comisai 1.0.19 → 1.0.22

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

@@ -1,125 +0,0 @@
-/**
- * Per-tool output schemas (Phase 568: SCHEMA-01 through SCHEMA-05).
- *
- * Registers outputSchema for 6 priority tools to describe their actual output
- * format. Schemas are informational only -- delivered to the LLM via JIT guide
- * injection to help predict result structure. Never validated at runtime.
- *
- * - grep, find: Text output (type: "string") -- NOT JSON
- * - exec, memory_search, web_search, sessions_list: JSON output (type: "object")
- *
- * Import this module for side effects only -- it runs registerToolMetadata()
- * calls at module scope. Imported from tool-bridge.ts to ensure schemas are
- * registered before assembleToolPipeline() runs.
- *
- * @module
- */
-import { registerToolMetadata } from "@comis/core";
-// ---------------------------------------------------------------------------
-// Text-output tools (pi-coding-agent, post-processed wrappers)
-// ---------------------------------------------------------------------------
-registerToolMetadata("grep", {
-    outputSchema: {
-        type: "string",
-        description: "Text output (not JSON). Default mode: `filepath:linenum: content` per line. " +
-            "files_with_matches mode: one filepath per line. " +
-            "count mode: `filepath: N matches` per line, sorted descending. " +
-            "Trailing `[...]` notices indicate truncation or limits.",
-    },
-});
-registerToolMetadata("find", {
-    outputSchema: {
-        type: "string",
-        description: "Text output (not JSON). Newline-separated file paths sorted by modification time (most recent first). " +
-            "Paths relative to workspace root. Trailing `[...]` notices for truncation.",
-    },
-});
-// ---------------------------------------------------------------------------
-// JSON-output tools (jsonResult() or JSON.stringify)
-// ---------------------------------------------------------------------------
-registerToolMetadata("exec", {
-    outputSchema: {
-        type: "object",
-        description: "Shell command execution result",
-        properties: {
-            exitCode: { type: "number", description: "0 = success, 124 = timeout" },
-            stdout: { type: "string", description: "Standard output" },
-            stderr: { type: "string", description: "Standard error" },
-            description: { type: "string", description: "User-provided command label" },
-            truncated: { type: "boolean", description: "True when output exceeded buffer" },
-            fullOutputPath: { type: "string", description: "Path to full output on disk" },
-        },
-    },
-});
-registerToolMetadata("memory_search", {
-    outputSchema: {
-        type: "object",
-        description: "Memory search results",
-        properties: {
-            results: {
-                type: "array",
-                description: "Matching entries (content max 500 chars each)",
-                items: {
-                    type: "object",
-                    properties: {
-                        id: { type: "string" },
-                        content: { type: "string" },
-                        score: { type: "number" },
-                        tags: { type: "array", items: { type: "string" } },
-                        createdAt: { type: "number", description: "Epoch ms" },
-                    },
-                },
-            },
-        },
-    },
-});
-registerToolMetadata("web_search", {
-    outputSchema: {
-        type: "object",
-        description: "Web search results. List-based providers (Brave/Tavily) return results[]. " +
-            "Perplexity/Grok return { content, citations } instead.",
-        properties: {
-            query: { type: "string" },
-            provider: { type: "string" },
-            tookMs: { type: "number" },
-            results: {
-                type: "array",
-                description: "List-based provider results",
-                items: {
-                    type: "object",
-                    properties: {
-                        title: { type: "string" },
-                        url: { type: "string" },
-                        description: { type: "string" },
-                    },
-                },
-            },
-        },
-    },
-});
-registerToolMetadata("sessions_list", {
-    outputSchema: {
-        type: "object",
-        description: "Active sessions listing",
-        properties: {
-            sessions: {
-                type: "array",
-                items: {
-                    type: "object",
-                    properties: {
-                        sessionKey: { type: "string" },
-                        agentId: { type: "string" },
-                        userId: { type: "string" },
-                        channelId: { type: "string" },
-                        kind: { type: "string" },
-                        messageCount: { type: "number" },
-                        totalTokens: { type: "number" },
-                        updatedAt: { type: "number" },
-                        createdAt: { type: "number" },
-                    },
-                },
-            },
-            total: { type: "number", description: "Total session count" },
-        },
-    },
-});

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

