@nexalab/agent-sdk 0.1.0

package/dist/kernel.d.ts.map

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

package/dist/kernel.js

@@ -0,0 +1,251 @@
+import { randomUUID } from "node:crypto";
+import { z } from "zod";
+import { AgentTool } from "./agent-builder.js";
+import { createOpenAICompatibleAgent } from "./openai-agent.js";
+import { anthropicProvider, geminiProvider, ollamaProvider, openaiProvider, openRouterProvider } from "./providers.js";
+import { createAdvancedMemoryStore } from "./advanced-memory.js";
+import { createContextEngine } from "./context.js";
+import { runInputGuardrails, runOutputGuardrails } from "./guardrails.js";
+import { createHookDispatcher } from "./hooks.js";
+import { parseStructuredOutput, structuredOutputInstruction, zodSchemaToJsonSchema } from "./structured-output.js";
+import { createSession } from "./sessions.js";
+import { skillsToInstructions, skillsToToolRegistrations } from "./skills.js";
+import { artifactsFromRunResult } from "./artifacts.js";
+import { agentWorkerFromAgent, MultiAgentCoordinator } from "./multi-agent.js";
+import { filterToolsByPermissions, namespaceKey } from "./tenancy.js";
+const PROVIDER_FACTORIES = {
+    openai: openaiProvider,
+    openrouter: openRouterProvider,
+    ollama: ollamaProvider,
+    anthropic: anthropicProvider,
+    gemini: geminiProvider
+};
+const PROVIDER_ENV_KEYS = {
+    openai: "OPENAI_API_KEY",
+    openrouter: "OPENROUTER_API_KEY",
+    anthropic: "ANTHROPIC_API_KEY",
+    gemini: "GEMINI_API_KEY"
+};
+export function resolveModelString(modelString) {
+    const separatorIndex = modelString.indexOf(":");
+    if (separatorIndex === -1) {
+        throw new Error(`Model string must be "provider:model" (e.g. "openai:gpt-4o-mini"), got "${modelString}".`);
+    }
+    const providerId = modelString.slice(0, separatorIndex);
+    const model = modelString.slice(separatorIndex + 1);
+    const factory = PROVIDER_FACTORIES[providerId];
+    if (!factory) {
+        throw new Error(`Unknown provider "${providerId}" in model string "${modelString}". Known providers: ${Object.keys(PROVIDER_FACTORIES).join(", ")}.`);
+    }
+    const envKey = PROVIDER_ENV_KEYS[providerId];
+    const apiKey = envKey ? process.env[envKey] : undefined;
+    return { provider: factory({ model, ...(apiKey ? { apiKey } : {}) }), model };
+}
+export async function agent(config) {
+    const { provider, model } = config.provider ? { provider: config.provider, model: config.model } : resolveModelString(config.model);
+    const memoryStore = resolveMemory(config.memory);
+    const knowledgeBases = config.knowledge ?? [];
+    const contextEngine = config.context || knowledgeBases.length ? createContextEngine(withKnowledge(config.context ?? {}, knowledgeBases)) : undefined;
+    const hooks = createHookDispatcher(config.hooks ?? {});
+    const guardrails = config.guardrails ?? [];
+    const sessionStore = hasSessionStore(config.storage) ? config.storage : undefined;
+    const skills = config.skills ?? [];
+    const instructions = [config.instructions, skills.length ? skillsToInstructions(skills) : undefined].filter(Boolean).join("\n\n") || undefined;
+    const mcpTools = (await Promise.all((config.mcp ?? []).map((connection) => connection.discoverTools()))).flat();
+    const handoffToolIds = new Set((config.handoffs ?? []).map((target) => handoffToolId(target.name)));
+    const handoffTools = (config.handoffs ?? []).map((target) => ({
+        tool: {
+            id: handoffToolId(target.name),
+            name: handoffToolId(target.name),
+            description: `Transfer the conversation to the "${target.name}" agent when the request is better handled by them.`,
+            capability: handoffToolId(target.name),
+            version: "1.0.0",
+            provider: "kernel",
+            enabled: true,
+            inputSchema: zodSchemaToJsonSchema(z.object({ task: z.string() }))
+        },
+        handler: async (rawInput) => {
+            const task = typeof rawInput.task === "string" ? rawInput.task : JSON.stringify(rawInput);
+            const targetResult = await target.run(task);
+            return { status: "ok", output: { text: targetResult.text, handoffTo: target.name } };
+        }
+    }));
+    const allToolRegistrations = [
+        ...(config.tools ?? []).map((tool) => (tool instanceof AgentTool ? tool.asRegistration() : tool)),
+        ...skillsToToolRegistrations(skills),
+        ...mcpTools,
+        ...handoffTools
+    ];
+    const toolRegistrations = config.permissions ? filterToolsByPermissions(allToolRegistrations, config.permissions) : allToolRegistrations;
+    const underlying = await createOpenAICompatibleAgent({
+        provider,
+        model,
+        ...(instructions ? { systemPrompt: instructions } : {}),
+        tools: toolRegistrations,
+        ...(config.trace ? { trace: config.trace } : {}),
+        ...(config.toolRouter ? { toolRouter: config.toolRouter } : {}),
+        ...(config.storage ? { storage: config.storage } : {}),
+        ...(config.telemetry ? { telemetry: config.telemetry } : {}),
+        ...(config.modelRouter ? { modelRouter: config.modelRouter } : {}),
+        ...(config.harness ? { harness: config.harness } : {})
+    });
+    async function run(text, options = {}) {
+        const runId = randomUUID();
+        const taskId = runId;
+        const hookContext = { taskId, runId };
+        await hooks.fire("beforeRun", { text, context: hookContext });
+        try {
+            const guardedInput = guardrails.length
+                ? await runInputGuardrails(guardrails, { text, messages: options.messages ?? [], context: { taskId, runId } })
+                : { text, violations: [] };
+            let messages = options.messages;
+            if (contextEngine) {
+                const built = await contextEngine.build({ runId, taskId, text: guardedInput.text, ...(options.messages ? { conversation: options.messages } : {}) });
+                const systemContent = [instructions, built.systemMessage].filter(Boolean).join("\n\n") ||
+                    "You are Nexa, a concise and useful AI assistant running through @nexalab/agent-sdk.";
+                const priorNonSystem = (options.messages ?? []).filter((message) => message.role !== "system");
+                messages = [{ role: "system", content: systemContent }, ...priorNonSystem];
+            }
+            const outputSchema = options.outputSchema ?? config.outputSchema;
+            const effectiveText = outputSchema ? `${guardedInput.text}\n\n${structuredOutputInstruction(outputSchema)}` : guardedInput.text;
+            const tenant = options.tenant ?? {};
+            const cacheKey = config.cache ? JSON.stringify({ name: config.name, tenant, effectiveText, messages }) : undefined;
+            if (cacheKey) {
+                const cached = config.cache?.get(cacheKey);
+                if (cached) {
+                    await hooks.fire("afterRun", { text, result: cached, context: hookContext });
+                    return cached;
+                }
+            }
+            await hooks.fire("beforeModel", { context: hookContext });
+            const result = messages ? await underlying.runMessage(effectiveText, messages) : await underlying.runMessage(effectiveText);
+            await hooks.fire("afterModel", { text: result.text, context: hookContext });
+            let rawText = result.text;
+            let handoffTo;
+            const handoffCall = [...(result.nativeToolTurn?.toolResults ?? [])]
+                .reverse()
+                .find((entry) => handoffToolIds.has(entry.tool.id) && entry.result.status === "ok");
+            if (handoffCall && handoffCall.result.status === "ok") {
+                const handoffOutput = handoffCall.result.output;
+                if (typeof handoffOutput.text === "string")
+                    rawText = handoffOutput.text;
+                if (typeof handoffOutput.handoffTo === "string") {
+                    handoffTo = handoffOutput.handoffTo;
+                    await hooks.fire("onHandoff", { fromAgent: config.name, toAgent: handoffTo, context: hookContext });
+                }
+            }
+            const guardedOutput = guardrails.length
+                ? await runOutputGuardrails(guardrails, { text: rawText, messages: result.messages, context: { taskId, runId } })
+                : { text: rawText, violations: [] };
+            let output;
+            if (outputSchema) {
+                const parsed = parseStructuredOutput(outputSchema, guardedOutput.text);
+                if (!parsed.ok)
+                    throw new Error(`Structured output validation failed: ${parsed.error}`);
+                output = parsed.data;
+            }
+            if (memoryStore) {
+                const record = memoryStore.writeUnique({ kind: "episode", content: `${text} => ${guardedOutput.text}`, source: namespaceKey(tenant, config.name) });
+                await hooks.fire("onMemoryWrite", { record, context: hookContext });
+            }
+            const finalResult = {
+                ...result,
+                text: guardedOutput.text,
+                artifacts: artifactsFromRunResult(result),
+                ...(handoffTo ? { handoffTo } : {}),
+                ...(output !== undefined ? { output } : {})
+            };
+            if (cacheKey)
+                config.cache?.set(cacheKey, finalResult, config.cacheTtlMs);
+            await hooks.fire("afterRun", { text, result: finalResult, context: hookContext });
+            return finalResult;
+        }
+        catch (error) {
+            await hooks.fire("onError", { error, context: hookContext });
+            throw error;
+        }
+    }
+    function session(id) {
+        return createSession({
+            ...(id ? { id } : {}),
+            ...(instructions ? { systemPrompt: instructions } : {}),
+            ...(sessionStore ? { store: sessionStore } : {}),
+            runner: async ({ text, messages }) => run(text, { messages })
+        });
+    }
+    function asTool(input = {}) {
+        const id = input.id ?? `agent.${config.name}`;
+        return {
+            tool: {
+                id,
+                name: config.name,
+                description: input.description ?? instructions ?? `Delegate a task to the "${config.name}" agent.`,
+                capability: id,
+                version: "1.0.0",
+                provider: "kernel",
+                enabled: true,
+                inputSchema: zodSchemaToJsonSchema(z.object({ task: z.string() }))
+            },
+            handler: async (rawInput) => {
+                const task = typeof rawInput.task === "string" ? rawInput.task : JSON.stringify(rawInput);
+                const result = await run(task);
+                return { status: "ok", output: { text: result.text } };
+            }
+        };
+    }
+    return { name: config.name, underlying, ...(memoryStore ? { memory: memoryStore } : {}), run, session, asTool };
+}
+function resolveMemory(memory) {
+    if (!memory)
+        return undefined;
+    if (memory === true)
+        return createAdvancedMemoryStore();
+    return memory;
+}
+function hasSessionStore(storage) {
+    return typeof storage?.saveSession === "function" && typeof storage.getSession === "function";
+}
+function handoffToolId(name) {
+    return `handoff_to_${name.replace(/[^a-zA-Z0-9_]/g, "_")}`;
+}
+function withKnowledge(config, knowledgeBases) {
+    if (!knowledgeBases.length)
+        return config;
+    const existingDynamic = config.dynamic;
+    return {
+        ...config,
+        dynamic: async (input) => {
+            const existing = existingDynamic ? await existingDynamic(input) : undefined;
+            const existingText = typeof existing === "string" ? existing : existing ? JSON.stringify(existing) : undefined;
+            const retrieved = (await Promise.all(knowledgeBases.map((base) => base.retrieve(input.text)))).flat();
+            const retrievedText = retrieved.map((result) => result.content).join("\n\n") || undefined;
+            return [existingText, retrievedText].filter(Boolean).join("\n\n") || undefined;
+        }
+    };
+}
+export function createTeam(input) {
+    const strategy = input.strategy ?? (input.supervisor ? "supervisor" : "router");
+    return {
+        async run(task) {
+            if (strategy === "parallel") {
+                const results = await Promise.all(input.agents.map(async (member) => ({ agent: member.name, result: await member.run(task) })));
+                return { text: results.map((entry) => `[${entry.agent}] ${entry.result.text}`).join("\n\n"), results };
+            }
+            if (strategy === "supervisor") {
+                if (!input.supervisor)
+                    throw new Error('createTeam: strategy "supervisor" requires a `supervisor` agent.');
+                const result = await input.supervisor.run(task);
+                return { text: result.text, results: [{ agent: input.supervisor.name, result }] };
+            }
+            const coordinator = new MultiAgentCoordinator(input.agents.map((member) => agentWorkerFromAgent({
+                id: member.name,
+                description: member.name,
+                capabilities: [member.name],
+                agent: { runMessage: (text) => member.run(text) }
+            })));
+            const delegation = await coordinator.delegate({ task });
+            return { text: delegation.result.text, results: [{ agent: delegation.worker.id, result: delegation.result }] };
+        }
+    };
+}
+//# sourceMappingURL=kernel.js.map

