@qduc/term2 0.11.0 → 0.12.0

package/dist/contracts/application-stream.d.ts

@@ -0,0 +1,38 @@
+import type { CodexRateLimitInfo } from './streamed-model-turn.js';
+import type { ProviderInputItem } from './provider-input.js';
+import type { NormalizedUsage } from '../utils/ai/token-usage.js';
+/**
+ * Closed event protocol consumed by the session/UI pipeline.
+ * Provider and runner-specific envelopes are normalized before they cross this seam.
+ */
+export type ApplicationRunEvent = {
+    readonly type: 'text_delta';
+    readonly text: string;
+} | {
+    readonly type: 'reasoning_delta';
+    readonly text: string;
+} | {
+    readonly type: 'codex_rate_limits';
+    readonly rateLimits: CodexRateLimitInfo;
+} | {
+    readonly type: 'tool_call_streaming_delta';
+    readonly toolName?: string;
+    readonly argumentCharCount: number;
+}
+/** Server-side context compaction bracketed by real provider frames; see StreamedModelTurnEvent. */
+ | {
+    readonly type: 'context_compaction_started';
+    readonly provider: string;
+} | {
+    readonly type: 'context_compaction_completed';
+    readonly provider: string;
+    readonly durationMs: number;
+} | {
+    readonly type: 'item';
+    readonly item: ProviderInputItem;
+} | {
+    readonly type: 'usage_update';
+    readonly usage: NormalizedUsage;
+};
+export type ApplicationRunStream = AsyncIterable<ApplicationRunEvent>;
+//# sourceMappingURL=application-stream.d.ts.map

package/dist/contracts/application-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-stream.d.ts","sourceRoot":"","sources":["../../source/contracts/application-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAA;CAAE,GAC/E;IAAE,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE;AAChH,oGAAoG;GAClG;IAAE,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC1E;IAAE,QAAQ,CAAC,IAAI,EAAE,8BAA8B,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACzG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAC3D;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;CAAE,CAAC;AAEvE,MAAM,MAAM,oBAAoB,GAAG,aAAa,CAAC,mBAAmB,CAAC,CAAC"}

package/dist/contracts/application-stream.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=application-stream.js.map

package/dist/contracts/application-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-stream.js","sourceRoot":"","sources":["../../source/contracts/application-stream.ts"],"names":[],"mappings":""}

package/dist/contracts/continuation-handle.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Opaque capability for resuming an in-flight model run.
+ *
+ * The value owned by the provider/runtime is deliberately kept out of the
+ * application contracts. Only the adapter that created the handle can unwrap
+ * it, which prevents provider-specific run-state APIs from leaking through the
+ * conversation/session layers.
+ */
+export interface ContinuationHandle {
+    readonly kind: 'continuation';
+    readonly approve?: (interruption: unknown) => void;
+    readonly reject?: (interruption: unknown, options?: {
+        message?: string;
+    }) => void;
+}
+export declare function createContinuationHandle(value: unknown): ContinuationHandle;
+export declare function unwrapContinuationHandle(handle: ContinuationHandle): unknown;
+//# sourceMappingURL=continuation-handle.d.ts.map

package/dist/contracts/continuation-handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuation-handle.d.ts","sourceRoot":"","sources":["../../source/contracts/continuation-handle.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,OAAO,KAAK,IAAI,CAAC;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACnF;AAID,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAgB3E;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAK5E"}

package/dist/contracts/continuation-handle.js

@@ -0,0 +1,22 @@
+const values = new WeakMap();
+export function createContinuationHandle(value) {
+    const source = value;
+    const handle = Object.freeze({
+        kind: 'continuation',
+        ...(typeof source?.approve === 'function'
+            ? { approve: (interruption) => source.approve(interruption) }
+            : {}),
+        ...(typeof source?.reject === 'function'
+            ? { reject: (interruption, options) => source.reject(interruption, options) }
+            : {}),
+    });
+    values.set(handle, value);
+    return handle;
+}
+export function unwrapContinuationHandle(handle) {
+    if (!handle || handle.kind !== 'continuation' || !values.has(handle)) {
+        throw new Error('Invalid continuation handle');
+    }
+    return values.get(handle);
+}
+//# sourceMappingURL=continuation-handle.js.map

