@nexface/agent 0.1.1-alpha.5 → 0.1.1-alpha.6

package/dist/request.js

@@ -0,0 +1,162 @@
+import { RunAgentInputSchema, MessageSchema } from "@ag-ui/core";
+import { getToolResultError } from "./internal.js";
+export function toProtocolMessages(messages) {
+    return messages.flatMap((message) => {
+        message.id ??= globalThis.crypto.randomUUID();
+        if (message.role === "system" || message.role === "application_context")
+            return [];
+        if (message.role === "assistant")
+            return [{ id: message.id, role: "assistant", ...(message.content === null ? {} : { content: message.content }), toolCalls: message.toolCalls.map(({ id, name, arguments: args }) => ({ id, type: "function", function: { name, arguments: args } })) }];
+        if (message.role === "tool") {
+            const error = getToolResultError(message.content);
+            return [{ id: message.id, role: "tool", toolCallId: message.toolCallId, content: message.content, ...(error === undefined ? {} : { error }) }];
+        }
+        return [{ id: message.id, role: "user", content: message.content }];
+    });
+}
+export function decodeRequest(value) {
+    RunAgentInputSchema.parse(value);
+    const extension = value.forwardedProps?.nexface;
+    if (extension && extension.version !== 1)
+        throw new Error("Unsupported Nexface request version.");
+    if (extension?.confirmedToolCallId !== undefined)
+        throw new Error("Use resume payload for confirmation results.");
+    const continuation = extension?.checkpoint?.continuation;
+    const restored = continuation ? JSON.parse(continuation) : undefined;
+    const source = new Map();
+    for (const message of value.messages) {
+        MessageSchema.parse(message);
+        if (source.has(message.id))
+            throw new Error("Duplicate message ID.");
+        source.set(message.id, message);
+    }
+    const convert = (message) => {
+        // Display-only messages stay in protocol history; native reasoning replay comes from the checkpoint.
+        if (message.role === "activity" || message.role === "reasoning")
+            return [];
+        if (message.role === "assistant")
+            return [{ id: message.id, role: "assistant", content: message.content ?? null, toolCalls: (message.toolCalls ?? []).map((call) => ({ id: call.id, ...call.function })) }];
+        if (message.role === "tool") {
+            const owner = value.messages.slice(0, value.messages.indexOf(message)).reverse().find((item) => item.role === "assistant" && item.toolCalls?.some((call) => call.id === message.toolCallId));
+            const call = owner?.role === "assistant" ? owner.toolCalls?.find((call) => call.id === message.toolCallId) : undefined;
+            const content = message.error !== undefined && getToolResultError(message.content) === undefined
+                ? JSON.stringify({ error: { code: "TOOL_ERROR", message: message.error }, content: message.content }) : message.content;
+            return [{ id: message.id, role: "tool", name: call?.function.name ?? "unknown", toolCallId: message.toolCallId, content }];
+        }
+        if (message.role === "user") {
+            if (Array.isArray(message.content) && message.content.some((part) => part.type !== "text" && part.type !== "image"))
+                throw new Error("This Agent supports text and image input only.");
+            return [{ id: message.id, role: "user", content: message.content }];
+        }
+        throw new Error(`Unsupported model history role: ${message.role}.`);
+    };
+    const used = new Set();
+    const messages = (restored?.timeline ?? []).flatMap((entry) => {
+        if ("internal" in entry) {
+            if (entry.internal.role !== "system" && entry.internal.role !== "application_context")
+                throw new Error("Invalid checkpoint history.");
+            return [entry.internal];
+        }
+        const message = source.get(entry.messageId);
+        if (!message || used.has(message.id))
+            throw new Error("Checkpoint message is missing or repeated.");
+        used.add(message.id);
+        return convert(message);
+    });
+    let toolResult;
+    const pending = restored?.pending;
+    let resultMessageId;
+    if (pending) {
+        const resume = value.resume;
+        if (typeof pending.interruptId !== "string" || !pending.interruptId || !resume || resume.length !== 1)
+            throw new Error("A pending client tool requires exactly one resume entry.");
+        const entry = resume[0];
+        if (entry.interruptId !== pending.interruptId || entry.status !== "resolved")
+            throw new Error("Resume does not match the pending interrupt.");
+        const payload = entry.payload;
+        if (!payload || typeof payload.toolResultMessageId !== "string" || (payload.confirmed !== undefined && typeof payload.confirmed !== "boolean"))
+            throw new Error("Invalid client tool resume payload.");
+        const message = source.get(payload.toolResultMessageId);
+        const pendingId = pending.calls?.[0]?.id;
+        if (!message || used.has(message.id) || message.role !== "tool" || message.toolCallId !== pendingId)
+            throw new Error("Resume result does not match the pending tool call.");
+        let result;
+        try {
+            result = JSON.parse(message.content);
+        }
+        catch (error) {
+            if (message.error === undefined)
+                throw error;
+        }
+        if (message.error !== undefined)
+            result = { error: { code: result?.error?.code ?? "TOOL_ERROR", message: message.error } };
+        if (!result || typeof result !== "object" || (!("result" in result) && !("error" in result)))
+            throw new Error("Invalid browser tool result.");
+        resultMessageId = message.id;
+        toolResult = { toolCallId: pendingId, ...(result.error ? { error: result.error } : { result: result.result }), ...(payload.confirmed === true ? { confirmed: true } : {}) };
+    }
+    else if (value.resume?.length)
+        throw new Error("Cannot resume without a pending interrupt.");
+    for (const message of value.messages) {
+        if (used.has(message.id) || message.id === resultMessageId)
+            continue;
+        if (pending && message.role === "tool" && message.toolCallId === pending.calls[0]?.id)
+            throw new Error("Repeated browser result.");
+        messages.push(...convert(message));
+    }
+    return {
+        messages, ...(continuation ? { continuation } : {}), ...(toolResult ? { toolResult, toolResultMessageId: resultMessageId } : {}),
+        tools: value.tools.map((tool) => ({ name: tool.name, description: tool.description, inputSchema: tool.parameters, effect: extension?.toolMetadata?.[tool.name]?.effect ?? "action" })),
+        contexts: value.context.map((context, index) => {
+            let data = context.value;
+            try {
+                data = JSON.parse(context.value);
+            }
+            catch { /* AG-UI context values may be plain text. */ }
+            if (data && typeof data === "object" && "name" in data && "value" in data)
+                return data;
+            return { name: `context${index}`, description: context.description, value: data };
+        }),
+    };
+}
+export function runResponse(run) {
+    const encoder = new TextEncoder();
+    const iterator = run[Symbol.asyncIterator]();
+    void run.result.catch(() => undefined);
+    return new Response(new ReadableStream({
+        async pull(controller) {
+            try {
+                const next = await iterator.next();
+                if (next.done)
+                    controller.close();
+                else
+                    controller.enqueue(encoder.encode(`data: ${JSON.stringify(next.value)}\n\n`));
+            }
+            catch (error) {
+                controller.error(error);
+            }
+        },
+        async cancel() { run.cancel(); await iterator.return?.(); },
+    }), { headers: {
+            "Content-Type": "text/event-stream",
+            "Cache-Control": "no-cache, no-transform",
+            "X-Accel-Buffering": "no",
+        } });
+}
+export function mergeProtocolMessages(messages, previous) {
+    const remaining = new Map(messages.map((message) => [message.id, message]));
+    const mergedHistory = previous.flatMap((old) => {
+        const message = remaining.get(old.id);
+        if (!message)
+            return old.role === "activity" || old.role === "reasoning" ? [old] : [];
+        remaining.delete(old.id);
+        const merged = { ...old, ...message };
+        if (message.role === "tool" && old.role === "tool" && old.error !== undefined)
+            merged.content = old.content;
+        if (message.role === "assistant" && old.role === "assistant")
+            merged.toolCalls = message.toolCalls?.map((call) => ({ ...old.toolCalls?.find((item) => item.id === call.id), ...call }));
+        return [MessageSchema.parse(merged)];
+    });
+    return [...mergedHistory, ...remaining.values()];
+}
+//# sourceMappingURL=request.js.map

