glitch-javascript-sdk 3.1.6 → 3.2.1

package/dist/esm/routes/AgentsRoute.d.ts

@@ -0,0 +1,7 @@
+import Route from "./interface";
+declare class AgentsRoute {
+    static routes: {
+        [key: string]: Route;
+    };
+}
+export default AgentsRoute;

package/dist/index.d.ts

@@ -9098,6 +9098,90 @@ declare class ServerOperations {
     static updatePolicy<T>(title_id: string, build_id: string, data: object): AxiosPromise<Response<T>>;
 }
 
+declare class Agents {
+    /**
+     * List game titles that can be managed in the Agents section.
+     */
+    static listTitles<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Return the full Laravel API route catalog agents use for route-aware planning.
+     */
+    static routeCatalog<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get a title-scoped agent workspace with setup, billing, counts, and route summary.
+     */
+    static workspace<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * List agents for a title.
+     */
+    static listAgents<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Create an agent before payment. Runs/results remain gated until trial/subscription.
+     */
+    static createAgent<T>(title_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * View one agent.
+     */
+    static viewAgent<T>(title_id: string, agent_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Update an agent's setup, policies, and guidance stop rules.
+     */
+    static updateAgent<T>(title_id: string, agent_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Archive an agent.
+     */
+    static deleteAgent<T>(title_id: string, agent_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * 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>>;
+    /**
+     * List agent runs for a title.
+     */
+    static listRuns<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * List agent actions/approval queue for a title.
+     */
+    static listActions<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Approve an agent action.
+     */
+    static approveAction<T>(title_id: string, action_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Reject an agent action.
+     */
+    static rejectAction<T>(title_id: string, action_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Execute an approved safe action.
+     */
+    static executeAction<T>(title_id: string, action_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * List guidance requests where agents have stopped for developer direction.
+     */
+    static listGuidance<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Answer a guidance request and write structured agent memory.
+     */
+    static answerGuidance<T>(title_id: string, guidance_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * List structured agent memories for a title.
+     */
+    static listMemories<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get results and outcome summary for title agents. Returns 402 until trial/subscription is active.
+     */
+    static results<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get this title's agent usage against plan limits (agents used/included, monthly runs, and
+     * 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>>;
+    /**
+     * Start a Stripe-backed agent trial/subscription after setup.
+     */
+    static startTrial<T>(title_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+}
+
 interface Route {
     url: string;
     method: string;
@@ -9453,6 +9537,7 @@ declare class Glitch {
         Crm: typeof Crm;
         Multiplayer: typeof Multiplayer;
         ServerOperations: typeof ServerOperations;
+        Agents: typeof Agents;
     };
     static util: {
         Requests: typeof Requests;

package/package.json

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

package/src/api/Agents.ts

@@ -0,0 +1,149 @@
+import AgentsRoute from "../routes/AgentsRoute";
+import Requests from "../util/Requests";
+import Response from "../util/Response";
+import { AxiosPromise } from "axios";
+
+class Agents {
+  /**
+   * List game titles that can be managed in the Agents section.
+   */
+  public static listTitles<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.listTitles, {}, {}, params);
+  }
+
+  /**
+   * Return the full Laravel API route catalog agents use for route-aware planning.
+   */
+  public static routeCatalog<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.routeCatalog, {}, {}, params);
+  }
+
+  /**
+   * Get a title-scoped agent workspace with setup, billing, counts, and route summary.
+   */
+  public static workspace<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.workspace, {}, { title_id }, params);
+  }
+
+  /**
+   * List agents for a title.
+   */
+  public static listAgents<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.listAgents, {}, { title_id }, params);
+  }
+
+  /**
+   * Create an agent before payment. Runs/results remain gated until trial/subscription.
+   */
+  public static createAgent<T>(title_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.createAgent, data, { title_id }, params);
+  }
+
+  /**
+   * View one agent.
+   */
+  public static viewAgent<T>(title_id: string, agent_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.viewAgent, {}, { title_id, agent_id }, params);
+  }
+
+  /**
+   * Update an agent's setup, policies, and guidance stop rules.
+   */
+  public static updateAgent<T>(title_id: string, agent_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.updateAgent, data, { title_id, agent_id }, params);
+  }
+
+  /**
+   * Archive an agent.
+   */
+  public static deleteAgent<T>(title_id: string, agent_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.deleteAgent, {}, { title_id, agent_id }, params);
+  }
+
+  /**
+   * Run an agent planning cycle. Returns 402 when trial/subscription is required.
+   */
+  public static runAgent<T>(title_id: string, agent_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.runAgent, data, { title_id, agent_id }, params);
+  }
+
+  /**
+   * List agent runs for a title.
+   */
+  public static listRuns<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.listRuns, {}, { title_id }, params);
+  }
+
+  /**
+   * List agent actions/approval queue for a title.
+   */
+  public static listActions<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.listActions, {}, { title_id }, params);
+  }
+
+  /**
+   * Approve an agent action.
+   */
+  public static approveAction<T>(title_id: string, action_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.approveAction, data || {}, { title_id, action_id }, params);
+  }
+
+  /**
+   * Reject an agent action.
+   */
+  public static rejectAction<T>(title_id: string, action_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.rejectAction, data || {}, { title_id, action_id }, params);
+  }
+
+  /**
+   * Execute an approved safe action.
+   */
+  public static executeAction<T>(title_id: string, action_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.executeAction, data || {}, { title_id, action_id }, params);
+  }
+
+  /**
+   * List guidance requests where agents have stopped for developer direction.
+   */
+  public static listGuidance<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.listGuidance, {}, { title_id }, params);
+  }
+
+  /**
+   * Answer a guidance request and write structured agent memory.
+   */
+  public static answerGuidance<T>(title_id: string, guidance_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.answerGuidance, data, { title_id, guidance_id }, params);
+  }
+
+  /**
+   * List structured agent memories for a title.
+   */
+  public static listMemories<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.listMemories, {}, { title_id }, params);
+  }
+
+  /**
+   * Get results and outcome summary for title agents. Returns 402 until trial/subscription is active.
+   */
+  public static results<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.results, {}, { title_id }, params);
+  }
+
+  /**
+   * Get this title's agent usage against plan limits (agents used/included, monthly runs, and
+   * AI dollars spent vs the configured monthly AI budget). Powers usage meters and limit warnings.
+   */
+  public static usage<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.usage, {}, { 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);
+  }
+}
+
+export default Agents;