package/dist/kernel.js.map

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

package/dist/knowledge.d.ts

@@ -0,0 +1,35 @@
+import { type EmbeddingProvider } from "./vector-memory.js";
+export type KnowledgeSource = {
+    id: string;
+    load(): Promise<string> | string;
+};
+export declare function textSource(id: string, content: string): KnowledgeSource;
+export declare function fileSource(path: string): KnowledgeSource;
+export declare function directorySource(dirPath: string, options?: {
+    extensions?: string[];
+}): KnowledgeSource;
+export type ChunkOptions = {
+    maxChars?: number;
+    overlap?: number;
+};
+export declare function chunkText(text: string, options?: ChunkOptions): string[];
+export type KnowledgeConfig = {
+    sources: KnowledgeSource[];
+    embeddings?: EmbeddingProvider;
+    chunk?: ChunkOptions;
+};
+export type KnowledgeRetrieveResult = {
+    content: string;
+    score: number;
+    sourceId: string;
+};
+export declare class Knowledge {
+    private readonly config;
+    private readonly store;
+    private ready;
+    constructor(config: KnowledgeConfig);
+    retrieve(query: string, limit?: number): Promise<KnowledgeRetrieveResult[]>;
+    private index;
+}
+export declare function createKnowledge(config: KnowledgeConfig): Knowledge;
+//# sourceMappingURL=knowledge.d.ts.map

