@desktalk/core 0.1.0-alpha.1

package/dist/services/ai/generate-icon-tool.js

@@ -0,0 +1,58 @@
+import { writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { Type } from '@sinclair/typebox';
+import { broadcastEvent } from '../messaging.js';
+const generateIconSchema = Type.Object({
+    liveAppId: Type.String({ description: 'Directory name of the LiveApp to generate an icon for.' }),
+    description: Type.String({ description: 'Short visual description of the desired app icon.' }),
+});
+export function createGenerateIconTool(options) {
+    const { imageGenerationService, getCurrentUsername, workspaceDataDir } = options;
+    return {
+        name: 'generate_icon',
+        label: 'Generate Icon',
+        description: 'Generate a 256x256 PNG icon for an existing LiveApp and save it as icon.png in the LiveApp directory.',
+        promptSnippet: 'Generate or regenerate an icon for any LiveApp.',
+        promptGuidelines: [
+            'Use this after `create_liveapp`, or later for an existing LiveApp that has no icon yet or needs a refreshed icon.',
+            'Pass the LiveApp directory name as `liveAppId` and a short visual description as `description`.',
+            'If you need to identify an existing LiveApp, use the Desktop Context, `desktop` action="list", or a focused Preview window state to find its LiveApp ID.',
+            'If this tool reports `{ ok: false }`, continue normally without retrying. The app can keep the default icon.',
+        ],
+        parameters: generateIconSchema,
+        async execute(_toolCallId, params) {
+            const input = params;
+            const liveAppDir = join(workspaceDataDir, 'home', getCurrentUsername(), '.data', 'liveapps', input.liveAppId);
+            const iconPath = join(liveAppDir, 'icon.png');
+            try {
+                const result = await imageGenerationService.generateIcon(input.description);
+                writeFileSync(iconPath, result.image);
+                broadcastEvent('preview', 'liveapps.changed', {
+                    path: iconPath,
+                    reason: 'icon-generated',
+                });
+                const payload = {
+                    ok: true,
+                    path: iconPath,
+                    provider: result.provider,
+                    model: result.model,
+                };
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }],
+                    details: payload,
+                };
+            }
+            catch (error) {
+                const payload = {
+                    ok: false,
+                    reason: error instanceof Error ? error.message : String(error),
+                };
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }],
+                    details: payload,
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=generate-icon-tool.js.map

package/dist/services/ai/generate-icon-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-icon-tool.js","sourceRoot":"","sources":["../../../src/services/ai/generate-icon-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,MAAM,kBAAkB,GAAG,IAAI,CAAC,MAAM,CAAC;IACrC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,wDAAwD,EAAE,CAAC;IACjG,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,mDAAmD,EAAE,CAAC;CAC/F,CAAC,CAAC;AAaH,MAAM,UAAU,sBAAsB,CAAC,OAAgC;IACrE,MAAM,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC;IAEjF,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,uGAAuG;QACzG,aAAa,EAAE,iDAAiD;QAChE,gBAAgB,EAAE;YAChB,mHAAmH;YACnH,iGAAiG;YACjG,0JAA0J;YAC1J,8GAA8G;SAC/G;QACD,UAAU,EAAE,kBAAkB;QAC9B,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM;YAC/B,MAAM,KAAK,GAAG,MAA4B,CAAC;YAC3C,MAAM,UAAU,GAAG,IAAI,CACrB,gBAAgB,EAChB,MAAM,EACN,kBAAkB,EAAE,EACpB,OAAO,EACP,UAAU,EACV,KAAK,CAAC,SAAS,CAChB,CAAC;YACF,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YAE9C,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,YAAY,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;gBAC5E,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;gBACtC,cAAc,CAAC,SAAS,EAAE,kBAAkB,EAAE;oBAC5C,IAAI,EAAE,QAAQ;oBACd,MAAM,EAAE,gBAAgB;iBACzB,CAAC,CAAC;gBACH,MAAM,OAAO,GAAG;oBACd,EAAE,EAAE,IAAI;oBACR,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,KAAK,EAAE,MAAM,CAAC,KAAK;iBACpB,CAAC;gBACF,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;oBACnE,OAAO,EAAE,OAAO;iBACjB,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG;oBACd,EAAE,EAAE,KAAK;oBACT,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBAC/D,CAAC;gBACF,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;oBACnE,OAAO,EAAE,OAAO;iBACjB,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/services/ai/html-bridge-script.d.ts

