@multiplayer-app/sandbox 0.0.1

package/dist/agents/filingramp-fetch.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentConfig } from '@multiplayer-app/ai-agent-types';
+import type { BuilderApiAgentDeps } from '../builder-api-config';
+export declare function createFilingRampFetchAgent(deps: BuilderApiAgentDeps): AgentConfig;
+//# sourceMappingURL=filingramp-fetch.agent.d.ts.map

package/dist/agents/filingramp-fetch.agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filingramp-fetch.agent.d.ts","sourceRoot":"","sources":["../../src/agents/filingramp-fetch.agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAGlE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AA0EhE,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,mBAAmB,GAAG,WAAW,CA+HjF"}

package/dist/agents/filingramp-fetch.agent.js

@@ -0,0 +1,195 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFilingRampFetchAgent = createFilingRampFetchAgent;
+const ai_agent_types_1 = require("@multiplayer-app/ai-agent-types");
+const zod_1 = require("zod");
+const filingramp_endpoints_1 = require("./knowledge/filingramp-endpoints");
+const publish_session_artifacts_tool_1 = require("./shared/publish-session-artifacts.tool");
+const searchEndpointsInputSchema = zod_1.z.object({
+    query: zod_1.z
+        .string()
+        .optional()
+        .describe('Search path, summary, tags, or parameter names (e.g. filings, dashboard, productId)'),
+    service: zod_1.z
+        .string()
+        .optional()
+        .describe('Filter by service section (e.g. ramp-web-api, ramp-library-service)'),
+    tag: zod_1.z.string().optional().describe('Filter by OpenAPI tag (e.g. filings, products)'),
+    limit: zod_1.z.number().int().min(1).max(50).optional().describe('Max endpoints to return (default 25)'),
+});
+function buildFetchScaffold(baseUrl) {
+    return `/**
+ * FilingRamp read-only fetch helpers (GET catalog only).
+ * Set before running: window.__FILINGRAMP_API_KEY__ = '<api-key>';
+ */
+const FILINGRAMP_BASE_URL = ${JSON.stringify(baseUrl.replace(/\/$/, ''))};
+
+/**
+ * @param {string} path - Absolute path from catalog, e.g. "/v1/products"
+ * @param {Record<string, string | number | boolean | undefined>} [query]
+ */
+async function filingRampGet(path, query = {}) {
+  const url = new URL(path.startsWith('/') ? path : \`/\${path}\`, FILINGRAMP_BASE_URL);
+  for (const [key, value] of Object.entries(query)) {
+    if (value === undefined || value === null) continue;
+    if (Array.isArray(value)) {
+      for (const item of value) url.searchParams.append(key, String(item));
+    } else {
+      url.searchParams.set(key, String(value));
+    }
+  }
+
+  const token = globalThis.__FILINGRAMP_API_KEY__ ?? '';
+  const headers = { Accept: 'application/json' };
+  if (token) headers.Authorization = \`Bearer \${token}\`;
+
+  const response = await fetch(url.toString(), { headers, method: 'GET' });
+  if (!response.ok) {
+    const detail = await response.text().catch(() => '');
+    throw new Error(\`FilingRamp \${response.status} \${response.statusText}: \${detail}\`.trim());
+  }
+  const contentType = response.headers.get('content-type') ?? '';
+  if (contentType.includes('application/json')) return response.json();
+  return response.text();
+}
+
+/** Paginate list endpoints that support limit/offset. */
+async function filingRampList(path, query = {}, { pageSize = 50, maxPages = 20 } = {}) {
+  const items = [];
+  let offset = Number(query.offset ?? 0);
+  for (let page = 0; page < maxPages; page += 1) {
+    const batch = await filingRampGet(path, { ...query, limit: pageSize, offset });
+    const rows = Array.isArray(batch) ? batch : batch?.data ?? batch?.items ?? [];
+    if (!Array.isArray(rows) || rows.length === 0) break;
+    items.push(...rows);
+    if (rows.length < pageSize) break;
+    offset += rows.length;
+  }
+  return items;
+}
+`;
+}
+function createFilingRampFetchAgent(deps) {
+    const { baseUrl, apiKey } = deps.filingramp;
+    return {
+        name: 'filingramp-fetch',
+        description: 'Generates JavaScript to fetch read-only data from the FilingRamp API',
+        defaultModel: deps.defaultModel,
+        systemPrompt: `You write browser-ready JavaScript that loads data from the FilingRamp platform using GET endpoints only.
+
+Workflow:
+1. Call getFilingRampConfig for base URL and auth notes.
+2. Call getFilingRampEndpoints to find real paths, required query params, and tags — never invent URLs.
+3. Call getFilingRampFetchScaffold for the standard fetch helper, then extend it with domain functions (e.g. loadProducts, loadFiling).
+4. Publish script.js (and optional lib/filingramp-client.js, data/*.json) via publishSessionArtifacts.
+5. Dashboard HTML may be published separately or by the html-generator agent; focus on correct API access here.
+
+Rules:
+- Only use endpoints from the catalog (GET / list). No POST, PUT, PATCH, or DELETE.
+- Path params use {id} notation in the catalog — substitute real ids at runtime.
+- Array query params (fields[], productIds[]) must be appended repeatedly in URLSearchParams.
+- Use filingRampGet for single resources and filingRampList when paginating list endpoints.
+- Handle errors with clear messages; do not swallow HTTP failures.
+- Prefer small, composable functions that return JSON ready for charts/tables.`,
+        stopWhen: () => false,
+        tools: [
+            {
+                type: ai_agent_types_1.AgentToolType.LOCAL_FUNCTION,
+                userConfigurable: true,
+                data: {
+                    title: 'getFilingRampConfig',
+                    needsApproval: false,
+                    description: 'Runtime FilingRamp API base URL and auth setup for generated scripts',
+                    inputSchema: zod_1.z.object({}),
+                    outputSchema: zod_1.z.object({
+                        baseUrl: zod_1.z.string(),
+                        apiKeyConfigured: zod_1.z.boolean(),
+                        authNotes: zod_1.z.string(),
+                    }),
+                    execute: () => ({
+                        baseUrl,
+                        apiKeyConfigured: Boolean(apiKey),
+                        authNotes: 'Browser scripts read window.__FILINGRAMP_API_KEY__. The API server may use FILINGRAMP_API_KEY from env when proxying; set the token in the preview host or inject before running script.js.',
+                    }),
+                },
+            },
+            {
+                type: ai_agent_types_1.AgentToolType.LOCAL_FUNCTION,
+                userConfigurable: true,
+                data: {
+                    title: 'getFilingRampEndpoints',
+                    needsApproval: false,
+                    description: 'Search the FilingRamp GET endpoint catalog (from knowledge/filingramp-endpoints.md)',
+                    inputSchema: searchEndpointsInputSchema,
+                    outputSchema: zod_1.z.object({
+                        total: zod_1.z.number(),
+                        endpoints: zod_1.z.array(zod_1.z.object({
+                            service: zod_1.z.string(),
+                            method: zod_1.z.literal('GET'),
+                            path: zod_1.z.string(),
+                            type: zod_1.z.string(),
+                            summary: zod_1.z.string().optional(),
+                            tags: zod_1.z.array(zod_1.z.string()),
+                            parameters: zod_1.z.array(zod_1.z.string()),
+                        })),
+                        catalogSize: zod_1.z.number(),
+                    }),
+                    execute: (input) => {
+                        const result = (0, filingramp_endpoints_1.searchFilingRampEndpoints)(input);
+                        return {
+                            ...result,
+                            catalogSize: (0, filingramp_endpoints_1.getFilingRampEndpointCatalog)().length,
+                        };
+                    },
+                },
+            },
+            {
+                type: ai_agent_types_1.AgentToolType.LOCAL_FUNCTION,
+                userConfigurable: true,
+                data: {
+                    title: 'getFilingRampEndpointsReference',
+                    needsApproval: false,
+                    description: 'Return the full markdown endpoint catalog (large; use search tool first)',
+                    inputSchema: zod_1.z.object({
+                        confirm: zod_1.z
+                            .boolean()
+                            .describe('Must be true — catalog is large (~90 endpoints)'),
+                    }),
+                    outputSchema: zod_1.z.object({
+                        markdown: zod_1.z.string(),
+                        catalogSize: zod_1.z.number(),
+                    }),
+                    execute: (input) => {
+                        if (!input.confirm) {
+                            throw new Error('Set confirm: true to load the full catalog');
+                        }
+                        return {
+                            markdown: (0, filingramp_endpoints_1.loadFilingRampEndpointsMarkdown)(),
+                            catalogSize: (0, filingramp_endpoints_1.getFilingRampEndpointCatalog)().length,
+                        };
+                    },
+                },
+            },
+            {
+                type: ai_agent_types_1.AgentToolType.LOCAL_FUNCTION,
+                userConfigurable: true,
+                data: {
+                    title: 'getFilingRampFetchScaffold',
+                    needsApproval: false,
+                    description: 'Starter script.js with filingRampGet and filingRampList helpers',
+                    inputSchema: zod_1.z.object({}),
+                    outputSchema: zod_1.z.object({
+                        baseUrl: zod_1.z.string(),
+                        script: zod_1.z.string(),
+                    }),
+                    execute: () => ({
+                        baseUrl,
+                        script: buildFetchScaffold(baseUrl),
+                    }),
+                },
+            },
+            (0, publish_session_artifacts_tool_1.createPublishSessionArtifactsTool)({ needsApproval: true, validateIndexHtml: false }),
+        ],
+    };
+}
+//# sourceMappingURL=filingramp-fetch.agent.js.map

