typebulb 0.40.0 → 0.41.0

package/README.md

@@ -16,7 +16,7 @@ This document is dedicated to the typebulb CLI. At its core, it compiles and ser
 ## Features
 
 - **Server-side code** — Add a `**server.ts**` section; exported functions become callable from the browser via `tb.server.<name>()` (e.g., `export async function query(...)` → `await tb.server.query(...)`). An `export async function*` **streams**: consume it with `for await (const chunk of tb.server.gen())`. Requires `--trust`.
-- **CLI logging** — `tb.server.log(...)` prints to the CLI's stdout
+- **CLI logging** — `tb.log(...)` prints to the CLI's stdout, from `code.tsx` and `server.ts` alike (no trust needed)
 - **Wake-on-event** — `typebulb wait <file|agent>` blocks until the target server logs a new line, prints it, and exits. Run in the background, that exit *is* an agent's wake-up: a user action a bulb logs, or an embed's render outcome — no polling.
 - **Env files** — `.env` / `.env.local` load from cwd, `.env.local` overriding `.env` (an exported shell var wins over both). `--mode <name>` adds `.env.<name>` to switch environments (local/staging/prod); a startup line reports which keys loaded from where.
 - **Server mode** — `--server` runs only the `**server.ts**` section in Node, skipping the web server. Bulbs with only `**server.ts**` (no `**code.tsx**`) use this mode automatically.
@@ -190,6 +190,7 @@ everywhere.
 | `tb.url()` | Get the bulb URL (the served localhost URL, locally) | |
 | `tb.models()` | List available AI models (for dynamic model selectors); the `.env` default is flagged (`default: true`); returns `[]` when embedded (no host AI) | |
 | `tb.hasOwnKeys()` | Whether the user's own AI keys back `tb.ai` — `false` means courtesy model only; always `false` embedded | |
+| `tb.log(...)` | Print to the CLI's stdout (read back with `typebulb logs`); falls back to the browser console when no CLI serves the page | |
 | `tb.onMessage(cb)` | Receive a value pushed in from the terminal by `typebulb send`; a non-`undefined` return becomes the reply `send --wait` prints — inert when embedded (no sender) | |
 | `tb.fs.read/readBytes/write` | Read and write local files | yes |
 | `tb.dir` | The bulb's folder (absolute path), where relative `tb.fs` paths land | |
@@ -267,7 +268,7 @@ That one launch *is* the loop: the server watches the file, so every save recomp
 
 A `**server.ts**` block with no `**code.tsx**` is a headless bulb — no UI, no port, absent from the launcher. Under `--trust` its code can use `tb.fs`, and call `tb.ai`, `tb.ai.stream`, and `tb.models` against your `.env` keys.
 
-- **Invoke one export with `typebulb call <file> <fn> [args…] --trust`.** It boots, runs that export, prints the `return` as JSON to stdout, and exits — a fresh boot per call. Log with `console.log` (no `tb.server.log` here); under `call` logs go to stderr, so the JSON result owns stdout.
+- **Invoke one export with `typebulb call <file> <fn> [args…] --trust`.** It boots, runs that export, prints the `return` as JSON to stdout, and exits — a fresh boot per call. Under `call`, logs (`console.log` / `tb.log`) go to stderr, so the JSON result owns stdout.
 
 ## Sizing
 
@@ -290,7 +291,8 @@ The host owns a bulb's **width**; you own its **height**.
 - **A bulb's working files land beside it automatically** — relative `tb.fs` paths resolve to the bulb's folder, in `code.tsx` and `server.ts` alike: `tb.fs.write('run.json')`, no path prefix, no mkdir.
 - **Images & media: an `assets/` subfolder of the bulb's folder** (`birds.bulb.md` → `birds/assets/robin.png`) — `<img src="assets/robin.png">` just works (always that relative form, never `/assets/…`), every tier except embedded.
 - **Batch runs: scope with `--batch`, don't hand-roll plumbing** — `--batch pilot` on a run or `call` lands `tb.dir` and relative `tb.fs` paths in `<bulb-folder>/batches/pilot/`; the bulb's code stays batch-unaware, an unscoped run sees `batches/` as an ordinary subfolder, and the agent mirror lists a bulb's batches on its launcher row (play opens the newest).
