@nexalab/agent-sdk 0.1.0

package/dist/mission-runtime.js.map

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

package/dist/model-harness.d.ts

@@ -0,0 +1,23 @@
+import { type NativeToolLoopInput, type NativeToolLoopResult } from "./native-tool-loop.js";
+/**
+ * Public contract for the agent's model-orchestration strategy: given a model,
+ * tools, and conversation, decide how to call the model and tools to reach a
+ * final answer (how many rounds, when to stop, how to react to tool results).
+ *
+ * `basicHarness()` below is the OSS reference implementation — it wraps the
+ * existing round-based native tool-calling loop unchanged. Third parties (and
+ * Pixelity's own more advanced strategies) can implement `ModelHarness`
+ * directly instead of forking the runtime.
+ *
+ * Note: supplying an explicit harness switches the native tool loop to this
+ * Promise-based contract, which does not emit the granular `native-tool`
+ * stream events `agent.runStream()` emits by default. That streaming behavior
+ * is unchanged when no harness is configured.
+ */
+export type ModelHarnessContext = NativeToolLoopInput;
+export type ModelHarnessResult = NativeToolLoopResult;
+export interface ModelHarness {
+    run(ctx: ModelHarnessContext): Promise<ModelHarnessResult>;
+}
+export declare function basicHarness(): ModelHarness;
+//# sourceMappingURL=model-harness.d.ts.map

package/dist/model-harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-harness.d.ts","sourceRoot":"","sources":["../src/model-harness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,mBAAmB,EAAE,KAAK,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE/G;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;AACtD,MAAM,MAAM,kBAAkB,GAAG,oBAAoB,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC5D;AAED,wBAAgB,YAAY,IAAI,YAAY,CAI3C"}

package/dist/model-harness.js

@@ -0,0 +1,7 @@
+import { runNativeToolLoop } from "./native-tool-loop.js";
+export function basicHarness() {
+    return {
+        run: (ctx) => runNativeToolLoop(ctx)
+    };
+}
+//# sourceMappingURL=model-harness.js.map

package/dist/model-harness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-harness.js","sourceRoot":"","sources":["../src/model-harness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAuD,MAAM,uBAAuB,CAAC;AAwB/G,MAAM,UAAU,YAAY;IAC1B,OAAO;QACL,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC;KACrC,CAAC;AACJ,CAAC"}

package/dist/model-router.d.ts

@@ -0,0 +1,60 @@
+import type { ChatCompletionInput, ChatCompletionResult, OpenAICompatibleChatClient } from "./openai-compatible.js";
+import type { JsonObject } from "./types.js";
+import { type TaskRequirement } from "./provider-capabilities.js";
+export type ModelRoute = {
+    id: string;
+    providerId: string;
+    model: string;
+    priority?: number;
+    maxInputChars?: number;
+    estimatedCostPer1kTokens?: number;
+    tags?: string[];
+};
+export type ModelBudget = {
+    maxEstimatedCost?: number;
+    maxCalls?: number;
+};
+export type ModelRouterDecision = {
+    route: ModelRoute;
+    reason: string;
+    estimatedCost: number;
+};
+export type ModelRouterStrategy = "priority" | "adaptive";
+export type ModelRouterOptions = {
+    strategy?: ModelRouterStrategy;
+};
+export declare class ModelRouter {
+    private readonly routes;
+    private readonly budget;
+    private readonly options;
+    private calls;
+    private spent;
+    constructor(routes: ModelRoute[], budget?: ModelBudget, options?: ModelRouterOptions);
+    select(input: {
+        prompt: string;
+        requiredTags?: string[];
+        requiredCapabilities?: TaskRequirement[];
+    }): ModelRouterDecision;
+    record(decision: ModelRouterDecision): void;
+    usage(): {
+        calls: number;
+        estimatedCost: number;
+        remainingCalls?: number;
+        remainingEstimatedCost?: number;
+    };
+}
+export declare function completeWithRouting(input: {
+    client: OpenAICompatibleChatClient;
+    router: ModelRouter;
+    messages: ChatCompletionInput["messages"];
+    prompt: string;
+    requiredTags?: string[];
+    requiredCapabilities?: TaskRequirement[];
+    extra?: Omit<ChatCompletionInput, "providerId" | "model" | "messages">;
+}): Promise<ChatCompletionResult & {
+    route: ModelRoute;
+    routing: ModelRouterDecision;
+}>;
+export declare function createModelRouter(routes: ModelRoute[], budget?: ModelBudget, options?: ModelRouterOptions): ModelRouter;
+export type RoutingSnapshot = JsonObject;
+//# sourceMappingURL=model-router.d.ts.map

