@nexalab/agent-sdk 0.1.0

package/dist/console-chat.js

@@ -0,0 +1,284 @@
+import readline from "node:readline/promises";
+import { readFileSync } from "node:fs";
+import { createNexaAgentSdk } from "./sdk.js";
+import { OpenAICompatibleChatClient, OpenAICompatibleRegistry, createOpenAICompatibleReasoner } from "./openai-compatible.js";
+import { LocalToolExecutor } from "./local-tool-executor.js";
+export class PremiumConsoleRenderer {
+    output;
+    constructor(output = process.stdout) {
+        this.output = output;
+    }
+    header(input) {
+        this.line(color("Nexa Agent SDK Console", "gold"));
+        this.line(`${muted("env")}      ${input.loadedEnvLabel ?? "none"}`);
+        this.line(`${muted("provider")} ${input.providerId}`);
+        if (input.baseUrl)
+            this.line(`${muted("baseUrl")}  ${input.baseUrl}`);
+        this.line(`${muted("model")}    ${input.model}`);
+        this.line(`${muted("trace")}    ${input.trace ? "on" : "off"}`);
+        this.line("");
+        this.line(muted("Commands"));
+        for (const command of input.commands)
+            this.line(`  ${color(command.name, "cyan")} ${muted(command.description)}`);
+        this.line("");
+    }
+    prompt() {
+        return `${color("you", "gold")}> `;
+    }
+    status(label, detail) {
+        this.line(`${color("◇", "cyan")} ${label}${detail ? ` ${muted(detail)}` : ""}`);
+    }
+    trace(event) {
+        this.line(`${muted("[trace]")} ${event.type}: ${JSON.stringify(event)}`);
+    }
+    assistantStart() {
+        this.write(`${color("nexa", "gold")}> `);
+    }
+    token(text) {
+        this.write(text);
+    }
+    assistantEnd() {
+        this.line("\n");
+    }
+    toolResult(toolId, result) {
+        if (result.status === "ok")
+            this.line(`${color("tool", "cyan")}> ${toolId}: ${JSON.stringify(result.output)}`);
+        else
+            this.line(`${color("tool", "red")}> ${toolId}: ${JSON.stringify(result)}`);
+        this.line("");
+    }
+    line(text = "") {
+        this.output.write(`${text}\n`);
+    }
+    write(text) {
+        this.output.write(text);
+    }
+}
+export class ConsoleChatIntegration {
+    options;
+    renderer;
+    commands;
+    messages;
+    constructor(options) {
+        this.options = options;
+        this.renderer = new PremiumConsoleRenderer();
+        this.commands = [
+            toolsCommand,
+            exitCommand,
+            ...(options.commands ?? [])
+        ];
+        this.messages = [
+            {
+                role: "system",
+                content: options.systemPrompt ?? "You are Nexa, a concise and useful AI assistant running through @nexalab/agent-sdk."
+            }
+        ];
+    }
+    trace(event) {
+        if (this.options.trace ?? true)
+            this.renderer.trace(event);
+    }
+    async run(runOptions = {}) {
+        const input = runOptions.input ?? process.stdin;
+        const output = runOptions.output ?? process.stdout;
+        const scriptedInputs = input.isTTY ? null : readFileSync(0, "utf8").split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+        const rl = input.isTTY ? readline.createInterface({ input, output }) : null;
+        this.renderer.header({
+            providerId: this.options.providerLabel ?? this.options.providerId,
+            model: this.options.model,
+            commands: this.commands,
+            trace: this.options.trace ?? true,
+            ...(this.options.loadedEnvLabel ? { loadedEnvLabel: this.options.loadedEnvLabel } : {}),
+            ...(this.options.baseUrl ? { baseUrl: this.options.baseUrl } : {})
+        });
+        for (;;) {
+            const answer = scriptedInputs ? scriptedInputs.shift() ?? "/exit" : await rl.question(this.renderer.prompt()).catch(() => "/exit");
+            const text = answer.trim();
+            if (scriptedInputs)
+                this.renderer.line(`${this.renderer.prompt()}${text}`);
+            if (!text)
+                continue;
+            const command = this.commands.find((item) => item.name === text.split(/\s+/)[0]);
+            if (command) {
+                const result = await command.run({
+                    sdk: this.options.sdk,
+                    messages: this.messages,
+                    write: (line = "") => this.renderer.line(line)
+                });
+                if (result === "exit")
+                    break;
+                continue;
+            }
+            await this.answer(text);
+        }
+        rl?.close();
+    }
+    async answer(text) {
+        this.messages.push({ role: "user", content: text });
+        this.renderer.status("preparing agent turn");
+        const turn = await this.options.sdk.prepareTurnWithTools({
+            text,
+            messages: this.messages
+        });
+        this.renderer.status("agent run", `${turn.run.state} ${turn.run.runId}`);
+        if (turn.toolTurn.selectedTools.length) {
+            this.renderer.status("tools selected", turn.toolTurn.selectedTools.map((intent) => intent.tool.id).join(", "));
+        }
+        else {
+            this.renderer.status("tools selected", "none");
+        }
+        this.renderer.assistantStart();
+        let assistantText = "";
+        for await (const chunk of this.options.client.stream({
+            providerId: this.options.providerId,
+            model: this.options.model,
+            messages: turn.modelMessages,
+            stream: true
+        })) {
+            if (chunk.done)
+                break;
+            assistantText += chunk.text;
+            this.renderer.token(chunk.text);
+        }
+        this.renderer.assistantEnd();
+        this.messages.push({ role: "assistant", content: assistantText });
+        this.options.sdk.memory.write({
+            kind: "episode",
+            content: `User: ${text}\nAssistant: ${assistantText}`,
+            source: "console-chat",
+            tags: ["chat", this.options.providerId, this.options.model],
+            importance: 0.6
+        });
+        return assistantText;
+    }
+}
+export function createConsoleChatIntegration(options) {
+    return new ConsoleChatIntegration(options);
+}
+export async function createOpenAICompatibleConsoleAgent(options) {
+    const registry = new OpenAICompatibleRegistry();
+    registry.register({
+        ...options.provider,
+        ...(options.model ? { defaultModel: options.model } : {})
+    });
+    const client = new OpenAICompatibleChatClient(registry);
+    const model = options.model ?? options.provider.defaultModel ?? (await client.listModels(options.provider.id))[0]?.id;
+    if (!model)
+        throw new Error(`No model found for provider ${options.provider.id}.`);
+    const selectedModel = model;
+    const toolExecutor = new LocalToolExecutor();
+    for (const registration of options.tools ?? []) {
+        toolExecutor.register(registration.tool, registration.handler);
+    }
+    const sdk = createNexaAgentSdk({
+        reasoner: createOpenAICompatibleReasoner({ client, providerId: options.provider.id, model: selectedModel }),
+        tools: (options.tools ?? []).map((registration) => registration.tool),
+        toolExecutor,
+        trace: createConsoleTraceRenderer(options.trace ?? true)
+    });
+    const commands = (options.tools ?? []).flatMap((registration) => (registration.commands ?? []).map((command) => createToolCommand({
+        name: command.name,
+        description: command.description,
+        toolId: registration.tool.id,
+        ...(command.input ? { input: command.input } : {})
+    })));
+    const console = createConsoleChatIntegration({
+        sdk,
+        client,
+        providerId: options.provider.id,
+        providerLabel: options.provider.name,
+        baseUrl: options.provider.baseUrl,
+        model: selectedModel,
+        trace: options.trace ?? true,
+        commands,
+        ...(options.loadedEnvLabel ? { loadedEnvLabel: options.loadedEnvLabel } : {}),
+        ...(options.systemPrompt ? { systemPrompt: options.systemPrompt } : {})
+    });
+    async function streamMessage(text, streamInput = {}) {
+        const messages = streamInput.messages ?? [{ role: "system", content: options.systemPrompt ?? "You are Nexa, a concise and useful AI assistant running through @nexalab/agent-sdk." }];
+        streamInput.onStatus?.("user.message.received", text);
+        messages.push({ role: "user", content: text });
+        streamInput.onStatus?.("agent.turn.prepare");
+        const turn = await sdk.prepareTurnWithTools({ text, messages });
+        streamInput.onStatus?.("agent.run", `${turn.run.state} ${turn.run.runId}`);
+        streamInput.onStatus?.("tools.selected", turn.toolTurn.selectedTools.map((intent) => intent.tool.id).join(", ") || "none");
+        let assistantText = "";
+        streamInput.onStatus?.("model.stream.start", selectedModel);
+        for await (const chunk of client.stream({
+            providerId: options.provider.id,
+            model: selectedModel,
+            messages: turn.modelMessages,
+            stream: true
+        })) {
+            if (chunk.done)
+                break;
+            assistantText += chunk.text;
+            streamInput.onToken?.(chunk.text);
+        }
+        streamInput.onStatus?.("model.stream.done");
+        messages.push({ role: "assistant", content: assistantText });
+        return { text: assistantText, messages, toolTurn: turn.toolTurn };
+    }
+    async function runMessage(text, messages = [{ role: "system", content: options.systemPrompt ?? "You are Nexa, a concise and useful AI assistant running through @nexalab/agent-sdk." }]) {
+        return streamMessage(text, { messages });
+    }
+    return {
+        sdk,
+        client,
+        console,
+        model: selectedModel,
+        runMessage,
+        streamMessage,
+        run: (runOptions) => console.run(runOptions)
+    };
+}
+export const createAgentCLI = createOpenAICompatibleConsoleAgent;
+export function createConsoleTraceRenderer(enabled = true) {
+    const renderer = new PremiumConsoleRenderer();
+    return (event) => {
+        if (enabled)
+            renderer.trace(event);
+    };
+}
+export function createToolCommand(input) {
+    return {
+        name: input.name,
+        description: input.description,
+        async run(context) {
+            const result = await context.sdk.toolOrchestrator.executor.execute(input.toolId, input.input ?? {}, {
+                taskId: "console",
+                runId: "console",
+                stepId: `command-${input.name}`
+            });
+            context.write(`${input.toolId}: ${JSON.stringify(result)}`);
+            context.write("");
+            return "continue";
+        }
+    };
+}
+const toolsCommand = {
+    name: "/tools",
+    description: "list registered tools",
+    run(context) {
+        for (const tool of context.sdk.tools.list()) {
+            context.write(`${tool.id} -> capability=${tool.capability}, provider=${tool.provider}`);
+        }
+        context.write("");
+        return "continue";
+    }
+};
+const exitCommand = {
+    name: "/exit",
+    description: "exit",
+    run() {
+        return "exit";
+    }
+};
+function color(text, tone) {
+    const code = tone === "gold" ? 33 : tone === "cyan" ? 36 : 31;
+    return `\u001b[${code}m${text}\u001b[0m`;
+}
+function muted(text) {
+    return `\u001b[2m${text}\u001b[0m`;
+}
+//# sourceMappingURL=console-chat.js.map