package/dist/request.js.map

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

package/dist/types.d.ts

@@ -1,10 +1,13 @@
+import type { RegisteredAgentTool } from "@nexface/tools";
+import type { RunAgentInput, AgentCheckpoint } from "./request.js";
 import type { ToolRuntime, AgentToolInputSchema } from "@nexface/tools";
 import type { AgentModelConfig, AgentModelInfo } from "./model/types.js";
-import type { ToolBridge } from "./tool-bridge.js";
-import type { TextInputContent, ImageInputContent, RunStartedEvent, RunFinishedEvent, RunErrorEvent, TextMessageStartEvent, TextMessageContentEvent, TextMessageEndEvent, ToolCallStartEvent, ToolCallArgsEvent, ToolCallEndEvent, ToolCallResultEvent } from "@ag-ui/core";
+import type { TextInputContent, ImageInputContent, RunStartedEvent, RunFinishedEvent, RunErrorEvent, TextMessageStartEvent, TextMessageContentEvent, TextMessageEndEvent, ToolCallStartEvent, ToolCallArgsEvent, ToolCallEndEvent, ToolCallResultEvent, CustomEvent, MessagesSnapshotEvent } from "@ag-ui/core";
 export type AgentInputContent = TextInputContent | ImageInputContent;
 export declare const agentBrand: unique symbol;
 export type AgentMessage = {
+    id?: string;
+} & ({
     role: "system";
     content: string;
 } | {
@@ -27,7 +30,7 @@ export type AgentMessage = {
     toolCallId: string;
     name: string;
     content: string;
-};
+});
 export interface AgentModelToolCall {
     id: string;
     name: string;
@@ -54,7 +57,7 @@ export interface AgentRunOptions {
     signal?: AbortSignal;
 }
 /**
- * @experimental Human-in-the-loop approval descriptor.
+ * @experimental Human-in-the-loop approval descriptor; ordinary completed Runs are not experimental.
  * @beta
  */
 export type ToolApprovalInterruptDescriptor = {
@@ -74,28 +77,28 @@ export type ToolApprovalInterruptDescriptor = {
     readonly mode: "page";
 });
 export type AgentRunResult = {
-    readonly status: "completed";
+    readonly outcome: Extract<NonNullable<RunFinishedEvent["outcome"]>, {
+        type: "success";
+    }>;
     readonly output: string;
+    readonly checkpoint?: AgentCheckpoint;
 } | {
-    /**
-     * @experimental Human-in-the-loop interruption; ordinary completed Runs are not experimental.
-     * @beta
-     */
-    readonly status: "interrupted";
-    /**
-     * @experimental Human-in-the-loop approval descriptor.
-     * @beta
-     */
-    readonly interrupt: ToolApprovalInterruptDescriptor;
+    readonly outcome: Extract<NonNullable<RunFinishedEvent["outcome"]>, {
+        type: "interrupt";
+    }>;
+    readonly output?: never;
+    readonly checkpoint?: AgentCheckpoint;
 };
-export type AgentRunEvent = RunStartedEvent | RunFinishedEvent | RunErrorEvent | TextMessageStartEvent | TextMessageContentEvent | TextMessageEndEvent | ToolCallStartEvent | ToolCallArgsEvent | ToolCallEndEvent | ToolCallResultEvent;
+export type AgentRunEvent = RunStartedEvent | RunFinishedEvent | RunErrorEvent | TextMessageStartEvent | TextMessageContentEvent | TextMessageEndEvent | ToolCallStartEvent | ToolCallArgsEvent | ToolCallEndEvent | ToolCallResultEvent | CustomEvent | MessagesSnapshotEvent;
 export interface AgentRun extends AsyncIterable<AgentRunEvent> {
     readonly id: string;
     readonly result: Promise<AgentRunResult>;
     cancel(): void;
+    toResponse(): Response;
 }
 export type AgentRunInput = {
     readonly message: {
+        readonly id?: string;
         readonly content: string | readonly AgentInputContent[];
     };
     readonly resume?: never;
@@ -123,23 +126,19 @@ export interface AgentSkill {
 }
 export type CreateAgentOptions = {
     model: AgentModelConfig;
+    toolRuntime?: ToolRuntime;
+    tools?: readonly RegisteredAgentTool[];
     skills?: readonly AgentSkill[];
     maxSteps?: number;
     maxRetries?: number;
     applicationContext?: {
         maxSizeBytes?: number;
     };
-} & ({
-    toolRuntime: ToolRuntime;
-    toolBridge?: never;
-} | {
-    toolBridge: ToolBridge;
-    toolRuntime?: never;
-});
+};
 export interface Agent {
     readonly [agentBrand]: true;
     readonly id: string;
     readonly model: AgentModelInfo;
     switchModel(model: AgentModelConfig): Promise<void>;
-    run(input: AgentRunInput, options?: AgentRunOptions): AgentRun;
+    run(input: AgentRunInput | RunAgentInput, options?: AgentRunOptions): AgentRun;
 }

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,UAAU,GAAkB,MAAM,CAAC,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAeA,MAAM,CAAC,MAAM,UAAU,GAAkB,MAAM,CAAC,gBAAgB,CAAC,CAAC"}

package/package.json

@@ -1,11 +1,15 @@
 {
   "name": "@nexface/agent",
-  "version": "0.1.1-alpha.5",
+  "version": "0.1.1-alpha.6",
   "type": "module",
   "engines": {
     "node": ">=22.19.0"
   },
   "exports": {
+    "./internal": {
+      "types": "./dist/internal.d.ts",
+      "default": "./dist/internal.js"
+    },
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
@@ -35,6 +39,6 @@
     "@ag-ui/core": "0.0.59"
   },
   "peerDependencies": {
-    "@nexface/tools": "0.1.1-alpha.5"
+    "@nexface/tools": "0.1.1-alpha.6"
   }
 }