qlogicagent 2.18.9 → 2.18.11

package/dist/types/host-contract/index.d.ts

@@ -509,11 +509,9 @@ export interface MemoryMatch {
  * 是 memory MCP 能力模块(freeze §3.7)的 store-owner;三张脸(MCP 面/UI-API 面/brain proxy 面 X7)
  * 都是 thin adapter,唯一写者恒为本服务(脸数≠拷贝数,M-1)。
  *
- * [Route B X6 裁决] 本服务只管 **A 域库面**(memories.db + 附件 + 晋升/蒸馏 JSON + 用户级 INDEX.md
- * 派生渲染)。C 域 memdir(`<cwd>/.qlogicagent/memory/`)从 memory host-state **剥离**,归"项目文件面"
- * (进用户仓的项目文件,类 .vscode/,非 host store):UI-API 的 memdir 分支由 gateway 文件服务本地应答
- * (VSCode main IFileService 同构),agent 侧 qla 直接 fs 操作如常。`read(source, target)` 的 memdir
- * 两义剥除——source 只指库内来源标识,绝不再指 memdir 文件。
+ * A 域库面(memories.db + 附件 + 晋升/蒸馏 JSON + 用户级 INDEX.md 派生渲染)与 C 域项目 memdir
+ * (`<cwd>/.qlogicagent/memory/`)都由 Gateway 独占在线存取。C 域仍是项目文件而非用户 Host store,
+ * 但 agent 只能经 projectMemory X7 语义代理访问,与 VSCode ext host 经 main IFileService proxy 同构。
  */
 export interface MemoryProfileService {
     atlas(query: MemoryQuery): MemoryRecord[];
@@ -573,6 +571,8 @@ export interface RunEvent {
     /** ISO 时间戳 */
     at: string;
     type: string;
+    /** Optional domain event sequence (Goal event-sourcing recovery). */
+    sequence?: number;
     member?: MemberHandle;
     payload?: unknown;
 }
@@ -595,15 +595,20 @@ export interface RunState {
  * leader 大脑逻辑(怎么规划、派谁)仍留 qlogicagent,只写"计划"、不持久化"进度记录"(P5)。
  */
 export interface RunStateStore {
-    openRun(kind: "solo" | "product" | "goal", owner: SessionContext): RunId;
+    /** Optional caller-selected domain id keeps Solo/Product/Goal public ids identical to host run ids. */
+    openRun(kind: "solo" | "product" | "goal", owner: SessionContext, runId?: RunId): RunId;
     recordEvent(runId: RunId, ev: RunEvent): void;
     /** product/solo 检查点 */
-    checkpoint(runId: RunId, snapshot: unknown): void;
+    checkpoint(runId: RunId, snapshot: unknown, checkpointId?: string): void;
+    getCheckpoint(runId: RunId, checkpointId: string): unknown | undefined;
+    listCheckpoints(runId: RunId): string[];
+    restoreCheckpoint(runId: RunId, checkpointId: string): unknown | undefined;
     getRun(runId: RunId): RunState;
     listRuns(filter: {
         projectId: ProjectId;
         kind?: string;
     }): RunState[];
+    deleteRun(runId: RunId): boolean;
 }
 export interface EvBase {
     /** 由 relay 合成(今天线上无 handle,只有 agentId+sessionId+delegationId 关联;R1) */
@@ -786,6 +791,18 @@ export interface HostNotificationSink {
  */
 export declare const HOST_MEMORY_PROXY_METHODS: readonly ["search", "addText", "embedText", "ingestExtracted", "proposeExtracted", "consumePendingProposals", "feedback", "findRelatedEvents", "synthesizeTimeline", "getActivitySummary", "getAllProfiles", "setProfile", "getAtlas", "setMemoryArchived", "triggerDecay", "resolveConflicts"];
 export type HostMemoryProxyMethod = (typeof HOST_MEMORY_PROXY_METHODS)[number];
+/** Project-scoped Markdown memory face. Gateway resolves cwd/project from the supervised caller. */
+export declare const HOST_PROJECT_MEMORY_PROXY_METHODS: readonly ["initialize", "getIndex", "addToIndex", "replaceInIndex", "removeFromIndex", "createFile", "writeFile", "readFile", "deleteFile", "listFiles", "searchLocal"];
+export type HostProjectMemoryProxyMethod = (typeof HOST_PROJECT_MEMORY_PROXY_METHODS)[number];
+export interface HostProjectMemoryIndexSnapshot {
+    raw: string;
+    prompt: string;
+    usage: {
+        chars: number;
+        lines: number;
+        percent: number;
+    };
+}
 /** [X7-C1a] Capability 大脑代理当前只开放两个只读方法；写面与 connector 尚未入约。 */
 export declare const HOST_CAPABILITY_PROXY_METHODS: readonly ["getSkillSnapshot", "readSkillFile", "recordSkillInvocation", "commitSkillMutation", "applyCuratorPlan", "prepareSkillInstall", "finalizeSkillInstall"];
 export type HostCapabilityProxyMethod = (typeof HOST_CAPABILITY_PROXY_METHODS)[number];
@@ -1061,10 +1078,15 @@ export interface HostSkillInvocationResult {
 /** 单文件读取上限；host 在解码前按 bytes 检查。 */
 export declare const HOST_SKILL_FILE_MAX_BYTES: number;
 /** [X7-P] 单一 agent→host 一元请求通道的服务域。 */
-export type HostRequestService = "memory" | "profile" | "preview" | "capability" | "session" | "feedback" | "project";
+export type HostRequestService = "memory" | "projectMemory" | "profile" | "preview" | "capability" | "session" | "feedback" | "project" | "runState" | "pet";
 /** Preview Browser 的七个允许动作；tool 与 gateway 必须消费此单源。 */
 export declare const PREVIEW_BROWSER_ACTIONS: readonly ["navigate", "snapshot", "click", "type", "screenshot", "console", "network"];
 export type PreviewBrowserAction = (typeof PREVIEW_BROWSER_ACTIONS)[number];
+export declare const PREVIEW_BROWSER_MUTATION_ACTIONS: readonly ["navigate", "click", "type"];
+export declare const PREVIEW_BROWSER_READ_ACTIONS: readonly ["snapshot", "screenshot", "console", "network"];
+/** Canonical identity for a built-in preview WebContentsView. */
+export type PreviewTargetKey = `preview:${number}`;
+export declare function isPreviewTargetKey(value: unknown): value is PreviewTargetKey;
 /** 每个 preview action 的精确 payload；禁止把任意 Electron IPC method/params 暴露给 agent。 */
 export interface PreviewBrowserActionParams {
     navigate: {
@@ -1106,12 +1128,65 @@ export interface PreviewBrowserDriveResult {
     screenshotB64?: string;
     error?: string;
     details?: unknown;
+    targetKey?: PreviewTargetKey;
+    refGeneration?: number;
 }
 export type HostMemoryRequestParams = {
     service: "memory";
     method: HostMemoryProxyMethod;
     params: unknown[];
 };
+export type HostProjectMemoryRequestParams = {
+    service: "projectMemory";
+    method: "initialize" | "getIndex" | "listFiles";
+    params: {
+        sessionId: string;
+    };
+} | {
+    service: "projectMemory";
+    method: "addToIndex";
+    params: {
+        sessionId: string;
+        content: string;
+    };
+} | {
+    service: "projectMemory";
+    method: "replaceInIndex";
+    params: {
+        sessionId: string;
+        oldText: string;
+        newText: string;
+    };
+} | {
+    service: "projectMemory";
+    method: "removeFromIndex";
+    params: {
+        sessionId: string;
+        oldText: string;
+    };
+} | {
+    service: "projectMemory";
+    method: "createFile" | "writeFile";
+    params: {
+        sessionId: string;
+        name: string;
+        content: string;
+    };
+} | {
+    service: "projectMemory";
+    method: "readFile" | "deleteFile";
+    params: {
+        sessionId: string;
+        name: string;
+    };
+} | {
+    service: "projectMemory";
+    method: "searchLocal";
+    params: {
+        sessionId: string;
+        query: string;
+    };
+};
 export type HostSessionRequestParams = {
     service: "session";
     method: "loadForResume";
@@ -1209,6 +1284,89 @@ export type HostFeedbackRequestParams = {
         projectId: ProjectId;
     };
 };
+/** Agent-originated semantic run-state operations. Owner/project/cwd are resolved by Gateway scope. */
+export declare const HOST_RUN_STATE_PROXY_METHODS: readonly ["open", "recordEvent", "checkpoint", "get", "list", "delete", "getCheckpoint", "listCheckpoints", "restoreCheckpoint"];
+export type HostRunStateProxyMethod = typeof HOST_RUN_STATE_PROXY_METHODS[number];
+export type HostRunStateRequestParams = {
+    service: "runState";
+    method: "open";
+    params: {
+        runId: RunId;
+        kind: "solo" | "product" | "goal";
+        projectId: ProjectId;
+        sessionId: CanonicalSessionId;
+    };
+} | {
+    service: "runState";
+    method: "recordEvent";
+    params: {
+        runId: RunId;
+        event: Omit<RunEvent, "member">;
+        sessionId: CanonicalSessionId;
+    };
+} | {
+    service: "runState";
+    method: "checkpoint";
+    params: {
+        runId: RunId;
+        checkpointId?: string;
+        snapshot: unknown;
+        sessionId: CanonicalSessionId;
+    };
+} | {
+    service: "runState";
+    method: "get";
+    params: {
+        runId: RunId;
+        sessionId: CanonicalSessionId;
+    };
+} | {
+    service: "runState";
+    method: "list";
+    params: {
+        projectId: ProjectId;
+        kind?: "solo" | "product" | "goal";
+        sessionId: CanonicalSessionId;
+    };
+} | {
+    service: "runState";
+    method: "delete";
+    params: {
+        runId: RunId;
+        sessionId: CanonicalSessionId;
+    };
+} | {
+    service: "runState";
+    method: "getCheckpoint" | "restoreCheckpoint";
+    params: {
+        runId: RunId;
+        checkpointId: string;
+        sessionId: CanonicalSessionId;
+    };
+} | {
+    service: "runState";
+    method: "listCheckpoints";
+    params: {
+        runId: RunId;
+        sessionId: CanonicalSessionId;
+    };
+};
+export declare const HOST_PET_PROXY_METHODS: readonly ["isActive", "getSoul", "awardXp", "journeyCatchUp"];
+export type HostPetProxyMethod = typeof HOST_PET_PROXY_METHODS[number];
+export type HostPetRequestParams = {
+    service: "pet";
+    method: "isActive" | "getSoul" | "journeyCatchUp";
+    params: {
+        sessionId: CanonicalSessionId;
+    };
+} | {
+    service: "pet";
+    method: "awardXp";
+    params: {
+        event: string;
+        sessionId: CanonicalSessionId;
+    };
+};
 /** Agent-originated profile store calls. UI/provider surfaces are intentionally excluded. */
 export declare const HOST_PROFILE_PROXY_METHODS: readonly ["getTunables", "updateTunable", "clearTunable", "appendDirectoryAllowRule"];
 export type HostProfileProxyMethod = typeof HOST_PROFILE_PROXY_METHODS[number];
@@ -1425,7 +1583,7 @@ export type HostPreviewRequestParams = {
  * [X7-P] 跨进程 HostRequest 判别联合。memory/profile/preview 共用 `x/host.request`，
  * service + method 二级分派；preview 的 method 与 payload 在类型层保持逐动作关联。
  */
-export type HostRequestParams = HostMemoryRequestParams | HostProfileRequestParams | HostPreviewRequestParams | HostCapabilityRequestParams | HostSessionRequestParams | HostFeedbackRequestParams | HostProjectRequestParams;
+export type HostRequestParams = HostMemoryRequestParams | HostProjectMemoryRequestParams | HostProfileRequestParams | HostPreviewRequestParams | HostCapabilityRequestParams | HostSessionRequestParams | HostFeedbackRequestParams | HostProjectRequestParams | HostRunStateRequestParams | HostPetRequestParams;
 /** initialize 声明的真实已装配 host-request 服务；version 只接受冻结版本 1。 */
 export type HostRequestCapability = {
     version: 1;

package/dist/types/orchestration/agent-instance.d.ts

@@ -11,7 +11,6 @@
  *   4. product.resume → load state, resume scheduling
  *   5. product.checkpoint → manual checkpoint
  */
-import type { AgentProcessManager } from "../runtime/infra/agent-process.js";
 import type { AcpDetector } from "../runtime/infra/acp-detector.js";
 import type { AgentConfigStore } from "../runtime/infra/agent-config-store.js";
 import type { ProductPhase, ProductCreateParams, ProductStatus, ProductSummary } from "../protocol/wire/acp-agent-management.js";
@@ -82,13 +81,12 @@ export declare function buildTaskContextPrompt(upstream: {
     output: string;
 }[], prompt: string): string;
 export declare class ProductOrchestrator {
-    private processManager;
     private acpDetector;
     private configStore;
     private callbacks;
     private leaderCoordinator?;
     private sessions;
-    constructor(processManager: AgentProcessManager, acpDetector: AcpDetector, configStore: AgentConfigStore | null, callbacks?: ProductCallbacks, leaderCoordinator?: ProductLeaderCoordinator | undefined);
+    constructor(acpDetector: AcpDetector, configStore: AgentConfigStore | null, callbacks?: ProductCallbacks, leaderCoordinator?: ProductLeaderCoordinator | undefined);
     setLeaderCoordinator(leaderCoordinator: ProductLeaderCoordinator): void;
     /** (a) Owner global cheat-sheet source for member dispatches (cli-injected;
      * orchestration never imports skills directly). */

package/dist/types/orchestration/goal-mode-adapters.d.ts

@@ -1,4 +1,3 @@
-import type { AgentProcessManager } from "../runtime/infra/agent-process.js";
 import type { AcpDetector } from "../runtime/infra/acp-detector.js";
 import type { DelegateBridge } from "./delegation-coordinator.js";
 import { type PlannerMemoryContext } from "./planner-memory-brief.js";
@@ -49,8 +48,6 @@ export declare function takeGoalPhaseChangedFiles(productId: string): string[];
  */
 export declare function extractJson<T>(text: string): T;
 export interface LeaderAdapterDeps {
-    /** Same transport ProductPlanner.sendToLeader uses (product-planner.ts:579). */
-    processManager: AgentProcessManager;
     /** Resolves the leader's external ACP descriptor (product-planner.ts:583). */
     acpDetector: AcpDetector;
     /** Catalog id of the leader agent (e.g. "qlogicagent"). */

package/dist/types/orchestration/goal-run-persistence.d.ts

@@ -3,9 +3,6 @@ import type { GoalRunEvent, PersistedGoalRunState } from "./goal-run-types.js";
 export interface GoalPersistenceOptions {
     pathService?: PathService;
 }
-export declare function getGoalDir(goalRunId: string, cwd?: string, o?: GoalPersistenceOptions): string;
-export declare function getEventsPath(goalRunId: string, cwd?: string, o?: GoalPersistenceOptions): string;
-export declare function getSnapshotPath(goalRunId: string, cwd?: string, o?: GoalPersistenceOptions): string;
 /** Append one event as a fsync'd JSON line (the durable source of truth). */
 export declare function appendGoalRunEvent(goalRunId: string, event: GoalRunEvent, cwd?: string, o?: GoalPersistenceOptions): Promise<void>;
 export declare function readGoalRunEvents(goalRunId: string, cwd?: string, o?: GoalPersistenceOptions): Promise<GoalRunEvent[]>;

package/dist/types/orchestration/product-persistence.d.ts

@@ -1,8 +1,5 @@
 /**
- * Product Persistence — read/write Product Mode state to disk.
- *
- * State is stored at `<project>/.qlogicagent/products/<productId>/product-state.json`.
- * Product listing is done by enumerating subdirectories.
+ * Product persistence facade over the Gateway-owned RunStateStore.
  */
 import type { PathService } from "../runtime/ports/index.js";
 import type { ProductPhase, ProductInstanceDef } from "../protocol/wire/acp-agent-management.js";

package/dist/types/orchestration/product-planner.d.ts

@@ -23,7 +23,6 @@
  *   - CrewAI: checkpoint serialization (mid-task state)
  *   - LangGraph: durable execution (persist after each node)
  */
-import type { AgentProcessManager } from "../runtime/infra/agent-process.js";
 import type { AcpDetector } from "../runtime/infra/acp-detector.js";
 import type { AgentConfigStore } from "../runtime/infra/agent-config-store.js";
 import type { DelegateBridge } from "./delegation-coordinator.js";
@@ -40,6 +39,7 @@ export interface PlanningSession {
     cwd: string;
     leaderAgentId: string;
     leaderMemberId?: string;
+    activeDelegationId?: string;
     phase: PlanningPhase;
     plan?: ProductPlan;
     /** Multi-turn conversation history during planning. */
@@ -105,12 +105,11 @@ export interface DagMutation {
     details?: Record<string, unknown>;
 }
 export declare class ProductPlanner {
-    private processManager;
     private acpDetector;
     private configStore;
     private callbacks;
     private sessions;
-    constructor(processManager: AgentProcessManager, acpDetector: AcpDetector, configStore: AgentConfigStore | null, callbacks?: PlannerCallbacks);
+    constructor(acpDetector: AcpDetector, configStore: AgentConfigStore | null, callbacks?: PlannerCallbacks);
     /**
      * Start an interactive planning session (Phase 1).
      * Spawns the leader agent and begins multi-turn dialogue.

package/dist/types/orchestration/run-state-host-authority.d.ts

@@ -0,0 +1,7 @@
+import type { HostRunStateClient } from "../transport/host-run-state-client.js";
+export interface HostRunStateAuthority {
+    client: HostRunStateClient;
+    sessionId: string;
+}
+export declare function configureHostRunStateAuthority(resolver: (() => HostRunStateAuthority | undefined) | null): void;
+export declare function requireHostRunStateAuthority(): HostRunStateAuthority;

package/dist/types/orchestration/solo-evaluator.d.ts

@@ -18,11 +18,11 @@
  *
  * Degradation: if K agents fail but ≥1 succeeds, session remains interactive.
  */
-import type { AgentProcessManager } from "../runtime/infra/agent-process.js";
 import type { AcpDetector } from "../runtime/infra/acp-detector.js";
 import type { AgentConfigStore } from "../runtime/infra/agent-config-store.js";
 import type { DelegateBridge } from "./delegation-coordinator.js";
 import type { SoloState, SoloAgentState, SoloEvaluation, SoloStatus, SoloStartParams, SoloSelectParams, SoloSpec } from "../protocol/wire/acp-agent-management.js";
+export declare function deriveSoloDelegateProjectId(registeredProjectRoot: string): string;
 export interface SoloCallbacks {
     log?: {
         info(msg: string): void;
@@ -75,11 +75,10 @@ export declare function buildEvaluationPrompt(originalTask: string, spec: SoloSp
     diff?: string;
 }>): string;
 export declare class SoloEvaluator {
-    private processManager;
     private configStore;
     private callbacks;
     private sessions;
-    constructor(processManager: AgentProcessManager, _acpDetector: AcpDetector, configStore: AgentConfigStore | null, callbacks?: SoloCallbacks);
+    constructor(_acpDetector: AcpDetector, configStore: AgentConfigStore | null, callbacks?: SoloCallbacks);
     /** Persist current session data to disk (fire-and-forget). */
     private persistSession;
     /** Restore sessions from disk (call once at startup). */

package/dist/types/orchestration/solo-persistence.d.ts

@@ -1,8 +1,5 @@
 /**
- * Solo Persistence — read/write Solo Mode state to disk.
- *
- * State is stored at `<project>/.qlogicagent/solos/<soloId>/solo-state.json`.
- * Mirrors the product-persistence.ts pattern.
+ * Solo persistence facade over the Gateway-owned RunStateStore.
  */
 import type { PathService } from "../runtime/ports/index.js";
 import type { SoloState, SoloAgentState, SoloEvaluation, SoloSpec } from "../protocol/wire/acp-agent-management.js";
@@ -40,11 +37,11 @@ export interface PersistedSoloState {
 export interface SoloPersistenceOptions {
     pathService?: PathService;
 }
-/** Save solo state to disk. */
+/** Save the latest Solo snapshot through Gateway authority. */
 export declare function saveSoloState(state: PersistedSoloState, cwd?: string, options?: SoloPersistenceOptions): Promise<void>;
-/** Load solo state from disk. Returns undefined if not found. */
+/** Load the latest Solo snapshot from Gateway authority. */
 export declare function loadSoloState(soloId: string, cwd?: string, options?: SoloPersistenceOptions): Promise<PersistedSoloState | undefined>;
 /** List all solo session IDs with their persisted state. */
 export declare function listSoloSessions(cwd?: string, options?: SoloPersistenceOptions): Promise<PersistedSoloState[]>;
-/** Delete solo state from disk. */
+/** Delete a Solo run through Gateway authority. */
 export declare function deleteSoloState(soloId: string, cwd?: string, options?: SoloPersistenceOptions): Promise<boolean>;

package/dist/types/orchestration/testing/delegate-test-bridge.d.ts

@@ -1,4 +1,15 @@
-import type { AgentProcessManager } from "../../runtime/infra/agent-process.js";
 import type { DelegateBridge } from "../delegation-coordinator.js";
+interface LegacyTurnFixture {
+    sendTask(memberId: string, prompt: string, options?: {
+        timeout?: number;
+    }): Promise<unknown>;
+    getUsageTracker?(memberId: string): {
+        getUsage(): {
+            inputTokens: number;
+            outputTokens: number;
+        };
+    } | null;
+}
 /** Test-only adapter for migrating orchestration fixtures from the retired local spawn lane. */
-export declare function makeDelegateTestBridge(processManager: AgentProcessManager): DelegateBridge;
+export declare function makeDelegateTestBridge(processManager: LegacyTurnFixture): DelegateBridge;
+export {};

package/dist/types/orchestration/workflow/node-schema.d.ts

@@ -147,11 +147,12 @@ export interface ExecutorHost {
     waitWebhook?(req: WebhookWaitHostRequest): Promise<Record<string, unknown>>;
 }
 export interface AgentHostRequest {
-    agentId?: string;
+    agentId: string;
     prompt: string;
     input: DataItem[];
     signal?: AbortSignal;
 }
+export declare function requireWorkflowAgentId(value: unknown): string;
 export interface ModelHostRequest {
     prompt: string;
     modelHint?: string;

package/dist/types/orchestration/workflow/qla-executor-host.d.ts

@@ -14,7 +14,7 @@ import type { ExecutorHost, ToolHostRequest, MemoryHostRequest, SubworkflowHostR
 export interface QlaExecutorHostDeps {
     /** Run one agent turn (spawn external ACP agent + sendTask). Returns the agent's text output. */
     runAgent: (req: {
-        agentId?: string;
+        agentId: string;
         prompt: string;
         signal?: AbortSignal;
     }) => Promise<string>;

package/dist/types/orchestration/workflow/workflow-bundle.d.ts

@@ -10,7 +10,7 @@
  *    graph references, so an importer (or the Hub apply checklist) can verify bindings
  *    BEFORE activating instead of failing mid-run.
  */
-import type { WorkflowDef } from "./node-schema.js";
+import { type WorkflowDef } from "./node-schema.js";
 import type { TriggerDef } from "./workflow-trigger.js";
 import type { ConcurrencyPolicy, WorkflowRecord } from "./workflow-store.js";
 export declare const WORKFLOW_BUNDLE_SCHEMA_VERSION = 2;

package/dist/types/project-memory-host.d.ts

@@ -0,0 +1,3 @@
+/** Gateway-owned project-memory implementation. qlogicagent production code must consume the X7 proxy. */
+export { Memdir } from "./skills/memory/memdir.js";
+export type { MemdirFileInfo, MemdirResult } from "./skills/memory/memdir.js";

package/dist/types/protocol/wire/acp-agent-management.d.ts

@@ -75,7 +75,7 @@ export interface AgentInstallSpec {
 }
 /**
  * Extended descriptor for external agents,
- * used internally by AgentProcessManager to spawn.
+ * used by the Gateway Supervisor when resolving an agent.
  */
 export interface ExternalAgentDescriptor {
     /** Backend ID. */

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

@@ -97,7 +97,7 @@ export interface AcpHostCapabilities {
 }
 /** Agent capabilities declared in the initialize response. */
 export interface AcpAgentCapabilities {
-    /** Standard (agent-process reads it; implemented in subproject 2). */
+    /** Standard ACP capability consumed by the Gateway Supervisor. */
     loadSession?: boolean;
     /** Standard (used when reading third-party agents like copilot). */
     promptCapabilities?: Record<string, unknown>;

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

@@ -117,5 +117,7 @@ export interface ToolDefinition {
         isEgress?: boolean;
         /** Egress carries user data (true) vs. read-only external query (false). */
         egressCarriesData?: boolean;
+        /** Tool-specific foreground execution deadline used by the agent scheduler. */
+        executionTimeoutMs?: number;
     };
 }

package/dist/types/runtime/execution/streaming-tool-executor.d.ts

@@ -39,6 +39,8 @@ export interface StreamingToolExecutorConfig {
     maxConcurrentTools?: number;
     /** Per foreground tool deadline. 0 or undefined means no executor deadline. */
     maxExecutionMs?: number;
+    /** Optional per-tool deadlines; entries override maxExecutionMs for that tool only. */
+    executionTimeoutMsByTool?: ReadonlyMap<string, number>;
 }
 /**
  * Executes tools with concurrency control and streaming progress.

package/dist/types/runtime/infra/acp-detector.d.ts

@@ -220,7 +220,7 @@ export declare class AcpDetector {
      */
     private buildSelfDescriptor;
     /**
-     * Build an ExternalAgentDescriptor suitable for AgentProcessManager.spawn().
+     * Build an ExternalAgentDescriptor suitable for Gateway Supervisor resolution.
      * Returns null if the agent is not available.
      */
     buildExternalDescriptor(agentId: string): import("../../protocol/wire/acp-agent-management.js").ExternalAgentDescriptor | null;

package/dist/types/runtime/infra/background-tasks.d.ts

@@ -67,7 +67,7 @@ export interface TaskOutputSnapshot {
 }
 /**
  * Control surface for a task whose EXECUTION lives outside this manager — e.g. a
- * team-member subprocess owned by AgentProcessManager. The manager holds the task
+ * supervised team-member process. The Gateway holds the task
  * in the unified panel (list/output/cancel) and routes those three actions here;
  * lifecycle settlement is driven by the owner via settleExternalTask().
  */

package/dist/types/runtime/pet/pet-community-assets.d.ts

@@ -1,31 +1,21 @@
 import type { CommunityInstallResolution } from "../community/community-consent-client.js";
-import { type PetdexPetAssetSummary } from "./petdex-asset.js";
-export interface InstalledCommunityPet {
+export interface CommunityPetAdoptionProposal {
     kind: "pet";
-    status: "installed";
+    mode: "gateway-adoption";
     resourceId: string;
     version: string;
     checksum: string;
-    /** Petdex asset id now registered in profile.customPets. */
     assetId: string;
     name: string;
-    /** Materialized petdex summary (atlas imageUrl = spritesheet data URL) for instant UI hydration. */
-    asset: PetdexPetAssetSummary;
+    fileName: string;
+    /** Validated, provenance-normalized .petdex bytes. Only Gateway may adopt these bytes. */
+    packageBase64: string;
 }
 export interface InstallCommunityPetOptions {
     fetchFn?: typeof fetch;
     /** Replace an existing install in place (update flow). Petdex upsert is idempotent, so this is accepted for dispatcher parity. */
     allowReplace?: boolean;
-    /** Owner whose profile receives the pet; defaults to the active runtime owner. */
-    ownerUserId?: string;
 }
-/**
- * Materialize a community pet end to end: download the gzipped `.petdex` package,
- * verify size + whole-package sha256, gunzip + load + validate the petdex atlas, then
- * register it into `profile.customPets` with `source.kind="community"` — the exact same
- * registration upload/forge use. From that moment `pet.status` includes it and the desktop
- * pet can render the sprite. (Previously this wrote a stripped manifest that never reached
- * the profile, so installed community pets were invisible in the settings pet list.)
- */
-export declare function installCommunityPetResource(install: CommunityInstallResolution, options?: InstallCommunityPetOptions): Promise<InstalledCommunityPet>;
+/** Download, verify, validate, and normalize a community PET into an inert Gateway adoption proposal. */
+export declare function installCommunityPetResource(install: CommunityInstallResolution, options?: InstallCommunityPetOptions): Promise<CommunityPetAdoptionProposal>;
 export declare function assertPetInstall(install: CommunityInstallResolution): void;

package/dist/types/runtime/pet/petdex-vision-qa.d.ts

@@ -0,0 +1,12 @@
+export interface PetdexVisionVerdict {
+    ok: boolean;
+    reason: string;
+    qaSkipped?: boolean;
+}
+export interface PetdexVisionQaContext {
+    label: string;
+    target: string;
+}
+/** Lenient parse: only an explicit FAIL blocks ambiguous model output. */
+export declare function parsePetdexVisionVerdict(text: string): PetdexVisionVerdict;
+export declare function runPetdexVisionQa(call: () => Promise<string>, context: PetdexVisionQaContext, log?: (message: string) => void): Promise<PetdexVisionVerdict>;

package/dist/types/runtime/ports/agent-runtime-ports.d.ts

@@ -39,6 +39,7 @@ export interface StreamingToolExecutorPortConfig {
     signal?: AbortSignal;
     maxConcurrentTools?: number;
     maxExecutionMs?: number;
+    executionTimeoutMsByTool?: ReadonlyMap<string, number>;
     /** Turn workspace/cwd — routes oversized tool-result spillover to the session's reachable data dir. */
     projectRoot?: string;
 }

package/dist/types/runtime/ports/memory-recall-source.d.ts

@@ -1,3 +1,13 @@
 export interface MemoryRecallSource {
     getRootPath(): string;
+    searchLocal(query: string): Promise<Array<{
+        file: string;
+        snippet: string;
+        score: number;
+    }>>;
+    readFile(name: string): Promise<{
+        ok: boolean;
+        content?: string;
+        message: string;
+    }>;
 }

package/dist/types/runtime/ports/project-memory-store.d.ts

@@ -12,7 +12,7 @@ export interface ProjectMemoryResult {
 }
 export interface ProjectMemoryStore {
     getRootPath(): string;
-    ensureInitialized(): void;
+    ensureInitialized(): void | Promise<void>;
     getIndexForPrompt(): string;
     getIndexRaw(): string;
     getIndexUsage(): {

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

@@ -1,13 +1,12 @@
 /**
  * Session persistence authority facade.
  *
- * 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.
+ * Every durable read/write goes through HostSessionClient. Standalone/local persistence is not a
+ * supported runtime mode after the S3 state-inversion cut.
  */
 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 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;

package/dist/types/skills/memory/host-memory-provider.d.ts

@@ -1,7 +1,7 @@
 /**
  * HostMemoryProvider —— qlogicagent 大脑对 memories.db 的存取反转(Route B B3;X7 brain proxy)。
  *
- * 与 LocalMemoryProvider 同公开面的 **proxy 实现**:大脑逻辑(dream/distill/晋升/consolidation/召回 hook)
+ * Gateway Memory 权威公开面的 **proxy 实现**:大脑逻辑(dream/distill/晋升/consolidation/召回 hook)
  * 零改动,底下的存取经 `x/host.request`(HostRequestClient)打到 gateway 四权威 host 服务(memory 域),
  * store(memories.db)只有 gateway 进程打开。
  *
@@ -144,5 +144,5 @@ export declare class HostMemoryProvider implements MemoryRuntimeHookProvider, Me
     readAttachmentBytes(_id: string): never;
     setAttachmentText(_id: string, _text: string): never;
 }
-/** 工厂便捷函数(与 createLocalMemoryProvider 对称)。 */
+/** Host Memory proxy 工厂。 */
 export declare function createHostMemoryProvider(config: HostMemoryProviderConfig): HostMemoryProvider;