agent-lattice 0.9.19 → 0.9.21

package/README.md

@@ -82,6 +82,27 @@ When `outputFormat` is set, the SDK sends structured output parameters to the
 provider and returns the final text unchanged. Parse or validate the returned
 JSON in your application when you need a typed value.
 
+Pass `thinkingConfig` on the agent to configure reasoning for every query, or
+on an individual query to override the agent default:
+
+```ts
+const agent = createAgent({
+  apiKey: process.env.ANTHROPIC_API_KEY,
+  model: "claude-sonnet-4-6",
+  thinkingConfig: { type: "adaptive" },
+});
+
+const result = await agent.prompt("Solve this carefully.", {
+  thinkingConfig: { type: "enabled", budgetTokens: 8_000 },
+});
+```
+
+Use `{ type: "adaptive" }` for models that support adaptive thinking. Use
+`{ type: "enabled", budgetTokens }` for models that require a fixed budget, or
+`{ type: "disabled" }` to omit thinking from the provider request. A fixed
+budget is capped at `maxTokens - 1` to satisfy the Anthropic API constraint.
+When omitted, the SDK does not send a thinking configuration.
+
 ## Multimodal Input
 
 Pass Anthropic-compatible content blocks for image or document prompts:
@@ -512,6 +533,14 @@ delivery: the runtime waits for the member's upstream reply, feeds it back to
 the lead, and keeps going until the root lead returns the final result or the
 run terminates.
 
+Accepted handoffs use work-item failure isolation by default. If one member
+returns an agent error such as `MaxTurnsError` or `APIError`, the runtime marks
+that work item `failed`, sends a failure report to the lead, and continues the
+other accepted handoffs. The lead receives successful and failed reports
+together and decides whether to retry, revise the task, accept a partial result,
+or finish. A run-wide `AbortError` still stops the runner; the runtime marks the
+current and remaining accepted work `cancelled` before propagating the abort.
+
 Team member tools can also request explicit shared workspace write grants:
 
 ```ts

package/dist/index.d.ts

@@ -20,7 +20,16 @@ export type ToolResultBlock = {
     content: string | ContentBlock[];
     is_error?: boolean;
 };
-export type ContentBlock = TextBlock | ImageBlock | DocumentBlock | ToolUseBlock | ToolResultBlock;
+export type ThinkingBlock = {
+    type: "thinking";
+    thinking: string;
+    signature: string;
+};
+export type RedactedThinkingBlock = {
+    type: "redacted_thinking";
+    data: string;
+};
+export type ContentBlock = TextBlock | ImageBlock | DocumentBlock | ToolUseBlock | ToolResultBlock | ThinkingBlock | RedactedThinkingBlock;
 export type AgentLikeEvent = SDKMessage | TeamRunnerMessage;
 export type AgentLike<TContext = unknown> = {
     query(prompt: string | ContentBlock[], options?: QueryOptions<TContext>): AsyncGenerator<AgentLikeEvent>;
@@ -44,13 +53,19 @@ export type AgentRuntimeDelegateInput = {
     workspaceGrants?: WorkspaceGrantInput[];
 };
 export type AgentRuntimeDelegateResult = {
-    status: "completed" | "accepted";
+    status: "completed" | "accepted" | "failed";
     content: string;
     request: TeamMessage;
     reply?: TeamMessage;
     result?: SDKResultMessage;
+    error?: AgentRuntimeFailure;
     workspaceGrants?: WorkspaceGrant[];
 };
+export type AgentRuntimeFailure = {
+    code: "max_turns_exceeded" | "api_error" | "tool_execution_error" | "permission_denied" | "agent_error";
+    message: string;
+    name: string;
+};
 export type WorkspaceAccess = "read" | "write" | "execute";
 export type WorkspaceGrantInput = {
     root: string;
@@ -151,6 +166,7 @@ export type ModelRequest = {
     tools: ModelToolDefinition[];
     stream: boolean;
     outputFormat?: OutputFormat;
+    thinkingConfig?: ThinkingConfig;
     onStreamEvent?: (event: Record<string, unknown>) => void;
     signal?: AbortSignal;
 };
@@ -362,6 +378,7 @@ export type AgentOptions<TContext = unknown> = {
     systemPrompt?: string;
     maxTokens?: number;
     maxTurns?: number;
+    thinkingConfig?: ThinkingConfig;
     tools?: Array<ToolDefinition<any, TContext>>;
     skills?: SkillDefinition[];
     workspace?: AgentWorkspaceOptions;
@@ -378,6 +395,7 @@ export type AgentWorkspaceToolsOptions = {
 export type QueryOptions<TContext = unknown> = {
     stream?: boolean;
     outputFormat?: OutputFormat;
+    thinkingConfig?: ThinkingConfig;
     signal?: AbortSignal;
     context?: TContext;
     agentRuntime?: AgentRuntimeContext;
@@ -385,6 +403,14 @@ export type QueryOptions<TContext = unknown> = {
     tracer?: ContextTracer;
 };
 export type OutputFormat = "json" | BetaJSONOutputFormat;
+export type ThinkingConfig = {
+    type: "adaptive";
+} | {
+    type: "enabled";
+    budgetTokens: number;
+} | {
+    type: "disabled";
+};
 export type SDKSystemInitMessage = {
     type: "system";
     subtype: "init";
@@ -422,10 +448,11 @@ export type SDKMessage = SDKSystemInitMessage | SDKStreamEventMessage | SDKAssis
 export type TeamRunnerSource = AgentRuntimeSource;
 export type TeamRunnerTeamMessage = {
     type: "team_message";
-    subtype: "sent" | "claimed" | "replied" | "followup" | "done" | "failed";
+    subtype: "sent" | "claimed" | "replied" | "followup" | "done" | "failed" | "cancelled";
     source: TeamRunnerSource;
     mailbox: string;
     message: TeamMessage;
+    error?: AgentRuntimeFailure;
 };
 export type TeamRunnerAgentMessage = {
     type: "agent_message";
@@ -517,6 +544,7 @@ export declare function query<TContext = unknown>(params: AgentOptions<TContext>
     prompt: string;
     stream?: boolean;
     outputFormat?: OutputFormat;
+    thinkingConfig?: ThinkingConfig;
     signal?: AbortSignal;
     context?: TContext;
 }): AsyncGenerator<SDKMessage>;