qlogicagent 2.14.1 → 2.14.3

package/dist/types/agent/tool-loop/completion-action-policy.d.ts

@@ -1,5 +1,5 @@
 import type { AgentLogger, ChatMessage, ThinkingBlock, ToolLoopTransition } from "../types.js";
-export type CompletionActionPolicyReason = "file_action_verification" | "explicit_required_file_verification" | "explicit_extra_file_verification" | "final_marker_verification" | "multi_file_skeleton_verification";
+export type CompletionActionPolicyReason = "file_action_verification" | "explicit_required_file_verification" | "explicit_extra_file_verification" | "artifact_index_evidence_verification" | "final_marker_verification" | "multi_file_skeleton_verification";
 export interface CompletionActionPolicyInput {
     inputMessages: readonly ChatMessage[];
     messages: unknown[];

package/dist/types/agent/tool-loop/loop-helpers.d.ts

@@ -4,6 +4,7 @@ export declare function isEmptyToolResult(r: {
     message: unknown;
 }): boolean;
 export declare function findLastToolError(messages: unknown[], _toolName: string): string | undefined;
+export declare function looksLikeBuildRequest(messages?: readonly ChatMessage[]): boolean;
 export declare function resolveToolLoopBudget(requested?: number, messages?: readonly ChatMessage[]): number;
 export declare function countExplicitOutputArtifacts(messages?: readonly ChatMessage[]): number;
 export declare function resolveTotalToolCallBudget(requested?: number, messages?: readonly ChatMessage[]): number;

package/dist/types/agent/tool-loop/tool-budget-continuation-policy.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 工具/轮数预算的「进度门控续跑」策略（A）。
+ *
+ * 默认工具预算(DEFAULT_TOOL_BUDGET)和轮数预算(DEFAULT_MAX_ROUNDS)对「建一个完整 app/游戏」这类
+ * 任务偏低,撞上就被迫收尾、任务半成品。本策略把预算从「写死的硬停」改成「软检查点 + 可续跑」:
+ * 预算耗尽时,若本轮窗口**确有进度**(产出了新的成功工具结果)且**没卡在循环里**(AP5 同款:同一文件
+ * 反复读),就再续一个窗口;否则停。续跑次数和绝对硬顶(MAX_*_CAP)双重封顶,杜绝失控。
+ *
+ * 与既有 token 预算续跑(budget-continuation-policy.ts)同构,只是进度信号换成「成功工具调用增量」、
+ * 失控信号换成「读循环」。纯函数,便于单测。
+ */
+/** 一轮 turn 内最多续跑次数 —— 与 token 续跑的 MAX_BUDGET_CONTINUATIONS 对齐。 */
+export declare const MAX_TOOL_BUDGET_CONTINUATIONS = 5;
+export interface ToolBudgetContinuationInput {
+    /** 当前工具调用预算(可能已被前几次续跑抬高过)。 */
+    currentToolBudget: number;
+    /** 当前轮数预算。 */
+    currentRoundBudget: number;
+    /** 工具调用绝对硬顶(失控兜底)。 */
+    toolHardCap: number;
+    /** 轮数绝对硬顶。 */
+    roundHardCap: number;
+    /** 已续跑次数。 */
+    continuationCount: number;
+    /** 上个检查点以来新增的「成功且非空」工具结果数 —— 进度信号。 */
+    successfulSinceLastCheck: number;
+    /** 文件读取计数(AP5 读循环检测,失控信号)。 */
+    fileReadCounts: ReadonlyMap<string, number>;
+    /** 每次续跑给工具预算加的窗口(= DEFAULT_TOOL_BUDGET)。 */
+    windowTools: number;
+    /** 每次续跑给轮数预算加的窗口(= DEFAULT_MAX_ROUNDS)。 */
+    windowRounds: number;
+}
+export interface ToolBudgetContinuationDecision {
+    nextToolBudget: number;
+    nextRoundBudget: number;
+    continuationCount: number;
+}
+/**
+ * 决定是否续跑。返回 null = 不续(应停下并诚实收尾);返回 decision = 续跑(把预算抬到 next*)。
+ *
+ * 停的条件(任一):①续跑次数用满;②两个预算都已到硬顶;③本窗口零进度(没新增成功结果);
+ * ④卡在读循环。其余情况续跑,但每个预算都不超过各自硬顶。
+ */
+export declare function resolveToolBudgetContinuation(input: ToolBudgetContinuationInput): ToolBudgetContinuationDecision | null;

package/dist/types/cli/acp-session-host.d.ts

@@ -28,7 +28,6 @@ export interface AcpSessionHost {
     memoryPrefetchState: ReturnType<typeof createMemoryPrefetchState>;
     sessionHistory: Pick<SessionHistoryCoordinator, "saveResumedSession" | "withResumedHistory">;
     sessionState: SessionState | null;
-    sessionTaskDomain: unknown;
     cancelIdleDreamTimer(): void;
     disposeSessionRuntime?(): void;
     enableIdleDream(): void;

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

@@ -14,12 +14,10 @@ import { SessionState } from "../../runtime/session/session-state.js";
 import { createMemoryPrefetchState } from "../../runtime/hooks/memory-hooks.js";
 import { type AgentRpcError, type AgentRpcErrorCode, type AgentRpcRequest } from "../../protocol/wire/index.js";
 import type { SessionHistoryCoordinator } from "../session-history-coordinator.js";
-import type { TaskDomain } from "../../runtime/prompt/task-domain.js";
 export interface SessionHandlerHost {
     currentSessionId?: string;
     currentModel?: string;
     sessionState?: SessionState | null;
-    sessionTaskDomain?: TaskDomain;
     memoryPrefetchState?: ReturnType<typeof createMemoryPrefetchState>;
     sessionHistory: Pick<SessionHistoryCoordinator, "saveResumedSession">;
     log(message: string): void;

package/dist/types/cli/session-context.d.ts

@@ -14,7 +14,6 @@
  */
 import type { SessionState } from "../runtime/session/session-state.js";
 import type { SessionLlmConfig } from "./acp-session-host.js";
-import type { TaskDomain } from "../runtime/prompt/task-domain.js";
 export declare class SessionContext {
     /** Active session id (chatId for desktop; group key pattern for groups). */
     sessionId: string;
@@ -22,8 +21,6 @@ export declare class SessionContext {
     turnId: string;
     /** Session cost/state snapshot (null until a session is resolved). */
     state: SessionState | null;
-    /** Session-level task domain stickiness — survives across turns within a session. */
-    taskDomain: TaskDomain | undefined;
     /** Host-pinned per-session LLM config (session/set_config_option · set_model · /model).
      *  NEVER wiped by ModelRegistry churn — distinct from the DERIVED ResolvedAgentCache. */
     llmConfig: SessionLlmConfig;

package/dist/types/cli/stdio-acp-request-host.d.ts

@@ -6,7 +6,7 @@ import type { CliAcpRequestHandlerHost } from "./cli-acp-request-handler.js";
  * (`this: any`), so members it touches must be forwarded here explicitly;
  * see TURN_PIPELINE_HOST_MEMBERS for the regression-tested list.
  */
-export type StdioAcpRequestHostSource = Pick<CliAcpRequestHandlerHost, "activeTurn" | "acpSessionMeta" | "currentHooks" | "currentSessionId" | "currentTurnId" | "memoryPrefetchState" | "permissionChecker" | "sessionHistory" | "sessionLlmConfig" | "sessionState" | "sessionTaskDomain" | "cancelIdleDreamTimer" | "disposeSessionRuntime" | "enableIdleDream" | "ensureDefaultProject" | "ensureModelRegistryHydrated" | "getActiveProjectRoot" | "log" | "sendNotification" | "setActiveWorkdir"> & {
+export type StdioAcpRequestHostSource = Pick<CliAcpRequestHandlerHost, "activeTurn" | "acpSessionMeta" | "currentHooks" | "currentSessionId" | "currentTurnId" | "memoryPrefetchState" | "permissionChecker" | "sessionHistory" | "sessionLlmConfig" | "sessionState" | "cancelIdleDreamTimer" | "disposeSessionRuntime" | "enableIdleDream" | "ensureDefaultProject" | "ensureModelRegistryHydrated" | "getActiveProjectRoot" | "log" | "sendNotification" | "setActiveWorkdir"> & {
     currentModel: string | undefined;
     lastAssistantMessageForExtract: string | undefined;
     lastUserMessageForAutoExtract: string | undefined;
@@ -24,5 +24,5 @@ export type StdioAcpRequestHostSource = Pick<CliAcpRequestHandlerHost, "activeTu
 };
 /** Host members the shared turn pipeline reads/writes — keep in sync with
  * `grep -oE "this\.[a-zA-Z]+" src/cli/handlers/turn-handler.ts | sort -u`. */
-export declare const TURN_PIPELINE_HOST_MEMBERS: readonly ["activeTurn", "configureTurnMedia", "currentHooks", "currentModel", "currentTurnId", "drainPendingTaskNotifications", "getActiveProjectRoot", "lastAssistantMessageForExtract", "lastUserMessageForAutoExtract", "log", "mcpReady", "memdir", "pendingAskUser", "permissionChecker", "petRuntime", "projectMemoryStoreFactory", "resolveAgent", "resolveClientForPurpose", "sendNotification", "sendResponse", "sessionHistory", "sessionState", "sessionTaskDomain", "setActiveWorkdir", "toolCatalog"];
+export declare const TURN_PIPELINE_HOST_MEMBERS: readonly ["activeTurn", "configureTurnMedia", "currentHooks", "currentModel", "currentTurnId", "drainPendingTaskNotifications", "getActiveProjectRoot", "lastAssistantMessageForExtract", "lastUserMessageForAutoExtract", "log", "mcpReady", "memdir", "pendingAskUser", "permissionChecker", "petRuntime", "projectMemoryStoreFactory", "resolveAgent", "resolveClientForPurpose", "sendNotification", "sendResponse", "sessionHistory", "sessionState", "setActiveWorkdir", "toolCatalog"];
 export declare function createStdioAcpRequestHandlerHost(host: StdioAcpRequestHostSource): CliAcpRequestHandlerHost;

package/dist/types/cli/stdio-rpc-handler-hosts.d.ts

@@ -10,7 +10,6 @@ type StdioRpcAdapterSource = DirectStdioRpcHost & {
     currentSessionId: NonNullable<RpcHandlerHosts["session"]["currentSessionId"]>;
     currentModel: NonNullable<RpcHandlerHosts["session"]["currentModel"]>;
     sessionState: RpcHandlerHosts["session"]["sessionState"];
-    sessionTaskDomain: RpcHandlerHosts["session"]["sessionTaskDomain"];
     memoryPrefetchState: NonNullable<RpcHandlerHosts["session"]["memoryPrefetchState"]>;
     sessionHistory: RpcHandlerHosts["session"]["sessionHistory"];
     currentHooks: RpcHandlerHosts["dream"]["currentHooks"];

package/dist/types/cli/stdio-server.d.ts

@@ -16,7 +16,6 @@ import { type MemoryPrefetchState } from "../runtime/hooks/memory-hooks.js";
 import { SessionState } from "../runtime/session/session-state.js";
 import { TaskStore } from "../runtime/infra/task-runtime.js";
 import { BackgroundTaskManager } from "../runtime/infra/background-tasks.js";
-import { type TaskDomain } from "../runtime/prompt/task-domain.js";
 import { type AgentRpcError } from "../protocol/wire/index.js";
 import type { AcpServer } from "../transport/acp-server.js";
 import type { NotificationMethod, NotificationMethodMap } from "../protocol/notifications.js";
@@ -109,8 +108,6 @@ export declare class StdioServer {
     set currentTurnId(v: string);
     get sessionState(): SessionState | null;
     set sessionState(v: SessionState | null);
-    get sessionTaskDomain(): TaskDomain | undefined;
-    set sessionTaskDomain(v: TaskDomain | undefined);
     get sessionLlmConfig(): SessionLlmConfig;
     set sessionLlmConfig(v: SessionLlmConfig);
     get acpSessionMeta(): Record<string, unknown> | null;

package/dist/types/cli/turn-lifecycle.d.ts

@@ -7,7 +7,6 @@ export interface TurnLifecycleHost {
     currentSessionId: string;
     currentHooks: HookRegistry | null;
     sessionState: SessionState | null;
-    sessionTaskDomain: unknown;
     memoryPrefetchState: MemoryPrefetchState;
     enableIdleDream(): void;
 }

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

@@ -61,6 +61,8 @@ export interface ChatMessage {
         mimeType?: string;
         size?: number;
     }>;
+    /** UI-facing structured blocks persisted with transcripts; ignored by model transports. */
+    blocks?: Array<Record<string, unknown>>;
 }
 export type ToolCapabilityCategory = "orchestration" | "filesystem" | "web" | "search" | "memory" | "media" | "developer" | "mcp" | "automation" | "system" | "other";
 export interface LocalizedToolText {

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

@@ -13,6 +13,7 @@ export interface FreshWorkspaceEvidencePolicy {
     requiresFreshTool: boolean;
     reason?: "file-read" | "file-mutation" | "memory-mutation" | "media-generation" | "directory-list" | "content-search" | "shell" | "web";
     mediaKind?: "image" | "tts" | "music";
+    workflowKind?: "artifact-index";
     allowedToolNames: string[];
 }
 export declare function getFreshWorkspaceEvidencePolicy(messages: readonly PromptMessageLike[] | string): FreshWorkspaceEvidencePolicy;

package/dist/types/runtime/prompt/index.d.ts

@@ -2,4 +2,4 @@ export { assembleSystemPrompt, clearSystemPromptSections, systemPromptSection, t
 export { PROMPT_POLICY_REGISTRY, PROMPT_POLICY_VERSION, createPromptPolicyHeader, type PromptPolicyRegistry, type PromptPolicyRegistryEntry, } from "./prompt-policy.js";
 export { getInstructions, buildInstructionsPrompt, resetInstructionCache, } from "./instruction-loader.js";
 export { createEnvironmentContextSection, createTaskGuidanceSection, createToolGuidanceSection, createLanguageSection } from "./environment-context.js";
-export { detectTaskDomain, resolveTaskDomain, loadProjectTaskDomain, persistTaskDomain, shouldPersistDomain, type TaskDomain, type DomainResolutionContext } from "./task-domain.js";
+export { detectTaskDomain, resolveTaskDomain, type TaskDomain, type DomainResolutionContext } from "./task-domain.js";

package/dist/types/runtime/prompt/task-domain.d.ts

@@ -1,21 +1,17 @@
 /**
- * Task Domain Detection — three-tier domain resolution for system prompt routing.
+ * Task Domain Detection — selects which system prompt guidance is injected.
  *
- * qlogicagent handles coding, office, AND creative tasks.
- * A coding-only system prompt hurts non-coding performance.
+ * qlogicagent handles coding, office, AND creative tasks; a coding-only prompt
+ * hurts non-coding performance, so the per-domain CONTENT blocks are kept.
  *
- * Resolution priority (highest → lowest):
- *   1. Project file: `.qlogicagent/settings.yaml` → `taskDomain: coding`
- *      Persisted, user-editable, checked into repo. Strongest signal.
- *   2. Host override: `config.taskDomain` in thread.turn params.
- *      Set by Electron/Hub per-request.
- *   3. Session sticky: once a domain is established in a session,
- *      keep it unless a new turn has a STRONG signal for a different domain.
- *   4. Auto-detect: regex keyword matching on the current user message.
- *      Falls back to "general" if ambiguous.
+ * Resolution is STATELESS and recomputed every turn (CC-aligned — no hidden
+ * session/disk state, no stickiness latch, no auto-persisted guesses):
+ *   1. Host override: `config.taskDomain` from thread.turn params (explicit).
+ *   2. Auto-detect: keyword match on the current user message; "general" if ambiguous.
  *
- * The `resolveTaskDomain()` function implements this full chain.
- * The `detectTaskDomain()` function is the low-level keyword matcher (tier 4).
+ * The universal BEHAVIORAL rules (answer-directly, tools-not-default, conciseness)
+ * live in universalGuidance() and apply in every domain, so misclassifying a turn
+ * as "general" degrades only the domain-tailored content, never the core behavior.
  */
 /**
  * Task domain determines which system prompt sections are injected.
@@ -27,56 +23,21 @@
  */
 export type TaskDomain = "coding" | "office" | "creative" | "general";
 /**
- * Load task domain from project-level `.qlogicagent/settings.yaml`.
- * Returns undefined if file doesn't exist or doesn't contain a valid domain.
- *
- * Uses sync I/O — called once per turn, file is tiny (<1KB).
- * Simple key:value parser (no YAML dependency needed for this).
- */
-export declare function loadProjectTaskDomain(cwd: string): TaskDomain | undefined;
-/**
- * Detect task domain from user message text (tier 4 — lowest priority).
- * Uses keyword matching — fast, no LLM call.
+ * Detect task domain from user message text. Keyword matching — fast, no LLM call.
  */
 export declare function detectTaskDomain(userText: string): TaskDomain;
 export interface DomainResolutionContext {
-    /** Current working directory (for project file lookup). */
-    cwd: string;
-    /** Host-provided override from config.taskDomain. */
+    /** Host-provided override from config.taskDomain (explicit, per-request). */
     hostOverride?: TaskDomain;
-    /** Previous session domain (for stickiness). */
-    sessionDomain?: TaskDomain;
     /** Current turn's user message text. */
     userText: string;
 }
 /**
- * Full domain resolution chain — implements the four-tier priority:
- *   1. Project file (.qlogicagent/settings.yaml or INSTRUCTIONS.md frontmatter)
- *   2. Host override (config.taskDomain)
- *   3. Session stickiness (keep previous domain unless strong signal)
- *   4. Auto-detect from keywords
- *
- * Returns both the resolved domain and a "source" tag for debugging.
+ * Resolve task domain, stateless and per-turn: explicit host override, else fresh
+ * keyword auto-detect on this turn's message. No project file, no session stickiness,
+ * no disk persistence.
  */
 export declare function resolveTaskDomain(ctx: DomainResolutionContext): {
     domain: TaskDomain;
-    source: "project-file" | "host-override" | "session-sticky" | "auto-detect";
+    source: "host-override" | "auto-detect";
 };
-/**
- * Persist the detected task domain to `.qlogicagent/settings.yaml`.
- *
- * This runs once per workspace — subsequent sessions skip auto-detect
- * and hit Tier 1 (project file) directly.
- *
- * Conditions for writing:
- *   - `domain` is NOT "general" (ambiguous → don't commit)
- *   - No existing `settings.yaml` with a `taskDomain` line
- *   - The auto-detect score was above the confidence threshold
- *
- * The written file is user-editable and meant to be checked into the repo.
- */
-export declare function persistTaskDomain(cwd: string, domain: TaskDomain): boolean;
-/**
- * Check if auto-detect scored high enough to justify persisting.
- */
-export declare function shouldPersistDomain(userText: string, domain: TaskDomain): boolean;

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

@@ -0,0 +1,9 @@
+export declare function hasLikelyMojibake(text: string): boolean;
+export declare function cleanSessionTitleCandidate(title: string | undefined | null, options?: {
+    maxLength?: number;
+}): string | undefined;
+export declare function titleFromPromptFallback(prompt: string, fallback: string, options?: {
+    maxLength?: number;
+    ellipsis?: string;
+}): string;
+export declare function deterministicSessionTitleForPrompt(prompt: string): string | null;

package/package.json

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