package/dist/contracts/continuation-handle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuation-handle.js","sourceRoot":"","sources":["../../source/contracts/continuation-handle.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,GAAG,IAAI,OAAO,EAA+B,CAAC;AAE1D,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,MAAM,MAAM,GAAG,KAGP,CAAC;IACT,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC3B,IAAI,EAAE,cAAuB;QAC7B,GAAG,CAAC,OAAO,MAAM,EAAE,OAAO,KAAK,UAAU;YACvC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,YAAqB,EAAE,EAAE,CAAC,MAAM,CAAC,OAAQ,CAAC,YAAY,CAAC,EAAE;YACvE,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,OAAO,MAAM,EAAE,MAAM,KAAK,UAAU;YACtC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,YAAqB,EAAE,OAA8B,EAAE,EAAE,CAAC,MAAM,CAAC,MAAO,CAAC,YAAY,EAAE,OAAO,CAAC,EAAE;YAC9G,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CAAC;IACH,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC1B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAA0B;IACjE,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC"}

package/dist/contracts/conversation-items.d.ts

@@ -0,0 +1,47 @@
+/** Serializable assistant-turn data independent of any provider SDK. */
+export interface ReasoningItem {
+    type: 'reasoning';
+    text: string;
+    providerMetadata?: Record<string, unknown>;
+    providerItemId?: string;
+    sequence?: number;
+}
+export interface AssistantTextItem {
+    type: 'assistant_text';
+    text: string;
+    providerMetadata?: Record<string, unknown>;
+    providerItemId?: string;
+}
+export interface ToolCall {
+    type: 'tool_call';
+    callId: string;
+    toolName: string;
+    arguments: unknown;
+    providerItem?: Record<string, unknown>;
+}
+export interface ToolResult {
+    type: 'tool_result';
+    callId: string;
+    toolName: string;
+    status: 'completed' | 'failed' | 'aborted';
+    output: unknown;
+    providerItem?: Record<string, unknown>;
+}
+/**
+ * A provider-native item Term2 does not model, persisted and replayed
+ * verbatim. Mirrors the `provider_opaque` variant on `StreamedModelTurnOutput`
+ * (`contracts/streamed-model-turn.ts`) and the `providerOpaque` marker on
+ * `ProviderInputItem` (`contracts/provider-input.ts`): this is the persisted
+ * form of the same opaque-item lane. `item` is stored as opaque JSON — never
+ * given a typed schema per provider item variant.
+ */
+export interface ProviderOpaqueItem {
+    type: 'provider_opaque';
+    provider: string;
+    item: Record<string, unknown>;
+}
+export type Item = ReasoningItem | AssistantTextItem | ToolCall | ToolResult | ProviderOpaqueItem;
+export interface Turn {
+    items: Item[];
+}
+//# sourceMappingURL=conversation-items.d.ts.map

package/dist/contracts/conversation-items.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-items.d.ts","sourceRoot":"","sources":["../../source/contracts/conversation-items.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3C,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,iBAAiB,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,MAAM,IAAI,GAAG,aAAa,GAAG,iBAAiB,GAAG,QAAQ,GAAG,UAAU,GAAG,kBAAkB,CAAC;AAElG,MAAM,WAAW,IAAI;IACnB,KAAK,EAAE,IAAI,EAAE,CAAC;CACf"}

package/dist/contracts/conversation-items.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=conversation-items.js.map

package/dist/contracts/conversation-items.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-items.js","sourceRoot":"","sources":["../../source/contracts/conversation-items.ts"],"names":[],"mappings":""}

package/dist/contracts/conversation.d.ts

@@ -1,21 +1,31 @@
-import type { ModelSettingsReasoningEffort } from '@openai/agents-core/model';
 import type { CommandMessage } from '../tools/types.js';
 import type { NormalizedUsage } from '../utils/ai/token-usage.js';