package/dist/console-chat.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,45 @@
+import type { ChatMessage } from "./openai-compatible.js";
+import type { JsonObject } from "./types.js";
+export type ContextResolverInput = {
+    runId: string;
+    taskId: string;
+    text: string;
+};
+export type ContextSectionValue = string | JsonObject | null | undefined;
+export type ContextResolverFn = (input: ContextResolverInput) => ContextSectionValue | Promise<ContextSectionValue>;
+export type ContextSectionInput = string | JsonObject | ContextResolverFn;
+export type ContextEngineConfig = {
+    sections?: Record<string, ContextSectionInput>;
+    conversation?: boolean;
+    knowledge?: ContextSectionInput[];
+    dynamic?: ContextResolverFn;
+    maxTokens?: number;
+    compression?: boolean;
+};
+export type ContextBlock = {
+    id: string;
+    label: string;
+    content: string;
+    tokens: number;
+    priority: number;
+};
+export type BuiltContext = {
+    systemMessage: string;
+    blocks: ContextBlock[];
+    totalTokens: number;
+    truncated: boolean;
+};
+export type BuildContextInput = {
+    runId: string;
+    taskId: string;
+    text: string;
+    conversation?: ChatMessage[];
+};
+export declare class ContextEngine {
+    private readonly config;
+    constructor(config: ContextEngineConfig);
+    build(input: BuildContextInput): Promise<BuiltContext>;
+}
+export declare function createContextEngine(config: ContextEngineConfig): ContextEngine;
+export declare function estimateTokens(text: string): number;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,MAAM,oBAAoB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AACnF,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,GAAG,SAAS,CAAC;AACzE,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,oBAAoB,KAAK,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;AACpH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,UAAU,GAAG,iBAAiB,CAAC;AAE1E,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC/C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAClC,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5G,MAAM,MAAM,YAAY,GAAG;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;CAC9B,CAAC;AAYF,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,mBAAmB;IAElD,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;CA+B7D;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,aAAa,CAE9E;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/context.js

