qlogicagent 2.10.22 → 2.10.24

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;

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

@@ -17,7 +17,7 @@
  *
  * Reference: claude-code src/utils/forkedAgent.ts
  */
-import type { AgentLogger, ChatMessage, ToolDefinition, ToolInvoker, TokenUsage, TurnEvent, HookRegistry } from "../../agent/types.js";
+import type { AgentLogger, ChatMessage, ToolDefinition, ToolInvoker, TokenUsage, TurnEvent, HookRegistry, ForkedAgentRunnerFactory } from "../ports/agent-execution-contracts.js";
 import type { LLMTransport } from "@xiaozhiclaw/provider-core";
 import type { AgentProgress } from "./progress-tracker.js";
 /**
@@ -49,6 +49,8 @@ export interface ForkedAgentParams {
     transport: LLMTransport;
     /** Tool invoker for tool execution */
     toolInvoker: ToolInvoker;
+    /** Factory for the concrete agent runner. Injected to keep runtime independent from agent/. */
+    createAgentRunner: ForkedAgentRunnerFactory;
     /** API key */
     apiKey: string;
     /** Model name */

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

@@ -10,8 +10,8 @@
  *
  * Reference: claude-code src/services/tools/StreamingToolExecutor.ts
  */
-import type { ToolInvoker, AgentLogger, HookRegistry } from "../../agent/types.js";
-import { type OpenAiToolCall } from "../../orchestration/index.js";
+import type { ToolInvoker, AgentLogger, HookRegistry } from "../ports/agent-execution-contracts.js";
+import { type OpenAiToolCall } from "../ports/tool-call-contracts.js";
 export type ToolStatus = "queued" | "executing" | "completed" | "yielded";
 export interface ToolExecutionResult {
     callId: string;
@@ -20,6 +20,8 @@ export interface ToolExecutionResult {
     error?: string;
     blocked?: boolean;
     blockReason?: string;
+    durationMs?: number;
+    details?: Record<string, unknown>;
     message: unknown;
 }
 export interface StreamingToolExecutorConfig {

package/dist/types/runtime/execution/tool-eligibility.d.ts

@@ -13,7 +13,7 @@
  *
  * Zero imports from express/pg/ioredis/ws.
  */
-import type { ToolDefinition } from "../../agent/types.js";
+import type { ToolDefinition } from "../ports/agent-execution-contracts.js";
 /**
  * Tool permission levels aligned with Claude Code's permission model:
  *

package/dist/types/runtime/hooks/context-compression.d.ts

@@ -1,4 +1,4 @@
-import { ContextEngineRegistry, type CompressibleMessage, type CompressionResult, type CompressionStrategy, type AsyncCompressionStrategy, type SummarizeFn } from "../../orchestration/index.js";
+import { ContextEngineRegistry, type CompressibleMessage, type CompressionResult, type CompressionStrategy, type AsyncCompressionStrategy, type SummarizeFn } from "../context/context-compression-strategies.js";
 import type { HookRegistry } from "./hook-registry.js";
 import type { RuntimeLogger } from "./hook-registry.js";
 import type { LLMTransport } from "@xiaozhiclaw/provider-core";
@@ -6,7 +6,7 @@ import type { LLMTransport } from "@xiaozhiclaw/provider-core";
 export declare function estimateTokens(msg: CompressibleMessage): number;
 /** Estimate total tokens for a message array. */
 export declare function estimateTotalTokens(messages: CompressibleMessage[]): number;
-export declare function getCompressionMetrics(): import("../../orchestration/index.js").CompressionMetricsSnapshot;
+export declare function getCompressionMetrics(): import("../context/context-compression-strategies.js").CompressionMetricsSnapshot;
 export declare function getContextEngineRegistry(): ContextEngineRegistry;
 /**
  * Create a summarization callback using an injected LLM transport.

package/dist/types/runtime/hooks/memory-hooks.d.ts

@@ -1,7 +1,7 @@
 import type { HookRegistry } from "../../contracts/hooks.js";
-import type { MemoryProvider } from "../../protocol/wire/index.js";
-import type { LocalMemoryProvider } from "../../skills/memory/local-memory-provider.js";
-import type { Memdir } from "../../skills/memory/memdir.js";
+import type { MemoryProvider } from "../ports/memory-provider.js";
+import type { MemoryWriter } from "../ports/memory-writer.js";
+import type { MemoryRecallSource } from "../ports/memory-recall-source.js";
 export declare const MEMORY_PREFETCH_CONFIG: {
     readonly MAX_SESSION_BYTES: number;
     readonly LIMIT_PER_RECALL: 10;
@@ -11,7 +11,7 @@ export interface MemoryHooksDeps {
     /** QMemory adapter (MemoryProvider with search/health). */
     memoryProvider?: MemoryProvider;
     /** Local memory provider for direct writes (auto-extract). */
-    localMemoryProvider?: LocalMemoryProvider;
+    localMemoryProvider?: MemoryWriter;
     /** User ID for memory lookups. */
     userId: string;
     /** Logger. */
@@ -55,8 +55,8 @@ export declare function registerMemoryHooks(hooks: HookRegistry, deps: MemoryHoo
 /** Shared statepass the same object across hook re-registrations in a session. */
 prefetchState?: MemoryPrefetchState): () => void;
 export interface MemdirRecallHookDeps {
-    /** MEMDIR instance (lazy: may be null at registration time). */
-    getMemdir: () => Memdir | null;
+    /** Project memory recall source (lazy: may be null at registration time). */
+    getMemorySource: () => MemoryRecallSource | null;
     /** Logger. */
     log: {
         debug(msg: string): void;

package/dist/types/runtime/infra/acp-detector.d.ts

@@ -6,7 +6,7 @@
  *
  * Reference: AionUI AcpDetector + ACP_BACKENDS_ALL registry.
  */
-import type { AcpBackendConfig, AgentDescriptor, AgentConfigStoreData } from "./acp-types.js";
+import type { AcpBackendConfig, AgentDescriptor, AgentConfigStoreData } from "../../protocol/wire/acp-agent-management.js";
 export declare const ACP_BACKENDS: Record<string, AcpBackendConfig>;
 export declare class AcpDetector {
     private cache;
@@ -32,5 +32,5 @@ export declare class AcpDetector {
      * Build an ExternalAgentDescriptor suitable for AgentProcessManager.spawn().
      * Returns null if the agent is not available.
      */
-    buildExternalDescriptor(agentId: string): import("./acp-types.js").ExternalAgentDescriptor | null;
+    buildExternalDescriptor(agentId: string): import("../../protocol/wire/acp-agent-management.js").ExternalAgentDescriptor | null;
 }

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

@@ -16,7 +16,7 @@
  *     terminal/wait_for_exit, terminal/kill
  */
 import type { ChildProcess } from "node:child_process";
-import type { AcpInitializeResult, AcpSessionResult, AcpPromptResponse, McpServerConfig } from "./acp-types.js";
+import type { AcpInitializeResult, AcpSessionResult, AcpPromptResponse, McpServerConfig } from "../../protocol/wire/acp-agent-management.js";
 /**
  * Handler for agent→host requests (fs, terminal, permission, elicitation).
  * Host implementations should implement the methods they support.

package/dist/types/runtime/infra/acp-usage-tracker.d.ts

@@ -8,7 +8,7 @@
  * The tracker prevents double-counting when an agent sends both
  * usage_update notifications AND prompt response usage.
  */
-import type { AcpUsageUpdatePayload, AcpPromptResponseUsage } from "./acp-types.js";
+import type { AcpUsageUpdatePayload, AcpPromptResponseUsage } from "../../protocol/wire/acp-agent-management.js";
 export interface AccumulatedUsage {
     inputTokens: number;
     outputTokens: number;

package/dist/types/runtime/infra/agent-config-store.d.ts

@@ -3,12 +3,12 @@
  *
  * Storage paths:
  *   - Project-level: `<cwd>/.qlogicagent/agent-configs.json`
- *   - User-level:    `~/.qlogicagent/agent-configs.json`
+ *   - User-level:    `~/.qlogicagent/profiles/<owner>/agent-configs.json`
  *
  * Merge strategy: project-level overrides take precedence.
  * Sensitive fields (apiKey) use file permissions 0o600 on Unix.
  */
-import type { AgentConfig, AgentConfigStoreData, CustomAgentDef } from "./acp-types.js";
+import type { AgentConfig, AgentConfigStoreData, CustomAgentDef } from "../../protocol/wire/acp-agent-management.js";
 export declare class AgentConfigStore {
     private data;
     private cwd;

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

@@ -9,35 +9,43 @@
 export declare const AGENT_DOT_DIR = ".qlogicagent";
 /** `~/.qlogicagent/` (or QLOGICAGENT_HOME override) */
 export declare function getUserAgentHome(): string;
+/** Legacy pre-profile user settings path: `~/.qlogicagent/settings.json`. */
+export declare function getLegacyUserSettingsPath(): string;
+/** Legacy pre-profile local memory database path: `~/.qlogicagent/memory/memories.db`. */
+export declare function getLegacyMemoryDbPath(): string;
+export declare function resolveActiveOwnerUserId(): string;
+export declare function encodeOwnerProfileSegment(ownerUserId: string): string;
+export declare function getOwnerProfileDir(ownerUserId?: string): string;
+export declare function getProfileMemoryDir(ownerUserId?: string): string;
 /**
  * Ensure the user agent home directory exists and is writable.
  * Returns the path if accessible, throws with a friendly message otherwise.
  * Call this once at startup rather than on every path resolution.
  */
 export declare function ensureUserAgentHome(): string;
-/** `~/.qlogicagent/.credentials.json` */
+/** `~/.qlogicagent/profiles/<owner>/.credentials.json` */
 export declare function getUserCredentialsPath(): string;
-/** `~/.qlogicagent/plugins/` */
+/** `~/.qlogicagent/profiles/<owner>/plugins/` */
 export declare function getUserPluginsDir(): string;
-/** `~/.qlogicagent/skills/` */
+/** `~/.qlogicagent/profiles/<owner>/skills/` */
 export declare function getUserSkillsDir(): string;
-/** `~/.qlogicagent/settings.json` */
+/** `~/.qlogicagent/profiles/<owner>/settings.json` */
 export declare function getUserSettingsPath(): string;
 /** `~/.qlogicagent/cache/` */
 export declare function getUserCacheDir(): string;
 /** `~/.qlogicagent/debug-logs/` */
 export declare function getUserDebugLogsDir(): string;
-/** `~/.qlogicagent/plugin-cache/` */
+/** `~/.qlogicagent/profiles/<owner>/plugin-cache/` */
 export declare function getUserPluginCacheDir(): string;
-/** `~/.qlogicagent/mcp.json` */
+/** `~/.qlogicagent/profiles/<owner>/mcp.json` */
 export declare function getUserMcpConfigPath(): string;
-/** `~/.qlogicagent/marketplace.json` */
+/** `~/.qlogicagent/profiles/<owner>/marketplace.json` */
 export declare function getUserMarketplaceConfigPath(): string;
-/** `~/.qlogicagent/workflows/` */
+/** `~/.qlogicagent/profiles/<owner>/workflows/` */
 export declare function getUserWorkflowsDir(): string;
-/** `~/.qlogicagent/INSTRUCTIONS.md` */
+/** `~/.qlogicagent/profiles/<owner>/INSTRUCTIONS.md` */
 export declare function getUserInstructionsPath(): string;
-/** `~/.qlogicagent/rules/` */
+/** `~/.qlogicagent/profiles/<owner>/rules/` */
 export declare function getUserRulesDir(): string;
 /** `<cwd>/.qlogicagent/` */
 export declare function getProjectAgentDir(cwd: string): string;

package/dist/types/runtime/infra/agent-paths.test.d.ts

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

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

@@ -13,8 +13,8 @@
  * Reference: claude-code-haha/src/utils/swarm/spawnMultiAgent.ts
  * Reference: claude-code-haha/src/utils/swarm/spawnUtils.ts
  */
-import type { ExternalAgentDescriptor, McpServerConfig } from "./acp-types.js";
-import type { AgentConfig } from "./acp-types.js";
+import type { ExternalAgentDescriptor, McpServerConfig } from "../../protocol/wire/acp-agent-management.js";
+import type { AgentConfig } from "../../protocol/wire/acp-agent-management.js";
 import { AcpUsageTracker } from "./acp-usage-tracker.js";
 export interface AgentProcessConfig {
     /** Unique member ID (e.g. "team-research-coder"). */

package/dist/types/runtime/infra/checkpoint-backend.d.ts

@@ -4,5 +4,5 @@
  * Creates and manages checkpoint snapshots in `<project>/.qlogicagent/checkpoints/<sessionId>/`
  * using a shadow git repository independent of the user's project .git.
  */
-import type { CheckpointToolDeps } from "../../skills/tools/checkpoint-tool.js";
-export declare function createLocalCheckpointBackend(projectRoot: string, sessionId: string): CheckpointToolDeps;
+import type { CheckpointBackend } from "../ports/checkpoint-contracts.js";
+export declare function createLocalCheckpointBackend(projectRoot: string, sessionId: string): CheckpointBackend;

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

@@ -15,5 +15,5 @@ export { ModelIdTranslator } from "./model-id-translator.js";
 export { SkillInjector } from "./skill-injector.js";
 export { ACP_FAULT_LEVEL, type AcpFaultLevel, buildLlmEnvForTeammate } from "./agent-process.js";
 export { McpBridge, MCP_BRIDGE_TOOLS } from "./mcp-bridge.js";
-export type { AgentCategory, AgentProtocol, AgentStatus, AcpBackendConfig, AgentDescriptor, ExternalAgentDescriptor, CustomAgentDef, AgentConfig, AgentConfigStoreData, AgentCapabilities, AcpInitializeResult, AcpSessionResult, AcpPromptResponse, AcpPromptResponseUsage, AcpStopReason, AcpUsageUpdatePayload, McpServerConfig, AgentsScanParams, AgentsConfigParams, AgentsSetConfigParams, AgentsGetConfigParams, AgentsRemoveConfigParams, AgentsSetGatewayParams, SoloState, SoloAgentState, SoloAgentResult, SoloEvaluation, SoloStatus, SoloStartParams, SoloIdParams, SoloSelectParams, ProductPhase, ProductInstanceState, ProductTaskStatus, ProductBudget, ProductInstanceDef, ProductTaskDef, ProductCreateParams, ProductIdParams, ProductInstanceStatus, ProductTaskState, ProductStatus, ProductSummary, AgentsGetGatewayResult, AgentsListConfiguredItem, AgentsProcessInfo, AgentsKillParams, AgentsGetLogParams, AgentsGetLogResult, AgentsTestConnectionParams, AgentsTestConnectionResult, SoloDeleteParams, ProductDeleteParams, AgentSource, } from "./acp-types.js";
+export type { AgentCategory, AgentProtocol, AgentStatus, AcpBackendConfig, AgentDescriptor, ExternalAgentDescriptor, CustomAgentDef, AgentConfig, AgentConfigStoreData, AgentCapabilities, AcpInitializeResult, AcpSessionResult, AcpPromptResponse, AcpPromptResponseUsage, AcpStopReason, AcpUsageUpdatePayload, McpServerConfig, AgentsScanParams, AgentsConfigParams, AgentsSetConfigParams, AgentsGetConfigParams, AgentsRemoveConfigParams, AgentsSetGatewayParams, SoloState, SoloAgentState, SoloAgentResult, SoloEvaluation, SoloStatus, SoloStartParams, SoloIdParams, SoloSelectParams, ProductPhase, ProductInstanceState, ProductTaskStatus, ProductBudget, ProductInstanceDef, ProductTaskDef, ProductCreateParams, ProductIdParams, ProductInstanceStatus, ProductTaskState, ProductStatus, ProductSummary, AgentsGetGatewayResult, AgentsListConfiguredItem, AgentsProcessInfo, AgentsKillParams, AgentsGetLogParams, AgentsGetLogResult, AgentsTestConnectionParams, AgentsTestConnectionResult, SoloDeleteParams, ProductDeleteParams, AgentSource, } from "../../protocol/wire/acp-agent-management.js";
 export type { AgentsStatusNotification, AgentsErrorNotification, SoloProgressNotification, SoloEvaluationNotification, SoloAgentDeltaNotification, ProductTaskStartedNotification, ProductTaskCompletedNotification, ProductTaskFailedNotification, ProductCheckpointedNotification, ProductBudgetWarningNotification, ProductCompletedNotification, } from "../../protocol/notifications.js";

package/dist/types/runtime/infra/llmrouter-catalog.d.ts

@@ -1,5 +1,7 @@
 import type { ModelEntry, ModelRegistry } from "./model-registry.js";
 export declare const LLMROUTER_CATALOG_UNAVAILABLE_MESSAGE = "\u65E0\u6CD5\u8FDE\u63A5 llmrouter \u6A21\u578B\u76EE\u5F55";
+export declare const LLMROUTER_PROVIDER_ID = "llmrouter";
+export declare const LLMROUTER_PROVIDER_NAME = "LLMRouter";
 export declare class LlmrouterCatalogUnavailableError extends Error {
     constructor(message?: string);
 }
@@ -40,10 +42,18 @@ export interface LlmrouterCatalogModel {
     capabilities?: string[];
     pricing?: Record<string, unknown>;
 }
+export declare function getLlmrouterBaseUrl(): string;
+export declare function getLlmrouterModelsUrl(baseUrl: string): string;
 export declare function listLlmrouterCatalogProviders(): Promise<LlmrouterCatalogProvider[]>;
 export declare function listLlmrouterCatalogModels(): Promise<LlmrouterCatalogModel[]>;
+export declare function listLlmrouterModelsByApiKey(baseUrl: string, apiKey: string): Promise<LlmrouterCatalogModel[]>;
 export declare function providerDisplayName(provider: LlmrouterCatalogProvider): string;
 export declare function providerBaseUrl(provider: LlmrouterCatalogProvider): string | undefined;
 export declare function getLlmrouterCatalogProvider(providerId: string): Promise<LlmrouterCatalogProvider | null>;
 export declare function refreshRegistryFromLlmrouterCatalog(registry: ModelRegistry): Promise<ModelEntry[]>;
+export declare function refreshRegistryFromLlmrouterApiKey(registry: ModelRegistry, options: {
+    baseUrl: string;
+    apiKey: string;
+}): Promise<ModelEntry[]>;
 export declare function toModelEntry(model: LlmrouterCatalogModel): ModelEntry | null;
+export declare function toModelEntries(model: LlmrouterCatalogModel): ModelEntry[];

package/dist/types/runtime/infra/mcp-bridge.d.ts

@@ -13,7 +13,7 @@
  * The bridge server runs as a stdio child process. Each external agent
  * session gets its own MCP bridge server instance.
  */
-import type { McpServerConfig, AgentCapabilities } from "./acp-types.js";
+import type { McpServerConfig, AgentCapabilities } from "../../protocol/wire/acp-agent-management.js";
 /**
  * Tools exported via MCP bridge.
  * These represent qlogicagent capabilities that external agents can call.

package/dist/types/runtime/infra/model-registry.d.ts

@@ -88,6 +88,7 @@ export declare class ModelRegistry {
         id?: string;
     }): string;
     replaceCatalogModels(entries: ModelEntry[]): void;
+    replaceProviderModels(providerId: string, entries: ModelEntry[]): void;
     migrateModelIds(aliasToNative: Map<string, string>): void;
     removeModel(id: string): void;
     enableModel(id: string): void;
@@ -113,6 +114,7 @@ export declare class ModelRegistry {
     hasConfiguredKeyForProviderVariant(providerId: string): boolean;
     hasAvailableKeyForProviderVariant(providerId: string): boolean;
     listProviderDefs(): ProviderDef[];
+    getKnownProviderDef(providerId: string): ProviderDef | null;
     resolveProviderApiKey(providerId: string): string | undefined;
     onChange(callback: RegistryChangeCallback): () => void;
     getKeyForProvider(providerId: string): string | null;
@@ -123,7 +125,6 @@ export declare class ModelRegistry {
     private providerVariantKeyCandidates;
     private loadModelState;
     private hydrateCatalogModels;
-    private pruneInvalidBindings;
     private exportModelState;
     private emitChange;
 }

package/dist/types/runtime/infra/profile-storage.test.d.ts

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

package/dist/types/runtime/infra/skill-injector.d.ts

@@ -11,9 +11,10 @@
  *    directory support, prepend skill instructions text to the first prompt.
  *    Subject to a token budget to prevent context bloat.
  */
-import type { AgentCapabilities } from "./acp-types.js";
-import { SKILL_INJECTION_MAX_CHARS, SKILL_INJECTION_MAX_COUNT } from "../../agent/tunable-defaults.js";
+import type { AgentCapabilities } from "../../protocol/wire/acp-agent-management.js";
+import { SKILL_INJECTION_MAX_CHARS, SKILL_INJECTION_MAX_COUNT } from "../config/tunable-defaults.js";
 export { SKILL_INJECTION_MAX_CHARS, SKILL_INJECTION_MAX_COUNT };
+export declare function isSystemGeneratedSkillName(name: string): boolean;
 export declare class SkillInjector {
     /**
      * Synchronize skills to an agent's native skill directory.