@ai-matrx/desktop-protocol 0.2.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## 0.4.0
+
+fs.patch reports every edit, as the cloud sandbox daemon does (recorded from a live sandbox:
+matrx-desktop `test/fixtures/sandbox-daemon/observed.json`, `patch_cases`).
+
+- `FsPatchResult` gains `edits_applied` (`{ edit_index, mode: "create" | "replace" |
+  "replace_all", matches_replaced? }`, `matches_replaced` only for replace_all) and `edits_failed`
+  (`{ edit_index, reason }`, the daemon's reason text verbatim). `applied` stays (= the count).
+- When every edit fails (CONFLICT, reason `patch_no_match` / `patch_ambiguous`), the error's
+  `data.edits_failed` lists them — the daemon's 422 `failures`.
+
+Consumer action: none required (additive). Read `edits_failed` instead of reconstructing it from
+`applied`.
+
+## 0.3.0
+
+SPEC 6.1 sandbox parity: every search and list op now answers exactly what the cloud sandbox
+daemon answers (fd 8.3.1 / ripgrep 13 run in `cwd`), verified against answers recorded from a live
+sandbox (matrx-desktop `test/fixtures/sandbox-daemon/observed.json`).
+
+- `fs.search_content`: `results[].path` is RELATIVE to `cwd` (no `./`), `submatches[].match` is
+  ripgrep's `{ text }`, and there is no `truncated` (`max_results` caps matching lines per file,
+  as `rg -m`).
+- `fs.search_paths`: `paths` are RELATIVE to `cwd` and prefixed `./` (fd), sorted, cut to
+  `max_results`; no `truncated`.
+- `FsEntry` (`fs.stat`, `fs.list` entries) is the daemon's `get_stat_dict` field for field:
+  `mtime_ms` and `hidden` are gone (take a write guard from `fs.read`'s `mtime_ms`).
+- `fs.list` defaults are the daemon's behaviour: `limit` 1000, dotfiles listed (`show_hidden`
+  true), siblings in byte order of name (`sort` "name"). Page tokens are single-use.
+
+Consumer action: join a search path to `cwd` yourself when you need an absolute one; read
+`match.text` instead of `match`; drop any use of `truncated` on search results and of `mtime_ms` /
+`hidden` on entries.
+
 ## 0.2.0
 
 The phone console (lane E) needs a client that comes back the instant the person does.

package/dist/client.cjs

@@ -125,6 +125,7 @@ var import_zod2 = require("zod");
 var import_zod = require("zod");
 var PROTOCOL_MAJOR = 1;
 var PROTOCOL_MINOR = 0;
+var PROTOCOL_VERSION = `${PROTOCOL_MAJOR}.${PROTOCOL_MINOR}`;
 var ProtocolVersion = import_zod.z.string().regex(/^[1-9][0-9]{0,2}\.[0-9]{1,3}$/);
 var RequestId = import_zod.z.string().min(1).max(64).regex(/^[A-Za-z0-9_-]+$/);
 var ResourceId = import_zod.z.string().regex(/^(pty|watch)_[A-Za-z0-9]{16,40}$/);
@@ -183,6 +184,7 @@ var ErrorReason = import_zod2.z.enum([
   // another client of the same user took control
   "window_exhausted"
 ]);
