@nexalab/agent-sdk 0.1.0

package/dist/openai-agent.js

@@ -0,0 +1,190 @@
+import { createNexaAgentSdk } from "./sdk.js";
+import { OpenAICompatibleChatClient, OpenAICompatibleRegistry, createOpenAICompatibleReasoner } from "./openai-compatible.js";
+import { LocalToolExecutor } from "./local-tool-executor.js";
+import { streamNativeToolLoop } from "./native-tool-loop.js";
+export async function createOpenAICompatibleAgent(options) {
+    const registry = new OpenAICompatibleRegistry();
+    registry.register({
+        ...options.provider,
+        ...(options.model ? { defaultModel: options.model } : {})
+    });
+    const client = new OpenAICompatibleChatClient(registry);
+    const model = options.model ?? options.provider.defaultModel ?? (await client.listModels(options.provider.id))[0]?.id;
+    if (!model)
+        throw new Error(`No model found for provider ${options.provider.id}.`);
+    const selectedModel = model;
+    const toolExecutor = new LocalToolExecutor();
+    for (const registration of options.tools ?? [])
+        toolExecutor.register(registration.tool, registration.handler);
+    const sdk = createNexaAgentSdk({
+        reasoner: createOpenAICompatibleReasoner({ client, providerId: options.provider.id, model }),
+        tools: (options.tools ?? []).map((registration) => registration.tool),
+        toolExecutor,
+        ...(options.trace ? { trace: options.trace } : {}),
+        ...(options.toolRouter ? { toolRouter: options.toolRouter } : {}),
+        ...(options.storage ? { storage: options.storage } : {}),
+        ...(options.telemetry ? { telemetry: options.telemetry } : {})
+    });
+    async function streamMessage(text, streamInput = {}) {
+        let final;
+        for await (const event of runStream(text, streamInput.messages ? { messages: streamInput.messages } : {})) {
+            if (event.type === "status")
+                streamInput.onStatus?.(event.label, event.detail);
+            if (event.type === "token")
+                streamInput.onToken?.(event.token);
+            if (event.type === "final")
+                final = event.result;
+        }
+        if (!final)
+            throw new Error("Agent stream ended without a final result.");
+        return final;
+    }
+    async function* runStream(text, streamInput = {}) {
+        const messages = streamInput.messages ?? defaultMessages(options.systemPrompt);
+        yield { type: "status", label: "user.message.received", detail: text };
+        messages.push({ role: "user", content: text });
+        yield { type: "status", label: "agent.turn.prepare" };
+        const turn = await sdk.prepareTurnWithTools({ text, messages });
+        yield { type: "status", label: "agent.run", detail: `${turn.run.state} ${turn.run.runId}` };
+        yield { type: "status", label: "tools.selected", detail: turn.toolTurn.selectedTools.map((intent) => intent.tool.id).join(", ") || "none" };
+        if (options.tools?.length) {
+            let native;
+            const startedAt = new Date();
+            const routingDecision = options.modelRouter?.select({ prompt: text });
+            const routeProviderId = routingDecision?.route.providerId ?? options.provider.id;
+            const routeModel = routingDecision?.route.model ?? selectedModel;
+            const onNativeEvent = (event) => {
+                void options.telemetry?.event({
+                    id: crypto.randomUUID(),
+                    type: event.type,
+                    source: "native-tool-loop",
+                    taskId: turn.run.taskId,
+                    runId: turn.run.runId,
+                    visibility: event.type.includes("tool") ? "technical" : "user",
+                    payload: event,
+                    at: new Date().toISOString()
+                });
+            };
+            if (options.harness) {
+                // A custom (or basicHarness()) ModelHarness only promises a final result — the
+                // granular `native-tool` stream events below are a property of the default
+                // streamNativeToolLoop path and are not available here. See model-harness.ts.
+                native = await options.harness.run({
+                    client,
+                    providerId: routeProviderId,
+                    model: routeModel,
+                    messages: turn.modelMessages,
+                    tools: options.tools,
+                    taskId: turn.run.taskId,
+                    runId: turn.run.runId,
+                    ...(streamInput.maxToolRounds ? { maxRounds: streamInput.maxToolRounds } : {}),
+                    ...(streamInput.signal ? { signal: streamInput.signal } : {}),
+                    onEvent: onNativeEvent
+                });
+            }
+            else {
+                for await (const nativeEvent of streamNativeToolLoop({
+                    client,
+                    providerId: routeProviderId,
+                    model: routeModel,
+                    messages: turn.modelMessages,
+                    tools: options.tools,
+                    taskId: turn.run.taskId,
+                    runId: turn.run.runId,
+                    ...(streamInput.maxToolRounds ? { maxRounds: streamInput.maxToolRounds } : {}),
+                    ...(streamInput.signal ? { signal: streamInput.signal } : {}),
+                    onEvent: onNativeEvent
+                })) {
+                    if (nativeEvent.type === "event")
+                        yield { type: "native-tool", event: nativeEvent.event };
+                    if (nativeEvent.type === "final")
+                        native = nativeEvent.result;
+                }
+            }
+            if (!native)
+                throw new Error("Native tool loop ended without a final result.");
+            if (routingDecision)
+                options.modelRouter?.record(routingDecision);
+            const result = {
+                text: native.text,
+                messages: native.messages,
+                toolTurn: turn.toolTurn,
+                nativeToolTurn: native,
+                metrics: metricsFor({
+                    startedAt,
+                    model: routeModel,
+                    text,
+                    output: native.text,
+                    toolCallCount: native.toolCalls.length,
+                    ...(options.modelRouter ? { routing: options.modelRouter.usage() } : {})
+                })
+            };
+            yield { type: "final", result };
+            return;
+        }
+        let assistantText = "";
+        const startedAt = new Date();
+        const routingDecision = options.modelRouter?.select({ prompt: text });
+        const routeProviderId = routingDecision?.route.providerId ?? options.provider.id;
+        const routeModel = routingDecision?.route.model ?? selectedModel;
+        yield { type: "status", label: "model.stream.start", detail: selectedModel };
+        for await (const chunk of client.stream({
+            providerId: routeProviderId,
+            model: routeModel,
+            messages: turn.modelMessages,
+            stream: true,
+            ...(streamInput.signal ? { signal: streamInput.signal } : {})
+        })) {
+            if (chunk.done)
+                break;
+            assistantText += chunk.text;
+            yield { type: "token", token: chunk.text };
+        }
+        if (routingDecision)
+            options.modelRouter?.record(routingDecision);
+        yield { type: "status", label: "model.stream.done" };
+        messages.push({ role: "assistant", content: assistantText });
+        yield {
+            type: "final",
+            result: {
+                text: assistantText,
+                messages,
+                toolTurn: turn.toolTurn,
+                metrics: metricsFor({
+                    startedAt,
+                    model: routeModel,
+                    text,
+                    output: assistantText,
+                    toolCallCount: 0,
+                    ...(options.modelRouter ? { routing: options.modelRouter.usage() } : {})
+                })
+            }
+        };
+    }
+    async function runMessage(text, messages = defaultMessages(options.systemPrompt)) {
+        return streamMessage(text, { messages });
+    }
+    return { sdk, client, model: selectedModel, runMessage, streamMessage, runStream };
+}
+function defaultMessages(systemPrompt) {
+    return [
+        {
+            role: "system",
+            content: systemPrompt ?? "You are Nexa, a concise and useful AI assistant running through @nexalab/agent-sdk."
+        }
+    ];
+}
+function metricsFor(input) {
+    const ended = new Date();
+    return {
+        startedAt: input.startedAt.toISOString(),
+        endedAt: ended.toISOString(),
+        latencyMs: ended.getTime() - input.startedAt.getTime(),
+        model: input.model,
+        estimatedInputChars: input.text.length,
+        estimatedOutputChars: input.output.length,
+        toolCallCount: input.toolCallCount,
+        ...(input.routing ? { routing: input.routing } : {})
+    };
+}
+//# sourceMappingURL=openai-agent.js.map

