zilmate 1.0.0

package/dist/tools/composio.tool.js

@@ -0,0 +1,272 @@
+import { Composio } from '@composio/core';
+import { VercelProvider } from '@composio/vercel';
+import { env, hasComposio } from '../config/env.js';
+import { loadComposioSession, saveComposioSession } from '../memory/composio-session.js';
+import { requestConfirmation } from '../runtime/confirm.js';
+import { emitProgress } from '../runtime/progress.js';
+const safeMetaTools = new Set([
+    'COMPOSIO_SEARCH_TOOLS',
+    'COMPOSIO_GET_TOOL_SCHEMAS',
+    'COMPOSIO_MANAGE_CONNECTIONS',
+]);
+const readPrefixes = ['GET', 'LIST', 'SEARCH', 'READ', 'FETCH', 'RETRIEVE', 'INSPECT'];
+const writeFragments = [
+    'CREATE',
+    'UPDATE',
+    'DELETE',
+    'SEND',
+    'POST',
+    'PUBLISH',
+    'INVITE',
+    'TRANSFER',
+    'CHARGE',
+    'REFUND',
+    'CANCEL',
+    'APPROVE',
+    'REVOKE',
+    'EXECUTE',
+    'WORKBENCH',
+    'BASH',
+];
+let client;
+function getClient() {
+    if (client)
+        return client;
+    client = new Composio({
+        provider: new VercelProvider(),
+        apiKey: env.composioApiKey ?? null,
+    });
+    return client;
+}
+function actionPart(toolSlug) {
+    return toolSlug.toUpperCase().split('_').slice(1).join('_') || toolSlug.toUpperCase();
+}
+function isReadOnlyTool(toolSlug) {
+    if (safeMetaTools.has(toolSlug.toUpperCase()))
+        return true;
+    const action = actionPart(toolSlug);
+    return readPrefixes.some((prefix) => action === prefix || action.startsWith(`${prefix}_`));
+}
+function isWriteLikeTool(toolSlug) {
+    const upper = toolSlug.toUpperCase();
+    if (upper.includes('REMOTE_WORKBENCH') || upper.includes('REMOTE_BASH'))
+        return true;
+    return writeFragments.some((fragment) => upper.includes(fragment));
+}
+function parseJsonish(value) {
+    const trimmed = value.trim();
+    if (!trimmed || !/^[{[]/.test(trimmed))
+        return value;
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        return value;
+    }
+}
+function findToolSlugs(value) {
+    if (typeof value === 'string') {
+        const parsed = parseJsonish(value);
+        if (parsed !== value)
+            return findToolSlugs(parsed);
+        return value.match(/[A-Z0-9]+_[A-Z0-9_]+/g) ?? [];
+    }
+    if (!value || typeof value !== 'object')
+        return [];
+    if (Array.isArray(value))
+        return value.flatMap(findToolSlugs);
+    const record = value;
+    const direct = ['toolSlug', 'tool_slug', 'slug', 'tool'];
+    const matches = direct.flatMap((field) => findToolSlugs(record[field]));
+    return [...matches, ...Object.values(record).flatMap(findToolSlugs)];
+}
+function getStringField(record, fields) {
+    for (const field of fields) {
+        const value = record[field];
+        if (typeof value === 'string' && value.trim())
+            return value.trim();
+    }
+    return undefined;
+}
+function asRecord(value) {
+    const parsed = typeof value === 'string' ? parseJsonish(value) : value;
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+        return undefined;
+    return parsed;
+}
+function extractInnerTools(params) {
+    const record = asRecord(params);
+    if (!record)
+        return [];
+    const rawTools = record.tools ?? record.tool_calls ?? record.toolCalls;
+    const parsedTools = typeof rawTools === 'string' ? parseJsonish(rawTools) : rawTools;
+    if (!Array.isArray(parsedTools))
+        return [];
+    return parsedTools
+        .map((item) => {
+        const tool = asRecord(item);
+        if (!tool)
+            return null;
+        const slug = getStringField(tool, ['tool_slug', 'toolSlug', 'slug', 'tool']);
+        if (!slug)
+            return null;
+        const rawArguments = tool.arguments ?? tool.args ?? tool.input;
+        const args = asRecord(rawArguments);
+        return {
+            slug,
+            ...(args ? { arguments: args } : {}),
+        };
+    })
+        .filter((tool) => Boolean(tool));
+}
+function classifyTool(toolSlug, params) {
+    const upper = toolSlug.toUpperCase();
+    if (safeMetaTools.has(upper))
+        return 'read';
+    if (upper === 'COMPOSIO_MULTI_EXECUTE_TOOL') {
+        const inner = extractInnerTools(params).map((toolCall) => toolCall.slug);
+        const slugs = [...new Set(inner.length > 0 ? inner : findToolSlugs(params))].filter((slug) => slug.toUpperCase() !== upper);
+        if (slugs.length === 0)
+            return 'write';
+        return slugs.every(isReadOnlyTool) ? 'read' : 'write';
+    }
+    if (isWriteLikeTool(upper))
+        return 'write';
+    if (isReadOnlyTool(upper))
+        return 'read';
+    return 'write';
+}
+function labelFromToolSlug(toolSlug) {
+    const [, ...parts] = toolSlug.toLowerCase().split('_');
+    return parts.length > 0
+        ? parts.map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(' ')
+        : toolSlug;
+}
+function summarizeValue(value) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    if (typeof value === 'boolean')
+        return value ? 'yes' : 'no';
+    if (typeof value === 'string')
+        return value.length > 80 ? `${value.slice(0, 77)}...` : value;
+    if (typeof value === 'number')
+        return String(value);
+    try {
+        const json = JSON.stringify(value);
+        return json.length > 80 ? `${json.slice(0, 77)}...` : json;
+    }
+    catch {
+        return String(value);
+    }
+}
+function friendlyDetails(toolCall) {
+    const args = toolCall.arguments ?? {};
+    const preferred = ['to', 'recipient', 'subject', 'query', 'max_results', 'limit', 'user_id', 'include_payload', 'verbose'];
+    const entries = [
+        ...preferred.filter((key) => key in args).map((key) => [key, args[key]]),
+        ...Object.entries(args).filter(([key]) => !preferred.includes(key)).slice(0, 6),
+    ];
+    return entries
+        .map(([key, value]) => {
+        const summarized = summarizeValue(value);
+        if (!summarized)
+            return null;
+        const label = key.replace(/_/g, ' ').replace(/\b\w/g, (char) => char.toUpperCase());
+        return `${label}: ${summarized}`;
+    })
+        .filter((item) => Boolean(item))
+        .slice(0, 8);
+}
+function createConfirmationDisplay(toolkitSlug, toolSlug, params) {
+    const innerTools = toolSlug.toUpperCase() === 'COMPOSIO_MULTI_EXECUTE_TOOL' ? extractInnerTools(params) : [];
+    const targetTools = innerTools.length > 0 ? innerTools.map((toolCall) => toolCall.slug) : [toolSlug];
+    const fallbackArgs = asRecord(params);
+    const primary = innerTools[0] ?? {
+        slug: toolSlug,
+        ...(fallbackArgs ? { arguments: fallbackArgs } : {}),
+    };
+    const writeTools = targetTools.filter((slug) => !isReadOnlyTool(slug));
+    const details = innerTools.length === 1 ? friendlyDetails(primary) : innerTools.map((toolCall) => `${toolCall.slug}: ${labelFromToolSlug(toolCall.slug)}`);
+    return {
+        toolkitSlug: innerTools.length === 1 ? innerTools[0].slug.split('_')[0] || toolkitSlug : toolkitSlug,
+        toolSlug,
+        targetTools,
+        action: innerTools.length === 1
+            ? labelFromToolSlug(primary.slug)
+            : `Run ${targetTools.length} external app action${targetTools.length === 1 ? '' : 's'}`,
+        access: writeTools.length === 0 ? 'Read-only' : 'Write',
+        details,
+        summary: details.length > 0 ? details.join('; ') : 'External app action',
+    };
+}
+async function getOrCreateSession(chatSessionId) {
+    const composio = getClient();
+    const saved = await loadComposioSession(chatSessionId);
+    if (saved?.sessionId) {
+        try {
+            const session = await composio.use(saved.sessionId);
+            return { session, reused: true };
+        }
+        catch {
+            emitProgress({ type: 'tool:error', label: 'Composio session reuse failed', detail: 'Creating a fresh session' });
+        }
+    }
+    const session = await composio.create(env.zilmateUserId);
+    await saveComposioSession(chatSessionId, session.sessionId);
+    return { session, reused: false };
+}
+function executionGuard() {
+    return {
+        beforeExecute: async ({ toolSlug, toolkitSlug, params }) => {
+            const classification = classifyTool(toolSlug, params);
+            if (classification === 'read')
+                return params;
+            const approved = await requestConfirmation({
+                ...createConfirmationDisplay(toolkitSlug, toolSlug, params),
+            });
+            if (!approved) {
+                throw new Error(`Blocked Composio write-like action ${toolkitSlug}/${toolSlug}. Run interactively and answer y to approve it.`);
+            }
+            return params;
+        },
+    };
+}
+export async function createComposioTools(chatSessionId = 'default') {
+    if (!hasComposio())
+        return {};
+    emitProgress({ type: 'tool:start', label: 'Loading Composio tools', detail: chatSessionId });
+    const { session, reused } = await getOrCreateSession(chatSessionId);
+    const tools = await session.tools(executionGuard());
+    emitProgress({ type: 'tool:end', label: reused ? 'Composio session reused' : 'Composio session created', detail: session.sessionId });
+    return tools;
+}
+export async function getComposioStatus(chatSessionId = 'default') {
+    const configured = hasComposio();
+    const status = {
+        configured,
+        userId: env.zilmateUserId || null,
+        sessionId: null,
+        reusedSession: false,
+        toolkits: [],
+    };
+    if (!configured)
+        return status;
+    const { session, reused } = await getOrCreateSession(chatSessionId);
+    status.sessionId = session.sessionId;
+    status.reusedSession = reused;
+    try {
+        const toolkits = await session.toolkits({ limit: 25 });
+        status.toolkits = toolkits.items.map((item) => ({
+            slug: item.slug,
+            name: item.name,
+            isNoAuth: item.isNoAuth,
+            connected: Boolean(item.connection?.isActive || item.isNoAuth),
+            ...(item.connection?.connectedAccount?.status ? { status: item.connection.connectedAccount.status } : {}),
+        }));
+    }
+    catch (error) {
+        emitProgress({ type: 'tool:error', label: 'Composio toolkit status unavailable', detail: error instanceof Error ? error.message : String(error) });
+    }
+    return status;
+}
+//# sourceMappingURL=composio.tool.js.map

