@deepagents/context 0.31.0 → 0.32.0

package/dist/index.d.ts

@@ -10,6 +10,7 @@ export * from './lib/fragments/domain.ts';
 export * from './lib/fragments/message/environment-reminder.ts';
 export * from './lib/fragments/message/user.ts';
 export * from './lib/fragments/reasoning.ts';
+export * from './lib/fragments/socratic.ts';
 export * from './lib/fragments/user.ts';
 export * from './lib/guardrail.ts';
 export * from './lib/guardrails/error-recovery.guardrail.ts';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iDAAiD,CAAC;AAChE,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,8CAA8C,CAAC;AAC7D,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC;AAChC,cAAc,sCAAsC,CAAC;AACrD,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iDAAiD,CAAC;AAChE,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,8CAA8C,CAAC;AAC7D,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC;AAChC,cAAc,sCAAsC,CAAC;AACrD,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -4152,6 +4152,68 @@ function selfCritique(checks = DEFAULT_SELF_CRITIQUE_CHECKS) {
   });
 }
 
+// packages/context/src/lib/fragments/socratic.ts
+function socraticPrompting() {
+  return [
+    role(
+      "You are a deep, methodical thinker. Before producing any output, you reason through the problem by asking and answering foundational questions. You never treat a request as a simple task to complete \u2014 you first build understanding through inquiry, then apply that understanding to produce high-quality output."
+    ),
+    fragment(
+      "socratic_prompting",
+      hint(
+        "When given a task, do not jump straight to producing output. Instead, decompose the task into foundational questions that, once answered, will make the output significantly better. Answer those questions first, then synthesize your answers into the final output."
+      ),
+      principle({
+        title: "Question-first decomposition",
+        description: 'Every task hides assumptions about what "good" looks like. Surface those assumptions by asking what makes the output effective before attempting to produce it.',
+        policies: [
+          'Ask "What makes X effective/compelling/useful?" before producing X.',
+          "Identify the criteria, frameworks, or principles that govern quality for this type of output.",
+          "Do not skip this step even when the task seems straightforward \u2014 obvious tasks often have non-obvious quality dimensions."
+        ]
+      }),
+      principle({
+        title: "Multi-dimensional inquiry",
+        description: "Explore the problem from multiple angles \u2014 emotional, logical, practical, audience-specific \u2014 through targeted questions.",
+        policies: [
+          "Ask about the audience: Who is this for? What do they care about?",
+          "Ask about constraints: What must this include or avoid?",
+          "Ask about effectiveness: What separates great output from mediocre output in this domain?",
+          "Ask about structure: How should this be organized for maximum impact?"
+        ]
+      }),
+      principle({
+        title: "Framework discovery before application",
+        description: "Build or recall a relevant framework by reasoning through questions, then explicitly apply that framework to the specific task.",
+        policies: [
+          "First derive the framework: What principles govern this type of work?",
+          'Then apply it: "Now, using these principles, produce the specific output."',
+          "The framework should emerge from your reasoning, not from a template."
+        ]
+      }),
+      workflow({
+        task: "Socratic reasoning process",
+        steps: [
+          "Identify the core task and desired output type.",
+          "Formulate 2-5 foundational questions about what makes this output effective.",
+          "Answer each question, drawing on relevant knowledge and frameworks.",
+          "Synthesize answers into a coherent set of principles or criteria.",
+          "Apply the discovered framework to produce the specific output.",
+          "Verify the output satisfies the criteria you identified."
+        ]
+      }),
+      example({
+        question: "How should I prompt for a value proposition for my AI analytics tool?",
+        answer: "What makes a value proposition compelling to B2B buyers? What emotional and logical triggers should it hit? Now apply that framework to an AI analytics tool that helps teams make faster data-driven decisions."
+      }),
+      example({
+        question: "How should I prompt for a 30-day LinkedIn content calendar for B2B SaaS?",
+        answer: "What types of LinkedIn content generate the most engagement in B2B SaaS? What posting frequency avoids audience fatigue? How should topics build on each other? Now design a 30-day calendar using these principles."
+      })
+    )
+  ];
+}
+
 // packages/context/src/lib/guardrails/error-recovery.guardrail.ts
 import chalk2 from "chalk";
 var errorRecoveryGuardrail = {
@@ -4260,6 +4322,107 @@ function render(tag, ...fragments) {
   return renderer.render([wrapped]);
 }
 
+// packages/context/src/lib/sandbox/agent-os-sandbox.ts
+import "bash-tool";
+var textDecoder = new TextDecoder();
+var AgentOsSandboxError = class extends Error {
+  constructor(message2) {
+    super(message2);
+    this.name = "AgentOsSandboxError";
+  }
+};
+var AgentOsNotAvailableError = class extends AgentOsSandboxError {
+  constructor(cause) {
+    super(
+      "@rivet-dev/agent-os-core is not installed. Install it with: npm install @rivet-dev/agent-os-core @rivet-dev/agent-os-common"
+    );
+    this.name = "AgentOsNotAvailableError";
+    this.cause = cause;
+  }
+};
+var AgentOsCreationError = class extends AgentOsSandboxError {
+  constructor(message2, cause) {
+    super(`Failed to create Agent OS instance: ${message2}`);
+    this.name = "AgentOsCreationError";
+    this.cause = cause;
+  }
+};
+async function importAgentOs() {
+  try {
+    return await import("@rivet-dev/agent-os-core");
+  } catch (error) {
+    throw new AgentOsNotAvailableError(
+      error instanceof Error ? error : void 0
+    );
+  }
+}
+async function createAgentOsSandbox(options = {}) {
+  const { AgentOs } = await importAgentOs();
+  let os;
+  try {
+    os = await AgentOs.create(options);
+  } catch (error) {
+    const err = error instanceof Error ? error : new Error(String(error));
+    throw new AgentOsCreationError(err.message, err);
+  }
+  return {
+    async executeCommand(command) {
+      try {
+        const result = await os.exec(command);
+        return {
+          stdout: result.stdout,
+          stderr: result.stderr,
+          exitCode: result.exitCode
+        };
+      } catch (error) {
+        const err = error;
+        return {
+          stdout: err.stdout || "",
+          stderr: err.stderr || err.message || "",
+          exitCode: err.exitCode ?? 1
+        };
+      }
+    },
+    async readFile(path3) {
+      try {
+        const bytes = await os.readFile(path3);
+        return textDecoder.decode(bytes);
+      } catch (error) {
+        throw new Error(
+          `Failed to read file "${path3}": ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    },
+    async writeFiles(files) {
+      const results = await os.writeFiles(
+        files.map((f) => ({
+          path: f.path,
+          content: typeof f.content === "string" ? f.content : new Uint8Array(f.content)
+        }))
+      );
+      const failures = results.filter((r) => !r.success);
+      if (failures.length > 0) {
+        const details = failures.map((f) => `${f.path}: ${f.error}`).join(", ");
+        throw new Error(`Failed to write files: ${details}`);
+      }
+    },
+    async dispose() {
+      try {
+        await os.dispose();
+      } catch {
+      }
+    }
+  };
+}
+async function useAgentOsSandbox(options, fn) {
+  const sandbox = await createAgentOsSandbox(options);
+  try {
+    return await fn(sandbox);
+  } finally {
+    await sandbox.dispose();
+  }
+}
+
 // packages/context/src/lib/sandbox/binary-bridges.ts
 import { existsSync } from "fs";
 import { defineCommand } from "just-bash";
@@ -4356,6 +4519,11 @@ function resolveRealCwd(ctx) {
   return realCwd;
 }
 
+// packages/context/src/lib/sandbox/container-tool.ts
+import {
+  createBashTool
+} from "bash-tool";
+
 // packages/context/src/lib/sandbox/docker-sandbox.ts
 import "bash-tool";
 import spawn2 from "nano-spawn";
@@ -4448,10 +4616,10 @@ var ComposeStartError = class extends DockerSandboxError {
   }
 };
 function isDebianBased(image) {
+  const lower = image.toLowerCase();
+  if (lower.includes("alpine")) return false;
   const debianPatterns = ["debian", "ubuntu", "node", "python"];
-  return debianPatterns.some(
-    (pattern) => image.toLowerCase().includes(pattern)
-  );
+  return debianPatterns.some((pattern) => lower.includes(pattern));
 }
 function isDockerfileOptions(opts) {
   return "dockerfile" in opts;
@@ -4463,9 +4631,18 @@ var DockerSandboxStrategy = class {
   context;
   mounts;
   resources;
-  constructor(mounts = [], resources = {}) {
+  env;
+  constructor(mounts = [], resources = {}, env = {}) {
+    for (const key of Object.keys(env)) {
+      if (key.length === 0 || key.includes("=")) {
+        throw new DockerSandboxError(
+          `Invalid environment variable key: "${key}"`
+        );
+      }
+    }
     this.mounts = mounts;
     this.resources = resources;
+    this.env = env;
   }
   /**
    * Template method - defines the algorithm skeleton for creating a sandbox.
@@ -4522,6 +4699,9 @@ var DockerSandboxStrategy = class {
       "/workspace"
       // Set working directory
     ];
+    for (const [key, value] of Object.entries(this.env)) {
+      args.push("-e", `${key}=${value}`);
+    }
     for (const mount of this.mounts) {
       const mode = mount.readOnly !== false ? "ro" : "rw";
       args.push("-v", `${mount.hostPath}:${mount.containerPath}:${mode}`);
@@ -4625,8 +4805,8 @@ var RuntimeStrategy = class extends DockerSandboxStrategy {
   image;
   packages;
   binaries;
-  constructor(image = "alpine:latest", packages = [], binaries = [], mounts, resources) {
-    super(mounts, resources);
+  constructor(image = "alpine:latest", packages = [], binaries = [], mounts, resources, env) {
+    super(mounts, resources, env);
     this.image = image;
     this.packages = packages;
     this.binaries = binaries;
@@ -4795,8 +4975,8 @@ var DockerfileStrategy = class extends DockerSandboxStrategy {
   imageTag;
   dockerfile;
   dockerContext;
-  constructor(dockerfile, dockerContext = ".", mounts, resources) {
-    super(mounts, resources);
+  constructor(dockerfile, dockerContext = ".", mounts, resources, env) {
+    super(mounts, resources, env);
     this.dockerfile = dockerfile;
     this.dockerContext = dockerContext;
     this.imageTag = this.computeImageTag();
@@ -4969,7 +5149,8 @@ async function createDockerSandbox(options = {}) {
       options.dockerfile,
       options.context,
       options.mounts,
-      options.resources
+      options.resources,
+      options.env
     );
   } else {
     strategy = new RuntimeStrategy(
@@ -4977,7 +5158,8 @@ async function createDockerSandbox(options = {}) {
       options.packages,
       options.binaries,
       options.mounts,
-      options.resources
+      options.resources,
+      options.env
     );
   }
   return strategy.create();
@@ -4992,9 +5174,6 @@ async function useSandbox(options, fn) {
 }
 
 // packages/context/src/lib/sandbox/container-tool.ts
-import {
-  createBashTool
-} from "bash-tool";
 async function createContainerTool(options = {}) {
   let sandboxOptions;
   let bashOptions;
@@ -5003,12 +5182,12 @@ async function createContainerTool(options = {}) {
     sandboxOptions = { compose, service, resources };
     bashOptions = rest;
   } else if (isDockerfileOptions(options)) {
-    const { dockerfile, context, mounts, resources, ...rest } = options;
-    sandboxOptions = { dockerfile, context, mounts, resources };
+    const { dockerfile, context, mounts, resources, env, ...rest } = options;
+    sandboxOptions = { dockerfile, context, mounts, resources, env };
     bashOptions = rest;
   } else {
-    const { image, packages, binaries, mounts, resources, ...rest } = options;
-    sandboxOptions = { image, packages, binaries, mounts, resources };
+    const { image, packages, binaries, mounts, resources, env, ...rest } = options;
+    sandboxOptions = { image, packages, binaries, mounts, resources, env };
     bashOptions = rest;
   }
   const sandbox = await createDockerSandbox(sandboxOptions);
@@ -7549,6 +7728,9 @@ function visualizeGraph(data) {
   return lines.join("\n");
 }
 export {
+  AgentOsCreationError,
+  AgentOsNotAvailableError,
+  AgentOsSandboxError,
   BM25SkillClassifier,
   BinaryInstallError,
   ComposeStartError,
@@ -7596,6 +7778,7 @@ export {
   clarification,
   correction,
   createAdaptivePollingState,
+  createAgentOsSandbox,
   createBinaryBridges,
   createContainerTool,
   createDockerSandbox,
@@ -7660,6 +7843,7 @@ export {
   selfCritique,
   skills,
   skillsReminder,
+  socraticPrompting,
   soul,
   staticChatTitle,
   stop,
@@ -7670,6 +7854,7 @@ export {
   term,
   toFragment,
   toMessageFragment,
+  useAgentOsSandbox,
   useSandbox,
   user,
   visualizeGraph,