@msm-core/mini 0.1.0

package/dist/core/loop.js

@@ -0,0 +1,255 @@
+/**
+ * Execution Loop — The core of msm-mini.
+ *
+ * event → gates → lock → control bus → context build → brain call →
+ * guards → dispatch:
+ *   use_tool → validate/dedup/execute → record → loop
+ *   respond/clarify/escalate → deliver → done
+ *   budget exhausted → force_respond → done
+ */
+import { randomBytes } from "crypto";
+import { resolveGuards, checkGuards, hasHardBlock, hardAction, } from "./guards.js";
+import { runGates } from "./gates.js";
+import { buildContext } from "./context-builder.js";
+import { fireIteration, fireToolCall, fireGuard, fireFatalError, fireSectionComplete, } from "./hooks.js";
+import { RedisMemory, connectRedis } from "../adapters/redis-memory.js";
+import { RedisControlBus } from "../adapters/redis-control.js";
+import { RedisDistributedLock } from "../adapters/redis-lock.js";
+import { executeTool, toToolDefinitions } from "../tools/executor.js";
+import { parseDefinition } from "../definition/parser.js";
+function makeTaskId() {
+    return randomBytes(8).toString("hex");
+}
+/**
+ * Create a stateful agent from config.
+ * Returns an Agent object — call .handle() on every incoming event.
+ */
+export function createAgent(config) {
+    const def = typeof config.definition === "string"
+        ? parseDefinition(config.definition)
+        : config.definition;
+    const guards = resolveGuards(config.guards);
+    const prefix = config.redis.prefix ?? "msm";
+    const ttl = config.redis.ttl ?? {};
+    // Lazy-initialized shared Redis connection
+    let _redis = null;
+    async function getRedis() {
+        if (!_redis)
+            _redis = (await connectRedis(config.redis.url));
+        return _redis;
+    }
+    async function handle(event) {
+        const sessionId = event.sessionId;
+        const taskId = makeTaskId();
+        const started = Date.now();
+        const redis = await getRedis();
+        const memory = new RedisMemory(redis, {
+            prefix,
+            ...(ttl.history !== undefined ? { historyTtl: ttl.history } : {}),
+            ...(ttl.document !== undefined ? { documentTtl: ttl.document } : {}),
+        });
+        const controlBus = new RedisControlBus(redis, prefix);
+        const lock = new RedisDistributedLock(redis, prefix);
+        // ── Gates (zero-LLM filters) ─────────────────────────────
+        const gated = runGates(sessionId, taskId, event.message, config.gates);
+        if (gated)
+            return gated;
+        // ── Distributed lock ─────────────────────────────────────
+        const lockHandle = await lock.acquireWithRetry(sessionId, guards.timeoutMs + 30_000);
+        const state = {
+            sessionId,
+            taskId,
+            iteration: 0,
+            startedAt: started,
+            totalCostUsd: 0,
+            totalToolCalls: 0,
+            consecutiveToolFailures: 0,
+        };
+        const toolDefs = toToolDefinitions(config.tools);
+        const toolMap = new Map(config.tools.map((t) => [t.name, t]));
+        const toolResults = [];
+        try {
+            // Load history
+            const history = await memory.getHistory(sessionId, guards.maxIterations * 4);
+            // Loop
+            while (true) {
+                state.iteration++;
+                // ── Control bus check ─────────────────────────────────
+                const command = await controlBus.getCommand(sessionId);
+                // ── Guards ────────────────────────────────────────────
+                const action = state.lastPayload?.orchestration?.action ?? "respond";
+                const confidence = state.lastPayload?.orchestration?.confidence ?? 1;
+                const guardSignals = checkGuards(state, guards, action, confidence, command);
+                if (hasHardBlock(guardSignals)) {
+                    const hardSignal = guardSignals.find((s) => s.hard);
+                    fireGuard(config.hooks, sessionId, hardSignal, state.iteration);
+                    const ha = hardAction(guardSignals);
+                    if (ha === "abort") {
+                        await lockHandle.release();
+                        return makeOutcome("error", sessionId, taskId, state, started, {
+                            text: `Aborted: ${hardSignal.message}`,
+                            terminatedBy: hardSignal.type,
+                        });
+                    }
+                    // force_respond / escalate → emit last text if available
+                    const lastText = state.lastPayload?.generation?.response_text ??
+                        state.lastPayload?.final_output?.text ??
+                        "I was unable to complete this request within the allowed limits. Please try a more specific question.";
+                    const outcomeType = ha === "escalate" ? "escalate" : "response";
+                    await memory.appendHistory(sessionId, {
+                        role: "assistant",
+                        content: lastText,
+                        timestamp: Date.now(),
+                    });
+                    await lockHandle.release();
+                    return makeOutcome(outcomeType, sessionId, taskId, state, started, {
+                        text: lastText,
+                        terminatedBy: hardSignal.type,
+                        toolCalls: toolResults,
+                    });
+                }
+                // ── Context build ─────────────────────────────────────
+                const documentState = await memory.getDocumentState(sessionId);
+                const currentSection = documentState?.currentSection;
+                fireIteration(config.hooks, state, guards.maxIterations, currentSection);
+                const { system_context, history: trimmedHistory } = buildContext(def, history, toolDefs, event.context);
+                // ── Brain call ────────────────────────────────────────
+                const brainInput = {
+                    raw: event.message,
+                    system_context,
+                    history: trimmedHistory,
+                    tools: toolDefs,
+                    ...(toolResults.length > 0
+                        ? { tool_results: toolResults.slice(-5) }
+                        : {}),
+                };
+                const payload = await config.brain.run(brainInput);
+                state.lastPayload = payload;
+                state.totalCostUsd += payload.costUsd ?? 0;
+                const orch = payload.orchestration;
+                // ── Tool call ─────────────────────────────────────────
+                if (orch?.action === "use_tool" && orch.tool_name) {
+                    const toolName = orch.tool_name;
+                    // Check if tool is disabled
+                    const disabledTool = RedisControlBus.disabledTool(command);
+                    if (disabledTool === toolName) {
+                        toolResults.push({
+                            tool: toolName,
+                            status: "failed",
+                            error: `Tool "${toolName}" is currently disabled`,
+                        });
+                        state.consecutiveToolFailures++;
+                        continue;
+                    }
+                    const tool = toolMap.get(toolName);
+                    if (!tool) {
+                        toolResults.push({
+                            tool: toolName,
+                            status: "failed",
+                            error: `Unknown tool: "${toolName}"`,
+                        });
+                        state.consecutiveToolFailures++;
+                        continue;
+                    }
+                    const params = (orch.tool_params ?? {});
+                    const exec = await executeTool(tool, params, {
+                        sessionId,
+                        iteration: state.iteration,
+                        agentName: def.name,
+                    }, {
+                        redis,
+                        redisPrefix: prefix,
+                        dedupTtlSeconds: ttl.toolDedup ?? 300,
+                    });
+                    fireToolCall(config.hooks, sessionId, exec.result, state.iteration, exec.cached, exec.durationMs);
+                    toolResults.push(exec.result);
+                    state.totalToolCalls++;
+                    if (exec.result.status === "failed") {
+                        state.consecutiveToolFailures++;
+                    }
+                    else {
+                        state.consecutiveToolFailures = 0;
+                    }
+                    continue; // next iteration
+                }
+                // ── Terminal outcome ──────────────────────────────────
+                const text = payload.generation?.response_text ?? payload.final_output?.text ?? "";
+                // Section complete tracking
+                if (documentState && currentSection) {
+                    const idx = documentState.sections.indexOf(currentSection);
+                    if (idx >= 0 &&
+                        !documentState.completedSections.includes(currentSection)) {
+                        documentState.completedSections.push(currentSection);
+                        const nextSection = documentState.sections[idx + 1];
+                        documentState.currentSection = nextSection ?? currentSection;
+                        documentState.updatedAt = Date.now();
+                        await memory.setDocumentState(sessionId, documentState);
+                        fireSectionComplete(config.hooks, sessionId, currentSection, idx, documentState.sections.length);
+                    }
+                }
+                // Record to history
+                await memory.appendHistory(sessionId, {
+                    role: "user",
+                    content: event.message,
+                    timestamp: started,
+                });
+                await memory.appendHistory(sessionId, {
+                    role: "assistant",
+                    content: text,
+                    timestamp: Date.now(),
+                });
+                const outcomeType = orch?.action === "clarify"
+                    ? "clarify"
+                    : orch?.action === "escalate"
+                        ? "escalate"
+                        : "response";
+                await lockHandle.release();
+                return makeOutcome(outcomeType, sessionId, taskId, state, started, {
+                    text,
+                    toolCalls: toolResults,
+                });
+            }
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            fireFatalError(config.hooks, error, sessionId);
+            await lockHandle.release();
+            return makeOutcome("error", sessionId, taskId, state, started, {
+                text: "An unexpected error occurred. Please try again.",
+                error: error.message,
+            });
+        }
+    }
+    async function kill(sessionId) {
+        const redis = await getRedis();
+        const bus = new RedisControlBus(redis, prefix);
+        await bus.kill(sessionId);
+    }
+    async function pause(sessionId) {
+        const redis = await getRedis();
+        const bus = new RedisControlBus(redis, prefix);
+        await bus.pause(sessionId);
+    }
+    async function resume(sessionId) {
+        const redis = await getRedis();
+        const bus = new RedisControlBus(redis, prefix);
+        await bus.resume(sessionId);
+    }
+    return { handle, kill, pause, resume };
+}
+// ─── Helpers ──────────────────────────────────────────────────
+function makeOutcome(type, sessionId, taskId, state, started, extra = {}) {
+    return {
+        type,
+        sessionId,
+        taskId,
+        metrics: {
+            iterations: state.iteration,
+            totalCostUsd: state.totalCostUsd,
+            durationMs: Date.now() - started,
+            totalToolCalls: state.totalToolCalls,
+        },
+        ...extra,
+    };
+}
+//# sourceMappingURL=loop.js.map