-import type { PersistedAssistantTurnItem } from '../services/conversation/conversation-persistence-types.js';
-export type ReasoningEffortSetting = ModelSettingsReasoningEffort | 'default';
+import type { ModelRequestCost } from '../services/cost/model-cost.js';
+import type { Item } from './conversation-items.js';
+export type ReasoningEffortSetting = 'default' | 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
+export type LLMAdvisoryRiskLevel = 'low' | 'medium' | 'high';
+export type LLMAdvisoryAuthorization = 'explicit' | 'implied' | 'weak' | 'unknown';
+export type LLMAdvisoryConfidence = 'high' | 'low';
 export interface LLMAdvisory {
     reasoning: string;
     approved: boolean;
     model: string;
+    /** Structured reviewer metadata used by the fail-closed auto-approve gate. */
+    riskLevel?: LLMAdvisoryRiskLevel;
+    authorization?: LLMAdvisoryAuthorization;
+    confidence?: LLMAdvisoryConfidence;
     source?: 'llm' | 'system';
     /** Set when the LLM call failed; the approved/reasoning values are placeholders. */
     isError?: boolean;
 }
 export type DeniedReadApproveAnswer = 'allow-once' | 'allow-remember' | 'unsandboxed-once';
+export type EditSessionApproveAnswer = 'allow-edit-file-session' | 'allow-edit-folder-session';
+export type PostExecuteDecision = 'approve' | 'reject' | DeniedReadApproveAnswer;
 export type DockerHostControlApproveAnswer = 'docker-allow-once' | 'docker-allow-session' | 'docker-allow-project';
 export declare const DOCKER_HOST_CONTROL_APPROVE_ANSWERS: ReadonlySet<DockerHostControlApproveAnswer>;
 export declare function isDockerHostControlApproveAnswer(answer: string | undefined): answer is DockerHostControlApproveAnswer;
 export declare const READ_FILE_SESSION_APPROVE_ANSWER = "allow-folder-session";
+export declare function supportsFolderSessionRead(toolName: string | undefined): boolean;
 export declare function isReadFileSessionApproveAnswer(answer: string | undefined): answer is typeof READ_FILE_SESSION_APPROVE_ANSWER;
 /** Answer strings for the denied-read approval variant (see prepareContinuation). */
 export declare const DENIED_READ_APPROVE_ANSWERS: ReadonlySet<DeniedReadApproveAnswer>;
@@ -45,11 +55,39 @@ export interface ApprovalDescriptor {
     callId?: string;
     llmAdvisory?: LLMAdvisory;
     deniedRead?: DeniedReadMetadata;
+    /** Present for a file-mutating tool whose target is outside the workspace. */
+    outsideWorkspaceEdit?: {
+        path: string;
+        folder: string;
+    };
+    /**
+     * This approval is the Docker host-control capability prompt, not an ordinary one.
+     *
+     * Resolved here because the answer depends on a per-session record of sandbox
+     * Docker blocks, and the UI has no session identity to consult it with. The
+     * prompt and the continuation must agree, or a Docker request stalls forever:
+     * an ordinary `y` cannot resume it, and a Docker grant cannot resume an
+     * ordinary one.
+     */
+    dockerHostControl?: boolean;
+    /** Application-owned post-execute gate; never pass this through SDK approval APIs. */
+    postExecute?: PostExecuteApprovalToken;
 }
