qlogicagent 2.19.1 → 2.19.2

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;
@@ -203,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;
 }
@@ -213,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)。
@@ -674,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;
@@ -1079,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];
@@ -1584,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;
@@ -1601,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,13 +11,12 @@
  *   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?: {
@@ -85,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). */
@@ -143,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,7 @@ 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[], options?: {
+export declare function buildAgentRoster(snapshot: Readonly<HostAgentProviderListResult>, allowedAgents?: string[], options?: {
     injectLeader?: boolean;
 }): AgentRosterEntry[];
 /**
@@ -25,7 +25,7 @@ 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[], options?: {
+export declare function buildAgentRosterWithDiagnostics(snapshot: Readonly<HostAgentProviderListResult>, allowedAgents?: string[], options?: {
     injectLeader?: boolean;
 }): {
     roster: AgentRosterEntry[];

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

@@ -1,5 +1,5 @@
 import type { NotificationMethodMap } from "./wire/notification-payloads.js";
-export declare const AGENT_CONTRACT_VERSION: 3;
+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];
@@ -12,6 +12,9 @@ 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];
@@ -26,17 +29,20 @@ export interface AgentEventEnvelope<K extends AgentEventName = AgentEventName> {
     payload: AgentEventPayloadMap[K];
 }
 export declare const AGENT_CONTRACT_DESCRIPTOR: {
-    readonly version: 3;
+    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: "495d6c1122d9ff8da40427e0809710e6e8a1a6663a4128c1ad9865707dd63147";
+export declare const AGENT_CONTRACT_HASH: "23e967b8afdc32d4f8663cf50a1e86e07e658b4d63a6c657f043b62be0c81ec3";
 export interface AgentContractIdentity {
     version: typeof AGENT_CONTRACT_VERSION;
     hash: typeof AGENT_CONTRACT_HASH;

package/dist/types/protocol/methods.d.ts

@@ -7,8 +7,8 @@
  * Reference: Codex app-server RPC, Claude Code JSON-RPC, GitHub Copilot Agent API.
  */
 import type { ChatMessage, LocalizedToolText, ToolCapabilityCategory } from "./wire/chat-types.js";
-import type { AgentDescriptor, AgentConfig, GatewayRpcMethodMap, RpcProjectInfo, RpcProjectType, RpcProjectStatus, SoloStatus, ProductStatus, ProductSummary } from "./wire/index.js";
-import type { AgentsScanParams, AgentsConfigParams, AgentsSetConfigParams, AgentsGetConfigParams, AgentsRemoveConfigParams, AgentsSetGatewayParams, SoloStartParams, SoloIdParams, SoloSelectParams, SoloDeleteParams, SoloMessageParams, SoloEvaluateParams, SoloEvaluation, ProductCreateParams, ProductPlanParams, ProductPlan, ProductConfirmParams, ProductMessageParams, ProductIdParams, ProductDeleteParams, ProductReplayParams } from "./wire/acp-agent-management.js";
+import type { GatewayRpcMethodMap, RpcProjectInfo, RpcProjectType, RpcProjectStatus, SoloStatus, ProductStatus, ProductSummary } from "./wire/index.js";
+import type { SoloStartParams, SoloIdParams, SoloSelectParams, SoloDeleteParams, SoloMessageParams, SoloEvaluateParams, SoloEvaluation, ProductCreateParams, ProductPlanParams, ProductPlan, ProductConfirmParams, ProductMessageParams, ProductIdParams, ProductDeleteParams, ProductReplayParams } from "./wire/acp-agent-management.js";
 export interface InitializeParams {
     protocolVersion: string;
     host?: {
@@ -381,6 +381,8 @@ export type ProjectCreateParams = GatewayRpcMethodMap["project.create"]["params"
 export type ProjectCreateResult = GatewayRpcMethodMap["project.create"]["result"];
 export type ProjectListParams = GatewayRpcMethodMap["project.list"]["params"];
 export type ProjectListResult = GatewayRpcMethodMap["project.list"]["result"];
+export type ProjectDetachParams = GatewayRpcMethodMap["project.detach"]["params"];
+export type ProjectDetachResult = GatewayRpcMethodMap["project.detach"]["result"];
 export type ProjectDeleteParams = GatewayRpcMethodMap["project.delete"]["params"];
 export type ProjectDeleteResult = GatewayRpcMethodMap["project.delete"]["result"];
 export type ProjectRenameParams = GatewayRpcMethodMap["project.rename"]["params"];
@@ -403,6 +405,10 @@ export type SessionDeleteParams = GatewayRpcMethodMap["session.delete"]["params"
 export type SessionDeleteResult = GatewayRpcMethodMap["session.delete"]["result"];
 export type SessionArchiveParams = GatewayRpcMethodMap["session.archive"]["params"];
 export type SessionArchiveResult = GatewayRpcMethodMap["session.archive"]["result"];
+export type SessionLoadNativeTranscriptParams = GatewayRpcMethodMap["session.loadNativeTranscript"]["params"];
+export type SessionLoadNativeTranscriptResult = GatewayRpcMethodMap["session.loadNativeTranscript"]["result"];
+export type SessionAdoptNativeParams = GatewayRpcMethodMap["session.adoptNative"]["params"];
+export type SessionAdoptNativeResult = GatewayRpcMethodMap["session.adoptNative"]["result"];
 export type InstructionsListParams = GatewayRpcMethodMap["instructions.list"]["params"];
 export type InstructionsListResult = GatewayRpcMethodMap["instructions.list"]["result"];
 export type InstructionsReadParams = GatewayRpcMethodMap["instructions.read"]["params"];
@@ -524,42 +530,6 @@ export interface RpcMethodMap {
         params: undefined;
         result: AgentPingResult;
     };
-    "agents.scan": {
-        params: AgentsScanParams;
-        result: AgentDescriptor[];
-    };
-    "agents.list": {
-        params: undefined;
-        result: AgentDescriptor[];
-    };
-    "agents.config": {
-        params: AgentsConfigParams;
-        result: {
-            ok: true;
-        };
-    };
-    "agents.setConfig": {
-        params: AgentsSetConfigParams;
-        result: {
-            ok: true;
-        };
-    };
-    "agents.getConfig": {
-        params: AgentsGetConfigParams;
-        result: AgentConfig | null;
-    };
-    "agents.removeConfig": {
-        params: AgentsRemoveConfigParams;
-        result: {
-            ok: true;
-        };
-    };
-    "agents.setGateway": {
-        params: AgentsSetGatewayParams;
-        result: {
-            ok: true;
-        };
-    };
     "solo.start": {
         params: SoloStartParams;
         result: {
@@ -695,6 +665,10 @@ export interface RpcMethodMap {
         params: ProjectListParams;
         result: ProjectListResult;
     };
+    "project.detach": {
+        params: ProjectDetachParams;
+        result: ProjectDetachResult;
+    };
     "project.delete": {
         params: ProjectDeleteParams;
         result: ProjectDeleteResult;
@@ -747,6 +721,14 @@ export interface RpcMethodMap {
         params: SessionArchiveParams;
         result: SessionArchiveResult;
     };
+    "session.loadNativeTranscript": {
+        params: SessionLoadNativeTranscriptParams;
+        result: SessionLoadNativeTranscriptResult;
+    };
+    "session.adoptNative": {
+        params: SessionAdoptNativeParams;
+        result: SessionAdoptNativeResult;
+    };
     "instructions.list": {
         params: InstructionsListParams;
         result: InstructionsListResult;

package/dist/types/protocol/notifications.d.ts

@@ -6,4 +6,4 @@
  * This file re-exports the wire types.
  * Internal consumers import from this file — zero churn.
  */
-export type { AgentSource, AgentsErrorNotification, AgentsStatusNotification, ArtifactType, MediaResultType, MemoryDecayCompletedNotification, MemoryUpdatedNotification, NotificationMethod, NotificationMethodMap, NotificationThreadItem, PermissionRuleUpdatedNotification, PlanInterruptedNotification, PongNotification, ProductAgentActivityNotification, ProductBudgetUpdateNotification, ProductBudgetWarningNotification, ProductCheckpointedNotification, ProductCompletedNotification, ProductDagTopologyNotification, ProductMembersNotification, ProductPlanFailedNotification, ProductPlanningDeltaNotification, ProductPlanReadyNotification, ProductLeaderMessageNotification, ProductPlanningAskNotification, ProductTaskCompletedNotification, ProductTaskFailedNotification, ProductTaskOutputDeltaNotification, ProductTaskStartedNotification, ProjectArchivedNotification, ProjectCreatedNotification, ProjectDeletedNotification, ProjectRenamedNotification, ProjectSwitchedNotification, ProjectUnarchivedNotification, SessionInfoNotification, SessionRecoveryPendingNotification, SoloAgentDeltaNotification, SoloAgentUsageNotification, SoloEvaluationNotification, SoloProgressNotification, TeamMemberNotification, ToolApprovalRequestNotification, TurnAnnotationsNotification, TurnArtifactNotification, TurnAskUserNotification, TurnDeltaNotification, TurnEndNotification, TurnErrorNotification, TurnExecProgressNotification, TurnHeartbeatNotification, TurnMediaPersistedNotification, TurnMediaProgressNotification, TurnMediaResultNotification, TurnPlanUpdateNotification, TurnProgressNotification, TurnReasoningDeltaNotification, TurnRecoveryNotification, TurnSidechainCompletedNotification, TurnSidechainStartedNotification, TurnSkillInstructionNotification, TurnStartNotification, TurnSubagentDeltaNotification, TurnSuggestionsNotification, TurnTaskUpdatedNotification, TurnTodosUpdatedNotification, TurnToolBlockedNotification, TurnToolCallNotification, TurnToolResultNotification, TurnToolUseSummaryNotification, TurnUsageUpdateNotification, WireTokenUsage, GoalRoundMessageNotification, MentionDelegateStartedNotification, MentionDelegateActivityNotification, MentionDelegateSettledNotification, } from "./wire/index.js";
+export type { AgentSource, ArtifactType, MediaResultType, MemoryDecayCompletedNotification, MemoryUpdatedNotification, NotificationMethod, NotificationMethodMap, NotificationThreadItem, PermissionRuleUpdatedNotification, PlanInterruptedNotification, PongNotification, ProductAgentActivityNotification, ProductBudgetUpdateNotification, ProductBudgetWarningNotification, ProductCheckpointedNotification, ProductCompletedNotification, ProductDagTopologyNotification, ProductMembersNotification, ProductPlanFailedNotification, ProductPlanningDeltaNotification, ProductPlanReadyNotification, ProductLeaderMessageNotification, ProductPlanningAskNotification, ProductTaskCompletedNotification, ProductTaskFailedNotification, ProductTaskOutputDeltaNotification, ProductTaskStartedNotification, ProjectArchivedNotification, ProjectCreatedNotification, ProjectDeletedNotification, ProjectRenamedNotification, ProjectSwitchedNotification, ProjectUnarchivedNotification, SessionInfoNotification, SessionRecoveryPendingNotification, SoloAgentDeltaNotification, SoloAgentUsageNotification, SoloEvaluationNotification, SoloProgressNotification, TeamMemberNotification, ToolApprovalRequestNotification, TurnAnnotationsNotification, TurnArtifactNotification, TurnAskUserNotification, TurnDeltaNotification, TurnEndNotification, TurnErrorNotification, TurnExecProgressNotification, TurnHeartbeatNotification, TurnMediaPersistedNotification, TurnMediaProgressNotification, TurnMediaResultNotification, TurnPlanUpdateNotification, TurnProgressNotification, TurnReasoningDeltaNotification, TurnRecoveryNotification, TurnSidechainCompletedNotification, TurnSidechainStartedNotification, TurnSkillInstructionNotification, TurnStartNotification, TurnSubagentDeltaNotification, TurnSuggestionsNotification, TurnTaskUpdatedNotification, TurnTodosUpdatedNotification, TurnToolBlockedNotification, TurnToolCallNotification, TurnToolResultNotification, TurnToolUseSummaryNotification, TurnUsageUpdateNotification, WireTokenUsage, GoalRoundMessageNotification, MentionDelegateStartedNotification, MentionDelegateActivityNotification, MentionDelegateSettledNotification, } from "./wire/index.js";