qlogicagent 2.20.6 → 2.20.7

package/dist/types/orchestration/goal-run-types.d.ts

@@ -1,16 +1,113 @@
 /** Loop tunables (single source of truth — I9). */
 export declare const GOAL_NO_PROGRESS_LIMIT = 3;
 export declare const GOAL_SOFT_NO_PROGRESS_LIMIT = 8;
-export declare const GOAL_DRAIN_TIMEOUT_MS: number;
+export declare const GOAL_PHASE_TIMEOUT_MS: number;
 export declare const GOAL_UNREACHABLE_MIN_STREAK = 2;
-export type GoalRunStatus = "running" | "ended";
+export type GoalRunStatus = "running" | "blocked" | "ended";
 export type GoalPauseState = "running" | "draining" | "paused";
-/** Why a run is paused: the user's explicit pause vs the engine's GOAL_DRAIN_TIMEOUT_MS wall expiring
- *  on its own. Carried on the `paused` event payload, the snapshot and goal.run_state_changed so an
- *  engine-imposed pause is never indistinguishable from a user action (限制必须可见,不静默)。 */
-export type GoalPauseReason = "user_pause" | "drain_timeout";
+/** Why a run is paused; the canonical paused item keeps engine and user intent distinguishable. */
+export type GoalPauseReason = "user_pause" | "phase_timeout";
 export type GoalEndReason = "done" | "stopped" | "failed";
 export type AcceptanceStatus = "pending" | "passed" | "failed" | "superseded";