@@ -0,0 +1,2 @@
+export { createHtmlBridgeScript } from '@desktalk/sdk';
+//# sourceMappingURL=html-bridge-script.d.ts.map

package/dist/services/ai/html-bridge-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-bridge-script.d.ts","sourceRoot":"","sources":["../../../src/services/ai/html-bridge-script.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC"}

package/dist/services/ai/html-bridge-script.js

@@ -0,0 +1,2 @@
+export { createHtmlBridgeScript } from '@desktalk/sdk';
+//# sourceMappingURL=html-bridge-script.js.map

package/dist/services/ai/html-bridge-script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-bridge-script.js","sourceRoot":"","sources":["../../../src/services/ai/html-bridge-script.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC"}

package/dist/services/ai/html-guidelines-tool.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from '@mariozechner/pi-coding-agent';
+export declare function createReadHtmlGuidelinesTool(): ToolDefinition;
+//# sourceMappingURL=html-guidelines-tool.d.ts.map

package/dist/services/ai/html-guidelines-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-guidelines-tool.d.ts","sourceRoot":"","sources":["../../../src/services/ai/html-guidelines-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAiJpE,wBAAgB,4BAA4B,IAAI,cAAc,CAe7D"}

package/dist/services/ai/html-guidelines-tool.js

@@ -0,0 +1,157 @@
+import { Type } from '@sinclair/typebox';
+const readHtmlGuidelinesSchema = Type.Object({});
+const HTML_GUIDELINES = [
+    '# DeskTalk HTML Guidelines',
+    '',
+    'Use these rules before calling `generate_html`.',
+    '',
+    '## Required',
+    '- Use semantic `--dt-*` CSS custom properties for all colors.',
+    '- Never hardcode hex, rgb, rgba, hsl, or oklch values.',
+    '- Provide a complete HTML document with `<html>`, `<head>`, and `<body>`.',
+    '- Inline CSS and JavaScript; do not reference external files or CDNs unless explicitly needed.',
+    '',
+    '## Semantic Tokens',
+    '- Backgrounds: `--dt-bg`, `--dt-bg-subtle`, `--dt-surface`, `--dt-surface-hover`, `--dt-surface-active`',
+    '- Text: `--dt-text`, `--dt-text-secondary`, `--dt-text-muted`, `--dt-text-on-accent`',
+    '- Borders: `--dt-border`, `--dt-border-subtle`, `--dt-border-strong`',
+    '- Accent: `--dt-accent`, `--dt-accent-hover`, `--dt-accent-active`, `--dt-accent-subtle`, `--dt-accent-ghost`',
+    '- Status: `--dt-danger`, `--dt-danger-subtle`, `--dt-success`, `--dt-success-subtle`, `--dt-warning`, `--dt-warning-subtle`, `--dt-info`, `--dt-info-subtle`',
+    '- Effects: `--dt-overlay`, `--dt-glass`, `--dt-shadow-color`',
+    '',
+    '## Auto-Injected Styles',
+    '- A `<link data-dt-theme>` stylesheet is injected automatically at execution time, loaded from the DeskTalk server.',
+    "- That stylesheet contains the full DeskTalk `:root { --dt-* }` token set for the user's current accent color and theme mode.",
+    '- It also contains a base stylesheet for `body`, headings, paragraphs, links, tables, cards, buttons, badges, `code`, and `pre`.',
+    '- A `window.DeskTalk` bridge is also injected automatically for generated HTML previews.',
+    '- `await DeskTalk.getState(selector)` supports: `desktop.summary`, `desktop.windows`, `desktop.focusedWindow`, `theme.current`, and `preview.context`.',
+    '- `DeskTalk.exec` and `DeskTalk.execute` are equivalent.',
+    '- Both accept a shell string: `await DeskTalk.exec("ls -la")` — this is automatically wrapped as `sh -c "ls -la"`.',
+    '- Both also accept explicit arguments: `await DeskTalk.exec("ls", ["-la"])` — this runs without a shell.',
+    '- An optional options object can be passed as the last argument: `await DeskTalk.exec("git", ["status"], { cwd: "subdir" })`.',
+    '- Commands on the dangerous list such as `rm`, `chmod`, `sudo`, `kill`, or destructive `git` subcommands trigger a native confirmation dialog before execution.',
+    '- Catastrophic commands such as filesystem formatting or `rm` against `/` are blocked outright.',
+    '- Available utility classes: `.badge`, `.badge-danger`, `.badge-success`, `.badge-warning`, `.badge-info`, `.btn`, `.text-muted`, `.text-secondary`, `.accent-bg`.',
+    '- **Do NOT create custom container classes** (e.g. `.card`, `.panel`, `.box`, `.section`, `.tile`, `.info-card`, `.stat-box`, or similar). Use `<dt-card>` for all visually distinct content sections (see Layout Rules below).',
+    '- Prefer those semantic tokens and utility classes over custom color literals or one-off palette definitions.',
+    '',
+    '## Typography (Pre-Styled — Do NOT Override)',
+    '- **Headings (`h1`–`h6`) and paragraphs (`p`) are fully styled by the injected base stylesheet.** Their font-size, font-weight, line-height, color, and spacing are pre-defined.',
+    '- **NEVER write CSS rules, inline `style` attributes, or `<style>` blocks that target `h1`, `h2`, `h3`, `h4`, `h5`, `h6`, or `p`.** This includes font-size, font-weight, font-family, color, margin, padding, line-height, letter-spacing, and text-transform.',
+    '- Simply use the native HTML tags and the injected styles will apply automatically:',
+    '  - `<h1>` — 2rem, bold (700), tight letter-spacing. Use for main page titles.',
+    '  - `<h2>` — 1.5rem, semibold (600). Use for section titles.',
+    '  - `<h3>` — 1.25rem, semibold (600). Use for subsection titles.',
+    '  - `<h4>` — 1.125rem, semibold (600). Use for card/group headings.',
+    '  - `<h5>` — 1rem, semibold (600). Use for minor headings.',
+    '  - `<h6>` — 0.875rem, semibold (600), uppercase. Use for label-style headings.',
+    '  - `<p>` — 1rem, normal weight, secondary text color. Use for body text.',
+    '- To change text color, use the utility classes `.text-muted` or `.text-secondary`, or apply `color` via `--dt-*` tokens on a wrapper — **not** on the heading/paragraph itself.',
+    '',
+    '## Layout Rules — Content Sections',
+    '- **Every visually distinct content block MUST be wrapped in a `<dt-card>`.** This includes anything you would otherwise put in a styled `<div>` with background, border, padding, or shadow — such as cards, panels, tiles, info boxes, stat blocks, sections, containers, or groups.',
+    '- **NEVER create a `<div>` (or `<section>`) with custom CSS classes for layout containers.** No `.card`, `.panel`, `.box`, `.tile`, `.info-card`, `.stat-box`, `.section-block`, `.container`, or any similar class. Use `<dt-card>` instead.',
+    '- **NEVER write CSS that styles a `<div>` to look like a container** (e.g. adding background, border, border-radius, padding, or box-shadow to a class). That is what `<dt-card>` already provides.',
+    '- Use plain `<div>` only for structural layout (flexbox/grid wrappers with no visual styling beyond `display`, `gap`, `flex`, `grid`, `align-items`, `justify-content`, `width`, `max-width`, and `margin`).',
+    '',
+    '## DeskTalk Web Components',
+    '- The `@desktalk/ui` component library is **automatically loaded** via a `<script>` tag injected into every generated HTML preview.',
+    '- All `<dt-*>` custom elements are registered and ready to use — no additional scripts or imports needed.',
+    '',
+    '### `<dt-card>`',
+    '- Use for **any visually grouped content**: information panels, stat displays, status sections, feature cards, list items with backgrounds, settings groups, etc.',
+    '- A card container with a **solid accent-colored border** and **no border-radius**.',
+    '- Attributes:',
+    '  - `variant` — `"default"` (solid surface background), `"outlined"` (transparent background), `"filled"` (accent-subtle background). Default is `"default"`.',
+    '- Place any content inside as children (headings, paragraphs, buttons, etc.).',
+    '- Example — stat display:',
+    '  ```html',
+    '  <div style="display: grid; grid-template-columns: repeat(3, 1fr); gap: 16px;">',
+    '    <dt-card>',
+    '      <h6>CPU Usage</h6>',
+    '      <h2>42%</h2>',
+    '      <p>Normal load</p>',
+    '    </dt-card>',
+    '    <dt-card>',
+    '      <h6>Memory</h6>',
+    '      <h2>8.2 GB</h2>',
+    '      <p>of 16 GB used</p>',
+    '    </dt-card>',
+    '    <dt-card variant="filled">',
+    '      <h6>Disk</h6>',
+    '      <h2>256 GB</h2>',
+    '      <p>free space</p>',
+    '    </dt-card>',
+    '  </div>',
+    '  ```',
+    '- Example — simple info panel:',
+    '  ```html',
+    '  <dt-card variant="outlined">',
+    '    <h3>Notice</h3>',
+    '    <p>This card has a transparent background.</p>',
+    '  </dt-card>',
+    '  ```',
+    '',
+    '### `<dt-tooltip>`',
+    '- A tooltip that appears on hover/focus around its slotted child.',
+    '- Attributes: `content` (text), `placement` (top|bottom|left|right), `delay` (ms), `disabled`.',
+    '- Example:',
+    '  ```html',
+    '  <dt-tooltip content="Save file" placement="top">',
+    '    <button class="btn">Save</button>',
+    '  </dt-tooltip>',
+    '  ```',
+    '',
+    '## Bridge Examples',
+    '```html',
+    '<script>',
+    '  async function loadDesktopState() {',
+    "    const desktop = await window.DeskTalk.getState('desktop.summary');",
+    '    console.log(desktop.windows);',
+    '  }',
+    '',
+    '  async function runCommand() {',
+    '    // Shell-style (simple, recommended for one-liners):',
+    "    const top = await window.DeskTalk.exec('top -l 1 -n 0 | head -12');",
+    '    console.log(top.stdout);',
+    '',
+    '    // Explicit args (no shell, safer for untrusted input):',
+    "    const git = await window.DeskTalk.exec('git', ['status', '--short']);",
+    '    console.log(git.stdout);',
+    '  }',
+    '</script>',
+    '```',
+    '',
+    '## Example',
+    '```html',
+    '<h1>Dashboard</h1>',
+    '<div style="display: grid; grid-template-columns: repeat(2, 1fr); gap: 16px;">',
+    '  <dt-card>',
+    '    <h3>Status</h3>',
+    '    <p>All systems operational.</p>',
+    '    <span class="badge badge-success">Online</span>',
+    '  </dt-card>',
+    '  <dt-card variant="outlined">',
+    '    <h3>Activity</h3>',
+    '    <p>12 events in the last hour.</p>',
+    '    <button class="btn">View All</button>',
+    '  </dt-card>',
+    '</div>',
+    '```',
+].join('\n');
+export function createReadHtmlGuidelinesTool() {
+    return {
+        name: 'read_html_guidelines',
+        label: 'Read HTML Guidelines',
+        description: 'Read the detailed DeskTalk HTML styling rules for generate_html, including allowed color tokens, injected classes, and examples.',
+        promptSnippet: 'Read detailed styling rules before using generate_html.',
+        parameters: readHtmlGuidelinesSchema,
+        async execute() {
+            return {
+                content: [{ type: 'text', text: HTML_GUIDELINES }],
+                details: { ok: true },
+            };
+        },
+    };
+}
+//# sourceMappingURL=html-guidelines-tool.js.map