package/dist/agents/filingramp-fetch.agent.js.map

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

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

@@ -0,0 +1,4 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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

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

package/dist/agents/knowledge/filingramp-endpoints.d.ts

@@ -0,0 +1,23 @@
+export interface FilingRampEndpoint {
+    service: string;
+    method: 'GET';
+    path: string;
+    type: 'list' | 'get' | string;
+    summary?: string;
+    tags: string[];
+    parameters: string[];
+}
+export declare function loadFilingRampEndpointsMarkdown(): string;
+export declare function parseFilingRampEndpoints(markdown: string): FilingRampEndpoint[];
+export declare function getFilingRampEndpointCatalog(): FilingRampEndpoint[];
+export interface SearchFilingRampEndpointsInput {
+    query?: string;
+    service?: string;
+    tag?: string;
+    limit?: number;
+}
+export declare function searchFilingRampEndpoints(input?: SearchFilingRampEndpointsInput): {
+    total: number;
+    endpoints: FilingRampEndpoint[];
+};
+//# sourceMappingURL=filingramp-endpoints.d.ts.map

package/dist/agents/knowledge/filingramp-endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filingramp-endpoints.d.ts","sourceRoot":"","sources":["../../../src/agents/knowledge/filingramp-endpoints.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,KAAK,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAAA;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB;AAqBD,wBAAgB,+BAA+B,IAAI,MAAM,CAIxD;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,EAAE,CA2D/E;AAED,wBAAgB,4BAA4B,IAAI,kBAAkB,EAAE,CAKnE;AAED,MAAM,WAAW,8BAA8B;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,wBAAgB,yBAAyB,CAAC,KAAK,GAAE,8BAAmC,GAAG;IACrF,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,kBAAkB,EAAE,CAAA;CAChC,CA6BA"}

