@nexalab/agent-sdk 0.1.0

package/dist/skills.js

@@ -0,0 +1,13 @@
+import { AgentTool } from "./agent-builder.js";
+export function defineSkill(definition) {
+    return definition;
+}
+export function skillsToInstructions(skills) {
+    return skills
+        .map((skill) => `### Skill: ${skill.id}\n${skill.description}\n\n${skill.instructions}`)
+        .join("\n\n");
+}
+export function skillsToToolRegistrations(skills) {
+    return skills.flatMap((skill) => (skill.tools ?? []).map((tool) => (tool instanceof AgentTool ? tool.asRegistration() : tool)));
+}
+//# sourceMappingURL=skills.js.map

package/dist/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAU/C,MAAM,UAAU,WAAW,CAAC,UAA2B;IACrD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAyB;IAC5D,OAAO,MAAM;SACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,WAAW,OAAO,KAAK,CAAC,YAAY,EAAE,CAAC;SACvF,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,MAAyB;IACjE,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAC9B,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,YAAY,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAC9F,CAAC;AACJ,CAAC"}

package/dist/smoke.d.ts

@@ -0,0 +1,8 @@
+export declare function smokeCheckPackage(input: {
+    exports: Record<string, unknown>;
+    required: string[];
+}): {
+    ok: boolean;
+    missing: string[];
+};
+//# sourceMappingURL=smoke.d.ts.map

package/dist/smoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke.d.ts","sourceRoot":"","sources":["../src/smoke.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAGrC"}

package/dist/smoke.js

@@ -0,0 +1,5 @@
+export function smokeCheckPackage(input) {
+    const missing = input.required.filter((name) => !(name in input.exports));
+    return { ok: missing.length === 0, missing };
+}
+//# sourceMappingURL=smoke.js.map

package/dist/smoke.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke.js","sourceRoot":"","sources":["../src/smoke.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,iBAAiB,CAAC,KAGjC;IACC,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1E,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;AAC/C,CAAC"}

package/dist/sqlite-storage.d.ts

@@ -0,0 +1,30 @@
+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";
+export type SqliteStatement = {
+    run(...params: unknown[]): unknown;
+    get(...params: unknown[]): unknown;
+    all(...params: unknown[]): unknown[];
+};
+export type SqliteDriver = {
+    exec(sql: string): unknown;
+    prepare(sql: string): SqliteStatement;
+};
+export declare class SqliteStorage implements NexaStorage {
+    private readonly db;
+    constructor(db: SqliteDriver);
+    saveRun(run: AgentRunSnapshot): void;
+    getRun(runId: string): AgentRunSnapshot | undefined;
+    listRuns(): AgentRunSnapshot[];
+    appendEvent(event: NexaSdkEvent): void;
+    listEvents(): NexaSdkEvent[];
+    saveMemory(record: MemoryRecord): void;
+    listMemories(): MemoryRecord[];
+    saveApproval(approval: ApprovalRequest): void;
+    getApproval(id: string): ApprovalRequest | undefined;
+    listApprovals(status?: ApprovalRequest["status"]): ApprovalRequest[];
+}
+export declare function createSqliteStorage(db: SqliteDriver): SqliteStorage;
+//# sourceMappingURL=sqlite-storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-storage.d.ts","sourceRoot":"","sources":["../src/sqlite-storage.ts"],"names":[],"mappings":"AAAA,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;AAEnD,MAAM,MAAM,eAAe,GAAG;IAC5B,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IACnC,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IACnC,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;CACvC,CAAC;AAEF,qBAAa,aAAc,YAAW,WAAW;IACnC,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,YAAY;IAS7C,OAAO,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI;IAIpC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAKnD,QAAQ,IAAI,gBAAgB,EAAE;IAI9B,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAItC,UAAU,IAAI,YAAY,EAAE;IAI5B,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAItC,YAAY,IAAI,YAAY,EAAE;IAI9B,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAI7C,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAKpD,aAAa,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC,QAAQ,CAAC,GAAG,eAAe,EAAE;CAOrE;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,YAAY,GAAG,aAAa,CAEnE"}

package/dist/sqlite-storage.js

