@hcu-lab.me/mcp-device 1.0.9 → 1.0.10

package/dist/tools/schemas.d.ts

@@ -23,6 +23,8 @@ export declare const ListProcessesArgsSchema: z.ZodObject<{}, "strip", z.ZodType
 export declare const StartProcessArgsSchema: z.ZodObject<{
     command: z.ZodString;
     timeout_ms: z.ZodNumber;
+    yield_ms: z.ZodOptional<z.ZodNumber>;
+    background: z.ZodOptional<z.ZodBoolean>;
     working_directory: z.ZodOptional<z.ZodString>;
     shell: z.ZodOptional<z.ZodString>;
     verbose_timing: z.ZodOptional<z.ZodBoolean>;
@@ -31,6 +33,8 @@ export declare const StartProcessArgsSchema: z.ZodObject<{
     command: string;
     timeout_ms: number;
     origin?: "ui" | "llm" | undefined;
+    yield_ms?: number | undefined;
+    background?: boolean | undefined;
     working_directory?: string | undefined;
     shell?: string | undefined;
     verbose_timing?: boolean | undefined;
@@ -38,6 +42,8 @@ export declare const StartProcessArgsSchema: z.ZodObject<{
     command: string;
     timeout_ms: number;
     origin?: "ui" | "llm" | undefined;
+    yield_ms?: number | undefined;
+    background?: boolean | undefined;
     working_directory?: string | undefined;
     shell?: string | undefined;
     verbose_timing?: boolean | undefined;
@@ -106,10 +112,19 @@ export declare const ReadFileArgsSchema: z.ZodObject<{
 }>;
 export declare const ReadMultipleFilesArgsSchema: z.ZodObject<{
     paths: z.ZodArray<z.ZodString, "many">;
+    offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    length: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    maxBytes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
 }, "strip", z.ZodTypeAny, {
+    length: number;
+    offset: number;
     paths: string[];
+    maxBytes: number;
 }, {
     paths: string[];
+    length?: number | undefined;
+    offset?: number | undefined;
+    maxBytes?: number | undefined;
 }>;
 export declare const WriteFileArgsSchema: z.ZodObject<{
     path: z.ZodString;
@@ -287,19 +302,37 @@ export declare const EditBlockArgsSchema: z.ZodEffects<z.ZodObject<{
     old_string: z.ZodOptional<z.ZodString>;
     new_string: z.ZodOptional<z.ZodString>;
     expected_replacements: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    edits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        old_string: z.ZodString;
+        new_string: z.ZodString;
+        expected_replacements: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        old_string: string;
+        new_string: string;
+        expected_replacements: number;
+    }, {
+        old_string: string;
+        new_string: string;
+        expected_replacements?: number | undefined;
+    }>, "many">>;
     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;
+    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;
+    edits?: {
+        old_string: string;
+        new_string: string;
+        expected_replacements: number;
+    }[] | undefined;
 }, {
     file_path: string;
     origin?: "ui" | "llm" | undefined;
@@ -309,15 +342,25 @@ export declare const EditBlockArgsSchema: z.ZodEffects<z.ZodObject<{
     old_string?: string | undefined;
     new_string?: string | undefined;
     expected_replacements?: number | undefined;
+    edits?: {
+        old_string: string;
+        new_string: string;
+        expected_replacements?: number | undefined;
+    }[] | undefined;
 }>, {
-    file_path: string;
     expected_replacements: number;
+    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;
+    edits?: {
+        old_string: string;
+        new_string: string;
+        expected_replacements: number;
+    }[] | undefined;
 }, {
     file_path: string;
     origin?: "ui" | "llm" | undefined;
@@ -327,6 +370,11 @@ export declare const EditBlockArgsSchema: z.ZodEffects<z.ZodObject<{
     old_string?: string | undefined;
     new_string?: string | undefined;
     expected_replacements?: number | undefined;
+    edits?: {
+        old_string: string;
+        new_string: string;
+        expected_replacements?: number | undefined;
+    }[] | undefined;
 }>;
 export declare const InteractWithProcessArgsSchema: z.ZodObject<{
     pid: z.ZodNumber;
@@ -388,6 +436,50 @@ export declare const StartSearchArgsSchema: z.ZodObject<{
     earlyTermination?: boolean | undefined;
     literalSearch?: boolean | undefined;
 }>;
+export declare const SearchOnceArgsSchema: 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"]>>;
+} & {
+    maxBytes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    maxBytes: number;
+    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;
+    maxBytes?: 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>>;

package/dist/tools/schemas.js

@@ -23,6 +23,8 @@ export const ListProcessesArgsSchema = z.object({});
 export const StartProcessArgsSchema = z.object({
     command: z.string(),
     timeout_ms: z.number(),
+    yield_ms: z.number().positive().optional(),
+    background: z.boolean().optional(),
     working_directory: z.string().optional(),
     shell: z.string().optional(),
     verbose_timing: z.boolean().optional(),
@@ -60,6 +62,9 @@ export const ReadFileArgsSchema = z.object({
 });
 export const ReadMultipleFilesArgsSchema = z.object({
     paths: z.array(z.string()),
+    offset: z.number().optional().default(0),
+    length: z.number().optional().default(1000),
+    maxBytes: z.number().int().positive().optional().default(256 * 1024),
 });
 export const WriteFileArgsSchema = z.object({
     path: z.string(),
@@ -119,17 +124,21 @@ export const MoveFileArgsSchema = z.object({
 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
+// Edit tool schema. Legacy text replacement and structured range rewrites remain.
+// The additive edits[] mode is exact-only and batches multiple text replacements
+// into one validated read/write cycle.
+const ExactEditSchema = z.object({
+    old_string: z.string().min(1),
+    new_string: z.string(),
+    expected_replacements: z.number().int().positive().optional().default(1),
+});
 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),
+    edits: z.array(ExactEditSchema).min(1).optional(),
     // Structured file range rewrite (Excel, etc.)
     range: z.string().optional(),
     content: z.any().optional(),
@@ -141,8 +150,9 @@ export const EditBlockArgsSchema = z.object({
     // 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) ||
+        (data.edits !== undefined && data.edits.length > 0) ||
         (hasValue(data.range) && hasValue(data.content));
-}, { message: "Must provide either (old_string + new_string) or (range + content)" });
+}, { message: "Must provide either (old_string + new_string), edits, or (range + content)" });
 // Send input to process schema
 export const InteractWithProcessArgsSchema = z.object({
     pid: z.number(),
@@ -170,6 +180,9 @@ export const StartSearchArgsSchema = z.object({
     // excluded from tool-call telemetry (see isUiOriginCall in server.ts).
     origin: z.enum(['ui', 'llm']).optional(),
 });
+export const SearchOnceArgsSchema = StartSearchArgsSchema.extend({
+    maxBytes: z.number().int().positive().optional().default(256 * 1024),
+});
 export const GetMoreSearchResultsArgsSchema = z.object({
     sessionId: z.string(),
     offset: z.number().optional().default(0), // Same as file reading
@@ -213,6 +226,7 @@ export const toolArgSchemas = {
     list_directory: ListDirectoryArgsSchema,
     move_file: MoveFileArgsSchema,
     start_search: StartSearchArgsSchema,
+    search_once: SearchOnceArgsSchema,
     get_more_search_results: GetMoreSearchResultsArgsSchema,
     stop_search: StopSearchArgsSchema,
     list_searches: ListSearchesArgsSchema,

package/dist/types.d.ts

@@ -16,6 +16,9 @@ export interface TerminalSession {
     process: ChildProcess;
     outputLines: string[];
     lastReadIndex: number;
+    lastReadOffset: number;
+    outputVersion: number;
+    outputWaiters: Set<() => void>;
     isBlocked: boolean;
     startTime: Date;
     bufferedChars: number;
@@ -26,6 +29,10 @@ export interface CommandExecutionResult {
     pid: number;
     output: string;
     isBlocked: boolean;
+    deliveredCursor?: {
+        lineIndex: number;
+        lineOffset: number;
+    };
     timingInfo?: TimingInfo;
 }
 export interface TimingInfo {

package/dist/utils/output-budget.d.ts

@@ -0,0 +1,6 @@
+export interface BudgetedText {
+    text: string;
+    bytes: number;
+    truncated: boolean;
+}
+export declare function takeUtf8Budget(text: string, maxBytes: number): BudgetedText;

package/dist/utils/output-budget.js

@@ -0,0 +1,15 @@
+import { StringDecoder } from 'node:string_decoder';
+export function takeUtf8Budget(text, maxBytes) {
+    const totalBytes = Buffer.byteLength(text, 'utf8');
+    if (totalBytes <= maxBytes) {
+        return { text, bytes: totalBytes, truncated: false };
+    }
+    const decoder = new StringDecoder('utf8');
+    const chunk = Buffer.from(text, 'utf8').subarray(0, Math.max(0, maxBytes));
+    const bounded = decoder.write(chunk);
+    return {
+        text: bounded,
+        bytes: Buffer.byteLength(bounded, 'utf8'),
+        truncated: true,
+    };
+}

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "1.0.9";
+export declare const VERSION = "1.0.10";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = '1.0.9';
+export const VERSION = '1.0.10';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hcu-lab.me/mcp-device",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "description": "MCP Device runtime.",
   "license": "MIT",
   "author": "Hirohimeow",