comisai 1.0.19 → 1.0.23

package/node_modules/@comis/skills/dist/bridge/tool-search-hints.js

@@ -1,68 +0,0 @@
-/**
- * Per-tool search hints for deferred tool discovery (Phase 569: DISC-01, DISC-03).
- *
- * Registers searchHint for all 35 deferrable tools. Each hint is max 80 chars,
- * lowercase, space-separated keyword synonyms that enrich BM25 matching in
- * discover_tools. Uses merge semantics so existing metadata (isReadOnly,
- * maxResultSizeChars, outputSchema, etc.) is preserved.
- *
- * Import this module for side effects only -- it runs registerToolMetadata()
- * calls at module scope. Imported from tool-bridge.ts to ensure hints are
- * registered before discover_tools execute() reads them.
- *
- * @module
- */
-import { registerToolMetadata } from "@comis/core";
-// ===========================================================================
-// Session tools (9)
-// ===========================================================================
-registerToolMetadata("sessions_list", { searchHint: "active sessions connections users online list enumerate" });
-registerToolMetadata("sessions_history", { searchHint: "chat log transcript conversation history messages past" });
-registerToolMetadata("sessions_send", { searchHint: "send reply respond direct message channel session inject" });
-registerToolMetadata("sessions_spawn", { searchHint: "delegate subagent background async child worker spawn" });
-registerToolMetadata("subagents", { searchHint: "parallel fan-out concurrent multi-agent batch delegate" });
-registerToolMetadata("pipeline", { searchHint: "workflow dag graph orchestrate chain multi-step sequential" });
-registerToolMetadata("session_status", { searchHint: "session state alive running progress heartbeat check" });
-registerToolMetadata("session_search", { searchHint: "find session lookup filter match query user channel" });
-registerToolMetadata("agents_list", { searchHint: "bots agents roster fleet inventory configured available" });
-// ===========================================================================
-// Platform tools (6)
-// ===========================================================================
-registerToolMetadata("cron", { searchHint: "schedule timer reminder recurring job automation crontab interval" });
-registerToolMetadata("gateway", { searchHint: "config restart patch status settings yaml update system admin" });
-registerToolMetadata("image_analyze", { searchHint: "vision ocr describe photo picture identify detect recognize" });
-registerToolMetadata("tts_synthesize", { searchHint: "speech voice audio speak narrate text-to-speech vocalize" });
-registerToolMetadata("transcribe_audio", { searchHint: "stt speech-to-text whisper dictation voice recording audio" });
-registerToolMetadata("describe_video", { searchHint: "video clip movie mp4 mov webm scene describe motion visual" });
-// ===========================================================================
-// Document and browser tools (2)
-// ===========================================================================
-registerToolMetadata("extract_document", { searchHint: "pdf csv docx xlsx parse text content extract spreadsheet" });
-registerToolMetadata("browser", { searchHint: "chrome headless puppeteer navigate click screenshot scrape" });
-// ===========================================================================
-// Context tools (4)
-// ===========================================================================
-registerToolMetadata("ctx_search", { searchHint: "rag context knowledge semantic embedding retrieve similar" });
-registerToolMetadata("ctx_inspect", { searchHint: "context detail metadata source provenance inspect entry" });
-registerToolMetadata("ctx_expand", { searchHint: "context expand elaborate detail follow-up deeper related" });
-registerToolMetadata("ctx_recall", { searchHint: "memory recall remember fact previous mentioned earlier" });
-// ===========================================================================
-// Platform channel actions (4)
-// ===========================================================================
-registerToolMetadata("discord_action", { searchHint: "pin kick ban roles threads channels guild server discord" });
-registerToolMetadata("telegram_action", { searchHint: "pin poll sticker admin topics group supergroup telegram" });
-registerToolMetadata("slack_action", { searchHint: "pin react thread channel topic archive bookmark slack" });
-registerToolMetadata("whatsapp_action", { searchHint: "status group admin label broadcast forward whatsapp" });
-// ===========================================================================
-// Privileged management tools (10)
-// ===========================================================================
-registerToolMetadata("agents_manage", { searchHint: "fleet create delete suspend resume agent configure workspace" });
-registerToolMetadata("obs_query", { searchHint: "diagnostics monitoring metrics billing traces logs health" });
-registerToolMetadata("sessions_manage", { searchHint: "delete reset export compact session lifecycle cleanup admin" });
-registerToolMetadata("memory_manage", { searchHint: "delete flush export browse stats storage cleanup purge" });
-registerToolMetadata("channels_manage", { searchHint: "enable disable restart channel adapter platform connection" });
-registerToolMetadata("tokens_manage", { searchHint: "api key token rotate revoke generate auth credential" });
-registerToolMetadata("models_manage", { searchHint: "llm provider model switch configure cost tier pricing" });
-registerToolMetadata("skills_manage", { searchHint: "skill plugin capability register unregister enable toggle" });
-registerToolMetadata("mcp_manage", { searchHint: "mcp server protocol connect disconnect tool external" });
-registerToolMetadata("heartbeat_manage", { searchHint: "heartbeat keepalive watchdog health probe interval alive" });