package/dist/agents/knowledge/filingramp-endpoints.js

@@ -0,0 +1,116 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadFilingRampEndpointsMarkdown = loadFilingRampEndpointsMarkdown;
+exports.parseFilingRampEndpoints = parseFilingRampEndpoints;
+exports.getFilingRampEndpointCatalog = getFilingRampEndpointCatalog;
+exports.searchFilingRampEndpoints = searchFilingRampEndpoints;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+let cachedCatalog = null;
+let cachedRawMarkdown = null;
+function resolveEndpointsFilePath() {
+    const candidates = [
+        node_path_1.default.join(process.cwd(), 'knowledge', 'filingramp-endpoints.md'),
+        node_path_1.default.join(__dirname, '../../../knowledge/filingramp-endpoints.md'),
+        node_path_1.default.join(__dirname, '../../../../knowledge/filingramp-endpoints.md'),
+    ];
+    for (const candidate of candidates) {
+        if (node_fs_1.default.existsSync(candidate))
+            return candidate;
+    }
+    throw new Error('FilingRamp endpoints catalog not found. Expected knowledge/filingramp-endpoints.md next to the app or @multiplayer-builder/builder-api package.');
+}
+function loadFilingRampEndpointsMarkdown() {
+    if (cachedRawMarkdown)
+        return cachedRawMarkdown;
+    cachedRawMarkdown = node_fs_1.default.readFileSync(resolveEndpointsFilePath(), 'utf8');
+    return cachedRawMarkdown;
+}
+function parseFilingRampEndpoints(markdown) {
+    const endpoints = [];
+    let currentService = 'unknown';
+    const lines = markdown.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const serviceHeading = line.match(/^## (.+)$/);
+        if (serviceHeading) {
+            currentService = serviceHeading[1].trim();
+            continue;
+        }
+        const endpointHeading = line.match(/^### `GET (.+)`$/);
+        if (!endpointHeading)
+            continue;
+        const endpointPath = endpointHeading[1].trim();
+        let type = 'list';
+        let summary;
+        const tags = [];
+        const parameters = [];
+        for (let j = i + 1; j < lines.length && !lines[j].startsWith('###'); j++) {
+            const detail = lines[j].trim();
+            const typeMatch = detail.match(/^- \*\*Type:\*\* (.+)$/);
+            if (typeMatch)
+                type = typeMatch[1].trim();
+            const summaryMatch = detail.match(/^- \*\*Summary:\*\* (.+)$/);
+            if (summaryMatch)
+                summary = summaryMatch[1].trim();
+            const tagsMatch = detail.match(/^- \*\*Tags:\*\* (.+)$/);
+            if (tagsMatch) {
+                tags.push(...tagsMatch[1].split(',').map((t) => t.trim()).filter(Boolean));
+            }
+            const paramsMatch = detail.match(/^- \*\*Parameters:\*\* (.+)$/);
+            if (paramsMatch) {
+                parameters.push(...paramsMatch[1]
+                    .split(',')
+                    .map((p) => p.trim())
+                    .filter(Boolean));
+            }
+        }
+        endpoints.push({
+            service: currentService,
+            method: 'GET',
+            path: endpointPath,
+            type,
+            summary,
+            tags,
+            parameters,
+        });
+    }
+    return endpoints;
+}
+function getFilingRampEndpointCatalog() {
+    if (!cachedCatalog) {
+        cachedCatalog = parseFilingRampEndpoints(loadFilingRampEndpointsMarkdown());
+    }
+    return cachedCatalog;
+}
+function searchFilingRampEndpoints(input = {}) {
+    var _a, _b, _c, _d;
+    const limit = (_a = input.limit) !== null && _a !== void 0 ? _a : 25;
+    const q = (_b = input.query) === null || _b === void 0 ? void 0 : _b.toLowerCase().trim();
+    const service = (_c = input.service) === null || _c === void 0 ? void 0 : _c.toLowerCase().trim();
+    const tag = (_d = input.tag) === null || _d === void 0 ? void 0 : _d.toLowerCase().trim();
+    let results = getFilingRampEndpointCatalog();
+    if (service) {
+        results = results.filter((e) => e.service.toLowerCase().includes(service));
+    }
+    if (tag) {
+        results = results.filter((e) => e.tags.some((t) => t.toLowerCase().includes(tag)));
+    }
+    if (q) {
+        results = results.filter((e) => {
+            var _a;
+            const haystack = [e.path, (_a = e.summary) !== null && _a !== void 0 ? _a : '', e.service, ...e.tags, ...e.parameters]
+                .join(' ')
+                .toLowerCase();
+            return haystack.includes(q);
+        });
+    }
+    return {
+        total: results.length,
+        endpoints: results.slice(0, limit),
+    };
+}
+//# sourceMappingURL=filingramp-endpoints.js.map

package/dist/agents/knowledge/filingramp-endpoints.js.map

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

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

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

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

@@ -0,0 +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;AA8DhE,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,mBAAmB,GAAG,WAAW,CA8CnF"}

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

@@ -0,0 +1,101 @@
+"use strict";
+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 publish_session_artifacts_tool_1 = require("./shared/publish-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
+        .string()
+        .optional()
+        .describe('Intended file path (e.g. README.md) for path-specific hints'),
+});
+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 };
+}
+function createMarkdownGeneratorAgent(deps) {
+    return {
+        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. 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. 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.
+- Use concise prose; bullet lists for steps and options.
+- Code samples in fenced blocks with a language identifier.
+- Tables for field/API comparisons when helpful.
+- Do not generate HTML dashboards unless the user explicitly asks — defer UI to the html-generator agent.`,
+        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: 'validateMarkdown',
+                    needsApproval: false,
+                    description: 'Run basic structural checks on Markdown before publishing',
+                    inputSchema: 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),
+                },
+            },
+            (0, publish_session_artifacts_tool_1.createPublishSessionArtifactsTool)({ needsApproval: false, validateIndexHtml: false }),
+        ],
+    };
+}
+//# sourceMappingURL=markdown-generator.agent.js.map

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

@@ -0,0 +1 @@
+{"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/publish-session-artifacts.tool.d.ts

@@ -0,0 +1,21 @@
+import type { AgentTool } from '@multiplayer-app/ai-agent-types';
+import { z } from 'zod';
+export declare const publishArtifactsInputSchema: z.ZodObject<{
+    label: z.ZodOptional<z.ZodString>;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strip>>;
+    previewPath: z.ZodOptional<z.ZodString>;
+    includeBaseStyles: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare function basicHtmlValidation(html: string): {
+    valid: boolean;
+    warnings: string[];
+    errors: string[];
+};
+export declare function createPublishSessionArtifactsTool(options?: {
+    needsApproval?: boolean;
+    validateIndexHtml?: boolean;
+}): AgentTool;
+//# sourceMappingURL=publish-session-artifacts.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"publish-session-artifacts.tool.d.ts","sourceRoot":"","sources":["../../../src/agents/shared/publish-session-artifacts.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,SAAS,EAAE,MAAM,iCAAiC,CAAA;AAGnF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAsBvB,eAAO,MAAM,2BAA2B;;;;;;;;iBAWtC,CAAA;AAEF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAS1G;AAED,wBAAgB,iCAAiC,CAAC,OAAO,CAAC,EAAE;IAC1D,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B,GAAG,SAAS,CAiFZ"}