qlogicagent 2.1.0 → 2.3.0

package/dist/types/orchestration/subagent/fork-subagent.d.ts

@@ -9,12 +9,12 @@
  * 5. Depth control via in-memory counter (not DB-based)
  */
 import type { AgentDefinition } from "./agent-registry.js";
+import { MAX_FORK_DEPTH } from "../../agent/tunable-defaults.js";
 /** Sentinel tag injected into fork children to prevent recursive forking. */
 export declare const FORK_SENTINEL_TAG = "<fork-child-context>";
 /** Placeholder text used for all tool_results in shared prefix (ensures byte-identical prefix). */
 export declare const FORK_PLACEHOLDER_RESULT = "Fork started \u2014 processing in background";
-/** Maximum fork depth for in-memory agents (CC: MAX_FORK_DEPTH). */
-export declare const MAX_FORK_DEPTH = 4;
+export { MAX_FORK_DEPTH };
 export interface ForkContext {
     /** Parent's full message history (becomes shared prefix for cache). */
     parentMessages: unknown[];

package/dist/types/orchestration/tool-loop/tool-schema.d.ts

@@ -38,5 +38,6 @@ export declare function buildToolResultMessage(callId: string, result: {
     payload?: unknown;
     error?: string;
     toolReferences?: string[];
+    imageUrls?: string[];
 }): Record<string, unknown>;
 export declare function cleanToolSchemaForGemini(schema: Record<string, unknown>): unknown;

package/dist/types/protocol/methods.d.ts

@@ -302,6 +302,56 @@ export interface TasksCancelResult {
     ok: boolean;
     message: string;
 }
+export type ProjectType = "default" | "personal" | "group";
+export type ProjectStatus = "active" | "archived";
+export interface ProjectInfo {
+    id: string;
+    name: string;
+    workspaceDir: string;
+    type: ProjectType;
+    status: ProjectStatus;
+    groupId?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ProjectCreateParams {
+    name: string;
+    workspaceDir: string;
+    type?: ProjectType;
+    groupId?: string;
+}
+export interface ProjectCreateResult {
+    ok: boolean;
+    project: ProjectInfo;
+}
+export interface ProjectListParams {
+}
+export interface ProjectListResult {
+    projects: ProjectInfo[];
+}
+export interface ProjectDeleteParams {
+    projectId: string;
+}
+export interface ProjectDeleteResult {
+    ok: boolean;
+    switchedTo?: ProjectInfo;
+}
+export interface SessionSwitchProjectParams {
+    projectId?: string;
+    projectName?: string;
+    workspaceDir?: string;
+}
+export interface SessionSwitchProjectResult {
+    ok: boolean;
+    project: ProjectInfo;
+}
+export interface SessionGetStateParams {
+}
+export interface SessionGetStateResult {
+    sessionId: string;
+    activeProject: ProjectInfo | null;
+    projects: ProjectInfo[];
+}
 export interface RpcMethodMap {
     "initialize": {
         params: InitializeParams;
@@ -484,6 +534,26 @@ export interface RpcMethodMap {
         params: undefined;
         result: ProductSummary[];
     };
+    "project.create": {
+        params: ProjectCreateParams;
+        result: ProjectCreateResult;
+    };
+    "project.list": {
+        params: ProjectListParams;
+        result: ProjectListResult;
+    };
+    "project.delete": {
+        params: ProjectDeleteParams;
+        result: ProjectDeleteResult;
+    };
+    "session.switchProject": {
+        params: SessionSwitchProjectParams;
+        result: SessionSwitchProjectResult;
+    };
+    "session.getState": {
+        params: SessionGetStateParams;
+        result: SessionGetStateResult;
+    };
 }
 /** All known RPC method names. */
 export type RpcMethod = keyof RpcMethodMap;

package/dist/types/protocol/notifications.d.ts

@@ -192,6 +192,16 @@ export interface TurnMediaProgressNotification {
     /** Provider id. */
     provider?: string;
 }
+/** Media files auto-downloaded to local storage (~/.qlogicagent/media/). */
+export interface TurnMediaPersistedNotification {
+    turnId: string;
+    files: Array<{
+        remoteUrl: string;
+        localPath: string;
+        bytes: number;
+        mimeType: string;
+    }>;
+}
 /** Full todo list updated — enables DeerFlow-style todo panel sync. */
 export interface TurnTodosUpdatedNotification {
     turnId?: string;
@@ -279,6 +289,15 @@ export interface MemoryUpdatedNotification {
     /** Human-readable summary of what changed. */
     summary?: string;
 }
+/** Emitted when importance decay runs after a Dream consolidation. */
+export interface MemoryDecayCompletedNotification {
+    /** Number of memories whose importance was reduced. */
+    decayed: number;
+    /** Number of memories archived (below threshold). */
+    archived: number;
+    /** Duration in ms. */
+    durationMs: number;
+}
 /** Session metadata changed (title, model, etc.). */
 export interface SessionInfoNotification {
     sessionId: string;
@@ -407,6 +426,40 @@ export interface ProductCompletedNotification {
     productId: string;
     summary: string;
 }
+/** A project was created. */
+export interface ProjectCreatedNotification {
+    id: string;
+    name: string;
+    workspaceDir: string;
+    type: string;
+    groupId?: string;
+}
+/** Active project was switched. */
+export interface ProjectSwitchedNotification {
+    id: string;
+    name: string;
+    workspaceDir: string;
+}
+/** A project was deleted. */
+export interface ProjectDeletedNotification {
+    id: string;
+}
+/** A project was renamed. */
+export interface ProjectRenamedNotification {
+    id: string;
+    name: string;
+    workspaceDir: string;
+}
+/** A project was archived. */
+export interface ProjectArchivedNotification {
+    id: string;
+}
+/** A project was unarchived (restored). */
+export interface ProjectUnarchivedNotification {
+    id: string;
+    name: string;
+    workspaceDir: string;
+}
 export interface NotificationMethodMap {
     "turn.start": TurnStartNotification;
     "turn.delta": TurnDeltaNotification;
@@ -425,6 +478,7 @@ export interface NotificationMethodMap {
     "turn.annotations": TurnAnnotationsNotification;
     "turn.media_result": TurnMediaResultNotification;
     "turn.media_progress": TurnMediaProgressNotification;
+    "turn.media_persisted": TurnMediaPersistedNotification;
     "turn.todos_updated": TurnTodosUpdatedNotification;
     "task.updated": TaskUpdatedNotification;
     "turn.exec_progress": TurnExecProgressNotification;
@@ -435,6 +489,7 @@ export interface NotificationMethodMap {
     "turn.skill_instruction": TurnSkillInstructionNotification;
     "turn.ask_user": TurnAskUserNotification;
     "memory.updated": MemoryUpdatedNotification;
+    "memory.decay.completed": MemoryDecayCompletedNotification;
     "session.info": SessionInfoNotification;
     "permission.rule_updated": PermissionRuleUpdatedNotification;
     "team.updated": TeamUpdatedNotification;
@@ -453,6 +508,12 @@ export interface NotificationMethodMap {
     "product.checkpointed": ProductCheckpointedNotification;
     "product.budgetWarning": ProductBudgetWarningNotification;
     "product.completed": ProductCompletedNotification;
+    "project.created": ProjectCreatedNotification;
+    "project.switched": ProjectSwitchedNotification;
+    "project.deleted": ProjectDeletedNotification;
+    "project.renamed": ProjectRenamedNotification;
+    "project.archived": ProjectArchivedNotification;
+    "project.unarchived": ProjectUnarchivedNotification;
 }
 /** All known notification method names. */
 export type NotificationMethod = keyof NotificationMethodMap;

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

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

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

@@ -2,11 +2,8 @@ import type { HookRegistry } from "../../contracts/hooks.js";
 import type { MemoryProvider } from "qlogicagent-runtime-contracts";
 import type { Memdir } from "../../skills/memory/memdir.js";
 export declare const MEMORY_PREFETCH_CONFIG: {
-    /** Max bytes of memory content to inject per session (CC: 60KB) */
     readonly MAX_SESSION_BYTES: number;
-    /** Max results per recall query */
     readonly LIMIT_PER_RECALL: 10;
-    /** Max entries in surfaced-path LRU set */
     readonly MAX_SURFACED_ENTRIES: 100;
 };
 export interface MemoryHooksDeps {

package/dist/types/runtime/hooks/skill-recall-hooks.d.ts

@@ -1,14 +1,12 @@
 import type { HookRegistry } from "../../contracts/hooks.js";
 export declare const SKILL_RECALL_CONFIG: {
-    /** Max number of cross-project skills to inject per turn. */
     readonly MAX_RECALLED_SKILLS: 3;
-    /** Max chars of skill content to include in recall context. */
     readonly MAX_SKILL_CONTENT_CHARS: 800;
-    /** Cache TTL for known project skill index (ms). */
     readonly CACHE_TTL_MS: number;
 };
 /**
- * Detect whether user message contains retrospective/cross-reference semantics.
+ * Detect whether user message contains retrospective/cross-reference semantics
+ * OR similar-task patterns that could benefit from existing skills.
  * Returns extracted keywords for skill matching if triggered, or null.
  */
 export declare function detectRetrospectiveTrigger(message: string): string[] | null;

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

@@ -39,6 +39,8 @@ export declare function getUserWorkflowsDir(): string;
 export declare function getUserInstructionsPath(): string;
 /** `~/.qlogicagent/rules/` */
 export declare function getUserRulesDir(): string;
+/** `~/.qlogicagent/media/` — auto-downloaded media files (images, videos, audio). */
+export declare function getUserMediaDir(): string;
 /** `<cwd>/.qlogicagent/` */
 export declare function getProjectAgentDir(cwd?: string): string;
 /** `<cwd>/.qlogicagent/workflows/` */
@@ -51,6 +53,10 @@ export declare function getProjectSkillsDir(cwd?: string): string;
 export declare function getProjectSettingsPath(cwd?: string): string;
 /** `<cwd>/.qlogicagent/INSTRUCTIONS.md` */
 export declare function getProjectInstructionsPath(cwd?: string): string;
+/** `<cwd>/.qlogicagent/instructions/` — project-scoped instruction files (CRUD via RPC) */
+export declare function getProjectInstructionsDir(cwd?: string): string;
+/** `<cwd>/.qlogicagent/plans/` — project-scoped plan files */
+export declare function getProjectPlansDir(cwd?: string): string;
 /** `<cwd>/.qlogicagent/rules/` */
 export declare function getProjectRulesDir(cwd?: string): string;
 /** `<cwd>/.qlogicagent/sessions/` */

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

@@ -1,6 +1,8 @@
-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 { 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";

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,36 @@
+/**
+ * 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 renameProject(projectId: string, newName: string): ProjectInfo | null;
+export declare function archiveProject(projectId: string): {
+    archived: boolean;
+    switchedTo?: ProjectInfo;
+};
+export declare function unarchiveProject(projectId: string): ProjectInfo | null;
+export declare function findByGroupId(groupId: string): ProjectInfo | null;
+export declare function archiveByGroupId(groupId: string): {
+    archived: boolean;
+    projectId?: string;
+    switchedTo?: ProjectInfo;
+};

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

@@ -9,8 +9,11 @@
  *
  * 2. **First-message prompt injection**: For agents without native skill
  *    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";
+export { SKILL_INJECTION_MAX_CHARS, SKILL_INJECTION_MAX_COUNT };
 export declare class SkillInjector {
     /**
      * Synchronize skills to an agent's native skill directory.
@@ -24,6 +27,9 @@ export declare class SkillInjector {
      * Build a skill description block to prepend to the first message
      * for agents that don't support native skill directories.
      *
+     * Respects SKILL_INJECTION_MAX_CHARS and SKILL_INJECTION_MAX_COUNT
+     * to prevent token bloat.
+     *
      * @param cwd - Project working directory (for project-level skills)
      * @returns Markdown text with skill instructions, or empty string if no skills.
      */
@@ -44,8 +50,9 @@ export declare class SkillInjector {
      */
     applySkills(capabilities?: AgentCapabilities, cwd?: string): string;
     /**
-     * Collect all skill file paths from user-level and project-level dirs.
-     * Only `.md` files are treated as skills.
+     * Collect all skill file paths from project-level and user-level dirs.
+     * Skills are stored as `<dir>/<skillName>/SKILL.md`.
+     * Priority: project > global (project listed first for budget-constrained injection).
      */
     private collectSkillPaths;
 }

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

@@ -8,8 +8,6 @@ export { createQMemoryAdapter } 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/memdir.d.ts

@@ -57,8 +57,13 @@ export declare class Memdir {
     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. */
+    /** 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;

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

@@ -1,4 +1,4 @@
-import type { QMemoryCategory } from "../../skills/memory/memory-write-gate.js";
+import type { QMemoryCategory } from "./categories.js";
 /** Detected query scenario with preferred categories. */
 export interface RecallCategoryHint {
     /** Detected scenario label. */

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.

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

@@ -5,7 +5,12 @@
 export interface ToolContentBlock {
     type: "text" | "image";
     text?: string;
-    /** base64-encoded image data (only when type === "image") */
+    /**
+     * base64-encoded image data (only when type === "image").
+     * Used by browser screenshots and MCP tools where data is already in memory.
+     * The tool invoker promotes these to data-URL imageUrls for transport resolution.
+     * For file-based images, prefer returning localPath via PortableToolResult.imageUrls.
+     */
     data?: string;
     mimeType?: string;
 }
@@ -16,6 +21,12 @@ export interface PortableToolResult {
     content: ToolContentBlock[];
     /** Arbitrary structured metadata for the calling runtime. */
     details?: Record<string, unknown>;
+    /**
+     * Local image file paths produced by this tool (e.g. read tool reading an image).
+     * Transport layer resolves these via FileUploadAdapter before sending to the LLM.
+     * This avoids loading large files into memory as base64.
+     */
+    imageUrls?: string[];
 }
 /**
  * A runtime-agnostic tool definition.
@@ -23,7 +34,7 @@ export interface PortableToolResult {
  * @typeParam TParams The expected parameter shape (for TypeScript consumers).
  */
 export interface PortableTool<TParams = Record<string, unknown>> {
-    /** Unique tool name (e.g. "think", "todo", "memory"). */
+    /** Unique tool name (e.g. "think", "task", "memory"). */
     name: string;
     /** Human-readable label. */
     label: string;