@deepagents/context 2.4.0 → 3.0.0

package/README.md

@@ -35,6 +35,11 @@ See the docs for the full API surface:
 
 - [Sandbox](https://januarylabs.github.io/deepagents/docs/context/sandbox)
 - [Subcommand Builders](https://januarylabs.github.io/deepagents/docs/context/subcommand)
+- [GCS Cloud Storage Volumes](https://januarylabs.github.io/deepagents/docs/context/recipes/gcs-cloud-storage)
+
+For same-host Linux Docker daemons, `gcs({ hostPath, mountPath })` provides a
+typed bind-volume helper over a host `gcsfuse` mount. For remote daemons, keep
+cloud wiring in the daemon/plugin layer and attach the resulting named volume.
 
 ## Basic Usage
 

package/dist/index.js

@@ -6595,11 +6595,9 @@ function resolveRealCwd(ctx) {
 // packages/context/src/lib/sandbox/daytona-sandbox.ts
 import "bash-tool";
 import { randomUUID } from "node:crypto";
-import { createRequire } from "node:module";
 var DAYTONA_DEFAULT_DESTINATION = "/home/daytona";
 var DAYTONA_EXIT_POLL_INTERVAL_MS = 250;
 var DAYTONA_EXIT_POLL_TIMEOUT_MS = 3e4;
-var requireOptional = createRequire(import.meta.url);
 var DaytonaSandboxError = class extends Error {
   constructor(message2, cause) {
     super(message2);
@@ -6630,28 +6628,28 @@ var DaytonaCommandError = class extends DaytonaSandboxError {
 };
 async function createDaytonaSandbox(options = {}) {
   validateDaytonaOptions(options);
-  const { Daytona } = await importDaytonaSdk();
+  const sdk = await importDaytonaSdk();
   let client;
   try {
-    client = new Daytona(createDaytonaConfig(options));
+    client = new sdk.Daytona(createDaytonaConfig(options));
   } catch (error) {
-    const err = toError(error);
-    throw new DaytonaCreationError(err.message, err);
+    throw normalizeDaytonaError(error, sdk);
   }
   const attached = options.sandboxId !== void 0;
-  const deleteOnDispose = options.deleteOnDispose ?? !attached;
+  const reuseByName = !attached && options.name !== void 0;
+  const deleteOnDispose = options.deleteOnDispose ?? (!attached && !reuseByName);
   let sandbox;
   try {
-    sandbox = attached ? await client.get(options.sandboxId) : await client.create(createDaytonaParams(options), {
-      timeout: options.createTimeout,
-      onSnapshotCreateLogs: options.onSnapshotCreateLogs
-    });
-    if (attached && sandbox.state && sandbox.state !== "started") {
-      await sandbox.start?.(options.startTimeout ?? options.createTimeout);
+    if (reuseByName) {
+      sandbox = await acquireReusedSandbox(client, options, sdk);
+    } else if (attached) {
+      sandbox = await client.get(options.sandboxId);
+      await startIfStopped(sandbox, options);
+    } else {
+      sandbox = await createSandbox(client, options);
     }
   } catch (error) {
-    const err = toError(error);
-    throw new DaytonaCreationError(err.message, err);
+    throw normalizeDaytonaError(error, sdk);
   }
   return createDaytonaSandboxMethods({
     client,
@@ -6661,15 +6659,39 @@ async function createDaytonaSandbox(options = {}) {
     deleteTimeout: options.deleteTimeout
   });
 }
+async function acquireReusedSandbox(client, options, sdk) {
+  try {
+    const sandbox = await client.get(options.name);
+    await startIfStopped(sandbox, options);
+    return sandbox;
+  } catch (error) {
+    if (!(error instanceof sdk.DaytonaNotFoundError)) {
+      throw error;
+    }
+    return createSandbox(client, options);
+  }
+}
+async function startIfStopped(sandbox, options) {
+  if (sandbox.state && sandbox.state !== "started") {
+    await sandbox.start?.(options.startTimeout ?? options.createTimeout);
+  }
+}
+function normalizeDaytonaError(error, sdk) {
+  const err = toError(error);
+  if (err instanceof sdk.DaytonaError) {
+    return err;
+  }
+  return new DaytonaCreationError(err.message, err);
+}
 async function importDaytonaSdk() {
   try {
-    const mod = requireOptional("@daytona/sdk");
+    const mod = await import("@daytona/sdk");
     if (typeof mod.Daytona !== "function") {
       throw new DaytonaSandboxError(
         "@daytona/sdk did not export a Daytona constructor"
       );
     }
-    return { Daytona: mod.Daytona };
+    return mod;
   } catch (error) {
     if (error instanceof DaytonaSandboxError) {
       throw error;
@@ -6692,7 +6714,7 @@ function createDaytonaConfig(options) {
     _experimental: options.experimental
   });
 }
-function createDaytonaParams(options) {
+function createSandbox(client, options) {
   const base = compactObject({
     name: options.name,
     user: options.user,
@@ -6708,18 +6730,24 @@ function createDaytonaParams(options) {
     networkAllowList: options.networkAllowList,
     ephemeral: options.ephemeral
   });
-  if (options.image) {
-    return compactObject({
+  if (options.image !== void 0) {
+    const params2 = compactObject({
       ...base,
       image: options.image,
       resources: options.resources
     });
+    return client.create(params2, {
+      timeout: options.createTimeout,
+      onSnapshotCreateLogs: options.onSnapshotCreateLogs
+    });
   }
   const params = compactObject({
     ...base,
     snapshot: options.snapshot
   });
-  return Object.keys(params).length > 0 ? params : void 0;
+  return client.create(Object.keys(params).length > 0 ? params : void 0, {
+    timeout: options.createTimeout
+  });
 }
 function validateDaytonaOptions(options) {
   if (options.image && options.snapshot) {
@@ -8517,7 +8545,7 @@ function soul() {
 }
 
 // packages/context/src/lib/store/postgres.store.ts
-import { createRequire as createRequire2 } from "node:module";
+import { createRequire } from "node:module";
 
 // packages/context/src/lib/store/ddl.postgres.ts
 function storeDDL(schema) {
@@ -8629,7 +8657,7 @@ var PostgresContextStore = class _PostgresContextStore extends ContextStore {
   }
   static #requirePg() {
     try {
-      const require2 = createRequire2(import.meta.url);
+      const require2 = createRequire(import.meta.url);
       return require2("pg");
     } catch {
       throw new Error(
@@ -9225,7 +9253,7 @@ var PostgresContextStore = class _PostgresContextStore extends ContextStore {
 };
 
 // packages/context/src/lib/store/sqlserver.store.ts
-import { createRequire as createRequire3 } from "node:module";
+import { createRequire as createRequire2 } from "node:module";
 
 // packages/context/src/lib/store/ddl.sqlserver.ts
 function storeDDL2(schema) {
@@ -9367,7 +9395,7 @@ var SqlServerContextStore = class _SqlServerContextStore extends ContextStore {
   }
   static #requireMssql() {
     try {
-      const require2 = createRequire3(import.meta.url);
+      const require2 = createRequire2(import.meta.url);
       return require2("mssql");
     } catch {
       throw new Error(
@@ -10357,7 +10385,7 @@ function asStaticWordPartText(parts, options = {}) {
 }
 
 // packages/context/src/lib/stream/postgres-notify-change-source.ts
-import { createRequire as createRequire4 } from "node:module";
+import { createRequire as createRequire3 } from "node:module";
 
 // packages/context/src/lib/stream/ddl.stream.postgres-notify.ts
 var DEFAULT_POSTGRES_STREAM_CHANGES_CHANNEL = "deepagents_stream_changes";
@@ -10459,7 +10487,7 @@ var PostgresNotifyChangeSource = class _PostgresNotifyChangeSource {
   }
   static #requirePg() {
     try {
-      const require2 = createRequire4(import.meta.url);
+      const require2 = createRequire3(import.meta.url);
       return require2("pg");
     } catch {
       throw new Error(
@@ -10714,7 +10742,7 @@ function assertIdentifier(value, label) {
 }
 
 // packages/context/src/lib/stream/postgres.stream-store.ts
-import { createRequire as createRequire5 } from "node:module";
+import { createRequire as createRequire4 } from "node:module";
 
 // packages/context/src/lib/stream/ddl.stream.postgres.ts
 function postgresStreamDDL(schema) {
@@ -10788,7 +10816,7 @@ var PostgresStreamStore = class _PostgresStreamStore extends StreamStore {
   }
   static #requirePg() {
     try {
-      const require2 = createRequire5(import.meta.url);
+      const require2 = createRequire4(import.meta.url);
       return require2("pg");
     } catch {
       throw new Error(