@nexalab/agent-sdk 0.1.0

package/dist/mcp.d.ts

@@ -0,0 +1,55 @@
+import type { LocalToolHandler } from "./local-tool-executor.js";
+import type { ToolDefinition } from "./tool-registry.js";
+import type { JsonObject, JsonValue } from "./types.js";
+export type McpTransport = {
+    send(message: JsonObject): Promise<void>;
+    onMessage(handler: (message: JsonObject) => void): void;
+    close(): Promise<void>;
+};
+export type StdioTransportConfig = {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+};
+export type HttpTransportConfig = {
+    url: string;
+    headers?: Record<string, string>;
+};
+export type McpConnectorConfig = StdioTransportConfig | HttpTransportConfig;
+export declare function createStdioTransport(config: StdioTransportConfig): McpTransport;
+export declare function createHttpTransport(config: HttpTransportConfig): McpTransport;
+export type McpToolInfo = {
+    name: string;
+    description?: string;
+    inputSchema?: JsonObject;
+};
+export declare class McpClient {
+    private readonly transport;
+    private readonly pending;
+    constructor(transport: McpTransport);
+    initialize(clientInfo?: {
+        name: string;
+        version: string;
+    }): Promise<JsonValue>;
+    listTools(): Promise<McpToolInfo[]>;
+    callTool(name: string, args: JsonObject): Promise<{
+        content: JsonValue;
+        isError: boolean;
+    }>;
+    close(): Promise<void>;
+    private handleMessage;
+    private request;
+    private notify;
+}
+export type McpToolRegistration = {
+    tool: ToolDefinition;
+    handler: LocalToolHandler;
+};
+export type McpConnection = {
+    client: McpClient;
+    discoverTools(): Promise<McpToolRegistration[]>;
+    close(): Promise<void>;
+};
+export declare function mcp(config: McpConnectorConfig): Promise<McpConnection>;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAuB,MAAM,oBAAoB,CAAC;AAC9E,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAC;IACxD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AACpH,MAAM,MAAM,mBAAmB,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AACpF,MAAM,MAAM,kBAAkB,GAAG,oBAAoB,GAAG,mBAAmB,CAAC;AAE5E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,YAAY,CAoC/E;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,YAAY,CA8B7E;AAED,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,UAAU,CAAA;CAAE,CAAC;AAE3F,qBAAa,SAAS;IAGR,OAAO,CAAC,QAAQ,CAAC,SAAS;IAFtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8F;gBAEzF,SAAS,EAAE,YAAY;IAI9C,UAAU,CAAC,UAAU,GAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAiD,GAAG,OAAO,CAAC,SAAS,CAAC;IAM5H,SAAS,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAKnC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,SAAS,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAK3F,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,OAAO,CAAC,aAAa;YAcP,OAAO;YAOP,MAAM;CAGrB;AAED,MAAM,MAAM,mBAAmB,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAEtF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,SAAS,CAAC;IAClB,aAAa,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAChD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC;AAEF,wBAAsB,GAAG,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAa5E"}

package/dist/mcp.js

