@qoder-ai/qoder-agent-sdk 1.0.32 → 1.0.33

package/dist/protocol/common.d.ts

@@ -251,7 +251,7 @@ export type ModelStrategy = {
     enabled: boolean;
     disabled_message_key: string;
 };
-export type ModelSource = 'system' | 'user' | 'organization';
+export type ModelSource = 'system' | 'user' | 'organization' | 'custom';
 /** JSON-compatible value inside a raw server model entry. */
 export type ServerModelJsonValue = string | number | boolean | null | ServerModelJsonValue[] | {
     [key: string]: ServerModelJsonValue;
@@ -302,7 +302,7 @@ export type ModelInfo = {
     modelId?: string;
     displayName: string;
     description: string;
-    /** `'system'` (Qoder catalog), `'user'` (BYOK), or organization-managed. */
+    /** `'system'` (Qoder catalog), `'user'` (BYOK), `'organization'`, or `'custom'` (Custom Provider). */
     source?: ModelSource;
     /** Server-designated default for the current scene. */
     isDefault?: boolean;

package/dist/protocol/control.d.ts

@@ -125,9 +125,12 @@ export type SDKControlInitializeRequest = {
     sdkMcpServers?: string[];
     sdkMcpToolOverrides?: Record<string, Record<string, McpToolRuntimeOverride>>;
     promptSuggestions?: boolean;
+    goalMaxTurns?: number;
     supportsCatalogReadyInitialize?: boolean;
     /** Opts this Host into authoritative model snapshots on the Query stream. */
     supportsAvailableModelsUpdate?: boolean;
+    /** Opts this Host into authoritative command snapshots on the Query stream. */
+    supportsCommandsChanged?: boolean;
     initializeTimeoutMs?: number;
     agentProgressSummaries?: boolean;
     memory?: SerializableMemoryConfig;
@@ -396,6 +399,9 @@ export type SDKControlMcpSetServersRequest = {
 export type SDKControlReloadPluginsRequest = {
     type: 'reload_plugins';
 };
+export type SDKControlReloadSkillsRequest = {
+    type: 'reload_skills';
+};
 export type SDKControlMcpReconnectRequest = {
     type: 'mcp_reconnect';
     serverName: string;
@@ -479,6 +485,163 @@ export type SDKControlValidateByokModelRequest = BYOKModelValidationInput & {
 export type SDKControlValidateByokModelResponse = {
     success: boolean;
 };
+export type ByokProtocol = 'openai' | 'openai-responses' | 'anthropic';
+export type ByokModelConfigInfo = {
+    key: string;
+    displayName: string;
+    provider: string;
+    model: string;
+    type?: string;
+    baseUrl?: string;
+    style?: string;
+    vision: boolean;
+    reasoning: boolean;
+    maxInputTokens: number;
+    reasoningEfforts?: string[];
+    supportsDisabledReasoning?: boolean;
+    reasoningEffort?: string;
+    availableContextWindows?: number[];
+    contextWindow?: number;
+};
+export type CustomByokProviderConfigInfo = {
+    providerId: string;
+    displayName: string;
+    baseUrl: string;
+    providerType: 'openai-compatible' | 'alibaba';
+    protocol: ByokProtocol;
+    authType: 'bearer' | 'api-key';
+    defaultModelId: string;
+    models: Array<{
+        id: string;
+        displayName: string;
+        vision: boolean;
+        reasoning: boolean;
+        maxInputTokens: number;
+        maxOutputTokens: number;
+        reasoningEfforts?: string[];
+    }>;
+};
+/** A secret-free persisted BYOK configuration returned by the CLI. */
+export type ByokConfigInfo = ByokModelConfigInfo | CustomByokProviderConfigInfo;
+export type ByokModelConfigInput = {
+    provider: string;
+    model: string;
+    parameters: Record<string, string>;
+    key?: string;
+    displayName?: string;
+    type?: string;
+    baseUrl?: string;
+    style?: string;
+    reasoningEffort?: string;
+    contextWindow?: number;
+};
+export type CustomByokProviderThinkingMode = 'enabled' | 'adaptive';
+export type CustomByokProviderReasoningEffortLevel = 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+export type CustomByokProviderThinkingCapabilitiesInput = {
+    modes: CustomByokProviderThinkingMode[];
+    preferredMode?: CustomByokProviderThinkingMode;
+    requiresBudgetForEnabled?: boolean;
+    supportsEffort?: boolean;
+    supportedEffortLevels?: CustomByokProviderReasoningEffortLevel[];
+    requiredBetasForEffort?: string[];
+};
+export type CustomByokProviderModelCapabilitiesInput = {
+    tools?: boolean;
+    vision?: boolean;
+    cacheControl?: boolean;
+    thinking?: CustomByokProviderThinkingCapabilitiesInput;
+};
+export type CustomByokProviderModelInput = {
+    model: string;
+    displayName?: string;
+    contextWindow?: number;
+    maxOutputTokens?: number;
+    capabilities?: CustomByokProviderModelCapabilitiesInput;
+};
+export type CustomByokProviderConfigInput = {
+    providerId: string;
+    baseUrl: string;
+    apiKey: string;
+    type?: 'openai-compatible' | 'alibaba' | 'aliyun-bailian';
+    protocol?: ByokProtocol;
+    authType?: 'bearer' | 'api-key';
+    displayName?: string;
+    model?: string;
+    models?: CustomByokProviderModelInput[];
+};
+export type CreateByokConfigInput = ByokModelConfigInput | CustomByokProviderConfigInput;
+export type UpdateByokModelConfigInput = {
+    key: string;
+    parameters?: Record<string, string>;
+    displayName?: string;
+    baseUrl?: string;
+    style?: string;
+    reasoningEffort?: string;
+    contextWindow?: number;
+};
+export type UpdateCustomByokProviderConfigInput = {
+    providerId: string;
+    baseUrl?: string;
+    apiKey?: string;
+    type?: 'openai-compatible' | 'alibaba' | 'aliyun-bailian';
+    protocol?: ByokProtocol;
+    authType?: 'bearer' | 'api-key';
+    displayName?: string;
+    model?: string;
+    models?: CustomByokProviderModelInput[];
+};
+export type UpdateByokConfigInput = UpdateByokModelConfigInput | UpdateCustomByokProviderConfigInput;
+export type DeleteByokConfigInput = {
+    key: string;
+} | {
+    providerId: string;
+};
+export type CheckByokConfigInput = CreateByokConfigInput;
+export type ByokConfigReference = {
+    key: string;
+} | {
+    providerId: string;
+};
+export type ByokConfigCheckResult = {
+    success: boolean;
+    /** Specific failure reason, with supplied credentials replaced by [REDACTED]. */
+    error?: string;
+    /** Existing validation/transport code, or BYOK_CHECK_FAILED when unavailable. */
+    code?: string;
+    /** Control request ID for correlating CLI logs. */
+    requestId?: string;
+    details?: {
+        field?: string;
+        httpStatus?: number;
+        upstreamCode?: string;
+    };
+};
+export type SDKControlListByokConfigsRequest = {
+    type: 'list_byok_configs';
+};
+export type SDKControlListByokConfigsResponse = {
+    configs: ByokConfigInfo[];
+};
+export type SDKControlCreateByokConfigRequest = {
+    type: 'create_byok_config';
+    config: CreateByokConfigInput;
+};
+export type SDKControlCreateByokConfigResponse = {
+    config: ByokConfigReference;
+};
+export type SDKControlUpdateByokConfigRequest = {
+    type: 'update_byok_config';
+    config: UpdateByokConfigInput;
+};
+export type SDKControlDeleteByokConfigRequest = {
+    type: 'delete_byok_config';
+    target: DeleteByokConfigInput;
+};
+export type SDKControlCheckByokConfigRequest = {
+    type: 'check_byok_config';
+    config: CheckByokConfigInput;
+};
+export type SDKControlCheckByokConfigResponse = ByokConfigCheckResult;
 /** A third-party LLM provider in the BYOK catalog. */
 export type BYOKProviderInfo = {
     /** Provider identifier, e.g. "openai", "deepseek" */
@@ -641,6 +804,17 @@ export type SDKControlSetGoalRequest = {
 export type SDKControlSetGoalResponse = {
     goal: SDKGoalSnapshot | null;
 };
+/**
+ * Update the maximum turns copied into Goals created after this request.
+ * `null` restores the CLI built-in value. The current Goal is unchanged.
+ */
+export type SDKControlSetGoalMaxTurnsRequest = {
+    subtype: 'set_goal_max_turns';
+    max_turns: number | null;
+};
+export type SDKControlSetGoalMaxTurnsResponse = {
+    goal_max_turns: number;
+};
 export type SDKControlGetGoalRequest = {
     subtype: 'get_goal';
 };
@@ -653,7 +827,7 @@ export type SDKControlClearGoalRequest = {
 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 SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetProxyRequest | SDKControlGenerateSessionTitleRequest | SDKControlSideQuestionRequest | SDKControlAddDirectoriesRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlMcpStatusRequest | SDKControlGetContextUsageRequest | SDKControlGetUsageInfoRequest | SDKControlGetModelPolicyRequest | SDKControlAccountInfoRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlRewindRequest | SDKControlCancelAsyncMessageRequest | SDKControlSeedReadStateRequest | SDKControlMcpSetServersRequest | SDKControlReloadPluginsRequest | SDKControlReloadSkillsRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest | SDKControlEndSessionRequest | SDKControlChannelEnableRequest | SDKControlMcpInjectTokenRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlMcpClearAuthRequest | SDKControlGetByokConfigRequest | SDKControlValidateByokModelRequest | SDKControlListByokConfigsRequest | SDKControlCreateByokConfigRequest | SDKControlUpdateByokConfigRequest | SDKControlDeleteByokConfigRequest | SDKControlCheckByokConfigRequest | SDKControlListPluginsRequest | SDKControlStopTaskRequest | SDKControlBackgroundTasksRequest | SDKControlMemoryShouldGenerateRequest | SDKControlFlushMemoryRequest | SDKControlSkillEvolutionShouldReviewRequest | SDKControlFlushSkillEvolutionRequest | SDKControlRefreshMemoryRequest | SDKControlSetPlanModeRequest | SDKControlGetPlanModeRequest | SDKControlSetGoalRequest | SDKControlSetGoalMaxTurnsRequest | SDKControlGetGoalRequest | SDKControlClearGoalRequest;
 export type SDKControlInitializeResponse = {
     commands: SlashCommand[];
     agents: AgentInfo[];
@@ -729,6 +903,9 @@ export type SDKControlReloadPluginsResponse = {
     mcpServers: McpServerStatus[];
     error_count: number;
 };
+export type SDKControlReloadSkillsResponse = {
+    skills: SlashCommand[];
+};
 export type SDKControlMcpStatusResponse = {
     servers: McpServerStatus[];
 };

package/dist/protocol/hooks.d.ts

@@ -45,6 +45,8 @@ export type PostToolUseFailureHookInput = BaseHookInput & {
 export type UserPromptSubmitHookInput = BaseHookInput & {
     hook_event_name: 'UserPromptSubmit';
     prompt: string;
+    /** Resolved HTTP(S) image URLs; omitted when none are available. */
+    image_urls?: string[];
 };
 export type SessionStartHookInput = BaseHookInput & {
     hook_event_name: 'SessionStart';

package/dist/protocol/index.d.ts

@@ -21,8 +21,8 @@ export type { EffectiveMemoryConfig, MemoryConsumptionFile, MemoryConsumptionRes
 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, SDKArtifactInfo, SDKArtifactUpdateMessage, SDKAvailableModelsUpdateMessage, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKStatusMessage, SDKAPIRetryMessage, SDKModelQueueStatusMessage, SDKControlRequestProgressMessage, SDKCommandLifecycleMessage, 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 { SDKAssistantMessage, SDKToolNonExecutionKind, SDKToolResultMeta, SDKMessageOrigin, SDKUserMessage, SDKUserMessageReplay, SDKResultSuccess, SDKResultError, SDKResultMessage, SDKFileAttachment, SDKSystemMessage, SDKArtifactInfo, SDKArtifactUpdateMessage, SDKAvailableModelsUpdateMessage, SDKCommandsChangedMessage, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKStatusMessage, SDKAPIRetryMessage, SDKModelQueueStatusMessage, SDKControlRequestProgressMessage, SDKCommandLifecycleMessage, 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, DaemonEventMessage, 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';
+export type { SDKControlRequest, SDKControlResponse, SDKControlCancelRequest, DaemonEventMessage, 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, SDKControlReloadSkillsRequest, SDKControlMcpReconnectRequest, SDKControlMcpToggleRequest, SDKControlApplyFlagSettingsRequest, SDKControlGetSettingsRequest, SDKControlElicitationRequest, SDKControlEndSessionRequest, SDKControlChannelEnableRequest, SDKControlMcpInjectTokenRequest, SDKControlMcpAuthenticateRequest, SDKControlMcpOAuthCallbackUrlRequest, SDKControlMcpClearAuthRequest, SDKPlanModeSnapshot, SDKControlSetPlanModeRequest, SDKControlSetPlanModeResponse, SDKControlGetPlanModeRequest, SDKControlGetPlanModeResponse, SDKGoalStatus, SDKGoalSnapshot, SDKControlSetGoalRequest, SDKControlSetGoalResponse, SDKControlSetGoalMaxTurnsRequest, SDKControlSetGoalMaxTurnsResponse, SDKControlGetGoalRequest, SDKControlGetGoalResponse, SDKControlClearGoalRequest, SDKControlClearGoalResponse, SDKControlRequestInner, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlReloadPluginsResponse, SDKControlReloadSkillsResponse, SDKControlMcpStatusResponse, SDKControlMcpSetServersResponse, SDKControlMcpAuthenticateResponse, SDKControlGetByokConfigRequest, SDKControlGetByokConfigResponse, SDKControlValidateByokModelRequest, SDKControlValidateByokModelResponse, SDKControlListByokConfigsRequest, SDKControlListByokConfigsResponse, SDKControlCreateByokConfigRequest, SDKControlCreateByokConfigResponse, SDKControlUpdateByokConfigRequest, SDKControlDeleteByokConfigRequest, SDKControlCheckByokConfigRequest, SDKControlCheckByokConfigResponse, BYOKModelValidationInput, BYOKProviderInfo, BYOKFieldInfo, BYOKModelTypeInfo, BYOKModelInfo, ByokProtocol, ByokModelConfigInfo, CustomByokProviderConfigInfo, ByokConfigInfo, ByokModelConfigInput, CustomByokProviderThinkingMode, CustomByokProviderReasoningEffortLevel, CustomByokProviderThinkingCapabilitiesInput, CustomByokProviderModelCapabilitiesInput, CustomByokProviderModelInput, CustomByokProviderConfigInput, CreateByokConfigInput, UpdateByokModelConfigInput, UpdateCustomByokProviderConfigInput, UpdateByokConfigInput, DeleteByokConfigInput, CheckByokConfigInput, ByokConfigReference, ByokConfigCheckResult, 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 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};
+var a="1.4.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 o=new Set(r),n=Object.keys(e).filter(t=>!o.has(t));if(n.length>0)throw new TypeError(`securityScan contains unknown option${n.length===1?"":"s"}: ${n.join(", ")}.`);for(let t of r){let s=e[t];if(s!==void 0&&typeof s!="boolean")throw new TypeError(`securityScan.${t} 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 o={...e.settings??{}},n=e.aiCodeTracking?.installGitCommitHook;if(n!==void 0){let t=o.aiCodeTracking;o.aiCodeTracking={...p(t)?t:{},installGitCommitHook:n}}return e.securityScan!==void 0&&(o.securityScan=i(e.securityScan)),o}function u(e={}){let o=l(e);return Object.keys(o).length===0?[]:["--settings",JSON.stringify(o)]}var g={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{g as QoderModelPurpose,a as WIRE_PROTOCOL_VERSION,l as buildQoderCliFlagSettings,u as buildQoderCliFlagSettingsArgs};

package/dist/protocol/messages.d.ts

@@ -11,7 +11,7 @@
  * `@google/gemini-cli-core/protocol/schemas` are kept aligned via
  * `satisfies z.ZodType<...>` against these types.
  */
-import type { BetaMessage, BetaRawMessageStreamEvent, MessageParam, UUID, SDKAssistantMessageError, FastModeState, ApiKeySource, ModelUsage, NonNullableUsage, PluginInfo, ModelInfo, SDKStatus } from './common.js';
+import type { BetaMessage, BetaRawMessageStreamEvent, MessageParam, UUID, SDKAssistantMessageError, FastModeState, ApiKeySource, ModelUsage, NonNullableUsage, PluginInfo, ModelInfo, SlashCommand, SDKStatus } from './common.js';
 import type { PermissionMode } from './permissions.js';
 import type { MemoryConsumptionResult, MemoryGenerationResult } from './memory.js';
 import type { SkillEvolutionResult } from './skill-evolution.js';
@@ -48,6 +48,21 @@ export type SDKToolResultMeta = {
     non_execution_kind: SDKToolNonExecutionKind;
     user_feedback?: string;
 };
+/** 触发一条 SDK 消息的公开来源。内部协调器元数据不会暴露。 */
+export type SDKMessageOrigin = {
+    kind: 'task-notification';
+} | {
+    kind: 'peer';
+    from?: string;
+    senderTaskId?: string;
+    name?: string;
+    body?: string;
+} | {
+    kind: 'human';
+} | {
+    kind: 'bridge';
+    sessionId?: string;
+};
 export type SDKUserMessage = {
     type: 'user';
     message: MessageParam;
@@ -55,6 +70,7 @@ export type SDKUserMessage = {
     custom_context?: Record<string, string>;
     file_attachments?: SDKFileAttachment[];
     isSynthetic?: boolean;
+    origin?: SDKMessageOrigin;
     tool_use_result?: unknown;
     tool_result_meta?: SDKToolResultMeta[];
     /**
@@ -78,6 +94,7 @@ export type SDKUserMessageReplay = {
     parent_tool_use_id: string | null;
     file_attachments?: SDKFileAttachment[];
     isSynthetic?: boolean;
+    origin?: SDKMessageOrigin;
     tool_use_result?: unknown;
     tool_result_meta?: SDKToolResultMeta[];
     /**
@@ -115,6 +132,7 @@ export type SDKResultSuccess = {
     deferred_tool_use?: unknown;
     terminal_reason?: string | null;
     fast_mode_state?: FastModeState;
+    origin?: SDKMessageOrigin;
     uuid: UUID;
     session_id: string;
 };
@@ -136,6 +154,7 @@ export type SDKResultError = {
     error_code?: number;
     terminal_reason?: string | null;
     fast_mode_state?: FastModeState;
+    origin?: SDKMessageOrigin;
     uuid: UUID;
     session_id: string;
 };
@@ -544,4 +563,17 @@ export type SDKAvailableModelsUpdateMessage = {
     uuid: UUID;
     session_id: string;
 };
-export type SDKMessage = SDKAssistantMessage | SDKUserMessage | SDKUserMessageReplay | SDKResultMessage | SDKSystemMessage | SDKArtifactUpdateMessage | SDKAvailableModelsUpdateMessage | SDKPermissionDeniedMessage | SDKPartialAssistantMessage | SDKCompactBoundaryMessage | SDKStatusMessage | SDKAPIRetryMessage | SDKModelQueueStatusMessage | SDKControlRequestProgressMessage | SDKCommandLifecycleMessage | SDKHookStartedMessage | SDKHookProgressMessage | SDKHookResponseMessage | SDKTaskNotificationMessage | SDKTaskStartedMessage | SDKTaskProgressMessage | SDKTaskUpdatedMessage | SDKBackgroundTasksChangedMessage | SDKSessionStateChangedMessage | SDKPlanModeChangedMessage | SDKGoalUpdatedMessage | SDKGoalClearedMessage | SDKSessionTitleChangedMessage | SDKFilesPersistedEvent | SDKElicitationCompleteMessage | SDKPromptSuggestionMessage | SDKCloudAgentEventMessage | SDKMemoryGenerationMessage | SDKMemoryConsumptionMessage | SDKSkillEvolutionMessage;
+/**
+ * Authoritative snapshot of commands available to a running Session.
+ *
+ * Consumers should replace their local command catalog instead of merging this
+ * event, because removed commands are intentionally absent from the snapshot.
+ */
+export type SDKCommandsChangedMessage = {
+    type: 'system';
+    subtype: 'commands_changed';
+    commands: SlashCommand[];
+    uuid: UUID;
+    session_id: string;
+};
+export type SDKMessage = SDKAssistantMessage | SDKUserMessage | SDKUserMessageReplay | SDKResultMessage | SDKSystemMessage | SDKArtifactUpdateMessage | SDKAvailableModelsUpdateMessage | SDKCommandsChangedMessage | SDKPermissionDeniedMessage | SDKPartialAssistantMessage | SDKCompactBoundaryMessage | SDKStatusMessage | SDKAPIRetryMessage | SDKModelQueueStatusMessage | SDKControlRequestProgressMessage | SDKCommandLifecycleMessage | SDKHookStartedMessage | SDKHookProgressMessage | SDKHookResponseMessage | SDKTaskNotificationMessage | SDKTaskStartedMessage | SDKTaskProgressMessage | SDKTaskUpdatedMessage | SDKBackgroundTasksChangedMessage | SDKSessionStateChangedMessage | SDKPlanModeChangedMessage | SDKGoalUpdatedMessage | SDKGoalClearedMessage | SDKSessionTitleChangedMessage | SDKFilesPersistedEvent | SDKElicitationCompleteMessage | SDKPromptSuggestionMessage | SDKCloudAgentEventMessage | SDKMemoryGenerationMessage | SDKMemoryConsumptionMessage | SDKSkillEvolutionMessage;

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.3.0";
+export declare const WIRE_PROTOCOL_VERSION: "1.4.0";
 export type WireProtocolVersion = string;

package/dist/query/goal-max-turns.d.ts

@@ -0,0 +1 @@
+export declare function assertValidGoalMaxTurns(value: number): void;

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 { SDKPlanModeSnapshot, SDKGoalSnapshot, SDKGoalStatus, 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, SDKControlReloadSkillsResponse } 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';
@@ -42,7 +42,7 @@ import type { ModelInfo, SlashCommand, AccountInfo, UsageInfo } from '../types/c
 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';
+import type { BYOKModelValidationInput, BYOKProviderInfo, ByokConfigCheckResult, ByokConfigInfo, ByokConfigReference, CheckByokConfigInput, CreateByokConfigInput, DeleteByokConfigInput, UpdateByokConfigInput } from '../types/byok.js';
 /** Init config passed to the initialize control request. */
 type InitConfig = {
     systemPrompt?: string;
@@ -52,6 +52,7 @@ type InitConfig = {
     skills?: string[];
     planMode?: boolean;
     promptSuggestions?: boolean;
+    goalMaxTurns?: number;
     enableFileCheckpointing?: boolean;
     memory?: SerializableMemoryConfig;
     evolution?: SerializableEvolutionConfig;
@@ -71,7 +72,9 @@ export declare class QueryRunner implements InternalQuery {
     private static readonly BACKGROUND_TASKS_CAPABILITY;
     private static readonly SIDE_QUESTION_CAPABILITY;
     private static readonly GOAL_CAPABILITY;
+    private static readonly GOAL_MAX_TURNS_CAPABILITY;
     private static readonly PLAN_MODE_CAPABILITY;
+    private static readonly BYOK_CONFIG_MANAGEMENT_CAPABILITY;
     private static readonly SESSION_STORE_FORK_BARRIER_CAPABILITY;
     private readonly transport;
     private readonly inputStream;
@@ -100,6 +103,7 @@ export declare class QueryRunner implements InternalQuery {
     private readonly memoryCallbacks?;
     private readonly skillEvolutionCallbacks?;
     private initResponse?;
+    private latestCommands;
     private initializationPromise?;
     private resultMessage?;
     /**
@@ -228,6 +232,8 @@ export declare class QueryRunner implements InternalQuery {
      * is available, matching the Query interface contract.
      */
     initializationResult(): Promise<SDKControlInitializeResponse>;
+    private replaceLatestCommands;
+    private getLatestCommands;
     /**
      * Stream user messages into the session.
      *
@@ -261,6 +267,11 @@ export declare class QueryRunner implements InternalQuery {
         status?: SDKGoalStatus;
         creditsBudget?: number | null;
     }): Promise<SDKGoalSnapshot | null>;
+    /**
+     * Update the maximum turns copied into Goals created after this call.
+     * The current Goal is unchanged; null restores the CLI built-in value.
+     */
+    setGoalMaxTurns(maxTurns: number | null): Promise<number>;
     /** 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. */
@@ -270,6 +281,8 @@ export declare class QueryRunner implements InternalQuery {
     /** Read the authoritative Plan Mode state from the running CLI session. */
     getPlanMode(): Promise<SDKPlanModeSnapshot>;
     private requireCliCapability;
+    /** Apply init-only configuration that an attached daemon did not consume. */
+    private applyAttachedGoalMaxTurns;
     /**
      * Set the permission mode.
      */
@@ -320,6 +333,11 @@ export declare class QueryRunner implements InternalQuery {
      * Validate a BYOK provider/model/API-key combination through the CLI.
      */
     validateByokModel(input: BYOKModelValidationInput): Promise<boolean | null>;
+    listByokConfigs(): Promise<ByokConfigInfo[]>;
+    createByokConfig(input: CreateByokConfigInput): Promise<ByokConfigReference>;
+    updateByokConfig(input: UpdateByokConfigInput): Promise<void>;
+    deleteByokConfig(target: DeleteByokConfigInput): Promise<void>;
+    checkByokConfig(input: CheckByokConfigInput): Promise<ByokConfigCheckResult>;
     /**
      * Get supported agents.
      */
@@ -350,6 +368,8 @@ export declare class QueryRunner implements InternalQuery {
      * Reload plugins.
      */
     reloadPlugins(): Promise<SDKControlReloadPluginsResponse>;
+    /** Rescan Skills and return the CLI's displayable, user-invocable snapshot. */
+    reloadSkills(): Promise<SDKControlReloadSkillsResponse>;
     listPlugins(): Promise<PluginDetails[]>;
     /**
      * Rewind files to a previous user message.

package/dist/runtime-manifest.json

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

package/dist/types/byok.d.ts

@@ -1,13 +1,13 @@
 /**
  * BYOK (Bring Your Own Key) types.
  *
- * These types represent the BYOK provider/model catalog returned by the CLI
- * when the SDK sends a `get_byok_config` control request, and the per-call
- * credential payload the host returns from `resolveModel` to route a
- * single LLM call through a third-party provider.
+ * These types represent the server BYOK provider/model catalog, persisted
+ * BYOK configurations, and the per-call credential payload the host returns
+ * from `resolveModel` to route a single LLM call through a third-party
+ * provider.
  *
  * `CustomModel` is the wire shape shared with the CLI via the protocol
  * module — defining it once on the protocol avoids snake/camel drift across
  * SDK and CLI.
  */
-export type { SDKControlGetByokConfigRequest, SDKControlGetByokConfigResponse, SDKControlValidateByokModelRequest, SDKControlValidateByokModelResponse, BYOKModelValidationInput, CustomModel, BYOKProviderInfo, BYOKFieldInfo, BYOKModelTypeInfo, BYOKModelInfo, } from '../protocol/index.js';
+export type { SDKControlGetByokConfigRequest, SDKControlGetByokConfigResponse, SDKControlValidateByokModelRequest, SDKControlValidateByokModelResponse, SDKControlListByokConfigsRequest, SDKControlListByokConfigsResponse, SDKControlCreateByokConfigRequest, SDKControlCreateByokConfigResponse, SDKControlUpdateByokConfigRequest, SDKControlDeleteByokConfigRequest, SDKControlCheckByokConfigRequest, SDKControlCheckByokConfigResponse, BYOKModelValidationInput, CustomModel, BYOKProviderInfo, BYOKFieldInfo, BYOKModelTypeInfo, BYOKModelInfo, ByokProtocol, ByokModelConfigInfo, CustomByokProviderConfigInfo, ByokConfigInfo, ByokModelConfigInput, CustomByokProviderThinkingMode, CustomByokProviderReasoningEffortLevel, CustomByokProviderThinkingCapabilitiesInput, CustomByokProviderModelCapabilitiesInput, CustomByokProviderModelInput, CustomByokProviderConfigInput, CreateByokConfigInput, UpdateByokModelConfigInput, UpdateCustomByokProviderConfigInput, UpdateByokConfigInput, DeleteByokConfigInput, CheckByokConfigInput, ByokConfigReference, ByokConfigCheckResult, } from '../protocol/index.js';

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, 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';
+export type { SDKControlRequest, SDKControlResponse, SDKControlCancelRequest, SDKControlInterruptRequest, SDKControlInterruptResponse, SDKControlPermissionRequest, SDKControlInitializeRequest, SDKControlSetPermissionModeRequest, SDKControlSetModelRequest, SDKPlanModeSnapshot, SDKControlSetPlanModeRequest, SDKControlSetPlanModeResponse, SDKControlGetPlanModeRequest, SDKControlGetPlanModeResponse, SDKControlSetGoalRequest, SDKControlSetGoalResponse, SDKControlSetGoalMaxTurnsRequest, SDKControlSetGoalMaxTurnsResponse, SDKControlGetGoalRequest, SDKControlGetGoalResponse, SDKControlClearGoalRequest, SDKControlClearGoalResponse, SDKGoalSnapshot, SDKGoalStatus, SDKControlGenerateSessionTitleRequest, SDKControlGenerateSessionTitleResponse, SideQuestionHistoryEntry, AskSideQuestionOptions, SideQuestionRefusalFallback, SideQuestionResult, SDKControlSideQuestionRequest, SDKControlSideQuestionResponse, SDKControlAddDirectoriesRequest, SDKControlAddDirectoriesResponse, SDKControlGetModelPolicyRequest, SDKControlGetByokConfigRequest, SDKControlGetByokConfigResponse, SDKControlValidateByokModelRequest, SDKControlValidateByokModelResponse, SDKControlListByokConfigsRequest, SDKControlListByokConfigsResponse, SDKControlCreateByokConfigRequest, SDKControlCreateByokConfigResponse, SDKControlUpdateByokConfigRequest, SDKControlDeleteByokConfigRequest, SDKControlCheckByokConfigRequest, SDKControlCheckByokConfigResponse, SDKControlSetMaxThinkingTokensRequest, SDKControlMcpStatusRequest, SDKControlGetContextUsageRequest, SDKControlGetUsageInfoRequest, SDKControlGetUsageInfoResponse, SDKControlAccountInfoRequest, SDKHookCallbackRequest, SDKControlMcpMessageRequest, SDKControlRewindFilesRequest, SDKControlRewindRequest, SDKControlCancelAsyncMessageRequest, SDKControlSeedReadStateRequest, SDKControlMcpSetServersRequest, SDKControlReloadPluginsRequest, SDKControlReloadSkillsRequest, SDKControlMcpReconnectRequest, SDKControlMcpToggleRequest, SDKControlApplyFlagSettingsRequest, SDKControlGetSettingsRequest, SDKControlElicitationRequest, SDKControlEndSessionRequest, SDKControlChannelEnableRequest, SDKControlMcpInjectTokenRequest, SDKControlMcpAuthenticateRequest, SDKControlMcpOAuthCallbackUrlRequest, SDKControlMcpClearAuthRequest, SDKControlRequestInner, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlReloadPluginsResponse, SDKControlReloadSkillsResponse, 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/messages.d.ts

@@ -9,13 +9,14 @@ import type { SDKMessage as ProtocolSDKMessage, SDKStatusMessage as ProtocolSDKS
 import type { MessageParam, UUID } from './common.js';
 import type { PermissionMode } from './permissions.js';
 import type { SessionKey } from '../session/session-store.js';
-export type { SDKAssistantMessage, SDKArtifactInfo, SDKArtifactUpdateMessage, SDKAvailableModelsUpdateMessage, SDKResultSuccess, SDKResultError, SDKResultMessage, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKAPIRetryMessage, SDKModelQueueStatusMessage, SDKControlRequestProgressMessage, SDKCommandLifecycleMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKTaskUpdatedMessage, SDKBackgroundTasksChangedMessage, SDKSessionStateChangedMessage, SDKPlanModeChangedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKMemoryGenerationMessage, SDKMemoryConsumptionMessage, SDKSkillEvolutionMessage, SDKPermissionDenial, SDKToolNonExecutionKind, SDKToolResultMeta, } from '../protocol/index.js';
+export type { SDKAssistantMessage, SDKArtifactInfo, SDKArtifactUpdateMessage, SDKAvailableModelsUpdateMessage, SDKCommandsChangedMessage, SDKResultSuccess, SDKResultError, SDKResultMessage, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKAPIRetryMessage, SDKModelQueueStatusMessage, SDKControlRequestProgressMessage, SDKCommandLifecycleMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKTaskUpdatedMessage, SDKBackgroundTasksChangedMessage, SDKSessionStateChangedMessage, SDKPlanModeChangedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKMemoryGenerationMessage, SDKMemoryConsumptionMessage, SDKSkillEvolutionMessage, SDKPermissionDenial, SDKMessageOrigin, SDKToolNonExecutionKind, SDKToolResultMeta, } from '../protocol/index.js';
 export type SDKUserMessage = {
     type: 'user';
     message: MessageParam;
     parent_tool_use_id: string | null;
     custom_context?: Record<string, string>;
     isSynthetic?: boolean;
+    origin?: import('../protocol/index.js').SDKMessageOrigin;
     tool_use_result?: unknown;
     /** CLI-stamped display metadata for tool results that did not execute. */
     tool_result_meta?: import('../protocol/index.js').SDKToolResultMeta[];

package/dist/types/options.d.ts

@@ -8,9 +8,9 @@ import type { HookCallbackMatcher, HookEvent } from './hooks.js';
 import type { McpServerConfig, McpServerStatus, McpSetServersResult, OAuthToken } from './mcp.js';
 import type { SDKMessage, SDKUserMessage } from './messages.js';
 import type { Settings } from './settings.js';
-import type { SDKControlInterruptResponse, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlGenerateSessionTitleResponse, AskSideQuestionOptions, SideQuestionResult, SDKControlAddDirectoriesResponse, SDKControlReloadPluginsResponse, StdoutMessage } from './control.js';
+import type { SDKControlInterruptResponse, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlGenerateSessionTitleResponse, AskSideQuestionOptions, SideQuestionResult, SDKControlAddDirectoriesResponse, SDKControlReloadPluginsResponse, SDKControlReloadSkillsResponse, StdoutMessage } from './control.js';
 import type { ModelPolicyProvider } from './model-policy-provider.js';
-import type { BYOKModelValidationInput, BYOKProviderInfo } from './byok.js';
+import type { BYOKModelValidationInput, BYOKProviderInfo, ByokConfigCheckResult, ByokConfigInfo, ByokConfigReference, CheckByokConfigInput, CreateByokConfigInput, DeleteByokConfigInput, UpdateByokConfigInput } from './byok.js';
 import type { RewindFilesResult, RewindResult, RewindScope } from './session.js';
 import type { CloudAgentOptions } from './cloud-agent.js';
 import type { QueryTransportProviderOption } from '../core/query-transport.js';
@@ -246,6 +246,12 @@ export type Options = {
     includePartialMessages?: boolean;
     includeHookEvents?: boolean;
     maxTurns?: number;
+    /**
+     * Maximum turns copied into Goals created later in this Query.
+     * This is separate from `maxTurns`, which limits ordinary CLI execution,
+     * and does not mutate a Goal restored with the session.
+     */
+    goalMaxTurns?: number;
     mcpServers?: Record<string, McpServerConfig>;
     allowedMcpServerNames?: string[];
     model?: string;
@@ -419,6 +425,13 @@ export interface Query extends AsyncGenerator<SDKMessage, void> {
         status?: SDKGoalStatus;
         creditsBudget?: number | null;
     }): Promise<SDKGoalSnapshot | null>;
+    /**
+     * Update the maximum turns copied into Goals created after this call.
+     * The current Goal is unchanged; pass `null` to restore the CLI built-in
+     * value. Requires the CLI `goal_max_turns_v1` capability. Only present on
+     * the local CLI transport; absent on cloud-agent queries.
+     */
+    setGoalMaxTurns?(maxTurns: number | null): Promise<number>;
     /** Read the current goal, or null when the session has none. */
     getGoal?(): Promise<SDKGoalSnapshot | null>;
     /** Clear the session goal; returns whether a goal was cleared. */
@@ -466,6 +479,7 @@ export interface Query extends AsyncGenerator<SDKMessage, void> {
     addDirectories(directories: string[]): Promise<SDKControlAddDirectoriesResponse>;
     applyFlagSettings(settings: Settings): Promise<void>;
     initializationResult(): Promise<SDKControlInitializeResponse>;
+    /** Returns the latest complete command snapshot known to this Query. */
     supportedCommands(): Promise<SlashCommand[]>;
     /**
      * Fetch the available model list from the CLI in real-time.
@@ -490,6 +504,20 @@ export interface Query extends AsyncGenerator<SDKMessage, void> {
      * control request.
      */
     validateByokModel(input: BYOKModelValidationInput): Promise<boolean | null>;
+    /**
+     * List persisted UID-scoped BYOK models plus User-scope Custom Providers.
+     * Credentials are never returned. Use listByokProviders() for the server
+     * provider/model catalog.
+     */
+    listByokConfigs(): Promise<ByokConfigInfo[]>;
+    /** Persist a server BYOK model or User-scope Custom Provider. */
+    createByokConfig(input: CreateByokConfigInput): Promise<ByokConfigReference>;
+    /** Update an existing BYOK entry by its stable storage key/provider id. */
+    updateByokConfig(input: UpdateByokConfigInput): Promise<void>;
+    /** Delete an existing BYOK entry by its stable storage key/provider id. */
+    deleteByokConfig(target: DeleteByokConfigInput): Promise<void>;
+    /** Validate a candidate configuration without persisting it. */
+    checkByokConfig(input: CheckByokConfigInput): Promise<ByokConfigCheckResult>;
     supportedAgents(): Promise<AgentInfo[]>;
     mcpServerStatus(): Promise<McpServerStatus[]>;
     getContextUsage(): Promise<SDKControlGetContextUsageResponse>;
@@ -499,6 +527,8 @@ export interface Query extends AsyncGenerator<SDKMessage, void> {
      * account usage endpoint.
      */
     getUsageInfo(): Promise<UsageInfo | null>;
+    /** Rescans Skills in the connected CLI and returns its Skill-only snapshot. */
+    reloadSkills(): Promise<SDKControlReloadSkillsResponse>;
     reloadPlugins(): Promise<SDKControlReloadPluginsResponse>;
     listPlugins(): Promise<PluginDetails[]>;
     accountInfo(): Promise<AccountInfo>;