@nexalab/agent-sdk 0.1.0

package/dist/runtime.d.ts

@@ -0,0 +1,54 @@
+import { type AgentPlan, type AgentRunSnapshot, type InterpretedGoal, type SuccessCriterion } from "./types.js";
+import { ToolRegistry, type ToolExecutor } from "./tool-registry.js";
+import type { PermissionMatrix } from "./permissions.js";
+import type { EventBus } from "./event-bus.js";
+import type { RunStore } from "./storage.js";
+import type { HookDispatcher } from "./hooks.js";
+export type AgentReasoner = {
+    interpretGoal(input: {
+        objective: string;
+        taskId: string;
+        runId: string;
+    }): Promise<InterpretedGoal>;
+    defineSuccessCriteria(input: {
+        goal: InterpretedGoal;
+        taskId: string;
+        runId: string;
+    }): Promise<SuccessCriterion[]>;
+    createPlan(input: {
+        taskId: string;
+        runId: string;
+        goal: InterpretedGoal;
+        criteria: SuccessCriterion[];
+    }): Promise<AgentPlan>;
+};
+export type AgentRuntimeOptions = {
+    reasoner: AgentReasoner;
+    toolRegistry?: ToolRegistry;
+    toolExecutor?: ToolExecutor;
+    permissions?: PermissionMatrix;
+    workspaceRoot?: string;
+    events?: EventBus;
+    runStore?: RunStore;
+    hooks?: HookDispatcher;
+};
+export declare class AgentRuntime {
+    private readonly options;
+    private readonly runs;
+    private readonly validator;
+    private readonly completionGate;
+    private readonly loopGuard;
+    private readonly toolRegistry;
+    constructor(options: AgentRuntimeOptions);
+    createRun(objective: string): AgentRunSnapshot;
+    getRun(runId: string): AgentRunSnapshot | undefined;
+    prepare(runId: string): Promise<AgentRunSnapshot>;
+    runToCompletion(runId: string, signal?: AbortSignal): Promise<AgentRunSnapshot>;
+    private executeStep;
+    private dependenciesSatisfied;
+    private requireRun;
+    private persistRun;
+    private recordEvent;
+    private publishRunEvent;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAA0G,KAAK,SAAS,EAAE,KAAK,gBAAgB,EAAkB,KAAK,eAAe,EAAmB,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAIzP,OAAO,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,MAAM,aAAa,GAAG;IAC1B,aAAa,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACrG,qBAAqB,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,eAAe,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACpH,UAAU,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,eAAe,CAAC;QAAC,QAAQ,EAAE,gBAAgB,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CAC/H,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,aAAa,CAAC;IACxB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB,CAAC;AAqBF,qBAAa,YAAY;IAOX,OAAO,CAAC,QAAQ,CAAC,OAAO;IANpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuC;IAC5D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwB;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;gBAEf,OAAO,EAAE,mBAAmB;IAIzD,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB;IAoB9C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI7C,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAwBjD,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC;YA0EvE,WAAW;IA2CzB,OAAO,CAAC,qBAAqB;IAI7B,OAAO,CAAC,UAAU;YAMJ,UAAU;YAIV,WAAW;YAKX,eAAe;CAW9B"}

package/dist/runtime.js

@@ -0,0 +1,218 @@
+import { randomUUID } from "node:crypto";
+import { agentObservationSchema, agentPlanSchema, interpretedGoalSchema } from "./types.js";
+import { CompletionGate } from "./completion-gate.js";
+import { LoopGuard } from "./loop-guard.js";
+import { PlanValidator } from "./plan-validator.js";
+import { ToolRegistry } from "./tool-registry.js";
+function nowIso() {
+    return new Date().toISOString();
+}
+function event(payload) {
+    return { ...payload, at: nowIso() };
+}
+function delay(ms, signal) {
+    if (ms <= 0)
+        return Promise.resolve();
+    return new Promise((resolvePromise) => {
+        const timer = setTimeout(resolvePromise, ms);
+        signal?.addEventListener("abort", () => {
+            clearTimeout(timer);
+            resolvePromise();
+        }, { once: true });
+    });
+}
+export class AgentRuntime {
+    options;
+    runs = new Map();
+    validator = new PlanValidator();
+    completionGate = new CompletionGate();
+    loopGuard = new LoopGuard();
+    toolRegistry;
+    constructor(options) {
+        this.options = options;
+        this.toolRegistry = options.toolRegistry ?? new ToolRegistry();
+    }
+    createRun(objective) {
+        const taskId = randomUUID();
+        const runId = randomUUID();
+        const createdAt = nowIso();
+        const snapshot = {
+            taskId,
+            runId,
+            state: "RECEIVED",
+            objective,
+            observations: [],
+            events: [],
+            createdAt,
+            updatedAt: createdAt
+        };
+        void this.recordEvent(snapshot, event({ type: "task.created", taskId, runId, objective }));
+        this.runs.set(runId, snapshot);
+        void this.persistRun(snapshot);
+        return snapshot;
+    }
+    getRun(runId) {
+        return this.runs.get(runId);
+    }
+    async prepare(runId) {
+        const run = this.requireRun(runId);
+        run.state = "UNDERSTANDING";
+        run.goal = interpretedGoalSchema.parse(await this.options.reasoner.interpretGoal({ objective: run.objective, taskId: run.taskId, runId }));
+        await this.recordEvent(run, event({ type: "goal.interpreted", taskId: run.taskId, runId, goal: run.goal }));
+        run.state = "DEFINING_SUCCESS";
+        const criteria = await this.options.reasoner.defineSuccessCriteria({ goal: run.goal, taskId: run.taskId, runId });
+        run.state = "PLANNING";
+        run.plan = agentPlanSchema.parse(await this.options.reasoner.createPlan({ taskId: run.taskId, runId, goal: run.goal, criteria }));
+        await this.recordEvent(run, event({ type: "plan.created", taskId: run.taskId, runId, plan: run.plan }));
+        run.state = "VALIDATING_PLAN";
+        const validation = this.validator.validate(run.plan);
+        if (!validation.valid) {
+            run.state = "BLOCKED";
+            await this.recordEvent(run, event({ type: "task.blocked", taskId: run.taskId, runId, reason: validation.errors.join("; ") }));
+        }
+        run.updatedAt = nowIso();
+        await this.persistRun(run);
+        return run;
+    }
+    async runToCompletion(runId, signal) {
+        let run = this.requireRun(runId);
+        if (!run.plan)
+            run = await this.prepare(runId);
+        if (run.state === "BLOCKED")
+            return run;
+        const plan = run.plan;
+        if (!plan)
+            throw new Error(`Agent run has no executable plan: ${runId}`);
+        for (const step of plan.steps) {
+            if (signal?.aborted) {
+                run.state = "CANCELLED";
+                return run;
+            }
+            if (step.status === "completed" || step.status === "skipped")
+                continue;
+            if (!this.dependenciesSatisfied(plan, step))
+                continue;
+            const hookContext = { taskId: run.taskId, runId: run.runId };
+            let observation;
+            let attempt = 0;
+            for (;;) {
+                attempt += 1;
+                await this.options.hooks?.fire("beforeTool", { toolId: step.id, context: hookContext });
+                observation = await this.executeStep(run, step, signal);
+                await this.options.hooks?.fire("afterTool", { toolId: step.id, result: observation, context: hookContext });
+                if (observation.status !== "failed")
+                    break;
+                const loop = this.loopGuard.record({ runId, stepId: step.id, type: "failed_observation", value: { summary: observation.summary }, maxRepeated: 2 });
+                if (loop.repeated || attempt >= Math.max(1, step.retryPolicy.maxAttempts))
+                    break;
+                run.state = "WAITING_FOR_RETRY";
+                await this.recordEvent(run, event({ type: "step.retrying", taskId: run.taskId, runId, stepId: step.id, reason: observation.summary }));
+                await this.options.hooks?.fire("onRetry", { attempt, error: observation.summary, context: hookContext });
+                const backoff = Math.min(step.retryPolicy.backoffMs * attempt, step.retryPolicy.maxBackoffMs || Number.POSITIVE_INFINITY);
+                if (backoff > 0)
+                    await delay(backoff, signal);
+                if (signal?.aborted) {
+                    run.state = "CANCELLED";
+                    return run;
+                }
+            }
+            run.observations.push(observation);
+            if (observation.status === "failed") {
+                step.status = "failed";
+                await this.recordEvent(run, event({ type: "step.failed", taskId: run.taskId, runId, stepId: step.id, observation }));
+                run.state = "BLOCKED";
+                await this.recordEvent(run, event({ type: "task.blocked", taskId: run.taskId, runId, reason: observation.summary }));
+                run.updatedAt = nowIso();
+                await this.persistRun(run);
+                return run;
+            }
+            if (observation.nextHints.includes("approval_required")) {
+                step.status = "waiting_approval";
+                run.state = "WAITING_FOR_APPROVAL";
+                await this.recordEvent(run, event({ type: "task.waiting_for_approval", taskId: run.taskId, runId, stepId: step.id, reason: observation.summary }));
+                run.updatedAt = nowIso();
+                await this.persistRun(run);
+                return run;
+            }
+            step.status = "completed";
+            await this.recordEvent(run, event({ type: "step.completed", taskId: run.taskId, runId, stepId: step.id, observation }));
+        }
+        const decision = this.completionGate.evaluate(run.goal?.successCriteria ?? run.plan?.steps.flatMap((step) => step.successCriteria) ?? [], run.observations);
+        run.state = decision.type === "COMPLETE" ? "COMPLETED" : "BLOCKED";
+        if (decision.type === "COMPLETE")
+            await this.recordEvent(run, event({ type: "task.completed", taskId: run.taskId, runId, decision }));
+        else
+            await this.recordEvent(run, event({ type: "task.blocked", taskId: run.taskId, runId, reason: decision.reason }));
+        run.updatedAt = nowIso();
+        await this.persistRun(run);
+        return run;
+    }
+    async executeStep(run, step, signal) {
+        step.status = "running";
+        run.state = step.type === "validate" || step.type === "finalize" ? "VALIDATING" : "EXECUTING";
+        await this.recordEvent(run, event({ type: "step.started", taskId: run.taskId, runId: run.runId, stepId: step.id }));
+        if (!this.options.toolExecutor || step.requiredCapabilities.length === 0) {
+            return agentObservationSchema.parse({
+                status: "success",
+                summary: `Step recorded: ${step.objective}`,
+                evidence: step.expectedEvidence.map((requirement) => ({ id: randomUUID(), kind: requirement.kind, summary: requirement.description })),
+                data: { mode: "record_only" }
+            });
+        }
+        const capability = step.requiredCapabilities[0]?.capability;
+        const candidate = capability ? this.toolRegistry.select(capability, this.options.permissions) : null;
+        if (!candidate) {
+            return agentObservationSchema.parse({
+                status: "failed",
+                summary: capability ? `No tool is available for ${capability}.` : "The step does not declare an executable capability.",
+                errors: [{ code: "TOOL_UNAVAILABLE", message: "No matching tool was registered.", retryable: false }]
+            });
+        }
+        const context = {
+            taskId: run.taskId,
+            runId: run.runId,
+            stepId: step.id,
+            ...(this.options.workspaceRoot ? { workspaceRoot: this.options.workspaceRoot } : {}),
+            ...(signal ? { signal } : {})
+        };
+        const result = await this.options.toolExecutor.execute(candidate.definition.id, {}, context);
+        if (result.status === "pending_approval")
+            return agentObservationSchema.parse({ status: "partial", summary: result.reason, nextHints: ["approval_required"] });
+        if (result.status === "error")
+            return agentObservationSchema.parse({ status: "failed", summary: result.error, errors: [{ code: "TOOL_ERROR", message: result.error, retryable: result.retryable ?? false }] });
+        return agentObservationSchema.parse({
+            status: "success",
+            summary: "Tool execution completed.",
+            data: result.output,
+            evidence: result.evidence ?? step.expectedEvidence.map((requirement) => ({ id: randomUUID(), kind: requirement.kind, summary: requirement.description }))
+        });
+    }
+    dependenciesSatisfied(plan, step) {
+        return step.dependencies.every((dependency) => plan.steps.find((candidate) => candidate.id === dependency)?.status === "completed");
+    }
+    requireRun(runId) {
+        const run = this.runs.get(runId);
+        if (!run)
+            throw new Error(`Agent run not found: ${runId}`);
+        return run;
+    }
+    async persistRun(run) {
+        await this.options.runStore?.saveRun(run);
+    }
+    async recordEvent(run, agentEvent) {
+        run.events.push(agentEvent);
+        await this.publishRunEvent(agentEvent);
+    }
+    async publishRunEvent(agentEvent) {
+        await this.options.events?.publish({
+            type: agentEvent.type,
+            source: "agent-runtime",
+            taskId: agentEvent.taskId,
+            runId: agentEvent.runId,
+            ...(agentEvent.stepId ? { stepId: agentEvent.stepId } : {}),
+            visibility: agentEvent.type.startsWith("task.") ? "user" : "technical",
+            payload: agentEvent
+        });
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/sdk.d.ts

@@ -0,0 +1,43 @@
+import { AgentRuntime, type AgentReasoner } from "./runtime.js";
+import { ToolRegistry, type ToolDefinition, type ToolExecutor } from "./tool-registry.js";
+import { EventBus } from "./event-bus.js";
+import { MemoryStore } from "./memory.js";
+import { MissionRuntime, type MissionPlanner, type MissionVerifier } from "./mission-runtime.js";
+import { ApprovalManager } from "./approvals.js";
+import { TransparentToolOrchestrator, type ToolOrchestrationResult, type ToolRouter, type ToolTraceEvent } from "./tool-orchestrator.js";
+import type { ChatMessage } from "./openai-compatible.js";
+import type { NexaStorage } from "./storage.js";
+import type { NexaTelemetry } from "./telemetry.js";
+export type CreateAgentSdkInput = {
+    reasoner: AgentReasoner;
+    tools?: ToolDefinition[];
+    toolExecutor?: ToolExecutor;
+    workspaceRoot?: string;
+    missionPlanner?: MissionPlanner;
+    missionVerifier?: MissionVerifier;
+    toolRouter?: ToolRouter;
+    trace?: (event: ToolTraceEvent) => void;
+    storage?: NexaStorage;
+    telemetry?: NexaTelemetry;
+};
+export type NexaAgentSdk = {
+    agent: AgentRuntime;
+    missions: MissionRuntime;
+    tools: ToolRegistry;
+    memory: MemoryStore;
+    events: EventBus;
+    approvals: ApprovalManager;
+    toolOrchestrator: TransparentToolOrchestrator;
+    prepareTurnWithTools(input: {
+        text: string;
+        messages: ChatMessage[];
+        maxToolRounds?: number;
+    }): Promise<{
+        run: Awaited<ReturnType<AgentRuntime["runToCompletion"]>>;
+        toolTurn: ToolOrchestrationResult;
+        modelMessages: ChatMessage[];
+    }>;
+};
+export declare function createAgentSdk(input: CreateAgentSdkInput): AgentRuntime;
+export declare function createNexaAgentSdk(input: CreateAgentSdkInput): NexaAgentSdk;
+//# sourceMappingURL=sdk.d.ts.map

package/dist/sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAA4B,MAAM,cAAc,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC1F,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACjG,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,2BAA2B,EAAE,KAAK,uBAAuB,EAAE,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACzI,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IACxC,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,QAAQ,CAAC;IACjB,SAAS,EAAE,eAAe,CAAC;IAC3B,gBAAgB,EAAE,2BAA2B,CAAC;IAC9C,oBAAoB,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,WAAW,EAAE,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QACtG,GAAG,EAAE,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;QAC1D,QAAQ,EAAE,uBAAuB,CAAC;QAClC,aAAa,EAAE,WAAW,EAAE,CAAC;KAC9B,CAAC,CAAC;CACJ,CAAC;AAEF,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,YAAY,CAEvE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,mBAAmB,GAAG,YAAY,CA2D3E"}

package/dist/sdk.js

@@ -0,0 +1,82 @@
+import { AgentRuntime } from "./runtime.js";
+import { ToolRegistry } from "./tool-registry.js";
+import { EventBus } from "./event-bus.js";
+import { MemoryStore } from "./memory.js";
+import { MissionRuntime } from "./mission-runtime.js";
+import { ApprovalManager } from "./approvals.js";
+import { TransparentToolOrchestrator } from "./tool-orchestrator.js";
+export function createAgentSdk(input) {
+    return createNexaAgentSdk(input).agent;
+}
+export function createNexaAgentSdk(input) {
+    const toolRegistry = new ToolRegistry();
+    for (const tool of input.tools ?? [])
+        toolRegistry.register(tool);
+    const events = new EventBus(hasEventJournal(input.storage) ? input.storage : undefined);
+    if (input.telemetry)
+        events.subscribe((event) => input.telemetry?.event(event));
+    const memory = new MemoryStore();
+    const approvals = new ApprovalManager(hasApprovalStore(input.storage) ? input.storage : undefined);
+    const toolOrchestrator = new TransparentToolOrchestrator(input.toolExecutor ?? {
+        async execute(toolId) {
+            return { status: "error", error: `No tool executor configured for ${toolId}.`, retryable: false };
+        }
+    }, {
+        ...(input.toolRouter ? { router: input.toolRouter } : {}),
+        trace: (event) => {
+            input.trace?.(event);
+            void input.telemetry?.toolTrace(event);
+        }
+    });
+    const options = {
+        reasoner: input.reasoner,
+        toolRegistry,
+        events,
+        ...(hasRunStore(input.storage) ? { runStore: input.storage } : {}),
+        ...(input.toolExecutor ? { toolExecutor: input.toolExecutor } : {}),
+        ...(input.workspaceRoot ? { workspaceRoot: input.workspaceRoot } : {})
+    };
+    const agent = new AgentRuntime(options);
+    return {
+        agent,
+        missions: new MissionRuntime({
+            tools: toolRegistry,
+            events,
+            memory,
+            ...(input.toolExecutor ? { toolExecutor: input.toolExecutor } : {}),
+            ...(input.missionPlanner ? { planner: input.missionPlanner } : {}),
+            ...(input.missionVerifier ? { verifier: input.missionVerifier } : {})
+        }),
+        tools: toolRegistry,
+        memory,
+        events,
+        approvals,
+        toolOrchestrator,
+        async prepareTurnWithTools(turnInput) {
+            const run = agent.createRun(turnInput.text);
+            const completedRun = await agent.runToCompletion(run.runId);
+            const toolTurn = await toolOrchestrator.runToolLoop({
+                text: turnInput.text,
+                tools: toolRegistry.list(),
+                taskId: completedRun.taskId,
+                runId: completedRun.runId,
+                ...(turnInput.maxToolRounds ? { maxRounds: turnInput.maxToolRounds } : {})
+            });
+            return {
+                run: completedRun,
+                toolTurn,
+                modelMessages: [...turnInput.messages, ...toolTurn.contextMessages]
+            };
+        }
+    };
+}
+function hasRunStore(storage) {
+    return typeof storage?.saveRun === "function" && typeof storage.getRun === "function";
+}
+function hasEventJournal(storage) {
+    return typeof storage?.appendEvent === "function" && typeof storage.listEvents === "function";
+}
+function hasApprovalStore(storage) {
+    return typeof storage?.saveApproval === "function" && typeof storage.getApproval === "function" && typeof storage.listApprovals === "function";
+}
+//# sourceMappingURL=sdk.js.map

package/dist/sdk.js.map

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

package/dist/secrets.d.ts

@@ -0,0 +1,9 @@
+export type SecretRef = {
+    readonly __nexaSecretRef: true;
+    readonly envKey: string;
+};
+export declare function secret(envKey: string): SecretRef;
+export declare function isSecretRef(value: unknown): value is SecretRef;
+export declare function resolveSecret(ref: SecretRef, env?: NodeJS.ProcessEnv): string;
+export declare function resolveSecretsDeep<T>(value: T, env?: NodeJS.ProcessEnv): T;
+//# sourceMappingURL=secrets.d.ts.map

package/dist/secrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG;IAAE,QAAQ,CAAC,eAAe,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpF,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAEhD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAI1F;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,CAAC,CAOvF"}

package/dist/secrets.js

@@ -0,0 +1,23 @@
+export function secret(envKey) {
+    return { __nexaSecretRef: true, envKey };
+}
+export function isSecretRef(value) {
+    return Boolean(value && typeof value === "object" && value.__nexaSecretRef === true);
+}
+export function resolveSecret(ref, env = process.env) {
+    const value = env[ref.envKey];
+    if (value === undefined)
+        throw new Error(`Missing required secret: environment variable "${ref.envKey}" is not set.`);
+    return value;
+}
+export function resolveSecretsDeep(value, env = process.env) {
+    if (isSecretRef(value))
+        return resolveSecret(value, env);
+    if (Array.isArray(value))
+        return value.map((item) => resolveSecretsDeep(item, env));
+    if (value && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, resolveSecretsDeep(item, env)]));
+    }
+    return value;
+}
+//# sourceMappingURL=secrets.js.map

