qlogicagent 2.10.21 → 2.10.23

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,39 @@
 export declare const AGENT_DOT_DIR = ".qlogicagent";
 /** `~/.qlogicagent/` (or QLOGICAGENT_HOME override) */
 export declare function getUserAgentHome(): 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;
@@ -122,6 +124,7 @@ export declare class ModelRegistry {
     private resolveTechnicalVariant;
     private providerVariantKeyCandidates;
     private loadModelState;
+    private hydrateCatalogModels;
     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.

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

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

package/dist/types/runtime/infra/task-runtime.d.ts

@@ -9,7 +9,7 @@
  * Architecture note: CC uses React-style setAppState(prev => next). We use
  * a simple Map-based store since we're in a subprocess (no React).
  */
-import type { TaskState, TaskType, TaskLifecycle, PermissionRole, IsolationMode, LocalAgentTaskState, LocalBashTaskState } from "../../orchestration/subagent/task-types.js";
+import type { TaskState, TaskType, TaskLifecycle, PermissionRole, IsolationMode, LocalAgentTaskState, LocalBashTaskState } from "../tasks/task-types.js";
 import type { HookRegistry } from "../../contracts/hooks.js";
 /** Polling interval for running tasks (ms) */
 export declare const POLL_INTERVAL_MS = 1000;

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

@@ -17,7 +17,7 @@
  *
  * Security: validateWorktreeSlug() prevents path traversal.
  */
-import type { WorktreeToolDeps } from "../../skills/tools/worktree-tool.js";
+import type { WorktreeBackend } from "../ports/worktree-contracts.js";
 interface WorktreeSession {
     originalCwd: string;
     worktreePath: string;
@@ -82,5 +82,5 @@ export interface WorktreeBackendOptions {
     /** Sparse-checkout paths (CC settings.worktree.sparsePaths parity). */
     sparsePaths?: string[];
 }
-export declare function createWorktreeBackend(opts: WorktreeBackendOptions): WorktreeToolDeps;
+export declare function createWorktreeBackend(opts: WorktreeBackendOptions): WorktreeBackend;
 export {};

package/dist/types/runtime/memory/categories.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Memory categories for QMemory writes.
+ * Each has different value thresholds and retention policies.
+ */
+export type QMemoryCategory = "lesson" | "preference" | "pattern" | "fact" | "decision" | "skill-learning";

package/dist/types/runtime/memory/find-relevant-memories.d.ts

@@ -0,0 +1,70 @@
+export declare const RELEVANT_MEMORIES_CONFIG: {
+    /** Max topic files to consider during scan. */
+    readonly MAX_SCAN_FILES: 100;
+    /** Max files to surface per turn. */
+    readonly MAX_SELECTED: 5;
+    /** Max bytes per surfaced file (CC: 4096). */
+    readonly MAX_FILE_BYTES: 4096;
+    /** Max total bytes for all surfaced files combined. */
+    readonly MAX_TOTAL_BYTES: number;
+    /** Minimum score to be selected (0.0-1.0). */
+    readonly MIN_SCORE: 0.2;
+    /** Lines to read for header/description extraction. */
+    readonly HEADER_LINES: 10;
+    /** Recency boost: files modified within this many days get a bonus. */
+    readonly RECENCY_DAYS: 7;
+    /** Recency boost amount. */
+    readonly RECENCY_BOOST: 0.15;
+};
+/** Scanned memory file header (CC MemoryHeader parity). */
+export interface MemoryFileHeader {
+    /** Filename (e.g. "lesson-docker.md") */
+    filename: string;
+    /** Absolute path */
+    filePath: string;
+    /** Last modified timestamp (ms since epoch) */
+    mtimeMs: number;
+    /** File size in bytes */
+    sizeBytes: number;
+    /** Description extracted from first non-heading line */
+    description: string | null;
+    /** Category inferred from filename prefix */
+    category: string | null;
+}
+/** A selected relevant memory with content loaded. */
+export interface RelevantMemory {
+    /** Filename */
+    filename: string;
+    /** Full file path */
+    filePath: string;
+    /** Last modified timestamp */
+    mtimeMs: number;
+    /** Relevance score (0.0 - 1.0) */
+    score: number;
+    /** Content (possibly truncated) */
+    content: string;
+    /** Whether content was truncated */
+    truncated: boolean;
+}
+/**
+ * Find memory files relevant to a user query.
+ *
+ * CC parity: scans topic files, scores by keyword + filename + recency,
+ * selects top-N, loads content. No LLM needed (unlike CC's Sonnet call).
+ *
+ * @param query - User query text
+ * @param memoryDir - Root of the MEMDIR directory (~/.qlogicagent/memory/)
+ * @param alreadySurfaced - Paths already shown in prior turns (for dedup)
+ * @returns Relevant memories with content, sorted by score
+ */
+export declare function findRelevantMemories(query: string, memoryDir: string, alreadySurfaced?: ReadonlySet<string>): Promise<RelevantMemory[]>;
+/**
+ * Scan memory directory for topic files (excludes INDEX.md).
+ * Returns headers sorted by modification time (newest first).
+ */
+export declare function scanMemoryHeaders(memoryDir: string): Promise<MemoryFileHeader[]>;
+/**
+ * Format relevant memories as a single block for system prompt injection.
+ * CC parity: includes freshness header per file.
+ */
+export declare function formatRelevantMemoriesBlock(memories: RelevantMemory[]): string;

package/dist/types/runtime/memory/implicit-extraction.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Implicit Memory Extraction — CC extractMemories lightweight port.
+ *
+ * Architecture:
+ *   Layer 1: Zero-cost signal detection (regex) — decides if turn has extractable content
+ *   Layer 2: Lightweight LLM pass (async, non-blocking) — extracts structured facts
+ *
+ * This runs AFTER turn.end, so the user already has their response.
+ * Layer 2 only fires for ~10-20% of turns (those with detectable signals).
+ *
+ * Reference: claude-code src/services/extractMemories/extractMemories.ts
+ */
+import type { MemoryWriter } from "../ports/memory-writer.js";
+export interface ExtractedFact {
+    text: string;
+    category: "personal_fact" | "preference" | "event" | "lesson" | "pattern" | "decision";
+    importance: number;
+    eventDate?: string;
+}
+export interface ImplicitExtractionDeps {
+    /** Local memory provider for writing extracted facts. */
+    localProvider: MemoryWriter;
+    /** User ID. */
+    userId: string;
+    /** Logger. */
+    log: {
+        debug(msg: string): void;
+        warn(msg: string): void;
+    };
+    /**
+     * LLM invocation function (uses background/cheap model).
+     * Returns structured JSON string or null if unavailable.
+     */
+    llmExtract?: (prompt: string) => Promise<string | null>;
+}
+export interface TurnPair {
+    userMessage: string;
+    assistantMessage: string;
+}
+/**
+ * Layer 1: Detect if a user message contains signals worth extracting.
+ * Zero LLM cost — pure regex scanning.
+ *
+ * @returns true if the message likely contains extractable personal facts/events
+ */
+export declare function hasExtractionSignal(userMessage: string): boolean;
+/**
+ * Layer 2: Use a lightweight LLM to extract structured facts from a turn pair.
+ * Only called when Layer 1 signals are detected.
+ */
+export declare function extractFactsViaLlm(turn: TurnPair, llmExtract: (prompt: string) => Promise<string | null>, today: string): Promise<ExtractedFact[]>;
+/**
+ * Run the full implicit extraction pipeline for a completed turn.
+ * This is async and non-blocking — call it after turn.end.
+ *
+ * @returns Number of facts extracted and stored
+ */
+export declare function runImplicitExtraction(turn: TurnPair, deps: ImplicitExtractionDeps): Promise<number>;

package/dist/types/runtime/memory/recall-category-filter.d.ts

@@ -0,0 +1,54 @@
+import type { QMemoryCategory } from "./categories.js";
+/** Detected query scenario with preferred categories. */
+export interface RecallCategoryHint {
+    /** Detected scenario label. */
+    scenario: QueryScenario;
+    /** Preferred categories for this scenario (ordered by priority). */
+    preferred: QMemoryCategory[];
+    /** Categories to deprioritize (still recalled but scored lower). */
+    deprioritized: QMemoryCategory[];
+    /** Confidence of scenario detection (0.0-1.0). */
+    confidence: number;
+}
+/** Known query scenarios. */
+export type QueryScenario = "coding" | "config" | "conversation" | "learning" | "decision" | "general";
+/**
+ * Detect the query scenario and return category preferences.
+ *
+ * Uses pattern matching on the user query to infer intent.
+ * Returns "general" (no filtering) when confidence is below threshold.
+ *
+ * @param query - User query text
+ * @returns Category hint with preferred/deprioritized categories
+ */
+export declare function detectRecallCategories(query: string): RecallCategoryHint;
+/**
+ * Apply category boost/penalty to a recall score.
+ *
+ * Used by recall hooks to adjust memory scores based on category alignment.
+ *
+ * @param baseScore - Original relevance score (0.0-1.0)
+ * @param memoryCategory - Category of the memory entry (if known)
+ * @param hint - Category hint from detectRecallCategories()
+ * @returns Adjusted score
+ */
+export declare function applyCategoryBoost(baseScore: number, memoryCategory: string | undefined | null, hint: RecallCategoryHint): number;
+/**
+ * Filter and re-rank a list of recalled memories based on category preferences.
+ *
+ * @param memories - Raw recalled memories with optional category
+ * @param hint - Category hint from detectRecallCategories()
+ * @param minScore - Minimum adjusted score to keep (default: 0)
+ * @returns Re-ranked memories (highest adjusted score first)
+ */
+export declare function filterByCategory<T extends {
+    score?: number;
+    category?: string | null;
+}>(memories: T[], hint: RecallCategoryHint, minScore?: number): T[];
+/**
+ * Infer memory category from filename prefix convention.
+ * E.g. "lesson-docker.md" → "lesson", "fact-ports.md" → "fact"
+ *
+ * Exported for use by recall hooks.
+ */
+export declare function inferCategoryFromFilename(filename: string): QMemoryCategory | null;

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

@@ -3,7 +3,7 @@
  */
 export { PetSoulService, type PetSoul, type PetStats, type PetBreed } from "./pet-soul-service.js";
 export { maybeGenerateReaction, generateLLMReaction, type ReactionPool, type LLMReactionContext, type ReactionStyle } from "./pet-reaction-service.js";
-export { PetGrowthEngine, type GrowthEvent, type MoltResult, type PetAbility } from "./pet-growth-engine.js";
+export { PetGrowthEngine, type GrowthEvent, type MoltResult, type PetDisplayTrait } from "./pet-growth-engine.js";
 export { loadPetFile, validatePetManifest, sanitizeSvg, type PetManifest, type PetFileBundle } from "./pet-file-loader.js";
 export { buildSkeletonPrompt, parseSkeleton, renderState, extractColors, validateSkeleton, STATE_ANIMATION_MAP, type PetSkeleton, type SkeletonPart, type StateAnimationParams } from "./pet-skeleton.js";
 export { evaluateConsistency, evaluateConsistencyWithVision, structuralConsistencyScore, buildConsistencyPrompt, parseConsistencyResponse, buildRetryPrompt, DEFAULT_THRESHOLD, DEFAULT_MAX_RETRIES, type ConsistencyResult, type ConsistencyReport, type ConsistencyOptions } from "./pet-consistency.js";

package/dist/types/runtime/pet/pet-growth-engine.d.ts

@@ -1,23 +1,24 @@
 /**
- * PetGrowthEngine — handles pet leveling, molting (脱壳升级), and ability unlocks.
+ * PetGrowthEngine — handles pet leveling, molting, and display-trait unlocks.
  *
  * Design §13: Growth system
  * - XP curve: level * 100 (linear P0, polynomial later)
  * - Molting: every 5 levels triggers a "molt" event with visual upgrade
- * - Abilities: unlocked at specific levels
+ * - Display traits: unlocked at specific levels, presentation-only
  * - Stats growth: each level-up slightly boosts one stat
  */
 import type { PetStats, PetSoul } from "./pet-soul-service.js";
-export interface PetAbility {
+export interface PetDisplayTrait {
     id: string;
     name: string;
     description: string;
     unlockedAtLevel: number;
+    surface: "presentation";
 }
 export interface GrowthEvent {
-    type: "level_up" | "molt" | "ability_unlock";
+    type: "level_up" | "molt" | "display_trait_unlock";
     level: number;
-    ability?: PetAbility;
+    displayTrait?: PetDisplayTrait;
     moltStage?: number;
 }
 export interface MoltResult {
@@ -46,13 +47,13 @@ export declare class PetGrowthEngine {
      */
     static getMoltResult(stage: number, currentStats: PetStats): MoltResult;
     /**
-     * Get all unlocked abilities for a given level.
+     * Get all unlocked presentation traits for a given level.
      */
-    static getUnlockedAbilities(level: number): PetAbility[];
+    static getUnlockedDisplayTraits(level: number): PetDisplayTrait[];
     /**
-     * Get next upcoming ability.
+     * Get next upcoming presentation trait.
      */
-    static getNextAbility(level: number): PetAbility | null;
+    static getNextDisplayTrait(level: number): PetDisplayTrait | null;
     /**
      * XP gain rules for different events.
      */

package/dist/types/runtime/pet/pet-growth-engine.test.d.ts

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

package/dist/types/runtime/pet/pet-soul-service.d.ts

@@ -31,10 +31,9 @@ export interface PetBreed {
     rarity: string;
 }
 export declare class PetSoulService {
-    private workspaceDir;
     private soul;
     private storagePath;
-    constructor(workspaceDir: string);
+    constructor(_workspaceDir: string, ownerUserId?: string);
     load(): PetSoul | null;
     hatch(userId: string, generateSoul?: (rarity: string, stats: PetStats) => Promise<{
         name: string;

package/dist/types/runtime/pet/pet-soul-service.test.d.ts

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