qlogicagent 2.13.10 → 2.14.1

package/dist/types/cli/stdio-runtime-services.d.ts

@@ -7,6 +7,7 @@ import { type PetRuntime } from "./pet-runtime.js";
 import { type TurnMediaSetupHost } from "./turn-media-setup.js";
 export interface StdioRuntimeServicesDeps {
     getActiveProjectRoot(): string;
+    getCurrentSessionId?(): string | undefined;
     resolveClientForPurpose(purpose: import("../runtime/infra/model-registry.js").ModelPurpose): {
         transport: LLMTransport;
         apiKey: string;

package/dist/types/cli/tool-bootstrap-community-registration.d.ts

@@ -1,9 +1,15 @@
 import type { PortableTool } from "../skills/portable-tool.js";
+import { type CommunitySeekAnswerCandidate } from "../skills/tools/community-seek-tool.js";
 import { type CommunityDiscoveryResult } from "../runtime/community/community-discovery-coordinator.js";
+import { type PetActivitySink } from "../runtime/community/pet-activity-sink.js";
 export interface LocalCommunityToolRegistrationContext {
     tools: PortableTool<any>[];
     /** 测试可注入的发现实现;默认从 env consent client 构造协调器。 */
     discover?: (intent: string) => Promise<CommunityDiscoveryResult>;
+    /** 测试可注入的经验答案源;默认经 consent client 调 hub /reviews/search(bge-m3 语义检索)。 */
+    findAnswers?: (intent: string, topK: number) => Promise<CommunitySeekAnswerCandidate[]>;
+    /** 测试可注入的活动发射 sink;默认从 env 解析 actorPetId 构造(无身份→null,不发)。 */
+    petActivitySink?: PetActivitySink | null;
 }
 export declare const localCommunityToolRegistrationModule: import("../runtime/ports/tool-contracts.js").ToolRegistrationModule<LocalCommunityToolRegistrationContext>;
 export declare function registerLocalCommunityTools(context: LocalCommunityToolRegistrationContext): void;

package/dist/types/cli/tool-bootstrap-core-registration.d.ts

@@ -9,7 +9,10 @@ export interface LocalCoreToolRegistrationContext {
     tools: PortableTool<any>[];
     taskToolHooks?: TaskToolHooks;
     backgroundTaskRuntime: BackgroundTaskManager | null;
+    getBackgroundTaskRuntime?: () => BackgroundTaskManager | null;
+    getTaskScopeKey?: () => string | undefined;
     askUserCallback: ((questions: AskUserQuestion[]) => Promise<Record<string, string> | null>) | null;
+    getAskUserCallback?: () => ((questions: AskUserQuestion[]) => Promise<Record<string, string> | null>) | null;
     onExecProgress?: (progress: ExecProgress) => void;
     getCwd(): string;
     activeProjectRoot(): string;

package/dist/types/cli/tool-bootstrap-media-registration.d.ts

@@ -1,8 +1,10 @@
 import type { PortableTool } from "../skills/portable-tool.js";
+import type { MediaPersistence } from "../runtime/infra/media-persistence.js";
 export interface LocalMediaToolRegistrationContext {
     tools: PortableTool<any>[];
     getCwd(): string;
     activeProjectRoot(): string;
+    mediaPersistence?: MediaPersistence;
 }
 export declare const localMediaToolRegistrationModule: import("../runtime/ports/tool-contracts.js").ToolRegistrationModule<LocalMediaToolRegistrationContext>;
 export declare function registerLocalMediaTools(context: LocalMediaToolRegistrationContext): void;

package/dist/types/cli/tool-bootstrap.d.ts

@@ -4,6 +4,7 @@ import type { TaskToolHooks } from "../skills/tools/task-tool.js";
 import type { ExecProgress } from "../skills/tools/exec-tool.js";
 import type { BackgroundTaskManager } from "../runtime/infra/background-tasks.js";
 import type { ModelPurpose } from "../runtime/infra/model-registry.js";
+import type { MediaPersistence } from "../runtime/infra/media-persistence.js";
 import type { LLMTransport } from "./provider-core-facade.js";
 import type { AgentLogger } from "../agent/types.js";
 import type { AskUserQuestion } from "../skills/tools/ask-user-tool.js";
@@ -42,6 +43,7 @@ export interface BootstrapConfig {
     workdir?: string;
     toolCatalog?: ToolCatalog;
     pathService?: PathService;
+    mediaPersistence?: MediaPersistence;
     log?: AgentLogger;
     /** Called during foreground shell execution with incremental progress. */
     onExecProgress?(progress: ExecProgress): void;
@@ -51,6 +53,7 @@ export interface BootstrapConfig {
         apiKey: string;
         model: string;
     } | null;
+    getTaskScopeKey?(): string | undefined;
 }
 /**
  * Create all locally-executable tools and install into centralized tool pool.

package/dist/types/orchestration/agent-instance.d.ts

@@ -14,7 +14,7 @@
 import type { AgentProcessManager } from "../runtime/infra/agent-process.js";
 import type { AcpDetector } from "../runtime/infra/acp-detector.js";
 import type { AgentConfigStore } from "../runtime/infra/agent-config-store.js";
-import type { ProductCreateParams, ProductStatus, ProductSummary } from "../protocol/wire/acp-agent-management.js";
+import type { ProductPhase, ProductCreateParams, ProductStatus, ProductSummary } from "../protocol/wire/acp-agent-management.js";
 import type { DagMutation } from "./product-planner.js";
 import type { ProductLeaderCoordinator } from "./product-run-coordinator.js";
 export type { ProductLeaderCoordinator } from "./product-run-coordinator.js";
@@ -28,7 +28,7 @@ export interface ProductCallbacks {
     onTaskFailed?: (productId: string, taskId: string, error: string) => void;
     onCheckpointed?: (productId: string, timestamp: string) => void;
     onBudgetWarning?: (productId: string, usedTokens: number, maxTotalTokens: number, percentage: number) => void;
-    onCompleted?: (productId: string, summary: string) => void;
+    onCompleted?: (productId: string, summary: string, phase: Extract<ProductPhase, "completed" | "failed">) => void;
     /** DAG topology resolved and sent to client for visualization. */
     onDagTopology?: (productId: string, nodes: {
         id: string;
@@ -69,6 +69,7 @@ export declare class ProductOrchestrator {
     rollback(productId: string, _checkpoint: string): Promise<void>;
     /** Get product status. */
     getStatus(productId: string): ProductStatus | null;
+    getPersistedStatus(productId: string, cwd?: string): Promise<ProductStatus | null>;
     /** List all products (in-memory + on-disk). */
     list(cwd?: string): Promise<ProductSummary[]>;
     private scheduleNext;

package/dist/types/orchestration/product-worktree.d.ts

@@ -6,6 +6,8 @@ export declare function findGitRoot(cwd: string): Promise<string | null>;
 /** Create an isolated git worktree. Returns the worktree path. */
 export declare function createWorktree(gitRoot: string, name: string, baseBranch?: string): Promise<string>;
 export declare function getWorktreeDiff(worktreePath: string): Promise<string>;
+/** Copy the changed files from a task worktree back into the product workspace. */
+export declare function materializeWorktreeChanges(worktreePath: string, targetRoot: string): Promise<void>;
 /** Remove a git worktree. */
 export declare function removeWorktree(gitRoot: string, path: string): Promise<void>;
 /** Merge a worktree branch into the current branch. */

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

@@ -18,12 +18,12 @@ export declare const AGENT_WS_EVENT_NAMES: readonly ["turn.start", "turn.delta",
  * 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.checkpointed", "product.dagTopology", "plan.interrupted"];
+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"];
 /**
  * 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.checkpointed", "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_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"];
 /** 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

@@ -27,7 +27,7 @@ export interface ProjectInfo {
     groupId?: string;
     createdAt: string;
     updatedAt: string;
-    planStatus?: "creating" | "running" | "completed" | "cancelled";
+    planStatus?: "creating" | "running" | "completed" | "failed" | "cancelled";
     planAgents?: string[];
     planWinnerId?: string;
     leaderSessionId?: string;
@@ -124,6 +124,7 @@ export interface GatewayRpcMethodMap {
                 groupKey?: string;
                 groupPlatform?: string;
                 lastActiveAt?: string;
+                messageCount: number;
                 pinnedAt?: string | null;
                 archivedAt?: string | null;
                 projectId: string;
@@ -142,6 +143,7 @@ export interface GatewayRpcMethodMap {
                 groupKey?: string;
                 groupPlatform?: string;
                 lastActiveAt?: string;
+                messageCount?: number;
                 pinnedAt?: string | null;
                 archivedAt?: string | null;
             } | null;
@@ -299,7 +301,7 @@ export interface GatewayRpcMethodMap {
     "project.update": {
         params: {
             projectId: string;
-            planStatus?: "creating" | "running" | "completed" | "cancelled";
+            planStatus?: "creating" | "running" | "completed" | "failed" | "cancelled";
             planAgents?: string[];
             planWinnerId?: string;
             leaderSessionId?: string;

package/dist/types/runtime/community/activity-event-emitter.d.ts

@@ -1,5 +1,6 @@
 import { type ActivityEvent, type CreateActivityEventInput } from "./activity-event.js";
 import { type CommunityConsentClient } from "./community-consent-client.js";
+import type { ConfigPort } from "../ports/index.js";
 export type ActivityEmitStatus = "emitted" | "disabled" | "consent-blocked" | "failed";
 /** 活动事件出口:真实实现把事件写入 community-service(社交通道,非权威)。 */
 export interface ActivityEventTransport {
@@ -22,3 +23,9 @@ export declare function createHubActivityTransport(client: Pick<CommunityConsent
  * 无 token(dev)→ client null → transport null(emit 返回 "disabled",fail-safe)。
  */
 export declare function createDefaultActivityEventEmitter(): ActivityEventEmitter;
+/**
+ * 解析本 agent 自己的 actorPetId = derivePetKey(owner, device)(Cut7/#1)。
+ * owner=QLOGIC_LLMROUTER_USER_ID、device=QLOGIC_LLMROUTER_DEVICE_ID(gateway 经 buildQlogicagentLlmrouterEnv 注入)。
+ * 缺料(未登录/dev)→ null:调用方应跳过发射(fail-soft,绝不因社交写挂任务)。
+ */
+export declare function resolveSelfActorPetId(configPort?: ConfigPort): string | null;

package/dist/types/runtime/community/activity-event.d.ts

@@ -1,7 +1,9 @@
 export type TrustSignalEventType = "installed" | "success" | "fail" | "error" | "kept" | "uninstalled" | "endorse";
 export type ExperientialEventType = "acquire" | "ask" | "answer" | "encounter" | "review";
 export type FlauntEventType = "unlock" | "flaunt";
-export type ActivityEventType = TrustSignalEventType | ExperientialEventType | FlauntEventType;
+/** 浏览/搜索族(Cut7/M5:agent 搜资源 → 宠物到该区"逛")。非 trust-signal;community 可见走 encounter 闸。 */
+export type BrowseEventType = "search";
+export type ActivityEventType = TrustSignalEventType | ExperientialEventType | FlauntEventType | BrowseEventType;
 /**
  * 空间锚点:agent 发射时本就持有 resourceId 与其 category,事件自带锚点让集市
  * 端零反查地把微动画钉到正确街区 / 店铺。**只允许 districtId / shopId。**

package/dist/types/runtime/community/community-consent-client.d.ts

@@ -42,6 +42,8 @@ export interface CommunityConsentClient {
     emitActivity?(event: ActivityEvent): Promise<void>;
     /** Cut4: author an agent review for a resource (social channel). Optional for mocks. */
     recordCommunityReview?(input: CommunityReviewInput): Promise<void>;
+    /** Cut4: semantic-search peer agent experiences (bge-m3 over community_review) → community_seek answer family. Optional for mocks. */
+    findReviewAnswers?(query: string, topK?: number): Promise<CommunityReviewAnswer[]>;
     /** Cut4: post a help request to the community (social channel). Optional for mocks. */
     recordCommunityAsk?(input: CommunityAskInput): Promise<void>;
     /** Cut4: answer a peer's help request (social channel). Optional for mocks. */
@@ -89,6 +91,8 @@ export interface CommunityRegistryMatchResult {
     type: string;
     title: string;
     summary: string;
+    /** RESOURCE_CATEGORIES key(search 表演锚点;hub match 返回 ResourceView.category)。 */
+    category: string | null;
     capabilityTags: string[];
     sourceTier: CommunityInstallSourceTier;
     trustStage: CommunityInstallTrustStage;
@@ -134,6 +138,16 @@ export interface CommunityReviewInput {
     contextCategory?: string;
     ts: number;
 }
+/** Cut4 经验答案(community_seek 答案族源):hub /reviews/search 的 bge-m3 语义检索结果。 */
+export interface CommunityReviewAnswer {
+    id: string;
+    resourceId: string;
+    actorPetId: string;
+    experience: string;
+    outcome: "success" | "fail" | "neutral";
+    contextCategory: string | null;
+    ts: number;
+}
 /** Cut4 求助频道:agent 发求助帖。question 须已脱敏(R24)。 */
 export interface CommunityAskInput {
     id: string;

package/dist/types/runtime/community/pet-activity-sink.d.ts

@@ -0,0 +1,36 @@
+import { type ActivityEventType, type ActivitySpatialAnchor } from "./activity-event.js";
+import { type ActivityEmitStatus, type ActivityEventEmitter } from "./activity-event-emitter.js";
+import { type CommunityConsentClient } from "./community-consent-client.js";
+import type { ConfigPort } from "../ports/config-port.js";
+/** 一条要发射的活动:类型 + 空间锚点(街区/店铺)+ 可选对端 + 敏感度。actorPetId/ts/id 由 sink 注入。 */
+export interface PetActivityInput {
+    type: ActivityEventType;
+    anchor?: ActivitySpatialAnchor;
+    peerRef?: string;
+    /** 高敏感内容 → 升级问人,不自动外发(DR3);默认 false。 */
+    highSensitivity?: boolean;
+}
+export type PetActivityEmitStatus = ActivityEmitStatus | "escalate";
+export interface PetActivitySink {
+    /** 发一条活动事件。绝不抛(任何失败都 best-effort 吞掉)。 */
+    emit(input: PetActivityInput): Promise<PetActivityEmitStatus>;
+}
+export interface PetActivitySinkDeps {
+    actorPetId: string;
+    consent: Pick<CommunityConsentClient, "getConsent">;
+    emitter: ActivityEventEmitter;
+    now: () => number;
+    newId: () => string;
+}
+/** 纯逻辑 sink(可注入,供测试)。游历闸定 visibility,emitter 落库。 */
+export declare function createPetActivitySink(deps: PetActivitySinkDeps): PetActivitySink;
+/**
+ * 由 (owner,device) 派生本 agent 自家宠物的 actorPetId。env 由 gateway 注入。
+ * 缺 owner/device(dev / 未登录)→ null(无身份不发,fail-safe)。
+ */
+export declare function resolveActorPetId(configPort?: ConfigPort): string | null;
+/**
+ * 默认 sink:从 env 解析 actorPetId + 构造 consent/transport。
+ * 无身份 / 无 token(dev)→ null(调用方 ?.emit 即 no-op,fail-safe 不发)。
+ */
+export declare function createDefaultPetActivitySink(configPort?: ConfigPort): PetActivitySink | null;

package/dist/types/runtime/config/tunable-defaults.d.ts

@@ -23,6 +23,8 @@ export declare const DEFAULT_TEMPERATURE = 0;
 export declare const MAX_TOOL_BUDGET_CAP = 100;
 /** Default tool budget per round. Overridable via TOOL_LOOP_DEFAULT_BUDGET env. */
 export declare const DEFAULT_TOOL_BUDGET: number;
+/** Foreground tool execution deadline in ms. Long jobs should use background tasks. */
+export declare const DEFAULT_TOOL_EXECUTION_TIMEOUT_MS: number;
 /** Max consecutive tool call failures before early exit. */
 export declare const MAX_CONSECUTIVE_FAILURES = 3;
 /** Max times the exact same (tool_name, arguments) pair can repeat. */
@@ -179,6 +181,7 @@ export interface TunableDefaults {
     defaultTemperature: number;
     maxToolBudgetCap: number;
     defaultToolBudget: number;
+    defaultToolExecutionTimeoutMs: number;
     maxConsecutiveFailures: number;
     maxIdenticalCallRepeats: number;
     defaultContextWindowTokens: number;

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

@@ -35,6 +35,8 @@ export interface StreamingToolExecutorConfig {
     concurrencySafeTools?: Set<string>;
     /** Hard ceiling on simultaneous tool executions (0 = unlimited). CC parity. */
     maxConcurrentTools?: number;
+    /** Per foreground tool deadline. 0 or undefined means no executor deadline. */
+    maxExecutionMs?: number;
 }
 /**
  * Executes tools with concurrency control and streaming progress.
@@ -99,4 +101,5 @@ export declare class StreamingToolExecutor {
     private hasCompletedResults;
     private hasExecutingTools;
     private hasUnfinishedTools;
+    private invokeToolWithDeadline;
 }

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

@@ -99,6 +99,19 @@ export interface AgentProcessHandle {
     lastActivityAt?: number;
     /** Whether the ACP agent supports session/resume (D-1). */
     supportsResume?: boolean;
+    /** ACP session/update types observed during the current external-agent prompt. */
+    acpUpdateTypes?: string[];
+    /** Stderr log path for this agent process, when diagnostics logging is enabled. */
+    stderrLogPath?: string;
+    /** Sanitized external ACP launch details for empty-output diagnostics. */
+    acpLaunchDiagnostics?: {
+        cliPath: string;
+        acpArgs: string[];
+        cwd: string;
+        env: string;
+    };
+    /** Last external ACP prompt elapsed time in milliseconds. */
+    acpLastPromptElapsedMs?: number;
 }
 /** Callbacks for process lifecycle events. */
 export interface AgentProcessCallbacks {
@@ -127,6 +140,7 @@ export interface AgentProcessCallbacks {
     /** Session directory for stderr logs. If set, ACP agent stderr is written to {sessionDir}/{agentId}.stderr.log. */
     sessionDir?: string;
 }
+export declare function ensureLoopbackNoProxy(env: Record<string, string>): Record<string, string>;
 /**
  * Build LLM-related environment variables for an external ACP teammate.
  *
@@ -149,6 +163,7 @@ export declare const ACP_FAULT_LEVEL: {
     readonly WARN: "warn";
 };
 export type AcpFaultLevel = (typeof ACP_FAULT_LEVEL)[keyof typeof ACP_FAULT_LEVEL];
+export declare function sanitizeAgentLogFileName(memberId: string): string;
 /**
  * Manages a pool of child agent processes.
  * Each child is a `qlogicagent` subprocess using JSON-RPC over stdio.
@@ -171,6 +186,7 @@ export declare class AgentProcessManager {
         sessionId?: string;
         timeout?: number;
     }): Promise<unknown>;
+    private buildExternalPromptDiagnostics;
     /** Send a raw JSON-RPC request to a child. */
     sendRpc(memberId: string, method: string, params?: unknown, timeoutMs?: number): Promise<unknown>;
     /**

package/dist/types/runtime/infra/codex-llmrouter-compat-proxy.d.ts

@@ -0,0 +1,4 @@
+export declare function filterCodexResponsesTools(body: unknown): unknown;
+export declare function ensureCodexLlmrouterCompatProxy(upstreamBaseUrl: string): Promise<string>;
+export declare function resetCodexLlmrouterCompatProxyForTests(): Promise<void>;
+export declare function setCodexLlmrouterCompatProxyDiagnosticPathForTests(path: string): void;

package/dist/types/runtime/infra/media-persistence.d.ts

@@ -28,6 +28,10 @@ export interface MediaDownloadResult {
     bytes: number;
     /** MIME type (from Content-Type header). */
     mimeType: string;
+    /** First bytes of the saved file as uppercase hex pairs. */
+    headerHex?: string;
+}
+export interface MediaSaveResult extends MediaDownloadResult {
 }
 export interface MediaPersistenceConfig {
     /**
@@ -79,6 +83,19 @@ export declare class MediaPersistence {
     }, log?: {
         warn: (msg: string) => void;
     }): Promise<MediaDownloadResult[]>;
+    /**
+     * Persist generated media to caller-requested artifact paths.
+     *
+     * This complements project-level archival downloads: generated assets remain
+     * previewable in assets/images, while explicit user deliverables are also
+     * written to their requested paths.
+     */
+    saveAllToPaths(urls: string[], outputPaths: string[], hint?: {
+        type?: string;
+        sessionId?: string;
+    }, log?: {
+        warn: (msg: string) => void;
+    }): Promise<MediaSaveResult[]>;
     /** Get the project-level assets root (<project>/assets). */
     getMediaDir(): string;
     /** Get the project directory (for testing/inspection). */

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

@@ -38,6 +38,7 @@ export interface StreamingToolExecutorPortConfig {
     log: AgentLogger;
     signal?: AbortSignal;
     maxConcurrentTools?: number;
+    maxExecutionMs?: number;
 }
 export interface ContextCompressionEnginePort {
     compressAsync(messages: RuntimeCompressibleMessage[], budget: number, context: {

package/dist/types/runtime/ports/tool-contracts.d.ts

@@ -1,4 +1,5 @@
 import type { ToolDefinition } from "../../protocol/wire/index.js";
+import type { MediaPersistence } from "../infra/media-persistence.js";
 import type { PathService } from "./path-service.js";
 import type { PermissionRiskLevel } from "./permission-contracts.js";
 export interface RuntimeToolContract {
@@ -58,12 +59,14 @@ export interface ToolBootstrapConfig {
     workdir?: string;
     toolCatalog?: ToolCatalog;
     pathService?: PathService;
+    mediaPersistence?: MediaPersistence;
     log?: {
         info(message: string): void;
         warn(message: string): void;
         error(message: string): void;
         debug(message: string): void;
     };
+    getTaskScopeKey?(): string | undefined;
     onExecProgress?(progress: ToolBootstrapProgress): void;
 }
 export interface ToolBootstrap {

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

@@ -17,5 +17,6 @@ export interface FreshWorkspaceEvidencePolicy {
 }
 export declare function getFreshWorkspaceEvidencePolicy(messages: readonly PromptMessageLike[] | string): FreshWorkspaceEvidencePolicy;
 export declare function isLightweightChatTurn(messages: readonly PromptMessageLike[] | string): boolean;
+export declare function isExplicitNoToolTurn(messages: readonly PromptMessageLike[] | string): boolean;
 export declare function selectFreshWorkspaceEvidenceTools<TTool extends ToolNameLike>(tools: readonly TTool[], policy: FreshWorkspaceEvidencePolicy): TTool[];
 export declare function createFreshWorkspaceEvidenceSection(policy: FreshWorkspaceEvidencePolicy): SystemPromptSection | null;

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

@@ -0,0 +1,4 @@
+export declare function markSessionDeleted(sessionId: string, projectRoot: string): Promise<void>;
+export declare function isSessionDeleted(sessionId: string, projectRoot: string): Promise<boolean>;
+export declare function isSessionDeletedSync(sessionId: string, projectRoot: string): boolean;
+export declare function listDeletedSessionIds(projectRoot: string): Promise<string[]>;

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

@@ -8,6 +8,7 @@ export declare function appendMessage(sessionId: string, message: ChatMessage, p
     usage?: TokenUsage;
     displayMetadata?: MessageDisplayMetadata;
 }): Promise<boolean>;
+export declare function countTranscriptMessages(sessionId: string, projectRoot: string): Promise<number | null>;
 export declare function loadTranscript(sessionId: string, projectRoot: string, options?: {
     includeDisplayMetadata?: boolean;
 }): Promise<TranscriptLoadResult | null>;

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

@@ -1,2 +1,3 @@
 export declare function withSessionWriteLimit<T>(fn: () => Promise<T>): Promise<T>;
 export declare function withTranscriptAppendOrder<T>(sessionKey: string, fn: () => Promise<T>): Promise<T>;
+export declare function waitForTranscriptAppends(sessionKey: string): Promise<void>;

package/dist/types/skills/tools/community-seek-tool.d.ts

@@ -49,6 +49,15 @@ export interface CommunitySeekDeps {
     findAnswers?(intent: string, topK: number): Promise<CommunitySeekAnswerCandidate[]>;
     /** 轻回执 sink(对话侧渲染);best-effort,抛错不影响工具结果。 */
     onReceipt?(receipt: CommunitySeekReceipt): void;
+    /**
+     * 「去社区张罗到了」→ 发一条 acquire ActivityEvent(父总纲 Cut1「落…一条 ActivityEvent」):
+     * 自家宠物现身于命中资源的店铺/街区。anchor 只给 shopId(店铺=canonical resourceId);
+     * 街区由集市端按 layout 反解。best-effort fire-and-forget,抛错/未配置都不影响工具结果。
+     */
+    onAcquire?(anchor: {
+        shopId?: string;
+        districtId?: string;
+    }): void;
 }
 export declare function toPackageCandidate(match: CommunityRegistryMatchResult): CommunitySeekPackageCandidate;
 export declare function runCommunitySeek(deps: CommunitySeekDeps, params: CommunitySeekParams): Promise<CommunitySeekResult>;

package/dist/types/skills/tools/file-tool-arguments.d.ts

@@ -0,0 +1,5 @@
+import type { PortableToolResult } from "../portable-tool.js";
+export declare function missingRequiredStringParam(params: Record<string, unknown>, field: string, options?: {
+    allowEmpty?: boolean;
+}): string | null;
+export declare function invalidFileToolArguments(type: "read" | "write" | "edit", message: string): PortableToolResult;

package/dist/types/skills/tools/image-generate-tool.d.ts

@@ -6,6 +6,8 @@ export interface ImageGenerateToolParams {
     style?: string;
     size?: string;
     image_url?: string;
+    output_path?: string;
+    output_paths?: string[];
     n?: number;
     quality?: string;
     seed?: number;
@@ -33,6 +35,17 @@ export declare const IMAGE_GENERATE_TOOL_SCHEMA: {
             readonly type: "string";
             readonly description: string;
         };
+        readonly output_path: {
+            readonly type: "string";
+            readonly description: "Optional absolute or workspace-relative path where the generated image should be saved. Use only for a single generated image.";
+        };
+        readonly output_paths: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+            readonly description: "Optional absolute or workspace-relative paths where generated images should be saved. Must match the number of generated images.";
+        };
         readonly n: {
             readonly type: "number";
             readonly description: "Number of images to generate (1-4). Default: 1.";
@@ -54,6 +67,13 @@ export interface ImageGenerateResult {
     size?: string;
     durationMs?: number;
 }
+export interface SavedGeneratedImage {
+    remoteUrl: string;
+    localPath: string;
+    bytes: number;
+    mimeType: string;
+    headerHex?: string;
+}
 /** Deps injected by the host runtime for image generation. */
 export interface ImageGenerateToolDeps {
     /**
@@ -70,5 +90,9 @@ export interface ImageGenerateToolDeps {
         quality?: string;
         seed?: number;
     }): Promise<ImageGenerateResult>;
+    saveGeneratedImages?(params: {
+        mediaUrls: string[];
+        outputPaths: string[];
+    }): Promise<SavedGeneratedImage[]>;
 }
 export declare function createImageGenerateTool(deps: ImageGenerateToolDeps): PortableTool<ImageGenerateToolParams>;

package/dist/types/skills/tools/read-tool.d.ts

@@ -34,6 +34,8 @@ export interface ReadToolDeps {
         type: "image";
         localPath: string;
         mimeType: string;
+        sizeBytes?: number;
+        headerHex?: string;
     } | {
         type: "binary";
         mimeType: string;

package/dist/types/skills/tools/shell/host-paths.d.ts

@@ -0,0 +1,2 @@
+export declare function normalizeHostPath(input: string): string;
+export declare function isWindowsHostPath(input: string): boolean;

package/dist/types/skills/tools/task-tool.d.ts

@@ -28,6 +28,8 @@ export interface RuntimeTaskView {
 export interface TaskToolRuntimeDeps {
     /** Live accessor — the registry is bound by the host after bootstrap. */
     getRuntime(): TaskRuntimeAccess | null;
+    /** Current chat/session scope. Checklist state is isolated by this key. */
+    getScopeKey?(): string | undefined;
 }
 export type TaskStatus = "not-started" | "in-progress" | "completed";
 export declare const TASK_STATUS_VALUES: readonly TaskStatus[];

package/dist/types/skills/tools/team-tool.d.ts

@@ -114,10 +114,6 @@ export interface TeamSendResult {
         reply: string;
     }>;
 }
-/**
- * Host-provided team management backend.
- * Creates agent teams whose members are messaged via the send action.
- */
 export interface TeamToolDeps {
     createTeam(params: {
         teamName: string;

package/dist/vendor/hatch-pet/scripts/prepare_pet_run.py

@@ -137,8 +137,11 @@ STYLE_PRESETS = {
         "clear silhouette, and no photoreal complexity."
     ),
     "painterly": (
-        "Painterly mascot with simplified brush texture, readable forms, stable "
-        "palette, and enough edge clarity for clean extraction."
+        "Painterly anime/JRPG fantasy mascot: soft cel-and-brush shading with "
+        "smooth gradients (NOT pixel art, no visible pixels or dithering), warm "
+        "bright storybook palette, gentle rim light, rounded readable forms, clear "
+        "silhouette, and enough edge clarity for clean chroma-key extraction. "
+        "Matches a lush daytime fantasy town-market art style."
     ),
     "brand-inspired": (
         "Brand-inspired mascot using approved public or user-provided brand cues "
@@ -671,9 +674,10 @@ def main() -> None:
     )
     parser.add_argument(
         "--style-preset",
-        default="auto",
+        default="painterly",
         choices=sorted(STYLE_PRESETS),
-        help="Pet-safe style preset to use across the base and all animation rows.",
+        help="Pet-safe style preset across base + all rows. Default 'painterly' (厚涂,和集市城镇同框协调);"
+        " 'auto' 由请求/参考图推断,其余见 STYLE_PRESETS。",
     )
     parser.add_argument("--style-notes", default="")
     parser.add_argument(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlogicagent",
-  "version": "2.13.10",
+  "version": "2.14.1",
   "description": "XiaozhiClaw Agent CLI — subprocess architecture (JSON-RPC over stdio)",
   "type": "module",
   "main": "dist/index.js",
@@ -90,7 +90,7 @@
     "@agentclientprotocol/sdk": "^0.25.0",
     "@napi-rs/canvas": "0.1.100",
     "@xiaozhiclaw/pet-core": "0.1.1",
-    "@xiaozhiclaw/provider-core": "^0.1.14",
+    "@xiaozhiclaw/provider-core": "^0.1.15",
     "better-sqlite3": "^12.10.0",
     "dotenv": "^17.3.1",
     "ioredis": "^5.11.1",