package/dist/core/loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.js","sourceRoot":"","sources":["../../src/core/loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAWrC,OAAO,EACL,aAAa,EACb,WAAW,EACX,YAAY,EACZ,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EACL,aAAa,EACb,YAAY,EACZ,SAAS,EACT,cAAc,EACd,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,SAAS,UAAU;IACjB,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,MAAmB;IAC7C,MAAM,GAAG,GACP,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;QACnC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC;QACpC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;IAExB,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC;IAC5C,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC;IAEnC,2CAA2C;IAC3C,IAAI,MAAM,GAAqB,IAAI,CAAC;IACpC,KAAK,UAAU,QAAQ;QACrB,IAAI,CAAC,MAAM;YAAE,MAAM,GAAG,CAAC,MAAM,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAc,CAAC;QAC1E,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,UAAU,MAAM,CAAC,KAAiB;QACrC,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QAClC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE3B,MAAM,KAAK,GAAG,MAAM,QAAQ,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,KAAK,EAAE;YACpC,MAAM;YACN,GAAG,CAAC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,GAAG,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrE,CAAC,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,IAAI,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAErD,4DAA4D;QAC5D,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;QAExB,4DAA4D;QAC5D,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAC5C,SAAS,EACT,MAAM,CAAC,SAAS,GAAG,MAAM,CAC1B,CAAC;QAEF,MAAM,KAAK,GAAa;YACtB,SAAS;YACT,MAAM;YACN,SAAS,EAAE,CAAC;YACZ,SAAS,EAAE,OAAO;YAClB,YAAY,EAAE,CAAC;YACf,cAAc,EAAE,CAAC;YACjB,uBAAuB,EAAE,CAAC;SAC3B,CAAC;QAEF,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9D,MAAM,WAAW,GAAiB,EAAE,CAAC;QAErC,IAAI,CAAC;YACH,eAAe;YACf,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,CACrC,SAAS,EACT,MAAM,CAAC,aAAa,GAAG,CAAC,CACzB,CAAC;YAEF,OAAO;YACP,OAAO,IAAI,EAAE,CAAC;gBACZ,KAAK,CAAC,SAAS,EAAE,CAAC;gBAElB,yDAAyD;gBACzD,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;gBAEvD,yDAAyD;gBACzD,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,EAAE,aAAa,EAAE,MAAM,IAAI,SAAS,CAAC;gBACrE,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,aAAa,EAAE,UAAU,IAAI,CAAC,CAAC;gBACrE,MAAM,YAAY,GAAG,WAAW,CAC9B,KAAK,EACL,MAAM,EACN,MAAM,EACN,UAAU,EACV,OAAO,CACR,CAAC;gBAEF,IAAI,YAAY,CAAC,YAAY,CAAC,EAAE,CAAC;oBAC/B,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAE,CAAC;oBACrD,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;oBAEhE,MAAM,EAAE,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;oBACpC,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;wBACnB,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC;wBAC3B,OAAO,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE;4BAC7D,IAAI,EAAE,YAAY,UAAU,CAAC,OAAO,EAAE;4BACtC,YAAY,EAAE,UAAU,CAAC,IAAI;yBAC9B,CAAC,CAAC;oBACL,CAAC;oBAED,yDAAyD;oBACzD,MAAM,QAAQ,GACZ,KAAK,CAAC,WAAW,EAAE,UAAU,EAAE,aAAa;wBAC5C,KAAK,CAAC,WAAW,EAAE,YAAY,EAAE,IAAI;wBACrC,uGAAuG,CAAC;oBAE1G,MAAM,WAAW,GAAG,EAAE,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;oBAChE,MAAM,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE;wBACpC,IAAI,EAAE,WAAW;wBACjB,OAAO,EAAE,QAAQ;wBACjB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;qBACtB,CAAC,CAAC;oBACH,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC;oBAC3B,OAAO,WAAW,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE;wBACjE,IAAI,EAAE,QAAQ;wBACd,YAAY,EAAE,UAAU,CAAC,IAAI;wBAC7B,SAAS,EAAE,WAAW;qBACvB,CAAC,CAAC;gBACL,CAAC;gBAED,yDAAyD;gBACzD,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;gBAC/D,MAAM,cAAc,GAAG,aAAa,EAAE,cAAc,CAAC;gBACrD,aAAa,CACX,MAAM,CAAC,KAAK,EACZ,KAAK,EACL,MAAM,CAAC,aAAa,EACpB,cAAc,CACf,CAAC;gBAEF,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,YAAY,CAC9D,GAAG,EACH,OAAO,EACP,QAAQ,EACR,KAAK,CAAC,OAAO,CACd,CAAC;gBAEF,yDAAyD;gBACzD,MAAM,UAAU,GAAkB;oBAChC,GAAG,EAAE,KAAK,CAAC,OAAO;oBAClB,cAAc;oBACd,OAAO,EAAE,cAAc;oBACvB,KAAK,EAAE,QAAQ;oBACf,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;wBACxB,CAAC,CAAC,EAAE,YAAY,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;wBACzC,CAAC,CAAC,EAAE,CAAC;iBACR,CAAC;gBAEF,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;gBACnD,KAAK,CAAC,WAAW,GAAG,OAAO,CAAC;gBAC5B,KAAK,CAAC,YAAY,IAAI,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC;gBAE3C,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC;gBAEnC,yDAAyD;gBACzD,IAAI,IAAI,EAAE,MAAM,KAAK,UAAU,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;oBAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;oBAEhC,4BAA4B;oBAC5B,MAAM,YAAY,GAAG,eAAe,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;oBAC3D,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;wBAC9B,WAAW,CAAC,IAAI,CAAC;4BACf,IAAI,EAAE,QAAQ;4BACd,MAAM,EAAE,QAAQ;4BAChB,KAAK,EAAE,SAAS,QAAQ,yBAAyB;yBAClD,CAAC,CAAC;wBACH,KAAK,CAAC,uBAAuB,EAAE,CAAC;wBAChC,SAAS;oBACX,CAAC;oBAED,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;oBACnC,IAAI,CAAC,IAAI,EAAE,CAAC;wBACV,WAAW,CAAC,IAAI,CAAC;4BACf,IAAI,EAAE,QAAQ;4BACd,MAAM,EAAE,QAAQ;4BAChB,KAAK,EAAE,kBAAkB,QAAQ,GAAG;yBACrC,CAAC,CAAC;wBACH,KAAK,CAAC,uBAAuB,EAAE,CAAC;wBAChC,SAAS;oBACX,CAAC;oBAED,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAA4B,CAAC;oBACnE,MAAM,IAAI,GAAG,MAAM,WAAW,CAC5B,IAAI,EACJ,MAAM,EACN;wBACE,SAAS;wBACT,SAAS,EAAE,KAAK,CAAC,SAAS;wBAC1B,SAAS,EAAE,GAAG,CAAC,IAAI;qBACpB,EACD;wBACE,KAAK;wBACL,WAAW,EAAE,MAAM;wBACnB,eAAe,EAAE,GAAG,CAAC,SAAS,IAAI,GAAG;qBACtC,CACF,CAAC;oBAEF,YAAY,CACV,MAAM,CAAC,KAAK,EACZ,SAAS,EACT,IAAI,CAAC,MAAM,EACX,KAAK,CAAC,SAAS,EACf,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,UAAU,CAChB,CAAC;oBAEF,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBAC9B,KAAK,CAAC,cAAc,EAAE,CAAC;oBAEvB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;wBACpC,KAAK,CAAC,uBAAuB,EAAE,CAAC;oBAClC,CAAC;yBAAM,CAAC;wBACN,KAAK,CAAC,uBAAuB,GAAG,CAAC,CAAC;oBACpC,CAAC;oBAED,SAAS,CAAC,iBAAiB;gBAC7B,CAAC;gBAED,yDAAyD;gBACzD,MAAM,IAAI,GACR,OAAO,CAAC,UAAU,EAAE,aAAa,IAAI,OAAO,CAAC,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC;gBAExE,4BAA4B;gBAC5B,IAAI,aAAa,IAAI,cAAc,EAAE,CAAC;oBACpC,MAAM,GAAG,GAAG,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;oBAC3D,IACE,GAAG,IAAI,CAAC;wBACR,CAAC,aAAa,CAAC,iBAAiB,CAAC,QAAQ,CAAC,cAAc,CAAC,EACzD,CAAC;wBACD,aAAa,CAAC,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;wBACrD,MAAM,WAAW,GAAG,aAAa,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;wBACpD,aAAa,CAAC,cAAc,GAAG,WAAW,IAAI,cAAc,CAAC;wBAC7D,aAAa,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;wBACrC,MAAM,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;wBACxD,mBAAmB,CACjB,MAAM,CAAC,KAAK,EACZ,SAAS,EACT,cAAc,EACd,GAAG,EACH,aAAa,CAAC,QAAQ,CAAC,MAAM,CAC9B,CAAC;oBACJ,CAAC;gBACH,CAAC;gBAED,oBAAoB;gBACpB,MAAM,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE;oBACpC,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,SAAS,EAAE,OAAO;iBACnB,CAAC,CAAC;gBACH,MAAM,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE;oBACpC,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,IAAI;oBACb,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;iBACtB,CAAC,CAAC;gBAEH,MAAM,WAAW,GACf,IAAI,EAAE,MAAM,KAAK,SAAS;oBACxB,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,UAAU;wBAC3B,CAAC,CAAC,UAAU;wBACZ,CAAC,CAAC,UAAU,CAAC;gBAEnB,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC;gBAC3B,OAAO,WAAW,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE;oBACjE,IAAI;oBACJ,SAAS,EAAE,WAAW;iBACvB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAClE,cAAc,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;YAC/C,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC;YAC3B,OAAO,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE;gBAC7D,IAAI,EAAE,iDAAiD;gBACvD,KAAK,EAAE,KAAK,CAAC,OAAO;aACrB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,UAAU,IAAI,CAAC,SAAiB;QACnC,MAAM,KAAK,GAAG,MAAM,QAAQ,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,IAAI,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC/C,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,UAAU,KAAK,CAAC,SAAiB;QACpC,MAAM,KAAK,GAAG,MAAM,QAAQ,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,IAAI,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC/C,MAAM,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,UAAU,MAAM,CAAC,SAAiB;QACrC,MAAM,KAAK,GAAG,MAAM,QAAQ,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,IAAI,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC/C,MAAM,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AACzC,CAAC;AAED,iEAAiE;AAEjE,SAAS,WAAW,CAClB,IAAyB,EACzB,SAAiB,EACjB,MAAc,EACd,KAAe,EACf,OAAe,EACf,QAA8B,EAAE;IAEhC,OAAO;QACL,IAAI;QACJ,SAAS;QACT,MAAM;QACN,OAAO,EAAE;YACP,UAAU,EAAE,KAAK,CAAC,SAAS;YAC3B,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;YAChC,cAAc,EAAE,KAAK,CAAC,cAAc;SACrC;QACD,GAAG,KAAK;KACT,CAAC;AACJ,CAAC"}

