qlogicagent 2.18.1 → 2.18.2

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

@@ -13,7 +13,7 @@
  * 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.file_changes", "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.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", "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.file_changes", "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.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", "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", "workflow.approvalTimedOut"];
 /**
  * Agent Team events (Solo Mode, Product Mode, Plan lifecycle).
  * Relayed to the UI's team/orchestration panel.
@@ -23,7 +23,7 @@ export declare const AGENT_TEAM_WS_EVENT_NAMES: readonly ["solo.progress", "solo
  * 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.file_changes", "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.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", "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", "goal.run_state_changed", "goal.phase_boundary", "goal.goal_edited", "goal.message_queued", "goal.acceptance_updated"];
+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.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.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", "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", "workflow.approvalTimedOut", "solo.progress", "solo.specProgress", "solo.agentDelta", "solo.agentActivity", "solo.agentUsage", "solo.evaluation", "product.taskStarted", "product.taskOutput", "product.members", "product.agentActivity", "product.taskCompleted", "product.taskFailed", "product.budgetUpdate", "product.budgetWarning", "product.checkpointed", "product.completed", "product.dagTopology", "plan.interrupted", "goal.run_state_changed", "goal.phase_boundary", "goal.goal_edited", "goal.message_queued", "goal.acceptance_updated"];
 /** 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/gateway-rpc.d.ts

@@ -241,6 +241,7 @@ export interface GatewayRpcMethodMap {
         result: {
             messages: unknown[];
             total: number;
+            corruptLines?: number;
         };
     };
     "project.list": {

package/dist/types/runtime/execution/streaming-tool-executor.d.ts

@@ -28,6 +28,8 @@ export interface StreamingToolExecutorConfig {
     toolInvoker: ToolInvoker;
     hooks?: HookRegistry;
     sessionId: string;
+    /** Turn workspace/cwd - routes oversized tool-result spillover to the session data dir. */
+    projectRoot?: string;
     turnId: string;
     log: AgentLogger;
     signal?: AbortSignal;

package/dist/types/runtime/execution/tool-result-storage.d.ts

@@ -48,7 +48,7 @@ export declare function generatePreview(content: string, maxBytes: number): {
     preview: string;
     hasMore: boolean;
 };
-export declare function persistToolResult(content: string, toolCallId: string, sessionId: string): Promise<PersistedToolResult | null>;
+export declare function persistToolResult(content: string, toolCallId: string, sessionId: string, projectRoot: string | undefined): Promise<PersistedToolResult | null>;
 /**
  * Build a reference message for large tool results (CC buildLargeToolResultMessage parity).
  */
@@ -58,7 +58,7 @@ export declare function buildLargeToolResultMessage(result: PersistedToolResult)
  * Falls back to hard truncation if persistence fails.
  * Called at tool execution time in streaming-tool-executor.ts.
  */