@@ -0,0 +1,52 @@
+export class SqliteStorage {
+    db;
+    constructor(db) {
+        this.db = db;
+        this.db.exec([
+            "create table if not exists nexa_runs (run_id text primary key, payload text not null, updated_at text not null)",
+            "create table if not exists nexa_events (id text primary key, type text not null, payload text not null, at text not null)",
+            "create table if not exists nexa_memories (id text primary key, payload text not null, created_at text not null)",
+            "create table if not exists nexa_approvals (id text primary key, status text not null, payload text not null, created_at text not null)"
+        ].join(";"));
+    }
+    saveRun(run) {
+        this.db.prepare("insert or replace into nexa_runs (run_id, payload, updated_at) values (?, ?, ?)").run(run.runId, JSON.stringify(run), run.updatedAt);
+    }
+    getRun(runId) {
+        const row = this.db.prepare("select payload from nexa_runs where run_id = ?").get(runId);
+        return row ? JSON.parse(row.payload) : undefined;
+    }
+    listRuns() {
+        return this.db.prepare("select payload from nexa_runs order by updated_at desc").all().map((row) => JSON.parse(row.payload));
+    }
+    appendEvent(event) {
+        this.db.prepare("insert or replace into nexa_events (id, type, payload, at) values (?, ?, ?, ?)").run(event.id, event.type, JSON.stringify(event), event.at);
+    }
+    listEvents() {
+        return this.db.prepare("select payload from nexa_events order by at asc").all().map((row) => JSON.parse(row.payload));
+    }
+    saveMemory(record) {
+        this.db.prepare("insert or replace into nexa_memories (id, payload, created_at) values (?, ?, ?)").run(record.id, JSON.stringify(record), record.createdAt);
+    }
+    listMemories() {
+        return this.db.prepare("select payload from nexa_memories order by created_at desc").all().map((row) => JSON.parse(row.payload));
+    }
+    saveApproval(approval) {
+        this.db.prepare("insert or replace into nexa_approvals (id, status, payload, created_at) values (?, ?, ?, ?)").run(approval.id, approval.status, JSON.stringify(approval), approval.createdAt);
+    }
+    getApproval(id) {
+        const row = this.db.prepare("select payload from nexa_approvals where id = ?").get(id);
+        return row ? JSON.parse(row.payload) : undefined;
+    }
+    listApprovals(status) {
+        const statement = status
+            ? this.db.prepare("select payload from nexa_approvals where status = ? order by created_at desc")
+            : this.db.prepare("select payload from nexa_approvals order by created_at desc");
+        const rows = status ? statement.all(status) : statement.all();
+        return rows.map((row) => JSON.parse(row.payload));
+    }
+}
+export function createSqliteStorage(db) {
+    return new SqliteStorage(db);
+}
+//# sourceMappingURL=sqlite-storage.js.map

package/dist/sqlite-storage.js.map

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

package/dist/storage.d.ts

