@deepagents/context 1.0.0 → 2.1.0

package/dist/lib/sandbox/types.d.ts

@@ -1,7 +1,50 @@
 import type { Tool } from 'ai';
-import type { BashToolkit, CommandResult } from 'bash-tool';
+import type { BashToolkit, CommandResult, Sandbox as UpstreamSandbox } from 'bash-tool';
 import type { SkillPathMapping } from '../skills/types.ts';
 import type { FileEvent } from './file-events.ts';
+/**
+ * Options accepted by `DisposableSandbox.executeCommand`. Currently only
+ * `signal` (cooperative cancellation); shaped as an object so we can add
+ * more without breaking backends.
+ */
+export interface ExecuteCommandOptions {
+    signal?: AbortSignal;
+}
+export interface SpawnOptions {
+    signal?: AbortSignal;
+    env?: Record<string, string>;
+    cwd?: string;
+}
+export interface ExitInfo {
+    code: number | null;
+    signal: NodeJS.Signals | null;
+    /** Convenience for `code === 0`. */
+    success: boolean;
+}
+export interface SandboxProcess {
+    readonly stdout: ReadableStream<Uint8Array>;
+    readonly stderr: ReadableStream<Uint8Array>;
+    readonly exit: Promise<ExitInfo>;
+}
+/**
+ * Sandbox contract used throughout this package: upstream's three-method
+ * shape plus a lifecycle hook, with `executeCommand` widened to accept
+ * optional cancellation. Every backend (virtual, docker, agent-os)
+ * implements this so callers can dispose uniformly. Backends that honor
+ * `options.signal` forward it to their runner; others ignore. Pure
+ * backends with no external resources (e.g. virtual-sandbox) supply a
+ * no-op `dispose()`.
+ *
+ * `spawn` is optional: only backends that can honestly expose unbuffered
+ * stdio (e.g. docker-sandbox) implement it. Callers feature-detect with
+ * `if (!sandbox.spawn) ...` — no silent fallback that aggregates output
+ * and flushes on completion.
+ */
+export interface DisposableSandbox extends Omit<UpstreamSandbox, 'executeCommand'> {
+    executeCommand(command: string, options?: ExecuteCommandOptions): Promise<CommandResult>;
+    spawn?(command: string, options?: SpawnOptions): SandboxProcess;
+    dispose(): Promise<void>;
+}
 /**
  * Declarative skill upload: a host directory whose contents are copied into
  * the sandbox at startup. The factory also parses each skill's frontmatter
@@ -29,18 +72,20 @@ export type WrappedBashTool = Tool<BashToolInput, CommandResult>;
  * the `skills()` fragment. The `bash` tool is widened to require a
  * `reasoning` input on every call.
  */
