octoflow-core 1.0.0

package/dist/domain/shared.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Small, reusable type fragments shared across multiple modules.
+ *
+ * These types replace repeated inline shapes that appeared in 4+ locations
+ * each. Keeping them here avoids circular imports while making the codebase
+ * DRY-er without affecting the public API surface.
+ */
+export interface ErrorSummary {
+    name: string;
+    message: string;
+}
+export interface StructuredHistoryEntry {
+    role: 'user' | 'assistant';
+    content: string;
+}
+/**
+ * Worker manifest tag — metadata stored on a `WorkerEntry` so the
+ * delegation driver can advertise worker capabilities in the leader's
+ * manifest and route by tag (see `WorkerRegistry.findBySkill`).
+ *
+ * This is **routing metadata only** — it has no effect on what the worker
+ * can actually do at runtime. Use `LocalWorkerConfig.agentSkills` for
+ * SKILL.md execution and `LocalWorkerConfig.tools` for tool/MCP delivery.
+ */
+export interface SkillRef {
+    id: string;
+    name: string;
+    tags?: string[];
+}
+//# sourceMappingURL=shared.d.ts.map

package/dist/domain/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/domain/shared.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB"}

package/dist/domain/shared.js

@@ -0,0 +1 @@
+//# sourceMappingURL=shared.js.map

package/dist/domain/shared.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/environments/bash-action.d.ts

@@ -0,0 +1,17 @@
+import type { ExecutionEnvironment } from 'octoflow-protocols';
+import type { ActionDefinition } from '../actions/types.js';
+export interface EnvBackedBashActionOptions {
+    /** Override the default action name. Defaults to `'bash'` (replaces the built-in). */
+    name?: string;
+    /** Tags injected onto the action. */
+    tags?: readonly string[];
+    /** Whether the action requires approval. Default `true`. */
+    requireApproval?: boolean;
+}
+/**
+ * Build an `Action` whose body delegates to the supplied {@link ExecutionEnvironment}.
+ * Drop-in replacement for the built-in `bash` action when the agent should run
+ * commands inside a sandbox or on a remote machine.
+ */
+export declare function envBackedBashAction(env: ExecutionEnvironment, opts?: EnvBackedBashActionOptions): ActionDefinition;
+//# sourceMappingURL=bash-action.d.ts.map

package/dist/environments/bash-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash-action.d.ts","sourceRoot":"","sources":["../../src/environments/bash-action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,WAAW,0BAA0B;IACzC,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,4DAA4D;IAC5D,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,oBAAoB,EACzB,IAAI,GAAE,0BAA+B,GACpC,gBAAgB,CAqElB"}

package/dist/environments/bash-action.js

@@ -0,0 +1,64 @@
+import { defineAction } from "../actions/define.js";
+function envBackedBashAction(env, opts = {}) {
+  return defineAction({
+    name: opts.name ?? "bash",
+    description: `Execute a shell command inside the '${env.name}' execution environment. Output is head+tail truncated when it exceeds the configured byte limit. Set \`workdir\` instead of running \`cd\` inside the command.`,
+    parameters: {
+      type: "object",
+      properties: {
+        command: {
+          type: "string",
+          description: "The shell command to execute."
+        },
+        workdir: {
+          type: "string",
+          description: "Working directory for the command."
+        },
+        env: {
+          type: "object",
+          additionalProperties: { type: "string" },
+          description: "Extra environment variables for the command."
+        },
+        timeout_ms: {
+          type: "number",
+          description: "Maximum execution time in milliseconds before the process is killed."
+        },
+        stdin: {
+          type: "string",
+          description: "Optional stdin payload piped to the command."
+        }
+      },
+      required: ["command"]
+    },
+    execute: async (args) => {
+      const command = args.command;
+      const workdir = typeof args.workdir === "string" ? args.workdir : void 0;
+      const extraEnv = args.env != null && typeof args.env === "object" ? args.env : void 0;
+      const timeoutMs = typeof args.timeout_ms === "number" ? args.timeout_ms : void 0;
+      const stdin = typeof args.stdin === "string" ? args.stdin : void 0;
+      const result = await env.exec({
+        command,
+        cwd: workdir,
+        env: extraEnv,
+        timeoutMs,
+        stdin
+      });
+      return {
+        environment: env.name,
+        stdout: result.stdout,
+        stderr: result.stderr,
+        exitCode: result.exitCode,
+        truncated: result.truncated,
+        timedOut: result.timedOut,
+        durationMs: result.durationMs,
+        ...result.costUsd != null ? { costUsd: result.costUsd } : {}
+      };
+    },
+    requireApproval: opts.requireApproval ?? true,
+    tags: opts.tags ?? ["shell", "bash", "exec", "environment", env.name]
+  });
+}
+export {
+  envBackedBashAction
+};
+//# sourceMappingURL=bash-action.js.map