-- **Self-testing a local bulb** — To confirm a bulb works, run it, instrument with `tb.server.log(...)` (prints to the server's stdout — and despite the name needs **no `server.ts` block**, working from `code.tsx` on a Restricted bulb, so a client-only bulb has a log channel), and read it back with `typebulb logs`. That's the loop to verify behaviour without asking the user to copy-paste console output. `tb.fs.write(...)` is handy for dumping large outputs.
+- **See what's already running** — `typebulb logs` with no argument lists every running bulb and mirror; check it before launching anything.
+- **Self-testing a local bulb** — To confirm a bulb works, run it, instrument with `tb.log(...)`, and read it back with `typebulb logs`. That's the loop to verify behaviour without asking the user to copy-paste console output. `tb.fs.write(...)` is handy for dumping large outputs.
 - **Self-testing client code** — gate checks behind `tb.onMessage(m => { if (m === 'selftest') return run() })`, trigger with `typebulb send <file> selftest --wait`, and assert on the JSON reply — see [Interrogating the live page](#interrogating-the-live-page).
 - **Testing a `server.ts` export directly** — `typebulb call <file> <fn> [arg…]` boots `server.ts`, invokes one export, and prints its return as JSON to stdout (logs/errors to stderr, so `… | jq` works). Args after `<fn>` are JSON-or-string; `--args '<json-array>'` (or `--args -` for stdin) escapes tricky quoting. Needs `--trust`.
 - **Mount to the container your `index.html` declares.** The corpus convention is `<div id="root"></div>` with `createRoot(document.getElementById("root")!)`.

package/dist/agents/claude/client.js

@@ -1026,12 +1026,12 @@ const something = require('module-name')  // NOT SUPPORTED!
     }
   };
 
-  // Diagnostic logging (tb.server.log). Routes to the UNGATED /__log endpoint, which only ever
+  // Diagnostic logging (tb.log). Routes to the UNGATED /__log endpoint, which only ever
   // runs the server's built-in console.log \u2014 never a user server.ts export \u2014 so it crosses no
   // capability boundary and works even on a Restricted (untrusted) bulb (the FAQ's recommended
   // debugging path). Embedded bulbs have no host, and any transport failure degrades to the page's
   // own console: a diagnostic log must never throw or block.