package/node_modules/@comis/skills/dist/bridge/tool-validators.d.ts

@@ -1,11 +0,0 @@
-/**
- * Per-tool input validators (Phase 566).
- *
- * Registers validateInput metadata for tools that benefit from pre-flight
- * input validation. Validators run before execute() in the enforcement
- * wrapper, saving tool budget when inputs are invalid.
- *
- * Import this module for side effects only.
- * @module
- */
-export {};

package/node_modules/@comis/skills/dist/bridge/tool-validators.js

@@ -1,105 +0,0 @@
-/**
- * Per-tool input validators (Phase 566).
- *
- * Registers validateInput metadata for tools that benefit from pre-flight
- * input validation. Validators run before execute() in the enforcement
- * wrapper, saving tool budget when inputs are invalid.
- *
- * Import this module for side effects only.
- * @module
- */
-import { registerToolMetadata, isImmutableConfigPath } from "@comis/core";
-import { validateCommand, validateEnvVars } from "../builtin/exec-tool.js";
-// ---------------------------------------------------------------------------
-// VAL-04: Exec tool -- command denylist + env var denylist check
-// ---------------------------------------------------------------------------
-registerToolMetadata("exec", {
-    validateInput: (params) => {
-        const command = typeof params.command === "string" ? params.command : undefined;
-        if (!command || command.trim() === "") {
-            return "Missing required parameter: command";
-        }
-        // Dangerous command denylist check (re-uses exec-tool.ts patterns)
-        const cmdError = validateCommand(command);
-        if (cmdError)
-            return cmdError;
-        // Dangerous env var denylist check
-        if (params.env && typeof params.env === "object") {
-            const envError = validateEnvVars(params.env);
-            if (envError)
-                return envError;
-        }
-        return undefined;
-    },
-});
-// ---------------------------------------------------------------------------
-// VAL-05: Cron tool -- action enum + per-action required param validation
-// ---------------------------------------------------------------------------
-const VALID_CRON_ACTIONS = ["add", "list", "update", "remove", "status", "runs", "run", "wake"];
-const VALID_SCHEDULE_KINDS = ["cron", "every", "at"];
-registerToolMetadata("cron", {
-    validateInput: (params) => {
-        const action = typeof params.action === "string" ? params.action : undefined;
-        if (!action || !VALID_CRON_ACTIONS.includes(action)) {
-            return `Invalid action: "${action ?? ""}". Valid: ${VALID_CRON_ACTIONS.join(", ")}`;
-        }
-        if (action === "add") {
-            if (!params.payload_kind)
-                return "Missing required parameter: payload_kind (for add)";
-            if (!params.payload_text)
-                return "Missing required parameter: payload_text (for add)";
-            if (params.schedule_kind && typeof params.schedule_kind === "string") {
-                if (!VALID_SCHEDULE_KINDS.includes(params.schedule_kind)) {
-                    return `Invalid schedule_kind: "${params.schedule_kind}". Valid: ${VALID_SCHEDULE_KINDS.join(", ")}`;
-                }
-            }
-        }
-        if (["update", "remove", "runs", "run"].includes(action)) {
-            if (!params.job_name)
-                return `Missing required parameter: job_name (for ${action})`;
-        }
-        return undefined;
-    },
-});
-// ---------------------------------------------------------------------------
-// VAL-06: Message tool -- action enum + channel_type/channel_id presence
-// ---------------------------------------------------------------------------
-const VALID_MESSAGE_ACTIONS = ["send", "reply", "react", "edit", "delete", "fetch", "attach"];
-registerToolMetadata("message", {
-    validateInput: (params) => {
-        const action = typeof params.action === "string" ? params.action : undefined;
-        if (!action || !VALID_MESSAGE_ACTIONS.includes(action)) {
-            return `Invalid action: "${action ?? ""}". Valid: ${VALID_MESSAGE_ACTIONS.join(", ")}`;
-        }
-        if (!params.channel_type || typeof params.channel_type !== "string") {
-            return "Missing required parameter: channel_type";
-        }
-        if (!params.channel_id || typeof params.channel_id !== "string") {
-            return "Missing required parameter: channel_id";
-        }
-        return undefined;
-    },
-});
-// ---------------------------------------------------------------------------
-// VAL-07: Gateway tool -- action enum + immutable path rejection for patch
-// ---------------------------------------------------------------------------
-const VALID_GATEWAY_ACTIONS = [
-    "read", "patch", "apply", "restart", "schema", "status", "history", "diff", "rollback", "env_set",
-];
-registerToolMetadata("gateway", {
-    validateInput: (params) => {
-        const action = typeof params.action === "string" ? params.action : undefined;
-        if (!action || !VALID_GATEWAY_ACTIONS.includes(action)) {
-            return `Invalid action: "${action ?? ""}". Valid: ${VALID_GATEWAY_ACTIONS.join(", ")}`;
-        }
-        // Only check immutability for patch action (Pitfall 3: reads must succeed on immutable paths)
-        if (action === "patch") {
-            const section = typeof params.section === "string" ? params.section : undefined;
-            const key = typeof params.key === "string" ? params.key : undefined;
-            if (section && isImmutableConfigPath(section, key)) {
-                return `Cannot patch immutable config path: ${section}${key ? "." + key : ""}`;
-            }
-        }
-        return undefined;
-    },
-});

