qlogicagent 2.1.0 → 2.2.0

package/dist/types/llm/transports/gemini-generatecontent.d.ts

@@ -21,6 +21,7 @@
  */
 import type { LLMChunk, LLMRequest, LLMTransport } from "../transport.js";
 import type { ProviderQuirks } from "../provider-def.js";
+import type { FileUploadAdapter } from "../file-upload-service.js";
 export interface GeminiGenerateContentTransportConfig {
     /** Base URL, e.g. "https://generativelanguage.googleapis.com/v1beta" */
     baseUrl: string;
@@ -28,11 +29,14 @@ export interface GeminiGenerateContentTransportConfig {
     timeoutMs?: number;
     /** Provider-specific quirks */
     quirks?: ProviderQuirks;
+    /** File upload adapter for resolving local media URLs via upload instead of base64. */
+    fileUploadAdapter?: FileUploadAdapter;
 }
 export declare class GeminiGenerateContentTransport implements LLMTransport {
     private baseUrl;
     private timeoutMs;
     private quirks;
+    private fileUploadAdapter?;
     constructor(config: GeminiGenerateContentTransportConfig);
     stream(request: LLMRequest, apiKey: string, signal?: AbortSignal): AsyncGenerator<LLMChunk>;
     private buildRequestBody;

package/dist/types/llm/transports/media-resolve.d.ts

@@ -1,25 +1,50 @@
 /**
- * Media URL Resolution — converts local/private URLs to inline base64 data URLs.
+ * Media URL Resolution — resolves local/private URLs for cloud LLM APIs.
  *
- * Cloud LLM APIs (OpenAI, Anthropic, DeepSeek) cannot fetch content from
- * localhost or private networks. This utility detects such URLs and resolves
- * them to base64 data URLs that can be sent inline.
+ * Cloud LLM APIs (OpenAI, Anthropic, DeepSeek, etc.) cannot fetch content
+ * from localhost or private networks.
+ *
+ * **Primary approach (upload-based):**
+ *   Local URLs are fetched → uploaded to provider's File API or Aliyun OSS → public URL returned.
+ *   This is the ONLY approach for images, video, and documents.
+ *
+ * **Audio exception (base64):**
+ *   OpenAI's input_audio.data API field mandates base64 encoding.
+ *   resolveMediaUrl() is retained ONLY for this case.
  *
  * URL-first design: the gateway stores media as HTTP URLs; this layer handles
  * the last-mile transformation before sending to provider APIs.
  */
+import type { FileUploadAdapter } from "../file-upload-service.js";
 /** Check if a URL points to a local/private address that cloud APIs cannot reach. */
 export declare function isLocalUrl(url: string): boolean;
+export interface MediaResolveContext {
+    /** Provider-specific upload adapter. */
+    uploadAdapter: FileUploadAdapter;
+    /** API key for the upload. */
+    apiKey: string;
+    /** Abort signal. */
+    signal?: AbortSignal;
+}
 /**
- * Resolve a URL to a base64 data URL if it's a local address.
- * Public URLs are returned as-is (the LLM API can fetch them directly).
+ * Resolve a local URL by uploading to the provider's File API.
+ * This is the **preferred** method for all media types.
  *
- * Returns the original URL for non-local addresses.
- * Returns a `data:<mime>;base64,...` string for local addresses.
+ * Public URLs pass through unchanged.
+ * Local URLs are uploaded → public URL or file_id returned.
  */
-export declare function resolveMediaUrl(url: string, fallbackMime?: string): Promise<string>;
+export declare function resolveMediaUrlViaUpload(url: string, ctx: MediaResolveContext): Promise<string>;
+/**
+ * Batch-resolve URLs via upload. Best-effort: failures return original URL.
+ */
+export declare function resolveMediaUrlsViaUpload(urls: string[], ctx: MediaResolveContext): Promise<string[]>;
 /**
- * Batch-resolve multiple URLs. Returns array in same order.
- * Failures are logged and the original URL is kept (best-effort).
+ * Resolve local audio URL to base64 data URL.
+ *
+ * ONLY for audio — OpenAI's input_audio.data API field mandates base64 encoding.
+ * There is no upload alternative for audio in the OpenAI API.
+ *
+ * For images/video/documents: ALWAYS use resolveMediaUrlViaUpload() instead.
+ * base64 is forbidden for non-audio media per project architecture rules.
  */
-export declare function resolveMediaUrls(urls: string[], fallbackMime?: string): Promise<string[]>;
+export declare function resolveMediaUrl(url: string, fallbackMime?: string): Promise<string>;

package/dist/types/llm/transports/openai-chat.d.ts

@@ -13,6 +13,7 @@
  */
 import type { LLMChunk, LLMRequest, LLMTransport, FIMRequest, FIMChunk } from "../transport.js";
 import type { ProviderQuirks } from "../provider-def.js";
+import type { FileUploadAdapter } from "../file-upload-service.js";
 export interface OpenAIChatTransportConfig {
     baseUrl: string;
     /** Additional headers (e.g. for specific providers) */
@@ -25,6 +26,8 @@ export interface OpenAIChatTransportConfig {
     omitZeroTemperature?: boolean;
     /** Provider-specific quirks (CC/altcode parity) */
     quirks?: ProviderQuirks;
+    /** File upload adapter for resolving local media URLs via upload instead of base64. */
+    fileUploadAdapter?: FileUploadAdapter;
 }
 export declare class OpenAIChatTransport implements LLMTransport {
     private baseUrl;
@@ -33,6 +36,7 @@ export declare class OpenAIChatTransport implements LLMTransport {
     private supportsStreamOptions;
     private omitZeroTemperature;
     private quirks;
+    private fileUploadAdapter?;
     private cumulativeReasoningLen;
     private cumulativeContentLen;
     constructor(config: OpenAIChatTransportConfig);

package/dist/types/llm/transports/openai-responses.d.ts

@@ -25,17 +25,20 @@
  */
 import type { LLMChunk, LLMRequest, LLMTransport } from "../transport.js";
 import type { ProviderQuirks } from "../provider-def.js";
+import type { FileUploadAdapter } from "../file-upload-service.js";
 export interface OpenAIResponsesTransportConfig {
     baseUrl: string;
     extraHeaders?: Record<string, string>;
     timeoutMs?: number;
     quirks?: ProviderQuirks;
+    fileUploadAdapter?: FileUploadAdapter;
 }
 export declare class OpenAIResponsesTransport implements LLMTransport {
     private baseUrl;
     private extraHeaders;
     private timeoutMs;
     private quirks;
+    private fileUploadAdapter?;
     constructor(config: OpenAIResponsesTransportConfig);
     stream(request: LLMRequest, apiKey: string, signal?: AbortSignal): AsyncGenerator<LLMChunk>;
     private buildRequestBody;

package/dist/types/llm/transports/volcengine-responses.d.ts

@@ -18,17 +18,21 @@
  */
 import type { LLMChunk, LLMRequest, LLMTransport } from "../transport.js";
 import type { ProviderQuirks } from "../provider-def.js";
+import type { FileUploadAdapter } from "../file-upload-service.js";
 export interface VolcengineResponsesTransportConfig {
     baseUrl: string;
     extraHeaders?: Record<string, string>;
     timeoutMs?: number;
     quirks?: ProviderQuirks;
+    /** File upload adapter for resolving local media URLs via upload instead of base64. */
+    fileUploadAdapter?: FileUploadAdapter;
 }
 export declare class VolcengineResponsesTransport implements LLMTransport {
     private baseUrl;
     private extraHeaders;
     private timeoutMs;
     private quirks;
+    private fileUploadAdapter?;
     constructor(config: VolcengineResponsesTransportConfig);
     stream(request: LLMRequest, apiKey: string, signal?: AbortSignal): AsyncGenerator<LLMChunk>;
     /**

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,24 @@ 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;
+}
 export interface NotificationMethodMap {
     "turn.start": TurnStartNotification;
     "turn.delta": TurnDeltaNotification;
@@ -425,6 +462,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 +473,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 +492,9 @@ export interface NotificationMethodMap {
     "product.checkpointed": ProductCheckpointedNotification;
     "product.budgetWarning": ProductBudgetWarningNotification;
     "product.completed": ProductCompletedNotification;
+    "project.created": ProjectCreatedNotification;
+    "project.switched": ProjectSwitchedNotification;
+    "project.deleted": ProjectDeletedNotification;
 }
 /** 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/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,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/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;