@qoder-ai/qoder-agent-sdk 1.0.35 → 1.0.36

package/dist/protocol/control.d.ts

@@ -14,7 +14,7 @@
 import type { JSONRPCMessage } from '@modelcontextprotocol/sdk/types.js';
 import type { HookEvent, HookInput } from './hooks.js';
 import type { McpServerStatus, McpSetServersResult, McpServerConfigForCliTransport, McpToolRuntimeOverride, OAuthToken } from './mcp.js';
-import type { PermissionMode, PermissionUpdate } from './permissions.js';
+import type { CanUseToolPermissionDetails, CanUseToolPermissionKind, CanUseToolPermissionOption, PermissionMode, PermissionUpdate } from './permissions.js';
 import type { SDKMessage } from './messages.js';
 import type { AgentDefinition, AgentInfo } from './agents.js';
 import type { AccountInfo, FastModeState, ModelInfo, SessionCreditsUsage, SlashCommand, SdkPluginConfig, UsageInfo } from './common.js';
@@ -52,12 +52,6 @@ export type SDKControlCancelRequest = {
     request_id: string;
     session_id?: string;
 };
-export type DaemonEventMessage = {
-    type: 'event';
-    event: string;
-    session_id?: string;
-    data: Record<string, unknown>;
-};
 export type SDKControlInterruptRequest = {
     type: 'interrupt';
     /**
@@ -93,6 +87,9 @@ export type SDKControlPermissionRequest = {
     description?: string;
     tool_use_id: string;
     agent_id?: string;
+    permission_kind?: CanUseToolPermissionKind;
+    options?: CanUseToolPermissionOption[];
+    details?: CanUseToolPermissionDetails;
 };
 /**
  * Wire form of MCP server config sent by SDK in `initialize` and
@@ -131,6 +128,8 @@ export type SDKControlInitializeRequest = {
     supportsAvailableModelsUpdate?: boolean;
     /** Opts this Host into authoritative command snapshots on the Query stream. */
     supportsCommandsChanged?: boolean;
+    /** Announces a Query-scoped App Artifact resolver to a shared-daemon Worker. */
+    resolveSessionArtifacts?: boolean;
     initializeTimeoutMs?: number;
     agentProgressSummaries?: boolean;
     memory?: SerializableMemoryConfig;
@@ -148,6 +147,11 @@ export type SDKControlInitializeRequest = {
      */
     scene?: string;
 };
+export type SDKControlResolveSessionArtifactsRequest = {
+    subtype: 'resolve_session_artifacts';
+    local_session_id: string;
+    cwd: string;
+};
 export type SDKControlMemoryShouldGenerateRequest = {
     type: 'memory_should_generate';
     callbackId: string;
@@ -445,6 +449,18 @@ export type SDKControlChannelEnableRequest = {
     channel: string;
     enabled: boolean;
 };
+/** Enable Remote Control event projection for this worker session. */
+export type SDKControlEnableRemoteProjectionRequest = {
+    type: 'enable_remote_projection';
+    remote_session_id: string;
+    suppress_initial_idle_state_events?: boolean;
+    skip_initial_flush?: boolean;
+    from_sequence_num?: number;
+};
+/** Disable Remote Control event projection for this worker session. */
+export type SDKControlDisableRemoteProjectionRequest = {
+    type: 'disable_remote_projection';
+};
 /**
  * SDK requests the CLI's BYOK (Bring Your Own Key) configuration.
  * The CLI responds with the server-side provider/model catalog.
@@ -642,12 +658,19 @@ export type SDKControlCheckByokConfigRequest = {
     config: CheckByokConfigInput;
 };
 export type SDKControlCheckByokConfigResponse = ByokConfigCheckResult;
+/** 服务端下发的双语名称，由宿主按界面语言选择；空字符串表示该语言未提供名称。 */
+export type BYOKLocalizedName = {
+    en_us: string;
+    cn_zh: string;
+};
 /** A third-party LLM provider in the BYOK catalog. */
 export type BYOKProviderInfo = {
     /** Provider identifier, e.g. "openai", "deepseek" */
     key: string;
-    /** Display name (may be localized object or plain string) */
+    /** 兼容旧宿主的显示名称，保持 CLI 既有的英文优先回退规则。 */
     display_name: string;
+    /** 可选双语名称；旧版 CLI 或服务端仅提供字符串时缺省。 */
+    display_name_i18n?: BYOKLocalizedName;
     /** Server-defined provider origin metadata, e.g. "custom". */
     source?: string;
     /** URL where the user can obtain an API key */
@@ -663,6 +686,8 @@ export type BYOKProviderInfo = {
 export type BYOKFieldInfo = {
     key: string;
     display_name: string;
+    /** 服务端提供的双语字段名称，由宿主选择展示语言。 */
+    display_name_i18n?: BYOKLocalizedName;
     type: string;
     /** Whether the user must fill this field. */
     mandatory?: boolean;
@@ -672,6 +697,8 @@ export type BYOKModelTypeInfo = {
     /** Group identifier, e.g. "cp" (coding plan), "tp" (token plan), "pg" (pay-as-you-go). */
     key?: string;
     display_name: string;
+    /** 服务端提供的双语分组名称，由宿主选择展示语言。 */
+    display_name_i18n?: BYOKLocalizedName;
     models: BYOKModelInfo[];
 };
 /** A specific model offered by a BYOK provider. */
@@ -827,7 +854,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 | 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 SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlResolveSessionArtifactsRequest | 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 | SDKControlEnableRemoteProjectionRequest | SDKControlDisableRemoteProjectionRequest | 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[];

package/dist/protocol/index.d.ts

@@ -19,10 +19,10 @@ export type { AICodeTrackingLaunchOptions, QoderAgentLaunchOptions, QoderCliFlag
 export { buildQoderCliFlagSettings, buildQoderCliFlagSettingsArgs, } from './launch.js';
 export type { EffectiveMemoryConfig, MemoryConsumptionFile, MemoryConsumptionResult, MemoryGenerationFailedFile, MemoryGenerationGateInput, MemoryGenerationGateResult, MemoryGenerationResult, MemoryMode, MemoryRoot, MemoryRootAccess, SerializableMemoryConfig, SerializableMemoryConsumptionOptions, SerializableMemoryGenerationOptions, } from './memory.js';
 export type { EffectiveEvolutionConfig, EffectiveSkillEvolutionConfig, SerializableEvolutionConfig, SerializableSkillEvolutionConfig, SerializableSkillEvolutionGenerationOptions, SkillEvolutionGateInput, SkillEvolutionGateResult, SkillEvolutionMode, SkillEvolutionResult, SkillEvolutionSuggestion, } from './skill-evolution.js';
-export type { PermissionMode, PermissionBehavior, PermissionDecisionClassification, PermissionUpdateDestination, PermissionRuleValue, PermissionUpdate, PermissionResult, } from './permissions.js';
+export type { PermissionMode, PermissionBehavior, PermissionScope, CanUseToolPermissionKind, CanUseToolPermissionOption, CanUseToolPermissionDetails, 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, 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, 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';
+export type { SDKControlRequest, SDKControlResponse, SDKControlCancelRequest, SDKControlInterruptRequest, SDKControlInterruptResponse, SDKControlPermissionRequest, SDKControlInitializeRequest, SDKControlResolveSessionArtifactsRequest, 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, SDKControlEnableRemoteProjectionRequest, SDKControlDisableRemoteProjectionRequest, 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, BYOKLocalizedName, 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/messages.d.ts

@@ -529,6 +529,10 @@ export type SDKArtifactInfo = {
     path: string;
     display_path: string;
     name: string;
+    group?: {
+        key: string;
+        name: string;
+    };
     relative_path?: string;
     size?: number;
     mime?: string;

package/dist/protocol/permissions.d.ts

@@ -11,6 +11,23 @@
  */
 export type PermissionMode = 'default' | 'acceptEdits' | 'bypassPermissions' | 'yolo' | 'plan' | 'dontAsk' | 'auto';
 export type PermissionBehavior = 'allow' | 'deny' | 'ask';
+export type PermissionScope = 'once' | 'session' | 'persist';
+export type CanUseToolPermissionKind = 'repeated_tool_call';
+export type CanUseToolPermissionOption = {
+    outcome: 'proceed_once' | 'proceed_always' | 'proceed_always_and_save' | 'cancel';
+    name: string;
+    allowed: boolean;
+};
+export type CanUseToolPermissionDetails = {
+    type: 'repeated_tool_call';
+    title: string;
+    toolName: string;
+    repeatCount: number;
+    threshold: number;
+    inputPreview: string;
+} | (Record<string, unknown> & {
+    type: string;
+});
 export type PermissionDecisionClassification = 'user_temporary' | 'user_permanent' | 'user_reject';
 export type PermissionUpdateDestination = 'userSettings' | 'projectSettings' | 'localSettings' | 'session' | 'cliArg';
 export type PermissionRuleValue = {
@@ -47,6 +64,7 @@ export type PermissionUpdate = {
 };
 export type PermissionResult = {
     behavior: 'allow';
+    permissionScope?: PermissionScope;
     updatedInput?: Record<string, unknown>;
     updatedPermissions?: PermissionUpdate[];
     toolUseID?: string;

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

@@ -20,11 +20,11 @@
  *
  * 3. Implements all Query interface methods for the consumer.
  */
-import type { DiagnosticsSink } from '../core/sdk-diagnostics.js';
+import { type DiagnosticsSink } from '../core/sdk-diagnostics.js';
 import type { ModelPromptPatches } from '../protocol/model-prompt-patches.js';
 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 { InternalQuery, OnElicitation, RemoteProjectionCheckpoint, RemoteProjectionEnableOptions } 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, SDKControlReloadSkillsResponse } from '../types/control.js';
 import type { PermissionMode, CanUseTool } from '../types/permissions.js';
@@ -42,6 +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 { ResolveSessionArtifacts } from '../types/artifacts.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 = {
@@ -61,8 +62,13 @@ type InitConfig = {
     independentPlanModeControls?: boolean;
     /** Initial shared-daemon Permission, applied as part of initialize. */
     permissionMode?: PermissionMode;
-    /** Use the daemon subscribe result instead of issuing Query initialize. */
-    attachedInitialization?: Promise<SDKControlInitializeResponse>;
+    /** Resolves transport-specific initialization settings before initialize. */
+    beforeInitialize?: () => Promise<void>;
+    /**
+     * 远端创建的会话：不向 worker 发 initialize 控制帧，
+     * 初始化结果从流中的 init 帧解析（daemon 侧负责驱动 worker 初始化）。
+     */
+    resolveInitializationFromStream?: boolean;
     /** Resolve initialization only after the Fork transcript is durable. */
     requireSessionStoreForkBarrier?: boolean;
 };
@@ -74,8 +80,9 @@ export declare class QueryRunner implements InternalQuery {
     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 static readonly BYOK_CONFIG_MANAGEMENT_CAPABILITY;
+    private static readonly REMOTE_PROJECTION_REQUEST_ID_PREFIX;
     private readonly transport;
     private readonly inputStream;
     private readonly pendingRequests;
@@ -102,6 +109,8 @@ export declare class QueryRunner implements InternalQuery {
     private readonly transcriptMirrorBatcher?;
     private readonly memoryCallbacks?;
     private readonly skillEvolutionCallbacks?;
+    private readonly resolveSessionArtifacts?;
+    private resolveStreamInitialization;
     private initResponse?;
     private latestCommands;
     private initializationPromise?;
@@ -125,7 +134,7 @@ export declare class QueryRunner implements InternalQuery {
     private skillEvolutionFlushPromise?;
     private closePromise?;
     private sessionStoreForkBarrierComplete;
-    constructor(transport: Transport, isSingleTurn: boolean, canUseTool?: CanUseTool, hooks?: Partial<Record<InternalHookEvent, HookCallbackMatcher[]>>, abortController?: AbortController, sdkMcpServers?: Map<string, McpServer>, initConfig?: InitConfig, onElicitation?: OnElicitation, diagnostics?: DiagnosticsSink, onAuthExpired?: () => void, controlRequestTimeoutMs?: number, sdkMcpTransports?: Map<string, SdkMcpTransport>, pendingMcpResponses?: Map<string, PendingMcpResponse>, fetchJobToken?: FetchJobToken, resolveModel?: ModelPolicyProvider, resolveModelTimeoutMs?: number, sessionStore?: SessionStore, sessionStoreFlush?: SessionStoreFlush, sdkMcpToolOverrides?: Record<string, Record<string, McpToolRuntimeOverride>>, fetchServiceAccountToken?: FetchServiceAccountToken, memoryCallbacks?: MemoryRuntimeCallbacks, skillEvolutionCallbacks?: SkillEvolutionRuntimeCallbacks);
+    constructor(transport: Transport, isSingleTurn: boolean, canUseTool?: CanUseTool, hooks?: Partial<Record<InternalHookEvent, HookCallbackMatcher[]>>, abortController?: AbortController, sdkMcpServers?: Map<string, McpServer>, initConfig?: InitConfig, onElicitation?: OnElicitation, diagnostics?: DiagnosticsSink, onAuthExpired?: () => void, controlRequestTimeoutMs?: number, sdkMcpTransports?: Map<string, SdkMcpTransport>, pendingMcpResponses?: Map<string, PendingMcpResponse>, fetchJobToken?: FetchJobToken, resolveModel?: ModelPolicyProvider, resolveModelTimeoutMs?: number, sessionStore?: SessionStore, sessionStoreFlush?: SessionStoreFlush, sdkMcpToolOverrides?: Record<string, Record<string, McpToolRuntimeOverride>>, fetchServiceAccountToken?: FetchServiceAccountToken, memoryCallbacks?: MemoryRuntimeCallbacks, skillEvolutionCallbacks?: SkillEvolutionRuntimeCallbacks, resolveSessionArtifacts?: ResolveSessionArtifacts);
     private getRecord;
     private normalizeLogPreview;
     private extractMessagePreview;
@@ -234,6 +243,8 @@ export declare class QueryRunner implements InternalQuery {
     initializationResult(): Promise<SDKControlInitializeResponse>;
     private replaceLatestCommands;
     private getLatestCommands;
+    /** 远端创建的会话：等流中的 init 帧，不向 worker 发 initialize。 */
+    private waitForStreamInitialization;
     /**
      * Stream user messages into the session.
      *
@@ -267,10 +278,6 @@ 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>;
@@ -281,8 +288,6 @@ 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.
      */
@@ -292,6 +297,12 @@ export declare class QueryRunner implements InternalQuery {
      * Set the model.
      */
     setModel(model?: string): Promise<void>;
+    /** 启用当前 worker 会话的 Remote Control 事件投影。 */
+    enableRemoteProjection(remoteSessionId: string, options?: RemoteProjectionEnableOptions): Promise<void>;
+    /** 关闭当前 worker 会话的 Remote Control 事件投影。 */
+    disableRemoteProjection(options?: {
+        timeoutMs?: number;
+    }): Promise<RemoteProjectionCheckpoint | undefined>;
     setProxy(proxy?: string | null): Promise<void>;
     /**
      * Generate a concise display title for the current session.
@@ -368,7 +379,6 @@ 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[]>;
     /**
@@ -467,10 +477,4 @@ export declare class QueryRunner implements InternalQuery {
      */
     [Symbol.asyncDispose](): Promise<void>;
 }
-export declare function createAttachedQueryRunner(options: {
-    transport: Transport;
-    initialization: Promise<SDKControlInitializeResponse>;
-    canUseTool?: CanUseTool;
-    onElicitation?: OnElicitation;
-}): InternalQuery;
 export {};

package/dist/runtime-manifest.json

@@ -1,7 +1,7 @@
 {
   "version": 1,
   "brand": "global",
-  "sdkVersion": "1.0.35",
+  "sdkVersion": "1.0.36",
   "qoderCliVersion": "1.1.46",
   "defaultTransport": "worker",
   "workerRuntime": {
@@ -10,7 +10,7 @@
     "source": "qodercli-worker-runtime",
     "urlTemplate": "https://download.qoder.com/qodercli/releases/1.1.46/qodercli-worker-runtime-{target}.tgz",
     "artifactNameTemplate": "qodercli-worker-runtime-{target}.tgz",
-    "sdkVersion": "1.0.35",
+    "sdkVersion": "1.0.36",
     "qoderCliVersion": "1.1.46"
   }
 }

package/dist/types/artifacts.d.ts

@@ -0,0 +1,31 @@
+export interface ArtifactGroup {
+    key: string;
+    name: string;
+}
+export interface SessionArtifactBase {
+    path: string;
+    displayPath: string;
+    name: string;
+    group?: ArtifactGroup;
+    relativePath?: string;
+    size?: number;
+    mime?: string;
+    mtime?: number;
+}
+export type SessionArtifact = SessionArtifactBase & ({
+    kind: 'presented';
+} | {
+    kind: 'changed';
+    additions: number;
+    deletions: number;
+    isNew: boolean;
+});
+export interface ResolveSessionArtifactsResult {
+    artifacts: readonly SessionArtifact[];
+}
+/**
+ * Returns the App-owned cumulative Artifact snapshot for a daemon-backed
+ * Session. A successful result replaces the CLI snapshot; an empty array
+ * clears it. Throwing or rejecting leaves the CLI snapshot in effect.
+ */
+export type ResolveSessionArtifacts = (localSessionId: string, cwd: string) => ResolveSessionArtifactsResult | Promise<ResolveSessionArtifactsResult>;

package/dist/types/byok.d.ts

@@ -10,4 +10,4 @@
  * module — defining it once on the protocol avoids snake/camel drift across
  * SDK and CLI.
  */
-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';
+export type { SDKControlGetByokConfigRequest, SDKControlGetByokConfigResponse, SDKControlValidateByokModelRequest, SDKControlValidateByokModelResponse, SDKControlListByokConfigsRequest, SDKControlListByokConfigsResponse, SDKControlCreateByokConfigRequest, SDKControlCreateByokConfigResponse, SDKControlUpdateByokConfigRequest, SDKControlDeleteByokConfigRequest, SDKControlCheckByokConfigRequest, SDKControlCheckByokConfigResponse, BYOKModelValidationInput, CustomModel, BYOKLocalizedName, 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, 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';
+export type { SDKControlRequest, SDKControlResponse, SDKControlCancelRequest, SDKControlInterruptRequest, SDKControlInterruptResponse, SDKControlPermissionRequest, SDKControlInitializeRequest, SDKControlResolveSessionArtifactsRequest, 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, SDKControlEnableRemoteProjectionRequest, SDKControlDisableRemoteProjectionRequest, 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/index.d.ts

@@ -5,6 +5,7 @@
 export * from './common.js';
 export * from './messages.js';
 export * from './memory.js';
+export * from './artifacts.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';

package/dist/types/options.d.ts

@@ -21,7 +21,7 @@ import type { MemoryOptions } from './memory.js';
 import type { EvolutionOptions } from './skill-evolution.js';
 import type { SDKGoalSnapshot, SDKGoalStatus, SDKPlanModeSnapshot } from '../protocol/control.js';
 import type { Daemon } from '../daemon/start-daemon.js';
-import type { SessionExtra } from '../daemon/session-metadata.js';
+import type { ResolveSessionArtifacts } from './artifacts.js';
 export type { CanUseTool };
 export type { AuthOptions };
 export type ElicitationRequest = {
@@ -70,10 +70,14 @@ export type Options = {
      * `abort()` closes the session and ends message iteration.
      */
     abortController?: AbortController;
-    /** Route this Query through a shared local daemon started by startDaemon(). */
+    /** Route this Query through a caller-provided daemon instance. */
     daemon?: Daemon;
-    /** Opaque, JSON-safe metadata attached to this daemon-backed Session. */
-    extra?: SessionExtra;
+    /**
+     * Resolve the App-owned cumulative Artifact snapshot for this daemon-backed
+     * Query. A successful result replaces the CLI snapshot; a rejected callback
+     * falls back to the CLI snapshot.
+     */
+    resolveSessionArtifacts?: ResolveSessionArtifacts;
     /**
      * Authentication configuration for the qodercli child process.
      *
@@ -94,7 +98,8 @@ export type Options = {
      *   integration. Prefer the `jobToken(fetchJobToken)` helper in host code.
      *
      * Required for direct `query()` sessions. A Query using `options.daemon`
-     * reuses the authentication bound by `startDaemon()` and must omit this field.
+     * inherits authentication configured when the daemon was started and must
+     * omit this field.
      */
     auth?: InternalAuthOptions;
     additionalDirectories?: string[];
@@ -369,6 +374,18 @@ export interface SpawnedProcess {
     off(event: 'exit', listener: (code: number | null, signal: NodeJS.Signals | null) => void): void;
     off(event: 'error', listener: (error: Error) => void): void;
 }
+/** 控制 worker 级远程事件投影的启用选项。 */
+export interface RemoteProjectionEnableOptions {
+    suppressInitialIdleStateEvents?: boolean;
+    skipInitialFlush?: boolean;
+    fromSequenceNum?: number;
+    timeoutMs?: number;
+}
+/** 关闭远程事件投影时返回的可恢复游标。 */
+export interface RemoteProjectionCheckpoint {
+    remoteSessionId: string;
+    lastSequenceNum: number;
+}
 /**
  * Query 公开接口。
  *
@@ -446,6 +463,16 @@ export interface Query extends AsyncGenerator<SDKMessage, void> {
     getPlanMode?(): Promise<SDKPlanModeSnapshot>;
     setPermissionMode(mode: PermissionMode): Promise<void>;
     setModel(model?: string): Promise<void>;
+    /**
+     * 启用该会话的远程事件投影。仅支持广告此控制能力的本地 CLI transport。
+     */
+    enableRemoteProjection?(remoteSessionId: string, options?: RemoteProjectionEnableOptions): Promise<void>;
+    /**
+     * 关闭该会话的远程事件投影，并返回可用于恢复投影的游标（若 worker 提供）。
+     */
+    disableRemoteProjection?(options?: {
+        timeoutMs?: number;
+    }): Promise<RemoteProjectionCheckpoint | undefined>;
     /**
      * Set or clear the proxy for the running qodercli session.
      *

package/dist/types/permissions.d.ts

@@ -5,8 +5,8 @@
  * `../protocol/`. This file adds SDK-local types — the `CanUseTool`
  * callback shape — which never crosses the JSONL boundary.
  */
-export type { PermissionBehavior, PermissionDecisionClassification, PermissionUpdateDestination, PermissionRuleValue, } from '../protocol/index.js';
-import type { PermissionBehavior, PermissionDecisionClassification, PermissionUpdateDestination, PermissionRuleValue } from '../protocol/index.js';
+export type { PermissionBehavior, PermissionScope, CanUseToolPermissionKind, CanUseToolPermissionOption, CanUseToolPermissionDetails, PermissionDecisionClassification, PermissionUpdateDestination, PermissionRuleValue, } from '../protocol/index.js';
+import type { PermissionBehavior, PermissionScope, CanUseToolPermissionKind, CanUseToolPermissionOption, CanUseToolPermissionDetails, PermissionDecisionClassification, PermissionUpdateDestination, PermissionRuleValue } from '../protocol/index.js';
 /**
  * Permission mode for controlling how tool executions are handled.
  */
@@ -41,6 +41,7 @@ export type PermissionUpdate = {
 };
 export type PermissionResult = {
     behavior: 'allow';
+    permissionScope?: PermissionScope;
     updatedInput?: Record<string, unknown>;
     updatedPermissions?: PermissionUpdate[];
     toolUseID?: string;
@@ -62,5 +63,8 @@ export type CanUseToolOptions = {
     description?: string;
     toolUseID: string;
     agentID?: string;
+    permissionKind?: CanUseToolPermissionKind;
+    permissionOptions?: CanUseToolPermissionOption[];
+    details?: CanUseToolPermissionDetails;
 };
 export type CanUseTool = (toolName: string, input: Record<string, unknown>, options: CanUseToolOptions) => Promise<PermissionResult>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qoder-ai/qoder-agent-sdk",
-  "version": "1.0.35",
+  "version": "1.0.36",
   "description": "TypeScript SDK for building Qoder-powered coding agents.",
   "type": "module",
   "main": "dist/index.js",

package/dist/daemon/remote-session-launch-rpc.d.ts

@@ -1,3 +0,0 @@
-import { type DaemonRequestHandler } from './daemon-connection.js';
-import { type ResolveRemoteSessionLaunch } from './session-metadata.js';
-export declare function createRemoteSessionLaunchRequestHandler(resolveLaunch: ResolveRemoteSessionLaunch, callbackTimeoutMs?: number): DaemonRequestHandler;

package/dist/daemon/session-metadata.d.ts

@@ -1,19 +0,0 @@
-export type SessionExtraValue = string | number | boolean | null | readonly SessionExtraValue[] | {
-    readonly [key: string]: SessionExtraValue;
-};
-/** Opaque, JSON-safe metadata owned by the Host application. */
-export type SessionExtra = Readonly<Record<string, SessionExtraValue>>;
-/** Replaces the complete metadata snapshot for one Session. */
-export interface SessionMetadataUpdate {
-    extra: SessionExtra;
-}
-export interface RemoteSessionLaunchRequest {
-    remoteSessionId: string;
-    extra?: SessionExtra;
-}
-export interface RemoteSessionLaunch {
-    cwd: string;
-    additionalDirectories?: readonly string[];
-}
-export type ResolveRemoteSessionLaunch = (request: RemoteSessionLaunchRequest) => Promise<RemoteSessionLaunch>;
-export declare function normalizeSessionExtra(value: SessionExtra, path?: string): SessionExtra;

package/dist/daemon/session-registration-store.d.ts

@@ -1,10 +0,0 @@
-import type { DaemonSessionStore } from "./session-store-rpc.js";
-export interface SessionRegistrationStore {
-    readonly store: DaemonSessionStore;
-    flush(): Promise<void>;
-    dispose(): void;
-}
-export declare function createSessionRegistrationStore(store: DaemonSessionStore, options: {
-    sync: (localSessionIds: string[]) => Promise<void>;
-    retryDelaysMs?: readonly number[];
-}): SessionRegistrationStore;

package/dist/daemon/session-store-rpc.d.ts

@@ -1,45 +0,0 @@
-import type { SessionKey, SessionStore, SessionStoreEntry } from "../session/session-store.js";
-import { DaemonRequestError, type DaemonRequestHandler } from "./daemon-connection.js";
-import type { JsonObject } from "./protocol.js";
-import { type SessionExtra, type SessionMetadataUpdate } from "./session-metadata.js";
-export declare const DEFAULT_SESSION_STORE_MAX_PAYLOAD_BYTES: number;
-export interface DaemonSessionStore extends SessionStore {
-    listAllSessions(): Promise<readonly DaemonSessionSummary[]>;
-    /**
-     * Persists a complete replacement of one Session's metadata. Implementations
-     * must use upsert semantics: the daemon may call this before the first
-     * transcript entry exists, and listAllSessions() must later return the same
-     * extra snapshot.
-     */
-    updateSessionMetadata?(key: Omit<SessionKey, "subpath">, update: SessionMetadataUpdate): Promise<void>;
-}
-export interface DaemonSessionSummary {
-    key: SessionKey;
-    title: string;
-    lastActiveAt: string;
-    cwd: string;
-    extra?: SessionExtra;
-}
-export interface DaemonSessionStoreRpcOptions {
-    callbackTimeoutMs?: number;
-    maxEntriesPerPage?: number;
-    maxPayloadBytes?: number;
-}
-/**
- * Returns the UTF-8 wire size of one SessionStore entry when transported as a
- * single-item page or append batch, including the surrounding array brackets.
- */
-export declare function measureSessionStoreEntryPayloadBytes(entry: SessionStoreEntry): number;
-export type DaemonSessionStoreRequestHandler = DaemonRequestHandler & {
-    dispose(): Promise<void>;
-};
-export declare class DaemonSessionStoreRpcError extends DaemonRequestError {
-    constructor(options: {
-        code: string;
-        message: string;
-        retryable?: boolean;
-        operation?: string;
-        details?: JsonObject;
-    });
-}
-export declare function createDaemonSessionStoreRequestHandler(store: DaemonSessionStore, options?: DaemonSessionStoreRpcOptions): DaemonSessionStoreRequestHandler;