package/node_modules/@comis/skills/dist/builtin/file/find-sort-wrapper.d.ts

@@ -1,22 +0,0 @@
-/**
- * Find tool mtime sort wrapper.
- *
- * Post-processes find tool results to sort file paths by modification time
- * (most recently modified first). Preserves trailing notices (truncation,
- * result limit) from the upstream SDK output.
- *
- * @module
- */
-import type { AgentTool } from "@mariozechner/pi-agent-core";
-/**
- * Wrap the find tool to sort results by modification time (most recent first).
- *
- * Delegates to the original find tool's execute, then post-processes the text
- * content: parses newline-separated file paths, stats each for mtime, sorts
- * descending, and preserves any trailing notice lines (lines starting with `[`).
- *
- * @param tool - The find tool (already wrapped with safePath)
- * @param workspacePath - Workspace root for path resolution
- * @returns A new AgentTool with mtime-sorted output
- */
-export declare function wrapFindWithMtimeSort(tool: AgentTool<any>, workspacePath: string): AgentTool<any>;

package/node_modules/@comis/skills/dist/builtin/file/find-sort-wrapper.js

@@ -1,95 +0,0 @@
-/**
- * Find tool mtime sort wrapper.
- *
- * Post-processes find tool results to sort file paths by modification time
- * (most recently modified first). Preserves trailing notices (truncation,
- * result limit) from the upstream SDK output.
- *
- * @module
- */
-import * as fs from "node:fs/promises";
-import * as nodePath from "node:path";
-import { safePath } from "@comis/core";
-/** No-match sentinel from pi-coding-agent find tool. */
-const NO_FILES_FOUND = "No files found matching pattern";
-/**
- * Wrap the find tool to sort results by modification time (most recent first).
- *
- * Delegates to the original find tool's execute, then post-processes the text
- * content: parses newline-separated file paths, stats each for mtime, sorts
- * descending, and preserves any trailing notice lines (lines starting with `[`).
- *
- * @param tool - The find tool (already wrapped with safePath)
- * @param workspacePath - Workspace root for path resolution
- * @returns A new AgentTool with mtime-sorted output
- */
-export function wrapFindWithMtimeSort(
-// eslint-disable-next-line @typescript-eslint/no-explicit-any -- AgentTool generic requires `any` per pi-agent-core API
-tool, workspacePath) {
-    return {
-        ...tool,
-        async execute(toolCallId, params, signal, onUpdate) {
-            // Delegate to the original find tool
-            const result = await tool.execute(toolCallId, params, signal, onUpdate);
-            // Extract text content from result
-            const textParts = result.content
-                .filter((c) => c.type === "text")
-                .map((c) => c.text);
-            const fullText = textParts.join("");
-            // Passthrough: no files found
-            if (fullText.trim() === NO_FILES_FOUND || fullText.trim() === "") {
-                return result;
-            }
-            // Split into lines and separate file paths from trailing notices
-            const lines = fullText.split("\n").filter((l) => l.length > 0);
-            const filePaths = [];
-            const notices = [];
-            for (const line of lines) {
-                if (line.startsWith("[")) {
-                    notices.push(line);
-                }
-                else {
-                    filePaths.push(line);
-                }
-            }
-            if (filePaths.length === 0) {
-                return result;
-            }
-            // Resolve search base: use the `path` param if provided, else workspace
-            const searchBase = typeof params.path === "string" ? params.path : workspacePath;
-            const resolvedBase = nodePath.isAbsolute(searchBase)
-                ? searchBase
-                : safePath(workspacePath, searchBase);
-            // Stat each file and collect mtime
-            const entries = [];
-            const failedEntries = [];
-            const statPromises = filePaths.map(async (fp) => {
-                const absolutePath = nodePath.isAbsolute(fp)
-                    ? fp
-                    : nodePath.resolve(resolvedBase, fp);
-                try {
-                    const stat = await fs.stat(absolutePath);
-                    entries.push({ path: fp, mtimeMs: stat.mtimeMs });
-                }
-                catch {
-                    // File disappeared between find and sort -- put at end
-                    failedEntries.push(fp);
-                }
-            });
-            await Promise.all(statPromises);
-            // Sort by mtime descending (most recent first)
-            entries.sort((a, b) => b.mtimeMs - a.mtimeMs);
-            // Reassemble: sorted paths + failed paths + notices
-            const sortedLines = [
-                ...entries.map((e) => e.path),
-                ...failedEntries,
-                ...notices,
-            ];
-            const sortedText = sortedLines.join("\n");
-            return {
-                ...result,
-                content: [{ type: "text", text: sortedText }],
-            };
-        },
-    };
-}