+export interface PostExecuteApprovalToken {
+    kind: 'post_execute';
+    sessionId: string;
+    epoch: string | number;
+    revision: number;
+    ids: readonly string[];
+}
+/** Canonical approval data. Reuses the established approval descriptor shape. */
+export type Approval = ApprovalDescriptor;
 export interface ApprovalRequiredTerminal {
     type: 'approval_required';
     approval: ApprovalDescriptor;
     usage?: NormalizedUsage;
+    /** Cumulative model-request cost records for the run up to this pause. */
+    costRecords?: ModelRequestCost[];
 }
 export interface FinalTerminal {
     type: 'response';
@@ -58,7 +96,9 @@ export interface FinalTerminal {
     /** @deprecated derived compatibility only; turnItems is authoritative. */
     reasoningText?: string;
     usage?: NormalizedUsage;
-    turnItems?: PersistedAssistantTurnItem[];
+    /** Cumulative model-request cost records for the completed run. */
+    costRecords?: ModelRequestCost[];
+    turnItems?: Item[];
 }
 export type ConversationTerminal = ApprovalRequiredTerminal | FinalTerminal;
 export interface PendingApproval extends ApprovalDescriptor {

package/dist/contracts/conversation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../source/contracts/conversation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,4DAA4D,CAAC;AAE7G,MAAM,MAAM,sBAAsB,GAAG,4BAA4B,GAAG,SAAS,CAAC;AAE9E,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC1B,oFAAoF;IACpF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,uBAAuB,GAAG,YAAY,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;AAC3F,MAAM,MAAM,8BAA8B,GAAG,mBAAmB,GAAG,sBAAsB,GAAG,sBAAsB,CAAC;AACnH,eAAO,MAAM,mCAAmC,EAAE,WAAW,CAAC,8BAA8B,CAI1F,CAAC;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,IAAI,8BAA8B,CAIrH;AACD,eAAO,MAAM,gCAAgC,yBAAyB,CAAC;AAEvE,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,MAAM,IAAI,OAAO,gCAAgC,CAEnD;AAED,qFAAqF;AACrF,eAAO,MAAM,2BAA2B,EAAE,WAAW,CAAC,uBAAuB,CAI3E,CAAC;AAEH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,IAAI,uBAAuB,CAEvG;AACD,4EAA4E;AAC5E,eAAO,MAAM,uBAAuB,SAAS,CAAC;AAE9C;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,eAAe,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,SAAS,EAAE,OAAO,CAAC;IACnB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,UAAU,CAAC,EAAE,kBAAkB,CAAC;CACjC;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,SAAS,CAAC,EAAE,0BAA0B,EAAE,CAAC;CAC1C;AAED,MAAM,MAAM,oBAAoB,GAAG,wBAAwB,GAAG,aAAa,CAAC;AAE5E,MAAM,WAAW,eAAgB,SAAQ,kBAAkB;IACzD,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B"}
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../source/contracts/conversation.ts"],"names":[],"mappings":"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"}

package/dist/contracts/conversation.js

@@ -7,6 +7,15 @@ export function isDockerHostControlApproveAnswer(answer) {
     return (typeof answer === 'string' && DOCKER_HOST_CONTROL_APPROVE_ANSWERS.has(answer));
 }
 export const READ_FILE_SESSION_APPROVE_ANSWER = 'allow-folder-session';
+/**
+ * Read-only tools whose approval prompt offers "allow this folder for this
+ * session". The grant is session-scoped and shared, so approving a folder from
+ * one of these prompts also covers the others.
+ */
+const FOLDER_SESSION_READ_TOOLS = new Set(['read_file', 'grep', 'glob']);
+export function supportsFolderSessionRead(toolName) {
+    return typeof toolName === 'string' && FOLDER_SESSION_READ_TOOLS.has(toolName);
+}
 export function isReadFileSessionApproveAnswer(answer) {
     return answer === READ_FILE_SESSION_APPROVE_ANSWER;
 }

package/dist/contracts/conversation.js.map

@@ -1 +1 @@
-{"version":3,"file":"conversation.js","sourceRoot":"","sources":["../../source/contracts/conversation.ts"],"names":[],"mappings":"AAkBA,MAAM,CAAC,MAAM,mCAAmC,GAAgD,IAAI,GAAG,CAAC;IACtG,mBAAmB;IACnB,sBAAsB;IACtB,sBAAsB;CACvB,CAAC,CAAC;AACH,MAAM,UAAU,gCAAgC,CAAC,MAA0B;IACzE,OAAO,CACL,OAAO,MAAM,KAAK,QAAQ,IAAI,mCAAmC,CAAC,GAAG,CAAC,MAAwC,CAAC,CAChH,CAAC;AACJ,CAAC;AACD,MAAM,CAAC,MAAM,gCAAgC,GAAG,sBAAsB,CAAC;AAEvE,MAAM,UAAU,8BAA8B,CAC5C,MAA0B;IAE1B,OAAO,MAAM,KAAK,gCAAgC,CAAC;AACrD,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,MAAM,2BAA2B,GAAyC,IAAI,GAAG,CAA0B;IAChH,YAAY;IACZ,gBAAgB;IAChB,kBAAkB;CACnB,CAAC,CAAC;AAEH,MAAM,UAAU,yBAAyB,CAAC,MAA0B;IAClE,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,2BAA2B,CAAC,GAAG,CAAC,MAAiC,CAAC,CAAC;AAC1G,CAAC;AACD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC"}
+{"version":3,"file":"conversation.js","sourceRoot":"","sources":["../../source/contracts/conversation.ts"],"names":[],"mappings":"AA4BA,MAAM,CAAC,MAAM,mCAAmC,GAAgD,IAAI,GAAG,CAAC;IACtG,mBAAmB;IACnB,sBAAsB;IACtB,sBAAsB;CACvB,CAAC,CAAC;AACH,MAAM,UAAU,gCAAgC,CAAC,MAA0B;IACzE,OAAO,CACL,OAAO,MAAM,KAAK,QAAQ,IAAI,mCAAmC,CAAC,GAAG,CAAC,MAAwC,CAAC,CAChH,CAAC;AACJ,CAAC;AACD,MAAM,CAAC,MAAM,gCAAgC,GAAG,sBAAsB,CAAC;AAEvE;;;;GAIG;AACH,MAAM,yBAAyB,GAAwB,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAE9F,MAAM,UAAU,yBAAyB,CAAC,QAA4B;IACpE,OAAO,OAAO,QAAQ,KAAK,QAAQ,IAAI,yBAAyB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,MAA0B;IAE1B,OAAO,MAAM,KAAK,gCAAgC,CAAC;AACrD,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,MAAM,2BAA2B,GAAyC,IAAI,GAAG,CAA0B;IAChH,YAAY;IACZ,gBAAgB;IAChB,kBAAkB;CACnB,CAAC,CAAC;AAEH,MAAM,UAAU,yBAAyB,CAAC,MAA0B;IAClE,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,2BAA2B,CAAC,GAAG,CAAC,MAAiC,CAAC,CAAC;AAC1G,CAAC;AACD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC"}

package/dist/contracts/model-errors.d.ts

@@ -0,0 +1,10 @@
+/** Application-owned model failure used for retry classification. */
+export declare class ModelBehaviorError extends Error {
+    name: string;
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/** Accepts legacy provider errors without importing the legacy SDK. */
+export declare function isModelBehaviorError(error: unknown): boolean;
+//# sourceMappingURL=model-errors.d.ts.map

package/dist/contracts/model-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-errors.d.ts","sourceRoot":"","sources":["../../source/contracts/model-errors.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,qBAAa,kBAAmB,SAAQ,KAAK;IAClC,IAAI,SAAwB;IAErC,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAEzD;CACF;AAED,uEAAuE;AACvE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAI5D"}

package/dist/contracts/model-errors.js

@@ -0,0 +1,15 @@
+/** Application-owned model failure used for retry classification. */
+export class ModelBehaviorError extends Error {
+    name = 'ModelBehaviorError';
+    constructor(message, options) {
+        super(message, options);
+    }
+}
+/** Accepts legacy provider errors without importing the legacy SDK. */
+export function isModelBehaviorError(error) {
+    if (error instanceof ModelBehaviorError)
+        return true;
+    const value = error;
+    return value?.name === 'ModelBehaviorError' || value?.constructor?.name === 'ModelBehaviorError';
+}
+//# sourceMappingURL=model-errors.js.map

package/dist/contracts/model-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-errors.js","sourceRoot":"","sources":["../../source/contracts/model-errors.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,GAAG,oBAAoB,CAAC;IAErC,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;CACF;AAED,uEAAuE;AACvE,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IAAI,KAAK,YAAY,kBAAkB;QAAE,OAAO,IAAI,CAAC;IACrD,MAAM,KAAK,GAAG,KAAoE,CAAC;IACnF,OAAO,KAAK,EAAE,IAAI,KAAK,oBAAoB,IAAI,KAAK,EAAE,WAAW,EAAE,IAAI,KAAK,oBAAoB,CAAC;AACnG,CAAC"}

package/dist/contracts/model-types.d.ts

@@ -0,0 +1,16 @@
+export type JsonSchemaDefinitionEntry = Record<string, any>;
+export type JsonObjectSchema = {
+    type: 'object';
+    properties: Record<string, JsonSchemaDefinitionEntry>;
+    required: string[];
+    additionalProperties: boolean;
+    description?: string;
+};
+/** Application-owned JSON schema shape for structured model output. */
+export type JsonSchemaDefinition = {
+    type: 'json_schema';
+    name: string;
+    strict: boolean;
+    schema: JsonObjectSchema;
+};
+//# sourceMappingURL=model-types.d.ts.map

package/dist/contracts/model-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-types.d.ts","sourceRoot":"","sources":["../../source/contracts/model-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,yBAAyB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAE5D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;IACtD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,uEAAuE;AACvE,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,gBAAgB,CAAC;CAC1B,CAAC"}

package/dist/contracts/model-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=model-types.js.map

package/dist/contracts/model-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-types.js","sourceRoot":"","sources":["../../source/contracts/model-types.ts"],"names":[],"mappings":""}

package/dist/contracts/patch.d.ts

@@ -0,0 +1,17 @@
+export type ApplyPatchOperation = {
+    type: 'create_file';
+    path: string;
+    diff: string;
+} | {
+    type: 'update_file';
+    path: string;
+    diff: string;
+} | {
+    type: 'delete_file';
+    path: string;
+};
+export type ApplyPatchResult = {
+    status: 'completed' | 'failed';
+    output: string;
+};
+//# sourceMappingURL=patch.d.ts.map

package/dist/contracts/patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.d.ts","sourceRoot":"","sources":["../../source/contracts/patch.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC"}

package/dist/contracts/patch.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=patch.js.map

package/dist/contracts/patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.js","sourceRoot":"","sources":["../../source/contracts/patch.ts"],"names":[],"mappings":""}

package/dist/contracts/provider-input.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Provider-facing transcript item owned by the application.
+ *
+ * Providers intentionally retain fields that are not part of the canonical
+ * assistant-turn contract (for example native response IDs and metadata).
+ * The run loop may add more fields as it adapts a provider, so this shape is
+ * open rather than tied to one transport's item union.
+ */
+export interface ProviderInputItem {
+    type?: unknown;
+    role?: unknown;
+    id?: unknown;
+    callId?: unknown;
+    call_id?: unknown;
+    tool_call_id?: unknown;
+    toolCallId?: unknown;
+    name?: unknown;
+    arguments?: unknown;
+    output?: unknown;
+    content?: unknown;
+    providerData?: Record<string, unknown>;
+    /**
+     * Marks an item as provider-native and opaque. Set only by the adapter that
+     * produced the item; the run loop carries the item through untouched and no
+     * other provider may re-serialize it. Absent for all application-modeled
+     * items.
+     */
+    providerOpaque?: {
+        provider: string;
+    };
+    [key: string]: unknown;
+}
+export type ProviderInput = string | ProviderInputItem | ProviderInputItem[];
+//# sourceMappingURL=provider-input.d.ts.map

package/dist/contracts/provider-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-input.d.ts","sourceRoot":"","sources":["../../source/contracts/provider-input.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC;;;;;OAKG;IACH,cAAc,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,iBAAiB,GAAG,iBAAiB,EAAE,CAAC"}

package/dist/contracts/provider-input.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provider-input.js.map

package/dist/contracts/provider-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-input.js","sourceRoot":"","sources":["../../source/contracts/provider-input.ts"],"names":[],"mappings":""}