qlogicagent 2.10.22 → 2.10.23

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

@@ -8,9 +8,10 @@
  *   import type { AgentRpcMethodMap } from "qlogicagent/protocol";
  *   async function call<M extends keyof AgentRpcMethodMap>(method: M, params: AgentRpcMethodMap[M]["params"]): Promise<AgentRpcMethodMap[M]["result"]> { ... }
  */
-import type { ChatMessage, ToolDefinition } from "./chat-types.js";
+import type { ChatMessage, LocalizedToolText, ToolCapabilityCategory, ToolDefinition } from "./chat-types.js";
 import type { GatewayRpcMethodMap } from "./gateway-rpc.js";
 import type { WireTokenUsage } from "./notification-payloads.js";
+import type { ToolApprovalResponseParams } from "./agent-rpc.js";
 export type AgentCategory = "sub-agent" | "teammate";
 export type AgentProtocol = "internal" | "acp";
 export type AgentStatus = "available" | "unavailable" | "handshake_failed" | "not_installed";
@@ -80,7 +81,7 @@ export interface SoloStatus {
     };
 }
 export type ProductPhase = "active" | "paused" | "completed" | "failed";
-export type ProductTaskStatus = "pending" | "running" | "completed" | "failed" | "paused";
+export type ProductTaskStatus = "pending" | "running" | "completed" | "failed" | "paused" | "skipped";
 export interface ProductInstanceDef {
     name: string;
     role: string;
@@ -339,17 +340,24 @@ export interface AgentRpcMethodMap extends GatewayRpcMethodMap {
     };
     "tools.list": {
         params: {
-            category?: string;
-            includeDisabled?: boolean;
+            category?: ToolCapabilityCategory;
+            includeDeferred?: boolean;
         };
         result: {
             tools: Array<{
+                id: string;
                 name: string;
+                category: ToolCapabilityCategory;
+                displayName: LocalizedToolText;
+                displayDescription: LocalizedToolText;
+                fallbackName: string;
+                fallbackDescription: string;
                 description: string;
-                category: string;
-                enabled: boolean;
+                source: "builtin";
+                deferred: boolean;
                 parameters?: Record<string, unknown>;
             }>;
+            total: number;
         };
     };
     "media.listModels": {
@@ -438,11 +446,7 @@ export interface AgentRpcMethodMap extends GatewayRpcMethodMap {
         };
     };
     "tool.approval.response": {
-        params: {
-            approvalId: string;
-            approved: boolean;
-            message?: string;
-        };
+        params: ToolApprovalResponseParams;
         result: {
             received: boolean;
         };

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

@@ -99,6 +99,17 @@ export interface ToolApprovalResponseParams {
     approvalId: string;
     /** User's decision. */
     decision: "allow-once" | "allow-session" | "allow-always" | "deny";
+    /** Optional tool name, used to create a persistent rule for allow-always. */
+    toolName?: string;
+    /** Optional corrected tool input after user review. */
+    updatedInput?: Record<string, unknown>;
+    /** Optional persistent rule update to save after approval. */
+    permissionUpdate?: {
+        pattern: string;
+        behavior: "allow" | "ask" | "deny";
+        scope?: "session" | "persistent";
+        description?: string;
+    };
 }
 /** Well-known method names for the approval protocol. */
 export declare const AGENT_RPC_APPROVAL_METHODS: {

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

@@ -60,6 +60,12 @@ export interface ChatMessage {
         size?: number;
     }>;
 }
+export type ToolCapabilityCategory = "orchestration" | "filesystem" | "web" | "search" | "memory" | "media" | "developer" | "mcp" | "automation" | "system" | "other";
+export interface LocalizedToolText {
+    key: string;
+    fallback: string;
+    values?: Partial<Record<string, string>>;
+}
 /**
  * Tool definition — wire format as sent over JSON-RPC.
  *
@@ -75,6 +81,9 @@ export interface ToolDefinition {
     };
     /** Tool scheduling metadata from host manifest (optional). */
     meta?: {
+        category?: ToolCapabilityCategory;
+        displayName?: LocalizedToolText;
+        displayDescription?: LocalizedToolText;
         serialOnly?: boolean;
         parallelSafe?: boolean;
         /** If true, host should request user approval before execution. */

package/dist/types/protocol/wire/gateway-rpc.d.ts

@@ -12,6 +12,12 @@
  */
 export type ProjectType = "default" | "personal" | "group" | "solo" | "product";
 export type ProjectStatus = "active" | "archived";
+export interface LocalizedTextWire {
+    key: string;
+    fallback: string;
+    values?: Record<string, string>;
+}
+export type CapabilityCategoryWire = "orchestration" | "filesystem" | "web" | "search" | "memory" | "media" | "developer" | "mcp" | "automation" | "system" | "other";
 export interface ProjectInfo {
     id: string;
     name: string;
@@ -433,10 +439,17 @@ export interface GatewayRpcMethodMap {
         };
         result: {
             skills: Array<{
+                id: string;
                 name: string;
                 path: string;
                 active: boolean;
                 scope: "project" | "global";
+                category: CapabilityCategoryWire;
+                displayName: LocalizedTextWire;
+                displayDescription: LocalizedTextWire;
+                fallbackName: string;
+                fallbackDescription: string;
+                systemGenerated: boolean;
                 version?: string;
                 description?: string;
             }>;

package/dist/types/protocol/wire/index.d.ts

@@ -1,8 +1,9 @@
 export { AGENT_RPC_APPROVAL_METHODS, AGENT_RPC_ERROR_CODES, AGENT_RPC_PROTOCOL_VERSION, isAgentRpcNotification, isAgentRpcRequest, isAgentRpcResponse, parseAgentRpcMessage, type AgentHelloParams, type AgentHelloResult, type AgentRpcError, type AgentRpcErrorCode, type AgentRpcMeta, type AgentRpcChannel, type AgentRpcMessage, type AgentRpcNotification, type AgentRpcRequest, type AgentRpcResponse, type ToolApprovalRequestParams, type ToolApprovalResponseParams, } from "./agent-rpc.js";
 export { GatewayRpcContract, buildAgentRpcMeta, classifyGatewayRpcMethod, requireGatewayRpcMeta, requiresIdempotencyKey, type GatewayRpcClassification, type GatewayRpcMetrics, type GatewayRpcMutability, } from "./gateway-contract.js";
 export { GATEWAY_RPC_METHODS, type AgentCall, type AgentCallOptions, type GatewayRpcMethodMap, type ProjectInfo as RpcProjectInfo, type ProjectStatus as RpcProjectStatus, type ProjectType as RpcProjectType, } from "./gateway-rpc.js";
-export { type ChatMessage, type ChatMessageRole, type ThinkingBlock, type ToolCallMessage, type ToolDefinition, } from "./chat-types.js";
+export { type ChatMessage, type ChatMessageRole, type LocalizedToolText, type ThinkingBlock, type ToolCapabilityCategory, type ToolCallMessage, type ToolDefinition, } from "./chat-types.js";
 export { type AgentCapabilities, type AgentCategory, type AgentConfig, type AgentDescriptor, type AgentProtocol, type AgentRpcMethodMap, type AgentStatus, type CustomAgentDef, type ProductInstanceDef, type ProductPhase, type ProductStatus, type ProductSummary, type ProductTaskDef, type ProductTaskStatus, type SoloAgentResult, type SoloAgentState, type SoloState, type SoloStatus, } from "./agent-methods.js";
+export type * from "./acp-agent-management.js";
 export { AGENT_TEAM_WS_EVENT_NAMES, AGENT_WS_EVENT_NAMES, ALL_AGENT_WS_EVENT_NAMES, type AgentTeamWsEventName, type AgentWsEventName, type AllAgentWsEventName, } from "./agent-events.js";
 export { type AgentSource, type AgentsErrorNotification, type AgentsStatusNotification, type ArtifactType, type MediaResultType, type MemoryDecayCompletedNotification, type MemoryUpdatedNotification, type NotificationMethod, type NotificationMethodMap, type NotificationThreadItem, type PermissionRuleUpdatedNotification, type PlanInterruptedNotification, type PongNotification, type ProductBudgetUpdateNotification, type ProductBudgetWarningNotification, type ProductCheckpointedNotification, type ProductCompletedNotification, type ProductDagTopologyNotification, type ProductTaskCompletedNotification, type ProductTaskFailedNotification, type ProductTaskOutputDeltaNotification, type ProductTaskStartedNotification, type ProjectArchivedNotification, type ProjectCreatedNotification, type ProjectDeletedNotification, type ProjectRenamedNotification, type ProjectSwitchedNotification, type ProjectUnarchivedNotification, type SessionInfoNotification, type SoloAgentDeltaNotification, type SoloAgentDiffNotification, type SoloAgentUsageNotification, type SoloEvaluationNotification, type SoloProgressNotification, type TeamMemberNotification, type ToolApprovalRequestNotification, type TurnAnnotationsNotification, type TurnArtifactNotification, type TurnAskUserNotification, type TurnDeltaNotification, type TurnEndNotification, type TurnErrorNotification, type TurnExecProgressNotification, type TurnHeartbeatNotification, type TurnMediaPersistedNotification, type TurnMediaProgressNotification, type TurnMediaResultNotification, type TurnPlanUpdateNotification, type TurnReasoningDeltaNotification, type TurnRecoveryNotification, type TurnSidechainCompletedNotification, type TurnSidechainStartedNotification, type TurnSkillAcquisitionNeededNotification, type TurnSkillInstructionNotification, type TurnStartNotification, type TurnSubagentDeltaNotification, type TurnSuggestionsNotification, type TurnTaskUpdatedNotification, type TurnTodosUpdatedNotification, type TurnToolBlockedNotification, type TurnToolCallNotification, type TurnToolResultNotification, type TurnToolUseSummaryNotification, type TurnUsageUpdateNotification, type WireTokenUsage, type ProductPlanReadyNotification, type ProductPlanFailedNotification, type ProductPlanningDeltaNotification, type PetSoulReadyNotification, type PetReactionNotification, type PetGrowthNotification, type PetStateNotification, type PetConfirmNotification, } from "./notification-payloads.js";
 export { ACP_EXTENDED_METHODS, ACP_EXTENDED_SESSION_UPDATE_TYPES, ACP_METHODS, ACP_PROTOCOL_VERSION, ACP_SESSION_UPDATE_TYPES, isAcpJsonRpcNotification, isAcpJsonRpcRequest, isAcpJsonRpcResponse, isExtendedSessionUpdateType, isStandardSessionUpdateType, parseAcpMessage, type AcpAgentCapabilities, type AcpAgentMessageChunkPayload, type AcpAgentThoughtChunkPayload, type AcpAvailableCommandsUpdatePayload, type AcpConfigOptionDescriptor, type AcpConfigOptionUpdatePayload, type AcpContentBlock, type AcpContextItem, type AcpEndTurnPayload, type AcpExtendedMethod, type AcpExtendedSessionUpdateType, type AcpFsReadTextFileParams, type AcpFsReadTextFileResult, type AcpFsWriteTextFileParams, type AcpFsWriteTextFileResult, type AcpHostCapabilities, type AcpInitializeParams, type AcpInitializeResult, type AcpJsonRpcError, type AcpJsonRpcMessage, type AcpJsonRpcNotification, type AcpJsonRpcRequest, type AcpJsonRpcResponse, type AcpPermissionOption, type AcpPermissionRequestParams, type AcpPermissionRequestResult, type AcpPlanPayload, type AcpSessionEndParams, type AcpSessionNewParams, type AcpSessionNewResult, type AcpSessionPromptParams, type AcpSessionPromptResult, type AcpSessionSetConfigParams, type AcpSessionUpdateNotification, type AcpSessionUpdateType, type AcpStandardMethod, type AcpStandardSessionUpdateType, type AcpStopReason, type AcpToolCallPayload, type AcpToolCallUpdatePayload, type AcpUsage, type AcpUsageUpdatePayload, type AcpXAskUserPayload, type AcpXMediaProgressPayload, type AcpXMediaResultPayload, type AcpXMemoryUpdatedPayload, type AcpXProductCheckpointPayload, type AcpXProductTaskCompletedPayload, type AcpXProductTaskStartedPayload, type AcpXRecoveryPayload, type AcpXSessionInfoPayload, type AcpXSidechainCompletedPayload, type AcpXSidechainStartedPayload, type AcpXSkillInstructionPayload, type AcpXSoloAgentFinishedPayload, type AcpXSoloSelectedPayload, type AcpXSoloStartedPayload, type AcpXSubagentDeltaPayload, type AcpXSubagentEndedPayload, type AcpXSubagentStartedPayload, type AcpXSuggestionsPayload, type AcpXTeamMemberUpdatePayload, } from "./acp-protocol.js";

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

@@ -86,6 +86,7 @@ export interface TurnToolCallNotification {
     callId: string;
     name: string;
     arguments?: string;
+    inputSummary?: string;
     item?: NotificationThreadItem;
     agentSource?: AgentSource;
 }
@@ -97,6 +98,11 @@ export interface TurnToolResultNotification {
     ok: boolean;
     error?: string;
     outputPreview?: string;
+    durationMs?: number;
+    exitCode?: number;
+    stdout?: string;
+    stderr?: string;
+    details?: Record<string, unknown>;
     item?: NotificationThreadItem;
 }
 /** Tool execution blocked by permission system. */
@@ -315,6 +321,7 @@ export interface SessionInfoNotification {
 export interface PermissionRuleUpdatedNotification {
     pattern: string;
     behavior: string;
+    scope?: "session" | "persistent";
 }
 /** Forwarded notification from a team member child process. */
 export interface TeamMemberNotification {
@@ -599,11 +606,19 @@ export interface PetGrowthNotification {
     level: number;
     experience: number;
     xpNeeded?: number;
-    newAbility?: string;
-    abilities?: string[];
-    nextAbility?: {
+    displayTraits?: Array<{
+        id: string;
         name: string;
+        description: string;
+        level: number;
+        surface: "presentation";
+    }>;
+    nextDisplayTrait?: {
+        id: string;
+        name: string;
+        description: string;
         level: number;
+        surface: "presentation";
     };
 }
 /** Emitted to override pet state from agent side. */

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

@@ -0,0 +1,117 @@
+export interface CommunityConsentView {
+    enabled: boolean;
+    methodSharingEnabled: boolean;
+    signalsEnabled: boolean;
+    encounterEnabled: boolean;
+    remoteSynced: boolean;
+}
+export interface SetCommunityConsentInput {
+    enabled: boolean;
+    methodSharingEnabled?: boolean;
+    signalsEnabled?: boolean;
+    encounterEnabled?: boolean;
+}
+export interface CommunityConsentClient {
+    getConsent(): Promise<CommunityConsentView>;
+    setConsent(input: SetCommunityConsentInput): Promise<CommunityConsentView>;
+    publishSkill(input: CommunityPublishSkillInput): Promise<CommunityPublishSkillResult>;
+    recordSignal(input: CommunityRecordSignalInput): Promise<CommunityRecordSignalResult>;
+    recordTelemetry(input: CommunityRecordTelemetryInput): Promise<CommunityRecordTelemetryResult>;
+    resolveInstall(resourceId: string, version?: string): Promise<CommunityInstallResolution>;
+    listSharedResources(): Promise<CommunitySharedResource[]>;
+    withdrawSharedResource(resourceId: string, reason?: string): Promise<CommunitySharedResource>;
+    withdrawSharedResources(reason?: string): Promise<CommunitySharedResource[]>;
+    listNotices(input?: CommunityListNoticesInput): Promise<CommunityNotice[]>;
+    markNoticeRead(noticeId: number): Promise<CommunityNotice>;
+}
+export interface CommunitySharedResource {
+    id: string;
+    type: string;
+    title: string;
+    summary: string;
+    visibility: string;
+    latestVersion: string | null;
+    withdrawn: boolean;
+    withdrawnAt: string | null;
+}
+export interface CommunityPublishedVersion {
+    version: string;
+    checksum: string;
+    sizeBytes: number;
+}
+export interface CommunityPublishSkillInput {
+    id: string;
+    title: string;
+    summary: string;
+    visibility?: "public" | "private";
+    tags?: string[];
+    manifest: Record<string, unknown>;
+    version?: string;
+    packageGzipBase64?: string;
+}
+export interface CommunityPublishSkillResult {
+    resource: CommunitySharedResource;
+    version?: CommunityPublishedVersion;
+}
+export type CommunitySignalEvent = "installed" | "success" | "fail" | "neutral" | "kept" | "uninstalled" | "endorse" | "error";
+export interface CommunityRecordSignalInput {
+    resourceId: string;
+    event: CommunitySignalEvent;
+    attribution?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface CommunityRecordSignalResult {
+    accepted: true;
+}
+export type CommunityTelemetryEvent = "community.journey.view" | "community.share.generated" | "community.sandbox.violation" | "community.desensitization.hit";
+export interface CommunityRecordTelemetryInput {
+    event: CommunityTelemetryEvent;
+    metadata?: Record<string, unknown>;
+}
+export interface CommunityRecordTelemetryResult {
+    accepted: true;
+}
+export interface CommunityNotice {
+    id: number;
+    resourceId: string;
+    resourceType: string;
+    title: string;
+    event: "withdrawn";
+    version: string | null;
+    reason: string | null;
+    read: boolean;
+    createdAt: string;
+    readAt: string | null;
+}
+export interface CommunityListNoticesInput {
+    includeRead?: boolean;
+}
+export type CommunityInstallRiskTier = "R0" | "R1" | "R2" | "R3";
+export type CommunityInstallSourceTier = "official" | "community";
+export type CommunityInstallTrustStage = "quarantine" | "trial" | "trusted";
+export type CommunityInstallReviewStatus = "pending" | "approved" | "rejected";
+export interface CommunityInstallResolution {
+    id: string;
+    type: string;
+    kind: string;
+    sourceTier: CommunityInstallSourceTier;
+    trustStage: CommunityInstallTrustStage;
+    reviewStatus: CommunityInstallReviewStatus;
+    resourceRiskTier: CommunityInstallRiskTier;
+    effectiveRiskTier: CommunityInstallRiskTier;
+    requires: string[];
+    dependencies: CommunityInstallResolution[];
+    version: string;
+    checksum: string;
+    sizeBytes: number;
+    downloadUrl: string;
+    manifest: unknown;
+}
+export interface CommunityConsentClientOptions {
+    baseUrl: string;
+    token: string;
+    fetchFn?: typeof fetch;
+}
+export declare function createCommunityConsentClient(options: CommunityConsentClientOptions): CommunityConsentClient;
+export declare function createDefaultCommunityConsentClient(): CommunityConsentClient | null;
+export declare function normalizeCommunityConsent(value: unknown, remoteSynced: boolean): CommunityConsentView;

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

@@ -0,0 +1 @@
+export {};

package/dist/types/runtime/community/community-desensitization-red-team-cli.d.ts

@@ -0,0 +1,7 @@
+export interface CommunityDesensitizationRedTeamCliDeps {
+    log?: {
+        info(message: string): void;
+        error(message: string): void;
+    };
+}
+export declare function runCommunityDesensitizationRedTeamCli(argv?: string[], deps?: CommunityDesensitizationRedTeamCliDeps): Promise<number>;

package/dist/types/runtime/community/community-desensitization-red-team-cli.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/runtime/community/community-desensitization.d.ts

@@ -0,0 +1,29 @@
+export type CommunityDesensitizationRuleId = "sensitive-email" | "sensitive-secret" | "sensitive-path" | "sensitive-phone";
+export interface CommunityDesensitizationHit {
+    reason: string;
+    ruleId: CommunityDesensitizationRuleId;
+}
+export interface CommunityDesensitizationRedTeamCase {
+    id: string;
+    content: string;
+    expectedRuleId: CommunityDesensitizationRuleId;
+}
+export interface CommunityDesensitizationRedTeamReport {
+    suite: "desensitization";
+    generatedAt: string;
+    cases: number;
+    passed: boolean;
+    failures: number;
+    breakdown: Record<CommunityDesensitizationRuleId, {
+        cases: number;
+        failures: number;
+    }>;
+    failureDetails: Array<{
+        id: string;
+        expectedRuleId: CommunityDesensitizationRuleId;
+        actualRuleId: CommunityDesensitizationRuleId | null;
+    }>;
+}
+export declare function detectCommunityPublishSensitiveContent(content: string): CommunityDesensitizationHit | null;
+export declare function buildCommunityDesensitizationRedTeamCases(): CommunityDesensitizationRedTeamCase[];
+export declare function runCommunityDesensitizationRedTeam(cases?: CommunityDesensitizationRedTeamCase[]): CommunityDesensitizationRedTeamReport;

package/dist/types/runtime/community/community-desensitization.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/runtime/community/community-telemetry-recorder.d.ts

@@ -0,0 +1,6 @@
+import { type CommunityRecordTelemetryInput } from "./community-consent-client.js";
+export interface CommunityTelemetryRecorder {
+    recordTelemetry(input: CommunityRecordTelemetryInput): Promise<void>;
+}
+export declare function createDefaultCommunityTelemetryRecorder(): CommunityTelemetryRecorder | null;
+export declare function recordCommunityTelemetryBestEffort(recorder: CommunityTelemetryRecorder | null | undefined, input: CommunityRecordTelemetryInput): void;

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

@@ -0,0 +1,249 @@
+/**
+ * Centralized tunable defaults — single source of truth.
+ *
+ * ALL configurable constants that external apps (Electron UI, CLI config)
+ * may want to read or override are defined here. This enables:
+ *
+ * 1. A future `config.tunables` RPC endpoint for visual editing
+ * 2. Serialization to JSON for persistence (settings.json)
+ * 3. Environment variable overrides via QLOGICAGENT_* prefix
+ *
+ * Consumers import individual constants from this module.
+ * The full shape is exported as `TunableDefaults` interface for RPC typing.
+ *
+ * Grouping follows subsystem boundaries.
+ */
+/** Absolute max rounds any agent can run (hard cap). */
+export declare const MAX_ROUNDS_LIMIT = 100;
+/** Default rounds for a top-level agent turn. */
+export declare const DEFAULT_MAX_ROUNDS = 25;
+/** Default temperature for LLM calls (0 = deterministic). */
+export declare const DEFAULT_TEMPERATURE = 0;
+/** Hard cap on tool calls per round (prevents runaway). */
+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;
+/** 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. */
+export declare const MAX_IDENTICAL_CALL_REPEATS = 2;
+/** Max times the same tool can fail with different args before blocking (variant-loop detection).
+ *  Includes both hard failures (ok=false) and soft empty results (e.g. "No matches found").
+ *  Note: blocked calls still emit tool_call events, so effective max attempts visible to
+ *  client = MAX + 1 (the blocked attempt) + possible 1 alternative tool = MAX + 2. */
+export declare const MAX_TOOL_VARIANT_FAILURES = 2;
+/** Default context window size (tokens). */
+export declare const DEFAULT_CONTEXT_WINDOW_TOKENS = 128000;
+/** Reserved tokens for model response output. */
+export declare const RESPONSE_BUFFER_TOKENS = 13000;
+/** Default max output tokens per LLM API call. */
+export declare const DEFAULT_MAX_OUTPUT_TOKENS = 16384;
+/** Model's absolute max output tokens (escalation ceiling). */
+export declare const DEFAULT_MODEL_MAX_OUTPUT_TOKENS = 65536;
+/** Max max_output_tokens recovery attempts (CC: 3). */
+export declare const MAX_OUTPUT_TOKENS_RECOVERY_LIMIT = 3;
+/** Escalated max output tokens during recovery (CC: 64k). */
+export declare const ESCALATED_MAX_OUTPUT_TOKENS = 65536;
+/** Delta threshold for "diminishing returns" detection (CC: 500). */
+export declare const DIMINISHING_RETURNS_THRESHOLD = 500;
+/** Min consecutive continuations before diminishing returns kicks in. */
+export declare const DIMINISHING_RETURNS_MIN_CONTINUATIONS = 3;
+/** Per-tool result size threshold (chars) for disk persistence. */
+export declare const DEFAULT_MAX_RESULT_SIZE_CHARS = 50000;
+/** Per-message aggregate tool result budget (chars). */
+export declare const MAX_TOOL_RESULTS_PER_MESSAGE_CHARS = 200000;
+/** Preview size for persisted tool result references (bytes). */
+export declare const TOOL_RESULT_PREVIEW_BYTES = 2000;
+/** Heartbeat interval during persistent retry waits (ms). */
+export declare const HEARTBEAT_INTERVAL_MS = 30000;
+/** Max 529 errors before fallback model switch. */
+export declare const MAX_529_RETRIES = 3;
+/** Max consecutive API error retries before aborting. */
+export declare const MAX_API_RETRIES = 2;
+/** Max backoff interval for persistent retry (ms). */
+export declare const PERSISTENT_RETRY_MAX_BACKOFF_MS = 300000;
+/** Total retry time cap for persistent retry (ms). */
+export declare const PERSISTENT_RETRY_RESET_CAP_MS = 21600000;
+/** Target usage ratio after compression (0-1). */
+export declare const COMPRESSION_TARGET_USAGE_RATIO = 0.75;
+/** Min token budget floor after compression. */
+export declare const COMPRESSION_MIN_BUDGET = 16000;
+/** Max token budget ceiling. */
+export declare const COMPRESSION_MAX_BUDGET = 120000;
+/** Max consecutive reactive compaction failures. */
+export declare const REACTIVE_COMPACT_MAX_FAILURES = 3;
+/** Min messages to keep after reactive compaction. */
+export declare const REACTIVE_COMPACT_MIN_MESSAGES = 4;
+/** Target usage percentage for reactive compaction. */
+export declare const REACTIVE_COMPACT_TARGET_PERCENT = 50;
+/** Max auto-learned skills per project. */
+export declare const MAX_SKILLS_PER_PROJECT = 20;
+/** Max global (user-level) skills. */
+export declare const MAX_SKILLS_GLOBAL = 50;
+/** Min tool calls to consider a turn "complex enough" for skill creation. */
+export declare const MIN_TOOL_CALLS_FOR_SKILL = 3;
+/** Min distinct tools to suggest a new skill. */
+export declare const MIN_DISTINCT_TOOLS_FOR_SKILL = 2;
+/** Cooldown between skill creation suggestions (ms). */
+export declare const SKILL_CREATION_COOLDOWN_MS: number;
+/**
+ * Project-level pattern repetition threshold.
+ * The same workflow signature must appear this many times across turns/sessions
+ * before a skill creation is triggered. Prevents one-off complex turns from
+ * immediately producing skills.
+ */
+export declare const SKILL_PATTERN_REPETITION_THRESHOLD = 3;
+/**
+ * Max age (ms) for pattern entries. Patterns older than this are pruned.
+ * Default: 30 days.
+ */
+export declare const SKILL_PATTERN_MAX_AGE_MS: number;
+/** Max chars of skill content injected into system prompt. */
+export declare const SKILL_INJECTION_MAX_CHARS = 4000;
+/** Max skills injected into a single prompt. */
+export declare const SKILL_INJECTION_MAX_COUNT = 5;
+/** Max skills recalled from other projects per turn. */
+export declare const SKILL_RECALL_MAX_SKILLS = 3;
+/** Max chars per recalled skill content. */
+export declare const SKILL_RECALL_MAX_CONTENT_CHARS = 800;
+/** Skill recall index cache TTL (ms). */
+export declare const SKILL_RECALL_CACHE_TTL_MS: number;
+/** Max nested fork depth for sub-agents. */
+export declare const MAX_FORK_DEPTH = 4;
+/** Team aggregate budget (total tokens across all forked sub-agents). 0 = unlimited. */
+export declare const TEAM_BUDGET_TOKENS = 0;
+/** Max historical sessions retained on disk. */
+export declare const MAX_SESSIONS = 50;
+/** Turn count threshold for triggering task summary. */
+export declare const TASK_SUMMARY_TURN_THRESHOLD = 50;
+/** Interval (turns) between summary regeneration. */
+export declare const TASK_SUMMARY_REGEN_INTERVAL = 30;
+/** Idle duration (ms) before a group session is auto-split into a new session. Default: 1 hour. */
+export declare const GROUP_SESSION_IDLE_THRESHOLD_MS: number;
+/** Hard limit: max turns in a single group session before soft-split. Default: 200 turns. */
+export declare const GROUP_SESSION_MAX_TURNS = 200;
+/** Max include nesting depth in instruction files. */
+export declare const MAX_INCLUDE_DEPTH = 5;
+/** Max total chars loaded from instruction files. */
+export declare const MAX_INSTRUCTION_CHARS = 40000;
+/** Max single instruction file size (bytes). */
+export declare const INSTRUCTIONS_MAX_FILE_SIZE: number;
+/** Max total instruction directory size (bytes). */
+export declare const INSTRUCTIONS_MAX_DIR_SIZE: number;
+/** Max single media file download size (bytes, 500 MB). */
+export declare const MEDIA_MAX_DOWNLOAD_SIZE: number;
+/** Max file size for direct LLM upload (bytes, 50 MB).
+ *  Files larger than this should be chunked or summarized before sending to LLM. */
+export declare const MEDIA_MAX_UPLOAD_SIZE: number;
+/** Media download timeout (ms). */
+export declare const MEDIA_DOWNLOAD_TIMEOUT_MS = 300000;
+/** Max retries when spawning an ACP agent process. */
+export declare const ACP_MAX_SPAWN_RETRIES = 2;
+/** Backoff base for agent spawn retries (ms). */
+export declare const ACP_RETRY_BACKOFF_BASE = 3000;
+/** Max automatic restarts after agent process crash. */
+export declare const ACP_RUNTIME_RESTART_MAX = 3;
+/** Backoff base for crash restarts (ms). */
+export declare const ACP_RUNTIME_RESTART_BACKOFF_BASE = 5000;
+/** Running task poll interval (ms). */
+export declare const TASK_POLL_INTERVAL_MS = 1000;
+/** How long to display stopped tasks before removal (ms). */
+export declare const TASK_STOPPED_DISPLAY_MS = 3000;
+/** Terminal task cleanup grace period (ms). */
+export declare const TASK_PANEL_GRACE_MS = 30000;
+/** Max bytes injected for session memory prefetch. */
+export declare const MEMORY_PREFETCH_MAX_SESSION_BYTES: number;
+/** Max results per memory recall query. */
+export declare const MEMORY_PREFETCH_LIMIT_PER_RECALL = 10;
+/** LRU dedup set size for surfaced memory entries. */
+export declare const MEMORY_MAX_SURFACED_ENTRIES = 100;
+/** Min hours between dream consolidation runs. */
+export declare const DREAM_MIN_INTERVAL_HOURS = 24;
+/** Min sessions before dream triggers. */
+export declare const DREAM_MIN_SESSIONS = 5;
+/** Dream scan throttle interval (ms). */
+export declare const DREAM_SCAN_INTERVAL_MS = 600000;
+/** Idle dream timer (minutes). */
+export declare const IDLE_DREAM_MINUTES = 30;
+/** Dream cooldown between runs (ms, 4 hours). */
+export declare const DREAM_COOLDOWN_MS = 14400000;
+/** Max dream run duration (ms). */
+export declare const DREAM_MAX_DURATION_MS = 300000;
+/**
+ * Full typed shape of all tunable defaults.
+ * Used by `config.tunables` RPC for external app visualization.
+ */
+export interface TunableDefaults {
+    maxRoundsLimit: number;
+    defaultMaxRounds: number;
+    defaultTemperature: number;
+    maxToolBudgetCap: number;
+    defaultToolBudget: number;
+    maxConsecutiveFailures: number;
+    maxIdenticalCallRepeats: number;
+    defaultContextWindowTokens: number;
+    responseBufferTokens: number;
+    defaultMaxOutputTokens: number;
+    defaultModelMaxOutputTokens: number;
+    maxOutputTokensRecoveryLimit: number;
+    escalatedMaxOutputTokens: number;
+    diminishingReturnsThreshold: number;
+    diminishingReturnsMinContinuations: number;
+    defaultMaxResultSizeChars: number;
+    maxToolResultsPerMessageChars: number;
+    toolResultPreviewBytes: number;
+    heartbeatIntervalMs: number;
+    max529Retries: number;
+    maxApiRetries: number;
+    persistentRetryMaxBackoffMs: number;
+    persistentRetryResetCapMs: number;
+    compressionTargetUsageRatio: number;
+    compressionMinBudget: number;
+    compressionMaxBudget: number;
+    reactiveCompactMaxFailures: number;
+    reactiveCompactMinMessages: number;
+    reactiveCompactTargetPercent: number;
+    maxSkillsPerProject: number;
+    maxSkillsGlobal: number;
+    minToolCallsForSkill: number;
+    minDistinctToolsForSkill: number;
+    skillCreationCooldownMs: number;
+    skillInjectionMaxChars: number;
+    skillInjectionMaxCount: number;
+    skillRecallMaxSkills: number;
+    skillRecallMaxContentChars: number;
+    skillRecallCacheTtlMs: number;
+    maxForkDepth: number;
+    maxSessions: number;
+    taskSummaryTurnThreshold: number;
+    taskSummaryRegenInterval: number;
+    maxIncludeDepth: number;
+    maxInstructionChars: number;
+    instructionsMaxFileSize: number;
+    instructionsMaxDirSize: number;
+    mediaMaxDownloadSize: number;
+    mediaMaxUploadSize: number;
+    mediaDownloadTimeoutMs: number;
+    acpMaxSpawnRetries: number;
+    acpRetryBackoffBase: number;
+    acpRuntimeRestartMax: number;
+    acpRuntimeRestartBackoffBase: number;
+    taskPollIntervalMs: number;
+    taskStoppedDisplayMs: number;
+    taskPanelGraceMs: number;
+    memoryPrefetchMaxSessionBytes: number;
+    memoryPrefetchLimitPerRecall: number;
+    memoryMaxSurfacedEntries: number;
+    dreamMinIntervalHours: number;
+    dreamMinSessions: number;
+    dreamScanIntervalMs: number;
+    idleDreamMinutes: number;
+    dreamCooldownMs: number;
+    dreamMaxDurationMs: number;
+    teamBudgetTokens: number;
+}
+/**
+ * Snapshot of all current tunable values.
+ * Use this for RPC serialization and external app display.
+ */
+export declare function getTunableDefaults(): TunableDefaults;

package/dist/types/runtime/execution/dream-agent.d.ts

@@ -10,8 +10,8 @@
  *
  * Reference: claude-code src/services/autoDream/
  */
-import type { DreamTaskState, DreamTurn } from "../../orchestration/subagent/task-types.js";
-import type { ToolDefinition, ToolInvoker, AgentLogger, HookRegistry } from "../../agent/types.js";
+import type { DreamTaskState, DreamTurn } from "../tasks/task-types.js";
+import type { ToolDefinition, ToolInvoker, AgentLogger, HookRegistry, ForkedAgentRunnerFactory } from "../ports/agent-execution-contracts.js";
 import type { LLMTransport } from "@xiaozhiclaw/provider-core";
 export interface DreamTriggerConfig {
     /** Minimum hours since last consolidation. Default: 24. */
@@ -153,6 +153,8 @@ export interface DreamRunDeps {
     transport: LLMTransport;
     /** Tool invoker */
     toolInvoker: ToolInvoker;
+    /** Concrete agent runner factory injected by CLI/app layer. */
+    createAgentRunner: ForkedAgentRunnerFactory;
     /** Available tools (will be filtered by canUseDreamTool) */
     tools: ToolDefinition[];
     /** API key */

package/dist/types/runtime/execution/dream-category-context.d.ts

@@ -1,4 +1,4 @@
-import type { QMemoryCategory } from "../../skills/memory/categories.js";
+import type { QMemoryCategory } from "../memory/categories.js";
 /** A memory file with its inferred category and metadata. */
 export interface CategorizedMemoryFile {
     filename: string;