@sixb/agent 0.2.2 → 0.2.4

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 (105) hide show
  1. package/README.md +2 -2
  2. package/dist/artifacts/board-previews.d.ts +41 -0
  3. package/dist/artifacts/board-previews.d.ts.map +1 -0
  4. package/dist/artifacts/layout-check/layout-check.d.ts +38 -6
  5. package/dist/artifacts/layout-check/layout-check.d.ts.map +1 -1
  6. package/dist/artifacts/layout-check/overview.d.ts +17 -0
  7. package/dist/artifacts/layout-check/overview.d.ts.map +1 -0
  8. package/dist/artifacts/materialize.d.ts +56 -24
  9. package/dist/artifacts/materialize.d.ts.map +1 -1
  10. package/dist/artifacts/publish-tool.d.ts +35 -27
  11. package/dist/artifacts/publish-tool.d.ts.map +1 -1
  12. package/dist/ask-tool.d.ts +62 -0
  13. package/dist/ask-tool.d.ts.map +1 -0
  14. package/dist/attachments.d.ts +1 -1
  15. package/dist/attachments.d.ts.map +1 -1
  16. package/dist/background-commands.d.ts +3 -3
  17. package/dist/background-commands.d.ts.map +1 -1
  18. package/dist/background-notices.d.ts.map +1 -1
  19. package/dist/child-files.d.ts +1 -1
  20. package/dist/child-questions.d.ts +1 -1
  21. package/dist/index.d.ts +2 -1
  22. package/dist/index.d.ts.map +1 -1
  23. package/dist/index.js +12309 -10490
  24. package/dist/index.js.map +41 -35
  25. package/dist/run-agent-turn.d.ts.map +1 -1
  26. package/dist/run-conversation-turn.d.ts.map +1 -1
  27. package/dist/run-environment.d.ts +4 -1
  28. package/dist/run-environment.d.ts.map +1 -1
  29. package/dist/run-subagent.d.ts +1 -1
  30. package/dist/sandbox-files.d.ts +19 -0
  31. package/dist/sandbox-files.d.ts.map +1 -1
  32. package/dist/subagent-tools.d.ts +23 -2
  33. package/dist/subagent-tools.d.ts.map +1 -1
  34. package/dist/tools/background.d.ts +50 -18
  35. package/dist/tools/background.d.ts.map +1 -1
  36. package/dist/tools/bash.d.ts +1 -0
  37. package/dist/tools/bash.d.ts.map +1 -1
  38. package/dist/tools/edit-text.d.ts +22 -0
  39. package/dist/tools/edit-text.d.ts.map +1 -0
  40. package/dist/tools/edit.d.ts +54 -0
  41. package/dist/tools/edit.d.ts.map +1 -0
  42. package/dist/tools/file-writes.d.ts +52 -0
  43. package/dist/tools/file-writes.d.ts.map +1 -0
  44. package/dist/tools/model-spec.d.ts.map +1 -1
  45. package/dist/tools/read.d.ts +16 -3
  46. package/dist/tools/read.d.ts.map +1 -1
  47. package/dist/tools/tool-files.d.ts.map +1 -1
  48. package/dist/tools/view-file.d.ts +20 -23
  49. package/dist/tools/view-file.d.ts.map +1 -1
  50. package/dist/tools/web-fetch/tool.d.ts +1 -0
  51. package/dist/tools/web-fetch/tool.d.ts.map +1 -1
  52. package/dist/tools/web-search.d.ts +1 -0
  53. package/dist/tools/web-search.d.ts.map +1 -1
  54. package/dist/tools/write.d.ts +36 -0
  55. package/dist/tools/write.d.ts.map +1 -0
  56. package/dist/types.d.ts +5 -4
  57. package/dist/types.d.ts.map +1 -1
  58. package/package.json +7 -6
  59. package/src/agent-prompt.ts +10 -10
  60. package/src/artifacts/board-previews.ts +218 -0
  61. package/src/artifacts/layout-check/check.cjs +304 -80
  62. package/src/artifacts/layout-check/layout-check.ts +119 -9
  63. package/src/artifacts/layout-check/overview.ts +291 -0
  64. package/src/artifacts/materialize.ts +181 -55
  65. package/src/artifacts/publish-tool.ts +475 -163
  66. package/src/ask-tool.ts +223 -0
  67. package/src/attachments.ts +7 -6
  68. package/src/background-commands.ts +5 -5
  69. package/src/background-notices.ts +5 -12
  70. package/src/child-files.ts +1 -1
  71. package/src/child-questions.ts +1 -1
  72. package/src/context-compaction.ts +4 -1
  73. package/src/index.ts +2 -1
  74. package/src/run-agent-turn.ts +14 -4
  75. package/src/run-child.ts +1 -1
  76. package/src/run-conversation-turn.ts +4 -1
  77. package/src/run-environment.ts +40 -26
  78. package/src/run-subagent.ts +3 -3
  79. package/src/sandbox-api-context.ts +1 -1
  80. package/src/sandbox-files.ts +86 -0
  81. package/src/skills/sixb-artifacts/SKILL.md +48 -25
  82. package/src/skills/sixb-artifacts/canvas.md +140 -18
  83. package/src/skills/sixb-artifacts/examples/canvas/onboarding-flow/canvas.json +1 -1
  84. package/src/skills/sixb-artifacts/page.md +2 -2
  85. package/src/skills/sixb-artifacts/references.md +15 -12
  86. package/src/skills/sixb-artifacts/sheet.md +1 -1
  87. package/src/skills/sixb-artifacts/slides.md +2 -2
  88. package/src/subagent-tools.ts +134 -88
  89. package/src/tools/background.ts +227 -67
  90. package/src/tools/bash.ts +2 -1
  91. package/src/tools/edit-text.ts +241 -0
  92. package/src/tools/edit.ts +166 -0
  93. package/src/tools/file-writes.ts +270 -0
  94. package/src/tools/model-spec.ts +9 -12
  95. package/src/tools/read.ts +75 -9
  96. package/src/tools/tool-files.ts +3 -1
  97. package/src/tools/tool-outputs.ts +2 -2
  98. package/src/tools/view-file.ts +78 -80
  99. package/src/tools/web-fetch/tool.ts +2 -1
  100. package/src/tools/web-search.ts +1 -0
  101. package/src/tools/write.ts +95 -0
  102. package/src/types.ts +5 -4
  103. package/dist/ask-parent-tool.d.ts +0 -36
  104. package/dist/ask-parent-tool.d.ts.map +0 -1
  105. package/src/ask-parent-tool.ts +0 -100
