@superatomai/sdk-node 0.0.62-dsp → 0.0.63-dsp

package/dist/index.d.mts

@@ -5389,6 +5389,15 @@ interface CodingAgentDefinition<TInput = unknown, TOutput = unknown> {
      * connection. Omit for an agent that only needs the files it is given.
      */
     tools?: Record<string, McpServerSpec>;
+    /**
+     * Environment for this run's session — how a SHARED executable learns what is
+     * specific to this run (bridge URL, identity token, source id).
+     *
+     * The alternative is a per-workspace copy of each tool with those values
+     * baked in, which makes a tool edit reach only new workspaces and leaves the
+     * run's identity token on disk after it is revoked.
+     */
+    env?(input: TInput, ctx: AgentRunContext): Record<string, string> | Promise<Record<string, string>>;
     /**
      * Put the job's inputs in the workspace as FILES, not prompt text. A coding
      * agent can grep, aggregate and script over a file; it cannot do any of that

package/dist/index.d.ts

@@ -5389,6 +5389,15 @@ interface CodingAgentDefinition<TInput = unknown, TOutput = unknown> {
      * connection. Omit for an agent that only needs the files it is given.
      */
     tools?: Record<string, McpServerSpec>;
+    /**
+     * Environment for this run's session — how a SHARED executable learns what is
+     * specific to this run (bridge URL, identity token, source id).
+     *
+     * The alternative is a per-workspace copy of each tool with those values
+     * baked in, which makes a tool edit reach only new workspaces and leaves the
+     * run's identity token on disk after it is revoked.
+     */
+    env?(input: TInput, ctx: AgentRunContext): Record<string, string> | Promise<Record<string, string>>;
     /**
      * Put the job's inputs in the workspace as FILES, not prompt text. A coding
      * agent can grep, aggregate and script over a file; it cannot do any of that

package/dist/index.js

@@ -24628,12 +24628,14 @@ async function runCodingAgent(agentId, options = {}) {
     // prepare() actually ran.
     (runAsJob && def.buildPrompt ? await def.buildPrompt(ws, input, ctx) : outputPath ? `Carry out the task described in AGENTS.md. Write your finished result to this exact absolute path: ${outputPath}` : "Carry out the task described in AGENTS.md.");
     const tools = { ...cfg.sharedTools ?? {}, ...def.tools ?? {} };
+    const sessionEnv = def.env ? await def.env(input, ctx) : void 0;
     const session = createCodingAgentSession(def.harness || cfg.harness, {
       cwd: dir,
       model: def.model || cfg.model,
       resumeId,
       // undefined, not {}, when this agent has no tools — see the driver.
       mcpServers: tools && Object.keys(tools).length ? tools : void 0,
+      ...sessionEnv ? { env: sessionEnv } : {},
       ...def.networkAccessEnabled !== void 0 ? { networkAccessEnabled: def.networkAccessEnabled } : {},
       ...def.sandboxMode ? { sandboxMode: def.sandboxMode } : {}
     });
@@ -24717,6 +24719,7 @@ async function runCodingAgent(agentId, options = {}) {
           model: def.model || cfg.model,
           resumeId: result.sessionId,
           mcpServers: tools && Object.keys(tools).length ? tools : void 0,
+          ...sessionEnv ? { env: sessionEnv } : {},
           ...def.networkAccessEnabled !== void 0 ? { networkAccessEnabled: def.networkAccessEnabled } : {},
           ...def.sandboxMode ? { sandboxMode: def.sandboxMode } : {}
         });

package/dist/index.mjs

@@ -24522,12 +24522,14 @@ async function runCodingAgent(agentId, options = {}) {
     // prepare() actually ran.
     (runAsJob && def.buildPrompt ? await def.buildPrompt(ws, input, ctx) : outputPath ? `Carry out the task described in AGENTS.md. Write your finished result to this exact absolute path: ${outputPath}` : "Carry out the task described in AGENTS.md.");
     const tools = { ...cfg.sharedTools ?? {}, ...def.tools ?? {} };
+    const sessionEnv = def.env ? await def.env(input, ctx) : void 0;
     const session = createCodingAgentSession(def.harness || cfg.harness, {
       cwd: dir,
       model: def.model || cfg.model,
       resumeId,
       // undefined, not {}, when this agent has no tools — see the driver.
       mcpServers: tools && Object.keys(tools).length ? tools : void 0,
+      ...sessionEnv ? { env: sessionEnv } : {},
       ...def.networkAccessEnabled !== void 0 ? { networkAccessEnabled: def.networkAccessEnabled } : {},
       ...def.sandboxMode ? { sandboxMode: def.sandboxMode } : {}
     });
@@ -24611,6 +24613,7 @@ async function runCodingAgent(agentId, options = {}) {
           model: def.model || cfg.model,
           resumeId: result.sessionId,
           mcpServers: tools && Object.keys(tools).length ? tools : void 0,
+          ...sessionEnv ? { env: sessionEnv } : {},
           ...def.networkAccessEnabled !== void 0 ? { networkAccessEnabled: def.networkAccessEnabled } : {},
           ...def.sandboxMode ? { sandboxMode: def.sandboxMode } : {}
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superatomai/sdk-node",
-  "version": "0.0.62-dsp",
+  "version": "0.0.63-dsp",
   "description": "Node.js TypeScript SDK for Superatom",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",