@sixb/agent 0.2.1 → 0.2.3

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 (107) hide show
  1. package/README.md +2 -1
  2. package/dist/agent-prompt.d.ts +13 -0
  3. package/dist/agent-prompt.d.ts.map +1 -1
  4. package/dist/agent-runtime/preflight.d.ts.map +1 -1
  5. package/dist/artifacts/board-previews.d.ts +41 -0
  6. package/dist/artifacts/board-previews.d.ts.map +1 -0
  7. package/dist/artifacts/layout-check/layout-check.d.ts +38 -6
  8. package/dist/artifacts/layout-check/layout-check.d.ts.map +1 -1
  9. package/dist/artifacts/layout-check/overview.d.ts +17 -0
  10. package/dist/artifacts/layout-check/overview.d.ts.map +1 -0
  11. package/dist/artifacts/materialize.d.ts +56 -24
  12. package/dist/artifacts/materialize.d.ts.map +1 -1
  13. package/dist/artifacts/publish-tool.d.ts +35 -9
  14. package/dist/artifacts/publish-tool.d.ts.map +1 -1
  15. package/dist/background-commands.d.ts +95 -0
  16. package/dist/background-commands.d.ts.map +1 -0
  17. package/dist/background-notices.d.ts +31 -0
  18. package/dist/background-notices.d.ts.map +1 -0
  19. package/dist/computer-runner.d.ts +63 -2
  20. package/dist/computer-runner.d.ts.map +1 -1
  21. package/dist/context-compaction.d.ts +3 -0
  22. package/dist/context-compaction.d.ts.map +1 -1
  23. package/dist/execution-plan.d.ts +12 -2
  24. package/dist/execution-plan.d.ts.map +1 -1
  25. package/dist/index.d.ts +3 -1
  26. package/dist/index.d.ts.map +1 -1
  27. package/dist/index.js +11814 -8722
  28. package/dist/index.js.map +35 -23
  29. package/dist/login-shell.d.ts +16 -0
  30. package/dist/login-shell.d.ts.map +1 -0
  31. package/dist/run-child.d.ts +3 -0
  32. package/dist/run-child.d.ts.map +1 -1
  33. package/dist/run-conversation-turn.d.ts +6 -2
  34. package/dist/run-conversation-turn.d.ts.map +1 -1
  35. package/dist/run-environment.d.ts +12 -2
  36. package/dist/run-environment.d.ts.map +1 -1
  37. package/dist/run-sandbox.d.ts +23 -0
  38. package/dist/run-sandbox.d.ts.map +1 -1
  39. package/dist/sandbox-files.d.ts +19 -0
  40. package/dist/sandbox-files.d.ts.map +1 -1
  41. package/dist/subagent-tools.d.ts +3 -1
  42. package/dist/subagent-tools.d.ts.map +1 -1
  43. package/dist/tools/background.d.ts +50 -0
  44. package/dist/tools/background.d.ts.map +1 -0
  45. package/dist/tools/bash.d.ts +12 -4
  46. package/dist/tools/bash.d.ts.map +1 -1
  47. package/dist/tools/model-spec.d.ts +9 -2
  48. package/dist/tools/model-spec.d.ts.map +1 -1
  49. package/dist/tools/tool-files.d.ts.map +1 -1
  50. package/dist/tools/tool-outputs.d.ts +12 -2
  51. package/dist/tools/tool-outputs.d.ts.map +1 -1
  52. package/dist/tools/web-fetch/cache.d.ts +33 -0
  53. package/dist/tools/web-fetch/cache.d.ts.map +1 -0
  54. package/dist/tools/web-fetch/html-markdown.d.ts +25 -0
  55. package/dist/tools/web-fetch/html-markdown.d.ts.map +1 -0
  56. package/dist/tools/web-fetch/network.d.ts +55 -0
  57. package/dist/tools/web-fetch/network.d.ts.map +1 -0
  58. package/dist/tools/web-fetch/tool.d.ts +96 -0
  59. package/dist/tools/web-fetch/tool.d.ts.map +1 -0
  60. package/dist/tools/web-search.d.ts +40 -0
  61. package/dist/tools/web-search.d.ts.map +1 -0
  62. package/dist/types.d.ts +5 -4
  63. package/dist/types.d.ts.map +1 -1
  64. package/dist/workspace-instructions.d.ts +15 -0
  65. package/dist/workspace-instructions.d.ts.map +1 -0
  66. package/package.json +15 -5
  67. package/src/agent-prompt.ts +64 -5
  68. package/src/agent-runtime/preflight.ts +2 -1
  69. package/src/artifacts/board-previews.ts +218 -0
  70. package/src/artifacts/layout-check/check.cjs +304 -80
  71. package/src/artifacts/layout-check/layout-check.ts +123 -13
  72. package/src/artifacts/layout-check/overview.ts +291 -0
  73. package/src/artifacts/materialize.ts +181 -55
  74. package/src/artifacts/publish-tool.ts +459 -129
  75. package/src/background-commands.ts +573 -0
  76. package/src/background-notices.ts +178 -0
  77. package/src/computer-runner.ts +211 -9
  78. package/src/context-compaction.ts +4 -1
  79. package/src/execution-plan.ts +15 -2
  80. package/src/index.ts +4 -0
  81. package/src/login-shell.ts +18 -0
  82. package/src/run-child.ts +5 -0
  83. package/src/run-conversation-turn.ts +23 -4
  84. package/src/run-environment.ts +96 -17
  85. package/src/run-sandbox.ts +41 -0
  86. package/src/sandbox-api-context.ts +1 -1
  87. package/src/sandbox-files.ts +88 -1
  88. package/src/skills/sixb-artifacts/SKILL.md +48 -25
  89. package/src/skills/sixb-artifacts/canvas.md +140 -18
  90. package/src/skills/sixb-artifacts/examples/canvas/onboarding-flow/canvas.json +1 -1
  91. package/src/skills/sixb-artifacts/page.md +1 -1
  92. package/src/skills/sixb-artifacts/references.md +15 -12
  93. package/src/skills/sixb-artifacts/sheet.md +1 -1
  94. package/src/skills/sixb-artifacts/slides.md +1 -1
  95. package/src/subagent-tools.ts +19 -7
  96. package/src/tools/background.ts +127 -0
  97. package/src/tools/bash.ts +80 -11
  98. package/src/tools/model-spec.ts +28 -5
  99. package/src/tools/tool-files.ts +3 -1
  100. package/src/tools/tool-outputs.ts +46 -6
  101. package/src/tools/web-fetch/cache.ts +91 -0
  102. package/src/tools/web-fetch/html-markdown.ts +479 -0
  103. package/src/tools/web-fetch/network.ts +452 -0
  104. package/src/tools/web-fetch/tool.ts +619 -0
  105. package/src/tools/web-search.ts +139 -0
  106. package/src/types.ts +5 -4
  107. package/src/workspace-instructions.ts +163 -0
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Runs a script in a bash that is not a login shell, once a login shell has loaded the profile:
3
+ * the profile's exports reach the script, and its `exit` leaves the login shell alone.
4
+ *
5
+ * A login shell runs `~/.bash_logout` when the `exit` builtin ends it, with the script's options
6
+ * still set. Debian's and Ubuntu's default one runs `clear_console`, which fails without a
7
+ * terminal, so a script under `set -e` that ends with `exit 0` exits 1. `exec` replaces the login
8
+ * shell without running that file, and keeps its pid, so a background command's `$!` and process
9
+ * group are still the script's.
10
+ *
11
+ * Arguments: the script.
12
+ */
13
+ export declare const LOGIN_SHELL_SCRIPT = "exec \"$BASH\" -c \"$1\" bash";
14
+ /** `bash` arguments that run `script` as {@link LOGIN_SHELL_SCRIPT} does. */
15
+ export declare function loginShellArgs(script: string): string[];
16
+ //# sourceMappingURL=login-shell.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"login-shell.d.ts","sourceRoot":"","sources":["../src/login-shell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,kCAA8B,CAAA;AAE7D,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAEvD"}
@@ -1,4 +1,5 @@
1
1
  import { type AgentRunSession } from "@sixb/core/internal/agents";
