qlogicagent 2.18.5 → 2.18.7

package/dist/types/protocol/wire/agent-methods.d.ts

@@ -2,7 +2,7 @@
  * Agent RPC Method Map — complete typed contract for ALL agent JSON-RPC methods.
  *
  * This extends GatewayRpcMethodMap (26 methods Gateway directly calls) with all
- * additional agent-specific methods (thread, memory, config, agents, solo, product, etc.).
+ * additional agent-specific methods (thread, memory, agents, solo, product, etc.).
  *
  * Consumers use this for fully typed RPC clients:
  *   import type { AgentRpcMethodMap } from "qlogicagent/protocol";
@@ -375,22 +375,6 @@ export interface AgentRpcMethodMap extends GatewayRpcMethodMap {
             }>;
         };
     };
-    "config.get": {
-        params: {
-            keys?: string[];
-        };
-        result: {
-            config: Record<string, unknown>;
-        };
-    };
-    "config.update": {
-        params: {
-            updates: Record<string, unknown>;
-        };
-        result: {
-            ok: boolean;
-        };
-    };
     "todos.list": {
         params: {
             sessionId?: string;
@@ -661,144 +645,6 @@ export interface AgentRpcMethodMap extends GatewayRpcMethodMap {
             model?: string;
         };
     };
-    "settings.listProviders": {
-        params: undefined;
-        result: {
-            providers: Array<{
-                id: string;
-                displayName: string;
-                baseUrl: string;
-                modelCount: number;
-            }>;
-        };
-    };
-    "settings.addKey": {
-        params: {
-            providerId: string;
-            key: string;
-            label?: string;
-        };
-        result: {
-            keyId: string;
-            providerId: string;
-        };
-    };
-    "settings.removeKey": {
-        params: {
-            keyId: string;
-        };
-        result: {
-            ok: true;
-        };
-    };
-    "settings.getKey": {
-        params: {
-            keyId: string;
-        };
-        result: {
-            key: string;
-        };
-    };
-    "settings.copyKey": {
-        params: {
-            keyId: string;
-        };
-        result: {
-            ok: true;
-        };
-    };
-    "settings.toggleKey": {
-        params: {
-            keyId: string;
-            enabled: boolean;
-        };
-        result: {
-            ok: true;
-        };
-    };
-    "settings.toggleModel": {
-        params: {
-            modelId: string;
-            enabled: boolean;
-            purpose?: string;
-        };
-        result: {
-            ok: true;
-        };
-    };
-    "settings.listModels": {
-        params: {
-            purpose?: string;
-            provider?: string;
-        };
-        result: {
-            models: unknown[];
-            grouped: Record<string, unknown[]>;
-        };
-    };
-    "settings.setActiveModel": {
-        params: {
-            purpose: string;
-            modelId: string;
-        };
-        result: {
-            ok: true;
-        };
-    };
-    "settings.getActiveModel": {
-        params: {
-            purpose: string;
-        };
-        result: {
-            model: {
-                id: string;
-                provider: string;
-                model: string;
-                displayName: string;
-                routeIntents: string[];
-                capabilityProfile?: Record<string, unknown>;
-                enabled: boolean;
-            } | null;
-            available: boolean;
-        };
-    };
-    "settings.getOverview": {
-        params: undefined;
-        result: {
-            providers: Array<{
-                providerId: string;
-                baseUrl?: string;
-                keyCount: number;
-                healthyKeys: number;
-                totalKeys: number;
-            }>;
-            purposes: Record<string, {
-                bound: boolean;
-                modelId?: string;
-                modelName?: string;
-                available: boolean;
-            }>;
-        };
-    };
-    "settings.refreshModels": {
-        params: undefined;
-        result: {
-            ok: true;
-            catalogRefreshed?: boolean;
-        };
-    };
-    "settings.validateKey": {
-        params: {
-            providerId: string;
-            apiKey: string;
-            baseUrl?: string;
-        };
-        result: {
-            valid: boolean;
-            status: number;
-            error?: string;
-        };
-    };
     "provider.list": {
         params: undefined;
         result: {
@@ -816,24 +662,6 @@ export interface AgentRpcMethodMap extends GatewayRpcMethodMap {
             }>;
         };
     };
-    "config.tunables": {
-        params: undefined;
-        result: {
-            defaults: Record<string, unknown>;
-            overrides: Record<string, unknown>;
-        };
-    };
-    "config.updateTunable": {
-        params: {
-            key: string;
-            value?: unknown;
-        };
-        result: {
-            ok: true;
-            key: string;
-            value: unknown;
-        };
-    };
     "community.resolveInstall": {
         params: {
             resourceId: string;

package/dist/types/protocol/wire/chat-types.d.ts

@@ -36,6 +36,12 @@ export interface ChatMessage {
     tool_call_id?: string;
     /** For tool result messages — tool name. */
     name?: string;
+    /** Tool-result error flag (AP2) — propagated so every transport can signal failure to the model. */
+    is_error?: boolean;
+    /** OpenAI-chat reasoning content (GLM/DeepSeek) carried across tool-call rounds on the assistant message. */
+    reasoning_content?: string;
+    /** Anthropic tool_reference metadata for tool_result blocks. */
+    toolReferences?: string[];
     /** Anthropic thinking blocks — must be passed back to API in subsequent requests. */
     thinkingBlocks?: ThinkingBlock[];
     /** Image URLs for vision-capable models. */

package/dist/types/runtime/config/tunable-defaults.d.ts

@@ -4,12 +4,12 @@
  * ALL configurable constants that external apps (Electron UI, CLI config)
  * may want to read or override are defined here. This enables:
  *
- * 1. A future `config.tunables` RPC endpoint for visual editing
+ * 1. Private X7 host profile tooling and local runtime consumers
  * 2. Serialization to JSON for persistence (settings.json)
  * 3. Environment variable overrides via QLOGICAGENT_* prefix
  *
  * Consumers import individual constants from this module.
- * The full shape is exported as `TunableDefaults` interface for RPC typing.
+ * The full shape is exported as `TunableDefaults` for the private host profile contract.
  *
  * Grouping follows subsystem boundaries.
  */
@@ -165,7 +165,7 @@ export declare const DREAM_COOLDOWN_MS = 14400000;
 export declare const DREAM_MAX_DURATION_MS = 300000;
 /**
  * Full typed shape of all tunable defaults.
- * Used by `config.tunables` RPC for external app visualization.
+ * Used by private X7 host profile tooling and local runtime consumers.
  */
 export interface TunableDefaults {
     maxRoundsLimit: number;
@@ -241,3 +241,13 @@ export interface TunableDefaults {
  * Use this for RPC serialization and external app display.
  */
 export declare function getTunableDefaults(): TunableDefaults;
+export type TunableKey = keyof TunableDefaults;
+/** Validate a tunable name against the one authoritative defaults table. */
+export declare function validateTunableKey(key: string): string | null;
+/**
+ * Validate an already-coerced update. Error text deliberately reports only the declared/received
+ * types and never interpolates the rejected value (some string tunables are credentials).
+ */
+export declare function validateTunableUpdate(key: string, value: unknown): string | null;
+/** Coerce a string toward a declared scalar type; unknown keys and unsafe numbers stay unchanged. */
+export declare function coerceTunableValue(key: string, value: unknown): unknown;

package/dist/types/runtime/execution/dream-agent.d.ts

@@ -212,8 +212,9 @@ export interface DreamRunDeps {
         feedback?(memoryIds: string[], signal: "useful" | "irrelevant" | "outdated" | "wrong"): Promise<{
             affected: number;
         }>;
-        /** Recent activity summary for temporal context injection into Dream. */
-        getActivitySummary?(userId: string, days?: number): {
+        /** Recent activity summary for temporal context injection into Dream.
+         * B3(X7)异步化:16 面 host-state proxy 方法(host 模式经 x/host.request 跨进程)。 */
+        getActivitySummary?(userId: string, days?: number): Promise<{
             dailyCounts: Array<{
                 date: string;
                 count: number;
@@ -224,13 +225,13 @@ export interface DreamRunDeps {
                 importance: number;
                 date: string;
             }>;
-        };
-        /** Synthesize a timeline narrative for a time range. */
-        synthesizeTimeline?(userId: string, startMs: number, endMs: number): string;
-        /** Get/set user profile entries. */
+        }>;
+        /** Synthesize a timeline narrative for a time range. B3(X7)异步化。 */
+        synthesizeTimeline?(userId: string, startMs: number, endMs: number): Promise<string>;
+        /** Get/set user profile entries. B3(X7):setProfile/getAllProfiles 异步化(16 面);getProfile 面外保持同步。 */
         getProfile?(userId: string, key: string): string | null;
-        setProfile?(userId: string, key: string, value: string): void;
-        getAllProfiles?(userId: string): Record<string, string>;
+        setProfile?(userId: string, key: string, value: string): Promise<void>;
+        getAllProfiles?(userId: string): Promise<Record<string, string>>;
         /** Drain consolidation backlog: resolve conflicts + promote corroborated pending claims. */
         resolveConflicts?(userId: string, opts?: {
             minEvidenceToPromote?: number;

package/dist/types/runtime/infra/agent-paths.d.ts

@@ -5,6 +5,7 @@
  * `<project>/.qlogicagent/` (project-level) must go through these
  * helpers so the dot-dir name is defined in exactly one place.
  */
+export { deriveProjectId } from "../../host-contract/project-id.js";
 /** Dot-directory name used for both user-level and project-level storage. */
 export declare const AGENT_DOT_DIR = ".qlogicagent";
 /**
@@ -14,10 +15,9 @@ export declare const AGENT_DOT_DIR = ".qlogicagent";
  * keeps the id length-safe on Windows (260-char path limit) while staying collision-free in
  * practice. NOTE: deliberately NO ctime salt (VS Code salts single-folder ids so recreating a folder
  * yields fresh state — a footgun for us; we want a recreated/rebound folder to map back to its data).
- * This is a leaf helper (crypto + path only) so project-store and project-data-paths can both import
- * it without a dependency cycle.
+ * The implementation is owned by host-contract/project-id.ts so the shared contract remains a leaf;
+ * this module re-exports the same function for existing path-helper consumers.
  */
-export declare function deriveProjectId(workspaceDir: string): string;
 /** `~/.qlogicagent/` (or QLOGICAGENT_HOME override) */
 export declare function getUserAgentHome(): string;
 export declare function resolveActiveOwnerUserId(): string;

package/dist/types/runtime/infra/astraclaw-capabilities.d.ts

@@ -1,6 +1,6 @@
 import type { ToolCatalog } from "../ports/index.js";
 export declare const ASTRACLAW_CAPABILITIES_SERVER_NAME = "astraclaw_capabilities";
-export declare const ASTRACLAW_CAPABILITIES_SERVER_ALIASES: readonly ["astraclaw_capabilities", "astraclaw"];
+export declare const ASTRACLAW_CAPABILITIES_RETIRED_SERVER_NAMES: readonly ["astraclaw"];
 export interface AstraClawCapabilityToolInput {
     tool: string;
     args: Record<string, unknown>;

package/dist/types/runtime/infra/clixml-sanitize.d.ts

@@ -0,0 +1,16 @@
+/**
+ * De-serialize Windows PowerShell 5.1 CLIXML noise back to readable text.
+ *
+ * When PS 5.1's stderr is a redirected pipe (a spawned child) and a native command writes to stderr —
+ * or PS itself raises Write-Error / throw — it appends a `#< CLIXML\n<Objs …>…</Objs>` block that
+ * serializes the error/progress streams. Left raw, the model sees XML garbage and assumes its output
+ * was "swallowed", then flails. This replaces each CLIXML block with the decoded human-readable
+ * strings (`<S>…</S>` — the error/warning text), dropping the `<Obj>` progress/type-name scaffolding.
+ * A native command's own stderr already appears RAW before the block, so this only RECOVERS the
+ * PowerShell-native errors that would otherwise live solely inside the CLIXML. Non-PowerShell output
+ * (no CLIXML marker) is returned unchanged, so it is safe to call on any exec output — bash included.
+ *
+ * Callers pass a COMPLETE snapshot of the output (a full stdout/stderr string or a whole-file read),
+ * never a mid-stream chunk: an incomplete `<Objs>` block would not match and would be left raw.
+ */
+export declare function sanitizePowerShellClixml(text: string): string;

package/dist/types/runtime/infra/external-agent-approvals.d.ts

@@ -30,6 +30,24 @@ export interface ApprovalForwardDeps {
     sendNotification?: (method: string, params: Record<string, unknown>) => void;
     timeoutMs?: number;
 }
+/**
+ * 激活层(S3c §1.1)delegate 路径的审批决议:输入是 SupervisorEventSink.onApprovalRequest 的已翻译
+ * 形状(toolName/options 已扁平,非 ACP 原始 session/request_permission params)。决议序与旧路径
+ * forwardExternalApproval 逐条对齐:①AstraClaw 只读能力自批 ②有交互上下文 → forward()发 UI 卡 +
+ * 同一 PENDING registry 等 agents.approvalResponse ③无上下文/超时 → reject 回退。返回最终 optionId
+ * (不透明,E2);调用方拿它走 x/delegate.respond(gateway 唯一应答口 respondApproval)。
+ */
+export declare function decideExternalApproval(input: {
+    agentId: string;
+    approvalId: string;
+    toolName?: string;
+    options: Array<Record<string, unknown>>;
+    /** 有流式回合上下文(turnId 在)才值得转 UI 卡;否则直接回退 reject。 */
+    hasInteractiveContext: boolean;
+    /** 发 agents.prompt.approval UI 卡(形状归属调用方;只在需要用户决议时调用)。 */
+    forward: () => void;
+    timeoutMs?: number;
+}): Promise<string>;
 /**
  * Drive one interactive approval for an external agent: forward the ACP session/request_permission
  * to the user (agents.prompt.approval), await the decision, and return the chosen optionId. Falls

package/dist/types/runtime/infra/feedback-distillation.d.ts

@@ -1,4 +1,5 @@
 import type { FeedbackEvent } from "./feedback-event-store.js";
+type DistillableFeedback = Pick<FeedbackEvent, "feedbackId" | "rating" | "reason" | "state" | "sessionId" | "turnId">;
 /** Minimum corroborating active events before a cluster becomes a proposal (mini-design §3.4). */
 export declare const MIN_EVIDENCE = 2;
 export interface FeedbackDistillationCandidate {
@@ -27,4 +28,5 @@ export interface FeedbackDistillationCandidate {
  * (retracted / replaced are filtered — §11.1). Clusters below MIN_EVIDENCE are dropped. Output is
  * sorted by clusterKey for deterministic ordering across runs.
  */
-export declare function distillFeedback(events: FeedbackEvent[]): FeedbackDistillationCandidate[];
+export declare function distillFeedback(events: DistillableFeedback[]): FeedbackDistillationCandidate[];
+export {};

package/dist/types/runtime/infra/feedback-host-authority.d.ts

@@ -0,0 +1,4 @@
+import type { HostFeedbackClient } from "../../transport/host-feedback-client.js";
+/** Process-lifetime binding installed by stdio-server after ACP initialize capability negotiation. */
+export declare function configureHostFeedbackAuthority(resolver: () => HostFeedbackClient | undefined): void;
+export declare function getHostFeedbackAuthority(): HostFeedbackClient | undefined;

package/dist/types/runtime/infra/llmrouter-catalog.d.ts

@@ -1,5 +1,6 @@
 import type { ModelCapabilityProfile, ModelEntry, ModelPurpose, ModelRegistry, ReasoningMode } from "./model-registry.js";
 import type { ConfigPort } from "../ports/index.js";
+import { type ProviderCatalogDef } from "../../host-contract/provider-profile.js";
 export declare const LLMROUTER_CATALOG_UNAVAILABLE_MESSAGE = "\u65E0\u6CD5\u8FDE\u63A5 llmrouter \u6A21\u578B\u76EE\u5F55";
 export declare const LLMROUTER_PROVIDER_ID = "llmrouter";
 export declare const LLMROUTER_PROVIDER_NAME = "LLMRouter";
@@ -19,19 +20,7 @@ export declare class LlmrouterAuthError extends Error {
     readonly status: number;
     constructor(status: number, message?: string);
 }
-export interface LlmrouterCatalogProvider {
-    id: string;
-    name?: string;
-    displayName?: string;
-    group?: string;
-    baseUrl?: string;
-    base_url?: string;
-    transport?: string;
-    authType?: string;
-    apiKeyEnvVars?: string[];
-    models?: Array<{
-        id?: string;
-    }>;
+export interface LlmrouterCatalogProvider extends ProviderCatalogDef {
 }
 export interface LlmrouterCatalogModel {
     id: string;

package/dist/types/runtime/infra/model-registry.d.ts

@@ -1,7 +1,8 @@
+import { MODEL_PURPOSES, type ModelPurpose } from "../../host-contract/index.js";
 import { type KeyConfig, type KeyHandle, type LoadBalanceStrategy, type PoolStatus, type ProviderPoolConfig } from "./key-pool.js";
 export type RegistryChangeCallback = () => void;
 export type ReasoningMode = "none" | "adaptive" | "collapsed" | "effort";
-export type ModelPurpose = "textGeneration" | "smallModel" | "stt" | "tts" | "imageGeneration" | "imageUnderstanding" | "videoGeneration" | "videoUnderstanding" | "threeDGeneration" | "embedding" | "voiceClone" | "musicGeneration" | "realtimeAudio" | "realtimeVideo";
+export { MODEL_PURPOSES, type ModelPurpose };
 export interface ModelInfo {
     id: string;
     name?: string;
@@ -97,6 +98,7 @@ export interface ResolvedModel {
     baseUrl?: string;
     keyHandle: KeyHandle;
 }
+/** @deprecated Use MODEL_PURPOSES; retained as a compatibility alias. */
 export declare const ALL_PURPOSES: ModelPurpose[];
 export declare class ModelRegistry {
     private keyPool;

package/dist/types/runtime/infra/project-authority-facade.d.ts

@@ -0,0 +1,11 @@
+/** Business mutations choose gateway X7 when negotiated, otherwise the standalone local store. */
+import type { ProjectInfo, ProjectType } from "../../protocol/methods.js";
+export declare function createProjectAuthoritative(params: {
+    name: string;
+    workspaceDir?: string;
+    type?: ProjectType;
+    groupId?: string;
+    skipAutoSwitch?: boolean;
+}): Promise<ProjectInfo>;
+export declare function updateProjectAuthoritative(projectId: string, patch: Partial<Pick<ProjectInfo, "planStatus" | "planAgents" | "planWinnerId" | "leaderSessionId" | "primaryWorkflowId">>): Promise<ProjectInfo | null>;
+export declare function switchProjectAuthoritative(projectIdOrQuery: string): Promise<ProjectInfo | null>;

package/dist/types/runtime/infra/project-host-authority.d.ts

@@ -0,0 +1,10 @@
+/** In-memory ExtHost-style project proxy. Durable registry bytes remain gateway-owned. */
+import type { HostProjectInfo, HostProjectSnapshotResult } from "../../host-contract/index.js";
+import type { HostProjectClient } from "../../transport/host-project-client.js";
+export declare function configureHostProjectAuthority(resolver: () => HostProjectClient | undefined): void;
+export declare function hasHostProjectAuthority(): boolean;
+export declare function hydrateHostProjectSnapshot(): Promise<void>;
+export declare function readHostProjectSnapshot(): HostProjectSnapshotResult | undefined;
+export declare function createHostProject(params: Parameters<HostProjectClient["create"]>[0]): Promise<HostProjectInfo>;
+export declare function switchHostProject(projectIdOrQuery: string): Promise<HostProjectInfo>;
+export declare function updateHostProject(projectId: string, patch: Parameters<HostProjectClient["update"]>[1]): Promise<HostProjectInfo>;

package/dist/types/runtime/ports/memory-provider.d.ts

@@ -64,7 +64,8 @@ export interface MemoryToolLocalProvider {
         category?: string;
         importance?: number;
     }): Promise<unknown>;
-    synthesizeTimeline(userId: string, startMs: number, endMs: number): string;
+    /** B3(X7)异步化:16 面 host-state proxy 方法(host 模式经 x/host.request 跨进程)。 */
+    synthesizeTimeline(userId: string, startMs: number, endMs: number): Promise<string>;
     feedback(ids: string[], signal: "useful" | "irrelevant" | "outdated" | "wrong"): Promise<{
         affected: number;
     }>;
@@ -124,8 +125,10 @@ export interface MemoryUpdatePatch {
     tags?: string[];
 }
 export interface MemoryHandlerProvider extends MemoryProvider {
-    getAtlas?(userId: string, options?: Record<string, unknown>): MemoryAtlasResult;
-    getActivitySummary?(userId: string, days: number): MemoryActivitySummary;
+    /** B3(X7)异步化:16 面 host-state proxy 方法(host 模式经 x/host.request 跨进程)。 */
+    getAtlas?(userId: string, options?: Record<string, unknown>): Promise<MemoryAtlasResult>;
+    /** B3(X7)异步化:16 面 host-state proxy 方法。 */
+    getActivitySummary?(userId: string, days: number): Promise<MemoryActivitySummary>;
     observeExtracted?(items: MemoryExtractionItem[], userId: string, options?: MemoryIngestOptions): Promise<MemoryConsolidationWriteResult>;
     proposeExtracted?(items: MemoryExtractionItem[], userId: string, options?: MemoryIngestOptions): Promise<MemoryConsolidationWriteResult>;
     ingestExtracted?(items: MemoryExtractionItem[], userId: string, options?: MemoryIngestOptions): Promise<MemoryConsolidationWriteResult>;
@@ -188,11 +191,12 @@ export interface MemoryDreamProvider {
     feedback?(memoryIds: string[], signal: "useful" | "irrelevant" | "outdated" | "wrong"): Promise<{
         affected: number;
     }>;
-    getActivitySummary?(userId: string, days?: number): MemoryActivitySummary;
-    synthesizeTimeline?(userId: string, startMs: number, endMs: number): string;
+    /** B3(X7)异步化:以下四个 16 面 host-state proxy 方法签名统一 Promise(host 模式经 x/host.request 跨进程)。 */
+    getActivitySummary?(userId: string, days?: number): Promise<MemoryActivitySummary>;
+    synthesizeTimeline?(userId: string, startMs: number, endMs: number): Promise<string>;
     getProfile?(userId: string, key: string): string | null;
-    setProfile?(userId: string, key: string, value: string): void;
-    getAllProfiles?(userId: string): Record<string, string>;
+    setProfile?(userId: string, key: string, value: string): Promise<void>;
+    getAllProfiles?(userId: string): Promise<Record<string, string>>;
 }
 export interface MemoryDecayProvider {
     triggerDecay(userId: string): Promise<{

package/dist/types/runtime/ports/tool-contracts.d.ts

@@ -67,6 +67,8 @@ export interface ToolBootstrapConfig {
     getCurrentTurnId?(): string | undefined;
     sendNotification?(method: string, params: Record<string, unknown>): void;
     onExecProgress?(progress: ToolBootstrapProgress): void;
+    /** Lazy host-owned tunable overrides; web registration must not call it until first invoke. */
+    loadTunableOverrides?(): Promise<Record<string, unknown>>;
 }
 export interface ToolBootstrap {
     getAllBaseTools(config?: ToolBootstrapConfig): RuntimeToolContract[];

package/dist/types/runtime/prompt/fresh-workspace-evidence.d.ts

@@ -11,8 +11,8 @@ export interface ToolNameLike {
 }
 export interface FreshWorkspaceEvidencePolicy {
     requiresFreshTool: boolean;
-    reason?: "file-read" | "memory-mutation" | "media-generation" | "directory-list" | "content-search" | "shell" | "web";
-    mediaKind?: "image" | "tts" | "music";
+    reason?: "file-read" | "memory-mutation" | "media-generation" | "media-understanding" | "directory-list" | "content-search" | "shell" | "web";
+    mediaKind?: "image" | "video" | "tts" | "music";
     allowedToolNames: string[];
 }
 export declare function getFreshWorkspaceEvidencePolicy(messages: readonly PromptMessageLike[] | string): FreshWorkspaceEvidencePolicy;

package/dist/types/runtime/session/session-catalog.d.ts

@@ -1,6 +1,18 @@
 import type { SessionListEntry } from "./session-types.js";
 export declare function listSessions(limit: number | undefined, projectRoot: string): Promise<SessionListEntry[]>;
 export declare function deleteSession(sessionId: string, projectRoot: string): Promise<void>;
+/**
+ * Authoritative "already ours" id set for the lazy-migration discovery scan: every session id and
+ * bound native id recorded for `agentId` in this project — including ARCHIVED records, which the
+ * list pipeline filters out of its window.
+ *
+ * listSessions' windowed result must NOT be used for discovery dedup: it truncates (limit) and
+ * post-filters (archived), so an adopted session pushed out of the window would be "re-discovered"
+ * as a second entry — and a resume on that duplicate would fork a second canonical record for the
+ * same native conversation. This enumerates metadata.json only (no transcript counting), and
+ * callers only pay for it when the scan actually yielded candidates.
+ */
+export declare function collectAdoptedNativeIds(agentId: string, projectRoot: string): Promise<Set<string>>;
 /**
  * ⚠️ Destructive cascade with NO user-visible confirmation: every pruned session goes through
  * deleteSession, which permanently removes its transcript + metadata + checkpoints + uploads.

package/dist/types/runtime/session/session-persistence.d.ts

@@ -1,16 +1,35 @@
 /**
- * Compatibility facade for session persistence.
+ * Session persistence authority facade.
  *
- * The implementation lives in focused modules:
- * - session-transcript-store.ts: append-only transcript JSONL
- * - session-metadata-store.ts: metadata schema, migration, atomic writes
- * - session-resume.ts: resume assembly
- * - session-catalog.ts: list/delete/prune
- * - session-summary.ts: title and task-summary generation
+ * When gateway advertises Session X7, durable reads/writes go through HostSessionClient. Without
+ * that capability (gate-off/tests/standalone), the legacy local implementation remains the inert
+ * compatibility path. A single call never writes both stores.
  */
-export { appendMessage } from "./session-transcript-store.js";
-export { getSessionMetadata, readSessionMetadata, saveSessionState, updateSessionMetadata, } from "./session-metadata-store.js";
-export { loadSessionForResume } from "./session-resume.js";
-export { deleteSession, listSessions, pruneOldSessions } from "./session-catalog.js";
+import type { ChatMessage } from "../../protocol/wire/index.js";
+import type { HostSessionClient } from "../../transport/host-session-client.js";
+import { type AppendMessageOutcome } from "./session-transcript-store.js";
+import { getSessionMetadata, readSessionMetadata } from "./session-metadata-store.js";
+import type { MessageDisplayMetadata, PersistedSession, SessionMetadataPatch, SessionStateSaveMetadata, SessionUsageSnapshot, TokenUsage } from "./session-types.js";
+export declare function configureHostSessionPersistence(resolver: () => HostSessionClient | undefined): void;
+export declare function isHostSessionPersistenceActive(): boolean;
+export declare function requestHostGroupSplit(sessionId: string, operationId: string, reason: "idle" | "turn-limit", cas?: {
+    expectedLastActiveAt?: string;
+    expectedTurnCount?: number;
+}): Promise<{
+    status: "updated" | "duplicate" | "session-deleted";
+    nextSessionId?: string;
+} | undefined>;
+export declare function appendMessage(sessionId: string, message: ChatMessage, projectRoot: string, turnId?: string, metadata?: {
+    usage?: TokenUsage;
+    displayMetadata?: MessageDisplayMetadata;
+}): Promise<AppendMessageOutcome>;
+export declare function waitForSessionPersistenceAppends(sessionId: string, projectRoot: string): Promise<void>;
+export declare function loadSessionForResume(sessionId: string, projectRoot: string, options?: {
+    includeDisplayMetadata?: boolean;
+}): Promise<PersistedSession | null>;
+export declare function saveSessionState(sessionId: string, usageSnapshot: SessionUsageSnapshot, metadata: SessionStateSaveMetadata, projectRoot: string): Promise<void>;
+export declare function updateSessionMetadata(sessionId: string, patch: SessionMetadataPatch, projectRoot: string): Promise<import("./session-types.js").SessionMetadata | null>;
+export { getSessionMetadata, readSessionMetadata };
+export { collectAdoptedNativeIds, deleteSession, listSessions, pruneOldSessions } from "./session-catalog.js";
 export { generateSessionTitle, maybeGenerateTaskSummary, shouldGenerateTaskSummary, } from "./session-summary.js";
 export { SESSION_SCHEMA_VERSION, type MessageDisplayMetadata, type PersistedChatMessage, type PersistedSession, type SessionListEntry, type SessionMetadata, type TaskSummaryDeps, } from "./session-types.js";

package/dist/types/runtime/session/session-recovery.d.ts

@@ -38,6 +38,8 @@ export declare function enumerateSessionMetadataFiles(): Promise<SessionMetaLoca
  * 直接原子改写 metadata.json（不经 updateSessionMetadata 的 projectRoot 解析）。返回清理数。
  */
 export declare function clearAllInflightMarkers(): Promise<number>;
+/** 读同目录 transcript.jsonl 最后一条 assistant 消息的 ts（毫秒）。无则 null。 */
+declare function readLastAssistantTs(metadataPath: string): Promise<number | null>;
 export interface CrashedTurnInfo {
     sessionId: string;
     turnId: string;
@@ -55,4 +57,6 @@ export interface CrashedTurnInfo {
  * - 否则：保留标记 + 递增中断计数，收进待恢复列表（交给 UI 让用户手动续）。
  */
 export declare function scanForCrashedTurns(): Promise<CrashedTurnInfo[]>;
+/** Test-only escape hatch: readLastAssistantTs is otherwise module-private (Cut 5.2). */
+export declare const __test_readLastAssistantTs: typeof readLastAssistantTs;
 export {};

package/dist/types/runtime/session/session-summary.d.ts

@@ -2,4 +2,6 @@ import type { ChatMessage } from "../../protocol/wire/index.js";
 import type { SessionMetadata, TaskSummaryDeps } from "./session-types.js";
 export declare function shouldGenerateTaskSummary(metadata: SessionMetadata): boolean;
 export declare function generateSessionTitle(userMessage: string, deps: TaskSummaryDeps): Promise<string | null>;
-export declare function maybeGenerateTaskSummary(sessionId: string, metadata: SessionMetadata, recentMessages: ChatMessage[], deps: TaskSummaryDeps, projectRoot: string): Promise<string | null>;
+export declare function maybeGenerateTaskSummary(sessionId: string, metadata: SessionMetadata, recentMessages: ChatMessage[], deps: TaskSummaryDeps, projectRoot: string, persist?: (summary: string, generatedAtTurn: number) => Promise<void>): Promise<string | null>;
+declare function buildDigestContext(recentMessages: ChatMessage[]): string;
+export { buildDigestContext as __test_buildDigestContext };

package/dist/types/runtime/session/session-transcript-store.d.ts

@@ -17,6 +17,13 @@ export declare function appendMessage(sessionId: string, message: ChatMessage, p
     usage?: TokenUsage;
     displayMetadata?: MessageDisplayMetadata;
 }): Promise<AppendMessageOutcome>;
+/**
+ * Public drain: await all queued transcript appends for one session to hit disk. Wraps the
+ * composite-key `waitForTranscriptAppends` (the queue is keyed by projectRoot+sessionId, not
+ * sessionId alone). Call before a process kill / cold-restart test — reading the file does NOT
+ * flush a same-process fire-and-forget tail (Cut 8).
+ */
+export declare function waitForSessionTranscriptAppends(sessionId: string, projectRoot: string): Promise<void>;
 export declare function countTranscriptMessages(sessionId: string, projectRoot: string): Promise<number | null>;
 export declare function loadTranscript(sessionId: string, projectRoot: string, options?: {
     includeDisplayMetadata?: boolean;