package/dist/environments/bash-action.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/environments/bash-action.ts"],
+  "sourcesContent": ["import type { ExecutionEnvironment } from 'octoflow-protocols';\n\nimport { defineAction } from '../actions/define.js';\nimport type { ActionDefinition } from '../actions/types.js';\n\nexport interface EnvBackedBashActionOptions {\n  /** Override the default action name. Defaults to `'bash'` (replaces the built-in). */\n  name?: string;\n  /** Tags injected onto the action. */\n  tags?: readonly string[];\n  /** Whether the action requires approval. Default `true`. */\n  requireApproval?: boolean;\n}\n\n/**\n * Build an `Action` whose body delegates to the supplied {@link ExecutionEnvironment}.\n * Drop-in replacement for the built-in `bash` action when the agent should run\n * commands inside a sandbox or on a remote machine.\n */\nexport function envBackedBashAction(\n  env: ExecutionEnvironment,\n  opts: EnvBackedBashActionOptions = {}\n): ActionDefinition {\n  return defineAction({\n    name: opts.name ?? 'bash',\n    description:\n      `Execute a shell command inside the '${env.name}' execution environment. ` +\n      'Output is head+tail truncated when it exceeds the configured byte limit. ' +\n      'Set `workdir` instead of running `cd` inside the command.',\n    parameters: {\n      type: 'object',\n      properties: {\n        command: {\n          type: 'string',\n          description: 'The shell command to execute.',\n        },\n        workdir: {\n          type: 'string',\n          description: 'Working directory for the command.',\n        },\n        env: {\n          type: 'object',\n          additionalProperties: { type: 'string' },\n          description: 'Extra environment variables for the command.',\n        },\n        timeout_ms: {\n          type: 'number',\n          description:\n            'Maximum execution time in milliseconds before the process is killed.',\n        },\n        stdin: {\n          type: 'string',\n          description: 'Optional stdin payload piped to the command.',\n        },\n      },\n      required: ['command'],\n    },\n    execute: async (args) => {\n      const command = args.command as string;\n      const workdir =\n        typeof args.workdir === 'string' ? args.workdir : undefined;\n      const extraEnv =\n        args.env != null && typeof args.env === 'object'\n          ? (args.env as Record<string, string>)\n          : undefined;\n      const timeoutMs =\n        typeof args.timeout_ms === 'number' ? args.timeout_ms : undefined;\n      const stdin = typeof args.stdin === 'string' ? args.stdin : undefined;\n\n      const result = await env.exec({\n        command,\n        cwd: workdir,\n        env: extraEnv,\n        timeoutMs,\n        stdin,\n      });\n\n      return {\n        environment: env.name,\n        stdout: result.stdout,\n        stderr: result.stderr,\n        exitCode: result.exitCode,\n        truncated: result.truncated,\n        timedOut: result.timedOut,\n        durationMs: result.durationMs,\n        ...(result.costUsd != null ? { costUsd: result.costUsd } : {}),\n      };\n    },\n    requireApproval: opts.requireApproval ?? true,\n    tags: opts.tags ?? ['shell', 'bash', 'exec', 'environment', env.name],\n  });\n}\n"],
+  "mappings": "AAEA,SAAS,oBAAoB;AAiBtB,SAAS,oBACd,KACA,OAAmC,CAAC,GAClB;AAClB,SAAO,aAAa;AAAA,IAClB,MAAM,KAAK,QAAQ;AAAA,IACnB,aACE,uCAAuC,IAAI,IAAI;AAAA,IAGjD,YAAY;AAAA,MACV,MAAM;AAAA,MACN,YAAY;AAAA,QACV,SAAS;AAAA,UACP,MAAM;AAAA,UACN,aAAa;AAAA,QACf;AAAA,QACA,SAAS;AAAA,UACP,MAAM;AAAA,UACN,aAAa;AAAA,QACf;AAAA,QACA,KAAK;AAAA,UACH,MAAM;AAAA,UACN,sBAAsB,EAAE,MAAM,SAAS;AAAA,UACvC,aAAa;AAAA,QACf;AAAA,QACA,YAAY;AAAA,UACV,MAAM;AAAA,UACN,aACE;AAAA,QACJ;AAAA,QACA,OAAO;AAAA,UACL,MAAM;AAAA,UACN,aAAa;AAAA,QACf;AAAA,MACF;AAAA,MACA,UAAU,CAAC,SAAS;AAAA,IACtB;AAAA,IACA,SAAS,OAAO,SAAS;AACvB,YAAM,UAAU,KAAK;AACrB,YAAM,UACJ,OAAO,KAAK,YAAY,WAAW,KAAK,UAAU;AACpD,YAAM,WACJ,KAAK,OAAO,QAAQ,OAAO,KAAK,QAAQ,WACnC,KAAK,MACN;AACN,YAAM,YACJ,OAAO,KAAK,eAAe,WAAW,KAAK,aAAa;AAC1D,YAAM,QAAQ,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ;AAE5D,YAAM,SAAS,MAAM,IAAI,KAAK;AAAA,QAC5B;AAAA,QACA,KAAK;AAAA,QACL,KAAK;AAAA,QACL;AAAA,QACA;AAAA,MACF,CAAC;AAED,aAAO;AAAA,QACL,aAAa,IAAI;AAAA,QACjB,QAAQ,OAAO;AAAA,QACf,QAAQ,OAAO;AAAA,QACf,UAAU,OAAO;AAAA,QACjB,WAAW,OAAO;AAAA,QAClB,UAAU,OAAO;AAAA,QACjB,YAAY,OAAO;AAAA,QACnB,GAAI,OAAO,WAAW,OAAO,EAAE,SAAS,OAAO,QAAQ,IAAI,CAAC;AAAA,MAC9D;AAAA,IACF;AAAA,IACA,iBAAiB,KAAK,mBAAmB;AAAA,IACzC,MAAM,KAAK,QAAQ,CAAC,SAAS,QAAQ,QAAQ,eAAe,IAAI,IAAI;AAAA,EACtE,CAAC;AACH;",
+  "names": []
+}

package/dist/environments/docker.d.ts

@@ -0,0 +1,38 @@
+import type { ExecutionEnvironment } from 'octoflow-protocols';
+export interface DockerEnvironmentOptions {
+    image: string;
+    /** Optional reusable container id; when omitted a fresh container is created per environment instance. */
+    containerId?: string;
+    cmd?: readonly string[];
+    workingDir?: string;
+    /** Pass to `Dockerode` — host, port, socketPath, version. */
+    dockerOptions?: Record<string, unknown>;
+    defaultTimeoutMs?: number;
+    outputByteLimit?: number;
+    /** Inject a pre-built `Dockerode` client (used by tests / custom transports). */
+    client?: DockerodeLike;
+}
+/** Minimal structural type for the bits of `dockerode` we consume. */
+export interface DockerodeLike {
+    getContainer(id: string): DockerContainerLike;
+    createContainer(opts: Record<string, unknown>): Promise<DockerContainerLike>;
+}
+export interface DockerContainerLike {
+    id?: string;
+    start(): Promise<unknown>;
+    stop(opts?: {
+        t?: number;
+    }): Promise<unknown>;
+    remove(opts?: {
+        force?: boolean;
+    }): Promise<unknown>;
+    exec(opts: Record<string, unknown>): Promise<DockerExecLike>;
+}
+export interface DockerExecLike {
+    start(opts: Record<string, unknown>): Promise<NodeJS.ReadableStream>;
+    inspect(): Promise<{
+        ExitCode?: number | null;
+    }>;
+}
+export declare function createDockerEnvironment(opts: DockerEnvironmentOptions): ExecutionEnvironment;
+//# sourceMappingURL=docker.d.ts.map

