@multiplayer-app/sandbox 0.0.8 → 0.0.9

package/dist/agents/shared/publish-session-artifacts.tool.js

@@ -1,17 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.publishArtifactsInputSchema = void 0;
-exports.basicHtmlValidation = basicHtmlValidation;
-exports.createPublishSessionArtifactsTool = createPublishSessionArtifactsTool;
+exports.publishSessionArtifactsSubagentTool = exports.publishArtifactsInputSchema = void 0;
 const ai_agent_types_1 = require("@multiplayer-app/ai-agent-types");
 const zod_1 = require("zod");
+const context_1 = require("../../context");
 const artifact_events_1 = require("../../lib/socket/artifact-events");
 const session_pages_1 = require("../../lib/session-pages");
 const artifactFileSchema = zod_1.z.object({
     path: zod_1.z
         .string()
         .min(1)
-        .describe('Relative path under the session folder, e.g. index.html, styles.css, script.js, lib/utils.js'),
+        .describe('Relative path under the session folder, e.g. index.html, about.html, data/metrics.json, README.md'),
     content: zod_1.z.string().describe('File contents (text)'),
 });
 exports.publishArtifactsInputSchema = zod_1.z.object({
@@ -21,86 +20,103 @@ exports.publishArtifactsInputSchema = zod_1.z.object({
         .string()
         .optional()
         .describe('Which published file to open in preview (default index.html)'),
-    includeBaseStyles: zod_1.z
-        .boolean()
-        .optional()
-        .describe('Merge default styles into styles.css when present (default true)'),
 });
-function basicHtmlValidation(html) {
-    const errors = [];
-    const warnings = [];
-    if (!html.trim()) {
-        errors.push('HTML is empty');
+async function executePublishSessionArtifacts(input, context) {
+    var _a, _b, _c, _d;
+    const sessionId = (_a = context === null || context === void 0 ? void 0 : context.data) === null || _a === void 0 ? void 0 : _a.chatId;
+    if (!sessionId) {
+        throw new Error('Session ID is required');
     }
-    return { valid: errors.length === 0, warnings, errors };
-}
-function createPublishSessionArtifactsTool(options) {
-    var _a, _b;
-    const needsApproval = (_a = options === null || options === void 0 ? void 0 : options.needsApproval) !== null && _a !== void 0 ? _a : true;
-    const validateIndexHtml = (_b = options === null || options === void 0 ? void 0 : options.validateIndexHtml) !== null && _b !== void 0 ? _b : true;
+    const defaultPreviewPath = (_c = (_b = input.files[0]) === null || _b === void 0 ? void 0 : _b.path) !== null && _c !== void 0 ? _c : 'index.html';
+    const previewPathInput = (_d = input.previewPath) !== null && _d !== void 0 ? _d : defaultPreviewPath;
+    const stored = await (0, session_pages_1.writeSessionArtifacts)({
+        sessionId,
+        files: input.files,
+    });
+    const publishedAt = new Date().toISOString();
+    const previewPath = (0, session_pages_1.normalizeArtifactPath)(previewPathInput);
+    const previewUrl = `${(0, context_1.getBuilderApiContext)().config.apiPrefix}/sessions/${sessionId}/${previewPath}`;
+    const socketPayload = {
+        sessionId,
+        files: stored.artifacts,
+        previewUrl,
+        previewPath,
+        publishedAt,
+    };
+    const notifyUserIds = await (0, session_pages_1.resolveArtifactNotifyUserIds)(sessionId, context);
+    (0, artifact_events_1.emitArtifactUpdateToUsers)(notifyUserIds, socketPayload);
     return {
-        type: ai_agent_types_1.AgentToolType.LOCAL_FUNCTION,
-        userConfigurable: true,
-        data: {
-            title: 'publishSessionArtifacts',
-            needsApproval,
-            description: 'Write or update one or more files under sessions/{chatId}/. Only paths listed in `files` are written; other existing session files are left unchanged. Returns the full artifact list.',
-            inputSchema: exports.publishArtifactsInputSchema,
-            outputSchema: zod_1.z.object({
-                sessionId: zod_1.z.string(),
-                label: zod_1.z.string().optional(),
-                previewUrl: zod_1.z.string(),
-                artifacts: zod_1.z.array(zod_1.z.object({
-                    path: zod_1.z.string(),
-                    bytes: zod_1.z.number(),
-                })),
-                updatedArtifacts: zod_1.z.array(zod_1.z.object({
-                    path: zod_1.z.string(),
-                    bytes: zod_1.z.number(),
-                })),
-                publishedAt: zod_1.z.string(),
-            }),
-            execute: async (input, context, secondArg) => {
-                var _a, _b, _c;
-                if (validateIndexHtml) {
-                    const indexFile = input.files.find((f) => (0, session_pages_1.normalizeArtifactPath)(f.path) === 'index.html');
-                    if (indexFile) {
-                        const validation = basicHtmlValidation(indexFile.content);
-                        if (!validation.valid) {
-                            throw new Error(validation.errors.join('; ') || 'index.html validation failed');
-                        }
-                    }
-                }
-                const sessionId = await (0, session_pages_1.resolveChatId)(context, secondArg);
-                const defaultPreviewPath = (_b = (_a = input.files[0]) === null || _a === void 0 ? void 0 : _a.path) !== null && _b !== void 0 ? _b : 'index.html';
-                const previewPathInput = (_c = input.previewPath) !== null && _c !== void 0 ? _c : defaultPreviewPath;
-                const stored = await (0, session_pages_1.writeSessionArtifacts)({
-                    sessionId,
-                    files: input.files,
-                    previewPath: previewPathInput,
-                    includeBaseStyles: input.includeBaseStyles,
-                });
-                const publishedAt = new Date().toISOString();
-                const previewPath = (0, session_pages_1.normalizeArtifactPath)(previewPathInput);
-                const socketPayload = {
-                    sessionId,
-                    files: stored.artifacts,
-                    previewUrl: stored.previewUrl,
-                    previewPath,
-                    publishedAt,
-                };
-                const notifyUserIds = await (0, session_pages_1.resolveArtifactNotifyUserIds)(sessionId, context);
-                (0, artifact_events_1.emitArtifactUpdateToUsers)(notifyUserIds, socketPayload);
-                return {
-                    sessionId,
-                    label: input.label,
-                    previewUrl: stored.previewUrl,
-                    artifacts: stored.artifacts,
-                    updatedArtifacts: stored.updatedArtifacts,
-                    publishedAt,
-                };
-            },
-        },
+        label: input.label,
+        previewUrl,
+        artifacts: stored.artifacts,
+        publishedAt,
     };
 }
+const publishSessionArtifactsOutputSchema = zod_1.z.object({
+    label: zod_1.z.string().optional(),
+    previewUrl: zod_1.z.string(),
+    artifacts: zod_1.z.array(zod_1.z.object({
+        path: zod_1.z.string(),
+        bytes: zod_1.z.number(),
+    })),
+    publishedAt: zod_1.z.string(),
+});
+/** Create-only publish tool used by session-artefact-creator subagent. */
+const publishSessionArtifactsTool = {
+    type: ai_agent_types_1.AgentToolType.LOCAL_FUNCTION,
+    userConfigurable: true,
+    data: {
+        needsApproval: false,
+        title: 'publishSessionArtifacts',
+        description: 'Create new files under the active session. Other session files are left unchanged',
+        inputSchema: exports.publishArtifactsInputSchema,
+        outputSchema: publishSessionArtifactsOutputSchema,
+        execute: async (input, context) => await executePublishSessionArtifacts(input, context),
+    },
+};
+exports.publishSessionArtifactsSubagentTool = {
+    type: ai_agent_types_1.AgentToolType.SUBAGENT,
+    userConfigurable: true,
+    data: {
+        title: 'publishSessionArtifacts',
+        description: 'Delegate creation of new session artifacts under the active session from context. Refuses paths that already exist. Notifies connected clients on publish.',
+        inputSchema: zod_1.z.object({
+            task: zod_1.z
+                .string()
+                .describe('Overall goal that connects all requested artifacts.'),
+            artifacts: zod_1.z.array(zod_1.z.object({
+                name: zod_1.z
+                    .string()
+                    .describe('Human-readable artifact name.'),
+                description: zod_1.z
+                    .string()
+                    .describe('What this artifact should contain or accomplish.'),
+                requirements: zod_1.z
+                    .array(zod_1.z.string())
+                    .optional()
+                    .describe('Requirements specific to this artifact.'),
+            })),
+            parentContext: zod_1.z
+                .string()
+                .optional()
+                .describe('Additional context from the parent workflow. May include list of existing artifacts.'),
+        }),
+        subAgent: {
+            name: 'session-artefact-creator',
+            description: 'Creates new session artifact files only (HTML, CSS, JS, Markdown, data). Never overwrites an existing path; publish fails if any target path is already on disk.',
+            systemPrompt: `You create new files under the active session resolved from tool context (chatId). The parent passes files (path + content), and optional label, previewPath.
+
+Workflow:
+1. Session-relative paths only (no leading slash), e.g. index.html, about.html, docs/readme.md, data/metrics.json. styles.css / script.js only if the parent included them (split-asset layout).
+2. Every path in files MUST be new. If a path already exists, report the conflict — do not overwrite.
+3. always include Pico CSS in the published .html files https://cdn.jsdelivr.net/npm/@picocss/pico@2/css/pico.min.css
+4. publishSessionArtifacts once with the new files only.
+5. previewPath: main entry .html (usually index.html) or primary .md for doc-only.
+6. Reply briefly: paths created, previewUrl
+`,
+            stopWhen: () => false,
+            tools: [publishSessionArtifactsTool],
+        },
+    },
+};
 //# sourceMappingURL=publish-session-artifacts.tool.js.map

package/dist/agents/shared/publish-session-artifacts.tool.js.map

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

package/dist/agents/shared/update-session-artifacts.tool.d.ts

@@ -0,0 +1,18 @@
+import type { AgentTool } from '@multiplayer-app/ai-agent-types';
+import { z } from 'zod';
+export declare const applySessionArtifactDiffInputSchema: z.ZodObject<{
+    path: z.ZodString;
+    diff: z.ZodString;
+}, z.core.$strip>;
+export declare const getSessionArtifactLatestContentInputSchema: z.ZodObject<{
+    path: z.ZodString;
+}, z.core.$strip>;
+export declare const updateSessionArtifactInputSchema: z.ZodObject<{
+    parentContext: z.ZodString;
+    task: z.ZodString;
+}, z.core.$strip>;
+export declare const getSessionArtifactLatestContentTool: AgentTool;
+export declare const applySessionArtifactDiffTool: AgentTool;
+export declare const updateSessionArtifactsSubagentTool: AgentTool;
+export declare function getUpdateSessionArtifactsSubagent(): AgentTool;
+//# sourceMappingURL=update-session-artifacts.tool.d.ts.map

package/dist/agents/shared/update-session-artifacts.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-session-artifacts.tool.d.ts","sourceRoot":"","sources":["../../../src/agents/shared/update-session-artifacts.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,SAAS,EAAE,MAAM,iCAAiC,CAAA;AAEnF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAevB,eAAO,MAAM,mCAAmC;;;iBAW9C,CAAA;AAEF,eAAO,MAAM,0CAA0C;;iBAErD,CAAA;AAEF,eAAO,MAAM,gCAAgC;;;iBAG3C,CAAA;AAWF,eAAO,MAAM,mCAAmC,EAAE,SA8BjD,CAAA;AAED,eAAO,MAAM,4BAA4B,EAAE,SAuC1C,CAAA;AAED,eAAO,MAAM,kCAAkC,EAAE,SA8ChD,CAAA;AAED,wBAAgB,iCAAiC,IAAI,SAAS,CAE7D"}

package/dist/agents/shared/update-session-artifacts.tool.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateSessionArtifactsSubagentTool = exports.applySessionArtifactDiffTool = exports.getSessionArtifactLatestContentTool = exports.updateSessionArtifactInputSchema = exports.getSessionArtifactLatestContentInputSchema = exports.applySessionArtifactDiffInputSchema = void 0;
+exports.getUpdateSessionArtifactsSubagent = getUpdateSessionArtifactsSubagent;
+const ai_agent_types_1 = require("@multiplayer-app/ai-agent-types");
+const zod_1 = require("zod");
+const context_1 = require("../../context");
+const artifact_events_1 = require("../../lib/socket/artifact-events");
+const hashline_diff_guide_1 = require("../../lib/session-artifacts/hashline-diff-guide");
+const session_pages_1 = require("../../lib/session-pages");
+const session_artifact_yjs_store_1 = require("../../realtime/session-artifact-yjs-store");
+const validate_artifact_content_tools_1 = require("./validate-artifact-content.tools");
+exports.applySessionArtifactDiffInputSchema = zod_1.z.object({
+    path: zod_1.z
+        .string()
+        .min(1)
+        .describe('Relative path of an existing session artifact, e.g. index.html or README.md'),
+    diff: zod_1.z
+        .string()
+        .min(1)
+        .describe('Hashline SEARCH/REPLACE blocks using tag ranges from latest content (<<<SEARCH ... >>>REPLACE ... <<<END).'),
+});
+exports.getSessionArtifactLatestContentInputSchema = zod_1.z.object({
+    path: zod_1.z.string().min(1).describe('Relative path of an existing session artifact'),
+});
+exports.updateSessionArtifactInputSchema = zod_1.z.object({
+    parentContext: zod_1.z.string().min(1).describe('Additional context provided by the parent agent to help complete the task. May include project requirements, user requests, design decisions, architecture details, existing artifact summaries, related files, constraints, assumptions, acceptance criteria, prior conversation excerpts, or any other information relevant to implementing the requested changes.'),
+    task: zod_1.z.string().min(1).describe('The specific work to be performed by the subagent. Describes the requested changes, desired outcome, scope of work, and any implementation requirements. This is the primary instruction that the subagent should execute using the provided context.'),
+});
+async function assertExistingArtifactPath(sessionId, artifactPath) {
+    const normalizedPath = (0, session_pages_1.normalizeArtifactPath)(artifactPath);
+    const [artifact] = await (0, session_pages_1.readSessionArtifacts)(sessionId, [normalizedPath]);
+    if (!(artifact === null || artifact === void 0 ? void 0 : artifact.found)) {
+        throw new Error(`Session artifact not found: ${normalizedPath}`);
+    }
+    return normalizedPath;
+}
+exports.getSessionArtifactLatestContentTool = {
+    type: ai_agent_types_1.AgentToolType.LOCAL_FUNCTION,
+    userConfigurable: true,
+    data: {
+        needsApproval: false,
+        title: 'getSessionArtifactLatestContent',
+        description: 'Read the latest content of session artifact.',
+        inputSchema: exports.getSessionArtifactLatestContentInputSchema,
+        outputSchema: zod_1.z.object({
+            path: zod_1.z.string(),
+            content: zod_1.z.string(),
+        }),
+        execute: async (input, context) => {
+            var _a;
+            const sessionId = (_a = context === null || context === void 0 ? void 0 : context.data) === null || _a === void 0 ? void 0 : _a.chatId;
+            if (!sessionId) {
+                throw new Error('Session ID is required');
+            }
+            const path = await assertExistingArtifactPath(sessionId, input.path);
+            const content = await (0, session_artifact_yjs_store_1.getSessionArtifactYjsStore)().getLatestText(sessionId, path);
+            return {
+                path,
+                content,
+            };
+        },
+    },
+};
+exports.applySessionArtifactDiffTool = {
+    type: ai_agent_types_1.AgentToolType.LOCAL_FUNCTION,
+    userConfigurable: true,
+    data: {
+        needsApproval: false,
+        title: 'applySessionArtifactDiff',
+        description: 'Update existing session artifact with a hashline SEARCH/REPLACE diff.',
+        inputSchema: exports.applySessionArtifactDiffInputSchema,
+        outputSchema: zod_1.z.object({
+            path: zod_1.z.string(),
+        }),
+        execute: async (input, context) => {
+            var _a;
+            const sessionId = (_a = context === null || context === void 0 ? void 0 : context.data) === null || _a === void 0 ? void 0 : _a.chatId;
+            if (!sessionId) {
+                throw new Error('Session ID is required');
+            }
+            const path = await assertExistingArtifactPath(sessionId, input.path);
+            const result = await (0, session_artifact_yjs_store_1.getSessionArtifactYjsStore)().applyPatchText(sessionId, path, input.diff);
+            const publishedAt = new Date().toISOString();
+            const previewUrl = `${(0, context_1.getBuilderApiContext)().config.apiPrefix}/sessions/${sessionId}/${result.path}`;
+            const socketPayload = {
+                sessionId,
+                files: [{ path: result.path }],
+                previewUrl,
+                publishedAt,
+            };
+            const notifyUserIds = await (0, session_pages_1.resolveArtifactNotifyUserIds)(sessionId, context);
+            (0, artifact_events_1.emitArtifactUpdateToUsers)(notifyUserIds, socketPayload);
+            return { path: result.path };
+        },
+    },
+};
+exports.updateSessionArtifactsSubagentTool = {
+    type: ai_agent_types_1.AgentToolType.SUBAGENT,
+    userConfigurable: true,
+    data: {
+        title: 'updateSessionArtifact',
+        description: 'Delegate read, Q&A, or edits for an existing session artifact.',
+        inputSchema: exports.updateSessionArtifactInputSchema,
+        subAgent: {
+            name: 'artifact-editor',
+            description: 'Reads existing session artifacts, answers questions (summaries, excerpts, explanations), and applies hashline edits when asked to change a file. Never returns a full file body.',
+            systemPrompt: `You work with a single existing file under the active session. The parent passes parentContext and task (include the artifact path in task).
+
+Decide mode from the task:
+- **Read / Q&A** — explain, summarize, locate, or quote what is in the file. No applySessionArtifactDiff.
+- **Edit** — change the file via hashline SEARCH/REPLACE. Use applySessionArtifactDiff when done.
+
+Always start by calling getSessionArtifactLatestContent with the path from the task.
+
+**Read / Q&A workflow**
+1. Use lines[].tag only internally if you later edit; for answers, cite short excerpts (a few lines or a function/block), bullet summaries, or direct answers.
+2. Do not return the full file, a near-complete copy, or a line-by-line dump. Truncate long sections with "…" and name paths/line tags only when helpful for a follow-up edit.
+3. Reply to the parent with the answer, summary, or relevant code chunks only.
+
+**Edit workflow**
+1. Use returned lines[].tag values for diff ranges.
+2. Produce hashline SEARCH/REPLACE blocks that implement the instruction.
+3. For .html edits: keep Pico-friendly structure (semantic tags, container main); preserve any existing Pico CDN <link> unless the task removes styling. Prefer editing <script>/<style> or body content over replacing the whole document.
+4. Validate before applying:
+   - For .html paths, call validateHtml with the expected updated content.
+   - For .md paths, call validateMarkdown with the expected updated content and path.
+5. Call applySessionArtifactDiff with path and diff.
+6. Reply to the parent with ONLY the updated path from applySessionArtifactDiff (no file body).
+
+${hashline_diff_guide_1.HASHLINE_DIFF_GUIDE}
+`,
+            stopWhen: () => false,
+            tools: [
+                exports.getSessionArtifactLatestContentTool,
+                validate_artifact_content_tools_1.validateHtmlTool,
+                validate_artifact_content_tools_1.validateMarkdownTool,
+                exports.applySessionArtifactDiffTool,
+            ],
+        },
+    },
+};
+function getUpdateSessionArtifactsSubagent() {
+    return exports.updateSessionArtifactsSubagentTool;
+}
+//# sourceMappingURL=update-session-artifacts.tool.js.map

package/dist/agents/shared/update-session-artifacts.tool.js.map

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

package/dist/agents/shared/validate-artifact-content.tools.d.ts

@@ -0,0 +1,12 @@
+import type { AgentTool } from '@multiplayer-app/ai-agent-types';
+import { z } from 'zod';
+export declare const validateHtmlInputSchema: z.ZodObject<{
+    html: z.ZodString;
+}, z.core.$strip>;
+export declare const validateMarkdownInputSchema: z.ZodObject<{
+    markdown: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const validateHtmlTool: AgentTool;
+export declare const validateMarkdownTool: AgentTool;
+//# sourceMappingURL=validate-artifact-content.tools.d.ts.map

package/dist/agents/shared/validate-artifact-content.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-artifact-content.tools.d.ts","sourceRoot":"","sources":["../../../src/agents/shared/validate-artifact-content.tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAA;AAEhE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,uBAAuB;;iBAElC,CAAA;AAEF,eAAO,MAAM,2BAA2B;;;iBAMtC,CAAA;AAwGF,eAAO,MAAM,gBAAgB,EAAE,SAe9B,CAAA;AAED,eAAO,MAAM,oBAAoB,EAAE,SAgBlC,CAAA"}

package/dist/agents/shared/validate-artifact-content.tools.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateMarkdownTool = exports.validateHtmlTool = exports.validateMarkdownInputSchema = exports.validateHtmlInputSchema = void 0;
+const ai_agent_types_1 = require("@multiplayer-app/ai-agent-types");
+const zod_1 = require("zod");
+exports.validateHtmlInputSchema = zod_1.z.object({
+    html: zod_1.z.string().min(1).describe('HTML to validate'),
+});
+exports.validateMarkdownInputSchema = zod_1.z.object({
+    markdown: zod_1.z.string().min(1).describe('Markdown source to validate'),
+    path: zod_1.z
+        .string()
+        .optional()
+        .describe('Intended file path (e.g. README.md) for path-specific hints'),
+});
+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 basicMarkdownValidation(markdown, path) {
+    const errors = [];
+    const warnings = [];
+    if (!markdown.trim()) {
+        errors.push('Markdown is empty');
+        return { valid: false, warnings, errors };
+    }
+    const fenceMatches = markdown.match(/```/g);
+    if (fenceMatches && fenceMatches.length % 2 !== 0) {
+        errors.push('Unclosed fenced code block (odd number of ``` markers)');
+    }
+    const lines = markdown.split('\n');
+    let inFence = false;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (line.trim().startsWith('```')) {
+            inFence = !inFence;
+            continue;
+        }
+        if (inFence)
+            continue;
+        const heading = line.match(/^(#{1,6})\s+(.+)$/);
+        if (heading && !heading[2].trim()) {
+            warnings.push(`Line ${i + 1}: empty heading`);
+        }
+        if (/^#{7,}/.test(line)) {
+            warnings.push(`Line ${i + 1}: heading level > 6 is not standard Markdown`);
+        }
+    }
+    if (!inFence && (path === null || path === void 0 ? void 0 : path.toLowerCase().endsWith('.md'))) {
+        const hasHeading = /^#\s+\S/m.test(markdown);
+        if (!hasHeading && markdown.length > 400) {
+            warnings.push('Long document without a top-level # heading - consider adding one');
+        }
+    }
+    const tabLines = lines.filter((l) => l.startsWith('\t') && !l.startsWith('\t\t'));
+    if (tabLines.length > 0) {
+        warnings.push('Lines use tab indentation; prefer spaces for GFM compatibility');
+    }
+    return { valid: errors.length === 0, warnings, errors };
+}
+exports.validateHtmlTool = {
+    type: ai_agent_types_1.AgentToolType.LOCAL_FUNCTION,
+    userConfigurable: true,
+    data: {
+        title: 'validateHtml',
+        needsApproval: false,
+        description: 'Run basic structural checks on HTML before publishing or updating',
+        inputSchema: exports.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),
+    },
+};
+exports.validateMarkdownTool = {
+    type: ai_agent_types_1.AgentToolType.LOCAL_FUNCTION,
+    userConfigurable: true,
+    data: {
+        title: 'validateMarkdown',
+        needsApproval: false,
+        description: 'Run basic structural checks on Markdown before publishing or updating',
+        inputSchema: exports.validateMarkdownInputSchema,
+        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) => basicMarkdownValidation(input.markdown, input.path),
+    },
+};
+//# sourceMappingURL=validate-artifact-content.tools.js.map

package/dist/agents/shared/validate-artifact-content.tools.js.map

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

package/dist/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAI/D,wBAAgB,WAAW,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAGrF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,mBAAmB,GAAG,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,CAE/F"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAG/D,wBAAgB,WAAW,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAErF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,mBAAmB,GAAG,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,CAE/F"}

package/dist/agents.js

@@ -2,11 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setupAgents = setupAgents;
 exports.createSetupAgents = createSetupAgents;
-const html_generator_agent_1 = require("./agents/html-generator.agent");
-const markdown_generator_agent_1 = require("./agents/markdown-generator.agent");
+const content_generator_agent_1 = require("./agents/content-generator.agent");
 function setupAgents(configStore, deps) {
-    configStore.addAgent(['main', 'html-generator'], (0, html_generator_agent_1.createHtmlGeneratorAgent)(deps));
-    configStore.addAgent(['main', 'markdown-generator'], (0, markdown_generator_agent_1.createMarkdownGeneratorAgent)(deps));
+    configStore.addAgent(['main', 'content-generator'], (0, content_generator_agent_1.createContentGeneratorAgent)(deps));
 }
 function createSetupAgents(deps) {
     return (configStore) => setupAgents(configStore, deps);

package/dist/agents.js.map

@@ -1 +1 @@
-{"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":";;AAKA,kCAGC;AAED,8CAEC;AAVD,wEAAwE;AACxE,gFAAgF;AAEhF,SAAgB,WAAW,CAAC,WAAwB,EAAE,IAAyB;IAC7E,WAAW,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAAE,IAAA,+CAAwB,EAAC,IAAI,CAAC,CAAC,CAAA;IAChF,WAAW,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,oBAAoB,CAAC,EAAE,IAAA,uDAA4B,EAAC,IAAI,CAAC,CAAC,CAAA;AAC1F,CAAC;AAED,SAAgB,iBAAiB,CAAC,IAAyB;IACzD,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,WAAW,EAAE,IAAI,CAAC,CAAA;AACxD,CAAC"}
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":";;AAIA,kCAEC;AAED,8CAEC;AARD,8EAA8E;AAE9E,SAAgB,WAAW,CAAC,WAAwB,EAAE,IAAyB;IAC7E,WAAW,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAAE,IAAA,qDAA2B,EAAC,IAAI,CAAC,CAAC,CAAA;AACxF,CAAC;AAED,SAAgB,iBAAiB,CAAC,IAAyB;IACzD,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,WAAW,EAAE,IAAI,CAAC,CAAA;AACxD,CAAC"}

package/dist/ai-agent.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-agent.service.d.ts","sourceRoot":"","sources":["../src/ai-agent.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AAG3F,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmB;IAE1C,OAAO,CAAC,cAAc,CAA4B;IAElD,OAAO;IAEA,UAAU,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAYvD,IAAW,OAAO,IAAI,cAAc,CAKnC;WAEa,WAAW,IAAI,iBAAiB;CAM/C"}
+{"version":3,"file":"ai-agent.service.d.ts","sourceRoot":"","sources":["../src/ai-agent.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AAE3F,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmB;IAE1C,OAAO,CAAC,cAAc,CAA4B;IAElD,OAAO;IAEA,UAAU,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAOvD,IAAW,OAAO,IAAI,cAAc,CAKnC;WAEa,WAAW,IAAI,iBAAiB;CAM/C"}

package/dist/ai-agent.service.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AgentServiceStore = void 0;
 const ai_agent_node_1 = require("@multiplayer-app/ai-agent-node");
-const resolve_chat_id_1 = require("./lib/session-pages/resolve-chat-id");
 class AgentServiceStore {
     constructor() { }
     initialize(options) {
@@ -10,7 +9,6 @@ class AgentServiceStore {
             throw new Error('Agent service already initialized');
         }
         this.aiAgentService = new ai_agent_node_1.AIAgentService(options);
-        (0, resolve_chat_id_1.patchChatProcessorWithSessionContext)(this.aiAgentService.getChatProcessor());
     }
     get service() {
         if (!this.aiAgentService) {

package/dist/ai-agent.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-agent.service.js","sourceRoot":"","sources":["../src/ai-agent.service.ts"],"names":[],"mappings":";;;AAAA,kEAA2F;AAC3F,yEAA0F;AAE1F,MAAa,iBAAiB;IAK5B,gBAAuB,CAAC;IAEjB,UAAU,CAAC,OAA8B;QAC9C,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;QACtD,CAAC;QACD,IAAI,CAAC,cAAc,GAAG,IAAI,8BAAc,CAAC,OAAO,CAAC,CAAA;QACjD,IAAA,sDAAoC,EAClC,IAAI,CAAC,cAAc,CAAC,gBAAgB,EAEhC,CACL,CAAA;IACH,CAAC;IAED,IAAW,OAAO;QAChB,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;QAClD,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CAAA;IAC5B,CAAC;IAEM,MAAM,CAAC,WAAW;QACvB,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,CAAC;YAChC,iBAAiB,CAAC,QAAQ,GAAG,IAAI,iBAAiB,EAAE,CAAA;QACtD,CAAC;QACD,OAAO,iBAAiB,CAAC,QAAQ,CAAA;IACnC,CAAC;CACF;AAhCD,8CAgCC"}
+{"version":3,"file":"ai-agent.service.js","sourceRoot":"","sources":["../src/ai-agent.service.ts"],"names":[],"mappings":";;;AAAA,kEAA2F;AAE3F,MAAa,iBAAiB;IAK5B,gBAAuB,CAAC;IAEjB,UAAU,CAAC,OAA8B;QAC9C,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;QACtD,CAAC;QACD,IAAI,CAAC,cAAc,GAAG,IAAI,8BAAc,CAAC,OAAO,CAAC,CAAA;IACnD,CAAC;IAED,IAAW,OAAO;QAChB,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;QAClD,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CAAA;IAC5B,CAAC;IAEM,MAAM,CAAC,WAAW;QACvB,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,CAAC;YAChC,iBAAiB,CAAC,QAAQ,GAAG,IAAI,iBAAiB,EAAE,CAAA;QACtD,CAAC;QACD,OAAO,iBAAiB,CAAC,QAAQ,CAAA;IACnC,CAAC;CACF;AA3BD,8CA2BC"}

package/dist/create-builder-api.d.ts

@@ -4,6 +4,10 @@ import type { ConfigStore } from '@multiplayer-app/ai-agent-node';
 import { type BuilderApiConfig } from './builder-api-config';
 import { type BuilderApiRepositories } from './context';
 import { type BuilderApiLogger } from './logger';
+/**
+ * Embedders must attach HTTP middleware that sets `req.userId` and `req.accountId`,
+ * plus `req.hasAccountAccess` before routes that invite chat participants.
+ */
 export interface CreateBuilderApiOptions {
     httpServer: HttpServer;
     config: BuilderApiConfig;