+export type GoalSpecStatus = "drafting" | "awaiting_clarification" | "awaiting_confirmation" | "confirmed";
+export type GoalStageName = "drafting_spec" | "initializing_checklist" | "planning_phase" | "reviewing_plan" | "executing_tasks" | "assessing_results" | "compacting_progress" | "recovering";
+/** Durable, user-safe activity projection. It exposes what is happening without leaking reasoning. */
+export interface GoalStage {
+    stage: GoalStageName;
+    phaseIndex: number;
+    agentId: string;
+    role: GoalControlRole | "worker_team" | "system";
+    startedAt: string;
+    detail?: string;
+}
+export type GoalInstructionKind = "instruction_once" | "constraint_add" | "constraint_remove" | "answer_to_blocker" | "priority_change";
+export type GoalTaskStatus = "pending" | "running" | "completed" | "failed" | "blocked" | "superseded";
+export type GoalControlRole = "leader" | "planner" | "plan_critic" | "acceptance_judge";
+export type GoalExecutionRole = "implementer" | "tester" | "reviewer" | "integrator";
+export type GoalAgentRole = GoalControlRole | GoalExecutionRole;
+export interface GoalTaskProjection {
+    taskId: string;
+    assignee: string;
+    prompt: string;
+    dependsOn?: string[];
+    acceptanceCriteria?: string;
+    status: GoalTaskStatus;
+    result?: string;
+    error?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    changedFiles?: string[];
+}
+export interface GoalRoleProjection {
+    name: string;
+    role: GoalAgentRole;
+    agentId: string;
+}
+export interface GoalMilestone {
+    phaseIndex: number;
+    label: string;
+    status: "planned" | "running" | "completed" | "failed" | "blocked";
+    productId?: string;
+    tasks: GoalTaskProjection[];
+    roles: GoalRoleProjection[];
+}
+export interface GoalBlocker {
+    code: string;
+    message: string;
+    phaseIndex?: number;
+    taskId?: string;
+    askId?: string;
+    questions?: Array<{
+        id: string;
+        prompt: string;
+    }>;
+    createdAt: string;
+}
+export interface GoalBudget {
+    maxTotalTokens?: number;
+    maxDurationMs?: number;
+    inputTokens: number;
+    outputTokens: number;
+}
+/**
+ * Execution choices captured when the user starts a Goal. They are durable so a recovered
+ * driver uses the same model/permission/skill policy instead of silently falling back to defaults.
+ */
+export interface GoalTurnContext {
+    modelId?: string;
+    reasoningEffort?: string;
+    permissions?: unknown;
+    activeSkills?: string[];
+}
+/** The single user-confirmed authority for planning, execution and acceptance. */
+export interface GoalSpec {
+    revision: number;
+    objective: string;
+    /** Canonical execution boundary confirmed by the user with the rest of the GoalSpec. */
+    workspaceMutationPolicy: "forbid" | "allow";
+    inScope: string[];
+    outOfScope: string[];
+    constraints: string[];
+    assumptions: string[];
+    acceptanceCriteria: AcceptanceCriterion[];
+    verificationStrategy: string[];
+    openQuestions: Array<{
+        id: string;
+        prompt: string;
+    }>;
+}
+export interface GoalFinalReport {
+    outcome: GoalEndReason;
+    summary: string;
+    acceptanceChecklist: AcceptanceChecklist;
+    milestones: GoalMilestone[];
+    changedFiles: string[];
+    inputTokens: number;
+    outputTokens: number;
+    wallClockStartedAt: string;
+    finishedAt: string;
+    failedReason?: string;
+}
 /** FINAL evidence type (I9 — not staged). source = file path / check name; quote = cited excerpt. */
 export interface AcceptanceEvidence {
     source: string;
@@ -38,14 +135,16 @@ export interface PhaseSpec {
         taskId: string;
         assignee: string;
         prompt: string;
+        workspaceMutation: "none" | "required";
         dependsOn?: string[];
         acceptanceCriteria?: string;
     }[];
     instances: {
         name: string;
-        role: string;
+        role: GoalExecutionRole;
         agentId: string;
     }[];
+    controlRoles?: GoalRoleProjection[];
     reasoning?: string;
     unreachable?: {
         criterionId: string;
@@ -69,38 +168,53 @@ export interface GoalQueuedMessage {
     id: string;
     ts: string;
     text: string;
+    kind: GoalInstructionKind;
 }
 /** Append-only event (events.jsonl). seq is monotonic from 1. */
 export interface GoalRunEvent {
     seq: number;
     ts: string;
-    type: "goal_started" | "checklist_initialized" | "phase_planned" | "phase_started" | "task_settled" | "phase_assessed" | "progress_compacted" | "goal_edited" | "message_queued" | "paused" | "resumed" | "stopped" | "phase_boundary" | "round_message" | "ended";
+    type: "goal_started" | "goal_spec_drafted" | "blocker_answered" | "checklist_initialized" | "phase_planned" | "phase_started" | "phase_assessed" | "progress_compacted" | "goal_edited" | "message_queued" | "blocked" | "paused" | "resumed" | "stopped" | "phase_boundary" | "round_message" | "budget_updated" | "stage_changed" | "recovery_failed" | "final_report" | "dismissed" | "recovered" | "ended";
     payload: Record<string, unknown>;
 }
-/** Derived Goal checkpoint stored by Gateway RunState, rebuildable by replaying events. */
+/** Goal checkpoint stored by Gateway RunState and advanced by replaying later Host events. */
 export interface PersistedGoalRunState {
     goalRunId: string;
     projectId: string;
     canonicalSessionId: string;
+    leaderAgentId: string;
     originalGoal: string;
     currentGoal: string;
+    goalSpecStatus: GoalSpecStatus;
+    goalSpec?: GoalSpec;
     goalUpdatedAt?: string;
     checklistVersion: number;
     /** False only between the durable start acknowledgement and the detached leader initialization. */
-    checklistInitialized?: boolean;
+    checklistInitialized: boolean;
     status: GoalRunStatus;
     pauseState: GoalPauseState;
     phaseIndex: number;
     noProgressCount: number;
-    noFlipStreak?: number;
-    unreachableStreak?: Record<string, number>;
+    noFlipStreak: number;
+    unreachableStreak: Record<string, number>;
     progressSummary: string;
+    currentStage?: GoalStage;
+    /** Timestamp of the latest durable Goal activity, used by every surface to judge freshness. */
+    lastActivityAt?: string;
     acceptanceChecklist: AcceptanceChecklist;
     queuedMessages: GoalQueuedMessage[];
+    /** Durable constraints are re-grounded into every later phase until explicitly removed. */
+    constraints: GoalQueuedMessage[];
     agentPool: string[];
+    milestones: GoalMilestone[];
+    budget: GoalBudget;
+    turnContext?: GoalTurnContext;
+    blocker?: GoalBlocker;
+    finalReport?: GoalFinalReport;
+    dismissedAt?: string;
     wallClockStartedAt: string;
     pausedAt?: string;
-    /** #4: how the run became paused (user_pause / drain_timeout) — cleared on resume. */
+    /** How the run became paused (user_pause / phase_timeout) — cleared on resume. */
     pauseReason?: GoalPauseReason;
     stopReason?: string;
     endReason?: GoalEndReason;

package/dist/types/orchestration/index.d.ts

@@ -1,6 +1,6 @@
 export { buildAssistantToolCallMessage, buildToolResultMessage, type FunctionToolDefinition, } from "./tool-loop/tool-schema.js";
 export { classifyError, isRetryableCategory, type ErrorCategory, } from "./error-handling/error-classification.js";
-export { composeStrategies, composeAsyncStrategies, SlidingWindowStrategy, SummarizeOldStrategy, ToolResultTrimStrategy, HeadTailProtectedStrategy, IncrementalCompactStrategy, CacheAwareCompressionStrategy, CompressionMetricsCollector, ContextEngineRegistry, MicroCompactStrategy, postCompactFileRecovery, type PostCompactRecoveryConfig, buildStructuredSummaryPrompt, computeAdaptiveBudget, isAsyncCompressionStrategy, selectCompressionTier, DEFAULT_ADAPTIVE_BUDGET_CONFIG, type AdaptiveBudgetConfig, type AsyncCompressionStrategy, type CacheAwareCompressionConfig, type CompressibleMessage, type CompressionEvent, type CompressionMetrics, type CompressionMetricsSnapshot, type CompressionResult, type CompressionStrategy, type CompressionTier, type ContextEngine, type HeadTailProtectionConfig, type IncrementalCompactConfig, type SummarizeFn, } from "../runtime/context/context-compression-strategies.js";
+export { composeStrategies, composeAsyncStrategies, SlidingWindowStrategy, SummarizeOldStrategy, ToolResultTrimStrategy, HeadTailProtectedStrategy, IncrementalCompactStrategy, CacheAwareCompressionStrategy, CompressionMetricsCollector, ContextEngineRegistry, MicroCompactStrategy, postCompactFileRecovery, type PostCompactRecoveryConfig, buildStructuredSummaryPrompt, CONTEXT_CAPSULE_MARKER, parseContextCapsule, redactCompressionSecrets, computeAdaptiveBudget, isAsyncCompressionStrategy, selectCompressionTier, DEFAULT_ADAPTIVE_BUDGET_CONFIG, type AdaptiveBudgetConfig, type AsyncCompressionStrategy, type CacheAwareCompressionConfig, type CompressibleMessage, type CompressionEvent, type ContextCapsule, type ContextCompactionReceipt, type CompressionMetrics, type CompressionMetricsSnapshot, type CompressionResult, type CompressionStrategy, type CompressionTier, type ContextEngine, type HeadTailProtectionConfig, type IncrementalCompactConfig, type SummarizeFn, } from "../runtime/context/context-compression-strategies.js";
 export { snipCompactIfNeeded, type SnipResult, } from "../runtime/context/context-compression-strategies.js";
 export { applyCollapsesIfNeeded as applyContextCollapsesIfNeeded, recoverFromOverflow as recoverContextCollapseFromOverflow, createCollapseStore, type CollapseStore, type CollapseStage, } from "./context/context-collapse.js";
 export { applyToolChoicePolicy, type ApplyToolChoicePolicyInput, type ApplyToolChoicePolicyResult, } from "./tool-loop/tool-choice-policy.js";

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

@@ -1,7 +1,7 @@
 /**
  * Product persistence facade over the Gateway-owned RunStateStore.
  */
-import type { ProductPhase, ProductInstanceDef } from "../protocol/wire/acp-agent-management.js";
+import type { ProductCreateParams, ProductPhase, ProductInstanceDef } from "../protocol/wire/acp-agent-management.js";
 import type { PersistedBudgetState } from "./product-budget.js";
 import type { SerializedNode } from "./dag-scheduler.js";
 import type { PlanningSession } from "./product-planner.js";
@@ -20,6 +20,15 @@ export interface PersistedProductState {
     lastCheckpointAt: string;
     /** Last durably announced attempt number for each stable task id. */
     taskAttempts?: Record<string, number>;
+    /** Host-owned abnormal-worker handoffs, retained across Gateway restarts for bounded retry/audit. */
+    taskHandoffs?: Record<string, Array<{
+        from: string;
+        to: string;
+        error: string;
+        at: string;
+    }>>;
+    /** Parent Goal turn policy, retained so recovered Product workers do not change execution policy. */
+    turnContext?: ProductCreateParams["turnContext"];
     /**
      * Snapshot of the leader's multi-turn planning dialogue, so the leader regains its planning
      * context after a resume. JSON-safe:

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

@@ -56,8 +56,8 @@ export interface PlanningSession {
      * User-supplied allow-list of agent ids the leader may assign tasks to (planning AND execution-phase
      * reassignment). Persisted AS-IS so the execution phase reuses the SAME constraint and a failure-driven
      * reassign cannot pull in a non-participating agent. PRESENCE-based (must survive uncollapsed end to
-     * end): undefined → all ready agents; `[]` → ONLY the leader 小智 (user deselected every worker);
-     * `[ids]` → those + leader. See buildAgentRoster for the always-include-leader rule.
+     * end): undefined → all ready agents; `[]` → ONLY the selected leader (user deselected every worker);
+     * `[ids]` → those + selected leader. See buildAgentRoster for the always-include-leader rule.
      */
     allowedAgents?: string[];
     createdAt: string;
@@ -111,7 +111,7 @@ export interface PlannerCallbacks {
 }
 /** Describes a DAG mutation performed by the leader. */
 export interface DagMutation {
-    type: "add_task" | "remove_task" | "retry_task" | "reassign_task" | "update_prompt";
+    type: "add_task" | "remove_task" | "retry_task" | "reassign_task" | "update_prompt" | "add_dependency" | "remove_dependency";
     taskId: string;
     details?: Record<string, unknown>;
 }

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

@@ -16,6 +16,7 @@ interface LegacyTurnFixture {
      * which is how every acceptance verdict reached the leader conversation unnoticed.
      */
     streamDeltas?(memberId: string, prompt: string): string[];
+    lifecycleEvents?(memberId: string, prompt: string): Array<Record<string, unknown>>;
 }
 /** Test-only adapter for migrating orchestration fixtures from the retired local spawn lane. */
 export declare function makeDelegateTestBridge(processManager: LegacyTurnFixture): DelegateBridge;

package/dist/types/orchestration/workflow/data-item.d.ts

@@ -1,5 +1,5 @@
 /**
- * Workflow data envelope (spec: workflow-dataflow-and-triggers-spec.md §A2).
+ * Workflow data envelope.
  *
  * Control/data separation: DagScheduler manages control (ready/skip/loop/ports) and
  * never touches these values. The runtime data-routing layer carries DataItem[] along

package/dist/types/orchestration/workflow/expression.d.ts

@@ -1,6 +1,5 @@
 /**
- * Restricted workflow expression evaluator (spec: workflow-dataflow-and-triggers-spec.md §A3–A4,
- * plan D6). Used to bind node params to upstream data.
+ * Restricted workflow expression evaluator used to bind node params to upstream data.
  *
  * HARD SECURITY LINE: NO arbitrary JS eval. This is a tiny recursive-descent interpreter over a
  * fixed grammar — property/index path access + a whitelist of pure functions only. Unattended

package/dist/types/orchestration/workflow/workflow-patch.d.ts

@@ -1,6 +1,5 @@
 /**
- * WorkflowPatch — the single mutation channel for workflow editing (plan D17/D19,
- * spec workflow-conversational-editing-spec.md §C).
+ * WorkflowPatch — the single mutation channel for workflow editing.
  *
  * One change protocol for BOTH agent edits and canvas hand-edits: every edit is a list of
  * `WorkflowPatch` ops applied transactionally to a workflow's graph. This module is the

package/dist/types/orchestration/workflow/workflow-render.d.ts

@@ -1,6 +1,5 @@
 /**
- * Compact workflow renderer — the "workflow-as-context" feeder (plan D17,
- * spec workflow-conversational-editing-spec.md §B).
+ * Compact workflow renderer — the "workflow-as-context" feeder.
  *
  * Every page-chat user turn injects the LATEST workflow as compact, deterministic text (NOT raw
  * JSON: cheaper tokens, never stale, stable node ids the agent references back in a WorkflowPatch).

package/dist/types/project-memory-host.d.ts

@@ -1,3 +1,4 @@
 /** Gateway-owned project-memory implementation. qlogicagent production code must consume the X7 proxy. */
 export { Memdir } from "./skills/memory/memdir.js";
 export type { MemdirFileInfo, MemdirResult } from "./skills/memory/memdir.js";
+export { isMemoryContentSafe } from "./skills/memory/memory-content-safety.js";

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

@@ -1,12 +1,12 @@
 import type { NotificationMethodMap } from "./wire/notification-payloads.js";
-export declare const AGENT_CONTRACT_VERSION: 9;
+export declare const AGENT_CONTRACT_VERSION: 10;
 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_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"];
+export declare const AGENT_WS_EVENT_NAMES: readonly ["turn.start", "turn.delta", "turn.end", "turn.error", "turn.recovery", "turn.text_rollback", "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.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", "thread.item", "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.taskHandoff", "product.budgetUpdate", "product.budgetWarning", "product.budgetExceeded", "product.checkpointed", "product.completed", "product.dagTopology", "plan.interrupted", "product.planReady", "product.planningDelta", "product.leaderMessage", "product.planFailed", "product.planningAsk", "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.text_rollback", "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.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", "thread.item", "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.taskHandoff", "product.budgetUpdate", "product.budgetWarning", "product.budgetExceeded", "product.checkpointed", "product.completed", "product.dagTopology", "plan.interrupted", "product.planReady", "product.planningDelta", "product.leaderMessage", "product.planFailed", "product.planningAsk", "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.text_rollback", "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.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", "thread.item", "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.taskHandoff", "product.budgetUpdate", "product.budgetWarning", "product.budgetExceeded", "product.checkpointed", "product.completed", "product.dagTopology", "plan.interrupted", "product.planReady", "product.planningDelta", "product.leaderMessage", "product.planFailed", "product.planningAsk", "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"];
@@ -16,6 +16,7 @@ export declare const AGENT_EVENT_REQUIRED_KEYS: {
     readonly "product.taskStarted": readonly ["productId", "taskId", "assignee", "attempt"];
     readonly "product.taskCompleted": readonly ["productId", "taskId", "result", "attempt"];
     readonly "product.taskFailed": readonly ["productId", "taskId", "error", "attempt", "terminalState"];
+    readonly "product.taskHandoff": readonly ["productId", "taskId", "from", "to", "reason", "attempt", "timestamp"];
     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"];
@@ -65,9 +66,9 @@ export interface ProductPlanIssueOptions {
 }
 export declare function collectProductPlanIssues(instances: readonly ProductPlanInstanceShape[], tasks: readonly ProductPlanTaskShape[], options?: ProductPlanIssueOptions): ProductPlanIssue[];
 export declare const AGENT_CONTRACT_DESCRIPTOR: {
-    readonly version: 9;
+    readonly version: 10;
     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_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 eventNames: readonly ["turn.start", "turn.delta", "turn.end", "turn.error", "turn.recovery", "turn.text_rollback", "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.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", "thread.item", "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.taskHandoff", "product.budgetUpdate", "product.budgetWarning", "product.budgetExceeded", "product.checkpointed", "product.completed", "product.dagTopology", "plan.interrupted", "product.planReady", "product.planningDelta", "product.leaderMessage", "product.planFailed", "product.planningAsk", "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"];
@@ -76,6 +77,7 @@ export declare const AGENT_CONTRACT_DESCRIPTOR: {
         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.taskHandoff": readonly ["productId", "taskId", "from", "to", "reason", "attempt", "timestamp"];
         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"];
@@ -83,7 +85,7 @@ export declare const AGENT_CONTRACT_DESCRIPTOR: {
     };
     readonly terminalStates: readonly ["completed", "failed", "cancelled"];
 };
-export declare const AGENT_CONTRACT_HASH: "1a1a3a59c6601cab382ac31e58198f8f61b182ed452061cd50f68faddeebc5cc";
+export declare const AGENT_CONTRACT_HASH: "5fcb0701c3e9acaff61e5039729e6eb5f41352581ce52079edfa434913ef234c";
 export interface AgentContractIdentity {
     version: typeof AGENT_CONTRACT_VERSION;
     hash: typeof AGENT_CONTRACT_HASH;

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

@@ -188,21 +188,6 @@ export interface ToolsListResult {
     }>;
     total: number;
 }
-export interface MediaListModelsParams {
-    /** Filter by media type (image/video/music/tts/3d/stt/embedding). Omit to list all. */
-    mediaType?: string;
-}
-export interface MediaListModelsResult {
-    models: Array<{
-        providerId: string;
-        providerName: string;
-        modelId: string;
-        modelName: string;
-        mediaType: string;
-        /** Fine-grained capability metadata (operations, formats, limits) */
-        capabilities?: Record<string, unknown>;
-    }>;
-}
 export type CommunityInstallRiskTier = "R0" | "R1" | "R2" | "R3";
 export type CommunityInstallSourceTier = "official" | "community";
 export type CommunityInstallTrustStage = "quarantine" | "trial" | "trusted";
@@ -238,6 +223,8 @@ export interface CommunityInstallResourceParams {
     resourceId: string;
     version?: string;
     explicitInstallConsent: true;
+    allowReplace?: boolean;
+    replacementPolicy?: "managed-unmodified" | "user-confirmed";
 }
 export interface CommunityInstalledResource {
     resourceId: string;
@@ -493,10 +480,6 @@ export interface RpcMethodMap {
         params: ToolsListParams;
         result: ToolsListResult;
     };
-    "media.listModels": {
-        params: MediaListModelsParams;
-        result: MediaListModelsResult;
-    };
     "community.resolveInstall": {
         params: CommunityResolveInstallParams;
         result: CommunityResolveInstallResult;

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, 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";
+export type { AgentSource, ArtifactType, MediaResultType, MemoryDecayCompletedNotification, MemoryUpdatedNotification, NotificationMethod, NotificationMethodMap, NotificationThreadItem, ThreadItemNotification, 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, 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, MentionDelegateStartedNotification, MentionDelegateActivityNotification, MentionDelegateSettledNotification, } from "./wire/index.js";

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

@@ -313,6 +313,19 @@ export interface ProductCreateParams {
         maxTotalTokens?: number;
         maxDuration?: number;
     };
+    /**
+     * Durable per-turn policy inherited from a parent Goal. Product keeps member-specific model
+     * selection: modelId/reasoningEffort apply only to the native qlogicagent member, while Host
+     * permissions and active skills remain available to every supervised member.
+     */
+    turnContext?: {
+        modelId?: string;
+        reasoningEffort?: string;
+        permissions?: unknown;
+        activeSkills?: string[];
+        /** Native qlogicagent-only projection of the parent Goal for Agent-local compaction. */
+        goalContextEnvelope?: import("./chat-types.js").ContextEnvelope;
+    };
 }
 /**
  * product.plan RPC params — starts an interactive planning session.
@@ -337,16 +350,16 @@ export interface ProductPlanParams {
         maxDuration?: number;
     };
     /**
-     * Optional user-supplied allow-list of agent ids the leader 小智 (qlogicagent) may assign tasks to —
+     * Optional user-supplied allow-list of agent ids the selected leader may assign tasks to —
      * during planning AND during execution-phase reassignment. The user picks WHICH agents participate;
      * the leader still auto-plans + assigns, but only within this set.
      *
      * Semantics are PRESENCE-based (see buildAgentRoster) — an explicit `[]` differs from omitted:
      *  - omitted / undefined → ALL ready agents.
-     *  - `[]` (explicit empty array) → ONLY the leader `qlogicagent` (小智): the user deselected every worker.
+     *  - `[]` (explicit empty array) → ONLY `leaderAgentId`: the user deselected every worker.
      *  - non-empty → the assignable roster = ready catalog entries whose id ∈ allowedAgents, PLUS the
-     *    leader `qlogicagent` (小智) ALWAYS included (universal coordinator / fallback executor, so there
-     *    is always ≥1 valid assignee even if the user's picks turn out unready).
+     *    selected leader. Product may use that leader as a single-agent executor; Goal keeps the selected
+     *    leader control-only whenever another ready worker exists.
      */
     allowedAgents?: string[];
 }
@@ -400,6 +413,21 @@ export interface ProductMessageParams {
     /** User's message content. */
     content: string;
 }
+/** Exact user-authored edit to a running Product DAG. One RPC carries one atomic mutation. */
+export interface ProductDagMutationParams {
+    productId: string;
+    projectId: string;
+    canonicalSessionId: string;
+    cwd: string;
+    mutation: {
+        type: "add_dependency" | "remove_dependency";
+        taskId: string;
+        details: {
+            from: string;
+            to: string;
+        };
+    };
+}
 /** Product lifecycle RPC params. Status projection is Host-native and not an agent method. */
 export interface ProductIdParams {
     productId: string;
@@ -425,18 +453,31 @@ export interface GoalStartParams {
     canonicalSessionId: string;
     cwd: string;
     agentPool: string[];
-    leaderAgentId?: string;
+    leaderAgentId: string;
+    budget?: {
+        maxTotalTokens?: number;
+        maxDurationMs?: number;
+    };
+    modelId?: string;
+    reasoningEffort?: string;
+    permissionPolicy?: unknown;
+    activeSkills?: string[];
 }
-/** x/goal.pause / x/goal.stop RPC params. */
+/** x/goal.pause / x/goal.stop RPC params. Gateway derives the leader from the immutable session owner. */
 export interface GoalIdParams {
     goalRunId: string;
     projectId: string;
     canonicalSessionId: string;
     cwd: string;
+    leaderAgentId: string;
 }
 /** x/goal.resume RPC params — optionally update the goal on resume. */
 export interface GoalResumeParams extends GoalIdParams {
     newGoal?: string;
+    additionalBudget?: {
+        maxTotalTokens?: number;
+        maxDurationMs?: number;
+    };
 }
 /** x/goal.updateGoal RPC params. */
 export interface GoalUpdateGoalParams extends GoalIdParams {
@@ -445,6 +486,7 @@ export interface GoalUpdateGoalParams extends GoalIdParams {
 /** x/goal.message RPC params — queue a steering message for the next phase boundary. */
 export interface GoalMessageParams extends GoalIdParams {
     text: string;
+    kind?: "instruction_once" | "constraint_add" | "constraint_remove" | "answer_to_blocker" | "priority_change";
 }
 /** Runtime instance state. */
 export interface ProductInstanceStatus {