package/dist/secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,MAAM,CAAC,MAAc;IACnC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAK,KAAuC,CAAC,eAAe,KAAK,IAAI,CAAC,CAAC;AAC1H,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAc,EAAE,MAAyB,OAAO,CAAC,GAAG;IAChF,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,GAAG,CAAC,MAAM,eAAe,CAAC,CAAC;IACtH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAI,KAAQ,EAAE,MAAyB,OAAO,CAAC,GAAG;IAClF,IAAI,WAAW,CAAC,KAAK,CAAC;QAAE,OAAO,aAAa,CAAC,KAAK,EAAE,GAAG,CAAiB,CAAC;IACzE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAiB,CAAC;IACpG,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,kBAAkB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAM,CAAC;IACnH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/sessions.d.ts

@@ -0,0 +1,44 @@
+import type { ChatMessage } from "./openai-compatible.js";
+import type { JsonObject } from "./types.js";
+import type { SessionStore } from "./storage.js";
+export type SessionRunResult = {
+    text: string;
+    messages: ChatMessage[];
+    [key: string]: unknown;
+};
+export type SessionRunner = (input: {
+    text: string;
+    messages: ChatMessage[];
+}) => Promise<SessionRunResult>;
+export type CreateSessionInput = {
+    id?: string;
+    systemPrompt?: string;
+    metadata?: JsonObject;
+    store?: SessionStore;
+    runner: SessionRunner;
+};
+export declare class AgentSession {
+    readonly id: string;
+    private messages;
+    private metadata;
+    private readonly store;
+    private readonly runner;
+    private createdAt;
+    constructor(input: CreateSessionInput & {
+        initialMessages?: ChatMessage[];
+        createdAt?: string;
+    });
+    history(): ChatMessage[];
+    run(text: string): Promise<SessionRunResult>;
+    compact(maxMessages?: number): Promise<void>;
+    reset(): Promise<void>;
+    fork(newId?: string): Promise<AgentSession>;
+    private persist;
+}
+export declare function createSession(input: CreateSessionInput): AgentSession;
+export declare function loadSession(input: {
+    id: string;
+    store: SessionStore;
+    runner: SessionRunner;
+}): Promise<AgentSession | undefined>;
+//# sourceMappingURL=sessions.d.ts.map