package/node_modules/@comis/skills/dist/builtin/file/grep-output-mode-wrapper.d.ts

@@ -1,24 +0,0 @@
-/**
- * Grep tool output mode wrapper.
- *
- * Post-processes grep tool results based on an `output_mode` parameter added
- * at the Comis layer. The upstream SDK grep always returns full match output
- * (file:line: content). This wrapper provides additional output formats:
- *   - `content` (default): unchanged upstream output
- *   - `files_with_matches`: deduplicated file paths only
- *   - `count`: per-file match counts, sorted by count descending
- *
- * @module
- */
-import type { AgentTool } from "@mariozechner/pi-agent-core";
-/**
- * Wrap the grep tool to support `output_mode` parameter.
- *
- * Extends the tool's parameter schema to add `output_mode`, strips it
- * before delegating to the original tool, then post-processes the result
- * based on the requested output mode.
- *
- * @param tool - The grep tool (already wrapped with safePath)
- * @returns A new AgentTool with output_mode support
- */
-export declare function wrapGrepWithOutputMode(tool: AgentTool<any>): AgentTool<any>;

package/node_modules/@comis/skills/dist/builtin/file/grep-output-mode-wrapper.js

@@ -1,167 +0,0 @@
-/**
- * Grep tool output mode wrapper.
- *
- * Post-processes grep tool results based on an `output_mode` parameter added
- * at the Comis layer. The upstream SDK grep always returns full match output
- * (file:line: content). This wrapper provides additional output formats:
- *   - `content` (default): unchanged upstream output
- *   - `files_with_matches`: deduplicated file paths only
- *   - `count`: per-file match counts, sorted by count descending
- *
- * @module
- */
-import { Type } from "@sinclair/typebox";
-/**
- * Regex to extract file path and line number from grep output lines.
- *
- * Match lines: `filepath:linenum: content`
- * Context lines: `filepath-linenum- content`
- *
- * The file path is everything before the first `:linenum:` or `-linenum-`.
- */
-const MATCH_LINE_RE = /^(.+?):(\d+): /;
-const CONTEXT_LINE_RE = /^(.+?)-(\d+)- /;
-/** Sentinel for no-match output from pi-coding-agent grep. */
-const NO_MATCHES = "No matches found";
-/**
- * Extract trailing notice lines (starting with `[`) from the output.
- * Notices appear after a blank line at the end of grep output.
- */
-function splitNotices(text) {
-    const lines = text.split("\n");
-    const notices = [];
-    // Walk backwards to find trailing notice lines
-    let i = lines.length - 1;
-    while (i >= 0 && (lines[i].startsWith("[") || lines[i].trim() === "")) {
-        if (lines[i].startsWith("[")) {
-            notices.unshift(lines[i]);
-        }
-        i--;
-    }
-    const body = lines.slice(0, i + 1).join("\n");
-    return { body, notices };
-}
-/**
- * Parse grep output into file-path-keyed match counts.
- * Only counts actual match lines (`:linenum: `), not context lines (`-linenum- `).
- */
-function countMatchesByFile(body) {
-    const counts = new Map();
-    for (const line of body.split("\n")) {
-        const match = MATCH_LINE_RE.exec(line);
-        if (match) {
-            const filePath = match[1];
-            counts.set(filePath, (counts.get(filePath) ?? 0) + 1);
-        }
-    }
-    return counts;
-}
-/**
- * Extract unique file paths from grep output (both match and context lines).
- */
-function extractUniquePaths(body) {
-    const seen = new Set();
-    const paths = [];
-    for (const line of body.split("\n")) {
-        const matchResult = MATCH_LINE_RE.exec(line) ?? CONTEXT_LINE_RE.exec(line);
-        if (matchResult) {
-            const filePath = matchResult[1];
-            if (!seen.has(filePath)) {
-                seen.add(filePath);
-                paths.push(filePath);
-            }
-        }
-    }
-    return paths;
-}
-/**
- * Wrap the grep tool to support `output_mode` parameter.
- *
- * Extends the tool's parameter schema to add `output_mode`, strips it
- * before delegating to the original tool, then post-processes the result
- * based on the requested output mode.
- *
- * @param tool - The grep tool (already wrapped with safePath)
- * @returns A new AgentTool with output_mode support
- */
-export function wrapGrepWithOutputMode(
-// eslint-disable-next-line @typescript-eslint/no-explicit-any -- AgentTool generic requires `any` per pi-agent-core API
-tool) {
-    // Extend parameter schema with output_mode
-    const originalParams = tool.parameters;
-    const extendedParams = Type.Object({
-        ...originalParams.properties,
-        output_mode: Type.Optional(Type.Union([
-            Type.Literal("content"),
-            Type.Literal("files_with_matches"),
-            Type.Literal("count"),
-        ], {
-            description: "Output format: 'content' (default, full match lines), 'files_with_matches' (file paths only), or 'count' (match counts per file)",
-        })),
-        offset: Type.Optional(Type.Number({
-            description: "Skip the first N result entries (lines for content mode, file paths for files_with_matches, count entries for count mode). Default: 0.",
-        })),
-    });
-    return {
-        ...tool,
-        parameters: extendedParams,
-        async execute(toolCallId, params, signal, onUpdate) {
-            // Extract and strip output_mode + offset before delegating to upstream
-            const outputMode = params.output_mode ?? "content";
-            const offset = params.offset ?? 0;
-            const upstreamParams = { ...params };
-            delete upstreamParams.output_mode;
-            delete upstreamParams.offset;
-            // Delegate to original grep tool
-            const result = await tool.execute(toolCallId, upstreamParams, signal, onUpdate);
-            // Extract text content from result
-            const textParts = result.content
-                .filter((c) => c.type === "text")
-                .map((c) => c.text);
-            const fullText = textParts.join("");
-            // Passthrough for empty or no-match results
-            if (fullText.trim() === "" || fullText.trim() === NO_MATCHES) {
-                return result;
-            }
-            // For default/content mode, apply offset if needed then return
-            if (outputMode === "content") {
-                if (offset <= 0) {
-                    return result;
-                }
-                const { body, notices } = splitNotices(fullText);
-                const lines = body.split("\n").slice(offset);
-                let transformedText = lines.join("\n");
-                if (notices.length > 0) {
-                    transformedText += (transformedText ? "\n\n" : "") + notices.join("\n");
-                }
-                return {
-                    ...result,
-                    content: [{ type: "text", text: transformedText }],
-                };
-            }
-            // Separate output body from trailing notices
-            const { body, notices } = splitNotices(fullText);
-            let transformedText;
-            if (outputMode === "files_with_matches") {
-                const paths = extractUniquePaths(body).slice(offset);
-                transformedText = paths.join("\n");
-            }
-            else {
-                // count mode
-                const counts = countMatchesByFile(body);
-                const sorted = [...counts.entries()].sort((a, b) => b[1] - a[1]).slice(offset);
-                transformedText = sorted
-                    .map(([filePath, count]) => `${filePath}: ${count} ${count === 1 ? "match" : "matches"}`)
-                    .join("\n");
-            }
-            // Append notices if present
-            if (notices.length > 0) {
-                transformedText += (transformedText ? "\n\n" : "") + notices.join("\n");
-            }
-            return {
-                ...result,
-                content: [{ type: "text", text: transformedText }],
-            };
-        },
-    };
-}

