glitch-javascript-sdk 3.2.2 → 3.2.4

package/dist/index.d.ts

@@ -9135,10 +9135,39 @@ 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>>;
+    /**
+     * Mark a queued or running agent run as being watched live so the UI can stream the loop
+     * and the backend can avoid sending delayed background summaries to active viewers.
+     */
+    static heartbeatRun<T>(title_id: string, run_id: string, data?: object, 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.
      */
@@ -9189,6 +9218,14 @@ declare class Agents {
      * Start a Stripe-backed agent trial/subscription after setup.
      */
     static startTrial<T>(title_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * List social/ad schedulers. Useful when agent setup needs to attach to an existing workflow.
+     */
+    static listSchedulers<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Create a scheduler inline from an agent setup flow.
+     */
+    static createScheduler<T>(data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
     /**
      * Cross-title agency cockpit: per-title agent status, billing/credits, and portfolio totals.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glitch-javascript-sdk",
-  "version": "3.2.2",
+  "version": "3.2.4",
   "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,42 @@ 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);
+  }
+
+  /**
+   * Mark a queued or running agent run as being watched live so the UI can stream the loop
+   * and the backend can avoid sending delayed background summaries to active viewers.
+   */
+  public static heartbeatRun<T>(title_id: string, run_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.heartbeatRun, data || {}, { 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.
    */
@@ -160,6 +228,20 @@ class Agents {
     return Requests.processRoute(AgentsRoute.routes.startTrial, data, { title_id }, params);
   }
 
+  /**
+   * List social/ad schedulers. Useful when agent setup needs to attach to an existing workflow.
+   */
+  public static listSchedulers<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.listSchedulers, {}, {}, params);
+  }
+
+  /**
+   * Create a scheduler inline from an agent setup flow.
+   */
+  public static createScheduler<T>(data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.createScheduler, data || {}, {}, params);
+  }
+
   /**
    * Cross-title agency cockpit: per-title agent status, billing/credits, and portfolio totals.
    */

package/src/routes/AgentsRoute.ts

@@ -12,7 +12,13 @@ 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 },
+    heartbeatRun: { url: "/agents/titles/{title_id}/runs/{run_id}/heartbeat", method: HTTP_METHODS.POST },
+    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 },
@@ -25,6 +31,8 @@ class AgentsRoute {
     credits: { url: "/agents/titles/{title_id}/credits", method: HTTP_METHODS.GET },
     purchaseCredits: { url: "/agents/titles/{title_id}/credits/purchase", method: HTTP_METHODS.POST },
     startTrial: { url: "/agents/titles/{title_id}/subscription/trial", method: HTTP_METHODS.POST },
+    listSchedulers: { url: "/schedulers", method: HTTP_METHODS.GET },
+    createScheduler: { url: "/schedulers", method: HTTP_METHODS.POST },
     agencyOverview: { url: "/agents/agency/overview", method: HTTP_METHODS.GET },
     agencyInbox: { url: "/agents/agency/inbox", method: HTTP_METHODS.GET },
   };