glitch-javascript-sdk 3.2.2 → 3.2.3

package/dist/index.d.ts

@@ -9135,10 +9135,34 @@ declare class Agents {
      * Run an agent planning cycle. Returns 402 when trial/subscription is required.
      */
     static runAgent<T>(title_id: string, agent_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Upload one file for an agent run. data can include { agent_run_id }.
+     */
+    static uploadAgentFile<T>(title_id: string, agent_id: string, file: File | Blob, data?: object, params?: Record<string, any>, onUploadProgress?: (progressEvent: AxiosProgressEvent) => void): AxiosPromise<Response<T>>;
+    /**
+     * Alias for callers that use plural naming while uploading one file at a time.
+     */
+    static uploadAgentFiles<T>(title_id: string, agent_id: string, file: File | Blob, data?: object, params?: Record<string, any>, onUploadProgress?: (progressEvent: AxiosProgressEvent) => void): AxiosPromise<Response<T>>;
     /**
      * List agent runs for a title.
      */
     static listRuns<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * View one durable agent run, including events, files, actions, and guidance when loaded by the API.
+     */
+    static viewRun<T>(title_id: string, run_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * List real-time user-visible events for an agent run.
+     */
+    static listRunEvents<T>(title_id: string, run_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Request cancellation for a queued or running agent run.
+     */
+    static cancelRun<T>(title_id: string, run_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Send a course correction to a queued or running agent run.
+     */
+    static interjectRun<T>(title_id: string, run_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
     /**
      * List agent actions/approval queue for a title.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glitch-javascript-sdk",
-  "version": "3.2.2",
+  "version": "3.2.3",
   "description": "Javascript SDK for Glitch",
   "publishConfig": {
     "access": "public"

package/src/api/Agents.ts

@@ -1,7 +1,7 @@
 import AgentsRoute from "../routes/AgentsRoute";
 import Requests from "../util/Requests";
 import Response from "../util/Response";
-import { AxiosPromise } from "axios";
+import { AxiosPromise, AxiosProgressEvent } from "axios";
 
 class Agents {
   /**
@@ -67,6 +67,38 @@ class Agents {
     return Requests.processRoute(AgentsRoute.routes.runAgent, data, { title_id, agent_id }, params);
   }
 
+  /**
+   * Upload one file for an agent run. data can include { agent_run_id }.
+   */
+  public static uploadAgentFile<T>(
+    title_id: string,
+    agent_id: string,
+    file: File | Blob,
+    data?: object,
+    params?: Record<string, any>,
+    onUploadProgress?: (progressEvent: AxiosProgressEvent) => void
+  ): AxiosPromise<Response<T>> {
+    const url = AgentsRoute.routes.uploadAgentFiles.url
+      .replace("{title_id}", title_id)
+      .replace("{agent_id}", agent_id);
+
+    return Requests.uploadFile(url, "file", file, data, params, onUploadProgress);
+  }
+
+  /**
+   * Alias for callers that use plural naming while uploading one file at a time.
+   */
+  public static uploadAgentFiles<T>(
+    title_id: string,
+    agent_id: string,
+    file: File | Blob,
+    data?: object,
+    params?: Record<string, any>,
+    onUploadProgress?: (progressEvent: AxiosProgressEvent) => void
+  ): AxiosPromise<Response<T>> {
+    return Agents.uploadAgentFile(title_id, agent_id, file, data, params, onUploadProgress);
+  }
+
   /**
    * List agent runs for a title.
    */
@@ -74,6 +106,34 @@ class Agents {
     return Requests.processRoute(AgentsRoute.routes.listRuns, {}, { title_id }, params);
   }
 
+  /**
+   * View one durable agent run, including events, files, actions, and guidance when loaded by the API.
+   */
+  public static viewRun<T>(title_id: string, run_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.viewRun, {}, { title_id, run_id }, params);
+  }
+
+  /**
+   * List real-time user-visible events for an agent run.
+   */
+  public static listRunEvents<T>(title_id: string, run_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.listRunEvents, {}, { title_id, run_id }, params);
+  }
+
+  /**
+   * Request cancellation for a queued or running agent run.
+   */
+  public static cancelRun<T>(title_id: string, run_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.cancelRun, data || {}, { title_id, run_id }, params);
+  }
+
+  /**
+   * Send a course correction to a queued or running agent run.
+   */
+  public static interjectRun<T>(title_id: string, run_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.interjectRun, data || {}, { title_id, run_id }, params);
+  }
+
   /**
    * List agent actions/approval queue for a title.
    */

package/src/routes/AgentsRoute.ts

@@ -12,7 +12,12 @@ class AgentsRoute {
     updateAgent: { url: "/agents/titles/{title_id}/agents/{agent_id}", method: HTTP_METHODS.PUT },
     deleteAgent: { url: "/agents/titles/{title_id}/agents/{agent_id}", method: HTTP_METHODS.DELETE },
     runAgent: { url: "/agents/titles/{title_id}/agents/{agent_id}/run", method: HTTP_METHODS.POST },
+    uploadAgentFiles: { url: "/agents/titles/{title_id}/agents/{agent_id}/files", method: HTTP_METHODS.POST },
     listRuns: { url: "/agents/titles/{title_id}/runs", method: HTTP_METHODS.GET },
+    viewRun: { url: "/agents/titles/{title_id}/runs/{run_id}", method: HTTP_METHODS.GET },
+    listRunEvents: { url: "/agents/titles/{title_id}/runs/{run_id}/events", method: HTTP_METHODS.GET },
+    cancelRun: { url: "/agents/titles/{title_id}/runs/{run_id}/cancel", method: HTTP_METHODS.POST },
+    interjectRun: { url: "/agents/titles/{title_id}/runs/{run_id}/interject", method: HTTP_METHODS.POST },
     listActions: { url: "/agents/titles/{title_id}/actions", method: HTTP_METHODS.GET },
     approveAction: { url: "/agents/titles/{title_id}/actions/{action_id}/approve", method: HTTP_METHODS.POST },
     rejectAction: { url: "/agents/titles/{title_id}/actions/{action_id}/reject", method: HTTP_METHODS.POST },