qlogicagent 1.3.0 → 2.1.0

package/dist/types/runtime/infra/disk-storage.d.ts

@@ -4,7 +4,6 @@
  * Provides:
  * - Atomic write (tmp + rename) with dir auto-creation
  * - JSON read/write helpers
- * - MemoryStore disk persistence (auto-save on mutation)
  */
 /**
  * Write data atomically: write to a temp file in the same directory,
@@ -19,18 +18,3 @@ export declare function readJsonFile<T = unknown>(filePath: string): Promise<T |
  * Write a JSON file atomically.
  */
 export declare function writeJsonFile(filePath: string, data: unknown): Promise<void>;
-/** Path to user-level memory file: `~/.qlogicagent/memory.json` */
-export declare function getMemoryFilePath(): string;
-export interface PersistedMemory {
-    memory: string;
-    user: string;
-    /** ISO 8601 timestamp of last save. */
-    savedAt: string;
-}
-/** Load persisted memory from disk. Returns undefined if no file exists. */
-export declare function loadPersistedMemory(): Promise<PersistedMemory | undefined>;
-/** Save memory to disk atomically. */
-export declare function savePersistedMemory(data: {
-    memory: string;
-    user: string;
-}): Promise<void>;

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

@@ -1,18 +1,18 @@
-export { AGENT_DOT_DIR, getUserAgentHome, getUserSessionDir, getUserCredentialsPath, getUserPluginsDir, getUserSkillsDir, getUserSettingsPath, getUserCacheDir, getUserDebugLogsDir, getUserCheckpointsDir, getUserPluginCacheDir, getUserMcpConfigPath, getUserMarketplaceConfigPath, getUserWorkflowsDir, getUserInstructionsPath, getProjectAgentDir, getProjectWorkflowsDir, getProjectPluginsDir, getProjectSkillsDir, getProjectSettingsPath, getProjectInstructionsPath, getProjectRulesDir, getGitRootHooksDir, } from "./agent-paths.js";
+export { AGENT_DOT_DIR, getUserAgentHome, getUserSessionDir, getUserCredentialsPath, getUserPluginsDir, getUserSkillsDir, getUserSettingsPath, getUserCacheDir, getUserDebugLogsDir, getUserCheckpointsDir, getUserPluginCacheDir, getUserMcpConfigPath, getUserMarketplaceConfigPath, getUserWorkflowsDir, getUserInstructionsPath, getProjectAgentDir, getProjectWorkflowsDir, getProjectPluginsDir, getProjectSkillsDir, getProjectSettingsPath, getProjectInstructionsPath, getProjectRulesDir, getGitRootHooksDir, getKnownProjectDirs, getAllProjectSkillDirs, } from "./agent-paths.js";
 export { getBudgetContinuationMessage } from "./token-budget.js";
 export { type SecureStorage, saveApiKey, loadApiKey } from "./secure-storage.js";
 export { createFileWatcher, FileWatcher } from "./file-watcher.js";
 export { TaskStore } from "./task-runtime.js";
 export { createWorktreeBackend } from "./worktree-backend.js";
 export { registerCleanup, runCleanupFunctions } from "./cleanup-registry.js";
-export { atomicWriteFile, readJsonFile, writeJsonFile, loadPersistedMemory, savePersistedMemory, getMemoryFilePath, type PersistedMemory, } from "./disk-storage.js";
+export { atomicWriteFile, readJsonFile, writeJsonFile, } from "./disk-storage.js";
 export { AcpDetector, ACP_BACKENDS } from "./acp-detector.js";
-export { AcpProtocolAdapter, type TranslatedNotification } from "./acp-protocol-adapter.js";
+export { AcpProtocolAdapter, type TranslatedNotification, type AcpHostRequestHandler } from "./acp-protocol-adapter.js";
 export { AcpUsageTracker, type AccumulatedUsage } from "./acp-usage-tracker.js";
 export { AgentConfigStore } from "./agent-config-store.js";
 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, AcpContentItem, AcpPromptResponseUsage, 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 "./acp-types.js";
 export type { AgentsStatusNotification, AgentsErrorNotification, SoloProgressNotification, SoloEvaluationNotification, SoloAgentDeltaNotification, ProductTaskStartedNotification, ProductTaskCompletedNotification, ProductTaskFailedNotification, ProductCheckpointedNotification, ProductBudgetWarningNotification, ProductCompletedNotification, } from "../../protocol/notifications.js";

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