package/dist/tools/composio.tool.js.map

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

package/dist/tools/docs-fetch.tool.d.ts

@@ -0,0 +1,6 @@
+export declare function assertAllowedDocsUrl(rawUrl: string): string;
+export declare function fetchDocsText(rawUrl: string): Promise<string>;
+export declare const docsFetchTool: import("ai").Tool<{
+    url: string;
+}, string>;
+//# sourceMappingURL=docs-fetch.tool.d.ts.map

package/dist/tools/docs-fetch.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-fetch.tool.d.ts","sourceRoot":"","sources":["../../src/tools/docs-fetch.tool.ts"],"names":[],"mappings":"AAuBA,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,UAMlD;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,mBA4BjD;AAED,eAAO,MAAM,aAAa;;UAIxB,CAAC"}

package/dist/tools/docs-fetch.tool.js

@@ -0,0 +1,62 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { tool } from 'ai';
+import { z } from 'zod';
+import { clampText, limits } from '../safety/limits.js';
+import { emitProgress } from '../runtime/progress.js';
+const allowedHosts = new Set([
+    'ai-sdk.dev',
+    'sdk.vercel.ai',
+    'vercel.com',
+    'developers.openai.com',
+    'platform.openai.com',
+    'openai.com',
+    'upstash.com',
+]);
+const cacheDir = path.resolve('.zilo-manager', 'docs-cache');
+function cacheName(url) {
+    return Buffer.from(url).toString('base64url').slice(0, 160) + '.txt';
+}
+export function assertAllowedDocsUrl(rawUrl) {
+    const url = new URL(rawUrl);
+    if (!allowedHosts.has(url.hostname)) {
+        throw new Error(`Docs fetch blocked for non-allowlisted host: ${url.hostname}`);
+    }
+    return url.toString();
+}
+export async function fetchDocsText(rawUrl) {
+    const url = assertAllowedDocsUrl(rawUrl);
+    await mkdir(cacheDir, { recursive: true });
+    const file = path.join(cacheDir, cacheName(url));
+    try {
+        const cached = JSON.parse(await readFile(file, 'utf8'));
+        if (Date.now() - cached.fetchedAt < limits.docsCacheTtlMs) {
+            emitProgress({ type: 'fetch:end', label: 'Loaded docs from cache', detail: url });
+            return cached.text;
+        }
+    }
+    catch {
+        // cache miss
+    }
+    emitProgress({ type: 'fetch:start', label: 'Fetching docs', detail: url });
+    const response = await fetch(url, { headers: { accept: 'text/plain,text/markdown,text/html' } });
+    if (!response.ok)
+        throw new Error(`Docs fetch failed ${response.status}: ${url}`);
+    const html = await response.text();
+    const text = html
+        .replace(/<script[\s\S]*?<\/script>/gi, ' ')
+        .replace(/<style[\s\S]*?<\/style>/gi, ' ')
+        .replace(/<[^>]+>/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+    const clipped = clampText(text, 12000);
+    await writeFile(file, JSON.stringify({ fetchedAt: Date.now(), text: clipped }, null, 2), 'utf8');
+    emitProgress({ type: 'fetch:end', label: 'Docs fetched', detail: url });
+    return clipped;
+}
+export const docsFetchTool = tool({
+    description: 'Fetch and cache allowlisted documentation pages. Use only for docs/reference sources.',
+    inputSchema: z.object({ url: z.string().url() }),
+    execute: async ({ url }) => fetchDocsText(url),
+});
+//# sourceMappingURL=docs-fetch.tool.js.map

package/dist/tools/docs-fetch.tool.js.map

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

package/dist/tools/docs-search.tool.d.ts

@@ -0,0 +1,4 @@
+export declare const docsSearchTool: import("ai").Tool<{
+    query: string;
+}, import("./web-search.tool.js").WebSearchResult[]>;
+//# sourceMappingURL=docs-search.tool.d.ts.map

package/dist/tools/docs-search.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-search.tool.d.ts","sourceRoot":"","sources":["../../src/tools/docs-search.tool.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,cAAc;;oDAQzB,CAAC"}

package/dist/tools/docs-search.tool.js

@@ -0,0 +1,14 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+import { searchWeb } from './web-search.tool.js';
+import { emitProgress } from '../runtime/progress.js';
+export const docsSearchTool = tool({
+    description: 'Search primary AI SDK, Vercel Gateway, OpenAI, and Upstash docs for implementation guidance.',
+    inputSchema: z.object({ query: z.string().min(3) }),
+    execute: async ({ query }) => {
+        emitProgress({ type: 'search:start', label: 'Searching primary docs', detail: query });
+        const scopedQuery = `${query} site:ai-sdk.dev OR site:vercel.com/docs OR site:developers.openai.com OR site:upstash.com`;
+        return searchWeb(scopedQuery, 5);
+    },
+});
+//# sourceMappingURL=docs-search.tool.js.map

package/dist/tools/docs-search.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-search.tool.js","sourceRoot":"","sources":["../../src/tools/docs-search.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;IACjC,WAAW,EAAE,8FAA8F;IAC3G,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACnD,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAC3B,YAAY,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,wBAAwB,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACvF,MAAM,WAAW,GAAG,GAAG,KAAK,4FAA4F,CAAC;QACzH,OAAO,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IACnC,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/image-generate.tool.d.ts

@@ -0,0 +1,22 @@
+import { type ImageProvider } from '../config/env.js';
+export type ImageProviderInput = ImageProvider | 'chatgpt' | 'google' | 'default';
+export type ImageSize = `${number}x${number}`;
+export type ImageGenerationOptions = {
+    provider?: ImageProviderInput | undefined;
+    size?: ImageSize | undefined;
+    outputDir?: string | undefined;
+};
+export type ImageGenerationResult = {
+    text?: string;
+    files: string[];
+    model: string;
+    provider: ImageProvider;
+};
+export declare function isImageSize(value: string | undefined): value is ImageSize;
+export declare function generateImageAsset(prompt: string, options?: ImageGenerationOptions): Promise<ImageGenerationResult>;
+export declare const imageGenerateTool: import("ai").Tool<{
+    prompt: string;
+    provider?: "openai" | "gemini" | "chatgpt" | "google" | "default" | undefined;
+    size?: string | undefined;
+}, ImageGenerationResult>;
+//# sourceMappingURL=image-generate.tool.d.ts.map

package/dist/tools/image-generate.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-generate.tool.d.ts","sourceRoot":"","sources":["../../src/tools/image-generate.tool.ts"],"names":[],"mappings":"AAKA,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAI1E,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAClF,MAAM,MAAM,SAAS,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAE9C,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAC1C,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,aAAa,CAAC;CACzB,CAAC;AAEF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,IAAI,SAAS,CAEzE;AAmFD,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAO7H;AAED,eAAO,MAAM,iBAAiB;;;;yBAW5B,CAAC"}

package/dist/tools/image-generate.tool.js

@@ -0,0 +1,113 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { generateImage, generateText, tool } from 'ai';
+import { z } from 'zod';
+import { models } from '../config/models.js';
+import { requireGatewayAuth } from '../config/env.js';
+import { redactSensitiveText } from '../safety/redaction.js';
+import { emitProgress } from '../runtime/progress.js';
+export function isImageSize(value) {
+    return /^\d+x\d+$/.test(value || '');
+}
+function normalizeProvider(provider) {
+    const value = (provider || models.imageDefaultProvider || 'openai').toLowerCase().trim();
+    if (value === 'default')
+        return models.imageDefaultProvider;
+    if (value === 'chatgpt' || value === 'openai')
+        return 'openai';
+    if (value === 'google' || value === 'gemini')
+        return 'gemini';
+    throw new Error(`Unsupported image provider: ${provider}. Use openai, chatgpt, or gemini.`);
+}
+function extensionFromMediaType(mediaType) {
+    const value = mediaType?.split('/')[1]?.split(';')[0];
+    if (!value)
+        return 'png';
+    if (value === 'jpeg')
+        return 'jpg';
+    return value;
+}
+function toBuffer(data) {
+    if (typeof data === 'string')
+        return Buffer.from(data, 'base64');
+    if (data instanceof ArrayBuffer)
+        return Buffer.from(new Uint8Array(data));
+    return Buffer.from(data);
+}
+async function saveImageBytes(data, mediaType, outputDir, index) {
+    const extension = extensionFromMediaType(mediaType);
+    const filename = `zilo-image-${Date.now()}-${index}.${extension}`;
+    const target = path.join(outputDir, filename);
+    await writeFile(target, toBuffer(data));
+    return target;
+}
+async function generateOpenAiImage(prompt, outputDir, size) {
+    const model = models.imageOpenai;
+    emitProgress({ type: 'tool:start', label: 'Generating OpenAI image', detail: model });
+    const result = await generateImage({
+        model,
+        prompt: redactSensitiveText(prompt),
+        ...(size ? { size } : {}),
+        providerOptions: {
+            gateway: {
+                tags: ['zilo-manager', 'feature:image', 'model:openai'],
+            },
+        },
+    });
+    const saved = [];
+    for (const [index, image] of result.images.entries()) {
+        const value = image;
+        const data = value.uint8Array || value.data || value.base64;
+        if (!data)
+            continue;
+        saved.push(await saveImageBytes(data, value.mediaType || image.mediaType, outputDir, index));
+    }
+    emitProgress({ type: 'tool:end', label: 'OpenAI image generation complete', detail: `${saved.length} file${saved.length === 1 ? '' : 's'}` });
+    return { files: saved, model, provider: 'openai' };
+}
+async function generateGeminiImage(prompt, outputDir) {
+    const model = models.imageGemini;
+    emitProgress({ type: 'tool:start', label: 'Generating Gemini image', detail: model });
+    const result = await generateText({
+        model,
+        prompt: redactSensitiveText(prompt),
+        providerOptions: {
+            gateway: {
+                tags: ['zilo-manager', 'feature:image', 'model:gemini'],
+            },
+        },
+    });
+    const files = (result.files || []).filter((file) => file.mediaType?.startsWith('image/'));
+    const saved = [];
+    for (const [index, file] of files.entries()) {
+        const value = file;
+        const data = value.uint8Array || value.data || value.base64;
+        if (!data)
+            continue;
+        saved.push(await saveImageBytes(data, value.mediaType || file.mediaType, outputDir, index));
+    }
+    emitProgress({ type: 'tool:end', label: 'Gemini image generation complete', detail: `${saved.length} file${saved.length === 1 ? '' : 's'}` });
+    return { text: result.text, files: saved, model, provider: 'gemini' };
+}
+export async function generateImageAsset(prompt, options = {}) {
+    requireGatewayAuth();
+    const outputDir = options.outputDir || path.resolve('outputs', 'images');
+    await mkdir(outputDir, { recursive: true });
+    const provider = normalizeProvider(options.provider);
+    if (provider === 'gemini')
+        return generateGeminiImage(prompt, outputDir);
+    return generateOpenAiImage(prompt, outputDir, options.size);
+}
+export const imageGenerateTool = tool({
+    description: 'Generate a high-quality image with OpenAI GPT Image 2 or Gemini 3 Pro Image and save it locally.',
+    inputSchema: z.object({
+        prompt: z.string().min(5),
+        provider: z.enum(['openai', 'chatgpt', 'gemini', 'google', 'default']).optional(),
+        size: z.string().regex(/^\d+x\d+$/).optional(),
+    }),
+    execute: async ({ prompt, provider, size }) => generateImageAsset(prompt, {
+        ...(provider ? { provider } : {}),
+        ...(isImageSize(size) ? { size } : {}),
+    }),
+});
+//# sourceMappingURL=image-generate.tool.js.map

package/dist/tools/image-generate.tool.js.map

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

package/dist/tools/memory.tool.d.ts

@@ -0,0 +1,18 @@
+export declare const memoryTools: {
+    rememberMemory: import("ai").Tool<{
+        text: string;
+        tags?: string[] | undefined;
+    }, import("../memory/long-term.js").LongTermMemory>;
+    recallMemory: import("ai").Tool<{
+        query?: string | undefined;
+        limit?: number | undefined;
+    }, import("../memory/long-term.js").LongTermMemory[]>;
+    listMemory: import("ai").Tool<Record<string, never>, import("../memory/long-term.js").LongTermMemory[]>;
+    forgetMemory: import("ai").Tool<{
+        id: string;
+    }, {
+        id: string;
+        deleted: boolean;
+    }>;
+};
+//# sourceMappingURL=memory.tool.d.ts.map

package/dist/tools/memory.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.tool.d.ts","sourceRoot":"","sources":["../../src/tools/memory.tool.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;CA+CvB,CAAC"}

package/dist/tools/memory.tool.js

@@ -0,0 +1,53 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+import { forget, listMemories, recall, remember } from '../memory/long-term.js';
+import { emitProgress } from '../runtime/progress.js';
+export const memoryTools = {
+    rememberMemory: tool({
+        description: 'Save a durable long-term memory for ZilMate. Use for stable user preferences, durable project facts, and recurring context.',
+        inputSchema: z.object({
+            text: z.string().min(3).max(2000),
+            tags: z.array(z.string().min(1).max(40)).max(8).optional(),
+        }),
+        execute: async ({ text, tags }) => {
+            emitProgress({ type: 'fetch:start', label: 'Saving memory' });
+            const memory = await remember(text, tags ?? []);
+            emitProgress({ type: 'fetch:end', label: 'Memory saved', detail: memory.id });
+            return memory;
+        },
+    }),
+    recallMemory: tool({
+        description: 'Recall durable long-term ZilMate memories by query. Use before answering when user preferences or recurring project facts may matter.',
+        inputSchema: z.object({
+            query: z.string().max(500).optional(),
+            limit: z.number().int().min(1).max(12).optional(),
+        }),
+        execute: async ({ query, limit }) => {
+            emitProgress(query ? { type: 'fetch:start', label: 'Recalling memory', detail: query } : { type: 'fetch:start', label: 'Recalling memory' });
+            const memories = await recall(query ?? '', limit ?? 8);
+            emitProgress({ type: 'fetch:end', label: 'Memory recalled', detail: `${memories.length} item${memories.length === 1 ? '' : 's'}` });
+            return memories;
+        },
+    }),
+    listMemory: tool({
+        description: 'List all durable long-term memories saved for ZilMate.',
+        inputSchema: z.object({}),
+        execute: async () => {
+            emitProgress({ type: 'fetch:start', label: 'Listing memory' });
+            const memories = await listMemories();
+            emitProgress({ type: 'fetch:end', label: 'Memory listed', detail: `${memories.length} item${memories.length === 1 ? '' : 's'}` });
+            return memories;
+        },
+    }),
+    forgetMemory: tool({
+        description: 'Forget one durable long-term memory by id.',
+        inputSchema: z.object({ id: z.string().min(1) }),
+        execute: async ({ id }) => {
+            emitProgress({ type: 'fetch:start', label: 'Forgetting memory', detail: id });
+            const deleted = await forget(id);
+            emitProgress({ type: 'fetch:end', label: deleted ? 'Memory forgotten' : 'Memory not found', detail: id });
+            return { id, deleted };
+        },
+    }),
+};
+//# sourceMappingURL=memory.tool.js.map

package/dist/tools/memory.tool.js.map

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