2
+ import type { SandboxNetworkPolicy } from "@sixb/core/sandboxes";
2
3
  import type { AgentRunRecord, AgentThreadRecord, ExecutionRecord, SubagentRunRecord } from "@sixb/core/storage";
3
4
  import type { AgentRunFailure } from "./failure";
4
5
  import type { FamilyMailbox } from "./family-mailbox";
@@ -42,6 +43,8 @@ export interface ChildParent {
42
43
  holdLease(session: AgentRunSession<SubagentRunRecord>): Promise<() => void>;
43
44
  /** The turn's mailbox, through which they talk. */
44
45
  readonly family: FamilyMailbox;
46
+ /** The network the turn's `web_fetch` follows, which the child's follows too. */
47
+ readonly networkPolicy?: SandboxNetworkPolicy;
45
48
  }
46
49
  /**
47
50
  * Runs the children of a runner's turns. A child holds its own run, session, token and sandbox,
@@ -1 +1 @@
1
- {"version":3,"file":"run-child.d.ts","sourceRoot":"","sources":["../src/run-child.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,eAAe,EAErB,MAAM,4BAA4B,CAAA;AAInC,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,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;AAK1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAKtE,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAA;IACnC,8FAA8F;IAC9F,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB;;;OAGG;IACH,KAAK,CACH,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE;QAAE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;KAAE,GACrE,OAAO,CAAC,eAAe,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC,CAAA;IACrD,sEAAsE;IACtE,WAAW,CAAC,KAAK,EAAE;QACjB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,iBAAiB,CAAC,CAAA;QACpD,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAA;QACvC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAA;QACnC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;KACnC,GAAG,cAAc,CAAA;IAClB,2FAA2F;IAC3F,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IACjD,4EAA4E;IAC5E,aAAa,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAAA;IACnF,oFAAoF;IACpF,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CACxE;AAED,kDAAkD;AAClD,MAAM,WAAW,WAAW;IAC1B,mFAAmF;IACnF,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,0EAA0E;IAC1E,cAAc,IAAI,MAAM,CAAA;IACxB,wFAAwF;IACxF,SAAS,CAAC,OAAO,EAAE,eAAe,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAA;IAC3E,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;CAC/B;AASD;;;;GAIG;AACH,qBAAa,WAAW;IAOV,OAAO,CAAC,QAAQ,CAAC,IAAI;IANjC,wFAAwF;IACxF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,+FAA+F;IAC/F,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAEhB,IAAI,EAAE,eAAe;IAElD,0FAA0F;IAC1F,KAAK,CAAC,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI;IAcxD;;;OAGG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxD,kEAAkE;IAC5D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAId,GAAG;IAkBjB,kFAAkF;IAClF,OAAO,CAAC,QAAQ;IAoBhB,oEAAoE;IACpE,OAAO,CAAC,WAAW;YAML,UAAU;IAwGxB,sFAAsF;YACxE,OAAO;CAyDtB"}
1
+ {"version":3,"file":"run-child.d.ts","sourceRoot":"","sources":["../src/run-child.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,5 @@
1
1
  import { type AgentRunSession } from "@sixb/core/internal/agents";
2
+ import type { SandboxNetworkPolicy } from "@sixb/core/sandboxes";
2
3
  import type { AgentRunRecord, AgentThreadRecord, ConversationAgentRunRecord, ExecutionRecord, SubagentRunRecord } from "@sixb/core/storage";
3
4
  import type { AgentRunFailure } from "./failure";
4
5
  import type { FamilyMailbox } from "./family-mailbox";
@@ -15,8 +16,11 @@ export interface ConversationTurnRunner {
15
16
  readonly execution: ExecutionRecord;
16
17
  readonly thread: AgentThreadRecord | null;
17
18
  }): OpenRunSandbox;
18
- /** Run a child the turn spawned or continues, beside the turn, on the turn's mailbox. */
19
- startChild(run: SubagentRunRecord, family: FamilyMailbox): void;
19
+ /**
20
+ * Run a child the turn spawned or continues, beside the turn, on the turn's mailbox, its
21
+ * `web_fetch` following the network the turn's sandbox declared.
22
+ */
23
+ startChild(run: SubagentRunRecord, family: FamilyMailbox, networkPolicy: SandboxNetworkPolicy | undefined): void;
20
24
  /** A sandbox teardown that outlives the turn: the runner waits for it before it stops. */