package/dist/knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../src/knowledge.ts"],"names":[],"mappings":"AAIA,OAAO,EAA8C,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAExG,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;CAClC,CAAC;AAEF,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,CAEvE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAExD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CAAO,GAAG,eAAe,CAUzG;AAaD,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,MAAM,EAAE,CAa5E;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3F,qBAAa,SAAS;IAIR,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,KAAK,CAA4B;gBAEZ,MAAM,EAAE,eAAe;IAI9C,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAM5E,OAAO,CAAC,KAAK;CAsBd;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAElE"}

package/dist/knowledge.js

@@ -0,0 +1,89 @@
+import { randomUUID } from "node:crypto";
+import { readFile, readdir } from "node:fs/promises";
+import { extname, join } from "node:path";
+import { createVectorMemoryStore } from "./vector-memory.js";
+export function textSource(id, content) {
+    return { id, load: () => content };
+}
+export function fileSource(path) {
+    return { id: path, load: () => readFile(path, "utf8") };
+}
+export function directorySource(dirPath, options = {}) {
+    const allowed = options.extensions ?? [".md", ".txt"];
+    return {
+        id: dirPath,
+        load: async () => {
+            const files = await collectFiles(dirPath, allowed);
+            const contents = await Promise.all(files.map(async (filePath) => `## ${filePath}\n${await readFile(filePath, "utf8")}`));
+            return contents.join("\n\n");
+        }
+    };
+}
+async function collectFiles(dirPath, allowed) {
+    const entries = await readdir(dirPath, { withFileTypes: true });
+    const results = [];
+    for (const entry of entries) {
+        const fullPath = join(dirPath, entry.name);
+        if (entry.isDirectory())
+            results.push(...(await collectFiles(fullPath, allowed)));
+        else if (allowed.includes(extname(entry.name)))
+            results.push(fullPath);
+    }
+    return results;
+}
+export function chunkText(text, options = {}) {
+    const maxChars = options.maxChars ?? 1200;
+    const overlap = Math.min(options.overlap ?? 100, maxChars - 1);
+    if (text.length <= maxChars)
+        return [text];
+    const chunks = [];
+    let start = 0;
+    while (start < text.length) {
+        const end = Math.min(start + maxChars, text.length);
+        chunks.push(text.slice(start, end));
+        if (end === text.length)
+            break;
+        start = end - overlap;
+    }
+    return chunks;
+}
+export class Knowledge {
+    config;
+    store;
+    ready;
+    constructor(config) {
+        this.config = config;
+        this.store = createVectorMemoryStore(config.embeddings);
+    }
+    async retrieve(query, limit = 5) {
+        await this.index();
+        const results = await this.store.search(query, limit);
+        return results.map((record) => ({ content: record.content, score: record.score, sourceId: record.source ?? "unknown" }));
+    }
+    index() {
+        this.ready ??= (async () => {
+            for (const source of this.config.sources) {
+                const content = await source.load();
+                for (const chunk of chunkText(content, this.config.chunk)) {
+                    const record = {
+                        id: randomUUID(),
+                        kind: "fact",
+                        content: chunk,
+                        source: source.id,
+                        tags: [],
+                        confidence: 1,
+                        importance: 0.5,
+                        metadata: {},
+                        createdAt: new Date().toISOString()
+                    };
+                    await this.store.upsert(record);
+                }
+            }
+        })();
+        return this.ready;
+    }
+}
+export function createKnowledge(config) {
+    return new Knowledge(config);
+}
+//# sourceMappingURL=knowledge.js.map

