@cleocode/core 2026.6.13 → 2026.6.14

package/dist/tools/media-agent-tools.js

@@ -0,0 +1,255 @@
+/**
+ * Vision / media agent-tool family — `vision_analyze` / `image_generate` /
+ * `text_to_speech` (T11951 · M7 · epic T11456 · SG-TOOLS).
+ *
+ * The FIRST occupants of the previously-empty `media` toolset. Every model /
+ * multimodal call routes THROUGH the single E9 chokepoint
+ * ({@link import('../llm/system-resolver.js')}'s `resolveLLMForSystem` →
+ * {@link import('../llm/model-runner.js')}'s `ModelRunner`), EXACTLY like
+ * `browser_vision` ({@link ./web-agent-tools.js}). There is NO raw provider client,
+ * NO new transport, NO API-key read at this call-site — the plaintext credential is
+ * materialized from the sealed handle ONLY at the wire inside `ModelRunner.build`
+ * (Gate-13 stays green).
+ *
+ *   - **`vision_analyze`** — read a local image + a prompt, send them as a single
+ *     multimodal user turn through the chokepoint, return the model's analysis.
+ *   - **`image_generate`** — send an image prompt through the chokepoint; returns
+ *     the model's response (text/asset-ref it emits). When the resolved model
+ *     cannot generate an image the chokepoint degrades — the tool surfaces an
+ *     `unsupported` flag rather than constructing a bespoke image client.
+ *   - **`text_to_speech`** — send text through the chokepoint for narration intent;
+ *     same degradation contract when the modality is unsupported.
+ *
+ * ## Availability (AC3 — mirrors `browser_vision`)
+ *
+ * Hidden unless outbound egress is permitted AND the host advertises a multimodal
+ * model (`networkEgressAllowed !== false && capabilities.multimodal === true`).
+ * Registered-but-hidden so core runs credential-OFF / egress-OFF and the catalog
+ * stays stable. (The capability flag is the host's "a multimodal model is
+ * resolvable" promise — availability is a SYNC predicate, so the actual resolution
+ * happens at `execute` time with graceful degradation when no credential resolves.)
+ *
+ * @epic T11456
+ * @task T11951
+ * @see ./web-agent-tools.js — `browser_vision`, the E9-routed multimodal pattern mirrored here
+ * @see ../llm/system-resolver.js — `resolveLLMForSystem` (the E9 chokepoint)
+ * @see ../llm/model-runner.js — `ModelRunner` (the single SSoT wire builder)
+ */
+import { readFile } from 'node:fs/promises';
+import { extname } from 'node:path';
+import { z } from 'zod';
+import { getLogger } from '../logger.js';
+const log = getLogger('tool-media-agent');
+/**
+ * Available only when outbound egress is permitted AND the host advertises a
+ * multimodal model. Mirrors `browser_vision`'s availability: registered-but-hidden
+ * (so the `media` catalog is stable) until a context advertises both
+ * `networkEgressAllowed !== false` and `capabilities.multimodal === true`.
+ */
+export const multimodalAvailable = (ctx) => ctx.networkEgressAllowed !== false && ctx.capabilities?.multimodal === true;
+/** Default {@link ImageReader} — a local `fs` read + extension-based MIME sniff. */
+const defaultImageReader = async (path) => {
+    const bytes = await readFile(path);
+    return { base64: bytes.toString('base64'), mediaType: mediaTypeForPath(path) };
+};
+/** Map a file extension to its image MIME type (defaults to `image/png`). */
+function mediaTypeForPath(path) {
+    switch (extname(path).toLowerCase()) {
+        case '.jpg':
+        case '.jpeg':
+            return 'image/jpeg';
+        case '.webp':
+            return 'image/webp';
+        case '.gif':
+            return 'image/gif';
+        default:
+            return 'image/png';
+    }
+}
+/**
+ * Resolve an LLM through the SINGLE E9 chokepoint and send `messages` as one turn
+ * via the SSoT {@link ModelRunner}. The sealed credential is materialized ONLY at
+ * the wire (inside `ModelRunner.build`); there is NO raw provider/transport
+ * construction here (Gate-13). Returns `aiUnavailable: true` when no credential
+ * resolves — graceful degradation, not an error (mirrors `runBrowserVision`).
+ *
+ * @param messages - The provider-neutral turn (text and/or image blocks).
+ * @param projectRoot - Project root for the resolver.
+ * @returns The {@link MediaModelResult}.
+ */
+async function runChokepointModel(messages, projectRoot) {
+    // E9 resolution chokepoint — the ONLY route to an LLM credential. Never throws.
+    const { resolveLLMForSystem } = await import('../llm/system-resolver.js');
+    const resolved = await resolveLLMForSystem('task-executor', {
+        ...(projectRoot !== undefined ? { projectRoot } : {}),
+    });
+    if (!resolved.sealedCredential) {
+        return { ok: false, aiUnavailable: true };
+    }
+    try {
+        // Build the wire surfaces via the single SSoT ModelRunner (Gate-13: no raw
+        // transport / provider construction here). The token is materialized from the
+        // sealed handle inside ModelRunner only.
+        const { ModelRunner } = await import('../llm/model-runner.js');
+        const apiKey = (await resolved.sealedCredential.fetch()).value;
+        const built = await ModelRunner.build({
+            provider: resolved.provider,
+            model: resolved.model,
+            credential: resolved.credential
+                ? {
+                    provider: resolved.credential.provider,
+                    apiKey,
+                    source: resolved.credential.source,
+                    authType: resolved.credential.authType,
+                }
+                : null,
+            source: resolved.source,
+            ...(resolved.credentialLabel !== undefined
+                ? { credentialLabel: resolved.credentialLabel }
+                : {}),
+            apiMode: resolved.apiMode,
+            baseUrl: resolved.baseUrl,
+            authType: resolved.authType,
+            ...(resolved.capabilities !== undefined ? { capabilities: resolved.capabilities } : {}),
+        });
+        const response = await built.session.send(messages);
+        return { ok: true, content: response.content ?? undefined, model: resolved.model };
+    }
+    catch (err) {
+        log.warn({ err }, 'media tool: chokepoint model call failed — returning unavailable');
+        return { ok: false, model: resolved.model, aiUnavailable: true };
+    }
+}
+/**
+ * Register the vision / media agent-tool family into `registry`. Pure
+ * registration — no model is resolved, no credential is read, no file is opened
+ * here; all of that happens later inside each tool's `execute` through the E9
+ * chokepoint (and the injected image reader). Import-time side-effect-free.
+ *
+ * @param registry - The registry to populate.
+ * @param options - Injectable image reader / project root (for testing).
+ */
+export function registerMediaAgentTools(registry, options = {}) {
+    const readImage = options.readImage ?? defaultImageReader;
+    const projectRoot = options.projectRoot;
+    // --- vision_analyze (image + prompt → analysis, via the E9 chokepoint) ----
+    registry.register({
+        name: 'vision_analyze',
+        // 'shell' — the call captures an external model response (its strongest surface).
+        class: 'shell',
+        description: 'Analyse a local image with a vision model: reads the image and sends it plus a ' +
+            'prompt as a multimodal turn through the resolveLLMForSystem chokepoint. Returns ' +
+            'the model analysis, or aiUnavailable when no credential resolves.',
+        toolset: 'media',
+        stateless: true,
+        available: multimodalAvailable,
+        parameters: z.object({
+            imagePath: z.string().describe('Absolute path to the image file to analyse.'),
+            prompt: z.string().describe('Question / instruction for the vision model about the image.'),
+        }),
+        execute: async (rawArgs) => {
+            const imagePath = String(rawArgs.imagePath);
+            const prompt = String(rawArgs.prompt);
+            let image;
+            try {
+                image = await readImage(imagePath);
+            }
+            catch (err) {
+                return {
+                    ok: false,
+                    error: {
+                        code: 'E_IMAGE_READ_FAILED',
+                        message: `could not read image at "${imagePath}": ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                };
+            }
+            const messages = [
+                {
+                    role: 'user',
+                    content: [
+                        { type: 'text', text: prompt },
+                        {
+                            type: 'image',
+                            source: { type: 'base64', data: image.base64, mediaType: image.mediaType },
+                        },
+                    ],
+                },
+            ];
+            return runChokepointModel(messages, projectRoot);
+        },
+    });
+    // --- image_generate (prompt → image, via the E9 chokepoint) --------------
+    registry.register({
+        name: 'image_generate',
+        class: 'shell',
+        description: 'Generate an image from a text prompt by routing the request through the ' +
+            'resolveLLMForSystem chokepoint. When the resolved model cannot synthesize an image, ' +
+            'reports unsupported rather than constructing a bespoke image client.',
+        toolset: 'media',
+        stateless: true,
+        available: multimodalAvailable,
+        parameters: z.object({
+            prompt: z.string().describe('A text description of the image to generate.'),
+        }),
+        execute: async (rawArgs) => {
+            const prompt = String(rawArgs.prompt);
+            const messages = [
+                {
+                    role: 'user',
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Generate an image for the following description. If you cannot produce an image, say so explicitly.\n\n${prompt}`,
+                        },
+                    ],
+                },
+            ];
+            const result = await runChokepointModel(messages, projectRoot);
+            // The chat chokepoint does not emit raw image bytes; surface the model's
+            // response and flag that true synthesis is not served by this path.
+            return { ...result, unsupported: result.ok ? true : result.unsupported };
+        },
+    });
+    // --- text_to_speech (text → narration intent, via the E9 chokepoint) -----
+    registry.register({
+        name: 'text_to_speech',
+        class: 'shell',
+        description: 'Convert text to speech by routing the request through the resolveLLMForSystem ' +
+            'chokepoint. When the resolved model cannot synthesize audio, reports unsupported ' +
+            'rather than constructing a bespoke TTS client.',
+        toolset: 'media',
+        stateless: true,
+        available: multimodalAvailable,
+        parameters: z.object({
+            text: z.string().describe('The text to narrate as speech.'),
+        }),
+        execute: async (rawArgs) => {
+            const text = String(rawArgs.text);
+            const messages = [
+                {
+                    role: 'user',
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Produce speech audio for the following text. If you cannot produce audio, say so explicitly.\n\n${text}`,
+                        },
+                    ],
+                },
+            ];
+            const result = await runChokepointModel(messages, projectRoot);
+            return { ...result, unsupported: result.ok ? true : result.unsupported };
+        },
+    });
+}
+/**
+ * Self-registration marker (AC1) — the identifier the
+ * {@link AgentToolRegistry.discover} bounded source scan greps for. Aliases
+ * {@link registerMediaAgentTools} so a future scan-dir discovery (or the built-in
+ * aggregator) can call it uniformly with the other agent-tool modules.
+ *
+ * @param registry - The registry to populate.
+ */
+export function registerAgentTools(registry) {
+    registerMediaAgentTools(registry);
+}
+//# sourceMappingURL=media-agent-tools.js.map

package/dist/tools/media-agent-tools.js.map

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

package/dist/tools/memory-agent-tools.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Memory (BRAIN) agent-tool family — `memory_search` / `memory_observe` /
+ * `memory_fetch` / `memory_timeline` (T11947 · M7 · epic T11456 · SG-TOOLS).
+ *
+ * Surfaces the EXISTING BRAIN cognitive-memory operations to the agent loop as
+ * `agent`-toolset tools, mirroring the `cleo memory find|observe|fetch|timeline`
+ * CLI verbs. It adds NO new store, NO new SQL, and NO new schema: each tool
+ * DELEGATES to the established memory ops in
+ * {@link import('../memory/engine-compat.js')}
+ * ({@link memoryFind} / {@link memoryObserve} / {@link memoryFetch} /
+ * {@link memoryTimeline}), which themselves route through the BRAIN retrieval
+ * accessors + the store chokepoint. The agent loop never re-implements brain
+ * retrieval — it reuses the SAME path the CLI and the orchestrator use.
+ *
+ * ## Why a seam, not a hardcoded import (AC5 + Gate-11)
+ *
+ * The four memory ops are injected through the {@link MemoryOps} seam, defaulting
+ * to the real `engine-compat` functions. This lets the unit test inject a FAKE
+ * Brain surface and assert delegation + schema validation WITHOUT opening a real
+ * `brain.db`. Production binds the real ops. The tools are DEFINED here under
+ * `packages/core/src/tools` and CONSUME the memory subsystem — they construct no
+ * new atomic primitive (Gate-11).
+ *
+ * ## Availability (AC4)
+ *
+ * BRAIN read/write is a LOCAL SQLite operation through the store chokepoint — no
+ * credential, no network, no daemon. Every memory tool is therefore
+ * {@link ALWAYS_AVAILABLE}: it works daemon-OFF and credential-OFF.
+ *
+ * ## Gate-13
+ *
+ * No model/transport/provider client is constructed here — BRAIN search is a
+ * local FTS/SQLite query, not an LLM call. There is no chokepoint concern.
+ *
+ * @epic T11456
+ * @task T11947
+ * @see ../memory/engine-compat.js — the memory ops this family delegates to
+ * @see ./exec-code-agent-tool.js — the injectable-seam + self-registering-marker pattern mirrored here
+ */
+import type { EngineResult } from '../engine-result.js';
+import { type AgentToolRegistry } from './agent-registry.js';
+/**
+ * The BRAIN memory operations the family delegates to. Each member has the SAME
+ * signature as the corresponding `engine-compat` function — `(params, root?) →
+ * Promise<EngineResult>`. Injectable so the unit test can supply a fake Brain
+ * surface; defaults to the real ops in production.
+ */
+export interface MemoryOps {
+    /** Token-efficient compact search (→ `cleo memory find`). */
+    readonly find: (params: {
+        query: string;
+        limit?: number;
+    }, projectRoot?: string) => Promise<EngineResult>;
+    /** Append an observation (→ `cleo memory observe`). */
+    readonly observe: (params: {
+        text: string;
+        title?: string;
+    }, projectRoot?: string) => Promise<EngineResult>;
+    /** Batch fetch entries by ID (→ `cleo memory fetch`). */
+    readonly fetch: (params: {
+        ids: string[];
+    }, projectRoot?: string) => Promise<EngineResult>;
+    /** Chronological context around an anchor (→ `cleo memory timeline`). */
+    readonly timeline: (params: {
+        anchor: string;
+        depthBefore?: number;
+        depthAfter?: number;
+    }, projectRoot?: string) => Promise<EngineResult>;
+}
+/** Options for {@link registerMemoryAgentTools} — all injectable for testing. */
+export interface MemoryAgentToolOptions {
+    /** The memory ops seam. Defaults to the real `engine-compat` functions. */
+    readonly memory?: MemoryOps;
+    /**
+     * The project root threaded into every op (defaults to the resolved project
+     * root via {@link resolveOrCwd} — never a bare `process.cwd()` in core, T9584).
+     */
+    readonly projectRoot?: string;
+}
+/**
+ * Register the memory (BRAIN) agent-tool family into `registry`. Pure
+ * registration — no `brain.db` is opened, no query runs here; all of that happens
+ * later inside each tool's `execute` through the injected (or default) ops.
+ * Import-time side-effect-free.
+ *
+ * @param registry - The registry to populate.
+ * @param options - Injectable memory ops / project root (for testing).
+ */
+export declare function registerMemoryAgentTools(registry: AgentToolRegistry, options?: MemoryAgentToolOptions): void;
+/**
+ * Self-registration marker (AC1) — the identifier the
+ * {@link AgentToolRegistry.discover} bounded source scan greps for. Aliases
+ * {@link registerMemoryAgentTools} so a future scan-dir discovery (or the
+ * built-in aggregator) can call it uniformly with the other agent-tool modules.
+ *
+ * @param registry - The registry to populate.
+ */
+export declare function registerAgentTools(registry: AgentToolRegistry): void;
+//# sourceMappingURL=memory-agent-tools.d.ts.map

package/dist/tools/memory-agent-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-agent-tools.d.ts","sourceRoot":"","sources":["../../src/tools/memory-agent-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAQxD,OAAO,EAAE,KAAK,iBAAiB,EAAoB,MAAM,qBAAqB,CAAC;AAE/E;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,CACb,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EACzC,WAAW,CAAC,EAAE,MAAM,KACjB,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3B,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,CAChB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EACxC,WAAW,CAAC,EAAE,MAAM,KACjB,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3B,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,WAAW,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3F,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,EAAE,CACjB,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,EACrE,WAAW,CAAC,EAAE,MAAM,KACjB,OAAO,CAAC,YAAY,CAAC,CAAC;CAC5B;AAUD,iFAAiF;AACjF,MAAM,WAAW,sBAAsB;IACrC,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAgBD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,GAAE,sBAA2B,GACnC,IAAI,CAgHN;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAEpE"}

package/dist/tools/memory-agent-tools.js

@@ -0,0 +1,190 @@
+/**
+ * Memory (BRAIN) agent-tool family — `memory_search` / `memory_observe` /
+ * `memory_fetch` / `memory_timeline` (T11947 · M7 · epic T11456 · SG-TOOLS).
+ *
+ * Surfaces the EXISTING BRAIN cognitive-memory operations to the agent loop as
+ * `agent`-toolset tools, mirroring the `cleo memory find|observe|fetch|timeline`
+ * CLI verbs. It adds NO new store, NO new SQL, and NO new schema: each tool
+ * DELEGATES to the established memory ops in
+ * {@link import('../memory/engine-compat.js')}
+ * ({@link memoryFind} / {@link memoryObserve} / {@link memoryFetch} /
+ * {@link memoryTimeline}), which themselves route through the BRAIN retrieval
+ * accessors + the store chokepoint. The agent loop never re-implements brain
+ * retrieval — it reuses the SAME path the CLI and the orchestrator use.
+ *
+ * ## Why a seam, not a hardcoded import (AC5 + Gate-11)
+ *
+ * The four memory ops are injected through the {@link MemoryOps} seam, defaulting
+ * to the real `engine-compat` functions. This lets the unit test inject a FAKE
+ * Brain surface and assert delegation + schema validation WITHOUT opening a real
+ * `brain.db`. Production binds the real ops. The tools are DEFINED here under
+ * `packages/core/src/tools` and CONSUME the memory subsystem — they construct no
+ * new atomic primitive (Gate-11).
+ *
+ * ## Availability (AC4)
+ *
+ * BRAIN read/write is a LOCAL SQLite operation through the store chokepoint — no
+ * credential, no network, no daemon. Every memory tool is therefore
+ * {@link ALWAYS_AVAILABLE}: it works daemon-OFF and credential-OFF.
+ *
+ * ## Gate-13
+ *
+ * No model/transport/provider client is constructed here — BRAIN search is a
+ * local FTS/SQLite query, not an LLM call. There is no chokepoint concern.
+ *
+ * @epic T11456
+ * @task T11947
+ * @see ../memory/engine-compat.js — the memory ops this family delegates to
+ * @see ./exec-code-agent-tool.js — the injectable-seam + self-registering-marker pattern mirrored here
+ */
+import { z } from 'zod';
+import { memoryFetch as realMemoryFetch, memoryFind as realMemoryFind, memoryObserve as realMemoryObserve, memoryTimeline as realMemoryTimeline, } from '../memory/engine-compat.js';
+import { resolveOrCwd } from '../paths.js';
+import { ALWAYS_AVAILABLE } from './agent-registry.js';
+/** The real BRAIN memory ops — the production default for {@link MemoryOps}. */
+const REAL_MEMORY_OPS = {
+    find: realMemoryFind,
+    observe: realMemoryObserve,
+    fetch: realMemoryFetch,
+    timeline: realMemoryTimeline,
+};
+/**
+ * Coerce an {@link EngineResult} into the opaque value the loop serialises back
+ * to the model. On success the `data` payload is returned as-is; on failure a
+ * stable `{ ok: false, error }` shape is returned (the op never throws for an
+ * expected failure — it returns a typed `EngineFailure`).
+ *
+ * @param result - The op's EngineResult.
+ * @returns The success data, or a typed failure object.
+ */
+function unwrapEngineResult(result) {
+    if (result.success)
+        return result.data;
+    return { ok: false, error: result.error };
+}
+/**
+ * Register the memory (BRAIN) agent-tool family into `registry`. Pure
+ * registration — no `brain.db` is opened, no query runs here; all of that happens
+ * later inside each tool's `execute` through the injected (or default) ops.
+ * Import-time side-effect-free.
+ *
+ * @param registry - The registry to populate.
+ * @param options - Injectable memory ops / project root (for testing).
+ */
+export function registerMemoryAgentTools(registry, options = {}) {
+    const memory = options.memory ?? REAL_MEMORY_OPS;
+    const projectRoot = resolveOrCwd(options.projectRoot);
+    // --- memory_search (→ memoryFind) ----------------------------------------
+    registry.register({
+        name: 'memory_search',
+        // 'search' — a local read-query of the BRAIN store (no side effect beyond reading).
+        class: 'search',
+        description: 'Search BRAIN cognitive memory (decisions / patterns / learnings / observations) ' +
+            'for entries matching a query, returning compact hits (IDs + titles). Use memory_fetch ' +
+            'to retrieve full details for a hit.',
+        toolset: 'agent',
+        stateless: true,
+        available: ALWAYS_AVAILABLE,
+        parameters: z.object({
+            query: z.string().describe('Free-text search query.'),
+            limit: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe('Maximum number of compact hits to return.'),
+        }),
+        execute: async (rawArgs) => {
+            const query = String(rawArgs.query);
+            const limit = typeof rawArgs.limit === 'number' ? rawArgs.limit : undefined;
+            const result = await memory.find({ query, limit }, projectRoot);
+            return unwrapEngineResult(result);
+        },
+    });
+    // --- memory_observe (→ memoryObserve) ------------------------------------
+    registry.register({
+        name: 'memory_observe',
+        // 'fs' — persists a row to the local BRAIN store (its strongest side-effect surface).
+        class: 'fs',
+        description: 'Append a new observation to BRAIN memory (an O-prefixed entry). Use after a ' +
+            'non-trivial step to record a learning or decision for future sessions.',
+        toolset: 'agent',
+        stateless: false,
+        available: ALWAYS_AVAILABLE,
+        parameters: z.object({
+            text: z.string().describe('The observation body to store.'),
+            title: z.string().optional().describe('A short title for the observation.'),
+        }),
+        execute: async (rawArgs) => {
+            const text = String(rawArgs.text);
+            const title = rawArgs.title === undefined ? undefined : String(rawArgs.title);
+            const result = await memory.observe({ text, title }, projectRoot);
+            return unwrapEngineResult(result);
+        },
+    });
+    // --- memory_fetch (→ memoryFetch) ----------------------------------------
+    registry.register({
+        name: 'memory_fetch',
+        class: 'search',
+        description: 'Fetch full details for one or more BRAIN entries by ID (e.g. O-abc123, D-def456). ' +
+            'Use after memory_search to expand a compact hit.',
+        toolset: 'agent',
+        stateless: true,
+        available: ALWAYS_AVAILABLE,
+        parameters: z.object({
+            ids: z
+                .array(z.string())
+                .min(1)
+                .describe('One or more BRAIN entry IDs to fetch (e.g. ["O-abc123"]).'),
+        }),
+        execute: async (rawArgs) => {
+            const ids = Array.isArray(rawArgs.ids) ? rawArgs.ids.map(String) : [];
+            const result = await memory.fetch({ ids }, projectRoot);
+            return unwrapEngineResult(result);
+        },
+    });
+    // --- memory_timeline (→ memoryTimeline) ----------------------------------
+    registry.register({
+        name: 'memory_timeline',
+        class: 'search',
+        description: 'Retrieve chronological context around a BRAIN entry — the entries recorded before ' +
+            'and after a given anchor ID — to understand the sequence of observations and decisions.',
+        toolset: 'agent',
+        stateless: true,
+        available: ALWAYS_AVAILABLE,
+        parameters: z.object({
+            anchor: z.string().describe('The BRAIN entry ID to anchor the timeline window on.'),
+            depthBefore: z
+                .number()
+                .int()
+                .nonnegative()
+                .optional()
+                .describe('How many entries before the anchor to include.'),
+            depthAfter: z
+                .number()
+                .int()
+                .nonnegative()
+                .optional()
+                .describe('How many entries after the anchor to include.'),
+        }),
+        execute: async (rawArgs) => {
+            const anchor = String(rawArgs.anchor);
+            const depthBefore = typeof rawArgs.depthBefore === 'number' ? rawArgs.depthBefore : undefined;
+            const depthAfter = typeof rawArgs.depthAfter === 'number' ? rawArgs.depthAfter : undefined;
+            const result = await memory.timeline({ anchor, depthBefore, depthAfter }, projectRoot);
+            return unwrapEngineResult(result);
+        },
+    });
+}
+/**
+ * Self-registration marker (AC1) — the identifier the
+ * {@link AgentToolRegistry.discover} bounded source scan greps for. Aliases
+ * {@link registerMemoryAgentTools} so a future scan-dir discovery (or the
+ * built-in aggregator) can call it uniformly with the other agent-tool modules.
+ *
+ * @param registry - The registry to populate.
+ */
+export function registerAgentTools(registry) {
+    registerMemoryAgentTools(registry);
+}
+//# sourceMappingURL=memory-agent-tools.js.map

package/dist/tools/memory-agent-tools.js.map

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