qlogicagent 2.15.10 → 2.16.2

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

@@ -44,6 +44,8 @@ export interface AcpBackendConfig {
     install?: AgentInstallSpec;
     /** Short UI note (e.g. "需 GitHub 账号", "非 ACP,自定义适配器驱动"). */
     note?: string;
+    /** Coarse soft capability hint for the leader's planning roster (NOT a capability contract). */
+    strengths?: string;
 }
 /** Official install commands for the one-click installer (no self-hosted CDN — runs upstream). */
 export interface AgentInstallSpec {
@@ -312,6 +314,8 @@ export interface ProductBudget {
     maxTotalTokens?: number;
     maxDuration?: number;
     usedTokens: number;
+    inputTokens?: number;
+    outputTokens?: number;
     elapsed: number;
 }
 /** product.create RPC params. */
@@ -347,6 +351,19 @@ export interface ProductPlanParams {
         maxTotalTokens?: number;
         maxDuration?: number;
     };
+    /**
+     * Optional user-supplied allow-list of agent ids the leader 小智 (qlogicagent) 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 (backward compatible — WS probes, other callers, old sessions).
+     *  - `[]` (explicit empty array) → ONLY the leader `qlogicagent` (小智): 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).
+     */
+    allowedAgents?: string[];
 }
 /** The structured plan produced by the leader agent. */
 export interface ProductPlan {
@@ -396,6 +413,14 @@ export interface ProductMessageParams {
 export interface ProductIdParams {
     productId: string;
 }
+/**
+ * product.replay RPC params — re-run from an arbitrary completed/failed task forward.
+ * Resets the task + its descendants to pending and reuses upstream (ancestor) outputs as context.
+ */
+export interface ProductReplayParams {
+    productId: string;
+    taskId: string;
+}
 /** Runtime instance state. */
 export interface ProductInstanceStatus {
     instanceId: string;
@@ -417,6 +442,11 @@ export interface ProductTaskState {
     error?: string;
     startedAt?: string;
     completedAt?: string;
+    /** Per-task token usage, surfaced for cost attribution in the task detail view. */
+    inputTokens?: number;
+    outputTokens?: number;
+    /** Relative paths of files the task produced. */
+    changedFiles?: string[];
 }
 /** agents.getGateway response. */
 export interface AgentsGetGatewayResult {
@@ -474,3 +504,11 @@ export interface ProductDeleteParams {
     productId: string;
 }
 export type { AgentSource } from "./notification-payloads.js";
+/** One row of the team roster shown to the leader during planning (soft capability hints only). */
+export interface AgentRosterEntry {
+    id: string;
+    name: string;
+    model?: string;
+    strengths: string;
+    isLeader: boolean;
+}

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

@@ -31,6 +31,7 @@ export declare const ACP_EXTENDED_METHODS: {
     readonly PRODUCT_PAUSE: "x/product.pause";
     readonly PRODUCT_CANCEL: "x/product.cancel";
     readonly PRODUCT_ROLLBACK: "x/product.rollback";
+    readonly PRODUCT_REPLAY: "x/product.replay";
     readonly PRODUCT_STATUS: "x/product.status";
     readonly SOLO_SUBSCRIBE: "x/solo.subscribe";
     readonly SOLO_MESSAGE: "x/solo.message";

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

@@ -13,17 +13,17 @@
  * Turn-lifecycle events relayed to the Control UI WebSocket.
  * These are the "chat session" events that every UI client needs.
  */
-export declare const AGENT_WS_EVENT_NAMES: readonly ["turn.start", "turn.delta", "turn.end", "turn.error", "turn.recovery", "turn.tool_call", "turn.tool_result", "turn.tool_blocked", "turn.reasoning_delta", "turn.approval_request", "turn.skill_instruction", "turn.ask_user", "turn.media_result", "turn.media_progress", "turn.media_usage", "turn.media_capability_check", "turn.plan_update", "turn.suggestions", "turn.sidechain_started", "turn.subagent_started", "turn.subagent_delta", "turn.subagent_ended", "turn.sidechain_completed", "turn.task_updated", "turn.todos_updated", "turn.exec_progress", "turn.tool_use_summary", "turn.lifecycle", "turn.document_maintenance", "turn.artifact_contract", "turn.usage_update", "team.member.notification", "session.info", "memory.updated", "skills.updated", "pet.soul_ready", "pet.reaction", "pet.growth", "pet.state", "pet.confirm", "pet.asset.updated", "system.activity", "workflow.created", "workflow.updated", "workflow.deleted", "workflow.runStarted", "workflow.runCompleted", "workflow.runFailed", "workflow.nodeStatus", "workflow.triggerDropped", "workflow.alert", "workflow.approvalRequested"];
+export declare const AGENT_WS_EVENT_NAMES: readonly ["turn.start", "turn.delta", "turn.end", "turn.error", "turn.recovery", "turn.tool_call", "turn.tool_result", "turn.tool_blocked", "turn.reasoning_delta", "turn.approval_request", "turn.skill_instruction", "turn.ask_user", "turn.media_result", "turn.media_progress", "turn.media_usage", "turn.media_capability_check", "turn.plan_update", "turn.suggestions", "turn.sidechain_started", "turn.subagent_started", "turn.subagent_delta", "turn.subagent_ended", "turn.sidechain_completed", "turn.task_updated", "turn.todos_updated", "turn.exec_progress", "turn.tool_use_summary", "turn.tool_selection_policy", "turn.lifecycle", "turn.document_maintenance", "turn.artifact_contract", "turn.usage_update", "team.member.notification", "session.info", "memory.updated", "skills.updated", "pet.soul_ready", "pet.reaction", "pet.growth", "pet.state", "pet.confirm", "pet.asset.updated", "system.activity", "workflow.created", "workflow.updated", "workflow.deleted", "workflow.runStarted", "workflow.runCompleted", "workflow.runFailed", "workflow.nodeStatus", "workflow.triggerDropped", "workflow.alert", "workflow.approvalRequested"];
 /**
  * Agent Team events (Solo Mode, Product Mode, Plan lifecycle).
  * Relayed to the UI's team/orchestration panel.
  */
-export declare const AGENT_TEAM_WS_EVENT_NAMES: readonly ["solo.progress", "solo.agentDelta", "solo.agentActivity", "solo.agentUsage", "solo.evaluation", "product.taskStarted", "product.taskOutput", "product.taskCompleted", "product.taskFailed", "product.budgetUpdate", "product.budgetWarning", "product.checkpointed", "product.completed", "product.dagTopology", "plan.interrupted"];
+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"];
 /**
  * All agent notifications that Gateway should relay to WS clients.
  * Union of session events + team events.
  */
-export declare const ALL_AGENT_WS_EVENT_NAMES: readonly ["turn.start", "turn.delta", "turn.end", "turn.error", "turn.recovery", "turn.tool_call", "turn.tool_result", "turn.tool_blocked", "turn.reasoning_delta", "turn.approval_request", "turn.skill_instruction", "turn.ask_user", "turn.media_result", "turn.media_progress", "turn.media_usage", "turn.media_capability_check", "turn.plan_update", "turn.suggestions", "turn.sidechain_started", "turn.subagent_started", "turn.subagent_delta", "turn.subagent_ended", "turn.sidechain_completed", "turn.task_updated", "turn.todos_updated", "turn.exec_progress", "turn.tool_use_summary", "turn.lifecycle", "turn.document_maintenance", "turn.artifact_contract", "turn.usage_update", "team.member.notification", "session.info", "memory.updated", "skills.updated", "pet.soul_ready", "pet.reaction", "pet.growth", "pet.state", "pet.confirm", "pet.asset.updated", "system.activity", "workflow.created", "workflow.updated", "workflow.deleted", "workflow.runStarted", "workflow.runCompleted", "workflow.runFailed", "workflow.nodeStatus", "workflow.triggerDropped", "workflow.alert", "workflow.approvalRequested", "solo.progress", "solo.agentDelta", "solo.agentActivity", "solo.agentUsage", "solo.evaluation", "product.taskStarted", "product.taskOutput", "product.taskCompleted", "product.taskFailed", "product.budgetUpdate", "product.budgetWarning", "product.checkpointed", "product.completed", "product.dagTopology", "plan.interrupted"];
+export declare const ALL_AGENT_WS_EVENT_NAMES: readonly ["turn.start", "turn.delta", "turn.end", "turn.error", "turn.recovery", "turn.tool_call", "turn.tool_result", "turn.tool_blocked", "turn.reasoning_delta", "turn.approval_request", "turn.skill_instruction", "turn.ask_user", "turn.media_result", "turn.media_progress", "turn.media_usage", "turn.media_capability_check", "turn.plan_update", "turn.suggestions", "turn.sidechain_started", "turn.subagent_started", "turn.subagent_delta", "turn.subagent_ended", "turn.sidechain_completed", "turn.task_updated", "turn.todos_updated", "turn.exec_progress", "turn.tool_use_summary", "turn.tool_selection_policy", "turn.lifecycle", "turn.document_maintenance", "turn.artifact_contract", "turn.usage_update", "team.member.notification", "session.info", "memory.updated", "skills.updated", "pet.soul_ready", "pet.reaction", "pet.growth", "pet.state", "pet.confirm", "pet.asset.updated", "system.activity", "workflow.created", "workflow.updated", "workflow.deleted", "workflow.runStarted", "workflow.runCompleted", "workflow.runFailed", "workflow.nodeStatus", "workflow.triggerDropped", "workflow.alert", "workflow.approvalRequested", "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"];
 /** Type-level event name for session events. */
 export type AgentWsEventName = (typeof AGENT_WS_EVENT_NAMES)[number];
 /** Type-level event name for team events. */

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

@@ -11,7 +11,7 @@
 import type { ChatMessage, LocalizedToolText, ToolCapabilityCategory } from "./chat-types.js";
 import type { GatewayRpcMethodMap } from "./gateway-rpc.js";
 import type { WireTokenUsage } from "./notification-payloads.js";
-import type { SoloEvaluation, SoloMessageParams, SoloEvaluateParams, SoloDeleteParams, ProductPlan, ProductPlanParams, ProductConfirmParams, ProductMessageParams, ProductIdParams, ProductDeleteParams, AgentsGetGatewayResult, AgentsListConfiguredItem, AgentsProcessInfo, AgentsKillParams, AgentsGetLogParams, AgentsGetLogResult, AgentsTestConnectionParams, AgentsTestConnectionResult } from "./acp-agent-management.js";
+import type { SoloEvaluation, SoloMessageParams, SoloEvaluateParams, SoloDeleteParams, ProductPlan, ProductPlanParams, ProductConfirmParams, ProductMessageParams, ProductIdParams, ProductDeleteParams, ProductReplayParams, AgentsGetGatewayResult, AgentsListConfiguredItem, AgentsProcessInfo, AgentsKillParams, AgentsGetLogParams, AgentsGetLogResult, AgentsTestConnectionParams, AgentsTestConnectionResult } from "./acp-agent-management.js";
 export type AgentCategory = "sub-agent" | "teammate";
 export type AgentProtocol = "internal" | "acp";
 export type AgentStatus = "available" | "unavailable" | "handshake_failed" | "not_installed";
@@ -103,6 +103,9 @@ export interface ProductTaskDef {
     assignee: string;
     prompt: string;
     dependsOn?: string[];
+    /** Leader-authored "done" criteria: files to produce / how to self-check / terminal PASS.
+     *  Appended to the task prompt so the evidence gate (assertProductTaskCompletionEvidence) sees it. */
+    acceptanceCriteria?: string;
 }
 export interface ProductStatus {
     productId: string;
@@ -1263,6 +1266,13 @@ export interface AgentRpcMethodMap extends GatewayRpcMethodMap {
             ok: true;
         };
     };
+    "product.replay": {
+        params: ProductReplayParams;
+        result: {
+            productId: string;
+            ok: true;
+        };
+    };
     "workflow.create": {
         params: Record<string, unknown>;
         result: Record<string, unknown>;

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

@@ -6,7 +6,7 @@ export { type ChatMessage, type ChatMessageRole, type LocalizedToolText, type Th
 export { type AgentCapabilities, type AgentCategory, type AgentConfig, type AgentDescriptor, type AgentProtocol, type AgentRpcMethodMap, type AgentStatus, type CustomAgentDef, type ProductInstanceDef, type ProductPhase, type ProductStatus, type ProductSummary, type ProductTaskDef, type ProductTaskStatus, type SoloAgentResult, type SoloAgentState, type SoloState, type SoloStatus, } from "./agent-methods.js";
 export type * from "./acp-agent-management.js";
 export { AGENT_TEAM_WS_EVENT_NAMES, AGENT_WS_EVENT_NAMES, ALL_AGENT_WS_EVENT_NAMES, type AgentTeamWsEventName, type AgentWsEventName, type AllAgentWsEventName, } from "./agent-events.js";
-export { type AgentSource, type AgentsErrorNotification, type AgentsStatusNotification, type ArtifactType, type MediaResultType, type MemoryDecayCompletedNotification, type MemoryUpdatedNotification, type NotificationMethod, type NotificationMethodMap, type NotificationThreadItem, type PermissionRuleUpdatedNotification, type PlanInterruptedNotification, type PongNotification, type ProductBudgetUpdateNotification, type ProductBudgetWarningNotification, type ProductCheckpointedNotification, type ProductCompletedNotification, type ProductDagTopologyNotification, type ProductTaskCompletedNotification, type ProductTaskFailedNotification, type ProductTaskOutputDeltaNotification, type ProductTaskStartedNotification, type ProjectArchivedNotification, type ProjectCreatedNotification, type ProjectDeletedNotification, type ProjectRenamedNotification, type ProjectSwitchedNotification, type ProjectUnarchivedNotification, type SessionInfoNotification, 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 TurnReasoningDeltaNotification, type TurnRecoveryNotification, type TurnSidechainCompletedNotification, type TurnSidechainStartedNotification, type TurnSkillAcquisitionNeededNotification, type TurnSkillInstructionNotification, type TurnStartNotification, type TurnSubagentDeltaNotification, type TurnSubagentEndedNotification, type TurnSubagentStartedNotification, type TurnSuggestionsNotification, type TurnTaskUpdatedNotification, type TurnTodosUpdatedNotification, type TurnToolBlockedNotification, type TurnToolCallNotification, type TurnToolResultNotification, type TurnToolUseSummaryNotification, type TurnUsageUpdateNotification, type WireTokenUsage, type ProductPlanReadyNotification, type ProductPlanFailedNotification, type ProductPlanningDeltaNotification, type PetSoulReadyNotification, type PetReactionNotification, type PetGrowthNotification, type PetStateNotification, type PetConfirmNotification, type WorkflowDeletedNotification, type WorkflowRecordNotification, type WorkflowRunCompletedNotification, type WorkflowRunFailedNotification, type WorkflowRunStartedNotification, } from "./notification-payloads.js";
+export { type AgentSource, type AgentsErrorNotification, type AgentsStatusNotification, type ArtifactType, type MediaResultType, type MemoryDecayCompletedNotification, type MemoryUpdatedNotification, type NotificationMethod, type NotificationMethodMap, type NotificationThreadItem, type PermissionRuleUpdatedNotification, type PlanInterruptedNotification, type PongNotification, type ProductBudgetUpdateNotification, type ProductBudgetWarningNotification, type ProductCheckpointedNotification, type ProductCompletedNotification, type ProductDagTopologyNotification, type ProductTaskCompletedNotification, type ProductTaskFailedNotification, type ProductTaskOutputDeltaNotification, type ProductMembersNotification, type ProductAgentActivityNotification, type ProductTaskStartedNotification, type ProjectArchivedNotification, type ProjectCreatedNotification, type ProjectDeletedNotification, type ProjectRenamedNotification, type ProjectSwitchedNotification, type ProjectUnarchivedNotification, type SessionInfoNotification, type 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 TurnReasoningDeltaNotification, type TurnRecoveryNotification, type TurnSidechainCompletedNotification, type TurnSidechainStartedNotification, type TurnSkillAcquisitionNeededNotification, type TurnSkillInstructionNotification, type TurnStartNotification, type TurnSubagentDeltaNotification, type TurnSubagentEndedNotification, type TurnSubagentStartedNotification, type TurnSuggestionsNotification, type TurnTaskUpdatedNotification, type TurnTodosUpdatedNotification, type TurnToolBlockedNotification, type TurnToolCallNotification, type TurnToolResultNotification, type TurnToolUseSummaryNotification, type TurnUsageUpdateNotification, type WireTokenUsage, type ProductPlanReadyNotification, type ProductPlanFailedNotification, type ProductPlanningDeltaNotification, type PetSoulReadyNotification, type PetReactionNotification, type PetGrowthNotification, type PetStateNotification, type PetConfirmNotification, type WorkflowDeletedNotification, type WorkflowRecordNotification, type WorkflowRunCompletedNotification, type WorkflowRunFailedNotification, type WorkflowRunStartedNotification, } from "./notification-payloads.js";
 export { ACP_EXTENDED_METHODS, ACP_EXTENDED_SESSION_UPDATE_TYPES, ACP_METHODS, ACP_PROTOCOL_VERSION, ACP_SESSION_UPDATE_TYPES, isAcpJsonRpcNotification, isAcpJsonRpcRequest, isAcpJsonRpcResponse, isExtendedSessionUpdateType, isStandardSessionUpdateType, parseAcpMessage, type AcpAgentCapabilities, type AcpAgentMessageChunkPayload, type AcpAgentThoughtChunkPayload, type AcpConfigOptionDescriptor, type AcpConfigOptionUpdatePayload, type AcpContentBlock, type AcpEndTurnPayload, type AcpExtendedMethod, type AcpExtendedSessionUpdateType, type AcpFsReadTextFileParams, type AcpFsReadTextFileResult, type AcpFsWriteTextFileParams, type AcpFsWriteTextFileResult, type AcpHostCapabilities, type AcpInitializeParams, type AcpInitializeResult, type AcpJsonRpcError, type AcpJsonRpcMessage, type AcpJsonRpcNotification, type AcpJsonRpcRequest, type AcpJsonRpcResponse, type AcpMode, type AcpPermissionOption, type AcpPermissionRequestParams, type AcpPermissionRequestResult, type AcpPlanPayload, type AcpSessionCancelParams, type AcpSessionCloseParams, type AcpSessionMeta, type AcpSessionLoadParams, type AcpSessionModeState, type AcpSessionNewParams, type AcpSessionNewResult, type AcpSessionPromptParams, type AcpSessionPromptResult, type AcpSessionSetConfigParams, type AcpSessionUpdateNotification, type AcpSessionUpdateType, type AcpStandardMethod, type AcpStandardSessionUpdateType, type AcpStopReason, type AcpToolCallPayload, type AcpToolCallUpdatePayload, type AcpUsage, type AcpUsageUpdatePayload, type AcpXSessionInfoPayload, type AcpXSkillInstructionPayload, } from "./acp-protocol.js";
 export { type ApprovalRequiredToolContract, type ModelSelectionReason, type PendingPromptContract, type RuntimeCapabilitySummaryContract, type RuntimeSessionContract, type SessionIdentityContract, } from "./session.js";
 export { type GatewayChannelExecutionEgressContract, type GatewayChannelExecutionEgressKind, type GatewayChannelExecutionIngressBindingContract, type GatewayChannelExecutionIngressSource, } from "./channel-ingress.js";

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

@@ -266,6 +266,7 @@ export interface TurnHeartbeatNotification {
 /** Structured telemetry for a tool use batch. */
 export interface TurnToolUseSummaryNotification {
     turnId: string;
+    telemetrySource?: "agent" | "agent-synthetic";
     availableToolNames: string[];
     enabledToolNames: string[];
     toolCallNames: string[];
@@ -274,6 +275,18 @@ export interface TurnToolUseSummaryNotification {
         reason: string;
     }>;
 }
+/** Structured telemetry for why the enabled tool surface changed within a turn. */
+export interface TurnToolSelectionPolicyNotification {
+    turnId: string;
+    policyId: string;
+    intent: "benchmark_state_maintenance" | "fresh_evidence" | "verification" | "final_answer" | "deferred_tool_discovery" | "tool_recovery" | "lifecycle_reconciliation";
+    reason: string;
+    availableToolNames: string[];
+    enabledToolNamesBefore: string[];
+    enabledToolNamesAfter: string[];
+    suppressedToolNames: string[];
+    nextAction: string;
+}
 /** Queryable long-horizon turn lifecycle telemetry. */
 export interface TurnLifecycleNotification {
     turnId: string;
@@ -302,6 +315,8 @@ export interface MaintainedDocumentIndex {
     contentHash: string;
     summary: string;
     lastReviewedTurn: number;
+    fileSizeBytes: number;
+    recordCount: number;
 }
 export interface DecisionStateRecord {
     id: string;
@@ -610,6 +625,11 @@ export interface ProductTaskCompletedNotification {
     productId: string;
     taskId: string;
     result: string;
+    /** Per-task token usage harvested from the agent's usage tracker. */
+    inputTokens?: number;
+    outputTokens?: number;
+    /** Relative paths of files the task produced (before its worktree was torn down). */
+    changedFiles?: string[];
 }
 /** Product task failed. */
 export interface ProductTaskFailedNotification {
@@ -661,6 +681,22 @@ export interface ProductTaskOutputDeltaNotification {
     taskId: string;
     text: string;
 }
+/** Live team roster, emitted once at run start (and on resume) so the 团队成员 panel populates live. */
+export interface ProductMembersNotification {
+    productId: string;
+    members: {
+        agentId: string;
+        role: string;
+        name: string;
+    }[];
+}
+/** Per-task tool-call heartbeat (parity with Solo's solo.agentActivity) — keeps a silent-tool worker's
+ *  detail pane from looking frozen by surfacing the tool it is currently using. */
+export interface ProductAgentActivityNotification {
+    productId: string;
+    taskId: string;
+    toolName: string;
+}
 /** Leader agent produced a structured plan — client should present to user. */
 export interface ProductPlanReadyNotification {
     productId: string;
@@ -922,6 +958,7 @@ export interface NotificationMethodMap {
     "turn.exec_progress": TurnExecProgressNotification;
     "turn.heartbeat": TurnHeartbeatNotification;
     "turn.tool_use_summary": TurnToolUseSummaryNotification;
+    "turn.tool_selection_policy": TurnToolSelectionPolicyNotification;
     "turn.lifecycle": TurnLifecycleNotification;
     "turn.document_maintenance": TurnDocumentMaintenanceNotification;
     "turn.artifact": TurnArtifactNotification;
@@ -960,6 +997,8 @@ export interface NotificationMethodMap {
     "product.dagTopology": ProductDagTopologyNotification;
     "product.budgetUpdate": ProductBudgetUpdateNotification;
     "product.taskOutput": ProductTaskOutputDeltaNotification;
+    "product.members": ProductMembersNotification;
+    "product.agentActivity": ProductAgentActivityNotification;
     "product.planReady": ProductPlanReadyNotification;
     "product.planFailed": ProductPlanFailedNotification;
     "product.planningDelta": ProductPlanningDeltaNotification;

package/dist/types/runtime/infra/acp-detector.d.ts

@@ -201,3 +201,6 @@ export declare class AcpDetector {
      */
     resolveCredentialError(agentId: string): string | null;
 }
+/** Best-effort resolve the backing model id for an agent (for the planning roster).
+ *  Returns the configured/auto model or undefined. No spawn — reads config + auto env only. */
+export declare function resolveAgentModel(detector: AcpDetector, id: string): string | undefined;

package/dist/types/runtime/infra/acp-protocol-adapter.d.ts

@@ -118,6 +118,15 @@ export declare class AcpProtocolAdapter {
      * @param hostHandler Optional handler for agent→host requests (fs, terminal, permission)
      */
     attach(child: ChildProcess, onNotification?: (method: string, params: unknown) => void, hostHandler?: AcpHostRequestHandler): void;
+    /**
+     * qlogicagent extends ACP `session/update` with an `x_*` variant namespace (x_relay, x_session_info,
+     * x_skill_instruction, …) that the standard SDK schema does not model and therefore rejects. Detect
+     * those notifications on the read side and dispatch them to onNotification directly — bypassing the
+     * SDK's strict validation — so the host's usage/progress accumulation runs exactly as it does for the
+     * internal-agent path. Returns true when the message was consumed here (and must be hidden from the
+     * SDK); false for everything else (standard updates, requests, responses) which the SDK handles.
+     */
+    private consumeExtensionNotification;
     /**
      * Build the SDK Client implementation (agent→host reverse-RPC) from our loose host handler.
      * Re-reads this.hostHandler / this.onNotification on each call so detach() takes effect.

package/dist/types/runtime/ports/agent-execution-contracts.d.ts

@@ -1,209 +1,12 @@
 import type { HookRegistry } from "../../contracts/hooks.js";
 import type { ChatMessage as WireChatMessage, ToolDefinition as WireToolDefinition, WireTokenUsage } from "../../protocol/wire/index.js";
+import type { TurnEvent } from "../../contracts/turn-event.js";
+export type { TurnEvent } from "../../contracts/turn-event.js";
 export type ChatMessage = WireChatMessage;
 export type TokenUsage = WireTokenUsage;
 export interface ToolDefinition extends WireToolDefinition {
     backfillObservableInput?: (input: Record<string, unknown>) => void;
 }
-export type TurnEvent = {
-    type: "start";
-    turnId: string;
-} | {
-    type: "delta";
-    turnId: string;
-    text: string;
-} | {
-    type: "tool_call";
-    turnId: string;
-    callId: string;
-    name: string;
-    arguments: string;
-    inputSummary?: string;
-} | {
-    type: "end";
-    turnId: string;
-    content: string;
-    usage?: TokenUsage;
-    model?: string;
-    provider?: string;
-} | {
-    type: "error";
-    turnId: string;
-    error: string;
-    code?: string;
-    usage?: TokenUsage;
-} | {
-    type: "skill_instruction";
-    turnId: string;
-    instruction: unknown;
-} | {
-    type: "tool_result";
-    turnId: string;
-    callId: string;
-    name: string;
-    ok: boolean;
-    error?: string;
-    outputPreview?: string;
-    durationMs?: number;
-    exitCode?: number;
-    stdout?: string;
-    stderr?: string;
-    details?: Record<string, unknown>;
-} | {
-    type: "tool_blocked";
-    turnId: string;
-    callId: string;
-    name: string;
-    reason: string;
-} | {
-    type: "recovery";
-    turnId: string;
-    action: string;
-    detail?: string;
-} | {
-    type: "plan_update";
-    turnId: string;
-    slug: string;
-    content: string;
-} | {
-    type: "heartbeat";
-    turnId: string;
-    message: string;
-} | {
-    type: "tool_use_summary";
-    turnId: string;
-    availableToolNames: string[];
-    enabledToolNames: string[];
-    toolCallNames: string[];
-    blockedToolCalls: Array<{
-        name: string;
-        reason: string;
-    }>;
-} | {
-    type: "lifecycle";
-    turnId: string;
-    kind: "stage" | "reopen" | "resume" | "context_compression" | "goal_reconstruction" | "memory_drift" | "artifact_path_drift";
-    stage?: string;
-    status?: string;
-    detail?: string;
-    reconstruction?: GoalReconstructionState;
-    observedAt?: string;
-} | {
-    type: "document_maintenance";
-    turnId: string;
-    checkpointId: string;
-    documents: MaintainedDocumentIndex[];
-    decisionStateTable: DecisionStateRecord[];
-    readCycleFindings: Array<Record<string, unknown>>;
-    readCycleGuard: ReadCycleGuard;
-    observedAt?: string;
-} | {
-    type: "reasoning_delta";
-    turnId: string;
-    text: string;
-} | {
-    type: "suggestions";
-    turnId: string;
-    items: Array<{
-        text: string;
-        icon?: string;
-        action?: string;
-    }>;
-} | {
-    type: "media_result";
-    turnId: string;
-    mediaType: "image" | "tts" | "video" | "music" | "3d";
-    url: string;
-    model?: string;
-    provider?: string;
-    durationSeconds?: number;
-    width?: number;
-    height?: number;
-    mimeType?: string;
-    billingUnit?: string;
-    billingQuantity?: number;
-    taskId?: string;
-} | {
-    type: "artifact";
-    turnId: string;
-    artifactId: string;
-    artifactType: "code" | "file" | "image" | "document" | "diagram" | "table";
-    title: string;
-    filePath?: string;
-    language?: string;
-    content?: string;
-    mimeType?: string;
-} | {
-    type: "artifact_contract";
-    turnId: string;
-    artifactRoot?: string;
-    writePaths: string[];
-    outOfRootWrites: Array<{
-        path: string;
-        artifactRoot: string;
-        toolName: string;
-    }>;
-    devServerUrls: string[];
-    browserVerified: boolean;
-    browserEvidence: string[];
-    requiresBrowserAcceptance: boolean;
-} | {
-    type: "annotations";
-    turnId: string;
-    annotations: Array<{
-        type: string;
-        url?: string;
-        title?: string;
-        [key: string]: unknown;
-    }>;
-} | {
-    type: "subagent_started";
-    turnId: string;
-    subagentId: string;
-    agentType: string;
-    prompt?: string;
-} | {
-    type: "subagent_ended";
-    turnId: string;
-    subagentId: string;
-    agentType: string;
-    ok: boolean;
-    outputPreview?: string;
-    error?: string;
-};
-export interface GoalReconstructionState {
-    goal: string;
-    artifactRoot: string;
-    decisions: string[];
-    defects: string[];
-    acceptanceCriteria: string[];
-    blockers: string[];
-    nextAction: string;
-}
-export interface MaintainedDocumentIndex {
-    name?: string;
-    path?: string;
-    indexed: true;
-    maintained: true;
-    indexVersion: string;
-    contentHash: string;
-    summary: string;
-    lastReviewedTurn: number;
-}
-export interface DecisionStateRecord {
-    id: string;
-    decision: string;
-    status: string;
-    evidence: string;
-    lastConfirmedTurn: number;
-}
-export interface ReadCycleGuard {
-    strategy: string;
-    nextReadPolicy: string;
-    budgetStatus: "within-budget";
-    maxReadsPerDocument: number;
-    observedReadsByPath: Record<string, number>;
-}
 export interface ToolInvoker {
     invoke(turnId: string, name: string, args: string, signal?: AbortSignal): Promise<{
         result: string;

package/dist/types/runtime/ports/tool-contracts.d.ts

@@ -48,6 +48,12 @@ export interface ToolCatalog {
     removeTool(name: string): boolean;
     activateTool(name: string): boolean;
     clearActivatedTools(): void;
+    /** SSOT for the deferred-tool set consumed by the prompt index and the tool_search corpus. */
+    listDeferredTools(): Array<{
+        name: string;
+        description: string;
+        searchHint?: string;
+    }>;
 }
 export interface ToolBootstrapProgress {
     output: string;

package/dist/types/runtime/prompt/environment-context.d.ts

@@ -35,6 +35,23 @@ export declare function createTaskGuidanceSection(domain?: TaskDomain): SystemPr
  * Tells the LLM when to use specialized tools vs. primitives.
  */
 export declare function createToolGuidanceSection(): SystemPromptSection;
+/**
+ * Render the deferred-tool listing with accuracy-aware token discipline.
+ *
+ * Dropping ALL descriptions to save tokens trades away tool-SELECTION accuracy:
+ * the model cannot tell `mcp__exa__search` from `mcp__github__search` by name.
+ * So spend the description budget exactly where confusion lives:
+ *   - small set (<= richHintLimit): every tool rich.
+ *   - built-in deferred tools (no server): always rich — small, bounded set.
+ *   - MCP tools whose leaf name collides with another tool: keep the hint.
+ *   - MCP tools with a unique leaf: name only (unambiguous; tool_search recovers
+ *     details on demand).
+ * Names are ALWAYS listed so any capability can be `select:`ed directly.
+ */
+export declare function buildDeferredToolIndexBody(deferred: Array<{
+    name: string;
+    description: string;
+}>, richHintLimit: number): string[];
 /**
  * Index of deferred tools so the model KNOWS these capabilities exist even
  * though their schemas are not loaded. Without this the model sees only the
@@ -47,7 +64,9 @@ export declare function createToolGuidanceSection(): SystemPromptSection;
 export declare function createDeferredToolIndexSection(listDeferredTools: () => Array<{
     name: string;
     description: string;
-}>): SystemPromptSection;
+}>, options?: {
+    richHintLimit?: number;
+}): SystemPromptSection;
 /**
  * Create a system prompt section that instructs the model on response language.
  * CC parity: only injected when language is explicitly set; when absent,

package/dist/types/skills/tools/ask-user-tool.d.ts

@@ -34,7 +34,9 @@ export declare const ASK_USER_TOOL_SCHEMA: {
                     };
                     readonly options: {
                         readonly type: "array";
-                        readonly description: "2-4 options for the user to choose from. Omit for free text.";
+                        readonly minItems: 2;
+                        readonly maxItems: 8;
+                        readonly description: "2-8 options for the user to choose from. Omit for free text.";
                         readonly items: {
                             readonly type: "object";
                             readonly properties: {
@@ -52,7 +54,7 @@ export declare const ASK_USER_TOOL_SCHEMA: {
                     };
                     readonly multiSelect: {
                         readonly type: "boolean";
-                        readonly description: "Allow selecting multiple options (default: false).";
+                        readonly description: string;
                     };
                 };
                 readonly required: readonly ["question", "header"];

package/dist/types/skills/tools/shell/command-classification.d.ts

@@ -42,3 +42,4 @@ export declare function commandHasAnyCd(command: string): boolean;
  * Mirrors cc's `isSearchOrReadBashCommand()` + `isSilentBashCommand()`.
  */
 export declare function classifyCommand(command: string): CommandClassification;
+export declare function requiresDedicatedReadSearchTool(classification: CommandClassification): boolean;

package/dist/types/skills/tools/tool-search-tool.d.ts

@@ -23,6 +23,11 @@ export interface DeferredToolInfo {
     description: string;
     /** Optional search hint for better discovery */
     searchHint?: string;
+    /** Compact parameter signature (e.g. "query, maxResults?") to disambiguate similar tools. */
+    paramSummary?: string;
+    score?: number;
+    matchedTerms?: string[];
+    matchedFields?: string[];
 }
 export interface ToolSearchOutput {
     matches: DeferredToolInfo[];
@@ -52,7 +57,15 @@ export interface ToolSearchCorpusEntry {
     name: string;
     description: string;
     searchHint?: string;
+    paramSummary?: string;
 }
+/**
+ * Compact parameter signature for a JSON-Schema tool, e.g. "query, maxResults?".
+ * Required params are plain, optional ones suffixed "?". Surfacing this in search
+ * results raises tool-SELECTION accuracy: two lexically similar tools (e.g. two
+ * `search` tools) are told apart by their inputs, not guessed by name.
+ */
+export declare function summarizeToolParams(parameters: unknown): string;
 /**
  * Score a keyword query against a tool corpus (CC-aligned weights).
  * Query syntax: plain terms rank, "+term" is required (must appear in

package/dist/types/skills/tools/tool-selection-eval.d.ts

@@ -0,0 +1,49 @@
+import { type ToolSearchCorpusEntry } from "./tool-search-tool.js";
+export type EvalLang = "en" | "zh";
+export interface ToolSelectionCase {
+    id: string;
+    /** Natural-language / keyword intent issued to tool_search. */
+    query: string;
+    lang: EvalLang;
+    /** Tool names that count as a correct selection (one or more acceptable). */
+    expected: string[];
+    /** Optional note on what weakness this case probes. */
+    note?: string;
+}
+export interface CaseResult {
+    id: string;
+    lang: EvalLang;
+    query: string;
+    expected: string[];
+    topMatch: string | null;
+    hitAt1: boolean;
+    hitAtK: boolean;
+    /** 1-based rank of the first expected tool among results, or null if absent. */
+    firstExpectedRank: number | null;
+}
+export interface EvalReport {
+    k: number;
+    total: number;
+    /** Share of cases whose #1 result is an expected tool. */
+    precisionAt1: number;
+    /** Share of cases with an expected tool anywhere in the top-k. */
+    recallAtK: number;
+    /** Mean reciprocal rank of the first expected tool. */
+    mrr: number;
+    byLang: Record<EvalLang, {
+        total: number;
+        precisionAt1: number;
+        recallAtK: number;
+    }>;
+    failures: CaseResult[];
+    results: CaseResult[];
+}
+/**
+ * Run the deterministic search-ranking eval: feed each case's query through
+ * searchToolCorpus and score whether the expected tool is surfaced (and where).
+ */
+export declare function evalSearchSelection(corpus: ToolSearchCorpusEntry[], cases: ToolSelectionCase[], options?: {
+    k?: number;
+}): EvalReport;
+/** Human-readable report — printed on gate failure so CI logs name the regressed cases. */
+export declare function formatEvalReport(report: EvalReport): string;

package/dist/types/skills/tools/tool-selection-eval.dataset.d.ts

@@ -0,0 +1,5 @@
+import type { ToolSearchCorpusEntry } from "./tool-search-tool.js";
+import type { ToolSelectionCase } from "./tool-selection-eval.js";
+/** Representative deferred corpus: built-in media/dev tools + colliding MCP tools. */
+export declare const SEED_CORPUS: ToolSearchCorpusEntry[];
+export declare const SEED_CASES: ToolSelectionCase[];