package/dist/core/types.d.ts

@@ -0,0 +1,310 @@
+/**
+ * msm-mini — Core Types
+ *
+ * All contracts for the lite agent runtime. Brain-agnostic, zero embedded
+ * databases. Application layer owns persistence; agent owns the loop.
+ */
+/**
+ * A single memory entry — assembled by msm-context or by the app directly.
+ * The agent injects these into every brain call in priority order.
+ */
+export interface MemoryEntry {
+    /** Tier/source identifier, e.g. "ground_truth", "project", "user_notes" */
+    source: string;
+    /** The text chunk to inject into the brain prompt */
+    content: string;
+    /** Similarity score 0–1 (higher = more relevant) */
+    score: number;
+    /** Estimated token count (used by context budget enforcement) */
+    tokenCount?: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Injected context — assembled by the app or msm-context before calling agent.handle().
+ * The agent never queries external stores directly; it receives ready context here.
+ */
+export interface AgentContext {
+    /**
+     * Optional system prompt prefix — prepended to the agent's own persona/capabilities block.
+     * Use to inject study type, company profile, or session-specific instructions.
+     */
+    systemPrompt?: string;
+    /** Ordered memory entries (highest priority first). Injected into every brain call. */
+    memories?: MemoryEntry[];
+    /** Arbitrary user/profile facts — passed through to the brain prompt verbatim. */
+    userProfile?: Record<string, unknown>;
+    /** App-specific fields — passed through unchanged, not used by the loop itself. */
+    customFields?: Record<string, unknown>;
+}
+export interface AgentEvent {
+    sessionId: string;
+    /** The user's message */
+    message: string;
+    /**
+     * Pre-assembled context from msm-context or the app layer.
+     * Not required — agent works without context injection.
+     */
+    context?: AgentContext;
+    /** Optional: resume a task that was previously killed or interrupted */
+    resumeTaskId?: string;
+}
+/** A single role+content message in conversation history */
+export interface Message {
+    role: "user" | "assistant" | "system" | "tool";
+    content: string;
+    toolName?: string;
+    toolCallId?: string;
+    timestamp?: number;
+}
+/** Tool definition passed to the brain so it knows what to call */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, ToolParameter>;
+    destructive?: boolean;
+    requiresApproval?: boolean;
+    category?: string;
+}
+export interface ToolParameter {
+    type: "string" | "number" | "boolean" | "object" | "array";
+    description: string;
+    required?: boolean;
+    enum?: string[];
+    default?: unknown;
+}
+/** Input the loop hands to every brain call */
+export interface BrainRunInput {
+    /** Raw user message */
+    raw: string;
+    /** Assembled system context (persona + memories + tools + history) */
+    system_context: string;
+    /** Conversation history for this session */
+    history: Message[];
+    /** Tool results from previous iteration, if any */
+    tool_results?: ToolResult[];
+    /** Available tool definitions */
+    tools: ToolDefinition[];
+}
+export interface BrainOrchestration {
+    action: "use_tool" | "respond" | "clarify" | "escalate" | "delegate";
+    confidence: number;
+    tool_name?: string;
+    tool_params?: Record<string, unknown>;
+    reasoning?: string;
+    [key: string]: unknown;
+}
+export interface BrainGeneration {
+    response_text: string;
+    response_text_ar?: string;
+    [key: string]: unknown;
+}
+/** The payload every brain implementation must return */
+export interface BrainPayload {
+    orchestration?: BrainOrchestration;
+    generation?: BrainGeneration;
+    /** Direct final output (alternative to generation.response_text) */
+    final_output?: {
+        text: string;
+    };
+    /** Reported cost in USD for this call (for cost accumulator) */
+    costUsd?: number;
+    /** Token usage from the brain */
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+    };
+    [key: string]: unknown;
+}
+/** The Brain interface — any model that implements this works with msm-mini */
+export interface Brain {
+    name: string;
+    run(input: BrainRunInput): Promise<BrainPayload>;
+}
+export interface ToolResult {
+    tool: string;
+    status: "ok" | "failed";
+    result?: Record<string, unknown>;
+    error?: string;
+}
+export interface ToolMeta {
+    sessionId: string;
+    iteration: number;
+    agentName: string;
+}
+/**
+ * A tool passed explicitly by the app. No registries — every tool the agent
+ * can call is declared at createAgent() time.
+ */
+export interface Tool {
+    name: string;
+    description: string;
+    /** Zod schema or JSON Schema object — used for parameter validation */
+    parameters: Record<string, ToolParameter>;
+    /** Tool requires human approval before execution */
+    requiresApproval?: boolean;
+    execute(args: Record<string, unknown>, meta: ToolMeta): Promise<ToolResult>;
+}
+export type GuardSignalType = "budget_iterations" | "budget_cost" | "budget_timeout" | "budget_tool_calls" | "confidence_low" | "task_killed" | "tenant_paused" | "tool_disabled" | "consecutive_failures";
+export interface GuardSignal {
+    type: GuardSignalType;
+    hard: boolean;
+    message: string;
+    /** Action the loop should take when this guard fires */
+    action?: "force_respond" | "clarify" | "escalate" | "abort";
+}
+export interface RunState {
+    sessionId: string;
+    taskId: string;
+    iteration: number;
+    startedAt: number;
+    totalCostUsd: number;
+    totalToolCalls: number;
+    consecutiveToolFailures: number;
+    /** Last brain payload (for force-respond on budget exhaustion) */
+    lastPayload?: BrainPayload;
+}
+export type OutcomeType = "response" | "tool_calls" | "error" | "clarify" | "escalate" | "suppressed";
+export interface LoopOutcome {
+    type: OutcomeType;
+    sessionId: string;
+    taskId: string;
+    text?: string;
+    text_ar?: string;
+    toolCalls?: ToolResult[];
+    metrics: {
+        iterations: number;
+        totalCostUsd: number;
+        durationMs: number;
+        totalToolCalls: number;
+    };
+    /** Guard that terminated the loop, if any */
+    terminatedBy?: GuardSignalType;
+    error?: string;
+}
+/**
+ * Lightweight section tracker for document-generation agents.
+ * Stored in Redis as session:{id}:document — survives session interruption.
+ */
+export interface DocumentState {
+    /** Ordered section list from agent definition ## Sections block */
+    sections: string[];
+    currentSection: string;
+    completedSections: string[];
+    /** Partial content of the section currently being drafted */
+    draftBuffer: string;
+    startedAt: number;
+    updatedAt: number;
+}
+export interface RedisConfig {
+    url: string;
+    /** Key prefix (default: "msm") */
+    prefix?: string;
+    ttl?: {
+        /** Session history TTL seconds (default: 86400 = 24h) */
+        history?: number;
+        /** Tool dedup TTL seconds (default: 300 = 5 min) */
+        toolDedup?: number;
+        /** Document state TTL seconds (default: 14400 = 4h) */
+        document?: number;
+    };
+}
+export interface GuardConfig {
+    maxIterations?: number;
+    costCapPerTask?: number;
+    timeoutMs?: number;
+    confidenceThreshold?: number;
+    maxToolCallsPerTask?: number;
+    maxConsecutiveFailures?: number;
+}
+export interface GateConfig {
+    /** Enable acknowledgement suppression gate (default: true) */
+    acknowledgement?: boolean;
+    /** Business hours gate — disabled by default */
+    businessHours?: {
+        days: Array<"sun" | "mon" | "tue" | "wed" | "thu" | "fri" | "sat">;
+        from: string;
+        to: string;
+        timezone: string;
+        closedMessage?: string;
+    };
+}
+export interface AgentConfig {
+    /** Path to .md definition file or pre-parsed AgentDefinition object */
+    definition: string | AgentDefinition;
+    brain: Brain;
+    redis: RedisConfig;
+    /** App-provided tools — agent can only call tools listed here */
+    tools: Tool[];
+    guards?: GuardConfig;
+    gates?: GateConfig;
+    hooks?: AgentHooks;
+}
+export interface IterationInfo {
+    sessionId: string;
+    iteration: number;
+    maxIterations: number;
+    currentSection?: string;
+    totalCostUsd: number;
+    elapsedMs: number;
+}
+export interface SectionInfo {
+    sessionId: string;
+    sectionName: string;
+    sectionIndex: number;
+    totalSections: number;
+    completedAt: number;
+}
+export interface ToolCallInfo {
+    sessionId: string;
+    toolName: string;
+    iteration: number;
+    cached: boolean;
+    durationMs: number;
+    status: "ok" | "failed";
+}
+export interface GuardFiredInfo {
+    sessionId: string;
+    signal: GuardSignal;
+    iteration: number;
+}
+export interface AgentHooks {
+    onIteration?: (info: IterationInfo) => void;
+    onSectionComplete?: (info: SectionInfo) => void;
+    onToolCall?: (info: ToolCallInfo) => void;
+    onGuard?: (info: GuardFiredInfo) => void;
+    onFatalError?: (error: Error, sessionId: string) => void;
+}
+export interface AgentDefinition {
+    name: string;
+    domain?: string;
+    language?: string;
+    persona: {
+        name?: string;
+        style?: string;
+        [key: string]: unknown;
+    };
+    brain: {
+        provider: "openai" | "anthropic" | "ollama" | "gemini" | "custom";
+        model: string;
+        endpoint?: string;
+        apiKey?: string;
+        [key: string]: unknown;
+    };
+    capabilities: string[];
+    limits: {
+        maxIterations: number;
+        costCapPerTask: number;
+        timeoutMs: number;
+        confidenceThreshold: number;
+        maxConsecutiveFailures?: number;
+    };
+    /** Ordered section list for document-generation agents */
+    sections?: string[];
+}
+export interface Agent {
+    handle(event: AgentEvent): Promise<LoopOutcome>;
+    kill(sessionId: string): Promise<void>;
+    pause(sessionId: string): Promise<void>;
+    resume(sessionId: string): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAID,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAID,4DAA4D;AAC5D,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,mEAAmE;AACnE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC1C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,sEAAsE;IACtE,cAAc,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,mDAAmD;IACnD,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC;IAC5B,iCAAiC;IACjC,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,yDAAyD;AACzD,MAAM,WAAW,YAAY;IAC3B,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,oEAAoE;IACpE,YAAY,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,KAAK,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,+EAA+E;AAC/E,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAClD;AAID,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,IAAI,GAAG,QAAQ,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC1C,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC7E;AAID,MAAM,MAAM,eAAe,GACvB,mBAAmB,GACnB,aAAa,GACb,gBAAgB,GAChB,mBAAmB,GACnB,gBAAgB,GAChB,aAAa,GACb,eAAe,GACf,eAAe,GACf,sBAAsB,CAAC;AAE3B,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,MAAM,CAAC,EAAE,eAAe,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;CAC7D;AAID,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,uBAAuB,EAAE,MAAM,CAAC;IAChC,kEAAkE;IAClE,WAAW,CAAC,EAAE,YAAY,CAAC;CAC5B;AAID,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,CAAC;AAEtG,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC;IACzB,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,6CAA6C;IAC7C,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE;QACJ,yDAAyD;QACzD,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,oDAAoD;QACpD,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,uDAAuD;QACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,UAAU;IACzB,8DAA8D;IAC9D,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gDAAgD;IAChD,aAAa,CAAC,EAAE;QACd,IAAI,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC,CAAC;QACnE,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,uEAAuE;IACvE,UAAU,EAAE,MAAM,GAAG,eAAe,CAAC;IACrC,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;IACnB,iEAAiE;IACjE,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAID,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,IAAI,GAAG,QAAQ,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;IAC5C,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;IAChD,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;IAC1C,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;IACzC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1D;AAID,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,KAAK,EAAE;QACL,QAAQ,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;QAClE,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE;QACN,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,sBAAsB,CAAC,EAAE,MAAM,CAAC;KACjC,CAAC;IACF,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAID,MAAM,WAAW,KAAK;IACpB,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAChD,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C"}

package/dist/core/types.js

@@ -0,0 +1,8 @@
+/**
+ * msm-mini — Core Types
+ *
+ * All contracts for the lite agent runtime. Brain-agnostic, zero embedded
+ * databases. Application layer owns persistence; agent owns the loop.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/definition/parser.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 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 type { AgentDefinition } from "../core/types.js";
+/**
+ * Parse an agent definition from a .md file path or raw markdown string.
+ */
+export declare function parseDefinition(input: string): AgentDefinition;
+//# sourceMappingURL=parser.d.ts.map

package/dist/definition/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/definition/parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAM9D"}