@multiplayer-app/sandbox 0.0.30 → 0.0.32

package/dist/agents/html-generator.agent.d.ts

@@ -1,2 +1,4 @@
-export { createContentGeneratorAgent, createContentGeneratorAgent as createHtmlGeneratorAgent, } from './content-generator.agent';
+import type { AgentConfig } from '@multiplayer-app/ai-agent-types';
+import type { BuilderApiAgentDeps } from '../builder-api-config';
+export declare function createHtmlGeneratorAgent(deps: BuilderApiAgentDeps): AgentConfig;
 //# sourceMappingURL=html-generator.agent.d.ts.map

package/dist/agents/html-generator.agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"html-generator.agent.d.ts","sourceRoot":"","sources":["../../src/agents/html-generator.agent.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,IAAI,wBAAwB,GACxD,MAAM,2BAA2B,CAAA"}
+{"version":3,"file":"html-generator.agent.d.ts","sourceRoot":"","sources":["../../src/agents/html-generator.agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAGlE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AA0DhE,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,mBAAmB,GAAG,WAAW,CAwC/E"}

package/dist/agents/html-generator.agent.js

@@ -1,7 +1,93 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createHtmlGeneratorAgent = exports.createContentGeneratorAgent = void 0;
-var content_generator_agent_1 = require("./content-generator.agent");
-Object.defineProperty(exports, "createContentGeneratorAgent", { enumerable: true, get: function () { return content_generator_agent_1.createContentGeneratorAgent; } });
-Object.defineProperty(exports, "createHtmlGeneratorAgent", { enumerable: true, get: function () { return content_generator_agent_1.createContentGeneratorAgent; } });
+exports.createHtmlGeneratorAgent = createHtmlGeneratorAgent;
+const ai_agent_types_1 = require("@multiplayer-app/ai-agent-types");
+const zod_1 = require("zod");
+const publish_session_artifacts_tool_1 = require("./shared/publish-session-artifacts.tool");
+const validateHtmlInputSchema = zod_1.z.object({
+    html: zod_1.z.string().min(1).describe('HTML to validate'),
+});
+function basicHtmlValidation(html) {
+    const errors = [];
+    const warnings = [];
+    if (!html.trim()) {
+        errors.push('HTML is empty');
+    }
+    const openTags = [...html.matchAll(/<([a-z][a-z0-9]*)\b[^>]*(?<!\/)>/gi)];
+    const closeTags = [...html.matchAll(/<\/([a-z][a-z0-9]*)\s*>/gi)];
+    const stack = [];
+    for (const match of openTags) {
+        const tag = match[1].toLowerCase();
+        if (![
+            'area',
+            'base',
+            'br',
+            'col',
+            'embed',
+            'hr',
+            'img',
+            'input',
+            'link',
+            'meta',
+            'param',
+            'source',
+            'track',
+            'wbr',
+        ].includes(tag)) {
+            stack.push(tag);
+        }
+    }
+    for (const match of closeTags) {
+        const tag = match[1].toLowerCase();
+        const last = stack.pop();
+        if (last !== tag) {
+            warnings.push(`Possible mismatched closing tag </${tag}>`);
+        }
+    }
+    if (stack.length > 0) {
+        warnings.push(`Unclosed elements: ${stack.join(', ')}`);
+    }
+    return { valid: errors.length === 0, warnings, errors };
+}
+function createHtmlGeneratorAgent(deps) {
+    return {
+        name: 'html-generator',
+        description: 'Builds session previews: HTML dashboards, CSS, JavaScript, and data files',
+        defaultModel: deps.defaultModel,
+        systemPrompt: `You build data dashboards and previews for user data. Every response that produces or updates UI MUST end with publishSessionArtifacts — nothing is saved until you publish.
+
+Workflow:
+1. Generate artifacts — typically index.html, styles.css, script.js, and optional JSON under data/.
+2. Keep paths relative (no leading slash). Link assets from HTML with relative URLs (./styles.css, ./script.js, ./data/metrics.json).
+3. Put layout/styling in styles.css and data fetching or rendering in script.js.
+4. For dashboards: use a shell with sidebar + main, KPI cards (.metrics article), and tables (.data-table).
+5. Call validateHtml on index.html when markup is non-trivial.
+6. Always call publishSessionArtifacts in the same turn. Include only files you created or modified in this turn — omit unchanged files; they remain on disk.
+7. Tell the user the previewUrl from the publish result so they can open App Preview.
+
+Base styles are merged into styles.css automatically unless includeBaseStyles is false.`,
+        stopWhen: () => false,
+        tools: [
+            { type: ai_agent_types_1.AgentToolType.WEB_SEARCH, userConfigurable: true },
+            { type: ai_agent_types_1.AgentToolType.REQUEST_CLARIFICATION, userConfigurable: true },
+            {
+                type: ai_agent_types_1.AgentToolType.LOCAL_FUNCTION,
+                userConfigurable: true,
+                data: {
+                    title: 'validateHtml',
+                    needsApproval: false,
+                    description: 'Run basic structural checks on HTML before publishing',
+                    inputSchema: validateHtmlInputSchema,
+                    outputSchema: zod_1.z.object({
+                        valid: zod_1.z.boolean(),
+                        warnings: zod_1.z.array(zod_1.z.string()),
+                        errors: zod_1.z.array(zod_1.z.string()),
+                    }),
+                    execute: (input) => basicHtmlValidation(input.html),
+                },
+            },
+            (0, publish_session_artifacts_tool_1.createPublishSessionArtifactsTool)({ needsApproval: false, validateIndexHtml: true }),
+        ],
+    };
+}
 //# sourceMappingURL=html-generator.agent.js.map

package/dist/agents/html-generator.agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"html-generator.agent.js","sourceRoot":"","sources":["../../src/agents/html-generator.agent.ts"],"names":[],"mappings":";;;AAAA,qEAGkC;AAFhC,sIAAA,2BAA2B,OAAA;AAC3B,mIAAA,2BAA2B,OAA4B"}
+{"version":3,"file":"html-generator.agent.js","sourceRoot":"","sources":["../../src/agents/html-generator.agent.ts"],"names":[],"mappings":";;AA6DA,4DAwCC;AApGD,oEAA+D;AAC/D,6BAAuB;AAEvB,4FAA2F;AAE3F,MAAM,uBAAuB,GAAG,OAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC;CACrD,CAAC,CAAA;AAEF,SAAS,mBAAmB,CAAC,IAAY;IACvC,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,MAAM,QAAQ,GAAa,EAAE,CAAA;IAE7B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACjB,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;IAC9B,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,oCAAoC,CAAC,CAAC,CAAA;IACzE,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,2BAA2B,CAAC,CAAC,CAAA;IACjE,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;QAClC,IACE,CAAC;YACC,MAAM;YACN,MAAM;YACN,IAAI;YACJ,KAAK;YACL,OAAO;YACP,IAAI;YACJ,KAAK;YACL,OAAO;YACP,MAAM;YACN,MAAM;YACN,OAAO;YACP,QAAQ;YACR,OAAO;YACP,KAAK;SACN,CAAC,QAAQ,CAAC,GAAG,CAAC,EACf,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACjB,CAAC;IACH,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;QAClC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,CAAA;QACxB,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,QAAQ,CAAC,IAAI,CAAC,qCAAqC,GAAG,GAAG,CAAC,CAAA;QAC5D,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,QAAQ,CAAC,IAAI,CAAC,sBAAsB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACzD,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;AACzD,CAAC;AAED,SAAgB,wBAAwB,CAAC,IAAyB;IAChE,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,2EAA2E;QACxF,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,YAAY,EAAE;;;;;;;;;;;wFAWsE;QACpF,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK;QACrB,KAAK,EAAE;YACL,EAAE,IAAI,EAAE,8BAAa,CAAC,UAAU,EAAE,gBAAgB,EAAE,IAAI,EAAE;YAC1D,EAAE,IAAI,EAAE,8BAAa,CAAC,qBAAqB,EAAE,gBAAgB,EAAE,IAAI,EAAE;YACrE;gBACE,IAAI,EAAE,8BAAa,CAAC,cAAc;gBAClC,gBAAgB,EAAE,IAAI;gBACtB,IAAI,EAAE;oBACJ,KAAK,EAAE,cAAc;oBACrB,aAAa,EAAE,KAAK;oBACpB,WAAW,EAAE,uDAAuD;oBACpE,WAAW,EAAE,uBAAuB;oBACpC,YAAY,EAAE,OAAC,CAAC,MAAM,CAAC;wBACrB,KAAK,EAAE,OAAC,CAAC,OAAO,EAAE;wBAClB,QAAQ,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;wBAC7B,MAAM,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;qBAC5B,CAAC;oBACF,OAAO,EAAE,CAAC,KAA8C,EAAE,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC;iBAC7F;aACF;YACD,IAAA,kEAAiC,EAAC,EAAE,aAAa,EAAE,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;SACrF;KACF,CAAA;AACH,CAAC"}