@@ -1,14 +0,0 @@
-/**
- * Per-tool parallelism metadata (Phase 565: PAR-04).
- *
- * Registers isReadOnly and isConcurrencySafe for all 51 built-in tools.
- * Uses merge semantics so Phase 564 maxResultSizeChars entries are preserved
- * when this module registers additional fields for the same tools.
- *
- * Import this module for side effects only -- it runs registerToolMetadata()
- * calls at module scope. Imported from tool-bridge.ts to ensure parallelism
- * metadata is registered before assembleToolPipeline() runs.
- *
- * @module
- */
-export {};

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

@@ -1,92 +0,0 @@
-/**
- * Per-tool parallelism metadata (Phase 565: PAR-04).
- *
- * Registers isReadOnly and isConcurrencySafe for all 51 built-in tools.
- * Uses merge semantics so Phase 564 maxResultSizeChars entries are preserved
- * when this module registers additional fields for the same tools.
- *
- * Import this module for side effects only -- it runs registerToolMetadata()
- * calls at module scope. Imported from tool-bridge.ts to ensure parallelism
- * metadata is registered before assembleToolPipeline() runs.
- *
- * @module
- */
-import { registerToolMetadata } from "@comis/core";
-// ===========================================================================
-// Read-only tools (25) -- { isReadOnly: true }
-// Safe for optimistic parallel execution with other read-only tools.
-// ===========================================================================
-// --- File system reads ---
-registerToolMetadata("read", { isReadOnly: true });
-registerToolMetadata("grep", { isReadOnly: true, searchHint: "search file contents with regex pattern ripgrep" });
-registerToolMetadata("find", { isReadOnly: true });
-registerToolMetadata("ls", { isReadOnly: true });
-// --- Web reads ---
-registerToolMetadata("web_search", { isReadOnly: true });
-registerToolMetadata("web_fetch", { isReadOnly: true });
-registerToolMetadata("browser", { isReadOnly: true });
-// --- Memory/session reads ---
-registerToolMetadata("memory_search", { isReadOnly: true });
-registerToolMetadata("memory_get", { isReadOnly: true });
-registerToolMetadata("session_search", { isReadOnly: true });
-// --- Session reads ---
-registerToolMetadata("sessions_list", { isReadOnly: true });
-registerToolMetadata("session_status", { isReadOnly: true });
-registerToolMetadata("sessions_history", { isReadOnly: true });
-registerToolMetadata("agents_list", { isReadOnly: true });
-// --- Context reads ---
-registerToolMetadata("ctx_search", { isReadOnly: true });
-registerToolMetadata("ctx_inspect", { isReadOnly: true });
-registerToolMetadata("ctx_expand", { isReadOnly: true });
-registerToolMetadata("ctx_recall", { isReadOnly: true });
-// --- Media analysis ---
-registerToolMetadata("image_analyze", { isReadOnly: true });
-registerToolMetadata("describe_video", { isReadOnly: true });
-registerToolMetadata("extract_document", { isReadOnly: true });
-registerToolMetadata("transcribe_audio", { isReadOnly: true });
-// --- Platform reads ---
-registerToolMetadata("obs_query", { isReadOnly: true });
-registerToolMetadata("models_manage", { isReadOnly: true });
-// --- Discovery ---
-registerToolMetadata("discover_tools", { isReadOnly: true });
-// ===========================================================================
-// Mutating tools (25) -- { isReadOnly: false }
-// Must not be executed in parallel with other mutating tools.
-// ===========================================================================
-// --- File writes ---
-registerToolMetadata("edit", { isReadOnly: false });
-registerToolMetadata("write", { isReadOnly: false });
-registerToolMetadata("apply_patch", { isReadOnly: false });
-// --- Exec/process ---
-registerToolMetadata("exec", { isReadOnly: false });
-registerToolMetadata("process", { isReadOnly: false });
-// --- Memory writes ---
-registerToolMetadata("memory_store", { isReadOnly: false });
-registerToolMetadata("memory_manage", { isReadOnly: false });
-// --- Session management ---
-registerToolMetadata("sessions_manage", { isReadOnly: false });
-registerToolMetadata("sessions_send", { isReadOnly: false });
-registerToolMetadata("sessions_spawn", { isReadOnly: false });
-registerToolMetadata("subagents", { isReadOnly: false });
-// --- Platform management ---
-registerToolMetadata("pipeline", { isReadOnly: false });
-registerToolMetadata("cron", { isReadOnly: false });
-registerToolMetadata("gateway", { isReadOnly: false });
-registerToolMetadata("heartbeat_manage", { isReadOnly: false });
-registerToolMetadata("channels_manage", { isReadOnly: false });
-registerToolMetadata("tokens_manage", { isReadOnly: false });
-registerToolMetadata("skills_manage", { isReadOnly: false });
-registerToolMetadata("mcp_manage", { isReadOnly: false });
-registerToolMetadata("agents_manage", { isReadOnly: false });
-// --- Channel actions ---
-registerToolMetadata("whatsapp_action", { isReadOnly: false });
-registerToolMetadata("discord_action", { isReadOnly: false });
-registerToolMetadata("telegram_action", { isReadOnly: false });
-registerToolMetadata("slack_action", { isReadOnly: false });
-// --- Media generation ---
-registerToolMetadata("tts_synthesize", { isReadOnly: false });
-// ===========================================================================
-// Concurrency-safe mutating tool (1) -- { isReadOnly: false, isConcurrencySafe: true }
-// Sends to independent channels with no ordering dependencies.
-// ===========================================================================
-registerToolMetadata("message", { isReadOnly: false, isConcurrencySafe: true });

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