package/node_modules/@comis/skills/dist/builtin/task-plan-tool.d.ts

@@ -1,25 +0,0 @@
-/**
- * Task plan tool: stateless formatter for multi-step work plans.
- *
- * Agents use this tool to structure and communicate multi-step plans
- * visible in conversation history. Pure formatting -- no persistence,
- * no side effects, no state.
- *
- * @module
- */
-import type { AgentTool } from "@mariozechner/pi-agent-core";
-declare const TaskPlanParams: import("@sinclair/typebox").TObject<{
-    tasks: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-        id: import("@sinclair/typebox").TString;
-        description: import("@sinclair/typebox").TString;
-        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"pending">, import("@sinclair/typebox").TLiteral<"in-progress">, import("@sinclair/typebox").TLiteral<"done">, import("@sinclair/typebox").TLiteral<"skipped">]>;
-    }>>;
-    title: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-}>;
-/**
- * Create a stateless task_plan tool for structuring multi-step work plans.
- *
- * @returns AgentTool that formats task lists into readable plan text
- */
-export declare function createTaskPlanTool(): AgentTool<typeof TaskPlanParams>;
-export {};

package/node_modules/@comis/skills/dist/builtin/task-plan-tool.js

@@ -1,67 +0,0 @@
-/**
- * Task plan tool: stateless formatter for multi-step work plans.
- *
- * Agents use this tool to structure and communicate multi-step plans
- * visible in conversation history. Pure formatting -- no persistence,
- * no side effects, no state.
- *
- * @module
- */
-import { Type } from "@sinclair/typebox";
-import { jsonResult } from "./platform/tool-helpers.js";
-// ---------------------------------------------------------------------------
-// Parameter schema
-// ---------------------------------------------------------------------------
-const TaskPlanParams = Type.Object({
-    tasks: Type.Array(Type.Object({
-        id: Type.String({ description: "Unique task identifier" }),
-        description: Type.String({ description: "What needs to be done" }),
-        status: Type.Union([
-            Type.Literal("pending"),
-            Type.Literal("in-progress"),
-            Type.Literal("done"),
-            Type.Literal("skipped"),
-        ], { description: "Current task status" }),
-    }), { description: "List of tasks in the plan" }),
-    title: Type.Optional(Type.String({ description: "Optional plan title (defaults to 'Task Plan')" })),
-});
-// ---------------------------------------------------------------------------
-// Status icon mapping
-// ---------------------------------------------------------------------------
-const STATUS_ICONS = {
-    pending: "[ ]",
-    "in-progress": "[~]",
-    done: "[x]",
-    skipped: "[-]",
-};
-// ---------------------------------------------------------------------------
-// Factory
-// ---------------------------------------------------------------------------
-/**
- * Create a stateless task_plan tool for structuring multi-step work plans.
- *
- * @returns AgentTool that formats task lists into readable plan text
- */
-export function createTaskPlanTool() {
-    return {
-        name: "task_plan",
-        label: "Task Plan",
-        description: "Structure and display a multi-step task plan. Returns a formatted summary. " +
-            "Stateless -- use this to organize your work and communicate progress.",
-        parameters: TaskPlanParams,
-        async execute(_toolCallId, params) {
-            const p = params;
-            const title = p.title ?? "Task Plan";
-            const tasks = p.tasks ?? [];
-            // Format each task line
-            const lines = tasks.map((t) => `${STATUS_ICONS[t.status]} ${t.id}: ${t.description}`);
-            // Count completed
-            const doneCount = tasks.filter((t) => t.status === "done").length;
-            const totalCount = tasks.length;
-            const summary = `${doneCount}/${totalCount} tasks completed`;
-            // Build plan text
-            const plan = [title, "", ...lines, "", summary].join("\n");
-            return jsonResult({ plan, summary, tasks });
-        },
-    };
-}

