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

package/dist/memory/memory-options.d.ts

@@ -0,0 +1,7 @@
+import type { MemoryOptions, MemoryRuntimeCallbacks } from '../types/memory.js';
+import type { SerializableMemoryConfig } from '../protocol/memory.js';
+export type PreparedMemoryOptions = {
+    config?: SerializableMemoryConfig;
+    callbacks?: MemoryRuntimeCallbacks;
+};
+export declare function prepareMemoryOptions(memory: MemoryOptions | undefined): PreparedMemoryOptions;

package/dist/protocol/control.d.ts

@@ -20,6 +20,7 @@ import type { AgentDefinition, AgentInfo } from './agents.js';
 import type { AccountInfo, FastModeState, ModelInfo, SessionCreditsUsage, SlashCommand, SdkPluginConfig, UsageInfo } from './common.js';
 import type { PluginDetails } from '../types/plugins.js';
 import type { ModelPromptPatches } from './model-prompt-patches.js';
+import type { EffectiveMemoryConfig, MemoryGenerationGateInput, SerializableMemoryConfig } from './memory.js';
 export type SDKControlRequest = {
     type: 'control_request';
     request_id: string;
@@ -113,6 +114,7 @@ export type SDKControlInitializeRequest = {
     supportsCatalogReadyInitialize?: boolean;
     initializeTimeoutMs?: number;
     agentProgressSummaries?: boolean;
+    memory?: SerializableMemoryConfig;
     hooks?: Partial<Record<HookEvent, Array<{
         hookCallbackIds: string[];
         timeout?: number;
@@ -126,6 +128,17 @@ export type SDKControlInitializeRequest = {
      */
     scene?: string;
 };
+export type SDKControlMemoryShouldGenerateRequest = {
+    type: 'memory_should_generate';
+    callbackId: string;
+    input: MemoryGenerationGateInput;
+};
+export type SDKControlFlushMemoryRequest = {
+    type: 'flush_memory';
+};
+export type SDKControlRefreshMemoryRequest = {
+    type: 'refresh_memory';
+};
 export type SDKControlSetPermissionModeRequest = {
     type: 'set_permission_mode';
     mode: PermissionMode;
@@ -146,6 +159,45 @@ export type SDKControlGenerateSessionTitleRequest = {
 export type SDKControlGenerateSessionTitleResponse = {
     title: string | null;
 };
+/** One completed side-question exchange that may be reused as local context. */
+export type SideQuestionHistoryEntry = {
+    question: string;
+    response: string;
+    /** Optional notice explaining that a fallback model produced the response. */
+    fallback_notice?: string;
+};
+/** Options for a side question that does not interrupt the main agent turn. */
+export type AskSideQuestionOptions = {
+    /** Cancels only this side question. The main agent turn continues running. */
+    signal?: AbortSignal;
+    /** Previous side-question exchanges to include as local context. */
+    history?: readonly SideQuestionHistoryEntry[];
+};
+export type SideQuestionRefusalFallback = {
+    originalModel: string;
+    fallbackModel: string;
+    content: string;
+};
+/** Public result returned by {@link Query.askSideQuestion}. */
+export type SideQuestionResult = {
+    response: string;
+    synthetic: boolean;
+    refusalFallback?: SideQuestionRefusalFallback;
+};
+export type SDKControlSideQuestionRequest = {
+    subtype: 'side_question';
+    question: string;
+    history?: SideQuestionHistoryEntry[];
+};
+export type SDKControlSideQuestionResponse = {
+    response: string | null;
+    synthetic?: boolean;
+    refusal_fallback?: {
+        original_model: string;
+        fallback_model: string;
+        content: string;
+    };
+};
 export type SDKControlAddDirectoriesRequest = {
     type: 'add_directories';
     directories: string[];
@@ -506,7 +558,7 @@ 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 | 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;
+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;
 export type SDKControlInitializeResponse = {
     commands: SlashCommand[];
     agents: AgentInfo[];
@@ -522,45 +574,37 @@ export type SDKControlInitializeResponse = {
     fast_mode_state?: FastModeState;
     /** Optional features implemented by the connected CLI control channel. */
     capabilities?: string[];
+    memory?: EffectiveMemoryConfig;
 };
 export type SDKControlGetContextUsageResponse = {
     model: string;
-    /** Whether optional token-count fields are available in this response. */
-    tokenCountsAvailable: boolean;
     contextWindow: {
         /** Context occupancy as a percentage from 0 to 100. */
         usedPercentage: number;
-        usedTokens?: number;
-        sizeTokens?: number;
     };
     /** Local estimates in the same order and category model as `/context`. */
     categories: Array<{
         type: 'system_prompt' | 'system_tools' | 'skills' | 'messages' | 'other' | 'free_space' | 'auto_compact';
         percentage: number;
-        tokens?: number;
     }>;
     autoCompact: {
         enabled: boolean;
         thresholdPercentage: number;
-        thresholdTokens?: number;
     };
     skills: {
         count: number;
         /** Aggregate skill frontmatter as a percentage of the full context. */
         percentageOfContext: number;
-        tokens?: number;
         items: Array<{
             name: string;
             source: 'project' | 'user' | 'built-in' | 'plugin';
             /** This skill's frontmatter as a percentage of the full context. */
             percentageOfContext: number;
-            tokens?: number;
         }>;
     };
     duplicateFileReads: Array<{
         path: string;
         count: number;
-        wastedTokens?: number;
     }>;
     session: {
         messageCount: number;

package/dist/protocol/index.d.ts

@@ -17,10 +17,11 @@ export type { ModelPromptPatch, ModelPromptPatches, } from './model-prompt-patch
 export type { UUID, BetaMessage, BetaRawMessageStreamEvent, BetaUsage, BetaStopReason, MessageParam, NonNullableUsage, AccountInfo, UsageAddOnQuotaBucket, UsageInfo, UsageOrgResourcePackage, UsageQuotaBucket, SessionCreditsUsage, ApiKeySource, ExitReason, FastModeState, ConfigScope, SettingSource, SDKAssistantMessageError, SDKStatus, EffortLevel, ThinkingAdaptive, ThinkingEnabled, ThinkingDisabled, ThinkingConfig, ModelInfo, ModelSource, ServerModelJson, ServerModelJsonValue, ModelStrategy, ModelPromotion, LocalizedModelText, ModelContextConfig, ModelContextWindowEntry, ModelEffortEntry, ModelThinkingConfig, ModelThinkingDisabled, ModelThinkingEnabled, PluginInfo, ModelUsage, SlashCommand, ToolConfig, SdkPluginConfig, } from './common.js';
 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 { 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, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKTaskUpdatedMessage, SDKBackgroundTasksChangedMessage, SDKSessionStateChangedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, 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, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKMemoryGenerationMessage, SDKMemoryConsumptionMessage, 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, 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, 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, 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';

package/dist/protocol/index.js

@@ -1 +1 @@
-var r="1.2.0";function i(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function n(e={}){let t={...e.settings??{}},o=e.aiCodeTracking?.installGitCommitHook;if(o!==void 0){let s=t.aiCodeTracking;t.aiCodeTracking={...i(s)?s:{},installGitCommitHook:o}}return t}function p(e={}){let t=n(e);return Object.keys(t).length===0?[]:["--settings",JSON.stringify(t)]}var l={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{l as QoderModelPurpose,r as WIRE_PROTOCOL_VERSION,n as buildQoderCliFlagSettings,p as buildQoderCliFlagSettingsArgs};
+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};

package/dist/protocol/launch.d.ts

@@ -3,6 +3,7 @@
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import type { SecurityScanOptions } from '../types/options.js';
 /**
  * Startup-only AI code tracking options exposed by the Agent SDK.
  *
@@ -21,6 +22,7 @@ export type AICodeTrackingLaunchOptions = {
 };
 export type QoderCliFlagSettings = Record<string, unknown> & {
     aiCodeTracking?: Record<string, unknown> & AICodeTrackingLaunchOptions;
+    securityScan?: Required<SecurityScanOptions>;
 };
 export type QoderAgentLaunchOptions = {
     /**
@@ -31,6 +33,8 @@ export type QoderAgentLaunchOptions = {
      * SDK-facing convenience options for AI code statistics.
      */
     aiCodeTracking?: AICodeTrackingLaunchOptions;
+    /** SDK-native code security capabilities. Omitted switches are disabled. */
+    securityScan?: SecurityScanOptions;
 };
 /**
  * Merge SDK launch options into a single qodercli flag-settings object.

package/dist/protocol/memory.d.ts

@@ -0,0 +1,133 @@
+import type { NonNullableUsage } from './common.js';
+/** Native delegates behavior to CLI defaults; custom applies partial SDK overrides. */
+export type MemoryMode = 'native' | 'custom';
+export type MemoryRootAccess = 'read' | 'read-write';
+export type MemoryRoot = {
+    /** Stable caller-defined identifier used in prompts, initialization, and generation results. */
+    id: string;
+    /** Directory path on the machine running qodercli. */
+    path: string;
+    /** Root access granted to memory agents. Defaults to "read-write". */
+    access?: MemoryRootAccess;
+    /** Relative index path inside this root. Omit when every file, including MEMORY.md, is content. */
+    indexFile?: string;
+};
+export type MemoryGenerationGateInput = {
+    /** Current CLI session identifier. */
+    sessionId: string;
+    /** Current model request identifier, when available. */
+    requestId?: string;
+    /** Current logical turn request-set identifier, when available. */
+    requestSetId?: string;
+    /** One-based SDK memory TurnComplete sequence number. */
+    turnIndex: number;
+    /** Current CLI working directory. */
+    cwd: string;
+    /** User prompt for the completed turn. */
+    prompt: string;
+    /** Final assistant response for the completed turn. */
+    response: string;
+};
+export type MemoryGenerationGateResult = {
+    /** True starts generation; false emits a skipped result. */
+    run: boolean;
+    /** Optional product-readable decision reason. */
+    reason?: string;
+};
+export type SerializableMemoryGenerationOptions = {
+    /** Defaults to true. */
+    enabled?: boolean;
+    roots?: MemoryRoot[];
+    prompt?: string;
+    turnComplete?: {
+        /** Defaults to true when generation is enabled. */
+        enabled?: boolean;
+        /** SDK process callback identifier used by the CLI control protocol. */
+        shouldGenerateCallbackId?: string;
+        /** Callback timeout in milliseconds. */
+        timeoutMs?: number;
+        /** Error/timeout result mapping for the product gate. */
+        onGateError?: 'skip' | 'report_failed';
+    };
+};
+export type MemoryConsumptionFile = {
+    /** Stable caller-defined identifier used as the injected section name and in results. */
+    id: string;
+    /** File path on the machine running qodercli. */
+    path: string;
+    /** Defaults to false. A read failure aborts only when this is true and failureMode is "fail_query". */
+    required?: boolean;
+};
+export type SerializableMemoryConsumptionOptions = {
+    /** Defaults to true. */
+    enabled?: boolean;
+    files?: MemoryConsumptionFile[];
+    maxTokens?: number;
+    overflow?: 'truncate' | 'fail_query';
+    failureMode?: 'best_effort' | 'fail_query';
+};
+type SerializableMemoryConfigBase = {
+    /** Marks this memory configuration as originating from the Agent SDK. */
+    requester: 'sdk';
+};
+export type SerializableMemoryConfig = SerializableMemoryConfigBase & ({
+    mode: 'native';
+    generation?: never;
+    consumption?: never;
+} | {
+    mode: 'custom';
+    generation?: SerializableMemoryGenerationOptions;
+    consumption?: SerializableMemoryConsumptionOptions;
+});
+export type EffectiveMemoryConfig = {
+    enabled: boolean;
+    requester: 'sdk';
+    mode?: MemoryMode;
+    generationEnabled: boolean;
+    turnCompleteEnabled: boolean;
+    consumptionEnabled: boolean;
+    roots: Array<{
+        id: string;
+        access: MemoryRootAccess;
+    }>;
+};
+export type MemoryGenerationFailedFile = {
+    rootId: string;
+    path: string;
+    error?: string;
+};
+export type MemoryGenerationResult = {
+    /** saved means every written file succeeded; partial means at least one file succeeded and one failed. */
+    status: 'saved' | 'partial' | 'no_change' | 'skipped' | 'failed';
+    attemptId: string;
+    /** Human-readable diagnostic detail. */
+    reason?: string;
+    origin: 'main_session' | 'turn_complete' | 'dream';
+    sourceRequestIds?: string[];
+    modelRequestIds?: string[];
+    writtenFiles: Array<{
+        rootId: string;
+        path: string;
+    }>;
+    /** Files that were not written successfully after the attempt completed. */
+    failedFiles: MemoryGenerationFailedFile[];
+    /** True when a native or explicitly declared custom index file changed. */
+    indexUpdated?: boolean;
+    /** True when at least one non-index memory content file changed. */
+    contentUpdated?: boolean;
+    durationMs: number;
+    usage?: NonNullableUsage;
+    /** Missing server-side credits remain undefined; callers must not infer them. */
+    credits?: number;
+};
+export type MemoryConsumptionResult = {
+    status: 'success' | 'partial' | 'failed';
+    files: Array<{
+        id: string;
+        path: string;
+        status: 'loaded' | 'missing' | 'failed' | 'truncated';
+        /** Human-readable diagnostic detail. */
+        error?: string;
+    }>;
+};
+export {};

package/dist/protocol/messages.d.ts

@@ -13,6 +13,7 @@
  */
 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';
 export type SDKAssistantMessage = {
     type: 'assistant';
     message: BetaMessage;
@@ -49,6 +50,7 @@ export type SDKUserMessage = {
     type: 'user';
     message: MessageParam;
     parent_tool_use_id: string | null;
+    custom_context?: Record<string, string>;
     file_attachments?: SDKFileAttachment[];
     isSynthetic?: boolean;
     tool_use_result?: unknown;
@@ -218,6 +220,36 @@ export type SDKAPIRetryMessage = {
     uuid: UUID;
     session_id: string;
 };
+/** Model capacity queue progress emitted while qodercli waits and retries. */
+export type SDKModelQueueStatusMessage = {
+    type: 'system';
+    subtype: 'model_queue_status';
+    status: 'queued' | 'ready';
+    request_id: string;
+    request_set_id: string;
+    model_key: string;
+    queue_type?: string;
+    queue_count?: number;
+    wait_time_ms?: number;
+    queue_wait_elapsed_ms?: number;
+    queue_max_wait_ms?: number;
+    service_available?: boolean;
+    uuid: UUID;
+    session_id: string;
+};
+/** Progress emitted for an SDK-initiated side question. */
+export type SDKControlRequestProgressMessage = {
+    type: 'system';
+    subtype: 'control_request_progress';
+    request_id: string;
+    status: 'started' | 'api_retry';
+    attempt?: number;
+    max_retries?: number;
+    retry_delay_ms?: number;
+    error_status?: number | null;
+    uuid: UUID;
+    session_id: string;
+};
 export type SDKHookStartedMessage = {
     type: 'system';
     subtype: 'hook_started';
@@ -389,6 +421,20 @@ export type SDKCloudAgentEventMessage = {
     uuid: UUID;
     session_id: string;
 };
+export type SDKMemoryGenerationMessage = {
+    type: 'system';
+    subtype: 'memory_generation';
+    result: MemoryGenerationResult;
+    uuid: UUID;
+    session_id: string;
+};
+export type SDKMemoryConsumptionMessage = {
+    type: 'system';
+    subtype: 'memory_consumption';
+    result: MemoryConsumptionResult;
+    uuid: UUID;
+    session_id: string;
+};
 export type SDKPermissionDenial = {
     tool_name: string;
     tool_use_id: string;
@@ -410,4 +456,4 @@ export type SDKPermissionDeniedMessage = {
     decision_reason_type?: SDKPermissionDeniedReasonType;
     decision_reason?: string;
 };
-export type SDKMessage = SDKAssistantMessage | SDKUserMessage | SDKUserMessageReplay | SDKResultMessage | SDKSystemMessage | SDKPermissionDeniedMessage | SDKPartialAssistantMessage | SDKCompactBoundaryMessage | SDKStatusMessage | SDKAPIRetryMessage | SDKHookStartedMessage | SDKHookProgressMessage | SDKHookResponseMessage | SDKTaskNotificationMessage | SDKTaskStartedMessage | SDKTaskProgressMessage | SDKTaskUpdatedMessage | SDKBackgroundTasksChangedMessage | SDKSessionStateChangedMessage | SDKSessionTitleChangedMessage | SDKFilesPersistedEvent | SDKElicitationCompleteMessage | SDKPromptSuggestionMessage | SDKCloudAgentEventMessage;
+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;

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, SDKControlAddDirectoriesResponse, SDKControlReloadPluginsResponse } from '../types/control.js';
+import type { 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';
@@ -40,6 +40,7 @@ import type { SessionStore, SessionStoreFlush } from '../session/session-store.j
 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 { BYOKModelValidationInput, BYOKProviderInfo } from '../types/byok.js';
 /** Init config passed to the initialize control request. */
 type InitConfig = {
@@ -50,10 +51,14 @@ type InitConfig = {
     skills?: string[];
     promptSuggestions?: boolean;
     enableFileCheckpointing?: boolean;
+    memory?: SerializableMemoryConfig;
+    customContext?: Record<string, string>;
 };
 export declare class QueryRunner implements InternalQuery {
+    private static readonly CUSTOM_CONTEXT_CAPABILITY;
     private static readonly INITIALIZE_TIMEOUT_MS;
     private static readonly BACKGROUND_TASKS_CAPABILITY;
+    private static readonly SIDE_QUESTION_CAPABILITY;
     private readonly transport;
     private readonly inputStream;
     private readonly pendingRequests;
@@ -78,6 +83,7 @@ export declare class QueryRunner implements InternalQuery {
     private readonly resolveModel?;
     private readonly resolveModelTimeoutMs;
     private readonly transcriptMirrorBatcher?;
+    private readonly memoryCallbacks?;
     private initResponse?;
     private initializationPromise?;
     private resultMessage?;
@@ -86,9 +92,13 @@ export declare class QueryRunner implements InternalQuery {
     private authExpiredFired;
     private protocolHandshakeValidated;
     private cliCapabilities?;
+    private customContextCapabilityWarningEmitted;
     private firstResultReceived;
     private firstResultReceivedResolve?;
-    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);
+    private memoryFlushPromise?;
+    private memoryEndInputPromise?;
+    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);
     private getRecord;
     private normalizeLogPreview;
     private extractMessagePreview;
@@ -111,6 +121,9 @@ export declare class QueryRunner implements InternalQuery {
      */
     private readMessages;
     private notifyAuthExpiredIfNeeded;
+    private dispatchMemoryCallbacks;
+    private flushMemoryBeforeEndInput;
+    private performFlushMemoryBeforeEndInput;
     /**
      * Send a control request to the CLI and wait for the response.
      *
@@ -225,6 +238,7 @@ export declare class QueryRunner implements InternalQuery {
     generateSessionTitle(description: string, options?: {
         persist?: boolean;
     }): Promise<SDKControlGenerateSessionTitleResponse['title']>;
+    askSideQuestion(question: string, options?: AskSideQuestionOptions): Promise<SideQuestionResult | null>;
     /**
      * Add directories to the running session workspace.
      */
@@ -306,6 +320,10 @@ export declare class QueryRunner implements InternalQuery {
      * Seed read state for a file.
      */
     seedReadState(path: string, mtime: number): Promise<void>;
+    flushMemory(): Promise<void>;
+    private performMemoryFlush;
+    refreshMemory(): Promise<void>;
+    private requireSdkMemoryEnabled;
     /**
      * Reconnect an MCP server.
      */
@@ -366,6 +384,7 @@ export declare class QueryRunner implements InternalQuery {
      * consumer queue that no more messages will arrive.
      */
     close(): Promise<void>;
+    private performClose;
     /**
      * Async dispose support.
      *

package/dist/runtime-manifest.json

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

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, 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, SDKControlMcpStatusResponse, SDKControlMcpSetServersResponse, SDKKeepAliveMessage, StdoutMessage, ControlMcpServerConfig, BYOKModelValidationInput, } 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';
 /** Wire format for fetch_job_token inbound control request from CLI. */
 export type FetchJobTokenWireRequest = {
     subtype: 'fetch_job_token';

package/dist/types/index.d.ts

@@ -4,12 +4,13 @@
  */
 export * from './common.js';
 export * from './messages.js';
+export * from './memory.js';
 export type { DefaultRuntimeTransport } from '../core/default-runtime.js';
 export type { QueryTransportCreateOptions, QueryTransportProviderOption, } from '../core/query-transport.js';
 export type { ProcessTransportOptions } from '../core/process-transport.js';
 export type { WorkerRuntimeTransportOptions, WorkerTransportOptions, } from '../core/worker-transport.js';
 export type { QueryTransportProvider, Transport, } from '../core/transport.js';
-export type { ElicitationRequest, ElicitationResult, OnElicitation, PromptRequestOption, PromptRequest, PromptResponse, Options, QueryTransportOptions, SpawnOptions, SpawnedProcess, Query, } from './options.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 * from './mcp.js';

package/dist/types/memory.d.ts

@@ -0,0 +1,59 @@
+import type { MemoryConsumptionFile, MemoryConsumptionResult, MemoryGenerationGateInput, MemoryGenerationGateResult, MemoryGenerationResult, MemoryRoot } from '../protocol/memory.js';
+export type { EffectiveMemoryConfig, MemoryConsumptionFile, MemoryConsumptionResult, MemoryGenerationGateInput, MemoryGenerationGateResult, MemoryGenerationResult, MemoryGenerationFailedFile, MemoryMode, MemoryRoot, MemoryRootAccess, SerializableMemoryConfig, SerializableMemoryConsumptionOptions, SerializableMemoryGenerationOptions, } from '../protocol/memory.js';
+/** Product-side decision invoked before TurnComplete memory generation starts. */
+export type MemoryShouldGenerate = (input: MemoryGenerationGateInput, options: {
+    signal: AbortSignal;
+}) => Promise<MemoryGenerationGateResult>;
+export type MemoryGenerationOptions = {
+    /** Enables automatic and active memory generation. Defaults to true. */
+    enabled?: boolean;
+    /** Memory directories available to the main agent and background memory agent. CLI defaults are used when omitted. */
+    roots?: MemoryRoot[];
+    /** Generation instructions. The CLI-owned default prompt is used when omitted. */
+    prompt?: string;
+    /** Controls generation started from the real CLI TurnComplete event. */
+    turnComplete?: {
+        /** Defaults to true when generation is enabled. */
+        enabled?: boolean;
+        /** Product-side gate called before the background memory agent starts. Omit to use only CLI built-in guards. */
+        shouldGenerate?: MemoryShouldGenerate;
+        /** Maximum time allowed for shouldGenerate. The CLI default is 10 seconds. */
+        timeoutMs?: number;
+        /** Whether callback errors/timeouts produce a skipped or failed generation result. Defaults to "skip". */
+        onGateError?: 'skip' | 'report_failed';
+    };
+    /** Called for every completed generation attempt, including saved, partial, no-change, skipped, and failed outcomes. */
+    onResult?: (result: MemoryGenerationResult) => void | Promise<void>;
+};
+export type MemoryConsumptionOptions = {
+    /** Enables memory consumption. Defaults to true. */
+    enabled?: boolean;
+    /** Explicit files to inject in array order. They replace CLI native auto-memory; static instructions remain. CLI native auto-memory is used when omitted. */
+    files?: MemoryConsumptionFile[];
+    /** Shared token budget for all explicit files. Omit for no explicit SDK budget. */
+    maxTokens?: number;
+    /** Behavior when explicit file content exceeds maxTokens. Defaults to "truncate". */
+    overflow?: 'truncate' | 'fail_query';
+    /** Read-failure behavior. Only required files fail the query in "fail_query" mode. Defaults to "best_effort". */
+    failureMode?: 'best_effort' | 'fail_query';
+    /** Receives per-file load status after initialization and explicit refreshes. */
+    onResult?: (result: MemoryConsumptionResult) => void | Promise<void>;
+};
+export type MemoryOptions = {
+    /** Uses CLI-native generation and consumption. Only result callbacks may be supplied. */
+    mode: 'native';
+    generation?: Pick<MemoryGenerationOptions, 'onResult'>;
+    consumption?: Pick<MemoryConsumptionOptions, 'onResult'>;
+} | {
+    /** Applies supplied overrides and inherits omitted behavior from the CLI. */
+    mode: 'custom';
+    /** Memory generation overrides. Omit to use CLI generation defaults. */
+    generation?: MemoryGenerationOptions;
+    /** Memory consumption overrides. Omit to use CLI consumption defaults. */
+    consumption?: MemoryConsumptionOptions;
+};
+export type MemoryRuntimeCallbacks = {
+    shouldGenerateCallbacks: ReadonlyMap<string, MemoryShouldGenerate>;
+    onGenerationResult?: MemoryGenerationOptions['onResult'];
+    onConsumptionResult?: MemoryConsumptionOptions['onResult'];
+};

package/dist/types/messages.d.ts

@@ -9,11 +9,12 @@ 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, SDKResultSuccess, SDKResultError, SDKResultMessage, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKAPIRetryMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKTaskUpdatedMessage, SDKBackgroundTasksChangedMessage, SDKSessionStateChangedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKPermissionDenial, SDKToolNonExecutionKind, SDKToolResultMeta, } from '../protocol/index.js';
+export type { SDKAssistantMessage, SDKResultSuccess, SDKResultError, SDKResultMessage, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKAPIRetryMessage, SDKModelQueueStatusMessage, SDKControlRequestProgressMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKTaskUpdatedMessage, SDKBackgroundTasksChangedMessage, SDKSessionStateChangedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKMemoryGenerationMessage, SDKMemoryConsumptionMessage, SDKPermissionDenial, 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;
     tool_use_result?: unknown;
     /** CLI-stamped display metadata for tool results that did not execute. */