package/dist/model-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-router.d.ts","sourceRoot":"","sources":["../src/model-router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAExF,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,UAAU,CAAC;AAC1D,MAAM,MAAM,kBAAkB,GAAG;IAAE,QAAQ,CAAC,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAEpE,qBAAa,WAAW;IAKpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,KAAK,CAAK;gBAGC,MAAM,EAAE,UAAU,EAAE,EACpB,MAAM,GAAE,WAAgB,EACxB,OAAO,GAAE,kBAAuB;IAGnD,MAAM,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,oBAAoB,CAAC,EAAE,eAAe,EAAE,CAAA;KAAE,GAAG,mBAAmB;IA2BzH,MAAM,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAK3C,KAAK,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,sBAAsB,CAAC,EAAE,MAAM,CAAA;KAAE;CAQ5G;AAED,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAC/C,MAAM,EAAE,0BAA0B,CAAC;IACnC,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,oBAAoB,CAAC,EAAE,eAAe,EAAE,CAAC;IACzC,KAAK,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,YAAY,GAAG,OAAO,GAAG,UAAU,CAAC,CAAC;CACxE,GAAG,OAAO,CAAC,oBAAoB,GAAG;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,mBAAmB,CAAA;CAAE,CAAC,CActF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,MAAM,GAAE,WAAgB,EAAE,OAAO,GAAE,kBAAuB,GAAG,WAAW,CAE/H;AAsBD,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC"}

package/dist/model-router.js

@@ -0,0 +1,90 @@
+import { providerSupportsTask } from "./provider-capabilities.js";
+export class ModelRouter {
+    routes;
+    budget;
+    options;
+    calls = 0;
+    spent = 0;
+    constructor(routes, budget = {}, options = {}) {
+        this.routes = routes;
+        this.budget = budget;
+        this.options = options;
+    }
+    select(input) {
+        if (this.budget.maxCalls !== undefined && this.calls >= this.budget.maxCalls)
+            throw new Error("Model budget exhausted: maxCalls reached.");
+        const strategy = this.options.strategy ?? "priority";
+        const candidates = this.routes
+            .filter((route) => !route.maxInputChars || input.prompt.length <= route.maxInputChars)
+            .filter((route) => (input.requiredTags ?? []).every((tag) => route.tags?.includes(tag)))
+            .filter((route) => !input.requiredCapabilities?.length || providerSupportsTask(route.providerId, input.requiredCapabilities));
+        if (strategy === "adaptive") {
+            const score = adaptiveScorer(candidates, input.prompt);
+            candidates.sort((a, b) => score(b) - score(a));
+        }
+        else {
+            candidates.sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
+        }
+        const route = candidates[0];
+        if (!route)
+            throw new Error("No model route matched the request.");
+        const estimatedCost = estimateCost(input.prompt, route);
+        if (this.budget.maxEstimatedCost !== undefined && this.spent + estimatedCost > this.budget.maxEstimatedCost) {
+            throw new Error("Model budget exhausted: estimated cost limit would be exceeded.");
+        }
+        return {
+            route,
+            estimatedCost,
+            reason: strategy === "adaptive" ? "Selected the best priority/cost tradeoff for the task's estimated complexity." : "Selected highest-priority route within limits."
+        };
+    }
+    record(decision) {
+        this.calls += 1;
+        this.spent += decision.estimatedCost;
+    }
+    usage() {
+        return {
+            calls: this.calls,
+            estimatedCost: this.spent,
+            ...(this.budget.maxCalls !== undefined ? { remainingCalls: Math.max(0, this.budget.maxCalls - this.calls) } : {}),
+            ...(this.budget.maxEstimatedCost !== undefined ? { remainingEstimatedCost: Math.max(0, this.budget.maxEstimatedCost - this.spent) } : {})
+        };
+    }
+}
+export async function completeWithRouting(input) {
+    const decision = input.router.select({
+        prompt: input.prompt,
+        ...(input.requiredTags ? { requiredTags: input.requiredTags } : {}),
+        ...(input.requiredCapabilities ? { requiredCapabilities: input.requiredCapabilities } : {})
+    });
+    const result = await input.client.complete({
+        providerId: decision.route.providerId,
+        model: decision.route.model,
+        messages: input.messages,
+        ...(input.extra ?? {})
+    });
+    input.router.record(decision);
+    return { ...result, route: decision.route, routing: decision };
+}
+export function createModelRouter(routes, budget = {}, options = {}) {
+    return new ModelRouter(routes, budget, options);
+}
+function estimateCost(prompt, route) {
+    const estimatedTokens = Math.ceil(prompt.length / 4);
+    return ((route.estimatedCostPer1kTokens ?? 0) * estimatedTokens) / 1000;
+}
+// OSS reference heuristic: a simple linear priority/cost/prompt-length blend, not
+// task-complexity classification or learned routing. See docs/architecture/open-core-target.md (R2)
+// for why this stays intentionally simple, and how a more advanced private router would replace it
+// by implementing the same select() contract.
+function adaptiveScorer(candidates, prompt) {
+    const complexity = Math.min(1, prompt.length / 2000);
+    const maxPriority = Math.max(1, ...candidates.map((route) => route.priority ?? 0));
+    const maxCost = Math.max(0.0001, ...candidates.map((route) => route.estimatedCostPer1kTokens ?? 0));
+    return (route) => {
+        const priorityScore = (route.priority ?? 0) / maxPriority;
+        const costScore = 1 - (route.estimatedCostPer1kTokens ?? 0) / maxCost;
+        return complexity * priorityScore + (1 - complexity) * costScore;
+    };
+}
+//# sourceMappingURL=model-router.js.map

