zilmate 1.6.2 → 1.7.0

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

@@ -1,4 +1,4 @@
-import { mkdir, writeFile } from 'node:fs/promises';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
 import path from 'node:path';
 import { generateImage, generateText, tool } from 'ai';
 import { z } from 'zod';
@@ -42,39 +42,123 @@ async function saveImageBytes(data, mediaType, outputDir, index) {
     await writeFile(target, toBuffer(data));
     return target;
 }
-async function generateOpenAiImage(prompt, outputDir, size) {
+function isHttpUrl(value) {
+    try {
+        const parsed = new URL(value);
+        return parsed.protocol === 'http:' || parsed.protocol === 'https:';
+    }
+    catch {
+        return false;
+    }
+}
+async function loadRemoteImage(url) {
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`Could not load image URL ${url}: ${response.status} ${response.statusText}`);
+    }
+    return new Uint8Array(await response.arrayBuffer());
+}
+async function loadImageReference(reference) {
+    if (isHttpUrl(reference))
+        return loadRemoteImage(reference);
+    return readFile(path.resolve(reference));
+}
+async function loadEditInputs(options) {
+    const imageSources = [...(options.imagePaths || []), ...(options.imageUrls || [])].filter(Boolean);
+    const maskSource = options.maskPath || options.maskUrl;
+    if (imageSources.length === 0 && !maskSource)
+        return undefined;
+    if (imageSources.length === 0) {
+        throw new Error('Image editing needs at least one input image. Provide imagePaths or imageUrls.');
+    }
+    emitProgress({ type: 'tool:start', label: 'Loading input image references', detail: `${imageSources.length} image${imageSources.length === 1 ? '' : 's'}` });
+    const loaded = { images: [], sources: [...imageSources] };
+    for (const source of imageSources) {
+        loaded.images.push(await loadImageReference(source));
+    }
+    if (maskSource) {
+        loaded.mask = await loadImageReference(maskSource);
+        loaded.sources.push(`mask:${maskSource}`);
+    }
+    emitProgress({ type: 'tool:end', label: 'Input images loaded', detail: `${loaded.images.length} image${loaded.images.length === 1 ? '' : 's'}` });
+    return loaded;
+}
+function buildImagePrompt(prompt, inputs) {
+    const text = redactSensitiveText(prompt);
+    if (!inputs)
+        return text;
+    return {
+        text,
+        images: inputs.images,
+        ...(inputs.mask ? { mask: inputs.mask } : {}),
+    };
+}
+async function saveGeneratedImages(result, outputDir) {
+    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));
+    }
+    return saved;
+}
+async function generateOpenAiImage(prompt, outputDir, size, inputs) {
     const model = models.imageOpenai;
-    emitProgress({ type: 'tool:start', label: 'Generating OpenAI image', detail: model });
+    const operation = inputs ? 'edit' : 'generate';
+    emitProgress({ type: 'tool:start', label: `${operation === 'edit' ? 'Editing' : 'Generating'} OpenAI image`, detail: model });
     const result = await generateImage({
         model,
-        prompt: redactSensitiveText(prompt),
+        prompt: buildImagePrompt(prompt, inputs),
         ...(size ? { size } : {}),
         providerOptions: {
             gateway: {
-                tags: ['zilo-manager', 'feature:image', 'model:openai'],
+                tags: ['zilo-manager', `feature:image-${operation}`, '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' };
+    const saved = await saveGeneratedImages(result, outputDir);
+    emitProgress({ type: 'tool:end', label: `OpenAI image ${operation} complete`, detail: `${saved.length} file${saved.length === 1 ? '' : 's'}` });
+    return {
+        files: saved,
+        model,
+        provider: 'openai',
+        operation,
+        ...(inputs?.sources.length ? { inputImages: inputs.sources } : {}),
+    };
 }
-async function generateGeminiImage(prompt, outputDir) {
+async function generateGeminiImage(prompt, outputDir, size, inputs) {
     const model = models.imageGemini;
+    if (inputs) {
+        emitProgress({ type: 'tool:start', label: 'Editing Gemini image', detail: model });
+        const result = await generateImage({
+            model,
+            prompt: buildImagePrompt(prompt, inputs),
+            ...(size ? { size } : {}),
+            providerOptions: {
+                gateway: {
+                    tags: ['zilo-manager', 'feature:image-edit', 'model:gemini'],
+                },
+            },
+        });
+        const saved = await saveGeneratedImages(result, outputDir);
+        emitProgress({ type: 'tool:end', label: 'Gemini image edit complete', detail: `${saved.length} file${saved.length === 1 ? '' : 's'}` });
+        return {
+            files: saved,
+            model,
+            provider: 'gemini',
+            operation: 'edit',
+            inputImages: inputs.sources,
+        };
+    }
     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'],
+                tags: ['zilo-manager', 'feature:image-generate', 'model:gemini'],
             },
         },
     });
@@ -88,27 +172,36 @@ async function generateGeminiImage(prompt, outputDir) {
         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' };
+    return { text: result.text, files: saved, model, provider: 'gemini', operation: 'generate' };
 }
 export async function generateImageAsset(prompt, options = {}) {
     requireGatewayAuth();
     const outputDir = options.outputDir || getOutputDir('images');
     await mkdir(outputDir, { recursive: true });
     const provider = normalizeProvider(options.provider);
+    const inputs = await loadEditInputs(options);
     if (provider === 'gemini')
-        return generateGeminiImage(prompt, outputDir);
-    return generateOpenAiImage(prompt, outputDir, options.size);
+        return generateGeminiImage(prompt, outputDir, options.size, inputs);
+    return generateOpenAiImage(prompt, outputDir, options.size, inputs);
 }
 export const imageGenerateTool = tool({
-    description: 'Generate a high-quality image with OpenAI GPT Image 2 or Gemini 3 Pro Image and save it locally.',
+    description: 'Generate or edit high-quality images with OpenAI GPT Image 2 or Gemini image models. Accepts local image paths, image URLs, and optional masks, then saves outputs 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(),
+        imagePaths: z.array(z.string().min(1)).optional().describe('Local image file paths to edit or use as visual references.'),
+        imageUrls: z.array(z.string().url()).optional().describe('Remote image URLs to edit or use as visual references.'),
+        maskPath: z.string().min(1).optional().describe('Optional local mask image path for masked edits. Requires at least one input image.'),
+        maskUrl: z.string().url().optional().describe('Optional mask image URL for masked edits. Requires at least one input image.'),
     }),
-    execute: async ({ prompt, provider, size }) => generateImageAsset(prompt, {
+    execute: async ({ prompt, provider, size, imagePaths, imageUrls, maskPath, maskUrl }) => generateImageAsset(prompt, {
         ...(provider ? { provider } : {}),
         ...(isImageSize(size) ? { size } : {}),
+        ...(imagePaths?.length ? { imagePaths } : {}),
+        ...(imageUrls?.length ? { imageUrls } : {}),
+        ...(maskPath ? { maskPath } : {}),
+        ...(maskUrl ? { maskUrl } : {}),
     }),
 });
 //# sourceMappingURL=image-generate.tool.js.map

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

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

package/dist/tools/notebook.tool.js

@@ -4,7 +4,7 @@ import { addNotebookEntry, appendNotebookMarkdown, listNotebookEntries, readNote
 import { emitProgress } from '../runtime/progress.js';
 export const notebookTools = {
     readNotebook: tool({
-        description: 'Read ZilMate private notebook.md — durable working notes separate from scratchpad.',
+        description: 'Read ZilMate private notebook.md: durable project/user working notes separate from short-lived scratchpad.',
         inputSchema: z.object({ limitChars: z.number().int().min(500).max(50_000).optional() }),
         execute: async ({ limitChars }) => {
             const text = await readNotebookMarkdown();
@@ -15,7 +15,7 @@ export const notebookTools = {
         },
     }),
     appendNotebook: tool({
-        description: 'Append a section to notebook.md and mirror it in notes.json.',
+        description: 'Save durable project memory to notebook.md and notes.json: architecture decisions, setup steps, recurring errors, commands, ports, preferences, and handoff notes.',
         inputSchema: z.object({
             title: z.string().min(1),
             body: z.string().min(1),
@@ -32,17 +32,17 @@ export const notebookTools = {
         },
     }),
     searchNotebook: tool({
-        description: 'Search structured notebook entries by keyword.',
+        description: 'Search durable structured notebook entries by keyword before asking the user to repeat prior project context.',
         inputSchema: z.object({ query: z.string().min(2), limit: z.number().int().min(1).max(20).optional() }),
         execute: async ({ query, limit }) => searchNotebook(query, limit ?? 10),
     }),
     listNotebookEntries: tool({
-        description: 'List recent structured notebook entries from notes.json.',
+        description: 'List recent durable notebook entries from notes.json for project/session recall.',
         inputSchema: z.object({ limit: z.number().int().min(1).max(50).optional() }),
         execute: async ({ limit }) => listNotebookEntries(limit ?? 15),
     }),
     quickNotebookNote: tool({
-        description: 'Quick append to notebook.md without structured entry metadata.',
+        description: 'Quick append to notebook.md for lightweight durable notes when structured metadata is unnecessary.',
         inputSchema: z.object({ section: z.string().min(1), content: z.string().min(1) }),
         execute: async ({ section, content }) => appendNotebookMarkdown(section, content),
     }),

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

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

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

@@ -28,12 +28,12 @@ export declare const usernameTools: {
         username: string;
         allSites: boolean;
         permute: boolean;
-        format: "csv" | "json" | "pdf" | "html" | "txt";
+        format: "json" | "csv" | "pdf" | "html" | "txt";
         tags?: string | undefined;
     }, {
         username: string;
         outputDir: string;
-        format: "csv" | "json" | "pdf" | "html" | "txt";
+        format: "json" | "csv" | "pdf" | "html" | "txt";
         raw: string;
     }>;
     /**
@@ -391,12 +391,12 @@ export declare const osintTools: {
         username: string;
         allSites: boolean;
         permute: boolean;
-        format: "csv" | "json" | "pdf" | "html" | "txt";
+        format: "json" | "csv" | "pdf" | "html" | "txt";
         tags?: string | undefined;
     }, {
         username: string;
         outputDir: string;
-        format: "csv" | "json" | "pdf" | "html" | "txt";
+        format: "json" | "csv" | "pdf" | "html" | "txt";
         raw: string;
     }>;
     /**

package/dist/tools/session-continuity.tool.d.ts

@@ -0,0 +1,25 @@
+type Handoff = {
+    sessionId: string;
+    summary: string;
+    nextActions: string[];
+    openThreads: string[];
+    updatedAt: string;
+};
+export declare function loadSessionHandoff(sessionId: string): Promise<Handoff | null>;
+export declare function saveSessionHandoff(sessionId: string, input: Omit<Handoff, 'sessionId' | 'updatedAt'>): Promise<Handoff>;
+export declare const sessionContinuityTools: {
+    getSessionHandoff: import("ai").Tool<{
+        sessionId?: string | undefined;
+    }, Handoff | null>;
+    saveSessionHandoff: import("ai").Tool<{
+        summary: string;
+        nextActions: string[];
+        sessionId?: string | undefined;
+        openThreads?: string[] | undefined;
+    }, Handoff>;
+    generateSessionHandoff: import("ai").Tool<{
+        sessionId?: string | undefined;
+    }, Handoff>;
+};
+export {};
+//# sourceMappingURL=session-continuity.tool.d.ts.map

package/dist/tools/session-continuity.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-continuity.tool.d.ts","sourceRoot":"","sources":["../../src/tools/session-continuity.tool.ts"],"names":[],"mappings":"AAaA,KAAK,OAAO,GAAG;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAMF,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAQnF;AAED,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,CAAC,oBAS1G;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;CAqDlC,CAAC"}

package/dist/tools/session-continuity.tool.js

@@ -0,0 +1,90 @@
+// src/tools/session-continuity.tool.ts
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { tool } from 'ai';
+import { z } from 'zod';
+import { generateText } from 'ai';
+import { models } from '../config/models.js';
+import { workspaceLayout } from '../workspace/paths.js';
+import { loadTurns } from '../memory/history.js';
+import { appendNotebookMarkdown } from '../memory/notebook.js';
+import { emitProgress } from '../runtime/progress.js';
+function handoffPath(sessionId) {
+    return path.join(workspaceLayout().config, `handoff-${sessionId}.json`);
+}
+export async function loadSessionHandoff(sessionId) {
+    const file = handoffPath(sessionId);
+    if (!existsSync(file))
+        return null;
+    try {
+        return JSON.parse(await readFile(file, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+export async function saveSessionHandoff(sessionId, input) {
+    const payload = {
+        sessionId,
+        ...input,
+        updatedAt: new Date().toISOString(),
+    };
+    await mkdir(workspaceLayout().config, { recursive: true });
+    await writeFile(handoffPath(sessionId), JSON.stringify(payload, null, 2), 'utf8');
+    return payload;
+}
+export const sessionContinuityTools = {
+    getSessionHandoff: tool({
+        description: 'Load the last session handoff: summary, next actions, and open threads so you can continue seamlessly.',
+        inputSchema: z.object({ sessionId: z.string().optional() }),
+        execute: async ({ sessionId = 'default' }) => loadSessionHandoff(sessionId),
+    }),
+    saveSessionHandoff: tool({
+        description: 'Save a session handoff before ending work so the next session can resume instantly.',
+        inputSchema: z.object({
+            sessionId: z.string().optional(),
+            summary: z.string().min(10),
+            nextActions: z.array(z.string()).min(1),
+            openThreads: z.array(z.string()).optional(),
+        }),
+        execute: async ({ sessionId = 'default', summary, nextActions, openThreads }) => {
+            const saved = await saveSessionHandoff(sessionId, {
+                summary,
+                nextActions,
+                openThreads: openThreads ?? [],
+            });
+            await appendNotebookMarkdown('Session handoff', `${summary}\n\nNext:\n${nextActions.map((a) => `- ${a}`).join('\n')}`);
+            return saved;
+        },
+    }),
+    generateSessionHandoff: tool({
+        description: 'Automatically synthesize a session handoff from recent chat turns.',
+        inputSchema: z.object({ sessionId: z.string().optional() }),
+        execute: async ({ sessionId = 'default' }) => {
+            emitProgress({ type: 'thinking', label: 'Generating session handoff' });
+            const turns = await loadTurns(sessionId);
+            const transcript = turns.slice(-12).map((t) => `${t.role}: ${t.content.slice(0, 400)}`).join('\n');
+            const result = await generateText({
+                model: models.manager,
+                prompt: `Create JSON only: {"summary":"...","nextActions":["..."],"openThreads":["..."]}\nFrom this session:\n${transcript || '(empty session)'}`,
+            });
+            let parsed = {};
+            try {
+                const match = result.text.match(/\{[\s\S]*\}/);
+                parsed = match ? JSON.parse(match[0]) : {};
+            }
+            catch {
+                parsed = { summary: result.text.trim(), nextActions: ['Continue previous task'] };
+            }
+            const saved = await saveSessionHandoff(sessionId, {
+                summary: parsed.summary || 'Session handoff',
+                nextActions: parsed.nextActions?.length ? parsed.nextActions : ['Review last conversation'],
+                openThreads: parsed.openThreads ?? [],
+            });
+            emitProgress({ type: 'done', label: 'Handoff saved' });
+            return saved;
+        },
+    }),
+};
+//# sourceMappingURL=session-continuity.tool.js.map

package/dist/tools/session-continuity.tool.js.map

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

package/dist/tools/situational-awareness.tool.d.ts

@@ -0,0 +1,71 @@
+export declare function buildSituationBrief(sessionId?: string): Promise<{
+    sessionId: string;
+    cwd: string;
+    package: string;
+    platform: string;
+    workspace: string;
+    models: {
+        manager: string;
+        coding: string;
+        image: string;
+        overrides: Partial<Record<import("../config/model-store.js").ModelRole, string>>;
+    };
+    capabilities: {
+        gateway: boolean;
+        composio: boolean;
+        redis: boolean;
+        qstash: boolean;
+        jobs: boolean;
+        voice: boolean;
+    };
+    git: string;
+    recentJobs: {
+        id: string;
+        status: import("../server.js").JobStatus;
+        task: string;
+    }[];
+    memoryCount: number;
+    owner: string;
+    activeProjects: string[];
+    knowledgeNodes: number;
+}>;
+export declare const situationalAwarenessTools: {
+    getSituationBrief: import("ai").Tool<{
+        sessionId?: string | undefined;
+    }, {
+        sessionId: string;
+        cwd: string;
+        package: string;
+        platform: string;
+        workspace: string;
+        models: {
+            manager: string;
+            coding: string;
+            image: string;
+            overrides: Partial<Record<import("../config/model-store.js").ModelRole, string>>;
+        };
+        capabilities: {
+            gateway: boolean;
+            composio: boolean;
+            redis: boolean;
+            qstash: boolean;
+            jobs: boolean;
+            voice: boolean;
+        };
+        git: string;
+        recentJobs: {
+            id: string;
+            status: import("../server.js").JobStatus;
+            task: string;
+        }[];
+        memoryCount: number;
+        owner: string;
+        activeProjects: string[];
+        knowledgeNodes: number;
+    }>;
+    recallRelevantMemories: import("ai").Tool<{
+        query: string;
+        limit?: number | undefined;
+    }, import("../memory/long-term.js").LongTermMemory[]>;
+};
+//# sourceMappingURL=situational-awareness.tool.d.ts.map

package/dist/tools/situational-awareness.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"situational-awareness.tool.d.ts","sourceRoot":"","sources":["../../src/tools/situational-awareness.tool.ts"],"names":[],"mappings":"AA0BA,wBAAsB,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8C3D;AAED,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiBrC,CAAC"}

package/dist/tools/situational-awareness.tool.js

@@ -0,0 +1,90 @@
+// src/tools/situational-awareness.tool.ts
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { tool } from 'ai';
+import { z } from 'zod';
+import { env, hasComposio, hasGatewayAuth, hasQStash, hasRedis } from '../config/env.js';
+import { models } from '../config/models.js';
+import { listJobs } from '../jobs/store.js';
+import { recall, listMemories } from '../memory/long-term.js';
+import { loadPersonalContext } from '../memory/personal-context.js';
+import { getKnowledgeGraph } from '../memory/knowledge-graph.js';
+import { workspaceLayout } from '../workspace/paths.js';
+import { loadModelSelections } from '../config/model-store.js';
+import { emitProgress } from '../runtime/progress.js';
+async function gitBrief(cwd) {
+    if (!existsSync(path.join(cwd, '.git')))
+        return 'not a git repo';
+    return new Promise((resolve) => {
+        spawn('git', ['status', '-sb'], { cwd, shell: process.platform === 'win32', windowsHide: true })
+            .stdout?.on('data', (c) => { resolve(String(c).trim().slice(0, 500)); });
+        setTimeout(() => resolve('git unavailable'), 3000);
+    });
+}
+export async function buildSituationBrief(sessionId) {
+    const cwd = process.cwd();
+    const layout = workspaceLayout();
+    const [jobs, memories, context, graph, modelStore] = await Promise.all([
+        listJobs({ limit: 8 }),
+        listMemories(),
+        loadPersonalContext(),
+        getKnowledgeGraph(),
+        loadModelSelections(),
+    ]);
+    let packageName = path.basename(cwd);
+    try {
+        const pkg = JSON.parse(await readFile(path.join(cwd, 'package.json'), 'utf8'));
+        if (pkg.name)
+            packageName = pkg.name;
+    }
+    catch {
+        // ignore
+    }
+    return {
+        sessionId: sessionId || 'default',
+        cwd,
+        package: packageName,
+        platform: `${process.platform} · Node ${process.versions.node}`,
+        workspace: layout.root,
+        models: {
+            manager: models.manager,
+            coding: models.coding,
+            image: models.image,
+            overrides: modelStore.roles,
+        },
+        capabilities: {
+            gateway: hasGatewayAuth(),
+            composio: hasComposio(),
+            redis: hasRedis(),
+            qstash: hasQStash(),
+            jobs: env.zilmateJobsEnabled,
+            voice: env.zilmateVoiceEnabled,
+        },
+        git: await gitBrief(cwd),
+        recentJobs: jobs.map((j) => ({ id: j.id, status: j.status, task: j.task.slice(0, 120) })),
+        memoryCount: memories.length,
+        owner: context.ownerName || graph.ownerName || '',
+        activeProjects: context.projects.filter((p) => p.status === 'active').map((p) => p.name),
+        knowledgeNodes: graph.nodes.length,
+    };
+}
+export const situationalAwarenessTools = {
+    getSituationBrief: tool({
+        description: 'Get a rich snapshot of the user environment: cwd, git, workspace, models, jobs, memory, projects, capabilities. Call at session start or before major decisions.',
+        inputSchema: z.object({ sessionId: z.string().optional() }),
+        execute: async ({ sessionId }) => {
+            emitProgress({ type: 'fetch:start', label: 'Building situation brief' });
+            const brief = await buildSituationBrief(sessionId);
+            emitProgress({ type: 'fetch:end', label: 'Situation brief ready' });
+            return brief;
+        },
+    }),
+    recallRelevantMemories: tool({
+        description: 'Recall long-term memories relevant to the current task or topic.',
+        inputSchema: z.object({ query: z.string().min(2), limit: z.number().int().min(1).max(12).optional() }),
+        execute: async ({ query, limit }) => recall(query, limit ?? 6),
+    }),
+};
+//# sourceMappingURL=situational-awareness.tool.js.map

package/dist/tools/situational-awareness.tool.js.map

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