package/dist/environments/docker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.d.ts","sourceRoot":"","sources":["../../src/environments/docker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAS5B,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,0GAA0G;IAC1G,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iFAAiF;IACjF,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,CAAC;IAC9C,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC9E;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1B,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,CAAC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrD,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IACrE,OAAO,IAAI,OAAO,CAAC;QAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CAClD;AAYD,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,wBAAwB,GAC7B,oBAAoB,CAyDtB"}

package/dist/environments/docker.js

@@ -0,0 +1,123 @@
+import { EXECUTION_ENVIRONMENT_CONTRACT_VERSION } from "octoflow-protocols";
+import {
+  ENVIRONMENT_DEFAULTS,
+  loadOptionalPeer,
+  runExecBody
+} from "./shared.js";
+const DOCKER_CAPABILITIES = [
+  "sandboxed",
+  "process-backed",
+  "sdk-backed"
+];
+function createDockerEnvironment(opts) {
+  const defaultTimeoutMs = opts.defaultTimeoutMs ?? ENVIRONMENT_DEFAULTS.timeoutMs;
+  const outputByteLimit = opts.outputByteLimit ?? ENVIRONMENT_DEFAULTS.outputByteLimit;
+  let containerPromise;
+  let ownsContainer = false;
+  async function getContainer() {
+    if (containerPromise) return containerPromise;
+    containerPromise = (async () => {
+      const client = opts.client ?? await createDockerodeClient(opts.dockerOptions);
+      if (opts.containerId) {
+        return client.getContainer(opts.containerId);
+      }
+      ownsContainer = true;
+      const container = await client.createContainer({
+        Image: opts.image,
+        Cmd: opts.cmd ?? ["sleep", "infinity"],
+        WorkingDir: opts.workingDir,
+        Tty: false
+      });
+      await container.start();
+      return container;
+    })();
+    return containerPromise;
+  }
+  return {
+    contractVersion: EXECUTION_ENVIRONMENT_CONTRACT_VERSION,
+    name: "docker",
+    capabilities: DOCKER_CAPABILITIES,
+    async exec(input) {
+      const container = await getContainer();
+      return runExecBody(
+        input,
+        defaultTimeoutMs,
+        outputByteLimit,
+        () => execInContainer(container, input)
+      );
+    },
+    async cleanup() {
+      if (!containerPromise || !ownsContainer) return;
+      const container = await containerPromise;
+      try {
+        await container.stop({ t: 1 });
+      } catch {
+      }
+      try {
+        await container.remove({ force: true });
+      } catch {
+      }
+      containerPromise = void 0;
+    }
+  };
+}
+async function createDockerodeClient(dockerOptions) {
+  const mod = await loadOptionalPeer("dockerode");
+  return new mod.default(dockerOptions);
+}
+async function execInContainer(container, input) {
+  const env = input.env ? Object.entries(input.env).map(([k, v]) => `${k}=${v}`) : void 0;
+  const exec = await container.exec({
+    Cmd: ["/bin/sh", "-c", input.command],
+    AttachStdout: true,
+    AttachStderr: true,
+    AttachStdin: input.stdin != null,
+    Tty: false,
+    WorkingDir: input.cwd,
+    Env: env
+  });
+  const stream = await exec.start({ hijack: true, stdin: input.stdin != null });
+  const { stdout, stderr } = await collectDemuxedStream(stream, input.stdin);
+  const inspect = await exec.inspect();
+  return {
+    stdout,
+    stderr,
+    exitCode: inspect.ExitCode ?? 0
+  };
+}
+function collectDemuxedStream(stream, stdin) {
+  return new Promise((resolve, reject) => {
+    const stdoutChunks = [];
+    const stderrChunks = [];
+    let leftover = Buffer.alloc(0);
+    stream.on("data", (chunk) => {
+      let buf = Buffer.concat([leftover, chunk]);
+      while (buf.byteLength >= 8) {
+        const header = buf.subarray(0, 8);
+        const streamId = header.readUInt8(0);
+        const payloadLen = header.readUInt32BE(4);
+        if (buf.byteLength < 8 + payloadLen) break;
+        const payload = buf.subarray(8, 8 + payloadLen);
+        if (streamId === 2) stderrChunks.push(payload);
+        else stdoutChunks.push(payload);
+        buf = buf.subarray(8 + payloadLen);
+      }
+      leftover = buf;
+    });
+    stream.on("error", reject);
+    stream.on("end", () => {
+      resolve({
+        stdout: Buffer.concat(stdoutChunks).toString("utf8"),
+        stderr: Buffer.concat(stderrChunks).toString("utf8")
+      });
+    });
+    const writable = stream;
+    if (stdin != null && typeof writable.end === "function") {
+      writable.end(stdin);
+    }
+  });
+}
+export {
+  createDockerEnvironment
+};
+//# sourceMappingURL=docker.js.map

