synthos 0.7.2 → 0.9.0

package/dist/models/fireworksai.js

@@ -0,0 +1,141 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fireworksai = exports.buildFireworksRequest = exports.resolveFireworksModel = exports.extractJSON = void 0;
+const openai_1 = __importDefault(require("openai"));
+const types_1 = require("./types");
+/** Known short-name → full Fireworks model path mappings. */
+const FIREWORKS_MODEL_MAP = {
+    'fireworks-glm-5': 'accounts/fireworks/models/glm-5',
+    'fireworks-minimax-m2p5': 'accounts/fireworks/models/minimax-m2p5',
+    'fireworks-kimi-k2p5': 'accounts/fireworks/models/kimi-k2p5',
+};
+const FIREWORKS_BASE_URL = 'https://api.fireworks.ai/inference/v1';
+/**
+ * Extract JSON from a string that may be wrapped in markdown fences or prose.
+ * Returns the original string if no JSON object/array is found.
+ */
+function extractJSON(text) {
+    // Strip markdown code fences (```json ... ``` or ``` ... ```)
+    const fenceMatch = text.match(/```(?:json)?\s*\n?([\s\S]*?)\n?\s*```/);
+    if (fenceMatch) {
+        return fenceMatch[1].trim();
+    }
+    // Find the first top-level { ... } or [ ... ]
+    const start = text.search(/[\[{]/);
+    if (start === -1)
+        return text;
+    const open = text[start];
+    const close = open === '{' ? '}' : ']';
+    let depth = 0;
+    let inString = false;
+    let escape = false;
+    for (let i = start; i < text.length; i++) {
+        const ch = text[i];
+        if (escape) {
+            escape = false;
+            continue;
+        }
+        if (ch === '\\' && inString) {
+            escape = true;
+            continue;
+        }
+        if (ch === '"') {
+            inString = !inString;
+            continue;
+        }
+        if (inString)
+            continue;
+        if (ch === open || ch === (open === '{' ? '[' : '{'))
+            depth++;
+        else if (ch === close || ch === (close === '}' ? ']' : '}'))
+            depth--;
+        if (depth === 0) {
+            return text.slice(start, i + 1);
+        }
+    }
+    // Fallback: return from the first brace to end
+    return text.slice(start);
+}
+exports.extractJSON = extractJSON;
+/**
+ * Resolve a short Fireworks model name to the full API path.
+ * Returns the input unchanged if not a known short name.
+ */
+function resolveFireworksModel(model) {
+    return FIREWORKS_MODEL_MAP[model] || model;
+}
+exports.resolveFireworksModel = resolveFireworksModel;
+/**
+ * Build the messages array, temperature, and JSON flag for a FireworksAI request.
+ * Pure function — no SDK dependency.
+ */
+function buildFireworksRequest(args, defaultTemp) {
+    const temperature = args.temperature ?? defaultTemp;
+    const useJson = !!(args.jsonMode || args.jsonSchema);
+    const messages = [];
+    if (args.system) {
+        messages.push({ role: 'system', content: args.system.content });
+    }
+    if (args.history) {
+        for (const msg of args.history) {
+            messages.push({ role: msg.role, content: msg.content });
+        }
+    }
+    // Strip images — FireworksAI has no vision support; keep text only
+    const promptContent = args.prompt.content;
+    let userContent;
+    if ((0, types_1.isMultimodalContent)(promptContent)) {
+        userContent = promptContent.filter(b => b.type === 'text').map(b => b.text).join('\n');
+    }
+    else {
+        userContent = promptContent;
+    }
+    if (useJson) {
+        userContent += '\n\nRespond with valid JSON only. No markdown fences.';
+    }
+    messages.push({ role: 'user', content: userContent });
+    return { messages, temperature, useJson };
+}
+exports.buildFireworksRequest = buildFireworksRequest;
+function fireworksai(args) {
+    const { apiKey, temperature = 0.0 } = args;
+    const model = resolveFireworksModel(args.model);
+    const client = new openai_1.default({ apiKey, baseURL: FIREWORKS_BASE_URL });
+    return async (completionArgs) => {
+        const { messages, temperature: reqTemp, useJson } = buildFireworksRequest(completionArgs, temperature);
+        try {
+            const response = await client.chat.completions.create({
+                model,
+                messages: messages,
+                temperature: reqTemp,
+                max_tokens: 32768,
+                ...(useJson ? { response_format: { type: 'json_object' } } : {}),
+            });
+            const choice = response.choices[0];
+            if (!choice?.message) {
+                return { completed: false, error: new Error('No response choice returned') };
+            }
+            let text = choice.message.content ?? '';
+            // Robust JSON extraction as a safety net
+            if (useJson && text) {
+                text = extractJSON(text);
+            }
+            return { completed: true, value: text };
+        }
+        catch (err) {
+            let error;
+            if (err instanceof openai_1.default.APIError && err.status !== undefined) {
+                error = new types_1.RequestError(err.message, err.status, err.name ?? 'APIError');
+            }
+            else {
+                error = err;
+            }
+            return { completed: false, error };
+        }
+    };
+}
+exports.fireworksai = fireworksai;
+//# sourceMappingURL=fireworksai.js.map

package/dist/models/fireworksai.js.map

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

package/dist/models/index.d.ts

@@ -1,3 +1,9 @@
-export { ProviderName, ProviderConfig, ModelEntry, Provider } from './types';
+export { ProviderName, ProviderConfig, ModelEntry, Provider, SystemMessage, UserMessage, Message, AgentCompletion, completePrompt, PromptCompletionArgs, AgentArgs, RequestError, TextBlock, ImageBlock, ContentBlock, MessageContent, isMultimodalContent } from './types';
 export { AnthropicProvider, OpenAIProvider, PROVIDERS, getProvider, detectProvider } from './providers';
+export { anthropic, AnthropicArgs, buildAnthropicRequest } from './anthropic';
+export { openai, OpenaiArgs, buildOpenAIRequest } from './openai';
+export { fireworksai, FireworksAIArgs, resolveFireworksModel, buildFireworksRequest } from './fireworksai';
+export { chainOfThought, ChainOfThoughtArgs, ExplainedAnswer } from './chainOfThought';
+export { logCompletePrompt } from './logCompletePrompt';
+export { variableToString } from './utils';
 //# sourceMappingURL=index.d.ts.map

package/dist/models/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,oBAAoB,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC5Q,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACxG,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC3G,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC"}

package/dist/models/index.js

@@ -1,10 +1,29 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.detectProvider = exports.getProvider = exports.PROVIDERS = exports.OpenAIProvider = exports.AnthropicProvider = void 0;
+exports.variableToString = exports.logCompletePrompt = exports.chainOfThought = exports.buildFireworksRequest = exports.resolveFireworksModel = exports.fireworksai = exports.buildOpenAIRequest = exports.openai = exports.buildAnthropicRequest = exports.anthropic = exports.detectProvider = exports.getProvider = exports.PROVIDERS = exports.OpenAIProvider = exports.AnthropicProvider = exports.isMultimodalContent = exports.RequestError = void 0;
+var types_1 = require("./types");
+Object.defineProperty(exports, "RequestError", { enumerable: true, get: function () { return types_1.RequestError; } });
+Object.defineProperty(exports, "isMultimodalContent", { enumerable: true, get: function () { return types_1.isMultimodalContent; } });
 var providers_1 = require("./providers");
 Object.defineProperty(exports, "AnthropicProvider", { enumerable: true, get: function () { return providers_1.AnthropicProvider; } });
 Object.defineProperty(exports, "OpenAIProvider", { enumerable: true, get: function () { return providers_1.OpenAIProvider; } });
 Object.defineProperty(exports, "PROVIDERS", { enumerable: true, get: function () { return providers_1.PROVIDERS; } });
 Object.defineProperty(exports, "getProvider", { enumerable: true, get: function () { return providers_1.getProvider; } });
 Object.defineProperty(exports, "detectProvider", { enumerable: true, get: function () { return providers_1.detectProvider; } });
+var anthropic_1 = require("./anthropic");
+Object.defineProperty(exports, "anthropic", { enumerable: true, get: function () { return anthropic_1.anthropic; } });
+Object.defineProperty(exports, "buildAnthropicRequest", { enumerable: true, get: function () { return anthropic_1.buildAnthropicRequest; } });
+var openai_1 = require("./openai");
+Object.defineProperty(exports, "openai", { enumerable: true, get: function () { return openai_1.openai; } });
+Object.defineProperty(exports, "buildOpenAIRequest", { enumerable: true, get: function () { return openai_1.buildOpenAIRequest; } });
+var fireworksai_1 = require("./fireworksai");
+Object.defineProperty(exports, "fireworksai", { enumerable: true, get: function () { return fireworksai_1.fireworksai; } });
+Object.defineProperty(exports, "resolveFireworksModel", { enumerable: true, get: function () { return fireworksai_1.resolveFireworksModel; } });
+Object.defineProperty(exports, "buildFireworksRequest", { enumerable: true, get: function () { return fireworksai_1.buildFireworksRequest; } });
+var chainOfThought_1 = require("./chainOfThought");
+Object.defineProperty(exports, "chainOfThought", { enumerable: true, get: function () { return chainOfThought_1.chainOfThought; } });
+var logCompletePrompt_1 = require("./logCompletePrompt");
+Object.defineProperty(exports, "logCompletePrompt", { enumerable: true, get: function () { return logCompletePrompt_1.logCompletePrompt; } });
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "variableToString", { enumerable: true, get: function () { return utils_1.variableToString; } });
 //# sourceMappingURL=index.js.map

package/dist/models/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":";;;AACA,yCAAwG;AAA/F,8GAAA,iBAAiB,OAAA;AAAE,2GAAA,cAAc,OAAA;AAAE,sGAAA,SAAS,OAAA;AAAE,wGAAA,WAAW,OAAA;AAAE,2GAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":";;;AAAA,iCAA4Q;AAAxG,qGAAA,YAAY,OAAA;AAAuD,4GAAA,mBAAmB,OAAA;AAC1P,yCAAwG;AAA/F,8GAAA,iBAAiB,OAAA;AAAE,2GAAA,cAAc,OAAA;AAAE,sGAAA,SAAS,OAAA;AAAE,wGAAA,WAAW,OAAA;AAAE,2GAAA,cAAc,OAAA;AAClF,yCAA8E;AAArE,sGAAA,SAAS,OAAA;AAAiB,kHAAA,qBAAqB,OAAA;AACxD,mCAAkE;AAAzD,gGAAA,MAAM,OAAA;AAAc,4GAAA,kBAAkB,OAAA;AAC/C,6CAA2G;AAAlG,0GAAA,WAAW,OAAA;AAAmB,oHAAA,qBAAqB,OAAA;AAAE,oHAAA,qBAAqB,OAAA;AACnF,mDAAuF;AAA9E,gHAAA,cAAc,OAAA;AACvB,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAC1B,iCAA2C;AAAlC,yGAAA,gBAAgB,OAAA"}

package/dist/models/logCompletePrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logCompletePrompt.d.ts","sourceRoot":"","sources":["../../src/models/logCompletePrompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,cAAc,EAAwB,MAAM,SAAS,CAAC;AAEhF,wBAAgB,iBAAiB,CAAC,MAAM,GAAG,MAAM,EAC7C,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,EAC7B,UAAU,CAAC,EAAE,OAAO,GACrB,cAAc,CAAC,MAAM,CAAC,CAmBxB"}

package/dist/models/logCompletePrompt.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logCompletePrompt = void 0;
+function logCompletePrompt(inner, logDetails) {
+    return async (args) => {
+        const result = await inner(args);
+        if (result.completed) {
+            const value = typeof result.value === 'string'
+                ? result.value
+                : JSON.stringify(result.value, null, 2);
+            console.log(`\x1b[32m${value}\x1b[0m`);
+        }
+        else if (result.error) {
+            console.log(`\x1b[31m${result.error.message}\x1b[0m`);
+        }
+        if (logDetails) {
+            console.log('─'.repeat(80));
+        }
+        return result;
+    };
+}
+exports.logCompletePrompt = logCompletePrompt;
+//# sourceMappingURL=logCompletePrompt.js.map

package/dist/models/logCompletePrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logCompletePrompt.js","sourceRoot":"","sources":["../../src/models/logCompletePrompt.ts"],"names":[],"mappings":";;;AAEA,SAAgB,iBAAiB,CAC7B,KAA6B,EAC7B,UAAoB;IAEpB,OAAO,KAAK,EAAE,IAA0B,EAAoC,EAAE;QAC1E,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QAEjC,IAAI,MAAM,CAAC,SAAS,EAAE;YAClB,MAAM,KAAK,GAAG,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;gBAC1C,CAAC,CAAC,MAAM,CAAC,KAAK;gBACd,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC;SAC1C;aAAM,IAAI,MAAM,CAAC,KAAK,EAAE;YACrB,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;SACzD;QAED,IAAI,UAAU,EAAE;YACZ,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;SAC/B;QAED,OAAO,MAAM,CAAC;IAClB,CAAC,CAAC;AACN,CAAC;AAtBD,8CAsBC"}

package/dist/models/openai.d.ts

@@ -0,0 +1,24 @@
+import { completePrompt, PromptCompletionArgs } from './types';
+export interface OpenaiArgs {
+    apiKey: string;
+    model: string;
+    baseURL?: string;
+    organization?: string;
+    project?: string;
+    temperature?: number;
+}
+/**
+ * Build the input messages and text format config for an OpenAI Responses API request.
+ * Pure function — no SDK dependency.
+ */
+export declare function buildOpenAIRequest(args: PromptCompletionArgs): {
+    input: {
+        role: string;
+        content: string | any[];
+    }[];
+    text?: {
+        format: any;
+    };
+};
+export declare function openai(args: OpenaiArgs): completePrompt;
+//# sourceMappingURL=openai.d.ts.map

package/dist/models/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/models/openai.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,cAAc,EAAE,oBAAoB,EAAqC,MAAM,SAAS,CAAC;AAEnH,MAAM,WAAW,UAAU;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,oBAAoB,GAAG;IAC5D,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,GAAG,EAAE,CAAA;KAAE,EAAE,CAAC;IACnD,IAAI,CAAC,EAAE;QAAE,MAAM,EAAE,GAAG,CAAA;KAAE,CAAC;CAC1B,CAwDA;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,CAgCvD"}

package/dist/models/openai.js

@@ -0,0 +1,101 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openai = exports.buildOpenAIRequest = void 0;
+const openai_1 = __importDefault(require("openai"));
+const types_1 = require("./types");
+/**
+ * Build the input messages and text format config for an OpenAI Responses API request.
+ * Pure function — no SDK dependency.
+ */
+function buildOpenAIRequest(args) {
+    const input = [];
+    if (args.history) {
+        for (const msg of args.history) {
+            input.push({ role: msg.role, content: msg.content });
+        }
+    }
+    // Build user content — multimodal when ContentBlock[] is provided
+    const promptContent = args.prompt.content;
+    if ((0, types_1.isMultimodalContent)(promptContent)) {
+        const parts = promptContent.map(block => {
+            if (block.type === 'text') {
+                return { type: 'input_text', text: block.text };
+            }
+            return {
+                type: 'input_image',
+                image_url: `data:${block.mediaType};base64,${block.data}`,
+            };
+        });
+        input.push({ role: 'user', content: parts });
+    }
+    else {
+        input.push({ role: 'user', content: promptContent });
+    }
+    if (args.jsonMode || args.jsonSchema) {
+        const inputText = input.map(m => typeof m.content === 'string' ? m.content : '').join(' ');
+        if (!/json/i.test(inputText)) {
+            const last = input[input.length - 1];
+            if (last) {
+                if (typeof last.content === 'string') {
+                    last.content += '\nReturn JSON.';
+                }
+                else if (Array.isArray(last.content)) {
+                    last.content.push({ type: 'input_text', text: '\nReturn JSON.' });
+                }
+            }
+        }
+    }
+    let text;
+    if (args.jsonSchema) {
+        text = {
+            format: {
+                type: 'json_schema',
+                name: 'response',
+                strict: true,
+                schema: args.jsonSchema,
+            },
+        };
+    }
+    else if (args.jsonMode) {
+        text = {
+            format: { type: 'json_object' },
+        };
+    }
+    return { input, text };
+}
+exports.buildOpenAIRequest = buildOpenAIRequest;
+function openai(args) {
+    const { apiKey, model, baseURL, organization, project } = args;
+    const client = new openai_1.default({ apiKey, baseURL, organization, project });
+    return async (completionArgs) => {
+        const { input, text } = buildOpenAIRequest(completionArgs);
+        try {
+            const response = await client.responses.create({
+                model,
+                instructions: completionArgs.system?.content,
+                input: input,
+                ...(text ? { text } : {}),
+            });
+            const output = response.output_text;
+            if (output === undefined || output === null) {
+                return { completed: false, error: new Error('No response output returned') };
+            }
+            return { completed: true, value: output };
+        }
+        catch (err) {
+            let error;
+            if (err instanceof openai_1.default.APIError && err.status !== undefined) {
+                error = new types_1.RequestError(err.message, err.status, err.name ?? 'APIError');
+            }
+            else {
+                error = err;
+            }
+            return { completed: false, error };
+        }
+    };
+}
+exports.openai = openai;
+//# sourceMappingURL=openai.js.map

package/dist/models/openai.js.map

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

package/dist/models/providers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../src/models/providers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEjD,eAAO,MAAM,iBAAiB,EAAE,QAO/B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,QAO5B,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,QAAQ,EAAwC,CAAC;AAEzE,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,QAAQ,CAMxD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAElE"}
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../src/models/providers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEjD,eAAO,MAAM,iBAAiB,EAAE,QAO/B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,QAO5B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,QAOjC,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,QAAQ,EAA6D,CAAC;AAE9F,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,QAAQ,CAMxD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAElE"}

package/dist/models/providers.js

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.detectProvider = exports.getProvider = exports.PROVIDERS = exports.OpenAIProvider = exports.AnthropicProvider = void 0;
+exports.detectProvider = exports.getProvider = exports.PROVIDERS = exports.FireworksAIProvider = exports.OpenAIProvider = exports.AnthropicProvider = void 0;
 exports.AnthropicProvider = {
     name: 'Anthropic',
     builderModels: ['claude-opus-4-6', 'claude-sonnet-4-5'],
-    chatModels: ['claude-haiku-4-5', 'claude-sonnet-4-5'],
+    chatModels: ['claude-sonnet-4-5', 'claude-haiku-4-5'],
     detectModel(model) {
         return model.startsWith('claude-');
     }
@@ -14,10 +14,18 @@ exports.OpenAIProvider = {
     builderModels: ['gpt-5.2', 'gpt-5.2-codex'],
     chatModels: ['gpt-5-nano', 'gpt-5-mini', 'gpt-4.1'],
     detectModel(model) {
-        return model.startsWith('gpt-') || model.startsWith('GPT-');
+        return model.startsWith('gpt-');
     }
 };
-exports.PROVIDERS = [exports.AnthropicProvider, exports.OpenAIProvider];
+exports.FireworksAIProvider = {
+    name: 'FireworksAI',
+    builderModels: ['fireworks-glm-5'],
+    chatModels: ['fireworks-minimax-m2p5', 'fireworks-kimi-k2p5', 'fireworks-glm-5'],
+    detectModel(model) {
+        return model.startsWith('fireworks-');
+    }
+};
+exports.PROVIDERS = [exports.AnthropicProvider, exports.OpenAIProvider, exports.FireworksAIProvider];
 function getProvider(name) {
     const provider = exports.PROVIDERS.find(p => p.name === name);
     if (!provider) {

package/dist/models/providers.js.map

@@ -1 +1 @@
-{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../src/models/providers.ts"],"names":[],"mappings":";;;AAEa,QAAA,iBAAiB,GAAa;IACvC,IAAI,EAAE,WAAW;IACjB,aAAa,EAAE,CAAC,iBAAiB,EAAE,mBAAmB,CAAC;IACvD,UAAU,EAAE,CAAC,kBAAkB,EAAE,mBAAmB,CAAC;IACrD,WAAW,CAAC,KAAa;QACrB,OAAO,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;CACJ,CAAC;AAEW,QAAA,cAAc,GAAa;IACpC,IAAI,EAAE,QAAQ;IACd,aAAa,EAAE,CAAC,SAAS,EAAE,eAAe,CAAC;IAC3C,UAAU,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,SAAS,CAAC;IACnD,WAAW,CAAC,KAAa;QACrB,OAAO,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAChE,CAAC;CACJ,CAAC;AAEW,QAAA,SAAS,GAAe,CAAC,yBAAiB,EAAE,sBAAc,CAAC,CAAC;AAEzE,SAAgB,WAAW,CAAC,IAAkB;IAC1C,MAAM,QAAQ,GAAG,iBAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACtD,IAAI,CAAC,QAAQ,EAAE;QACX,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;KAChD;IACD,OAAO,QAAQ,CAAC;AACpB,CAAC;AAND,kCAMC;AAED,SAAgB,cAAc,CAAC,KAAa;IACxC,OAAO,iBAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;AACrD,CAAC;AAFD,wCAEC"}
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../src/models/providers.ts"],"names":[],"mappings":";;;AAEa,QAAA,iBAAiB,GAAa;IACvC,IAAI,EAAE,WAAW;IACjB,aAAa,EAAE,CAAC,iBAAiB,EAAE,mBAAmB,CAAC;IACvD,UAAU,EAAE,CAAC,mBAAmB,EAAC,kBAAkB,CAAC;IACpD,WAAW,CAAC,KAAa;QACrB,OAAO,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;CACJ,CAAC;AAEW,QAAA,cAAc,GAAa;IACpC,IAAI,EAAE,QAAQ;IACd,aAAa,EAAE,CAAC,SAAS,EAAE,eAAe,CAAC;IAC3C,UAAU,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,SAAS,CAAC;IACnD,WAAW,CAAC,KAAa;QACrB,OAAO,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;CACJ,CAAC;AAEW,QAAA,mBAAmB,GAAa;IACzC,IAAI,EAAE,aAAa;IACnB,aAAa,EAAE,CAAC,iBAAiB,CAAC;IAClC,UAAU,EAAE,CAAC,wBAAwB,EAAE,qBAAqB,EAAE,iBAAiB,CAAC;IAChF,WAAW,CAAC,KAAa;QACrB,OAAO,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAC1C,CAAC;CACJ,CAAC;AAEW,QAAA,SAAS,GAAe,CAAC,yBAAiB,EAAE,sBAAc,EAAE,2BAAmB,CAAC,CAAC;AAE9F,SAAgB,WAAW,CAAC,IAAkB;IAC1C,MAAM,QAAQ,GAAG,iBAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACtD,IAAI,CAAC,QAAQ,EAAE;QACX,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;KAChD;IACD,OAAO,QAAQ,CAAC;AACpB,CAAC;AAND,kCAMC;AAED,SAAgB,cAAc,CAAC,KAAa;IACxC,OAAO,iBAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;AACrD,CAAC;AAFD,wCAEC"}

package/dist/models/types.d.ts

@@ -1,8 +1,7 @@
-export type ProviderName = 'Anthropic' | 'OpenAI';
+export type ProviderName = 'Anthropic' | 'OpenAI' | 'FireworksAI';
 export interface ProviderConfig {
     apiKey: string;
     model: string;
-    maxTokens: number;
 }
 export interface ModelEntry {
     use: 'builder' | 'chat';
@@ -18,4 +17,56 @@ export interface Provider {
     chatModels: string[];
     detectModel(model: string): boolean;
 }
+export interface TextBlock {
+    type: 'text';
+    text: string;
+}
+export interface ImageBlock {
+    type: 'image';
+    mediaType: string;
+    data: string;
+}
+export type ContentBlock = TextBlock | ImageBlock;
+export type MessageContent = string | ContentBlock[];
+/** Type guard: returns true when content is a multimodal ContentBlock array. */
+export declare function isMultimodalContent(content: MessageContent): content is ContentBlock[];
+export interface Message {
+    role: string;
+    content: string;
+    name?: string;
+}
+export interface SystemMessage extends Message {
+    role: 'system';
+}
+export interface UserMessage {
+    role: 'user';
+    content: MessageContent;
+    name?: string;
+}
+export interface AgentCompletion<TValue> {
+    completed: boolean;
+    value?: TValue;
+    error?: Error;
+}
+export interface PromptCompletionArgs {
+    prompt: UserMessage;
+    system?: SystemMessage;
+    history?: Message[];
+    temperature?: number;
+    jsonMode?: boolean;
+    /** JSON schema for structured output. When provided, the model is asked to return JSON conforming to this schema. */
+    jsonSchema?: Record<string, unknown>;
+    /** When true, system content is wrapped with cache_control for Anthropic prompt caching. */
+    cacheSystem?: boolean;
+    /** JSON schema for structured output via constrained decoding (Anthropic output_config). */
+    outputSchema?: Record<string, unknown>;
+}
+export type completePrompt<TValue = string> = (args: PromptCompletionArgs) => Promise<AgentCompletion<TValue>>;
+export interface AgentArgs {
+    completePrompt: completePrompt<any>;
+}
+export declare class RequestError extends Error {
+    readonly status: number;
+    constructor(message: string, status: number, name?: string);
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/models/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/models/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;AAElD,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACvB,GAAG,EAAE,SAAS,GAAG,MAAM,CAAC;IACxB,QAAQ,EAAE,YAAY,CAAC;IACvB,aAAa,EAAE,cAAc,CAAC;IAC9B,YAAY,EAAE,UAAU,GAAG,IAAI,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,YAAY,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACvC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/models/types.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,aAAa,CAAC;AAElE,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACvB,GAAG,EAAE,SAAS,GAAG,MAAM,CAAC;IACxB,QAAQ,EAAE,YAAY,CAAC;IACvB,aAAa,EAAE,cAAc,CAAC;IAC9B,YAAY,EAAE,UAAU,GAAG,IAAI,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,YAAY,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACvC;AAMD,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,CAAC;AAElD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,YAAY,EAAE,CAAC;AAErD,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,IAAI,YAAY,EAAE,CAEtF;AAMD,MAAM,WAAW,OAAO;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAc,SAAQ,OAAO;IAC1C,IAAI,EAAE,QAAQ,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD,MAAM,WAAW,eAAe,CAAC,MAAM;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,KAAK,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACjC,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qHAAqH;IACrH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,4FAA4F;IAC5F,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,4FAA4F;IAC5F,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,MAAM,MAAM,cAAc,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,oBAAoB,KAAK,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;AAM/G,MAAM,WAAW,SAAS;IACtB,cAAc,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC;CACvC;AAMD,qBAAa,YAAa,SAAQ,KAAK;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAK7D"}

package/dist/models/types.js

@@ -1,3 +1,24 @@
 "use strict";
+// ---------------------------------------------------------------------------
+// Provider types
+// ---------------------------------------------------------------------------
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestError = exports.isMultimodalContent = void 0;
+/** Type guard: returns true when content is a multimodal ContentBlock array. */
+function isMultimodalContent(content) {
+    return Array.isArray(content);
+}
+exports.isMultimodalContent = isMultimodalContent;
+// ---------------------------------------------------------------------------
+// Errors
+// ---------------------------------------------------------------------------
+class RequestError extends Error {
+    status;
+    constructor(message, status, name) {
+        super(message);
+        this.status = status;
+        this.name = name ?? 'RequestError';
+    }
+}
+exports.RequestError = RequestError;
 //# sourceMappingURL=types.js.map

package/dist/models/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/models/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/models/types.ts"],"names":[],"mappings":";AAAA,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;;;AA4C9E,gFAAgF;AAChF,SAAgB,mBAAmB,CAAC,OAAuB;IACvD,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC;AAFD,kDAEC;AAwDD,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E,MAAa,YAAa,SAAQ,KAAK;IAC1B,MAAM,CAAS;IAExB,YAAY,OAAe,EAAE,MAAc,EAAE,IAAa;QACtD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,cAAc,CAAC;IACvC,CAAC;CACJ;AARD,oCAQC"}

package/dist/models/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/models/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,GAAG,GAAG,MAAM,CAWtD"}

package/dist/models/utils.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.variableToString = void 0;
+/**
+ * Convert any value to a string suitable for template substitution.
+ * Replaces double quotes and line feeds with spaces.
+ */
+function variableToString(variable) {
+    if (variable === null || variable === undefined) {
+        return '';
+    }
+    if (typeof variable === 'string') {
+        return variable;
+    }
+    if (typeof variable === 'object') {
+        return JSON.stringify(variable);
+    }
+    return variable.toString();
+}
+exports.variableToString = variableToString;
+//# sourceMappingURL=utils.js.map

package/dist/models/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/models/utils.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,QAAa;IAC1C,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,SAAS,EAAE;QAC7C,OAAO,EAAE,CAAC;KACb;IACD,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE;QAC9B,OAAO,QAAQ,CAAC;KACnB;IACD,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE;QAC9B,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;KACnC;IACD,OAAO,QAAQ,CAAC,QAAQ,EAAE,CAAC;AAC/B,CAAC;AAXD,4CAWC"}

package/dist/pages.d.ts

@@ -1,5 +1,9 @@
-export declare const REQUIRED_PAGES: string[];
-export declare const PAGE_VERSION = 2;
+/**
+ * Derive the list of required page names by scanning *.html files
+ * across one or more requiredPages folders.
+ */
+export declare function getRequiredPages(requiredPagesFolders: string[]): Promise<string[]>;
+export declare const PAGE_VERSION = 3;
 export interface PageInfo {
     name: string;
     title: string;
@@ -12,14 +16,33 @@ export interface PageInfo {
     mode: 'unlocked' | 'locked';
 }
 export type PageMetadata = Omit<PageInfo, 'name'>;
-export declare function loadPageMetadata(pagesFolder: string, name: string, fallbackFolder?: string): Promise<PageMetadata | undefined>;
+export declare function loadPageMetadata(pagesFolder: string, name: string, fallbackFolders?: string[]): Promise<PageMetadata | undefined>;
 export declare function parseMetadata(parsed: Record<string, unknown>): PageMetadata;
 export declare function savePageMetadata(pagesFolder: string, name: string, metadata: PageMetadata): Promise<void>;
-export declare function listPages(pagesFolder: string, fallbackPagesFolder: string): Promise<PageInfo[]>;
-export declare function loadPageState(pagesFolder: string, name: string, reset: boolean): Promise<string | undefined>;
+export declare function listPages(pagesFolder: string, fallbackPagesFolders: string[]): Promise<PageInfo[]>;
+export declare function loadPageState(pagesFolder: string, name: string): Promise<string | undefined>;
 export declare function normalizePageName(name: string | undefined): string | undefined;
 export declare function savePageState(pagesFolder: string, name: string, content: string, title?: string, categories?: string[]): Promise<void>;
-export declare function updatePageState(name: string, content: string): void;
 export declare function deletePage(pagesFolder: string, name: string): Promise<void>;
-export declare function copyPage(pagesFolder: string, sourceName: string, targetName: string, title: string, categories: string[], requiredPagesFolder: string): Promise<void>;
+/**
+ * Save a version snapshot: <pagesFolder>/pages/<name>/page.v<version>.html
+ */
+export declare function savePageVersion(pagesFolder: string, name: string, version: number, html: string): Promise<void>;
+/**
+ * Load a version snapshot (returns undefined if the file doesn't exist).
+ */
+export declare function loadPageVersion(pagesFolder: string, name: string, version: number): Promise<string | undefined>;
+/**
+ * Scan page.v*.html files and return the highest version number (0 if none).
+ */
+export declare function getLatestVersion(pagesFolder: string, name: string): Promise<number>;
+/**
+ * Delete all page.v*.html version files for a page.
+ */
+export declare function clearVersions(pagesFolder: string, name: string): Promise<void>;
+export interface CopyPageOptions {
+    copyTables?: boolean;
+    copyFiles?: boolean;
+}
+export declare function copyPage(pagesFolder: string, sourceName: string, targetName: string, title: string, categories: string[], requiredPagesFolders: string[], options?: CopyPageOptions): Promise<void>;
 //# sourceMappingURL=pages.d.ts.map

package/dist/pages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../src/pages.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,cAAc,UAAsD,CAAC;AAElF,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,UAAU,GAAG,QAAQ,CAAC;CAC/B;AAED,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAElD,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CA4BpI;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CAY3E;AAED,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/G;AAaD,wBAAsB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAuErG;AAED,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAC,SAAS,CAAC,CAgBhH;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAC,SAAS,GAAG,MAAM,GAAC,SAAS,CAE1E;AAED,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB5I;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAEnE;AAED,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAejF;AAED,wBAAsB,QAAQ,CAC1B,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAAE,EACpB,mBAAmB,EAAE,MAAM,GAC5B,OAAO,CAAC,IAAI,CAAC,CA8Bf"}
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../src/pages.ts"],"names":[],"mappings":"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"}