@@ -1,14 +0,0 @@
-/**
- * Per-tool result size caps (Phase 564: TRUNC-02).
- *
- * Registers maxResultSizeChars for tools that can produce large text output.
- * Values are calibrated per TRUNC-03 to avoid triple truncation stacking
- * with the per-tool bouncer (default 50K) and turn budget (200K aggregate).
- *
- * Import this module for side effects only -- it runs registerToolMetadata()
- * calls at module scope. Imported from tool-bridge.ts to ensure caps are
- * registered before assembleToolPipeline() runs.
- *
- * @module
- */
-export {};

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

@@ -1,36 +0,0 @@
-/**
- * Per-tool result size caps (Phase 564: TRUNC-02).
- *
- * Registers maxResultSizeChars for tools that can produce large text output.
- * Values are calibrated per TRUNC-03 to avoid triple truncation stacking
- * with the per-tool bouncer (default 50K) and turn budget (200K aggregate).
- *
- * Import this module for side effects only -- it runs registerToolMetadata()
- * calls at module scope. Imported from tool-bridge.ts to ensure caps are
- * registered before assembleToolPipeline() runs.
- *
- * @module
- */
-import { registerToolMetadata } from "@comis/core";
-// ---------------------------------------------------------------------------
-// File tools (from @mariozechner/pi-coding-agent via createComisFileTools)
-// ---------------------------------------------------------------------------
-registerToolMetadata("grep", { maxResultSizeChars: 100_000 });
-registerToolMetadata("read", { maxResultSizeChars: 200_000 });
-registerToolMetadata("find", { maxResultSizeChars: 50_000 });
-registerToolMetadata("ls", { maxResultSizeChars: 20_000 });
-// ---------------------------------------------------------------------------
-// Exec tool
-// ---------------------------------------------------------------------------
-registerToolMetadata("exec", { maxResultSizeChars: 100_000 });
-// ---------------------------------------------------------------------------
-// Web tools
-// ---------------------------------------------------------------------------
-registerToolMetadata("web_fetch", { maxResultSizeChars: 150_000 });
-registerToolMetadata("web_search", { maxResultSizeChars: 50_000 });
-// ---------------------------------------------------------------------------
-// Platform tools (RPC-based, created in daemon wiring)
-// ---------------------------------------------------------------------------
-registerToolMetadata("sessions_history", { maxResultSizeChars: 100_000 });
-registerToolMetadata("obs_query", { maxResultSizeChars: 100_000 });
-registerToolMetadata("memory_search", { maxResultSizeChars: 50_000 });

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

@@ -1,15 +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
- */
-export {};

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>;