@@ -0,0 +1,74 @@
+import type { AgentRunSnapshot, JsonObject } from "./types.js";
+import type { MemoryRecord } from "./memory.js";
+import type { ApprovalRequest } from "./approvals.js";
+import type { NexaSdkEvent } from "./event-bus.js";
+import type { ChatMessage } from "./openai-compatible.js";
+export type RunStore = {
+    saveRun(run: AgentRunSnapshot): Promise<void> | void;
+    getRun(runId: string): Promise<AgentRunSnapshot | undefined> | AgentRunSnapshot | undefined;
+    listRuns?(): Promise<AgentRunSnapshot[]> | AgentRunSnapshot[];
+};
+export type MemoryAdapter = {
+    saveMemory(record: MemoryRecord): Promise<void> | void;
+    listMemories(): Promise<MemoryRecord[]> | MemoryRecord[];
+};
+export type ApprovalStore = {
+    saveApproval(approval: ApprovalRequest): Promise<void> | void;
+    getApproval(id: string): Promise<ApprovalRequest | undefined> | ApprovalRequest | undefined;
+    listApprovals(status?: ApprovalRequest["status"]): Promise<ApprovalRequest[]> | ApprovalRequest[];
+};
+export type EventJournal = {
+    appendEvent(event: NexaSdkEvent): Promise<void> | void;
+    listEvents(): Promise<NexaSdkEvent[]> | NexaSdkEvent[];
+};
+export type SessionRecord = {
+    id: string;
+    messages: ChatMessage[];
+    metadata: JsonObject;
+    createdAt: string;
+    updatedAt: string;
+};
+export type SessionStore = {
+    saveSession(session: SessionRecord): Promise<void> | void;
+    getSession(id: string): Promise<SessionRecord | undefined> | SessionRecord | undefined;
+    listSessions?(): Promise<SessionRecord[]> | SessionRecord[];
+    deleteSession?(id: string): Promise<void> | void;
+};
+export type NexaStorage = Partial<RunStore & MemoryAdapter & ApprovalStore & EventJournal & SessionStore>;
+export declare class InMemoryRunStore implements RunStore {
+    private readonly runs;
+    saveRun(run: AgentRunSnapshot): void;
+    getRun(runId: string): AgentRunSnapshot | undefined;
+    listRuns(): AgentRunSnapshot[];
+}
+export declare class InMemoryEventJournal implements EventJournal {
+    private readonly events;
+    appendEvent(event: NexaSdkEvent): void;
+    listEvents(): NexaSdkEvent[];
+}
+export declare function createInMemoryRunStore(): InMemoryRunStore;
+export declare function createInMemoryEventJournal(): InMemoryEventJournal;
+export declare class InMemorySessionStore implements SessionStore {
+    private readonly sessions;
+    saveSession(session: SessionRecord): void;
+    getSession(id: string): SessionRecord | undefined;
+    listSessions(): SessionRecord[];
+    deleteSession(id: string): void;
+}
+export declare function createInMemorySessionStore(): InMemorySessionStore;
+export declare class InMemoryStorage implements NexaStorage {
+    private readonly runStore;
+    private readonly eventJournal;
+    private readonly sessionStore;
+    saveRun(run: AgentRunSnapshot): void;
+    getRun(runId: string): AgentRunSnapshot | undefined;
+    listRuns(): AgentRunSnapshot[];
+    appendEvent(event: NexaSdkEvent): void;
+    listEvents(): NexaSdkEvent[];
+    saveSession(session: SessionRecord): void;
+    getSession(id: string): SessionRecord | undefined;
+    listSessions(): SessionRecord[];
+    deleteSession(id: string): void;
+}
+export declare function createInMemoryStorage(): InMemoryStorage;
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

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

package/dist/storage.js

@@ -0,0 +1,83 @@
+export class InMemoryRunStore {
+    runs = new Map();
+    saveRun(run) {
+        this.runs.set(run.runId, structuredClone(run));
+    }
+    getRun(runId) {
+        const run = this.runs.get(runId);
+        return run ? structuredClone(run) : undefined;
+    }
+    listRuns() {
+        return [...this.runs.values()].map((run) => structuredClone(run));
+    }
+}
+export class InMemoryEventJournal {
+    events = [];
+    appendEvent(event) {
+        this.events.push(structuredClone(event));
+    }
+    listEvents() {
+        return this.events.map((event) => structuredClone(event));
+    }
+}
+export function createInMemoryRunStore() {
+    return new InMemoryRunStore();
+}
+export function createInMemoryEventJournal() {
+    return new InMemoryEventJournal();
+}
+export class InMemorySessionStore {
+    sessions = new Map();
+    saveSession(session) {
+        this.sessions.set(session.id, structuredClone(session));
+    }
+    getSession(id) {
+        const session = this.sessions.get(id);
+        return session ? structuredClone(session) : undefined;
+    }
+    listSessions() {
+        return [...this.sessions.values()].map((session) => structuredClone(session));
+    }
+    deleteSession(id) {
+        this.sessions.delete(id);
+    }
+}
+export function createInMemorySessionStore() {
+    return new InMemorySessionStore();
+}
+export class InMemoryStorage {
+    runStore = new InMemoryRunStore();
+    eventJournal = new InMemoryEventJournal();
+    sessionStore = new InMemorySessionStore();
+    saveRun(run) {
+        this.runStore.saveRun(run);
+    }
+    getRun(runId) {
+        return this.runStore.getRun(runId);
+    }
+    listRuns() {
+        return this.runStore.listRuns();
+    }
+    appendEvent(event) {
+        this.eventJournal.appendEvent(event);
+    }
+    listEvents() {
+        return this.eventJournal.listEvents();
+    }
+    saveSession(session) {
+        this.sessionStore.saveSession(session);
+    }
+    getSession(id) {
+        return this.sessionStore.getSession(id);
+    }
+    listSessions() {
+        return this.sessionStore.listSessions();
+    }
+    deleteSession(id) {
+        this.sessionStore.deleteSession(id);
+    }
+}
+export function createInMemoryStorage() {
+    return new InMemoryStorage();
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

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

package/dist/structured-output.d.ts

@@ -0,0 +1,14 @@
+import { z } from "zod";
+import type { JsonObject } from "./types.js";
+export declare function zodSchemaToJsonSchema(schema: z.ZodTypeAny): JsonObject;
+export type StructuredOutputResult<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    error: string;
+    raw: string;
+};
+export declare function structuredOutputInstruction(schema: z.ZodTypeAny, label?: string): string;
+export declare function parseStructuredOutput<T>(schema: z.ZodType<T>, text: string): StructuredOutputResult<T>;
+//# sourceMappingURL=structured-output.d.ts.map

