daemora 1.0.0-alpha.0

package/dist/tools/core/manageMCP.js

@@ -0,0 +1,160 @@
+/**
+ * manage_mcp(action, ...) — configure MCP servers from inside the agent.
+ *
+ * Actions:
+ *   list       — all configured servers with status + tool counts
+ *   get        — detail for a single server
+ *   add        — register a new server (stdio via command+args OR http via url)
+ *   update     — patch server config
+ *   remove     — delete a server (disconnects first)
+ *   enable     — flip enabled flag on, reconnects if possible
+ *   disable    — flip enabled flag off, disconnects
+ *   reconnect  — force disconnect + reconnect for one server
+ *   tools      — list tools exposed by a connected server
+ */
+import { z } from "zod";
+import { NotFoundError, ValidationError } from "../../util/errors.js";
+const inputSchema = z.object({
+    action: z.enum([
+        "list", "get", "add", "update", "remove",
+        "enable", "disable", "reconnect", "tools",
+    ]),
+    name: z.string().optional().describe("Server name — unique id used in tool naming (mcp__<name>__<tool>)."),
+    command: z.string().optional().describe("Stdio-transport command to spawn."),
+    args: z.array(z.string()).optional().describe("Args passed to the spawn command."),
+    url: z.string().optional().describe("HTTP/SSE endpoint for http-transport servers."),
+    env: z.record(z.string(), z.string()).optional().describe("Environment variables passed to the spawned process."),
+    headers: z.record(z.string(), z.string()).optional().describe("Extra HTTP headers for http-transport."),
+    transport: z.enum(["stdio", "http", "sse"]).optional(),
+    enabled: z.boolean().optional(),
+});
+export function makeManageMCPTool(store, manager) {
+    return {
+        name: "manage_mcp",
+        description: "Register and manage Model Context Protocol servers. Actions: list, get, add, update, remove, enable, disable, reconnect, tools.",
+        category: "agent",
+        source: { kind: "core" },
+        tags: ["mcp", "integration", "tool-registry"],
+        inputSchema,
+        async execute(input, { logger }) {
+            switch (input.action) {
+                case "list": {
+                    return manager.listStatus();
+                }
+                case "get": {
+                    if (!input.name)
+                        throw new ValidationError("name is required");
+                    const cfg = store.get(input.name);
+                    if (!cfg)
+                        throw new NotFoundError(`MCP server not found: ${input.name}`);
+                    const status = manager.listStatus().find((s) => s.name === input.name);
+                    return { config: cfg, status };
+                }
+                case "add": {
+                    if (!input.name)
+                        throw new ValidationError("name is required");
+                    if (!input.command && !input.url) {
+                        throw new ValidationError("either `command` (stdio) or `url` (http) is required");
+                    }
+                    const existing = store.get(input.name);
+                    if (existing)
+                        throw new ValidationError(`MCP server already exists: ${input.name}`);
+                    const entry = store.add(input.name, {
+                        ...(input.command ? { command: input.command } : {}),
+                        ...(input.args ? { args: input.args } : {}),
+                        ...(input.url ? { url: input.url } : {}),
+                        ...(input.env ? { env: input.env } : {}),
+                        ...(input.headers ? { headers: input.headers } : {}),
+                        ...(input.transport ? { transport: input.transport } : {}),
+                        ...(input.enabled !== undefined ? { enabled: input.enabled } : {}),
+                    });
+                    if (entry.enabled !== false) {
+                        await manager.connect(entry).catch((err) => {
+                            logger.warn("mcp connect failed", { name: input.name, error: err.message });
+                        });
+                    }
+                    return { name: entry.name, message: `MCP server '${entry.name}' added` };
+                }
+                case "update": {
+                    if (!input.name)
+                        throw new ValidationError("name is required");
+                    const updates = {};
+                    if (input.command !== undefined)
+                        updates.command = input.command;
+                    if (input.args !== undefined)
+                        updates.args = input.args;
+                    if (input.url !== undefined)
+                        updates.url = input.url;
+                    if (input.env !== undefined)
+                        updates.env = input.env;
+                    if (input.headers !== undefined)
+                        updates.headers = input.headers;
+                    if (input.transport !== undefined)
+                        updates.transport = input.transport;
+                    if (input.enabled !== undefined)
+                        updates.enabled = input.enabled;
+                    const entry = store.update(input.name, updates);
+                    if (!entry)
+                        throw new NotFoundError(`MCP server not found: ${input.name}`);
+                    // Reconnect to pick up the new config.
+                    await manager.disconnect(input.name);
+                    if (entry.enabled !== false) {
+                        await manager.connect(entry).catch((err) => {
+                            logger.warn("mcp reconnect failed", { name: input.name, error: err.message });
+                        });
+                    }
+                    return { name: input.name, message: `MCP server '${input.name}' updated` };
+                }
+                case "remove": {
+                    if (!input.name)
+                        throw new ValidationError("name is required");
+                    await manager.disconnect(input.name);
+                    const ok = store.remove(input.name);
+                    if (!ok)
+                        throw new NotFoundError(`MCP server not found: ${input.name}`);
+                    return { name: input.name, removed: true, message: `MCP server '${input.name}' removed` };
+                }
+                case "enable":
+                case "disable": {
+                    if (!input.name)
+                        throw new ValidationError("name is required");
+                    const ok = store.setEnabled(input.name, input.action === "enable");
+                    if (!ok)
+                        throw new NotFoundError(`MCP server not found: ${input.name}`);
+                    if (input.action === "enable") {
+                        const entry = store.get(input.name);
+                        if (entry) {
+                            await manager.connect(entry).catch((err) => {
+                                logger.warn("mcp connect failed", { name: input.name, error: err.message });
+                            });
+                        }
+                    }
+                    else {
+                        await manager.disconnect(input.name);
+                    }
+                    return { name: input.name, enabled: input.action === "enable", message: `MCP server '${input.name}' ${input.action}d` };
+                }
+                case "reconnect": {
+                    if (!input.name)
+                        throw new ValidationError("name is required");
+                    const entry = store.get(input.name);
+                    if (!entry)
+                        throw new NotFoundError(`MCP server not found: ${input.name}`);
+                    await manager.disconnect(input.name);
+                    await manager.connect(entry);
+                    const status = manager.listStatus().find((s) => s.name === input.name);
+                    return { name: input.name, status, message: `MCP server '${input.name}' reconnected` };
+                }
+                case "tools": {
+                    if (!input.name)
+                        throw new ValidationError("name is required");
+                    const status = manager.listStatus().find((s) => s.name === input.name);
+                    if (!status)
+                        throw new NotFoundError(`MCP server not found: ${input.name}`);
+                    return { name: input.name, count: status.tools.length, tools: status.tools };
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=manageMCP.js.map

package/dist/tools/core/manageMCP.js.map

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

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

@@ -0,0 +1,49 @@
+/**
+ * memory — hermes-pattern declarative memory tool.
+ *
+ * Two targets:
+ *   - target="user"   → USER.md, facts about the user (persona, prefs)
+ *   - target="memory" → MEMORY.md, notes about environment / project
+ *
+ * Three actions:
+ *   - add(target, content)
+ *   - replace(target, old_text, content)
+ *   - remove(target, old_text)
+ *
+ * System-prompt injection is frozen at session start — mid-session writes
+ * DO hit disk, but the model sees the same snapshot for the whole
+ * session. Fresh snapshots only on reload/compaction.
+ */
+import { z } from "zod";
+import type { EventBus } from "../../events/eventBus.js";
+import type { DeclarativeMemoryStore } from "../../memory/DeclarativeMemoryStore.js";
+import type { ToolDef } from "../types.js";
+declare const inputSchema: z.ZodObject<{
+    action: z.ZodEnum<["add", "replace", "remove"]>;
+    target: z.ZodEnum<["user", "memory"]>;
+    content: z.ZodOptional<z.ZodString>;
+    old_text: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    target: "user" | "memory";
+    action: "replace" | "add" | "remove";
+    content?: string | undefined;
+    old_text?: string | undefined;
+}, {
+    target: "user" | "memory";
+    action: "replace" | "add" | "remove";
+    content?: string | undefined;
+    old_text?: string | undefined;
+}>;
+type MemoryToolResult = {
+    success: true;
+    message: string;
+    entry_count?: number;
+    chars?: number;
+    limit?: number;
+} | {
+    success: false;
+    error: string;
+};
+export declare function makeMemoryTool(store: DeclarativeMemoryStore, bus?: EventBus): ToolDef<typeof inputSchema, MemoryToolResult>;
+export {};
+//# sourceMappingURL=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/tools/core/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EACV,sBAAsB,EAEvB,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;EAKf,CAAC;AAEH,KAAK,gBAAgB,GACjB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACxF;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,wBAAgB,cAAc,CAC5B,KAAK,EAAE,sBAAsB,EAC7B,GAAG,CAAC,EAAE,QAAQ,GACb,OAAO,CAAC,OAAO,WAAW,EAAE,gBAAgB,CAAC,CAsC/C"}

package/dist/tools/core/memory.js

@@ -0,0 +1,80 @@
+/**
+ * memory — hermes-pattern declarative memory tool.
+ *
+ * Two targets:
+ *   - target="user"   → USER.md, facts about the user (persona, prefs)
+ *   - target="memory" → MEMORY.md, notes about environment / project
+ *
+ * Three actions:
+ *   - add(target, content)
+ *   - replace(target, old_text, content)
+ *   - remove(target, old_text)
+ *
+ * System-prompt injection is frozen at session start — mid-session writes
+ * DO hit disk, but the model sees the same snapshot for the whole
+ * session. Fresh snapshots only on reload/compaction.
+ */
+import { z } from "zod";
+const inputSchema = z.object({
+    action: z.enum(["add", "replace", "remove"]),
+    target: z.enum(["user", "memory"]),
+    content: z.string().max(2000).optional(),
+    old_text: z.string().max(2000).optional(),
+});
+export function makeMemoryTool(store, bus) {
+    return {
+        name: "memory",
+        description: "Save or update persistent declarative memory. target='user' holds facts about the user " +
+            "(preferences, persona, recurring corrections); target='memory' holds notes about the " +
+            "environment/project. Save DECLARATIVE FACTS, not imperative instructions " +
+            "('User prefers concise responses' ✓ — 'Always respond concisely' ✗). " +
+            "DO NOT save task progress or completed-work logs — that's session history, not memory.",
+        category: "data",
+        source: { kind: "core" },
+        alwaysOn: true,
+        inputSchema,
+        async execute(input) {
+            const target = input.target;
+            try {
+                let r;
+                if (input.action === "add") {
+                    if (!input.content)
+                        return { success: false, error: "content is required for add" };
+                    r = await store.add(target, input.content);
+                }
+                else if (input.action === "replace") {
+                    if (!input.old_text || !input.content) {
+                        return { success: false, error: "old_text and content are required for replace" };
+                    }
+                    r = await store.replace(target, input.old_text, input.content);
+                }
+                else if (input.action === "remove") {
+                    if (!input.old_text)
+                        return { success: false, error: "old_text is required for remove" };
+                    r = await store.remove(target, input.old_text);
+                }
+                else {
+                    return { success: false, error: `unknown action: ${String(input.action)}` };
+                }
+                if (r.success)
+                    bus?.emit("memory:written", { target, action: input.action });
+                return toResult(r);
+            }
+            catch (e) {
+                return { success: false, error: e.message };
+            }
+        },
+    };
+}
+function toResult(r) {
+    if (!r.success)
+        return { success: false, error: r.message };
+    return {
+        success: true,
+        message: r.message,
+        ...(r.entryCount !== undefined ? { entry_count: r.entryCount } : {}),
+        ...(r.chars !== undefined ? { chars: r.chars } : {}),
+        ...(r.limit !== undefined ? { limit: r.limit } : {}),
+    };
+}
+//# sourceMappingURL=memory.js.map

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

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

package/dist/tools/core/memoryRecall.d.ts

@@ -0,0 +1,39 @@
+/**
+ * memory_recall — BM25 search over previously-saved facts.
+ *
+ * Query is natural language. Results come back oldest-to-newest within
+ * the rank band, with the original timestamps so the caller can tell
+ * "you told me this a year ago" from "you told me this yesterday".
+ */
+import { z } from "zod";
+import type { MemoryStore } from "../../memory/MemoryStore.js";
+import type { ToolDef } from "../types.js";
+declare const inputSchema: z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    tags_any: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    tags_all: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    query: string;
+    tags_any?: string[] | undefined;
+    tags_all?: string[] | undefined;
+}, {
+    query: string;
+    limit?: number | undefined;
+    tags_any?: string[] | undefined;
+    tags_all?: string[] | undefined;
+}>;
+interface Recalled {
+    readonly id: string;
+    readonly content: string;
+    readonly tags: readonly string[];
+    readonly createdAt: number;
+    readonly rank: number;
+}
+export declare function makeMemoryRecallTool(store: MemoryStore): ToolDef<typeof inputSchema, {
+    query: string;
+    results: readonly Recalled[];
+}>;
+export {};
+//# sourceMappingURL=memoryRecall.d.ts.map

package/dist/tools/core/memoryRecall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoryRecall.d.ts","sourceRoot":"","sources":["../../../src/tools/core/memoryRecall.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;EAKf,CAAC;AAEH,UAAU,QAAQ;IAChB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,WAAW,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,SAAS,QAAQ,EAAE,CAAA;CAAE,CAAC,CA0BrI"}

package/dist/tools/core/memoryRecall.js

@@ -0,0 +1,42 @@
+/**
+ * memory_recall — BM25 search over previously-saved facts.
+ *
+ * Query is natural language. Results come back oldest-to-newest within
+ * the rank band, with the original timestamps so the caller can tell
+ * "you told me this a year ago" from "you told me this yesterday".
+ */
+import { z } from "zod";
+const inputSchema = z.object({
+    query: z.string().min(1).max(400).describe("Natural-language query over saved memory."),
+    limit: z.number().int().min(1).max(50).default(5),
+    tags_any: z.array(z.string()).optional().describe("At least one of these tags must be present."),
+    tags_all: z.array(z.string()).optional().describe("All of these tags must be present."),
+});
+export function makeMemoryRecallTool(store) {
+    return {
+        name: "memory_recall",
+        description: "Search saved memories by keyword. Returns the most relevant entries first (BM25 ranking).",
+        category: "data",
+        source: { kind: "core" },
+        alwaysOn: true,
+        inputSchema,
+        async execute({ query, limit, tags_any, tags_all }) {
+            const hits = store.search(query, {
+                limit,
+                ...(tags_any ? { tagsAny: tags_any } : {}),
+                ...(tags_all ? { tagsAll: tags_all } : {}),
+            });
+            return {
+                query,
+                results: hits.map((h) => ({
+                    id: h.id,
+                    content: h.content,
+                    tags: h.tags,
+                    createdAt: h.createdAt,
+                    rank: h.rank,
+                })),
+            };
+        },
+    };
+}
+//# sourceMappingURL=memoryRecall.js.map

package/dist/tools/core/memoryRecall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoryRecall.js","sourceRoot":"","sources":["../../../src/tools/core/memoryRecall.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IACvF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACjD,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IAChG,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;CACxF,CAAC,CAAC;AAUH,MAAM,UAAU,oBAAoB,CAAC,KAAkB;IACrD,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,2FAA2F;QACxG,QAAQ,EAAE,MAAM;QAChB,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;QACxB,QAAQ,EAAE,IAAI;QACd,WAAW;QACX,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE;YAChD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE;gBAC/B,KAAK;gBACL,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1C,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC3C,CAAC,CAAC;YACH,OAAO;gBACL,KAAK;gBACL,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACxB,EAAE,EAAE,CAAC,CAAC,EAAE;oBACR,OAAO,EAAE,CAAC,CAAC,OAAO;oBAClB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,SAAS,EAAE,CAAC,CAAC,SAAS;oBACtB,IAAI,EAAE,CAAC,CAAC,IAAI;iBACb,CAAC,CAAC;aACJ,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/core/memorySave.d.ts

@@ -0,0 +1,33 @@
+/**
+ * memory_save — commit a durable fact the agent should remember across turns.
+ *
+ * When to call:
+ *   - User tells you a stable fact about themselves, their work, or
+ *     their preferences ("I use pnpm", "my daughter's name is Luna").
+ *   - User asks you to remember something explicitly.
+ *   - Mid-task discoveries worth keeping ("API v2 requires x-session
+ *     header even though the docs don't mention it").
+ *
+ * When NOT to call:
+ *   - Ephemeral task state — that's conversation history (auto-saved).
+ *   - Things already obvious from the code.
+ */
+import { z } from "zod";
+import type { MemoryStore } from "../../memory/MemoryStore.js";
+import type { ToolDef } from "../types.js";
+declare const inputSchema: z.ZodObject<{
+    content: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    tags?: string[] | undefined;
+}, {
+    content: string;
+    tags?: string[] | undefined;
+}>;
+export declare function makeMemorySaveTool(store: MemoryStore): ToolDef<typeof inputSchema, {
+    id: string;
+    createdAt: number;
+}>;
+export {};
+//# sourceMappingURL=memorySave.d.ts.map

package/dist/tools/core/memorySave.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memorySave.d.ts","sourceRoot":"","sources":["../../../src/tools/core/memorySave.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,QAAA,MAAM,WAAW;;;;;;;;;EAGf,CAAC;AAEH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,WAAW,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAkBrH"}

package/dist/tools/core/memorySave.js

@@ -0,0 +1,41 @@
+/**
+ * memory_save — commit a durable fact the agent should remember across turns.
+ *
+ * When to call:
+ *   - User tells you a stable fact about themselves, their work, or
+ *     their preferences ("I use pnpm", "my daughter's name is Luna").
+ *   - User asks you to remember something explicitly.
+ *   - Mid-task discoveries worth keeping ("API v2 requires x-session
+ *     header even though the docs don't mention it").
+ *
+ * When NOT to call:
+ *   - Ephemeral task state — that's conversation history (auto-saved).
+ *   - Things already obvious from the code.
+ */
+import { z } from "zod";
+import { ValidationError } from "../../util/errors.js";
+const inputSchema = z.object({
+    content: z.string().min(1).max(4_000).describe("The fact or preference to remember, in one or two sentences."),
+    tags: z.array(z.string().min(1).max(64)).max(16).optional().describe("Lowercase tags for filtering, e.g. ['preference','tooling']."),
+});
+export function makeMemorySaveTool(store) {
+    return {
+        name: "memory_save",
+        description: "Remember a durable fact across conversations. Use sparingly — only things worth keeping.",
+        category: "data",
+        source: { kind: "core" },
+        alwaysOn: true,
+        inputSchema,
+        async execute({ content, tags }) {
+            const trimmed = content.trim();
+            if (!trimmed)
+                throw new ValidationError("memory_save: content cannot be empty");
+            const entry = store.save({
+                content: trimmed,
+                ...(tags ? { tags: tags.map((t) => t.toLowerCase()) } : {}),
+            });
+            return { id: entry.id, createdAt: entry.createdAt };
+        },
+    };
+}
+//# sourceMappingURL=memorySave.js.map

package/dist/tools/core/memorySave.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memorySave.js","sourceRoot":"","sources":["../../../src/tools/core/memorySave.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,8DAA8D,CAAC;IAC9G,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8DAA8D,CAAC;CACrI,CAAC,CAAC;AAEH,MAAM,UAAU,kBAAkB,CAAC,KAAkB;IACnD,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,0FAA0F;QACvG,QAAQ,EAAE,MAAM;QAChB,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;QACxB,QAAQ,EAAE,IAAI;QACd,WAAW;QACX,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE;YAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;YAC/B,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,eAAe,CAAC,sCAAsC,CAAC,CAAC;YAChF,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC;gBACvB,OAAO,EAAE,OAAO;gBAChB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5D,CAAC,CAAC;YACH,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;QACtD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/core/messageChannel.d.ts

@@ -0,0 +1,27 @@
+/**
+ * message_channel(channel, target, message) — proactively send a
+ * message to any user on any configured channel.
+ *
+ * Lets the agent initiate conversations (not just reply to inbound
+ * tasks). Validates target format (email, E.164 phone), looks up the
+ * running channel, and calls its `sendReply` with synthesised meta.
+ */
+import { z } from "zod";
+import type { ChannelManager } from "../../channels/ChannelManager.js";
+import type { ToolDef } from "../types.js";
+declare const inputSchema: z.ZodObject<{
+    channel: z.ZodString;
+    target: z.ZodString;
+    message: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    target: string;
+    message: string;
+    channel: string;
+}, {
+    target: string;
+    message: string;
+    channel: string;
+}>;
+export declare function makeMessageChannelTool(channels: ChannelManager): ToolDef<typeof inputSchema, unknown>;
+export {};
+//# sourceMappingURL=messageChannel.d.ts.map

package/dist/tools/core/messageChannel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageChannel.d.ts","sourceRoot":"","sources":["../../../src/tools/core/messageChannel.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAGvE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,QAAA,MAAM,WAAW;;;;;;;;;;;;EAIf,CAAC;AAIH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,WAAW,EAAE,OAAO,CAAC,CA6CrG"}

package/dist/tools/core/messageChannel.js

@@ -0,0 +1,59 @@
+/**
+ * message_channel(channel, target, message) — proactively send a
+ * message to any user on any configured channel.
+ *
+ * Lets the agent initiate conversations (not just reply to inbound
+ * tasks). Validates target format (email, E.164 phone), looks up the
+ * running channel, and calls its `sendReply` with synthesised meta.
+ */
+import { z } from "zod";
+import { NotFoundError, ValidationError } from "../../util/errors.js";
+const inputSchema = z.object({
+    channel: z.string().min(1).describe("Channel id (telegram, discord, slack, whatsapp, email, etc.)"),
+    target: z.string().min(1).describe("Chat id / user id / phone number / email — depends on channel."),
+    message: z.string().min(1).max(20_000),
+});
+const EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+export function makeMessageChannelTool(channels) {
+    return {
+        name: "message_channel",
+        description: "Send a proactive message to a user on any configured channel. Works with telegram, discord, slack, whatsapp, email, etc.",
+        category: "channel",
+        source: { kind: "core" },
+        tags: ["message", "channel", "outbound", "notify"],
+        inputSchema,
+        async execute({ channel, target, message }, { logger }) {
+            const id = channel.toLowerCase();
+            const ch = channels.getChannel(id);
+            if (!ch) {
+                const running = [...channels.runningSet()].join(", ") || "none";
+                throw new NotFoundError(`Channel '${channel}' is not running. Running: ${running}`);
+            }
+            // Target format checks — match the JS tool.
+            if (id === "email" && !EMAIL_REGEX.test(target)) {
+                throw new ValidationError(`Invalid email address: ${target}`);
+            }
+            if (id === "whatsapp" && !target.startsWith("+")) {
+                logger.warn("whatsapp target missing E.164 prefix", { target });
+            }
+            // Synthesise metadata. The chat/user/phone/email fields are
+            // duplicated because different channels read from different keys.
+            const meta = {
+                channel: id,
+                userId: target,
+                chatId: target,
+                to: target,
+                phoneNumber: target,
+                email: target,
+            };
+            await ch.sendReply(meta, message);
+            return {
+                channel: id,
+                target,
+                sent: true,
+                message: `Message sent to ${target} via ${id}`,
+            };
+        },
+    };
+}
+//# sourceMappingURL=messageChannel.js.map

package/dist/tools/core/messageChannel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageChannel.js","sourceRoot":"","sources":["../../../src/tools/core/messageChannel.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGtE,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,8DAA8D,CAAC;IACnG,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gEAAgE,CAAC;IACpG,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;CACvC,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,4BAA4B,CAAC;AAEjD,MAAM,UAAU,sBAAsB,CAAC,QAAwB;IAC7D,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,0HAA0H;QAC5H,QAAQ,EAAE,SAAS;QACnB,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;QACxB,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,CAAC;QAClD,WAAW;QACX,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE;YACpD,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;YACjC,MAAM,EAAE,GAAG,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YACnC,IAAI,CAAC,EAAE,EAAE,CAAC;gBACR,MAAM,OAAO,GAAG,CAAC,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC;gBAChE,MAAM,IAAI,aAAa,CAAC,YAAY,OAAO,8BAA8B,OAAO,EAAE,CAAC,CAAC;YACtF,CAAC;YAED,4CAA4C;YAC5C,IAAI,EAAE,KAAK,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChD,MAAM,IAAI,eAAe,CAAC,0BAA0B,MAAM,EAAE,CAAC,CAAC;YAChE,CAAC;YACD,IAAI,EAAE,KAAK,UAAU,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACjD,MAAM,CAAC,IAAI,CAAC,sCAAsC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAClE,CAAC;YAED,4DAA4D;YAC5D,kEAAkE;YAClE,MAAM,IAAI,GAAgB;gBACxB,OAAO,EAAE,EAAE;gBACX,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,MAAM;gBACd,EAAE,EAAE,MAAM;gBACV,WAAW,EAAE,MAAM;gBACnB,KAAK,EAAE,MAAM;aACd,CAAC;YAEF,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAClC,OAAO;gBACL,OAAO,EAAE,EAAE;gBACX,MAAM;gBACN,IAAI,EAAE,IAAI;gBACV,OAAO,EAAE,mBAAmB,MAAM,QAAQ,EAAE,EAAE;aAC/C,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/core/parallelCrew.d.ts

@@ -0,0 +1,54 @@
+/**
+ * parallel_crew — fan out N independent tasks to different crews at once.
+ *
+ * Use when two (or more) tasks have no ordering dependency — e.g. "have
+ * the researcher find X while the reviewer checks Y". Returns one
+ * result per task, in the same order, with `ok:false` + error for any
+ * that failed without tearing down the siblings.
+ */
+import { z } from "zod";
+import type { CrewAgentRunner } from "../../crew/CrewAgentRunner.js";
+import type { CrewRegistry } from "../../crew/CrewRegistry.js";
+import type { ToolDef } from "../types.js";
+interface UseCrewTurnContext {
+    resolvedModel(): string;
+}
+declare const inputSchema: z.ZodObject<{
+    tasks: z.ZodArray<z.ZodObject<{
+        crew: z.ZodString;
+        task: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        crew: string;
+        task: string;
+    }, {
+        crew: string;
+        task: string;
+    }>, "many">;
+    maxSteps: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    tasks: {
+        crew: string;
+        task: string;
+    }[];
+    maxSteps?: number | undefined;
+}, {
+    tasks: {
+        crew: string;
+        task: string;
+    }[];
+    maxSteps?: number | undefined;
+}>;
+interface TaskOutcome {
+    readonly crewId: string;
+    readonly ok: boolean;
+    readonly text?: string;
+    readonly error?: {
+        code: string;
+        message: string;
+    };
+}
+export declare function makeParallelCrewTool(registry: CrewRegistry, runner: CrewAgentRunner, turn: UseCrewTurnContext): ToolDef<typeof inputSchema, {
+    results: readonly TaskOutcome[];
+}>;
+export {};
+//# sourceMappingURL=parallelCrew.d.ts.map