@msm-core/mini 0.1.0

package/dist/definition/parser.js

@@ -0,0 +1,117 @@
+/**
+ * Definition Parser — parse .md agent definition files.
+ *
+ * Supported sections: Persona, Brain, Capabilities, Limits, Sections
+ * Stripped: Equipment, Skills, Hours, Memory rules (owned by the app layer)
+ */
+import { readFileSync } from "fs";
+/**
+ * Parse an agent definition from a .md file path or raw markdown string.
+ */
+export function parseDefinition(input) {
+    // If it looks like a file path, read it
+    const md = input.trimStart().startsWith("#")
+        ? input
+        : readFileSync(input, "utf-8");
+    return parseMd(md);
+}
+function parseMd(md) {
+    const lines = md.split("\n");
+    // Title — first H1
+    const titleLine = lines.find((l) => l.startsWith("# "));
+    const name = titleLine ? titleLine.replace(/^# /, "").trim() : "Agent";
+    // Top-level metadata (key: value lines before first ##)
+    const meta = parseTopMeta(lines);
+    // Sections
+    const persona = parseSection(lines, "Persona");
+    const brain = parseBrainSection(lines);
+    const capabilities = parseListSection(lines, "Capabilities");
+    const limits = parseLimitsSection(lines);
+    const sections = parseListSection(lines, "Sections");
+    const personaName = extractKey(persona, "name") ?? extractKey(persona, "Name");
+    const personaStyle = extractKey(persona, "style") ?? extractKey(persona, "Style");
+    const brainEndpoint = brain["endpoint"] ?? brain["Endpoint"];
+    const domain = meta["domain"] ?? meta["Domain"];
+    const language = meta["language"] ?? meta["Language"];
+    return {
+        name,
+        ...(domain !== undefined ? { domain } : {}),
+        ...(language !== undefined ? { language } : {}),
+        persona: {
+            ...(personaName !== undefined ? { name: personaName } : {}),
+            ...(personaStyle !== undefined ? { style: personaStyle } : {}),
+        },
+        brain: {
+            provider: (brain["provider"] ??
+                brain["Provider"] ??
+                "openai"),
+            model: brain["model"] ?? brain["Model"] ?? "gpt-4o-mini",
+            ...(brainEndpoint !== undefined ? { endpoint: brainEndpoint } : {}),
+        },
+        capabilities,
+        limits: {
+            maxIterations: Number(limits["maxIterations"] ?? limits["MaxIterations"] ?? 60),
+            costCapPerTask: Number(limits["costCapPerTask"] ?? limits["CostCapPerTask"] ?? 2.5),
+            timeoutMs: Number(limits["timeoutMs"] ?? limits["TimeoutMs"] ?? 900_000),
+            confidenceThreshold: Number(limits["confidenceThreshold"] ?? limits["ConfidenceThreshold"] ?? 0.75),
+            maxConsecutiveFailures: Number(limits["maxConsecutiveFailures"] ??
+                limits["MaxConsecutiveFailures"] ??
+                3),
+        },
+        ...(sections.length > 0 ? { sections } : {}),
+    };
+}
+// ─── Helpers ─────────────────────────────────────────────────
+function parseTopMeta(lines) {
+    const result = {};
+    for (const line of lines) {
+        if (line.startsWith("##"))
+            break;
+        const m = /^([A-Za-z]+)\s*:\s*(.+)$/.exec(line.trim());
+        if (m && m[1] && m[2])
+            result[m[1]] = m[2].trim();
+    }
+    return result;
+}
+function getSectionLines(lines, sectionName) {
+    const startIdx = lines.findIndex((l) => l.match(new RegExp(`^##\\s+${sectionName}\\s*$`, "i")));
+    if (startIdx === -1)
+        return [];
+    const result = [];
+    for (let i = startIdx + 1; i < lines.length; i++) {
+        const line = lines[i];
+        if (line === undefined)
+            break;
+        if (/^##\s/.test(line))
+            break;
+        result.push(line);
+    }
+    return result;
+}
+function parseSection(lines, sectionName) {
+    const sectionLines = getSectionLines(lines, sectionName);
+    const result = {};
+    for (const line of sectionLines) {
+        const m = /^([A-Za-z]+)\s*:\s*(.+)$/.exec(line.trim());
+        if (m && m[1] && m[2])
+            result[m[1]] = m[2].trim();
+    }
+    return result;
+}
+function parseBrainSection(lines) {
+    return parseSection(lines, "Brain");
+}
+function parseListSection(lines, sectionName) {
+    return getSectionLines(lines, sectionName)
+        .map((l) => l.trim())
+        .filter((l) => l.startsWith("-"))
+        .map((l) => l.replace(/^-\s*/, "").trim())
+        .filter(Boolean);
+}
+function parseLimitsSection(lines) {
+    return parseSection(lines, "Limits");
+}
+function extractKey(obj, key) {
+    return obj[key] ?? obj[key.toLowerCase()];
+}
+//# sourceMappingURL=parser.js.map

package/dist/definition/parser.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * msm-mini — Public API
+ *
+ * import { createAgent } from 'msm-mini'
+ * import { createGeminiBrain } from 'msm-mini'         // or openai/anthropic/ollama
+ * import { scoreOutcome } from 'msm-mini/quality'
+ * import { RedisMemory, RedisControlBus } from 'msm-mini/adapters'
+ */
+export { createAgent } from "./core/loop.js";
+export { createGeminiBrain } from "./brain/gemini.js";
+export { createOpenAIBrain } from "./brain/openai.js";
+export { createAnthropicBrain } from "./brain/anthropic.js";
+export { createOllamaBrain } from "./brain/ollama.js";
+export { buildBrain } from "./brain/factory.js";
+export { parseDefinition } from "./definition/parser.js";
+export type { Agent, AgentConfig, AgentEvent, AgentContext, AgentDefinition, AgentHooks, Brain, BrainPayload, BrainRunInput, DocumentState, GateConfig, GuardConfig, GuardSignal, GuardSignalType, IterationInfo, LoopOutcome, MemoryEntry, Message, OutcomeType, RedisConfig, RunState, SectionInfo, Tool, ToolCallInfo, ToolDefinition, ToolMeta, ToolParameter, ToolResult, } from "./core/types.js";
+export { resolveGuards, DEFAULT_GUARDS } from "./core/guards.js";
+export { scoreOutcome } from "./quality/scorer.js";
+export type { QualityScore, QualityFlag } from "./quality/scorer.js";
+export { createAgentServer } from "./server.js";
+export type { AgentServer, AgentServerOptions } from "./server.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,YAAY,EACV,KAAK,EACL,WAAW,EACX,UAAU,EACV,YAAY,EACZ,eAAe,EACf,UAAU,EACV,KAAK,EACL,YAAY,EACZ,aAAa,EACb,aAAa,EACb,UAAU,EACV,WAAW,EACX,WAAW,EACX,eAAe,EACf,aAAa,EACb,WAAW,EACX,WAAW,EACX,OAAO,EACP,WAAW,EACX,WAAW,EACX,QAAQ,EACR,WAAW,EACX,IAAI,EACJ,YAAY,EACZ,cAAc,EACd,QAAQ,EACR,aAAa,EACb,UAAU,GACX,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGjE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+/**
+ * msm-mini — Public API
+ *
+ * import { createAgent } from 'msm-mini'
+ * import { createGeminiBrain } from 'msm-mini'         // or openai/anthropic/ollama
+ * import { scoreOutcome } from 'msm-mini/quality'
+ * import { RedisMemory, RedisControlBus } from 'msm-mini/adapters'
+ */
+// ── Main factory ────────────────────────────────────────────────────────────
+export { createAgent } from "./core/loop.js";
+// ── Brain factories ─────────────────────────────────────────────────────────
+export { createGeminiBrain } from "./brain/gemini.js";
+export { createOpenAIBrain } from "./brain/openai.js";
+export { createAnthropicBrain } from "./brain/anthropic.js";
+export { createOllamaBrain } from "./brain/ollama.js";
+export { buildBrain } from "./brain/factory.js";
+// ── Definition parser ───────────────────────────────────────────────────────
+export { parseDefinition } from "./definition/parser.js";
+// ── Guard utilities ─────────────────────────────────────────────────────────
+export { resolveGuards, DEFAULT_GUARDS } from "./core/guards.js";
+// ── Quality scorer ──────────────────────────────────────────────────────────
+export { scoreOutcome } from "./quality/scorer.js";
+// ── HTTP server wrapper ─────────────────────────────────────────────────────
+export { createAgentServer } from "./server.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,+EAA+E;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,+EAA+E;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,+EAA+E;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAkCzD,+EAA+E;AAC/E,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEjE,+EAA+E;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,+EAA+E;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/quality/scorer.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Quality Scorer — pure function, zero side effects.
+ * Compute resolution/efficiency/errorRate from a LoopOutcome.
+ * Feeds the dashboard quality monitor. No evolving layer.
+ */
+import type { LoopOutcome } from "../core/types.js";
+export type QualityFlag = "failed_resolution" | "slow_response" | "high_error_rate";
+export interface QualityScore {
+    /** 0–1: likelihood the user's request was resolved */
+    resolution: number;
+    /** 0–1: 1=direct (≤1 tool call), 0=verbose (>5) */
+    efficiency: number;
+    /** 0–1: 1=no tool failures, 0=all failed */
+    errorRate: number;
+    flags: QualityFlag[];
+}
+export declare function scoreOutcome(outcome: LoopOutcome): QualityScore;
+//# sourceMappingURL=scorer.d.ts.map

package/dist/quality/scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scorer.d.ts","sourceRoot":"","sources":["../../src/quality/scorer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,MAAM,WAAW,GACnB,mBAAmB,GACnB,eAAe,GACf,iBAAiB,CAAC;AAEtB,MAAM,WAAW,YAAY;IAC3B,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,YAAY,CAe/D"}

package/dist/quality/scorer.js

@@ -0,0 +1,22 @@
+/**
+ * Quality Scorer — pure function, zero side effects.
+ * Compute resolution/efficiency/errorRate from a LoopOutcome.
+ * Feeds the dashboard quality monitor. No evolving layer.
+ */
+export function scoreOutcome(outcome) {
+    const toolCalls = outcome.toolCalls ?? [];
+    const totalTools = outcome.metrics.totalToolCalls;
+    const failedTools = toolCalls.filter((t) => t.status === "failed").length;
+    const resolution = outcome.type === "response" ? 1 : outcome.type === "error" ? 0 : 0.5;
+    const efficiency = totalTools === 0 ? 1 : Math.max(0, 1 - (totalTools - 1) / 5);
+    const errorRate = totalTools === 0 ? 1 : 1 - failedTools / totalTools;
+    const flags = [];
+    if (resolution < 0.5)
+        flags.push("failed_resolution");
+    if (efficiency < 0.5)
+        flags.push("slow_response");
+    if (errorRate < 0.7)
+        flags.push("high_error_rate");
+    return { resolution, efficiency, errorRate, flags };
+}
+//# sourceMappingURL=scorer.js.map

package/dist/quality/scorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scorer.js","sourceRoot":"","sources":["../../src/quality/scorer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmBH,MAAM,UAAU,YAAY,CAAC,OAAoB;IAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;IAC1C,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC;IAClD,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC;IAE1E,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACxF,MAAM,UAAU,GAAG,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAChF,MAAM,SAAS,GAAG,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,GAAG,UAAU,CAAC;IAEtE,MAAM,KAAK,GAAkB,EAAE,CAAC;IAChC,IAAI,UAAU,GAAG,GAAG;QAAE,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACtD,IAAI,UAAU,GAAG,GAAG;QAAE,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAClD,IAAI,SAAS,GAAG,GAAG;QAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAEnD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AACtD,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,27 @@
+/**
+ * createAgentServer — lightweight HTTP wrapper around an msm-mini Agent.
+ *
+ * Exposes:
+ *   POST /v1/event   → agent.handle({ sessionId, message, context? })
+ *   GET  /health     → { ok: true, uptime }
+ *
+ * The UTS api/server.ts proxies /chat → /v1/event on this server.
+ * All other msm-agent HTTP surface (dashboard etc.) is NOT replicated — keep it slim.
+ *
+ * @example
+ * const agentServer = createAgentServer(agent, { port: PORT + 1 });
+ * await agentServer.start();
+ * // ...
+ * await agentServer.stop();
+ */
+import type { Agent } from "./core/types.js";
+export interface AgentServerOptions {
+    port: number;
+    host?: string;
+}
+export interface AgentServer {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+export declare function createAgentServer(agent: Agent, opts: AgentServerOptions): AgentServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AA4BD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,kBAAkB,GACvB,WAAW,CAoFb"}

package/dist/server.js

@@ -0,0 +1,118 @@
+/**
+ * createAgentServer — lightweight HTTP wrapper around an msm-mini Agent.
+ *
+ * Exposes:
+ *   POST /v1/event   → agent.handle({ sessionId, message, context? })
+ *   GET  /health     → { ok: true, uptime }
+ *
+ * The UTS api/server.ts proxies /chat → /v1/event on this server.
+ * All other msm-agent HTTP surface (dashboard etc.) is NOT replicated — keep it slim.
+ *
+ * @example
+ * const agentServer = createAgentServer(agent, { port: PORT + 1 });
+ * await agentServer.start();
+ * // ...
+ * await agentServer.stop();
+ */
+import { createServer, } from "node:http";
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on("data", (c) => chunks.push(c));
+        req.on("end", () => {
+            try {
+                resolve(JSON.parse(Buffer.concat(chunks).toString("utf8")));
+            }
+            catch {
+                reject(new Error("Invalid JSON body"));
+            }
+        });
+        req.on("error", reject);
+    });
+}
+function json(res, status, body) {
+    const payload = JSON.stringify(body);
+    res.writeHead(status, {
+        "Content-Type": "application/json",
+        "Content-Length": Buffer.byteLength(payload),
+    });
+    res.end(payload);
+}
+const START_TIME = Date.now();
+export function createAgentServer(agent, opts) {
+    const host = opts.host ?? "127.0.0.1";
+    const port = opts.port;
+    const server = createServer(async (req, res) => {
+        const path = (req.url ?? "/").split("?")[0];
+        // CORS preflight
+        if (req.method === "OPTIONS") {
+            res.writeHead(204, {
+                "Access-Control-Allow-Origin": "*",
+                "Access-Control-Allow-Methods": "POST, GET, OPTIONS",
+                "Access-Control-Allow-Headers": "Content-Type, Authorization",
+            });
+            res.end();
+            return;
+        }
+        try {
+            // ── Health ────────────────────────────────────────────────────────────
+            if (path === "/health" && req.method === "GET") {
+                json(res, 200, { ok: true, uptime: Date.now() - START_TIME });
+                return;
+            }
+            // ── Agent event ───────────────────────────────────────────────────────
+            if (path === "/v1/event" && req.method === "POST") {
+                let body;
+                try {
+                    body = (await readBody(req));
+                }
+                catch {
+                    json(res, 400, { error: "Invalid JSON body" });
+                    return;
+                }
+                const sessionId = typeof body["sessionId"] === "string" ? body["sessionId"] : "";
+                const text = typeof body["text"] === "string" ? body["text"] : "";
+                if (!sessionId || !text) {
+                    json(res, 400, {
+                        error: "Missing required fields: sessionId, text",
+                    });
+                    return;
+                }
+                const outcome = await agent.handle({
+                    sessionId,
+                    message: text,
+                });
+                json(res, 200, outcome);
+                return;
+            }
+            json(res, 404, { error: "Not found" });
+        }
+        catch (err) {
+            if (!res.headersSent) {
+                json(res, 500, { error: String(err) });
+            }
+            console.error("[AgentServer]", err);
+        }
+    });
+    return {
+        start() {
+            return new Promise((resolve) => {
+                server.listen(port, host, () => {
+                    console.log(`[AgentServer] listening on http://${host}:${port}`);
+                    resolve();
+                });
+            });
+        },
+        stop() {
+            return new Promise((resolve, reject) => {
+                server.close((err) => {
+                    if (err)
+                        reject(err);
+                    else
+                        resolve();
+                });
+            });
+        },
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/dedup.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Tool Dedup — Hash-based idempotency for tool calls.
+ *
+ * Deduplication key: SHA-256(toolName + JSON.stringify(sortedArgs))
+ * Stored in Redis as: {prefix}:session:{id}:tools:dedup hash field
+ * TTL: 5 minutes (configurable)
+ */
+import type { ToolResult } from "../core/types.js";
+type RedisLike = {
+    hget(key: string, field: string): Promise<string | null>;
+    hset(key: string, field: string, value: string): Promise<unknown>;
+    expire(key: string, seconds: number): Promise<unknown>;
+};
+export declare function toolDedupKey(prefix: string, sessionId: string): string;
+export declare function checkDedup(redis: RedisLike, dedupKey: string, hash: string): Promise<ToolResult | null>;
+export declare function storeDedup(redis: RedisLike, dedupKey: string, hash: string, result: ToolResult, ttlSeconds: number): Promise<void>;
+/** Deterministic hash of a tool call — pure function, no crypto dependency */
+export declare function hashToolCall(toolName: string, args: Record<string, unknown>): string;
+export {};
+//# sourceMappingURL=dedup.d.ts.map

package/dist/tools/dedup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.d.ts","sourceRoot":"","sources":["../../src/tools/dedup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,KAAK,SAAS,GAAG;IACf,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACxD,CAAC;AAEF,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAsB,UAAU,CAC9B,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAQ5B;AAED,wBAAsB,UAAU,CAC9B,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAUpF"}

package/dist/tools/dedup.js

@@ -0,0 +1,47 @@
+/**
+ * Tool Dedup — Hash-based idempotency for tool calls.
+ *
+ * Deduplication key: SHA-256(toolName + JSON.stringify(sortedArgs))
+ * Stored in Redis as: {prefix}:session:{id}:tools:dedup hash field
+ * TTL: 5 minutes (configurable)
+ */
+export function toolDedupKey(prefix, sessionId) {
+    return `${prefix}:session:${sessionId}:tools:dedup`;
+}
+export async function checkDedup(redis, dedupKey, hash) {
+    const cached = await redis.hget(dedupKey, hash);
+    if (!cached)
+        return null;
+    try {
+        return JSON.parse(cached);
+    }
+    catch {
+        return null;
+    }
+}
+export async function storeDedup(redis, dedupKey, hash, result, ttlSeconds) {
+    await redis.hset(dedupKey, hash, JSON.stringify(result));
+    await redis.expire(dedupKey, ttlSeconds);
+}
+/** Deterministic hash of a tool call — pure function, no crypto dependency */
+export function hashToolCall(toolName, args) {
+    const sorted = sortKeys(args);
+    const str = toolName + "::" + JSON.stringify(sorted);
+    // FNV-1a 32-bit hash — fast, deterministic, no external dep
+    let h = 2166136261;
+    for (let i = 0; i < str.length; i++) {
+        h ^= str.charCodeAt(i);
+        h = (h * 16777619) >>> 0;
+    }
+    return h.toString(16).padStart(8, "0");
+}
+function sortKeys(obj) {
+    if (obj === null || typeof obj !== "object")
+        return obj;
+    if (Array.isArray(obj))
+        return obj.map(sortKeys);
+    return Object.fromEntries(Object.entries(obj)
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([k, v]) => [k, sortKeys(v)]));
+}
+//# sourceMappingURL=dedup.js.map

package/dist/tools/dedup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.js","sourceRoot":"","sources":["../../src/tools/dedup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,SAAiB;IAC5D,OAAO,GAAG,MAAM,YAAY,SAAS,cAAc,CAAC;AACtD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,KAAgB,EAChB,QAAgB,EAChB,IAAY;IAEZ,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAe,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,KAAgB,EAChB,QAAgB,EAChB,IAAY,EACZ,MAAkB,EAClB,UAAkB;IAElB,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACzD,MAAM,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AAC3C,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,IAA6B;IAC1E,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,GAAG,GAAG,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACrD,4DAA4D;IAC5D,IAAI,CAAC,GAAG,UAAU,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,QAAQ,CAAC,GAAY;IAC5B,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACjD,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,GAA8B,CAAC;SAC3C,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;SACtC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CACrC,CAAC;AACJ,CAAC"}

package/dist/tools/executor.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Tool Executor — Validation, dedup, and execution pipeline.
+ *
+ * Pipeline per tool call:
+ *   1. Control bus — check if tool is disabled
+ *   2. Dedup — return cached result if same args seen in last 5 min
+ *   3. Validate — check required parameters are present and typed
+ *   4. Execute — call tool.execute()
+ *   5. Cache — store result in dedup hash
+ */
+import type { Tool, ToolResult, ToolMeta } from "../core/types.js";
+type RedisLike = {
+    hget(key: string, field: string): Promise<string | null>;
+    hset(key: string, field: string, value: string): Promise<unknown>;
+    expire(key: string, seconds: number): Promise<unknown>;
+    get(key: string): Promise<string | null>;
+};
+export interface ExecutorOptions {
+    redis: RedisLike;
+    redisPrefix: string;
+    dedupTtlSeconds: number;
+}
+export interface ExecutionResult {
+    result: ToolResult;
+    cached: boolean;
+    durationMs: number;
+}
+export declare function executeTool(tool: Tool, params: Record<string, unknown>, meta: ToolMeta, opts: ExecutorOptions): Promise<ExecutionResult>;
+/** Build a ToolDefinition list from app-provided Tool objects (for brain prompt) */
+export declare function toToolDefinitions(tools: Tool[]): import("../core/types.js").ToolDefinition[];
+export {};
+//# sourceMappingURL=executor.d.ts.map

package/dist/tools/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/tools/executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAGnE,KAAK,SAAS,GAAG;IACf,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC1C,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,SAAS,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,eAAe,CAAC,CAuC1B;AAqBD,oFAAoF;AACpF,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,IAAI,EAAE,GACZ,OAAO,kBAAkB,EAAE,cAAc,EAAE,CAS7C"}

package/dist/tools/executor.js

@@ -0,0 +1,75 @@
+/**
+ * Tool Executor — Validation, dedup, and execution pipeline.
+ *
+ * Pipeline per tool call:
+ *   1. Control bus — check if tool is disabled
+ *   2. Dedup — return cached result if same args seen in last 5 min
+ *   3. Validate — check required parameters are present and typed
+ *   4. Execute — call tool.execute()
+ *   5. Cache — store result in dedup hash
+ */
+import { hashToolCall, checkDedup, storeDedup, toolDedupKey } from "./dedup.js";
+export async function executeTool(tool, params, meta, opts) {
+    const start = Date.now();
+    // Step 1: Validate required parameters
+    const validationError = validateParams(tool, params);
+    if (validationError) {
+        return {
+            result: { tool: tool.name, status: "failed", error: validationError },
+            cached: false,
+            durationMs: Date.now() - start,
+        };
+    }
+    // Step 2: Dedup check
+    const hash = hashToolCall(tool.name, params);
+    const dedupKey = toolDedupKey(opts.redisPrefix, meta.sessionId);
+    const cached = await checkDedup(opts.redis, dedupKey, hash);
+    if (cached) {
+        return { result: cached, cached: true, durationMs: Date.now() - start };
+    }
+    // Step 3: Execute
+    let result;
+    try {
+        result = await tool.execute(params, meta);
+    }
+    catch (err) {
+        result = {
+            tool: tool.name,
+            status: "failed",
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+    // Step 4: Cache successful results only
+    if (result.status === "ok") {
+        await storeDedup(opts.redis, dedupKey, hash, result, opts.dedupTtlSeconds);
+    }
+    return { result, cached: false, durationMs: Date.now() - start };
+}
+/** Lightweight required-field validation (no Zod runtime dep in loop) */
+function validateParams(tool, params) {
+    for (const [name, def] of Object.entries(tool.parameters)) {
+        if (!def.required)
+            continue;
+        if (params[name] === undefined || params[name] === null) {
+            return `Tool "${tool.name}": required parameter "${name}" is missing`;
+        }
+        const expected = def.type;
+        const actual = Array.isArray(params[name]) ? "array" : typeof params[name];
+        if (expected !== "object" && expected !== actual) {
+            return `Tool "${tool.name}": parameter "${name}" expected ${expected}, got ${actual}`;
+        }
+    }
+    return null;
+}
+/** Build a ToolDefinition list from app-provided Tool objects (for brain prompt) */
+export function toToolDefinitions(tools) {
+    return tools.map((t) => ({
+        name: t.name,
+        description: t.description,
+        parameters: t.parameters,
+        ...(t.requiresApproval !== undefined
+            ? { requiresApproval: t.requiresApproval }
+            : {}),
+    }));
+}
+//# sourceMappingURL=executor.js.map

package/dist/tools/executor.js.map

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