feat(discord): read-only tools for the Discord Sage through a Mosaic pi extension confined to declared roots (#1509)

A binding may declare `tools` with named roots. pi starts with --no-builtin-tools and the package's own extension, allowlisting list_dir, read_file and search. src/tools.mjs holds the rules: names not paths, per-segment lstat walk, one checked descriptor read that refuses symlinks, swaps, FIFOs, hard links and oversize files, credential shapes refusing the whole read, and a per-message call budget. The engine settles on agent_end and records tool calls in the turn record. Jason's rulings R1-R7 in the brief, section 7. rev-code-02 approved round 2 (comment 26276) on tree 43f0329b after four round 1 fixes. Suite 48/48, node tests 116. Not pushed. Co-Authored-By: Claude Opus 5 <[email protected]>
2026-09-14 19:52:21 -05:00
parent c4fc8e7d7f
commit 1ac812d3d5
24 changed files with 1269 additions and 44 deletions
@@ -28,5 +28,13 @@
      "agents/sage/SOUL.md",
      "agents/sage/DISCORD-USER.md"
    ]
+  },
+  "tools": {
+    "roots": [
+      { "name": "stack-docs", "path": "/home/example/src/mosaic-stack/docs" },
+      { "name": "sage", "path": "/home/example/src/mosaic-stack/agents/sage" }
+    ],
+    "maxFileBytes": 262144,
+    "maxCallsPerTurn": 8
  }
 }