typebulb 0.48.0 → 0.49.0

package/dist/format/index.d.ts

@@ -5,6 +5,7 @@ export * from './config.js';
 export * from './detection.js';
 export * from './chunks.js';
 export * from './slug.js';
+export * from './mode.js';
 export * from './pageShell.js';
 export { escapeYamlString, unescapeYamlString } from './yaml.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/format/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../format/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../format/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA"}

package/dist/format/index.js

@@ -5,6 +5,7 @@ export * from './config.js';
 export * from './detection.js';
 export * from './chunks.js';
 export * from './slug.js';
+export * from './mode.js';
 export * from './pageShell.js';
 export { escapeYamlString, unescapeYamlString } from './yaml.js';
 //# sourceMappingURL=index.js.map

package/dist/format/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../format/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../format/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA"}

package/dist/format/mode.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The `tb.mode` values, owned in one place (TB-Mode.md). Every producer emits mode as a
+ * *string* baked into a sandbox page, so a hand-typed copy compiles clean and fails only at
+ * runtime inside the frame; producers interpolate `MODE` instead. It lives in `format`
+ * because the client and the CLI both import `typebulb/format`, and runtime imports neither.
+ *
+ * Mode names the host surface, never the capability — `'local'` spans Restricted and Trusted.
+ * Bulbs ask for capability directly (`tb.aiAccess()`).
+ */
+export declare const MODE: {
+    /** The user's machine, via the CLI. */
+    readonly local: "local";
+    /** typebulb.com's editor, in a frame beside the code. */
+    readonly ide: "ide";
+    /** The bulb's own page on typebulb.com. */
+    readonly published: "published";
+    /** Inline in an agent's transcript, rendered by the mirror (bulb-in-a-bulb). */
+    readonly inline: "inline";
+};
+export type TbMode = (typeof MODE)[keyof typeof MODE];
+/** The union as it appears in the emitted `tb` typings — generated, so the `.d.ts` can't drift from MODE. */
+export declare const modeUnion: string;
+//# sourceMappingURL=mode.d.ts.map

package/dist/format/mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.d.ts","sourceRoot":"","sources":["../../format/src/mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,IAAI;IACf,uCAAuC;;IAEvC,yDAAyD;;IAEzD,2CAA2C;;IAE3C,gFAAgF;;CAExE,CAAA;AAEV,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,OAAO,IAAI,CAAC,CAAA;AAErD,6GAA6G;AAC7G,eAAO,MAAM,SAAS,EAAE,MAA2D,CAAA"}

package/dist/format/mode.js

@@ -0,0 +1,22 @@
+/**
+ * The `tb.mode` values, owned in one place (TB-Mode.md). Every producer emits mode as a
+ * *string* baked into a sandbox page, so a hand-typed copy compiles clean and fails only at
+ * runtime inside the frame; producers interpolate `MODE` instead. It lives in `format`
+ * because the client and the CLI both import `typebulb/format`, and runtime imports neither.
+ *
+ * Mode names the host surface, never the capability — `'local'` spans Restricted and Trusted.
+ * Bulbs ask for capability directly (`tb.aiAccess()`).
+ */
+export const MODE = {
+    /** The user's machine, via the CLI. */
+    local: 'local',
+    /** typebulb.com's editor, in a frame beside the code. */
+    ide: 'ide',
+    /** The bulb's own page on typebulb.com. */
+    published: 'published',
+    /** Inline in an agent's transcript, rendered by the mirror (bulb-in-a-bulb). */
+    inline: 'inline',
+};
+/** The union as it appears in the emitted `tb` typings — generated, so the `.d.ts` can't drift from MODE. */
+export const modeUnion = Object.values(MODE).map(v => `'${v}'`).join(' | ');
+//# sourceMappingURL=mode.js.map

package/dist/format/mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.js","sourceRoot":"","sources":["../../format/src/mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,uCAAuC;IACvC,KAAK,EAAE,OAAO;IACd,yDAAyD;IACzD,GAAG,EAAE,KAAK;IACV,2CAA2C;IAC3C,SAAS,EAAE,WAAW;IACtB,gFAAgF;IAChF,MAAM,EAAE,QAAQ;CACR,CAAA;AAIV,6GAA6G;AAC7G,MAAM,CAAC,MAAM,SAAS,GAAW,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA"}

package/dist/format/pageShell.d.ts

@@ -12,9 +12,9 @@
  *
  *  `body { display: flow-root }` makes body a block formatting context so a first/
  *  last child's vertical margin (author's, or a UA default like `<h1>`'s) can't
