qlogicagent 2.18.12 → 2.19.2

package/dist/types/cli/product-coordinator.d.ts

@@ -1,22 +1,11 @@
 import { ProductOrchestrator } from "../orchestration/agent-instance.js";
 import { ProductPlanner } from "../orchestration/product-planner.js";
-import type { DelegateBridge } from "../orchestration/delegation-coordinator.js";
-import type { AgentConfigStore } from "../runtime/infra/agent-config-store.js";
-import type { AcpDetector } from "../runtime/infra/acp-detector.js";
+import type { DelegateBridge } from "../orchestration/delegate-bridge.js";
+import type { HostAgentProviderDirectory } from "../runtime/infra/host-agent-provider-directory.js";
 export interface ProductCoordinatorHost {
-    acpDetector: AcpDetector;
-    agentConfigStore: AgentConfigStore | null;
+    providerDirectory: HostAgentProviderDirectory;
     productOrchestrator: ProductOrchestrator | null;
     productPlanner: ProductPlanner | null;
-    emitAgentStatus(agentId: string, state: string, extra?: {
-        missedBeats?: number;
-        lastActivityAt?: number;
-        usage?: {
-            inputTokens: number;
-            outputTokens: number;
-            totalTokens: number;
-        };
-    }): void;
     handleMcpToolCall(memberId: string, tool: string, args: Record<string, unknown>): Promise<unknown>;
     sendNotification(method: string, params: Record<string, unknown>): void;
     /** 激活层(S3c):gateway-routed delegate 桥(gate 关/未挂 = undefined → 旧本地 spawn 路径)。 */

package/dist/types/cli/rpc-registry.d.ts

@@ -5,7 +5,6 @@ import { type ControlHandlerHost } from "./handlers/control-handler.js";
 import { type FilesHandlerHost } from "./handlers/files-handler.js";
 import { type MediaHandlerHost } from "./handlers/media-handler.js";
 import { type MemoryHandlerHost } from "./handlers/memory-handler.js";
-import { type ProjectHandlerHost } from "./handlers/project-handler.js";
 import { type SessionHandlerHost } from "./handlers/session-handler.js";
 import { type SkillsHandlerHost } from "./handlers/skills-handler.js";
 import { type TurnBaselineHandlerHost } from "./handlers/turn-baseline-handler.js";
@@ -50,7 +49,6 @@ export interface RpcHandlerHosts {
     files: FilesHandlerHost;
     media: MediaHandlerHost;
     skills: SkillsHandlerHost;
-    project: ProjectHandlerHost;
     community: CommunityHandlerHost;
     dream: DreamHandlerHost;
     turn: TurnControlHandlerHost;

package/dist/types/cli/stdio-rpc-handler-hosts.d.ts

@@ -1,10 +1,13 @@
 import type { LLMRequest } from "../agent/types.js";
 import type { ModelPurpose } from "../runtime/infra/model-registry.js";
 import type { RpcHandlerHosts } from "./rpc-registry.js";
-type DirectStdioRpcHost = RpcHandlerHosts["config"] & RpcHandlerHosts["control"] & RpcHandlerHosts["files"] & RpcHandlerHosts["skills"] & RpcHandlerHosts["project"] & RpcHandlerHosts["community"] & {
+type DirectStdioRpcHost = RpcHandlerHosts["config"] & RpcHandlerHosts["control"] & RpcHandlerHosts["files"] & RpcHandlerHosts["skills"] & RpcHandlerHosts["community"] & {
     currentTurnId?: string;
     /** Mid-turn guidance queue (运行中引导) — shared between handleTurnGuide and the tool loop's drain. */
     pendingTurnGuidance?: string[];
+    memdir: RpcHandlerHosts["memory"]["memdir"];
+    projectMemoryStoreFactory: RpcHandlerHosts["memory"]["projectMemoryStoreFactory"];
+    setActiveWorkdir(dir: string): void;
     getActiveProjectRoot(): string;
     readonly multiAgentHandlerHost: RpcHandlerHosts["multiAgent"];
 };

package/dist/types/cli/stdio-server.d.ts

@@ -122,6 +122,7 @@ export declare class StdioServer {
     getHostProfileClient(): HostProfileClient | undefined;
     /** Thin read-only facade; consumers fail loudly when the host did not advertise capability. */
     getHostCapabilityClient(): HostCapabilityClient | undefined;
+    getHostAgentProviderDirectory(): import("../runtime/infra/host-agent-provider-directory.js").HostAgentProviderDirectory;
     /** Session durable-state facade; absent under gate-off/standalone so compatibility stays inert. */
     getHostSessionClient(): HostSessionClient | undefined;
     /** D2 telemetry/feedback business facade; durable storage remains gateway-only. */
@@ -223,8 +224,6 @@ export declare class StdioServer {
     ensureTaskDistillation(): TaskDistillationCoordinator;
     resolveAgent(config: TurnConfig): Agent | null;
     private invalidateResolvedLlmCache;
-    /** Emit an `agents.status` notification when a child process state changes. */
-    private emitAgentStatus;
     createDreamHandlerHost(): import("./handlers/dream-handler.js").DreamHandlerHost;
     private createAcpExtendedHandlerHost;
     /**

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

@@ -11,6 +11,9 @@
  * 标注 [S1 补定] 的辅助类型是 freeze 引用但未给定义的最小结构,属 S1 评审点,
  * 其字段以 freeze 正文/recon 注释为据;实现 lane 负责与现状 store 形状做映射。
  */
+import type { NativeTranscript } from "../host-session-collection-contract.js";
+export type { HostSessionCollectionDelta, HostSessionCollectionScope, HostSessionCollectionSnapshot, HostSessionLifecycle, HostSessionProviderDiagnostic, HostSessionSummary, HostSessionTitleSource, NativeTranscript, NativeTranscriptMessage, } from "../host-session-collection-contract.js";
+export { isHostSessionCollectionDelta, isHostSessionCollectionSnapshot, isNativeTranscript, } from "../host-session-collection-contract.js";
 export * from "./provider-profile.js";
 /** agent 逻辑身份(小智自身也是一个 agentId="qlogicagent")。自身 vs 第三方仅由此值决定(F2)。 */
 export type AgentId = string;
@@ -71,7 +74,8 @@ export type AgentInstanceState = "starting" | "ready" | "busy" | "unresponsive"
  * 结构化失败归类(freeze §4 E3:失败一律结构化明示,不得降级成裸 error 串)。
  * UNKNOWN = 无法归类时的显式兜底:禁止硬塞错误 code,也禁止因归不了类降级成裸串。
  */
-export type LifecycleCode = "CANCELLED" | "PROCESS_EXIT" | "HEARTBEAT_TIMEOUT" | "TURN_TIMEOUT" | "UNKNOWN";
+export declare const LIFECYCLE_CODES: readonly ["CANCELLED", "PROCESS_EXIT", "HEARTBEAT_TIMEOUT", "TURN_TIMEOUT", "PROTOCOL_MISMATCH", "UNKNOWN"];
+export type LifecycleCode = (typeof LIFECYCLE_CODES)[number];
 /**
  * 确定性派生 projectId —— host-contract leaf 内的唯一实现(project-id.ts):
  * sha256(resolve(workspaceDir).toLowerCase()).hex[:16]。
@@ -202,7 +206,7 @@ export interface SessionMeta {
     /** 主 agent(创建即锁定,severe 禁中途切换) */
     agentId: AgentId;
     cwd: string;
-    /** 每 native agent 的原生会话 id 映射(现状单 nativeBinding 由 importer 迁入,见 N2) */
+    /** 每 native agent 的原生会话 id 映射(现状旧单值映射由 importer 迁入,见 N2) */
     nativeSessionIds?: Record<AgentId, string>;
     lifecycle: string;
 }
@@ -212,22 +216,36 @@ export interface NativeSessionSummary {
     updatedAt: number;
     title?: string;
 }
-/**
- * 原生会话索引提供者(codex-index 上移网关):按 agentId 读该 agent 的 native 会话目录(~/.codex 等)。
- * 语义 = 索引/发现,NOT transcript owner(freeze §9 边界)。home/env 由 AgentDescriptor/CredentialResolver 供。
- * qlogicagent 不再承担读取点(否则 session plane 又漏回 agent)。
- */
-export interface NativeSessionIndexProvider {
-    /** 仅 native-cwd 后端(codex/claude)有 provider */
+export interface NativeProjectContext {
+    projectId: ProjectId;
+    cwd: string;
+}
+export interface NativeSessionRef {
     agentId: AgentId;
-    listNativeSessions(ctx: {
-        projectId: ProjectId;
-        cwd: string;
-    }): NativeSessionSummary[];
-    resolveNativeResumeId(sessionId: CanonicalSessionId, ctx: {
-        cwd: string;
-    }): string | undefined;
+    projectId: ProjectId;
+    nativeId: string;
 }
+export interface NativeSessionDetail extends NativeSessionSummary {
+    createdAt?: number;
+    messageCount?: number;
+}
+export interface NativeSessionProvider {
+    readonly agentId: AgentId;
+    list(ctx: NativeProjectContext): Promise<NativeSessionSummary[]>;
+    get(nativeId: string, ctx: NativeProjectContext): Promise<NativeSessionDetail | undefined>;
+    loadTranscript(nativeId: string, ctx: NativeProjectContext): Promise<NativeTranscript>;
+    exists(nativeId: string, ctx: NativeProjectContext): Promise<boolean>;
+}
+export type ProjectAgentSessionEntry = {
+    source: "host";
+    canonicalSessionId: CanonicalSessionId;
+    nativeRef?: NativeSessionRef;
+    title?: string;
+} | {
+    source: "native-unadopted";
+    nativeRef: NativeSessionRef;
+    title?: string;
+};
 /**
  * 拥有会话存储 + 项目作用域 + agentId 绑定 + canonical↔native 映射 + 生命周期状态。
  * 唯一权威(不与 qlogicagent 并存)。崩溃恢复靠网关持有并重放(freeze §11.4#5)。
@@ -673,7 +691,7 @@ export interface SupervisorEventSink {
     }): void;
     /**
      * media:统一 {mediaType,url,model,provider}(非 imageUrls[])。⚠R3:external agent 今天不发此事件
-     * (codex 图像漏成 tool_call),cutover 必须补 agents.prompt.media relay,否则 external media 无一等来源。
+     * Provider media must arrive as a first-class lifecycle event, never only as a generic tool call.
      */
     onMedia(e: EvBase & {
         mediaType: string;
@@ -1078,7 +1096,78 @@ export interface HostSkillInvocationResult {
 /** 单文件读取上限；host 在解码前按 bytes 检查。 */
 export declare const HOST_SKILL_FILE_MAX_BYTES: number;
 /** [X7-P] 单一 agent→host 一元请求通道的服务域。 */
-export type HostRequestService = "memory" | "projectMemory" | "profile" | "preview" | "capability" | "session" | "feedback" | "project" | "runState" | "pet";
+export type HostRequestService = "memory" | "projectMemory" | "profile" | "preview" | "capability" | "session" | "feedback" | "project" | "runState" | "pet" | "provider";
+/** Read-only Provider projection exposed by the Gateway Host to supervised qlogicagent compute. */
+export declare const HOST_PROVIDER_PROXY_METHODS: readonly ["list", "get", "diagnose"];
+export type HostProviderProxyMethod = typeof HOST_PROVIDER_PROXY_METHODS[number];
+export type HostAgentProviderState = "installed" | "auth_required" | "ready" | "disabled" | "incompatible" | "unresponsive" | "failed";
+export type HostAgentProviderDiagnosticState = HostAgentProviderState | "not_installed";
+export type HostAgentProviderDiagnosticStage = "install" | "manifest" | "auth" | "launch" | "initialize" | "models" | "native_sessions" | "request";
+export type HostAgentProviderModelAuthority = {
+    kind: "provider";
+    enumeration: "protocol" | "implicit-default";
+} | {
+    kind: "host";
+    managedPurposes: string[];
+};
+export interface HostAgentProviderDiagnostic {
+    providerId: string;
+    state: HostAgentProviderDiagnosticState;
+    stage: HostAgentProviderDiagnosticStage;
+    code: string;
+    message: string;
+    retryable: boolean;
+    providerVersion?: string;
+    payloadVersion?: string;
+}
+export interface HostAgentProviderSnapshot {
+    providerId: string;
+    displayName: string;
+    version: string;
+    state: HostAgentProviderState;
+    capabilities: {
+        execution: {
+            streaming: boolean;
+            approvals: boolean;
+            cancellation: boolean;
+            resume: boolean;
+        };
+        auth: {
+            modes: Array<"account" | "userKey" | "managed">;
+            terminal: boolean;
+            logout: boolean;
+        };
+        models: HostAgentProviderModelAuthority;
+        nativeSessions: {
+            discover: boolean;
+            transcript: boolean;
+            resume: boolean;
+        };
+        diagnostics: {
+            readiness: true;
+            version: true;
+            structuredErrors: true;
+        };
+    };
+    diagnostic?: HostAgentProviderDiagnostic;
+}
+export interface HostAgentProviderListResult {
+    revision: number;
+    providers: HostAgentProviderSnapshot[];
+}
+export interface HostAgentProviderGetResult {
+    revision: number;
+    provider: HostAgentProviderSnapshot | null;
+}
+export type HostProviderRequestParams = {
+    service: "provider";
+    method: "list";
+    params: [];
+} | {
+    service: "provider";
+    method: "get" | "diagnose";
+    params: [providerId: string];
+};
 /** 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];
@@ -1583,7 +1672,7 @@ export type HostPreviewRequestParams = {
  * [X7-P] 跨进程 HostRequest 判别联合。memory/profile/preview 共用 `x/host.request`，
  * service + method 二级分派；preview 的 method 与 payload 在类型层保持逐动作关联。
  */
-export type HostRequestParams = HostMemoryRequestParams | HostProjectMemoryRequestParams | HostProfileRequestParams | HostPreviewRequestParams | HostCapabilityRequestParams | HostSessionRequestParams | HostFeedbackRequestParams | HostProjectRequestParams | HostRunStateRequestParams | HostPetRequestParams;
+export type HostRequestParams = HostMemoryRequestParams | HostProjectMemoryRequestParams | HostProfileRequestParams | HostPreviewRequestParams | HostCapabilityRequestParams | HostSessionRequestParams | HostFeedbackRequestParams | HostProjectRequestParams | HostRunStateRequestParams | HostPetRequestParams | HostProviderRequestParams;
 /** initialize 声明的真实已装配 host-request 服务；version 只接受冻结版本 1。 */
 export type HostRequestCapability = {
     version: 1;
@@ -1600,6 +1689,10 @@ export declare function isHostSkillMutationResult(value: unknown): value is Host
 export declare function isHostApplyCuratorPlanResult(value: unknown): value is HostApplyCuratorPlanResult;
 export declare function isHostPrepareSkillInstallResult(value: unknown): value is HostPrepareSkillInstallResult;
 export declare function isHostFinalizeSkillInstallResult(value: unknown): value is HostFinalizeSkillInstallResult;
+export declare function isHostAgentProviderDiagnostic(value: unknown): value is HostAgentProviderDiagnostic;
+export declare function isHostAgentProviderSnapshot(value: unknown): value is HostAgentProviderSnapshot;
+export declare function isHostAgentProviderListResult(value: unknown): value is HostAgentProviderListResult;
+export declare function isHostAgentProviderGetResult(value: unknown): value is HostAgentProviderGetResult;
 export declare function isHostSessionLoadForResumeResult(value: unknown): value is HostSessionLoadForResumeResult;
 export declare function isHostSessionAppendResult(value: unknown): value is HostSessionAppendResult;
 export declare function isHostSessionMutationResult(value: unknown): value is HostSessionMutationResult;

package/dist/types/host-session-collection-contract.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Browser-safe Host session collection protocol.
+ *
+ * This is the common protocol layer shared by Gateway and renderer clients. It intentionally has
+ * no Node/runtime imports; Host services and native Providers remain behind the Gateway facade.
+ */
+import type { AgentId, CanonicalSessionId, NativeSessionRef, ProjectId } from "./host-contract/index.js";
+export type HostSessionTitleSource = "prompt" | "generated" | "user" | "native" | "repaired";
+export type HostSessionLifecycle = "active" | "archived" | "source-missing" | "resume-unavailable";
+export type HostSessionCollectionScope = {
+    kind: "project";
+    projectId: ProjectId;
+} | {
+    kind: "workspace-tree";
+};
+export interface HostSessionSummary {
+    resourceId: string;
+    canonicalSessionId?: CanonicalSessionId;
+    source: "host" | "native-unadopted";
+    projectId: ProjectId;
+    agentId: AgentId;
+    title?: string;
+    titleSource?: HostSessionTitleSource;
+    lastActiveAt: string;
+    lifecycle: HostSessionLifecycle;
+    nativeRef?: NativeSessionRef;
+}
+export interface HostSessionProviderDiagnostic {
+    agentId: AgentId;
+    projectId: ProjectId;
+    code: string;
+    message: string;
+    lastGoodRevision?: number;
+}
+export interface HostSessionCollectionSnapshot {
+    revision: number;
+    scopeGeneration: number;
+    items: HostSessionSummary[];
+    diagnostics: HostSessionProviderDiagnostic[];
+}
+export interface HostSessionCollectionDelta {
+    revision: number;
+    scopeGeneration: number;
+    addedOrUpdated?: HostSessionSummary[];
+    removed?: string[];
+    diagnostics?: HostSessionProviderDiagnostic[];
+}
+/** Provider-owned transcript wire shape. The renderer consumes this exact shape through Host RPC. */
+export interface NativeTranscriptMessage {
+    id?: string;
+    role: "user" | "assistant" | "tool";
+    content: unknown;
+    createdAt?: string;
+}
+export interface NativeTranscript {
+    messages: NativeTranscriptMessage[];
+    diagnostics?: unknown[];
+}
+export declare function isNativeTranscript(value: unknown): value is NativeTranscript;
+export declare function isHostSessionCollectionSnapshot(value: unknown): value is HostSessionCollectionSnapshot;
+export declare function isHostSessionCollectionDelta(value: unknown): value is HostSessionCollectionDelta;

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

@@ -11,27 +11,30 @@
  *   4. product.resume → load state, resume scheduling
  *   5. product.checkpoint → manual checkpoint
  */
-import type { AcpDetector } from "../runtime/infra/acp-detector.js";
-import type { AgentConfigStore } from "../runtime/infra/agent-config-store.js";
+import type { HostAgentProviderDirectory } from "../runtime/infra/host-agent-provider-directory.js";
 import type { ProductPhase, ProductCreateParams, ProductStatus, ProductSummary } from "../protocol/wire/acp-agent-management.js";
 import { type PlannerMemoryContext } from "./planner-memory-brief.js";
 import type { DagMutation } from "./product-planner.js";
 import type { ProductLeaderCoordinator } from "./product-run-coordinator.js";
-import type { DelegateBridge } from "./delegation-coordinator.js";
+import type { DelegateBridge } from "./delegate-bridge.js";
 export type { ProductLeaderCoordinator } from "./product-run-coordinator.js";
 export interface ProductCallbacks {
     log?: {
         info(msg: string): void;
         warn(msg: string): void;
     };
-    onTaskStarted?: (productId: string, taskId: string, assignee: string) => void;
-    onTaskCompleted?: (productId: string, taskId: string, result: string, meta?: {
+    onTaskStarted?: (productId: string, taskId: string, assignee: string, attempt: number) => void;
+    onTaskCompleted?: (productId: string, taskId: string, result: string, meta: {
+        attempt: number;
         inputTokens: number;
         outputTokens: number;
         changedFiles: string[];
         acceptanceUnverified?: boolean;
     }) => void;
-    onTaskFailed?: (productId: string, taskId: string, error: string) => void;
+    onTaskFailed?: (productId: string, taskId: string, error: string, meta: {
+        attempt: number;
+        terminalState: "failed" | "cancelled";
+    }) => void;
     onCheckpointed?: (productId: string, timestamp: string) => void;
     onBudgetWarning?: (productId: string, usedTokens: number, maxTotalTokens: number, percentage: number) => void;
     /** Budget hard limit hit → the run auto-paused. The 100% counterpart of onBudgetWarning (80%): the
@@ -81,12 +84,11 @@ export declare function buildTaskContextPrompt(upstream: {
     output: string;
 }[], prompt: string): string;
 export declare class ProductOrchestrator {
-    private acpDetector;
-    private configStore;
+    private providerDirectory;
     private callbacks;
     private leaderCoordinator?;
     private sessions;
-    constructor(acpDetector: AcpDetector, configStore: AgentConfigStore | null, callbacks?: ProductCallbacks, leaderCoordinator?: ProductLeaderCoordinator | undefined);
+    constructor(providerDirectory: HostAgentProviderDirectory, 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). */
@@ -139,11 +141,6 @@ export declare class ProductOrchestrator {
      * targets a successful-but-wrong task and re-runs forward from it in place.
      */
     replayTask(productId: string, taskId: string): Promise<void>;
-    /** Get product status. */
-    /** P2-1: the native (codex/claude) session id captured for a delegation's single worker, so the
-     *  DelegationCoordinator can resume it on the next same-(chat×agent) delegation. undefined for a
-     *  multi-instance product, an own agent, or before the worker's first task settles. */
-    getDelegationNativeSessionId(productId: string): string | undefined;
     getStatus(productId: string): ProductStatus | null;
     /** Live DAG progress snapshot for a product (for the planner's execution-phase leader). */
     getProgressSnapshot(productId: string): {

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

@@ -1,5 +1,5 @@
-import type { AgentRosterEntry, AgentConfigStoreData } from "../protocol/wire/acp-agent-management.js";
-import { type AcpDetector } from "../runtime/infra/acp-detector.js";
+import type { HostAgentProviderListResult } from "../host-contract/index.js";
+import type { AgentRosterEntry } from "../protocol/wire/acp-agent-management.js";
 /** Build the team roster the leader sees during planning: every ready agent with a coarse
  *  strengths hint + its backing model. Leader-only soft hints — NOT a capability contract.
  *
@@ -14,7 +14,9 @@ import { type AcpDetector } from "../runtime/infra/acp-detector.js";
  *  The leader `qlogicagent` (小智) is ALWAYS present (universal coordinator / fallback executor) — appended
  *  if not already in the roster, so the leader always has ≥1 valid assignee even when the user's picks turn
  *  out unready (or when the pool is empty). */
-export declare function buildAgentRoster(detector: AcpDetector, _configStore: AgentConfigStoreData | null, allowedAgents?: string[]): AgentRosterEntry[];
+export declare function buildAgentRoster(snapshot: Readonly<HostAgentProviderListResult>, allowedAgents?: string[], options?: {
+    injectLeader?: boolean;
+}): AgentRosterEntry[];
 /**
  * User-PICKED worker ids that did NOT make it into the roster (unready: not installed / not logged in
  * / not in the catalog). Excludes the leader (always force-included). Empty when nothing was dropped
@@ -23,7 +25,9 @@ export declare function buildAgentRoster(detector: AcpDetector, _configStore: Ag
  */
 export declare function computeUnavailablePicks(allowedAgents: string[] | undefined, rosterIds: readonly string[]): string[];
 /** buildAgentRoster + the diagnostics of which picked workers were dropped as unavailable. */
-export declare function buildAgentRosterWithDiagnostics(detector: AcpDetector, configStore: AgentConfigStoreData | null, allowedAgents?: string[]): {
+export declare function buildAgentRosterWithDiagnostics(snapshot: Readonly<HostAgentProviderListResult>, allowedAgents?: string[], options?: {
+    injectLeader?: boolean;
+}): {
     roster: AgentRosterEntry[];
     unavailablePicks: string[];
 };

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

@@ -0,0 +1,8 @@
+import type { DelegateRequestParams, SupervisorEventSink, TurnResult } from "../host-contract/index.js";
+/** Authority-neutral transport used by the six orchestration stations to call Gateway-owned workers. */
+export interface DelegateBridge {
+    isSupported(): boolean;
+    send(params: DelegateRequestParams, sink: SupervisorEventSink): Promise<TurnResult>;
+    cancel(delegationId: string): void;
+    respond(delegationId: string, approvalId: string, optionId: string): void;
+}

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

@@ -1,5 +1,5 @@
-import type { AcpDetector } from "../runtime/infra/acp-detector.js";
-import type { DelegateBridge } from "./delegation-coordinator.js";
+import type { HostAgentProviderDirectory } from "../runtime/infra/host-agent-provider-directory.js";
+import type { DelegateBridge } from "./delegate-bridge.js";
 import { type PlannerMemoryContext } from "./planner-memory-brief.js";
 import type { ProductOrchestrator } from "./agent-instance.js";
 import type { LeaderPort, PhaseRunnerPort } from "./goal-loop-coordinator.js";
@@ -49,7 +49,7 @@ export declare function takeGoalPhaseChangedFiles(productId: string): string[];
 export declare function extractJson<T>(text: string): T;
 export interface LeaderAdapterDeps {
     /** Resolves the leader's external ACP descriptor (product-planner.ts:583). */
-    acpDetector: AcpDetector;
+    providerDirectory: HostAgentProviderDirectory;
     /** Catalog id of the leader agent (e.g. "qlogicagent"). */
     leaderAgentId: string;
     /** Project workspaceDir — the leader process cwd. */

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

@@ -27,10 +27,6 @@ export interface PersistedProductState {
      * PlanningSession is strings / arrays / plain objects (no functions, dates, or class instances).
      */
     leaderDialogue?: PlanningSession;
-    /** P2-1: run tasks in the project cwd instead of per-task worktrees (see
-     *  ProductCreateParams.runInProjectCwd) — persisted so a delegation resumed after an engine restart
-     *  keeps running in the project cwd, not a fresh isolated worktree. */
-    runInProjectCwd?: boolean;
 }
 export interface ProductPersistenceOptions {
     pathService?: PathService;

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

@@ -23,9 +23,8 @@
  *   - CrewAI: checkpoint serialization (mid-task state)
  *   - LangGraph: durable execution (persist after each node)
  */
-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 { HostAgentProviderDirectory } from "../runtime/infra/host-agent-provider-directory.js";
+import type { DelegateBridge } from "./delegate-bridge.js";
 import type { ProductPlanParams, ProductPlan, ProductConfirmParams } from "../protocol/wire/acp-agent-management.js";
 export type PlanningPhase = "planning" | "awaiting_confirmation" | "confirmed" | "executing" | "paused" | "completed" | "cancelled";
 export interface PlanningMessage {
@@ -105,11 +104,10 @@ export interface DagMutation {
     details?: Record<string, unknown>;
 }
 export declare class ProductPlanner {
-    private acpDetector;
-    private configStore;
+    private providerDirectory;
     private callbacks;
     private sessions;
-    constructor(acpDetector: AcpDetector, configStore: AgentConfigStore | null, callbacks?: PlannerCallbacks);
+    constructor(providerDirectory: HostAgentProviderDirectory, callbacks?: PlannerCallbacks);
     /**
      * Start an interactive planning session (Phase 1).
      * Spawns the leader agent and begins multi-turn dialogue.

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

@@ -18,9 +18,7 @@
  *
  * Degradation: if K agents fail but ≥1 succeeds, session remains interactive.
  */
-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 { DelegateBridge } from "./delegate-bridge.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 {
@@ -75,10 +73,9 @@ export declare function buildEvaluationPrompt(originalTask: string, spec: SoloSp
     diff?: string;
 }>): string;
 export declare class SoloEvaluator {
-    private configStore;
     private callbacks;
     private sessions;
-    constructor(_acpDetector: AcpDetector, configStore: AgentConfigStore | null, callbacks?: SoloCallbacks);
+    constructor(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/testing/delegate-test-bridge.d.ts

@@ -1,7 +1,8 @@
-import type { DelegateBridge } from "../delegation-coordinator.js";
+import type { DelegateBridge } from "../delegate-bridge.js";
 interface LegacyTurnFixture {
     sendTask(memberId: string, prompt: string, options?: {
         timeout?: number;
+        session?: unknown;
     }): Promise<unknown>;
     getUsageTracker?(memberId: string): {
         getUsage(): {

package/dist/types/orchestration/testing/host-agent-provider-directory-fixture.d.ts

@@ -0,0 +1,7 @@
+import type { HostAgentProviderState } from "../../host-contract/index.js";
+import type { HostAgentProviderDirectory } from "../../runtime/infra/host-agent-provider-directory.js";
+export interface HostProviderDirectoryFixtureOptions {
+    states?: Readonly<Record<string, HostAgentProviderState | "not_installed">>;
+    diagnostics?: Readonly<Record<string, string>>;
+}
+export declare function makeHostAgentProviderDirectoryFixture(options?: HostProviderDirectoryFixtureOptions): HostAgentProviderDirectory;

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

@@ -3,7 +3,7 @@
  * with qlogicagent's actual capabilities. No mocks, no stubs (plan §1.5).
  *
  * Boundary capabilities (runAgent / invokeMcp / sendChannel) are injected so this file stays
- * decoupled from the handler host that owns processManager/acpDetector and the xiaozhiclaw channel
+ * decoupled from the handler host that owns Gateway delegation and the xiaozhiclaw channel
  * callback. Tool invocation goes straight through the single-source-of-truth tool registry
  * (`findTool`). fail-loud everywhere: unknown tool, missing channel host, or any rejection throws.
  */

package/dist/types/protocol/agent-contract.d.ts

@@ -0,0 +1,50 @@
+import type { NotificationMethodMap } from "./wire/notification-payloads.js";
+export declare const AGENT_CONTRACT_VERSION: 4;
+export declare const AGENT_EVENT_SCHEMA_VERSION: 1;
+export declare const AGENT_TERMINAL_STATES: readonly ["completed", "failed", "cancelled"];
+export type TerminalState = (typeof AGENT_TERMINAL_STATES)[number];
+export declare const AGENT_WS_EVENT_NAMES: readonly ["turn.start", "turn.delta", "turn.end", "turn.error", "turn.recovery", "turn.file_changes", "turn.tool_call", "turn.tool_result", "turn.tool_blocked", "turn.reasoning_delta", "turn.approval_request", "turn.skill_instruction", "turn.ask_user", "turn.media_result", "turn.media_progress", "turn.media_usage", "turn.media_capability_check", "turn.plan_update", "turn.suggestions", "turn.sidechain_started", "turn.subagent_started", "turn.subagent_delta", "turn.subagent_ended", "turn.sidechain_completed", "turn.task_updated", "turn.todos_updated", "turn.exec_progress", "turn.progress", "turn.tool_use_summary", "turn.tool_selection_policy", "turn.lifecycle", "turn.document_maintenance", "turn.artifact_contract", "turn.usage_update", "team.member.notification", "session.info", "session.recovery_pending", "memory.updated", "skills.updated", "turn.memory_recall", "turn.memory_written", "pet.soul_ready", "pet.reaction", "pet.growth", "pet.state", "pet.confirm", "pet.asset.updated", "system.activity", "workflow.created", "workflow.updated", "workflow.deleted", "workflow.runStarted", "workflow.runCompleted", "workflow.runFailed", "workflow.nodeStatus", "workflow.triggerDropped", "workflow.alert", "workflow.approvalRequested", "workflow.approvalTimedOut"];
+export declare const AGENT_TEAM_WS_EVENT_NAMES: readonly ["solo.progress", "solo.specProgress", "solo.agentDelta", "solo.agentActivity", "solo.agentUsage", "solo.evaluation", "product.taskStarted", "product.taskOutput", "product.members", "product.agentActivity", "product.taskCompleted", "product.taskFailed", "product.budgetUpdate", "product.budgetWarning", "product.checkpointed", "product.completed", "product.dagTopology", "plan.interrupted", "product.planReady", "product.planningDelta", "product.leaderMessage", "product.planFailed", "product.planningAsk", "goal.run_state_changed", "goal.phase_boundary", "goal.goal_edited", "goal.message_queued", "goal.acceptance_updated", "goal.round_message", "mention.delegate_started", "mention.delegate_activity", "mention.delegate_settled"];
+export declare const AGENT_EVENT_NAMES: readonly ["turn.start", "turn.delta", "turn.end", "turn.error", "turn.recovery", "turn.file_changes", "turn.tool_call", "turn.tool_result", "turn.tool_blocked", "turn.reasoning_delta", "turn.approval_request", "turn.skill_instruction", "turn.ask_user", "turn.media_result", "turn.media_progress", "turn.media_usage", "turn.media_capability_check", "turn.plan_update", "turn.suggestions", "turn.sidechain_started", "turn.subagent_started", "turn.subagent_delta", "turn.subagent_ended", "turn.sidechain_completed", "turn.task_updated", "turn.todos_updated", "turn.exec_progress", "turn.progress", "turn.tool_use_summary", "turn.tool_selection_policy", "turn.lifecycle", "turn.document_maintenance", "turn.artifact_contract", "turn.usage_update", "team.member.notification", "session.info", "session.recovery_pending", "memory.updated", "skills.updated", "turn.memory_recall", "turn.memory_written", "pet.soul_ready", "pet.reaction", "pet.growth", "pet.state", "pet.confirm", "pet.asset.updated", "system.activity", "workflow.created", "workflow.updated", "workflow.deleted", "workflow.runStarted", "workflow.runCompleted", "workflow.runFailed", "workflow.nodeStatus", "workflow.triggerDropped", "workflow.alert", "workflow.approvalRequested", "workflow.approvalTimedOut", "solo.progress", "solo.specProgress", "solo.agentDelta", "solo.agentActivity", "solo.agentUsage", "solo.evaluation", "product.taskStarted", "product.taskOutput", "product.members", "product.agentActivity", "product.taskCompleted", "product.taskFailed", "product.budgetUpdate", "product.budgetWarning", "product.checkpointed", "product.completed", "product.dagTopology", "plan.interrupted", "product.planReady", "product.planningDelta", "product.leaderMessage", "product.planFailed", "product.planningAsk", "goal.run_state_changed", "goal.phase_boundary", "goal.goal_edited", "goal.message_queued", "goal.acceptance_updated", "goal.round_message", "mention.delegate_started", "mention.delegate_activity", "mention.delegate_settled"];
+export declare const ALL_AGENT_WS_EVENT_NAMES: readonly ["turn.start", "turn.delta", "turn.end", "turn.error", "turn.recovery", "turn.file_changes", "turn.tool_call", "turn.tool_result", "turn.tool_blocked", "turn.reasoning_delta", "turn.approval_request", "turn.skill_instruction", "turn.ask_user", "turn.media_result", "turn.media_progress", "turn.media_usage", "turn.media_capability_check", "turn.plan_update", "turn.suggestions", "turn.sidechain_started", "turn.subagent_started", "turn.subagent_delta", "turn.subagent_ended", "turn.sidechain_completed", "turn.task_updated", "turn.todos_updated", "turn.exec_progress", "turn.progress", "turn.tool_use_summary", "turn.tool_selection_policy", "turn.lifecycle", "turn.document_maintenance", "turn.artifact_contract", "turn.usage_update", "team.member.notification", "session.info", "session.recovery_pending", "memory.updated", "skills.updated", "turn.memory_recall", "turn.memory_written", "pet.soul_ready", "pet.reaction", "pet.growth", "pet.state", "pet.confirm", "pet.asset.updated", "system.activity", "workflow.created", "workflow.updated", "workflow.deleted", "workflow.runStarted", "workflow.runCompleted", "workflow.runFailed", "workflow.nodeStatus", "workflow.triggerDropped", "workflow.alert", "workflow.approvalRequested", "workflow.approvalTimedOut", "solo.progress", "solo.specProgress", "solo.agentDelta", "solo.agentActivity", "solo.agentUsage", "solo.evaluation", "product.taskStarted", "product.taskOutput", "product.members", "product.agentActivity", "product.taskCompleted", "product.taskFailed", "product.budgetUpdate", "product.budgetWarning", "product.checkpointed", "product.completed", "product.dagTopology", "plan.interrupted", "product.planReady", "product.planningDelta", "product.leaderMessage", "product.planFailed", "product.planningAsk", "goal.run_state_changed", "goal.phase_boundary", "goal.goal_edited", "goal.message_queued", "goal.acceptance_updated", "goal.round_message", "mention.delegate_started", "mention.delegate_activity", "mention.delegate_settled"];
+/** Runtime-required keys whose shape is not encoded by TypeScript after serialization. */
+export declare const AGENT_EVENT_REQUIRED_KEYS: {
+    readonly "product.taskStarted": readonly ["productId", "taskId", "assignee", "attempt"];
+    readonly "product.taskCompleted": readonly ["productId", "taskId", "result", "attempt"];
+    readonly "product.taskFailed": readonly ["productId", "taskId", "error", "attempt", "terminalState"];
+    readonly "mention.delegate_started": readonly ["parentSessionId", "parentMessageId", "bindingId", "executionSessionId", "delegationId", "sequence", "providerId", "revision"];
+    readonly "mention.delegate_activity": readonly ["parentSessionId", "parentMessageId", "bindingId", "executionSessionId", "delegationId", "sequence", "providerId", "revision"];
+    readonly "mention.delegate_settled": readonly ["parentSessionId", "parentMessageId", "bindingId", "executionSessionId", "delegationId", "sequence", "providerId", "revision", "status"];
+};
+export type AgentWsEventName = (typeof AGENT_WS_EVENT_NAMES)[number];
+export type AgentTeamWsEventName = (typeof AGENT_TEAM_WS_EVENT_NAMES)[number];
+export type AgentEventName = (typeof AGENT_EVENT_NAMES)[number];
+export type AllAgentWsEventName = AgentEventName;
+export type AgentEventPayloadMap = {
+    [K in AgentEventName]: K extends keyof NotificationMethodMap ? NotificationMethodMap[K] : Record<string, unknown>;
+};
+export interface AgentEventEnvelope<K extends AgentEventName = AgentEventName> {
+    schemaVersion: typeof AGENT_EVENT_SCHEMA_VERSION;
+    type: K;
+    payload: AgentEventPayloadMap[K];
+}
+export declare const AGENT_CONTRACT_DESCRIPTOR: {
+    readonly version: 4;
+    readonly eventSchemaVersion: 1;
+    readonly eventNames: readonly ["turn.start", "turn.delta", "turn.end", "turn.error", "turn.recovery", "turn.file_changes", "turn.tool_call", "turn.tool_result", "turn.tool_blocked", "turn.reasoning_delta", "turn.approval_request", "turn.skill_instruction", "turn.ask_user", "turn.media_result", "turn.media_progress", "turn.media_usage", "turn.media_capability_check", "turn.plan_update", "turn.suggestions", "turn.sidechain_started", "turn.subagent_started", "turn.subagent_delta", "turn.subagent_ended", "turn.sidechain_completed", "turn.task_updated", "turn.todos_updated", "turn.exec_progress", "turn.progress", "turn.tool_use_summary", "turn.tool_selection_policy", "turn.lifecycle", "turn.document_maintenance", "turn.artifact_contract", "turn.usage_update", "team.member.notification", "session.info", "session.recovery_pending", "memory.updated", "skills.updated", "turn.memory_recall", "turn.memory_written", "pet.soul_ready", "pet.reaction", "pet.growth", "pet.state", "pet.confirm", "pet.asset.updated", "system.activity", "workflow.created", "workflow.updated", "workflow.deleted", "workflow.runStarted", "workflow.runCompleted", "workflow.runFailed", "workflow.nodeStatus", "workflow.triggerDropped", "workflow.alert", "workflow.approvalRequested", "workflow.approvalTimedOut", "solo.progress", "solo.specProgress", "solo.agentDelta", "solo.agentActivity", "solo.agentUsage", "solo.evaluation", "product.taskStarted", "product.taskOutput", "product.members", "product.agentActivity", "product.taskCompleted", "product.taskFailed", "product.budgetUpdate", "product.budgetWarning", "product.checkpointed", "product.completed", "product.dagTopology", "plan.interrupted", "product.planReady", "product.planningDelta", "product.leaderMessage", "product.planFailed", "product.planningAsk", "goal.run_state_changed", "goal.phase_boundary", "goal.goal_edited", "goal.message_queued", "goal.acceptance_updated", "goal.round_message", "mention.delegate_started", "mention.delegate_activity", "mention.delegate_settled"];
+    readonly eventRequiredKeys: {
+        readonly "product.taskStarted": readonly ["productId", "taskId", "assignee", "attempt"];
+        readonly "product.taskCompleted": readonly ["productId", "taskId", "result", "attempt"];
+        readonly "product.taskFailed": readonly ["productId", "taskId", "error", "attempt", "terminalState"];
+        readonly "mention.delegate_started": readonly ["parentSessionId", "parentMessageId", "bindingId", "executionSessionId", "delegationId", "sequence", "providerId", "revision"];
+        readonly "mention.delegate_activity": readonly ["parentSessionId", "parentMessageId", "bindingId", "executionSessionId", "delegationId", "sequence", "providerId", "revision"];
+        readonly "mention.delegate_settled": readonly ["parentSessionId", "parentMessageId", "bindingId", "executionSessionId", "delegationId", "sequence", "providerId", "revision", "status"];
+    };
+    readonly terminalStates: readonly ["completed", "failed", "cancelled"];
+};
+export declare const AGENT_CONTRACT_HASH: "23e967b8afdc32d4f8663cf50a1e86e07e658b4d63a6c657f043b62be0c81ec3";
+export interface AgentContractIdentity {
+    version: typeof AGENT_CONTRACT_VERSION;
+    hash: typeof AGENT_CONTRACT_HASH;
+}
+export declare const AGENT_CONTRACT_IDENTITY: AgentContractIdentity;