@giselles-ai/agent 0.1.24 → 0.1.25

package/dist/{chunk-TAQV6ZOB.js → chunk-JGH5DCA7.js}

@@ -7,7 +7,13 @@ function computeConfigHash(config) {
     files: (config.files ?? []).map((f) => ({
       path: f.path,
       content: f.content
-    }))
+    })),
+    setup: config.setup?.script ?? null,
+    env: config.env ? Object.fromEntries(
+      Object.entries(config.env).sort(
+        ([a], [b]) => a < b ? -1 : a > b ? 1 : 0
+      )
+    ) : null
   });
   return createHash("sha256").update(payload).digest("hex").slice(0, 16);
 }
@@ -50,7 +56,9 @@ async function requestBuild(agent, options) {
   const requestBody = {
     config_hash: configHash,
     agent_type: agent.agentType ?? "gemini",
-    files
+    files,
+    setup_script: agent.setup?.script ?? null,
+    env: agent.env ?? null
   };
   const requestHeaders = {
     "content-type": "application/json",

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as AgentConfig, D as DefinedAgent } from './types-Cto-uejG.js';
-export { a as AgentFile } from './types-Cto-uejG.js';
+import { A as AgentConfig, D as DefinedAgent } from './types-cRejduhB.js';
+export { a as AgentFile, b as AgentSetup } from './types-cRejduhB.js';
 
 declare function defineAgent(config: AgentConfig): DefinedAgent;
 

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   computeConfigHash,
   requestBuild
-} from "./chunk-TAQV6ZOB.js";
+} from "./chunk-JGH5DCA7.js";
 
 // src/define-agent.ts
 function defineAgent(config) {
@@ -9,6 +9,8 @@ function defineAgent(config) {
     agentType: config.agentType ?? "gemini",
     agentMd: config.agentMd,
     files: config.files ?? [],
+    env: config.env ?? {},
+    setup: config.setup,
     get snapshotId() {
       const id = process.env?.GISELLE_AGENT_SNAPSHOT_ID;
       if (!id) {

package/dist/next/index.d.ts

@@ -1,5 +1,5 @@
 import { NextConfig } from 'next';
-import { A as AgentConfig } from '../types-Cto-uejG.js';
+import { A as AgentConfig } from '../types-cRejduhB.js';
 
 type GiselleAgentPluginOptions = {
     /** Base URL for the agent API. Default: process.env.GISELLE_AGENT_BASE_URL ?? "https://studio.giselles.ai/agent-api" */

package/dist/next/index.js

@@ -1,9 +1,9 @@
 import {
+  computeConfigHash,
   requestBuild
-} from "../chunk-TAQV6ZOB.js";
+} from "../chunk-JGH5DCA7.js";
 
 // src/next/with-giselle-agent.ts
-import crypto from "crypto";
 import fs from "fs";
 import { createRequire } from "module";
 import path from "path";
@@ -18,12 +18,7 @@ function resolveBaseUrl(options) {
   return (options?.baseUrl ?? process.env.GISELLE_AGENT_BASE_URL ?? "https://studio.giselles.ai/agent-api").replace(/\/+$/, "");
 }
 function getSnapshotFile(agent) {
-  const key = {
-    agentType: agent.agentType,
-    agentMd: agent.agentMd,
-    files: agent.files
-  };
-  const hash = crypto.createHash("sha256").update(JSON.stringify(key)).digest("hex").slice(0, 16);
+  const hash = computeConfigHash(agent);
   return path.join(process.cwd(), ".next", "giselle", hash);
 }
 function hasRunRecently() {

package/dist/server/index.d.ts

@@ -147,6 +147,7 @@ declare const cloudChatRunRequestSchema: z.ZodObject<{
         gemini: "gemini";
     }>;
     snapshot_id: z.ZodString;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     tool_results: z.ZodOptional<z.ZodArray<z.ZodObject<{
         toolCallId: z.ZodString;
         toolName: z.ZodEnum<{

package/dist/server/index.js

@@ -51,6 +51,8 @@ function parseBuildRequest(body) {
   const configHash = record.config_hash;
   const agentType = record.agent_type;
   const files = record.files;
+  const setupScript = record.setup_script;
+  const rawEnv = record.env;
   if (typeof configHash !== "string" || !configHash.trim()) {
     return null;
   }
@@ -61,6 +63,8 @@ function parseBuildRequest(body) {
     return null;
   }
   const parsedFiles = [];
+  let parsedSetupScript = null;
+  let parsedEnv = null;
   for (const file of files) {
     if (!file || typeof file !== "object" || Array.isArray(file)) {
       return null;
@@ -74,10 +78,30 @@ function parseBuildRequest(body) {
       content: recordFile.content
     });
   }
+  if (setupScript !== void 0 && setupScript !== null) {
+    if (typeof setupScript !== "string") {
+      return null;
+    }
+    parsedSetupScript = setupScript;
+  }
+  if (rawEnv !== void 0 && rawEnv !== null) {
+    if (typeof rawEnv !== "object" || Array.isArray(rawEnv)) {
+      return null;
+    }
+    const envRecord = rawEnv;
+    for (const value of Object.values(envRecord)) {
+      if (typeof value !== "string") {
+        return null;
+      }
+    }
+    parsedEnv = envRecord;
+  }
   return {
     config_hash: configHash.trim(),
     agent_type: agentType,
-    files: parsedFiles
+    files: parsedFiles,
+    setup_script: parsedSetupScript,
+    env: parsedEnv
   };
 }
 async function buildAgent(input) {
@@ -123,6 +147,21 @@ async function buildAgent(input) {
       }))
     );
   }
+  if (parsed.setup_script) {
+    console.log("[agent-build] running setup script...");
+    const result = await sandbox.runCommand({
+      cmd: "bash",
+      args: ["-lc", parsed.setup_script],
+      ...parsed.env ? { env: parsed.env } : {}
+    });
+    if (result.exitCode !== 0) {
+      const stderr = typeof result.stderr === "string" ? result.stderr : "";
+      throw new Error(
+        `Setup script failed (exit ${result.exitCode}): ${stderr}`
+      );
+    }
+    console.log("[agent-build] setup script completed");
+  }
   const snapshot = await sandbox.snapshot();
   console.log(`[agent-build] snapshot created: ${snapshot.snapshotId}`);
   await cache.set(cacheKey, snapshot.snapshotId);
@@ -359,7 +398,12 @@ function createCodexAgent(options = {}) {
       return {
         cmd: "codex",
         args,
-        env: { CODEX_API_KEY: apiKey }
+        env: Object.fromEntries(
+          Object.entries({
+            ...env,
+            CODEX_API_KEY: apiKey
+          }).filter((e) => e[1] != null)
+        )
       };
     },
     createStdoutMapper() {
@@ -501,9 +545,12 @@ function createGeminiAgent(options = {}) {
       return {
         cmd: "gemini",
         args,
-        env: {
-          GEMINI_API_KEY: requiredEnv2(env, "GEMINI_API_KEY")
-        }
+        env: Object.fromEntries(
+          Object.entries({
+            ...env,
+            GEMINI_API_KEY: requiredEnv2(env, "GEMINI_API_KEY")
+          }).filter((e) => e[1] != null)
+        )
       };
     }
   };
@@ -822,6 +869,7 @@ var cloudChatRunRequestSchema = z3.object({
   message: z3.string().min(1),
   agent_type: z3.enum(["gemini", "codex"]),
   snapshot_id: z3.string().min(1),
+  env: z3.record(z3.string(), z3.string()).optional(),
   tool_results: z3.array(
     z3.object({
       toolCallId: z3.string().min(1),
@@ -1446,12 +1494,17 @@ function createAgentApi(options) {
           chat_id: parsed.data.chat_id,
           agent_type: parsed.data.agent_type,
           snapshot_id: parsed.data.snapshot_id,
+          env: parsed.data.env,
           tool_results: parsed.data.tool_results
         },
         agent: {
           ...agentOptions,
           type: parsed.data.agent_type,
-          snapshotId: parsed.data.snapshot_id
+          snapshotId: parsed.data.snapshot_id,
+          env: {
+            ...parsed.data.env,
+            ...agentOptions.env
+          }
         },
         signal: request.signal,
         store: await getStore(),

package/dist/{types-Cto-uejG.d.ts → types-cRejduhB.d.ts}

@@ -2,20 +2,32 @@ type AgentFile = {
     path: string;
     content: string;
 };
+type AgentSetup = {
+    /** Shell script to run inside the sandbox during build. Executed as `bash -lc`. */
+    script: string;
+};
 type AgentConfig = {
     /** Agent type. Defaults to "gemini". */
     agentType?: "gemini" | "codex";
     /** Content for AGENTS.md in the sandbox. */
     agentMd?: string;
+    /** Environment variables passed to the sandbox at build and run time. */
+    env?: Record<string, string>;
     /** Additional files to write into the sandbox. */
     files?: AgentFile[];
+    /** Setup configuration for the sandbox build phase. */
+    setup?: AgentSetup;
 };
 type DefinedAgent = {
     readonly agentType: "gemini" | "codex";
     readonly agentMd?: string;
     readonly files: AgentFile[];
+    /** Setup configuration. Undefined when no setup is configured. */
+    readonly setup?: AgentSetup;
+    /** Environment variables. */
+    readonly env: Record<string, string>;
     /** Snapshot ID resolved from env at runtime. Throws if not set. */
     readonly snapshotId: string;
 };
 
-export type { AgentConfig as A, DefinedAgent as D, AgentFile as a };
+export type { AgentConfig as A, DefinedAgent as D, AgentFile as a, AgentSetup as b };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@giselles-ai/agent",
-	"version": "0.1.24",
+	"version": "0.1.25",
 	"type": "module",
 	"sideEffects": false,
 	"license": "Apache-2.0",
@@ -37,8 +37,8 @@
 		"format": "pnpm exec biome check --write ."
 	},
 	"dependencies": {
-		"@giselles-ai/browser-tool": "0.1.24",
-		"@vercel/sandbox": "1.6.0",
+		"@giselles-ai/browser-tool": "0.1.25",
+		"@vercel/sandbox": "1.8.1",
 		"@iarna/toml": "3.0.0",
 		"zod": "4.3.6"
 	},