package/dist/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../src/sessions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,cAAc,CAAC;AAGhE,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,WAAW,EAAE,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AACjG,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,WAAW,EAAE,CAAA;CAAE,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAE5G,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,aAAa,CAAC;CACvB,CAAC;AAEF,qBAAa,YAAY;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,SAAS,CAAS;gBAEd,KAAK,EAAE,kBAAkB,GAAG;QAAE,eAAe,CAAC,EAAE,WAAW,EAAE,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IAS/F,OAAO,IAAI,WAAW,EAAE;IAIlB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAQ5C,OAAO,CAAC,WAAW,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAOxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;YAYnC,OAAO;CAUtB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,YAAY,CAErE;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAWtI"}

package/dist/sessions.js

@@ -0,0 +1,76 @@
+import { randomUUID } from "node:crypto";
+import { InMemorySessionStore } from "./storage.js";
+export class AgentSession {
+    id;
+    messages;
+    metadata;
+    store;
+    runner;
+    createdAt;
+    constructor(input) {
+        this.id = input.id ?? randomUUID();
+        this.messages = input.initialMessages ?? (input.systemPrompt ? [{ role: "system", content: input.systemPrompt }] : []);
+        this.metadata = input.metadata ?? {};
+        this.store = input.store ?? new InMemorySessionStore();
+        this.runner = input.runner;
+        this.createdAt = input.createdAt ?? new Date().toISOString();
+    }
+    history() {
+        return [...this.messages];
+    }
+    async run(text) {
+        const priorMessages = [...this.messages];
+        const result = await this.runner({ text, messages: priorMessages });
+        this.messages = result.messages;
+        await this.persist();
+        return result;
+    }
+    async compact(maxMessages = 20) {
+        const system = this.messages.filter((message) => message.role === "system");
+        const rest = this.messages.filter((message) => message.role !== "system");
+        this.messages = [...system, ...rest.slice(-maxMessages)];
+        await this.persist();
+    }
+    async reset() {
+        this.messages = this.messages.filter((message) => message.role === "system");
+        await this.persist();
+    }
+    async fork(newId) {
+        const forked = new AgentSession({
+            id: newId ?? randomUUID(),
+            metadata: this.metadata,
+            store: this.store,
+            runner: this.runner,
+            initialMessages: this.history()
+        });
+        await forked.persist();
+        return forked;
+    }
+    async persist() {
+        const record = {
+            id: this.id,
+            messages: this.messages,
+            metadata: this.metadata,
+            createdAt: this.createdAt,
+            updatedAt: new Date().toISOString()
+        };
+        await this.store.saveSession(record);
+    }
+}
+export function createSession(input) {
+    return new AgentSession(input);
+}
+export async function loadSession(input) {
+    const record = await input.store.getSession(input.id);
+    if (!record)
+        return undefined;
+    return new AgentSession({
+        id: record.id,
+        metadata: record.metadata,
+        store: input.store,
+        runner: input.runner,
+        initialMessages: record.messages,
+        createdAt: record.createdAt
+    });
+}
+//# sourceMappingURL=sessions.js.map

package/dist/sessions.js.map

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

package/dist/skills.d.ts

@@ -0,0 +1,12 @@
+import { AgentTool } from "./agent-builder.js";
+import type { AgentToolRegistration } from "./openai-agent.js";
+export type SkillDefinition = {
+    id: string;
+    description: string;
+    instructions: string;
+    tools?: Array<AgentTool | AgentToolRegistration>;
+};
+export declare function defineSkill(definition: SkillDefinition): SkillDefinition;
+export declare function skillsToInstructions(skills: SkillDefinition[]): string;
+export declare function skillsToToolRegistrations(skills: SkillDefinition[]): AgentToolRegistration[];
+//# sourceMappingURL=skills.d.ts.map

package/dist/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,qBAAqB,CAAC,CAAC;CAClD,CAAC;AAEF,wBAAgB,WAAW,CAAC,UAAU,EAAE,eAAe,GAAG,eAAe,CAExE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAItE;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,qBAAqB,EAAE,CAI5F"}