@economic/agents-react 1.7.0 → 2.0.0-alpha.38489283394.1.0

package/README.md

@@ -212,4 +212,4 @@ The package also exports the handler types `AssistantActions`, `GetChatsHandler`
 
 ## Authentication
 
-Pass a JWT as `authToken`. It is sent both as an `Authorization: Bearer …` header and as a WebSocket subprotocol (`["bearer", token]`), matching the server-side [`getJwtAuthConfig`](../agents/README.md#authentication). When verification fails, the connection status becomes `"unauthorized"`.
+Pass a JWT as `authToken`. It is sent both as an `Authorization: Bearer …` header and as a WebSocket subprotocol (`["bearer", token]`), matching the server-side [`getAuthenticator(env)`](../agents/README.md#authentication). When verification fails, the connection status becomes `"unauthorized"`.

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { useAgent as useAgent$1 } from "agents/react";
 import { getToolApproval, getToolCallId, getToolPartState, useAgentChat } from "@cloudflare/ai-chat/react";
-
+import { UIMessage } from "ai";
 //#region src/types.d.ts
 type _CfAgent = ReturnType<typeof useAgent$1>;
 type Agent = Omit<_CfAgent, "call"> & {
@@ -10,7 +10,8 @@ type Chat = ReturnType<typeof useAgentChat>;
 type AgentConnectionStatus = "connecting" | "reconnecting" | "connected" | "disconnected" | "unauthorized" | "error";
 type AgentConnectionType = "agent" | "chat" | "assistant";
 type ChatSummary = {
-  name: string; /** True when this entry only represents the active, unregistered chat facet. */
+  name: string;
+  /** True when this entry only represents the active, unregistered chat facet. */
   isTemporary?: boolean;
   title?: string;
   summary?: string;
@@ -38,6 +39,16 @@ type CreateChatHandler = () => Promise<string>;
 type OpenChatHandler = (chatId: string) => void;
 type DeleteChatHandler = (chatId: string) => Promise<void>;
 type RenameChatHandler = (chatId: string, title: string) => Promise<void>;
+/** How an agent's `run` ended: with its answer, waiting for an approval, or without one. */
+type RunResult = {
+  status: "completed";
+  output: unknown;
+} | {
+  status: "waiting";
+} | {
+  status: "error" | "skipped" | "aborted";
+  error?: string;
+};
 //#endregion
 //#region src/useAgent.d.ts
 interface UseAgentReturn {
@@ -61,7 +72,7 @@ interface UseAgentOptions {
   onError?: (event: ErrorEvent) => void;
   onMessage?: (event: MessageEvent) => void;
 }
-declare function useAgent(options: UseAgentOptions): UseAgentReturn;
+export declare function useAgent(options: UseAgentOptions): UseAgentReturn;
 //#endregion
 //#region src/useChat.d.ts
 interface UseChatReturn {
@@ -79,7 +90,7 @@ interface UseChatOptions<ToolContext extends Record<string, unknown>> extends Us
   /** Include internal SDK messages such as compaction summaries. Defaults to false. */
   showInternalMessages?: boolean;
 }
-declare function useChat<ToolContext extends Record<string, unknown>>(options: UseChatOptions<ToolContext>): UseChatReturn;
+export declare function useChat<ToolContext extends Record<string, unknown>>(options: UseChatOptions<ToolContext>): UseChatReturn;
 //#endregion
 //#region src/useAssistant.d.ts
 interface Assistant {
@@ -100,6 +111,33 @@ interface UseAssistantReturn {
 interface UseAssistantOptions<ToolContext extends Record<string, unknown> = Record<string, unknown>> extends Omit<UseChatOptions<ToolContext>, "actorId" | "getInitialMessages"> {
   initialChatId?: string;
 }
-declare function useAssistant<ToolContext extends Record<string, unknown>>(options: UseAssistantOptions<ToolContext>): UseAssistantReturn;
+export declare function useAssistant<ToolContext extends Record<string, unknown>>(options: UseAssistantOptions<ToolContext>): UseAssistantReturn;
+//#endregion
+//#region src/useTask.d.ts
+interface UseTaskOptions<ToolContext extends Record<string, unknown>> extends Omit<UseAgentOptions, "name" | "enabled"> {
+  /** The agent's name for one run, from that run's new ID. */
+  name: (runId: string) => string;
+  toolContext?: ToolContext;
+}
+interface UseTaskReturn {
+  /** Starts a new run on `input`, apart from any earlier one. */
+  run: (input: unknown) => void;
+  /** The current run's ID, once one has started. */
+  runId: string | undefined;
+  /** The current run's messages as they stream: its input, tool calls and answer. */
+  messages: UIMessage[];
+  /** How the current run ended, once it has. */
+  result: RunResult | undefined;
+  running: boolean;
+  status: AgentConnectionStatus;
+  agent: Agent;
+  /** The run's chat, to answer its tool approvals. */
+  chat: Chat;
+}
+/**
+ * Runs an agent once per input, each run on an agent of its own, so runs
+ * don't share history. Nothing is loaded from earlier runs.
+ */
+export declare function useTask<ToolContext extends Record<string, unknown>>(options: UseTaskOptions<ToolContext>): UseTaskReturn;
 //#endregion
-export { type Agent, type AgentConnectionStatus, type AgentConnectionType, type Assistant, type Chat, type ChatSummary, type CreateChatHandler, type DeleteChatHandler, type GetChatsHandler, type GetInvocableSkillsHandler, type GetMessageFeedbackHandler, type InvocableSkill, type MessageFeedback, type MessageFeedbackHandler, type OpenChatHandler, type RenameChatHandler, type UseAgentReturn, type UseAssistantReturn, type UseChatReturn, getToolApproval, getToolCallId, getToolPartState, useAgent, useAssistant, useChat };
+export { type Agent, type AgentConnectionStatus, type AgentConnectionType, type Assistant, type Chat, type ChatSummary, type CreateChatHandler, type DeleteChatHandler, type GetChatsHandler, type GetInvocableSkillsHandler, type GetMessageFeedbackHandler, type InvocableSkill, type MessageFeedback, type MessageFeedbackHandler, type OpenChatHandler, type RenameChatHandler, type RunResult, type UseAgentReturn, type UseAssistantReturn, type UseChatReturn, type UseTaskOptions, type UseTaskReturn, getToolApproval, getToolCallId, getToolPartState };

package/dist/index.mjs

@@ -2,7 +2,6 @@ import { n as visibleChatMessages, t as getTokenArgs } from "./util-tBvVuxIJ.mjs
 import { useCallback, useEffect, useLayoutEffect, useRef, useState } from "react";
 import { useAgent as useAgent$1 } from "agents/react";
 import { getToolApproval, getToolCallId, getToolPartState, useAgentChat } from "@cloudflare/ai-chat/react";
-import { agentFetch } from "agents/client";
 //#region src/useAgent.ts
 function getAgentConnectionStatus(state, connectionId) {
 	return state.connectionId === connectionId ? state.status : "connecting";
@@ -204,19 +203,6 @@ function useAgent(options) {
 }
 //#endregion
 //#region src/useChat.ts
-async function fetchInvocableSkills(agent) {
-	const target = getAgentSocketTarget(agent);
-	if (!target) throw new Error("Cannot determine the connected agent");
-	const path = target.subPath ? `${target.subPath}/getInvocableSkills` : "getInvocableSkills";
-	const response = await agentFetch({
-		agent: target.agentName,
-		host: target.host,
-		name: target.name,
-		path
-	}, { headers: target.authToken ? { Authorization: `Bearer ${target.authToken}` } : void 0 });
-	if (!response.ok) throw new Error(`Failed to get invocable skills (${response.status})`);
-	return response.json();
-}
 function useChat(options) {
 	const { toolContext, welcomeMessage, showInternalMessages = false, ...agentOptions } = options;
 	const { agent, status } = useAgent({
@@ -226,9 +212,10 @@ function useChat(options) {
 	const chat = useAgentChat({
 		agent,
 		body: toolContext ?? {},
+		headers: agentOptions.authToken ? { Authorization: `Bearer ${agentOptions.authToken}` } : void 0,
 		getInitialMessages: !!agentOptions.name && status === "connected" ? void 0 : null
 	});
-	const getInvocableSkills = useCallback(() => fetchInvocableSkills(agent), [agent]);
+	const getInvocableSkills = useCallback(async () => await agent.call("getInvocableSkills"), [agent]);
 	const hasSentWelcome = useRef(false);
 	useEffect(() => {
 		if (welcomeMessage && status === "connected" && chat.messages.length === 0 && !hasSentWelcome.current) {
@@ -405,4 +392,56 @@ function useAssistant(options) {
 	};
 }
 //#endregion
-export { getToolApproval, getToolCallId, getToolPartState, useAgent, useAssistant, useChat };
+//#region src/useTask.ts
+/**
+* Runs an agent once per input, each run on an agent of its own, so runs
+* don't share history. Nothing is loaded from earlier runs.
+*/
+function useTask(options) {
+	const { name, toolContext, ...agentOptions } = options;
+	const [run, setRun] = useState();
+	const [result, setResult] = useState();
+	const started = useRef(void 0);
+	const { agent, status } = useAgent({
+		...agentOptions,
+		name: run ? name(run.id) : "",
+		enabled: !!run
+	});
+	const chat = useAgentChat({
+		agent,
+		getInitialMessages: null
+	});
+	useEffect(() => {
+		if (!run || status !== "connected" || started.current === run.id) return;
+		started.current = run.id;
+		agent.call("run", [run.input, toolContext]).catch((error) => ({
+			status: "error",
+			error: error instanceof Error ? error.message : String(error)
+		})).then((ended) => setResult({
+			runId: run.id,
+			result: ended
+		}));
+	}, [
+		agent,
+		run,
+		status,
+		toolContext
+	]);
+	const start = useCallback((input) => setRun({
+		id: crypto.randomUUID(),
+		input
+	}), []);
+	const current = run && result?.runId === run.id ? result.result : void 0;
+	return {
+		run: start,
+		runId: run?.id,
+		messages: run ? visibleChatMessages(chat.messages, false) : [],
+		result: current,
+		running: !!run && !current && (status === "connecting" || status === "reconnecting" || status === "connected"),
+		status,
+		agent,
+		chat
+	};
+}
+//#endregion
+export { getToolApproval, getToolCallId, getToolPartState, useAgent, useAssistant, useChat, useTask };

package/dist/v1.d.mts

@@ -1,9 +1,8 @@
 import { useAgent } from "agents/react";
 import { useAgentChat } from "@cloudflare/ai-chat/react";
-
 //#region src/v1/index.d.ts
-type AgentConnectionStatus = "connecting" | "connected" | "disconnected" | "unauthorized";
-interface UseAIChatAgentOptions {
+export type AgentConnectionStatus = "connecting" | "connected" | "disconnected" | "unauthorized";
+export interface UseAIChatAgentOptions {
   agent: string;
   host: string;
   basePath?: string;
@@ -27,6 +26,5 @@ type UseAIChatAgentResult = {
   chat: ReturnType<typeof useAgentChat>;
   connectionStatus: AgentConnectionStatus;
 };
-declare function useAIChatAgent(options: UseAIChatAgentOptions): UseAIChatAgentResult;
-//#endregion
-export { AgentConnectionStatus, UseAIChatAgentOptions, useAIChatAgent };
+export declare function useAIChatAgent(options: UseAIChatAgentOptions): UseAIChatAgentResult;
+//#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@economic/agents-react",
-  "version": "1.7.0",
+  "version": "2.0.0-alpha.38489283394.1.0",
   "license": "MIT",
   "files": [
     "dist"
@@ -20,18 +20,18 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@ai-sdk/react": "^3.0.182",
-    "@cloudflare/ai-chat": "^0.11.0",
-    "agents": "^0.22.0",
-    "ai": "^6.0.180",
-    "zod": "^4.4.3"
+    "@ai-sdk/react": "^4.0.140",
+    "@cloudflare/ai-chat": "^0.12.1",
+    "agents": "^0.28.0",
+    "ai": "^7.0.137",
+    "zod": "^4.6.5"
   },
   "devDependencies": {
-    "@cloudflare/workers-types": "^4.20260702.1",
-    "@types/node": "^25.6.0",
-    "@typescript/native-preview": "7.0.0-dev.20260412.1",
-    "tsdown": "^0.22.0",
-    "typescript": "^6.0.2",
+    "@cloudflare/workers-types": "^5.20261009.1",
+    "@types/node": "^26.6.4",
+    "@typescript/native-preview": "7.0.0-dev.20260707.2",
+    "tsdown": "^0.23.0",
+    "typescript": "^7.0.2",
     "vitest": "^4.1.4"
   },
   "peerDependencies": {