qlogicagent 2.20.2 → 2.20.4

package/dist/types/orchestration/workflow-chat-builder.d.ts

@@ -2,25 +2,89 @@
  * Workflow Chat Builder (M4) — 自动化页"意图先行"的对话搭图/改图(D18/D17)。
  *
  * 与 solo-spec-builder.runSpecChatRound 同构:进程内 runForkedAgent + 受限工具,纯推理产出,
- * 不直接落库。区别:产出的是 **工作流提案**——新建给完整 WorkflowDef,改已有给 WorkflowPatch[]。
- * 应用由调用方(前端经既有 workflow.create/patch RPC,触发 WS 回流画布)完成,故本轮无副作用、
- * 也无需访问引擎控制器。
+ * 不直接落库。Agent 只提交有界 authoring operations；确定性编译器根据 Host 能力目录生成
+ * WorkflowPatch[]、dry-run 并产生流程级验收证据。应用仍由 Runtime Host 原子完成。
  */
 import type { ForkedAgentRunnerFactory } from "../runtime/ports/agent-execution-contracts.js";
 import type { LLMTransport } from "../runtime/ports/index.js";
-import type { ToolDefinition, AgentLogger } from "../agent/types.js";
+import type { ChatMessage, ToolDefinition, AgentLogger } from "../agent/types.js";
+import { type WorkflowPatch } from "./workflow/workflow-patch.js";
 import { type CapabilityEntry } from "./workflow/capability-catalog.js";
-/** agent 通过此工具产出工作流提案:新建给 def,改已有给 patch。 */
+import { type WorkflowIntentContract } from "./workflow/workflow-intent-contract.js";
+import type { WorkflowEditContextCapsule } from "./workflow/workflow-edit-context.js";
+import { type WorkflowSemanticAcceptance } from "./workflow/semantic-acceptance.js";
+export interface WorkflowClarification {
+    /** Host-roundtrip id for deterministically resolving this open question after an answer. */
+    intentQuestionId?: string;
+    /** Stable semantic id supplied by the Agent when the question is not tied to one field. */
+    id?: string;
+    /** Why this choice is useful; transported for telemetry/context, never interpreted as a gate. */
+    purpose?: string;
+    /** Optional field target for __ASK__ replacement flows. */
+    nodeId?: string;
+    field?: string;
+    header: string;
+    question: string;
+    options?: Array<{
+        label: string;
+        description?: string;
+    }>;
+    multiSelect?: boolean;
+}
+export interface WorkflowChatContextCheckpoint {
+    protocolVersion: 1;
+    producer: "qlogicagent";
+    payload: {
+        messages: {
+            role: "user" | "assistant";
+            content: string;
+        }[];
+        intentContract?: WorkflowIntentContract;
+    };
+}
+export interface WorkflowChatContextInput {
+    checkpoint: WorkflowChatContextCheckpoint | null;
+    newTurns: Array<{
+        sequence: number;
+        role: "user" | "assistant";
+        content: string;
+    }>;
+}
+type WorkflowChatContextMessage = {
+    role: "user" | "assistant";
+    content: string;
+};
+export declare function buildWorkflowChatPromptContext(input: {
+    context?: WorkflowChatContextInput;
+    history?: {
+        role: "user" | "assistant";
+        content: string;
+    }[];
+    model: string;
+    budgetTokens?: number;
+}): {
+    promptMessages: ChatMessage[];
+    checkpointMessages: WorkflowChatContextMessage[];
+};
+/** Agent emits bounded authoring operations; the deterministic compiler owns graph JSON. */
 export declare const PROPOSE_WORKFLOW_TOOL_NAME = "propose_workflow";
 export declare const PROPOSE_WORKFLOW_TOOL_DEF: ToolDefinition;