package/dist/knowledge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.js","sourceRoot":"","sources":["../src/knowledge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,uBAAuB,EAA6C,MAAM,oBAAoB,CAAC;AAOxG,MAAM,UAAU,UAAU,CAAC,EAAU,EAAE,OAAe;IACpD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,UAAqC,EAAE;IACtF,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACtD,OAAO;QACL,EAAE,EAAE,OAAO;QACX,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACnD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,MAAM,QAAQ,KAAK,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;YACzH,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;KACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,OAAe,EAAE,OAAiB;IAC5D,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,KAAK,CAAC,WAAW,EAAE;YAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;aAC7E,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAID,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,UAAwB,EAAE;IAChE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,GAAG,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC;IAC/D,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACpD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;QACpC,IAAI,GAAG,KAAK,IAAI,CAAC,MAAM;YAAE,MAAM;QAC/B,KAAK,GAAG,GAAG,GAAG,OAAO,CAAC;IACxB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAUD,MAAM,OAAO,SAAS;IAIS;IAHZ,KAAK,CAAoB;IAClC,KAAK,CAA4B;IAEzC,YAA6B,MAAuB;QAAvB,WAAM,GAAN,MAAM,CAAiB;QAClD,IAAI,CAAC,KAAK,GAAG,uBAAuB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAa,EAAE,KAAK,GAAG,CAAC;QACrC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACtD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC;IAC3H,CAAC;IAEO,KAAK;QACX,IAAI,CAAC,KAAK,KAAK,CAAC,KAAK,IAAI,EAAE;YACzB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACzC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBACpC,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC1D,MAAM,MAAM,GAAiB;wBAC3B,EAAE,EAAE,UAAU,EAAE;wBAChB,IAAI,EAAE,MAAM;wBACZ,OAAO,EAAE,KAAK;wBACd,MAAM,EAAE,MAAM,CAAC,EAAE;wBACjB,IAAI,EAAE,EAAE;wBACR,UAAU,EAAE,CAAC;wBACb,UAAU,EAAE,GAAG;wBACf,QAAQ,EAAE,EAAE;wBACZ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;qBACpC,CAAC;oBACF,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAClC,CAAC;YACH,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QACL,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,MAAuB;IACrD,OAAO,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC"}