package/dist/model-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-router.js","sourceRoot":"","sources":["../src/model-router.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAwB,MAAM,4BAA4B,CAAC;AA0BxF,MAAM,OAAO,WAAW;IAKH;IACA;IACA;IANX,KAAK,GAAG,CAAC,CAAC;IACV,KAAK,GAAG,CAAC,CAAC;IAElB,YACmB,MAAoB,EACpB,SAAsB,EAAE,EACxB,UAA8B,EAAE;QAFhC,WAAM,GAAN,MAAM,CAAc;QACpB,WAAM,GAAN,MAAM,CAAkB;QACxB,YAAO,GAAP,OAAO,CAAyB;IAChD,CAAC;IAEJ,MAAM,CAAC,KAA4F;QACjG,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC3I,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,UAAU,CAAC;QACrD,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM;aAC3B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC;aACrF,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;aACvF,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,EAAE,MAAM,IAAI,oBAAoB,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC;QAEhI,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YACvD,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACjD,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACnE,MAAM,aAAa,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACxD,IAAI,IAAI,CAAC,MAAM,CAAC,gBAAgB,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,GAAG,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC5G,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;QACrF,CAAC;QACD,OAAO;YACL,KAAK;YACL,aAAa;YACb,MAAM,EAAE,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,+EAA+E,CAAC,CAAC,CAAC,gDAAgD;SACrK,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,QAA6B;QAClC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;QAChB,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,aAAa,CAAC;IACvC,CAAC;IAED,KAAK;QACH,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,aAAa,EAAE,IAAI,CAAC,KAAK;YACzB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjH,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,sBAAsB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1I,CAAC;IACJ,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAQzC;IACC,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;QACnC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,GAAG,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,KAAK,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5F,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;QACzC,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,UAAU;QACrC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK;QAC3B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;KACvB,CAAC,CAAC;IACH,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC9B,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAoB,EAAE,SAAsB,EAAE,EAAE,UAA8B,EAAE;IAChH,OAAO,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,YAAY,CAAC,MAAc,EAAE,KAAiB;IACrD,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,CAAC,KAAK,CAAC,wBAAwB,IAAI,CAAC,CAAC,GAAG,eAAe,CAAC,GAAG,IAAI,CAAC;AAC1E,CAAC;AAED,kFAAkF;AAClF,oGAAoG;AACpG,mGAAmG;AACnG,8CAA8C;AAC9C,SAAS,cAAc,CAAC,UAAwB,EAAE,MAAc;IAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC;IACnF,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,wBAAwB,IAAI,CAAC,CAAC,CAAC,CAAC;IACpG,OAAO,CAAC,KAAiB,EAAE,EAAE;QAC3B,MAAM,aAAa,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,WAAW,CAAC;QAC1D,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,wBAAwB,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC;QACtE,OAAO,UAAU,GAAG,aAAa,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,GAAG,SAAS,CAAC;IACnE,CAAC,CAAC;AACJ,CAAC"}

