qlogicagent 2.15.9 → 2.15.10

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

@@ -263,10 +263,69 @@ 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;
+    availableToolNames: string[];
+    enabledToolNames: string[];
+    toolCallNames: string[];
+    blockedToolCalls: Array<{
+        name: string;
+        reason: 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;
+}
+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 +338,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 +576,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 +592,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;
@@ -854,7 +922,10 @@ export interface NotificationMethodMap {
     "turn.exec_progress": TurnExecProgressNotification;
     "turn.heartbeat": TurnHeartbeatNotification;
     "turn.tool_use_summary": TurnToolUseSummaryNotification;
+    "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 +950,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;

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,22 @@ 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;
 }

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

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

@@ -72,7 +72,31 @@ export type TurnEvent = {
 } | {
     type: "tool_use_summary";
     turnId: string;
-    summary: 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;
@@ -109,6 +133,20 @@ export type TurnEvent = {
     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;
@@ -133,6 +171,39 @@ export type TurnEvent = {
     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;
@@ -146,6 +217,8 @@ export interface AgentRunRequest {
     turnId: string;
     sessionId: string;
     messages: ChatMessage[];
+    /** Full registered tool surface before per-turn policy filtering. */
+    availableTools?: ToolDefinition[];
     tools: ToolDefinition[];
     systemPrompt?: string;
     config?: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlogicagent",
-  "version": "2.15.9",
+  "version": "2.15.10",
   "description": "XiaozhiClaw Agent CLI — subprocess architecture (JSON-RPC over stdio)",
   "type": "module",
   "main": "dist/index.js",