agi 0.4.0 → 0.4.1

package/dist/index.d.mts

@@ -554,6 +554,7 @@ declare class SessionsResource {
         restoreFromEnvironmentId?: string;
         agentSessionType?: string;
         cdpUrl?: string;
+        environmentType?: string;
     }): Promise<SessionResponse>;
     /**
      * List all sessions for the authenticated user
@@ -1143,7 +1144,7 @@ declare class APIError extends AGIError {
  * - Events are emitted on stdout (driver -> SDK)
  * - Commands are sent on stdin (SDK -> driver)
  */
-type EventType = 'ready' | 'state_change' | 'thinking' | 'action' | 'confirm' | 'ask_question' | 'finished' | 'error' | 'screenshot_captured';
+type EventType = 'ready' | 'state_change' | 'thinking' | 'action' | 'confirm' | 'ask_question' | 'finished' | 'error' | 'screenshot_captured' | 'session_created';
 type CommandType = 'start' | 'screenshot' | 'pause' | 'resume' | 'stop' | 'confirm' | 'answer';
 type DriverState = 'idle' | 'running' | 'paused' | 'waiting_confirmation' | 'waiting_answer' | 'finished' | 'stopped' | 'error';
 interface BaseEvent {
@@ -1198,7 +1199,17 @@ interface ScreenshotCapturedEvent extends BaseEvent {
     width: number;
     height: number;
 }
-type DriverEvent = ReadyEvent | StateChangeEvent | ThinkingEvent | ActionEvent | ConfirmEvent | AskQuestionEvent | FinishedEvent | ErrorEvent | ScreenshotCapturedEvent;
+/**
+ * Emitted after the driver creates an API session.
+ */
+interface SessionCreatedEvent extends BaseEvent {
+    event: 'session_created';
+    session_id: string;
+    agent_url: string;
+    environment_url?: string;
+    vnc_url?: string;
+}
+type DriverEvent = ReadyEvent | StateChangeEvent | ThinkingEvent | ActionEvent | ConfirmEvent | AskQuestionEvent | FinishedEvent | ErrorEvent | ScreenshotCapturedEvent | SessionCreatedEvent;
 interface DriverAction {
     type: string;
     x?: number;
@@ -1217,8 +1228,14 @@ interface StartCommand extends BaseCommand {
     screen_height: number;
     platform: 'desktop' | 'android';
     model: string;
-    /** "local" for autonomous mode, "" for legacy SDK-driven mode */
+    /** "local" for autonomous mode, "remote" for managed VM, "" for legacy SDK-driven mode */
     mode?: string;
+    /** Agent name for the AGI API (e.g., "agi-2-claude") */
+    agent_name?: string;
+    /** AGI API base URL (default: "https://api.agi.tech") */
+    api_url?: string;
+    /** Environment type for remote mode ("ubuntu-1" or "chrome-1") */
+    environment_type?: string;
 }
 interface ScreenshotCommand extends BaseCommand {
     command: 'screenshot';
@@ -1265,8 +1282,14 @@ interface DriverOptions {
     model?: string;
     /** Platform type (default: 'desktop') */
     platform?: 'desktop' | 'android';
-    /** "local" for autonomous mode, "" for legacy SDK-driven mode */
+    /** "local" for autonomous mode, "remote" for managed VM, "" for legacy SDK-driven mode */
     mode?: string;
+    /** Agent name for the AGI API (e.g., "agi-2-claude") */
+    agentName?: string;
+    /** AGI API base URL (default: "https://api.agi.tech") */
+    apiUrl?: string;
+    /** Environment type for remote mode ("ubuntu-1" or "chrome-1") */
+    environmentType?: string;
     /** Environment variables to pass to the driver process */
     env?: Record<string, string>;
 }
@@ -1312,10 +1335,12 @@ interface DriverResult {
  */
 declare class AgentDriver extends EventEmitter {
     private readonly binaryPath;
-    private readonly pythonFallback;
     private readonly model;
     private readonly platform;
     private readonly mode;
+    private readonly agentName;
+    private readonly apiUrl;
+    private readonly environmentType;
     private readonly env;
     private process;
     private readline;

package/dist/index.d.ts

@@ -554,6 +554,7 @@ declare class SessionsResource {
         restoreFromEnvironmentId?: string;
         agentSessionType?: string;
         cdpUrl?: string;
+        environmentType?: string;
     }): Promise<SessionResponse>;
     /**
      * List all sessions for the authenticated user
@@ -1143,7 +1144,7 @@ declare class APIError extends AGIError {
  * - Events are emitted on stdout (driver -> SDK)
  * - Commands are sent on stdin (SDK -> driver)
  */
-type EventType = 'ready' | 'state_change' | 'thinking' | 'action' | 'confirm' | 'ask_question' | 'finished' | 'error' | 'screenshot_captured';
+type EventType = 'ready' | 'state_change' | 'thinking' | 'action' | 'confirm' | 'ask_question' | 'finished' | 'error' | 'screenshot_captured' | 'session_created';
 type CommandType = 'start' | 'screenshot' | 'pause' | 'resume' | 'stop' | 'confirm' | 'answer';
 type DriverState = 'idle' | 'running' | 'paused' | 'waiting_confirmation' | 'waiting_answer' | 'finished' | 'stopped' | 'error';
 interface BaseEvent {
@@ -1198,7 +1199,17 @@ interface ScreenshotCapturedEvent extends BaseEvent {
     width: number;
     height: number;
 }
-type DriverEvent = ReadyEvent | StateChangeEvent | ThinkingEvent | ActionEvent | ConfirmEvent | AskQuestionEvent | FinishedEvent | ErrorEvent | ScreenshotCapturedEvent;
+/**
+ * Emitted after the driver creates an API session.
+ */
+interface SessionCreatedEvent extends BaseEvent {
+    event: 'session_created';
+    session_id: string;
+    agent_url: string;
+    environment_url?: string;
+    vnc_url?: string;
+}
+type DriverEvent = ReadyEvent | StateChangeEvent | ThinkingEvent | ActionEvent | ConfirmEvent | AskQuestionEvent | FinishedEvent | ErrorEvent | ScreenshotCapturedEvent | SessionCreatedEvent;
 interface DriverAction {
     type: string;
     x?: number;
@@ -1217,8 +1228,14 @@ interface StartCommand extends BaseCommand {
     screen_height: number;
     platform: 'desktop' | 'android';
     model: string;
-    /** "local" for autonomous mode, "" for legacy SDK-driven mode */
+    /** "local" for autonomous mode, "remote" for managed VM, "" for legacy SDK-driven mode */
     mode?: string;
+    /** Agent name for the AGI API (e.g., "agi-2-claude") */
+    agent_name?: string;
+    /** AGI API base URL (default: "https://api.agi.tech") */
+    api_url?: string;
+    /** Environment type for remote mode ("ubuntu-1" or "chrome-1") */
+    environment_type?: string;
 }
 interface ScreenshotCommand extends BaseCommand {
     command: 'screenshot';
@@ -1265,8 +1282,14 @@ interface DriverOptions {
     model?: string;
     /** Platform type (default: 'desktop') */
     platform?: 'desktop' | 'android';
-    /** "local" for autonomous mode, "" for legacy SDK-driven mode */
+    /** "local" for autonomous mode, "remote" for managed VM, "" for legacy SDK-driven mode */
     mode?: string;
+    /** Agent name for the AGI API (e.g., "agi-2-claude") */
+    agentName?: string;
+    /** AGI API base URL (default: "https://api.agi.tech") */
+    apiUrl?: string;
+    /** Environment type for remote mode ("ubuntu-1" or "chrome-1") */
+    environmentType?: string;
     /** Environment variables to pass to the driver process */
     env?: Record<string, string>;
 }
@@ -1312,10 +1335,12 @@ interface DriverResult {
  */
 declare class AgentDriver extends EventEmitter {
     private readonly binaryPath;
-    private readonly pythonFallback;
     private readonly model;
     private readonly platform;
     private readonly mode;
+    private readonly agentName;
+    private readonly apiUrl;
+    private readonly environmentType;
     private readonly env;
     private process;
     private readline;

package/dist/index.js

@@ -674,6 +674,7 @@ var SessionsResource = class {
       payload.agent_session_type = options.agentSessionType;
     }
     if (options?.cdpUrl) payload.cdp_url = options.cdpUrl;
+    if (options?.environmentType) payload.environment_type = options.environmentType;
     const response = await this.http.request("POST", "/v1/sessions", {
       json: payload
     });
@@ -1305,16 +1306,6 @@ function getSearchPaths(platformId) {
   }
   return paths;
 }
-function getPythonFallback() {
-  const driverPath = process.env.AGI_DRIVER_PATH;
-  if (driverPath && fs.existsSync(path.join(driverPath, "__main__.py"))) {
-    return {
-      command: process.env.PYTHON_PATH || "python",
-      args: ["-m", "agi_driver"]
-    };
-  }
-  return null;
-}
 function findBinaryPath() {
   const platformId = getPlatformId();
   const searchPaths = getSearchPaths(platformId);
@@ -1348,10 +1339,12 @@ function serializeCommand(command) {
 // src/driver/driver.ts
 var AgentDriver = class extends events.EventEmitter {
   binaryPath;
-  pythonFallback;
   model;
   platform;
   mode;
+  agentName;
+  apiUrl;
+  environmentType;
   env;
   process = null;
   readline = null;
@@ -1367,21 +1360,13 @@ var AgentDriver = class extends events.EventEmitter {
   pendingAnswer = null;
   constructor(options = {}) {
     super();
-    let binaryPath = null;
-    try {
-      binaryPath = options.binaryPath ?? findBinaryPath();
-    } catch {
-    }
-    this.binaryPath = binaryPath;
-    this.pythonFallback = binaryPath ? null : getPythonFallback();
-    if (!this.binaryPath && !this.pythonFallback) {
-      throw new Error(
-        "Could not find agi-driver binary and Python fallback is not available. Set AGI_DRIVER_PATH to the agi_driver source directory for development."
-      );
-    }
+    this.binaryPath = options.binaryPath ?? findBinaryPath();
     this.model = options.model ?? "claude-sonnet";
     this.platform = options.platform ?? "desktop";
     this.mode = options.mode ?? "";
+    this.agentName = options.agentName ?? "";
+    this.apiUrl = options.apiUrl ?? "";
+    this.environmentType = options.environmentType ?? "";
     this.env = options.env ?? {};
   }
   /**
@@ -1428,28 +1413,13 @@ var AgentDriver = class extends events.EventEmitter {
     return new Promise((resolve, reject) => {
       this.resolveStart = resolve;
       this.rejectStart = reject;
-      if (this.binaryPath) {
-        this.process = child_process.spawn(this.binaryPath, [], {
-          stdio: ["pipe", "pipe", "pipe"],
-          env: {
-            ...process.env,
-            ...this.env
-          }
-        });
-      } else if (this.pythonFallback) {
-        this.process = child_process.spawn(this.pythonFallback.command, this.pythonFallback.args, {
-          stdio: ["pipe", "pipe", "pipe"],
-          env: {
-            ...process.env,
-            ...this.env,
-            PYTHONPATH: process.env.AGI_DRIVER_PATH ? `${process.env.AGI_DRIVER_PATH}/..` : ""
-          },
-          cwd: process.env.AGI_DRIVER_PATH ? `${process.env.AGI_DRIVER_PATH}/..` : void 0
-        });
-      } else {
-        reject(new Error("No binary or Python fallback available"));
-        return;
-      }
+      this.process = child_process.spawn(this.binaryPath, [], {
+        stdio: ["pipe", "pipe", "pipe"],
+        env: {
+          ...process.env,
+          ...this.env
+        }
+      });
       this.process.on("error", (err) => {
         this.cleanup();
         if (this.rejectStart) {
@@ -1494,7 +1464,10 @@ var AgentDriver = class extends events.EventEmitter {
           screen_height: screenHeight,
           platform: this.platform,
           model: this.model,
-          mode: mode ?? this.mode
+          mode: mode ?? this.mode,
+          agent_name: this.agentName || void 0,
+          api_url: this.apiUrl || void 0,
+          environment_type: this.environmentType || void 0
         };
         this.sendCommand(startCmd);
       });
@@ -1667,6 +1640,9 @@ var AgentDriver = class extends events.EventEmitter {
       case "screenshot_captured":
         this.emit("screenshot_captured", event);
         break;
+      case "session_created":
+        this.emit("session_created", event);
+        break;
       case "finished":
         this.handleFinished(event);
         break;