package/dist/multi-agent.d.ts

@@ -0,0 +1,56 @@
+import type { AgentMessageResult, OpenAICompatibleAgent } from "./openai-agent.js";
+import type { JsonObject } from "./types.js";
+import type { LocalToolHandler } from "./local-tool-executor.js";
+import type { ToolDefinition } from "./tool-registry.js";
+export type AgentWorker = {
+    id: string;
+    description: string;
+    capabilities: string[];
+    run: (input: {
+        task: string;
+        context: JsonObject;
+    }) => Promise<AgentMessageResult> | AgentMessageResult;
+};
+export type DelegationResult = {
+    worker: AgentWorker;
+    result: AgentMessageResult;
+    score: number;
+    reason: string;
+};
+export declare class MultiAgentCoordinator {
+    private readonly workers;
+    constructor(workers: AgentWorker[]);
+    select(input: {
+        task: string;
+        requiredCapabilities?: string[];
+    }): {
+        worker: AgentWorker;
+        score: number;
+        reason: string;
+    };
+    delegate(input: {
+        task: string;
+        context?: JsonObject;
+        requiredCapabilities?: string[];
+    }): Promise<DelegationResult>;
+    fanOut(input: {
+        task: string;
+        context?: JsonObject;
+        requiredCapabilities?: string[];
+    }): Promise<DelegationResult[]>;
+}
+export declare function createMultiAgentCoordinator(workers: AgentWorker[]): MultiAgentCoordinator;
+export declare function agentWorkerFromAgent(input: {
+    id: string;
+    description: string;
+    capabilities: string[];
+    agent: Pick<OpenAICompatibleAgent, "runMessage">;
+}): AgentWorker;
+export declare function agentAsTool(agent: Pick<OpenAICompatibleAgent, "runMessage">, input: {
+    id: string;
+    description: string;
+}): {
+    tool: ToolDefinition;
+    handler: LocalToolHandler;
+};
+//# sourceMappingURL=multi-agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"multi-agent.d.ts","sourceRoot":"","sources":["../src/multi-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,GAAG,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,UAAU,CAAA;KAAE,KAAK,OAAO,CAAC,kBAAkB,CAAC,GAAG,kBAAkB,CAAC;CACzG,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,qBAAa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,WAAW,EAAE;IAEnD,MAAM,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IASlH,QAAQ,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,UAAU,CAAC;QAAC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAMnH,MAAM,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,UAAU,CAAC;QAAC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAU1H;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,qBAAqB,CAEzF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,EAAE,IAAI,CAAC,qBAAqB,EAAE,YAAY,CAAC,CAAC;CAClD,GAAG,WAAW,CAOd;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,IAAI,CAAC,qBAAqB,EAAE,YAAY,CAAC,EAChD,KAAK,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,CAkBrD"}

package/dist/multi-agent.js

