@economic/agents 2.11.0 → 2.11.1

package/README.md

@@ -663,7 +663,7 @@ Imported from `@economic/agents` unless noted.
 | Export                                                                   | Description                                                                |
 | ------------------------------------------------------------------------ | -------------------------------------------------------------------------- |
 | `tool(def)` / `Tool` / `ToolSet`                                         | Define a tool with optional `approval`, `authorize`, and `onUnauthorized`. |
-| `action(def)` / `Action` / `ActionConfig` / `ActionContext`              | Define a ledger-backed action with approval and idempotency support.       |
+| `action(def)` / `Action` / `RegisteredAction` / `ActionContext`          | Define a ledger-backed action with approval and idempotency support.       |
 | `skill(def)` / `Skill`                                                   | Define a skill with optional `tools`, `actions`, and authorization.        |
 | `ToolContext`                                                            | `RequestContext & { _userContext?: UserContext }`.                         |
 | `AgentEnv`                                                               | The bindings the runtime expects.                                          |

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { Agent as Agent$1, AgentOptions, Connection, ConnectionContext, SubAgentClass } from "agents";
-import { Action as Action$1, ActionConfig as ActionConfig$1, ActionContext as ActionContext$1, ChatResponseResult, PrepareStepContext, Session, Think, ToolCallContext, ToolCallDecision, TurnConfig, TurnContext, skills } from "@cloudflare/think";
-import { FlexibleSchema, InferSchema, JSONValue, LanguageModel, ModelMessage, Tool as Tool$1, ToolExecutionOptions, UIMessage } from "ai";
+import { Action as Action$1, ActionConfig, ActionContext as ActionContext$1, ChatResponseResult, PrepareStepContext, Session, Think, ToolCallContext, ToolCallDecision, TurnConfig, TurnContext, skills } from "@cloudflare/think";
+import { FlexibleSchema, JSONValue, LanguageModel, ModelMessage, Tool as Tool$1, ToolExecutionOptions, UIMessage } from "ai";
 import { Observability } from "agents/observability";
 import { createCompactFunction } from "agents/experimental/memory/utils";
 import { SkillSource as SkillSource$1 } from "agents/skills";
@@ -415,17 +415,19 @@ type ActionContext<Context extends Record<string, unknown> = Record<string, unkn
   experimental_context: Context; /** The action's resolved domain key, or its tool-call fallback when none was declared. */
   idempotencyKey: string;
 };
-type ActionConfig<Context extends Record<string, unknown>, InputSchema extends FlexibleSchema, Output = unknown> = Omit<ActionConfig$1<InputSchema, Output>, "execute"> & {
+type Action<Context extends Record<string, unknown> = Record<string, unknown>, Input = any, Output = any> = Omit<Tool<Context, Input, Output>, "approval" | "description" | "execute" | "inputSchema" | "needsApproval"> & Omit<ActionConfig<FlexibleSchema<Input>, Output>, "description" | "execute" | "inputSchema"> & {
+  description: string;
+  inputSchema: FlexibleSchema<Input>;
   authorize?: (ctx?: Context) => boolean;
   onUnauthorized?: UnauthorizedToolPolicy<Context>;
-  execute(input: InferSchema<InputSchema>, ctx: ActionContext<Context>): Promise<Output> | Output;
+  execute(input: Input, ctx: ActionContext<Context>): Promise<Output> | Output;
 };
-type Action<Context extends Record<string, unknown> = Record<string, unknown>, InputSchema extends FlexibleSchema = FlexibleSchema, Output = unknown> = Action$1<InputSchema, Output> & {
+type RegisteredAction<Context extends Record<string, unknown> = Record<string, unknown>, InputSchema extends FlexibleSchema = FlexibleSchema, Output = unknown> = Action$1<InputSchema, Output> & {
   authorize?: (ctx?: Context) => boolean;
   onUnauthorized?: UnauthorizedToolPolicy<Context>;
 };
 /** A native Think action with the SDK's standard authorization policy. */
-declare function action<Context extends Record<string, unknown> = Record<string, unknown>, const InputSchema extends FlexibleSchema = FlexibleSchema, Output = unknown>(definition: ActionConfig<Context, InputSchema, Output>): Action<Context, InputSchema, Output>;
+declare function action<Context extends Record<string, unknown> = Record<string, unknown>, Input = any, Output = any>(definition: Action<Context, Input, Output>): RegisteredAction<Context, FlexibleSchema<Input>, Output>;
 //#endregion
 //#region src/server/util/skills.d.ts
 interface Skill<Context extends Record<string, unknown> = Record<string, unknown>> {
@@ -433,12 +435,12 @@ interface Skill<Context extends Record<string, unknown> = Record<string, unknown
   description: string;
   instructions: string;
   tools?: Record<string, Tool<Context>>;
-  actions?: Record<string, Action<Context, any, any>>;
+  actions?: Record<string, RegisteredAction<Context, any, any>>;
   authorize?: (ctx?: Context) => boolean;
 }
 interface SkillSource<Context extends Record<string, unknown> = Record<string, unknown>> extends SkillSource$1 {
   tools?: Record<string, Tool<Context>>;
-  actions?: Record<string, Action<Context, any, any>>;
+  actions?: Record<string, RegisteredAction<Context, any, any>>;
   authorize?: (ctx?: Context | undefined) => boolean;
 }
 declare function skill<Context extends Record<string, unknown> = Record<string, unknown>>(definition: Skill<Context>): SkillSource<Context>;
@@ -449,4 +451,4 @@ declare function routeAgentRequest<Env>(request: Request, env: Env, options?: Ag
 //#region src/server/index.d.ts
 declare function getCurrentToolContext(): any;
 //#endregion
-export { type Action, type ActionConfig, type ActionContext, Agent, type AgentConnectionStatus, type AgentConnectionType, type AgentEnv, Assistant, ChatAgent, type ExchangedToken, type JwtAuthConfig, type Skill, type SkillSource, type TokenExchangeConfig, type TokenExchangeResult, type Tool, type ToolContext, type ToolSet, type TurnSnapshot, type UnauthorizedToolPolicy, action, createJwtAuthConfig, exchangeToken, getCurrentToolContext, routeAgentRequest, skill, tool };
+export { type Action, type ActionContext, Agent, type AgentConnectionStatus, type AgentConnectionType, type AgentEnv, Assistant, ChatAgent, type ExchangedToken, type JwtAuthConfig, type RegisteredAction, type Skill, type SkillSource, type TokenExchangeConfig, type TokenExchangeResult, type Tool, type ToolContext, type ToolSet, type TurnSnapshot, type UnauthorizedToolPolicy, action, createJwtAuthConfig, exchangeToken, getCurrentToolContext, routeAgentRequest, skill, tool };

package/dist/index.mjs

@@ -2497,10 +2497,11 @@ function action(definition) {
 		...config,
 		approval: config.approval ?? true,
 		execute: async (input, ctx) => {
-			const idempotencyKey = typeof config.idempotencyKey === "function" ? await config.idempotencyKey({
+			const configuredKey = config.idempotencyKey;
+			const idempotencyKey = typeof configuredKey === "function" ? await configuredKey({
 				input,
 				ctx
-			}) : config.idempotencyKey ?? ctx.toolCallId;
+			}) : typeof configuredKey === "string" ? configuredKey : ctx.toolCallId;
 			return execute(input, {
 				...ctx,
 				messages: [...ctx.messages],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@economic/agents",
-  "version": "2.11.0",
+  "version": "2.11.1",
   "description": "A starter for creating a TypeScript package.",
   "license": "MIT",
   "files": [