package/dist/environments/docker.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/environments/docker.ts"],
+  "sourcesContent": ["import type {\n  EnvCapability,\n  ExecInput,\n  ExecResult,\n  ExecutionEnvironment,\n} from 'octoflow-protocols';\nimport { EXECUTION_ENVIRONMENT_CONTRACT_VERSION } from 'octoflow-protocols';\n\nimport {\n  ENVIRONMENT_DEFAULTS,\n  loadOptionalPeer,\n  runExecBody,\n} from './shared.js';\n\nexport interface DockerEnvironmentOptions {\n  image: string;\n  /** Optional reusable container id; when omitted a fresh container is created per environment instance. */\n  containerId?: string;\n  cmd?: readonly string[];\n  workingDir?: string;\n  /** Pass to `Dockerode` \u2014 host, port, socketPath, version. */\n  dockerOptions?: Record<string, unknown>;\n  defaultTimeoutMs?: number;\n  outputByteLimit?: number;\n  /** Inject a pre-built `Dockerode` client (used by tests / custom transports). */\n  client?: DockerodeLike;\n}\n\n/** Minimal structural type for the bits of `dockerode` we consume. */\nexport interface DockerodeLike {\n  getContainer(id: string): DockerContainerLike;\n  createContainer(opts: Record<string, unknown>): Promise<DockerContainerLike>;\n}\n\nexport interface DockerContainerLike {\n  id?: string;\n  start(): Promise<unknown>;\n  stop(opts?: { t?: number }): Promise<unknown>;\n  remove(opts?: { force?: boolean }): Promise<unknown>;\n  exec(opts: Record<string, unknown>): Promise<DockerExecLike>;\n}\n\nexport interface DockerExecLike {\n  start(opts: Record<string, unknown>): Promise<NodeJS.ReadableStream>;\n  inspect(): Promise<{ ExitCode?: number | null }>;\n}\n\ninterface DockerodeModule {\n  default: new (opts?: Record<string, unknown>) => DockerodeLike;\n}\n\nconst DOCKER_CAPABILITIES: readonly EnvCapability[] = [\n  'sandboxed',\n  'process-backed',\n  'sdk-backed',\n];\n\nexport function createDockerEnvironment(\n  opts: DockerEnvironmentOptions\n): ExecutionEnvironment {\n  const defaultTimeoutMs =\n    opts.defaultTimeoutMs ?? ENVIRONMENT_DEFAULTS.timeoutMs;\n  const outputByteLimit =\n    opts.outputByteLimit ?? ENVIRONMENT_DEFAULTS.outputByteLimit;\n  let containerPromise: Promise<DockerContainerLike> | undefined;\n  let ownsContainer = false;\n\n  async function getContainer(): Promise<DockerContainerLike> {\n    if (containerPromise) return containerPromise;\n    containerPromise = (async () => {\n      const client =\n        opts.client ?? (await createDockerodeClient(opts.dockerOptions));\n      if (opts.containerId) {\n        return client.getContainer(opts.containerId);\n      }\n      ownsContainer = true;\n      const container = await client.createContainer({\n        Image: opts.image,\n        Cmd: opts.cmd ?? ['sleep', 'infinity'],\n        WorkingDir: opts.workingDir,\n        Tty: false,\n      });\n      await container.start();\n      return container;\n    })();\n    return containerPromise;\n  }\n\n  return {\n    contractVersion: EXECUTION_ENVIRONMENT_CONTRACT_VERSION,\n    name: 'docker',\n    capabilities: DOCKER_CAPABILITIES,\n\n    async exec(input: ExecInput): Promise<ExecResult> {\n      const container = await getContainer();\n      return runExecBody(input, defaultTimeoutMs, outputByteLimit, () =>\n        execInContainer(container, input)\n      );\n    },\n\n    async cleanup(): Promise<void> {\n      if (!containerPromise || !ownsContainer) return;\n      const container = await containerPromise;\n      try {\n        await container.stop({ t: 1 });\n      } catch {\n        /* already stopped */\n      }\n      try {\n        await container.remove({ force: true });\n      } catch {\n        /* already gone */\n      }\n      containerPromise = undefined;\n    },\n  };\n}\n\nasync function createDockerodeClient(\n  dockerOptions?: Record<string, unknown>\n): Promise<DockerodeLike> {\n  const mod = await loadOptionalPeer<DockerodeModule>('dockerode');\n  return new mod.default(dockerOptions);\n}\n\nasync function execInContainer(\n  container: DockerContainerLike,\n  input: ExecInput\n): Promise<{ stdout: string; stderr: string; exitCode: number }> {\n  const env = input.env\n    ? Object.entries(input.env).map(([k, v]) => `${k}=${v}`)\n    : undefined;\n  const exec = await container.exec({\n    Cmd: ['/bin/sh', '-c', input.command],\n    AttachStdout: true,\n    AttachStderr: true,\n    AttachStdin: input.stdin != null,\n    Tty: false,\n    WorkingDir: input.cwd,\n    Env: env,\n  });\n\n  const stream = await exec.start({ hijack: true, stdin: input.stdin != null });\n  const { stdout, stderr } = await collectDemuxedStream(stream, input.stdin);\n\n  const inspect = await exec.inspect();\n  return {\n    stdout,\n    stderr,\n    exitCode: inspect.ExitCode ?? 0,\n  };\n}\n\n/**\n * Collect a demuxed Docker exec stream into stdout/stderr buffers.\n * Docker frames have an 8-byte header where byte 0 is the stream id (1=stdout, 2=stderr).\n */\nfunction collectDemuxedStream(\n  stream: NodeJS.ReadableStream,\n  stdin?: string\n): Promise<{ stdout: string; stderr: string }> {\n  return new Promise((resolve, reject) => {\n    const stdoutChunks: Buffer[] = [];\n    const stderrChunks: Buffer[] = [];\n    let leftover = Buffer.alloc(0);\n\n    stream.on('data', (chunk: Buffer) => {\n      let buf = Buffer.concat([leftover, chunk]);\n      while (buf.byteLength >= 8) {\n        const header = buf.subarray(0, 8);\n        const streamId = header.readUInt8(0);\n        const payloadLen = header.readUInt32BE(4);\n        if (buf.byteLength < 8 + payloadLen) break;\n        const payload = buf.subarray(8, 8 + payloadLen);\n        if (streamId === 2) stderrChunks.push(payload);\n        else stdoutChunks.push(payload);\n        buf = buf.subarray(8 + payloadLen);\n      }\n      leftover = buf;\n    });\n\n    stream.on('error', reject);\n    stream.on('end', () => {\n      resolve({\n        stdout: Buffer.concat(stdoutChunks).toString('utf8'),\n        stderr: Buffer.concat(stderrChunks).toString('utf8'),\n      });\n    });\n\n    const writable = stream as unknown as NodeJS.WritableStream;\n    if (stdin != null && typeof writable.end === 'function') {\n      writable.end(stdin);\n    }\n  });\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/environments/e2b.d.ts

@@ -0,0 +1,28 @@
+import type { ExecutionEnvironment } from 'octoflow-protocols';
+export interface E2bEnvironmentOptions {
+    apiKey: string;
+    template?: string;
+    /** Optional running sandbox id to attach to (skip create). */
+    sandboxId?: string;
+    defaultTimeoutMs?: number;
+    outputByteLimit?: number;
+    /** Inject a pre-built `Sandbox` (used by tests). */
+    sandbox?: E2bSandboxLike;
+}
+export interface E2bSandboxLike {
+    commands: {
+        run(command: string, opts?: Record<string, unknown>): Promise<E2bCommandResult>;
+    };
+    pause?(): Promise<{
+        id: string;
+    }>;
+    resume?(snapshotId: string): Promise<unknown>;
+    kill?(): Promise<unknown>;
+}
+export interface E2bCommandResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export declare function createE2bEnvironment(opts: E2bEnvironmentOptions): ExecutionEnvironment;
+//# sourceMappingURL=e2b.d.ts.map

package/dist/environments/e2b.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"e2b.d.ts","sourceRoot":"","sources":["../../src/environments/e2b.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,oBAAoB,EAErB,MAAM,oBAAoB,CAAC;AAY5B,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE;QACR,GAAG,CACD,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,gBAAgB,CAAC,CAAC;KAC9B,CAAC;IACF,KAAK,CAAC,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClC,MAAM,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAmBD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,qBAAqB,GAC1B,oBAAoB,CA0FtB"}

package/dist/environments/e2b.js

@@ -0,0 +1,105 @@
+import { EXECUTION_ENVIRONMENT_CONTRACT_VERSION } from "octoflow-protocols";
+import {
+  ENVIRONMENT_DEFAULTS,
+  isEnvironmentTimeoutError,
+  loadOptionalPeer,
+  runWithTimeout,
+  timedOutExecResult,
+  truncateOutput
+} from "./shared.js";
+const E2B_CAPABILITIES = [
+  "sandboxed",
+  "serverless",
+  "sdk-backed",
+  "persistent-snapshot"
+];
+function createE2bEnvironment(opts) {
+  const defaultTimeoutMs = opts.defaultTimeoutMs ?? ENVIRONMENT_DEFAULTS.timeoutMs;
+  const outputByteLimit = opts.outputByteLimit ?? ENVIRONMENT_DEFAULTS.outputByteLimit;
+  let sandboxPromise;
+  async function getSandbox() {
+    if (sandboxPromise) return sandboxPromise;
+    sandboxPromise = createOrConnect(opts);
+    return sandboxPromise;
+  }
+  return {
+    contractVersion: EXECUTION_ENVIRONMENT_CONTRACT_VERSION,
+    name: "e2b",
+    capabilities: E2B_CAPABILITIES,
+    async exec(input) {
+      const start = Date.now();
+      const timeoutMs = input.timeoutMs ?? defaultTimeoutMs;
+      const sandbox = await getSandbox();
+      let value;
+      let timedOut;
+      try {
+        ({ value, timedOut } = await runWithTimeout(
+          async () => sandbox.commands.run(input.command, {
+            cwd: input.cwd,
+            envs: input.env,
+            stdin: input.stdin
+          }),
+          timeoutMs,
+          input.signal
+        ));
+      } catch (error) {
+        if (isEnvironmentTimeoutError(error)) {
+          return timedOutExecResult(error, start);
+        }
+        throw error;
+      }
+      const stdoutTrunc = truncateOutput(value.stdout, outputByteLimit);
+      const stderrTrunc = truncateOutput(value.stderr, outputByteLimit);
+      return {
+        stdout: stdoutTrunc.text,
+        stderr: stderrTrunc.text,
+        exitCode: value.exitCode,
+        truncated: stdoutTrunc.truncated || stderrTrunc.truncated,
+        timedOut,
+        durationMs: Date.now() - start
+      };
+    },
+    async snapshot(taskId) {
+      const sandbox = await getSandbox();
+      if (!sandbox.pause) {
+        throw new Error(
+          "[octoflow-core/environments] e2b: sandbox.pause() unavailable on this SDK version"
+        );
+      }
+      const result = await sandbox.pause();
+      return { id: result.id, metadata: { taskId } };
+    },
+    async restore(_taskId, ref) {
+      const mod = await loadOptionalPeer("@e2b/code-interpreter");
+      if (!mod.Sandbox.connect) {
+        throw new Error(
+          "[octoflow-core/environments] e2b: Sandbox.connect() unavailable on this SDK version"
+        );
+      }
+      sandboxPromise = mod.Sandbox.connect(ref.id, { apiKey: opts.apiKey });
+      const sandbox = await sandboxPromise;
+      await sandbox.resume?.(ref.id);
+    },
+    async cleanup() {
+      if (!sandboxPromise) return;
+      const sandbox = await sandboxPromise;
+      try {
+        await sandbox.kill?.();
+      } catch {
+      }
+      sandboxPromise = void 0;
+    }
+  };
+}
+async function createOrConnect(opts) {
+  if (opts.sandbox) return opts.sandbox;
+  const mod = await loadOptionalPeer("@e2b/code-interpreter");
+  if (opts.sandboxId && mod.Sandbox.connect) {
+    return mod.Sandbox.connect(opts.sandboxId, { apiKey: opts.apiKey });
+  }
+  return mod.Sandbox.create({ apiKey: opts.apiKey, template: opts.template });
+}
+export {
+  createE2bEnvironment
+};
+//# sourceMappingURL=e2b.js.map

package/dist/environments/e2b.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/environments/e2b.ts"],
+  "sourcesContent": ["import type {\n  EnvCapability,\n  ExecInput,\n  ExecResult,\n  ExecutionEnvironment,\n  SnapshotRef,\n} from 'octoflow-protocols';\nimport { EXECUTION_ENVIRONMENT_CONTRACT_VERSION } from 'octoflow-protocols';\n\nimport {\n  ENVIRONMENT_DEFAULTS,\n  isEnvironmentTimeoutError,\n  loadOptionalPeer,\n  runWithTimeout,\n  timedOutExecResult,\n  truncateOutput,\n} from './shared.js';\n\nexport interface E2bEnvironmentOptions {\n  apiKey: string;\n  template?: string;\n  /** Optional running sandbox id to attach to (skip create). */\n  sandboxId?: string;\n  defaultTimeoutMs?: number;\n  outputByteLimit?: number;\n  /** Inject a pre-built `Sandbox` (used by tests). */\n  sandbox?: E2bSandboxLike;\n}\n\nexport interface E2bSandboxLike {\n  commands: {\n    run(\n      command: string,\n      opts?: Record<string, unknown>\n    ): Promise<E2bCommandResult>;\n  };\n  pause?(): Promise<{ id: string }>;\n  resume?(snapshotId: string): Promise<unknown>;\n  kill?(): Promise<unknown>;\n}\n\nexport interface E2bCommandResult {\n  stdout: string;\n  stderr: string;\n  exitCode: number;\n}\n\ninterface E2bModule {\n  Sandbox: {\n    create(opts: Record<string, unknown>): Promise<E2bSandboxLike>;\n    connect?(\n      sandboxId: string,\n      opts?: Record<string, unknown>\n    ): Promise<E2bSandboxLike>;\n  };\n}\n\nconst E2B_CAPABILITIES: readonly EnvCapability[] = [\n  'sandboxed',\n  'serverless',\n  'sdk-backed',\n  'persistent-snapshot',\n];\n\nexport function createE2bEnvironment(\n  opts: E2bEnvironmentOptions\n): ExecutionEnvironment {\n  const defaultTimeoutMs =\n    opts.defaultTimeoutMs ?? ENVIRONMENT_DEFAULTS.timeoutMs;\n  const outputByteLimit =\n    opts.outputByteLimit ?? ENVIRONMENT_DEFAULTS.outputByteLimit;\n  let sandboxPromise: Promise<E2bSandboxLike> | undefined;\n\n  async function getSandbox(): Promise<E2bSandboxLike> {\n    if (sandboxPromise) return sandboxPromise;\n    sandboxPromise = createOrConnect(opts);\n    return sandboxPromise;\n  }\n\n  return {\n    contractVersion: EXECUTION_ENVIRONMENT_CONTRACT_VERSION,\n    name: 'e2b',\n    capabilities: E2B_CAPABILITIES,\n\n    async exec(input: ExecInput): Promise<ExecResult> {\n      const start = Date.now();\n      const timeoutMs = input.timeoutMs ?? defaultTimeoutMs;\n      const sandbox = await getSandbox();\n\n      let value: E2bCommandResult;\n      let timedOut: boolean;\n      try {\n        ({ value, timedOut } = await runWithTimeout(\n          async () =>\n            sandbox.commands.run(input.command, {\n              cwd: input.cwd,\n              envs: input.env,\n              stdin: input.stdin,\n            }),\n          timeoutMs,\n          input.signal\n        ));\n      } catch (error) {\n        if (isEnvironmentTimeoutError(error)) {\n          return timedOutExecResult(error, start);\n        }\n        throw error;\n      }\n\n      const stdoutTrunc = truncateOutput(value.stdout, outputByteLimit);\n      const stderrTrunc = truncateOutput(value.stderr, outputByteLimit);\n\n      return {\n        stdout: stdoutTrunc.text,\n        stderr: stderrTrunc.text,\n        exitCode: value.exitCode,\n        truncated: stdoutTrunc.truncated || stderrTrunc.truncated,\n        timedOut,\n        durationMs: Date.now() - start,\n      };\n    },\n\n    async snapshot(taskId: string): Promise<SnapshotRef> {\n      const sandbox = await getSandbox();\n      if (!sandbox.pause) {\n        throw new Error(\n          '[octoflow-core/environments] e2b: sandbox.pause() unavailable on this SDK version'\n        );\n      }\n      const result = await sandbox.pause();\n      return { id: result.id, metadata: { taskId } };\n    },\n\n    async restore(_taskId: string, ref: SnapshotRef): Promise<void> {\n      const mod = await loadOptionalPeer<E2bModule>('@e2b/code-interpreter');\n      if (!mod.Sandbox.connect) {\n        throw new Error(\n          '[octoflow-core/environments] e2b: Sandbox.connect() unavailable on this SDK version'\n        );\n      }\n      sandboxPromise = mod.Sandbox.connect(ref.id, { apiKey: opts.apiKey });\n      const sandbox = await sandboxPromise;\n      await sandbox.resume?.(ref.id);\n    },\n\n    async cleanup(): Promise<void> {\n      if (!sandboxPromise) return;\n      const sandbox = await sandboxPromise;\n      try {\n        await sandbox.kill?.();\n      } catch {\n        /* already gone */\n      }\n      sandboxPromise = undefined;\n    },\n  };\n}\n\nasync function createOrConnect(\n  opts: E2bEnvironmentOptions\n): Promise<E2bSandboxLike> {\n  if (opts.sandbox) return opts.sandbox;\n  const mod = await loadOptionalPeer<E2bModule>('@e2b/code-interpreter');\n  if (opts.sandboxId && mod.Sandbox.connect) {\n    return mod.Sandbox.connect(opts.sandboxId, { apiKey: opts.apiKey });\n  }\n  return mod.Sandbox.create({ apiKey: opts.apiKey, template: opts.template });\n}\n"],
+  "mappings": "AAOA,SAAS,8CAA8C;AAEvD;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAyCP,MAAM,mBAA6C;AAAA,EACjD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,SAAS,qBACd,MACsB;AACtB,QAAM,mBACJ,KAAK,oBAAoB,qBAAqB;AAChD,QAAM,kBACJ,KAAK,mBAAmB,qBAAqB;AAC/C,MAAI;AAEJ,iBAAe,aAAsC;AACnD,QAAI,eAAgB,QAAO;AAC3B,qBAAiB,gBAAgB,IAAI;AACrC,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,iBAAiB;AAAA,IACjB,MAAM;AAAA,IACN,cAAc;AAAA,IAEd,MAAM,KAAK,OAAuC;AAChD,YAAM,QAAQ,KAAK,IAAI;AACvB,YAAM,YAAY,MAAM,aAAa;AACrC,YAAM,UAAU,MAAM,WAAW;AAEjC,UAAI;AACJ,UAAI;AACJ,UAAI;AACF,SAAC,EAAE,OAAO,SAAS,IAAI,MAAM;AAAA,UAC3B,YACE,QAAQ,SAAS,IAAI,MAAM,SAAS;AAAA,YAClC,KAAK,MAAM;AAAA,YACX,MAAM,MAAM;AAAA,YACZ,OAAO,MAAM;AAAA,UACf,CAAC;AAAA,UACH;AAAA,UACA,MAAM;AAAA,QACR;AAAA,MACF,SAAS,OAAO;AACd,YAAI,0BAA0B,KAAK,GAAG;AACpC,iBAAO,mBAAmB,OAAO,KAAK;AAAA,QACxC;AACA,cAAM;AAAA,MACR;AAEA,YAAM,cAAc,eAAe,MAAM,QAAQ,eAAe;AAChE,YAAM,cAAc,eAAe,MAAM,QAAQ,eAAe;AAEhE,aAAO;AAAA,QACL,QAAQ,YAAY;AAAA,QACpB,QAAQ,YAAY;AAAA,QACpB,UAAU,MAAM;AAAA,QAChB,WAAW,YAAY,aAAa,YAAY;AAAA,QAChD;AAAA,QACA,YAAY,KAAK,IAAI,IAAI;AAAA,MAC3B;AAAA,IACF;AAAA,IAEA,MAAM,SAAS,QAAsC;AACnD,YAAM,UAAU,MAAM,WAAW;AACjC,UAAI,CAAC,QAAQ,OAAO;AAClB,cAAM,IAAI;AAAA,UACR;AAAA,QACF;AAAA,MACF;AACA,YAAM,SAAS,MAAM,QAAQ,MAAM;AACnC,aAAO,EAAE,IAAI,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE;AAAA,IAC/C;AAAA,IAEA,MAAM,QAAQ,SAAiB,KAAiC;AAC9D,YAAM,MAAM,MAAM,iBAA4B,uBAAuB;AACrE,UAAI,CAAC,IAAI,QAAQ,SAAS;AACxB,cAAM,IAAI;AAAA,UACR;AAAA,QACF;AAAA,MACF;AACA,uBAAiB,IAAI,QAAQ,QAAQ,IAAI,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC;AACpE,YAAM,UAAU,MAAM;AACtB,YAAM,QAAQ,SAAS,IAAI,EAAE;AAAA,IAC/B;AAAA,IAEA,MAAM,UAAyB;AAC7B,UAAI,CAAC,eAAgB;AACrB,YAAM,UAAU,MAAM;AACtB,UAAI;AACF,cAAM,QAAQ,OAAO;AAAA,MACvB,QAAQ;AAAA,MAER;AACA,uBAAiB;AAAA,IACnB;AAAA,EACF;AACF;AAEA,eAAe,gBACb,MACyB;AACzB,MAAI,KAAK,QAAS,QAAO,KAAK;AAC9B,QAAM,MAAM,MAAM,iBAA4B,uBAAuB;AACrE,MAAI,KAAK,aAAa,IAAI,QAAQ,SAAS;AACzC,WAAO,IAAI,QAAQ,QAAQ,KAAK,WAAW,EAAE,QAAQ,KAAK,OAAO,CAAC;AAAA,EACpE;AACA,SAAO,IAAI,QAAQ,OAAO,EAAE,QAAQ,KAAK,QAAQ,UAAU,KAAK,SAAS,CAAC;AAC5E;",
+  "names": []
+}

