@deepagents/context 7.5.1 → 7.6.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.
Files changed (55) hide show
  1. package/README.md +7 -5
  2. package/dist/index.js +1171 -1066
  3. package/dist/index.js.map +4 -4
  4. package/dist/lib/agent.d.ts.map +1 -1
  5. package/dist/lib/fragments/plan-shared.d.ts.map +1 -1
  6. package/dist/lib/sandbox/apple-container-sandbox.d.ts +2 -2
  7. package/dist/lib/sandbox/apple-container-sandbox.d.ts.map +1 -1
  8. package/dist/lib/sandbox/bash-tool.d.ts +0 -2
  9. package/dist/lib/sandbox/bash-tool.d.ts.map +1 -1
  10. package/dist/lib/sandbox/container-engine.d.ts +46 -14
  11. package/dist/lib/sandbox/container-engine.d.ts.map +1 -1
  12. package/dist/lib/sandbox/container-sandbox.d.ts.map +1 -1
  13. package/dist/lib/sandbox/container-session.d.ts +21 -0
  14. package/dist/lib/sandbox/container-session.d.ts.map +1 -0
  15. package/dist/lib/sandbox/daytona-sandbox.d.ts +3 -3
  16. package/dist/lib/sandbox/daytona-sandbox.d.ts.map +1 -1
  17. package/dist/lib/sandbox/docker-sandbox.d.ts +12 -13
  18. package/dist/lib/sandbox/docker-sandbox.d.ts.map +1 -1
  19. package/dist/lib/sandbox/legacy-sandbox.d.ts +8 -0
  20. package/dist/lib/sandbox/legacy-sandbox.d.ts.map +1 -0
  21. package/dist/lib/sandbox/microsandbox-sandbox.d.ts +6 -13
  22. package/dist/lib/sandbox/microsandbox-sandbox.d.ts.map +1 -1
  23. package/dist/lib/sandbox/read-file-tool/index.d.ts +2 -2
  24. package/dist/lib/sandbox/read-file-tool/index.d.ts.map +1 -1
  25. package/dist/lib/sandbox/read-file-tool/text.d.ts.map +1 -1
  26. package/dist/lib/sandbox/strace/file-changes.d.ts +22 -16
  27. package/dist/lib/sandbox/strace/file-changes.d.ts.map +1 -1
  28. package/dist/lib/sandbox/strace/index.d.ts +1 -1
  29. package/dist/lib/sandbox/strace/index.d.ts.map +1 -1
  30. package/dist/lib/sandbox/strace/index.js +7 -6
  31. package/dist/lib/sandbox/strace/index.js.map +2 -2
  32. package/dist/lib/sandbox/types.d.ts +26 -23
  33. package/dist/lib/sandbox/types.d.ts.map +1 -1
  34. package/dist/lib/sandbox/virtual-sandbox.d.ts +3 -3
  35. package/dist/lib/sandbox/virtual-sandbox.d.ts.map +1 -1
  36. package/dist/lib/stream/change-source.d.ts.map +1 -1
  37. package/dist/lib/telemetry/console-telemetry.d.ts +7 -1
  38. package/dist/lib/telemetry/console-telemetry.d.ts.map +1 -1
  39. package/dist/lib/telemetry/file/file-telemetry.d.ts +6 -0
  40. package/dist/lib/telemetry/file/file-telemetry.d.ts.map +1 -1
  41. package/dist/lib/telemetry/file/index.js +9 -5
  42. package/dist/lib/telemetry/file/index.js.map +2 -2
  43. package/dist/lib/telemetry/index.js +10 -6
  44. package/dist/lib/telemetry/index.js.map +2 -2
  45. package/dist/lib/telemetry/safe-serialize.d.ts +1 -1
  46. package/dist/lib/telemetry/safe-serialize.d.ts.map +1 -1
  47. package/dist/lib/tracing/batch-processor.d.ts +7 -1
  48. package/dist/lib/tracing/batch-processor.d.ts.map +1 -1
  49. package/dist/lib/tracing/index.js +24 -16
  50. package/dist/lib/tracing/index.js.map +2 -2
  51. package/dist/lib/tracing/openai-traces-integration.d.ts +9 -3
  52. package/dist/lib/tracing/openai-traces-integration.d.ts.map +1 -1
  53. package/package.json +19 -15
  54. package/dist/lib/sandbox/cli-process.d.ts +0 -35
  55. package/dist/lib/sandbox/cli-process.d.ts.map +0 -1
package/README.md CHANGED
@@ -54,15 +54,17 @@ deletes the underlying Daytona sandbox.
54
54
  ### File-change tracking
55
55
 
56
56
  `withStraceFileChanges()` decorates a real sandbox backend so each command,
57
- spawn, or file write reports the mutations it caused as a `FileChange[]`
57
+ spawn, file write, or file delete reports the mutations it caused as a `FileChange[]`
58
58
  (`{ op: 'write' | 'delete' | 'rename'; path; from?; timestamp }`).
59
- Consume changes via the `onFileChanges` callback (fires per command, spawn, or
60
- `writeFiles` call). Bash tool calls also receive
59
+ Consume changes via the `onFileChanges` callback (fires per command, spawn, file
60
+ write, or `deleteFile` that removed a file). Bash tool calls also receive
61
61
  `tool-result.output.meta.fileChanges` as hidden host-only metadata.
62
62
 
63
63
  Scope which paths are reported with `include` glob patterns (required — a path
64
64
  must match at least one); drop noise such as uploaded skills with optional
65
65
  `exclude` patterns. Both match absolute paths via Node's `path.matchesGlob`.
66
+ `createBashTool()` creates its working directory and uploads its files through the
67
+ decorator, so a callback that must not see that setup excludes those paths.
66
68
 
67
69
  ```ts
68
70
  const backend = await createDockerSandbox({ image: 'my-image-with-strace' });
@@ -74,11 +76,11 @@ const tracked = await withStraceFileChanges(backend, {
74
76
  });
75
77
  const sandbox = await createBashTool({
76
78
  sandbox: tracked,
77
- destination: '/workspace',
79
+ workingDirectory: '/workspace',
78
80
  });
79
81
  ```
80
82
 
81
- Tracking uses `strace` (per `executeCommand` and per `spawn`) when you compose
83
+ Tracking uses `strace` (per `run` and per `spawn`) when you compose
82
84
  the `withStraceFileChanges()` decorator. The decorator itself does **no**
83
85
  self-test — it trusts that strace tracing works in the sandbox, because "strace
84
86
  works here" is an invariant of the (image + host kernel + seccomp/caps) that is