@multiplayer-app/sandbox 0.0.31 → 0.0.33-beta.1

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

@@ -1,4 +1,12 @@
 import type { AgentConfig } from '@multiplayer-app/ai-agent-types';
 import type { BuilderApiAgentDeps } from '../builder-api-config';
+/**
+ * Parent stop budget. Models otherwise round-robin updateSessionArtifact on
+ * every published file ("polish index, then contact, then index…") until the
+ * old 16-step cap. Count tool names conservatively from serialized steps.
+ */
+export declare function shouldStopContentGenerator({ steps }: {
+    steps: unknown[];
+}): boolean;
 export declare function createContentGeneratorAgent(deps: BuilderApiAgentDeps): AgentConfig;
 //# sourceMappingURL=content-generator.agent.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"content-generator.agent.d.ts","sourceRoot":"","sources":["../../src/agents/content-generator.agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAElE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAOhE,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,mBAAmB,GAAG,WAAW,CAgClF"}
+{"version":3,"file":"content-generator.agent.d.ts","sourceRoot":"","sources":["../../src/agents/content-generator.agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAElE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAUhE;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,GAAG,OAAO,CAUnF;AAOD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,mBAAmB,GAAG,WAAW,CAqDlF"}

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

@@ -1,32 +1,76 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.shouldStopContentGenerator = shouldStopContentGenerator;
 exports.createContentGeneratorAgent = createContentGeneratorAgent;
 const ai_agent_types_1 = require("@multiplayer-app/ai-agent-types");
 const publish_session_artifacts_tool_1 = require("./shared/publish-session-artifacts.tool");
+const app_vm_tools_1 = require("./shared/app-vm.tools");
 const content_generator_system_prompt_1 = require("./shared/content-generator-system-prompt");
 const update_session_artifacts_tool_1 = require("./shared/update-session-artifacts.tool");
+const session_quality_report_tool_1 = require("./shared/session-quality-report.tool");
 const session_pages_1 = require("../lib/session-pages");
 const agent_context_1 = require("./shared/agent-context");
+const skills_1 = require("./skills");
+/**
+ * Parent stop budget. Models otherwise round-robin updateSessionArtifact on
+ * every published file ("polish index, then contact, then index…") until the
+ * old 16-step cap. Count tool names conservatively from serialized steps.
+ */
+function shouldStopContentGenerator({ steps }) {
+    if (steps.length >= 6)
+        return true;
+    const blob = JSON.stringify(steps !== null && steps !== void 0 ? steps : []);
+    const updateCalls = countToolMentions(blob, 'updateSessionArtifact');
+    const publishCalls = countToolMentions(blob, 'publishSessionArtifacts');
+    // After a landing is on disk, at most one follow-up edit pass — not one per file.
+    if (updateCalls >= 2)
+        return true;
+    // Two publish delegations is already past the intended "one ship + one repair" path.
+    if (publishCalls >= 2 && updateCalls >= 1)
+        return true;
+    return false;
+}
+function countToolMentions(blob, toolName) {
+    var _a, _b;
+    const re = new RegExp(`"(?:name|title)"\\s*:\\s*"${toolName}"`, 'g');
+    return (_b = (_a = blob.match(re)) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0;
+}
 function createContentGeneratorAgent(deps) {
     return {
         name: 'content-generator',
         description: 'Generates and updates session artifacts: HTML pages, optional split CSS/JS, JSON data, and Markdown docs',
         defaultModel: deps.defaultModel,
         systemPrompt: content_generator_system_prompt_1.CONTENT_GENERATOR_SYSTEM_PROMPT,
-        stopWhen: () => false,
+        stopWhen: shouldStopContentGenerator,
         prepareStep: async (options, context) => {
-            if (options.stepCount > 0) {
-                return undefined;
-            }
+            var _a;
             const sessionId = (0, agent_context_1.getRootChatId)(context);
             if (!sessionId) {
                 return undefined;
             }
-            const artifacts = await (0, session_pages_1.listSessionArtifacts)(sessionId);
+            const stepCount = (_a = options.stepCount) !== null && _a !== void 0 ? _a : 0;
+            const [artifacts, customSkills] = await Promise.all([
+                (0, session_pages_1.listSessionArtifacts)(sessionId),
+                stepCount === 0 ? (0, skills_1.loadAccountSkills)(context) : Promise.resolve([]),
+            ]);
+            const customSkillCatalog = customSkills.length
+                ? `\nAccount skills (add to the catalog; same-name entries replace built-ins):\n${customSkills
+                    .map((skill) => `- ${skill.name} — ${skill.description}. Use for: ${skill.whenToUse}`)
+                    .join('\n')}`
+                : '';
+            const artifactList = artifacts.length
+                ? artifacts.map((artifact) => artifact.path).join(', ')
+                : '(none yet)';
+            const stopPolish = artifacts.length > 0 && stepCount >= 1
+                ? `\nSTOP RULE: HTML already exists (${artifactList}). If the last publish/update returned previewUrl or an updated path, FINISH with a short summary NOW. Do NOT round-robin updateSessionArtifact across every file. Do NOT invent nindex.html / contact.html / data/*.json unless the user asked. At most ONE updateSessionArtifact for a named blocking error — then stop.`
+                : '';
             return {
                 messages: [
                     ...options.messages,
-                    { role: 'system', content: `List of available artifacts: ${artifacts.map((artifact) => artifact.path).join(', ')}` },
+                    {
+                        role: 'system',
+                        content: `Existing session artifacts RIGHT NOW: ${artifactList}. These paths MUST go through updateSessionArtifact — publishing them again always fails. Any path NOT in this list does not exist yet — create it with publishSessionArtifacts, never updateSessionArtifact. No build plan — ship with publish/update directly.${customSkillCatalog}${stopPolish}`,
+                    },
                 ],
             };
         },
@@ -35,6 +79,9 @@ function createContentGeneratorAgent(deps) {
             { type: ai_agent_types_1.AgentToolType.REQUEST_CLARIFICATION, userConfigurable: true },
             publish_session_artifacts_tool_1.publishSessionArtifactsSubagentTool,
             update_session_artifacts_tool_1.updateSessionArtifactsSubagentTool,
+            app_vm_tools_1.writeAppFilesTool,
+            app_vm_tools_1.runAppCommandTool,
+            session_quality_report_tool_1.getSessionQualityReportTool,
         ],
     };
 }

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

@@ -1 +1 @@
-{"version":3,"file":"content-generator.agent.js","sourceRoot":"","sources":["../../src/agents/content-generator.agent.ts"],"names":[],"mappings":";;AASA,kEAgCC;AAxCD,oEAA+D;AAE/D,4FAA6F;AAC7F,8FAA0F;AAC1F,0FAA2F;AAC3F,wDAA2D;AAC3D,0DAAsD;AAEtD,SAAgB,2BAA2B,CAAC,IAAyB;IACnE,OAAO;QACL,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,0GAA0G;QAC5G,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,YAAY,EAAE,iEAA+B;QAC7C,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK;QACrB,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;YACtC,IAAI,OAAO,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;gBAC1B,OAAO,SAAS,CAAA;YAClB,CAAC;YACD,MAAM,SAAS,GAAG,IAAA,6BAAa,EAAC,OAAO,CAAC,CAAA;YACxC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO,SAAS,CAAA;YAClB,CAAC;YAED,MAAM,SAAS,GAAG,MAAM,IAAA,oCAAoB,EAAC,SAAS,CAAC,CAAA;YACvD,OAAO;gBACL,QAAQ,EAAE;oBACR,GAAG,OAAO,CAAC,QAAQ;oBACnB,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,gCAAgC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE;iBACrH;aACF,CAAA;QACH,CAAC;QACD,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,oEAAmC;YACnC,kEAAkC;SACnC;KACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"content-generator.agent.js","sourceRoot":"","sources":["../../src/agents/content-generator.agent.ts"],"names":[],"mappings":"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"}

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":"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"}

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":"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"}
+{"version":3,"file":"markdown-generator.agent.js","sourceRoot":"","sources":["../../src/agents/markdown-generator.agent.ts"],"names":[],"mappings":"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"}

package/dist/agents/notebook.agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notebook.agent.d.ts","sourceRoot":"","sources":["../../src/agents/notebook.agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAElE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAOhE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,GAAG,WAAW,CA2C1E"}
+{"version":3,"file":"notebook.agent.d.ts","sourceRoot":"","sources":["../../src/agents/notebook.agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAElE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAOhE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,GAAG,WAAW,CA4C1E"}

package/dist/agents/notebook.agent.js

@@ -13,7 +13,8 @@ function createNotebookAgent(deps) {
         description: 'Reads, searches, and edits the collaborative notebook the user has open, including runnable SQL, code, and chart blocks',
         defaultModel: deps.defaultModel,
         systemPrompt: notebook_agent_system_prompt_1.NOTEBOOK_AGENT_SYSTEM_PROMPT,
-        stopWhen: () => false,
+        // Safety net against runaway tool-retry loops.
+        stopWhen: ({ steps }) => steps.length >= 64,
         prepareStep: async (options, context) => {
             if (options.stepCount > 0) {
                 return undefined;

package/dist/agents/notebook.agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"notebook.agent.js","sourceRoot":"","sources":["../../src/agents/notebook.agent.ts"],"names":[],"mappings":";;AASA,kDA2CC;AAnDD,oEAA+D;AAE/D,sCAA+C;AAC/C,8EAAuF;AACvF,uFAAmF;AACnF,wFAAoF;AACpF,4DAA8E;AAE9E,SAAgB,mBAAmB,CAAC,IAAyB;IAC3D,OAAO;QACL,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACT,yHAAyH;QAC3H,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,YAAY,EAAE,2DAA4B;QAC1C,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK;QACrB,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;YACtC,IAAI,OAAO,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;gBAC1B,OAAO,SAAS,CAAA;YAClB,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAA,sCAAqB,EAAC,OAAO,CAAC,CAAA;gBACnD,MAAM,QAAQ,GAAG,MAAM,IAAA,uDAA0B,GAAE,CAAC,mBAAmB,CACrE,MAAM,CAAC,SAAS,EAChB,MAAM,CAAC,UAAU,CAClB,CAAA;gBACD,MAAM,OAAO,GAAG,IAAA,kCAAY,EAAC,IAAA,wCAAkB,EAAC,QAAQ,CAAC,CAAC,CAAA;gBAC1D,OAAO;oBACL,QAAQ,EAAE;wBACR,GAAG,OAAO,CAAC,QAAQ;wBACnB;4BACE,IAAI,EAAE,QAAiB;4BACvB,OAAO,EAAE,sDACP,OAAO,CAAC,MAAM,GAAG,CAAC;gCAChB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gCACvF,CAAC,CAAC,kBACN,EAAE;yBACH;qBACF;iBACF,CAAA;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAA,4BAAmB,GAAE,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,0CAA0C,CAAC,CAAA;gBAC/E,OAAO,SAAS,CAAA;YAClB,CAAC;QACH,CAAC;QACD,KAAK,EAAE;YACL,EAAE,IAAI,EAAE,8BAAa,CAAC,qBAAqB,EAAE,gBAAgB,EAAE,IAAI,EAAE;YACrE,GAAG,8BAAa;SACjB;KACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"notebook.agent.js","sourceRoot":"","sources":["../../src/agents/notebook.agent.ts"],"names":[],"mappings":";;AASA,kDA4CC;AApDD,oEAA+D;AAE/D,sCAA+C;AAC/C,8EAAuF;AACvF,uFAAmF;AACnF,wFAAoF;AACpF,4DAA8E;AAE9E,SAAgB,mBAAmB,CAAC,IAAyB;IAC3D,OAAO;QACL,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACT,yHAAyH;QAC3H,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,YAAY,EAAE,2DAA4B;QAC1C,+CAA+C;QAC/C,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAwB,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE;QACjE,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;YACtC,IAAI,OAAO,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;gBAC1B,OAAO,SAAS,CAAA;YAClB,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAA,sCAAqB,EAAC,OAAO,CAAC,CAAA;gBACnD,MAAM,QAAQ,GAAG,MAAM,IAAA,uDAA0B,GAAE,CAAC,mBAAmB,CACrE,MAAM,CAAC,SAAS,EAChB,MAAM,CAAC,UAAU,CAClB,CAAA;gBACD,MAAM,OAAO,GAAG,IAAA,kCAAY,EAAC,IAAA,wCAAkB,EAAC,QAAQ,CAAC,CAAC,CAAA;gBAC1D,OAAO;oBACL,QAAQ,EAAE;wBACR,GAAG,OAAO,CAAC,QAAQ;wBACnB;4BACE,IAAI,EAAE,QAAiB;4BACvB,OAAO,EAAE,sDACP,OAAO,CAAC,MAAM,GAAG,CAAC;gCAChB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gCACvF,CAAC,CAAC,kBACN,EAAE;yBACH;qBACF;iBACF,CAAA;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAA,4BAAmB,GAAE,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,0CAA0C,CAAC,CAAA;gBAC/E,OAAO,SAAS,CAAA;YAClB,CAAC;QACH,CAAC;QACD,KAAK,EAAE;YACL,EAAE,IAAI,EAAE,8BAAa,CAAC,qBAAqB,EAAE,gBAAgB,EAAE,IAAI,EAAE;YACrE,GAAG,8BAAa;SACjB;KACF,CAAA;AACH,CAAC"}

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;AAoGnF,eAAO,MAAM,mBAAmB,EAAE,SA6BjC,CAAA;AASD,eAAO,MAAM,mBAAmB,EAAE,SA8DjC,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,SAkB9B,CAAA"}