-  const serverLog = async (...args) => {
+  const tbLog = async (...args) => {
     if (isEmbedded) { console.log(...args); return; }
     try {
       const resp = await fetch('/__log', {
@@ -1259,17 +1259,19 @@ const something = require('module-name')  // NOT SUPPORTED!
       return location.origin && location.origin !== 'null' ? location.origin + rel : rel;
     },
 
+    // The bulb's log channel: prints on the CLI's stdout (\`typebulb logs\` reads it back). Ungated \u2014
+    // no server.ts, no trust \u2014 see tbLog above.
+    log: (...args) => { void tbLog(...args); },
+
     // Server API - call functions from **server.ts**. Returns the hybrid call object: await it for
     // a normal export's result, or for-await it for an async-generator export's stream.
     api: (name, ...args) => serverCall(name, args),
 
-    // Server proxy - tb.server.fn(...) delegates to serverCall. 'log' is special: it's the ungated
-    // diagnostic (serverLog -> /__log, built-in only), so it prints untrusted; everything else is a
-    // gated /__api call into the bulb's own server.ts.
+    // Server proxy - tb.server.fn(...) delegates to serverCall: purely the bulb's own server.ts
+    // exports, every one a gated /__api call. (The ungated diagnostic lives at tb.log, so no
+    // built-in shadows a user export.)
     server: new Proxy({}, {
-      get: (_, name) => name === 'log'
-        ? (...args) => serverLog(...args)
-        : (...args) => serverCall(name, args)
+      get: (_, name) => (...args) => serverCall(name, args)
     }),
 
     // Filesystem - local CLI extension
@@ -1284,7 +1286,7 @@ const something = require('module-name')  // NOT SUPPORTED!
     },
 
     // Receive a value pushed from the terminal via \`typebulb send\` (data-in, the dual of the
-    // ungated tb.server.log). Returns an unsubscribe fn. Inert when embedded \u2014 no server, so no
+    // ungated tb.log). Returns an unsubscribe fn. Inert when embedded \u2014 no server, so no
     // sender; the handler is registered but never fires (cf. tb.models returning []). A handler's
     // non-undefined return (awaited) becomes the reply \`send --wait\` prints (TB-Interrogation.md).
     onMessage: (handler) => {

package/dist/agents/pi/client.js

@@ -1026,12 +1026,12 @@ const something = require('module-name')  // NOT SUPPORTED!
     }
   };
 
-  // Diagnostic logging (tb.server.log). Routes to the UNGATED /__log endpoint, which only ever
+  // Diagnostic logging (tb.log). Routes to the UNGATED /__log endpoint, which only ever
   // runs the server's built-in console.log \u2014 never a user server.ts export \u2014 so it crosses no
   // capability boundary and works even on a Restricted (untrusted) bulb (the FAQ's recommended
   // debugging path). Embedded bulbs have no host, and any transport failure degrades to the page's
   // own console: a diagnostic log must never throw or block.
-  const serverLog = async (...args) => {
+  const tbLog = async (...args) => {
     if (isEmbedded) { console.log(...args); return; }
     try {
       const resp = await fetch('/__log', {
@@ -1259,17 +1259,19 @@ const something = require('module-name')  // NOT SUPPORTED!
       return location.origin && location.origin !== 'null' ? location.origin + rel : rel;
     },
 
+    // The bulb's log channel: prints on the CLI's stdout (\`typebulb logs\` reads it back). Ungated \u2014
+    // no server.ts, no trust \u2014 see tbLog above.
+    log: (...args) => { void tbLog(...args); },
+
     // Server API - call functions from **server.ts**. Returns the hybrid call object: await it for
     // a normal export's result, or for-await it for an async-generator export's stream.
     api: (name, ...args) => serverCall(name, args),
 
-    // Server proxy - tb.server.fn(...) delegates to serverCall. 'log' is special: it's the ungated
-    // diagnostic (serverLog -> /__log, built-in only), so it prints untrusted; everything else is a
-    // gated /__api call into the bulb's own server.ts.
+    // Server proxy - tb.server.fn(...) delegates to serverCall: purely the bulb's own server.ts
+    // exports, every one a gated /__api call. (The ungated diagnostic lives at tb.log, so no
+    // built-in shadows a user export.)
     server: new Proxy({}, {
-      get: (_, name) => name === 'log'
-        ? (...args) => serverLog(...args)
-        : (...args) => serverCall(name, args)
+      get: (_, name) => (...args) => serverCall(name, args)
     }),
 
     // Filesystem - local CLI extension
@@ -1284,7 +1286,7 @@ const something = require('module-name')  // NOT SUPPORTED!
     },
 
     // Receive a value pushed from the terminal via \`typebulb send\` (data-in, the dual of the
-    // ungated tb.server.log). Returns an unsubscribe fn. Inert when embedded \u2014 no server, so no
+    // ungated tb.log). Returns an unsubscribe fn. Inert when embedded \u2014 no server, so no
     // sender; the handler is registered but never fires (cf. tb.models returning []). A handler's
     // non-undefined return (awaited) becomes the reply \`send --wait\` prints (TB-Interrogation.md).
     onMessage: (handler) => {

package/dist/agents/pi/matchu-patchu.ts

@@ -2357,7 +2357,7 @@ var Patcher = class {
 
 // cli/agents/pi/server/piPatcherExtension.ts
 var DESCRIPTION = true ? "Apply unified diffs to files \u2014 tolerant of form, strict about intent. Repairs sloppy AI-generated diffs (mangled headers, whitespace drift, missing prefixes; line numbers can be wrong or absent \u2014 hunks anchor by fuzzy-matched context lines) and applies all hunks atomically when the intent is unambiguous; fails with a precise, typed error when it isn't. Use for multi-hunk edits in one step, or when exact string-replacement editing fails on whitespace or invisible characters." : "Apply unified diffs to files.";
-var BUILD_TAG = true ? "matchu-patchu-pi 0.3.3, built 2026-07-26 13:14:27" : "matchu-patchu-pi dev";
+var BUILD_TAG = true ? "matchu-patchu-pi 0.3.3, built 2026-07-26 14:38:40" : "matchu-patchu-pi dev";
 var errorBlocks = (errors) => {
   const parts = [`Patch failed with ${errors.length} error(s):`];
   for (const e of errors) parts.push("", e.toString());

package/dist/dts/tbTypings.d.ts

@@ -9,9 +9,10 @@
  * 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>`). A non-`undefined` return value (awaited)\n   * becomes the reply `send --wait` prints on stdout \u2014 JSON-serializable, at most one handler\n   * replying \u2014 the structured read-back for self-tests. 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; may return a JSON-serializable reply.\n   * @returns An unsubscribe function.\n   */\n  onMessage(handler: (message: any) => unknown): () => 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    /** Reasoning effort hint: 0=minimal, 1=low, 2=med, 3=high. Mapped to each provider's native mechanism (OpenAI/OpenRouter reasoning effort, Gemini thinking budget, Anthropic adaptive thinking). 0 minimizes reasoning \u2014 a floor, not a guaranteed \"off\": some models still think a little at 0, and adaptive models already self-skip at 1 (low). Level 1 (low) is the sensible default for most work; reach for 0 only when you truly want minimal deliberation. Omit for the model's own default. */\n    effort?: 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    /** Reasoning effort hint: 0=minimal, 1=low, 2=med, 3=high. Mapped to each provider's native mechanism (OpenAI/OpenRouter reasoning effort, Gemini thinking budget, Anthropic adaptive thinking). 0 minimizes reasoning \u2014 a floor, not a guaranteed \"off\": some models still think a little at 0, and adaptive models already self-skip at 1 (low). Level 1 (low) is the sensible default for most work; reach for 0 only when you truly want minimal deliberation. Omit for the model's own default. */\n    effort?: 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   * Relative paths resolve against the bulb's folder (`tb.dir` \u2014\n   * `<bulb-dir>/<filename-stem>/`, created on demand), so\n   * `tb.fs.write('results.json')` lands beside the bulb. `../` reaches sibling\n   * bulbs' folders; everything stays confined to the project (the launch cwd).\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   * The bulb's folder \u2014 absolute path to `<bulb-dir>/<filename-stem>/`\n   * (or its `batches/<name>/` folder when the run is scoped with `--batch`).\n   *\n   * For interop only (handing a path to `server.ts` or a spawned tool):\n   * `tb.fs` already resolves relative paths against it, so bulb code writing\n   * its own files never needs it. CLI only \u2014 throws in editor/published/embedded mode.\n   */\n  readonly dir: string;\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    /** True on the .env-configured default model (TB_AI_PROVIDER + TB_AI_MODEL); absent otherwise */\n    default?: boolean;\n  }>>;\n  /**\n   * Whether the user's own AI keys back `tb.ai`. False means only the\n   * quota-limited courtesy model is available (or no AI at all) \u2014 a bulb\n   * making many AI calls should check this and show a \"use your own keys\"\n   * notice instead of running.\n   */\n  hasOwnKeys(): Promise<boolean>;\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   * Print to the CLI's stdout \u2014 the bulb's log channel, read back with `typebulb logs <file>`.\n   *\n   * Ungated: needs no `server.ts` block and no `--trust`, so a Restricted client-only bulb can\n   * instrument itself. Args cross to the CLI as JSON; where no CLI serves the page (web, embedded,\n   * or a transport failure) it falls back to the browser console. Works in `server.ts` too (same\n   * as `console.log` there).\n   */\n  log(...args: any[]): void;\n  /**\n   * Server-side function proxy.\n   *\n   * In the CLI, calls exported functions from the `**server.ts**` section.\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.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>`). A non-`undefined` return value (awaited)\n   * becomes the reply `send --wait` prints on stdout \u2014 JSON-serializable, at most one handler\n   * replying \u2014 the structured read-back for self-tests. 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; may return a JSON-serializable reply.\n   * @returns An unsubscribe function.\n   */\n  onMessage(handler: (message: any) => unknown): () => 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    /** Reasoning effort hint: 0=minimal, 1=low, 2=med, 3=high. Mapped to each provider's native mechanism (OpenAI/OpenRouter reasoning effort, Gemini thinking budget, Anthropic adaptive thinking). 0 minimizes reasoning \u2014 a floor, not a guaranteed \"off\": some models still think a little at 0, and adaptive models already self-skip at 1 (low). Level 1 (low) is the sensible default for most work; reach for 0 only when you truly want minimal deliberation. Omit for the model's own default. */\n    effort?: 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    /** Reasoning effort hint: 0=minimal, 1=low, 2=med, 3=high. Mapped to each provider's native mechanism (OpenAI/OpenRouter reasoning effort, Gemini thinking budget, Anthropic adaptive thinking). 0 minimizes reasoning \u2014 a floor, not a guaranteed \"off\": some models still think a little at 0, and adaptive models already self-skip at 1 (low). Level 1 (low) is the sensible default for most work; reach for 0 only when you truly want minimal deliberation. Omit for the model's own default. */\n    effort?: 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   * Relative paths resolve against the bulb's folder (`tb.dir` \u2014\n   * `<bulb-dir>/<filename-stem>/`, created on demand), so\n   * `tb.fs.write('results.json')` lands beside the bulb. `../` reaches sibling\n   * bulbs' folders; everything stays confined to the project (the launch cwd).\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   * The bulb's folder \u2014 absolute path to `<bulb-dir>/<filename-stem>/`\n   * (or its `batches/<name>/` folder when the run is scoped with `--batch`).\n   *\n   * For interop only (handing a path to `server.ts` or a spawned tool):\n   * `tb.fs` already resolves relative paths against it, so bulb code writing\n   * its own files never needs it. CLI only \u2014 throws in editor/published/embedded mode.\n   */\n  readonly dir: string;\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    /** True on the .env-configured default model (TB_AI_PROVIDER + TB_AI_MODEL); absent otherwise */\n    default?: boolean;\n  }>>;\n  /**\n   * Whether the user's own AI keys back `tb.ai`. False means only the\n   * quota-limited courtesy model is available (or no AI at all) \u2014 a bulb\n   * making many AI calls should check this and show a \"use your own keys\"\n   * notice instead of running.\n   */\n  hasOwnKeys(): Promise<boolean>;\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).
  *  Only what carries a bulb-specific rule Node can't know — tb.ai, tb.fs, tb.dir (TB-FS.md);
- *  the browser-only helpers are intentionally absent. Must match serverTb.ts's runtime surface. */
-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   * 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    /** Reasoning effort hint: 0=minimal, 1=low, 2=med, 3=high. Mapped to each provider's native mechanism (OpenAI/OpenRouter reasoning effort, Gemini thinking budget, Anthropic adaptive thinking). 0 minimizes reasoning \u2014 a floor, not a guaranteed \"off\": some models still think a little at 0, and adaptive models already self-skip at 1 (low). Level 1 (low) is the sensible default for most work; reach for 0 only when you truly want minimal deliberation. Omit for the model's own default. */\n    effort?: 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    /** Reasoning effort hint: 0=minimal, 1=low, 2=med, 3=high. Mapped to each provider's native mechanism (OpenAI/OpenRouter reasoning effort, Gemini thinking budget, Anthropic adaptive thinking). 0 minimizes reasoning \u2014 a floor, not a guaranteed \"off\": some models still think a little at 0, and adaptive models already self-skip at 1 (low). Level 1 (low) is the sensible default for most work; reach for 0 only when you truly want minimal deliberation. Omit for the model's own default. */\n    effort?: 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   * Relative paths resolve against the bulb's folder (`tb.dir` \u2014\n   * `<bulb-dir>/<filename-stem>/`, created on demand), so\n   * `tb.fs.write('results.json')` lands beside the bulb. `../` reaches sibling\n   * bulbs' folders; everything stays confined to the project (the launch cwd).\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   * The bulb's folder \u2014 absolute path to `<bulb-dir>/<filename-stem>/`\n   * (or its `batches/<name>/` folder when the run is scoped with `--batch`).\n   *\n   * For interop only (handing a path to `server.ts` or a spawned tool):\n   * `tb.fs` already resolves relative paths against it, so bulb code writing\n   * its own files never needs it. CLI only \u2014 throws in editor/published/embedded mode.\n   */\n  readonly dir: string;\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    /** True on the .env-configured default model (TB_AI_PROVIDER + TB_AI_MODEL); absent otherwise */\n    default?: boolean;\n  }>>;\n  /**\n   * Whether the user's own AI keys back `tb.ai`. False means only the\n   * quota-limited courtesy model is available (or no AI at all) \u2014 a bulb\n   * making many AI calls should check this and show a \"use your own keys\"\n   * notice instead of running.\n   */\n  hasOwnKeys(): Promise<boolean>;\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";
+ *  plus the tb.log uniformity exception (serverTb.ts). The browser-only helpers are intentionally
+ *  absent. Must match serverTb.ts's runtime surface. */
+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   * Print to the CLI's stdout \u2014 the same channel as `console.log` here (the server's console IS\n   * the bulb's log). One log verb across blocks: page-side `tb.log` reaches this same stdout.\n   */\n  log(...args: any[]): 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    /** Reasoning effort hint: 0=minimal, 1=low, 2=med, 3=high. Mapped to each provider's native mechanism (OpenAI/OpenRouter reasoning effort, Gemini thinking budget, Anthropic adaptive thinking). 0 minimizes reasoning \u2014 a floor, not a guaranteed \"off\": some models still think a little at 0, and adaptive models already self-skip at 1 (low). Level 1 (low) is the sensible default for most work; reach for 0 only when you truly want minimal deliberation. Omit for the model's own default. */\n    effort?: 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    /** Reasoning effort hint: 0=minimal, 1=low, 2=med, 3=high. Mapped to each provider's native mechanism (OpenAI/OpenRouter reasoning effort, Gemini thinking budget, Anthropic adaptive thinking). 0 minimizes reasoning \u2014 a floor, not a guaranteed \"off\": some models still think a little at 0, and adaptive models already self-skip at 1 (low). Level 1 (low) is the sensible default for most work; reach for 0 only when you truly want minimal deliberation. Omit for the model's own default. */\n    effort?: 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   * Relative paths resolve against the bulb's folder (`tb.dir` \u2014\n   * `<bulb-dir>/<filename-stem>/`, created on demand), so\n   * `tb.fs.write('results.json')` lands beside the bulb. `../` reaches sibling\n   * bulbs' folders; everything stays confined to the project (the launch cwd).\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   * The bulb's folder \u2014 absolute path to `<bulb-dir>/<filename-stem>/`\n   * (or its `batches/<name>/` folder when the run is scoped with `--batch`).\n   *\n   * For interop only (handing a path to `server.ts` or a spawned tool):\n   * `tb.fs` already resolves relative paths against it, so bulb code writing\n   * its own files never needs it. CLI only \u2014 throws in editor/published/embedded mode.\n   */\n  readonly dir: string;\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    /** True on the .env-configured default model (TB_AI_PROVIDER + TB_AI_MODEL); absent otherwise */\n    default?: boolean;\n  }>>;\n  /**\n   * Whether the user's own AI keys back `tb.ai`. False means only the\n   * quota-limited courtesy model is available (or no AI at all) \u2014 a bulb\n   * making many AI calls should check this and show a \"use your own keys\"\n   * notice instead of running.\n   */\n  hasOwnKeys(): Promise<boolean>;\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;AAkQH,kEAAkE;AAClE,eAAO,MAAM,eAAe,g6WAO3B,CAAA;AAED;;mGAEmG;AACnG,eAAO,MAAM,eAAe,mtLAO3B,CAAA"}
+{"version":3,"file":"tbTypings.d.ts","sourceRoot":"","sources":["../../dts/src/tbTypings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA2QH,kEAAkE;AAClE,eAAO,MAAM,eAAe,0tXAO3B,CAAA;AASD;;;wDAGwD;AACxD,eAAO,MAAM,eAAe,s8LAO3B,CAAA"}

package/dist/dts/tbTypings.js

@@ -224,7 +224,7 @@ const onMessage = `
   /**
    * Subscribe to a value pushed from the terminal via \`typebulb send <file> [message]\`.
    *
-   * The dual of \`tb.server.log\` (data out): a value sent *in* from the CLI, no \`--trust\` required.
+   * The dual of \`tb.log\` (data out): a value sent *in* from the CLI, no \`--trust\` required.
    * Use it to start expensive work on demand instead of on load — e.g. \`tb.onMessage(() => start())\`
    * — so hot reloads don't re-trigger it while you edit, and an agent kicks off one run when ready.
    *
@@ -238,13 +238,21 @@ const onMessage = `
    * @returns An unsubscribe function.
    */
   onMessage(handler: (message: any) => unknown): () => void;`;
+const log = `
+  /**
+   * Print to the CLI's stdout — the bulb's log channel, read back with \`typebulb logs <file>\`.
+   *
+   * Ungated: needs no \`server.ts\` block and no \`--trust\`, so a Restricted client-only bulb can
+   * instrument itself. Args cross to the CLI as JSON; where no CLI serves the page (web, embedded,
+   * or a transport failure) it falls back to the browser console. Works in \`server.ts\` too (same
+   * as \`console.log\` there).
+   */
+  log(...args: any[]): void;`;
 const clientServerProxy = `
   /**
    * Server-side function proxy.
    *
    * In the CLI, calls exported functions from the \`**server.ts**\` section.
-   * \`tb.server.log(...)\` is a built-in that prints to CLI stdout (falls back to console.log on web).
-   * User exports override built-ins of the same name.
    *
    * A normal export is awaited for its result (\`await tb.server.fn()\`). An \`async function*\`
    * export streams: \`for await (const chunk of tb.server.gen())\`. The call object supports both;
@@ -257,18 +265,25 @@ export const clientTbTypings = `${aiChunkType}
  * Typebulb utilities namespace.
  * Type \`tb.\` to discover available helpers.
  */
-declare const tb: {${dataAndJson}${clientOnlyMembers}${insight}${clientServerProxy}${onMessage}${ai}${fs}${dir}${models}${theme}${mode}
+declare const tb: {${dataAndJson}${clientOnlyMembers}${insight}${log}${clientServerProxy}${onMessage}${ai}${fs}${dir}${models}${theme}${mode}
 };
 `;
+const serverLog = `
+  /**
+   * Print to the CLI's stdout — the same channel as \`console.log\` here (the server's console IS
+   * the bulb's log). One log verb across blocks: page-side \`tb.log\` reaches this same stdout.
+   */
+  log(...args: any[]): void;`;
 /** Typebulb globals available in Node-side code (server.ts).
  *  Only what carries a bulb-specific rule Node can't know — tb.ai, tb.fs, tb.dir (TB-FS.md);
- *  the browser-only helpers are intentionally absent. Must match serverTb.ts's runtime surface. */
+ *  plus the tb.log uniformity exception (serverTb.ts). The browser-only helpers are intentionally
+ *  absent. Must match serverTb.ts's runtime surface. */
 export const serverTbTypings = `${aiChunkType}
 /**
  * Typebulb utilities namespace (server-side).
  * Type \`tb.\` to discover available helpers.
  */
-declare const tb: {${ai}${fs}${dir}${models}${mode}
+declare const tb: {${serverLog}${ai}${fs}${dir}${models}${mode}
 };
 `;
 //# sourceMappingURL=tbTypings.js.map

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;;;;;;;;;;;IAWd,CAAA;AAEJ,oGAAoG;AACpG,MAAM,WAAW,GAAG;;;;;CAKnB,CAAA;AAED,MAAM,EAAE,GAAG;;;;;;;;;OASJ,SAAS;;;;;;;;;;;;;;aAcH,SAAS;KACjB,CAAA;AAEL,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;kCAwBmB,CAAA;AAElC,MAAM,KAAK,GAAG;;;;;;;;;;;;uCAYyB,CAAA;AAEvC,MAAM,IAAI,GAAG;;;;;;;;;;uDAU0C,CAAA;AAEvD,MAAM,EAAE,GAAG;;;;;;;;;;;;;;;;;KAiBN,CAAA;AAEL,MAAM,GAAG,GAAG;;;;;;;;;wBASY,CAAA;AAExB,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAmEA,CAAA;AAE1B,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;6DAiB2C,CAAA;AAE7D,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,GAAG,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI;;CAErI,CAAA;AAED;;mGAEmG;AACnG,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,WAAW;;;;;qBAKxB,EAAE,GAAG,EAAE,GAAG,GAAG,GAAG,MAAM,GAAG,IAAI;;CAEjD,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;;;;;;;;;;;;;;;;;;;;;;;;kCAwBmB,CAAA;AAElC,MAAM,KAAK,GAAG;;;;;;;;;;;;uCAYyB,CAAA;AAEvC,MAAM,IAAI,GAAG;;;;;;;;;;uDAU0C,CAAA;AAEvD,MAAM,EAAE,GAAG;;;;;;;;;;;;;;;;;KAiBN,CAAA;AAEL,MAAM,GAAG,GAAG;;;;;;;;;wBASY,CAAA;AAExB,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAmEA,CAAA;AAE1B,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;6DAiB2C,CAAA;AAE7D,MAAM,GAAG,GAAG;;;;;;;;;6BASiB,CAAA;AAE7B,MAAM,iBAAiB,GAAG;;;;;;;;;;iFAUuD,CAAA;AAEjF,kEAAkE;AAClE,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,WAAW;;;;;qBAKxB,WAAW,GAAG,iBAAiB,GAAG,OAAO,GAAG,GAAG,GAAG,iBAAiB,GAAG,SAAS,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI;;CAE3I,CAAA;AAED,MAAM,SAAS,GAAG;;;;;6BAKW,CAAA;AAE7B;;;wDAGwD;AACxD,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,WAAW;;;;;qBAKxB,SAAS,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,GAAG,MAAM,GAAG,IAAI;;CAE7D,CAAA"}