package/dist/environments/index.d.ts

@@ -0,0 +1,19 @@
+export type { EnvBackedBashActionOptions } from './bash-action.js';
+export { envBackedBashAction } from './bash-action.js';
+export type { DockerContainerLike, DockerEnvironmentOptions, DockerExecLike, DockerodeLike, } from './docker.js';
+export { createDockerEnvironment } from './docker.js';
+export type { E2bCommandResult, E2bEnvironmentOptions, E2bSandboxLike, } from './e2b.js';
+export { createE2bEnvironment } from './e2b.js';
+export type { LocalEnvironmentOptions } from './local.js';
+export { createLocalEnvironment } from './local.js';
+export type { EnvironmentsBridgePlugin, EnvironmentsPluginOptions, } from './plugin.js';
+export { createEnvironmentsPlugin } from './plugin.js';
+export type { EnvironmentsRegistry, EnvironmentsRegistryOptions, } from './registry.js';
+export { createEnvironmentsRegistry } from './registry.js';
+export type { SshChannelLike, SshClientLike, SshEnvironmentOptions, } from './ssh.js';
+export { createSshEnvironment } from './ssh.js';
+export type { VercelCommandResult, VercelSandboxEnvironmentOptions, VercelSandboxLike, } from './vercel-sandbox.js';
+export { createVercelSandboxEnvironment } from './vercel-sandbox.js';
+export type { EnvCapability, ExecInput, ExecResult, ExecutionEnvironment, SnapshotRef, } from 'octoflow-protocols';
+export { EXECUTION_ENVIRONMENT_CONTRACT_VERSION } from 'octoflow-protocols';
+//# sourceMappingURL=index.d.ts.map

