docs(snippets): update code block labels and imports

Author: masnwilliams

.github/scripts/code_samples.config.json

@@ -2,6 +2,10 @@
 	"variants": {
 		"post /invocations": [
 			{ "name": "async", "overrides": { "async": true } }
+		],
+		"post /browsers": [
+			{ "name": "timeout", "overrides": { "timeout_seconds": 300 } },
+			{ "name": "live-view", "overrides": { "log": "browser.browser_live_view_url" } }
 		]
 	}
 }

.github/scripts/generate_code_samples.ts

@@ -24,8 +24,8 @@ function normalizeLang(input: string): SupportedLanguage {
 }
 
 function renderFenceInfo(lang: SupportedLanguage, rawLang: string): string {
-  if (lang === "typescript" || lang === "javascript") return "typescript index.ts";
-  if (lang === "python") return "python main.py";
+  if (lang === "typescript" || lang === "javascript") return "typescript Typescript/Javascript";
+  if (lang === "python") return "python Python";
   return `${lang} ${toTitleCase(rawLang)}`;
 }
 
@@ -92,6 +92,10 @@ function injectParamsIntoObjectLiteral(
       }
     }
   }
+  // For JS/TS single-line objects, remove any trailing comma before the closing brace
+  if (lang !== "python") {
+    updated = updated.replace(/,\s*}/, " }");
+  }
   return updated;
 }
 
