agent-lattice 0.9.18 → 0.9.20

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:
@@ -180,8 +201,17 @@ const agent = createAgent({
   model: "deepseek-v4-flash",
   tracer,
 });
+
+try {
+  await agent.prompt("Trace this run.", { stream: false });
+} finally {
+  await tracer.close?.();
+}
 ```
 
+Close or flush the LangSmith tracer before a short-lived test process exits so
+LangSmith receives the final root run patch.
+
 If you prefer explicit values over environment variables, pass them to the SDK
 tracer. `workspaceId` is optional and only selects a LangSmith workspace; it is
 not the tracing project name.

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>;
@@ -151,6 +160,7 @@ export type ModelRequest = {
     tools: ModelToolDefinition[];
     stream: boolean;
     outputFormat?: OutputFormat;
+    thinkingConfig?: ThinkingConfig;
     onStreamEvent?: (event: Record<string, unknown>) => void;
     signal?: AbortSignal;
 };
@@ -362,6 +372,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 +389,7 @@ export type AgentWorkspaceToolsOptions = {
 export type QueryOptions<TContext = unknown> = {
     stream?: boolean;
     outputFormat?: OutputFormat;
+    thinkingConfig?: ThinkingConfig;
     signal?: AbortSignal;
     context?: TContext;
     agentRuntime?: AgentRuntimeContext;
@@ -385,6 +397,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";
@@ -517,6 +537,7 @@ export declare function query<TContext = unknown>(params: AgentOptions<TContext>
     prompt: string;
     stream?: boolean;
     outputFormat?: OutputFormat;
+    thinkingConfig?: ThinkingConfig;
     signal?: AbortSignal;
     context?: TContext;
 }): AsyncGenerator<SDKMessage>;