21
25
  onDetachedTeardown(teardown: Promise<void>): void;
22
26
  /** A turn that failed: the runner reports it, once its end is recorded. */
@@ -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,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,yFAAyF;IACzF,UAAU,CAAC,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAAA;IAC/D,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,CAwHhB"}
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,13 +1,14 @@
1
1
  import type { Principal } from "@sixb/core";
2
- import { type AgentContextBudget, type AgentRunSession, type AgentTurnHistory } from "@sixb/core/internal/agents";
2
+ import { type AgentContextBudget, type AgentRunModels, type AgentRunSession, type AgentTurnHistory } from "@sixb/core/internal/agents";
3
3
  import type { WorkflowIOSnapshot } from "@sixb/core/internal/workflows";
4
4
  import type { ModelTool } from "@sixb/core/models";
5
+ import type { SandboxNetworkPolicy } from "@sixb/core/sandboxes";
5
6
  import type { AgentContextCheckpointReason, AgentThreadRecord, ConversationAgentRunRecord, SubagentRunRecord, WorkflowAgentNodeRunRecord } from "@sixb/core/storage";
6
7
  import { type ConversationRequest } from "./context-compaction";
7
8
  import type { ResolvedAgentExecutionPlan } from "./execution-plan";
8
9
  import { type ConversationReaders } from "./message-authors";
9
10
  import { type AgentErrorDetails, type AgentToolCaller } from "./model-adapters";
10
- import type { BeforeFinalizeOptions, RunSandbox } from "./run-sandbox";
11
+ import { type BeforeFinalizeOptions, type RunSandbox } from "./run-sandbox";
11
12
  import { type SubagentThreadContext } from "./subagent-context";
12
13
  import type { SubagentHistory } from "./subagent-continuation";
13
14
  import { type LoadedAgentThreadModelContext } from "./thread-context";
@@ -34,6 +35,8 @@ export interface ConversationAgentExecutionEnvironment extends AgentExecutionEnv
34
35
  }) => Promise<ConversationRequest | undefined>;
