@hcu-lab.me/mcp-device 1.0.0

package/dist/tools/schemas.d.ts

@@ -0,0 +1,454 @@
+import { z } from "zod";
+export declare const GetConfigArgsSchema: z.ZodObject<{
+    origin: z.ZodOptional<z.ZodEnum<["ui", "llm"]>>;
+}, "strip", z.ZodTypeAny, {
+    origin?: "ui" | "llm" | undefined;
+}, {
+    origin?: "ui" | "llm" | undefined;
+}>;
+export declare const SetConfigValueArgsSchema: z.ZodObject<{
+    key: z.ZodString;
+    value: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString, "many">, z.ZodNull]>;
+    origin: z.ZodOptional<z.ZodEnum<["ui", "llm"]>>;
+}, "strip", z.ZodTypeAny, {
+    value: string | number | boolean | string[] | null;
+    key: string;
+    origin?: "ui" | "llm" | undefined;
+}, {
+    value: string | number | boolean | string[] | null;
+    key: string;
+    origin?: "ui" | "llm" | undefined;
+}>;
+export declare const ListProcessesArgsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const StartProcessArgsSchema: z.ZodObject<{
+    command: z.ZodString;
+    timeout_ms: z.ZodNumber;
+    working_directory: z.ZodOptional<z.ZodString>;
+    shell: z.ZodOptional<z.ZodString>;
+    verbose_timing: z.ZodOptional<z.ZodBoolean>;
+    origin: z.ZodOptional<z.ZodEnum<["ui", "llm"]>>;
+}, "strip", z.ZodTypeAny, {
+    command: string;
+    timeout_ms: number;
+    origin?: "ui" | "llm" | undefined;
+    working_directory?: string | undefined;
+    shell?: string | undefined;
+    verbose_timing?: boolean | undefined;
+}, {
+    command: string;
+    timeout_ms: number;
+    origin?: "ui" | "llm" | undefined;
+    working_directory?: string | undefined;
+    shell?: string | undefined;
+    verbose_timing?: boolean | undefined;
+}>;
+export declare const ReadProcessOutputArgsSchema: z.ZodObject<{
+    pid: z.ZodNumber;
+    timeout_ms: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    length: z.ZodOptional<z.ZodNumber>;
+    verbose_timing: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    pid: number;
+    length?: number | undefined;
+    timeout_ms?: number | undefined;
+    verbose_timing?: boolean | undefined;
+    offset?: number | undefined;
+}, {
+    pid: number;
+    length?: number | undefined;
+    timeout_ms?: number | undefined;
+    verbose_timing?: boolean | undefined;
+    offset?: number | undefined;
+}>;
+export declare const ForceTerminateArgsSchema: z.ZodObject<{
+    pid: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    pid: number;
+}, {
+    pid: number;
+}>;
+export declare const ListSessionsArgsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const KillProcessArgsSchema: z.ZodObject<{
+    pid: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    pid: number;
+}, {
+    pid: number;
+}>;
+export declare const ReadFileArgsSchema: z.ZodObject<{
+    path: z.ZodString;
+    isUrl: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    length: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    sheet: z.ZodOptional<z.ZodString>;
+    range: z.ZodOptional<z.ZodString>;
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    origin: z.ZodOptional<z.ZodEnum<["ui", "llm"]>>;
+}, "strip", z.ZodTypeAny, {
+    length: number;
+    path: string;
+    offset: number;
+    isUrl: boolean;
+    origin?: "ui" | "llm" | undefined;
+    options?: Record<string, any> | undefined;
+    sheet?: string | undefined;
+    range?: string | undefined;
+}, {
+    path: string;
+    length?: number | undefined;
+    origin?: "ui" | "llm" | undefined;
+    options?: Record<string, any> | undefined;
+    offset?: number | undefined;
+    isUrl?: boolean | undefined;
+    sheet?: string | undefined;
+    range?: string | undefined;
+}>;
+export declare const ReadMultipleFilesArgsSchema: z.ZodObject<{
+    paths: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    paths: string[];
+}, {
+    paths: string[];
+}>;
+export declare const WriteFileArgsSchema: z.ZodObject<{
+    path: z.ZodString;
+    content: z.ZodString;
+    mode: z.ZodDefault<z.ZodEnum<["rewrite", "append"]>>;
+    origin: z.ZodOptional<z.ZodEnum<["ui", "llm"]>>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    content: string;
+    mode: "rewrite" | "append";
+    origin?: "ui" | "llm" | undefined;
+}, {
+    path: string;
+    content: string;
+    origin?: "ui" | "llm" | undefined;
+    mode?: "rewrite" | "append" | undefined;
+}>;
+export declare const PdfInsertOperationSchema: z.ZodObject<{
+    type: z.ZodLiteral<"insert">;
+    pageIndex: z.ZodNumber;
+    markdown: z.ZodOptional<z.ZodString>;
+    sourcePdfPath: z.ZodOptional<z.ZodString>;
+    pdfOptions: z.ZodOptional<z.ZodObject<{}, "passthrough", z.ZodTypeAny, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">, z.objectInputType<{}, z.ZodTypeAny, "passthrough">>>;
+}, "strip", z.ZodTypeAny, {
+    type: "insert";
+    pageIndex: number;
+    markdown?: string | undefined;
+    sourcePdfPath?: string | undefined;
+    pdfOptions?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
+}, {
+    type: "insert";
+    pageIndex: number;
+    markdown?: string | undefined;
+    sourcePdfPath?: string | undefined;
+    pdfOptions?: z.objectInputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
+}>;
+export declare const PdfDeleteOperationSchema: z.ZodObject<{
+    type: z.ZodLiteral<"delete">;
+    pageIndexes: z.ZodArray<z.ZodNumber, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "delete";
+    pageIndexes: number[];
+}, {
+    type: "delete";
+    pageIndexes: number[];
+}>;
+export declare const PdfOperationSchema: z.ZodUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"insert">;
+    pageIndex: z.ZodNumber;
+    markdown: z.ZodOptional<z.ZodString>;
+    sourcePdfPath: z.ZodOptional<z.ZodString>;
+    pdfOptions: z.ZodOptional<z.ZodObject<{}, "passthrough", z.ZodTypeAny, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">, z.objectInputType<{}, z.ZodTypeAny, "passthrough">>>;
+}, "strip", z.ZodTypeAny, {
+    type: "insert";
+    pageIndex: number;
+    markdown?: string | undefined;
+    sourcePdfPath?: string | undefined;
+    pdfOptions?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
+}, {
+    type: "insert";
+    pageIndex: number;
+    markdown?: string | undefined;
+    sourcePdfPath?: string | undefined;
+    pdfOptions?: z.objectInputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"delete">;
+    pageIndexes: z.ZodArray<z.ZodNumber, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "delete";
+    pageIndexes: number[];
+}, {
+    type: "delete";
+    pageIndexes: number[];
+}>]>;
+export declare const WritePdfArgsSchema: z.ZodObject<{
+    path: z.ZodString;
+    content: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"insert">;
+        pageIndex: z.ZodNumber;
+        markdown: z.ZodOptional<z.ZodString>;
+        sourcePdfPath: z.ZodOptional<z.ZodString>;
+        pdfOptions: z.ZodOptional<z.ZodObject<{}, "passthrough", z.ZodTypeAny, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">, z.objectInputType<{}, z.ZodTypeAny, "passthrough">>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "insert";
+        pageIndex: number;
+        markdown?: string | undefined;
+        sourcePdfPath?: string | undefined;
+        pdfOptions?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
+    }, {
+        type: "insert";
+        pageIndex: number;
+        markdown?: string | undefined;
+        sourcePdfPath?: string | undefined;
+        pdfOptions?: z.objectInputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"delete">;
+        pageIndexes: z.ZodArray<z.ZodNumber, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "delete";
+        pageIndexes: number[];
+    }, {
+        type: "delete";
+        pageIndexes: number[];
+    }>]>, "many">]>, string | ({
+        type: "insert";
+        pageIndex: number;
+        markdown?: string | undefined;
+        sourcePdfPath?: string | undefined;
+        pdfOptions?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
+    } | {
+        type: "delete";
+        pageIndexes: number[];
+    })[], unknown>;
+    outputPath: z.ZodOptional<z.ZodString>;
+    options: z.ZodOptional<z.ZodObject<{}, "passthrough", z.ZodTypeAny, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">, z.objectInputType<{}, z.ZodTypeAny, "passthrough">>>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    content: string | ({
+        type: "insert";
+        pageIndex: number;
+        markdown?: string | undefined;
+        sourcePdfPath?: string | undefined;
+        pdfOptions?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
+    } | {
+        type: "delete";
+        pageIndexes: number[];
+    })[];
+    options?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
+    outputPath?: string | undefined;
+}, {
+    path: string;
+    options?: z.objectInputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
+    content?: unknown;
+    outputPath?: string | undefined;
+}>;
+export declare const CreateDirectoryArgsSchema: z.ZodObject<{
+    path: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+}, {
+    path: string;
+}>;
+export declare const ListDirectoryArgsSchema: z.ZodObject<{
+    path: z.ZodString;
+    depth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    origin: z.ZodOptional<z.ZodEnum<["ui", "llm"]>>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    depth: number;
+    origin?: "ui" | "llm" | undefined;
+}, {
+    path: string;
+    origin?: "ui" | "llm" | undefined;
+    depth?: number | undefined;
+}>;
+export declare const MoveFileArgsSchema: z.ZodObject<{
+    source: z.ZodString;
+    destination: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    source: string;
+    destination: string;
+}, {
+    source: string;
+    destination: string;
+}>;
+export declare const GetFileInfoArgsSchema: z.ZodObject<{
+    path: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+}, {
+    path: string;
+}>;
+export declare const EditBlockArgsSchema: z.ZodEffects<z.ZodObject<{
+    file_path: z.ZodString;
+    old_string: z.ZodOptional<z.ZodString>;
+    new_string: z.ZodOptional<z.ZodString>;
+    expected_replacements: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    range: z.ZodOptional<z.ZodString>;
+    content: z.ZodOptional<z.ZodAny>;
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    origin: z.ZodOptional<z.ZodEnum<["ui", "llm"]>>;
+}, "strip", z.ZodTypeAny, {
+    file_path: string;
+    expected_replacements: number;
+    origin?: "ui" | "llm" | undefined;
+    options?: Record<string, any> | undefined;
+    range?: string | undefined;
+    content?: any;
+    old_string?: string | undefined;
+    new_string?: string | undefined;
+}, {
+    file_path: string;
+    origin?: "ui" | "llm" | undefined;
+    options?: Record<string, any> | undefined;
+    range?: string | undefined;
+    content?: any;
+    old_string?: string | undefined;
+    new_string?: string | undefined;
+    expected_replacements?: number | undefined;
+}>, {
+    file_path: string;
+    expected_replacements: number;
+    origin?: "ui" | "llm" | undefined;
+    options?: Record<string, any> | undefined;
+    range?: string | undefined;
+    content?: any;
+    old_string?: string | undefined;
+    new_string?: string | undefined;
+}, {
+    file_path: string;
+    origin?: "ui" | "llm" | undefined;
+    options?: Record<string, any> | undefined;
+    range?: string | undefined;
+    content?: any;
+    old_string?: string | undefined;
+    new_string?: string | undefined;
+    expected_replacements?: number | undefined;
+}>;
+export declare const InteractWithProcessArgsSchema: z.ZodObject<{
+    pid: z.ZodNumber;
+    input: z.ZodString;
+    timeout_ms: z.ZodOptional<z.ZodNumber>;
+    wait_for_prompt: z.ZodOptional<z.ZodBoolean>;
+    verbose_timing: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    pid: number;
+    input: string;
+    timeout_ms?: number | undefined;
+    verbose_timing?: boolean | undefined;
+    wait_for_prompt?: boolean | undefined;
+}, {
+    pid: number;
+    input: string;
+    timeout_ms?: number | undefined;
+    verbose_timing?: boolean | undefined;
+    wait_for_prompt?: boolean | undefined;
+}>;
+export declare const GetUsageStatsArgsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const GiveFeedbackArgsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const StartSearchArgsSchema: z.ZodObject<{
+    path: z.ZodString;
+    pattern: z.ZodString;
+    searchType: z.ZodDefault<z.ZodEnum<["files", "content"]>>;
+    filePattern: z.ZodOptional<z.ZodString>;
+    ignoreCase: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    maxResults: z.ZodOptional<z.ZodNumber>;
+    includeHidden: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    contextLines: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    timeout_ms: z.ZodOptional<z.ZodNumber>;
+    earlyTermination: z.ZodOptional<z.ZodBoolean>;
+    literalSearch: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    origin: z.ZodOptional<z.ZodEnum<["ui", "llm"]>>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    pattern: string;
+    searchType: "content" | "files";
+    ignoreCase: boolean;
+    includeHidden: boolean;
+    contextLines: number;
+    literalSearch: boolean;
+    origin?: "ui" | "llm" | undefined;
+    timeout_ms?: number | undefined;
+    filePattern?: string | undefined;
+    maxResults?: number | undefined;
+    earlyTermination?: boolean | undefined;
+}, {
+    path: string;
+    pattern: string;
+    origin?: "ui" | "llm" | undefined;
+    timeout_ms?: number | undefined;
+    searchType?: "content" | "files" | undefined;
+    filePattern?: string | undefined;
+    ignoreCase?: boolean | undefined;
+    maxResults?: number | undefined;
+    includeHidden?: boolean | undefined;
+    contextLines?: number | undefined;
+    earlyTermination?: boolean | undefined;
+    literalSearch?: boolean | undefined;
+}>;
+export declare const GetMoreSearchResultsArgsSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    length: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    length: number;
+    offset: number;
+    sessionId: string;
+}, {
+    sessionId: string;
+    length?: number | undefined;
+    offset?: number | undefined;
+}>;
+export declare const StopSearchArgsSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string;
+}, {
+    sessionId: string;
+}>;
+export declare const ListSearchesArgsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const GetPromptsArgsSchema: z.ZodObject<{
+    action: z.ZodEnum<["get_prompt"]>;
+    promptId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    action: "get_prompt";
+    promptId: string;
+}, {
+    action: "get_prompt";
+    promptId: string;
+}>;
+export declare const GetRecentToolCallsArgsSchema: z.ZodObject<{
+    maxResults: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    toolName: z.ZodOptional<z.ZodString>;
+    since: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    maxResults: number;
+    toolName?: string | undefined;
+    since?: string | undefined;
+}, {
+    maxResults?: number | undefined;
+    toolName?: string | undefined;
+    since?: string | undefined;
+}>;
+export declare const TrackUiEventArgsSchema: z.ZodObject<{
+    event: z.ZodString;
+    component: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    params: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>>;
+}, "strip", z.ZodTypeAny, {
+    params: Record<string, string | number | boolean | null>;
+    event: string;
+    component: string;
+}, {
+    event: string;
+    params?: Record<string, string | number | boolean | null> | undefined;
+    component?: string | undefined;
+}>;
+/**
+ * Map of tool name -> argument schema, used by the dispatcher to detect and warn
+ * about parameters a caller sent that the tool does not support. Keep in sync
+ * with the tool definitions in server.ts.
+ */
+export declare const toolArgSchemas: Record<string, z.ZodTypeAny>;

