@nexalab/agent-sdk 0.1.0

package/dist/agent-builder.d.ts

@@ -0,0 +1,60 @@
+import { type AgentToolRegistration, type OpenAICompatibleAgent, type OpenAICompatibleAgentOptions } from "./openai-agent.js";
+import { type ConsoleToolRegistration, type OpenAICompatibleConsoleAgent } from "./console-chat.js";
+import type { LocalToolContext, LocalToolHandler } from "./local-tool-executor.js";
+import type { ToolDefinition, ToolExecutionResult } from "./tool-registry.js";
+import type { JsonObject } from "./types.js";
+import type { OpenAICompatibleProviderConfig } from "./openai-compatible.js";
+import type { ToolRouter, ToolTraceEvent } from "./tool-orchestrator.js";
+import type { NexaStorage } from "./storage.js";
+import type { NexaTelemetry } from "./telemetry.js";
+import type { ModelRouter } from "./model-router.js";
+export declare abstract class AgentTool {
+    abstract readonly definition: ToolDefinition;
+    abstract execute(input: JsonObject, context: LocalToolContext): Promise<ToolExecutionResult> | ToolExecutionResult;
+    asRegistration(): AgentToolRegistration;
+    asConsoleRegistration(commands?: ConsoleToolRegistration["commands"]): ConsoleToolRegistration;
+}
+export declare class FunctionTool extends AgentTool {
+    readonly definition: ToolDefinition;
+    private readonly handler;
+    constructor(definition: ToolDefinition, handler: LocalToolHandler);
+    execute(input: JsonObject, context: LocalToolContext): Promise<ToolExecutionResult> | ToolExecutionResult;
+}
+export declare function defineTool(definition: ToolDefinition, handler: LocalToolHandler): AgentTool;
+export declare class AgentBuilder {
+    private providerConfig;
+    private modelId;
+    private prompt;
+    private traceHandler;
+    private router;
+    private storage;
+    private telemetry;
+    private modelRouter;
+    private readonly tools;
+    useProvider(provider: OpenAICompatibleProviderConfig): this;
+    useModel(model: string): this;
+    useSystemPrompt(prompt: string): this;
+    useTool(tool: AgentTool | AgentToolRegistration): this;
+    useTools(tools: Array<AgentTool | AgentToolRegistration>): this;
+    useRouter(router: ToolRouter): this;
+    useTrace(trace: (event: ToolTraceEvent) => void): this;
+    useStorage(storage: NexaStorage): this;
+    useTelemetry(telemetry: NexaTelemetry): this;
+    useModelRouter(router: ModelRouter): this;
+    useConsoleTrace(enabled?: boolean): this;
+    build(): Promise<OpenAICompatibleAgent>;
+    buildCLI(input?: {
+        loadedEnvLabel?: string;
+        commands?: Array<{
+            tool?: AgentTool | ToolDefinition;
+            toolId?: string;
+            commands: ConsoleToolRegistration["commands"];
+        }>;
+    }): Promise<OpenAICompatibleConsoleAgent>;
+    private toAgentOptions;
+    private requireProvider;
+}
+export declare function createAgentBuilder(): AgentBuilder;
+export declare function createAgent(): AgentBuilder;
+export declare function createAgent(options: OpenAICompatibleAgentOptions): Promise<OpenAICompatibleAgent>;
+//# sourceMappingURL=agent-builder.d.ts.map

package/dist/agent-builder.d.ts.map

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

package/dist/agent-builder.js