@@ -1 +1 @@
1
- {"version":3,"file":"run-agent-turn.d.ts","sourceRoot":"","sources":["../src/run-agent-turn.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"run-agent-turn.d.ts","sourceRoot":"","sources":["../src/run-agent-turn.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"run-conversation-turn.d.ts","sourceRoot":"","sources":["../src/run-conversation-turn.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,eAAe,EAErB,MAAM,4BAA4B,CAAA;AAInC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,KAAK,EACV,cAAc,EAEd,iBAAiB,EAEjB,0BAA0B,EAC1B,eAAe,EACf,iBAAiB,EAClB,MAAM,oBAAoB,CAAA;AAI3B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAGrD,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAA;AAI1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAMtE,6CAA6C;AAC7C,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAA;IACnC,qEAAqE;IACrE,WAAW,CAAC,IAAI,EAAE;QAChB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,0BAA0B,CAAC,CAAA;QAC7D,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAA;QACvC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAA;QACnC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAA;KAC1C,GAAG,cAAc,CAAA;IAClB;;;OAGG;IACH,UAAU,CACR,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,aAAa,EACrB,aAAa,EAAE,oBAAoB,GAAG,SAAS,GAC9C,IAAI,CAAA;IACP,0FAA0F;IAC1F,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IACjD,2EAA2E;IAC3E,aAAa,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAAA;IACnF;;;OAGG;IACH,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CACnD;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAC/C,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,0BAA0B,CAAC,CAAA;IAC7D,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAA;IACvC,gFAAgF;IAChF,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAC7B,GAAG,OAAO,CAAC,IAAI,CAAC,CAgIhB"}
1
+ {"version":3,"file":"run-conversation-turn.d.ts","sourceRoot":"","sources":["../src/run-conversation-turn.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,eAAe,EAErB,MAAM,4BAA4B,CAAA;AAInC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,KAAK,EACV,cAAc,EAEd,iBAAiB,EAEjB,0BAA0B,EAC1B,eAAe,EACf,iBAAiB,EAClB,MAAM,oBAAoB,CAAA;AAK3B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAGrD,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAA;AAI1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAMtE,6CAA6C;AAC7C,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAA;IACnC,qEAAqE;IACrE,WAAW,CAAC,IAAI,EAAE;QAChB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,0BAA0B,CAAC,CAAA;QAC7D,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAA;QACvC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAA;QACnC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAA;KAC1C,GAAG,cAAc,CAAA;IAClB;;;OAGG;IACH,UAAU,CACR,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,aAAa,EACrB,aAAa,EAAE,oBAAoB,GAAG,SAAS,GAC9C,IAAI,CAAA;IACP,0FAA0F;IAC1F,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IACjD,2EAA2E;IAC3E,aAAa,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAAA;IACnF;;;OAGG;IACH,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CACnD;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAC/C,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,0BAA0B,CAAC,CAAA;IAC7D,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAA;IACvC,gFAAgF;IAChF,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAC7B,GAAG,OAAO,CAAC,IAAI,CAAC,CAkIhB"}
@@ -12,6 +12,7 @@ import { type BeforeFinalizeOptions, type RunSandbox } from "./run-sandbox";
12
12
  import { type SubagentThreadContext } from "./subagent-context";
13
13
  import type { SubagentHistory } from "./subagent-continuation";
14
14
  import { type LoadedAgentThreadModelContext } from "./thread-context";
15
+ import { type WaitableChildren } from "./tools/background";
15
16
  import type { AgentTurnRuntime } from "./turn-runtime";
16
17
  import type { AgentExecutionContext, AgentRunFiles, AgentTurnContext } from "./types";
17
18
  export interface AgentExecutionEnvironment {
@@ -86,6 +87,8 @@ export interface CreateConversationAgentEnvironmentInput extends CreateAgentEnvi
86
87
  readonly history: AgentTurnHistory;
87
88
  /** Framework-owned tools of the conversational Agent: delegation. */
88
89
  readonly frameworkTools?: readonly ModelTool[];
90
+ /** Its children, which `wait` and `stop` reach beside its background commands. */
91
+ readonly children?: WaitableChildren;
89
92
  }
90
93
  export interface CreateSubagentEnvironmentInput extends CreateAgentEnvironmentInput {
91
94
  /** The child's session: its workspace goes through it. */
@@ -99,7 +102,7 @@ export interface CreateSubagentEnvironmentInput extends CreateAgentEnvironmentIn
99
102
  readonly requestedBy?: Principal;
100
103
  /** Its thread's messages, whose files are projected again, and the paused run it continues. */
101
104
  readonly history: SubagentHistory;
102
- /** Framework-owned tools of a child: `ask_parent`. */
105
+ /** Framework-owned tools of a child: `ask`, to its parent. */
103
106
  readonly frameworkTools?: readonly ModelTool[];
104
107
  /** Weigh the thread before the first call, and compact it on the child's thread when needed. */
105
108
  readonly preflight?: {
@@ -1 +1 @@
1
- {"version":3,"file":"run-environment.d.ts","sourceRoot":"","sources":["../src/run-environment.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"run-environment.d.ts","sourceRoot":"","sources":["../src/run-environment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,EACL,KAAK,kBAAkB,EAEvB,KAAK,cAAc,EACnB,KAAK,eAAe,EAGpB,KAAK,gBAAgB,EAGtB,MAAM,4BAA4B,CAAA;AAEnC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,KAAK,EACV,4BAA4B,EAE5B,iBAAiB,EACjB,0BAA0B,EAC1B,iBAAiB,EACjB,0BAA0B,EAC3B,MAAM,oBAAoB,CAAA;AAwB3B,OAAO,EAGL,KAAK,mBAAmB,EAMzB,MAAM,sBAAsB,CAAA;AAI7B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAA;AAElE,OAAO,EAAE,KAAK,mBAAmB,EAAuB,MAAM,mBAAmB,CAAA;AACjF,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAqB,MAAM,kBAAkB,CAAA;AAClG,OAAO,EAGL,KAAK,qBAAqB,EAC1B,KAAK,UAAU,EAChB,MAAM,eAAe,CAAA;AAUtB,OAAO,EAEL,KAAK,qBAAqB,EAI3B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAC9D,OAAO,EAA2B,KAAK,6BAA6B,EAAE,MAAM,kBAAkB,CAAA;AAC9F,OAAO,EAAkC,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAsB1F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAGrF,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAA;IACtC,kGAAkG;IAClG,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;IAChC,0FAA0F;IAC1F,cAAc,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAED,MAAM,WAAW,qCAAsC,SAAQ,yBAAyB;IACtF,iFAAiF;IACjF,QAAQ,CAAC,aAAa,EAAE,6BAA6B,CAAA;IACrD;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE;QAC/B,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAA;KAC9C,KAAK,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAA;IAC9C,+FAA+F;IAC/F,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,uFAAuF;IACvF,QAAQ,CAAC,aAAa,CAAC,EAAE,oBAAoB,CAAA;CAC9C;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE;IACvC,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,iGAAiG;IACjG,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;CAC3C,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAA;AAE/B,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAA;IAC5B,0FAA0F;IAC1F,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,UAAU,2BAA2B;IACnC,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAA;IACvC,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAA;IACzC,mDAAmD;IACnD,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAA;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAA;CAChE;AAED,MAAM,WAAW,uCAAwC,SAAQ,2BAA2B;IAC1F,oFAAoF;IACpF,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAC1C,mGAAmG;IACnG,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAA;IAChC,+FAA+F;IAC/F,QAAQ,CAAC,YAAY,CAAC,EAAE,mBAAmB,CAAA;IAC3C,iFAAiF;IACjF,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,yEAAyE;IACzE,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;KAAE,CAAA;IAChG,QAAQ,CAAC,GAAG,EAAE,0BAA0B,CAAA;IACxC,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;IAClC,qEAAqE;IACrE,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,SAAS,EAAE,CAAA;IAC9C,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAA;CACrC;AAED,MAAM,WAAW,8BAA+B,SAAQ,2BAA2B;IACjF,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,QAAQ,CAAC,GAAG,EAAE,iBAAiB,CAAA;IAC/B,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;IAClC,4FAA4F;IAC5F,QAAQ,CAAC,YAAY,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAChD,yEAAyE;IACzE,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAA;IAChC,+FAA+F;IAC/F,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,8DAA8D;IAC9D,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,SAAS,EAAE,CAAA;IAC9C,gGAAgG;IAChG,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;KAAE,CAAA;IAChG;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,oBAAoB,CAAA;CACpD;AAED,MAAM,WAAW,iCAAkC,SAAQ,yBAAyB;IAClF,iFAAiF;IACjF,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAA;IACtC;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE;QAC9B,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAA;KAC9C,KAAK,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAA;IAC9C,6FAA6F;IAC7F,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAChC;AAED,MAAM,WAAW,uCAAwC,SAAQ,2BAA2B;IAC1F,QAAQ,CAAC,GAAG,EAAE,0BAA0B,CAAA;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAA;IACtC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAA;IACxC,2FAA2F;IAC3F,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAA;IAClC,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;CAChD;AAED,6FAA6F;AAC7F,wBAAsB,kCAAkC,CACtD,KAAK,EAAE,uCAAuC,GAC7C,OAAO,CAAC,qCAAqC,CAAC,CAyNhD;AAED;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,iCAAiC,CAAC,CAsC5C;AAoND,mFAAmF;AACnF,wBAAsB,kCAAkC,CACtD,KAAK,EAAE,uCAAuC,GAC7C,OAAO,CAAC,yBAAyB,CAAC,CAqDpC"}
@@ -50,7 +50,7 @@ export declare function runSubagent(input: {
50
50
  readonly runFiles: AgentRunFiles;
51
51
  /**
52
52
  * What its parent sends it while it runs, read before its next step, and the questions it asks,
53
- * through the inbox's `ask_parent` among its tools.
53
+ * through the inbox's `ask` among its tools.
54
54
  */
55
55
  readonly inbox: SubagentInbox;
56
56
  }): Promise<SubagentRunRecord>;
@@ -50,6 +50,25 @@ export declare function readSandboxFile(handle: AgentSandboxHandle, input: Sandb
50
50
  readonly path: string;
51
51
  readonly maxBytes: number;
52
52
  }): Promise<Uint8Array>;
53
+ /** One file of {@link readSandboxFiles}: its bytes, or why it could not be read. */
54
+ export type SandboxFileRead = {
55
+ readonly path: string;
56
+ readonly bytes: Uint8Array;
57
+ } | {
58
+ readonly path: string;
59
+ readonly error: SandboxFileErrorReason;
60
+ };
61
+ /**
62
+ * Read many regular files in one command, with the checks {@link readSandboxFile} makes on each.
63
+ * A file that fails is reported in its place and the others are read: one per path, in order.
64
+ * Everything comes back on one stdout, so keep the files' total to what a command prints.
65
+ */
66
+ export declare function readSandboxFiles(handle: AgentSandboxHandle, input: SandboxCommandOptions & {
67
+ /** Absolute paths, as `resolveSandboxPath` returns them. */
68
+ readonly paths: readonly string[];
69
+ /** The most each file may hold. */
70
+ readonly maxBytes: number;
71
+ }): Promise<SandboxFileRead[]>;
53
72
  /** What a path names once its symbolic links are followed. */
54
73
  export type SandboxPathEntry = {
55
74
  readonly kind: "file" | "directory";
@@ -1 +1 @@
1
- {"version":3,"file":"sandbox-files.d.ts","sourceRoot":"","sources":["../src/sandbox-files.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,kBAAkB,EAAe,MAAM,kBAAkB,CAAA;AAMvE,gGAAgG;AAChG,MAAM,MAAM,sBAAsB,GAC9B,cAAc,GACd,cAAc,GACd,WAAW,GACX,WAAW,GACX,SAAS,GACT,QAAQ,CAAA;AAEZ,qBAAa,gBAAiB,SAAQ,KAAK;IAEvC,QAAQ,CAAC,MAAM,EAAE,sBAAsB;gBAA9B,MAAM,EAAE,sBAAsB,EACvC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY;CAKzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,8FAA8F;IAC9F,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,2FAA2F;IAC3F,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,0FAA0F;IAC1F,QAAQ,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAA;IAC3C,+FAA+F;IAC/F,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AAED,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,MAAM,EAAE,CAI1E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAoB5F;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,qBAAqB,GAAG;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B,GACA,OAAO,CAAC,kBAAkB,CAAC,CAsC7B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,qBAAqB,GAAG;IAC7B,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B,GACA,OAAO,CAAC,UAAU,CAAC,CAwCrB;AAED,8DAA8D;AAC9D,MAAM,MAAM,gBAAgB,GACxB;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;IACnC,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAE7B;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,qBAAqB,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACvD,OAAO,CAAC,gBAAgB,CAAC,CAsB3B"}
1
+ {"version":3,"file":"sandbox-files.d.ts","sourceRoot":"","sources":["../src/sandbox-files.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,kBAAkB,EAAe,MAAM,kBAAkB,CAAA;AAMvE,gGAAgG;AAChG,MAAM,MAAM,sBAAsB,GAC9B,cAAc,GACd,cAAc,GACd,WAAW,GACX,WAAW,GACX,SAAS,GACT,QAAQ,CAAA;AAEZ,qBAAa,gBAAiB,SAAQ,KAAK;IAEvC,QAAQ,CAAC,MAAM,EAAE,sBAAsB;gBAA9B,MAAM,EAAE,sBAAsB,EACvC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY;CAKzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,8FAA8F;IAC9F,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,2FAA2F;IAC3F,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,0FAA0F;IAC1F,QAAQ,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAA;IAC3C,+FAA+F;IAC/F,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AAED,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,MAAM,EAAE,CAI1E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAoB5F;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,qBAAqB,GAAG;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B,GACA,OAAO,CAAC,kBAAkB,CAAC,CAsC7B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,qBAAqB,GAAG;IAC7B,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B,GACA,OAAO,CAAC,UAAU,CAAC,CAwCrB;AAED,oFAAoF;AACpF,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAA;CAAE,CAAA;AAErE;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,qBAAqB,GAAG;IAC7B,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B,GACA,OAAO,CAAC,eAAe,EAAE,CAAC,CA4B5B;AAMD,8DAA8D;AAC9D,MAAM,MAAM,gBAAgB,GACxB;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;IACnC,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAE7B;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,qBAAqB,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACvD,OAAO,CAAC,gBAAgB,CAAC,CAsB3B"}
@@ -6,6 +6,7 @@ import { type InstalledChildFile } from "./child-files";
6
6
  import { type QuestionRef } from "./child-questions";
7
7
  import { FamilyMailbox } from "./family-mailbox";
8
8
  import type { TurnChildren } from "./run-agent-turn";
9
+ import type { WaitableChildren } from "./tools/background";
9
10
  import type { AgentRunFiles, AgentRunSettings } from "./types";
10
11
  /**
11
12
  * How long a wait for children goes without reading their runs when nothing woke it. A child's
@@ -108,12 +109,14 @@ export interface WaitedQuestion extends QuestionRef {
108
109
  }
109
110
  export interface WaitForSubagentsOutput {
110
111
  readonly results: readonly WaitedSubagentResult[];
111
- /** Every question a child of this turn waits on: `wait_agent` returns as soon as one comes. */
112
+ /** Every question a child of this turn waits on: `wait` returns as soon as one comes. */
112
113
  readonly questions?: readonly WaitedQuestion[];
113
114
  /** The files no earlier result held, in the order of `results`. */
114
115
  readonly files: readonly InstalledChildFile[];
115
116
  /** Why what the children published is not all in `$SIXB_ARTIFACTS`. */
116
117
  readonly artifactsError?: string;
118
+ /** The folders the Agent published from that took what the children wrote. */
119
+ readonly artifactsNote?: string;
117
120
  }
118
121
  /** What a turn offers the children it spawns. */
119
122
  export interface TurnDelegation {
@@ -181,6 +184,15 @@ export declare class SubagentCoordinator {
181
184
  */
182
185
  private pausedChildrenToContinue;
183
186
  createTools(): Promise<readonly ModelTool[]>;
187
+ /** The turn's children as `wait` and `stop` reach them, by key or run id. */
188
+ waitable(): WaitableChildren;
189
+ /**
190
+ * Stop one of this turn's children, then return what `wait` returns for it once it ended: its
191
+ * answer so far, the files it wrote, the messages it did not read.
192
+ */
193
+ stop(id: string, signal: AbortSignal): Promise<WaitForSubagentsOutput>;
194
+ /** The run a key names: this turn's child under it. A run id names itself. */
195
+ private childRunId;
184
196
  /**
185
197
  * Send a child a message, through the turn's mailbox. Its id names this turn, the model call and
186
198
  * the tool call in it, so a replay of the call is the same message and the child reads it once,
@@ -234,6 +246,15 @@ export declare class SubagentCoordinator {
234
246
  /** The open questions of the turn's children still at work, each with the child's key. */
235
247
  private askingChildren;
236
248
  spawn(input: SpawnSubagentInput, signal: AbortSignal): Promise<SpawnSubagentOutput>;
249
+ /**
250
+ * The runs these ids name. A run id names itself. A key names this turn's child under it, the one
251
+ * a spawn of this same step is admitting, or else the conversation's latest child under it, as
252
+ * `message_agent` finds one. Calls of one step run together, each starting once its call is
253
+ * published, so a wait may begin before the spawn beside it: a key that names nothing yet is
254
+ * looked up again a few times, a second at most. What is still missing the caller refuses.
255
+ */
256
+ private resolveChildren;
257
+ private admitSpawn;
237
258
  private admitInTurn;
238
259
  /**
239
260
  * What admission will answer, read before the files the child is handed: the child already
@@ -274,7 +295,7 @@ export declare class SubagentCoordinator {
274
295
  private earlierTurnsOf;
275
296
  /**
276
297
  * Copy what each finished child wrote under `out/` into the parent's sandbox, once, and install
277
- * what the children published in its `$SIXB_ARTIFACTS`, as the parent's own. A result holds at
298
+ * the artifacts the children wrote in its `$SIXB_ARTIFACTS`, as the parent's own. A result holds at
278
299
  * most the attachment limits of new files, a child's whole or not at all; a child that does not
279
300
  * fit, or whose files cannot be copied, says so, and its files come with a later wait.
280
301
  */
@@ -1 +1 @@
1
- {"version":3,"file":"subagent-tools.d.ts","sourceRoot":"","sources":["../src/subagent-tools.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"subagent-tools.d.ts","sourceRoot":"","sources":["../src/subagent-tools.ts"],"names":[],"mappings":"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"}
@@ -1,17 +1,30 @@
1
- import type { ModelTool } from "@sixb/core/models";
2
- import type { BackgroundCommands } from "../background-commands";
1
+ import { type ModelTool } from "@sixb/core/models";
2
+ import type { BackgroundCommandOutput, BackgroundCommands } from "../background-commands";
3
3
  import type { AgentSandboxHandle } from "../sandbox-handle";
4
- export declare const BASH_OUTPUT_TOOL_SPEC: {
5
- readonly name: "bash_output";
6
- readonly description: "A background command's status (running, exited with its code, or stopped) and its output since your last read: the newest 20,000 bytes, the rest in its file. wait blocks until it ends, at most that many ms. You are told when one ends: do not poll.";
4
+ import type { WaitForSubagentsOutput } from "../subagent-tools";
5
+ /** Before `wait` and `stop`, a background command's tools: earlier threads hold calls to them. */
6
+ export declare const LEGACY_BACKGROUND_TOOLS: readonly ["bash_output", "bash_stop"];
7
+ /** Before `wait`, the Agent's wait for its children: earlier threads hold calls to it. */
8
+ export declare const LEGACY_WAIT_AGENT_TOOL = "wait_agent";
9
+ export declare const WAIT_TOOL_SPEC: {
10
+ readonly name: "wait";
11
+ readonly strict: true;
12
+ readonly description: string;
7
13
  readonly inputSchema: {
8
14
  type: string;
9
15
  properties: {
10
- id: {
16
+ ids: {
11
17
  type: string;
18
+ minItems: number;
19
+ maxItems: number;
20
+ uniqueItems: true;
21
+ items: {
22
+ type: string;
23
+ minLength: number;
24
+ };
12
25
  description: string;
13
26
  };
14
- wait: {
27
+ timeoutMs: {
15
28
  type: string;
16
29
  description: string;
17
30
  };
@@ -20,14 +33,16 @@ export declare const BASH_OUTPUT_TOOL_SPEC: {
20
33
  additionalProperties: false;
21
34
  };
22
35
  };
23
- export declare const BASH_STOP_TOOL_SPEC: {
24
- readonly name: "bash_stop";
25
- readonly description: "Stop a background command and all it started: SIGTERM, then SIGKILL after 3 s. Returns its final status and output since your last read.";
36
+ export declare const STOP_TOOL_SPEC: {
37
+ readonly name: "stop";
38
+ readonly strict: true;
39
+ readonly description: "Stop work you started: a background command and all it started (SIGTERM, then SIGKILL after 3 s), or a child agent of this turn. Returns what wait would: how it ended, and its output or answer so far.";
26
40
  readonly inputSchema: {
27
41
  type: string;
28
42
  properties: {
29
43
  id: {
30
44
  type: string;
45
+ minLength: number;
31
46
  description: string;
32
47
  };
33
48
  };
@@ -35,16 +50,33 @@ export declare const BASH_STOP_TOOL_SPEC: {
35
50
  additionalProperties: false;
36
51
  };
37
52
  };
38
- interface BashOutputToolInput {
39
- readonly id: string;
40
- readonly wait?: number;
53
+ /**
54
+ * The Agent's children, as `wait` and `stop` reach them: an id that names no background command
55
+ * names one of them, by its key or its run id.
56
+ */
57
+ export interface WaitableChildren {
58
+ wait(ids: readonly string[], signal: AbortSignal): Promise<WaitForSubagentsOutput>;
59
+ stop(id: string, signal: AbortSignal): Promise<WaitForSubagentsOutput>;
60
+ }
61
+ /** What `wait` and `stop` return: the commands named, and the children's results. */
62
+ export interface WaitOutput extends Partial<Omit<WaitForSubagentsOutput, "files">> {
63
+ readonly commands?: readonly BackgroundCommandOutput[];
64
+ }
65
+ interface WaitToolInput {
66
+ readonly ids: readonly string[];
67
+ readonly timeoutMs?: number;
41
68
  }
42
- interface BashStopToolInput {
69
+ interface StopToolInput {
43
70
  readonly id: string;
44
71
  }
45
- /** `bash_output`: a background command's status and new output, after waiting when asked. */
46
- export declare function createBashOutputTool(resolveSandbox: () => Promise<AgentSandboxHandle>, commands: BackgroundCommands): ModelTool<BashOutputToolInput>;
47
- /** `bash_stop`: stop a background command, then report how it ended and its last output. */
48
- export declare function createBashStopTool(resolveSandbox: () => Promise<AgentSandboxHandle>, commands: BackgroundCommands): ModelTool<BashStopToolInput>;
72
+ /** `wait`: until the commands and children named end, a child asks, or the timeout passes. */
73
+ export declare function createWaitTool(resolveSandbox: () => Promise<AgentSandboxHandle>, commands: BackgroundCommands, children?: WaitableChildren): ModelTool<WaitToolInput>;
74
+ /** `stop`: stop a command or a child, then report how it ended and its output or answer so far. */
75
+ export declare function createStopTool(resolveSandbox: () => Promise<AgentSandboxHandle>, commands: BackgroundCommands, children?: WaitableChildren): ModelTool<StopToolInput>;
76
+ /**
77
+ * The background commands a tool's result reports, as each read it: `bash` and the tools before
78
+ * `wait` report one, `wait` and `stop` those they name.
79
+ */
80
+ export declare function reportedCommands(toolName: string, output: unknown): readonly unknown[];
49
81
  export {};
50
82
  //# sourceMappingURL=background.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"background.d.ts","sourceRoot":"","sources":["../../src/tools/background.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAyB,SAAS,EAAE,MAAM,mBAAmB,CAAA;AACzE,OAAO,KAAK,EAA2B,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAEzF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAK3D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;CAgBxB,CAAA;AAEV,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;CAYtB,CAAA;AAEV,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,UAAU,iBAAiB;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CACpB;AAED,6FAA6F;AAC7F,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,EACjD,QAAQ,EAAE,kBAAkB,GAC3B,SAAS,CAAC,mBAAmB,CAAC,CA0BhC;AAED,4FAA4F;AAC5F,wBAAgB,kBAAkB,CAChC,cAAc,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,EACjD,QAAQ,EAAE,kBAAkB,GAC3B,SAAS,CAAC,iBAAiB,CAAC,CAkB9B"}
1
+ {"version":3,"file":"background.d.ts","sourceRoot":"","sources":["../../src/tools/background.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoD,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAA;AACpG,OAAO,KAAK,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAEzF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAQ/D,kGAAkG;AAClG,eAAO,MAAM,uBAAuB,uCAAwC,CAAA;AAE5E,0FAA0F;AAC1F,eAAO,MAAM,sBAAsB,eAAe,CAAA;AAElD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BjB,CAAA;AAEV,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;CAiBjB,CAAA;AAEV;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAA;IAClF,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAA;CACvE;AAED,qFAAqF;AACrF,MAAM,WAAW,UAAW,SAAQ,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC;IAChF,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAA;CACvD;AAED,UAAU,aAAa;IACrB,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAA;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,UAAU,aAAa;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CACpB;AAED,8FAA8F;AAC9F,wBAAgB,cAAc,CAC5B,cAAc,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,EACjD,QAAQ,EAAE,kBAAkB,EAC5B,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,SAAS,CAAC,aAAa,CAAC,CA6D1B;AAED,mGAAmG;AACnG,wBAAgB,cAAc,CAC5B,cAAc,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,EACjD,QAAQ,EAAE,kBAAkB,EAC5B,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,SAAS,CAAC,aAAa,CAAC,CAwB1B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,SAAS,OAAO,EAAE,CAOtF"}
@@ -4,6 +4,7 @@ import type { BackgroundCommands } from "../background-commands";
4
4
  import type { AgentSandboxHandle } from "../sandbox-handle";
5
5
  export declare const BASH_TOOL_SPEC: {
6
6
  readonly name: "bash";
7
+ readonly strict: true;
7
8
  readonly description: string;
8
9
  readonly inputSchema: {
9
10
  type: string;
@@ -1 +1 @@
1
- {"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../src/tools/bash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,YAAY,CAAA;AACrE,OAAO,KAAK,EAAyB,SAAS,EAAE,MAAM,mBAAmB,CAAA;AACzE,OAAO,KAAK,EAA0B,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAExF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAO3D,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;CA8BjB,CAAA;AAEV,UAAU,aAAa;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;CACrC;AAED,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;IACjC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAClC;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,cAAc,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,EACjD,UAAU,EAAE,kBAAkB,GAC7B,SAAS,CAAC,aAAa,CAAC,CAoC1B;AAsED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc,CAEvE;AAiBD,UAAU,cAAc;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,CAe7E"}
1
+ {"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../src/tools/bash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,YAAY,CAAA;AACrE,OAAO,KAAK,EAAyB,SAAS,EAAE,MAAM,mBAAmB,CAAA;AACzE,OAAO,KAAK,EAA0B,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAExF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAO3D,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BjB,CAAA;AAEV,UAAU,aAAa;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;CACrC;AAED,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;IACjC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAClC;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,cAAc,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,EACjD,UAAU,EAAE,kBAAkB,GAC7B,SAAS,CAAC,aAAa,CAAC,CAoC1B;AAsED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc,CAEvE;AAiBD,UAAU,cAAc;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,CAe7E"}
@@ -0,0 +1,22 @@
1
+ /**
2
+ * The text half of `edit`: find `old` in a file, replace it, and describe the change as a unified
3
+ * diff, or say where to look when it does not match. No sandbox here, so it is tested on strings.
4
+ */
5
+ export type EditTextResult = {
6
+ readonly ok: true;
7
+ readonly text: string;
8
+ readonly replaced: number;
9
+ readonly diff: string;
10
+ /** Lines the change adds and removes, all of them: the diff may be cut. */
11
+ readonly added: number;
12
+ readonly removed: number;
13
+ } | {
14
+ readonly ok: false;
15
+ readonly reason: string;
16
+ };
17
+ export declare function editText(text: string, input: {
18
+ readonly old: string;
19
+ readonly new: string;
20
+ readonly all: boolean;
21
+ }): EditTextResult;
22
+ //# sourceMappingURL=edit-text.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"edit-text.d.ts","sourceRoot":"","sources":["../../src/tools/edit-text.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,MAAM,cAAc,GACtB;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB,GACD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAEnD,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;CAAE,GAC3E,cAAc,CAsChB"}
@@ -0,0 +1,54 @@
1
+ import type { ModelTool } from "@sixb/core/models";
2
+ import type { AgentSandboxHandle } from "../sandbox-handle";
3
+ import { type FileReadLedger, type LoadedSandboxFile } from "./file-writes";
4
+ export declare const EDIT_TOOL_SPEC: {
5
+ readonly name: "edit";
6
+ readonly strict: true;
7
+ readonly description: "Replace text in a file. old_string must match the file exactly, once, unless replace_all is true. Read the file first: an edit refuses a file that changed since you read it. Returns the change as a diff, so there is no need to read the file again to check it.";
8
+ readonly inputSchema: {
9
+ type: string;
10
+ properties: {
11
+ path: {
12
+ type: string;
13
+ description: string;
14
+ };
15
+ old_string: {
16
+ type: string;
17
+ description: string;
18
+ };
19
+ new_string: {
20
+ type: string;
21
+ description: string;
22
+ };
23
+ replace_all: {
24
+ type: string;
25
+ description: string;
26
+ };
27
+ };
28
+ required: string[];
29
+ additionalProperties: false;
30
+ };
31
+ };
32
+ export interface EditToolInput {
33
+ readonly path: string;
34
+ readonly old_string: string;
35
+ readonly new_string: string;
36
+ readonly replace_all?: boolean;
37
+ }
38
+ export interface EditToolOutput {
39
+ readonly path: string;
40
+ readonly replaced: number;
41
+ /** Unified diff of the change, with line numbers; cut past a few thousand characters. */
42
+ readonly diff: string;
43
+ /** Lines the change adds and removes, all of them, however short the diff was cut. */
44
+ readonly added: number;
45
+ readonly removed: number;
46
+ }
47
+ export declare function createEditTool(resolveSandbox: () => Promise<AgentSandboxHandle>, ledger: FileReadLedger): ModelTool<EditToolInput>;
48
+ /** An existing file is changed only as the run last read or wrote it. */
49
+ export declare function assertReadAsIs(ledger: FileReadLedger, loaded: Extract<LoadedSandboxFile, {
50
+ kind: "file";
51
+ }>, path: string, tool: string): void;
52
+ export declare function objectInput(value: unknown, tool: string, keys: readonly string[]): Record<string, unknown>;
53
+ export declare function pathInput(value: unknown, tool: string): string;
54
+ //# sourceMappingURL=edit.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../src/tools/edit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAyB,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAEzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAE3D,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EAGvB,MAAM,eAAe,CAAA;AAEtB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuBjB,CAAA;AAEV,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,yFAAyF;IACzF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,sFAAsF;IACtF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,wBAAgB,cAAc,CAC5B,cAAc,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,EACjD,MAAM,EAAE,cAAc,GACrB,SAAS,CAAC,aAAa,CAAC,CA2C1B;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAC5B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,OAAO,CAAC,iBAAiB,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACpD,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,IAAI,CAWN;AAyBD,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAK9D"}
@@ -0,0 +1,52 @@
1
+ import { AgentToolPublicError } from "@sixb/core";
2
+ import { type AgentSandboxHandle } from "../sandbox-handle";
3
+ /** The largest file `edit` changes and `write` writes: a whole file passes through the harness. */
4
+ export declare const MAX_EDITED_FILE_BYTES: number;
5
+ /**
6
+ * What a run has read, by real path: the file's fingerprint (`cksum`: CRC and size) when it read
7
+ * it. `edit` and `write` change an existing file only when it is the file the run read, so a change
8
+ * made since, by the user, another process or the run's own `bash`, is never overwritten blind.
9
+ */
10
+ export declare class FileReadLedger {
11
+ #private;
12
+ record(realPath: string, fingerprint: string): void;
13
+ get(realPath: string): string | undefined;
14
+ }
15
+ export type LoadedSandboxFile = {
16
+ readonly kind: "missing";
17
+ } | {
18
+ readonly kind: "file";
19
+ readonly realPath: string;
20
+ readonly fingerprint: string;
21
+ readonly bytes: Uint8Array;
22
+ };
23
+ /** Read a whole file for `edit` or `write`: where it really is, its fingerprint and its bytes. */
24
+ export declare function loadSandboxFile(handle: AgentSandboxHandle, input: {
25
+ readonly path: string;
26
+ readonly tool: string;
27
+ readonly signal: AbortSignal;
28
+ }): Promise<LoadedSandboxFile>;
29
+ /**
30
+ * Write `bytes` to `path` when the file there is still `expected` (a fingerprint, or `missing`
31
+ * for a file to create), keeping an existing file's mode. Missing parent directories are created
32
+ * inside the run's roots. Returns where the file is and its new fingerprint.
33
+ */
34
+ export declare function commitSandboxFile(handle: AgentSandboxHandle, input: {
35
+ readonly path: string;
36
+ readonly expected: string;
37
+ readonly bytes: Uint8Array;
38
+ readonly tool: string;
39
+ readonly signal: AbortSignal;
40
+ }): Promise<{
41
+ readonly realPath: string;
42
+ readonly fingerprint: string;
43
+ }>;
44
+ export declare function publicError(tool: string, message: string): AgentToolPublicError;
45
+ export declare function isFingerprint(value: string): boolean;
46
+ /**
47
+ * Bash functions shared with `read`: a file's fingerprint as `crc:size` from `cksum`, and a real
48
+ * path on one line (empty when the path holds a newline, which then goes unrecorded). Neither
49
+ * needs `tr` or `awk`, which some sandbox images lack.
50
+ */
51
+ export declare const FINGERPRINT_FUNCTIONS = "fingerprint() {\n local sum rest\n sum=\"$(cksum < \"$1\")\" || return 1\n rest=\"${sum#* }\"\n printf '%s:%s\\n' \"${sum%% *}\" \"${rest%% *}\"\n}\nprint_path() {\n case \"$1\" in *$'\\n'*) printf '\\n' ;; *) printf '%s\\n' \"$1\" ;; esac\n}";
52
+ //# sourceMappingURL=file-writes.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"file-writes.d.ts","sourceRoot":"","sources":["../../src/tools/file-writes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAsB,MAAM,YAAY,CAAA;AAErE,OAAO,EAAE,KAAK,kBAAkB,EAAe,MAAM,mBAAmB,CAAA;AAExE,mGAAmG;AACnG,eAAO,MAAM,qBAAqB,QAAc,CAAA;AAShD;;;;GAIG;AACH,qBAAa,cAAc;;IAGzB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAInD,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAG1C;AAED,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAC3B,CAAA;AAEL,kGAAkG;AAClG,wBAAsB,eAAe,CACnC,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GACpF,OAAO,CAAC,iBAAiB,CAAC,CAoB5B;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE;IACL,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAC7B,GACA,OAAO,CAAC;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CA8CtE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAE/E;AAqDD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,4PAQhC,CAAA"}
@@ -1 +1 @@
1
- {"version":3,"file":"model-spec.d.ts","sourceRoot":"","sources":["../../src/tools/model-spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAChF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAYhE;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,SAAS,aAAa,EAAE,EACtC,OAAO,GAAE;IACP,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,eAAe,CAAA;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,oBAAoB,CAAA;CACzC,GACL,SAAS,aAAa,EAAE,CAc1B;AAED,8FAA8F;AAC9F,wBAAgB,UAAU,CACxB,GAAG,EAAE,eAAe,GAAG,SAAS,EAChC,aAAa,EAAE,oBAAoB,GAAG,SAAS,GAC9C,OAAO,CAET"}
1
+ {"version":3,"file":"model-spec.d.ts","sourceRoot":"","sources":["../../src/tools/model-spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAChF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAUhE;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,SAAS,aAAa,EAAE,EACtC,OAAO,GAAE;IACP,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,eAAe,CAAA;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,oBAAoB,CAAA;CACzC,GACL,SAAS,aAAa,EAAE,CAa1B;AAED,8FAA8F;AAC9F,wBAAgB,UAAU,CACxB,GAAG,EAAE,eAAe,GAAG,SAAS,EAChC,aAAa,EAAE,oBAAoB,GAAG,SAAS,GAC9C,OAAO,CAET"}
@@ -1,8 +1,11 @@
1
1
  import type { ModelTool } from "@sixb/core/models";
2
2
  import { type AgentSandboxHandle } from "../sandbox-handle";
3
+ import { type FileReadLedger } from "./file-writes";
4
+ import { type SandboxFileViewer } from "./view-file";
3
5
  export declare const READ_TOOL_SPEC: {
4
6
  readonly name: "read";
5
- readonly description: "Read a UTF-8 text file relative to the sandbox working directory. Returns at most 2,000 lines or 50 KiB and includes nextOffset when more content remains. Prefer this over bash for reading files.";
7
+ readonly strict: true;
8
+ readonly description: "Read a file, or list a directory. Text comes as at most 2,000 lines or 50 KiB, with nextOffset when more remains; an image or a PDF comes as itself; a directory as its entries, folders ending in /. Prefer this over bash for reading files.";
6
9
  readonly inputSchema: {
7
10
  type: string;
8
11
  properties: {
@@ -30,6 +33,12 @@ export interface ReadToolInput {
30
33
  readonly offset?: number;
31
34
  readonly limit?: number;
32
35
  }
36
+ /** A directory's entries, names only, folders ending in `/`. */
37
+ export interface ReadDirectoryOutput {
38
+ readonly path: string;
39
+ readonly entries: readonly string[];
40
+ readonly truncated?: true;
41
+ }
33
42
  export interface ReadToolOutput {
34
43
  readonly path: string;
35
44
  readonly content: string;
@@ -38,6 +47,10 @@ export interface ReadToolOutput {
38
47
  readonly truncated: boolean;
39
48
  readonly nextOffset?: number;
40
49
  }
41
- /** Build the bounded UTF-8 file reader from the run's lazy sandbox resolver. */
42
- export declare function createReadTool(resolveSandbox: () => Promise<AgentSandboxHandle>): ModelTool<ReadToolInput>;
50
+ /** Build the reader from the run's lazy sandbox resolver. */
51
+ export declare function createReadTool(resolveSandbox: () => Promise<AgentSandboxHandle>,
52
+ /** Where each read is recorded, so `edit` and `write` change only a file the run has read. */
53
+ ledger?: FileReadLedger,
54
+ /** Shows images, PDFs and other files that are not text; without it, they are refused. */
55
+ viewer?: SandboxFileViewer): ModelTool<ReadToolInput>;
43
56
  //# sourceMappingURL=read.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/tools/read.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAyB,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAGzE,OAAO,EAAE,KAAK,kBAAkB,EAAe,MAAM,mBAAmB,CAAA;AAOxE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;CAsBjB,CAAA;AAEV,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAC5B,cAAc,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,GAChD,SAAS,CAAC,aAAa,CAAC,CAqD1B"}
1
+ {"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/tools/read.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAyB,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAGzE,OAAO,EAAE,KAAK,kBAAkB,EAAe,MAAM,mBAAmB,CAAA;AACxE,OAAO,EAAyB,KAAK,cAAc,EAAiB,MAAM,eAAe,CAAA;AACzF,OAAO,EAAsB,KAAK,iBAAiB,EAAmB,MAAM,aAAa,CAAA;AAUzF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;CAuBjB,CAAA;AAEV,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,gEAAgE;AAChE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAA;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED,6DAA6D;AAC7D,wBAAgB,cAAc,CAC5B,cAAc,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC;AACjD,8FAA8F;AAC9F,MAAM,CAAC,EAAE,cAAc;AACvB,0FAA0F;AAC1F,MAAM,CAAC,EAAE,iBAAiB,GACzB,SAAS,CAAC,aAAa,CAAC,CA2E1B"}
@@ -1 +1 @@
1
- {"version":3,"file":"tool-files.d.ts","sourceRoot":"","sources":["../../src/tools/tool-files.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAyB,cAAc,EAAE,MAAM,YAAY,CAAA;AAEtF,OAAO,EACL,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EAEvB,MAAM,4BAA4B,CAAA;AACnC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAE3D,OAAO,EAAE,oBAAoB,EAAE,CAAA;AAG/B,UAAU,yBAAyB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAA;IACvC,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAC1D,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAA;IACpD,+FAA+F;IAC/F,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAA;IACjC,iEAAiE;IACjE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED,0EAA0E;AAC1E,qBAAa,eAAe;;IAQd,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,SAAwB;IAMrD,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,oBAAoB;IAQ9D,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAO1C,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI5B,+FAA+F;IAC/F,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAUtE,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAQrC;AAED,cAAM,oBAAoB;;IAMtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAFR,MAAM,EAAE,eAAe,EACxC,KAAK,EAAE,MAAM,EACI,QAAQ,EAAE,MAAM;IAKnC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKxB,gGAAgG;IAChG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKnD,OAAO,IAAI,IAAI;CAMhB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,cAAc,CAyBrF;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAA;IAC5C,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAA;IACvC,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAC1D,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;IAChC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAA;CACrD,GAAG,OAAO,CAAC,IAAI,CAAC,CAehB"}
1
+ {"version":3,"file":"tool-files.d.ts","sourceRoot":"","sources":["../../src/tools/tool-files.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAyB,cAAc,EAAE,MAAM,YAAY,CAAA;AAGtF,OAAO,EACL,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EAEvB,MAAM,4BAA4B,CAAA;AACnC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAE3D,OAAO,EAAE,oBAAoB,EAAE,CAAA;AAI/B,UAAU,yBAAyB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAA;IACvC,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAC1D,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAA;IACpD,+FAA+F;IAC/F,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAA;IACjC,iEAAiE;IACjE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED,0EAA0E;AAC1E,qBAAa,eAAe;;IAQd,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,SAAwB;IAMrD,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,oBAAoB;IAQ9D,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAO1C,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI5B,+FAA+F;IAC/F,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAUtE,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAQrC;AAED,cAAM,oBAAoB;;IAMtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAFR,MAAM,EAAE,eAAe,EACxC,KAAK,EAAE,MAAM,EACI,QAAQ,EAAE,MAAM;IAKnC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKxB,gGAAgG;IAChG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKnD,OAAO,IAAI,IAAI;CAMhB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,cAAc,CAyBrF;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAA;IAC5C,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAA;IACvC,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAC1D,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;IAChC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAA;CACrD,GAAG,OAAO,CAAC,IAAI,CAAC,CAehB"}
@@ -1,29 +1,15 @@
1
1
  import type { AgentToolFiles, JsonValue } from "@sixb/core";
2
- import type { ModelTool } from "@sixb/core/models";
3
2
  import type { PreparedAgentAttachmentContext } from "../attachments";
4
3
  import type { AgentSandboxFileRegistry } from "../sandbox-file-registry";
5
4
  import type { AgentSandboxHandle } from "../sandbox-handle";
6
5
  import type { AgentToolModelOutput } from "./result-output";
7
- export declare const VIEW_FILE_TOOL_SPEC: {
8
- readonly name: "view_file";
9
- readonly description: "Inspect a file in the current run sandbox. Use this for historical attachments and files created by bash. Paths must stay inside the working directory or the run's context directory. Images are prepared for visual input when supported; other formats return bounded text or metadata.";
10
- readonly inputSchema: {
11
- type: string;
12
- properties: {
13
- path: {
14
- type: string;
15
- minLength: number;
16
- };
17
- };
18
- required: string[];
19
- additionalProperties: false;
20
- };
21
- };
22
- interface ViewFileInput {
23
- readonly path: string;
24
- }
25
- export declare function createViewFileTool(input: {
26
- readonly resolveSandbox: () => Promise<AgentSandboxHandle>;
6
+ /**
7
+ * What `read` took over: earlier threads hold calls to `view_file`, and their results replay as
8
+ * they were stored, images included.
9
+ */
10
+ export declare const LEGACY_VIEW_FILE_TOOL = "view_file";
11
+ /** What `read` needs to show a file as itself, an image or a PDF, rather than as text. */
12
+ export interface SandboxFileViewer {
27
13
  readonly attachments: PreparedAgentAttachmentContext;
28
14
  readonly registry: AgentSandboxFileRegistry;
29
15
  readonly filesForToolCall: (options: {
@@ -35,6 +21,17 @@ export declare function createViewFileTool(input: {
35
21
  readonly signal: AbortSignal;
36
22
  readonly toolCallId: string;
37
23
  }) => AgentToolModelOutput | Promise<AgentToolModelOutput>;
38
- }): ModelTool<ViewFileInput>;
39
- export {};
24
+ }
25
+ /**
26
+ * A sandbox file as a rich result: the file itself, stored with the call, which the run's media
27
+ * bridge shows the model as an image or a document when it can, and as metadata otherwise. An
28
+ * attachment, or a file a tool stored, is the snapshot it already is.
29
+ */
30
+ export declare function viewSandboxFile(viewer: SandboxFileViewer, handle: AgentSandboxHandle, input: {
31
+ readonly path: string;
32
+ readonly toolCallId: string;
33
+ readonly signal: AbortSignal;
34
+ }): Promise<JsonValue>;
35
+ /** Whether `path` names an attachment or a file a tool stored, which `read` shows as itself. */
36
+ export declare function isKnownSandboxFile(viewer: SandboxFileViewer, handle: AgentSandboxHandle, path: string): boolean;
40
37
  //# sourceMappingURL=view-file.d.ts.map