@@ -0,0 +1,92 @@
+const WELL_KNOWN_PRIORITY = {
+    identity: 100,
+    user: 90,
+    tenant: 85,
+    company: 85,
+    conversation: 70,
+    knowledge: 60,
+    dynamic: 50
+};
+export class ContextEngine {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async build(input) {
+        const resolverInput = { runId: input.runId, taskId: input.taskId, text: input.text };
+        const blocks = [];
+        for (const [id, section] of Object.entries(this.config.sections ?? {})) {
+            const value = await resolveSection(section, resolverInput);
+            if (value == null)
+                continue;
+            blocks.push(toBlock(id, id, value, WELL_KNOWN_PRIORITY[id] ?? 40));
+        }
+        if (this.config.conversation && input.conversation?.length) {
+            const transcript = input.conversation
+                .map((message) => `${message.role}: ${message.content}`)
+                .join("\n");
+            blocks.push(toBlock("conversation", "conversation", transcript, WELL_KNOWN_PRIORITY.conversation ?? 70));
+        }
+        for (const [index, source] of (this.config.knowledge ?? []).entries()) {
+            const value = await resolveSection(source, resolverInput);
+            if (value == null)
+                continue;
+            blocks.push(toBlock(`knowledge-${index}`, "knowledge", value, (WELL_KNOWN_PRIORITY.knowledge ?? 60) - index));
+        }
+        if (this.config.dynamic) {
+            const value = await this.config.dynamic(resolverInput);
+            if (value != null)
+                blocks.push(toBlock("dynamic", "dynamic", value, WELL_KNOWN_PRIORITY.dynamic ?? 50));
+        }
+        blocks.sort((a, b) => b.priority - a.priority);
+        return applyBudget(blocks, this.config);
+    }
+}
+export function createContextEngine(config) {
+    return new ContextEngine(config);
+}
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+async function resolveSection(section, input) {
+    const value = typeof section === "function" ? await section(input) : section;
+    return value;
+}
+function toBlock(id, label, value, priority) {
+    const content = typeof value === "string" ? value : JSON.stringify(value);
+    return { id, label, content, tokens: estimateTokens(content), priority };
+}
+// OSS reference strategy: plain char-count truncation, not context ranking or adaptive
+// compression. See docs/architecture/open-core-target.md (R3) — `dynamic`/section resolvers
+// are already the intended seam for a more advanced private ranking/compression strategy;
+// no SDK change is needed to plug one in.
+function applyBudget(blocks, config) {
+    const maxTokens = config.maxTokens;
+    if (!maxTokens)
+        return finalize(blocks, false);
+    let budget = maxTokens;
+    const kept = [];
+    let truncated = false;
+    for (const block of blocks) {
+        if (block.tokens <= budget) {
+            kept.push(block);
+            budget -= block.tokens;
+            continue;
+        }
+        if (config.compression && budget > 0) {
+            const maxChars = budget * 4;
+            kept.push({ ...block, content: `${block.content.slice(0, maxChars)}…`, tokens: budget });
+            budget = 0;
+            truncated = true;
+            continue;
+        }
+        truncated = true;
+    }
+    return finalize(kept, truncated);
+}
+function finalize(blocks, truncated) {
+    const systemMessage = blocks.map((block) => `## ${block.label}\n${block.content}`).join("\n\n");
+    const totalTokens = blocks.reduce((sum, block) => sum + block.tokens, 0);
+    return { systemMessage, blocks, totalTokens, truncated };
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/evals.d.ts

@@ -0,0 +1,38 @@
+import type { AgentMessageResult, OpenAICompatibleAgent } from "./openai-agent.js";
+import type { JsonObject } from "./types.js";
+export type AgentEvalCase = {
+    id: string;
+    input: string;
+    expected?: string[];
+    metadata?: JsonObject;
+};
+export type AgentEvalScore = {
+    passed: boolean;
+    score: number;
+    reason: string;
+};
+export type AgentEvalJudge = (input: {
+    testCase: AgentEvalCase;
+    result: AgentMessageResult;
+}) => Promise<AgentEvalScore> | AgentEvalScore;
+export type AgentEvalResult = {
+    id: string;
+    input: string;
+    output: string;
+    passed: boolean;
+    score: number;
+    reason: string;
+    metadata: JsonObject;
+};
+export type AgentEvalReport = {
+    passed: boolean;
+    score: number;
+    results: AgentEvalResult[];
+};
+export declare function runAgentEvals(input: {
+    agent: Pick<OpenAICompatibleAgent, "runMessage">;
+    cases: AgentEvalCase[];
+    judge?: AgentEvalJudge;
+}): Promise<AgentEvalReport>;
+export declare const keywordJudge: AgentEvalJudge;
+//# sourceMappingURL=evals.d.ts.map

package/dist/evals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evals.d.ts","sourceRoot":"","sources":["../src/evals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE;IACnC,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,kBAAkB,CAAC;CAC5B,KAAK,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAAC;AAE/C,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,UAAU,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B,CAAC;AAEF,wBAAsB,aAAa,CAAC,KAAK,EAAE;IACzC,KAAK,EAAE,IAAI,CAAC,qBAAqB,EAAE,YAAY,CAAC,CAAC;IACjD,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB,GAAG,OAAO,CAAC,eAAe,CAAC,CAsB3B;AAED,eAAO,MAAM,YAAY,EAAE,cAW1B,CAAC"}

package/dist/evals.js

@@ -0,0 +1,37 @@
+export async function runAgentEvals(input) {
+    const judge = input.judge ?? keywordJudge;
+    const results = [];
+    for (const testCase of input.cases) {
+        const result = await input.agent.runMessage(testCase.input);
+        const score = await judge({ testCase, result });
+        results.push({
+            id: testCase.id,
+            input: testCase.input,
+            output: result.text,
+            passed: score.passed,
+            score: score.score,
+            reason: score.reason,
+            metadata: testCase.metadata ?? {}
+        });
+    }
+    const average = results.length ? results.reduce((sum, result) => sum + result.score, 0) / results.length : 1;
+    return {
+        passed: results.every((result) => result.passed),
+        score: average,
+        results
+    };
+}
+export const keywordJudge = ({ testCase, result }) => {
+    const expected = testCase.expected ?? [];
+    if (!expected.length)
+        return { passed: Boolean(result.text.trim()), score: result.text.trim() ? 1 : 0, reason: "Output is non-empty." };
+    const normalized = result.text.toLowerCase();
+    const matched = expected.filter((term) => normalized.includes(term.toLowerCase()));
+    const score = matched.length / expected.length;
+    return {
+        passed: score === 1,
+        score,
+        reason: `Matched ${matched.length}/${expected.length} expected term(s).`
+    };
+};
+//# sourceMappingURL=evals.js.map

package/dist/evals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evals.js","sourceRoot":"","sources":["../src/evals.ts"],"names":[],"mappings":"AAqCA,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAInC;IACC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,YAAY,CAAC;IAC1C,MAAM,OAAO,GAAsB,EAAE,CAAC;IACtC,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC5D,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,QAAQ,CAAC,EAAE;YACf,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,MAAM,EAAE,MAAM,CAAC,IAAI;YACnB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,EAAE;SAClC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,GAAG,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7G,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;QAChD,KAAK,EAAE,OAAO;QACd,OAAO;KACR,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAmB,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE;IACnE,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC;IACzC,IAAI,CAAC,QAAQ,CAAC,MAAM;QAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC;IACxI,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IAC7C,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IACnF,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC/C,OAAO;QACL,MAAM,EAAE,KAAK,KAAK,CAAC;QACnB,KAAK;QACL,MAAM,EAAE,WAAW,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,oBAAoB;KACzE,CAAC;AACJ,CAAC,CAAC"}

package/dist/event-bus.d.ts

@@ -0,0 +1,28 @@
+import type { JsonValue } from "./types.js";
+import type { EventJournal } from "./storage.js";
+export type NexaSdkEvent<T extends JsonValue = JsonValue> = {
+    id: string;
+    type: string;
+    source: string;
+    taskId?: string;
+    runId?: string;
+    missionId?: string;
+    stepId?: string;
+    visibility?: "user" | "technical";
+    payload: T;
+    at: string;
+};
+export type EventHandler = (event: NexaSdkEvent) => void | Promise<void>;
+export declare class EventBus {
+    private readonly persistentJournal?;
+    private readonly handlers;
+    private readonly journal;
+    constructor(persistentJournal?: EventJournal | undefined);
+    subscribe(handler: EventHandler): () => void;
+    list(): NexaSdkEvent[];
+    publish(input: Omit<NexaSdkEvent, "id" | "at"> & {
+        id?: string;
+        at?: string;
+    }): Promise<NexaSdkEvent>;
+}
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../src/event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,IAAI;IAC1D,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAClC,OAAO,EAAE,CAAC,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEzE,qBAAa,QAAQ;IAIP,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IAH/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;gBAEjB,iBAAiB,CAAC,EAAE,YAAY,YAAA;IAE7D,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,IAAI;IAK5C,IAAI,IAAI,YAAY,EAAE;IAIhB,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,IAAI,CAAC,GAAG;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;CAW5G"}

package/dist/event-bus.js

@@ -0,0 +1,28 @@
+export class EventBus {
+    persistentJournal;
+    handlers = new Set();
+    journal = [];
+    constructor(persistentJournal) {
+        this.persistentJournal = persistentJournal;
+    }
+    subscribe(handler) {
+        this.handlers.add(handler);
+        return () => this.handlers.delete(handler);
+    }
+    list() {
+        return [...this.journal];
+    }
+    async publish(input) {
+        const event = {
+            ...input,
+            id: input.id ?? crypto.randomUUID(),
+            at: input.at ?? new Date().toISOString()
+        };
+        this.journal.push(event);
+        await this.persistentJournal?.appendEvent(event);
+        for (const handler of this.handlers)
+            await handler(event);
+        return event;
+    }
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../src/event-bus.ts"],"names":[],"mappings":"AAkBA,MAAM,OAAO,QAAQ;IAIU;IAHZ,QAAQ,GAAG,IAAI,GAAG,EAAgB,CAAC;IACnC,OAAO,GAAmB,EAAE,CAAC;IAE9C,YAA6B,iBAAgC;QAAhC,sBAAiB,GAAjB,iBAAiB,CAAe;IAAG,CAAC;IAEjE,SAAS,CAAC,OAAqB;QAC7B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAqE;QACjF,MAAM,KAAK,GAAiB;YAC1B,GAAG,KAAK;YACR,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,MAAM,CAAC,UAAU,EAAE;YACnC,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACzC,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,MAAM,IAAI,CAAC,iBAAiB,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC;QACjD,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ;YAAE,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;QAC1D,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/file-storage.d.ts

@@ -0,0 +1,25 @@
+import type { ApprovalRequest } from "./approvals.js";
+import type { NexaSdkEvent } from "./event-bus.js";
+import type { MemoryRecord } from "./memory.js";
+import type { NexaStorage } from "./storage.js";
+import type { AgentRunSnapshot } from "./types.js";
+import type { WorkflowRun } from "./workflow.js";
+export declare class JsonFileStorage implements NexaStorage {
+    private readonly rootDir;
+    constructor(rootDir: string);
+    saveRun(run: AgentRunSnapshot): Promise<void>;
+    getRun(runId: string): Promise<AgentRunSnapshot | undefined>;
+    listRuns(): Promise<AgentRunSnapshot[]>;
+    appendEvent(event: NexaSdkEvent): Promise<void>;
+    listEvents(): Promise<NexaSdkEvent[]>;
+    saveMemory(record: MemoryRecord): Promise<void>;
+    listMemories(): Promise<MemoryRecord[]>;
+    saveApproval(approval: ApprovalRequest): Promise<void>;
+    getApproval(id: string): Promise<ApprovalRequest | undefined>;
+    listApprovals(status?: ApprovalRequest["status"]): Promise<ApprovalRequest[]>;
+    saveWorkflow(run: WorkflowRun): Promise<void>;
+    getWorkflow(id: string): Promise<WorkflowRun | undefined>;
+    private path;
+}
+export declare function createJsonFileStorage(rootDir: string): JsonFileStorage;
+//# sourceMappingURL=file-storage.d.ts.map

package/dist/file-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-storage.d.ts","sourceRoot":"","sources":["../src/file-storage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,qBAAa,eAAgB,YAAW,WAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,MAAM;IAEtC,OAAO,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAI5D,QAAQ,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAIvC,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/C,UAAU,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAIrC,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/C,YAAY,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAIvC,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAStD,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAI7D,aAAa,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAK7E,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAI/D,OAAO,CAAC,IAAI;CAGb;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAEtE"}