@@ -0,0 +1,141 @@
+import { createOpenAICompatibleAgent } from "./openai-agent.js";
+import { createAgentCLI, createConsoleTraceRenderer } from "./console-chat.js";
+export class AgentTool {
+    asRegistration() {
+        return {
+            tool: this.definition,
+            handler: (input, context) => this.execute(input, context)
+        };
+    }
+    asConsoleRegistration(commands = []) {
+        return {
+            ...this.asRegistration(),
+            commands
+        };
+    }
+}
+export class FunctionTool extends AgentTool {
+    definition;
+    handler;
+    constructor(definition, handler) {
+        super();
+        this.definition = definition;
+        this.handler = handler;
+    }
+    execute(input, context) {
+        return this.handler(input, context);
+    }
+}
+export function defineTool(definition, handler) {
+    return new FunctionTool(definition, handler);
+}
+export class AgentBuilder {
+    providerConfig;
+    modelId;
+    prompt;
+    traceHandler;
+    router;
+    storage;
+    telemetry;
+    modelRouter;
+    tools = [];
+    useProvider(provider) {
+        this.providerConfig = provider;
+        return this;
+    }
+    useModel(model) {
+        if (model)
+            this.modelId = model;
+        return this;
+    }
+    useSystemPrompt(prompt) {
+        this.prompt = prompt;
+        return this;
+    }
+    useTool(tool) {
+        this.tools.push("asRegistration" in tool ? tool.asRegistration() : tool);
+        return this;
+    }
+    useTools(tools) {
+        for (const tool of tools)
+            this.useTool(tool);
+        return this;
+    }
+    useRouter(router) {
+        this.router = router;
+        return this;
+    }
+    useTrace(trace) {
+        this.traceHandler = trace;
+        return this;
+    }
+    useStorage(storage) {
+        this.storage = storage;
+        return this;
+    }
+    useTelemetry(telemetry) {
+        this.telemetry = telemetry;
+        return this;
+    }
+    useModelRouter(router) {
+        this.modelRouter = router;
+        return this;
+    }
+    useConsoleTrace(enabled = true) {
+        this.traceHandler = createConsoleTraceRenderer(enabled);
+        return this;
+    }
+    async build() {
+        return createOpenAICompatibleAgent(this.toAgentOptions());
+    }
+    async buildCLI(input = {}) {
+        const provider = this.requireProvider();
+        const consoleTools = this.tools.map((registration) => {
+            const commandConfig = input.commands?.find((item) => commandToolId(item) === registration.tool.id);
+            return {
+                ...registration,
+                ...(commandConfig?.commands ? { commands: commandConfig.commands } : {})
+            };
+        });
+        return createAgentCLI({
+            provider,
+            tools: consoleTools,
+            ...(this.modelId ? { model: this.modelId } : {}),
+            ...(input.loadedEnvLabel ? { loadedEnvLabel: input.loadedEnvLabel } : {}),
+            ...(this.prompt ? { systemPrompt: this.prompt } : {}),
+            trace: Boolean(this.traceHandler)
+        });
+    }
+    toAgentOptions() {
+        return {
+            provider: this.requireProvider(),
+            tools: this.tools,
+            ...(this.modelId ? { model: this.modelId } : {}),
+            ...(this.prompt ? { systemPrompt: this.prompt } : {}),
+            ...(this.traceHandler ? { trace: this.traceHandler } : {}),
+            ...(this.router ? { toolRouter: this.router } : {}),
+            ...(this.storage ? { storage: this.storage } : {}),
+            ...(this.telemetry ? { telemetry: this.telemetry } : {}),
+            ...(this.modelRouter ? { modelRouter: this.modelRouter } : {})
+        };
+    }
+    requireProvider() {
+        if (!this.providerConfig)
+            throw new Error("AgentBuilder needs a provider. Call useProvider(...) before build().");
+        return this.providerConfig;
+    }
+}
+function commandToolId(input) {
+    if (input.toolId)
+        return input.toolId;
+    if (!input.tool)
+        return undefined;
+    return "definition" in input.tool ? input.tool.definition.id : input.tool.id;
+}
+export function createAgentBuilder() {
+    return new AgentBuilder();
+}
+export function createAgent(options) {
+    return options ? createOpenAICompatibleAgent(options) : createAgentBuilder();
+}
+//# sourceMappingURL=agent-builder.js.map

package/dist/agent-builder.js.map

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

package/dist/approvals.d.ts

