@qoder-ai/qoder-agent-sdk 1.0.24 → 1.0.26

package/dist/protocol/control.d.ts

@@ -21,6 +21,7 @@ import type { AccountInfo, FastModeState, ModelInfo, SessionCreditsUsage, SlashC
 import type { PluginDetails } from '../types/plugins.js';
 import type { ModelPromptPatches } from './model-prompt-patches.js';
 import type { EffectiveMemoryConfig, MemoryGenerationGateInput, SerializableMemoryConfig } from './memory.js';
+import type { EffectiveEvolutionConfig, SkillEvolutionGateInput, SerializableEvolutionConfig } from './skill-evolution.js';
 export type SDKControlRequest = {
     type: 'control_request';
     request_id: string;
@@ -115,6 +116,7 @@ export type SDKControlInitializeRequest = {
     initializeTimeoutMs?: number;
     agentProgressSummaries?: boolean;
     memory?: SerializableMemoryConfig;
+    evolution?: SerializableEvolutionConfig;
     hooks?: Partial<Record<HookEvent, Array<{
         hookCallbackIds: string[];
         timeout?: number;
@@ -133,9 +135,17 @@ export type SDKControlMemoryShouldGenerateRequest = {
     callbackId: string;
     input: MemoryGenerationGateInput;
 };
+export type SDKControlSkillEvolutionShouldReviewRequest = {
+    subtype: 'skill_evolution_should_review';
+    callbackId: string;
+    input: SkillEvolutionGateInput;
+};
 export type SDKControlFlushMemoryRequest = {
     type: 'flush_memory';
 };
+export type SDKControlFlushSkillEvolutionRequest = {
+    type: 'flush_skill_evolution';
+};
 export type SDKControlRefreshMemoryRequest = {
     type: 'refresh_memory';
 };
@@ -253,6 +263,10 @@ export type SDKControlGetModelPolicyRequest = {
     turnIndex: number;
     /** Current agent ID (for subagent scenarios). */
     agentId?: string;
+    /** Stable agent type (for subagent scenarios). */
+    agentType?: string;
+    /** Model already selected by the CLI before applying host policy. */
+    resolvedModel?: string;
     /** Context window usage ratio (0~1). */
     contextUsage?: number;
     /** Estimated input token count for this prompt. */
@@ -273,8 +287,8 @@ export type SDKControlGetModelPolicyRequest = {
  */
 export type SDKControlGetModelPolicyResponse = {
     type: 'get_model_policy';
-    /** The model to use for this request. */
-    model: string;
+    /** Optional model override. Omitted means keep the CLI-resolved model. */
+    model?: string;
     /** Optional per-request model policy parameters (contextWindow, reasoningEffort). */
     parameters?: Record<string, unknown>;
     /**
@@ -558,7 +572,67 @@ export type SDKControlBackgroundTasksResponse = {
     /** Present for a targeted tool use. Bulk backgrounding may omit the body. */
     backgrounded?: boolean;
 };
-export type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetProxyRequest | SDKControlGenerateSessionTitleRequest | SDKControlSideQuestionRequest | SDKControlAddDirectoriesRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlMcpStatusRequest | SDKControlGetContextUsageRequest | SDKControlGetUsageInfoRequest | SDKControlGetModelPolicyRequest | SDKControlAccountInfoRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlRewindRequest | SDKControlCancelAsyncMessageRequest | SDKControlSeedReadStateRequest | SDKControlMcpSetServersRequest | SDKControlReloadPluginsRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest | SDKControlEndSessionRequest | SDKControlChannelEnableRequest | SDKControlMcpInjectTokenRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlMcpClearAuthRequest | SDKControlGetByokConfigRequest | SDKControlValidateByokModelRequest | SDKControlListPluginsRequest | SDKControlStopTaskRequest | SDKControlBackgroundTasksRequest | SDKControlMemoryShouldGenerateRequest | SDKControlFlushMemoryRequest | SDKControlRefreshMemoryRequest;
+/** Structured snapshot of the main session's independent Plan Mode state. */
+export type SDKPlanModeSnapshot = {
+    active: boolean;
+};
+/** Enter or leave Plan Mode without changing the tool permission mode. */
+export type SDKControlSetPlanModeRequest = {
+    subtype: 'set_plan_mode';
+    active: boolean;
+};
+export type SDKControlSetPlanModeResponse = {
+    plan_mode: SDKPlanModeSnapshot;
+};
+/** Read the authoritative Plan Mode state from the running CLI session. */
+export type SDKControlGetPlanModeRequest = {
+    subtype: 'get_plan_mode';
+};
+export type SDKControlGetPlanModeResponse = {
+    plan_mode: SDKPlanModeSnapshot;
+};
+/** Lifecycle status of a goal (aligned with the CLI goal state machine). */
+export type SDKGoalStatus = 'active' | 'paused' | 'blocked' | 'usage_limited' | 'budget_limited' | 'complete';
+/** Structured snapshot of the current goal. */
+export type SDKGoalSnapshot = {
+    id: string;
+    objective: string;
+    status: SDKGoalStatus;
+    turns_used: number;
+    max_turns?: number;
+    time_used_seconds: number;
+    credits_budget?: number;
+    credits_used?: number;
+    created_at: number;
+    updated_at: number;
+};
+/**
+ * Create, redirect, transition, or re-budget the session goal. Omitted fields
+ * are left unchanged; `credits_budget: null` explicitly clears the budget.
+ * Setting `status: 'active'` while the session is idle starts the goal loop.
+ */
+export type SDKControlSetGoalRequest = {
+    subtype: 'set_goal';
+    objective?: string;
+    status?: SDKGoalStatus;
+    credits_budget?: number | null;
+};
+export type SDKControlSetGoalResponse = {
+    goal: SDKGoalSnapshot | null;
+};
+export type SDKControlGetGoalRequest = {
+    subtype: 'get_goal';
+};
+export type SDKControlGetGoalResponse = {
+    goal: SDKGoalSnapshot | null;
+};
+export type SDKControlClearGoalRequest = {
+    subtype: 'clear_goal';
+};
+export type SDKControlClearGoalResponse = {
+    cleared: boolean;
+};
+export type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetProxyRequest | SDKControlGenerateSessionTitleRequest | SDKControlSideQuestionRequest | SDKControlAddDirectoriesRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlMcpStatusRequest | SDKControlGetContextUsageRequest | SDKControlGetUsageInfoRequest | SDKControlGetModelPolicyRequest | SDKControlAccountInfoRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlRewindRequest | SDKControlCancelAsyncMessageRequest | SDKControlSeedReadStateRequest | SDKControlMcpSetServersRequest | SDKControlReloadPluginsRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest | SDKControlEndSessionRequest | SDKControlChannelEnableRequest | SDKControlMcpInjectTokenRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlMcpClearAuthRequest | SDKControlGetByokConfigRequest | SDKControlValidateByokModelRequest | SDKControlListPluginsRequest | SDKControlStopTaskRequest | SDKControlBackgroundTasksRequest | SDKControlMemoryShouldGenerateRequest | SDKControlFlushMemoryRequest | SDKControlSkillEvolutionShouldReviewRequest | SDKControlFlushSkillEvolutionRequest | SDKControlRefreshMemoryRequest | SDKControlSetPlanModeRequest | SDKControlGetPlanModeRequest | SDKControlSetGoalRequest | SDKControlGetGoalRequest | SDKControlClearGoalRequest;
 export type SDKControlInitializeResponse = {
     commands: SlashCommand[];
     agents: AgentInfo[];
@@ -575,6 +649,7 @@ export type SDKControlInitializeResponse = {
     /** Optional features implemented by the connected CLI control channel. */
     capabilities?: string[];
     memory?: EffectiveMemoryConfig;
+    evolution?: EffectiveEvolutionConfig;
 };
 export type SDKControlGetContextUsageResponse = {
     model: string;

package/dist/protocol/index.d.ts

@@ -18,10 +18,11 @@ export type { UUID, BetaMessage, BetaRawMessageStreamEvent, BetaUsage, BetaStopR
 export type { AICodeTrackingLaunchOptions, QoderAgentLaunchOptions, QoderCliFlagSettings, } from './launch.js';
 export { buildQoderCliFlagSettings, buildQoderCliFlagSettingsArgs, } from './launch.js';
 export type { EffectiveMemoryConfig, MemoryConsumptionFile, MemoryConsumptionResult, MemoryGenerationFailedFile, MemoryGenerationGateInput, MemoryGenerationGateResult, MemoryGenerationResult, MemoryMode, MemoryRoot, MemoryRootAccess, SerializableMemoryConfig, SerializableMemoryConsumptionOptions, SerializableMemoryGenerationOptions, } from './memory.js';
+export type { EffectiveEvolutionConfig, EffectiveSkillEvolutionConfig, SerializableEvolutionConfig, SerializableSkillEvolutionConfig, SerializableSkillEvolutionGenerationOptions, SkillEvolutionGateInput, SkillEvolutionGateResult, SkillEvolutionMode, SkillEvolutionResult, SkillEvolutionSuggestion, } from './skill-evolution.js';
 export type { PermissionMode, PermissionBehavior, PermissionDecisionClassification, PermissionUpdateDestination, PermissionRuleValue, PermissionUpdate, PermissionResult, } from './permissions.js';
 export type { McpStdioServerConfig, McpSSEServerConfig, McpHttpServerConfig, McpSdkServerConfig, McpServerConfigForProcessTransport, McpServerStatus, McpServerStatusConfig, McpSetServersResult, OAuthToken, } from './mcp.js';
-export type { SDKAssistantMessage, SDKToolNonExecutionKind, SDKToolResultMeta, SDKUserMessage, SDKUserMessageReplay, SDKResultSuccess, SDKResultError, SDKResultMessage, SDKFileAttachment, SDKSystemMessage, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKStatusMessage, SDKAPIRetryMessage, SDKModelQueueStatusMessage, SDKControlRequestProgressMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKTaskUpdatedMessage, SDKBackgroundTasksChangedMessage, SDKSessionStateChangedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKMemoryGenerationMessage, SDKMemoryConsumptionMessage, SDKPermissionDenial, SDKPermissionDeniedMessage, SDKPermissionDeniedReasonType, SDKMessage, } from './messages.js';
+export type { SDKAssistantMessage, SDKToolNonExecutionKind, SDKToolResultMeta, SDKUserMessage, SDKUserMessageReplay, SDKResultSuccess, SDKResultError, SDKResultMessage, SDKFileAttachment, SDKSystemMessage, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKStatusMessage, SDKAPIRetryMessage, SDKModelQueueStatusMessage, SDKControlRequestProgressMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKTaskUpdatedMessage, SDKBackgroundTasksChangedMessage, SDKSessionStateChangedMessage, SDKPlanModeChangedMessage, SDKGoalUpdatedMessage, SDKGoalClearedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKMemoryGenerationMessage, SDKMemoryConsumptionMessage, SDKSkillEvolutionMessage, SDKPermissionDenial, SDKPermissionDeniedMessage, SDKPermissionDeniedReasonType, SDKMessage, } from './messages.js';
 export type { BaseHookInput, PreToolUseHookInput, PostToolUseHookInput, PostToolUseFailureHookInput, UserPromptSubmitHookInput, SessionStartHookInput, SessionEndHookInput, StopHookInput, StopFailureHookInput, SubagentStartHookInput, SubagentStopHookInput, PreCompactHookInput, PostCompactHookInput, PermissionRequestHookInput, PermissionDeniedHookInput, SetupHookInput, TeammateIdleHookInput, TaskCreatedHookInput, TaskCompletedHookInput, ElicitationHookInput, ElicitationResultHookInput, ConfigChangeHookInput, WorktreeCreateHookInput, WorktreeRemoveHookInput, InstructionsLoadedHookInput, CwdChangedHookInput, FileChangedHookInput, HookInput, PreToolUseHookSpecificOutput, PostToolUseHookSpecificOutput, PostToolUseFailureHookSpecificOutput, UserPromptSubmitHookSpecificOutput, SessionStartHookSpecificOutput, SetupHookSpecificOutput, SubagentStartHookSpecificOutput, PermissionRequestHookSpecificOutput, ElicitationHookSpecificOutput, ElicitationResultHookSpecificOutput, CwdChangedHookSpecificOutput, FileChangedHookSpecificOutput, WorktreeCreateHookSpecificOutput, SyncHookJSONOutput, AsyncHookJSONOutput, HookJSONOutput, HookEvent, } from './hooks.js';
 export type { AgentMcpServerSpec, AgentDefinition, AgentInfo, AgentMemoryScope, } from './agents.js';
 export { QoderModelPurpose } from './control.js';
-export type { SDKControlRequest, SDKControlResponse, SDKControlCancelRequest, SDKControlInterruptRequest, SDKControlInterruptResponse, SDKControlPermissionRequest, SDKControlInitializeRequest, SDKControlSetPermissionModeRequest, SDKControlSetModelRequest, SDKControlGenerateSessionTitleRequest, SDKControlGenerateSessionTitleResponse, SideQuestionHistoryEntry, AskSideQuestionOptions, SideQuestionRefusalFallback, SideQuestionResult, SDKControlSideQuestionRequest, SDKControlSideQuestionResponse, SDKControlAddDirectoriesRequest, SDKControlAddDirectoriesResponse, SDKControlGetModelPolicyRequest, SDKControlGetModelPolicyResponse, SDKControlSetMaxThinkingTokensRequest, SDKControlMcpStatusRequest, SDKControlGetContextUsageRequest, SDKControlGetUsageInfoRequest, SDKControlGetUsageInfoResponse, SDKControlAccountInfoRequest, SDKHookCallbackRequest, SDKControlMcpMessageRequest, SDKControlRewindFilesRequest, SDKControlRewindRequest, SDKControlCancelAsyncMessageRequest, SDKControlSeedReadStateRequest, SDKControlMcpSetServersRequest, SDKControlReloadPluginsRequest, SDKControlMcpReconnectRequest, SDKControlMcpToggleRequest, SDKControlApplyFlagSettingsRequest, SDKControlGetSettingsRequest, SDKControlElicitationRequest, SDKControlEndSessionRequest, SDKControlChannelEnableRequest, SDKControlMcpInjectTokenRequest, SDKControlMcpAuthenticateRequest, SDKControlMcpOAuthCallbackUrlRequest, SDKControlMcpClearAuthRequest, SDKControlRequestInner, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlReloadPluginsResponse, SDKControlMcpStatusResponse, SDKControlMcpSetServersResponse, SDKControlMcpAuthenticateResponse, SDKControlGetByokConfigRequest, SDKControlGetByokConfigResponse, SDKControlValidateByokModelRequest, SDKControlValidateByokModelResponse, BYOKModelValidationInput, BYOKProviderInfo, BYOKFieldInfo, BYOKModelTypeInfo, BYOKModelInfo, CustomModel, SDKControlListPluginsRequest, SDKControlListPluginsResponse, SDKControlStopTaskRequest, SDKControlBackgroundTasksRequest, SDKControlBackgroundTasksResponse, SDKControlMemoryShouldGenerateRequest, SDKControlFlushMemoryRequest, SDKControlRefreshMemoryRequest, SDKKeepAliveMessage, StdoutMessage, ControlMcpServerConfig, } from './control.js';
+export type { SDKControlRequest, SDKControlResponse, SDKControlCancelRequest, SDKControlInterruptRequest, SDKControlInterruptResponse, SDKControlPermissionRequest, SDKControlInitializeRequest, SDKControlSetPermissionModeRequest, SDKControlSetModelRequest, SDKControlGenerateSessionTitleRequest, SDKControlGenerateSessionTitleResponse, SideQuestionHistoryEntry, AskSideQuestionOptions, SideQuestionRefusalFallback, SideQuestionResult, SDKControlSideQuestionRequest, SDKControlSideQuestionResponse, SDKControlAddDirectoriesRequest, SDKControlAddDirectoriesResponse, SDKControlGetModelPolicyRequest, SDKControlGetModelPolicyResponse, SDKControlSetMaxThinkingTokensRequest, SDKControlMcpStatusRequest, SDKControlGetContextUsageRequest, SDKControlGetUsageInfoRequest, SDKControlGetUsageInfoResponse, SDKControlAccountInfoRequest, SDKHookCallbackRequest, SDKControlMcpMessageRequest, SDKControlRewindFilesRequest, SDKControlRewindRequest, SDKControlCancelAsyncMessageRequest, SDKControlSeedReadStateRequest, SDKControlMcpSetServersRequest, SDKControlReloadPluginsRequest, SDKControlMcpReconnectRequest, SDKControlMcpToggleRequest, SDKControlApplyFlagSettingsRequest, SDKControlGetSettingsRequest, SDKControlElicitationRequest, SDKControlEndSessionRequest, SDKControlChannelEnableRequest, SDKControlMcpInjectTokenRequest, SDKControlMcpAuthenticateRequest, SDKControlMcpOAuthCallbackUrlRequest, SDKControlMcpClearAuthRequest, SDKPlanModeSnapshot, SDKControlSetPlanModeRequest, SDKControlSetPlanModeResponse, SDKControlGetPlanModeRequest, SDKControlGetPlanModeResponse, SDKGoalStatus, SDKGoalSnapshot, SDKControlSetGoalRequest, SDKControlSetGoalResponse, SDKControlGetGoalRequest, SDKControlGetGoalResponse, SDKControlClearGoalRequest, SDKControlClearGoalResponse, SDKControlRequestInner, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlReloadPluginsResponse, SDKControlMcpStatusResponse, SDKControlMcpSetServersResponse, SDKControlMcpAuthenticateResponse, SDKControlGetByokConfigRequest, SDKControlGetByokConfigResponse, SDKControlValidateByokModelRequest, SDKControlValidateByokModelResponse, BYOKModelValidationInput, BYOKProviderInfo, BYOKFieldInfo, BYOKModelTypeInfo, BYOKModelInfo, CustomModel, SDKControlListPluginsRequest, SDKControlListPluginsResponse, SDKControlStopTaskRequest, SDKControlBackgroundTasksRequest, SDKControlBackgroundTasksResponse, SDKControlMemoryShouldGenerateRequest, SDKControlFlushMemoryRequest, SDKControlRefreshMemoryRequest, SDKControlSkillEvolutionShouldReviewRequest, SDKControlFlushSkillEvolutionRequest, SDKKeepAliveMessage, StdoutMessage, ControlMcpServerConfig, } from './control.js';

package/dist/protocol/index.js

@@ -1 +1 @@
-var p="1.2.0";var r=["l1StaticCheck","l2LightweightScan","l3DeepScan"];function i(e){if(e===null||typeof e!="object"||Array.isArray(e))throw new TypeError("securityScan must be an object.");let t=new Set(r),s=Object.keys(e).filter(o=>!t.has(o));if(s.length>0)throw new TypeError(`securityScan contains unknown option${s.length===1?"":"s"}: ${s.join(", ")}.`);for(let o of r){let n=e[o];if(n!==void 0&&typeof n!="boolean")throw new TypeError(`securityScan.${o} must be a boolean.`)}return{l1StaticCheck:e.l1StaticCheck??!1,l2LightweightScan:e.l2LightweightScan??!1,l3DeepScan:e.l3DeepScan??!1}}function a(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function l(e={}){let t={...e.settings??{}},s=e.aiCodeTracking?.installGitCommitHook;if(s!==void 0){let o=t.aiCodeTracking;t.aiCodeTracking={...a(o)?o:{},installGitCommitHook:s}}return e.securityScan!==void 0&&(t.securityScan=i(e.securityScan)),t}function u(e={}){let t=l(e);return Object.keys(t).length===0?[]:["--settings",JSON.stringify(t)]}var S={Main:"main",Plan:"plan",Task:"task",Compact:"compact",Title:"title",Suggestion:"suggestion",Generate:"generate",HookPrompt:"hook_prompt",Subagent:"subagent",WebFetch:"web_fetch",ImageGen:"image_gen",Compression:"compression",Utility:"utility"};export{S as QoderModelPurpose,p as WIRE_PROTOCOL_VERSION,l as buildQoderCliFlagSettings,u as buildQoderCliFlagSettingsArgs};
+var a="1.3.0";var r=["l1StaticCheck","l2LightweightScan","l3DeepScan"];function i(e){if(e===null||typeof e!="object"||Array.isArray(e))throw new TypeError("securityScan must be an object.");let t=new Set(r),n=Object.keys(e).filter(o=>!t.has(o));if(n.length>0)throw new TypeError(`securityScan contains unknown option${n.length===1?"":"s"}: ${n.join(", ")}.`);for(let o of r){let s=e[o];if(s!==void 0&&typeof s!="boolean")throw new TypeError(`securityScan.${o} must be a boolean.`)}return{l1StaticCheck:e.l1StaticCheck??!1,l2LightweightScan:e.l2LightweightScan??!1,l3DeepScan:e.l3DeepScan??!1}}function p(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function l(e={}){let t={...e.settings??{}},n=e.aiCodeTracking?.installGitCommitHook;if(n!==void 0){let o=t.aiCodeTracking;t.aiCodeTracking={...p(o)?o:{},installGitCommitHook:n}}return e.securityScan!==void 0&&(t.securityScan=i(e.securityScan)),t}function u(e={}){let t=l(e);return Object.keys(t).length===0?[]:["--settings",JSON.stringify(t)]}var S={Main:"main",Plan:"plan",Task:"task",Compact:"compact",Title:"title",Suggestion:"suggestion",Generate:"generate",HookPrompt:"hook_prompt",Subagent:"subagent",WebFetch:"web_fetch",ImageGen:"image_gen",Compression:"compression",Utility:"utility"};export{S as QoderModelPurpose,a as WIRE_PROTOCOL_VERSION,l as buildQoderCliFlagSettings,u as buildQoderCliFlagSettingsArgs};

package/dist/protocol/memory.d.ts

@@ -69,6 +69,10 @@ export type SerializableMemoryConsumptionOptions = {
 type SerializableMemoryConfigBase = {
     /** Marks this memory configuration as originating from the Agent SDK. */
     requester: 'sdk';
+    /** Query-level PROJECT-scope override. Omit to use the SDK native default (`true`). */
+    projectScope?: boolean;
+    /** Query-level USER-scope override. Omit to use the SDK native default (`true`). */
+    userScope?: boolean;
 };
 export type SerializableMemoryConfig = SerializableMemoryConfigBase & ({
     mode: 'native';

package/dist/protocol/messages.d.ts

@@ -14,6 +14,8 @@
 import type { BetaMessage, BetaRawMessageStreamEvent, MessageParam, UUID, SDKAssistantMessageError, FastModeState, ApiKeySource, ModelUsage, NonNullableUsage, PluginInfo, SDKStatus } from './common.js';
 import type { PermissionMode } from './permissions.js';
 import type { MemoryConsumptionResult, MemoryGenerationResult } from './memory.js';
+import type { SkillEvolutionResult } from './skill-evolution.js';
+import type { SDKGoalSnapshot, SDKPlanModeSnapshot } from './control.js';
 export type SDKAssistantMessage = {
     type: 'assistant';
     message: BetaMessage;
@@ -364,6 +366,39 @@ export type SDKBackgroundTasksChangedMessage = {
     uuid: UUID;
     session_id: string;
 };
+/**
+ * The main session entered or left Plan Mode.
+ * Requires the CLI `plan_mode_v1` capability.
+ */
+export type SDKPlanModeChangedMessage = {
+    type: 'system';
+    subtype: 'plan_mode_changed';
+    plan_mode: SDKPlanModeSnapshot;
+    uuid: UUID;
+    session_id: string;
+};
+/**
+ * Goal state changed (created / redirected / transitioned / budget update).
+ * Requires the CLI `goal_v1` capability.
+ */
+export type SDKGoalUpdatedMessage = {
+    type: 'system';
+    subtype: 'goal_updated';
+    goal: SDKGoalSnapshot;
+    /** Why the goal changed, e.g. 'safety-limit' or 'blocked'. */
+    reason?: string;
+    uuid: UUID;
+    session_id: string;
+};
+/** Goal was cleared. Requires the CLI `goal_v1` capability. */
+export type SDKGoalClearedMessage = {
+    type: 'system';
+    subtype: 'goal_cleared';
+    goal_id: string;
+    reason?: string;
+    uuid: UUID;
+    session_id: string;
+};
 export type SDKSessionStateChangedMessage = {
     type: 'system';
     subtype: 'session_state_changed';
@@ -435,6 +470,13 @@ export type SDKMemoryConsumptionMessage = {
     uuid: UUID;
     session_id: string;
 };
+export type SDKSkillEvolutionMessage = {
+    type: 'system';
+    subtype: 'skill_evolution';
+    result: SkillEvolutionResult;
+    uuid: UUID;
+    session_id: string;
+};
 export type SDKPermissionDenial = {
     tool_name: string;
     tool_use_id: string;
@@ -456,4 +498,4 @@ export type SDKPermissionDeniedMessage = {
     decision_reason_type?: SDKPermissionDeniedReasonType;
     decision_reason?: string;
 };
-export type SDKMessage = SDKAssistantMessage | SDKUserMessage | SDKUserMessageReplay | SDKResultMessage | SDKSystemMessage | SDKPermissionDeniedMessage | SDKPartialAssistantMessage | SDKCompactBoundaryMessage | SDKStatusMessage | SDKAPIRetryMessage | SDKModelQueueStatusMessage | SDKControlRequestProgressMessage | SDKHookStartedMessage | SDKHookProgressMessage | SDKHookResponseMessage | SDKTaskNotificationMessage | SDKTaskStartedMessage | SDKTaskProgressMessage | SDKTaskUpdatedMessage | SDKBackgroundTasksChangedMessage | SDKSessionStateChangedMessage | SDKSessionTitleChangedMessage | SDKFilesPersistedEvent | SDKElicitationCompleteMessage | SDKPromptSuggestionMessage | SDKCloudAgentEventMessage | SDKMemoryGenerationMessage | SDKMemoryConsumptionMessage;
+export type SDKMessage = SDKAssistantMessage | SDKUserMessage | SDKUserMessageReplay | SDKResultMessage | SDKSystemMessage | SDKPermissionDeniedMessage | SDKPartialAssistantMessage | SDKCompactBoundaryMessage | SDKStatusMessage | SDKAPIRetryMessage | SDKModelQueueStatusMessage | SDKControlRequestProgressMessage | SDKHookStartedMessage | SDKHookProgressMessage | SDKHookResponseMessage | SDKTaskNotificationMessage | SDKTaskStartedMessage | SDKTaskProgressMessage | SDKTaskUpdatedMessage | SDKBackgroundTasksChangedMessage | SDKSessionStateChangedMessage | SDKPlanModeChangedMessage | SDKGoalUpdatedMessage | SDKGoalClearedMessage | SDKSessionTitleChangedMessage | SDKFilesPersistedEvent | SDKElicitationCompleteMessage | SDKPromptSuggestionMessage | SDKCloudAgentEventMessage | SDKMemoryGenerationMessage | SDKMemoryConsumptionMessage | SDKSkillEvolutionMessage;

package/dist/protocol/skill-evolution.d.ts

@@ -0,0 +1,67 @@
+import type { NonNullableUsage } from './common.js';
+export type SkillEvolutionMode = 'native' | 'custom';
+export type SkillEvolutionGateInput = {
+    sessionId: string;
+    requestId?: string;
+    requestSetId?: string;
+    turnIndex: number;
+    cwd: string;
+    prompt: string;
+    response: string;
+};
+export type SkillEvolutionGateResult = {
+    run: boolean;
+    reason?: string;
+};
+export type SerializableSkillEvolutionGenerationOptions = {
+    enabled?: boolean;
+    prompt?: string;
+    maxSuggestions?: number;
+    turnComplete?: {
+        enabled?: boolean;
+        reviewThreshold?: number;
+        shouldReviewCallbackId?: string;
+        timeoutMs?: number;
+        onGateError?: 'skip' | 'report_failed';
+    };
+};
+export type SerializableSkillEvolutionConfig = {
+    requester: 'sdk';
+    mode: SkillEvolutionMode;
+    generation?: SerializableSkillEvolutionGenerationOptions;
+};
+export type SerializableEvolutionConfig = {
+    skill?: SerializableSkillEvolutionConfig;
+};
+export type EffectiveSkillEvolutionConfig = {
+    enabled: boolean;
+    requester: 'sdk';
+    mode: SkillEvolutionMode;
+    generationEnabled: boolean;
+    turnCompleteEnabled: boolean;
+    reviewThreshold: number;
+    cooldownMs: number;
+    maxSuggestions: number;
+};
+export type EffectiveEvolutionConfig = {
+    skill?: EffectiveSkillEvolutionConfig;
+};
+export type SkillEvolutionSuggestion = {
+    skillName: string;
+    action: 'create' | 'update';
+    summary: string;
+    confidence: number;
+    rationale?: string;
+};
+export type SkillEvolutionResult = {
+    status: 'suggested' | 'no_change' | 'skipped' | 'failed';
+    attemptId: string;
+    reason?: string;
+    origin: 'turn_complete';
+    reviewScore?: number;
+    sourceRequestIds?: string[];
+    modelRequestIds?: string[];
+    suggestions: SkillEvolutionSuggestion[];
+    durationMs: number;
+    usage?: NonNullableUsage;
+};

package/dist/protocol/version.d.ts

@@ -21,5 +21,5 @@
  * `system/init` JSONL message. The SDK validates it against the
  * version it was built against using semver.
  */
-export declare const WIRE_PROTOCOL_VERSION: "1.2.0";
+export declare const WIRE_PROTOCOL_VERSION: "1.3.0";
 export type WireProtocolVersion = string;

package/dist/query/query-runner.d.ts

@@ -26,7 +26,7 @@ import type { Transport } from '../core/transport.js';
 import type { SDKMessage, SDKUserMessage } from '../types/messages.js';
 import type { InternalQuery, OnElicitation } from '../types/options.js';
 import type { FetchJobToken, FetchServiceAccountToken } from '../types/auth.js';
-import type { SDKControlInterruptResponse, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlGenerateSessionTitleResponse, AskSideQuestionOptions, SideQuestionResult, SDKControlAddDirectoriesResponse, SDKControlReloadPluginsResponse } from '../types/control.js';
+import type { SDKPlanModeSnapshot, SDKGoalSnapshot, SDKGoalStatus, SDKControlInterruptResponse, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlGenerateSessionTitleResponse, AskSideQuestionOptions, SideQuestionResult, SDKControlAddDirectoriesResponse, SDKControlReloadPluginsResponse } from '../types/control.js';
 import type { PermissionMode, CanUseTool } from '../types/permissions.js';
 import type { HookCallbackMatcher } from '../types/hooks.js';
 import type { HookEvent as InternalHookEvent } from '../protocol/index.js';
@@ -41,6 +41,7 @@ import type { PluginDetails } from '../types/plugins.js';
 import type { ModelInfo, SlashCommand, AccountInfo, UsageInfo } from '../types/common.js';
 import type { ModelPolicyProvider } from '../types/model-policy-provider.js';
 import type { MemoryRuntimeCallbacks, SerializableMemoryConfig } from '../types/memory.js';
+import type { SkillEvolutionRuntimeCallbacks, SerializableEvolutionConfig } from '../types/skill-evolution.js';
 import type { BYOKModelValidationInput, BYOKProviderInfo } from '../types/byok.js';
 /** Init config passed to the initialize control request. */
 type InitConfig = {
@@ -49,9 +50,11 @@ type InitConfig = {
     modelRequestPatches?: ModelPromptPatches;
     agents?: Record<string, AgentDefinition>;
     skills?: string[];
+    planMode?: boolean;
     promptSuggestions?: boolean;
     enableFileCheckpointing?: boolean;
     memory?: SerializableMemoryConfig;
+    evolution?: SerializableEvolutionConfig;
     customContext?: Record<string, string>;
 };
 export declare class QueryRunner implements InternalQuery {
@@ -59,6 +62,8 @@ export declare class QueryRunner implements InternalQuery {
     private static readonly INITIALIZE_TIMEOUT_MS;
     private static readonly BACKGROUND_TASKS_CAPABILITY;
     private static readonly SIDE_QUESTION_CAPABILITY;
+    private static readonly GOAL_CAPABILITY;
+    private static readonly PLAN_MODE_CAPABILITY;
     private readonly transport;
     private readonly inputStream;
     private readonly pendingRequests;
@@ -84,9 +89,16 @@ export declare class QueryRunner implements InternalQuery {
     private readonly resolveModelTimeoutMs;
     private readonly transcriptMirrorBatcher?;
     private readonly memoryCallbacks?;
+    private readonly skillEvolutionCallbacks?;
     private initResponse?;
     private initializationPromise?;
     private resultMessage?;
+    /**
+     * True only while the latest completed turn is an error result and no newer
+     * user or assistant turn has started. A following exit code 1 is the shell
+     * status for that structured result, not a second SDK failure.
+     */
+    private pendingErrorResultExit;
     private readLoopPromise?;
     private closed;
     private authExpiredFired;
@@ -96,9 +108,10 @@ export declare class QueryRunner implements InternalQuery {
     private firstResultReceived;
     private firstResultReceivedResolve?;
     private memoryFlushPromise?;
-    private memoryEndInputPromise?;
+    private endInputFlushPromise?;
+    private skillEvolutionFlushPromise?;
     private closePromise?;
-    constructor(transport: Transport, isSingleTurn: boolean, canUseTool?: CanUseTool, hooks?: Partial<Record<InternalHookEvent, HookCallbackMatcher[]>>, abortController?: AbortController, sdkMcpServers?: Map<string, McpServer>, initConfig?: InitConfig, onElicitation?: OnElicitation, diagnostics?: DiagnosticsSink, onAuthExpired?: () => void, controlRequestTimeoutMs?: number, sdkMcpTransports?: Map<string, SdkMcpTransport>, pendingMcpResponses?: Map<string, PendingMcpResponse>, fetchJobToken?: FetchJobToken, resolveModel?: ModelPolicyProvider, resolveModelTimeoutMs?: number, sessionStore?: SessionStore, sessionStoreFlush?: SessionStoreFlush, sdkMcpToolOverrides?: Record<string, Record<string, McpToolRuntimeOverride>>, fetchServiceAccountToken?: FetchServiceAccountToken, memoryCallbacks?: MemoryRuntimeCallbacks);
+    constructor(transport: Transport, isSingleTurn: boolean, canUseTool?: CanUseTool, hooks?: Partial<Record<InternalHookEvent, HookCallbackMatcher[]>>, abortController?: AbortController, sdkMcpServers?: Map<string, McpServer>, initConfig?: InitConfig, onElicitation?: OnElicitation, diagnostics?: DiagnosticsSink, onAuthExpired?: () => void, controlRequestTimeoutMs?: number, sdkMcpTransports?: Map<string, SdkMcpTransport>, pendingMcpResponses?: Map<string, PendingMcpResponse>, fetchJobToken?: FetchJobToken, resolveModel?: ModelPolicyProvider, resolveModelTimeoutMs?: number, sessionStore?: SessionStore, sessionStoreFlush?: SessionStoreFlush, sdkMcpToolOverrides?: Record<string, Record<string, McpToolRuntimeOverride>>, fetchServiceAccountToken?: FetchServiceAccountToken, memoryCallbacks?: MemoryRuntimeCallbacks, skillEvolutionCallbacks?: SkillEvolutionRuntimeCallbacks);
     private getRecord;
     private normalizeLogPreview;
     private extractMessagePreview;
@@ -120,10 +133,12 @@ export declare class QueryRunner implements InternalQuery {
      * this method finishes and signals the consumer queue.
      */
     private readMessages;
+    private isStructuredResultExit;
     private notifyAuthExpiredIfNeeded;
     private dispatchMemoryCallbacks;
-    private flushMemoryBeforeEndInput;
-    private performFlushMemoryBeforeEndInput;
+    private dispatchSkillEvolutionCallbacks;
+    private flushBeforeEndInput;
+    private performFlushBeforeEndInput;
     /**
      * Send a control request to the CLI and wait for the response.
      *
@@ -221,6 +236,27 @@ export declare class QueryRunner implements InternalQuery {
     stopTask(taskId: string): Promise<void>;
     /** Move one or all eligible foreground tasks into the background. */
     backgroundTasks(toolUseId?: string): Promise<boolean>;
+    /**
+     * Create, redirect, transition, or re-budget the session goal.
+     *
+     * Omitted fields are left unchanged; `creditsBudget: null` explicitly
+     * clears the credits budget. Setting `status: 'active'` while the session
+     * is idle starts the goal loop. Returns the goal snapshot after the change
+     * (null only if no goal exists afterwards).
+     */
+    setGoal(params: {
+        objective?: string;
+        status?: SDKGoalStatus;
+        creditsBudget?: number | null;
+    }): Promise<SDKGoalSnapshot | null>;
+    /** Read the current goal, or null when the session has none. */
+    getGoal(): Promise<SDKGoalSnapshot | null>;
+    /** Clear the session goal. Returns whether a goal was actually cleared. */
+    clearGoal(): Promise<boolean>;
+    /** Enter or leave Plan Mode without changing the current permission mode. */
+    setPlanMode(active: boolean): Promise<SDKPlanModeSnapshot>;
+    /** Read the authoritative Plan Mode state from the running CLI session. */
+    getPlanMode(): Promise<SDKPlanModeSnapshot>;
     private requireCliCapability;
     /**
      * Set the permission mode.
@@ -321,6 +357,9 @@ export declare class QueryRunner implements InternalQuery {
      */
     seedReadState(path: string, mtime: number): Promise<void>;
     flushMemory(): Promise<void>;
+    flushSkillEvolution(): Promise<void>;
+    private performSkillEvolutionFlush;
+    private requireSkillEvolutionEnabled;
     private performMemoryFlush;
     refreshMemory(): Promise<void>;
     private requireSdkMemoryEnabled;

package/dist/runtime-manifest.json

@@ -1,16 +1,16 @@
 {
   "version": 1,
   "brand": "global",
-  "sdkVersion": "1.0.24",
-  "qoderCliVersion": "1.1.25",
+  "sdkVersion": "1.0.26",
+  "qoderCliVersion": "1.1.31",
   "defaultTransport": "worker",
   "workerRuntime": {
     "packaged": false,
     "delivery": "install",
     "source": "qodercli-worker-runtime",
-    "urlTemplate": "https://download.qoder.com/qodercli/releases/1.1.25/qodercli-worker-runtime-{target}.tgz",
+    "urlTemplate": "https://download.qoder.com/qodercli/releases/1.1.31/qodercli-worker-runtime-{target}.tgz",
     "artifactNameTemplate": "qodercli-worker-runtime-{target}.tgz",
-    "sdkVersion": "1.0.24",
-    "qoderCliVersion": "1.1.25"
+    "sdkVersion": "1.0.26",
+    "qoderCliVersion": "1.1.31"
   }
 }

package/dist/session/session-manager.d.ts

@@ -1,4 +1,41 @@
-import type { SDKSessionInfo, SessionMessage, ListSessionsOptions, GetSessionInfoOptions, GetSessionMessagesOptions, GetSubagentMessagesOptions, ListSubagentsOptions, SessionMutationOptions } from '../types/session.js';
+import type { SDKSessionInfo, SessionMessage, ListSessionsOptions, GetSessionInfoOptions, GetSessionMessagesOptions, GetSubagentMessagesOptions, ListSubagentsOptions, SessionMutationOptions, SessionMessageView } from '../types/session.js';
+type TranscriptEntry = {
+    type: string;
+    uuid: string;
+    sessionId?: string;
+    session_id?: string;
+    parentUuid?: string | null;
+    logicalParentUuid?: string | null;
+    isSidechain?: boolean;
+    isMeta?: boolean;
+    isCompactSummary?: boolean;
+    teamName?: string;
+    timestamp?: string;
+    subtype?: string;
+    message?: unknown;
+    isApiErrorMessage?: unknown;
+    toolUseResult?: unknown;
+    toolDenialKind?: unknown;
+    userFeedback?: unknown;
+    compactMetadata?: {
+        trigger?: 'manual' | 'auto';
+        preTokens?: number;
+        pre_tokens?: number;
+        postTokens?: number;
+        post_tokens?: number;
+        messagesSummarized?: number;
+        messages_summarized?: number;
+        durationMs?: number;
+        duration_ms?: number;
+        preservedSegment?: {
+            headUuid?: string;
+            anchorUuid?: string;
+            tailUuid?: string;
+        };
+    };
+};
+/** Builds one active transcript lineage for SDK readers and persisted forks. */
+export declare function buildSessionTranscriptChain(entries: readonly unknown[], sessionId: string, view: SessionMessageView): TranscriptEntry[];
 /**
  * List sessions with metadata.
  *
@@ -37,8 +74,8 @@ export declare function getSessionInfo(sessionId: string, options?: GetSessionIn
  * Parses the JSONL transcript, follows the session's persisted active leaf
  * (falling back to the latest main leaf for legacy transcripts), and returns
  * visible user/assistant messages in chronological order. Supports pagination
- * via offset/limit. Set `includeSystemMessages` to include chain system entries
- * such as compact boundaries.
+ * via offset/limit. Runtime view is the default. Historical view crosses
+ * compact boundaries while omitting compact boundary and summary records.
  *
  * @param sessionId - The session UUID
  * @param options.dir - Restrict search to this working directory
@@ -99,4 +136,5 @@ export declare function listSubagents(sessionId: string, options?: ListSubagents
  */
 export declare function getSubagentMessages(sessionId: string, agentId: string, options?: GetSubagentMessagesOptions): Promise<SessionMessage[]>;
 /** Delete a session and all child transcripts from a local or external store. */
-export declare function deleteSession(sessionId: string, options?: SessionMutationOptions): Promise<void>;
+export declare function deleteSession(sessionId: string, options?: SessionMutationOptions): Promise<void>;
+export {};

package/dist/skill-evolution/skill-evolution-options.d.ts

@@ -0,0 +1,2 @@
+import type { SkillEvolutionOptions, PreparedSkillEvolutionOptions } from '../types/skill-evolution.js';
+export declare function prepareSkillEvolutionOptions(options: SkillEvolutionOptions | undefined): PreparedSkillEvolutionOptions;

package/dist/types/control.d.ts

@@ -5,7 +5,7 @@
  * shim so existing SDK consumer imports keep working.
  */
 export type { QoderModelPurpose } from '../protocol/index.js';
-export type { SDKControlRequest, SDKControlResponse, SDKControlCancelRequest, SDKControlInterruptRequest, SDKControlInterruptResponse, SDKControlPermissionRequest, SDKControlInitializeRequest, SDKControlSetPermissionModeRequest, SDKControlSetModelRequest, SDKControlGenerateSessionTitleRequest, SDKControlGenerateSessionTitleResponse, SideQuestionHistoryEntry, AskSideQuestionOptions, SideQuestionRefusalFallback, SideQuestionResult, SDKControlSideQuestionRequest, SDKControlSideQuestionResponse, SDKControlAddDirectoriesRequest, SDKControlAddDirectoriesResponse, SDKControlGetModelPolicyRequest, SDKControlGetByokConfigRequest, SDKControlGetByokConfigResponse, SDKControlValidateByokModelRequest, SDKControlValidateByokModelResponse, SDKControlSetMaxThinkingTokensRequest, SDKControlMcpStatusRequest, SDKControlGetContextUsageRequest, SDKControlGetUsageInfoRequest, SDKControlGetUsageInfoResponse, SDKControlAccountInfoRequest, SDKHookCallbackRequest, SDKControlMcpMessageRequest, SDKControlRewindFilesRequest, SDKControlRewindRequest, SDKControlCancelAsyncMessageRequest, SDKControlSeedReadStateRequest, SDKControlMcpSetServersRequest, SDKControlReloadPluginsRequest, SDKControlMcpReconnectRequest, SDKControlMcpToggleRequest, SDKControlApplyFlagSettingsRequest, SDKControlGetSettingsRequest, SDKControlElicitationRequest, SDKControlEndSessionRequest, SDKControlChannelEnableRequest, SDKControlMcpInjectTokenRequest, SDKControlMcpAuthenticateRequest, SDKControlMcpOAuthCallbackUrlRequest, SDKControlMcpClearAuthRequest, SDKControlRequestInner, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlReloadPluginsResponse, SDKControlListPluginsRequest, SDKControlListPluginsResponse, SDKControlStopTaskRequest, SDKControlBackgroundTasksRequest, SDKControlBackgroundTasksResponse, SDKControlMemoryShouldGenerateRequest, SDKControlFlushMemoryRequest, SDKControlRefreshMemoryRequest, SDKControlMcpStatusResponse, SDKControlMcpSetServersResponse, SDKKeepAliveMessage, StdoutMessage, ControlMcpServerConfig, BYOKModelValidationInput, } from '../protocol/index.js';
+export type { SDKControlRequest, SDKControlResponse, SDKControlCancelRequest, SDKControlInterruptRequest, SDKControlInterruptResponse, SDKControlPermissionRequest, SDKControlInitializeRequest, SDKControlSetPermissionModeRequest, SDKControlSetModelRequest, SDKPlanModeSnapshot, SDKControlSetPlanModeRequest, SDKControlSetPlanModeResponse, SDKControlGetPlanModeRequest, SDKControlGetPlanModeResponse, SDKControlSetGoalRequest, SDKControlSetGoalResponse, SDKControlGetGoalRequest, SDKControlGetGoalResponse, SDKControlClearGoalRequest, SDKControlClearGoalResponse, SDKGoalSnapshot, SDKGoalStatus, SDKControlGenerateSessionTitleRequest, SDKControlGenerateSessionTitleResponse, SideQuestionHistoryEntry, AskSideQuestionOptions, SideQuestionRefusalFallback, SideQuestionResult, SDKControlSideQuestionRequest, SDKControlSideQuestionResponse, SDKControlAddDirectoriesRequest, SDKControlAddDirectoriesResponse, SDKControlGetModelPolicyRequest, SDKControlGetByokConfigRequest, SDKControlGetByokConfigResponse, SDKControlValidateByokModelRequest, SDKControlValidateByokModelResponse, SDKControlSetMaxThinkingTokensRequest, SDKControlMcpStatusRequest, SDKControlGetContextUsageRequest, SDKControlGetUsageInfoRequest, SDKControlGetUsageInfoResponse, SDKControlAccountInfoRequest, SDKHookCallbackRequest, SDKControlMcpMessageRequest, SDKControlRewindFilesRequest, SDKControlRewindRequest, SDKControlCancelAsyncMessageRequest, SDKControlSeedReadStateRequest, SDKControlMcpSetServersRequest, SDKControlReloadPluginsRequest, SDKControlMcpReconnectRequest, SDKControlMcpToggleRequest, SDKControlApplyFlagSettingsRequest, SDKControlGetSettingsRequest, SDKControlElicitationRequest, SDKControlEndSessionRequest, SDKControlChannelEnableRequest, SDKControlMcpInjectTokenRequest, SDKControlMcpAuthenticateRequest, SDKControlMcpOAuthCallbackUrlRequest, SDKControlMcpClearAuthRequest, SDKControlRequestInner, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlReloadPluginsResponse, SDKControlListPluginsRequest, SDKControlListPluginsResponse, SDKControlStopTaskRequest, SDKControlBackgroundTasksRequest, SDKControlBackgroundTasksResponse, SDKControlMemoryShouldGenerateRequest, SDKControlFlushMemoryRequest, SDKControlRefreshMemoryRequest, SDKControlSkillEvolutionShouldReviewRequest, SDKControlFlushSkillEvolutionRequest, SDKControlMcpStatusResponse, SDKControlMcpSetServersResponse, SDKKeepAliveMessage, StdoutMessage, ControlMcpServerConfig, BYOKModelValidationInput, } from '../protocol/index.js';
 /** Wire format for fetch_job_token inbound control request from CLI. */
 export type FetchJobTokenWireRequest = {
     subtype: 'fetch_job_token';

package/dist/types/hooks.d.ts

@@ -5,11 +5,11 @@
  * `../protocol/`. The SDK-local HookEvent/HookInput contract is
  * intentionally narrowed to events supported by SDK user configuration.
  */
-export type { BaseHookInput, PreToolUseHookInput, PostToolUseHookInput, PostToolUseFailureHookInput, UserPromptSubmitHookInput, SessionStartHookInput, SessionEndHookInput, StopHookInput, SubagentStartHookInput, SubagentStopHookInput, PreCompactHookInput, PostCompactHookInput, PermissionRequestHookInput, PermissionDeniedHookInput, InstructionsLoadedHookInput, CwdChangedHookInput, FileChangedHookInput, PostToolUseFailureHookSpecificOutput, UserPromptSubmitHookSpecificOutput, SessionStartHookSpecificOutput, SubagentStartHookSpecificOutput, PermissionRequestHookSpecificOutput, CwdChangedHookSpecificOutput, FileChangedHookSpecificOutput, } from '../protocol/index.js';
-import type { AsyncHookJSONOutput as ProtocolAsyncHookJSONOutput, CwdChangedHookSpecificOutput, FileChangedHookSpecificOutput, HookInput as ProtocolHookInput, PostToolUseHookSpecificOutput as ProtocolPostToolUseHookSpecificOutput, PostToolUseFailureHookSpecificOutput, PreToolUseHookSpecificOutput as ProtocolPreToolUseHookSpecificOutput, PermissionRequestHookSpecificOutput, SessionStartHookSpecificOutput, SubagentStartHookSpecificOutput, SyncHookJSONOutput as ProtocolSyncHookJSONOutput, UserPromptSubmitHookSpecificOutput } from '../protocol/index.js';
+export type { BaseHookInput, PreToolUseHookInput, PostToolUseHookInput, PostToolUseFailureHookInput, UserPromptSubmitHookInput, SessionStartHookInput, SessionEndHookInput, StopHookInput, SubagentStartHookInput, SubagentStopHookInput, PreCompactHookInput, PostCompactHookInput, PermissionRequestHookInput, PermissionDeniedHookInput, InstructionsLoadedHookInput, WorktreeCreateHookInput, WorktreeRemoveHookInput, CwdChangedHookInput, FileChangedHookInput, PostToolUseFailureHookSpecificOutput, UserPromptSubmitHookSpecificOutput, SessionStartHookSpecificOutput, SubagentStartHookSpecificOutput, PermissionRequestHookSpecificOutput, WorktreeCreateHookSpecificOutput, CwdChangedHookSpecificOutput, FileChangedHookSpecificOutput, } from '../protocol/index.js';
+import type { AsyncHookJSONOutput as ProtocolAsyncHookJSONOutput, CwdChangedHookSpecificOutput, FileChangedHookSpecificOutput, HookInput as ProtocolHookInput, PostToolUseHookSpecificOutput as ProtocolPostToolUseHookSpecificOutput, PostToolUseFailureHookSpecificOutput, PreToolUseHookSpecificOutput as ProtocolPreToolUseHookSpecificOutput, PermissionRequestHookSpecificOutput, SessionStartHookSpecificOutput, SubagentStartHookSpecificOutput, WorktreeCreateHookSpecificOutput, SyncHookJSONOutput as ProtocolSyncHookJSONOutput, UserPromptSubmitHookSpecificOutput } from '../protocol/index.js';
 import type { HookEventConst } from '../core/constants.js';
 /**
- * The 16 publicly supported hook events available to SDK users.
+ * The publicly supported hook events available to SDK users.
  * Internal/experimental events are handled at runtime but not exposed
  * in the user-facing configuration type.
  */
@@ -26,7 +26,7 @@ export type PostToolUseHookSpecificOutput = Omit<ProtocolPostToolUseHookSpecific
     updatedMCPToolOutput?: string;
 };
 export type AsyncHookJSONOutput = ProtocolAsyncHookJSONOutput;
-export type HookSpecificOutput = PreToolUseHookSpecificOutput | PostToolUseHookSpecificOutput | PostToolUseFailureHookSpecificOutput | UserPromptSubmitHookSpecificOutput | SessionStartHookSpecificOutput | SubagentStartHookSpecificOutput | PermissionRequestHookSpecificOutput | CwdChangedHookSpecificOutput | FileChangedHookSpecificOutput;
+export type HookSpecificOutput = PreToolUseHookSpecificOutput | PostToolUseHookSpecificOutput | PostToolUseFailureHookSpecificOutput | UserPromptSubmitHookSpecificOutput | SessionStartHookSpecificOutput | SubagentStartHookSpecificOutput | PermissionRequestHookSpecificOutput | WorktreeCreateHookSpecificOutput | CwdChangedHookSpecificOutput | FileChangedHookSpecificOutput;
 export type SyncHookJSONOutput = Omit<ProtocolSyncHookJSONOutput, 'hookSpecificOutput'> & {
     hookSpecificOutput?: HookSpecificOutput;
 };

package/dist/types/index.d.ts

@@ -12,7 +12,7 @@ export type { WorkerRuntimeTransportOptions, WorkerTransportOptions, } from '../
 export type { QueryTransportProvider, Transport, } from '../core/transport.js';
 export type { ElicitationRequest, ElicitationResult, OnElicitation, PromptRequestOption, PromptRequest, PromptResponse, SecurityScanOptions, Options, QueryTransportOptions, SpawnOptions, SpawnedProcess, Query, } from './options.js';
 export * from './permissions.js';
-export type { HookEvent, HookPermissionDecision, HookCallback, HookCallbackMatcher, HookInput, HookSpecificOutput, HookJSONOutput, AsyncHookJSONOutput, SyncHookJSONOutput, BaseHookInput, PreToolUseHookInput, PostToolUseHookInput, PostToolUseFailureHookInput, UserPromptSubmitHookInput, SessionStartHookInput, SessionEndHookInput, StopHookInput, SubagentStartHookInput, SubagentStopHookInput, PreCompactHookInput, PostCompactHookInput, PermissionRequestHookInput, InstructionsLoadedHookInput, CwdChangedHookInput, FileChangedHookInput, PreToolUseHookSpecificOutput, PostToolUseHookSpecificOutput, PostToolUseFailureHookSpecificOutput, UserPromptSubmitHookSpecificOutput, SessionStartHookSpecificOutput, SubagentStartHookSpecificOutput, PermissionRequestHookSpecificOutput, CwdChangedHookSpecificOutput, FileChangedHookSpecificOutput, } from './hooks.js';
+export type { HookEvent, HookPermissionDecision, HookCallback, HookCallbackMatcher, HookInput, HookSpecificOutput, HookJSONOutput, AsyncHookJSONOutput, SyncHookJSONOutput, BaseHookInput, PreToolUseHookInput, PostToolUseHookInput, PostToolUseFailureHookInput, UserPromptSubmitHookInput, SessionStartHookInput, SessionEndHookInput, StopHookInput, SubagentStartHookInput, SubagentStopHookInput, PreCompactHookInput, PostCompactHookInput, PermissionRequestHookInput, PermissionDeniedHookInput, InstructionsLoadedHookInput, WorktreeCreateHookInput, WorktreeRemoveHookInput, CwdChangedHookInput, FileChangedHookInput, PreToolUseHookSpecificOutput, PostToolUseHookSpecificOutput, PostToolUseFailureHookSpecificOutput, UserPromptSubmitHookSpecificOutput, SessionStartHookSpecificOutput, SubagentStartHookSpecificOutput, PermissionRequestHookSpecificOutput, WorktreeCreateHookSpecificOutput, CwdChangedHookSpecificOutput, FileChangedHookSpecificOutput, } from './hooks.js';
 export * from './mcp.js';
 export * from './agents.js';
 export * from './session.js';

package/dist/types/memory.d.ts

@@ -40,13 +40,28 @@ export type MemoryConsumptionOptions = {
     onResult?: (result: MemoryConsumptionResult) => void | Promise<void>;
 };
 export type MemoryOptions = {
-    /** Uses CLI-native generation and consumption. Only result callbacks may be supplied. */
+    /** An empty object disables SDK memory, equivalent to omitting options.memory. */
+    mode?: never;
+    projectScope?: never;
+    userScope?: never;
+    generation?: never;
+    consumption?: never;
+} | {
+    /** Uses CLI-native generation and consumption; only scope switches and result callbacks are configurable. */
     mode: 'native';
+    /** Enables or disables the CLI PROJECT scope for this Query. Defaults to `true`. */
+    projectScope?: boolean;
+    /** Enables or disables the CLI USER scope for this Query. Defaults to `true`. */
+    userScope?: boolean;
     generation?: Pick<MemoryGenerationOptions, 'onResult'>;
     consumption?: Pick<MemoryConsumptionOptions, 'onResult'>;
 } | {
     /** Applies supplied overrides and inherits omitted behavior from the CLI. */
     mode: 'custom';
+    /** Enables or disables the CLI PROJECT scope for inherited native behavior. Defaults to `true`. */
+    projectScope?: boolean;
+    /** Enables or disables the CLI USER scope for inherited native behavior. Defaults to `true`. */
+    userScope?: boolean;
     /** Memory generation overrides. Omit to use CLI generation defaults. */
     generation?: MemoryGenerationOptions;
     /** Memory consumption overrides. Omit to use CLI consumption defaults. */