qlogicagent 2.17.1 → 2.17.5

package/dist/types/agent/tool-loop/artifact-final-contract.d.ts

@@ -16,6 +16,16 @@ export interface ArtifactContractState {
     buildVerified: boolean;
     buildEvidence: string[];
     buildFailureEvidence: string[];
+    /**
+     * Ledger sizes recovered from prior turns' history at turn start. The recovered ledger keeps
+     * cross-turn claims reconcilable (a model may legitimately cite files written last turn), but
+     * it is NOT this turn's evidence — the engine fallback block only fires on new entries.
+     */
+    recoveredBaseline?: {
+        writePaths: number;
+        devServerUrls: number;
+        artifactRoot: boolean;
+    };
 }
 export interface ArtifactContractEventPayload {
     artifactRoot?: string;
@@ -39,10 +49,40 @@ export interface TaskContractItem {
 export declare function createArtifactContractState(inputMessages: readonly ChatMessage[]): ArtifactContractState;
 export declare function requiresBrowserAcceptance(inputMessages: readonly ChatMessage[]): boolean;
 export declare function requiresBuildVerification(inputMessages: readonly ChatMessage[]): boolean;
-export declare function requiresResearchQualityGate(inputMessages: readonly ChatMessage[]): boolean;
-export declare function requiresFinalStatusAudit(inputMessages: readonly ChatMessage[]): boolean;
-export declare function hasFinalStatusContract(content: string): boolean;
-export declare function hasResearchQualityGate(content: string): boolean;
+export type FinalStatusBrowserVerdict = "verified" | "failed" | "not-run";
+export type FinalStatusBuildVerdict = "passed" | "failed" | "not-run";
+export interface FinalStatusClaim {
+    schema: number;
+    author?: "model" | "engine";
+    done?: string[];
+    notDone?: string[];
+    artifacts?: {
+        root?: string;
+        files?: string[];
+        urls?: string[];
+    };
+    verification?: {
+        browser?: FinalStatusBrowserVerdict;
+        build?: FinalStatusBuildVerdict;
+    };
+    sources?: {
+        cited?: string[];
+    };
+    blockers?: string[];
+    nextAction?: string;
+}
+export interface ParsedFinalStatusBlock {
+    /** null = a block was present but not valid schema-1 JSON (malformed). */
+    claim: FinalStatusClaim | null;
+    start: number;
+    end: number;
+}
+/** The final-status contract applies only to turns whose tool surface can produce artifacts or run verification. */
+export declare function finalStatusContractApplies(toolNames: Iterable<string>): boolean;
+export declare const FINAL_STATUS_PROMPT_CONTRACT: string;
+/** Locate and parse the last ```final-status block. Returns null when no block exists. */
+export declare function parseFinalStatusBlock(content: string): ParsedFinalStatusBlock | null;
+export declare function renderFinalStatusBlock(claim: FinalStatusClaim): string;
 export declare function toolCallWritePath(toolName: string, rawArguments: string): string | null;
 export declare function resolveArtifactRootWriteBlock(params: {
     state: ArtifactContractState;
@@ -77,10 +117,15 @@ export declare function updateArtifactContractFromToolResult(params: {
 export declare function artifactContractPayload(state: ArtifactContractState, inputMessages: readonly ChatMessage[]): ArtifactContractEventPayload;
 export declare function recoverArtifactContractState(inputMessages: readonly ChatMessage[]): ArtifactContractState;
 export declare function updateArtifactContractFromFinalContent(state: ArtifactContractState, content: string): void;
-export declare function applyFinalStatusContract(params: {
+export interface FinalStatusReconciliation {
     content: string;
-    inputMessages: readonly ChatMessage[];
-    messages: readonly ChatMessage[];
+    /** A ```final-status block was present but not valid schema-1 JSON (treated as absent). */
+    malformedBlock: boolean;
+}
+export declare function reconcileFinalStatus(params: {
+    content: string;
+    /** From finalStatusContractApplies() over the turn's tool surface; inactive turns pass through untouched. */
+    contractActive: boolean;
     totalToolCallCount: number;
     distinctToolNames: Iterable<string>;
     visibleToolCallCount?: number;
@@ -91,4 +136,6 @@ export declare function applyFinalStatusContract(params: {
         reason: string;
     }>;
     activeTasks?: readonly TaskContractItem[];
-}): string;
+    /** The turn ended on a forced/failure terminal rather than a clean model stop. */
+    forcedStop?: boolean;
+}): FinalStatusReconciliation;

package/dist/types/cli/handlers/turn-handler.d.ts

@@ -18,12 +18,6 @@ export interface TurnControlHandlerHost {
     sendResponse(id: string | number, result?: unknown, error?: unknown): void;
 }
 export declare function hydrateTurnConfigFromModelMetadata(config: TurnConfig): TurnConfig;
-export declare function resolveAutoToolChoice(params: {
-    currentToolChoice?: TurnConfig["toolChoice"];
-    explicitNoToolTurn: boolean;
-    looksLikeBuildIntent: boolean;
-    requiresPreToolPreamble?: boolean;
-}): TurnConfig["toolChoice"] | undefined;
 export declare function hydrateAttachmentReferenceUrlsForTurn(messages: ChatMessage[]): ChatMessage[];
 export declare function getFocusedAttachmentToolNamesForTurn(messages: ChatMessage[]): Set<string> | null;
 type FocusedAttachmentModelPurpose = "imageUnderstanding" | "videoUnderstanding";

package/dist/types/orchestration/delegation-coordinator.d.ts

@@ -34,6 +34,7 @@ export declare class DelegationCoordinator {
      */
     delegate(agentId: string, brief: string, opts?: {
         acceptanceCriteria?: string;
+        delegationId?: string;
         sessionId?: string;
     }): {
         delegationId: string;

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

@@ -114,6 +114,7 @@ export interface AcpInitializeResult {
         mcpCapabilities?: {
             http?: boolean;
             sse?: boolean;
+            stdio?: boolean;
         };
         promptCapabilities?: {
             audio?: boolean;
@@ -166,11 +167,15 @@ export interface AcpUsageUpdatePayload {
     totalTokens?: number;
 }
 /** MCP server config to inject into ACP session/new. */
+export interface McpServerEnvEntry {
+    name: string;
+    value: string;
+}
 export interface McpServerConfig {
     name: string;
     command: string;
     args: string[];
-    env?: Record<string, string>;
+    env?: McpServerEnvEntry[];
 }
 export interface AgentsScanParams {
     force?: boolean;

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

@@ -140,6 +140,10 @@ export interface AcpSessionNewParams {
         uri?: string;
         command?: string;
         args?: string[];
+        env?: Array<{
+            name: string;
+            value: string;
+        }>;
     }>;
     /** Optional session ID (host-assigned). If omitted, agent generates one. */
     sessionId?: string;

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

@@ -53,6 +53,10 @@ export interface AgentProcessConfig {
     /** System prompt to inject into ACP session. */
     systemPrompt?: string;
 }
+export declare function buildExternalAcpSpawnCommand(cliPath: string, acpArgs: string[]): {
+    command: string;
+    args: string[];
+};
 /** Snapshot of ongoing media generation progress reported by a child agent. */
 export interface MediaProgressSnapshot {
     /** Provider-specific task ID (e.g. volcengine job id). */

package/dist/types/skills/memory/local-store.d.ts

@@ -195,7 +195,7 @@ export declare class LocalMemoryStore {
         }>;
     };
     /**
-     * Find memories related to a specific event date (卤tolerance).
+     * Find memories related to a specific event date (±tolerance).
      * Used for temporal context retrieval, such as finding memories around a requested date.
      */
     findByEventDate(userId: string, targetDate: string, toleranceDays?: number): MemorySearchHit[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlogicagent",
-  "version": "2.17.1",
+  "version": "2.17.5",
   "description": "XiaozhiClaw Agent CLI — subprocess architecture (JSON-RPC over stdio)",
   "type": "module",
   "main": "dist/index.js",
@@ -69,10 +69,11 @@
     "build:search-svc": "node scripts/build-search-svc.mjs",
     "start": "node dist/cli.js",
     "test": "vitest run",
-    "check": "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 && 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: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",