@@ -136,29 +140,67 @@ function applyOverridesToSource(
   overrides?: Record<string, unknown>
 ): string {
   if (!overrides || Object.keys(overrides).length === 0) return src;
-  // Heuristic: find the first object literal in a create(...) call and inject params
-  const createCall = /(invocations\.(create|new)\()([\s\S]*?)(\))/m;
-  const match = src.match(createCall);
-  if (!match) return src;
-  const before = src.slice(0, match.index ?? 0);
-  const after = src.slice((match.index ?? 0) + match[0].length);
-  const inside = match[3] ?? "";
-  const objectMatch = inside.match(/\{[\s\S]*?\}/m);
-  if (objectMatch) {
-    const objBefore = inside.slice(0, objectMatch.index!);
-    const obj = objectMatch[0];
-    const objAfter = inside.slice((objectMatch.index || 0) + objectMatch[0].length);
-    const injected = injectParamsIntoObjectLiteral(lang, obj, overrides);
-    const newInside = objBefore + injected + objAfter;
-    return before + match[1] + newInside + match[4] + after;
+  let transformed = src;
+
+  // Heuristic: find the first object literal in a X.create(...) call and inject params (excluding special keys like 'log')
+  const { log: _logOverride, ...injectionOverrides } = overrides as Record<string, unknown>;
+  if (Object.keys(injectionOverrides).length > 0) {
+    const createCall = /(\b\w+\.(create|new)\()([\s\S]*?)(\))/m;
+    const match = transformed.match(createCall);
+    if (match) {
+      const before = transformed.slice(0, match.index ?? 0);
+      const after = transformed.slice((match.index ?? 0) + match[0].length);
+      const inside = match[3] ?? "";
+      const objectMatch = inside.match(/\{[\s\S]*?\}/m);
+      if (objectMatch) {
+        const objBefore = inside.slice(0, objectMatch.index!);
+        const obj = objectMatch[0];
+        const objAfter = inside.slice((objectMatch.index || 0) + objectMatch[0].length);
+        const injected = injectParamsIntoObjectLiteral(lang, obj, injectionOverrides);
+        const newInside = objBefore + injected + objAfter;
+        transformed = before + match[1] + newInside + match[4] + after;
+      } else if (lang === "python") {
+        const injectedArgs = injectParamsIntoPythonArgs(inside, injectionOverrides);
+        const needsNewlineBeforeParen = /\n/.test(injectedArgs) && !/\n\s*$/.test(injectedArgs);
+        const joiner = needsNewlineBeforeParen ? "\n" : "";
+        transformed = before + match[1] + injectedArgs + joiner + match[4] + after;
+      } else {
+        // JS/TS with no object literal: insert one and inject
+        const injectedObj = injectParamsIntoObjectLiteral(lang, "{}", injectionOverrides);
+        transformed = before + match[1] + injectedObj + match[4] + after;
+      }
+    }
   }
-  if (lang === "python") {
-    const injectedArgs = injectParamsIntoPythonArgs(inside, overrides);
-    const needsNewlineBeforeParen = /\n/.test(injectedArgs) && !/\n\s*$/.test(injectedArgs);
-    const joiner = needsNewlineBeforeParen ? "\n" : "";
-    return before + match[1] + injectedArgs + joiner + match[4] + after;
+
+  // Apply log override if present: replace argument of the last console.log/print call
+  const logExpr = (overrides as Record<string, unknown>)?.log;
+  if (typeof logExpr === "string" && logExpr.trim().length > 0) {
+    if (lang === "python") {
+      const regex = /print\(([^\)]*)\)/g;
+      let lastMatch: RegExpExecArray | null = null;
+      let m: RegExpExecArray | null;
+      while ((m = regex.exec(transformed)) !== null) lastMatch = m;
+      if (lastMatch) {
+        const start = lastMatch.index;
+        const end = start + lastMatch[0].length;
+        transformed =
+          transformed.slice(0, start) + `print(${logExpr})` + transformed.slice(end);
+      }
+    } else {
+      const regex = /console\.log\(([^\)]*)\)/g;
+      let lastMatch: RegExpExecArray | null = null;
+      let m: RegExpExecArray | null;
+      while ((m = regex.exec(transformed)) !== null) lastMatch = m;
+      if (lastMatch) {
+        const start = lastMatch.index;
+        const end = start + lastMatch[0].length;
+        transformed =
+          transformed.slice(0, start) + `console.log(${logExpr})` + transformed.slice(end);
+      }
+    }
   }
-  return src;
+
+  return transformed;
 }
 
 function parseOverridesString(raw: string): Record<string, unknown> | undefined {
@@ -318,7 +360,7 @@ function slugifyEndpoint(method: string, endpoint: string): string {
 async function writeSnippetFile(filePath: string, blocks: string) {
   const dir = path.dirname(filePath);
   await mkdir(dir, { recursive: true });
-  const content = `<CodeGroup dropdown>\n${blocks.trim()}\n</CodeGroup>\n`;
+  const content = `<CodeGroup>\n${blocks.trim()}\n</CodeGroup>\n`;
   await writeFile(filePath, content, "utf8");
 }
 
@@ -403,7 +445,7 @@ async function processFile(file: string, spec: any) {
       if (inline) overrides = { ...(overrides || {}), ...inline };
     }
     const blocks = extractCodeSamples(spec, endpoint, method, overrides).trim();
-    return `<CodeGroup dropdown>\n${blocks}\n</CodeGroup>`;
+    return `<CodeGroup>\n${blocks}\n</CodeGroup>`;
   });
 
   if (changed) {

apps/status.mdx

@@ -2,10 +2,10 @@
 title: "Status"
 ---
 
-Once you've [deployed](/apps/deploy) an app and invoked it, you can check its status.
-
 import GetInvocationStatus from '/snippets/openapi/get-invocations-id.mdx';
 
+Once you've [deployed](/apps/deploy) an app and invoked it, you can check its status.
+
 <GetInvocationStatus />
 
 <Info>

apps/stop.mdx

@@ -2,6 +2,8 @@
 title: "Stopping"
 ---
 
+import StopInvocation from '/snippets/openapi/patch-invocations-id.mdx';
+
 You can terminate an invocation that's running. You can use this to stop automations or agents stuck in an infinite loop.
 
 <Info>
@@ -11,10 +13,7 @@ Terminating an invocation also destroys any browsers associated with it.
 ## Via API
 You can also do this via the API:
 
-import StopInvocation from '/snippets/openapi/patch-invocations-id.mdx';
-
 <StopInvocation />
 
-
 ## Via CLI
 Use `ctrl-c` in the terminal tab where you launched the invocation.

browsers/create-a-browser.mdx

@@ -2,14 +2,15 @@
 title: "Create a Browser"
 ---
 
+import CreateBrowserSnippet from '/snippets/openapi/post-browsers.mdx';
+import DeleteBrowserSnippet from '/snippets/openapi/delete-browsers-id.mdx';
+
 Kernel browsers were designed to be lightweight, fast, and efficient for cloud-based browser automations at scale. They can be used as part of the Kernel [app platform](/apps/develop) or connected to from another service with the Chrome DevTools Protocol.
 
 ## 1. Create a Kernel browser
 
 Use our SDK to create a browser:
 
-import CreateBrowserSnippet from '/snippets/openapi/post-browsers.mdx';
-
 <CreateBrowserSnippet />
 
 ## 2. Connect to the browser with the Chrome DevTools Protocol
@@ -39,8 +40,6 @@ browser = playwright.chromium.connect_over_cdp(kernel_browser.cdp_ws_url)
 
 When you're finished with the browser, you can delete it:
 
-import DeleteBrowserSnippet from '/snippets/openapi/delete-browsers-id.mdx';
-
 <DeleteBrowserSnippet />
 
 You can also delete the browser by [specifiying a timeout](/browsers/termination#timeouts-for-non-persisted-browsers) when you create the browser.

browsers/live-view.mdx

@@ -2,12 +2,12 @@
 title: "Live View"
 ---
 
+import CreateBrowserForLiveView from '/snippets/openapi/post-browsers-live-view.mdx';
+
 Humans-in-the-loop can access the live view of Kernel browsers in real-time to resolve errors or take unscripted actions.
 
 To access the live view, visit the `browser_live_view_url` provided when you create a Kernel browser:
 
-import CreateBrowserForLiveView from '/snippets/openapi/post-browsers.mdx';
-
 <CreateBrowserForLiveView />
 
 ## Query parameters

browsers/termination.mdx

@@ -2,14 +2,15 @@
 title: "Termination & Timeouts"
 ---
 
+import DeleteBrowser from '/snippets/openapi/delete-browsers-id.mdx';
+import CreateBrowserTimeout from '/snippets/openapi/post-browsers-timeout.mdx';
+
 Kernel browsers should be terminated after you're done with them.
 
 ## Via API
 
 You can delete a browser by making a `DELETE` request to Kernel's API:
 
-import DeleteBrowser from '/snippets/openapi/delete-browsers-id.mdx';
-
 <DeleteBrowser />
 
 ## Timeouts for non-persisted browsers
@@ -18,6 +19,4 @@ If you don't manually delete a `non-persisted` browser, deletion will happen aut
 
 You can set a custom timeout of up to 24 hours via the API:
 
-import CreateBrowserTimeout from '/snippets/openapi/post-browsers.mdx';
-
 <CreateBrowserTimeout />

snippets/openapi/delete-browsers-id-fs-watch-watch_id.mdx

@@ -1,5 +1,5 @@
-<CodeGroup dropdown>
-```typescript index.ts
+<CodeGroup>
+```typescript Typescript/Javascript
 import Kernel from '@onkernel/sdk';
 
 const client = new Kernel({
@@ -10,7 +10,7 @@ await client.browsers.fs.watch.stop('watch_id', { id: 'id' });
 ```
 
 
-```python main.py
+```python Python
 from kernel import Kernel
 
 client = Kernel(

snippets/openapi/delete-browsers-id.mdx

@@ -1,5 +1,5 @@
-<CodeGroup dropdown>
-```typescript index.ts
+<CodeGroup>
+```typescript Typescript/Javascript
 import Kernel from '@onkernel/sdk';
 
 const client = new Kernel({
@@ -10,7 +10,7 @@ await client.browsers.deleteByID('htzv5orfit78e1m2biiifpbv');
 ```
 
 
-```python main.py
+```python Python
 from kernel import Kernel
 
 client = Kernel(

snippets/openapi/delete-browsers.mdx

@@ -1,5 +1,5 @@
-<CodeGroup dropdown>
-```typescript index.ts
+<CodeGroup>
+```typescript Typescript/Javascript
 import Kernel from '@onkernel/sdk';
 
 const client = new Kernel({
@@ -10,7 +10,7 @@ await client.browsers.delete({ persistent_id: 'persistent_id' });
 ```
 
 
-```python main.py
+```python Python
 from kernel import Kernel
 
 client = Kernel(