@xingular/harness 0.1.3 → 0.1.5

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.
Files changed (32) hide show
  1. package/README.md +7 -3
  2. package/dist/cli.js +270 -125
  3. package/package.json +1 -1
  4. package/src/accounts/accounts.test.ts +1 -1
  5. package/src/accounts/env.test.ts +1 -1
  6. package/src/accounts/env.ts +1 -1
  7. package/src/core/path.test.ts +14 -0
  8. package/src/core/path.ts +56 -22
  9. package/src/mcp/connections.ts +2 -2
  10. package/src/mcp/manager.ts +2 -2
  11. package/src/memory/blocks.ts +2 -2
  12. package/src/memory/caller.ts +1 -1
  13. package/src/memory/dispatch.ts +1 -1
  14. package/src/memory/facts.ts +1 -1
  15. package/src/memory/store.ts +1 -1
  16. package/src/prompt/compile.test.ts +2 -2
  17. package/src/prompt/compile.ts +2 -2
  18. package/src/sessions/contracts.ts +12 -1
  19. package/src/sessions/runner.ts +16 -3
  20. package/src/sessions/sessions.test.ts +21 -0
  21. package/src/terminal/cli.ts +5 -5
  22. package/src/terminal/client.ts +2 -2
  23. package/src/terminal/launch.test.ts +34 -0
  24. package/src/terminal/launch.ts +88 -0
  25. package/src/terminal/socket.test.ts +44 -1
  26. package/src/terminal/socket.ts +32 -12
  27. package/src/terminal/standalone.test.ts +10 -0
  28. package/src/terminal/standalone.ts +11 -1
  29. package/src/terminal/terminal.test.ts +33 -5
  30. package/src/terminal/terminals.ts +32 -18
  31. package/src/tools/definitions.ts +2 -2
  32. package/src/tools/types.ts +3 -0
package/README.md CHANGED
@@ -13,7 +13,7 @@ needs to work for someone over time, and nothing about any particular applicatio
13
13
  | Plugins | `src/plugins/` | What a Pi session loads, chosen by the harness and never by Pi's own discovery; trust for a working folder's code; the list of every plugin and what reaches one caller. |
14
14
  | Tools | `src/tools/` | Tool definitions, the memory tools, `ask_user`; a gate that asks the application's policy, then standing approvals, then the person. |
15
15
  | Connected apps | `src/mcp/` | MCP connections, OAuth, per-session grants, redaction, a trace of what each call returned. |
16
- | Terminal | `src/terminal/` | Interactive Pi sessions with isolated accounts, compiled instructions, a telemetry and tool extension, and the session socket with the `agentx-wiki` and `agentx-mcp` commands. |
16
+ | Terminal | `src/terminal/` | Interactive Pi sessions with isolated accounts, compiled instructions, a telemetry and tool extension, and the session socket with the `xagent-wiki` and `xagent-mcp` commands. |
17
17
  | Server | `src/server/` | The same API over newline-delimited JSON, for a host that is not a Node program. |
18
18
 
19
19
  It was split out of Xingular Agent, which is now an application built on it.
@@ -58,6 +58,9 @@ An application adds what it knows through six points:
58
58
  updates.
59
59
  2. **Tool providers** (`harness.sessions.provide`). A provider returns `ToolSpec`s for a session;
60
60
  only the names in the session's `allow` list are registered, in that order.
61
+ A tool may return `attachments` as `{ id, name, mimeType }` references. The harness records
62
+ those references on `tool.completed`; attachment bytes remain with the provider and never enter
63
+ the run-event stream.
61
64
  The harness provides the web tools itself: `webTools({ secrets })` gives `web_search` (Brave Search,
62
65
  key read from the secret store) and `web_fetch` (checked reads of public pages). An application
63
66
  passes it to `harness.sessions.provide` and switches the names on for each agent.
@@ -207,8 +210,9 @@ npm install --global @xingular/harness
207
210
  xingular-harness
208
211
  ```
209
212
 
210
- The machine needs Node 22.13 or newer and the `pi` command on `PATH`. On first launch, the
211
- harness creates a `Default` Pi account; Pi handles provider sign-in.
213
+ The machine needs Node 22.19 or newer. On macOS and Linux, the `pi` command must be on `PATH`;
214
+ on Windows, Harness runs the pinned Pi CLI package through the active Node runtime. On first
215
+ launch, the harness creates a `Default` Pi account; Pi handles provider sign-in.
212
216
 
213
217
  To build and run from a source checkout instead:
214
218