package/dist/structured-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-output.d.ts","sourceRoot":"","sources":["../src/structured-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,UAAU,CAEtE;AAED,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAChC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GACrB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9C,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,EAAE,KAAK,SAAW,GAAG,MAAM,CAG1F;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAQtG"}

package/dist/structured-output.js

@@ -0,0 +1,24 @@
+import { zodToJsonSchema } from "zod-to-json-schema";
+export function zodSchemaToJsonSchema(schema) {
+    return zodToJsonSchema(schema, { target: "jsonSchema7", $refStrategy: "none" });
+}
+export function structuredOutputInstruction(schema, label = "Output") {
+    const jsonSchema = zodSchemaToJsonSchema(schema);
+    return `Respond with ONLY a single JSON object (no prose, no markdown code fences) named "${label}" that satisfies this JSON Schema:\n${JSON.stringify(jsonSchema)}`;
+}
+export function parseStructuredOutput(schema, text) {
+    try {
+        const json = JSON.parse(extractJson(text));
+        const data = schema.parse(json);
+        return { ok: true, data };
+    }
+    catch (error) {
+        return { ok: false, error: error instanceof Error ? error.message : String(error), raw: text };
+    }
+}
+function extractJson(text) {
+    const trimmed = text.trim();
+    const fenced = trimmed.match(/```(?:json)?\s*([\s\S]*?)```/i);
+    return fenced?.[1]?.trim() ?? trimmed;
+}
+//# sourceMappingURL=structured-output.js.map

package/dist/structured-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-output.js","sourceRoot":"","sources":["../src/structured-output.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,MAAM,UAAU,qBAAqB,CAAC,MAAoB;IACxD,OAAO,eAAe,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,EAAE,CAA0B,CAAC;AAC3G,CAAC;AAMD,MAAM,UAAU,2BAA2B,CAAC,MAAoB,EAAE,KAAK,GAAG,QAAQ;IAChF,MAAM,UAAU,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACjD,OAAO,qFAAqF,KAAK,uCAAuC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;AACvK,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAI,MAAoB,EAAE,IAAY;IACzE,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAY,CAAC;QACtD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC5B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;IACjG,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAC9D,OAAO,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC;AACxC,CAAC"}

package/dist/telemetry.d.ts

