qlogicagent 2.0.0 → 2.2.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,11 +1,13 @@
-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, getProjectInstructionsDir, getProjectPlansDir, getProjectRulesDir, getGitRootHooksDir, getKnownProjectDirs, getAllProjectSkillDirs, } from "./agent-paths.js";
 export { getBudgetContinuationMessage } from "./token-budget.js";
 export { type SecureStorage, saveApiKey, loadApiKey } from "./secure-storage.js";
+export { ProjectInstructionsStore, type InstructionFile } from "./project-instructions-store.js";
+export { ProjectPlanStore, type PlanEntry } from "./project-plan-store.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, type AcpHostRequestHandler } from "./acp-protocol-adapter.js";
 export { AcpUsageTracker, type AccumulatedUsage } from "./acp-usage-tracker.js";

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

@@ -0,0 +1,71 @@
+/**
+ * MediaPersistence — Auto-download generated media to local storage.
+ *
+ * When LLM tools generate files (images, videos, audio) and return
+ * cloud URLs, this service downloads them to a persistent local directory
+ * so the user can access them offline without manual intervention.
+ *
+ * Storage layout:
+ *   ~/.qlogicagent/media/
+ *   ├── <session-or-date>/
+ *   │   ├── image_20260520_143022_abc.png
+ *   │   ├── video_20260520_143055_def.mp4
+ *   │   └── audio_20260520_143100_ghi.mp3
+ *
+ * Integration:
+ *   Called from the tool result pipeline in tool-loop.ts.
+ *   When a tool result's `details.mediaUrls` contains URLs,
+ *   each URL is downloaded and the local path is added to details.
+ */
+export interface MediaDownloadResult {
+    /** Original cloud URL. */
+    remoteUrl: string;
+    /** Local file path after download. */
+    localPath: string;
+    /** File size in bytes. */
+    bytes: number;
+    /** MIME type (from Content-Type header). */
+    mimeType: string;
+}
+export interface MediaPersistenceConfig {
+    /**
+     * Project working directory. When set, media downloads to `{projectDir}/media/`.
+     * Takes precedence over `mediaDir`. This is the preferred approach — generated
+     * media files belong to the project, not the global user home.
+     */
+    projectDir?: string;
+    /** Base directory for media storage. Default: ~/.qlogicagent/media/ (fallback only). */
+    mediaDir?: string;
+    /** Maximum file size to download (bytes). Default: 500MB. */
+    maxFileSize?: number;
+    /** Download timeout per file (ms). Default: 300_000 (5 min). */
+    timeoutMs?: number;
+}
+export declare class MediaPersistence {
+    private mediaDir;
+    private readonly maxFileSize;
+    private readonly timeoutMs;
+    constructor(config?: MediaPersistenceConfig);
+    /** Update media directory to use a specific project root. */
+    setProjectDir(projectDir: string): void;
+    /**
+     * Download a remote URL to local storage.
+     * Returns the local file path and metadata.
+     */
+    download(remoteUrl: string, hint?: {
+        type?: string;
+        sessionId?: string;
+    }): Promise<MediaDownloadResult>;
+    /**
+     * Download multiple URLs. Returns results for successful downloads.
+     * Failed downloads are logged but don't throw.
+     */
+    downloadAll(urls: string[], hint?: {
+        type?: string;
+        sessionId?: string;
+    }, log?: {
+        warn: (msg: string) => void;
+    }): Promise<MediaDownloadResult[]>;
+    /** Get the base media directory path. */
+    getMediaDir(): string;
+}

package/dist/types/runtime/infra/project-instructions-store.d.ts

@@ -0,0 +1,30 @@
+/**
+ * ProjectInstructionsStore — CRUD for project-scoped instruction files.
+ *
+ * Storage location: `<workspace>/.qlogicagent/instructions/*.md`
+ * Format matches Gateway's InstructionsStore output for seamless migration.
+ */
+export interface InstructionFile {
+    filename: string;
+    content: string;
+    sizeBytes: number;
+}
+export declare class ProjectInstructionsStore {
+    private dir;
+    constructor(cwd: string);
+    /** List all instruction files for the project. */
+    list(): InstructionFile[];
+    /** Read a single instruction file. */
+    read(filename: string): InstructionFile | null;
+    /** Write (create or update) an instruction file. */
+    write(filename: string, content: string): InstructionFile;
+    /** Delete an instruction file. */
+    remove(filename: string): boolean;
+    /**
+     * Load all instruction files and concatenate into a single block
+     * for agent system context injection.
+     */
+    loadAll(): string;
+    private isValidFilename;
+    private getDirSize;
+}

package/dist/types/runtime/infra/project-plan-store.d.ts