-export declare function maybePersistLargeToolResult(content: string, toolCallId: string, sessionId: string, threshold?: number): Promise<string>;
+export declare function maybePersistLargeToolResult(content: string, toolCallId: string, sessionId: string, projectRoot: string | undefined, threshold?: number): Promise<string>;
 interface MessageLike {
     role: string;
     content?: string | unknown;
@@ -78,10 +78,12 @@ interface MessageLike {
  * replaced later (would break prompt cache).
  *
  * @param state — MUTATED in place (seenIds and replacements updated)
- * @returns messages with replacements applied + count of new replacements
+ * @returns messages with replacements applied + count of new replacements +
+ *          total original bytes spilled this pass (so the caller can surface it)
  */
-export declare function enforceToolResultBudget(messages: MessageLike[], state: ContentReplacementState, sessionId: string, limit?: number): Promise<{
+export declare function enforceToolResultBudget(messages: MessageLike[], state: ContentReplacementState, sessionId: string, projectRoot: string | undefined, limit?: number): Promise<{
     messages: MessageLike[];
     newlyReplacedCount: number;
+    newlyPersistedBytes: number;
 }>;
 export {};

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

@@ -16,6 +16,12 @@
  */
 import type { ChildProcess } from "node:child_process";
 import type { AcpInitializeResult, AcpSessionResult, AcpPromptResponse, McpServerConfig } from "../../protocol/wire/acp-agent-management.js";
+interface AcpPromptTimeoutOptions {
+    timeoutMs?: number;
+    getLastActivityAt?: () => number | undefined;
+    checkIntervalMs?: number;
+}
+type AcpPromptTimeoutInput = number | AcpPromptTimeoutOptions;
 /**
  * Handler for agent→host requests (fs, terminal, permission, elicitation).
  * Host implementations should implement the methods they support. This is intentionally loose
@@ -137,6 +143,7 @@ export declare class AcpProtocolAdapter {
     private requireConn;
     /** Race a connection call against a timeout; optionally run a side effect (e.g. cancel) on timeout. */
     private withTimeout;
+    private withActivityTimeout;
     /**
      * Perform the ACP initialize handshake. Sends standard clientInfo + clientCapabilities plus the
      * qlogicagent extension capability (forwarded verbatim by the SDK).
@@ -170,7 +177,7 @@ export declare class AcpProtocolAdapter {
      * notifications during execution; the response carries only { stopReason, usage? }. On timeout the
      * turn is cancelled (session/cancel) so the agent stops cleanly.
      */
-    sendPrompt(_child: ChildProcess, sessionId: string, content: string, timeoutMs?: number): Promise<AcpPromptResponse>;
+    sendPrompt(_child: ChildProcess, sessionId: string, content: string, timeoutInput?: AcpPromptTimeoutInput): Promise<AcpPromptResponse>;
     /**
      * Resume an existing ACP session (session/load — replays history via notifications).
      * Only valid when the agent advertised the loadSession capability.
@@ -190,3 +197,4 @@ export declare class AcpProtocolAdapter {
      */
     static translateNotification(method: string, params: unknown): TranslatedNotification | null;
 }
+export {};

package/dist/types/runtime/infra/external-agent-pool.d.ts

@@ -44,6 +44,18 @@ export declare function poolKey(agentId: string, cwd: string, sessionId?: string
 export declare function getAlivePooledAgent(key: string): PooledAgentEntry | undefined;
 /** Register a freshly-spawned entry, evicting any stale same-key entry and enforcing MAX_POOL. */
 export declare function registerPooledAgent(key: string, entry: PooledAgentEntry): void;
+/**
+ * Move a live pooled entry from one key to another without disposing it — the same ACP process keeps
+ * running, only its pool key changes. Disposes any stale occupant of the destination key. Returns the
+ * moved entry, or undefined if `fromKey` has no live entry (a dead one is reaped). No-op returning the
+ * existing entry when the keys are equal.
+ *
+ * Merge note (session-identity-alignment): the second caller this was extracted for — the transient→native
+ * X→Y re-key after a native agent reported its own id — is GONE. Under canonical-id-stable, the frontend
+ * never converges to Y, so the pool key never changes mid-conversation; the sole caller is adoptWarmedAgent
+ * (warm → real session key). Kept as the general re-key primitive.
+ */
+export declare function rekeyPooledAgent(fromKey: string, toKey: string): PooledAgentEntry | undefined;
 /**
  * Re-key a pre-warmed entry (spawned before a session existed, under WARM_SESSION) onto the real
  * session key, so the first turn adopts the warmed process and skips the cold start. Does not

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

@@ -39,6 +39,8 @@ export interface StreamingToolExecutorPortConfig {
     signal?: AbortSignal;
     maxConcurrentTools?: number;
     maxExecutionMs?: number;
+    /** Turn workspace/cwd — routes oversized tool-result spillover to the session's reachable data dir. */
+    projectRoot?: string;
 }
 export interface ContextCompressionEnginePort {
     compressAsync(messages: RuntimeCompressibleMessage[], budget: number, context: {
@@ -52,9 +54,10 @@ export interface ToolLoopRuntimePorts {
         role: string;
         content?: string | unknown;
         tool_call_id?: string;
-    }>, state: unknown, sessionId: string): Promise<{
+    }>, state: unknown, sessionId: string, projectRoot: string | undefined): Promise<{
         messages: unknown[];
         newlyReplacedCount: number;
+        newlyPersistedBytes?: number;
     }>;
     getActiveContextCompressionEngine(): ContextCompressionEnginePort | null;
     compressMessages(messages: RuntimeCompressibleMessage[], options: {

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

@@ -32,6 +32,16 @@ export interface ShellInfo {
     psEdition?: "5.1" | "7+";
     isGitBashOnWindows?: boolean;
 }
+/**
+ * Dynamic, platform-specific shell guidance lines appended to `# Environment`.
+ *
+ * When `shellInfo` is present it reflects the REAL active shell (edition +
+ * Git-Bash-on-Windows), so the advice matches what commands will actually run
+ * against. When absent, we fall back to the env-guessed `shellType` and keep the
+ * old one-line PowerShell/CMD note (never crashes, never over-claims an edition
+ * we don't know).
+ */
+export declare function shellGuidanceLines(shellInfo: ShellInfo | undefined, shellType: ShellType): string[];
 /**
  * Create a system prompt section that provides environment context.
  * Memoized — computed once per session (environment doesn't change mid-session).

package/dist/types/runtime/prompt/fresh-workspace-evidence.d.ts

@@ -16,8 +16,6 @@ export interface FreshWorkspaceEvidencePolicy {
     allowedToolNames: string[];
 }
 export declare function getFreshWorkspaceEvidencePolicy(messages: readonly PromptMessageLike[] | string): FreshWorkspaceEvidencePolicy;
-/** 显式构建/创建类请求(做个游戏/网站/app…)。命中 → 第一回合就强制工具调用。 */
-export declare function looksLikeBuildIntent(messages: readonly PromptMessageLike[] | string): boolean;
 export declare function isLightweightChatTurn(messages: readonly PromptMessageLike[] | string): boolean;
 export declare function isExplicitNoToolTurn(messages: readonly PromptMessageLike[] | string): boolean;
 /**

package/dist/types/runtime/session/inbound-upload-persistence.d.ts

@@ -15,6 +15,14 @@ import type { ChatMessage } from "../../protocol/wire/index.js";
 export interface PersistedUpload {
     url: string;
     localPath?: string;
+    /**
+     * Whether the bytes were actually written to durable storage. `true` on success, `false` when a
+     * transport upload was found but persisting it FAILED (fetch error / non-ok / write error) — the
+     * returned `url` is then the short-lived transport URL that dies with the turn. `undefined` means
+     * the input was not a transport upload to begin with (already-persisted / remote / file://), which
+     * is not a failure. Honesty over silence: callers use `false` to warn instead of pretending it saved.
+     */
+    persisted?: boolean;
 }
 /** 同 persistInboundUploadUrl，但返回持久化后的本地绝对路径（供模型直接 read/exec）。 */
 export declare function persistInboundUploadUrlDetailed(url: string, projectId: string, sessionId: string): Promise<PersistedUpload>;

package/dist/types/runtime/session/session-resource-key.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Single source of truth for session resource keys (canonical identity) and the derived
+ * resident-pool / delegation keys. Forbids scattered ad-hoc string concatenation of session keys
+ * (invariant I2, docs/session-identity-alignment-spec.md). Leaf module — imports nothing.
+ */
+/** Canonical session identity: our-minted, stable-from-creation id + its owning agent + project. */
+export interface SessionResource {
+    /** Owning agent kind: own ("qlogicagent") / codex / claude / … (= SessionMetadata.agentId). */
+    agentId: string;
+    /** Owning project id (path-derived / opaque; not minted here). */
+    projectId: string;
+    /** Our-minted session id, stable from creation — never the native Y (Y lives in nativeBinding). */
+    canonicalSessionId: string;
+}
+/** Serialize the canonical session resource to its single opaque key string. */
+export declare function buildSessionResourceKey(r: SessionResource): string;
+/** Parse a key produced by {@link buildSessionResourceKey}; throws on a malformed key. */
+export declare function parseSessionResourceKey(key: string): SessionResource;
+/**
+ * Resident external-agent pool key: same agent + workspace + session ⇒ same resident process.
+ * `sessionId` may be a canonical id, the WARM_SESSION token, or undefined (defaults to "default").
+ * Byte-identical to the historical inline pool key it replaces.
+ */
+export declare function buildAgentPoolKey(agentId: string, cwd: string, sessionId?: string): string;
+/** Prefix matching every pool key for `agentId` (agent-scoped eviction, exact id-boundary). */
+export declare function agentPoolKeyPrefix(agentId: string): string;
+/** @mention delegation serialization key for one (agent × conversation) pair. */
+export declare function buildConvKey(agentId: string, canonicalSessionId: string): string;

package/dist/types/runtime/session/session-transcript-store.d.ts

@@ -3,6 +3,8 @@ import type { MessageDisplayMetadata, PersistedChatMessage, TokenUsage } from ".
 export interface TranscriptLoadResult {
     messages: PersistedChatMessage[];
     corruptLines: number;
+    /** 1-based line numbers that failed to parse (bounded to the first MAX_REPORTED_CORRUPT_LINES). */
+    corruptLineNumbers: number[];
 }
 export declare function appendMessage(sessionId: string, message: ChatMessage, projectRoot: string, turnId?: string, metadata?: {
     usage?: TokenUsage;

package/dist/types/runtime/session/session-types.d.ts

@@ -18,6 +18,25 @@ export interface InflightTurnMarker {
     /** 该轮是否已执行过有副作用的工具（写文件/发消息/外部 API）。安全档不据此自动续，仅用于 UI"可能重复"提示 + 为智能档铺路。 */
     hadSideEffectTool?: boolean;
 }
+/**
+ * Native (codex/claude) session binding — present only on native sessions, written once the
+ * external agent reports its own session id (Y). Our `sessionId` stays the canonical identity;
+ * `nativeSessionId` is an ATTRIBUTE used ONLY when talking to the external CLI (ACP session/load),
+ * never as a map/pool/list key. `nativeRef` independently locates the external transcript file so
+ * content loads (and the binding is recoverable) without relying on `sessionId === nativeSessionId`.
+ */
+export interface NativeBinding {
+    /** External agent's own session id (Y) — used only for ACP session/load resume. */
+    nativeSessionId: string;
+    /** Locator for the external transcript file (loadTranscript + binding-loss fallback). */
+    nativeRef: {
+        agentId: string;
+        kind: "codex" | "claude";
+        file: string;
+    };
+    /** ISO time the binding was established (first turn the external agent reported Y). */
+    boundAt: string;
+}
 export interface SessionMetadata {
     schemaVersion?: number;
     sessionId: string;
@@ -52,10 +71,18 @@ export interface SessionMetadata {
     interruptedTurnCount?: number;
     /** 达熔断阈值放弃恢复的时间戳（UI 显示"多次中断已停止自动恢复"）。 */
     recoveryAbandonedAt?: string;
+    /** native(codex/claude)会话绑定：外部 Y + nativeRef;own 会话恒 undefined。见 {@link NativeBinding}。 */
+    nativeBinding?: NativeBinding;
 }
 export interface PersistedSession {
     metadata: SessionMetadata;
     messages: PersistedChatMessage[];
+    /**
+     * Count of transcript lines that failed to parse and were skipped on load. Surfaced so the UI can
+     * tell the user "N 条消息无法读取" instead of silently resuming a conversation with holes in it.
+     * Omitted/0 for a clean transcript.
+     */
+    corruptLines?: number;
 }
 export interface MessageDisplayMetadata {
     messageId?: string;
@@ -96,6 +123,8 @@ export interface SessionListEntry {
     groupKey?: string;
     previousSessionId?: string;
     carryoverSummary?: string | null;
+    /** N4: native (codex/claude) binding, surfaced so session.list can shape source:"native" + nativeRef. */
+    nativeBinding?: NativeBinding;
 }
 export interface TaskSummaryDeps {
     transport: import("../ports/index.js").LLMTransport;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlogicagent",
-  "version": "2.18.1",
+  "version": "2.18.2",
   "description": "XiaozhiClaw Agent CLI — subprocess architecture (JSON-RPC over stdio)",
   "type": "module",
   "main": "dist/index.js",
@@ -70,11 +70,12 @@
     "start": "node dist/cli.js",
     "test": "vitest run",
     "test:replay": "vitest run benchmarks/transcript-replay",
-    "check": "pnpm run check:encoding-corruption && tsc --noEmit && pnpm test && pnpm run check:architecture-boundaries && pnpm run check:provider-core-boundary && pnpm run check:provider-core-release-sync && pnpm run check:pet-core-boundary && pnpm run check:workspace-hygiene && pnpm run check:package-artifact",
+    "check": "pnpm run check:encoding-corruption && pnpm run check:mechanical-rules && tsc --noEmit && pnpm test && pnpm run check:architecture-boundaries && pnpm run check:provider-core-boundary && pnpm run check:provider-core-release-sync && pnpm run check:pet-core-boundary && pnpm run check:workspace-hygiene && pnpm run check:package-artifact",
     "test:watch": "vitest",
     "benchmark:hermes-superiority": "tsx benchmarks/hermes-superiority/runner.ts",
     "lint": "oxlint .",
     "check:encoding-corruption": "node scripts/check-encoding-corruption.mjs",
+    "check:mechanical-rules": "node scripts/check-mechanical-rules.mjs",
     "check:architecture-boundaries": "node scripts/check-architecture-boundaries.mjs",
     "check:provider-core-boundary": "node scripts/check-provider-core-boundary.mjs",
     "check:provider-core-release-sync": "node scripts/check-provider-core-release-sync.mjs",
@@ -94,7 +95,7 @@
     "@agentclientprotocol/sdk": "^0.25.0",
     "@napi-rs/canvas": "0.1.100",
     "@xiaozhiclaw/pet-core": "0.1.3",
-    "@xiaozhiclaw/provider-core": "^0.1.20",
+    "@xiaozhiclaw/provider-core": "^0.1.21",
     "better-sqlite3": "^12.10.0",
     "dotenv": "^17.3.1",
     "ioredis": "^5.11.1",