package/dist/local-tool-executor.d.ts

@@ -0,0 +1,26 @@
+import type { JsonObject } from "./types.js";
+import type { ToolDefinition, ToolExecutionResult, ToolExecutor } from "./tool-registry.js";
+import type { ApprovalManager, ApprovalRisk } from "./approvals.js";
+export type LocalToolContext = {
+    taskId: string;
+    runId: string;
+    stepId: string;
+    workspaceRoot?: string;
+    signal?: AbortSignal;
+};
+export type LocalToolHandler = (input: JsonObject, context: LocalToolContext) => Promise<ToolExecutionResult> | ToolExecutionResult;
+export type LocalToolExecutorOptions = {
+    approvals?: ApprovalManager;
+    approvalPolicy?: (input: {
+        tool: ToolDefinition;
+        context: LocalToolContext;
+    }) => ApprovalRisk | null;
+};
+export declare class LocalToolExecutor implements ToolExecutor {
+    private readonly options;
+    private readonly registrations;
+    constructor(options?: LocalToolExecutorOptions);
+    register(tool: ToolDefinition, handler: LocalToolHandler): this;
+    execute(toolId: string, input: JsonObject, context: LocalToolContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=local-tool-executor.d.ts.map

package/dist/local-tool-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-tool-executor.d.ts","sourceRoot":"","sources":["../src/local-tool-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC5F,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEpE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,mBAAmB,CAAC,GAAG,mBAAmB,CAAC;AAEpI,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,cAAc,CAAC;QAAC,OAAO,EAAE,gBAAgB,CAAA;KAAE,KAAK,YAAY,GAAG,IAAI,CAAC;CACtG,CAAC;AAEF,qBAAa,iBAAkB,YAAW,YAAY;IAGxC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0E;gBAE3E,OAAO,GAAE,wBAA6B;IAEnE,QAAQ,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAKzD,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAiB1G"}

package/dist/local-tool-executor.js

@@ -0,0 +1,30 @@
+export class LocalToolExecutor {
+    options;
+    registrations = new Map();
+    constructor(options = {}) {
+        this.options = options;
+    }
+    register(tool, handler) {
+        this.registrations.set(tool.id, { tool, handler });
+        return this;
+    }
+    async execute(toolId, input, context) {
+        const registration = this.registrations.get(toolId);
+        if (!registration)
+            return { status: "error", error: `No local handler registered for tool: ${toolId}`, retryable: false };
+        const risk = this.options.approvalPolicy?.({ tool: registration.tool, context });
+        if (risk && this.options.approvals) {
+            const approval = this.options.approvals.request({
+                risk,
+                reason: `Tool ${registration.tool.id} requires approval.`,
+                toolId: registration.tool.id,
+                taskId: context.taskId,
+                runId: context.runId,
+                stepId: context.stepId
+            });
+            return { status: "pending_approval", reason: `Approval required: ${approval.id}` };
+        }
+        return registration.handler(input, context);
+    }
+}
+//# sourceMappingURL=local-tool-executor.js.map

package/dist/local-tool-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-tool-executor.js","sourceRoot":"","sources":["../src/local-tool-executor.ts"],"names":[],"mappings":"AAmBA,MAAM,OAAO,iBAAiB;IAGC;IAFZ,aAAa,GAAG,IAAI,GAAG,EAA+D,CAAC;IAExG,YAA6B,UAAoC,EAAE;QAAtC,YAAO,GAAP,OAAO,CAA+B;IAAG,CAAC;IAEvE,QAAQ,CAAC,IAAoB,EAAE,OAAyB;QACtD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAc,EAAE,KAAiB,EAAE,OAAyB;QACxE,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpD,IAAI,CAAC,YAAY;YAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,yCAAyC,MAAM,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QAC1H,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACjF,IAAI,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC;gBAC9C,IAAI;gBACJ,MAAM,EAAE,QAAQ,YAAY,CAAC,IAAI,CAAC,EAAE,qBAAqB;gBACzD,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE;gBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB,CAAC,CAAC;YACH,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,sBAAsB,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC;QACrF,CAAC;QACD,OAAO,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;CACF"}

package/dist/loop-guard.d.ts

@@ -0,0 +1,15 @@
+import type { JsonValue } from "./types.js";
+export declare class LoopGuard {
+    private readonly signatures;
+    record(input: {
+        runId: string;
+        stepId?: string | null;
+        type: string;
+        value: JsonValue;
+        maxRepeated: number;
+    }): {
+        repeated: boolean;
+        count: number;
+    };
+}
+//# sourceMappingURL=loop-guard.d.ts.map

package/dist/loop-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-guard.d.ts","sourceRoot":"","sources":["../src/loop-guard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IAExD,MAAM,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;CAOpJ"}

package/dist/loop-guard.js

@@ -0,0 +1,12 @@
+import { createHash } from "node:crypto";
+export class LoopGuard {
+    signatures = new Map();
+    record(input) {
+        const hash = createHash("sha256").update(JSON.stringify(input.value)).digest("hex");
+        const key = [input.runId, input.stepId ?? "", input.type, hash].join(":");
+        const count = (this.signatures.get(key) ?? 0) + 1;
+        this.signatures.set(key, count);
+        return { repeated: count > input.maxRepeated, count };
+    }
+}
+//# sourceMappingURL=loop-guard.js.map

package/dist/loop-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-guard.js","sourceRoot":"","sources":["../src/loop-guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,MAAM,OAAO,SAAS;IACH,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAExD,MAAM,CAAC,KAAqG;QAC1G,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACpF,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1E,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAClD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAChC,OAAO,EAAE,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC;IACxD,CAAC;CACF"}

package/dist/manifest.d.ts

@@ -0,0 +1,43 @@
+import { z } from "zod";
+import { type NexaAgent, type NexaAgentConfig } from "./kernel.js";
+declare const manifestSchema: z.ZodObject<{
+    name: z.ZodString;
+    model: z.ZodUnion<[z.ZodString, z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        model: string;
+        provider: string;
+    }, {
+        model: string;
+        provider: string;
+    }>]>;
+    instructions: z.ZodOptional<z.ZodString>;
+    memory: z.ZodOptional<z.ZodBoolean>;
+    cacheTtlMs: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    model: string | {
+        model: string;
+        provider: string;
+    };
+    memory?: boolean | undefined;
+    instructions?: string | undefined;
+    cacheTtlMs?: number | undefined;
+}, {
+    name: string;
+    model: string | {
+        model: string;
+        provider: string;
+    };
+    memory?: boolean | undefined;
+    instructions?: string | undefined;
+    cacheTtlMs?: number | undefined;
+}>;
+export type AgentManifest = z.infer<typeof manifestSchema>;
+export declare function parseAgentManifest(raw: string): AgentManifest;
+export declare function manifestModelString(manifest: AgentManifest): string;
+export type LoadAgentManifestOptions = Partial<Omit<NexaAgentConfig, "name" | "model" | "instructions" | "memory" | "cacheTtlMs">>;
+export declare function loadAgentManifest(path: string, extend?: LoadAgentManifestOptions): Promise<NexaAgent>;
+export {};
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAS,KAAK,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAE1E,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMlB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE3D,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAG7D;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAEnE;AAED,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,GAAG,cAAc,GAAG,QAAQ,GAAG,YAAY,CAAC,CAAC,CAAC;AAEnI,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,wBAA6B,GAAG,OAAO,CAAC,SAAS,CAAC,CAW/G"}

package/dist/manifest.js

@@ -0,0 +1,31 @@
+import { readFile } from "node:fs/promises";
+import { parse as parseYaml } from "yaml";
+import { z } from "zod";
+import { agent } from "./kernel.js";
+const manifestSchema = z.object({
+    name: z.string().min(1),
+    model: z.union([z.string().min(1), z.object({ provider: z.string().min(1), model: z.string().min(1) })]),
+    instructions: z.string().optional(),
+    memory: z.boolean().optional(),
+    cacheTtlMs: z.number().int().positive().optional()
+});
+export function parseAgentManifest(raw) {
+    const data = parseYaml(raw);
+    return manifestSchema.parse(data);
+}
+export function manifestModelString(manifest) {
+    return typeof manifest.model === "string" ? manifest.model : `${manifest.model.provider}:${manifest.model.model}`;
+}
+export async function loadAgentManifest(path, extend = {}) {
+    const raw = await readFile(path, "utf8");
+    const manifest = parseAgentManifest(raw);
+    return agent({
+        ...extend,
+        name: manifest.name,
+        model: manifestModelString(manifest),
+        ...(manifest.instructions ? { instructions: manifest.instructions } : {}),
+        ...(manifest.memory !== undefined ? { memory: manifest.memory } : {}),
+        ...(manifest.cacheTtlMs !== undefined ? { cacheTtlMs: manifest.cacheTtlMs } : {})
+    });
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAwC,MAAM,aAAa,CAAC;AAE1E,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxG,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CACnD,CAAC,CAAC;AAIH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,IAAI,GAAY,SAAS,CAAC,GAAG,CAAC,CAAC;IACrC,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAuB;IACzD,OAAO,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;AACpH,CAAC;AAID,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY,EAAE,SAAmC,EAAE;IACzF,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACzC,OAAO,KAAK,CAAC;QACX,GAAG,MAAM;QACT,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,KAAK,EAAE,mBAAmB,CAAC,QAAQ,CAAC;QACpC,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,GAAG,CAAC,QAAQ,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,GAAG,CAAC,QAAQ,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClF,CAAC,CAAC;AACL,CAAC"}