package/dist/agents/markdown-generator.agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown-generator.agent.d.ts","sourceRoot":"","sources":["../../src/agents/markdown-generator.agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAGlE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAgEhE,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,mBAAmB,GAAG,WAAW,CAiDnF"}
+{"version":3,"file":"markdown-generator.agent.d.ts","sourceRoot":"","sources":["../../src/agents/markdown-generator.agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAGlE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AA8DhE,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,mBAAmB,GAAG,WAAW,CA8CnF"}

package/dist/agents/markdown-generator.agent.js

@@ -3,9 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createMarkdownGeneratorAgent = createMarkdownGeneratorAgent;
 const ai_agent_types_1 = require("@multiplayer-app/ai-agent-types");
 const zod_1 = require("zod");
-const list_session_artifact_paths_tool_1 = require("./shared/list-session-artifact-paths.tool");
 const publish_session_artifacts_tool_1 = require("./shared/publish-session-artifacts.tool");
-const update_session_artifacts_tool_1 = require("./shared/update-session-artifacts.tool");
 const validateMarkdownInputSchema = zod_1.z.object({
     markdown: zod_1.z.string().min(1).describe('Markdown source to validate'),
     path: zod_1.z
@@ -59,17 +57,16 @@ function createMarkdownGeneratorAgent(deps) {
         name: 'markdown-generator',
         description: 'Writes and updates Markdown documentation in the session artifact store',
         defaultModel: deps.defaultModel,
-        systemPrompt: `You create and refine Markdown (.md) documents for the active session. New files use publishSessionArtifacts; changes to existing files use updateSessionArtifact.
+        systemPrompt: `You create and refine Markdown (.md) documents for the active session. Every response that produces or updates docs MUST end with publishSessionArtifacts — nothing is saved until you publish.
 
 Workflow:
 1. Clarify purpose (README, design doc, runbook, release notes, API summary, etc.).
 2. Write valid GitHub-Flavored Markdown (GFM): headings, lists, tables, fenced code blocks with language tags, links, blockquotes.
 3. Use session-relative paths without a leading slash, e.g. README.md, docs/architecture.md, notes/todo.md.
 4. Call validateMarkdown on substantial content before publishing.
-5. New paths: call publishSessionArtifacts with sessionId and only files that do not exist yet.
-6. Existing paths: call updateSessionArtifact with sessionId, path, and a clear instruction.
-7. Set previewPath to your primary doc (e.g. README.md) when publishing markdown-only artifacts.
-8. Summarize what was published or which path was updated (Code tab / file explorer).
+5. Call publishSessionArtifacts in the same turn. Include only files you created or modified — omit unchanged files; they remain on disk.
+6. Set previewPath to your primary doc (e.g. README.md) when publishing markdown-only artifacts.
+7. Summarize what was published and where the user can read it (Code tab / file explorer).
 
 Style:
 - Prefer one H1 per document; use ## / ### for structure.
@@ -97,9 +94,7 @@ Style:
                     execute: (input) => basicMarkdownValidation(input.markdown, input.path),
                 },
             },
-            (0, list_session_artifact_paths_tool_1.getListSessionArtifactPathsTool)(),
-            publish_session_artifacts_tool_1.publishSessionArtifactsSubagentTool,
-            update_session_artifacts_tool_1.updateSessionArtifactsSubagentTool,
+            (0, publish_session_artifacts_tool_1.createPublishSessionArtifactsTool)({ needsApproval: false, validateIndexHtml: false }),
         ],
     };
 }

