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

package/README.md

@@ -457,27 +457,46 @@ supports the built-in Process and Worker transports. Use
 `importSessionToStore(sessionId, store, options)` to copy an existing local main
 transcript, child-agent transcripts, and metadata into a store.
 
-For a shared daemon, implement `DaemonSessionStore`, which adds
-`listAllSessions()`, and bind it once at daemon startup:
+A Query can replace the CLI Artifact snapshot with an App-owned cumulative
+snapshot. Configure the callback on that Query:
 
 ```ts
-const daemon = await startDaemon({
-  auth: qodercliAuth(),
-  capacity: 4,
-  sessionStore,
+import { join } from "node:path";
+import {
+  qodercliAuth,
+  query,
+  type ResolveSessionArtifacts,
+} from "@qoder-ai/qoder-agent-sdk";
+
+const resolveSessionArtifacts: ResolveSessionArtifacts = async (
+  localSessionId,
+  cwd,
+) => ({
+  artifacts: [
+    {
+      path: join(cwd, "outputs/report.pdf"),
+      displayPath: "outputs/report.pdf",
+      name: "report.pdf",
+      kind: "presented",
+      group: { key: "outputs", name: "Outputs" },
+      relativePath: "report.pdf",
+    },
+  ],
 });
 
 const running = query({
-  prompt,
-  options: { daemon, cwd: "/path/to/project" },
+  prompt: "Create a report.",
+  options: {
+    auth: qodercliAuth(),
+    cwd: "/path/to/project",
+    resolveSessionArtifacts,
+  },
 });
 ```
 
-`listAllSessions()` returns only main Sessions owned by that Host Store. Each
-summary contains the exact stored `key`, a non-empty title, an ISO timestamp,
-and the canonical working directory. Daemon-bound Queries reuse this one Store
-and cannot override it per Query. Registration sends summaries only; transcript
-entries are loaded lazily when a Worker needs to resume the Session.
+The callback receives the local Session ID and working directory. Return the
+current full snapshot; `artifacts: []` clears it. If the callback is omitted or
+rejects, the CLI snapshot remains in effect.
 
 ### Production stores
 

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

@@ -0,0 +1,2 @@
+import type { ResolveSessionArtifactsResult } from '../types/artifacts.js';
+export declare function normalizeResolveSessionArtifactsResult(value: unknown): ResolveSessionArtifactsResult;

package/dist/core/process-transport.d.ts

@@ -17,7 +17,6 @@ import type { McpServerConfigForProcessTransport, McpServerToolPolicy } from '..
 import type { InternalAuthOptions } from '../types/auth.js';
 import type { SecurityScanOptions, SpawnedProcess, SpawnOptions, SettingSource } from '../types/options.js';
 import type { DiagnosticsSink } from './sdk-diagnostics.js';