35
36
  /** The bytes per token the preflight measured the history at, which the turn's calls go by. */
36
37
  readonly bytesPerToken?: number;
38
+ /** The network its sandbox declared, which `web_fetch` follows: its children's too. */
39
+ readonly networkPolicy?: SandboxNetworkPolicy;
37
40
  }
38
41
  /**
39
42
  * How a runner gives a run its environment: a cloud sandbox, or a folder on a computer. The runner
@@ -103,6 +106,11 @@ export interface CreateSubagentEnvironmentInput extends CreateAgentEnvironmentIn
103
106
  readonly budget: AgentContextBudget;
104
107
  readonly runtime: AgentTurnRuntime;
105
108
  };
109
+ /**
110
+ * The network its parent's `web_fetch` follows, which the child's follows too: a child's blank
111
+ * sandbox declares none, and would otherwise read any URL.
112
+ */
113
+ readonly parentNetworkPolicy?: SandboxNetworkPolicy;
106
114
  }
107
115
  export interface SubagentAgentExecutionEnvironment extends AgentExecutionEnvironment {
108
116
  /** The thread the child runs on: as it started, or as its compaction left it. */
@@ -126,6 +134,8 @@ export interface CreateWorkflowAgentNodeEnvironmentInput extends CreateAgentEnvi
126
134
  readonly errorDetails: AgentErrorDetails;
127
135
  /** How the step calls a project tool: it runs in the cloud, so in the worker's process. */
128
136
  readonly callTool: AgentToolCaller;
137
+ /** How the step searches the web, recorded with its other model calls. */
138
+ readonly webSearch: AgentRunModels["webSearch"];
129
139
  }
130
140
  /** Prepare conversation history and attachments, then start the shared agent environment. */
131
141
  export declare function createConversationAgentEnvironment(input: CreateConversationAgentEnvironmentInput): Promise<ConversationAgentExecutionEnvironment>;
@@ -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":"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"}
@@ -1,5 +1,8 @@
1
1
  import type { Sandbox } from "@sixb/core";
2
+ import type { SandboxNetworkPolicy } from "@sixb/core/sandboxes";
2
3
  import type { AgentWorkspacePromptContext } from "./agent-prompt";
4
+ import type { BackgroundCommands } from "./background-commands";
5
+ import type { WebFetchNetwork } from "./tools/web-fetch/network";
3
6
  /**
4
7
  * Where a provider's sandbox keeps a run's files: in its working directory, which a Git checkout
5
8
  * excludes (see `prepareWorkspaceRunFiles`).
@@ -39,6 +42,20 @@ export interface RunSandbox {
39
42
  * names it: relative to the working directory, or absolute.
40
43
  */
41
44
  readonly contextDirectory: string;
45
+ /**
46
+ * The background commands the run's tools start and see, when they outlive the run: a
47
+ * computer's thread keeps them across its turns, and its runner stops them. Absent, the run has
48
+ * its own, stopped as it ends.
49
+ */
50
+ readonly background?: BackgroundCommands;
51
+ /**
52
+ * The network policy the project declared for the sandbox, which `web_fetch` follows: only the
53
+ * origins a `restricted` one lists, and no tool for `none`. Absent, as for a blank sandbox: any
54
+ * URL.
55
+ */
56
+ readonly networkPolicy?: SandboxNetworkPolicy;
57
+ /** Where `web_fetch` reads pages from. Absent: Sixb's servers. */
58
+ readonly webNetwork?: WebFetchNetwork;
42
59
  /** Called once, when the run environment starts. */
43
60
  acquire(): Promise<AcquiredRunSandbox>;
44
61
  /**
@@ -57,4 +74,10 @@ export interface BeforeFinalizeOptions {
57
74
  */
58
75
  readonly discard?: boolean;
59
76
  }
77
+ /**
78
+ * Acquire a run's sandbox. A workspace the prompt describes comes with the instruction files it
79
+ * carries, read once here: every request of the run then renders the same prompt, and so does the
80
+ * next run while the files stay as they are.
81
+ */
82
+ export declare function acquireRunSandbox(sandbox: RunSandbox, signal?: AbortSignal): Promise<AcquiredRunSandbox>;
60
83
  //# sourceMappingURL=run-sandbox.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"run-sandbox.d.ts","sourceRoot":"","sources":["../src/run-sandbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAA;AAEjE;;;GAGG;AACH,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAA;AAEtE,gFAAgF;AAChF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,gEAAgE;IAChE,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAC/C,oEAAoE;IACpE,QAAQ,CAAC,aAAa,CAAC,EAAE,2BAA2B,CAAA;IACpD,wEAAwE;IACxE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;IACjC;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,oDAAoD;IACpD,OAAO,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAA;IACtC;;;OAGG;IACH,OAAO,CAAC,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrD,gGAAgG;IAChG,cAAc,CAAC,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAChE;AAED,qDAAqD;AACrD,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAC3B"}