package/dist/agents/markdown-generator.agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"markdown-generator.agent.js","sourceRoot":"","sources":["../../src/agents/markdown-generator.agent.ts"],"names":[],"mappings":";;AAmEA,oEAiDC;AAnHD,oEAA+D;AAC/D,6BAAuB;AAEvB,gGAA2F;AAC3F,4FAA6F;AAC7F,0FAA2F;AAE3F,MAAM,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3C,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IACnE,IAAI,EAAE,OAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,6DAA6D,CAAC;CAC3E,CAAC,CAAA;AAEF,SAAS,uBAAuB,CAC9B,QAAgB,EAChB,IAAa;IAEb,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,MAAM,QAAQ,GAAa,EAAE,CAAA;IAE7B,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAA;QAChC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;IAC3C,CAAC;IAED,MAAM,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC3C,IAAI,YAAY,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,MAAM,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAA;IACvE,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAClC,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;QACrB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAClC,OAAO,GAAG,CAAC,OAAO,CAAA;YAClB,SAAQ;QACV,CAAC;QACD,IAAI,OAAO;YAAE,SAAQ;QAErB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAA;QAC/C,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YAClC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;QAC/C,CAAC;QACD,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAA;QAC5E,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAO,KAAI,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA,EAAE,CAAC;QACpD,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC5C,IAAI,CAAC,UAAU,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YACzC,QAAQ,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAA;QACpF,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAA;IACjF,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,QAAQ,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAA;IACjF,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;AACzD,CAAC;AAED,SAAgB,4BAA4B,CAAC,IAAyB;IACpE,OAAO;QACL,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE,yEAAyE;QACtF,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,YAAY,EAAE;;;;;;;;;;;;;;;;;0GAiBwF;QACtG,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK;QACrB,KAAK,EAAE;YACL,EAAE,IAAI,EAAE,8BAAa,CAAC,UAAU,EAAE,gBAAgB,EAAE,IAAI,EAAE;YAC1D,EAAE,IAAI,EAAE,8BAAa,CAAC,qBAAqB,EAAE,gBAAgB,EAAE,IAAI,EAAE;YACrE;gBACE,IAAI,EAAE,8BAAa,CAAC,cAAc;gBAClC,gBAAgB,EAAE,IAAI;gBACtB,IAAI,EAAE;oBACJ,KAAK,EAAE,kBAAkB;oBACzB,aAAa,EAAE,KAAK;oBACpB,WAAW,EAAE,2DAA2D;oBACxE,WAAW,EAAE,2BAA2B;oBACxC,YAAY,EAAE,OAAC,CAAC,MAAM,CAAC;wBACrB,KAAK,EAAE,OAAC,CAAC,OAAO,EAAE;wBAClB,QAAQ,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;wBAC7B,MAAM,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;qBAC5B,CAAC;oBACF,OAAO,EAAE,CAAC,KAAkD,EAAE,EAAE,CAC9D,uBAAuB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC;iBACtD;aACF;YACD,IAAA,kEAA+B,GAAE;YACjC,oEAAmC;YACnC,kEAAkC;SACnC;KACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"markdown-generator.agent.js","sourceRoot":"","sources":["../../src/agents/markdown-generator.agent.ts"],"names":[],"mappings":"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"}

