@anthropic-ai/claude-agent-sdk 0.3.206 → 0.3.208

package/bridge.d.ts

@@ -150,7 +150,7 @@ export type AttachBridgeSessionOptions = {
         ok: false;
         error: string;
     } | void;
-    onSetMaxThinkingTokens?: (tokens: number | null, thinkingDisplay?: 'summarized' | 'omitted' | null) => void;
+    onSetMaxThinkingTokens?: (tokens: number | null | undefined, thinkingDisplay?: 'summarized' | 'omitted' | null) => void;
     /**
      * `set_permission_mode` from claude.ai. Return an error verdict to send
      * an error control_response (vs silently false-succeeding). Omit if
@@ -220,17 +220,55 @@ export declare function isCredentialsFailure(r: RemoteCredentials | CredentialsF
 export type CodeSessionGitContext = {
     gitRepoUrl: string;
     branch: string;
+    /**
+     * The repo's default branch, when authoritatively known. LOAD-BEARING
+     * for branch continuity: when absent, `branch` is omitted from
+     * `outcomes.branches` entirely (the classification never acts on a
+     * guess), so the remote session works on a runner-generated branch
+     * instead of `branch`, with only a debug-level signal. Callers that
+     * want the session to check out AND push to `branch` must supply
+     * this — read `git symbolic-ref refs/remotes/origin/HEAD`, or run
+     * `git remote set-head origin -a` to repair a missing symref.
+     */
     defaultBranch?: string;
 };
+/**
+ * Caller-owned dedupe state for createCodeSession's branch-drop debug
+ * signal: create one object per logical create (outside your retry
+ * loop) and pass it to every attempt so the drop logs once per
+ * decision. Omit it to log on every attempt.
+ * @alpha
+ */
+export declare type BranchDropLogDedup = {
+    lastKey?: string | null;
+};
+/**
+ * Terminal 4xx from `POST /v1/code/sessions` for a recognized
+ * `session_grouping_id` rejection — retrying with the same inputs fails
+ * identically.
+ * @alpha
+ */
+export type CreateSessionFailure = {
+    terminal: true;
+    status: number;
+    detail: string | undefined;
+};
+/**
+ * Type guard for `createCodeSession` results.
+ * @alpha
+ */
+export declare function isCreateSessionFailure(r: string | CreateSessionFailure | null): r is CreateSessionFailure;
 /**
  * `POST /v1/code/sessions` — create a fresh CCR session. Returns the `cse_*`
- * session id, or null on any failure (HTTP error, malformed response).
+ * session id on success, a `CreateSessionFailure` for a recognized
+ * `session_grouping_id` rejection (terminal — don't retry), or null on any
+ * other failure (HTTP error, malformed response).
  *
  * Callers supply their own OAuth token — this is a thin HTTP wrapper with no
  * implicit auth, so it works from any process (not just the CLI).
  * @alpha
  */
-export declare function createCodeSession(baseUrl: string, accessToken: string, title: string, timeoutMs: number, tags?: string[], gitContext?: CodeSessionGitContext, cwd?: string, model?: string): Promise<string | null>;
+export declare function createCodeSession(baseUrl: string, accessToken: string, title: string, timeoutMs: number, tags?: string[], gitContext?: CodeSessionGitContext, cwd?: string, model?: string, sessionGroupingId?: string, dropLogDedup?: BranchDropLogDedup): Promise<string | CreateSessionFailure | null>;
 /**
  * `POST /v1/code/sessions/{id}/bridge` — mint a worker JWT for the session.
  * Returns credentials, a `CredentialsFailure` for terminal authz failures