- *  collapse out through body — the embed auto-height reports `body.scrollHeight`
+ *  collapse out through body — the inline bulb auto-height reports `body.scrollHeight`
  *  (cli/bulb/template.ts), and an escaped margin sizes the frame short → clipped
- *  content + premature scrollbar (TB-Agent-Mirror-Embed.md Invariant 3). Don't drop it.
+ *  content + premature scrollbar (TB-Agent-Mirror-Inline.md Invariant 3). Don't drop it.
  *
  *  `canvas { max-width: 100% }` keeps a canvas inside its container the way
  *  responsive `img` does: a canvas's backing store is `devicePixelRatio`-scaled, so
@@ -26,8 +26,8 @@ export declare const baseResetStyle = "    *, *::before, *::after { box-sizing:
 /** The definite-height chain, for pages whose frame has a definite height — the CLI's
  *  standalone page and every typebulb.com context (all frame-sized iframes) — so a
  *  fill bulb (`height: 100%` root) resolves against the window instead of collapsing
- *  to zero. NEVER for a content-measured embed: there `body` must stay content-height
+ *  to zero. NEVER for a content-measured inline bulb: there `body` must stay content-height
  *  or the auto-height protocol's `body.scrollHeight` can no longer shrink the frame
- *  (TB-Agent-Mirror-Embed.md). */
+ *  (TB-Agent-Mirror-Inline.md). */
 export declare const pageHeightStyle = "    html, body { height: 100%; }";
 //# sourceMappingURL=pageShell.d.ts.map