package/src/api/index.ts

@@ -45,6 +45,7 @@ import Education from "./Education";
 import Crm from "./Crm";
 import Multiplayer from "./Multiplayer";
 import ServerOperations from "./ServerOperations";
+import Agents from "./Agents";
 
 export {Ads};
 export {AccessKeys};
@@ -93,3 +94,4 @@ export {Education};
 export {Crm};
 export {Multiplayer};
 export {ServerOperations};
+export {Agents};

package/src/index.ts

@@ -49,6 +49,7 @@ import {Education} from './api';
 import {Crm} from './api';
 import {Multiplayer} from './api';
 import {ServerOperations} from './api';
+import {Agents} from './api';
 
 import Requests from "./util/Requests";
 import Parser from "./util/Parser";
@@ -127,6 +128,7 @@ class Glitch {
         Crm : Crm,
         Multiplayer : Multiplayer,
         ServerOperations : ServerOperations,
+        Agents : Agents,
     }
 
     public static util = {

package/src/routes/AgentsRoute.ts

@@ -0,0 +1,29 @@
+import Route from "./interface";
+import HTTP_METHODS from "../constants/HttpMethods";
+
+class AgentsRoute {
+  public static routes: { [key: string]: Route } = {
+    listTitles: { url: "/agents/titles", method: HTTP_METHODS.GET },
+    routeCatalog: { url: "/agents/routes/catalog", method: HTTP_METHODS.GET },
+    workspace: { url: "/agents/titles/{title_id}/workspace", method: HTTP_METHODS.GET },
+    listAgents: { url: "/agents/titles/{title_id}/agents", method: HTTP_METHODS.GET },
+    createAgent: { url: "/agents/titles/{title_id}/agents", method: HTTP_METHODS.POST },
+    viewAgent: { url: "/agents/titles/{title_id}/agents/{agent_id}", method: HTTP_METHODS.GET },
+    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 },
+    listRuns: { url: "/agents/titles/{title_id}/runs", method: HTTP_METHODS.GET },
+    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 },
+    executeAction: { url: "/agents/titles/{title_id}/actions/{action_id}/execute", method: HTTP_METHODS.POST },
+    listGuidance: { url: "/agents/titles/{title_id}/guidance", method: HTTP_METHODS.GET },
+    answerGuidance: { url: "/agents/titles/{title_id}/guidance/{guidance_id}/answer", method: HTTP_METHODS.POST },
+    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 },
+    startTrial: { url: "/agents/titles/{title_id}/subscription/trial", method: HTTP_METHODS.POST },
+  };
+}
+
+export default AgentsRoute;