@ai-matrx/desktop-protocol 0.11.0 → 0.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,22 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.13.0
4
+
5
+ - `EXCLUDED_TOOLS`: tools armed with a device binding that are deliberately not device tools, with
6
+ the reason. `git_ingest` moves there (it ingests repository URLs on the server and refuses a local
7
+ path on a bound computer or sandbox); the status table lists them under "Not device tools".
8
+ - `shell_execute`'s summary: `cd` carries over between calls.
9
+
10
+ Consumer action: none.
11
+
12
+ ## 0.12.0
13
+
14
+ - `TOOL_CATALOG`: `desktop_transcribe` is built — one op, `models.transcribe`, reached through
15
+ aidream's generic `POST /api/local-proxy/{device}/op/{cap.op}`. matrx-local's `speech_locales`
16
+ needs no op of its own (Whisper detects the language).
17
+
18
+ Consumer action: none.
19
+
3
20
  ## 0.11.0
4
21
 
5
22
  - `createDesktopTranscriber(client, options)` (`./client`): speech to text on the person's own
package/dist/index.cjs CHANGED
@@ -58,6 +58,7 @@ __export(src_exports, {
58
58
  DesktopProtocolError: () => DesktopProtocolError,
59
59
  DeviceId: () => DeviceId,
60
60
  EVENTS: () => EVENTS,
61
+ EXCLUDED_TOOLS: () => EXCLUDED_TOOLS,
61
62
  EndMsg: () => EndMsg,
62
63
  EndReason: () => EndReason,
63
64
  ErrorCode: () => ErrorCode,
@@ -1534,18 +1535,8 @@ var TOOL_CATALOG = [
1534
1535
  { name: "fs_list", group: "files_shell", state: "built", path: "sandbox_proxy", ops: ["fs.list"], platforms: ALL, summary: "List a folder" },
1535
1536
  { name: "fs_mkdir", group: "files_shell", state: "built", path: "sandbox_proxy", ops: ["fs.mkdir"], platforms: ALL, summary: "Create a folder" },
1536
1537
  { name: "fs_search", group: "files_shell", state: "built", path: "sandbox_proxy", ops: ["fs.search_paths", "fs.search_content"], platforms: ALL, summary: "Find files by name or content" },
1537
- { name: "shell_execute", group: "files_shell", state: "built", path: "sandbox_proxy", ops: ["exec.run"], platforms: ALL, summary: "Run a command in a folder" },
1538
+ { name: "shell_execute", group: "files_shell", state: "built", path: "sandbox_proxy", ops: ["exec.run"], platforms: ALL, summary: "Run a command; cd carries over" },
1538
1539
  { name: "shell_python", group: "files_shell", state: "built", path: "sandbox_proxy", ops: ["exec.run"], platforms: ALL, summary: "Run a Python script" },
1539
- {
1540
- name: "git_ingest",
1541
- group: "files_shell",
1542
- state: "broken",
1543
- path: "server",
1544
- ops: [],
1545
- platforms: ALL,
1546
- summary: "Digest a repository",
1547
- note: "Armed with the files tools, but a local path is read on the server, not the bound device"
1548
- },
1549
1540
  { name: "shell_job", group: "files_shell", state: "planned", path: "device_op", ops: ["exec.job.start", "exec.job.output", "exec.job.stop"], platforms: ALL, summary: "Background commands: start, read output, stop" },
1550
1541
  // ── 2. Computer control (TS owners) ──────────────────────────────────────────────────────────
1551
1542
  { name: "desktop_process", group: "os_control", state: "planned", path: "device_op", ops: ["proc.list", "proc.ports", "proc.kill", "proc.launch_app", "proc.focus_app", "proc.installed_apps"], platforms: ALL, summary: "Processes, ports and apps" },
@@ -1571,10 +1562,15 @@ var TOOL_CATALOG = [
1571
1562
  { name: "desktop_documents", group: "tools_service", state: "planned", path: "device_op", ops: ["tools.pdf_extract", "tools.office_generate", "tools.ocr", "tools.image_resize"], platforms: ALL, summary: "PDF text, Office files, OCR, images" },
1572
1563
  { name: "desktop_entities", group: "tools_service", state: "planned", path: "device_op", ops: ["tools.ner", "tools.pii"], platforms: ALL, summary: "Names and private data, found on the device" },
1573
1564
  // ── 5. Python `ml` service ───────────────────────────────────────────────────────────────────
1574
- { name: "desktop_transcribe", group: "ml_service", state: "planned", path: "device_op", ops: ["models.transcribe", "models.speech_locales"], platforms: ALL, summary: "Speech to text on the device" },
1565
+ // Built: models.transcribe through local_proxy's POST /op/{cap.op} (matrx-ai implementations/desktop.py).
1566
+ // Whisper detects the language itself, so matrx-local's speech_locales needs no op of its own.
1567
+ { name: "desktop_transcribe", group: "ml_service", state: "built", path: "device_op", ops: ["models.transcribe"], platforms: ALL, summary: "Speech to text on the device" },
1575
1568
  // ── 6. Windows administration ────────────────────────────────────────────────────────────────
1576
1569
  { name: "desktop_windows_admin", group: "windows_admin", state: "planned", path: "device_op", ops: ["windows.registry_read", "windows.registry_write", "windows.services", "windows.service_control", "windows.event_log", "windows.features"], platforms: ["win32"], summary: "Registry, services, event log" }
1577
1570
  ];
1571
+ var EXCLUDED_TOOLS = {
1572
+ git_ingest: "Runs on the server: it ingests repository URLs. A local path on a bound computer or sandbox is refused with the fs_* and shell remedy, since the server cannot see it"
1573
+ };
1578
1574
  var tool = (name) => ({ kind: "tool", tool: name });
1579
1575
  var dropped = (reason) => ({ kind: "dropped", reason });
1580
1576
  var SHELL_COVERS = "Done with shell_execute (mv, cp, rm, tar), as every coding agent does";
@@ -1824,6 +1820,10 @@ function renderToolStatusMarkdown(status) {
1824
1820
  }
1825
1821
  lines.push("");
1826
1822
  }
1823
+ const excluded = Object.entries(EXCLUDED_TOOLS);
1824
+ if (excluded.length > 0) {
1825
+ lines.push("## Not device tools", "", "| Tool | Why |", "|---|---|", ...excluded.map(([name, why]) => `| ${name} | ${why} |`), "");
1826
+ }
1827
1827
  return lines.join("\n");
1828
1828
  }
1829
1829
  //# sourceMappingURL=index.cjs.map