package/dist/environments/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/environments/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,YAAY,EACV,mBAAmB,EACnB,wBAAwB,EACxB,cAAc,EACd,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,GACf,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,YAAY,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,YAAY,EACV,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EACV,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAC3D,YAAY,EACV,cAAc,EACd,aAAa,EACb,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,YAAY,EACV,mBAAmB,EACnB,+BAA+B,EAC/B,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,8BAA8B,EAAE,MAAM,qBAAqB,CAAC;AACrE,YAAY,EACV,aAAa,EACb,SAAS,EACT,UAAU,EACV,oBAAoB,EACpB,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,sCAAsC,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/environments/index.js

@@ -0,0 +1,21 @@
+import { envBackedBashAction } from "./bash-action.js";
+import { createDockerEnvironment } from "./docker.js";
+import { createE2bEnvironment } from "./e2b.js";
+import { createLocalEnvironment } from "./local.js";
+import { createEnvironmentsPlugin } from "./plugin.js";
+import { createEnvironmentsRegistry } from "./registry.js";
+import { createSshEnvironment } from "./ssh.js";
+import { createVercelSandboxEnvironment } from "./vercel-sandbox.js";
+import { EXECUTION_ENVIRONMENT_CONTRACT_VERSION } from "octoflow-protocols";
+export {
+  EXECUTION_ENVIRONMENT_CONTRACT_VERSION,
+  createDockerEnvironment,
+  createE2bEnvironment,
+  createEnvironmentsPlugin,
+  createEnvironmentsRegistry,
+  createLocalEnvironment,
+  createSshEnvironment,
+  createVercelSandboxEnvironment,
+  envBackedBashAction
+};
+//# sourceMappingURL=index.js.map