package/dist/format/pageShell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pageShell.d.ts","sourceRoot":"","sources":["../../format/src/pageShell.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;qFAgBqF;AACrF,eAAO,MAAM,cAAc,6SAI2B,CAAA;AAEtD;;;;;kCAKkC;AAClC,eAAO,MAAM,eAAe,qCAAqC,CAAA"}
+{"version":3,"file":"pageShell.d.ts","sourceRoot":"","sources":["../../format/src/pageShell.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;qFAgBqF;AACrF,eAAO,MAAM,cAAc,6SAI2B,CAAA;AAEtD;;;;;mCAKmC;AACnC,eAAO,MAAM,eAAe,qCAAqC,CAAA"}

package/dist/format/pageShell.js

@@ -12,9 +12,9 @@
  *
  *  `body { display: flow-root }` makes body a block formatting context so a first/
  *  last child's vertical margin (author's, or a UA default like `<h1>`'s) can't
- *  collapse out through body — the embed auto-height reports `body.scrollHeight`
+ *  collapse out through body — the inline bulb auto-height reports `body.scrollHeight`
  *  (cli/bulb/template.ts), and an escaped margin sizes the frame short → clipped
- *  content + premature scrollbar (TB-Agent-Mirror-Embed.md Invariant 3). Don't drop it.
+ *  content + premature scrollbar (TB-Agent-Mirror-Inline.md Invariant 3). Don't drop it.
  *
  *  `canvas { max-width: 100% }` keeps a canvas inside its container the way
  *  responsive `img` does: a canvas's backing store is `devicePixelRatio`-scaled, so
@@ -30,8 +30,8 @@ export const baseResetStyle = `    *, *::before, *::after { box-sizing: border-b
 /** The definite-height chain, for pages whose frame has a definite height — the CLI's
  *  standalone page and every typebulb.com context (all frame-sized iframes) — so a
  *  fill bulb (`height: 100%` root) resolves against the window instead of collapsing
- *  to zero. NEVER for a content-measured embed: there `body` must stay content-height
+ *  to zero. NEVER for a content-measured inline bulb: there `body` must stay content-height
  *  or the auto-height protocol's `body.scrollHeight` can no longer shrink the frame
- *  (TB-Agent-Mirror-Embed.md). */
+ *  (TB-Agent-Mirror-Inline.md). */
 export const pageHeightStyle = `    html, body { height: 100%; }`;
 //# sourceMappingURL=pageShell.js.map

package/dist/format/pageShell.js.map

@@ -1 +1 @@
-{"version":3,"file":"pageShell.js","sourceRoot":"","sources":["../../format/src/pageShell.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;qFAgBqF;AACrF,MAAM,CAAC,MAAM,cAAc,GAAG;;;;sDAIwB,CAAA;AAEtD;;;;;kCAKkC;AAClC,MAAM,CAAC,MAAM,eAAe,GAAG,kCAAkC,CAAA"}
+{"version":3,"file":"pageShell.js","sourceRoot":"","sources":["../../format/src/pageShell.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;qFAgBqF;AACrF,MAAM,CAAC,MAAM,cAAc,GAAG;;;;sDAIwB,CAAA;AAEtD;;;;;mCAKmC;AACnC,MAAM,CAAC,MAAM,eAAe,GAAG,kCAAkC,CAAA"}

package/dist/format/parse.d.ts

@@ -25,7 +25,7 @@ export interface ParsedBulb {
      * closing fence — i.e. where the bulb's body ends. NOT end-of-content: trailing lines that set no block
      * (prose, a stray `---`) sit beyond it. Equals the line after the frontmatter when no block was captured.
      * Lets a caller slice a bulb out of surrounding prose without swallowing what follows it (see
-     * `findEmbeddedBulbs`).
+     * `findUnfencedBulbs`).
      */
     bodyEndLine: number;
 }
@@ -46,13 +46,13 @@ export declare function validateBulbStructure(content: string): string[];
 /** A bulb found sitting "naked" in prose — frontmatter and blocks dumped straight into the text with no
  * enclosing ````bulb```` fence. `start`/`end` are the half-open `[start, end)` line range (0-based, into
  * `content.split('\n')`); `source` is that slice, ready to feed back to `parseBulb` or a renderer. */
-export interface EmbeddedBulb {
+export interface UnfencedBulb {
     start: number;
     end: number;
     source: string;
 }
 /**
- * Find bulbs embedded unfenced in arbitrary prose. The normal path wraps a bulb in a ````bulb```` fence
+ * Find bulbs inline unfenced in arbitrary prose. The normal path wraps a bulb in a ````bulb```` fence
  * (and the mislabel-tolerant host promotes a fence whose body parses); but some non-SOTA models — Kimi
  * notably — skip the fence entirely and dump the raw frontmatter + blocks into the message, using `---`
  * thematic breaks as ad-hoc delimiters, so no fence token ever wraps the bulb. This scans for that.
@@ -61,10 +61,10 @@ export interface EmbeddedBulb {
  * mislabel tolerance leans on, so we anchor on a `---` line, run `parseBulb` from there, and accept it
  * only if it yields at least one real block. The extent is `parseBulb`'s own `bodyEndLine` (just past the
  * last captured block) — NOT end-of-text — so trailing prose after the bulb (Kimi's closing `---`, a
- * follow-up paragraph) stays prose instead of being swallowed into the embed. Returned spans are
+ * follow-up paragraph) stays prose instead of being swallowed into the inline bulb. Returned spans are
  * non-overlapping and in document order; the caller slices the surrounding prose around them.
  */
-export declare function findEmbeddedBulbs(content: string): EmbeddedBulb[];
+export declare function findUnfencedBulbs(content: string): UnfencedBulb[];
 /** Convert a parsed bulb to a structured per-kind object (missing blocks become ''). */
 export declare function toBulbData(parsed: ParsedBulb): BulbData;
 //# sourceMappingURL=parse.d.ts.map

package/dist/format/parse.js

@@ -137,7 +137,7 @@ export function validateBulbStructure(content) {
     return parseBulb(content)?.warnings ?? [];
 }
 /**
- * Find bulbs embedded unfenced in arbitrary prose. The normal path wraps a bulb in a ````bulb```` fence
+ * Find bulbs inline unfenced in arbitrary prose. The normal path wraps a bulb in a ````bulb```` fence
  * (and the mislabel-tolerant host promotes a fence whose body parses); but some non-SOTA models — Kimi
  * notably — skip the fence entirely and dump the raw frontmatter + blocks into the message, using `---`
  * thematic breaks as ad-hoc delimiters, so no fence token ever wraps the bulb. This scans for that.
@@ -146,10 +146,10 @@ export function validateBulbStructure(content) {
  * mislabel tolerance leans on, so we anchor on a `---` line, run `parseBulb` from there, and accept it
  * only if it yields at least one real block. The extent is `parseBulb`'s own `bodyEndLine` (just past the
  * last captured block) — NOT end-of-text — so trailing prose after the bulb (Kimi's closing `---`, a
- * follow-up paragraph) stays prose instead of being swallowed into the embed. Returned spans are
+ * follow-up paragraph) stays prose instead of being swallowed into the inline bulb. Returned spans are
  * non-overlapping and in document order; the caller slices the surrounding prose around them.
  */
-export function findEmbeddedBulbs(content) {
+export function findUnfencedBulbs(content) {
     const lines = content.split('\n');
     const found = [];
     let i = 0;