@@ -0,0 +1,69 @@
+export class MultiAgentCoordinator {
+    workers;
+    constructor(workers) {
+        this.workers = workers;
+    }
+    select(input) {
+        const scored = this.workers
+            .map((worker) => ({ worker, score: scoreWorker(worker, input), reason: "Matched capability and task keywords." }))
+            .sort((a, b) => b.score - a.score);
+        const selected = scored[0];
+        if (!selected || selected.score <= 0)
+            throw new Error("No agent worker matched the task.");
+        return selected;
+    }
+    async delegate(input) {
+        const selected = this.select({ task: input.task, ...(input.requiredCapabilities ? { requiredCapabilities: input.requiredCapabilities } : {}) });
+        const result = await selected.worker.run({ task: input.task, context: input.context ?? {} });
+        return { ...selected, result };
+    }
+    async fanOut(input) {
+        const candidates = this.workers
+            .map((worker) => ({ worker, score: scoreWorker(worker, input), reason: "Matched capability and task keywords." }))
+            .filter((candidate) => candidate.score > 0)
+            .sort((a, b) => b.score - a.score);
+        return Promise.all(candidates.map(async (candidate) => ({
+            ...candidate,
+            result: await candidate.worker.run({ task: input.task, context: input.context ?? {} })
+        })));
+    }
+}
+export function createMultiAgentCoordinator(workers) {
+    return new MultiAgentCoordinator(workers);
+}
+export function agentWorkerFromAgent(input) {
+    return {
+        id: input.id,
+        description: input.description,
+        capabilities: input.capabilities,
+        run: async ({ task }) => input.agent.runMessage(task)
+    };
+}
+export function agentAsTool(agent, input) {
+    return {
+        tool: {
+            id: input.id,
+            name: input.id,
+            description: input.description,
+            capability: input.id,
+            version: "1.0.0",
+            provider: "multi-agent",
+            enabled: true,
+            inputSchema: { type: "object", properties: { task: { type: "string" } }, required: ["task"] }
+        },
+        handler: async (rawInput) => {
+            const task = typeof rawInput.task === "string" ? rawInput.task : JSON.stringify(rawInput);
+            const result = await agent.runMessage(task);
+            return { status: "ok", output: { text: result.text } };
+        }
+    };
+}
+function scoreWorker(worker, input) {
+    const required = input.requiredCapabilities ?? [];
+    const requiredScore = required.length ? required.filter((capability) => worker.capabilities.includes(capability)).length / required.length : 0.5;
+    const text = `${worker.id} ${worker.description} ${worker.capabilities.join(" ")}`.toLowerCase();
+    const terms = input.task.toLowerCase().split(/[^a-z0-9_áéíóúñ]+/i).filter(Boolean);
+    const keywordScore = terms.reduce((score, term) => score + (text.includes(term) ? 0.1 : 0), 0);
+    return requiredScore + keywordScore;
+}
+//# sourceMappingURL=multi-agent.js.map

package/dist/multi-agent.js.map

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

package/dist/native-tool-loop.d.ts

@@ -0,0 +1,70 @@
+import type { LocalToolHandler } from "./local-tool-executor.js";
+import type { ChatMessage, ChatToolCall, OpenAICompatibleChatClient } from "./openai-compatible.js";
+import type { ToolDefinition, ToolExecutionResult } from "./tool-registry.js";
+export type NativeToolLoopEvent = {
+    type: "native.loop.started";
+    roundLimit: number;
+} | {
+    type: "native.model.completed";
+    round: number;
+    text: string;
+    toolCallCount: number;
+} | {
+    type: "native.tool.started";
+    round: number;
+    toolId: string;
+    toolCallId: string;
+} | {
+    type: "native.tool.completed";
+    round: number;
+    toolId: string;
+    toolCallId: string;
+    result: ToolExecutionResult;
+} | {
+    type: "native.approval.required";
+    round: number;
+    toolId: string;
+    toolCallId: string;
+    reason: string;
+} | {
+    type: "native.loop.completed";
+    rounds: number;
+    text: string;
+};
+export type NativeToolLoopStreamEvent = {
+    type: "event";
+    event: NativeToolLoopEvent;
+} | {
+    type: "final";
+    result: NativeToolLoopResult;
+};
+export type NativeToolRegistration = {
+    tool: ToolDefinition;
+    handler: LocalToolHandler;
+};
+export type NativeToolLoopResult = {
+    text: string;
+    messages: ChatMessage[];
+    toolCalls: ChatToolCall[];
+    toolResults: Array<{
+        tool: ToolDefinition;
+        result: ToolExecutionResult;
+        toolCallId: string;
+    }>;
+    rounds: number;
+};
+export type NativeToolLoopInput = {
+    client: OpenAICompatibleChatClient;
+    providerId: string;
+    model: string;
+    messages: ChatMessage[];
+    tools: NativeToolRegistration[];
+    taskId: string;
+    runId: string;
+    maxRounds?: number;
+    onEvent?: (event: NativeToolLoopEvent) => void | Promise<void>;
+    signal?: AbortSignal;
+};
+export declare function runNativeToolLoop(input: NativeToolLoopInput): Promise<NativeToolLoopResult>;
+export declare function streamNativeToolLoop(input: NativeToolLoopInput): AsyncGenerator<NativeToolLoopStreamEvent>;
+//# sourceMappingURL=native-tool-loop.d.ts.map

