@tangle-network/agent-app 3.0.34 → 3.0.35

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.
@@ -31,7 +31,7 @@ import {
31
31
  sandboxRunFailureDetail,
32
32
  streamSandboxPrompt,
33
33
  turnStorageBindings
34
- } from "./chunk-3FKIGI3I.js";
34
+ } from "./chunk-5DG2LO3T.js";
35
35
  import {
36
36
  redactErrorMessage
37
37
  } from "./chunk-MH74DY2I.js";
@@ -4227,4 +4227,4 @@ export {
4227
4227
  createChatTurnRoutes,
4228
4228
  streamChatRouteAsSandboxEvents
4229
4229
  };
4230
- //# sourceMappingURL=chunk-KNVFMTC2.js.map
4230
+ //# sourceMappingURL=chunk-VG27P322.js.map
@@ -1,14 +1,14 @@
1
1
  import {
2
2
  createChatTurnRoutes,
3
3
  streamChatRouteAsSandboxEvents
4
- } from "../chunk-KNVFMTC2.js";
4
+ } from "../chunk-VG27P322.js";
5
5
  import "../chunk-SBHFMDR7.js";
6
6
  import "../chunk-H6BRJU5M.js";
7
7
  import "../chunk-4DBHC63F.js";
8
8
  import "../chunk-RN4WPTBH.js";
9
9
  import "../chunk-MM6RLOXF.js";
10
10
  import "../chunk-M4QITAQV.js";
11
- import "../chunk-3FKIGI3I.js";
11
+ import "../chunk-5DG2LO3T.js";
12
12
  import "../chunk-F4TUZYMX.js";
13
13
  import "../chunk-MH74DY2I.js";
14
14
  import "../chunk-5DAEU3CP.js";
@@ -67,7 +67,8 @@ export interface LivenessProbeConfig {
67
67
  * every reuse.
68
68
  *
69
69
  * Only the exec probe is cached. Runtime readiness, deferred-file
70
- * materialization, and bootstrap still run on every reuse, and the egress
70
+ * materialization, and bootstrap (unless {@link SandboxRuntimeConfig.bootstrapDigest}
71
+ * names a build this box already ran it under) still run on every reuse, and the egress
71
72
  * policy and runtime environment are checked as {@link SandboxRuntimeConfig.egressPolicy}
72
73
  * and {@link SandboxRuntimeConfig.runtimeEnv} describe. A box that dies during
73
74
  * this window is surfaced by the first call on it: a caller whose first call
@@ -164,6 +165,18 @@ export interface SandboxRuntimeConfig {
164
165
  boxKey?: (scope: SandboxScope) => string;
165
166
  childKeyMint?: (scope: SandboxScope) => Promise<Outcome<string>>;
166
167
  bootstrap?: (box: SandboxInstance, scope: SandboxScope) => Promise<Outcome<void>>;
168
+ /**
169
+ * The served build this bootstrap belongs to, such as the deploy sha. A box
170
+ * that ran {@link bootstrap} under the same build, harness, egress policy and
171
+ * scope keeps a marker file for it, and a reuse that finds a marker younger
172
+ * than 24 hours skips the bootstrap; a new release runs it once more on every
173
+ * box. If something deletes what the bootstrap wrote, the box is repaired at
174
+ * the next release or within a day, not on the next start, so a bootstrap that
175
+ * must repair on every start declares no build, and neither does a per-turn
176
+ * lifecycle. Declare the build id, never a hash of the bootstrap's own files.
177
+ * Without it, the bootstrap runs on every reuse.
178
+ */
179
+ bootstrapDigest?: (scope: SandboxScope) => string | Promise<string>;
167
180
  livenessProbe?: LivenessProbeConfig;
168
181
  webTerminalEnabled?: boolean;
169
182
  resumeStopped?: boolean;
@@ -40,4 +40,11 @@ type ReuseMeasure = <T>(stage: string, operation: () => Promise<T>) => Promise<T
40
40
  */
41
41
  export declare function prefetchExistingBoxReads(shell: SandboxRuntimeConfig, box: SandboxInstance, runtimeEnv: Promise<Record<string, string>>, measure: ReuseMeasure): ExistingBoxPrefetch;
42
42
  export declare function finalizeExistingBox(shell: SandboxRuntimeConfig, client: Sandbox, box: SandboxInstance, stage: SandboxExistingBoxStage, name: string, workspaceId: string, userId: string | undefined, harness: Harness, scope: SandboxScope, runtimeEnv: Record<string, string>, prefetch?: Omit<ExistingBoxPrefetch, 'decided'>): Promise<SandboxInstance>;
43
+ /**
44
+ * Run the product bootstrap unless this box ran it under the same key within a day: the build the product declares
45
+ * ({@link SandboxRuntimeConfig.bootstrapDigest}), the harness, the egress policy and the scope. Reading the marker is
46
+ * one exec; the bootstrap it stands for is several. A fresh box has none to read. The marker is written only after the
47
+ * bootstrap succeeds, and a failed write costs the next reuse a bootstrap. With no declared build, every call runs it.
48
+ */
49
+ export declare function bootstrapBox(shell: SandboxRuntimeConfig, box: SandboxInstance, scope: SandboxScope, harness: Harness, stage: string, name: string, fresh: boolean): Promise<void>;
43
50
  export {};
@@ -112,7 +112,7 @@ import {
112
112
  warmKey,
113
113
  warmReceiptId,
114
114
  warmWeekdayOf
115
- } from "../chunk-3FKIGI3I.js";
115
+ } from "../chunk-5DG2LO3T.js";
116
116
  import {
117
117
  createWarmCache
118
118
  } from "../chunk-F4TUZYMX.js";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tangle-network/agent-app",
3
- "version": "3.0.34",
3
+ "version": "3.0.35",
4
4
  "packageManager": "pnpm@11.28.8",
5
5
  "description": "Build agent applications with typed chat, tools, sandboxes, integrations, billing, and evaluation.",
6
6
  "keywords": [