package/dist/openai-agent.js.map

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

package/dist/openai-compatible.d.ts

@@ -0,0 +1,117 @@
+import type { AgentReasoner } from "./runtime.js";
+import type { JsonObject, JsonValue } from "./types.js";
+export type ChatRole = "system" | "user" | "assistant" | "tool";
+export type ContentPart = {
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    url?: string;
+    base64?: string;
+    mimeType?: string;
+} | {
+    type: "file";
+    url?: string;
+    base64?: string;
+    mimeType?: string;
+    name?: string;
+};
+export declare function textPart(value: string): ContentPart;
+export declare function imagePart(input: {
+    url?: string;
+    base64?: string;
+    mimeType?: string;
+}): ContentPart;
+export declare function filePart(input: {
+    url?: string;
+    base64?: string;
+    mimeType?: string;
+    name?: string;
+}): ContentPart;
+export type ChatMessage = {
+    role: ChatRole;
+    content: string | ContentPart[];
+    name?: string;
+    toolCallId?: string;
+    /** For assistant messages that requested tool calls — OpenAI-compatible providers require it for the following "tool" messages to be valid. */
+    toolCalls?: ChatToolCall[];
+};
+export type ChatToolCall = {
+    id: string;
+    type: "function";
+    function: {
+        name: string;
+        arguments: string;
+    };
+};
+export type ChatTool = {
+    type: "function";
+    function: {
+        name: string;
+        description?: string;
+        parameters?: JsonObject;
+    };
+};
+export type OpenAICompatibleProviderConfig = {
+    id: string;
+    name: string;
+    baseUrl: string;
+    format?: "openai" | "anthropic" | "gemini";
+    apiKey?: string;
+    defaultModel?: string;
+    headers?: Record<string, string>;
+    modelsPath?: string;
+    chatPath?: string;
+};
+export type ProviderModel = {
+    id: string;
+    name: string;
+    providerId: string;
+    raw?: JsonValue;
+};
+export type ChatCompletionInput = {
+    providerId?: string;
+    model?: string;
+    messages: ChatMessage[];
+    temperature?: number;
+    maxTokens?: number;
+    tools?: ChatTool[];
+    toolChoice?: "auto" | "none" | "required" | JsonObject;
+    stream?: boolean;
+    signal?: AbortSignal;
+};
+export type ChatCompletionResult = {
+    model: string;
+    text: string;
+    toolCalls: ChatToolCall[];
+    raw: JsonValue;
+};
+export type ChatStreamChunk = {
+    text: string;
+    done: boolean;
+    raw?: JsonValue;
+};
+export declare class OpenAICompatibleRegistry {
+    private readonly providers;
+    register(provider: OpenAICompatibleProviderConfig): void;
+    get(id: string): OpenAICompatibleProviderConfig;
+    list(): OpenAICompatibleProviderConfig[];
+    defaultProvider(): OpenAICompatibleProviderConfig;
+}
+export declare class OpenAICompatibleChatClient {
+    private readonly registry;
+    constructor(registry: OpenAICompatibleRegistry);
+    listModels(providerId?: string, signal?: AbortSignal): Promise<ProviderModel[]>;
+    complete(input: ChatCompletionInput): Promise<ChatCompletionResult>;
+    stream(input: ChatCompletionInput): AsyncGenerator<ChatStreamChunk>;
+}
+export declare function createOpenAICompatibleReasoner(input: {
+    client: OpenAICompatibleChatClient;
+    providerId?: string;
+    model?: string;
+}): AgentReasoner;
+export declare function createOpenAICompatibleProvider(input: OpenAICompatibleProviderConfig): {
+    registry: OpenAICompatibleRegistry;
+    client: OpenAICompatibleChatClient;
+};
+//# sourceMappingURL=openai-compatible.d.ts.map

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

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