package/dist/tools/schemas.js

@@ -0,0 +1,242 @@
+import { z } from "zod";
+// Config tools schemas
+export const GetConfigArgsSchema = z.object({
+    // 'ui' marks calls the config-editor widget fires programmatically; they are
+    // excluded from tool-call telemetry (see isUiOriginCall in server.ts).
+    origin: z.enum(['ui', 'llm']).optional(),
+});
+export const SetConfigValueArgsSchema = z.object({
+    key: z.string(),
+    value: z.union([
+        z.string(),
+        z.number(),
+        z.boolean(),
+        z.array(z.string()),
+        z.null(),
+    ]),
+    // 'ui' marks widget-fired calls; excluded from tool-call telemetry.
+    origin: z.enum(['ui', 'llm']).optional(),
+});
+// Empty schemas
+export const ListProcessesArgsSchema = z.object({});
+// Terminal tools schemas
+export const StartProcessArgsSchema = z.object({
+    command: z.string(),
+    timeout_ms: z.number(),
+    working_directory: z.string().optional(),
+    shell: z.string().optional(),
+    verbose_timing: z.boolean().optional(),
+    // 'ui' marks widget-fired calls (e.g. open-in-folder/editor buttons);
+    // excluded from tool-call telemetry (see isUiOriginCall in server.ts).
+    origin: z.enum(['ui', 'llm']).optional(),
+});
+export const ReadProcessOutputArgsSchema = z.object({
+    pid: z.number(),
+    timeout_ms: z.number().optional(),
+    offset: z.number().optional(), // Line offset: 0=from last read, positive=absolute, negative=tail
+    length: z.number().optional(), // Max lines to return (default from config.fileReadLineLimit)
+    verbose_timing: z.boolean().optional(),
+});
+export const ForceTerminateArgsSchema = z.object({
+    pid: z.number(),
+});
+export const ListSessionsArgsSchema = z.object({});
+export const KillProcessArgsSchema = z.object({
+    pid: z.number(),
+});
+// Filesystem tools schemas
+export const ReadFileArgsSchema = z.object({
+    path: z.string(),
+    isUrl: z.boolean().optional().default(false),
+    offset: z.number().optional().default(0),
+    length: z.number().optional().default(1000),
+    sheet: z.string().optional(), // String only for MCP client compatibility (Cursor doesn't support union types in JSON Schema)
+    range: z.string().optional(),
+    options: z.record(z.any()).optional(),
+    // Whether the call came from the file-preview UI (refresh/navigation) or the
+    // LLM. 'ui' calls are excluded from tool-call telemetry; see isUiOriginCall
+    // in server.ts.
+    origin: z.enum(['ui', 'llm']).optional(),
+});
+export const ReadMultipleFilesArgsSchema = z.object({
+    paths: z.array(z.string()),
+});
+export const WriteFileArgsSchema = z.object({
+    path: z.string(),
+    content: z.string(),
+    mode: z.enum(['rewrite', 'append']).default('rewrite'),
+    // 'ui' when fired by the file-preview UI, else 'llm'. 'ui' calls are
+    // excluded from tool-call telemetry; see isUiOriginCall in server.ts.
+    origin: z.enum(['ui', 'llm']).optional(),
+});
+// PDF modification schemas - exported for reuse
+export const PdfInsertOperationSchema = z.object({
+    type: z.literal('insert'),
+    pageIndex: z.number(),
+    markdown: z.string().optional(),
+    sourcePdfPath: z.string().optional(),
+    pdfOptions: z.object({}).passthrough().optional(),
+});
+export const PdfDeleteOperationSchema = z.object({
+    type: z.literal('delete'),
+    pageIndexes: z.array(z.number()),
+});
+export const PdfOperationSchema = z.union([PdfInsertOperationSchema, PdfDeleteOperationSchema]);
+export const WritePdfArgsSchema = z.object({
+    path: z.string(),
+    // Preprocess content to handle JSON strings that should be parsed as arrays
+    content: z.preprocess((val) => {
+        // If it's a string that looks like JSON array, parse it
+        if (typeof val === 'string' && val.trim().startsWith('[')) {
+            try {
+                return JSON.parse(val);
+            }
+            catch {
+                // If parsing fails, return as-is (might be markdown content)
+                return val;
+            }
+        }
+        // Otherwise return as-is
+        return val;
+    }, z.union([z.string(), z.array(PdfOperationSchema)])),
+    outputPath: z.string().optional(),
+    options: z.object({}).passthrough().optional(), // Allow passing options to md-to-pdf
+});
+export const CreateDirectoryArgsSchema = z.object({
+    path: z.string(),
+});
+export const ListDirectoryArgsSchema = z.object({
+    path: z.string(),
+    depth: z.number().optional().default(2),
+    // 'ui' when fired by the file-preview UI, else 'llm'. 'ui' calls are
+    // excluded from tool-call telemetry; see isUiOriginCall in server.ts.
+    origin: z.enum(['ui', 'llm']).optional(),
+});
+export const MoveFileArgsSchema = z.object({
+    source: z.string(),
+    destination: z.string(),
+});
+export const GetFileInfoArgsSchema = z.object({
+    path: z.string(),
+});
+// Edit tools schema - SIMPLIFIED from three modes to two
+// Previously supported: text replacement, location-based edits (edits array), and range rewrites
+// Now supports only: text replacement and range rewrites
+// Removed 'edits' array parameter - location-based surgical edits were complex and unnecessary
+// Range rewrites are more powerful and cover all structured file editing needs
+export const EditBlockArgsSchema = z.object({
+    file_path: z.string(),
+    // Text file string replacement
+    old_string: z.string().optional(),
+    new_string: z.string().optional(),
+    expected_replacements: z.number().optional().default(1),
+    // Structured file range rewrite (Excel, etc.)
+    range: z.string().optional(),
+    content: z.any().optional(),
+    options: z.record(z.any()).optional(),
+    // 'ui' when fired by the file-preview UI, else 'llm'. 'ui' calls are
+    // excluded from tool-call telemetry; see isUiOriginCall in server.ts.
+    origin: z.enum(['ui', 'llm']).optional(),
+}).refine(data => {
+    // Helper to check if value is actually provided (not undefined, not empty string)
+    const hasValue = (v) => v !== undefined && v !== '';
+    return (hasValue(data.old_string) && data.new_string !== undefined) ||
+        (hasValue(data.range) && hasValue(data.content));
+}, { message: "Must provide either (old_string + new_string) or (range + content)" });
+// Send input to process schema
+export const InteractWithProcessArgsSchema = z.object({
+    pid: z.number(),
+    input: z.string(),
+    timeout_ms: z.number().optional(),
+    wait_for_prompt: z.boolean().optional(),
+    verbose_timing: z.boolean().optional(),
+});
+// Usage stats schema
+export const GetUsageStatsArgsSchema = z.object({});
+// Feedback tool schema - no pre-filled parameters, all user input
+export const GiveFeedbackArgsSchema = z.object({
+// No parameters needed - form will be filled manually by user
+// Only auto-filled hidden fields remain:
+// - tool_call_count (auto)
+// - days_using (auto) 
+// - platform (auto)
+// - client_id (auto)
+});
+// Search schemas (renamed for natural language)
+export const StartSearchArgsSchema = z.object({
+    path: z.string(),
+    pattern: z.string(),
+    searchType: z.enum(['files', 'content']).default('files'),
+    filePattern: z.string().optional(),
+    ignoreCase: z.boolean().optional().default(true),
+    maxResults: z.number().optional(),
+    includeHidden: z.boolean().optional().default(false),
+    contextLines: z.number().optional().default(5),
+    timeout_ms: z.number().optional(), // Match process naming convention
+    earlyTermination: z.boolean().optional(), // Stop search early when exact filename match is found (default: true for files, false for content)
+    literalSearch: z.boolean().optional().default(false), // Force literal string matching (-F flag) instead of regex
+    // 'ui' marks widget-fired calls (e.g. markdown link-target search);
+    // excluded from tool-call telemetry (see isUiOriginCall in server.ts).
+    origin: z.enum(['ui', 'llm']).optional(),
+});
+export const GetMoreSearchResultsArgsSchema = z.object({
+    sessionId: z.string(),
+    offset: z.number().optional().default(0), // Same as file reading
+    length: z.number().optional().default(100), // Same as file reading (but smaller default)
+});
+export const StopSearchArgsSchema = z.object({
+    sessionId: z.string(),
+});
+export const ListSearchesArgsSchema = z.object({});
+// Prompts tool schema - SIMPLIFIED (only get_prompt action)
+export const GetPromptsArgsSchema = z.object({
+    action: z.enum(['get_prompt']),
+    promptId: z.string(),
+    // Disabled to check if it makes sense or should be removed or changed
+    // anonymous_user_use_case: z.string().optional(),
+});
+// Tool history schema
+export const GetRecentToolCallsArgsSchema = z.object({
+    maxResults: z.number().min(1).max(1000).optional().default(50),
+    toolName: z.string().optional(),
+    since: z.string().datetime().optional(),
+});
+export const TrackUiEventArgsSchema = z.object({
+    event: z.string().min(1).max(80),
+    component: z.string().optional().default('file_preview'),
+    params: z.record(z.union([z.string(), z.number(), z.boolean(), z.null()])).optional().default({}),
+});
+/**
+ * Map of tool name -> argument schema, used by the dispatcher to detect and warn
+ * about parameters a caller sent that the tool does not support. Keep in sync
+ * with the tool definitions in server.ts.
+ */
+export const toolArgSchemas = {
+    get_config: GetConfigArgsSchema,
+    set_config_value: SetConfigValueArgsSchema,
+    read_file: ReadFileArgsSchema,
+    read_multiple_files: ReadMultipleFilesArgsSchema,
+    write_file: WriteFileArgsSchema,
+    write_pdf: WritePdfArgsSchema,
+    create_directory: CreateDirectoryArgsSchema,
+    list_directory: ListDirectoryArgsSchema,
+    move_file: MoveFileArgsSchema,
+    start_search: StartSearchArgsSchema,
+    get_more_search_results: GetMoreSearchResultsArgsSchema,
+    stop_search: StopSearchArgsSchema,
+    list_searches: ListSearchesArgsSchema,
+    get_file_info: GetFileInfoArgsSchema,
+    edit_block: EditBlockArgsSchema,
+    start_process: StartProcessArgsSchema,
+    read_process_output: ReadProcessOutputArgsSchema,
+    interact_with_process: InteractWithProcessArgsSchema,
+    force_terminate: ForceTerminateArgsSchema,
+    list_sessions: ListSessionsArgsSchema,
+    list_processes: ListProcessesArgsSchema,
+    kill_process: KillProcessArgsSchema,
+    get_usage_stats: GetUsageStatsArgsSchema,
+    get_recent_tool_calls: GetRecentToolCallsArgsSchema,
+    give_feedback_to_desktop_commander: GiveFeedbackArgsSchema,
+    get_prompts: GetPromptsArgsSchema,
+    track_ui_event: TrackUiEventArgsSchema,
+};