@@ -0,0 +1,34 @@
+import type { JsonObject } from "./types.js";
+import type { ApprovalStore } from "./storage.js";
+export type ApprovalRisk = "SAFE_READ" | "LOCAL_WRITE" | "EXTERNAL_WRITE" | "INSTALL_DEPENDENCY" | "CREDENTIAL_ACCESS" | "ACCOUNT_CONNECTION" | "SENSITIVE_DATA" | "DESTRUCTIVE" | "FINANCIAL" | "PRIVILEGED_EXECUTION";
+export type ApprovalStatus = "pending" | "approved" | "denied" | "expired";
+export type ApprovalRequest = {
+    id: string;
+    risk: ApprovalRisk;
+    reason: string;
+    toolId?: string;
+    taskId?: string;
+    runId?: string;
+    stepId?: string;
+    metadata: JsonObject;
+    status: ApprovalStatus;
+    createdAt: string;
+    resolvedAt?: string;
+};
+export declare class ApprovalRequiredError extends Error {
+    readonly approvalId: string;
+    constructor(message: string, approvalId: string);
+}
+export declare class ApprovalManager {
+    private readonly store?;
+    private readonly approvals;
+    constructor(store?: ApprovalStore | undefined);
+    request(input: Omit<ApprovalRequest, "id" | "status" | "createdAt" | "metadata"> & {
+        metadata?: JsonObject;
+    }): ApprovalRequest;
+    resolve(id: string, status: "approved" | "denied"): ApprovalRequest;
+    get(id: string): Promise<ApprovalRequest | undefined>;
+    list(status?: ApprovalStatus): Promise<ApprovalRequest[]>;
+    resume(id: string): Promise<ApprovalRequest>;
+}
+//# sourceMappingURL=approvals.d.ts.map

package/dist/approvals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approvals.d.ts","sourceRoot":"","sources":["../src/approvals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,aAAa,GACb,gBAAgB,GAChB,oBAAoB,GACpB,mBAAmB,GACnB,oBAAoB,GACpB,gBAAgB,GAChB,aAAa,GACb,WAAW,GACX,sBAAsB,CAAC;AAE3B,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE3E,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,UAAU,CAAC;IACrB,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,qBAAa,qBAAsB,SAAQ,KAAK;IAG5C,QAAQ,CAAC,UAAU,EAAE,MAAM;gBAD3B,OAAO,EAAE,MAAM,EACN,UAAU,EAAE,MAAM;CAK9B;AAED,qBAAa,eAAe;IAGd,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IAFnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsC;gBAEnC,KAAK,CAAC,EAAE,aAAa,YAAA;IAElD,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC,GAAG;QAAE,QAAQ,CAAC,EAAE,UAAU,CAAA;KAAE,GAAG,eAAe;IAa9H,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,eAAe;IAS7D,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAIrD,IAAI,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAMzD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;CAMnD"}

package/dist/approvals.js

@@ -0,0 +1,54 @@
+export class ApprovalRequiredError extends Error {
+    approvalId;
+    constructor(message, approvalId) {
+        super(message);
+        this.approvalId = approvalId;
+        this.name = "ApprovalRequiredError";
+    }
+}
+export class ApprovalManager {
+    store;
+    approvals = new Map();
+    constructor(store) {
+        this.store = store;
+    }
+    request(input) {
+        const approval = {
+            ...input,
+            id: crypto.randomUUID(),
+            status: "pending",
+            metadata: input.metadata ?? {},
+            createdAt: new Date().toISOString()
+        };
+        this.approvals.set(approval.id, approval);
+        void this.store?.saveApproval(approval);
+        return approval;
+    }
+    resolve(id, status) {
+        const approval = this.approvals.get(id);
+        if (!approval)
+            throw new Error(`Approval not found: ${id}`);
+        const resolved = { ...approval, status, resolvedAt: new Date().toISOString() };
+        this.approvals.set(id, resolved);
+        void this.store?.saveApproval(resolved);
+        return resolved;
+    }
+    async get(id) {
+        return this.approvals.get(id) ?? await this.store?.getApproval(id);
+    }
+    async list(status) {
+        const stored = await this.store?.listApprovals(status);
+        if (stored)
+            return stored;
+        return [...this.approvals.values()].filter((approval) => !status || approval.status === status);
+    }
+    async resume(id) {
+        const approval = await this.get(id);
+        if (!approval)
+            throw new Error(`Approval not found: ${id}`);
+        if (approval.status !== "approved")
+            throw new ApprovalRequiredError(`Approval is not resolved as approved: ${id}`, id);
+        return approval;
+    }
+}
+//# sourceMappingURL=approvals.js.map