@@ -0,0 +1,27 @@
+/**
+ * ProjectPlanStore — CRUD for project-scoped plan files.
+ *
+ * Storage location: `<workspace>/.qlogicagent/plans/*.md`
+ * Each plan is a markdown file with YAML frontmatter (slug, status, timestamps).
+ */
+export interface PlanEntry {
+    slug: string;
+    status: "active" | "completed" | "abandoned";
+    content: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export declare class ProjectPlanStore {
+    private dir;
+    constructor(cwd: string);
+    /** List all plans. */
+    list(): PlanEntry[];
+    /** Load active plans only. */
+    loadActive(): PlanEntry[];
+    /** Load a single plan by slug. */
+    load(slug: string): PlanEntry | null;
+    /** Save or update a plan. */
+    save(slug: string, content: string): void;
+    /** Delete a plan. */
+    remove(slug: string): boolean;
+}

package/dist/types/runtime/infra/project-store.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Local Project Store — persists project metadata to ~/.qlogicagent/projects.json.
+ *
+ * This is the Agent-side (runtime authority) project registry.
+ * Hub maintains a mirror copy via EventBus → HubSubscriber → hub.persistProject.
+ *
+ * Direction A: Agent is the source of truth for project state.
+ */
+import type { ProjectInfo, ProjectType } from "../../protocol/methods.js";
+export declare function createProject(params: {
+    name: string;
+    workspaceDir: string;
+    type?: ProjectType;
+    groupId?: string;
+}): ProjectInfo;
+export declare function listProjects(): ProjectInfo[];
+export declare function getActiveProject(): ProjectInfo | null;
+export declare function getProjectById(projectId: string): ProjectInfo | null;
+export declare function switchProject(projectId: string): ProjectInfo | null;
+export declare function deleteProject(projectId: string): {
+    deleted: boolean;
+    switchedTo?: ProjectInfo;
+};
+export declare function getOrCreateDefaultProject(defaultWorkspaceDir: string): ProjectInfo;
+export declare function findByGroupId(groupId: string): ProjectInfo | null;
+export declare function archiveByGroupId(groupId: string): {
+    archived: boolean;
+    projectId?: string;
+    switchedTo?: ProjectInfo;
+};

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,15 +1,13 @@
 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";
-export type { TodoToolParams, TodoToolOptions, TodoAction } from "./todo-tool.js";
 export { READ_TOOL_NAME, READ_TOOL_SCHEMA, createReadTool } from "./tools/read-tool.js";
 export type { ReadToolParams, ReadToolDeps, ReadResultType } from "./tools/read-tool.js";
 export { WRITE_TOOL_NAME, WRITE_TOOL_SCHEMA, createWriteTool } from "./tools/write-tool.js";
@@ -54,8 +52,8 @@ export { PATCH_TOOL_NAME, PATCH_TOOL_SCHEMA, createPatchTool, fuzzyFind } from "
 export type { PatchToolParams, PatchToolDeps, PatchResult, MatchStrategy, MatchResult } from "./tools/patch-tool.js";
 export { AGENT_TOOL_NAME, AGENT_TOOL_SCHEMA, createAgentTool } from "./tools/agent-tool.js";
 export type { AgentToolParams, AgentToolDeps, AgentResult } from "./tools/agent-tool.js";
-export { TASK_TOOL_NAME, TASK_TOOL_SCHEMA, createTaskTool } from "./tools/task-tool.js";
-export type { TaskToolParams, TaskToolDeps, TaskInfo, TaskResult, TaskAction, TaskStatus } from "./tools/task-tool.js";
+export { TASK_TOOL_NAME, TASK_TOOL_SCHEMA, TASK_ACTIONS, createTaskTool, summarizeTaskList } from "./tools/task-tool.js";
+export type { TaskToolParams, TaskToolOptions, TaskToolHooks, TaskItem, TaskListSummary, TaskAction, TaskStatus } from "./tools/task-tool.js";
 export { REPL_TOOL_NAME, REPL_TOOL_SCHEMA, REPL_HIDES_TOOLS, createReplTool } from "./tools/repl-tool.js";
 export type { ReplToolParams, ReplToolDeps, ReplPrimitives, ReplExecResult } from "./tools/repl-tool.js";
 export { BROWSER_TOOL_NAME, BROWSER_TOOL_SCHEMA, createBrowserTool } from "./tools/browser-tool.js";

package/dist/types/skills/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/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,85 @@
+/** 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. Auto-splits if content > 8KB. */
+    writeFile(name: string, content: string): Promise<MemdirResult>;
+    /**
+     * Auto-split: write oversized content into numbered part files.
+     * e.g. "lesson-docker.md" → "lesson-docker-1.md", "lesson-docker-2.md"
+     */
+    private writeFileSplit;
+    /** 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/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 "./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/skills/permissions/group-security-policy.d.ts

@@ -0,0 +1,15 @@
+import type { PermissionRuleEntry } from "./types.js";
+/**
+ * File path patterns considered sensitive — reading/writing these
+ * is blocked in group sessions. Used by the file access guard.
+ */
+export declare const GROUP_SENSITIVE_FILE_PATTERNS: readonly RegExp[];
+/**
+ * Returns the set of permission rules to inject for group sessions.
+ * These should be prepended to the rule engine (first-match wins).
+ */
+export declare function getGroupSecurityRules(): PermissionRuleEntry[];
+/**
+ * Checks if a file path matches sensitive patterns blocked in group mode.
+ */
+export declare function isGroupSensitivePath(filePath: string): boolean;

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

@@ -9,4 +9,5 @@ export { ClassifierCache } from "./classifier-cache.js";
 export type { CachedClassification } from "./classifier-cache.js";
 export { watchSettings, loadInitialSettings } from "./settings-watcher.js";
 export type { SettingsFile, SettingsWatcherDeps } from "./settings-watcher.js";
+export { getGroupSecurityRules, isGroupSensitivePath } from "./group-security-policy.js";
 export type { PermissionMode, PermissionBehavior, PermissionResult, PermissionRuleEntry, PermissionConfig, PermissionUpdate, PermissionDecisionReason, ToolPermissionCheckInput, ApprovalRequest, ApprovalResponse, } from "./types.js";

package/dist/types/skills/plugins/plugin-loader.d.ts

@@ -32,6 +32,11 @@ export declare class PluginLoader {
      * Get list of all loaded plugins.
      */
     getLoaded(): LoadedPlugin[];
+    /**
+     * Discover and load NEW plugins that weren't present during initial loadAll().
+     * Call per-turn to pick up newly-created skill directories (铁律 #16).
+     */
+    discoverNew(): Promise<number>;
     /**
      * Re-check activation for plugins whose TTL has expired.
      * Call this before tool resolution or periodically in the agent loop.