package/dist/agents/shared/app-vm.tools.d.ts

@@ -0,0 +1,4 @@
+import type { AgentTool } from '@multiplayer-app/ai-agent-types';
+export declare const writeAppFilesTool: AgentTool;
+export declare const runAppCommandTool: AgentTool;
+//# sourceMappingURL=app-vm.tools.d.ts.map

package/dist/agents/shared/app-vm.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-vm.tools.d.ts","sourceRoot":"","sources":["../../../src/agents/shared/app-vm.tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,SAAS,EAAE,MAAM,iCAAiC,CAAA;AAsCnF,eAAO,MAAM,iBAAiB,EAAE,SA4B/B,CAAA;AASD,eAAO,MAAM,iBAAiB,EAAE,SAqC/B,CAAA"}

package/dist/agents/shared/app-vm.tools.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runAppCommandTool = exports.writeAppFilesTool = void 0;
+const ai_agent_types_1 = require("@multiplayer-app/ai-agent-types");
+const zod_1 = require("zod");
+const context_1 = require("../../context");
+const logger_1 = require("../../logger");
+const agent_context_1 = require("./agent-context");
+const STACKS = ['node', 'python', 'generic'];
+function requireBridgeAndSession(context) {
+    const bridge = (0, context_1.getBuilderApiContext)().sessionVmBridge;
+    if (!bridge) {
+        throw new Error('App workspaces are not available in this deployment — build with session artifacts (publishSessionArtifacts) instead.');
+    }
+    const sessionId = (0, agent_context_1.getRootChatId)(context);
+    if (!sessionId) {
+        throw new Error('Session ID is required');
+    }
+    return { bridge, sessionId };
+}
+const writeAppFilesInputSchema = zod_1.z.object({
+    files: zod_1.z
+        .array(zod_1.z.object({
+        path: zod_1.z.string().min(1).max(500).describe('Workspace-relative path, e.g. index.html, src/main.js, package.json'),
+        content: zod_1.z.string().describe('File contents'),
+        encoding: zod_1.z.enum(['utf8', 'base64']).optional().describe('base64 for binary files; utf8 default'),
+    }))
+        .min(1)
+        .max(64),
+    stack: zod_1.z.enum(STACKS).optional().describe('VM stack when the workspace does not exist yet (default node)'),
+});
+exports.writeAppFilesTool = {
+    type: ai_agent_types_1.AgentToolType.LOCAL_FUNCTION,
+    userConfigurable: true,
+    data: {
+        needsApproval: false,
+        title: 'writeAppFiles',
+        description: "Write files into the session's app workspace (an isolated per-session VM). Creates the workspace on first use. Static files are served immediately at the returned previewUrl.",
+        inputSchema: writeAppFilesInputSchema,
+        outputSchema: zod_1.z.object({
+            vmId: zod_1.z.string(),
+            previewUrl: zod_1.z.string().optional(),
+            written: zod_1.z.array(zod_1.z.object({ path: zod_1.z.string(), bytes: zod_1.z.number() })),
+        }),
+        execute: async (input, context) => {
+            try {
+                const { bridge, sessionId } = requireBridgeAndSession(context);
+                if (input.stack) {
+                    await bridge.ensureVm(sessionId, input.stack);
+                }
+                const { vm, written } = await bridge.writeFiles(sessionId, input.files);
+                return { vmId: vm.vmId, previewUrl: vm.previewUrl, written };
+            }
+            catch (err) {
+                (0, logger_1.getBuilderApiLogger)().error({ err });
+                throw err;
+            }
+        },
+    },
+};
+const runAppCommandInputSchema = zod_1.z.object({
+    command: zod_1.z.string().min(1).max(4000).describe('Shell command run in the workspace root (or cwd)'),
+    cwd: zod_1.z.string().max(500).optional().describe('Workspace-relative working directory'),
+    timeoutMs: zod_1.z.number().int().positive().max(300000).optional().describe('Wall-clock limit, default 60000'),
+    stack: zod_1.z.enum(STACKS).optional().describe('VM stack when the workspace does not exist yet (default node)'),
+});
+exports.runAppCommandTool = {
+    type: ai_agent_types_1.AgentToolType.LOCAL_FUNCTION,
+    userConfigurable: true,
+    data: {
+        needsApproval: false,
+        title: 'runAppCommand',
+        description: "Run a shell command inside the session's app workspace VM (npm install, build steps, node scripts). Returns exit code and captured output. Creates the workspace on first use.",
+        inputSchema: runAppCommandInputSchema,
+        outputSchema: zod_1.z.object({
+            vmId: zod_1.z.string(),
+            previewUrl: zod_1.z.string().optional(),
+            exitCode: zod_1.z.number(),
+            stdout: zod_1.z.string(),
+            stderr: zod_1.z.string(),
+            durationMs: zod_1.z.number(),
+            truncated: zod_1.z.boolean(),
+            timedOut: zod_1.z.boolean(),
+        }),
+        execute: async (input, context) => {
+            try {
+                const { bridge, sessionId } = requireBridgeAndSession(context);
+                if (input.stack) {
+                    await bridge.ensureVm(sessionId, input.stack);
+                }
+                const { vm, result } = await bridge.exec(sessionId, {
+                    command: input.command,
+                    cwd: input.cwd,
+                    timeoutMs: input.timeoutMs,
+                });
+                return { vmId: vm.vmId, previewUrl: vm.previewUrl, ...result };
+            }
+            catch (err) {
+                (0, logger_1.getBuilderApiLogger)().error({ err });
+                throw err;
+            }
+        },
+    },
+};
+//# sourceMappingURL=app-vm.tools.js.map