package/dist/native-tool-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-tool-loop.d.ts","sourceRoot":"","sources":["../src/native-tool-loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpG,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAI9E,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GACtF;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAClF;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,GACjH;IAAE,IAAI,EAAE,0BAA0B,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACvG;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpE,MAAM,MAAM,yBAAyB,GACjC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAEpD,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,gBAAgB,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,cAAc,CAAC;QAAC,MAAM,EAAE,mBAAmB,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9F,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,0BAA0B,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,EAAE,sBAAsB,EAAE,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAOjG;AAED,wBAAuB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc,CAAC,yBAAyB,CAAC,CAuDjH"}

package/dist/native-tool-loop.js

@@ -0,0 +1,92 @@
+import { toOpenAIChatTool } from "./tool-factory.js";
+export async function runNativeToolLoop(input) {
+    let final;
+    for await (const event of streamNativeToolLoop(input)) {
+        if (event.type === "final")
+            final = event.result;
+    }
+    if (!final)
+        throw new Error("Native tool loop ended without a final result.");
+    return final;
+}
+export async function* streamNativeToolLoop(input) {
+    const maxRounds = input.maxRounds ?? 6;
+    const messages = [...input.messages];
+    const toolCalls = [];
+    const toolResults = [];
+    yield* emit(input, { type: "native.loop.started", roundLimit: maxRounds });
+    for (let round = 1; round <= maxRounds; round += 1) {
+        const response = await input.client.complete({
+            providerId: input.providerId,
+            model: input.model,
+            messages,
+            tools: input.tools.map((registration) => toOpenAIChatTool(registration.tool)),
+            toolChoice: input.tools.length ? "auto" : "none",
+            ...(input.signal ? { signal: input.signal } : {})
+        });
+        toolCalls.push(...response.toolCalls);
+        yield* emit(input, { type: "native.model.completed", round, text: response.text, toolCallCount: response.toolCalls.length });
+        if (!response.toolCalls.length) {
+            messages.push({ role: "assistant", content: response.text });
+            yield* emit(input, { type: "native.loop.completed", rounds: round, text: response.text });
+            yield { type: "final", result: { text: response.text, messages, toolCalls, toolResults, rounds: round } };
+            return;
+        }
+        messages.push({ role: "assistant", content: response.text, toolCalls: response.toolCalls });
+        for (const toolCall of response.toolCalls) {
+            const registration = findRegistration(input.tools, toolCall.function.name);
+            const parsedInput = parseToolArguments(toolCall.function.arguments);
+            if (!registration) {
+                const result = { status: "error", error: `No tool registered for function: ${toolCall.function.name}`, retryable: false };
+                toolResults.push({ tool: unknownTool(toolCall.function.name), result, toolCallId: toolCall.id });
+                messages.push({ role: "tool", toolCallId: toolCall.id, name: toolCall.function.name, content: JSON.stringify(result) });
+                continue;
+            }
+            yield* emit(input, { type: "native.tool.started", round, toolId: registration.tool.id, toolCallId: toolCall.id });
+            const result = await registration.handler(parsedInput, {
+                taskId: input.taskId,
+                runId: input.runId,
+                stepId: `native-tool-${toolCall.id}`,
+                ...(input.signal ? { signal: input.signal } : {})
+            });
+            if (result.status === "pending_approval") {
+                yield* emit(input, { type: "native.approval.required", round, toolId: registration.tool.id, toolCallId: toolCall.id, reason: result.reason });
+            }
+            toolResults.push({ tool: registration.tool, result, toolCallId: toolCall.id });
+            messages.push({ role: "tool", toolCallId: toolCall.id, name: toolCall.function.name, content: JSON.stringify(result) });
+            yield* emit(input, { type: "native.tool.completed", round, toolId: registration.tool.id, toolCallId: toolCall.id, result });
+        }
+    }
+    const text = "Native tool loop reached the configured round limit before the model produced a final answer.";
+    yield* emit(input, { type: "native.loop.completed", rounds: maxRounds, text });
+    yield { type: "final", result: { text, messages, toolCalls, toolResults, rounds: maxRounds } };
+}
+async function* emit(input, event) {
+    await input.onEvent?.(event);
+    yield { type: "event", event };
+}
+function findRegistration(registrations, functionName) {
+    return registrations.find((registration) => toOpenAIName(registration.tool.id) === functionName || registration.tool.id === functionName);
+}
+function parseToolArguments(value) {
+    if (!value.trim())
+        return {};
+    const parsed = JSON.parse(value);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+        return {};
+    return parsed;
+}
+function toOpenAIName(toolId) {
+    return toolId.replace(/[^a-zA-Z0-9_-]/g, "_");
+}
+function unknownTool(name) {
+    return {
+        id: name,
+        name,
+        capability: "unknown",
+        version: "0.0.0",
+        provider: "native-tool-loop",
+        enabled: false
+    };
+}
+//# sourceMappingURL=native-tool-loop.js.map