@@ -0,0 +1,27 @@
+import type { NexaSdkEvent } from "./event-bus.js";
+import type { ToolTraceEvent } from "./tool-orchestrator.js";
+import type { JsonObject } from "./types.js";
+export type TelemetrySpan = {
+    id: string;
+    name: string;
+    attributes: JsonObject;
+    startedAt: string;
+    endedAt?: string;
+    error?: string;
+};
+export type TelemetrySink = {
+    onEvent?(event: NexaSdkEvent): void | Promise<void>;
+    onToolTrace?(event: ToolTraceEvent): void | Promise<void>;
+    onSpan?(span: TelemetrySpan): void | Promise<void>;
+};
+export declare class NexaTelemetry {
+    private readonly sink;
+    private readonly spans;
+    constructor(sink?: TelemetrySink);
+    event(event: NexaSdkEvent): void | Promise<void>;
+    toolTrace(event: ToolTraceEvent): void | Promise<void>;
+    startSpan(name: string, attributes?: JsonObject): TelemetrySpan;
+    endSpan(id: string, error?: unknown): Promise<TelemetrySpan>;
+}
+export declare function createTelemetry(sink?: TelemetrySink): NexaTelemetry;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,CAAC,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,WAAW,CAAC,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,CAAC,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD,CAAC;AAEF,qBAAa,aAAa;IAGZ,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;gBAE7B,IAAI,GAAE,aAAkB;IAErD,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,GAAE,UAAe,GAAG,aAAa;IAW7D,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC;CAYnE;AAED,wBAAgB,eAAe,CAAC,IAAI,GAAE,aAAkB,GAAG,aAAa,CAEvE"}

package/dist/telemetry.js