@@ -0,0 +1,175 @@
+import { spawn } from "node:child_process";
+import { randomUUID } from "node:crypto";
+export function createStdioTransport(config) {
+    const child = spawn(config.command, config.args ?? [], {
+        env: { ...process.env, ...(config.env ?? {}) },
+        ...(config.cwd ? { cwd: config.cwd } : {})
+    });
+    const handlers = [];
+    let buffer = "";
+    child.stdout.on("data", (chunk) => {
+        buffer += chunk.toString("utf8");
+        const lines = buffer.split("\n");
+        buffer = lines.pop() ?? "";
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                const message = JSON.parse(trimmed);
+                for (const handler of handlers)
+                    handler(message);
+            }
+            catch {
+                continue;
+            }
+        }
+    });
+    return {
+        async send(message) {
+            await new Promise((resolvePromise, rejectPromise) => {
+                child.stdin.write(`${JSON.stringify(message)}\n`, (error) => (error ? rejectPromise(error) : resolvePromise()));
+            });
+        },
+        onMessage(handler) {
+            handlers.push(handler);
+        },
+        async close() {
+            child.kill();
+        }
+    };
+}
+export function createHttpTransport(config) {
+    const handlers = [];
+    return {
+        async send(message) {
+            const response = await fetch(config.url, {
+                method: "POST",
+                headers: { "content-type": "application/json", accept: "application/json, text/event-stream", ...(config.headers ?? {}) },
+                body: JSON.stringify(message)
+            });
+            if (!response.ok)
+                throw new Error(`MCP HTTP transport failed with status ${response.status}`);
+            if (response.status === 202)
+                return;
+            const contentType = response.headers.get("content-type") ?? "";
+            if (contentType.includes("text/event-stream")) {
+                const text = await response.text();
+                for (const line of text.split("\n")) {
+                    if (!line.startsWith("data:"))
+                        continue;
+                    const data = line.slice(5).trim();
+                    if (!data)
+                        continue;
+                    handlers.forEach((handler) => handler(JSON.parse(data)));
+                }
+                return;
+            }
+            const body = (await response.json());
+            handlers.forEach((handler) => handler(body));
+        },
+        onMessage(handler) {
+            handlers.push(handler);
+        },
+        async close() { }
+    };
+}
+export class McpClient {
+    transport;
+    pending = new Map();
+    constructor(transport) {
+        this.transport = transport;
+        transport.onMessage((message) => this.handleMessage(message));
+    }
+    async initialize(clientInfo = { name: "nexa-agent-sdk", version: "1.0.0" }) {
+        const result = await this.request("initialize", { protocolVersion: "2024-11-05", capabilities: {}, clientInfo });
+        await this.notify("notifications/initialized");
+        return result;
+    }
+    async listTools() {
+        const result = (await this.request("tools/list"));
+        return result.tools ?? [];
+    }
+    async callTool(name, args) {
+        const result = (await this.request("tools/call", { name, arguments: args }));
+        return { content: result.content ?? [], isError: Boolean(result.isError) };
+    }
+    async close() {
+        await this.transport.close();
+    }
+    handleMessage(message) {
+        if (message.id === undefined || message.id === null)
+            return;
+        const key = String(message.id);
+        const waiter = this.pending.get(key);
+        if (!waiter)
+            return;
+        this.pending.delete(key);
+        if (message.error) {
+            const error = message.error;
+            waiter.reject(new Error(`MCP error ${String(error.code ?? "?")}: ${String(error.message ?? "unknown error")}`));
+            return;
+        }
+        waiter.resolve((message.result ?? null));
+    }
+    async request(method, params) {
+        const id = randomUUID();
+        const promise = new Promise((resolvePromise, rejectPromise) => this.pending.set(id, { resolve: resolvePromise, reject: rejectPromise }));
+        await this.transport.send({ jsonrpc: "2.0", id, method, ...(params ? { params } : {}) });
+        return promise;
+    }
+    async notify(method, params) {
+        await this.transport.send({ jsonrpc: "2.0", method, ...(params ? { params } : {}) });
+    }
+}
+export async function mcp(config) {
+    const transport = isHttpConfig(config) ? createHttpTransport(config) : createStdioTransport(config);
+    const client = new McpClient(transport);
+    await client.initialize();
+    return {
+        client,
+        async discoverTools() {
+            const tools = await client.listTools();
+            return tools.map((toolInfo) => toRegistration(client, toolInfo));
+        },
+        close: () => client.close()
+    };
+}
+function isHttpConfig(config) {
+    return "url" in config;
+}
+function toRegistration(client, info) {
+    const id = `mcp.${info.name}`;
+    return {
+        tool: {
+            id,
+            name: info.name,
+            capability: id,
+            version: "1.0.0",
+            provider: "mcp",
+            enabled: true,
+            ...(info.description ? { description: info.description } : {}),
+            ...(info.inputSchema ? { inputSchema: info.inputSchema } : {})
+        },
+        handler: async (input) => {
+            try {
+                const result = await client.callTool(info.name, input);
+                if (result.isError)
+                    return { status: "error", error: summarizeMcpContent(result.content), retryable: false };
+                return { status: "ok", output: { content: result.content } };
+            }
+            catch (error) {
+                return { status: "error", error: error instanceof Error ? error.message : String(error), retryable: true };
+            }
+        }
+    };
+}
+function summarizeMcpContent(content) {
+    if (Array.isArray(content)) {
+        return content
+            .map((item) => (item && typeof item === "object" && "text" in item ? String(item.text) : JSON.stringify(item)))
+            .join("\n");
+    }
+    return JSON.stringify(content);
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

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

package/dist/memory.d.ts

@@ -0,0 +1,32 @@
+import type { JsonObject } from "./types.js";
+export type MemoryKind = "fact" | "episode" | "procedure" | "preference" | "artifact";
+export type MemoryRecord = {
+    id: string;
+    kind: MemoryKind;
+    content: string;
+    source?: string;
+    tags: string[];
+    confidence: number;
+    importance: number;
+    metadata: JsonObject;
+    createdAt: string;
+};
+export type MemorySearchResult = MemoryRecord & {
+    score: number;
+};
+export declare class MemoryStore {
+    private readonly records;
+    write(input: {
+        kind: MemoryKind;
+        content: string;
+        source?: string;
+        tags?: string[];
+        confidence?: number;
+        importance?: number;
+        metadata?: JsonObject;
+    }): MemoryRecord;
+    get(id: string): MemoryRecord | undefined;
+    list(): MemoryRecord[];
+    search(query: string, limit?: number): MemorySearchResult[];
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,GAAG,UAAU,CAAC;AAEtF,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,UAAU,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG;IAC9C,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAE3D,KAAK,CAAC,KAAK,EAAE;QACX,IAAI,EAAE,UAAU,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,UAAU,CAAC;KACvB,GAAG,YAAY;IAgBhB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIzC,IAAI,IAAI,YAAY,EAAE;IAItB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,kBAAkB,EAAE;CAQxD"}

package/dist/memory.js

@@ -0,0 +1,40 @@
+export class MemoryStore {
+    records = new Map();
+    write(input) {
+        const record = {
+            id: crypto.randomUUID(),
+            kind: input.kind,
+            content: input.content,
+            ...(input.source ? { source: input.source } : {}),
+            tags: input.tags ?? [],
+            confidence: input.confidence ?? 0.8,
+            importance: input.importance ?? 0.5,
+            metadata: input.metadata ?? {},
+            createdAt: new Date().toISOString()
+        };
+        this.records.set(record.id, record);
+        return record;
+    }
+    get(id) {
+        return this.records.get(id);
+    }
+    list() {
+        return [...this.records.values()];
+    }
+    search(query, limit = 10) {
+        const terms = tokenize(query);
+        return this.list()
+            .map((record) => ({ ...record, score: scoreMemory(record, terms) }))
+            .filter((record) => record.score > 0)
+            .sort((a, b) => b.score - a.score || b.importance - a.importance)
+            .slice(0, limit);
+    }
+}
+function tokenize(value) {
+    return value.toLowerCase().split(/[^a-z0-9_áéíóúñ]+/i).filter(Boolean);
+}
+function scoreMemory(record, terms) {
+    const haystack = `${record.content} ${record.tags.join(" ")} ${record.source ?? ""}`.toLowerCase();
+    return terms.reduce((score, term) => score + (haystack.includes(term) ? 1 : 0), 0);
+}
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAoBA,MAAM,OAAO,WAAW;IACL,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;IAE3D,KAAK,CAAC,KAQL;QACC,MAAM,MAAM,GAAiB;YAC3B,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;YACvB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;YACtB,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,GAAG;YACnC,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,GAAG;YACnC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE;YAC9B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACpC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,CAAC,KAAa,EAAE,KAAK,GAAG,EAAE;QAC9B,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC,IAAI,EAAE;aACf,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;aACnE,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;aACpC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC;aAChE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACrB,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,KAAa;IAC7B,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACzE,CAAC;AAED,SAAS,WAAW,CAAC,MAAoB,EAAE,KAAe;IACxD,MAAM,QAAQ,GAAG,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC;IACnG,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACrF,CAAC"}

package/dist/mission-runtime.d.ts

@@ -0,0 +1,106 @@
+import { EventBus } from "./event-bus.js";
+import { MemoryStore } from "./memory.js";
+import { ToolRegistry, type ToolExecutor } from "./tool-registry.js";
+import type { JsonObject, JsonValue } from "./types.js";
+export type MissionStatus = "accepted" | "planning" | "executing" | "verifying" | "completed" | "blocked" | "failed" | "cancelled";
+export type MissionStepType = "tool" | "llm" | "verify";
+export type ErrorClass = "transient" | "permanent" | "rate_limited" | "approval_required";
+export type MissionPlanStep = {
+    id?: string;
+    title: string;
+    description: string;
+    toolHint: string | null;
+    stepType: MissionStepType;
+    dependsOn: number[];
+    input?: JsonObject;
+    maxRetries?: number;
+};
+export type MissionStep = Required<Omit<MissionPlanStep, "id" | "input" | "maxRetries">> & {
+    id: string;
+    input: JsonObject;
+    status: "pending" | "running" | "completed" | "failed" | "skipped";
+    output: JsonValue | null;
+    evidence: JsonValue[];
+    error: string | null;
+    retryCount: number;
+    maxRetries: number;
+};
+export type MissionRecord = {
+    id: string;
+    title: string;
+    goal: string;
+    status: MissionStatus;
+    steps: MissionStep[];
+    evidence: JsonValue[];
+    result: string | null;
+    error: string | null;
+    replannedCount: number;
+    createdAt: string;
+    updatedAt: string;
+};
+export type MissionPlanner = {
+    createPlan(input: {
+        mission: MissionRecord;
+        memories: JsonValue[];
+    }): Promise<MissionPlanStep[]>;
+    replan?(input: {
+        mission: MissionRecord;
+        failedStep: MissionStep;
+        error: string;
+    }): Promise<MissionPlanStep[]>;
+};
+export type MissionVerifier = {
+    verify(input: {
+        mission: MissionRecord;
+        steps: MissionStep[];
+    }): Promise<{
+        ok: boolean;
+        reason: string;
+    }>;
+};
+export declare class RetryEngine {
+    classifyError(error: unknown): ErrorClass;
+    shouldRetry(error: unknown, attempt: number, maxRetries: number): boolean;
+}
+export declare class DefaultMissionPlanner implements MissionPlanner {
+    createPlan(input: {
+        mission: MissionRecord;
+        memories: JsonValue[];
+    }): Promise<MissionPlanStep[]>;
+}
+export declare class DefaultMissionVerifier implements MissionVerifier {
+    verify(input: {
+        mission: MissionRecord;
+        steps: MissionStep[];
+    }): Promise<{
+        ok: boolean;
+        reason: string;
+    }>;
+}
+export type MissionRuntimeOptions = {
+    planner?: MissionPlanner;
+    verifier?: MissionVerifier;
+    tools?: ToolRegistry;
+    toolExecutor?: ToolExecutor;
+    memory?: MemoryStore;
+    events?: EventBus;
+};
+export declare class MissionRuntime {
+    readonly retry: RetryEngine;
+    readonly planner: MissionPlanner;
+    readonly verifier: MissionVerifier;
+    readonly tools: ToolRegistry;
+    readonly memory: MemoryStore;
+    readonly events: EventBus;
+    private readonly missions;
+    constructor(options?: MissionRuntimeOptions);
+    private readonly toolExecutor;
+    createMission(goal: string): MissionRecord;
+    getMission(id: string): MissionRecord;
+    runMission(id: string): Promise<MissionRecord>;
+    private planMission;
+    private executeStep;
+    private runStepAction;
+    private patch;
+}
+//# sourceMappingURL=mission-runtime.d.ts.map

package/dist/mission-runtime.d.ts.map

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

package/dist/mission-runtime.js

@@ -0,0 +1,196 @@
+import { EventBus } from "./event-bus.js";
+import { MemoryStore } from "./memory.js";
+import { ToolRegistry } from "./tool-registry.js";
+export class RetryEngine {
+    classifyError(error) {
+        const message = String(error instanceof Error ? error.message : error).toLowerCase();
+        if (message.includes("approval") || message.includes("denied") || message.includes("permission"))
+            return "approval_required";
+        if (message.includes("429") || message.includes("rate limit"))
+            return "rate_limited";
+        if (["timeout", "econnreset", "enotfound", "econnrefused", "network", "503", "502"].some((token) => message.includes(token)))
+            return "transient";
+        return "permanent";
+    }
+    shouldRetry(error, attempt, maxRetries) {
+        const kind = this.classifyError(error);
+        return attempt < maxRetries && (kind === "transient" || kind === "rate_limited");
+    }
+}
+export class DefaultMissionPlanner {
+    async createPlan(input) {
+        const hasTool = input.memories.length > 0;
+        return [
+            {
+                title: "Gather context",
+                description: "Collect relevant context before acting.",
+                toolHint: hasTool ? "memory.search" : null,
+                stepType: hasTool ? "tool" : "llm",
+                dependsOn: []
+            },
+            {
+                title: "Execute goal",
+                description: input.mission.goal,
+                toolHint: null,
+                stepType: "llm",
+                dependsOn: [0]
+            },
+            {
+                title: "Verify result",
+                description: "Confirm the mission produced evidence.",
+                toolHint: null,
+                stepType: "verify",
+                dependsOn: [1]
+            }
+        ];
+    }
+}
+export class DefaultMissionVerifier {
+    async verify(input) {
+        const actionable = input.steps.filter((step) => step.status !== "skipped");
+        const completed = actionable.filter((step) => step.status === "completed");
+        if (completed.length < actionable.length)
+            return { ok: false, reason: `Only ${completed.length}/${actionable.length} steps completed.` };
+        if (!input.mission.evidence.length)
+            return { ok: false, reason: "Mission has no evidence recorded." };
+        return { ok: true, reason: `${completed.length} steps completed with evidence.` };
+    }
+}
+export class MissionRuntime {
+    retry = new RetryEngine();
+    planner;
+    verifier;
+    tools;
+    memory;
+    events;
+    missions = new Map();
+    constructor(options = {}) {
+        this.planner = options.planner ?? new DefaultMissionPlanner();
+        this.verifier = options.verifier ?? new DefaultMissionVerifier();
+        this.tools = options.tools ?? new ToolRegistry();
+        this.memory = options.memory ?? new MemoryStore();
+        this.events = options.events ?? new EventBus();
+        this.toolExecutor = options.toolExecutor;
+    }
+    toolExecutor;
+    createMission(goal) {
+        const now = new Date().toISOString();
+        const mission = {
+            id: crypto.randomUUID(),
+            title: goal.length > 72 ? `${goal.slice(0, 69)}...` : goal,
+            goal,
+            status: "accepted",
+            steps: [],
+            evidence: [],
+            result: null,
+            error: null,
+            replannedCount: 0,
+            createdAt: now,
+            updatedAt: now
+        };
+        this.missions.set(mission.id, mission);
+        void this.events.publish({ type: "mission.created", source: "mission-runtime", missionId: mission.id, payload: { goal } });
+        return mission;
+    }
+    getMission(id) {
+        const mission = this.missions.get(id);
+        if (!mission)
+            throw new Error(`Mission not found: ${id}`);
+        return mission;
+    }
+    async runMission(id) {
+        const mission = this.getMission(id);
+        if (mission.status === "completed" || mission.status === "cancelled")
+            return mission;
+        if (!mission.steps.length)
+            await this.planMission(mission);
+        this.patch(mission, { status: "executing" });
+        for (const step of mission.steps) {
+            if (step.status === "completed" || step.status === "skipped")
+                continue;
+            const ok = await this.executeStep(mission, step);
+            if (!ok) {
+                this.patch(mission, { status: "blocked", error: step.error ?? "Step failed." });
+                return mission;
+            }
+        }
+        this.patch(mission, { status: "verifying" });
+        const verified = await this.verifier.verify({ mission, steps: mission.steps });
+        if (!verified.ok) {
+            this.patch(mission, { status: "blocked", error: verified.reason });
+            return mission;
+        }
+        const result = `Mission completed: ${mission.title}. ${mission.evidence.length} evidence item(s).`;
+        this.memory.write({ kind: "episode", content: result, source: `mission:${mission.id}`, tags: ["mission", "completed"] });
+        this.patch(mission, { status: "completed", result, error: null });
+        await this.events.publish({ type: "mission.completed", source: "mission-runtime", missionId: mission.id, payload: { result } });
+        return mission;
+    }
+    async planMission(mission) {
+        this.patch(mission, { status: "planning" });
+        const memories = this.memory.search(mission.goal, 5);
+        mission.steps = (await this.planner.createPlan({ mission, memories })).map((step, index) => ({
+            id: step.id ?? crypto.randomUUID(),
+            title: step.title,
+            description: step.description,
+            toolHint: step.toolHint,
+            stepType: step.stepType,
+            dependsOn: step.dependsOn,
+            input: step.input ?? {},
+            status: "pending",
+            output: null,
+            evidence: [],
+            error: null,
+            retryCount: 0,
+            maxRetries: step.maxRetries ?? 3
+        }));
+        await this.events.publish({ type: "mission.planned", source: "mission-runtime", missionId: mission.id, payload: { steps: mission.steps.map((step) => step.title) } });
+    }
+    async executeStep(mission, step) {
+        step.status = "running";
+        await this.events.publish({ type: "mission.step.started", source: "mission-runtime", missionId: mission.id, stepId: step.id, payload: { title: step.title } });
+        try {
+            const output = await this.runStepAction(mission, step);
+            step.output = output;
+            step.evidence = [{ step: step.title, output }];
+            step.status = "completed";
+            mission.evidence.push(...step.evidence);
+            await this.events.publish({ type: "mission.step.completed", source: "mission-runtime", missionId: mission.id, stepId: step.id, payload: { output } });
+            return true;
+        }
+        catch (error) {
+            step.error = error instanceof Error ? error.message : String(error);
+            step.status = "failed";
+            await this.events.publish({ type: "mission.step.failed", source: "mission-runtime", missionId: mission.id, stepId: step.id, payload: { error: step.error } });
+            return false;
+        }
+    }
+    async runStepAction(mission, step) {
+        if (step.stepType === "verify") {
+            if (!mission.evidence.length)
+                throw new Error("Verification failed: no evidence recorded.");
+            return { verified: true, evidenceCount: mission.evidence.length };
+        }
+        if (step.stepType === "llm" || !step.toolHint)
+            return { note: step.description, title: step.title };
+        if (step.toolHint === "memory.search")
+            return { results: this.memory.search(mission.goal, 5) };
+        if (step.toolHint === "memory.write")
+            return this.memory.write({ kind: "episode", content: mission.goal, source: `mission:${mission.id}` });
+        if (!this.toolExecutor)
+            throw new Error(`No tool executor configured for ${step.toolHint}.`);
+        const tool = this.tools.list().find((candidate) => candidate.id === step.toolHint || candidate.name === step.toolHint);
+        if (!tool)
+            throw new Error(`Tool not registered: ${step.toolHint}`);
+        const result = await this.toolExecutor.execute(tool.id, step.input, { taskId: mission.id, runId: mission.id, stepId: step.id });
+        if (result.status === "ok")
+            return result.output;
+        if (result.status === "pending_approval")
+            throw new Error(`Approval required: ${result.reason}`);
+        throw new Error(result.error);
+    }
+    patch(mission, patch) {
+        Object.assign(mission, patch, { updatedAt: new Date().toISOString() });
+    }
+}
+//# sourceMappingURL=mission-runtime.js.map