typebulb 0.19.0 → 0.19.1

package/dist/agents/claude/client.js

@@ -998,13 +998,12 @@ const something = require('module-name')  // NOT SUPPORTED!
   }
 
   // tb.ai(): non-streaming, resolves with the full { text } (unchanged 90% path).
-  const aiCall = async ({ messages, system, effort, reasoning, provider, model, webSearch, signal } = {}) => {
+  const aiCall = async ({ messages, system, effort, provider, model, webSearch, signal } = {}) => {
     if (isEmbedded) throw embedErr('tb.ai()');
     const resp = await fetch('/__ai', {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
-      // 'reasoning' is the deprecated alias for 'effort'
-      body: JSON.stringify({ messages, system, effort: effort ?? reasoning, provider, model, webSearch }),
+      body: JSON.stringify({ messages, system, effort, provider, model, webSearch }),
       signal
     });
     if (resp.status === 403) throw new Error((await resp.text().catch(() => '')) || 'tb.ai() is blocked \u2014 re-run with --trust');
@@ -1021,12 +1020,11 @@ const something = require('module-name')  // NOT SUPPORTED!
   // streaming tb.server.<gen>(). Break the loop (or abort the signal) to cancel.
   const aiStream = (opts = {}) => (async function* () {
     if (isEmbedded) throw embedErr('tb.ai.stream()');
-    const { messages, system, effort, reasoning, provider, model, webSearch, signal } = opts;
+    const { messages, system, effort, provider, model, webSearch, signal } = opts;
     const resp = await fetch('/__ai', {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
-      // 'reasoning' is the deprecated alias for 'effort'
-      body: JSON.stringify({ messages, system, effort: effort ?? reasoning, provider, model, webSearch, stream: true }),
+      body: JSON.stringify({ messages, system, effort, provider, model, webSearch, stream: true }),
       signal
     });
     if (resp.status === 403) throw new Error((await resp.text().catch(() => '')) || 'tb.ai() is blocked \u2014 re-run with --trust');

package/dist/agents/pi/client.js

@@ -998,13 +998,12 @@ const something = require('module-name')  // NOT SUPPORTED!
   }
 
   // tb.ai(): non-streaming, resolves with the full { text } (unchanged 90% path).
-  const aiCall = async ({ messages, system, effort, reasoning, provider, model, webSearch, signal } = {}) => {
+  const aiCall = async ({ messages, system, effort, provider, model, webSearch, signal } = {}) => {
     if (isEmbedded) throw embedErr('tb.ai()');
     const resp = await fetch('/__ai', {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
-      // 'reasoning' is the deprecated alias for 'effort'
-      body: JSON.stringify({ messages, system, effort: effort ?? reasoning, provider, model, webSearch }),
+      body: JSON.stringify({ messages, system, effort, provider, model, webSearch }),
       signal
     });
     if (resp.status === 403) throw new Error((await resp.text().catch(() => '')) || 'tb.ai() is blocked \u2014 re-run with --trust');
@@ -1021,12 +1020,11 @@ const something = require('module-name')  // NOT SUPPORTED!
   // streaming tb.server.<gen>(). Break the loop (or abort the signal) to cancel.
   const aiStream = (opts = {}) => (async function* () {
     if (isEmbedded) throw embedErr('tb.ai.stream()');
-    const { messages, system, effort, reasoning, provider, model, webSearch, signal } = opts;
+    const { messages, system, effort, provider, model, webSearch, signal } = opts;
     const resp = await fetch('/__ai', {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
-      // 'reasoning' is the deprecated alias for 'effort'
-      body: JSON.stringify({ messages, system, effort: effort ?? reasoning, provider, model, webSearch, stream: true }),
+      body: JSON.stringify({ messages, system, effort, provider, model, webSearch, stream: true }),
       signal
     });
     if (resp.status === 403) throw new Error((await resp.text().catch(() => '')) || 'tb.ai() is blocked \u2014 re-run with --trust');

package/dist/dts/tbTypings.d.ts

@@ -9,7 +9,7 @@
  * TypeChecker, and the CLI's emitted typecheck dirs.
  */
 /** Typebulb globals available in browser-side code (code.tsx). */
-export declare const clientTbTypings = "\n/** A single streamed delta from `tb.ai.stream()`. Discriminated by `kind`. */\ntype AiChunk =\n  | { kind: \"text\"; text: string }\n  | { kind: \"reasoning\"; text: string };\n\n/**\n * Typebulb utilities namespace.\n * Type `tb.` to discover available helpers.\n */\ndeclare const tb: {\n  /**\n   * Get raw data chunk from the Data tab.\n   * @param index - Chunk index (0-based). Separate chunks with 2 blank lines.\n   */\n  data(index: number): string;\n  /**\n   * Get data chunk parsed as JSON (handles JSON-ish with unquoted keys).\n   * @param index - Chunk index (0-based)\n   * @throws If chunk is not valid JSON/JSON-ish\n   */\n  json<T = unknown>(index: number): T;\n  /**\n   * Async value inspector for tensor-like objects.\n   *\n   * Materializes lazy values (like GPU tensors) and logs them with metadata.\n   * Handles objects with `.js()`, `.data()`, `.array()`, `.arraySync()`, etc.\n   *\n   * @remarks\n   * - Always use `await` - materialization may be async (GPU\u2192CPU readback)\n   * - Large values are truncated (max 1000 elements)\n   * - Promises are logged as `[Promise]` (not awaited - could hang)\n   */\n  dump(...args: any[]): Promise<void>;\n  /**\n   * Trigger inference to generate new insight data.\n   *\n   * Opens a confirmation modal showing the data to be analyzed, then streams\n   * the inference result. On success, updates the insight so subsequent\n   * `tb.insight()` calls return the new value.\n   *\n   * @param opts - Options for inference\n   * @param opts.data - Data to pre-populate in the modal (string or array of strings). If omitted, modal opens with empty textarea for user to paste.\n   * @returns Promise that resolves with the parsed insight JSON\n   * @throws If inference is already in progress, or on network/parse/rate limit errors\n   */\n  infer<T = unknown>(opts?: { data?: string | string[] }): Promise<T>;\n  /**\n   * Get the current inference state.\n   *\n   * @returns 'idle' | 'running' | 'complete' | 'error'\n   */\n  inferenceState(): 'idle' | 'running' | 'complete' | 'error';\n  /**\n   * Set a data chunk for the next inference call.\n   *\n   * Use this to programmatically set data that will be sent when `tb.infer()` is called\n   * without the `data` option.\n   *\n   * @param index - The chunk index (0-based)\n   * @param content - The content for this chunk\n   */\n  setData(index: number, content: string): void;\n  /**\n   * Proxy a CDN URL through the sandbox origin for Web Worker/WASM same-origin loading.\n   *\n   * In the sandbox, prepends `/proxy/` so the URL is served from the same origin.\n   * Outside the sandbox (exported HTML, CLI), returns the URL unchanged.\n   *\n   * @param url - Full HTTPS URL to an allowlisted CDN (esm.sh, unpkg.com, cdn.jsdelivr.net, cdnjs.cloudflare.com)\n   * @returns The proxied URL (sandbox) or the original URL (standalone/CLI)\n   */\n  proxy(url: string): string;\n  /**\n   * Copy text to clipboard.\n   * Must be called synchronously within a user gesture (click/keydown).\n   * @returns true if successful, false otherwise\n   */\n  copy(text: string): Promise<boolean>;\n  /**\n   * Get the canonical URL of this bulb.\n   *\n   * Returns the parent typebulb.com URL (including path, query, and `#tb=` fragment),\n   * resolving correctly from inside the cross-origin sandbox iframe.\n   * Use this instead of `location.href` or `document.referrer`.\n   *\n   * @returns The full canonical URL\n   */\n  url(): Promise<string>;\n  /**\n   * Get the insight data produced by the inference layer.\n   *\n   * Returns the parsed JSON from insight.json, populated by the inference LLM.\n   * Use a type parameter to get typed access to the insight data.\n   *\n   * @returns The parsed insight JSON, or undefined if no insight is available\n   */\n  insight<T = unknown>(): T | undefined;\n  /**\n   * Server-side function proxy.\n   *\n   * In the CLI, calls exported functions from the `**server.ts**` section.\n   * `tb.server.log(...)` is a built-in that prints to CLI stdout (falls back to console.log on web).\n   * User exports override built-ins of the same name.\n   *\n   * A normal export is awaited for its result (`await tb.server.fn()`). An `async function*`\n   * export streams: `for await (const chunk of tb.server.gen())`. The call object supports both;\n   * break the `for await` to cancel and tear down the server generator.\n   */\n  server: Record<string, (...args: any[]) => Promise<any> & AsyncIterable<any>>;\n  /**\n   * Subscribe to a value pushed from the terminal via `typebulb send <file> [message]`.\n   *\n   * The dual of `tb.server.log` (data out): a value sent *in* from the CLI, no `--trust` required.\n   * Use it to start expensive work on demand instead of on load \u2014 e.g. `tb.onMessage(() => start())`\n   * \u2014 so hot reloads don't re-trigger it while you edit, and an agent kicks off one run when ready.\n   *\n   * The message is the JSON-parsed value of what `send` was given (or the raw string if it isn't\n   * JSON; `undefined` for a bare `typebulb send <file>`). Returns an unsubscribe function. Inert in\n   * an embedded bulb (no sender) \u2014 the handler is registered but never fires.\n   *\n   * @param handler - Called with each pushed message.\n   * @returns An unsubscribe function.\n   */\n  onMessage(handler: (message: any) => void): () => void;\n  /**\n   * General-purpose AI call. `tb.ai(opts)` resolves with the full text; `tb.ai.stream(opts)`\n   * returns an async iterable of {@link AiChunk} deltas you consume with `for await`.\n   *\n   * @returns Promise resolving to { text: string }\n   * @throws On rate limit, network error, or provider error\n   */\n  ai: {\n    (options: {\n    messages: Array<{ role: \"user\" | \"assistant\"; content: string }>;\n    system?: string;\n    /** Extended-thinking effort hint (1=low, 2=med, 3=high). Mapped to each provider's native mechanism (e.g. Anthropic adaptive thinking, OpenAI reasoning effort). Omit for the model's native default; use a non-reasoning model to avoid thinking entirely. */\n    effort?: 1 | 2 | 3;\n    /** @deprecated Renamed to `effort`. Still accepted; a `0` is treated as omitted. */\n    reasoning?: 0 | 1 | 2 | 3;\n    provider?: string;\n    model?: string;\n    /** Enable/disable web search. Default: on for BYOK, always off for free model. */\n    webSearch?: boolean;\n    /** Abort the request. On abort the promise rejects / the stream ends. */\n    signal?: AbortSignal;\n  }): Promise<{ text: string }>;\n    /**\n     * Streaming counterpart of `tb.ai()`. Yields `{ kind: \"text\" | \"reasoning\", text }` deltas\n     * as they arrive; break the loop (or abort `signal`) to cancel and stop the upstream.\n     *\n     * `kind: \"reasoning\"` deltas only arrive when you pass `effort: 1-3` AND use a\n     * thinking-capable model; otherwise the stream is `text`-only.\n     *\n     * @example\n     * let answer = \"\";\n     * for await (const c of tb.ai.stream({ messages })) {\n     *   if (c.kind === \"text\") answer += c.text;\n     * }\n     */\n    stream(options: {\n    messages: Array<{ role: \"user\" | \"assistant\"; content: string }>;\n    system?: string;\n    /** Extended-thinking effort hint (1=low, 2=med, 3=high). Mapped to each provider's native mechanism (e.g. Anthropic adaptive thinking, OpenAI reasoning effort). Omit for the model's native default; use a non-reasoning model to avoid thinking entirely. */\n    effort?: 1 | 2 | 3;\n    /** @deprecated Renamed to `effort`. Still accepted; a `0` is treated as omitted. */\n    reasoning?: 0 | 1 | 2 | 3;\n    provider?: string;\n    model?: string;\n    /** Enable/disable web search. Default: on for BYOK, always off for free model. */\n    webSearch?: boolean;\n    /** Abort the request. On abort the promise rejects / the stream ends. */\n    signal?: AbortSignal;\n  }): AsyncIterable<AiChunk>;\n  };\n  /**\n   * Local filesystem access (CLI only).\n   *\n   * Paths are resolved relative to the current working directory (where the CLI\n   * was launched), consistent with the .env cascade \u2014 not the bulb file's folder.\n   * Throws in editor/published mode.\n   */\n  fs: {\n    /** Read a file as UTF-8 text. Throws if the file is not valid UTF-8 \u2014 use readBytes for binary. */\n    read(path: string): Promise<string>;\n    /** Read a file as raw bytes. */\n    readBytes(path: string): Promise<Uint8Array>;\n    /** Write text or raw bytes to a file. Creates parent directories if needed. */\n    write(path: string, content: string | Uint8Array): Promise<boolean>;\n  };\n  /**\n   * Returns AI models available to the current user.\n   * Models are filtered by the user's configured API keys.\n   * If no keys are configured, returns only the courtesy model.\n   */\n  models(): Promise<Array<{\n    /** Provider protocol: \"anthropic\", \"openai\", \"gemini\", \"openrouter\" */\n    provider: string;\n    /** Model identifier, e.g. \"claude-sonnet-4-6\" */\n    name: string;\n    /** Human-readable display name, e.g. \"Sonnet 4.6\" */\n    friendlyName: string;\n    /** Provider display name, e.g. \"Anthropic\" */\n    providerName: string;\n  }>>;\n  /**\n   * The bulb's theme override (`<html data-theme>`).\n   *\n   * - Get: the current override \u2014 `'dark'` | `'light'`, or `undefined` when\n   *   following the OS preference.\n   * - Set `'dark'`/`'light'` to force and persist it (per-bulb); set\n   *   `undefined` to clear the override and follow the OS again.\n   *\n   * Drives `<html data-theme>`, so render off `html[data-theme=\"\u2026\"]` selectors\n   * (or observe the attribute) rather than reading `tb.theme`.\n   */\n  theme: 'light' | 'dark' | undefined;\n  /**\n   * The mode this bulb is running in.\n   *\n   * - `'local'` \u2014 Running via the typebulb CLI\n   * - `'editor'` \u2014 Running in the typebulb.com editor\n   * - `'published'` \u2014 Running as a published/standalone bulb on typebulb.com\n   * - `'embedded'` \u2014 Running as a bulb embedded inside another bulb (sandboxed,\n   *   client-only: AI, filesystem, and server RPC are unavailable)\n   */\n  mode: 'local' | 'editor' | 'published' | 'embedded';\n};\n";
+export declare const clientTbTypings = "\n/** A single streamed delta from `tb.ai.stream()`. Discriminated by `kind`. */\ntype AiChunk =\n  | { kind: \"text\"; text: string }\n  | { kind: \"reasoning\"; text: string };\n\n/**\n * Typebulb utilities namespace.\n * Type `tb.` to discover available helpers.\n */\ndeclare const tb: {\n  /**\n   * Get raw data chunk from the Data tab.\n   * @param index - Chunk index (0-based). Separate chunks with 2 blank lines.\n   */\n  data(index: number): string;\n  /**\n   * Get data chunk parsed as JSON (handles JSON-ish with unquoted keys).\n   * @param index - Chunk index (0-based)\n   * @throws If chunk is not valid JSON/JSON-ish\n   */\n  json<T = unknown>(index: number): T;\n  /**\n   * Async value inspector for tensor-like objects.\n   *\n   * Materializes lazy values (like GPU tensors) and logs them with metadata.\n   * Handles objects with `.js()`, `.data()`, `.array()`, `.arraySync()`, etc.\n   *\n   * @remarks\n   * - Always use `await` - materialization may be async (GPU\u2192CPU readback)\n   * - Large values are truncated (max 1000 elements)\n   * - Promises are logged as `[Promise]` (not awaited - could hang)\n   */\n  dump(...args: any[]): Promise<void>;\n  /**\n   * Trigger inference to generate new insight data.\n   *\n   * Opens a confirmation modal showing the data to be analyzed, then streams\n   * the inference result. On success, updates the insight so subsequent\n   * `tb.insight()` calls return the new value.\n   *\n   * @param opts - Options for inference\n   * @param opts.data - Data to pre-populate in the modal (string or array of strings). If omitted, modal opens with empty textarea for user to paste.\n   * @returns Promise that resolves with the parsed insight JSON\n   * @throws If inference is already in progress, or on network/parse/rate limit errors\n   */\n  infer<T = unknown>(opts?: { data?: string | string[] }): Promise<T>;\n  /**\n   * Get the current inference state.\n   *\n   * @returns 'idle' | 'running' | 'complete' | 'error'\n   */\n  inferenceState(): 'idle' | 'running' | 'complete' | 'error';\n  /**\n   * Set a data chunk for the next inference call.\n   *\n   * Use this to programmatically set data that will be sent when `tb.infer()` is called\n   * without the `data` option.\n   *\n   * @param index - The chunk index (0-based)\n   * @param content - The content for this chunk\n   */\n  setData(index: number, content: string): void;\n  /**\n   * Proxy a CDN URL through the sandbox origin for Web Worker/WASM same-origin loading.\n   *\n   * In the sandbox, prepends `/proxy/` so the URL is served from the same origin.\n   * Outside the sandbox (exported HTML, CLI), returns the URL unchanged.\n   *\n   * @param url - Full HTTPS URL to an allowlisted CDN (esm.sh, unpkg.com, cdn.jsdelivr.net, cdnjs.cloudflare.com)\n   * @returns The proxied URL (sandbox) or the original URL (standalone/CLI)\n   */\n  proxy(url: string): string;\n  /**\n   * Copy text to clipboard.\n   * Must be called synchronously within a user gesture (click/keydown).\n   * @returns true if successful, false otherwise\n   */\n  copy(text: string): Promise<boolean>;\n  /**\n   * Get the canonical URL of this bulb.\n   *\n   * Returns the parent typebulb.com URL (including path, query, and `#tb=` fragment),\n   * resolving correctly from inside the cross-origin sandbox iframe.\n   * Use this instead of `location.href` or `document.referrer`.\n   *\n   * @returns The full canonical URL\n   */\n  url(): Promise<string>;\n  /**\n   * Get the insight data produced by the inference layer.\n   *\n   * Returns the parsed JSON from insight.json, populated by the inference LLM.\n   * Use a type parameter to get typed access to the insight data.\n   *\n   * @returns The parsed insight JSON, or undefined if no insight is available\n   */\n  insight<T = unknown>(): T | undefined;\n  /**\n   * Server-side function proxy.\n   *\n   * In the CLI, calls exported functions from the `**server.ts**` section.\n   * `tb.server.log(...)` is a built-in that prints to CLI stdout (falls back to console.log on web).\n   * User exports override built-ins of the same name.\n   *\n   * A normal export is awaited for its result (`await tb.server.fn()`). An `async function*`\n   * export streams: `for await (const chunk of tb.server.gen())`. The call object supports both;\n   * break the `for await` to cancel and tear down the server generator.\n   */\n  server: Record<string, (...args: any[]) => Promise<any> & AsyncIterable<any>>;\n  /**\n   * Subscribe to a value pushed from the terminal via `typebulb send <file> [message]`.\n   *\n   * The dual of `tb.server.log` (data out): a value sent *in* from the CLI, no `--trust` required.\n   * Use it to start expensive work on demand instead of on load \u2014 e.g. `tb.onMessage(() => start())`\n   * \u2014 so hot reloads don't re-trigger it while you edit, and an agent kicks off one run when ready.\n   *\n   * The message is the JSON-parsed value of what `send` was given (or the raw string if it isn't\n   * JSON; `undefined` for a bare `typebulb send <file>`). Returns an unsubscribe function. Inert in\n   * an embedded bulb (no sender) \u2014 the handler is registered but never fires.\n   *\n   * @param handler - Called with each pushed message.\n   * @returns An unsubscribe function.\n   */\n  onMessage(handler: (message: any) => void): () => void;\n  /**\n   * General-purpose AI call. `tb.ai(opts)` resolves with the full text; `tb.ai.stream(opts)`\n   * returns an async iterable of {@link AiChunk} deltas you consume with `for await`.\n   *\n   * @returns Promise resolving to { text: string }\n   * @throws On rate limit, network error, or provider error\n   */\n  ai: {\n    (options: {\n    messages: Array<{ role: \"user\" | \"assistant\"; content: string }>;\n    system?: string;\n    /** Extended-thinking effort hint (1=low, 2=med, 3=high). Mapped to each provider's native mechanism (e.g. Anthropic adaptive thinking, OpenAI reasoning effort). Omit for the model's native default; use a non-reasoning model to avoid thinking entirely. */\n    effort?: 1 | 2 | 3;\n    provider?: string;\n    model?: string;\n    /** Enable/disable web search. Default: on for BYOK, always off for free model. */\n    webSearch?: boolean;\n    /** Abort the request. On abort the promise rejects / the stream ends. */\n    signal?: AbortSignal;\n  }): Promise<{ text: string }>;\n    /**\n     * Streaming counterpart of `tb.ai()`. Yields `{ kind: \"text\" | \"reasoning\", text }` deltas\n     * as they arrive; break the loop (or abort `signal`) to cancel and stop the upstream.\n     *\n     * `kind: \"reasoning\"` deltas only arrive when you pass `effort: 1-3` AND use a\n     * thinking-capable model; otherwise the stream is `text`-only.\n     *\n     * @example\n     * let answer = \"\";\n     * for await (const c of tb.ai.stream({ messages })) {\n     *   if (c.kind === \"text\") answer += c.text;\n     * }\n     */\n    stream(options: {\n    messages: Array<{ role: \"user\" | \"assistant\"; content: string }>;\n    system?: string;\n    /** Extended-thinking effort hint (1=low, 2=med, 3=high). Mapped to each provider's native mechanism (e.g. Anthropic adaptive thinking, OpenAI reasoning effort). Omit for the model's native default; use a non-reasoning model to avoid thinking entirely. */\n    effort?: 1 | 2 | 3;\n    provider?: string;\n    model?: string;\n    /** Enable/disable web search. Default: on for BYOK, always off for free model. */\n    webSearch?: boolean;\n    /** Abort the request. On abort the promise rejects / the stream ends. */\n    signal?: AbortSignal;\n  }): AsyncIterable<AiChunk>;\n  };\n  /**\n   * Local filesystem access (CLI only).\n   *\n   * Paths are resolved relative to the current working directory (where the CLI\n   * was launched), consistent with the .env cascade \u2014 not the bulb file's folder.\n   * Throws in editor/published mode.\n   */\n  fs: {\n    /** Read a file as UTF-8 text. Throws if the file is not valid UTF-8 \u2014 use readBytes for binary. */\n    read(path: string): Promise<string>;\n    /** Read a file as raw bytes. */\n    readBytes(path: string): Promise<Uint8Array>;\n    /** Write text or raw bytes to a file. Creates parent directories if needed. */\n    write(path: string, content: string | Uint8Array): Promise<boolean>;\n  };\n  /**\n   * Returns AI models available to the current user.\n   * Models are filtered by the user's configured API keys.\n   * If no keys are configured, returns only the courtesy model.\n   */\n  models(): Promise<Array<{\n    /** Provider protocol: \"anthropic\", \"openai\", \"gemini\", \"openrouter\" */\n    provider: string;\n    /** Model identifier, e.g. \"claude-sonnet-4-6\" */\n    name: string;\n    /** Human-readable display name, e.g. \"Sonnet 4.6\" */\n    friendlyName: string;\n    /** Provider display name, e.g. \"Anthropic\" */\n    providerName: string;\n  }>>;\n  /**\n   * The bulb's theme override (`<html data-theme>`).\n   *\n   * - Get: the current override \u2014 `'dark'` | `'light'`, or `undefined` when\n   *   following the OS preference.\n   * - Set `'dark'`/`'light'` to force and persist it (per-bulb); set\n   *   `undefined` to clear the override and follow the OS again.\n   *\n   * Drives `<html data-theme>`, so render off `html[data-theme=\"\u2026\"]` selectors\n   * (or observe the attribute) rather than reading `tb.theme`.\n   */\n  theme: 'light' | 'dark' | undefined;\n  /**\n   * The mode this bulb is running in.\n   *\n   * - `'local'` \u2014 Running via the typebulb CLI\n   * - `'editor'` \u2014 Running in the typebulb.com editor\n   * - `'published'` \u2014 Running as a published/standalone bulb on typebulb.com\n   * - `'embedded'` \u2014 Running as a bulb embedded inside another bulb (sandboxed,\n   *   client-only: AI, filesystem, and server RPC are unavailable)\n   */\n  mode: 'local' | 'editor' | 'published' | 'embedded';\n};\n";
 /** Typebulb globals available in Node-side code (server.ts). */
-export declare const serverTbTypings = "\n/** A single streamed delta from `tb.ai.stream()`. Discriminated by `kind`. */\ntype AiChunk =\n  | { kind: \"text\"; text: string }\n  | { kind: \"reasoning\"; text: string };\n\n/**\n * Typebulb utilities namespace (server-side).\n * Type `tb.` to discover available helpers.\n */\ndeclare const tb: {\n  /**\n   * Get raw data chunk from the Data tab.\n   * @param index - Chunk index (0-based). Separate chunks with 2 blank lines.\n   */\n  data(index: number): string;\n  /**\n   * Get data chunk parsed as JSON (handles JSON-ish with unquoted keys).\n   * @param index - Chunk index (0-based)\n   * @throws If chunk is not valid JSON/JSON-ish\n   */\n  json<T = unknown>(index: number): T;\n  /**\n   * Get the insight data produced by the inference layer.\n   *\n   * Returns the parsed JSON from insight.json, populated by the inference LLM.\n   * Use a type parameter to get typed access to the insight data.\n   *\n   * @returns The parsed insight JSON, or undefined if no insight is available\n   */\n  insight<T = unknown>(): T | undefined;\n  /**\n   * General-purpose AI call. `tb.ai(opts)` resolves with the full text; `tb.ai.stream(opts)`\n   * returns an async iterable of {@link AiChunk} deltas you consume with `for await`.\n   *\n   * @returns Promise resolving to { text: string }\n   * @throws On rate limit, network error, or provider error\n   */\n  ai: {\n    (options: {\n    messages: Array<{ role: \"user\" | \"assistant\"; content: string }>;\n    system?: string;\n    /** Extended-thinking effort hint (1=low, 2=med, 3=high). Mapped to each provider's native mechanism (e.g. Anthropic adaptive thinking, OpenAI reasoning effort). Omit for the model's native default; use a non-reasoning model to avoid thinking entirely. */\n    effort?: 1 | 2 | 3;\n    /** @deprecated Renamed to `effort`. Still accepted; a `0` is treated as omitted. */\n    reasoning?: 0 | 1 | 2 | 3;\n    provider?: string;\n    model?: string;\n    /** Enable/disable web search. Default: on for BYOK, always off for free model. */\n    webSearch?: boolean;\n    /** Abort the request. On abort the promise rejects / the stream ends. */\n    signal?: AbortSignal;\n  }): Promise<{ text: string }>;\n    /**\n     * Streaming counterpart of `tb.ai()`. Yields `{ kind: \"text\" | \"reasoning\", text }` deltas\n     * as they arrive; break the loop (or abort `signal`) to cancel and stop the upstream.\n     *\n     * `kind: \"reasoning\"` deltas only arrive when you pass `effort: 1-3` AND use a\n     * thinking-capable model; otherwise the stream is `text`-only.\n     *\n     * @example\n     * let answer = \"\";\n     * for await (const c of tb.ai.stream({ messages })) {\n     *   if (c.kind === \"text\") answer += c.text;\n     * }\n     */\n    stream(options: {\n    messages: Array<{ role: \"user\" | \"assistant\"; content: string }>;\n    system?: string;\n    /** Extended-thinking effort hint (1=low, 2=med, 3=high). Mapped to each provider's native mechanism (e.g. Anthropic adaptive thinking, OpenAI reasoning effort). Omit for the model's native default; use a non-reasoning model to avoid thinking entirely. */\n    effort?: 1 | 2 | 3;\n    /** @deprecated Renamed to `effort`. Still accepted; a `0` is treated as omitted. */\n    reasoning?: 0 | 1 | 2 | 3;\n    provider?: string;\n    model?: string;\n    /** Enable/disable web search. Default: on for BYOK, always off for free model. */\n    webSearch?: boolean;\n    /** Abort the request. On abort the promise rejects / the stream ends. */\n    signal?: AbortSignal;\n  }): AsyncIterable<AiChunk>;\n  };\n  /**\n   * Local filesystem access (CLI only).\n   *\n   * Paths are resolved relative to the current working directory (where the CLI\n   * was launched), consistent with the .env cascade \u2014 not the bulb file's folder.\n   * Throws in editor/published mode.\n   */\n  fs: {\n    /** Read a file as UTF-8 text. Throws if the file is not valid UTF-8 \u2014 use readBytes for binary. */\n    read(path: string): Promise<string>;\n    /** Read a file as raw bytes. */\n    readBytes(path: string): Promise<Uint8Array>;\n    /** Write text or raw bytes to a file. Creates parent directories if needed. */\n    write(path: string, content: string | Uint8Array): Promise<boolean>;\n  };\n  /**\n   * Server-side function proxy. The built-in `log` prints to CLI stdout\n   * (falls back to console.log on web). On the server side, this object only\n   * exposes `log` \u2014 server-to-server calls are not supported.\n   */\n  server: {\n    log(...args: any[]): Promise<void>;\n  };\n  /**\n   * Returns AI models available to the current user.\n   * Models are filtered by the user's configured API keys.\n   * If no keys are configured, returns only the courtesy model.\n   */\n  models(): Promise<Array<{\n    /** Provider protocol: \"anthropic\", \"openai\", \"gemini\", \"openrouter\" */\n    provider: string;\n    /** Model identifier, e.g. \"claude-sonnet-4-6\" */\n    name: string;\n    /** Human-readable display name, e.g. \"Sonnet 4.6\" */\n    friendlyName: string;\n    /** Provider display name, e.g. \"Anthropic\" */\n    providerName: string;\n  }>>;\n  /**\n   * The mode this bulb is running in.\n   *\n   * - `'local'` \u2014 Running via the typebulb CLI\n   * - `'editor'` \u2014 Running in the typebulb.com editor\n   * - `'published'` \u2014 Running as a published/standalone bulb on typebulb.com\n   * - `'embedded'` \u2014 Running as a bulb embedded inside another bulb (sandboxed,\n   *   client-only: AI, filesystem, and server RPC are unavailable)\n   */\n  mode: 'local' | 'editor' | 'published' | 'embedded';\n};\n";
+export declare const serverTbTypings = "\n/** A single streamed delta from `tb.ai.stream()`. Discriminated by `kind`. */\ntype AiChunk =\n  | { kind: \"text\"; text: string }\n  | { kind: \"reasoning\"; text: string };\n\n/**\n * Typebulb utilities namespace (server-side).\n * Type `tb.` to discover available helpers.\n */\ndeclare const tb: {\n  /**\n   * Get raw data chunk from the Data tab.\n   * @param index - Chunk index (0-based). Separate chunks with 2 blank lines.\n   */\n  data(index: number): string;\n  /**\n   * Get data chunk parsed as JSON (handles JSON-ish with unquoted keys).\n   * @param index - Chunk index (0-based)\n   * @throws If chunk is not valid JSON/JSON-ish\n   */\n  json<T = unknown>(index: number): T;\n  /**\n   * Get the insight data produced by the inference layer.\n   *\n   * Returns the parsed JSON from insight.json, populated by the inference LLM.\n   * Use a type parameter to get typed access to the insight data.\n   *\n   * @returns The parsed insight JSON, or undefined if no insight is available\n   */\n  insight<T = unknown>(): T | undefined;\n  /**\n   * General-purpose AI call. `tb.ai(opts)` resolves with the full text; `tb.ai.stream(opts)`\n   * returns an async iterable of {@link AiChunk} deltas you consume with `for await`.\n   *\n   * @returns Promise resolving to { text: string }\n   * @throws On rate limit, network error, or provider error\n   */\n  ai: {\n    (options: {\n    messages: Array<{ role: \"user\" | \"assistant\"; content: string }>;\n    system?: string;\n    /** Extended-thinking effort hint (1=low, 2=med, 3=high). Mapped to each provider's native mechanism (e.g. Anthropic adaptive thinking, OpenAI reasoning effort). Omit for the model's native default; use a non-reasoning model to avoid thinking entirely. */\n    effort?: 1 | 2 | 3;\n    provider?: string;\n    model?: string;\n    /** Enable/disable web search. Default: on for BYOK, always off for free model. */\n    webSearch?: boolean;\n    /** Abort the request. On abort the promise rejects / the stream ends. */\n    signal?: AbortSignal;\n  }): Promise<{ text: string }>;\n    /**\n     * Streaming counterpart of `tb.ai()`. Yields `{ kind: \"text\" | \"reasoning\", text }` deltas\n     * as they arrive; break the loop (or abort `signal`) to cancel and stop the upstream.\n     *\n     * `kind: \"reasoning\"` deltas only arrive when you pass `effort: 1-3` AND use a\n     * thinking-capable model; otherwise the stream is `text`-only.\n     *\n     * @example\n     * let answer = \"\";\n     * for await (const c of tb.ai.stream({ messages })) {\n     *   if (c.kind === \"text\") answer += c.text;\n     * }\n     */\n    stream(options: {\n    messages: Array<{ role: \"user\" | \"assistant\"; content: string }>;\n    system?: string;\n    /** Extended-thinking effort hint (1=low, 2=med, 3=high). Mapped to each provider's native mechanism (e.g. Anthropic adaptive thinking, OpenAI reasoning effort). Omit for the model's native default; use a non-reasoning model to avoid thinking entirely. */\n    effort?: 1 | 2 | 3;\n    provider?: string;\n    model?: string;\n    /** Enable/disable web search. Default: on for BYOK, always off for free model. */\n    webSearch?: boolean;\n    /** Abort the request. On abort the promise rejects / the stream ends. */\n    signal?: AbortSignal;\n  }): AsyncIterable<AiChunk>;\n  };\n  /**\n   * Local filesystem access (CLI only).\n   *\n   * Paths are resolved relative to the current working directory (where the CLI\n   * was launched), consistent with the .env cascade \u2014 not the bulb file's folder.\n   * Throws in editor/published mode.\n   */\n  fs: {\n    /** Read a file as UTF-8 text. Throws if the file is not valid UTF-8 \u2014 use readBytes for binary. */\n    read(path: string): Promise<string>;\n    /** Read a file as raw bytes. */\n    readBytes(path: string): Promise<Uint8Array>;\n    /** Write text or raw bytes to a file. Creates parent directories if needed. */\n    write(path: string, content: string | Uint8Array): Promise<boolean>;\n  };\n  /**\n   * Server-side function proxy. The built-in `log` prints to CLI stdout\n   * (falls back to console.log on web). On the server side, this object only\n   * exposes `log` \u2014 server-to-server calls are not supported.\n   */\n  server: {\n    log(...args: any[]): Promise<void>;\n  };\n  /**\n   * Returns AI models available to the current user.\n   * Models are filtered by the user's configured API keys.\n   * If no keys are configured, returns only the courtesy model.\n   */\n  models(): Promise<Array<{\n    /** Provider protocol: \"anthropic\", \"openai\", \"gemini\", \"openrouter\" */\n    provider: string;\n    /** Model identifier, e.g. \"claude-sonnet-4-6\" */\n    name: string;\n    /** Human-readable display name, e.g. \"Sonnet 4.6\" */\n    friendlyName: string;\n    /** Provider display name, e.g. \"Anthropic\" */\n    providerName: string;\n  }>>;\n  /**\n   * The mode this bulb is running in.\n   *\n   * - `'local'` \u2014 Running via the typebulb CLI\n   * - `'editor'` \u2014 Running in the typebulb.com editor\n   * - `'published'` \u2014 Running as a published/standalone bulb on typebulb.com\n   * - `'embedded'` \u2014 Running as a bulb embedded inside another bulb (sandboxed,\n   *   client-only: AI, filesystem, and server RPC are unavailable)\n   */\n  mode: 'local' | 'editor' | 'published' | 'embedded';\n};\n";
 //# sourceMappingURL=tbTypings.d.ts.map

package/dist/dts/tbTypings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tbTypings.d.ts","sourceRoot":"","sources":["../../dts/src/tbTypings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAsPH,kEAAkE;AAClE,eAAO,MAAM,eAAe,m8TAO3B,CAAA;AAED,gEAAgE;AAChE,eAAO,MAAM,eAAe,igLAO3B,CAAA"}
+{"version":3,"file":"tbTypings.d.ts","sourceRoot":"","sources":["../../dts/src/tbTypings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAoPH,kEAAkE;AAClE,eAAO,MAAM,eAAe,+sTAO3B,CAAA;AAED,gEAAgE;AAChE,eAAO,MAAM,eAAe,6wKAO3B,CAAA"}

package/dist/dts/tbTypings.js

@@ -36,8 +36,6 @@ const aiOptions = `options: {
     system?: string;
     /** Extended-thinking effort hint (1=low, 2=med, 3=high). Mapped to each provider's native mechanism (e.g. Anthropic adaptive thinking, OpenAI reasoning effort). Omit for the model's native default; use a non-reasoning model to avoid thinking entirely. */
     effort?: 1 | 2 | 3;
-    /** @deprecated Renamed to \`effort\`. Still accepted; a \`0\` is treated as omitted. */
-    reasoning?: 0 | 1 | 2 | 3;
     provider?: string;
     model?: string;
     /** Enable/disable web search. Default: on for BYOK, always off for free model. */

package/dist/dts/tbTypings.js.map

@@ -1 +1 @@
-{"version":3,"file":"tbTypings.js","sourceRoot":"","sources":["../../dts/src/tbTypings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,GAAG;;;;;;;;;;;uCAWmB,CAAA;AAEvC,MAAM,OAAO,GAAG;;;;;;;;;yCASyB,CAAA;AAEzC,2DAA2D;AAC3D,MAAM,SAAS,GAAG;;;;;;;;;;;;;IAad,CAAA;AAEJ,oGAAoG;AACpG,MAAM,WAAW,GAAG;;;;;CAKnB,CAAA;AAED,MAAM,EAAE,GAAG;;;;;;;;;OASJ,SAAS;;;;;;;;;;;;;;aAcH,SAAS;KACjB,CAAA;AAEL,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;OAeR,CAAA;AAEP,MAAM,KAAK,GAAG;;;;;;;;;;;;uCAYyB,CAAA;AAEvC,MAAM,IAAI,GAAG;;;;;;;;;;uDAU0C,CAAA;AAEvD,MAAM,EAAE,GAAG;;;;;;;;;;;;;;;KAeN,CAAA;AAEL,MAAM,aAAa,GAAG;;;;;;;;KAQjB,CAAA;AAEL,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAmEA,CAAA;AAE1B,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;0DAewC,CAAA;AAE1D,MAAM,iBAAiB,GAAG;;;;;;;;;;;;iFAYuD,CAAA;AAEjF,kEAAkE;AAClE,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,WAAW;;;;;qBAKxB,WAAW,GAAG,iBAAiB,GAAG,OAAO,GAAG,iBAAiB,GAAG,SAAS,GAAG,EAAE,GAAG,EAAE,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI;;CAE/H,CAAA;AAED,gEAAgE;AAChE,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,WAAW;;;;;qBAKxB,WAAW,GAAG,OAAO,GAAG,EAAE,GAAG,EAAE,GAAG,aAAa,GAAG,MAAM,GAAG,IAAI;;CAEnF,CAAA"}
+{"version":3,"file":"tbTypings.js","sourceRoot":"","sources":["../../dts/src/tbTypings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,GAAG;;;;;;;;;;;uCAWmB,CAAA;AAEvC,MAAM,OAAO,GAAG;;;;;;;;;yCASyB,CAAA;AAEzC,2DAA2D;AAC3D,MAAM,SAAS,GAAG;;;;;;;;;;;IAWd,CAAA;AAEJ,oGAAoG;AACpG,MAAM,WAAW,GAAG;;;;;CAKnB,CAAA;AAED,MAAM,EAAE,GAAG;;;;;;;;;OASJ,SAAS;;;;;;;;;;;;;;aAcH,SAAS;KACjB,CAAA;AAEL,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;OAeR,CAAA;AAEP,MAAM,KAAK,GAAG;;;;;;;;;;;;uCAYyB,CAAA;AAEvC,MAAM,IAAI,GAAG;;;;;;;;;;uDAU0C,CAAA;AAEvD,MAAM,EAAE,GAAG;;;;;;;;;;;;;;;KAeN,CAAA;AAEL,MAAM,aAAa,GAAG;;;;;;;;KAQjB,CAAA;AAEL,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAmEA,CAAA;AAE1B,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;0DAewC,CAAA;AAE1D,MAAM,iBAAiB,GAAG;;;;;;;;;;;;iFAYuD,CAAA;AAEjF,kEAAkE;AAClE,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,WAAW;;;;;qBAKxB,WAAW,GAAG,iBAAiB,GAAG,OAAO,GAAG,iBAAiB,GAAG,SAAS,GAAG,EAAE,GAAG,EAAE,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI;;CAE/H,CAAA;AAED,gEAAgE;AAChE,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,WAAW;;;;;qBAKxB,WAAW,GAAG,OAAO,GAAG,EAAE,GAAG,EAAE,GAAG,aAAa,GAAG,MAAM,GAAG,IAAI;;CAEnF,CAAA"}