package/dist/environments/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/environments/index.ts"],
+  "sourcesContent": ["export type { EnvBackedBashActionOptions } from './bash-action.js';\nexport { envBackedBashAction } from './bash-action.js';\nexport type {\n  DockerContainerLike,\n  DockerEnvironmentOptions,\n  DockerExecLike,\n  DockerodeLike,\n} from './docker.js';\nexport { createDockerEnvironment } from './docker.js';\nexport type {\n  E2bCommandResult,\n  E2bEnvironmentOptions,\n  E2bSandboxLike,\n} from './e2b.js';\nexport { createE2bEnvironment } from './e2b.js';\nexport type { LocalEnvironmentOptions } from './local.js';\nexport { createLocalEnvironment } from './local.js';\nexport type {\n  EnvironmentsBridgePlugin,\n  EnvironmentsPluginOptions,\n} from './plugin.js';\nexport { createEnvironmentsPlugin } from './plugin.js';\nexport type {\n  EnvironmentsRegistry,\n  EnvironmentsRegistryOptions,\n} from './registry.js';\nexport { createEnvironmentsRegistry } from './registry.js';\nexport type {\n  SshChannelLike,\n  SshClientLike,\n  SshEnvironmentOptions,\n} from './ssh.js';\nexport { createSshEnvironment } from './ssh.js';\nexport type {\n  VercelCommandResult,\n  VercelSandboxEnvironmentOptions,\n  VercelSandboxLike,\n} from './vercel-sandbox.js';\nexport { createVercelSandboxEnvironment } from './vercel-sandbox.js';\nexport type {\n  EnvCapability,\n  ExecInput,\n  ExecResult,\n  ExecutionEnvironment,\n  SnapshotRef,\n} from 'octoflow-protocols';\nexport { EXECUTION_ENVIRONMENT_CONTRACT_VERSION } from 'octoflow-protocols';\n"],
+  "mappings": "AACA,SAAS,2BAA2B;AAOpC,SAAS,+BAA+B;AAMxC,SAAS,4BAA4B;AAErC,SAAS,8BAA8B;AAKvC,SAAS,gCAAgC;AAKzC,SAAS,kCAAkC;AAM3C,SAAS,4BAA4B;AAMrC,SAAS,sCAAsC;AAQ/C,SAAS,8CAA8C;",
+  "names": []
+}

package/dist/environments/local.d.ts

@@ -0,0 +1,15 @@
+import type { ExecutionEnvironment } from 'octoflow-protocols';
+export interface LocalEnvironmentOptions {
+    /** Default working directory used when an `ExecInput` does not supply one. */
+    cwd?: string;
+    /** Extra environment variables merged on top of `process.env`. */
+    env?: Record<string, string>;
+    /** Default timeout in ms when an `ExecInput` does not supply one. */
+    defaultTimeoutMs?: number;
+    /** Maximum bytes of stdout/stderr returned. Excess is head+tail truncated. */
+    outputByteLimit?: number;
+    /** Run under a shell (`/bin/sh -c <command>`). Default `true`. */
+    shell?: boolean;
+}
+export declare function createLocalEnvironment(opts?: LocalEnvironmentOptions): ExecutionEnvironment;
+//# sourceMappingURL=local.d.ts.map

package/dist/environments/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/environments/local.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAIV,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAW5B,MAAM,WAAW,uBAAuB;IACtC,8EAA8E;IAC9E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8EAA8E;IAC9E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAOD,wBAAgB,sBAAsB,CACpC,IAAI,GAAE,uBAA4B,GACjC,oBAAoB,CAkDtB"}