@msm-core/mini 0.1.0

package/README.md

@@ -0,0 +1,297 @@
+# @msm-core/mini
+
+> Portable AI agent execution loop — brain-agnostic, stateless, zero embedded databases.
+
+`@msm-core/mini` is the execution engine extracted from [`msm-agent`](https://github.com/msm-core/agent). It owns only the **loop** — brain calls, tool dispatch, guards, and session state in Redis. Everything else (memory, RAG, channels) belongs to your application.
+
+---
+
+## Install
+
+```bash
+npm install @msm-core/mini
+# peer deps — install only the ones you use:
+npm install openai                    # OpenAI / compatible (Gemini, etc.)
+npm install @anthropic-ai/sdk         # Anthropic
+npm install @google/generative-ai     # Google Gemini (native)
+npm install ioredis                   # required at runtime
+```
+
+---
+
+## Quick Start
+
+```typescript
+import {
+  createAgent,
+  createGeminiBrain,
+  parseDefinition,
+} from "@msm-core/mini";
+
+const brain = createGeminiBrain({ model: "gemini-2.5-flash" });
+
+const agent = createAgent({
+  definition: "./agent.md", // or a parsed AgentDefinition object
+  brain,
+  redis: { url: process.env.REDIS_URL! },
+  tools: [
+    {
+      name: "search_kb",
+      description: "Search the knowledge base",
+      parameters: {
+        query: { type: "string", description: "Search query", required: true },
+      },
+      async execute(args) {
+        const results = await myKb.search(String(args.query));
+        return { status: "ok", result: { results } };
+      },
+    },
+  ],
+});
+
+const outcome = await agent.handle({
+  sessionId: "user-123",
+  message: "What is the market size for solar in Egypt?",
+  context: {
+    memories: assembledContext, // from @msm-core/context
+    userProfile: { country: "EG", language: "ar" },
+  },
+});
+
+console.log(outcome.text);
+```
+
+---
+
+## Agent Definition File
+
+Create a Markdown file (`agent.md`) that the parser reads at startup:
+
+```markdown
+# Feasibility Analyst
+
+domain: feasibility
+language: ar
+
+## Persona
+
+name: Jarvis
+style: professional, concise
+
+## Brain
+
+provider: gemini
+model: gemini-2.5-flash
+
+## Capabilities
+
+- Conduct investment feasibility studies
+- Analyze financial projections
+- Retrieve and synthesize research documents
+
+## Limits
+
+maxIterations: 40
+costCapPerTask: 1.50
+timeoutMs: 600000
+
+## Sections
+
+- Executive Summary
+- Market Analysis
+- Financial Projections
+- Risk Assessment
+- Recommendations
+```
+
+Supported providers: `openai` | `anthropic` | `gemini` | `ollama`
+
+---
+
+## Context Injection
+
+The agent never queries external stores — your app assembles context before each call and passes it in `AgentEvent.context`. Use [`@msm-core/context`](../context/README.md) to do this automatically.
+
+```typescript
+import { createContextAssembler } from "@msm-core/context";
+import { QdrantAdapter } from "@msm-core/context/adapters";
+
+const assembler = createContextAssembler({
+  tiers: [{ name: "kb", priority: 1, adapters: [qdrantAdapter] }],
+  budget: { maxTokens: 6000 },
+});
+
+// In your request handler:
+const ctx = await assembler.build({ text: userMessage, sessionId });
+const outcome = await agent.handle({
+  sessionId,
+  message: userMessage,
+  context: {
+    memories: ctx.results.map((r) => ({
+      source: r.source,
+      content: r.content,
+      score: r.score,
+    })),
+  },
+});
+```
+
+---
+
+## Brains
+
+| Factory                      | Provider                    | Env var             |
+| ---------------------------- | --------------------------- | ------------------- |
+| `createGeminiBrain(opts)`    | Google Gemini               | `GEMINI_API_KEY`    |
+| `createOpenAIBrain(opts)`    | OpenAI / compatible         | `OPENAI_API_KEY`    |
+| `createAnthropicBrain(opts)` | Anthropic Claude            | `ANTHROPIC_API_KEY` |
+| `createOllamaBrain(opts)`    | Ollama (local)              | —                   |
+| `buildBrain(def)`            | Auto-select from definition | —                   |
+
+`buildBrain(definition)` reads the `## Brain` section of an `AgentDefinition` and returns the correct brain automatically.
+
+---
+
+## HTTP Server
+
+Wrap any agent with a minimal HTTP server for internal service-to-service calls:
+
+```typescript
+import { createAgentServer } from "@msm-core/mini";
+
+const server = createAgentServer(agent, { port: 4001 });
+await server.start();
+// GET  /health      → { ok: true, uptime: N }
+// POST /v1/event    → { sessionId, message } → LoopOutcome JSON
+```
+
+---
+
+## Guards
+
+Guards are hard limits that terminate the loop and return a forced response. Configure in the agent definition `## Limits` section or override in code:
+
+| Guard                    | Default    | Description                             |
+| ------------------------ | ---------- | --------------------------------------- |
+| `maxIterations`          | 60         | Max brain-call iterations per task      |
+| `costCapPerTask`         | $2.50      | Max spend per task (USD)                |
+| `timeoutMs`              | 900 000 ms | Wall-clock timeout                      |
+| `maxToolCallsPerTask`    | 200        | Max tool invocations                    |
+| `maxConsecutiveFailures` | 3          | Abort after N consecutive tool failures |
+
+---
+
+## Redis Schema
+
+```
+session:{prefix}:{id}:history      # Message history (TTL: 24h)
+session:{prefix}:{id}:metadata     # Iteration count, cost accumulator
+session:{prefix}:{id}:tools:dedup  # Tool-call dedup cache (TTL: 5min)
+agent:{prefix}:control:{id}        # Kill/pause signal
+```
+
+No long-term storage — Redis is ephemeral session cache only. Your app owns persistence.
+
+---
+
+## Architecture
+
+```
+Your App
+  │
+  ├── assembles context (via @msm-core/context)
+  ├── calls agent.handle({ sessionId, message, context })
+  │
+  └── @msm-core/mini
+        ├── gates (ack, business hours)
+        ├── session lock (Redis distributed)
+        ├── context builder (persona + memories + tools + history)
+        ├── brain call (Gemini / OpenAI / Anthropic / Ollama)
+        ├── guards (iterations, cost, timeout, failures)
+        └── tool executor (validate → dedup check → execute → record)
+              │
+              └── Your Tools (passed explicitly — no registries)
+```
+
+---
+
+## API Reference
+
+### `createAgent(config)`
+
+```typescript
+interface AgentConfig {
+  definition: string | AgentDefinition; // .md file path or parsed object
+  brain: Brain; // from createGeminiBrain() etc.
+  redis: {
+    url: string;
+    prefix?: string; // key namespace (default: "msm")
+    ttl?: { history?: number; document?: number };
+  };
+  tools: Tool[];
+  guards?: Partial<GuardConfig>;
+  gates?: GateConfig;
+  hooks?: AgentHooks; // lifecycle callbacks
+}
+```
+
+### `agent.handle(event)`
+
+```typescript
+interface AgentEvent {
+  sessionId: string;
+  message: string;
+  context?: {
+    systemPrompt?: string;
+    memories?: MemoryEntry[];
+    userProfile?: Record<string, unknown>;
+    customFields?: Record<string, unknown>;
+  };
+}
+// Returns: Promise<LoopOutcome>
+```
+
+### `LoopOutcome`
+
+```typescript
+interface LoopOutcome {
+  type:
+    | "response"
+    | "tool_calls"
+    | "error"
+    | "clarify"
+    | "escalate"
+    | "suppressed";
+  sessionId: string;
+  taskId: string;
+  text?: string;
+  metrics: {
+    iterations: number;
+    totalCostUsd: number;
+    durationMs: number;
+    totalToolCalls: number;
+  };
+  terminatedBy?: string; // guard type that ended the loop, if any
+}
+```
+
+---
+
+## Migrating from `msm-agent`
+
+| msm-agent                       | @msm-core/mini                                  |
+| ------------------------------- | ----------------------------------------------- |
+| `loadAgent(path)`               | `parseDefinition(path)`                         |
+| `SQLiteMemoryAdapter`           | ❌ removed — app owns DB                        |
+| `MongoMemoryAdapter`            | ❌ removed — app owns DB                        |
+| `QdrantKnowledgeAdapter`        | Use `@msm-core/context` + `QdrantAdapter`       |
+| `SkillRegistry.register(skill)` | Pass tools directly to `createAgent({ tools })` |
+| `createAgentHub(...)`           | ❌ removed                                      |
+| `createMcpServer(...)`          | ❌ removed                                      |
+| `ManualEventAdapter`            | Call `agent.handle()` directly                  |
+
+---
+
+## License
+
+MIT

package/dist/adapters/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Adapters barrel — re-exports all adapter classes for convenience.
+ */
+export { RedisMemory, connectRedis } from "./redis-memory.js";
+export type { SessionMetadata } from "./redis-memory.js";
+export { RedisControlBus } from "./redis-control.js";
+export { RedisDistributedLock } from "./redis-lock.js";
+export type { LockHandle } from "./redis-lock.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC9D,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/adapters/index.js

@@ -0,0 +1,7 @@
+/**
+ * Adapters barrel — re-exports all adapter classes for convenience.
+ */
+export { RedisMemory, connectRedis } from "./redis-memory.js";
+export { RedisControlBus } from "./redis-control.js";
+export { RedisDistributedLock } from "./redis-lock.js";
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/adapters/redis-control.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Redis Control Bus — Kill / pause / disable-tool commands.
+ *
+ * Keys:
+ *   {prefix}:agent:control:{sessionId}   → "kill" | "pause" | "disabled:{toolName}"
+ *
+ * Checked on every loop iteration before the brain call.
+ */
+import type { RedisLike } from "./redis-types.js";
+export declare class RedisControlBus {
+    private readonly redis;
+    private readonly prefix;
+    constructor(redis: RedisLike, prefix?: string);
+    private controlKey;
+    /** Read the current control command for a session. Returns null if none. */
+    getCommand(sessionId: string): Promise<string | null>;
+    kill(sessionId: string, reason?: string): Promise<void>;
+    pause(sessionId: string): Promise<void>;
+    resume(sessionId: string): Promise<void>;
+    disableTool(sessionId: string, toolName: string): Promise<void>;
+    clear(sessionId: string): Promise<void>;
+    /** Returns the disabled tool name if the command is disable, else null */
+    static disabledTool(command: string | null): string | null;
+}
+//# sourceMappingURL=redis-control.d.ts.map

package/dist/adapters/redis-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-control.d.ts","sourceRoot":"","sources":["../../src/adapters/redis-control.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAIlD,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,KAAK,EAAE,SAAS,EAChB,MAAM,GAAE,MAAc;IAGzC,OAAO,CAAC,UAAU;IAIlB,4EAA4E;IACtE,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIrD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,SAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,0EAA0E;IAC1E,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI;CAI3D"}

package/dist/adapters/redis-control.js

@@ -0,0 +1,48 @@
+/**
+ * Redis Control Bus — Kill / pause / disable-tool commands.
+ *
+ * Keys:
+ *   {prefix}:agent:control:{sessionId}   → "kill" | "pause" | "disabled:{toolName}"
+ *
+ * Checked on every loop iteration before the brain call.
+ */
+const KILLED_TTL = 7 * 24 * 60 * 60; // 7 days
+export class RedisControlBus {
+    redis;
+    prefix;
+    constructor(redis, prefix = "msm") {
+        this.redis = redis;
+        this.prefix = prefix;
+    }
+    controlKey(sessionId) {
+        return `${this.prefix}:agent:control:${sessionId}`;
+    }
+    /** Read the current control command for a session. Returns null if none. */
+    async getCommand(sessionId) {
+        return this.redis.get(this.controlKey(sessionId));
+    }
+    async kill(sessionId, reason = "killed") {
+        await this.redis.setex(this.controlKey(sessionId), KILLED_TTL, `kill:${reason}`);
+    }
+    async pause(sessionId) {
+        await this.redis.set(this.controlKey(sessionId), "pause");
+    }
+    async resume(sessionId) {
+        const cmd = await this.getCommand(sessionId);
+        if (cmd === "pause")
+            await this.redis.del(this.controlKey(sessionId));
+    }
+    async disableTool(sessionId, toolName) {
+        await this.redis.set(this.controlKey(sessionId), `disabled:${toolName}`);
+    }
+    async clear(sessionId) {
+        await this.redis.del(this.controlKey(sessionId));
+    }
+    /** Returns the disabled tool name if the command is disable, else null */
+    static disabledTool(command) {
+        if (!command?.startsWith("disabled:"))
+            return null;
+        return command.slice("disabled:".length);
+    }
+}
+//# sourceMappingURL=redis-control.js.map

package/dist/adapters/redis-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-control.js","sourceRoot":"","sources":["../../src/adapters/redis-control.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,SAAS;AAE9C,MAAM,OAAO,eAAe;IAEP;IACA;IAFnB,YACmB,KAAgB,EAChB,SAAiB,KAAK;QADtB,UAAK,GAAL,KAAK,CAAW;QAChB,WAAM,GAAN,MAAM,CAAgB;IACtC,CAAC;IAEI,UAAU,CAAC,SAAiB;QAClC,OAAO,GAAG,IAAI,CAAC,MAAM,kBAAkB,SAAS,EAAE,CAAC;IACrD,CAAC;IAED,4EAA4E;IAC5E,KAAK,CAAC,UAAU,CAAC,SAAiB;QAChC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAiB,EAAE,MAAM,GAAG,QAAQ;QAC7C,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,QAAQ,MAAM,EAAE,CAAC,CAAC;IACnF,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,SAAiB;QAC3B,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,SAAiB;QAC5B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,GAAG,KAAK,OAAO;YAAE,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,SAAiB,EAAE,QAAgB;QACnD,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,YAAY,QAAQ,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,SAAiB;QAC3B,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,0EAA0E;IAC1E,MAAM,CAAC,YAAY,CAAC,OAAsB;QACxC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC;YAAE,OAAO,IAAI,CAAC;QACnD,OAAO,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/dist/adapters/redis-lock.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Redis Distributed Lock — Atomic session mutex.
+ *
+ * Uses SET NX PX (atomic set-if-not-exists with TTL).
+ * Returns a LockHandle with release() and extend() for long operations.
+ *
+ * Key: {prefix}:session:{id}:lock
+ * TTL: timeoutMs + 30s safety margin
+ */
+import type { RedisLike } from "./redis-types.js";
+export interface LockHandle {
+    release(): Promise<void>;
+    extend(ttlMs: number): Promise<boolean>;
+}
+export declare class RedisDistributedLock {
+    private readonly redis;
+    private readonly prefix;
+    constructor(redis: RedisLike, prefix?: string);
+    private lockKey;
+    /**
+     * Attempt to acquire the lock.
+     * Returns a LockHandle on success, or null if already held.
+     */
+    acquire(sessionId: string, ttlMs: number): Promise<LockHandle | null>;
+    /**
+     * Acquire with retry (exponential backoff).
+     * Throws if the lock cannot be acquired within `waitMs`.
+     */
+    acquireWithRetry(sessionId: string, ttlMs: number, waitMs?: number, retryInterval?: number): Promise<LockHandle>;
+}
+//# sourceMappingURL=redis-lock.d.ts.map

package/dist/adapters/redis-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-lock.d.ts","sourceRoot":"","sources":["../../src/adapters/redis-lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAkBlD,MAAM,WAAW,UAAU;IACzB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzC;AAED,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,KAAK,EAAE,SAAS,EAChB,MAAM,GAAE,MAAc;IAGzC,OAAO,CAAC,OAAO;IAIf;;;OAGG;IACG,OAAO,CACX,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAiB7B;;;OAGG;IACG,gBAAgB,CACpB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,MAAM,SAAO,EACb,aAAa,SAAM,GAClB,OAAO,CAAC,UAAU,CAAC;CASvB"}

package/dist/adapters/redis-lock.js

@@ -0,0 +1,73 @@
+/**
+ * Redis Distributed Lock — Atomic session mutex.
+ *
+ * Uses SET NX PX (atomic set-if-not-exists with TTL).
+ * Returns a LockHandle with release() and extend() for long operations.
+ *
+ * Key: {prefix}:session:{id}:lock
+ * TTL: timeoutMs + 30s safety margin
+ */
+import { randomBytes } from "crypto";
+const RELEASE_SCRIPT = `
+  if redis.call("get", KEYS[1]) == ARGV[1] then
+    return redis.call("del", KEYS[1])
+  else
+    return 0
+  end
+`;
+const EXTEND_SCRIPT = `
+  if redis.call("get", KEYS[1]) == ARGV[1] then
+    return redis.call("pexpire", KEYS[1], ARGV[2])
+  else
+    return 0
+  end
+`;
+export class RedisDistributedLock {
+    redis;
+    prefix;
+    constructor(redis, prefix = "msm") {
+        this.redis = redis;
+        this.prefix = prefix;
+    }
+    lockKey(sessionId) {
+        return `${this.prefix}:session:${sessionId}:lock`;
+    }
+    /**
+     * Attempt to acquire the lock.
+     * Returns a LockHandle on success, or null if already held.
+     */
+    async acquire(sessionId, ttlMs) {
+        const key = this.lockKey(sessionId);
+        const token = randomBytes(16).toString("hex");
+        const result = await this.redis.set(key, token, "PX", ttlMs, "NX");
+        if (!result)
+            return null;
+        return {
+            release: async () => {
+                await this.redis.eval(RELEASE_SCRIPT, 1, key, token);
+            },
+            extend: async (newTtlMs) => {
+                const r = await this.redis.eval(EXTEND_SCRIPT, 1, key, token, String(newTtlMs));
+                return r === 1;
+            },
+        };
+    }
+    /**
+     * Acquire with retry (exponential backoff).
+     * Throws if the lock cannot be acquired within `waitMs`.
+     */
+    async acquireWithRetry(sessionId, ttlMs, waitMs = 5000, retryInterval = 100) {
+        const deadline = Date.now() + waitMs;
+        while (Date.now() < deadline) {
+            const handle = await this.acquire(sessionId, ttlMs);
+            if (handle)
+                return handle;
+            await sleep(retryInterval + Math.random() * 50);
+        }
+        throw new Error(`msm-mini: could not acquire lock for session ${sessionId} within ${waitMs}ms`);
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=redis-lock.js.map

package/dist/adapters/redis-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-lock.js","sourceRoot":"","sources":["../../src/adapters/redis-lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAGrC,MAAM,cAAc,GAAG;;;;;;CAMtB,CAAC;AAEF,MAAM,aAAa,GAAG;;;;;;CAMrB,CAAC;AAOF,MAAM,OAAO,oBAAoB;IAEZ;IACA;IAFnB,YACmB,KAAgB,EAChB,SAAiB,KAAK;QADtB,UAAK,GAAL,KAAK,CAAW;QAChB,WAAM,GAAN,MAAM,CAAgB;IACtC,CAAC;IAEI,OAAO,CAAC,SAAiB;QAC/B,OAAO,GAAG,IAAI,CAAC,MAAM,YAAY,SAAS,OAAO,CAAC;IACpD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CACX,SAAiB,EACjB,KAAa;QAEb,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QACnE,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEzB,OAAO;YACL,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YACvD,CAAC;YACD,MAAM,EAAE,KAAK,EAAE,QAAgB,EAAE,EAAE;gBACjC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAChF,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;SACF,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,gBAAgB,CACpB,SAAiB,EACjB,KAAa,EACb,MAAM,GAAG,IAAI,EACb,aAAa,GAAG,GAAG;QAEnB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC;QACrC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YACpD,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAC;YAC1B,MAAM,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAClD,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,gDAAgD,SAAS,WAAW,MAAM,IAAI,CAAC,CAAC;IAClG,CAAC;CACF;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/adapters/redis-memory.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Redis Memory Adapter — Session history, metadata, document state.
+ *
+ * The only memory store in msm-mini. All long-term persistence stays
+ * in the application layer.
+ *
+ * Keys (all prefixed with config.prefix):
+ *   {prefix}:session:{id}:history    JSON array, TTL 24h
+ *   {prefix}:session:{id}:metadata   JSON object, TTL 24h
+ *   {prefix}:session:{id}:document   JSON object, TTL 4h
+ */
+import type { Message, DocumentState } from "../core/types.js";
+import type { RedisLike } from "./redis-types.js";
+export interface SessionMetadata {
+    iterationCount: number;
+    startedAt: number;
+    totalCostUsd: number;
+    status: "running" | "completed" | "failed" | "killed";
+}
+export declare class RedisMemory {
+    private readonly redis;
+    private readonly prefix;
+    private readonly historyTtl;
+    private readonly documentTtl;
+    constructor(redis: RedisLike, opts?: {
+        prefix?: string;
+        historyTtl?: number;
+        documentTtl?: number;
+    });
+    private historyKey;
+    private metaKey;
+    private documentKey;
+    appendHistory(sessionId: string, entry: Message): Promise<void>;
+    getHistory(sessionId: string, limit?: number): Promise<Message[]>;
+    getMetadata(sessionId: string): Promise<SessionMetadata | null>;
+    setMetadata(sessionId: string, meta: SessionMetadata): Promise<void>;
+    getDocumentState(sessionId: string): Promise<DocumentState | null>;
+    setDocumentState(sessionId: string, state: DocumentState): Promise<void>;
+}
+/** Connect to Redis using ioredis (peer dependency) */
+export declare function connectRedis(url: string): Promise<RedisLike>;
+//# sourceMappingURL=redis-memory.d.ts.map

package/dist/adapters/redis-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-memory.d.ts","sourceRoot":"","sources":["../../src/adapters/redis-memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;CACvD;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAGnC,KAAK,EAAE,SAAS,EAChB,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO;IAQ3E,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,WAAW;IAMb,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/D,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAc7D,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAU/D,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAUpE,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAUlE,gBAAgB,CACpB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,IAAI,CAAC;CAOjB;AAED,uDAAuD;AACvD,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAMlE"}

package/dist/adapters/redis-memory.js

@@ -0,0 +1,87 @@
+/**
+ * Redis Memory Adapter — Session history, metadata, document state.
+ *
+ * The only memory store in msm-mini. All long-term persistence stays
+ * in the application layer.
+ *
+ * Keys (all prefixed with config.prefix):
+ *   {prefix}:session:{id}:history    JSON array, TTL 24h
+ *   {prefix}:session:{id}:metadata   JSON object, TTL 24h
+ *   {prefix}:session:{id}:document   JSON object, TTL 4h
+ */
+export class RedisMemory {
+    redis;
+    prefix;
+    historyTtl;
+    documentTtl;
+    constructor(redis, opts = {}) {
+        this.redis = redis;
+        this.prefix = opts.prefix ?? "msm";
+        this.historyTtl = opts.historyTtl ?? 86_400;
+        this.documentTtl = opts.documentTtl ?? 14_400;
+    }
+    historyKey(sessionId) {
+        return `${this.prefix}:session:${sessionId}:history`;
+    }
+    metaKey(sessionId) {
+        return `${this.prefix}:session:${sessionId}:metadata`;
+    }
+    documentKey(sessionId) {
+        return `${this.prefix}:session:${sessionId}:document`;
+    }
+    // ─── History ──────────────────────────────────────────────
+    async appendHistory(sessionId, entry) {
+        const key = this.historyKey(sessionId);
+        await this.redis.rpush(key, JSON.stringify(entry));
+        await this.redis.expire(key, this.historyTtl);
+    }
+    async getHistory(sessionId, limit = 50) {
+        const key = this.historyKey(sessionId);
+        const raw = await this.redis.lrange(key, -limit, -1);
+        return raw.flatMap((r) => {
+            try {
+                return [JSON.parse(r)];
+            }
+            catch {
+                return [];
+            }
+        });
+    }
+    // ─── Metadata ─────────────────────────────────────────────
+    async getMetadata(sessionId) {
+        const raw = await this.redis.get(this.metaKey(sessionId));
+        if (!raw)
+            return null;
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    async setMetadata(sessionId, meta) {
+        await this.redis.setex(this.metaKey(sessionId), this.historyTtl, JSON.stringify(meta));
+    }
+    // ─── Document State (section tracker) ────────────────────
+    async getDocumentState(sessionId) {
+        const raw = await this.redis.get(this.documentKey(sessionId));
+        if (!raw)
+            return null;
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    async setDocumentState(sessionId, state) {
+        await this.redis.setex(this.documentKey(sessionId), this.documentTtl, JSON.stringify(state));
+    }
+}
+/** Connect to Redis using ioredis (peer dependency) */
+export async function connectRedis(url) {
+    const mod = await import("ioredis");
+    const Redis = (mod.default ?? mod);
+    return new Redis(url);
+}
+//# sourceMappingURL=redis-memory.js.map

package/dist/adapters/redis-memory.js.map

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