package/node_modules/@comis/skills/dist/integrations/mcp-tool-bridge.d.ts

@@ -1,75 +0,0 @@
-/**
- * MCP Tool Bridge: Converts MCP tool definitions to AgentTool instances.
- *
- * Follows the pattern established by skill-tool-bridge.ts for converting
- * external tool definitions into the AgentTool format expected by the
- * agent executor (pi-agent-core).
- *
- * Key functions:
- * - mcpToolsToAgentTools: Batch convert MCP tools to AgentTool[]
- * - jsonSchemaToTypeBox: Basic JSON Schema -> TypeBox conversion
- *
- * @module
- */
-import type { AgentTool } from "@mariozechner/pi-agent-core";
-import { type TSchema } from "@sinclair/typebox";
-import { type ToolSourceProfile } from "../builtin/tool-source-profiles.js";
-import type { McpToolDefinition, McpClientManager } from "./mcp-client.js";
-/**
- * Extract the MCP server name from a sanitized tool name.
- *
- * Sanitized MCP tool names use the format `mcp__serverName--toolName`.
- * Returns `undefined` for non-MCP tools or malformed names.
- *
- * @example
- * extractMcpServerName("mcp__context7--resolve-library-id") // "context7"
- * extractMcpServerName("mcp__srv__v2--ns--tool") // "srv__v2"
- * extractMcpServerName("bash") // undefined
- */
-export declare function extractMcpServerName(toolName: string): string | undefined;
-/**
- * Classify an MCP error message into a category for observability.
- *
- * Returns one of: "timeout", "connection", "tool_error", "transport", "unknown".
- */
-export declare function classifyMcpErrorType(errorText: string | undefined): string;
-/**
- * Convert a basic JSON Schema definition to a TypeBox TSchema.
- *
- * Handles primitive types, arrays, and objects. Complex schema features
- * (oneOf, allOf, $ref, etc.) fall back to Type.Any().
- *
- * This is intentionally simple -- MCP tool schemas are typically flat
- * objects with primitive properties. Complex schemas still work but
- * lose TypeBox-level validation detail.
- */
-export declare function jsonSchemaToTypeBox(schema: Record<string, unknown>): TSchema;
-/** Maximum characters for LLM-facing MCP tool descriptions. */
-export declare const MAX_LLM_DESCRIPTION_CHARS = 2048;
-/**
- * Sanitize a qualified MCP tool name for use as an LLM API tool name.
- *
- * LLM APIs (Anthropic, OpenAI) require tool names to match `^[a-zA-Z0-9_-]{1,128}$`.
- * Qualified names like "mcp:context7/resolve-library-id" contain invalid characters
- * (`:`, `/`). This function replaces them: "mcp:" -> "mcp__", "/" -> "--".
- *
- * Example: "mcp:context7/resolve-library-id" -> "mcp__context7--resolve-library-id"
- */
-export declare function sanitizeMcpToolName(qualifiedName: string): string;
-/**
- * Convert an array of MCP tool definitions to AgentTool instances.
- *
- * Each AgentTool's execute() delegates to the provided callTool function,
- * which dispatches to the correct MCP server connection. Error results
- * from the MCP server are returned as text content (not thrown), matching
- * the AgentTool contract.
- *
- * Successful results are capped to the resolved source profile's maxChars
- * limit, preventing oversized MCP responses from consuming agent context.
- *
- * @param tools - MCP tool definitions from McpClientManager.getTools()
- * @param callTool - McpClientManager.callTool bound function
- * @param toolSourceProfiles - Optional per-tool overrides for source profiles
- * @returns AgentTool instances ready for the agent executor
- */
-export declare function mcpToolsToAgentTools(tools: McpToolDefinition[], callTool: McpClientManager["callTool"], toolSourceProfiles?: Record<string, Partial<ToolSourceProfile>>): AgentTool<any>[];