-import type { SessionExtra } from '../daemon/session-metadata.js';
 export declare class QoderCliProcessError extends Error {
     readonly code: "QODER_CLI_PROCESS_ERROR";
     readonly exitCode?: number | null;
@@ -74,8 +73,6 @@ export interface ProcessTransportOptions {
     /** SDK-internal diagnostics sink. This is not forwarded to qodercli. */
     diagnostics?: DiagnosticsSink;
     agent?: string;
-    /** SDK-internal Session metadata consumed by the shared daemon. */
-    extra?: SessionExtra;
     sessionId?: string;
     continue?: boolean;
     resume?: string;
@@ -134,11 +131,15 @@ export declare class ProcessTransport implements Transport, QueryTransportProvid
     private options;
     private ready;
     private closed;
+    private shutdownStarted;
     private initializePromise;
     private authExpiredFired;
     private pendingInput;
     private diagnostics?;
     private processExitError;
+    private processStopped;
+    private closeTimer;
+    private killTimer;
     private stderrTail;
     private launchOptionsBuilder;
     constructor(options?: ProcessTransportOptions);
@@ -179,7 +180,11 @@ export declare class ProcessTransport implements Transport, QueryTransportProvid
      * 5. Send SIGKILL if still running
      */
     close(): void;
-    private cleanupGeneratedSettings;
+    /** 回收进程资源，不改变调用方主动关闭状态；异常仍由读取循环传播。 */
+    private shutdownProcess;
+    private hasProcessStopped;
+    private finishProcess;
+    private observeProcess;
     /**
      * Get the underlying process PID, if available.
      */
@@ -201,8 +206,8 @@ export declare class ProcessTransport implements Transport, QueryTransportProvid
      * and is used directly as the command.
      */
     private resolveExecutable;
-    /** Best-effort cleanup of the auth payload file and its parent directory. */
-    private cleanupAuthPayload;
+    /** 清理 runtime 已消费或不再可能消费的启动制品。 */
+    private cleanupLaunchArtifacts;
     /** Fire `onAuthExpired` at most once per session. */
     private fireAuthExpired;
 }

package/dist/core/runtime-launch-options.d.ts

@@ -75,6 +75,12 @@ export declare class RuntimeLaunchOptionsBuilder {
     constructor(options: RuntimeLaunchOptions, diagnostics?: DiagnosticsSink, logPrefix?: string);
     prepare(): Promise<RuntimeLaunchConfig>;
     cleanupGeneratedSettings(): void;
+    /**
+     * 清理仅用于启动 runtime 的临时文件。
+     *
+     * 调用方必须保证 runtime 尚未启动或已经退出。runtime 存活期间清理会与其启动读取形成竞态。
+     */
+    cleanupLaunchArtifacts(): Promise<void>;
     cleanupAuthPayload(): Promise<void>;
     buildEnv(): Record<string, string>;
     private serviceAccountCredentialEnvVars;

package/dist/core/worker-transport.d.ts

@@ -93,6 +93,6 @@ export declare class WorkerRuntimeTransport implements Transport {
     private waitForWorkerExit;
     private clearCloseTimer;
     private cleanupAbortListener;
-    private cleanupAuthPayload;
+    private cleanupLaunchArtifacts;
     private fireAuthExpired;
 }

package/dist/daemon/daemon-auth-rpc.d.ts

@@ -1,9 +1,3 @@
 import type { InternalAuthOptions } from '../types/auth.js';
 import { type DaemonRequestHandler } from './daemon-connection.js';
-export declare function createDaemonAuthRequestHandler(auth: InternalAuthOptions, callbackTimeoutMs?: number): DaemonRequestHandler;
-export declare function createDaemonRequestHandler(options: {
-    auth: InternalAuthOptions;
-    sessionStoreHandler?: DaemonRequestHandler;
-    remoteSessionLaunchHandler?: DaemonRequestHandler;
-    callbackTimeoutMs?: number;
-}): DaemonRequestHandler;
+export declare function createDaemonAuthRequestHandler(auth: InternalAuthOptions, callbackTimeoutMs?: number): DaemonRequestHandler;

package/dist/daemon/daemon-connection.d.ts

@@ -1,5 +1,5 @@
 import type { Readable, Writable } from "node:stream";
-import { type DaemonControlRequestFrame, type DaemonEventFrame, type DaemonWireSessionMessage, type JsonObject, type JsonValue, type EnableRemoteControlParams, type EnableRemoteControlResult, type OpenSessionParams, type RenameSessionResult, type SubscribeSessionResult, type UpdateSessionMetadataResult } from "./protocol.js";
+import { type DaemonControlRequestFrame, type DaemonWireSessionMessage, type JsonObject, type JsonValue, type OpenSessionParams, type RenameSessionResult } from "./protocol.js";
 import { DaemonSessionTransport, type DaemonSessionTransportOptions } from "./daemon-session-transport.js";
 export declare const SESSION_STORE_FILE_CHECKPOINTING_CAPABILITY = "session_store_file_checkpointing_v1";
 export declare const SESSION_STORE_FORK_BARRIER_CAPABILITY = "session_store_fork_barrier_v1";
@@ -10,10 +10,6 @@ export interface DaemonConnectionOptions {
     maxFrameBytes?: number;
 }
 export type DaemonRequestHandler = (request: DaemonControlRequestFrame) => Promise<JsonValue>;
-export type RemoteControlFailure = {
-    environmentId: string;
-    error: DaemonRpcError;
-};
 export declare class DaemonRpcError extends Error {
     readonly code: string;
     readonly retryable: boolean;
@@ -57,29 +53,18 @@ export declare class DaemonConnection {
     private readonly capabilities;
     private stopping;
     private failure;
-    private remoteControlFailureListener;
-    private readonly daemonEventListeners;
     private readonly failureListeners;
     constructor(options: DaemonConnectionOptions);
     initialize(sdkVersion: string, optionalCapabilitiesOrTimeout?: readonly string[] | number, timeoutMs?: number): Promise<void>;
     createSessionTransport(options: DaemonSessionTransportOptions): DaemonSessionTransport;
     supportsCapability(capability: string): boolean;
-    createAttachedSessionTransport(remoteSessionId: string): DaemonSessionTransport;
-    onRemoteControlFailure(listener: (failure: RemoteControlFailure) => void): void;
-    onDaemonEvent(listener: (event: DaemonEventFrame) => void): () => void;
     onFailure(listener: (error: Error) => void): () => void;
     openSession(params: OpenSessionParams, transport: DaemonSessionTransport): Promise<string>;
-    subscribeSession(remoteSessionId: string, transport: DaemonSessionTransport): Promise<SubscribeSessionResult>;
-    enableRemoteControl(params: EnableRemoteControlParams): Promise<EnableRemoteControlResult>;
     listSessions(): Promise<import("./protocol.js").DaemonSessionInfo[]>;
     renameSession(sessionId: string, title: string): Promise<RenameSessionResult>;
-    disableRemoteControl(): Promise<void>;
-    syncSessionRegistrations(localSessionIds: string[]): Promise<void>;
-    updateSessionMetadata(sessionId: string, extra: JsonObject): Promise<UpdateSessionMetadataResult>;
     sendSessionMessage(message: DaemonWireSessionMessage): Promise<void>;
     closeSession(sessionId: string): Promise<void>;
     deleteSession(localSessionId: string): Promise<void>;
-    unsubscribeSession(sessionId: string): Promise<void>;
     shutdown(timeoutMs?: number): Promise<void>;
     fail(error: unknown, notifyListeners?: boolean): void;
     private request;
@@ -97,7 +82,6 @@ export declare class DaemonConnection {
     private rejectLegacyInitialize;
     private acceptRequest;
     private writeInboundError;
-    private acceptEvent;
-    private acceptRemoteControlEvent;
+    private acceptSessionUpdatedStatusEvent;
     private writeFrame;
 }

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

@@ -1,22 +1,12 @@
 import type { Transport } from '../core/transport.js';
 import type { StdoutMessage } from '../types/control.js';
-import type { DaemonWireSessionMessage, JsonObject } from './protocol.js';
+import type { DaemonWireSessionMessage } from './protocol.js';
 import type { DaemonConnection } from './daemon-connection.js';
-import type { SessionExtra } from './session-metadata.js';
 export type DaemonSessionTransportOptions = {
     workerArgs: string[];
     cwd?: string;
     configDir?: string;
-    extra?: SessionExtra;
     cleanup?: () => void;
-    remoteSessionId?: never;
-} | {
-    remoteSessionId: string;
-    workerArgs?: never;
-    cwd?: never;
-    configDir?: never;
-    extra?: never;
-    cleanup?: never;
 };
 export declare class DaemonSessionTransport implements Transport {
     private readonly connection;
@@ -34,11 +24,8 @@ export declare class DaemonSessionTransport implements Transport {
     private cleaned;
     private releasePromise;
     private closePromise;
-    private subscribeResult;
-    private readonly remoteSessionId;
     constructor(connection: DaemonConnection, options: DaemonSessionTransportOptions);
     initialize(): Promise<void>;
-    initializationResult(): Promise<JsonObject>;
     write(data: string): void;
     readMessages(): AsyncGenerator<StdoutMessage, void, unknown>;
     endInput(): void;

package/dist/daemon/global-daemon.d.ts

@@ -0,0 +1,24 @@
+import type { InternalAuthOptions } from '../types/auth.js';
+import { type Daemon } from './start-daemon.js';
+export interface InitDaemonOptions {
+    auth: InternalAuthOptions;
+    /** Idle Worker timeout in milliseconds. Set to 0 to disable reclamation. */
+    workerIdleTimeoutMs?: number;
+    cwd?: string;
+    pathToQoderCLIExecutable?: string;
+    proxy?: string;
+    env?: Record<string, string | undefined>;
+}
+export type DaemonFallbackReason = 'protocol_version_mismatch' | 'daemon_unavailable';
+export type DaemonInitResult = {
+    mode: 'daemon';
+    daemon: Daemon;
+} | {
+    mode: 'direct';
+    reason: DaemonFallbackReason;
+};
+export declare class DaemonConfigurationConflictError extends Error {
+    constructor();
+}
+export declare function initDaemon(options: InitDaemonOptions): Promise<DaemonInitResult>;
+export declare function shutdownDaemon(): Promise<void>;

package/dist/daemon/protocol.d.ts

@@ -41,11 +41,15 @@ export interface DaemonErrorResponseFrame {
     };
 }
 export type DaemonControlResponseFrame = DaemonSuccessResponseFrame | DaemonErrorResponseFrame;
-export interface DaemonEventFrame {
-    type: "event";
-    event: string;
-    session_id?: string;
-    data: JsonObject;
+/** Daemon-private Session failure notification consumed by the SDK transport. */
+export interface DaemonSessionUpdatedStatusEventFrame {
+    type: "status_event";
+    status: "daemon.session_updated";
+    data: {
+        local_session_id: string;
+        state: "failed";
+        error: JsonObject;
+    };
 }
 export interface KeepAliveFrame {
     type: "keep_alive";
@@ -55,7 +59,7 @@ export type DaemonWireSessionMessage = JsonObject & {
     type: string;
     session_id?: string;
 };
-export type DaemonProtocolFrame = DaemonControlRequestFrame | DaemonControlResponseFrame | DaemonEventFrame | KeepAliveFrame | DaemonWireSessionMessage;
+export type DaemonProtocolFrame = DaemonControlRequestFrame | DaemonControlResponseFrame | DaemonSessionUpdatedStatusEventFrame | KeepAliveFrame | DaemonWireSessionMessage;
 export type InitializeDaemonParams = {
     daemon_protocol_version: typeof DAEMON_PROTOCOL_VERSION;
     sdk_version: string;
@@ -70,27 +74,15 @@ export type OpenSessionParams = {
     worker_args: string[];
     cwd?: string;
     config_dir?: string;
-    extra?: JsonObject;
 };
 export type OpenSessionResult = {
     session_id: string;
 };
-export type SubscribeSessionParams = {
-    remote_session_id: string;
-};
-export type SubscribeSessionResult = {
-    session_id: string;
-    initialization_result: JsonObject;
-};
-export type UnsubscribeSessionParams = Record<string, never>;
 export type SessionRuntimeState = "pending" | "ready" | "inactive" | "failed";
 export type DaemonSessionInfo = {
     local_session_id: string;
-    remote_session_id?: string;
-    environment_id?: string;
     title: string;
     cwd?: string;
-    extra?: JsonObject;
     state: SessionRuntimeState;
     created_at: string;
     updated_at: string;
@@ -105,58 +97,27 @@ export type RenameSessionParams = {
 export type RenameSessionResult = {
     session: DaemonSessionInfo;
 };
-export type EnableRemoteControlParams = {
-    external_id: string;
-    environment_type: string;
-    name?: string;
-    metadata?: JsonObject;
-};
-export type EnableRemoteControlResult = {
-    environment_id: string;
-};
-export type DisableRemoteControlParams = Record<string, never>;
-export type SyncSessionRegistrationsParams = {
-    local_session_ids: string[];
-};
-export type UpdateSessionMetadataParams = {
-    extra: JsonObject;
-};
-export type UpdateSessionMetadataResult = {
-    session: DaemonSessionInfo;
-};
 export type CloseSessionParams = Record<string, never>;
 export type DeleteSessionParams = {
     local_session_id: string;
 };
 export type ShutdownParams = Record<string, never>;
-export type DaemonCommandMethod = "initialize" | "open_session" | "list_sessions" | "rename_session" | "subscribe_session" | "unsubscribe_session" | "enable_remote_control" | "sync_session_registrations" | "update_session_metadata" | "disable_remote_control" | "close_session" | "delete_session" | "shutdown";
+export type DaemonCommandMethod = "initialize" | "open_session" | "list_sessions" | "rename_session" | "close_session" | "delete_session" | "shutdown";
 export interface DaemonCommandParamsMap {
     initialize: InitializeDaemonParams;
     open_session: OpenSessionParams;
     list_sessions: ListSessionsParams;
     rename_session: RenameSessionParams;
-    subscribe_session: SubscribeSessionParams;
-    unsubscribe_session: UnsubscribeSessionParams;
-    enable_remote_control: EnableRemoteControlParams;
-    sync_session_registrations: SyncSessionRegistrationsParams;
-    update_session_metadata: UpdateSessionMetadataParams;
-    disable_remote_control: DisableRemoteControlParams;
     close_session: CloseSessionParams;
     delete_session: DeleteSessionParams;
     shutdown: ShutdownParams;
 }
-export type DaemonCommandRequest = DaemonControlRequestFrame<"initialize", InitializeDaemonParams> | DaemonControlRequestFrame<"open_session", OpenSessionParams> | DaemonControlRequestFrame<"list_sessions", ListSessionsParams> | DaemonControlRequestFrame<"rename_session", RenameSessionParams> | DaemonControlRequestFrame<"subscribe_session", SubscribeSessionParams> | DaemonControlRequestFrame<"unsubscribe_session", UnsubscribeSessionParams> | DaemonControlRequestFrame<"enable_remote_control", EnableRemoteControlParams> | DaemonControlRequestFrame<"sync_session_registrations", SyncSessionRegistrationsParams> | DaemonControlRequestFrame<"update_session_metadata", UpdateSessionMetadataParams> | DaemonControlRequestFrame<"disable_remote_control", DisableRemoteControlParams> | DaemonControlRequestFrame<"close_session", CloseSessionParams> | DaemonControlRequestFrame<"delete_session", DeleteSessionParams> | DaemonControlRequestFrame<"shutdown", ShutdownParams>;
+export type DaemonCommandRequest = DaemonControlRequestFrame<"initialize", InitializeDaemonParams> | DaemonControlRequestFrame<"open_session", OpenSessionParams> | DaemonControlRequestFrame<"list_sessions", ListSessionsParams> | DaemonControlRequestFrame<"rename_session", RenameSessionParams> | DaemonControlRequestFrame<"close_session", CloseSessionParams> | DaemonControlRequestFrame<"delete_session", DeleteSessionParams> | DaemonControlRequestFrame<"shutdown", ShutdownParams>;
 export interface DaemonCommandResultMap {
     initialize: InitializeDaemonResult;
     open_session: OpenSessionResult;
     list_sessions: ListSessionsResult;
     rename_session: RenameSessionResult;
-    subscribe_session: SubscribeSessionResult;
-    unsubscribe_session: null;
-    enable_remote_control: EnableRemoteControlResult;
-    sync_session_registrations: null;
-    update_session_metadata: UpdateSessionMetadataResult;
-    disable_remote_control: null;
     close_session: null;
     delete_session: null;
     shutdown: null;

package/dist/daemon/start-daemon.d.ts

@@ -1,96 +1,35 @@
 import type { InternalAuthOptions } from '../types/auth.js';
-import type { Query, OnElicitation } from '../types/options.js';
-import type { CanUseTool } from '../types/permissions.js';
 import type { ProcessTransportOptions } from '../core/process-transport.js';
 import type { QueryTransportProvider } from '../core/transport.js';
-import { type DaemonSessionStore } from './session-store-rpc.js';
-import { type ResolveRemoteSessionLaunch, type SessionExtra, type SessionMetadataUpdate } from './session-metadata.js';
 export type DaemonState = 'ready' | 'stopping' | 'stopped' | 'failed';
-export type RemoteControlState = 'ready' | 'stopping' | 'stopped' | 'failed';
-export interface EnableRemoteControlOptions {
-    externalId: string;
-    /**
-     * Remote Manager-registered push-family Environment type for this Host.
-     * The value is an Environment identity component and must remain stable.
-     */
-    environmentType: string;
-    name?: string;
-    metadata?: Record<string, unknown>;
-}
-export interface RemoteControl {
-    readonly environmentId: string;
-    readonly state: RemoteControlState;
-    disable(): Promise<void>;
-}
-export interface AttachSessionOptions {
-    canUseTool?: CanUseTool;
-    onElicitation?: OnElicitation;
-}
 export type SessionRuntimeState = 'pending' | 'ready' | 'inactive' | 'failed';
 export interface DaemonSessionInfo {
     localSessionId: string;
-    remoteSessionId?: string;
-    environmentId?: string;
     title: string;
     cwd?: string;
-    extra?: SessionExtra;
     state: SessionRuntimeState;
     createdAt: string;
     updatedAt: string;
 }
 export interface StartDaemonOptions {
     auth: InternalAuthOptions;
-    capacity: number;
     /** Idle Worker timeout in milliseconds. Set to 0 to disable reclamation. */
     workerIdleTimeoutMs?: number;
     cwd?: string;
     pathToQoderCLIExecutable?: string;
     proxy?: string;
     env?: Record<string, string | undefined>;
-    sessionStore?: DaemonSessionStore;
-    /** Resolves a remotely-created Session to trusted local launch paths. */
-    resolveRemoteSessionLaunch?: ResolveRemoteSessionLaunch;
 }
-export type DaemonEvent = {
-    type: 'daemonStateChanged';
-    previousState: DaemonState;
-    state: DaemonState;
-    error?: Error;
-} | {
-    type: 'remoteControlStateChanged';
-    environmentId?: string;
-    previousState: RemoteControlState;
-    state: RemoteControlState;
-    error?: Error;
-} | {
-    type: 'sessionDiscovered';
-    session: DaemonSessionInfo;
-} | {
-    type: 'sessionUpdated';
-    session: DaemonSessionInfo;
-    previousState?: SessionRuntimeState;
-} | {
-    type: 'sessionDeleted';
-    localSessionId: string;
-};
-export type DaemonEventCallback = (event: DaemonEvent) => void;
 export interface Daemon {
     readonly state: DaemonState;
     listSessions(): Promise<DaemonSessionInfo[]>;
-    onEvent(callback: DaemonEventCallback): () => void;
     renameSession(localSessionId: string, title: string): Promise<DaemonSessionInfo>;
-    updateSessionMetadata(localSessionId: string, update: SessionMetadataUpdate): Promise<DaemonSessionInfo>;
     deleteSession(localSessionId: string): Promise<void>;
-    enableRemoteControl(options: EnableRemoteControlOptions): Promise<RemoteControl>;
-    attachSession(remoteSessionId: string, options?: AttachSessionOptions): Promise<Query>;
     stop(): Promise<void>;
 }
 interface InternalDaemonRuntime {
     readonly auth: InternalAuthOptions;
     readonly transportProvider: QueryTransportProvider<ProcessTransportOptions>;
-    readonly sessionStore?: DaemonSessionStore;
-    readonly supportsSessionStoreFileCheckpointing: boolean;
-    readonly supportsSessionStoreForkBarrier: boolean;
 }
 export declare function getDaemonRuntime(daemon: Daemon): InternalDaemonRuntime | undefined;
 export declare function startDaemon(options: StartDaemonOptions): Promise<Daemon>;

package/dist/index.d.ts

@@ -55,11 +55,10 @@ export { query } from './query/query.js';
 export { startup } from './query/startup.js';
 export type { StartupParams, WarmQuery } from './query/startup.js';
 export { resolveSettings } from './settings/resolve-settings.js';
+export { initDaemon, shutdownDaemon } from './daemon/global-daemon.js';
+export type { DaemonFallbackReason, DaemonInitResult, InitDaemonOptions, } from './daemon/global-daemon.js';
 export { startDaemon } from './daemon/start-daemon.js';
-export type { Daemon, DaemonEvent, DaemonEventCallback, DaemonState, AttachSessionOptions, DaemonSessionInfo, SessionRuntimeState, EnableRemoteControlOptions, RemoteControl, RemoteControlState, StartDaemonOptions, } from './daemon/start-daemon.js';
-export type { RemoteSessionLaunch, RemoteSessionLaunchRequest, ResolveRemoteSessionLaunch, SessionExtra, SessionExtraValue, SessionMetadataUpdate, } from './daemon/session-metadata.js';
-export type { DaemonSessionStore, DaemonSessionSummary, } from './daemon/session-store-rpc.js';
-export { DEFAULT_SESSION_STORE_MAX_PAYLOAD_BYTES, measureSessionStoreEntryPayloadBytes, } from './daemon/session-store-rpc.js';
+export type { Daemon, DaemonState, DaemonSessionInfo, SessionRuntimeState, StartDaemonOptions, } from './daemon/start-daemon.js';
 export { DEFAULT_RUNTIME_TRANSPORT, } from './core/default-runtime.js';
 export { ProcessTransport, QoderCliProcessError, } from './core/process-transport.js';
 export { hasResolvableQoderWorkerRuntime, QoderWorkerRuntimeError, WorkerTransport, resolveQoderWorkerRuntimePath, } from './core/worker-transport.js';
@@ -98,13 +97,14 @@ export type { QueryTransportCreateOptions, QueryTransportProviderOption, } from
 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 { Options, QueryTransportOptions, Query, SpawnOptions, SpawnedProcess, ElicitationRequest, ElicitationResult, OnElicitation, PromptRequest, PromptRequestOption, PromptResponse, CanUseTool, SecurityScanOptions, } from './types/options.js';
+export type { Options, QueryTransportOptions, Query, RemoteProjectionEnableOptions, RemoteProjectionCheckpoint, SpawnOptions, SpawnedProcess, ElicitationRequest, ElicitationResult, OnElicitation, PromptRequest, PromptRequestOption, PromptResponse, CanUseTool, SecurityScanOptions, } from './types/options.js';
+export type { ArtifactGroup, SessionArtifactBase, SessionArtifact, ResolveSessionArtifactsResult, ResolveSessionArtifacts, } from './types/artifacts.js';
 export type { EffectiveMemoryConfig, MemoryConsumptionFile, MemoryConsumptionOptions, MemoryConsumptionResult, MemoryGenerationGateInput, MemoryGenerationGateResult, MemoryGenerationOptions, MemoryGenerationFailedFile, MemoryGenerationResult, MemoryMode, MemoryOptions, MemoryRoot, MemoryRootAccess, MemoryShouldGenerate, } from './types/memory.js';
 export type { EffectiveEvolutionConfig, EffectiveSkillEvolutionConfig, EvolutionOptions, SkillEvolutionGateInput, SkillEvolutionGateResult, SkillEvolutionGenerationOptions, SkillEvolutionMode, SkillEvolutionOptions, SkillEvolutionResult, SkillEvolutionShouldReview, SkillEvolutionSuggestion, } from './types/skill-evolution.js';
 export { MAX_SKILL_EVOLUTION_REVIEW_THRESHOLD } from './types/skill-evolution.js';
 export type { AgentCreateParams, BetaManagedAgentsAgentToolName, BetaManagedAgentsAgentToolset20260401Params, BetaManagedAgentsCustomSkillParams, BetaManagedAgentsFileResourceParams, BetaManagedAgentsModel, BetaManagedAgentsSkillParams, BetaManagedAgentsURLMCPServerParams, CloudAgentOptions, CloudAgentReference, CloudAgentStreamOptions, CloudSessionResource, CloudSessionCreateParams, CloudSessionCreateReference, CloudSessionExistingReference, CloudSessionReference, SessionCreateParams, } from './types/cloud-agent.js';
 export type { SettingSource as SettingSourceFromOptions } from './types/options.js';
-export type { PermissionMode, PermissionBehavior, PermissionDecisionClassification, PermissionUpdateDestination, PermissionRuleValue, PermissionUpdate, PermissionResult, CanUseToolOptions, } from './types/permissions.js';
+export type { PermissionMode, PermissionBehavior, PermissionScope, CanUseToolPermissionKind, CanUseToolPermissionOption, CanUseToolPermissionDetails, PermissionDecisionClassification, PermissionUpdateDestination, PermissionRuleValue, PermissionUpdate, PermissionResult, CanUseToolOptions, } from './types/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, PermissionDeniedHookInput, InstructionsLoadedHookInput, WorktreeCreateHookInput, WorktreeRemoveHookInput, CwdChangedHookInput, FileChangedHookInput, PreToolUseHookSpecificOutput, PostToolUseHookSpecificOutput, PostToolUseFailureHookSpecificOutput, UserPromptSubmitHookSpecificOutput, SessionStartHookSpecificOutput, SubagentStartHookSpecificOutput, PermissionRequestHookSpecificOutput, WorktreeCreateHookSpecificOutput, CwdChangedHookSpecificOutput, FileChangedHookSpecificOutput, } from './types/hooks.js';
 export type { McpStdioServerConfig, McpSSEServerConfig, McpHttpServerConfig, McpSdkServerConfig, McpSdkServerConfigWithInstance, McpServerConfig, McpServerToolPolicy, McpServerConfigForProcessTransport, McpServerStatus, McpServerStatusConfig, } from './types/mcp.js';
 export type { AgentDefinition, AgentInfo, AgentMemoryScope, AgentMcpServerSpec, } from './types/agents.js';
@@ -114,7 +114,7 @@ export { filterEscalatingDefaultMode } from './types/settings.js';
 export type { QoderModelPurpose } from './types/control.js';
 export type { SDKControlRequest, SDKControlResponse, SDKControlInterruptResponse, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlGetUsageInfoRequest, SDKControlGetUsageInfoResponse, SideQuestionHistoryEntry, AskSideQuestionOptions, SideQuestionRefusalFallback, SideQuestionResult, SDKControlAddDirectoriesResponse, SDKControlReloadPluginsResponse, SDKControlReloadSkillsRequest, SDKControlReloadSkillsResponse, SDKControlStopTaskRequest, SDKControlBackgroundTasksRequest, SDKControlBackgroundTasksResponse, SDKPlanModeSnapshot, } from './types/control.js';
 export type { SDKControlGetModelPolicyRequest, SDKControlGetModelPolicyResponse, SDKCapabilities, ModelPolicyContext, ModelPolicyResult, ModelPolicyProvider, } from './types/model-policy-provider.js';
-export type { SDKControlGetByokConfigRequest, SDKControlGetByokConfigResponse, SDKControlValidateByokModelRequest, SDKControlValidateByokModelResponse, SDKControlListByokConfigsRequest, SDKControlListByokConfigsResponse, SDKControlCreateByokConfigRequest, SDKControlCreateByokConfigResponse, SDKControlUpdateByokConfigRequest, SDKControlDeleteByokConfigRequest, SDKControlCheckByokConfigRequest, SDKControlCheckByokConfigResponse, BYOKModelValidationInput, BYOKProviderInfo, BYOKModelTypeInfo, BYOKModelInfo, ByokProtocol, ByokModelConfigInfo, CustomByokProviderConfigInfo, ByokConfigInfo, ByokModelConfigInput, CustomByokProviderThinkingMode, CustomByokProviderReasoningEffortLevel, CustomByokProviderThinkingCapabilitiesInput, CustomByokProviderModelCapabilitiesInput, CustomByokProviderModelInput, CustomByokProviderConfigInput, CreateByokConfigInput, UpdateByokModelConfigInput, UpdateCustomByokProviderConfigInput, UpdateByokConfigInput, DeleteByokConfigInput, CheckByokConfigInput, ByokConfigReference, ByokConfigCheckResult, CustomModel, } from './types/byok.js';
+export type { SDKControlGetByokConfigRequest, SDKControlGetByokConfigResponse, SDKControlValidateByokModelRequest, SDKControlValidateByokModelResponse, SDKControlListByokConfigsRequest, SDKControlListByokConfigsResponse, SDKControlCreateByokConfigRequest, SDKControlCreateByokConfigResponse, SDKControlUpdateByokConfigRequest, SDKControlDeleteByokConfigRequest, SDKControlCheckByokConfigRequest, SDKControlCheckByokConfigResponse, BYOKModelValidationInput, BYOKLocalizedName, BYOKProviderInfo, BYOKModelTypeInfo, BYOKModelInfo, ByokProtocol, ByokModelConfigInfo, CustomByokProviderConfigInfo, ByokConfigInfo, ByokModelConfigInput, CustomByokProviderThinkingMode, CustomByokProviderReasoningEffortLevel, CustomByokProviderThinkingCapabilitiesInput, CustomByokProviderModelCapabilitiesInput, CustomByokProviderModelInput, CustomByokProviderConfigInput, CreateByokConfigInput, UpdateByokModelConfigInput, UpdateCustomByokProviderConfigInput, UpdateByokConfigInput, DeleteByokConfigInput, CheckByokConfigInput, ByokConfigReference, ByokConfigCheckResult, CustomModel, } from './types/byok.js';
 export { isBashToolBackgroundLaunchResult } from './types/tools.js';
 export type { AgentInput, AgentOutput, AgentToolCompletionResult, AgentToolBackgroundLaunchResult, AgentToolTeammateSpawnedResult, BashInput, BashToolBackgroundLaunchResult, FileReadInput, FileReadOutput, FileEditInput, FileWriteInput, GlobInput, GrepInput, WebFetchInput, WebSearchInput, AskUserQuestionInput, NotebookEditInput, TaskCreateInput, TaskCreateOutput, TaskGetInput, TaskGetOutput, TaskUpdateInput, TaskUpdateOutput, TaskListInput, TaskListOutput, ExitPlanModeInput, TodoWriteInput, ToolInputSchemas, ToolOutputSchemas, } from './types/tools.js';
 export type { FeedbackResult } from './types/account.js';