package/dist/native-tool-loop.js.map

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

package/dist/openai-agent.d.ts

@@ -0,0 +1,75 @@
+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 } from "./tool-registry.js";
+import type { ToolOrchestrationResult, ToolTraceEvent } from "./tool-orchestrator.js";
+import type { NexaStorage } from "./storage.js";
+import type { NexaTelemetry } from "./telemetry.js";
+import { type NativeToolLoopEvent, type NativeToolLoopResult } from "./native-tool-loop.js";
+import type { ModelRouter } from "./model-router.js";
+import type { ModelHarness } from "./model-harness.js";
+export type AgentToolRegistration = {
+    tool: ToolDefinition;
+    handler: LocalToolHandler;
+};
+export type OpenAICompatibleAgentOptions = {
+    provider: OpenAICompatibleProviderConfig;
+    tools?: AgentToolRegistration[];
+    model?: string;
+    systemPrompt?: string;
+    trace?: (event: ToolTraceEvent) => void;
+    toolRouter?: import("./tool-orchestrator.js").ToolRouter;
+    storage?: NexaStorage;
+    telemetry?: NexaTelemetry;
+    modelRouter?: ModelRouter;
+    harness?: ModelHarness;
+};
+export type AgentMessageResult = {
+    text: string;
+    messages: ChatMessage[];
+    toolTurn: ToolOrchestrationResult;
+    nativeToolTurn?: NativeToolLoopResult;
+    metrics?: AgentRunMetrics;
+};
+export type AgentRunMetrics = {
+    startedAt: string;
+    endedAt: string;
+    latencyMs: number;
+    model: string;
+    estimatedInputChars: number;
+    estimatedOutputChars: number;
+    toolCallCount: number;
+    routing?: ReturnType<ModelRouter["usage"]>;
+};
+export type AgentStreamEvent = {
+    type: "status";
+    label: string;
+    detail?: string;
+} | {
+    type: "token";
+    token: string;
+} | {
+    type: "native-tool";
+    event: NativeToolLoopEvent;
+} | {
+    type: "final";
+    result: AgentMessageResult;
+};
+export type OpenAICompatibleAgent = {
+    sdk: NexaAgentSdk;
+    client: OpenAICompatibleChatClient;
+    model: string;
+    runMessage(text: string, messages?: ChatMessage[]): Promise<AgentMessageResult>;
+    streamMessage(text: string, input?: {
+        messages?: ChatMessage[];
+        onStatus?: (label: string, detail?: string) => void;
+        onToken?: (token: string) => void;
+    }): Promise<AgentMessageResult>;
+    runStream(text: string, input?: {
+        messages?: ChatMessage[];
+        maxToolRounds?: number;
+        signal?: AbortSignal;
+    }): AsyncGenerator<AgentStreamEvent>;
+};
+export declare function createOpenAICompatibleAgent(options: OpenAICompatibleAgentOptions): Promise<OpenAICompatibleAgent>;
+//# sourceMappingURL=openai-agent.d.ts.map

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

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