-export interface AgentSandbox extends Omit<BashToolkit, 'bash' | 'tools'> {
+export interface AgentSandbox extends Omit<BashToolkit, 'bash' | 'tools' | 'sandbox'> {
     /** Discovered skills — empty array if none were configured. */
     skills: SkillPathMapping[];
     bash: WrappedBashTool;
     tools: Omit<BashToolkit['tools'], 'bash'> & {
         bash: WrappedBashTool;
     };
+    sandbox: DisposableSandbox;
     /**
-     * Drain and return file events observed since the last call. Attached by
-     * callers who composed an `ObservedFs` into their backend; omitted
-     * otherwise. The chat pipeline reads this via optional chaining.
+     * Drain and return file events observed since the last `drain()`. The
+     * observation root is the `destination` passed to `createBashTool`; every
+     * `executeCommand` / `writeFiles` call is bracketed by a snapshot, and
+     * `readFile` records a `read` event.
      */
-    drainFileEvents?(): FileEvent[];
+    drainFileEvents(): FileEvent[];
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/lib/sandbox/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/sandbox/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,mEAAmE;AACnE,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IACvE,+DAA+D;IAC/D,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,GAAG;QAAE,IAAI,EAAE,eAAe,CAAA;KAAE,CAAC;IACtE;;;;OAIG;IACH,eAAe,CAAC,IAAI,SAAS,EAAE,CAAC;CACjC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/sandbox/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,OAAO,IAAI,eAAe,EAC3B,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAC9B,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IAC5C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAC7C,eAAe,EACf,gBAAgB,CACjB;IACC,cAAc,CACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1B,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,cAAc,CAAC;IAChE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,mEAAmE;AACnE,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,WAAW,YAAa,SAAQ,IAAI,CACxC,WAAW,EACX,MAAM,GAAG,OAAO,GAAG,SAAS,CAC7B;IACC,+DAA+D;IAC/D,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,GAAG;QAAE,IAAI,EAAE,eAAe,CAAA;KAAE,CAAC;IACtE,OAAO,EAAE,iBAAiB,CAAC;IAC3B;;;;;OAKG;IACH,eAAe,IAAI,SAAS,EAAE,CAAC;CAChC"}

package/dist/lib/sandbox/virtual-sandbox.d.ts

@@ -1,10 +1,10 @@
-import type { Sandbox } from 'bash-tool';
 import { type CustomCommand, type IFileSystem } from 'just-bash';
+import type { DisposableSandbox } from './types.ts';
 export interface CreateVirtualSandboxOptions {
     fs: IFileSystem;
     cwd?: string;
     env?: Record<string, string>;
     customCommands?: CustomCommand[];
 }
-export declare function createVirtualSandbox(options: CreateVirtualSandboxOptions): Promise<Sandbox>;
+export declare function createVirtualSandbox(options: CreateVirtualSandboxOptions): Promise<DisposableSandbox>;
 //# sourceMappingURL=virtual-sandbox.d.ts.map

package/dist/lib/sandbox/virtual-sandbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"virtual-sandbox.d.ts","sourceRoot":"","sources":["../../../src/lib/sandbox/virtual-sandbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAQ,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAEvE,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,WAAW,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;CAClC;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,OAAO,CAAC,CAiClB"}
+{"version":3,"file":"virtual-sandbox.d.ts","sourceRoot":"","sources":["../../../src/lib/sandbox/virtual-sandbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAEvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,WAAW,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;CAClC;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,iBAAiB,CAAC,CAsC5B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepagents/context",
-  "version": "1.0.0",
+  "version": "2.1.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -43,28 +43,20 @@
   },
   "dependencies": {
     "@ai-sdk/groq": "^3.0.36",
-    "@ai-sdk/openai": "^3.0.54",
-    "@ai-sdk/openai-compatible": "^2.0.42",
     "@ai-sdk/provider": "^3.0.10",
-    "@clack/prompts": "^1.3.0",
-    "@deepagents/agent": "1.0.0",
-    "@sdk-it/rpc": "^0.40.0",
-    "@sdk-it/spec": "^0.40.0",
+    "@deepagents/agent": "2.1.0",
     "ai": "^6.0.174",
     "bash-tool": "^1.3.16",
     "chalk": "^5.6.0",
     "dedent": "^1.7.0",
     "gpt-tokenizer": "^3.4.0",
-    "just-bash": "^2.14.2",
-    "lodash-es": "^4.17.21",
+    "just-bash": "^3.0.0",
     "nano-spawn": "^2.0.0",
-    "openai": "^6.25.0",
     "pluralize": "^8.0.0",
     "stringcase": "^4.3.1",
     "tiny-tfidf": "^1.0.0",
     "yaml": "^2.8.0",
-    "zod": "^3.25.76 || ^4.0.0",
-    "zod-to-json-schema": "^3.25.1"
+    "zod": "^3.25.76 || ^4.0.0"
   },
   "devDependencies": {
     "@types/debug": "^4.1.12",

package/dist/lib/sandboxes/openai.d.ts

@@ -1,6 +0,0 @@
-export declare class OpenAISandbox {
-    #private;
-    uploadSkill(): void;
-    listSkills(): void;
-}
-//# sourceMappingURL=openai.d.ts.map

package/dist/lib/sandboxes/openai.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/lib/sandboxes/openai.ts"],"names":[],"mappings":"AAEA,qBAAa,aAAa;;IAExB,WAAW;IAGX,UAAU;CAGX"}