package/dist/services/ai/html-guidelines-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-guidelines-tool.js","sourceRoot":"","sources":["../../../src/services/ai/html-guidelines-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,MAAM,wBAAwB,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEjD,MAAM,eAAe,GAAG;IACtB,4BAA4B;IAC5B,EAAE;IACF,iDAAiD;IACjD,EAAE;IACF,aAAa;IACb,+DAA+D;IAC/D,wDAAwD;IACxD,2EAA2E;IAC3E,gGAAgG;IAChG,EAAE;IACF,oBAAoB;IACpB,yGAAyG;IACzG,sFAAsF;IACtF,sEAAsE;IACtE,+GAA+G;IAC/G,8JAA8J;IAC9J,8DAA8D;IAC9D,EAAE;IACF,yBAAyB;IACzB,qHAAqH;IACrH,+HAA+H;IAC/H,kIAAkI;IAClI,0FAA0F;IAC1F,wJAAwJ;IACxJ,0DAA0D;IAC1D,oHAAoH;IACpH,0GAA0G;IAC1G,+HAA+H;IAC/H,iKAAiK;IACjK,iGAAiG;IACjG,oKAAoK;IACpK,iOAAiO;IACjO,+GAA+G;IAC/G,EAAE;IACF,8CAA8C;IAC9C,kLAAkL;IAClL,iQAAiQ;IACjQ,qFAAqF;IACrF,gFAAgF;IAChF,8DAA8D;IAC9D,kEAAkE;IAClE,qEAAqE;IACrE,4DAA4D;IAC5D,iFAAiF;IACjF,2EAA2E;IAC3E,kLAAkL;IAClL,EAAE;IACF,oCAAoC;IACpC,wRAAwR;IACxR,+OAA+O;IAC/O,qMAAqM;IACrM,8MAA8M;IAC9M,EAAE;IACF,4BAA4B;IAC5B,qIAAqI;IACrI,2GAA2G;IAC3G,EAAE;IACF,iBAAiB;IACjB,mKAAmK;IACnK,qFAAqF;IACrF,eAAe;IACf,+JAA+J;IAC/J,+EAA+E;IAC/E,2BAA2B;IAC3B,WAAW;IACX,kFAAkF;IAClF,eAAe;IACf,0BAA0B;IAC1B,oBAAoB;IACpB,0BAA0B;IAC1B,gBAAgB;IAChB,eAAe;IACf,uBAAuB;IACvB,uBAAuB;IACvB,4BAA4B;IAC5B,gBAAgB;IAChB,gCAAgC;IAChC,qBAAqB;IACrB,uBAAuB;IACvB,yBAAyB;IACzB,gBAAgB;IAChB,UAAU;IACV,OAAO;IACP,gCAAgC;IAChC,WAAW;IACX,gCAAgC;IAChC,qBAAqB;IACrB,oDAAoD;IACpD,cAAc;IACd,OAAO;IACP,EAAE;IACF,oBAAoB;IACpB,mEAAmE;IACnE,gGAAgG;IAChG,YAAY;IACZ,WAAW;IACX,oDAAoD;IACpD,uCAAuC;IACvC,iBAAiB;IACjB,OAAO;IACP,EAAE;IACF,oBAAoB;IACpB,SAAS;IACT,UAAU;IACV,uCAAuC;IACvC,wEAAwE;IACxE,mCAAmC;IACnC,KAAK;IACL,EAAE;IACF,iCAAiC;IACjC,0DAA0D;IAC1D,yEAAyE;IACzE,8BAA8B;IAC9B,EAAE;IACF,6DAA6D;IAC7D,2EAA2E;IAC3E,8BAA8B;IAC9B,KAAK;IACL,WAAW;IACX,KAAK;IACL,EAAE;IACF,YAAY;IACZ,SAAS;IACT,oBAAoB;IACpB,gFAAgF;IAChF,aAAa;IACb,qBAAqB;IACrB,qCAAqC;IACrC,qDAAqD;IACrD,cAAc;IACd,gCAAgC;IAChC,uBAAuB;IACvB,wCAAwC;IACxC,2CAA2C;IAC3C,cAAc;IACd,QAAQ;IACR,KAAK;CACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,UAAU,4BAA4B;IAC1C,OAAO;QACL,IAAI,EAAE,sBAAsB;QAC5B,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,kIAAkI;QACpI,aAAa,EAAE,yDAAyD;QACxE,UAAU,EAAE,wBAAwB;QACpC,KAAK,CAAC,OAAO;YACX,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;gBAClD,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE;aACtB,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/services/ai/html-stream-coordinator.d.ts