@@ -52,8 +52,10 @@ export interface SessionListEntry {
 /**
  * Append a message to the session transcript.
  * Creates the session directory if it doesn't exist.
+ * When turnId is provided, it acts as a per-turn boundary marker enabling
+ * reconciliation with Gateway's token_usage records.
  */
-export declare function appendMessage(sessionId: string, message: ChatMessage, projectRoot?: string): Promise<void>;
+export declare function appendMessage(sessionId: string, message: ChatMessage, projectRoot?: string, turnId?: string): Promise<void>;
 /**
  * Save session state (cost + metadata) atomically.
  */

package/dist/types/skills/index.d.ts

@@ -1,11 +1,11 @@
 export type { PortableTool, PortableToolResult, ToolContentBlock, } from "./portable-tool.js";
 export { setToolPool, addTool, addTools, removeTool, findTool, hasTool, getToolNames, getToolCount, executeTool, getToolManifest, getTools, activateTool, isToolActivated, clearActivatedTools, AGENT_DISALLOWED_TOOLS, CUSTOM_AGENT_DISALLOWED_TOOLS, filterToolsForAgent, } from "./tools.js";
-export { MEMORY_TOOL_NAME, MEMORY_TOOL_MAX_CONTENT_LENGTH, MEMORY_TOOL_ACTIONS, MEMORY_TOOL_SCHEMA, MEMORY_TOOL_DESCRIPTION, MEMORY_TOOL_LABEL, isMemoryContentSafe, executeMemoryTool, } from "./memory/memory-tool.js";
-export type { MemoryToolAction, MemoryToolParams, MemoryToolResult, MemoryToolExecutorDeps, MediaPreferencesSummary, } from "./memory/memory-tool.js";
-export { MemoryStore, MEMORY_ENTRY_DELIMITER, DEFAULT_MEMORY_CHAR_LIMIT, DEFAULT_USER_CHAR_LIMIT, } from "./memory/memory-store.js";
-export type { MemoryStoreTarget, MemoryStoreResult, MemoryStoreOptions, MemoryStoreSerialized, } from "./memory/memory-store.js";
+export { MEMORY_TOOL_NAME, MEMORY_TOOL_ACTIONS, MEMORY_TOOL_SCHEMA, MEMORY_TOOL_DESCRIPTION, MEMORY_TOOL_LABEL, isMemoryContentSafe, executeMemoryTool, } from "./memory/memory-tool.js";
+export type { MemoryToolAction, MemoryToolParams, MemoryToolResult, MemoryToolExecutorDeps, } from "./memory/memory-tool.js";
+export { Memdir, getMemdirPath, getIndexPath } from "./memory/memdir.js";
+export type { MemdirFileInfo, MemdirResult } from "./memory/memdir.js";
 export { createQMemoryAdapter } from "./memory/qmemory-adapter.js";
-export type { QMemoryAdapterConfig, QMemoryHealthStatus, ExtractedMemoryItem } from "./memory/qmemory-adapter.js";
+export type { QMemoryAdapterConfig, QMemoryHealthStatus, ExtractedMemoryItem, DecayOptions, DecayResult } from "./memory/qmemory-adapter.js";
 export { THINK_TOOL_NAME, THINK_TOOL_SCHEMA, createThinkTool } from "./think-tool.js";
 export type { ThinkToolParams } from "./think-tool.js";
 export { TODO_TOOL_NAME, TODO_TOOL_SCHEMA, TODO_ACTIONS, createTodoTool } from "./todo-tool.js";

package/dist/types/skills/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/skills/memory/memdir.d.ts

@@ -0,0 +1,80 @@
+/** Max chars for INDEX.md to inject into system prompt (CC uses 25KB, we use 12KB). */
+export declare const INDEX_MAX_CHARS = 12288;
+/** Max lines for INDEX.md injection. */
+export declare const INDEX_MAX_LINES = 200;
+/** Max chars for a single topic file. */
+export declare const TOPIC_FILE_MAX_CHARS = 8192;
+/** Root directory: ~/.qlogicagent/memory/ */
+export declare function getMemdirPath(): string;
+/** Full path to INDEX.md */
+export declare function getIndexPath(): string;
+export interface MemdirFileInfo {
+    name: string;
+    /** Size in bytes */
+    size: number;
+    /** Last modified ISO timestamp */
+    modifiedAt: string;
+    /** First non-empty line (preview) */
+    preview?: string;
+}
+export interface MemdirResult {
+    ok: boolean;
+    message: string;
+    /** File path relative to memdir */
+    file?: string;
+    /** Current INDEX.md char usage */
+    indexUsage?: string;
+}
+export declare function isMemoryContentSafe(text: string): boolean;
+export declare class Memdir {
+    private readonly root;
+    private indexCache;
+    constructor(root?: string);
+    /** Get the root directory path of this MEMDIR. */
+    getRootPath(): string;
+    /** Ensure memdir exists with a default INDEX.md if missing. */
+    ensureInitialized(): void;
+    /**
+     * Get INDEX.md content for system prompt injection.
+     * Truncated to INDEX_MAX_CHARS / INDEX_MAX_LINES.
+     */
+    getIndexForPrompt(): string;
+    /** Get raw INDEX.md content (untruncated). */
+    getIndexRaw(): string;
+    /** Get INDEX.md usage stats. */
+    getIndexUsage(): {
+        chars: number;
+        lines: number;
+        percent: number;
+    };
+    /** Append a line/entry to INDEX.md. */
+    addToIndex(content: string): Promise<MemdirResult>;
+    /** Replace text in INDEX.md (str_replace semantics). */
+    replaceInIndex(oldText: string, newText: string): Promise<MemdirResult>;
+    /** Remove text from INDEX.md. */
+    removeFromIndex(oldText: string): Promise<MemdirResult>;
+    /** List all memory files (excluding INDEX.md). */
+    listFiles(): Promise<MemdirFileInfo[]>;
+    /** Create a new topic file. Fails if it already exists. */
+    createFile(name: string, content: string): Promise<MemdirResult>;
+    /** Write/overwrite a topic file. */
+    writeFile(name: string, content: string): Promise<MemdirResult>;
+    /** Read a topic file. */
+    readFile(name: string): Promise<{
+        ok: boolean;
+        content?: string;
+        message: string;
+    }>;
+    /** Delete a topic file. INDEX.md cannot be deleted. */
+    deleteFile(name: string): Promise<MemdirResult>;
+    /** Search all memory files for keyword matches. Returns matching snippets. */
+    searchLocal(query: string): Promise<Array<{
+        file: string;
+        snippet: string;
+        score: number;
+    }>>;
+    private writeIndex;
+    private ensureDir;
+    /** Append an entry to the file listing section of INDEX.md (idempotent). */
+    private appendIndexEntry;
+}

package/dist/types/skills/memory/memory-tool.d.ts

@@ -1,16 +1,8 @@
 import type { MemoryProvider, MemorySearchResult } from "qlogicagent-runtime-contracts";
-import type { MemoryStore, MemoryStoreTarget } from "./memory-store.js";
-export interface MediaPreferencesSummary {
-    imageStyle?: string;
-    videoStyle?: string;
-    musicGenre?: string;
-    musicMood?: string;
-    primaryPurpose?: string;
-    colorPreference?: string;
-}
+import type { Memdir } from "./memdir.js";
 export declare const MEMORY_TOOL_NAME: "memory";
-export declare const MEMORY_TOOL_MAX_CONTENT_LENGTH = 2000;
-export declare const MEMORY_TOOL_ACTIONS: readonly ["add", "replace", "remove", "search"];
+export declare const MEMORY_TOOL_LABEL = "Memory";
+export declare const MEMORY_TOOL_ACTIONS: readonly ["add", "replace", "remove", "create_file", "write_file", "read_file", "delete_file", "list_files", "search"];
 export type MemoryToolAction = (typeof MEMORY_TOOL_ACTIONS)[number];
 export declare const MEMORY_TOOL_SCHEMA: {
     readonly type: "object";
@@ -20,68 +12,48 @@ export declare const MEMORY_TOOL_SCHEMA: {
             readonly enum: string[];
             readonly description: string;
         };
-        readonly target: {
-            readonly type: "string";
-            readonly enum: readonly ["memory", "user"];
-            readonly description: string;
-        };
         readonly content: {
             readonly type: "string";
             readonly description: string;
         };
         readonly old_text: {
             readonly type: "string";
-            readonly description: "Required for 'replace' and 'remove'. A substring that uniquely identifies the note entry to modify.";
+            readonly description: "For 'replace'/'remove': the exact text to find in INDEX.md.";
         };
-        readonly query: {
+        readonly new_text: {
             readonly type: "string";
-            readonly description: "Required for 'search'. Natural language query to find relevant memories.";
+            readonly description: "For 'replace': the replacement text.";
         };
-        readonly category: {
+        readonly file: {
             readonly type: "string";
-            readonly enum: readonly ["profile", "facts", "media", "projects"];
-            readonly description: string;
+            readonly description: "Filename for file operations (e.g. 'project-notes.md', 'lesson-esbuild.md'). Must be kebab-case .md.";
+        };
+        readonly query: {
+            readonly type: "string";
+            readonly description: "For 'search': natural language query to find relevant memories.";
         };
     };
     readonly required: readonly ["action"];
 };
 export declare const MEMORY_TOOL_DESCRIPTION: string;
-export declare const MEMORY_TOOL_LABEL = "Memory";
 export declare function isMemoryContentSafe(text: string): boolean;
 export interface MemoryToolParams {
     action: MemoryToolAction;
-    target?: MemoryStoreTarget;
     content?: string;
     old_text?: string;
+    new_text?: string;
+    file?: string;
     query?: string;
-    category?: "profile" | "facts" | "media" | "projects";
 }
 export interface MemoryToolResult {
     ok: boolean;
     message: string;
     action: string;
-    /** For MD store operations: live entry count */
-    entryCount?: number;
-    /** For MD store operations: usage string */
-    usage?: string;
-    /** For search: qmemory results */
     results?: MemorySearchResult[];
-    /** Indicates MD store was mutated (consumer should persist) */
-    storeModified?: boolean;
-    errorCode?: string;
 }
 export interface MemoryToolExecutorDeps {
-    /** QMemory provider for semantic search. */
-    provider: MemoryProvider;
-    /** Local MD memory store for notes. */
-    store?: MemoryStore;
+    memdir: Memdir;
+    provider?: MemoryProvider;
     userId: string;
-    sessionId?: string;
-    /** Query recalled facts/memories by natural language. */
-    queryGraph?: (query: string, userId: string) => string[];
-    /** Retrieve user profile summary. */
-    getProfileSummary?: (userId: string) => string | null;
-    /** Retrieve media preferences. */
-    getMediaPreferences?: (userId: string) => MediaPreferencesSummary | null;
 }
 export declare function executeMemoryTool(params: MemoryToolParams, deps: MemoryToolExecutorDeps): Promise<MemoryToolResult>;

package/dist/types/skills/memory/memory-write-gate.d.ts

@@ -0,0 +1,46 @@
+import type { MemorySearchResult } from "qlogicagent-runtime-contracts";
+/**
+ * Memory categories for QMemory writes.
+ * Each has different value thresholds and retention policies.
+ */
+export type QMemoryCategory = "lesson" | "preference" | "pattern" | "fact" | "decision" | "skill-learning";
+/**
+ * A candidate memory extracted from a turn.
+ */
+export interface MemoryCandidate {
+    text: string;
+    category: QMemoryCategory;
+    importance: number;
+    tags: string[];
+}
+/**
+ * Extract memory candidates from a completed turn.
+ *
+ * Strategy: scan assistant response for category signal patterns.
+ * This is a fast pattern-based approach (no LLM call needed).
+ * Only extracts segments that match high-value patterns.
+ */
+export declare function extractCandidates(userPrompt: string, assistantResponse: string): MemoryCandidate[];
+/**
+ * Quality gate: filter candidates by minimum importance threshold.
+ */
+export declare function applyQualityGate(candidates: MemoryCandidate[], minImportance?: number): MemoryCandidate[];
+/**
+ * Result of supersedes check for a single candidate.
+ */
+export interface SupersedesCheckResult {
+    candidate: MemoryCandidate;
+    supersedes: string[];
+}
+/**
+ * Check if candidates supersede existing memories.
+ *
+ * Strategy: for each candidate, search QMemory for semantically similar
+ * existing entries. If similarity is high (>0.80) and the candidate is
+ * newer/more specific, mark the old one for supersede.
+ *
+ * @param candidates - Memory candidates to check
+ * @param existingSearch - Function to search existing memories
+ * @returns Candidates with supersedes info
+ */
+export declare function checkSupersedes(candidates: MemoryCandidate[], existingSearch: (query: string) => Promise<MemorySearchResult[]>): Promise<SupersedesCheckResult[]>;

package/dist/types/skills/memory/memory-write-hook.d.ts

@@ -0,0 +1,44 @@
+import type { MemorySearchResult } from "qlogicagent-runtime-contracts";
+import type { ExtractedMemoryItem } from "./qmemory-adapter.js";
+export declare const WRITE_HOOK_CONFIG: {
+    /** Minimum importance to pass the quality gate. */
+    readonly MIN_IMPORTANCE: 0.4;
+    /** Max candidates to write per turn (prevent flood). */
+    readonly MAX_PER_TURN: 3;
+    /** Cooldown between writes (ms) — prevents rapid duplicate writes. */
+    readonly COOLDOWN_MS: 5000;
+};
+export interface MemoryWriteHookDeps {
+    /** Write extracted items to QMemory. */
+    ingestExtracted: (items: ExtractedMemoryItem[], userId: string) => Promise<{
+        memoriesAdded: number;
+    }>;
+    /** Search existing memories (for supersedes check). */
+    searchMemories: (query: string, userId: string) => Promise<MemorySearchResult[]>;
+    /** Remove a superseded memory by ID. */
+    removeMemory?: (memoryId: string) => Promise<boolean>;
+    /** User ID for QMemory writes. */
+    userId: string;
+    /** Logger. */
+    log: {
+        debug(msg: string): void;
+        warn(msg: string): void;
+    };
+}
+/** Per-session state for the write hook. */
+export interface MemoryWriteState {
+    /** Timestamp of last write (for cooldown). */
+    lastWriteAt: number;
+    /** Total memories written this session (for budget). */
+    sessionWrites: number;
+    /** Recent write texts (for intra-session dedup). */
+    recentTexts: Set<string>;
+}
+export declare function createMemoryWriteState(): MemoryWriteState;
+/**
+ * Process a completed turn for memory-worthy content.
+ * Called directly from stdio-server after turn.end (fire-and-forget).
+ *
+ * Pipeline: extract → gate → dedup → supersedes check → write.
+ */
+export declare function processMemoryWriteGate(userPrompt: string, assistantResponse: string, deps: MemoryWriteHookDeps, state: MemoryWriteState): Promise<void>;

package/dist/types/skills/memory/qmemory-adapter.d.ts

@@ -19,6 +19,17 @@ export interface QMemoryAdapterConfig {
     /** Prefix prepended to userId for multi-tenant isolation. */
     userIdPrefix?: string;
 }
+/** Options for triggering a decay cycle. */
+export interface DecayOptions {
+    temporalExpiry?: boolean;
+    stalenessDecay?: boolean;
+    noiseArchival?: boolean;
+}
+/** Result of a decay cycle. */
+export interface DecayResult {
+    decayed: number;
+    archived: number;
+}
 /** Health status returned by qmemory `/v1/health/`. */
 export interface QMemoryHealthStatus {
     status: string;
@@ -40,4 +51,5 @@ export declare function createQMemoryAdapter(config: QMemoryAdapterConfig): Memo
         memoriesAdded: number;
     }>;
     feedback(memoryIds: string[], signal: string, sessionId?: string): Promise<void>;
+    triggerDecay(userId: string, options?: DecayOptions): Promise<DecayResult>;
 };

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

@@ -0,0 +1,54 @@
+import type { QMemoryCategory } from "../../skills/memory/memory-write-gate.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/skills/tools/skill-tool.d.ts

@@ -1,7 +1,7 @@
 import type { PortableTool } from "../portable-tool.js";
 import type { WorkspaceSkill } from "../skill-system/skill-types.js";
 export declare const SKILL_TOOL_NAME: "skill";
-export type SkillAction = "invoke" | "list" | "view" | "create" | "edit" | "patch" | "delete";
+export type SkillAction = "invoke" | "list" | "view" | "create" | "edit" | "patch" | "delete" | "promote" | "install";
 export interface SkillToolParams {
     action: SkillAction;
     name?: string;
@@ -12,18 +12,20 @@ export interface SkillToolParams {
     fileContent?: string;
     oldString?: string;
     newString?: string;
+    /** URL to download skill from (for 'install' action). */
+    url?: string;
 }
 export declare const SKILL_TOOL_SCHEMA: {
     readonly type: "object";
     readonly properties: {
         readonly action: {
             readonly type: "string";
-            readonly enum: readonly ["invoke", "list", "view", "create", "edit", "patch", "delete"];
+            readonly enum: readonly ["invoke", "list", "view", "create", "edit", "patch", "delete", "promote", "install"];
             readonly description: string;
         };
         readonly name: {
             readonly type: "string";
-            readonly description: "Skill name (required for invoke/view/create/edit/patch/delete).";
+            readonly description: "Skill name (required for invoke/view/create/edit/patch/delete/promote).";
         };
         readonly args: {
             readonly type: "string";
@@ -53,6 +55,10 @@ export declare const SKILL_TOOL_SCHEMA: {
             readonly type: "string";
             readonly description: "Replacement text for patch action.";
         };
+        readonly url: {
+            readonly type: "string";
+            readonly description: "URL to download a skill from (for 'install' action). Supports skill stores (skillhub.cn, skill.io, GitHub raw links, etc.) and any direct .md URL.";
+        };
     };
     readonly required: readonly ["action"];
 };
@@ -61,6 +67,8 @@ export interface SkillListItem {
     description: string;
     version?: string;
     category?: string;
+    /** Where the skill lives: "global" (user-level) or "project" (cwd-level). */
+    scope?: "global" | "project" | "plugin" | "config";
 }
 export interface SkillListOutput {
     skills: SkillListItem[];
@@ -91,11 +99,16 @@ export interface SkillToolDeps {
     manageSkill(params: {
         action: string;
         name: string;
+        category?: string;
         content?: string;
         filePath?: string;
         fileContent?: string;
         oldString?: string;
         newString?: string;
     }): Promise<SkillManageResult>;
+    /** Promote a project-level skill to user/global level. Returns success message. */
+    promoteSkill?(name: string): Promise<SkillManageResult>;
+    /** Install a skill from a URL. Downloads .md content and saves it. */
+    installSkill?(url: string, name?: string): Promise<SkillManageResult>;
 }
 export declare function createSkillMetaTool(deps: SkillToolDeps): PortableTool<SkillToolParams>;

package/dist/types/transport/acp-event-emitter.d.ts

@@ -0,0 +1,21 @@
+/**
+ * ACP Event Emitter — translates internal qlogicagent notifications to ACP
+ * session/update notifications.
+ *
+ * Maps the 47+ internal notification methods (turn.delta, turn.tool_call, etc.)
+ * to 9 standard + 19 extended ACP sessionUpdate types.
+ *
+ * Usage: Called by the StdioServer event loop. Instead of (or in addition to)
+ * emitting raw notifications, events are translated and emitted through the
+ * AcpServer.emitSessionUpdate() method.
+ */
+import type { AcpServer } from "./acp-server.js";
+/**
+ * Translates and emits a qlogicagent internal notification as an ACP session/update.
+ *
+ * @param server The AcpServer instance to emit through
+ * @param sessionId Active ACP session ID
+ * @param method Internal notification method name
+ * @param params Internal notification payload
+ */
+export declare function emitAcpUpdate(server: AcpServer, sessionId: string, method: string, params: Record<string, unknown>): void;