package/dist/agents/shared/app-vm.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-vm.tools.js","sourceRoot":"","sources":["../../../src/agents/shared/app-vm.tools.ts"],"names":[],"mappings":"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"}

package/dist/agents/shared/build-plan.tools.d.ts

@@ -0,0 +1,5 @@
+import type { AgentTool } from '@multiplayer-app/ai-agent-types';
+export declare const createBuildPlanTool: AgentTool;
+export declare const updateBuildTaskTool: AgentTool;
+export declare const getBuildPlanTool: AgentTool;
+//# sourceMappingURL=build-plan.tools.d.ts.map

package/dist/agents/shared/build-plan.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-plan.tools.d.ts","sourceRoot":"","sources":["../../../src/agents/shared/build-plan.tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,SAAS,EAAE,MAAM,iCAAiC,CAAA;AAmGnF,eAAO,MAAM,mBAAmB,EAAE,SA6BjC,CAAA;AASD,eAAO,MAAM,mBAAmB,EAAE,SA8DjC,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,SAkB9B,CAAA"}

package/dist/agents/shared/build-plan.tools.js

@@ -0,0 +1,176 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBuildPlanTool = exports.updateBuildTaskTool = exports.createBuildPlanTool = void 0;
+const ai_agent_types_1 = require("@multiplayer-app/ai-agent-types");
+const zod_1 = require("zod");
+const agent_context_1 = require("./agent-context");
+const logger_1 = require("../../logger");
+const session_artifact_yjs_store_1 = require("../../realtime/session-artifact-yjs-store");
+const build_plan_1 = require("../../lib/session-plans/build-plan");
+const session_pages_1 = require("../../lib/session-pages");
+function requireSessionId(context) {
+    const sessionId = (0, agent_context_1.getRootChatId)(context);
+    if (!sessionId) {
+        throw new Error('Session ID is required');
+    }
+    return sessionId;
+}
+async function readPlan(sessionId) {
+    try {
+        const content = await (0, session_artifact_yjs_store_1.getSessionArtifactYjsStore)().getLatestText(sessionId, build_plan_1.BUILD_PLAN_PATH);
+        return (0, build_plan_1.parseBuildPlan)(content);
+    }
+    catch (_a) {
+        return null;
+    }
+}
+async function writePlan(sessionId, plan) {
+    await (0, session_artifact_yjs_store_1.getSessionArtifactYjsStore)().initializeFromContent(sessionId, build_plan_1.BUILD_PLAN_PATH, (0, build_plan_1.serializeBuildPlan)(plan));
+}
+const openAdvisorySchema = zod_1.z.object({
+    path: zod_1.z.string(),
+    findings: zod_1.z.array(zod_1.z.string()),
+    recordedAt: zod_1.z.string(),
+});
+function planSummary(plan) {
+    var _a;
+    const next = (0, build_plan_1.nextPendingTask)(plan);
+    return {
+        title: plan.title,
+        progress: (0, build_plan_1.planProgress)(plan),
+        nextTask: next ? { id: next.id, title: next.title, description: next.description, status: next.status } : null,
+        tasks: plan.tasks.map((task) => ({ id: task.id, title: task.title, status: task.status })),
+        openAdvisories: (_a = plan.openAdvisories) !== null && _a !== void 0 ? _a : [],
+    };
+}
+const planSummarySchema = zod_1.z.object({
+    title: zod_1.z.string(),
+    progress: zod_1.z.object({ done: zod_1.z.number(), total: zod_1.z.number(), remaining: zod_1.z.number() }),
+    nextTask: zod_1.z.object({ id: zod_1.z.string(), title: zod_1.z.string(), description: zod_1.z.string(), status: zod_1.z.string() }).nullable(),
+    tasks: zod_1.z.array(zod_1.z.object({ id: zod_1.z.string(), title: zod_1.z.string(), status: zod_1.z.string() })),
+    openAdvisories: zod_1.z.array(openAdvisorySchema),
+});
+const createPlanInputSchema = zod_1.z.object({
+    title: zod_1.z.string().min(1).max(200).describe('Short name of what is being built'),
+    designBrief: zod_1.z
+        .string()
+        .min(80)
+        .max(900)
+        .describe('Session-wide design contract BEFORE building. MUST include: (1) accent hex + darker hover hex (topic-fit, never default indigo), (2) neutral scale slate/zinc/stone, (3) Google Font pairing by name (Manrope/Sora/Fraunces/Outfit — never Inter), (4) tone, (5) layout pack product|launch|editorial, (6) light/dark strategy, (7) atmosphere (e.g. soft accent wash + blur orb / glass nav), (8) anti-cliché note (what this must NOT look like).'),
+    tasks: zod_1.z
+        .array(zod_1.z.object({
+        title: zod_1.z.string().min(1).max(120).describe('One concrete deliverable, e.g. "Landing page hero + nav"'),
+        description: zod_1.z.string().min(1).max(1000).describe('What this task produces: artifact paths, sections, behaviors'),
+    }))
+        .min(2)
+        .max(6)
+        .describe('Ordered tasks. Prefer 2–3 for a landing page (complete index.html publish + consistency). Max 6. Last must be consistency/polish.'),
+});
+exports.createBuildPlanTool = {
+    type: ai_agent_types_1.AgentToolType.LOCAL_FUNCTION,
+    userConfigurable: true,
+    data: {
+        needsApproval: false,
+        title: 'createBuildPlan',
+        description: 'Create the build plan for this session: an ordered task list that will be executed one task at a time. Replaces any previous plan. The plan is stored as plan.json and visible to the user. Last task must be a consistency/polish pass.',
+        inputSchema: createPlanInputSchema,
+        outputSchema: planSummarySchema,
+        execute: async (input, context) => {
+            try {
+                const sessionId = requireSessionId(context);
+                (0, build_plan_1.assertDesignBriefQuality)(input.designBrief);
+                const last = input.tasks[input.tasks.length - 1];
+                if (!last || !(0, build_plan_1.isConsistencyPassTask)(last)) {
+                    throw new Error('The last task MUST be a consistency/polish pass (title or description must mention consistency, polish, qa, or quality). Prefer a light error check — do not end the plan on a new page.');
+                }
+                const plan = (0, build_plan_1.createBuildPlan)(input.title, input.tasks, new Date().toISOString(), input.designBrief);
+                await writePlan(sessionId, plan);
+                return planSummary(plan);
+            }
+            catch (err) {
+                (0, logger_1.getBuilderApiLogger)().error({ err });
+                throw err;
+            }
+        },
+    },
+};
+const updateTaskInputSchema = zod_1.z.object({
+    taskId: zod_1.z.string().min(1).describe('Task id from the plan, e.g. t1'),
+    status: zod_1.z.enum(['in_progress', 'done', 'skipped']),
+    paths: zod_1.z.array(zod_1.z.string()).optional().describe('Artifact paths this task produced or edited'),
+    note: zod_1.z.string().max(500).optional().describe('Short outcome note, e.g. the previewUrl or why skipped'),
+});
+exports.updateBuildTaskTool = {
+    type: ai_agent_types_1.AgentToolType.LOCAL_FUNCTION,
+    userConfigurable: true,
+    data: {
+        needsApproval: false,
+        title: 'updateBuildTask',
+        description: 'Update a build-plan task status. Returns remaining progress, openAdvisories, and the next pending task — when nextTask is not null, continue building it immediately.',
+        inputSchema: updateTaskInputSchema,
+        outputSchema: planSummarySchema,
+        execute: async (input, context) => {
+            var _a;
+            try {
+                const sessionId = requireSessionId(context);
+                const plan = await readPlan(sessionId);
+                if (!plan) {
+                    throw new Error('No build plan exists — call createBuildPlan first');
+                }
+                const task = plan.tasks.find((candidate) => candidate.id === input.taskId);
+                const now = new Date().toISOString();
+                // Never mark a task done for HTML paths that were never published.
+                // (Parent previously claimed index.html after a failed publish.)
+                if (input.status === 'done' && ((_a = input.paths) === null || _a === void 0 ? void 0 : _a.length)) {
+                    const existing = new Set((await (0, session_pages_1.listSessionArtifacts)(sessionId)).map((file) => file.path));
+                    const missing = input.paths.filter((path) => path.toLowerCase().endsWith('.html') && path !== 'plan.json' && !existing.has(path));
+                    if (missing.length > 0) {
+                        throw new Error(`Cannot mark task done — claimed path(s) do not exist: ${missing.join(', ')}. Successful publishSessionArtifacts must return a previewUrl first. If publish failed, re-call publishSessionArtifacts (not updateSessionArtifact).`);
+                    }
+                }
+                // Consistency pass cannot close while HTML still has blocking audit errors
+                // (including missing-html-pages when nothing was published).
+                if (input.status === 'done' && task && (0, build_plan_1.isConsistencyPassTask)(task)) {
+                    const report = await (0, session_pages_1.auditSessionHtmlArtifacts)(sessionId);
+                    if (report.errorCount > 0) {
+                        (0, build_plan_1.clearOpenAdvisories)(plan, undefined, now);
+                        (0, build_plan_1.recordOpenAdvisories)(plan, (0, session_pages_1.sessionQualityToAdvisoryLines)(report), now);
+                        await writePlan(sessionId, plan);
+                        const blocking = report.advisoryLines.filter((line) => line.startsWith('[error]')).slice(0, 8);
+                        throw new Error(`Consistency pass incomplete — ${report.errorCount} blocking quality error(s) remain across ${report.issues.length} page(s). If missing-html-pages: call publishSessionArtifacts. Otherwise updateSessionArtifact per path. Remaining:\n${blocking.join('\n')}${report.errorCount > 8 ? '\n…' : ''}`);
+                    }
+                    (0, build_plan_1.clearOpenAdvisories)(plan, undefined, now);
+                }
+                const updated = (0, build_plan_1.applyTaskUpdate)(plan, input, now);
+                if (!updated) {
+                    throw new Error(`Unknown task id: ${input.taskId}`);
+                }
+                await writePlan(sessionId, updated);
+                return planSummary(updated);
+            }
+            catch (err) {
+                (0, logger_1.getBuilderApiLogger)().error({ err });
+                throw err;
+            }
+        },
+    },
+};
+exports.getBuildPlanTool = {
+    type: ai_agent_types_1.AgentToolType.LOCAL_FUNCTION,
+    userConfigurable: true,
+    data: {
+        needsApproval: false,
+        title: 'getBuildPlan',
+        description: 'Read the current build plan, progress, and openAdvisories for this session (null when no plan exists yet).',
+        inputSchema: zod_1.z.object({}),
+        outputSchema: zod_1.z.object({
+            plan: planSummarySchema.nullable(),
+        }),
+        execute: async (_input, context) => {
+            const sessionId = requireSessionId(context);
+            const plan = await readPlan(sessionId);
+            return { plan: plan ? planSummary(plan) : null };
+        },
+    },
+};
+//# sourceMappingURL=build-plan.tools.js.map