package/dist/approvals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approvals.js","sourceRoot":"","sources":["../src/approvals.ts"],"names":[],"mappings":"AA+BA,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAGnC;IAFX,YACE,OAAe,EACN,UAAkB;QAE3B,KAAK,CAAC,OAAO,CAAC,CAAC;QAFN,eAAU,GAAV,UAAU,CAAQ;QAG3B,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,OAAO,eAAe;IAGG;IAFZ,SAAS,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEhE,YAA6B,KAAqB;QAArB,UAAK,GAAL,KAAK,CAAgB;IAAG,CAAC;IAEtD,OAAO,CAAC,KAAoG;QAC1G,MAAM,QAAQ,GAAoB;YAChC,GAAG,KAAK;YACR,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;YACvB,MAAM,EAAE,SAAS;YACjB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE;YAC9B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QACF,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC1C,KAAK,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;QACxC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,EAAU,EAAE,MAA6B;QAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC;QAC5D,MAAM,QAAQ,GAAG,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;QAC/E,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QACjC,KAAK,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;QACxC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,MAAM,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAuB;QAChC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;QACvD,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAC1B,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IAClG,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC;QAC5D,IAAI,QAAQ,CAAC,MAAM,KAAK,UAAU;YAAE,MAAM,IAAI,qBAAqB,CAAC,yCAAyC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACvH,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/dist/artifacts.d.ts

@@ -0,0 +1,13 @@
+import type { ToolExecutionResult } from "./tool-registry.js";
+import type { AgentMessageResult } from "./openai-agent.js";
+export type ArtifactKind = "file" | "image" | "report" | "json" | "code" | "spreadsheet" | "chart" | "document" | "ui";
+export type Artifact = {
+    type: ArtifactKind;
+    name: string;
+    toolId?: string;
+    mimeType?: string;
+    uri?: string;
+};
+export declare function artifactsFromToolResult(toolId: string, result: ToolExecutionResult): Artifact[];
+export declare function artifactsFromRunResult(result: Pick<AgentMessageResult, "toolTurn" | "nativeToolTurn">): Artifact[];
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../src/artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,IAAI,CAAC;AAEvH,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,QAAQ,EAAE,CAK/F;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE,UAAU,GAAG,gBAAgB,CAAC,GAAG,QAAQ,EAAE,CAIlH"}

package/dist/artifacts.js