-/** 单轮入参。history 含到本轮为止的完整对话(末条为用户最新消息)。currentWorkflow 为已有图的渲染文本(改图上下文)。
- *  v1 不带 ask_user(不反问;直接用默认搭,用户再说一句改),故澄清往返的网关路由也无需接。 */
+/** Structured clarification transport only. It does not decide whether asking is required. */
+export declare const REQUEST_WORKFLOW_INPUT_TOOL_NAME = "request_workflow_input";
+export declare const REQUEST_WORKFLOW_INPUT_TOOL_DEF: ToolDefinition;
+/** 单轮入参。Runtime Host 传 checkpoint + 新消息；history 只服务不写主对话的 ephemeral 局部编辑。
+ * currentWorkflow 为已有图的渲染文本(改图上下文)。 */
 export interface WorkflowChatDeps {
-    history: {
+    context?: WorkflowChatContextInput;
+    /** Answered clarification ids from the transport; resolves evidence only and never ends the task. */
+    resolvedClarificationIds?: string[];
+    history?: {
         role: "user" | "assistant";
         content: string;
     }[];
     currentWorkflow?: string;
+    /** Host-built bounded prompt context. The full graph remains private compiler input. */
+    editContext?: WorkflowEditContextCapsule;
     /** D19 框选局部修改:用户框选的节点 id;非空时指示 agent 只产出 scoped patch(引擎按同 scope 强制)。 */
     scope?: string[];
     /**
@@ -29,18 +93,32 @@ export interface WorkflowChatDeps {
      * 校验回环拒绝引用目录外能力(反幻觉)。缺省(无目录)时退回静态 kind 说明、不做 ref 校验。
      */
     catalog?: CapabilityEntry[];
+    /** Automation-only Host tools. Omitted entirely outside workflow configuration. */
+    connectorTools?: ToolDefinition[];
+    invokeConnectorTool?: (name: string, args: Record<string, unknown>) => Promise<unknown>;
     transport: LLMTransport;
     apiKey: string;
     model: string;
     createAgentRunner: ForkedAgentRunnerFactory;
     log: AgentLogger;
     parentSignal?: AbortSignal;
+    /** Test seam for deterministic forced compaction. Production uses the model-derived budget. */
+    contextBudgetTokens?: number;
 }
 export interface WorkflowChatResult {
     reply: string;
-    def?: Record<string, unknown>;
-    patch?: unknown[];
-    trigger?: Record<string, unknown>;
+    proposal?: {
+        patch: WorkflowPatch[];
+    };
+    /**
+     * A valid partial proposal can coexist with a later rejected refinement. The Host still applies
+     * the validated patch, while the UI receives the actual rejected diagnostics instead of an
+     * assistant success claim that describes nodes which never reached the candidate graph.
+     */
+    proposalWarnings?: {
+        attempts: number;
+        errors: string[];
+    };
     /**
      * Fail-loud(§3/EX-A):本轮 agent 调过 propose_workflow 但**没有任何一次通过校验**时带上
      * (attempts=被拒次数,errors=最后一次的校验错误)。reply 此时只是 agent 的口头方案,
@@ -51,17 +129,24 @@ export interface WorkflowChatResult {
         errors: string[];
     };
     /**
-     * AI-2: per-field {{ __ASK__ }} placeholders the agent left for genuinely-unknown REQUIRED values.
-     * The def IS applied (so the user sees the shape) but these nodes show a 待补 badge and the
-     * workflow cannot be activated until resolved. Absent/empty = nothing pending.
+     * Per-field __ASK__ placeholders for genuinely unknown required values. They remain revisable
+     * conversation state and never prevent already reliable parts of the proposal being applied.
      */
-    clarify?: {
-        nodeId: string;
-        field: string;
-        question: string;
-    }[];
+    clarify?: WorkflowClarification[];
+    /** Flow-level evidence for the accepted candidate. It informs the user; it is not a hard gate. */
+    semanticAcceptance?: WorkflowSemanticAcceptance;
+    /** Revisable conversational evidence only; never a save/finish gate. */
+    intentContract: WorkflowIntentContract;
+    /** IDs included in the initial compact working set; full catalog remains searchable. */
+    capabilitySelection?: string[];
+    /** Structured secure-input request returned by connector_request_connection. */
+    pendingConnectorInput?: Record<string, unknown>;
+    /** Most recent connector_validate evidence, surfaced without turning it into a finish gate. */
+    connectorValidation?: Record<string, unknown>;
+    contextCheckpoint: WorkflowChatContextCheckpoint;
 }
 /** agent 按需检索能力长尾(系统提示只放每类前 N 条)。 */
 export declare const LIST_CAPABILITIES_TOOL_NAME = "list_capabilities";
-/** 跑一轮对话式搭图/改图,返回自然语言 reply + 工作流提案(def 新建 / patch 改已有)。失败抛,由调用方降级。 */
+/** 跑一轮对话式搭图/改图,返回自然语言 reply + 编译后的工作流 patch。失败抛,由调用方降级。 */
 export declare function runWorkflowChatRound(deps: WorkflowChatDeps): Promise<WorkflowChatResult>;
+export {};

package/dist/types/orchestration/worktree-task-prompt.d.ts

@@ -0,0 +1 @@
+export declare function buildWorktreeTaskPrompt(worktreePath: string, prompt: string): string;

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>;
-}