qlogicagent 2.19.1 → 2.19.2

package/dist/types/protocol/wire/gateway-rpc.d.ts

@@ -10,8 +10,109 @@
  * Reference: CC uses Zod union in a single package; we use TypeScript interface map
  * in a shared package (same effect — single source, compile-time checked).
  */
+import type { NativeSessionRef, NativeTranscript } from "../../host-contract/index.js";
 export type ProjectType = "default" | "personal" | "group" | "solo" | "product" | "automation";
-export type ProjectStatus = "active" | "archived";
+export type ProjectStatus = "active" | "detached" | "archived";
+export type ProviderHostMethod = "provider.catalog" | "provider.list" | "provider.get" | "provider.install" | "provider.update" | "provider.uninstall" | "provider.enable" | "provider.disable" | "provider.diagnose" | "provider.auth.status" | "provider.auth.methods" | "provider.auth.start" | "provider.auth.attach" | "provider.auth.input" | "provider.auth.resize" | "provider.auth.cancel" | "provider.auth.logout" | "provider.models.list" | "provider.nativeSessions.list" | "provider.nativeSessions.load" | "provider.nativeSessions.resume";
+export type AgentProviderState = "installed" | "auth_required" | "ready" | "disabled" | "incompatible" | "unresponsive" | "failed";
+export interface AgentProviderDiagnosticWire {
+    providerId: string;
+    state: "ready" | "not_installed" | "disabled" | "incompatible" | "auth_required" | "unresponsive" | "failed";
+    stage: "install" | "manifest" | "auth" | "launch" | "initialize" | "models" | "native_sessions" | "request";
+    code: string;
+    message: string;
+    retryable: boolean;
+    providerVersion?: string;
+    payloadVersion?: string;
+}
+export interface AgentProviderErrorWire {
+    providerId: string;
+    stage: AgentProviderDiagnosticWire["stage"];
+    code: string;
+    message: string;
+    retryable: boolean;
+    data?: unknown;
+}
+export interface AgentProviderCatalogEntryWire {
+    schemaVersion: 1;
+    providerId: string;
+    displayName: string;
+    brandId: string;
+    category: "coding" | "assistant" | "custom";
+    order: number;
+    featured: boolean;
+    installPolicy: "builtin" | "managed-package";
+    distribution: {
+        kind: "builtin";
+    } | {
+        kind: "npm";
+        packageName: string;
+        exactVersion: string;
+        integrity: `sha512-${string}`;
+        mirrorAllowed: boolean;
+    } | {
+        kind: "signed-bundle";
+        artifactId: string;
+        exactVersion: string;
+        sha256: string;
+    };
+    expectedManifestDigest?: `sha256:${string}`;
+}
+export interface RegisteredAgentProviderWire {
+    providerId: string;
+    source: "builtin" | "installed";
+    installationId: string;
+    manifest: Readonly<Record<string, unknown>>;
+    manifestDigest: `sha256:${string}`;
+    state: AgentProviderState;
+    diagnostic?: AgentProviderDiagnosticWire;
+}
+export interface ProviderAuthTerminalSessionWire {
+    authSessionId: string;
+    providerId: string;
+    ownerId: string;
+    authMethodId: string;
+    state: "starting" | "interactive" | "verifying" | "succeeded" | "failed" | "cancelled";
+    cols: number;
+    rows: number;
+    exitCode?: number;
+    error?: AgentProviderErrorWire;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface DelegationBindingKey {
+    parentSessionId: string;
+    providerId: string;
+    generation: number;
+}
+export interface DelegationBinding extends DelegationBindingKey {
+    bindingId: string;
+    projectId: string;
+    executionSessionId: string;
+    nativeResumeId?: string;
+    createdAt: string;
+    updatedAt: string;
+    revision: number;
+}
+export interface DelegationTurn {
+    delegationId: string;
+    bindingId: string;
+    parentMessageId: string;
+    requestId: string;
+    sequence: number;
+    state: "queued" | "running" | "completed" | "failed" | "cancelled";
+}
+export type DelegationErrorCode = "PROVIDER_NOT_INSTALLED" | "AUTH_REQUIRED" | "PROVIDER_UNAVAILABLE" | "SESSION_CREATE_FAILED" | "SESSION_RESUME_FAILED" | "TURN_FAILED" | "PROTOCOL_ERROR" | "CANCELLED";
+export interface DelegationError {
+    code: DelegationErrorCode;
+    message: string;
+    stage: "validate" | "bind" | "spawn" | "resume" | "turn" | "cancel";
+    retryable: boolean;
+    providerId: string;
+    bindingId?: string;
+    delegationId?: string;
+    diagnosticId?: string;
+}
 export interface LocalizedTextWire {
     key: string;
     fallback: string;
@@ -110,6 +211,213 @@ export interface GatewayRpcMethodMap {
             cancelled: boolean;
         };
     };
+    "provider.catalog": {
+        params: Record<string, never>;
+        result: {
+            providers: AgentProviderCatalogEntryWire[];
+        };
+    };
+    "provider.list": {
+        params: Record<string, never>;
+        result: {
+            providers: RegisteredAgentProviderWire[];
+            revision: number;
+        };
+    };
+    "provider.get": {
+        params: {
+            providerId: string;
+        };
+        result: {
+            provider: RegisteredAgentProviderWire | null;
+            revision: number;
+        };
+    };
+    "provider.install": {
+        params: {
+            providerId: string;
+            mirror: "official" | "china";
+        };
+        result: {
+            operationId: string;
+            state: AgentProviderState;
+        };
+    };
+    "provider.update": {
+        params: {
+            providerId: string;
+            mirror: "official" | "china";
+        };
+        result: {
+            operationId: string;
+            state: AgentProviderState;
+        };
+    };
+    "provider.uninstall": {
+        params: {
+            providerId: string;
+        };
+        result: {
+            ok: true;
+            nativeDataPreserved: true;
+        };
+    };
+    "provider.enable": {
+        params: {
+            providerId: string;
+        };
+        result: {
+            ok: true;
+        };
+    };
+    "provider.disable": {
+        params: {
+            providerId: string;
+        };
+        result: {
+            ok: true;
+        };
+    };
+    "provider.diagnose": {
+        params: {
+            providerId: string;
+        };
+        result: AgentProviderDiagnosticWire;
+    };
+    "provider.auth.status": {
+        params: {
+            providerId: string;
+        };
+        result: {
+            providerId: string;
+            preference?: "account" | "userKey" | "managed";
+            state: AgentProviderState;
+        };
+    };
+    "provider.auth.methods": {
+        params: {
+            providerId: string;
+        };
+        result: {
+            methods: Array<{
+                id: string;
+                label: string;
+                kind: "protocol" | "terminal";
+            }>;
+        };
+    };
+    "provider.auth.start": {
+        params: {
+            providerId: string;
+            authMethodId: string;
+            cols: number;
+            rows: number;
+        };
+        result: {
+            session: ProviderAuthTerminalSessionWire;
+            replay: string;
+        };
+    };
+    "provider.auth.attach": {
+        params: {
+            authSessionId: string;
+        };
+        result: {
+            session: ProviderAuthTerminalSessionWire;
+            replay: string;
+        };
+    };
+    "provider.auth.input": {
+        params: {
+            authSessionId: string;
+            data: string;
+        };
+        result: {
+            ok: true;
+        };
+    };
+    "provider.auth.resize": {
+        params: {
+            authSessionId: string;
+            cols: number;
+            rows: number;
+        };
+        result: {
+            ok: true;
+        };
+    };
+    "provider.auth.cancel": {
+        params: {
+            authSessionId: string;
+        };
+        result: {
+            ok: true;
+        };
+    };
+    "provider.auth.logout": {
+        params: {
+            providerId: string;
+        };
+        result: {
+            ok: true;
+        };
+    };
+    "provider.models.list": {
+        params: {
+            providerId: string;
+        };
+        result: {
+            models: Array<Record<string, unknown>>;
+        };
+    };
+    "provider.nativeSessions.list": {
+        params: {
+            providerId: string;
+            projectId: string;
+            limit?: number;
+        };
+        result: {
+            sessions: Array<Record<string, unknown>>;
+        };
+    };
+    "provider.nativeSessions.load": {
+        params: {
+            providerId: string;
+            nativeRef: NativeSessionRef;
+        };
+        result: NativeTranscript;
+    };
+    "provider.nativeSessions.resume": {
+        params: {
+            providerId: string;
+            nativeRef: NativeSessionRef;
+            parentSessionId: string;
+        };
+        result: {
+            executionSessionId: string;
+            nativeResumeId?: string;
+        };
+    };
+    "delegation.cancel": {
+        params: {
+            parentSessionId: string;
+            bindingId: string;
+            delegationId: string;
+        };
+        result: {
+            ok: true;
+            state: "cancelled";
+        };
+    };
+    "delegation.reset": {
+        params: {
+            parentSessionId: string;
+            providerId: string;
+        };
+        result: {
+            binding: DelegationBinding;
+        };
+    };
     "session.list": {
         params: {
             limit?: number;
@@ -131,11 +439,7 @@ export interface GatewayRpcMethodMap {
                 projectId: string;
                 agentId?: string;
                 source?: "native";
-                nativeRef?: {
-                    agentId: string;
-                    kind: "codex" | "claude";
-                    file: string;
-                };
+                nativeRef?: NativeSessionRef;
                 sealedAt?: string | null;
                 previousSessionId?: string | null;
                 carryoverSummary?: string | null;
@@ -215,6 +519,22 @@ export interface GatewayRpcMethodMap {
             ok: boolean;
         };
     };
+    "session.loadNativeTranscript": {
+        params: {
+            nativeRef: NativeSessionRef;
+        };
+        result: NativeTranscript;
+    };
+    "session.adoptNative": {
+        params: {
+            nativeRef: NativeSessionRef;
+        };
+        result: {
+            canonicalSessionId: string;
+            created: boolean;
+            title?: string;
+        };
+    };
     "session.moveToProject": {
         params: {
             sessionId: string;
@@ -275,15 +595,30 @@ export interface GatewayRpcMethodMap {
             deduplicated?: boolean;
         };
     };
-    "project.delete": {
+    "project.detach": {
         params: {
             projectId: string;
         };
         result: {
-            ok: boolean;
+            ok: true;
+            project: ProjectInfo & {
+                status: "detached";
+            };
             switchedTo?: ProjectInfo;
         };
     };
+    "project.delete": {
+        params: {
+            projectId: string;
+        };
+        result: {
+            ok: true;
+            deleted: true;
+            internalDataDeleted: true;
+            workspacePreserved: true;
+            providerNativeSessionsPreserved: true;
+        };
+    };
     "project.rename": {
         params: {
             projectId: string;
@@ -323,13 +658,6 @@ export interface GatewayRpcMethodMap {
             ok: boolean;
         };
     };
-    "project.purgeAll": {
-        params: Record<string, never>;
-        result: {
-            ok: boolean;
-            deletedCount?: number;
-        };
-    };
     "instructions.list": {
         params: {
             projectId?: string;

package/dist/types/protocol/wire/index.d.ts

@@ -1,12 +1,12 @@
 export { PETDEX_ANIMATION_IDS, type PetdexAnimationId, } from "./pet-contracts.js";
 export { AGENT_RPC_APPROVAL_METHODS, AGENT_RPC_ERROR_CODES, AGENT_RPC_PROTOCOL_VERSION, isAgentRpcNotification, isAgentRpcRequest, isAgentRpcResponse, parseAgentRpcMessage, type AgentHelloParams, type AgentHelloResult, type AgentRpcError, type AgentRpcErrorCode, type AgentRpcMeta, type AgentRpcChannel, type AgentRpcMessage, type AgentRpcNotification, type AgentRpcRequest, type AgentRpcResponse, type ToolApprovalRequestParams, } from "./agent-rpc.js";
 export { GatewayRpcContract, buildAgentRpcMeta, classifyGatewayRpcMethod, requireGatewayRpcMeta, requiresIdempotencyKey, type GatewayRpcClassification, type GatewayRpcMetrics, type GatewayRpcMutability, } from "./gateway-contract.js";
-export { GATEWAY_RPC_METHODS, type AgentCall, type AgentCallOptions, type GatewayRpcMethodMap, type ProjectInfo as RpcProjectInfo, type ProjectStatus as RpcProjectStatus, type ProjectType as RpcProjectType, } from "./gateway-rpc.js";
+export { GATEWAY_RPC_METHODS, type AgentCall, type AgentCallOptions, type GatewayRpcMethodMap, type AgentProviderCatalogEntryWire, type AgentProviderDiagnosticWire, type AgentProviderErrorWire, type AgentProviderState, type DelegationBinding, type DelegationBindingKey, type DelegationError, type DelegationErrorCode, type DelegationTurn, type ProviderAuthTerminalSessionWire, type ProviderHostMethod, type RegisteredAgentProviderWire, type ProjectInfo as RpcProjectInfo, type ProjectStatus as RpcProjectStatus, type ProjectType as RpcProjectType, } from "./gateway-rpc.js";
 export { type ChatMessage, type ChatMessageRole, type LocalizedToolText, type ThinkingBlock, type ToolCapabilityCategory, type ToolCallMessage, type ToolDefinition, } from "./chat-types.js";
-export { type AgentCapabilities, type AgentCategory, type AgentConfig, type AgentDescriptor, type AgentProtocol, type AgentRpcMethodMap, type AgentStatus, type CustomAgentDef, type ProductInstanceDef, type ProductPhase, type ProductStatus, type ProductSummary, type ProductTaskDef, type ProductTaskStatus, type SoloAgentResult, type SoloAgentState, type SoloState, type SoloStatus, } from "./agent-methods.js";
+export { type AgentRpcMethodMap, type ProductInstanceDef, type ProductPhase, type ProductStatus, type ProductSummary, type ProductTaskDef, type ProductTaskStatus, type SoloAgentResult, type SoloAgentState, type SoloState, type SoloStatus, } from "./agent-methods.js";
 export type * from "./acp-agent-management.js";
 export { AGENT_TEAM_WS_EVENT_NAMES, AGENT_WS_EVENT_NAMES, ALL_AGENT_WS_EVENT_NAMES, type AgentTeamWsEventName, type AgentWsEventName, type AllAgentWsEventName, } from "./agent-events.js";
-export { type AgentSource, type AgentsErrorNotification, type AgentsStatusNotification, type ArtifactType, type MediaResultType, type MemoryDecayCompletedNotification, type MemoryUpdatedNotification, type NotificationMethod, type NotificationMethodMap, type NotificationThreadItem, type PermissionRuleUpdatedNotification, type PlanInterruptedNotification, type PongNotification, type ProductBudgetUpdateNotification, type ProductBudgetWarningNotification, type ProductCheckpointedNotification, type ProductCompletedNotification, type ProductDagTopologyNotification, type ProductTaskCompletedNotification, type ProductTaskFailedNotification, type ProductTaskOutputDeltaNotification, type ProductMembersNotification, type ProductAgentActivityNotification, type ProductTaskStartedNotification, type ProjectArchivedNotification, type ProjectCreatedNotification, type ProjectDeletedNotification, type ProjectRenamedNotification, type ProjectSwitchedNotification, type ProjectUnarchivedNotification, type SessionInfoNotification, type SessionRecoveryPendingNotification, type SoloAgentDeltaNotification, type SoloAgentUsageNotification, type SoloEvaluationNotification, type SoloProgressNotification, type TeamMemberNotification, type ToolApprovalRequestNotification, type TurnAnnotationsNotification, type TurnArtifactContractNotification, type TurnArtifactNotification, type TurnAskUserNotification, type TurnDeltaNotification, type TurnEndNotification, type TurnErrorNotification, type TurnExecProgressNotification, type TurnHeartbeatNotification, type TurnMediaPersistedNotification, type TurnMediaProgressNotification, type TurnMediaResultNotification, type TurnPlanUpdateNotification, type TurnProgressNotification, type TurnReasoningDeltaNotification, type TurnRecoveryNotification, type TurnSidechainCompletedNotification, type TurnSidechainStartedNotification, type TurnSkillAcquisitionNeededNotification, type TurnSkillInstructionNotification, type TurnStartNotification, type TurnSubagentDeltaNotification, type TurnSubagentEndedNotification, type TurnSubagentStartedNotification, type TurnSuggestionsNotification, type TurnTaskUpdatedNotification, type TurnTodosUpdatedNotification, type TurnToolBlockedNotification, type TurnToolCallNotification, type TurnToolResultNotification, type TurnToolUseSummaryNotification, type TurnUsageUpdateNotification, type WireTokenUsage, type ProductPlanReadyNotification, type ProductPlanFailedNotification, type ProductPlanningDeltaNotification, type ProductLeaderMessageNotification, type ProductPlanningAskNotification, type GoalRoundMessageNotification, type MentionDelegateStartedNotification, type MentionDelegateActivityNotification, type MentionDelegateSettledNotification, type PetSoulReadyNotification, type PetReactionNotification, type PetGrowthNotification, type PetStateNotification, type PetConfirmNotification, type WorkflowDeletedNotification, type WorkflowRecordNotification, type WorkflowRunCompletedNotification, type WorkflowRunFailedNotification, type WorkflowRunStartedNotification, } from "./notification-payloads.js";
+export { type AgentSource, type ArtifactType, type MediaResultType, type MemoryDecayCompletedNotification, type MemoryUpdatedNotification, type NotificationMethod, type NotificationMethodMap, type NotificationThreadItem, type PermissionRuleUpdatedNotification, type PlanInterruptedNotification, type PongNotification, type ProductBudgetUpdateNotification, type ProductBudgetWarningNotification, type ProductCheckpointedNotification, type ProductCompletedNotification, type ProductDagTopologyNotification, type ProductTaskCompletedNotification, type ProductTaskFailedNotification, type ProductTaskOutputDeltaNotification, type ProductMembersNotification, type ProductAgentActivityNotification, type ProductTaskStartedNotification, type ProjectArchivedNotification, type ProjectCreatedNotification, type ProjectDeletedNotification, type ProjectDetachedNotification, type ProjectAttachedNotification, type ProjectRenamedNotification, type ProjectSwitchedNotification, type ProjectUnarchivedNotification, type SessionInfoNotification, type SessionRecoveryPendingNotification, type SoloAgentDeltaNotification, type SoloAgentUsageNotification, type SoloEvaluationNotification, type SoloProgressNotification, type TeamMemberNotification, type ToolApprovalRequestNotification, type TurnAnnotationsNotification, type TurnArtifactContractNotification, type TurnArtifactNotification, type TurnAskUserNotification, type TurnDeltaNotification, type TurnEndNotification, type TurnErrorNotification, type TurnExecProgressNotification, type TurnHeartbeatNotification, type TurnMediaPersistedNotification, type TurnMediaProgressNotification, type TurnMediaResultNotification, type TurnPlanUpdateNotification, type TurnProgressNotification, type TurnReasoningDeltaNotification, type TurnRecoveryNotification, type TurnSidechainCompletedNotification, type TurnSidechainStartedNotification, type TurnSkillAcquisitionNeededNotification, type TurnSkillInstructionNotification, type TurnStartNotification, type TurnSubagentDeltaNotification, type TurnSubagentEndedNotification, type TurnSubagentStartedNotification, type TurnSuggestionsNotification, type TurnTaskUpdatedNotification, type TurnTodosUpdatedNotification, type TurnToolBlockedNotification, type TurnToolCallNotification, type TurnToolResultNotification, type TurnToolUseSummaryNotification, type TurnUsageUpdateNotification, type WireTokenUsage, type ProductPlanReadyNotification, type ProductPlanFailedNotification, type ProductPlanningDeltaNotification, type ProductLeaderMessageNotification, type ProductPlanningAskNotification, type GoalRoundMessageNotification, type MentionDelegateStartedNotification, type MentionDelegateActivityNotification, type MentionDelegateSettledNotification, type PetSoulReadyNotification, type PetReactionNotification, type PetGrowthNotification, type PetStateNotification, type PetConfirmNotification, type WorkflowDeletedNotification, type WorkflowRecordNotification, type WorkflowRunCompletedNotification, type WorkflowRunFailedNotification, type WorkflowRunStartedNotification, } from "./notification-payloads.js";
 export { ACP_EXTENDED_METHODS, ACP_EXTENDED_SESSION_UPDATE_TYPES, ACP_METHODS, ACP_PROTOCOL_VERSION, ACP_SESSION_UPDATE_TYPES, isAcpJsonRpcNotification, isAcpJsonRpcRequest, isAcpJsonRpcResponse, isExtendedSessionUpdateType, isStandardSessionUpdateType, parseAcpMessage, type AcpAgentCapabilities, type AcpAgentMessageChunkPayload, type AcpAgentThoughtChunkPayload, type AcpConfigOptionDescriptor, type AcpConfigOptionUpdatePayload, type AcpContentBlock, type AcpEndTurnPayload, type AcpExtendedMethod, type AcpExtendedSessionUpdateType, type AcpFsReadTextFileParams, type AcpFsReadTextFileResult, type AcpFsWriteTextFileParams, type AcpFsWriteTextFileResult, type AcpHostCapabilities, type AcpInitializeParams, type AcpInitializeResult, type AcpJsonRpcError, type AcpJsonRpcMessage, type AcpJsonRpcNotification, type AcpJsonRpcRequest, type AcpJsonRpcResponse, type AcpMode, type AcpPermissionOption, type AcpPermissionRequestParams, type AcpPermissionRequestResult, type AcpPlanPayload, type AcpSessionCancelParams, type AcpSessionCloseParams, type AcpSessionMeta, type AcpSessionLoadParams, type AcpSessionModeState, type AcpSessionNewParams, type AcpSessionNewResult, type AcpSessionPromptParams, type AcpSessionPromptResult, type AcpSessionSetConfigParams, type AcpSessionUpdateNotification, type AcpSessionUpdateType, type AcpStandardMethod, type AcpStandardSessionUpdateType, type AcpStopReason, type AcpToolCallPayload, type AcpToolCallUpdatePayload, type AcpUsage, type AcpUsageUpdatePayload, type AcpXSessionInfoPayload, type AcpXSkillInstructionPayload, } from "./acp-protocol.js";
 export { type ApprovalRequiredToolContract, type ModelSelectionReason, type PendingPromptContract, type RuntimeCapabilitySummaryContract, type RuntimeSessionContract, type SessionIdentityContract, } from "./session.js";
 export { type GatewayChannelExecutionEgressContract, type GatewayChannelExecutionEgressKind, type GatewayChannelExecutionIngressBindingContract, type GatewayChannelExecutionIngressSource, } from "./channel-ingress.js";

package/dist/types/protocol/wire/notification-payloads.d.ts

@@ -11,6 +11,7 @@
  * 3. Add event name string in agent-events.ts (if WS-relayed)
  */
 import type { ToolRiskLevel } from "./web-capability.js";
+import type { DelegationError } from "./gateway-rpc.js";
 /** Identifies which agent produced this notification (main or teammate). */
 export interface AgentSource {
     id: string;
@@ -547,125 +548,6 @@ export interface TurnUsageUpdateNotification {
     model?: string;
     sessionCostUSD?: number;
 }
-/** Agent status change notification. */
-export interface AgentsStatusNotification {
-    agentId: string;
-    status: "available" | "spawning" | "running" | "hang" | "failed" | "unavailable";
-    health?: {
-        missedBeats: number;
-        lastActiveAt: string;
-    };
-    usage?: {
-        inputTokens: number;
-        outputTokens: number;
-        totalTokens: number;
-    };
-    error?: {
-        phase: string;
-        message: string;
-        retriesLeft: number;
-    };
-}
-/** Agent error notification. */
-export interface AgentsErrorNotification {
-    agentId: string;
-    phase: "detect" | "spawn" | "handshake" | "runtime" | "shutdown" | "heartbeat";
-    error: string;
-    retriesLeft: number;
-}
-/** One-click install progress (state transitions + streamed log lines + final result). */
-export interface AgentInstallProgressNotification {
-    agentId: string;
-    event: {
-        type: "state";
-        state: "installing" | "verifying" | "installed" | "failed";
-    } | {
-        type: "log";
-        stream: "stdout" | "stderr";
-        chunk: string;
-    } | {
-        type: "done";
-        ok: boolean;
-        error?: string;
-    };
-}
-/**
- * Live streaming chunk from an EXTERNAL agent's prompt turn (agents.prompt). Echoes the gateway's
- * turn identity (sessionId/turnId/requestId passed in agents.prompt params) so the gateway can
- * re-emit it on the same turn.delta path the main agent uses — no separate frontend handling.
- */
-export interface AgentsPromptDeltaNotification {
-    agentId: string;
-    sessionId?: string;
-    turnId?: string;
-    requestId?: string;
-    text: string;
-    /** When true this chunk is the agent's reasoning/thinking (→ turn.reasoning_delta), not reply text. */
-    reasoning?: boolean;
-}
-/**
- * Live tool-call lifecycle from an EXTERNAL agent's prompt turn — same echo-the-turn-identity
- * mechanism as AgentsPromptDeltaNotification, so the gateway re-emits it on the main
- * turn.tool_call / turn.tool_result path and the UI shows external tools running, no extra handling.
- */
-export interface AgentsPromptToolNotification {
-    agentId: string;
-    sessionId?: string;
-    turnId?: string;
-    requestId?: string;
-    event: {
-        kind: "call";
-        callId: string;
-        name: string;
-        arguments?: string;
-        inputSummary?: string;
-    } | {
-        kind: "result";
-        callId: string;
-        name: string;
-        ok: boolean;
-        outputPreview?: string;
-        error?: string;
-    };
-}
-/**
- * Plan/task update from an EXTERNAL agent's prompt turn (ACP plan steps). The gateway maps the
- * steps onto the main turn.task_updated path so the UI shows the agent's plan as a task list.
- */
-export interface AgentsPromptPlanNotification {
-    agentId: string;
-    sessionId?: string;
-    turnId?: string;
-    requestId?: string;
-    steps: Array<{
-        content?: string;
-        title?: string;
-        status?: string;
-        priority?: string;
-    }>;
-}
-/**
- * Interactive permission request from an EXTERNAL agent's prompt turn. Echoes the gateway's turn
- * identity so the gateway re-emits it on the main turn.approval_request path → the UI shows an
- * approval card; the user's decision returns via the agents.approvalResponse RPC.
- */
-export interface AgentsPromptApprovalNotification {
-    agentId: string;
-    sessionId?: string;
-    turnId?: string;
-    requestId?: string;
-    approvalId: string;
-    callId?: string;
-    toolName: string;
-    arguments?: string;
-    message?: string;
-    category?: string;
-    options?: Array<{
-        optionId: string;
-        name?: string;
-        kind?: string;
-    }>;
-}
 /** Solo agent progress. */
 export interface SoloProgressNotification {
     soloId: string;
@@ -859,6 +741,29 @@ export interface ProjectSwitchedNotification {
 export interface ProjectDeletedNotification {
     id: string;
 }
+export interface ProjectDetachedNotification {
+    project: {
+        id: string;
+        name: string;
+        workspaceDir: string;
+        type: string;
+        status: "detached";
+    };
+    switchedTo?: {
+        id: string;
+        name: string;
+        workspaceDir: string;
+    };
+}
+export interface ProjectAttachedNotification {
+    project: {
+        id: string;
+        name: string;
+        workspaceDir: string;
+        type: string;
+        status: "active";
+    };
+}
 /** A project was renamed. */
 export interface ProjectRenamedNotification {
     id: string;
@@ -1058,27 +963,41 @@ export interface GoalRoundMessageNotification {
     };
 }
 export interface MentionDelegateStartedNotification {
-    canonicalSessionId: string;
+    parentSessionId: string;
+    parentMessageId: string;
+    bindingId: string;
+    executionSessionId: string;
     delegationId: string;
-    agentId: string;
+    sequence: number;
+    providerId: string;
+    revision: number;
     brief?: string;
-    productId?: string;
-    suppressAgentContext?: boolean;
 }
 export interface MentionDelegateActivityNotification {
-    canonicalSessionId: string;
+    parentSessionId: string;
+    parentMessageId: string;
+    bindingId: string;
+    executionSessionId: string;
     delegationId: string;
+    sequence: number;
+    providerId: string;
+    revision: number;
     toolName?: string;
     delta?: string;
 }
 export interface MentionDelegateSettledNotification {
-    canonicalSessionId: string;
+    parentSessionId: string;
+    parentMessageId: string;
+    bindingId: string;
+    executionSessionId: string;
     delegationId: string;
-    agentId: string;
+    sequence: number;
+    providerId: string;
+    revision: number;
     status: "completed" | "failed" | "cancelled";
     changedFiles?: string[];
     finalText?: string;
-    error?: string;
+    error?: DelegationError;
 }
 export interface NotificationMethodMap {
     "turn.start": TurnStartNotification;
@@ -1132,13 +1051,6 @@ export interface NotificationMethodMap {
     "team.member.notification": TeamMemberNotification;
     "turn.usage_update": TurnUsageUpdateNotification;
     "pong": PongNotification;
-    "agents.status": AgentsStatusNotification;
-    "agents.error": AgentsErrorNotification;
-    "agent.install.progress": AgentInstallProgressNotification;
-    "agents.prompt.delta": AgentsPromptDeltaNotification;
-    "agents.prompt.tool": AgentsPromptToolNotification;
-    "agents.prompt.approval": AgentsPromptApprovalNotification;
-    "agents.prompt.plan": AgentsPromptPlanNotification;
     "solo.progress": SoloProgressNotification;
     "solo.evaluation": SoloEvaluationNotification;
     "solo.agentDelta": SoloAgentDeltaNotification;
@@ -1171,6 +1083,8 @@ export interface NotificationMethodMap {
     "mention.delegate_settled": MentionDelegateSettledNotification;
     "project.created": ProjectCreatedNotification;
     "project.switched": ProjectSwitchedNotification;
+    "project.detached": ProjectDetachedNotification;
+    "project.attached": ProjectAttachedNotification;
     "project.deleted": ProjectDeletedNotification;
     "project.renamed": ProjectRenamedNotification;
     "project.archived": ProjectArchivedNotification;

package/dist/types/runtime/infra/host-agent-provider-directory.d.ts

@@ -0,0 +1,17 @@
+import { type HostAgentProviderDiagnostic, type HostAgentProviderGetResult, type HostAgentProviderListResult, type HostProviderRequestParams } from "../../host-contract/index.js";
+export type HostProviderDirectoryErrorCode = "HOST_PROVIDER_DIRECTORY_UNAVAILABLE" | "HOST_PROVIDER_DIRECTORY_INVALID_RESPONSE";
+export declare class HostProviderDirectoryError extends Error {
+    readonly code: HostProviderDirectoryErrorCode;
+    constructor(code: HostProviderDirectoryErrorCode, message: string, options?: ErrorOptions);
+}
+export interface HostProviderDirectoryRequester {
+    request(params: HostProviderRequestParams): Promise<unknown>;
+}
+export declare class HostAgentProviderDirectory {
+    private readonly requester;
+    constructor(requester: HostProviderDirectoryRequester);
+    list(): Promise<Readonly<HostAgentProviderListResult>>;
+    get(providerId: string): Promise<Readonly<HostAgentProviderGetResult>>;
+    diagnose(providerId: string): Promise<Readonly<HostAgentProviderDiagnostic>>;
+    private read;
+}

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

@@ -1,4 +1,4 @@
-/** Business mutations choose gateway X7 when negotiated, otherwise the standalone local store. */
+/** Project mutations are requests to the Gateway-owned X7 authority. */
 import type { ProjectInfo, ProjectType } from "../../protocol/methods.js";
 export declare function createProjectAuthoritative(params: {
     name: string;