1
+ {"version":3,"file":"run-sandbox.d.ts","sourceRoot":"","sources":["../src/run-sandbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAA;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAGhE;;;GAGG;AACH,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAA;AAEtE,gFAAgF;AAChF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,gEAAgE;IAChE,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAC/C,oEAAoE;IACpE,QAAQ,CAAC,aAAa,CAAC,EAAE,2BAA2B,CAAA;IACpD,wEAAwE;IACxE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;IACjC;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAA;IACxC;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,oBAAoB,CAAA;IAC7C,kEAAkE;IAClE,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAA;IACrC,oDAAoD;IACpD,OAAO,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAA;IACtC;;;OAGG;IACH,OAAO,CAAC,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrD,gGAAgG;IAChG,cAAc,CAAC,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAChE;AAED,qDAAqD;AACrD,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,UAAU,EACnB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAa7B"}
@@ -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":"AAEA,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"}
@@ -114,6 +114,8 @@ export interface WaitForSubagentsOutput {
114
114
  readonly files: readonly InstalledChildFile[];
115
115
  /** Why what the children published is not all in `$SIXB_ARTIFACTS`. */
116
116
  readonly artifactsError?: string;
117
+ /** The folders the Agent published from that took what the children wrote. */
118
+ readonly artifactsNote?: string;
117
119
  }
118
120
  /** What a turn offers the children it spawns. */
119
121
  export interface TurnDelegation {
@@ -274,7 +276,7 @@ export declare class SubagentCoordinator {
274
276
  private earlierTurnsOf;
275
277
  /**
276
278
  * 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
279
+ * the artifacts the children wrote in its `$SIXB_ARTIFACTS`, as the parent's own. A result holds at
278
280
  * most the attachment limits of new files, a child's whole or not at all; a child that does not
279
281
  * fit, or whose files cannot be copied, says so, and its files come with a later wait.
280
282
  */
@@ -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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"}
@@ -0,0 +1,50 @@
1
+ import type { ModelTool } from "@sixb/core/models";
2
+ import type { BackgroundCommands } from "../background-commands";
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.";
7
+ readonly inputSchema: {
8
+ type: string;
9
+ properties: {
10
+ id: {
11
+ type: string;
12
+ description: string;
13
+ };
14
+ wait: {
15
+ type: string;
16
+ description: string;
17
+ };
18
+ };
19
+ required: string[];
20
+ additionalProperties: false;
21
+ };
22
+ };
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.";
26
+ readonly inputSchema: {
27
+ type: string;
28
+ properties: {
29
+ id: {
30
+ type: string;
31
+ description: string;
32
+ };
33
+ };
34
+ required: string[];
35
+ additionalProperties: false;
36
+ };
37
+ };
38
+ interface BashOutputToolInput {
39
+ readonly id: string;
40
+ readonly wait?: number;
41
+ }
42
+ interface BashStopToolInput {
43
+ readonly id: string;
44
+ }
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>;
49
+ export {};
50
+ //# sourceMappingURL=background.d.ts.map
@@ -0,0 +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,9 +1,10 @@
1
- import type { CommandResult } from "@sixb/core";
1
+ import { type CommandResult } from "@sixb/core";
2
2
  import type { ModelTool } from "@sixb/core/models";
3
+ import type { BackgroundCommands } from "../background-commands";
3
4
  import type { AgentSandboxHandle } from "../sandbox-handle";
4
5
  export declare const BASH_TOOL_SPEC: {
5
6
  readonly name: "bash";
6
- readonly description: "Run a Bash command in the agent run sandbox.";
7
+ readonly description: string;
7
8
  readonly inputSchema: {
8
9
  type: string;
9
10
  properties: {
@@ -16,6 +17,11 @@ export declare const BASH_TOOL_SPEC: {
16
17
  };
17
18
  timeoutMs: {
18
19
  type: string;
20
+ description: string;
21
+ };
22
+ run_in_background: {
23
+ type: string;
24
+ description: string;
19
25
  };
20
26
  };
21
27
  required: string[];
@@ -26,6 +32,7 @@ interface BashToolInput {
26
32
  readonly command: string;
27
33
  readonly cwd?: string;
28
34
  readonly timeoutMs?: number;
35
+ readonly run_in_background?: boolean;
29
36
  }
30
37
  export interface BashToolOutput extends CommandResult {
31
38
  readonly stdoutTruncated: boolean;
@@ -38,9 +45,10 @@ export interface BashToolOutput extends CommandResult {
38
45
  * of blocking the turn. A resolver rejection surfaces as a failed command.
39
46
  *
40
47
  * Its output holds the command's streams whole: the run's tools save an output too large for the
41
- * context to a file and keep {@link keptCommandOutput} of it (see tool-outputs.ts).
48
+ * context to a file and keep {@link keptCommandOutput} of it (see tool-outputs.ts). A command run
49
+ * in the background returns its {@link BackgroundCommandState} instead.
42
50
  */
43
- export declare function createBashTool(resolveSandbox: () => Promise<AgentSandboxHandle>): ModelTool<BashToolInput>;
51
+ export declare function createBashTool(resolveSandbox: () => Promise<AgentSandboxHandle>, background: BackgroundCommands): ModelTool<BashToolInput>;
44
52
  /**
45
53
  * What a command's message part keeps of an output saved to a file: each stream within
46
54
  * 20,000 characters, as the app, the TUI and `sixb history` show it.
@@ -1 +1 @@
1
- {"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../src/tools/bash.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC/C,OAAO,KAAK,EAAyB,SAAS,EAAE,MAAM,mBAAmB,CAAA;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAM3D,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;CAiBjB,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;CAC5B;AAED,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;IACjC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAClC;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,cAAc,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,GAChD,SAAS,CAAC,aAAa,CAAC,CAqB1B;AAmCD;;;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;;;;;;;;;;;;;;;;;;;;;;;;;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,9 +1,16 @@
1
- import type { AgentToolSpec } from "@sixb/core/internal/agents";
1
+ import type { AgentRunWebPlan, AgentToolSpec } from "@sixb/core/internal/agents";
2
+ import type { SandboxNetworkPolicy } from "@sixb/core/sandboxes";
2
3
  /**
3
4
  * Describe exactly the tools a conversational model receives, in its order, without starting its
4
- * sandbox. A conversation publishes artifacts once its run executes in a thread.
5
+ * sandbox. A conversation publishes artifacts once its run executes in a thread; it searches the
6
+ * web when its plan names a search model, and fetches pages when its plan has web tools at all,
7
+ * unless its sandbox's network is `none`.
5
8
  */
6
9
  export declare function agentModelToolSpecs(projectTools: readonly AgentToolSpec[], options?: {
7
10
  readonly publishes?: boolean;
11
+ readonly web?: AgentRunWebPlan;
12
+ readonly networkPolicy?: SandboxNetworkPolicy;
8
13
  }): readonly AgentToolSpec[];
14
+ /** Whether a run has `web_fetch`: web tools are on, and its sandbox may reach the network. */
15
+ export declare function fetchesWeb(web: AgentRunWebPlan | undefined, networkPolicy: SandboxNetworkPolicy | undefined): boolean;
9
16
  //# sourceMappingURL=model-spec.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"model-spec.d.ts","sourceRoot":"","sources":["../../src/tools/model-spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAS/D;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,SAAS,aAAa,EAAE,EACtC,OAAO,GAAE;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GAC7C,SAAS,aAAa,EAAE,CAU1B"}
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;AAahE;;;;;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 +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,5 +1,5 @@
1
- import { type AgentRunFileStore, type AgentToolCallFile } from "@sixb/core/internal/agents";
2
- import { type ModelTool } from "@sixb/core/models";
1
+ import { type AgentRunFileStore, type AgentToolCallFile, type AgentToolOutputExtension } from "@sixb/core/internal/agents";
2
+ import { type ModelTool, type ModelToolExecutionContext } from "@sixb/core/models";
3
3
  import type { AgentMessageRecord } from "@sixb/core/storage";
4
4
  import { type AgentSandboxHandle } from "../sandbox-handle";
5
5
  import { AgentFileBudget } from "./tool-files";
@@ -37,7 +37,17 @@ export declare class ToolOutputFiles {
37
37
  /** The stored file of a call whose output was saved, for its message part. */
38
38
  fileOf(toolCallId: string): AgentToolCallFile | undefined;
39
39
  private saving;
40
+ /**
41
+ * Save a call's output that its tool shows the model itself, such as a fetched page: stored and
42
+ * written back as an output saved here is, under the same budget, and its call's
43
+ * {@link fileOf}. Returns the path the agent reads it at.
44
+ */
45
+ store(toolName: string, bytes: Uint8Array, type: {
46
+ readonly extension: AgentToolOutputExtension;
47
+ readonly mediaType: string;
48
+ }, context: ModelToolExecutionContext): Promise<string>;
40
49
  private save;
50
+ private write;
41
51
  }
42
52
  /**
43
53
  * The outputs a history saved, to write back: the newest within
@@ -1 +1 @@
1
- {"version":3,"file":"tool-outputs.d.ts","sourceRoot":"","sources":["../../src/tools/tool-outputs.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EAIvB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAGL,KAAK,SAAS,EAGf,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAE5D,OAAO,EAAE,KAAK,kBAAkB,EAAe,MAAM,mBAAmB,CAAA;AAGxE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAG9C;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,QAAY,CAAA;AAEnD,kFAAkF;AAClF,eAAO,MAAM,sBAAsB,iBAA+B,CAAA;AASlE;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,QAAmB,CAAA;AA4BtD;;;;;;GAMG;AACH,qBAAa,eAAe;;IAKxB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE;QACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAA;QACnD,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAA;QACpD,8FAA8F;QAC9F,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAA;KAClC;IAKH,IAAI,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,EAAE;IAI9C,8EAA8E;IAC9E,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIzD,OAAO,CAAC,MAAM;YA2CA,IAAI;CAkCnB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,GAAG,iBAAiB,EAAE,CAejG;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAA;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAA;IAC5C,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAA;IACrD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAC7B,GAAG,OAAO,CAAC,IAAI,CAAC,CAiChB;AAoCD,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEpE"}
1
+ {"version":3,"file":"tool-outputs.d.ts","sourceRoot":"","sources":["../../src/tools/tool-outputs.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAI9B,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,yBAAyB,EAE/B,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAE5D,OAAO,EAAE,KAAK,kBAAkB,EAAe,MAAM,mBAAmB,CAAA;AAGxE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAI9C;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,QAAY,CAAA;AAEnD,kFAAkF;AAClF,eAAO,MAAM,sBAAsB,iBAA+B,CAAA;AASlE;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,QAAmB,CAAA;AAmCtD;;;;;;GAMG;AACH,qBAAa,eAAe;;IAKxB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE;QACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAA;QACnD,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAA;QACpD,8FAA8F;QAC9F,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAA;KAClC;IAKH,IAAI,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,EAAE;IAI9C,8EAA8E;IAC9E,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIzD,OAAO,CAAC,MAAM;IA2Cd;;;;OAIG;IACG,KAAK,CACT,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,wBAAwB,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAClF,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,MAAM,CAAC;YAMJ,IAAI;YAeJ,KAAK;CAkCpB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,GAAG,iBAAiB,EAAE,CAejG;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAA;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAA;IAC5C,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAA;IACrD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAC7B,GAAG,OAAO,CAAC,IAAI,CAAC,CAiChB;AAoCD,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEpE"}
@@ -0,0 +1,33 @@
1
+ /** A page as `web_fetch` read it: what it saves, never what a question made of it. */
2
+ export interface CachedWebPage {
3
+ /** The final URL, after the same-host redirects that were followed. */
4
+ readonly url: string;
5
+ readonly title: string;
6
+ readonly status: number;
7
+ /** The media type the server sent, lowercased, or empty when it sent none. */
8
+ readonly contentType: string;
9
+ /** The page as it is saved: markdown or text, or a PDF or image as it came. */
10
+ readonly body: Uint8Array;
11
+ readonly kind: WebPageKind;
12
+ /** How many bytes the server sent, up to the fetch cap. */
13
+ readonly size: number;
14
+ /** The body stopped at the fetch cap, or an HTML page was converted only up to its own. */
15
+ readonly truncated: boolean;
16
+ }
17
+ /** What a saved page is, by its file's extension and media type. */
18
+ export interface WebPageKind {
19
+ readonly extension: "md" | "txt" | "pdf" | "png" | "jpg" | "gif" | "webp";
20
+ readonly mediaType: string;
21
+ }
22
+ /**
23
+ * The pages a runner process fetched in the last 15 minutes, by URL, up to 64 MB: a run that
24
+ * reads a page again, or another run that reads it, does not fetch it again. Least recently used
25
+ * pages go first.
26
+ */
27
+ export declare class WebFetchCache {
28
+ #private;
29
+ get(url: URL): CachedWebPage | undefined;
30
+ set(url: URL, page: CachedWebPage): void;
31
+ private delete;
32
+ }
33
+ //# sourceMappingURL=cache.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/tools/web-fetch/cache.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,2FAA2F;IAC3F,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AAED,oEAAoE;AACpE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,SAAS,EAAE,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAA;IACzE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAcD;;;;GAIG;AACH,qBAAa,aAAa;;IAIxB,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,aAAa,GAAG,SAAS;IAgBxC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI;IAgBxC,OAAO,CAAC,MAAM;CAOf"}
@@ -0,0 +1,25 @@
1
+ /** A fetched HTML page, as the network returned it. */
2
+ export interface HtmlPage {
3
+ readonly bytes: Uint8Array;
4
+ /** The response's `content-type` header, which may carry the charset. Empty when absent. */
5
+ readonly contentType: string;
6
+ /** The URL the page was finally read from, after redirects: relative links resolve against it. */
7
+ readonly url: string | URL;
8
+ }
9
+ /** The page's readable text. */
10
+ export interface HtmlMarkdown {
11
+ /** `og:title`, else `<title>`; empty when the page names itself nowhere. */
12
+ readonly title: string;
13
+ readonly markdown: string;
14
+ /** The page was cut where it nested too deep or held too many elements: the rest is missing. */
15
+ readonly truncated?: true;
16
+ }
17
+ /**
18
+ * Convert a fetched HTML page to markdown, keeping its content and dropping its chrome.
19
+ *
20
+ * `parse5` builds the tree the way a browser would, whatever the markup; the page is then pruned
21
+ * (scripts, navigation, hidden elements), narrowed to its single `main` or `article` when it has
22
+ * one, and written as GFM markdown. Links and images are absolute.
23
+ */
24
+ export declare function htmlToMarkdown(page: HtmlPage): HtmlMarkdown;
25
+ //# sourceMappingURL=html-markdown.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"html-markdown.d.ts","sourceRoot":"","sources":["../../../src/tools/web-fetch/html-markdown.ts"],"names":[],"mappings":"AAQA,uDAAuD;AACvD,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,4FAA4F;IAC5F,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,kGAAkG;IAClG,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAC3B;AAED,gCAAgC;AAChC,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,gGAAgG;IAChG,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAA;CAC1B;AAuDD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAY3D"}
@@ -0,0 +1,55 @@
1
+ import { AgentToolPublicError } from "@sixb/core";
2
+ /**
3
+ * Where a fetch leaves from: Sixb's servers, or the user's computer through the `sixb` CLI. Both
4
+ * reach only public addresses; a computer may also read its own loopback, so a developer can point
5
+ * the agent at their dev server.
6
+ */
7
+ export type WebFetchNetwork = "server" | "computer";
8
+ export interface GuardedFetchInput {
9
+ readonly network: WebFetchNetwork;
10
+ readonly signal: AbortSignal;
11
+ /** The body is read up to this many bytes, then cut (`truncated`). */
12
+ readonly maxBytes: number;
13
+ /** For the whole fetch: every redirect hop and the body. */
14
+ readonly timeoutMs: number;
15
+ /** Throws to refuse a URL before it is requested: the first, and each redirect followed. */
16
+ readonly admit?: (url: URL) => void;
17
+ }
18
+ export interface GuardedPage {
19
+ /** The final URL, after the same-host redirects that were followed. */
20
+ readonly url: string;
21
+ readonly status: number;
22
+ /** The media type, lowercased and without parameters. */
23
+ readonly contentType?: string;
24
+ readonly charset?: string;
25
+ readonly body: Uint8Array;
26
+ readonly truncated: boolean;
27
+ }
28
+ /** A redirect to another host. It is not followed: the agent decides whether to fetch it. */
29
+ export interface GuardedRedirect {
30
+ /** The URL that answered with the redirect. */
31
+ readonly url: string;
32
+ readonly redirect: {
33
+ readonly url: string;
34
+ readonly status: number;
35
+ };
36
+ }
37
+ export type GuardedResponse = GuardedPage | GuardedRedirect;
38
+ export type WebFetchErrorCode = "unsupported-url" | "blocked" | "unresolved" | "unreachable" | "too-many-redirects" | "timeout";
39
+ /** Why a page could not be fetched, worded for the model. */
40
+ export declare class WebFetchError extends AgentToolPublicError {
41
+ readonly code: WebFetchErrorCode;
42
+ readonly name = "WebFetchError";
43
+ constructor(code: WebFetchErrorCode, message: string, options?: ErrorOptions);
44
+ }
45
+ /**
46
+ * Fetch a page for the agent without letting it reach anything but the public web.
47
+ *
48
+ * Every address DNS returns for the host must be public, and the connection goes to the one that
49
+ * was checked: the URL carries the address, `Host` and the TLS server name carry the host, so DNS
50
+ * is never asked again and cannot answer differently in between. Same-host redirects are followed,
51
+ * each hop resolved and checked again; a redirect to another host is returned, unless its target
52
+ * is refused before DNS is even asked.
53
+ */
54
+ export declare function guardedFetch(url: URL, input: GuardedFetchInput): Promise<GuardedResponse>;
55
+ //# sourceMappingURL=network.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../../src/tools/web-fetch/network.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAGjD;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,UAAU,CAAA;AAEnD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,4FAA4F;IAC5F,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAA;CACpC;AAED,MAAM,WAAW,WAAW;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,yDAAyD;IACzD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AAED,6FAA6F;AAC7F,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CACrE;AAED,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,eAAe,CAAA;AAE3D,MAAM,MAAM,iBAAiB,GACzB,iBAAiB,GACjB,SAAS,GACT,YAAY,GACZ,aAAa,GACb,oBAAoB,GACpB,SAAS,CAAA;AAEb,6DAA6D;AAC7D,qBAAa,aAAc,SAAQ,oBAAoB;IAInD,QAAQ,CAAC,IAAI,EAAE,iBAAiB;IAHlC,SAAkB,IAAI,mBAAkB;gBAG7B,IAAI,EAAE,iBAAiB,EAChC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY;CAIzB;AAgDD;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CAuD/F"}