glitch-javascript-sdk 3.2.1 → 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.
      */
@@ -9176,10 +9200,27 @@ declare class Agents {
      * AI dollars spent vs the configured monthly AI budget). Powers usage meters and limit warnings.
      */
     static usage<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get the prepaid agent credit balance and ledger (Pay-As-You-Go plan).
+     */
+    static credits<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Buy prepaid agent credits (Pay-As-You-Go). Charges the card up front; the agent draws down
+     * credits per run and stops when they run out. data: { paymentMethod, amount_usd }.
+     */
+    static purchaseCredits<T>(title_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
     /**
      * Start a Stripe-backed agent trial/subscription after setup.
      */
     static startTrial<T>(title_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Cross-title agency cockpit: per-title agent status, billing/credits, and portfolio totals.
+     */
+    static agencyOverview<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Unified cross-title "needs you" inbox (open guidance + pending approvals across all titles).
+     */
+    static agencyInbox<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
 }
 
 interface Route {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glitch-javascript-sdk",
-  "version": "3.2.1",
+  "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.
    */
@@ -138,12 +198,41 @@ class Agents {
     return Requests.processRoute(AgentsRoute.routes.usage, {}, { title_id }, params);
   }
 
+  /**
+   * Get the prepaid agent credit balance and ledger (Pay-As-You-Go plan).
+   */
+  public static credits<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.credits, {}, { title_id }, params);
+  }
+
+  /**
+   * Buy prepaid agent credits (Pay-As-You-Go). Charges the card up front; the agent draws down
+   * credits per run and stops when they run out. data: { paymentMethod, amount_usd }.
+   */
+  public static purchaseCredits<T>(title_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.purchaseCredits, data, { title_id }, params);
+  }
+
   /**
    * Start a Stripe-backed agent trial/subscription after setup.
    */
   public static startTrial<T>(title_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
     return Requests.processRoute(AgentsRoute.routes.startTrial, data, { title_id }, params);
   }
+
+  /**
+   * Cross-title agency cockpit: per-title agent status, billing/credits, and portfolio totals.
+   */
+  public static agencyOverview<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.agencyOverview, {}, {}, params);
+  }
+
+  /**
+   * Unified cross-title "needs you" inbox (open guidance + pending approvals across all titles).
+   */
+  public static agencyInbox<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.agencyInbox, {}, {}, params);
+  }
 }
 
 export default Agents;

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 },
@@ -22,7 +27,11 @@ class AgentsRoute {
     listMemories: { url: "/agents/titles/{title_id}/memories", method: HTTP_METHODS.GET },
     results: { url: "/agents/titles/{title_id}/results", method: HTTP_METHODS.GET },
     usage: { url: "/agents/titles/{title_id}/usage", method: HTTP_METHODS.GET },
+    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 },
+    agencyOverview: { url: "/agents/agency/overview", method: HTTP_METHODS.GET },
+    agencyInbox: { url: "/agents/agency/inbox", method: HTTP_METHODS.GET },
   };
 }