@@ -0,0 +1,92 @@
+import type pino from 'pino';
+import type { SendAiCommand } from './desktop-tool.js';
+type PreferenceValue = string | number | boolean;
+type PreferenceReader = (key: string) => PreferenceValue | undefined | Promise<PreferenceValue | undefined>;
+export type HtmlStreamState = 'idle' | 'streaming' | 'done' | 'failed';
+export interface HtmlStreamSession {
+    /** Unique stream identifier shared between coordinator and preview window. */
+    streamId: string;
+    /** Bridge authentication token. */
+    bridgeToken: string;
+    /** Current state of this streaming session. */
+    state: HtmlStreamState;
+    /** How much of the parsed `content` we've already sent to the preview. */
+    streamedContentLength: number;
+    /** Accumulated raw JSON argument string from toolcall_delta events. */
+    accumulatedJson: string;
+    /** The title extracted from partial JSON (used to open the window). */
+    title: string | null;
+    /** Whether the preview window has been opened. */
+    windowOpened: boolean;
+    /** Whether the synthetic preamble (theme + bridge) has been sent. */
+    preambleSent: boolean;
+    /** The window ID returned by sendAiCommand, if available. */
+    windowId: string | null;
+    /**
+     * Offset into the LLM `content` string where actual streamable content
+     * begins (right after the opening `<head…>` tag). Everything before this
+     * is structural markup (`<!DOCTYPE html><html><head>`) that the preamble
+     * already provides. Set to 0 if no `<head>` tag is found.
+     */
+    contentStartOffset: number;
+}
+export declare class HtmlStreamCoordinator {
+    /** The currently active streaming session, or null. */
+    private activeSession;
+    /**
+     * A promise chain that serializes all async operations (opening the window,
+     * sending the preamble, broadcasting chunks). Every call to `onToolcallDelta`
+     * appends to this chain so that operations execute in order without races.
+     */
+    private pendingWork;
+    private readonly sendAiCommand;
+    private readonly activateMiniApp;
+    private readonly getPreference;
+    private readonly log;
+    constructor(options: {
+        sendAiCommand: SendAiCommand;
+        activateMiniApp: (miniAppId: string) => void;
+        getPreference: PreferenceReader;
+        logger: pino.Logger;
+    });
+    /**
+     * Returns the active session, if any.
+     */
+    getActiveSession(): HtmlStreamSession | null;
+    /**
+     * Called when a `toolcall_start` event is detected for `create_liveapp`.
+     * Creates a new streaming session.
+     */
+    onToolcallStart(): void;
+    /**
+     * Called on each `toolcall_delta` event while a session is active.
+     *
+     * This method is synchronous — it accumulates the JSON fragment immediately,
+     * then queues any async work (window open, preamble, chunk broadcast) onto
+     * the serialized `pendingWork` chain so operations never race.
+     */
+    onToolcallDelta(delta: string): void;
+    /**
+     * Called when the `toolcall_end` event fires. The tool's `execute()` will run
+     * next with the complete params, so we just mark the LLM streaming as done.
+     */
+    onToolcallEnd(): void;
+    /**
+     * Called by `create-liveapp-tool.ts` execute() to finalize the stream.
+     *
+     * Waits for all pending async work (window open, preamble, chunk sends) to
+     * complete, then sends any remaining content and the done signal.
+     *
+     * Returns the session info so execute() can build its result, or null if
+     * no streaming session was active (fallback to non-streaming path).
+     */
+    finalize(finalContent: string): Promise<HtmlStreamSession | null>;
+    /**
+     * Abort the current session (e.g. on error).
+     */
+    abort(): void;
+    private openPreviewWindow;
+    private sendPreamble;
+}
+export {};
+//# sourceMappingURL=html-stream-coordinator.d.ts.map

