qlogicagent 2.15.9 → 2.16.1

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 {
@@ -57,6 +59,19 @@ export interface AgentInstallSpec {
     verifyCmd?: string;
     /** Official docs / source URL (shown in the install confirmation). */
     docsUrl: string;
+    /**
+     * Self/host-platform agents (e.g. openclaw) whose in-place UPDATE would disrupt the running session
+     * (the engine bridges to a live instance). When already installed, the update runs DETACHED in the
+     * background instead of as a child of the engine, and takes effect on the agent's next startup.
+     */
+    deferUpdate?: boolean;
+    /**
+     * Interactive terminal login/setup command for agents that hold credentials in their OWN CLI store
+     * (oauth / own-setup, e.g. `kimi login`, `hermes acp --setup`). The UI exposes a "在终端登录/设置"
+     * button that opens an OS terminal running this, so the user never leaves the app. Resolved
+     * server-side (fixed catalog string, no user input) — never managed/key-routable agents.
+     */
+    setupCommand?: string;
 }
 /**
  * Extended descriptor for external agents,
@@ -299,6 +314,8 @@ export interface ProductBudget {
     maxTotalTokens?: number;
     maxDuration?: number;
     usedTokens: number;
+    inputTokens?: number;
+    outputTokens?: number;
     elapsed: number;
 }
 /** product.create RPC params. */
@@ -334,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 {
@@ -383,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;
@@ -404,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 {
@@ -461,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_delta", "turn.sidechain_completed", "turn.task_updated", "turn.todos_updated", "turn.exec_progress", "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.agentUsage", "solo.agentDiff", "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_delta", "turn.sidechain_completed", "turn.task_updated", "turn.todos_updated", "turn.exec_progress", "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.agentUsage", "solo.agentDiff", "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;
@@ -1108,7 +1111,9 @@ export interface AgentRpcMethodMap extends GatewayRpcMethodMap {
         };
     };
     "agents.checkUpdates": {
-        params: undefined;
+        params: {
+            mirror?: string;
+        } | undefined;
         result: {
             updates: unknown[];
         };
@@ -1261,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 SoloAgentDiffNotification, type SoloAgentUsageNotification, type SoloEvaluationNotification, type SoloProgressNotification, type TeamMemberNotification, type ToolApprovalRequestNotification, type TurnAnnotationsNotification, 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 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

@@ -263,10 +263,84 @@ export interface TurnHeartbeatNotification {
     turnId: string;
     message: string;
 }
-/** Human-readable summary of a tool use batch. */
+/** Structured telemetry for a tool use batch. */
 export interface TurnToolUseSummaryNotification {
     turnId: string;
+    telemetrySource?: "agent" | "agent-synthetic";
+    availableToolNames: string[];
+    enabledToolNames: string[];
+    toolCallNames: string[];
+    blockedToolCalls: Array<{
+        name: string;
+        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;
+    kind: "stage" | "reopen" | "resume" | "context_compression" | "goal_reconstruction" | "memory_drift" | "artifact_path_drift";
+    stage?: string;
+    status?: string;
+    detail?: string;
+    reconstruction?: GoalReconstructionState;
+    observedAt?: 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;
+    fileSizeBytes: number;
+    recordCount: 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>;
+}
+/** Queryable large-document maintenance and read-cycle audit telemetry. */
+export interface TurnDocumentMaintenanceNotification {
+    turnId: string;
+    checkpointId: string;
+    documents: MaintainedDocumentIndex[];
+    decisionStateTable: DecisionStateRecord[];
+    readCycleFindings: Array<Record<string, unknown>>;
+    readCycleGuard: ReadCycleGuard;
+    observedAt?: string;
 }
 /** Structured artifact produced by the agent. */
 export interface TurnArtifactNotification {
@@ -279,6 +353,21 @@ export interface TurnArtifactNotification {
     content?: string;
     mimeType?: string;
 }
+/** Single-track artifact delivery and browser-acceptance contract. */
+export interface TurnArtifactContractNotification {
+    turnId: string;
+    artifactRoot?: string;
+    writePaths: string[];
+    outOfRootWrites: Array<{
+        path: string;
+        artifactRoot: string;
+        toolName: string;
+    }>;
+    devServerUrls: string[];
+    browserVerified: boolean;
+    browserEvidence: string[];
+    requiresBrowserAcceptance: boolean;
+}
 /** Agent requests user approval before executing a restricted tool. */
 export interface ToolApprovalRequestNotification {
     approvalId: string;
@@ -502,6 +591,9 @@ export interface SoloProgressNotification {
     agentId: string;
     state: "pending" | "running" | "completed" | "failed" | "idle";
     progress?: string;
+    /** Absolute path of the competitor's isolated git worktree, sent with the first "running" event so
+     *  the UI can resolve the agent's产物 (which live in the worktree) for click-to-preview. */
+    worktreePath?: string;
 }
 /** Solo evaluation completed. */
 export interface SoloEvaluationNotification {
@@ -515,15 +607,6 @@ export interface SoloAgentDeltaNotification {
     agentId: string;
     text: string;
 }
-/** Solo agent diff. */
-export interface SoloAgentDiffNotification {
-    soloId: string;
-    agentId: string;
-    files: {
-        path: string;
-        hunks: string;
-    }[];
-}
 /** Solo agent usage. */
 export interface SoloAgentUsageNotification {
     soloId: string;
@@ -542,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 {
@@ -593,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;
@@ -854,7 +958,11 @@ 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;
+    "turn.artifact_contract": TurnArtifactContractNotification;
     "tool.approval.request": ToolApprovalRequestNotification;
     "turn.skill_instruction": TurnSkillInstructionNotification;
     "turn.skill_acquisition_needed": TurnSkillAcquisitionNeededNotification;
@@ -879,7 +987,6 @@ export interface NotificationMethodMap {
     "solo.progress": SoloProgressNotification;
     "solo.evaluation": SoloEvaluationNotification;
     "solo.agentDelta": SoloAgentDeltaNotification;
-    "solo.agentDiff": SoloAgentDiffNotification;
     "solo.agentUsage": SoloAgentUsageNotification;
     "product.taskStarted": ProductTaskStartedNotification;
     "product.taskCompleted": ProductTaskCompletedNotification;
@@ -890,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

@@ -22,7 +22,7 @@ export declare function resolveInstalledNpmPackageVersionFromInstall(install: Ac
 export declare function getCatalogInstalledVersion(entry: AcpBackendConfig, detectedVersion?: string): string | undefined;
 /** Resolve a package's latest published version via `npm view` (async + cached). Used by the background
  *  update check so N agents resolve concurrently (one `npm view` each) instead of blocking sequentially. */
-export declare function fetchNpmLatestPackageVersionAsync(packageName: string | null | undefined): Promise<string | null>;
+export declare function fetchNpmLatestPackageVersionAsync(packageName: string | null | undefined, registry?: string): Promise<string | null>;
 export interface CatalogUpdateInfo {
     id: string;
     packageName?: string;
@@ -39,7 +39,22 @@ export declare function getCatalogUpdateInfoAsync(entries: ReadonlyArray<{
     id: string;
     entry: AcpBackendConfig;
     detectedVersion?: string;
-}>): Promise<CatalogUpdateInfo[]>;
+}>, registry?: string): Promise<CatalogUpdateInfo[]>;
+/**
+ * Synchronous, NETWORK-FREE update info read straight from the persisted cache (disk-seeded on first
+ * use). Returns immediately so the panel lights up last-known badges INSTANTLY — VS Code's gallery
+ * pattern — without waiting on `npm view`. `stale` is true when any installed package's cached "latest"
+ * is missing, errored, or older than the TTL; the caller then refreshes via getCatalogUpdateInfoAsync
+ * in the background, and the next call serves the fresh value.
+ */
+export declare function getCatalogUpdateInfoCached(entries: ReadonlyArray<{
+    id: string;
+    entry: AcpBackendConfig;
+    detectedVersion?: string;
+}>, registry?: string): {
+    updates: CatalogUpdateInfo[];
+    stale: boolean;
+};
 export declare function normalizeWindowsAcpCommand(cliPath: string, args: string[]): {
     cliPath: string;
     acpArgs: string[];
@@ -167,5 +182,25 @@ export declare class AcpDetector {
      * would fail its turn ("No LLM provider"/auth). Does NOT verify the key is *valid* — that's only
      * known at runtime.
      */
+    /**
+     * Tri-state native-login state for the credential UI's account label — distinct from isAgentReady.
+     * `true` = a native login/subscription was actually detected (e.g. codex ~/.codex/auth.json); `false`
+     * = probeable but not logged in; `undefined` = no probe for this agent (e.g. hermes' own `acp --setup`
+     * store, which we can't read). isAgentReady treats undefined as ready-if-installed so the CLI gets a
+     * chance to run, but the UI must NOT claim "已登录" on undefined — it just doesn't know.
+     */
+    getNativeLoginState(agentId: string): boolean | undefined;
     isAgentReady(agentId: string): boolean;
+    /**
+     * Fast-fail guard for the turn path: returns a user-facing error when an agent is in a key-required
+     * credential mode (managed / userKey / auto-resolving-to-key) but NO usable key got injected — so the
+     * caller can reject the turn cleanly instead of spawning a CLI that would silently stall on auth (the
+     * host then goes quiet → the gateway's hang-watchdog kills it → the user sees a cryptic "Agent process
+     * stdio closed"). Returns null when credentialed, or when the mode owns its own native login
+     * (account / oauth / keyless), or when we can't be sure a key is needed.
+     */
+    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/infra/agent-install-runner.d.ts

@@ -55,3 +55,26 @@ export declare function runAgentInstall(install: AgentInstallSpec, onEvent: (e:
     ok: boolean;
     error?: string;
 }>;
+/**
+ * Open an OS terminal window running an agent's interactive login/setup command (e.g. `kimi login`,
+ * `hermes acp --setup`). The local desktop host can spawn a real terminal so the user completes the
+ * CLI's own login flow without leaving the app. Detached + unref so it outlives the engine. The command
+ * is a fixed catalog string (no user input) → no injection surface.
+ */
+export declare function launchSetupTerminal(command: string, platform?: NodeJS.Platform): {
+    ok: boolean;
+    error?: string;
+};
+/**
+ * Fire-and-forget install in a FULLY DETACHED process (own session/process-group, no stdio shared with
+ * us). Used for self/host-platform agents (openclaw) whose in-place UPDATE would otherwise disrupt the
+ * running engine the install is a child of — "Agent process stdio closed". Returns immediately; the new
+ * version is live on the agent's next startup. No progress streaming (the process is detached).
+ */
+export declare function runAgentInstallDetached(install: AgentInstallSpec, opts?: {
+    platform?: NodeJS.Platform;
+    mirror?: string;
+}): {
+    ok: boolean;
+    error?: string;
+};

package/dist/types/runtime/infra/agent-process.d.ts

@@ -285,6 +285,16 @@ export declare class AgentProcessManager {
     isAlive(memberId: string): boolean;
     /** Get usage tracker for an ACP agent (returns null for internal agents). */
     getUsageTracker(memberId: string): AcpUsageTracker | null;
+    /**
+     * Feed token usage into the tracker from a child notification (Tier 1). Handles all three shapes a
+     * child may use so the tracker is actually populated:
+     *   - a top-level `usage_update` method (legacy/non-standard),
+     *   - standard ACP `session/update` with `sessionUpdate:"usage_update"` (fields on the update),
+     *   - the self-hosted qlogicagent's relay: `session/update` → `sessionUpdate:"x_relay"` carrying
+     *     `method:"turn.usage_update"` with `params.usage` (a TokenUsage object).
+     * Without the x_relay branch the self-agent's usage was never captured → Solo columns showed ↓0 ↑0.
+     */
+    private feedUsageFromNotification;
     /**
      * Create a named-pipe IPC server for MCP bridge tool-call proxying.
      * External agents' MCP bridge servers connect here to proxy tool calls