+var FsPatchEditFailure = import_zod2.z.strictObject({ edit_index: nonNegInt, reason: import_zod2.z.string().max(300) });
 var ProtocolErrorBody = import_zod2.z.strictObject({
   code: ErrorCode,
   message: import_zod2.z.string().max(300),
@@ -197,6 +199,8 @@ var ProtocolErrorBody = import_zod2.z.strictObject({
     // PERMISSION_DENIED_OS deep link
     retry_after_ms: nonNegInt.optional(),
     limit_bytes: nonNegInt.optional(),
+    /** fs.patch when every edit failed (CONFLICT, patch_no_match / patch_ambiguous): the daemon's 422 `failures`. */
+    edits_failed: import_zod2.z.array(FsPatchEditFailure).max(256).optional(),
     upgrade: import_zod2.z.strictObject({
       min_version: ProtocolVersion,
       max_version: ProtocolVersion,
@@ -396,12 +400,9 @@ var FsEntry = import_zod6.z.strictObject({
   kind: FsKind,
   size: nonNegInt,
   mtime: import_zod6.z.number().min(0),
-  // seconds, float — daemon parity
-  mtime_ms: epochMs,
+  // seconds, float
   mode: import_zod6.z.int().min(0).max(4095),
-  target: AbsPath.nullable(),
-  // symlink target, never followed
-  hidden: import_zod6.z.boolean()
+  target: AbsPath.nullable()
 });
 var FsListParams = import_zod6.z.strictObject({
   path: AbsPath,
@@ -409,10 +410,12 @@ var FsListParams = import_zod6.z.strictObject({
   depth: import_zod6.z.int().min(1).max(32).default(1),
   pattern: import_zod6.z.string().max(256).optional(),
   // glob on name
-  limit: import_zod6.z.int().min(1).max(5e3).default(500),
+  limit: import_zod6.z.int().min(1).max(5e3).default(1e3),
   page_token: import_zod6.z.string().max(256).optional(),
-  show_hidden: import_zod6.z.boolean().default(false),
-  sort: import_zod6.z.enum(["name", "mtime", "size", "kind"]).default("kind")
+  // Desktop additions; their defaults ARE the daemon's behaviour: dotfiles listed, siblings in
+  // binary (byte) order of name, depth-first.
+  show_hidden: import_zod6.z.boolean().default(true),
+  sort: import_zod6.z.enum(["name", "mtime", "size", "kind"]).default("name")
 });
 var FsListResult = import_zod6.z.strictObject({
   entries: import_zod6.z.array(FsEntry),
@@ -489,14 +492,27 @@ var FsPatchParams = import_zod6.z.strictObject({
   ).min(1).max(256),
   create_if_missing: import_zod6.z.boolean().default(false)
 });
-var FsPatchResult = import_zod6.z.strictObject({ path: AbsPath, applied: nonNegInt, size: nonNegInt, mtime_ms: epochMs });
+var FsPatchEditApplied = import_zod6.z.strictObject({
+  edit_index: nonNegInt,
+  mode: import_zod6.z.enum(["create", "replace", "replace_all"]),
+  /** Present for replace_all only, as the daemon sends it. */
+  matches_replaced: nonNegInt.optional()
+});
+var FsPatchResult = import_zod6.z.strictObject({
+  path: AbsPath,
+  applied: nonNegInt,
+  size: nonNegInt,
+  mtime_ms: epochMs,
+  edits_applied: import_zod6.z.array(FsPatchEditApplied).max(256),
+  edits_failed: import_zod6.z.array(FsPatchEditFailure).max(256)
+});
 var FsSearchPathsParams = import_zod6.z.strictObject({
   pattern: import_zod6.z.string().min(1).max(512),
   cwd: AbsPath,
   hidden: import_zod6.z.boolean().default(false),
   max_results: import_zod6.z.int().min(1).max(5e3).default(100)
 });
-var FsSearchPathsResult = import_zod6.z.strictObject({ paths: import_zod6.z.array(AbsPath), truncated: import_zod6.z.boolean() });
+var FsSearchPathsResult = import_zod6.z.strictObject({ paths: import_zod6.z.array(import_zod6.z.string().min(3).max(4096).regex(/^\.\/[^\\\u0000]+$/)) });
 var FsSearchContentParams = import_zod6.z.strictObject({
   query: import_zod6.z.string().min(1).max(1024),
   cwd: AbsPath,
@@ -509,13 +525,14 @@ var FsSearchContentParams = import_zod6.z.strictObject({
 var FsSearchContentResult = import_zod6.z.strictObject({
   results: import_zod6.z.array(
     import_zod6.z.strictObject({
-      path: AbsPath,
+      path: import_zod6.z.string().min(1).max(4096).regex(/^[^/\\\u0000][^\\\u0000]*$/),
       lines: import_zod6.z.string(),
       line_number: import_zod6.z.int().min(1),
-      submatches: import_zod6.z.array(import_zod6.z.strictObject({ match: import_zod6.z.string(), start: nonNegInt, end: nonNegInt }))
+      submatches: import_zod6.z.array(
+        import_zod6.z.strictObject({ match: import_zod6.z.strictObject({ text: import_zod6.z.string() }), start: nonNegInt, end: nonNegInt })
+      )
     })
-  ),
-  truncated: import_zod6.z.boolean()
+  )
 });
 var FsChange = import_zod6.z.strictObject({
   type: import_zod6.z.enum(["created", "modified", "deleted", "moved"]),