qlogicagent 2.20.1 → 2.20.3

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

@@ -1,17 +1,22 @@
 import type { NotificationMethodMap } from "./wire/notification-payloads.js";
-export declare const AGENT_CONTRACT_VERSION: 6;
+export declare const AGENT_CONTRACT_VERSION: 9;
 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.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", "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.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", "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.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", "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 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.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_activity", "turn.subagent_ended", "turn.subagent_completed", "turn.subagent_decision", "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", "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", "solo.agentDiff", "solo.state", "product.taskStarted", "product.taskOutput", "product.members", "product.agentActivity", "product.taskCompleted", "product.taskFailed", "product.budgetUpdate", "product.budgetWarning", "product.budgetExceeded", "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.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_activity", "turn.subagent_ended", "turn.subagent_completed", "turn.subagent_decision", "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", "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", "solo.agentDiff", "solo.state", "product.taskStarted", "product.taskOutput", "product.members", "product.agentActivity", "product.taskCompleted", "product.taskFailed", "product.budgetUpdate", "product.budgetWarning", "product.budgetExceeded", "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.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_activity", "turn.subagent_ended", "turn.subagent_completed", "turn.subagent_decision", "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", "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", "solo.agentDiff", "solo.state", "product.taskStarted", "product.taskOutput", "product.members", "product.agentActivity", "product.taskCompleted", "product.taskFailed", "product.budgetUpdate", "product.budgetWarning", "product.budgetExceeded", "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 "turn.subagent_started": readonly ["turnId", "parentTurnId", "subagentId", "agentType", "displayName", "delegatedTask", "mode", "startedAt"];
+    readonly "turn.subagent_activity": readonly ["turnId", "parentTurnId", "subagentId", "agentType", "displayName", "conciseStatus", "status", "observedAt"];
+    readonly "turn.subagent_completed": readonly ["turnId", "parentTurnId", "subagentId", "agentType", "displayName", "status", "evidence", "toolsUsed", "durationMs", "tokenUsage", "finishedAt"];
+    readonly "turn.subagent_decision": readonly ["turnId", "parentTurnId", "subagentId", "decision", "decidedAt"];
     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 "product.budgetExceeded": readonly ["productId", "usedTokens", "reason"];
     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"];
@@ -28,21 +33,57 @@ export interface AgentEventEnvelope<K extends AgentEventName = AgentEventName> {
     type: K;
     payload: AgentEventPayloadMap[K];
 }