@@ -0,0 +1,13 @@
+export function artifactsFromToolResult(toolId, result) {
+    if (result.status !== "ok")
+        return [];
+    return (result.evidence ?? [])
+        .filter((item) => item.kind === "artifact")
+        .map((item) => ({ type: "file", name: item.summary, toolId, ...(item.uri ? { uri: item.uri } : {}) }));
+}
+export function artifactsFromRunResult(result) {
+    const fromTransparent = result.toolTurn.results.flatMap((entry) => artifactsFromToolResult(entry.tool.id, entry.result));
+    const fromNative = (result.nativeToolTurn?.toolResults ?? []).flatMap((entry) => artifactsFromToolResult(entry.tool.id, entry.result));
+    return [...fromTransparent, ...fromNative];
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../src/artifacts.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,uBAAuB,CAAC,MAAc,EAAE,MAA2B;IACjF,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACtC,OAAO,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;SAC3B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC;SAC1C,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACpH,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAA+D;IACpG,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,uBAAuB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACzH,MAAM,UAAU,GAAG,CAAC,MAAM,CAAC,cAAc,EAAE,WAAW,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,uBAAuB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACvI,OAAO,CAAC,GAAG,eAAe,EAAE,GAAG,UAAU,CAAC,CAAC;AAC7C,CAAC"}

package/dist/cache.d.ts

@@ -0,0 +1,17 @@
+export type Cache = {
+    get<T = unknown>(key: string): T | undefined;
+    set<T = unknown>(key: string, value: T, ttlMs?: number): void;
+    has(key: string): boolean;
+    delete(key: string): void;
+    clear(): void;
+};
+export declare class InMemoryCache implements Cache {
+    private readonly entries;
+    get<T = unknown>(key: string): T | undefined;
+    set<T = unknown>(key: string, value: T, ttlMs?: number): void;
+    has(key: string): boolean;
+    delete(key: string): void;
+    clear(): void;
+}
+export declare function createInMemoryCache(): InMemoryCache;
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,GAAG;IAClB,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAC7C,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,IAAI,IAAI,CAAC;CACf,CAAC;AAIF,qBAAa,aAAc,YAAW,KAAK;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;IAElE,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAU5C,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAI7D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB,KAAK,IAAI,IAAI;CAGd;AAED,wBAAgB,mBAAmB,IAAI,aAAa,CAEnD"}

package/dist/cache.js

@@ -0,0 +1,29 @@
+export class InMemoryCache {
+    entries = new Map();
+    get(key) {
+        const entry = this.entries.get(key);
+        if (!entry)
+            return undefined;
+        if (entry.expiresAt !== undefined && entry.expiresAt < Date.now()) {
+            this.entries.delete(key);
+            return undefined;
+        }
+        return entry.value;
+    }
+    set(key, value, ttlMs) {
+        this.entries.set(key, { value, ...(ttlMs ? { expiresAt: Date.now() + ttlMs } : {}) });
+    }
+    has(key) {
+        return this.get(key) !== undefined;
+    }
+    delete(key) {
+        this.entries.delete(key);
+    }
+    clear() {
+        this.entries.clear();
+    }
+}
+export function createInMemoryCache() {
+    return new InMemoryCache();
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,aAAa;IACP,OAAO,GAAG,IAAI,GAAG,EAA+B,CAAC;IAElE,GAAG,CAAc,GAAW;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAClE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,KAAK,CAAC,KAAU,CAAC;IAC1B,CAAC;IAED,GAAG,CAAc,GAAW,EAAE,KAAQ,EAAE,KAAc;QACpD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACxF,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;IACrC,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,aAAa,EAAE,CAAC;AAC7B,CAAC"}

package/dist/completion-gate.d.ts

@@ -0,0 +1,5 @@
+import type { AgentObservation, CompletionDecision, SuccessCriterion } from "./types.js";
+export declare class CompletionGate {
+    evaluate(criteria: SuccessCriterion[], observations: AgentObservation[]): CompletionDecision;
+}
+//# sourceMappingURL=completion-gate.d.ts.map

package/dist/completion-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-gate.d.ts","sourceRoot":"","sources":["../src/completion-gate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,gBAAgB,EAA0B,MAAM,YAAY,CAAC;AAEjH,qBAAa,cAAc;IACzB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,EAAE,EAAE,YAAY,EAAE,gBAAgB,EAAE,GAAG,kBAAkB;CAkB7F"}

package/dist/completion-gate.js

@@ -0,0 +1,20 @@
+export class CompletionGate {
+    evaluate(criteria, observations) {
+        const evidence = observations.flatMap((observation) => observation.evidence);
+        const evaluations = criteria.map((criterion) => {
+            const matches = evidence.filter((item) => criterion.requiredEvidence.length === 0 || criterion.requiredEvidence.some((requirement) => requirement.kind === item.kind));
+            const status = matches.length > 0 ? "SATISFIED" : criterion.required ? "UNKNOWN" : "UNSATISFIED";
+            return {
+                criterionId: criterion.id,
+                status,
+                evidenceRefs: matches.map((item) => item.id),
+                reason: matches.length > 0 ? "Criterion is backed by normalized evidence." : "No sufficient evidence for this criterion."
+            };
+        });
+        const requiredOpen = evaluations.filter((item) => item.status !== "SATISFIED" && criteria.find((criterion) => criterion.id === item.criterionId)?.required);
+        if (requiredOpen.length)
+            return { type: "INCOMPLETE", criteria: evaluations, reason: "Required criteria are missing evidence." };
+        return { type: "COMPLETE", criteria: evaluations, reason: "All required criteria are satisfied." };
+    }
+}
+//# sourceMappingURL=completion-gate.js.map

package/dist/completion-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-gate.js","sourceRoot":"","sources":["../src/completion-gate.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,cAAc;IACzB,QAAQ,CAAC,QAA4B,EAAE,YAAgC;QACrE,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC7E,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE;YAC7C,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAC7B,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CACtI,CAAC;YACF,MAAM,MAAM,GAA2B,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC;YACzH,OAAO;gBACL,WAAW,EAAE,SAAS,CAAC,EAAE;gBACzB,MAAM;gBACN,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5C,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,6CAA6C,CAAC,CAAC,CAAC,4CAA4C;aAC1H,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,IAAI,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC5J,IAAI,YAAY,CAAC,MAAM;YAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,yCAAyC,EAAE,CAAC;QACjI,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,sCAAsC,EAAE,CAAC;IACrG,CAAC;CACF"}

package/dist/console-chat.d.ts

@@ -0,0 +1,110 @@
+import type { Writable } from "node:stream";
+import type { NexaAgentSdk } from "./sdk.js";
+import { OpenAICompatibleChatClient, type ChatMessage, type OpenAICompatibleProviderConfig } from "./openai-compatible.js";
+import { type LocalToolHandler } from "./local-tool-executor.js";
+import type { ToolDefinition, ToolExecutionResult } from "./tool-registry.js";
+import type { JsonObject } from "./types.js";
+import type { AgentMessageResult } from "./openai-agent.js";
+import type { ToolTraceEvent } from "./tool-orchestrator.js";
+export type ConsoleCommandContext = {
+    sdk: NexaAgentSdk;
+    messages: ChatMessage[];
+    write(line?: string): void;
+};
+export type ConsoleCommand = {
+    name: string;
+    description: string;
+    run(context: ConsoleCommandContext): Promise<"continue" | "exit"> | "continue" | "exit";
+};
+export type ConsoleChatIntegrationOptions = {
+    sdk: NexaAgentSdk;
+    client: OpenAICompatibleChatClient;
+    providerId: string;
+    model: string;
+    providerLabel?: string;
+    baseUrl?: string;
+    loadedEnvLabel?: string;
+    systemPrompt?: string;
+    trace?: boolean;
+    commands?: ConsoleCommand[];
+};
+export type ConsoleToolRegistration = {
+    tool: ToolDefinition;
+    handler: LocalToolHandler;
+    commands?: Array<{
+        name: string;
+        description: string;
+        input?: Record<string, unknown>;
+    }>;
+};
+export type OpenAICompatibleConsoleAgentOptions = {
+    provider: OpenAICompatibleProviderConfig;
+    tools?: ConsoleToolRegistration[];
+    model?: string;
+    loadedEnvLabel?: string;
+    systemPrompt?: string;
+    trace?: boolean;
+};
+export type OpenAICompatibleConsoleAgent = {
+    sdk: NexaAgentSdk;
+    client: OpenAICompatibleChatClient;
+    console: ConsoleChatIntegration;
+    model: string;
+    runMessage(text: string, messages?: ChatMessage[]): Promise<{
+        text: string;
+        messages: ChatMessage[];
+        toolTurn: Awaited<ReturnType<NexaAgentSdk["prepareTurnWithTools"]>>["toolTurn"];
+    }>;
+    streamMessage(text: string, input?: {
+        messages?: ChatMessage[];
+        onStatus?: (label: string, detail?: string) => void;
+        onToken?: (token: string) => void;
+    }): Promise<AgentMessageResult>;
+    run(options?: ConsoleRunOptions): Promise<void>;
+};
+export type ConsoleRunOptions = {
+    input?: NodeJS.ReadStream;
+    output?: NodeJS.WriteStream;
+};
+export declare class PremiumConsoleRenderer {
+    private readonly output;
+    constructor(output?: Writable);
+    header(input: {
+        loadedEnvLabel?: string;
+        providerId: string;
+        baseUrl?: string;
+        model: string;
+        commands: ConsoleCommand[];
+        trace: boolean;
+    }): void;
+    prompt(): string;
+    status(label: string, detail?: string): void;
+    trace(event: ToolTraceEvent): void;
+    assistantStart(): void;
+    token(text: string): void;
+    assistantEnd(): void;
+    toolResult(toolId: string, result: ToolExecutionResult): void;
+    line(text?: string): void;
+    write(text: string): void;
+}
+export declare class ConsoleChatIntegration {
+    private readonly options;
+    private readonly renderer;
+    private readonly commands;
+    private readonly messages;
+    constructor(options: ConsoleChatIntegrationOptions);
+    trace(event: ToolTraceEvent): void;
+    run(runOptions?: ConsoleRunOptions): Promise<void>;
+    answer(text: string): Promise<string>;
+}
+export declare function createConsoleChatIntegration(options: ConsoleChatIntegrationOptions): ConsoleChatIntegration;
+export declare function createOpenAICompatibleConsoleAgent(options: OpenAICompatibleConsoleAgentOptions): Promise<OpenAICompatibleConsoleAgent>;
+export declare const createAgentCLI: typeof createOpenAICompatibleConsoleAgent;
+export declare function createConsoleTraceRenderer(enabled?: boolean): (event: ToolTraceEvent) => void;
+export declare function createToolCommand(input: {
+    name: string;
+    description: string;
+    toolId: string;
+    input?: JsonObject;
+}): ConsoleCommand;
+//# sourceMappingURL=console-chat.d.ts.map

package/dist/console-chat.d.ts.map

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