@@ -0,0 +1,40 @@
+export class NexaTelemetry {
+    sink;
+    spans = new Map();
+    constructor(sink = {}) {
+        this.sink = sink;
+    }
+    event(event) {
+        return this.sink.onEvent?.(event);
+    }
+    toolTrace(event) {
+        return this.sink.onToolTrace?.(event);
+    }
+    startSpan(name, attributes = {}) {
+        const span = {
+            id: crypto.randomUUID(),
+            name,
+            attributes,
+            startedAt: new Date().toISOString()
+        };
+        this.spans.set(span.id, span);
+        return span;
+    }
+    async endSpan(id, error) {
+        const span = this.spans.get(id);
+        if (!span)
+            throw new Error(`Telemetry span not found: ${id}`);
+        const ended = {
+            ...span,
+            endedAt: new Date().toISOString(),
+            ...(error ? { error: error instanceof Error ? error.message : String(error) } : {})
+        };
+        this.spans.set(id, ended);
+        await this.sink.onSpan?.(ended);
+        return ended;
+    }
+}
+export function createTelemetry(sink = {}) {
+    return new NexaTelemetry(sink);
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAmBA,MAAM,OAAO,aAAa;IAGK;IAFZ,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE1D,YAA6B,OAAsB,EAAE;QAAxB,SAAI,GAAJ,IAAI,CAAoB;IAAG,CAAC;IAEzD,KAAK,CAAC,KAAmB;QACvB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,SAAS,CAAC,KAAqB;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;IAED,SAAS,CAAC,IAAY,EAAE,aAAyB,EAAE;QACjD,MAAM,IAAI,GAAkB;YAC1B,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;YACvB,IAAI;YACJ,UAAU;YACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,EAAU,EAAE,KAAe;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,EAAE,EAAE,CAAC,CAAC;QAC9D,MAAM,KAAK,GAAkB;YAC3B,GAAG,IAAI;YACP,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACjC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpF,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC1B,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,OAAsB,EAAE;IACtD,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC"}

package/dist/tenancy.d.ts

@@ -0,0 +1,9 @@
+import { type PermissionMatrix } from "./permissions.js";
+import type { AgentToolRegistration } from "./openai-agent.js";
+export type TenantContext = {
+    tenantId?: string;
+    userId?: string;
+};
+export declare function namespaceKey(context: TenantContext, key: string): string;
+export declare function filterToolsByPermissions(tools: AgentToolRegistration[], permissions: PermissionMatrix): AgentToolRegistration[];
+//# sourceMappingURL=tenancy.d.ts.map

package/dist/tenancy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenancy.d.ts","sourceRoot":"","sources":["../src/tenancy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,MAAM,MAAM,aAAa,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,qBAAqB,EAAE,EAAE,WAAW,EAAE,gBAAgB,GAAG,qBAAqB,EAAE,CAE/H"}

package/dist/tenancy.js

@@ -0,0 +1,8 @@
+import { isToolAllowedByAgentPermissions } from "./permissions.js";
+export function namespaceKey(context, key) {
+    return [context.tenantId, context.userId, key].filter(Boolean).join(":");
+}
+export function filterToolsByPermissions(tools, permissions) {
+    return tools.filter((registration) => isToolAllowedByAgentPermissions(registration.tool.name, permissions));
+}
+//# sourceMappingURL=tenancy.js.map

package/dist/tenancy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenancy.js","sourceRoot":"","sources":["../src/tenancy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAyB,MAAM,kBAAkB,CAAC;AAK1F,MAAM,UAAU,YAAY,CAAC,OAAsB,EAAE,GAAW;IAC9D,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAA8B,EAAE,WAA6B;IACpG,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,+BAA+B,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;AAC9G,CAAC"}

package/dist/tool-factory.d.ts

@@ -0,0 +1,25 @@
+import { z } from "zod";
+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 { ChatTool } from "./openai-compatible.js";
+export type SchemaLike = z.ZodTypeAny | JsonObject;
+export type DefineSdkToolInput<TInput extends z.ZodTypeAny | undefined = undefined> = {
+    id: string;
+    name?: string;
+    description?: string;
+    capability: string;
+    version?: string;
+    provider?: string;
+    enabled?: boolean;
+    inputSchema?: TInput;
+    outputSchema?: SchemaLike;
+    handler: TInput extends z.ZodTypeAny ? (input: z.infer<TInput>, context: LocalToolContext) => Promise<ToolExecutionResult> | ToolExecutionResult : LocalToolHandler;
+};
+export type SdkToolRegistration = {
+    tool: ToolDefinition;
+    handler: LocalToolHandler;
+};
+export declare function defineSdkTool<TInput extends z.ZodTypeAny | undefined = undefined>(input: DefineSdkToolInput<TInput>): SdkToolRegistration;
+export declare function toOpenAIChatTool(tool: ToolDefinition): ChatTool;
+//# sourceMappingURL=tool-factory.d.ts.map

package/dist/tool-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-factory.d.ts","sourceRoot":"","sources":["../src/tool-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGvD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,UAAU,GAAG,UAAU,CAAC;AAEnD,MAAM,MAAM,kBAAkB,CAAC,MAAM,SAAS,CAAC,CAAC,UAAU,GAAG,SAAS,GAAG,SAAS,IAAI;IACpF,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,UAAU,CAAC;IAC1B,OAAO,EAAE,MAAM,SAAS,CAAC,CAAC,UAAU,GAChC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,mBAAmB,CAAC,GAAG,mBAAmB,GACzG,gBAAgB,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,gBAAgB,CAAC;CAC3B,CAAC;AAEF,wBAAgB,aAAa,CAAC,MAAM,SAAS,CAAC,CAAC,UAAU,GAAG,SAAS,GAAG,SAAS,EAAE,KAAK,EAAE,kBAAkB,CAAC,MAAM,CAAC,GAAG,mBAAmB,CAmBzI;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,QAAQ,CAS/D"}

package/dist/tool-factory.js

@@ -0,0 +1,38 @@
+import { zodSchemaToJsonSchema } from "./structured-output.js";
+export function defineSdkTool(input) {
+    const tool = {
+        id: input.id,
+        name: input.name ?? input.id,
+        capability: input.capability,
+        version: input.version ?? "1.0.0",
+        provider: input.provider ?? "local",
+        enabled: input.enabled ?? true,
+        ...(input.description ? { description: input.description } : {}),
+        ...(input.inputSchema ? { inputSchema: schemaToJsonObject(input.inputSchema) } : {}),
+        ...(input.outputSchema ? { outputSchema: schemaToJsonObject(input.outputSchema) } : {})
+    };
+    const handler = async (rawInput, context) => {
+        const parsed = input.inputSchema && isZodSchema(input.inputSchema) ? input.inputSchema.parse(rawInput) : rawInput;
+        return input.handler(parsed, context);
+    };
+    return { tool, handler };
+}
+export function toOpenAIChatTool(tool) {
+    return {
+        type: "function",
+        function: {
+            name: tool.id.replace(/[^a-zA-Z0-9_-]/g, "_"),
+            ...(tool.description ? { description: tool.description } : {}),
+            ...(tool.inputSchema ? { parameters: tool.inputSchema } : {})
+        }
+    };
+}
+function isZodSchema(value) {
+    return Boolean(value && typeof value === "object" && "_def" in value && "parse" in value);
+}
+function schemaToJsonObject(schema) {
+    if (isZodSchema(schema))
+        return zodSchemaToJsonSchema(schema);
+    return schema;
+}
+//# sourceMappingURL=tool-factory.js.map

package/dist/tool-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-factory.js","sourceRoot":"","sources":["../src/tool-factory.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAwB/D,MAAM,UAAU,aAAa,CAAsD,KAAiC;IAClH,MAAM,IAAI,GAAmB;QAC3B,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE;QAC5B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,OAAO;QACjC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,OAAO;QACnC,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;QAC9B,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,kBAAkB,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpF,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,kBAAkB,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxF,CAAC;IAEF,MAAM,OAAO,GAAqB,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;QAC5D,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,IAAI,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAClH,OAAQ,KAAK,CAAC,OAA4B,CAAC,MAAoB,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAoB;IACnD,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC;YAC7C,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9D;KACF,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAI,OAAO,IAAI,KAAK,CAAC,CAAC;AAC5F,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAkB;IAC5C,IAAI,WAAW,CAAC,MAAM,CAAC;QAAE,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9D,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tool-orchestrator.d.ts

@@ -0,0 +1,89 @@
+import type { ChatMessage } from "./openai-compatible.js";
+import type { JsonObject } from "./types.js";
+import type { ToolDefinition, ToolExecutor, ToolExecutionResult } from "./tool-registry.js";
+export type ToolIntent = {
+    tool: ToolDefinition;
+    confidence: number;
+    reason: string;
+};
+export type ToolTraceEvent = {
+    type: "tool.routing.started";
+    input: string;
+    availableTools: Array<{
+        id: string;
+        capability: string;
+    }>;
+} | {
+    type: "tool.routing.completed";
+    selectedTools: Array<{
+        id: string;
+        capability: string;
+        confidence: number;
+        reason: string;
+    }>;
+} | {
+    type: "tool.loop.started";
+    maxRounds: number;
+} | {
+    type: "tool.loop.round";
+    round: number;
+    selectedCount: number;
+} | {
+    type: "tool.loop.completed";
+    rounds: number;
+    resultCount: number;
+} | {
+    type: "tool.execution.started";
+    toolId: string;
+    capability: string;
+} | {
+    type: "tool.execution.completed";
+    toolId: string;
+    result: ToolExecutionResult;
+};
+export type ToolRouter = {
+    select(input: {
+        text: string;
+        tools: ToolDefinition[];
+    }): Promise<ToolIntent[]> | ToolIntent[];
+};
+export type ToolOrchestratorOptions = {
+    router?: ToolRouter;
+    trace?: (event: ToolTraceEvent) => void;
+};
+export type ToolOrchestrationResult = {
+    selectedTools: ToolIntent[];
+    results: Array<{
+        tool: ToolDefinition;
+        result: ToolExecutionResult;
+    }>;
+    contextMessages: ChatMessage[];
+};
+export declare class CapabilityKeywordRouter implements ToolRouter {
+    select(input: {
+        text: string;
+        tools: ToolDefinition[];
+    }): ToolIntent[];
+}
+export declare class TransparentToolOrchestrator {
+    readonly executor: ToolExecutor;
+    private readonly router;
+    private readonly trace;
+    constructor(executor: ToolExecutor, options?: ToolOrchestratorOptions);
+    prepareTurn(input: {
+        text: string;
+        tools: ToolDefinition[];
+        taskId: string;
+        runId: string;
+        toolInput?: JsonObject;
+    }): Promise<ToolOrchestrationResult>;
+    runToolLoop(input: {
+        text: string;
+        tools: ToolDefinition[];
+        taskId: string;
+        runId: string;
+        maxRounds?: number;
+        toolInput?: JsonObject;
+    }): Promise<ToolOrchestrationResult>;
+}
+//# sourceMappingURL=tool-orchestrator.d.ts.map