+export interface ProductPlanInstanceShape {
+    name: string;
+    agentId: string;
+}
+export interface ProductPlanTaskShape {
+    taskId: string;
+    assignee: string;
+    prompt: string;
+    dependsOn?: string[];
+}
+export interface ProductPlanIssue {
+    /** Empty when the issue is about the plan as a whole rather than one task. */
+    taskId: string;
+    reason: string;
+}
+/**
+ * Everything the DAG will reject at confirm time, checked up front.
+ * Returns one issue per problem; an empty array means the plan is structurally runnable.
+ */
+export interface ProductPlanIssueOptions {
+    /**
+     * Flag an assignee that matches no instance (by name or agentId).
+     *
+     * True for the planner, which validates AFTER normalizeAssigneesToInstanceName — there an unmatched
+     * assignee is a real dead end. False for the draft screen, which repairs the same case at confirm by
+     * appending the missing instance; flagging it there would block a draft that is about to be fixed.
+     * Default true: an unmatched assignee is a defect unless the caller says it repairs it.
+     */
+    requireKnownAssignee?: boolean;
+}
+export declare function collectProductPlanIssues(instances: readonly ProductPlanInstanceShape[], tasks: readonly ProductPlanTaskShape[], options?: ProductPlanIssueOptions): ProductPlanIssue[];
 export declare const AGENT_CONTRACT_DESCRIPTOR: {
-    readonly version: 6;
+    readonly version: 9;
     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.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", "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 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.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_activity", "turn.subagent_ended", "turn.subagent_completed", "turn.subagent_decision", "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", "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", "solo.agentDiff", "solo.state", "product.taskStarted", "product.taskOutput", "product.members", "product.agentActivity", "product.taskCompleted", "product.taskFailed", "product.budgetUpdate", "product.budgetWarning", "product.budgetExceeded", "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 "turn.subagent_started": readonly ["turnId", "parentTurnId", "subagentId", "agentType", "displayName", "delegatedTask", "mode", "startedAt"];
+        readonly "turn.subagent_activity": readonly ["turnId", "parentTurnId", "subagentId", "agentType", "displayName", "conciseStatus", "status", "observedAt"];
+        readonly "turn.subagent_completed": readonly ["turnId", "parentTurnId", "subagentId", "agentType", "displayName", "status", "evidence", "toolsUsed", "durationMs", "tokenUsage", "finishedAt"];
+        readonly "turn.subagent_decision": readonly ["turnId", "parentTurnId", "subagentId", "decision", "decidedAt"];
         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 "product.budgetExceeded": readonly ["productId", "usedTokens", "reason"];
         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: "9f6f4e0389933c9949ccd55de37131d17a7ca93e9525ee796f96a349b82ca271";
+export declare const AGENT_CONTRACT_HASH: "1a1a3a59c6601cab382ac31e58198f8f61b182ed452061cd50f68faddeebc5cc";
 export interface AgentContractIdentity {
     version: typeof AGENT_CONTRACT_VERSION;
     hash: typeof AGENT_CONTRACT_HASH;

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, 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, 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, TurnStartNotification, TurnSubagentActivityNotification, TurnSubagentActivityStatus, TurnSubagentCompletedNotification, TurnSubagentDecisionNotification, TurnSubagentDeltaNotification, TurnSubagentEvidenceItem, TurnSubagentStartedNotification, TurnSubagentTokenUsage, TurnSuggestionsNotification, TurnTaskUpdatedNotification, TurnTodosUpdatedNotification, TurnToolBlockedNotification, TurnToolCallNotification, TurnToolResultNotification, TurnToolUseSummaryNotification, TurnUsageUpdateNotification, WireTokenUsage, GoalRoundMessageNotification, MentionDelegateStartedNotification, MentionDelegateActivityNotification, MentionDelegateSettledNotification, } from "./wire/index.js";

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

@@ -81,6 +81,17 @@ export interface McpServerConfig {
 export interface SoloEvaluation {
     winnerId: string;
     reasoning: string;
+    /** True once the user adopted the winner's worktree changes into the workspace (solo.select).
+     *  Absent on the auto-judge recommendation — the UI keeps the adopt action visible until then. */
+    adopted?: boolean;
+    /** displayId of the agent that acted as judge — a competitor judging its own race is a
+     *  trust caveat the user must see, not a hidden implementation detail. */
+    judgedBy?: string;
+    /** True when the judge did NOT compete (preferred): an independent ready agent scored the race. */
+    judgeExternal?: boolean;
+    /** True when the verdict is a fallback (judge turn failed / unparseable response) rather than a
+     *  real comparison — the UI must flag it for manual review instead of presenting it as a ruling. */
+    degraded?: boolean;
 }
 /** Lightweight Spec (design D3): goal + constraints + acceptance, fits one screen. */
 export interface SoloSpec {
@@ -104,6 +115,8 @@ export interface SoloSpecChatParams {
         content: string;
     }[];
     projectId?: string;
+    /** 上一轮形成的规格草稿——回传给主持人做增量更新,防止第二轮起整份重写。 */
+    draft?: SoloSpec;
 }
 /** x/solo.specChat RPC result. */
 export interface SoloSpecChatResult {
@@ -122,15 +135,63 @@ export interface SoloSpecJudgeResult {
      *  soft-gate pass, not a real "spec reviewed OK". Fail-open stays, but honestly labeled. */
     judgeSkipped?: boolean;
 }
-/** x/workflow.chat RPC params(M4 自动化页对话式搭图/改图)。history 含到本轮的完整对话;
- *  currentWorkflow 为已有图的渲染文本(改图上下文,前端从 store 提供)。 */
+export interface WorkflowChatContextCheckpoint {
+    protocolVersion: 1;
+    producer: "qlogicagent";
+    payload: {
+        messages: {
+            role: "user" | "assistant";
+            content: string;
+        }[];
+        /** Revisable conversation evidence. Deliberately has no ready/complete/pass gate. */
+        intentContract?: WorkflowIntentContract;
+    };
+}
+export interface WorkflowIntentContract {
+    revision: number;
+    observations: Array<{
+        id: string;
+        sequence: number;
+        text: string;
+    }>;
+    facts: Array<{
+        id: string;
+        statement: string;
+        confidence: "explicit" | "inferred";
+        sourceObservationIds: string[];
+        status: "active" | "superseded";
+    }>;
+    openQuestions: Array<{
+        id: string;
+        question: string;
+        sourceObservationIds: string[];
+        status: "open" | "resolved";
+    }>;
+    diagnostics: string[];
+}
+export interface WorkflowChatContextTurn {
+    sequence: number;
+    role: "user" | "assistant";
+    content: string;
+}
+/** x/workflow.chat RPC params(M4 自动化页对话式搭图/改图)。
+ * Runtime Host 传入 durable checkpoint + checkpoint 之后的新消息。`history` 仅保留给显式
+ * ephemeral 局部编辑，不再是持久化会话权威。 */
 export interface WorkflowChatParams {
-    history: {
+    context?: {
+        checkpoint: WorkflowChatContextCheckpoint | null;
+        newTurns: WorkflowChatContextTurn[];
+    };
+    /** Answered UI clarification ids. Resolves revisable evidence only; never marks the workflow complete. */
+    resolvedClarificationIds?: string[];
+    history?: {
         role: "user" | "assistant";
         content: string;
     }[];
     /** Registered project whose capability catalog and workflow draft are being edited. */
     projectId: string;
+    /** Workflow currently edited. The Host injects this into connector tools. */
+    workflowId?: string;
     /** Exact Runtime Host capability snapshot for this proposal round. */
     capabilities: Array<{
         category: string;
@@ -140,22 +201,49 @@ export interface WorkflowChatParams {
         [key: string]: unknown;
     }>;
     currentWorkflow?: string;
-    /** D19 框选局部修改:框选的节点 id;非空 → agent 产 scoped patch(前端再交给 Gateway Host 应用)。 */
+    /** Host-built bounded prompt context; full currentWorkflow stays compiler-only. */
+    editContext?: Record<string, unknown>;
+    /** D19 框选局部修改:框选的节点 id;非空 → agent 产 scoped proposal，由 Gateway Host 应用。 */
     scope?: string[];
 }
-/** x/workflow.chat RPC result:propose-only —— 新建给 def,改已有给 patch(均为松类型,前端转发给
- *  Gateway Host 的 workflow.create/patch 落库并强校验)。 */
+/** x/workflow.chat RPC result:one deterministic proposal compiled from bounded Agent operations.
+ * Runtime Host is the only mutation owner; UI never receives or reapplies raw graph patches. */
 export interface WorkflowChatResult {
     reply?: string;
-    def?: Record<string, unknown>;
-    patch?: unknown[];
-    trigger?: Record<string, unknown>;
+    proposal?: {
+        patch: unknown[];
+    };
     error?: string;
     /** propose 全被校验拒(无任何提案落地)时的显式失败:前端展示真实错误 + 重试出路,不许当正常回复。 */
     rejected?: {
         attempts: number;
         errors: string[];
     };
+    /** Agent-authored structured interaction. Transport only: not a save, finish, or proposal gate. */
+    clarify?: Array<{
+        intentQuestionId?: string;
+        id?: string;
+        purpose?: string;
+        nodeId?: string;
+        field?: string;
+        header: string;
+        question: string;
+        options?: Array<{
+            label: string;
+            description?: string;
+        }>;
+        multiSelect?: boolean;
+    }>;
+    /** qlogicagent-owned compact model context. Runtime stores this opaque payload separately from
+     *  the complete visible transcript and assigns the durable transcript boundary on commit. */
+    contextCheckpoint?: WorkflowChatContextCheckpoint;
+    semanticAcceptance?: Record<string, unknown>;
+    intentContract?: WorkflowIntentContract;
+    capabilitySelection?: string[];
+    /** Host-owned secure input request produced by a connector tool. */
+    pendingConnectorInput?: Record<string, unknown>;
+    /** Layered connector validation evidence; informative and never a uniform completion gate. */
+    connectorValidation?: Record<string, unknown>;
 }
 /** solo.start RPC params. */
 export interface SoloStartParams {

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

@@ -23,6 +23,7 @@ export declare const ACP_EXTENDED_METHODS: {
     readonly SOLO_START: "x/solo.start";
     readonly SOLO_SELECT: "x/solo.select";
     readonly SOLO_CANCEL: "x/solo.cancel";
+    readonly SOLO_DELETE: "x/solo.delete";
     readonly PRODUCT_CREATE: "x/product.create";
     readonly PRODUCT_PLAN: "x/product.plan";
     readonly PRODUCT_CONFIRM: "x/product.confirm";
@@ -127,6 +128,11 @@ export interface AcpInitializeResult {
 }
 export interface AcpSessionMeta {
     projectId?: string;
+    /**
+     * Agent-internal materialization of the standard session/new|load `cwd`.
+     * Hosts MUST use the standard top-level field; prompt `_meta` cannot change it.
+     */
+    workdir?: string;
     sessionType?: string;
     groupKey?: string;
     groupName?: string;
@@ -165,7 +171,7 @@ export interface AcpSessionNewParams {
     resumeSessionId?: string;
     forkSession?: boolean;
     /** Per-session context supplement (no standard ACP home). Inherited by every session/prompt. */
-    _meta?: Omit<AcpSessionMeta, "mcpServers">;
+    _meta?: Omit<AcpSessionMeta, "mcpServers" | "workdir">;
 }
 export interface AcpSessionLoadParams {
     sessionId: string;

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

@@ -34,7 +34,21 @@ export interface SoloStatus {
     evaluation?: {
         winnerId: string;
         reasoning: string;
-    };
+        adopted?: boolean;
+        judgedBy?: string;
+        degraded?: boolean;
+    };
+    /** Original task text — history reopen must show what the race was about. */
+    task?: string;
+    /** Clarified Spec (goal/constraints/acceptance) when the race was started from one. */
+    spec?: {
+        goal: string;
+        constraints: string[];
+        acceptance: string[];
+        rawTask?: string;
+    };
+    /** Epoch ms the race started. */
+    createdAt?: number;
 }
 export type ProductPhase = "active" | "paused" | "completed" | "failed";
 export type ProductTaskStatus = "pending" | "running" | "completed" | "failed" | "paused" | "skipped";

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

@@ -5,20 +5,18 @@ export { type ChatMessage, type ChatMessageRole, type LocalizedToolText, type Th
 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 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 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 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 TurnStartNotification, type TurnSubagentActivityNotification, type TurnSubagentActivityStatus, type TurnSubagentCompletedNotification, type TurnSubagentDecisionNotification, type TurnSubagentDeltaNotification, type TurnSubagentEndedNotification, type TurnSubagentEvidenceItem, type TurnSubagentStartedNotification, type TurnSubagentTokenUsage, 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 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";
 export { CAPABILITY_MANIFEST_DIFF_SECTIONS, cloneCapabilityManifestSnapshot, createCapabilityManifestDiffPayload, deriveCapabilityToolNamespaces, deriveCapabilityWorkspaceIds, mergeCapabilityManifestSnapshot, type CapabilityManifestApprovalMode, type CapabilityManifestApprovalPolicyContract, type CapabilityManifestDiffSection, type CapabilityMcpManifestContract, type CapabilityManifestSnapshotContract, type HostCapabilitySnapshotContract, type CapabilityPluginManifestContract, type RuntimeCapabilityViewContract, type RuntimeToolEligibilityContract, type CapabilitySkillManifestContract, type CapabilityToolManifestContract, type CapabilityWorkspaceSummaryContract, type ToolEligibilityResolvedSource, type ToolEligibilityReasonCode, type ToolEligibilityStatus, } from "./capability-manifest.js";
 export { WEB_ACTION_SCOPE_VALUES, WEB_APPROVAL_DEFAULT_VALUES, WEB_CAPABILITY_FAMILY_VALUES, WEB_CAPABILITY_ID_VALUES, WEB_DEGRADATION_TARGET_VALUES, WEB_ESCALATION_REASON_VALUES, WEB_EXECUTION_MODE_VALUES, WEB_POLICY_RISK_CLASS_VALUES, WEB_RETRY_POLICY_VALUES, WEB_STATEFULNESS_VALUES, WEB_TASK_MODE_VALUES, type WebActionScope, type WebApprovalDefault, type WebCapabilityDescriptorContract, type WebCapabilityFamily, type WebCapabilityId, type WebDegradationTarget, type WebEscalationReason, type WebExecutionMode, type WebPolicyRiskClass, type WebRetryPolicy, type WebStatefulness, type WebTaskMode, type ToolRiskLevel, } from "./web-capability.js";
-export { MEMORY_OBSERVATION_HOOK_VALUES, MEMORY_OBSERVATION_SOURCE_VALUES, MEMORY_WRITE_ACCESS_VALUES, type MemoryContextBlock, type MemoryIngestOptions, type MemoryLlmConfig, type MemoryObservedPayload, type MemoryObservationEnvelope, type MemoryObservationHook, type MemoryObservationSource, type MemoryProvider, type MemorySearchOptions, type MemorySearchResult, type MemoryWriteAccess, } from "./memory-provider-lifecycle.js";
+export { MEMORY_OBSERVATION_HOOK_VALUES, MEMORY_OBSERVATION_SOURCE_VALUES, MEMORY_WRITE_ACCESS_VALUES, type MemoryContextBlock, type MemoryObservedPayload, type MemoryObservationEnvelope, type MemoryObservationHook, type MemoryObservationSource, type MemoryWriteAccess, } from "./memory-provider-lifecycle.js";
 export { RESOURCE_MANIFEST_SCHEMA_VERSION, RUNTIME_ASSET_IDS, RUNTIME_PROFILE_IDS, createDefaultRuntimeResourceProfiles, getManifestShortcutEntry, getRuntimeResourceAsset, getRuntimeResourceProfile, getRuntimeResourceProfileAssets, normalizeRuntimeResourceManifest, upsertRuntimeResourceAsset, type RuntimeManifestShortcutEntry, type RuntimeResourceArtifact, type RuntimeResourceAsset, type RuntimeResourceAssetDelivery, type RuntimeResourceAssetKind, type RuntimeResourceAssetMap, type RuntimeResourceManifest, type RuntimeResourcePlatform, type RuntimeResourceProfile, type RuntimeResourceProfileMap, } from "./resource-manifest.js";
 export { MUTATION_CHECKPOINT_ENTRY_KIND_VALUES, MUTATION_CHECKPOINT_BACKEND_VALUES, MUTATION_CHECKPOINT_PHASE_VALUES, type MutationCheckpointBackend, type MutationCheckpointContract, type MutationCheckpointEntryKind, type MutationCheckpointPhase, type MutationCheckpointRestoreAckContract, type MutationCheckpointRollbackResultContract, type MutationCheckpointRestoreContract, type MutationCheckpointSnapshotEntryContract, } from "./checkpoint.js";
 export { type MutationCheckpointRuntimeManager, type MutationCheckpointRuntimeManagerDeps, } from "./checkpoint-runtime.js";
 export { PROVIDER_RUNTIME_AUTH_MODE_VALUES, PROVIDER_RUNTIME_COMPAT_FLAG_VALUES, PROVIDER_RUNTIME_VAULT_ERROR_TYPE_VALUES, readProviderRuntimeCompatFlag, type ProviderRuntimeAdapterContract, type ProviderRuntimeAuthMode, type ProviderRuntimeCompatFlag, type ProviderRuntimeCompatModelContract, type ProviderRuntimeProfileRecordContract, type ProviderRuntimeProfileStoreContract, type ProviderRuntimeResolvedAuthContract, type ProviderRuntimeVaultErrorType, } from "./provider-runtime-contract.js";
 export { PROVIDER_RUNTIME_OPENAI_CODEX_PROVIDER_ID, PROVIDER_RUNTIME_ENV_API_KEY_CANDIDATES, isAnthropicProviderRuntimeFamily, isOpenAiProviderRuntimeFamily, listProviderRuntimeEnvApiKeyNames, normalizeProviderRuntimeId, normalizeProviderRuntimeIdForAuth, preservesProviderRuntimeAnthropicThinkingSignatures, requiresOpenAiCompatibleAnthropicToolPayloadForProviderRuntime, resolveProviderRuntimeCapabilities, resolveProviderRuntimeEnvApiKey, resolveProviderRuntimeKeyFamily, resolveProviderRuntimeTranscriptToolCallIdMode, shouldDropThinkingBlocksForProviderRuntimeModel, shouldSanitizeProviderRuntimeThoughtSignaturesForModel, supportsOpenAiCompatTurnValidationForProviderRuntime, usesOpenAiFunctionAnthropicToolSchemaForProviderRuntime, usesOpenAiStringModeAnthropicToolChoiceForProviderRuntime, type ProviderRuntimeAuthCoreDeps, type ProviderRuntimeAuthProfileDeps, type ProviderRuntimeCapabilities, type ProviderRuntimeCredentialMap, type ProviderRuntimeCredentialRecord, type ProviderRuntimeEnvApiKeyResult, type ProviderRuntimePlatformKey, type ProviderRuntimeResolvedAuth, type ProviderRuntimeResolvedAuthMode, } from "./provider-runtime-core.js";
 export * from "./transport.js";
-export * from "./channel.js";
 export * from "./capability-transport.js";
 export * from "./execution.js";
 export * from "./turn.js";

package/dist/types/protocol/wire/memory-provider-lifecycle.d.ts

@@ -6,7 +6,7 @@ export type MemoryObservationSource = (typeof MEMORY_OBSERVATION_SOURCE_VALUES)[
 export declare const MEMORY_WRITE_ACCESS_VALUES: readonly ["observe-only", "parent-write", "deny"];
 export type MemoryWriteAccess = (typeof MEMORY_WRITE_ACCESS_VALUES)[number];
 export interface MemoryContextBlock {
-    blockId?: string;
+    id?: string;
     providerId: string;
     kind: "informational-background";
     title?: string;
@@ -29,41 +29,3 @@ export interface MemoryObservedPayload extends MemoryObservationEnvelope {
     blocks?: MemoryContextBlock[];
     error?: string;
 }
-export interface MemoryLlmConfig {
-    provider: string;
-    baseUrl: string;
-    apiKey: string;
-    model: string;
-}
-export interface MemorySearchResult {
-    blockId: string;
-    text: string;
-    score: number;
-    source?: string;
-    metadata?: Record<string, unknown>;
-}
-export interface MemorySearchOptions {
-    limit?: number;
-    minScore?: number;
-    llmConfig?: MemoryLlmConfig;
-    /** Categories to boost during reranking (e.g. ["lesson", "preference"]). */
-    preferredCategories?: string[];
-    /** Drop hits whose tags contain ALL strings of any group (resident-layer exclusion:
-     * entries already injected verbatim via the global INDEX must not be recalled again). */
-    excludeTagGroups?: string[][];
-}
-export interface MemoryIngestOptions {
-    llmConfig?: MemoryLlmConfig;
-    source?: string;
-    sessionId?: string;
-}
-export interface MemoryProvider {
-    readonly providerId: string;
-    search(query: string, userId: string, options?: MemorySearchOptions): Promise<MemorySearchResult[]>;
-    /** Store a plain text memory entry (no LLM extraction — agent decides content). */
-    addText?(text: string, userId: string, options?: MemoryIngestOptions): Promise<{
-        memoriesAdded: number;
-    }>;
-    /** Remove a memory entry by ID. */
-    remove?(memoryId: string): Promise<boolean>;
-}

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

@@ -168,6 +168,8 @@ export interface TurnSuggestionsNotification {
 export interface TurnMemoryRecallNotification {
     sessionId: string;
     turnId: string;
+    /** How the single Host retrieval chain was entered. */
+    source: "automatic" | "tool";
     count: number;
     /** Truncated texts of the memories actually injected (post-cap), for the expanded list. */
     titles: string[];
@@ -191,6 +193,20 @@ export interface TurnSubagentDeltaNotification {
     subagentId?: string;
     text: string;
 }
+export type TurnSubagentActivityStatus = "running" | "completed" | "failed" | "blocked";
+/** Tool-level sub-agent progress. Never carries hidden reasoning or raw model chain-of-thought. */
+export interface TurnSubagentActivityNotification {
+    turnId: string;
+    parentTurnId: string;
+    subagentId: string;
+    agentType: string;
+    displayName: string;
+    activityId?: string;
+    toolName?: string;
+    conciseStatus: string;
+    status: TurnSubagentActivityStatus;
+    observedAt: string;
+}
 /** Sidechain completed execution. */
 export interface TurnSidechainCompletedNotification {
     turnId: string;
@@ -306,7 +322,7 @@ export interface TurnTodosUpdatedNotification {
 export interface TurnExecProgressNotification {
     output: string;
     elapsedTimeSeconds: number;
-    totalLines: number;
+    visibleLines: number;
     totalBytes: number;
 }
 /**
@@ -557,6 +573,27 @@ export interface SoloEvaluationNotification {
     soloId: string;
     winnerId: string;
     reasoning: string;
+    /** Present (true) only on the solo.select adoption event; absent on the auto-judge recommendation. */
+    adopted?: boolean;
+    /** displayId of the agent that acted as judge (trust caveat when it is also a racer). */
+    judgedBy?: string;
+    /** True when an independent, non-competing agent judged the race. */
+    judgeExternal?: boolean;
+    /** True when the verdict is a fallback (judge failed / unparseable) — flag for manual review. */
+    degraded?: boolean;
+}
+/** Full unified diff of one competitor's worktree, emitted when a turn settles (initial run or
+ *  follow-up). Carries the same capped diff the judge scores, so the user sees what the judge sees. */
+export interface SoloAgentDiffNotification {
+    soloId: string;
+    agentId: string;
+    diff: string;
+}
+/** Run-level Solo state transition (e.g. entering/leaving "evaluating"), so the UI can show the
+ *  auto-judge phase instead of a silent gap between all-done and the verdict. */
+export interface SoloStateNotification {
+    soloId: string;
+    state: "running" | "evaluating" | "completed" | "failed" | "cancelled";
 }
 /** Solo agent streaming delta. */
 export interface SoloAgentDeltaNotification {
@@ -611,6 +648,17 @@ export interface ProductBudgetWarningNotification {
     maxTotalTokens: number;
     percentage: number;
 }
+/**
+ * Product budget hard limit hit (100%) — the run auto-paused. The counterpart of the 80% warning, and
+ * the louder of the two: the run has stopped. `maxTotalTokens` is absent for a time-only budget, so
+ * `reason` is what states WHICH ceiling tripped.
+ */
+export interface ProductBudgetExceededNotification {
+    productId: string;
+    usedTokens: number;
+    maxTotalTokens?: number;
+    reason: string;
+}
 /** Product completed (all tasks done or terminal). */
 export interface ProductCompletedNotification {
     productId: string;
@@ -777,8 +825,14 @@ export interface ProjectUnarchivedNotification {
 /** A sub-agent was spawned. */
 export interface TurnSubagentStartedNotification {
     turnId: string;
+    parentTurnId: string;
     subagentId: string;
     agentType: string;
+    displayName: string;
+    delegatedTask: string;
+    mode: "foreground" | "background";
+    startedAt: string;
+    /** @deprecated Use delegatedTask. */
     prompt?: string;
 }
 /** A sub-agent finished. */
@@ -790,6 +844,41 @@ export interface TurnSubagentEndedNotification {
     outputPreview?: string;
     error?: string;
 }
+export interface TurnSubagentEvidenceItem {
+    source: "tool" | "artifact" | "verification";
+    label: string;
+    status: "passed" | "failed" | "observed";
+}
+export interface TurnSubagentTokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+}
+/** Canonical terminal lifecycle event for foreground and background sub-agents. */
+export interface TurnSubagentCompletedNotification {
+    turnId: string;
+    parentTurnId: string;
+    subagentId: string;
+    agentType: string;
+    displayName: string;
+    status: "completed" | "failed" | "cancelled";
+    resultSummary?: string;
+    evidence: TurnSubagentEvidenceItem[];
+    toolsUsed: string[];
+    durationMs: number;
+    tokenUsage: TurnSubagentTokenUsage;
+    error?: string;
+    finishedAt: string;
+}
+/** Explicit parent synthesis decision; absence remains truthfully "pending", never inferred. */
+export interface TurnSubagentDecisionNotification {
+    turnId: string;
+    parentTurnId: string;
+    subagentId: string;
+    decision: "adopted" | "partially_adopted" | "rejected";
+    summary?: string;
+    decidedAt: string;
+}
 /** A task lifecycle state changed. */
 export interface TaskUpdatedNotification {
     taskId: string;
@@ -930,9 +1019,12 @@ export interface NotificationMethodMap {
     "turn.memory_written": TurnMemoryWrittenNotification;
     "turn.sidechain_started": TurnSidechainStartedNotification;
     "turn.subagent_delta": TurnSubagentDeltaNotification;
+    "turn.subagent_activity": TurnSubagentActivityNotification;
     "turn.sidechain_completed": TurnSidechainCompletedNotification;
     "turn.subagent_started": TurnSubagentStartedNotification;
     "turn.subagent_ended": TurnSubagentEndedNotification;
+    "turn.subagent_completed": TurnSubagentCompletedNotification;
+    "turn.subagent_decision": TurnSubagentDecisionNotification;
     "turn.annotations": TurnAnnotationsNotification;
     "turn.media_result": TurnMediaResultNotification;
     "turn.media_progress": TurnMediaProgressNotification;
@@ -968,11 +1060,14 @@ export interface NotificationMethodMap {
     "solo.evaluation": SoloEvaluationNotification;
     "solo.agentDelta": SoloAgentDeltaNotification;
     "solo.agentUsage": SoloAgentUsageNotification;
+    "solo.agentDiff": SoloAgentDiffNotification;
+    "solo.state": SoloStateNotification;
     "product.taskStarted": ProductTaskStartedNotification;
     "product.taskCompleted": ProductTaskCompletedNotification;
     "product.taskFailed": ProductTaskFailedNotification;
     "product.checkpointed": ProductCheckpointedNotification;
     "product.budgetWarning": ProductBudgetWarningNotification;
+    "product.budgetExceeded": ProductBudgetExceededNotification;
     "product.completed": ProductCompletedNotification;
     "product.dagTopology": ProductDagTopologyNotification;
     "product.budgetUpdate": ProductBudgetUpdateNotification;

package/dist/types/protocol/wire/web-capability.d.ts

@@ -1,4 +1,4 @@
-export declare const WEB_CAPABILITY_ID_VALUES: readonly ["web_search", "web_fetch", "deep_research", "browser_execution"];
+export declare const WEB_CAPABILITY_ID_VALUES: readonly ["web_search", "web_fetch", "web_research", "browser_execution"];
 export type WebCapabilityId = (typeof WEB_CAPABILITY_ID_VALUES)[number];
 export declare const WEB_CAPABILITY_FAMILY_VALUES: readonly ["web-intelligence", "browser-execution"];
 export type WebCapabilityFamily = (typeof WEB_CAPABILITY_FAMILY_VALUES)[number];
@@ -16,7 +16,7 @@ export declare const TOOL_RISK_LEVEL_VALUES: readonly ["read", "write", "system"
 export type ToolRiskLevel = (typeof TOOL_RISK_LEVEL_VALUES)[number];
 export declare const WEB_ACTION_SCOPE_VALUES: readonly ["read-page", "read-authenticated-page", "fill-form", "submit-form", "download-file", "reuse-session"];
 export type WebActionScope = (typeof WEB_ACTION_SCOPE_VALUES)[number];
-export declare const WEB_DEGRADATION_TARGET_VALUES: readonly ["web_search", "web_fetch", "deep_research", "blocked"];
+export declare const WEB_DEGRADATION_TARGET_VALUES: readonly ["web_search", "web_fetch", "web_research", "blocked"];
 export type WebDegradationTarget = (typeof WEB_DEGRADATION_TARGET_VALUES)[number];
 export declare const WEB_ESCALATION_REASON_VALUES: readonly ["requires-interaction", "requires-login-state", "requires-rendered-dom", "requires-persistent-session", "requires-state-changing-action"];
 export type WebEscalationReason = (typeof WEB_ESCALATION_REASON_VALUES)[number];