@giselles-ai/agent 0.1.25 → 0.1.26

package/dist/index.d.ts

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

package/dist/index.js

@@ -5,11 +5,18 @@ import {
 
 // src/define-agent.ts
 function defineAgent(config) {
+  const catalogPrompt = config.catalog?.prompt({ mode: "inline" });
+  const agentMd = [config.agentMd, catalogPrompt].filter(Boolean).join("\n\n");
   return {
     agentType: config.agentType ?? "gemini",
-    agentMd: config.agentMd,
+    agentMd: agentMd || void 0,
+    catalog: config.catalog,
     files: config.files ?? [],
-    env: config.env ?? {},
+    env: config.env ? Object.fromEntries(
+      Object.entries(config.env).filter(
+        (entry) => entry[1] != null
+      )
+    ) : {},
     setup: config.setup,
     get snapshotId() {
       const id = process.env?.GISELLE_AGENT_SNAPSHOT_ID;

package/dist/next/index.d.ts

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

package/dist/server/index.js

@@ -537,11 +537,19 @@ function createGeminiAgent(options = {}) {
         "--output-format",
         "stream-json",
         "--approval-mode",
-        "yolo"
+        "yolo",
+        "--sandbox",
+        "false"
       ];
       if (input.session_id) {
         args.push("--resume", input.session_id);
       }
+      console.info("[gemini-agent] createCommand", {
+        hasSessionId: Boolean(input.session_id),
+        hasSandboxId: Boolean(input.sandbox_id),
+        hasSnapshotId: Boolean(input.snapshot_id),
+        argCount: args.length
+      });
       return {
         cmd: "gemini",
         args,
@@ -597,6 +605,7 @@ function createAgent(options) {
 // src/chat-run.ts
 import { Writable } from "stream";
 import { Sandbox as Sandbox2 } from "@vercel/sandbox";
+var COMMAND_TIMEOUT_EXTENSION_MS = 5 * 60 * 1e3;
 function emitText(controller, text, encoder) {
   if (text.length === 0) {
     return;
@@ -666,7 +675,21 @@ function runChat(input) {
           const sandbox = await (async () => {
             if (parsed.sandbox_id) {
               try {
-                return await Sandbox2.get({ sandboxId: parsed.sandbox_id });
+                const existing = await Sandbox2.get({
+                  sandboxId: parsed.sandbox_id
+                });
+                if (existing.status !== "running") {
+                  if (!snapshotId) {
+                    throw new Error(
+                      `Sandbox ${parsed.sandbox_id} is ${existing.status}, not running`
+                    );
+                  }
+                  console.log(
+                    `[sandbox] sandbox=${parsed.sandbox_id} status=${existing.status}, recreating from snapshot=${snapshotId}`
+                  );
+                  return createFromSnapshot(snapshotId);
+                }
+                return existing;
               } catch (error) {
                 if (!snapshotId) {
                   throw error;
@@ -692,6 +715,16 @@ function runChat(input) {
           const command = input.agent.createCommand({
             input: parsed
           });
+          console.info("[chat-run] starting sandbox command", {
+            sandboxId: sandbox.sandboxId,
+            cmd: command.cmd,
+            args: command.args,
+            envKeys: Object.keys(command.env ?? {}).sort(),
+            hasSessionId: typeof parsed.session_id === "string" && parsed.session_id.length > 0,
+            hasSandboxId: typeof parsed.sandbox_id === "string" && parsed.sandbox_id.length > 0,
+            hasSnapshotId: typeof parsed.snapshot_id === "string" && parsed.snapshot_id.length > 0
+          });
+          await sandbox.extendTimeout(COMMAND_TIMEOUT_EXTENSION_MS);
           await sandbox.runCommand({
             cmd: command.cmd,
             args: command.args,
@@ -713,6 +746,10 @@ function runChat(input) {
             stderr: new Writable({
               write(chunk, _encoding, callback) {
                 const text = typeof chunk === "string" ? chunk : chunk.toString("utf8");
+                console.error("[chat-run] sandbox stderr", {
+                  sandboxId: sandbox.sandboxId,
+                  content: text
+                });
                 enqueueEvent({ type: "stderr", content: text });
                 callback();
               }
@@ -969,8 +1006,12 @@ function injectRelayUrl(agent, relayUrl) {
     }
   };
 }
+function usesBrowserTool(agent) {
+  return isCreateAgentOptions2(agent) && agent.tools?.browser !== void 0;
+}
 async function runCloudChat(input) {
-  const agentParam = injectRelayUrl(input.agent, input.relayUrl);
+  const browserToolEnabled = usesBrowserTool(input.agent);
+  const agentParam = browserToolEnabled ? injectRelayUrl(input.agent, input.relayUrl) : input.agent;
   const agent = resolveAgent(agentParam);
   const now = input.now?.() ?? Date.now();
   const createRelaySub = input.createRelayRequestSubscription ?? createRelayRequestSubscription;
@@ -992,23 +1033,29 @@ async function runCloudChat(input) {
       sendResponse
     });
   }
-  const relaySession = await input.createRelaySession();
-  const relaySubscription = await createRelaySub({
-    sessionId: relaySession.sessionId,
-    token: relaySession.token
-  });
-  console.info("[cloud-chat] relay subscription ready", {
-    chatId: input.chatId,
-    relaySessionId: relaySession.sessionId
-  });
   const runtimeInput = {
     ...input.request,
     ...existing?.agentSessionId ? { session_id: existing.agentSessionId } : {},
     ...existing?.sandboxId ? { sandbox_id: existing.sandboxId } : {},
-    ...existing?.snapshotId ? { snapshot_id: existing.snapshotId } : {},
-    relay_session_id: relaySession.sessionId,
-    relay_token: relaySession.token
+    ...existing?.snapshotId ? { snapshot_id: existing.snapshotId } : {}
   };
+  let relaySession;
+  let relaySubscription = null;
+  if (browserToolEnabled) {
+    relaySession = await input.createRelaySession();
+    relaySubscription = await createRelaySub({
+      sessionId: relaySession.sessionId,
+      token: relaySession.token
+    });
+    console.info("[cloud-chat] relay subscription ready", {
+      chatId: input.chatId,
+      relaySessionId: relaySession.sessionId
+    });
+    Object.assign(runtimeInput, {
+      relay_session_id: relaySession.sessionId,
+      relay_token: relaySession.token
+    });
+  }
   let response;
   try {
     response = await (input.runChatImpl ?? runChat)({
@@ -1017,7 +1064,7 @@ async function runCloudChat(input) {
       input: runtimeInput
     });
   } catch (error) {
-    await relaySubscription.close().catch(() => void 0);
+    await relaySubscription?.close().catch(() => void 0);
     throw error;
   }
   const managed = createManagedCloudResponseFromReader({
@@ -1032,7 +1079,7 @@ async function runCloudChat(input) {
     relaySubscription,
     relaySession,
     relayUrl: input.relayUrl,
-    includeRelaySessionPrelude: true,
+    includeRelaySessionPrelude: browserToolEnabled,
     initialBuffer: "",
     initialTextBlockOpen: false
   });

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

@@ -1,3 +1,10 @@
+/** Minimal interface for a json-render catalog. */
+type UICatalog = {
+    prompt(options?: {
+        mode?: "inline" | "standalone";
+        customRules?: string[];
+    }): string;
+};
 type AgentFile = {
     path: string;
     content: string;
@@ -11,8 +18,10 @@ type AgentConfig = {
     agentType?: "gemini" | "codex";
     /** Content for AGENTS.md in the sandbox. */
     agentMd?: string;
+    /** Optional json-render catalog for generative UI. */
+    catalog?: UICatalog;
     /** Environment variables passed to the sandbox at build and run time. */
-    env?: Record<string, string>;
+    env?: Record<string, string | undefined>;
     /** Additional files to write into the sandbox. */
     files?: AgentFile[];
     /** Setup configuration for the sandbox build phase. */
@@ -21,6 +30,7 @@ type AgentConfig = {
 type DefinedAgent = {
     readonly agentType: "gemini" | "codex";
     readonly agentMd?: string;
+    readonly catalog?: UICatalog;
     readonly files: AgentFile[];
     /** Setup configuration. Undefined when no setup is configured. */
     readonly setup?: AgentSetup;
@@ -30,4 +40,4 @@ type DefinedAgent = {
     readonly snapshotId: string;
 };
 
-export type { AgentConfig as A, DefinedAgent as D, AgentFile as a, AgentSetup as b };
+export type { AgentConfig as A, DefinedAgent as D, UICatalog as U, AgentFile as a, AgentSetup as b };

package/package.json

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