package/dist/services/ai/html-stream-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-stream-coordinator.d.ts","sourceRoot":"","sources":["../../../src/services/ai/html-stream-coordinator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAM7B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAIpD,KAAK,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AACjD,KAAK,gBAAgB,GAAG,CACtB,GAAG,EAAE,MAAM,KACR,eAAe,GAAG,SAAS,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAAC;AAExE,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEvE,MAAM,WAAW,iBAAiB;IAChC,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,KAAK,EAAE,eAAe,CAAC;IACvB,0EAA0E;IAC1E,qBAAqB,EAAE,MAAM,CAAC;IAC9B,uEAAuE;IACvE,eAAe,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,kDAAkD;IAClD,YAAY,EAAE,OAAO,CAAC;IACtB,qEAAqE;IACrE,YAAY,EAAE,OAAO,CAAC;IACtB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;;;;OAKG;IACH,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAUD,qBAAa,qBAAqB;IAChC,uDAAuD;IACvD,OAAO,CAAC,aAAa,CAAkC;IAEvD;;;;OAIG;IACH,OAAO,CAAC,WAAW,CAAoC;IAEvD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA8B;IAC9D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAmB;IACjD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;gBAEtB,OAAO,EAAE;QACnB,aAAa,EAAE,aAAa,CAAC;QAC7B,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;QAC7C,aAAa,EAAE,gBAAgB,CAAC;QAChC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;KACrB;IAOD;;OAEG;IACH,gBAAgB,IAAI,iBAAiB,GAAG,IAAI;IAI5C;;;OAGG;IACH,eAAe,IAAI,IAAI;IAkBvB;;;;;;OAMG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAwHpC;;;OAGG;IACH,aAAa,IAAI,IAAI;IAIrB;;;;;;;;OAQG;IACG,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAoEvE;;OAEG;IACH,KAAK,IAAI,IAAI;YAaC,iBAAiB;YAuBjB,YAAY;CAqC3B"}