package/dist/agents/shared/build-plan.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-plan.tools.js","sourceRoot":"","sources":["../../../src/agents/shared/build-plan.tools.ts"],"names":[],"mappings":"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"}

package/dist/agents/shared/session-quality-report.tool.d.ts

@@ -0,0 +1,7 @@
+import type { AgentTool } from '@multiplayer-app/ai-agent-types';
+/**
+ * Parent-orchestrator tool: re-audit every HTML page and refresh plan.openAdvisories.
+ * Call only during the consistency/polish pass — never mid-build.
+ */
+export declare const getSessionQualityReportTool: AgentTool;
+//# sourceMappingURL=session-quality-report.tool.d.ts.map

package/dist/agents/shared/session-quality-report.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-quality-report.tool.d.ts","sourceRoot":"","sources":["../../../src/agents/shared/session-quality-report.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,SAAS,EAAE,MAAM,iCAAiC,CAAA;AAkBnF;;;GAGG;AACH,eAAO,MAAM,2BAA2B,EAAE,SA4FzC,CAAA"}

package/dist/agents/shared/session-quality-report.tool.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSessionQualityReportTool = void 0;
+const ai_agent_types_1 = require("@multiplayer-app/ai-agent-types");
+const zod_1 = require("zod");
+const agent_context_1 = require("./agent-context");
+const logger_1 = require("../../logger");
+const session_pages_1 = require("../../lib/session-pages");
+const build_plan_1 = require("../../lib/session-plans/build-plan");
+const session_artifact_yjs_store_1 = require("../../realtime/session-artifact-yjs-store");
+/**
+ * Parent-orchestrator tool: re-audit every HTML page and refresh plan.openAdvisories.
+ * Call only during the consistency/polish pass — never mid-build.
+ */
+exports.getSessionQualityReportTool = {
+    type: ai_agent_types_1.AgentToolType.LOCAL_FUNCTION,
+    userConfigurable: true,
+    data: {
+        needsApproval: false,
+        title: 'getSessionQualityReport',
+        description: 'Re-audit every HTML artifact. Call ONLY during the consistency/polish pass (never mid-build). Returns errorCount (blocking) and actionable warnings. Deferred heuristics like low-contrast are counted separately and do NOT need mid-build fixes. When errorCount===0 after at most one consistency fix round, mark consistency done.',
+        inputSchema: zod_1.z.object({}),
+        outputSchema: zod_1.z.object({
+            clean: zod_1.z.boolean(),
+            errorCount: zod_1.z.number(),
+            warningCount: zod_1.z.number(),
+            deferredWarningCount: zod_1.z.number(),
+            actionRequired: zod_1.z.boolean(),
+            guidance: zod_1.z.string(),
+            issues: zod_1.z.array(zod_1.z.object({
+                path: zod_1.z.string(),
+                findings: zod_1.z.array(zod_1.z.object({
+                    rule: zod_1.z.string(),
+                    severity: zod_1.z.enum(['error', 'warning']),
+                    message: zod_1.z.string(),
+                })),
+            })),
+            actionableIssues: zod_1.z.array(zod_1.z.object({
+                path: zod_1.z.string(),
+                findings: zod_1.z.array(zod_1.z.object({
+                    rule: zod_1.z.string(),
+                    severity: zod_1.z.enum(['error', 'warning']),
+                    message: zod_1.z.string(),
+                })),
+            })),
+            openAdvisories: zod_1.z.array(zod_1.z.object({
+                path: zod_1.z.string(),
+                findings: zod_1.z.array(zod_1.z.string()),
+                recordedAt: zod_1.z.string(),
+            })),
+        }),
+        execute: async (_input, context) => {
+            var _a;
+            const sessionId = (0, agent_context_1.getRootChatId)(context);
+            if (!sessionId) {
+                throw new Error('Session ID is required');
+            }
+            try {
+                const report = await (0, session_pages_1.auditSessionHtmlArtifacts)(sessionId);
+                const now = new Date().toISOString();
+                const store = (0, session_artifact_yjs_store_1.getSessionArtifactYjsStore)();
+                const plan = (0, build_plan_1.parseBuildPlan)(await store.getLatestText(sessionId, build_plan_1.BUILD_PLAN_PATH).catch(() => ''));
+                let openAdvisories = [];
+                if (plan) {
+                    (0, build_plan_1.clearOpenAdvisories)(plan, undefined, now);
+                    const lines = (0, session_pages_1.sessionQualityToAdvisoryLines)(report);
+                    if (lines.length > 0) {
+                        (0, build_plan_1.recordOpenAdvisories)(plan, lines, now);
+                    }
+                    await store.initializeFromContent(sessionId, build_plan_1.BUILD_PLAN_PATH, (0, build_plan_1.serializeBuildPlan)(plan));
+                    openAdvisories = (_a = plan.openAdvisories) !== null && _a !== void 0 ? _a : [];
+                }
+                const actionRequired = report.errorCount > 0;
+                return {
+                    clean: report.actionableIssues.length === 0,
+                    errorCount: report.errorCount,
+                    warningCount: report.warningCount,
+                    deferredWarningCount: report.deferredWarningCount,
+                    actionRequired,
+                    guidance: actionRequired
+                        ? report.actionableIssues.some((issue) => issue.findings.some((finding) => finding.rule === 'missing-html-pages'))
+                            ? 'No HTML pages on disk. Call publishSessionArtifacts to create index.html — updateSessionArtifact cannot create files. Then getSessionQualityReport again.'
+                            : 'Blocking errors remain — call updateSessionArtifact once per path in actionableIssues, then getSessionQualityReport again. Mark consistency done only when errorCount===0.'
+                        : 'No blocking errors. Do NOT start updateSessionArtifact for warnings. Mark the consistency task done and finish the plan.',
+                    issues: report.issues,
+                    actionableIssues: report.actionableIssues,
+                    openAdvisories,
+                };
+            }
+            catch (err) {
+                (0, logger_1.getBuilderApiLogger)().error({ err });
+                throw err;
+            }
+        },
+    },
+};
+//# sourceMappingURL=session-quality-report.tool.js.map