glitch-javascript-sdk 3.3.4 → 3.3.6

package/dist/index.d.ts

@@ -5200,6 +5200,14 @@ declare class Campaigns {
      * @returns promise
      */
     static sendInfluencerInvite<T>(campaign_id: string, data: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get creator context used when preparing a personalized invite.
+     */
+    static creatorInviteContext<T>(campaign_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Send a personalized creator invite after review.
+     */
+    static sendCreatorInvite<T>(campaign_id: string, data: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
     /**
      * Invites an influencer to join this campaign.
      *
@@ -9915,7 +9923,20 @@ interface AgentRunRequest {
     agent_run_id?: string | null;
     [key: string]: any;
 }
+interface AgentStreamAnswerRequest {
+    prompt: string;
+    [key: string]: any;
+}
+interface AgentFetchOptions {
+    params?: Record<string, any>;
+    signal?: AbortSignal;
+    headers?: Record<string, string>;
+    fetcher?: typeof fetch;
+}
+interface AgentStreamAnswerOptions extends AgentFetchOptions {
+}
 declare class Agents {
+    private static fetchWithAuth;
     /**
      * List game titles that can be managed in the Agents section.
      */
@@ -9960,6 +9981,15 @@ declare class Agents {
      * Run an agent planning cycle. Returns 402 when subscription or prepaid credits are required.
      */
     static runAgent<T>(title_id: string, agent_id: string, data?: AgentRunRequest, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Stream a quick advisory answer for the agent workspace.
+     *
+     * This returns the native Fetch API Response so callers can consume the
+     * ReadableStream body incrementally. A 409 response means streaming is
+     * disabled server-side and the caller should fall back to the normal run
+     * flow.
+     */
+    static streamAnswer(title_id: string, agent_id: string, data: AgentStreamAnswerRequest | string, options?: AgentStreamAnswerOptions): Promise<globalThis.Response>;
     /**
      * Upload one file for an agent run. data can include { agent_run_id }.
      */
@@ -9968,6 +9998,25 @@ declare class Agents {
      * 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 Google Drive files/folders available to attach to a title agent.
+     */
+    static listGoogleDriveFiles<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Attach a Google Drive file as a reference file for an agent.
+     */
+    static attachGoogleDriveFile<T>(title_id: string, agent_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Download a protected agent file through the authenticated API route.
+     *
+     * Returns the native Fetch API Response so callers can inspect headers such
+     * as Content-Disposition before creating a browser download or preview blob.
+     */
+    static downloadAgentFile(title_id: string, file_id: string, options?: AgentFetchOptions): Promise<globalThis.Response>;
+    /**
+     * Export a generated agent artifact to Google Drive.
+     */
+    static exportAgentFileToGoogleDrive<T>(title_id: string, file_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
     /**
      * List agent runs for a title.
      */
@@ -10021,10 +10070,41 @@ declare class Agents {
      * Rewrite an editable agent draft for review without executing the parent action.
      */
     static rewriteAgentDraft<T>(title_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Agent workflow convenience wrapper for creator invite context.
+     */
+    static creatorInviteContext<T>(campaign_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Agent workflow convenience wrapper for sending a reviewed creator invite.
+     */
+    static sendCreatorInvite<T>(campaign_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Agent workflow convenience wrapper for updating a drafted social post.
+     */
+    static updateSocialPost<T>(post_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Agent workflow convenience wrapper for updating campaign settings.
+     */
+    static updateCampaign<T>(campaign_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Agent workflow convenience wrapper for saving manual access keys.
+     */
+    static createAccessKeys<T>(title_id: string, data: {
+        platform: string;
+        codes: string;
+    }, 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>>;
+    /**
+     * Update one structured agent memory.
+     */
+    static updateMemory<T>(title_id: string, memory_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Deactivate one structured agent memory.
+     */
+    static deactivateMemory<T>(title_id: string, memory_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
     /**
      * Get results and outcome summary for title agents. Returns 402 until subscription or prepaid credits are active.
      */
@@ -10830,6 +10910,17 @@ declare class AdminUsers {
      * @returns promise
      */
     static list<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Retrieve aggregated user analytics for the admin directory.
+     *
+     * Supported params include `search`, `is_site_admin`, `is_verified`,
+     * `user_type`, `start_date`, `end_date`, `period`, `sort_by`, and
+     * `sort_order`.
+     *
+     * @param params Optional query parameters.
+     * @returns promise
+     */
+    static analytics<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
     /**
      * Retrieve a comprehensive profile for a single user, including communities,
      * administered titles, games played, roles, billing status, social presence,

package/package.json

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

package/src/api/AdminUsers.ts

@@ -25,6 +25,20 @@ class AdminUsers {
         return Requests.processRoute(AdminUsersRoute.routes.list, undefined, undefined, params);
     }
 
+    /**
+     * Retrieve aggregated user analytics for the admin directory.
+     *
+     * Supported params include `search`, `is_site_admin`, `is_verified`,
+     * `user_type`, `start_date`, `end_date`, `period`, `sort_by`, and
+     * `sort_order`.
+     *
+     * @param params Optional query parameters.
+     * @returns promise
+     */
+    public static analytics<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(AdminUsersRoute.routes.analytics, undefined, undefined, params);
+    }
+
     /**
      * Retrieve a comprehensive profile for a single user, including communities,
      * administered titles, games played, roles, billing status, social presence,

package/src/api/Agents.ts

@@ -1,6 +1,10 @@
 import AgentsRoute from "../routes/AgentsRoute";
+import AccessKeys from "./AccessKeys";
+import Campaigns from "./Campaigns";
+import Config from "../config/Config";
 import Requests from "../util/Requests";
 import Response from "../util/Response";
+import SocialPosts from "./SocialPosts";
 import { AxiosPromise, AxiosProgressEvent } from "axios";
 
 export interface AgentRunRequest {
@@ -15,7 +19,51 @@ export interface AgentRunRequest {
   [key: string]: any;
 }
 
+export interface AgentStreamAnswerRequest {
+  prompt: string;
+  [key: string]: any;
+}
+
+export interface AgentFetchOptions {
+  params?: Record<string, any>;
+  signal?: AbortSignal;
+  headers?: Record<string, string>;
+  fetcher?: typeof fetch;
+}
+
+export interface AgentStreamAnswerOptions extends AgentFetchOptions {}
+
 class Agents {
+  private static fetchWithAuth(
+    path: string,
+    init: RequestInit,
+    options: AgentFetchOptions = {}
+  ): Promise<globalThis.Response> {
+    const url = Requests.buildUrl(path, options.params);
+    const token = Config.getAuthToken?.();
+    const headers: Record<string, string> = {
+      ...((init.headers || {}) as Record<string, string>),
+    };
+
+    if (token && !headers.Authorization) {
+      headers.Authorization = `Bearer ${token}`;
+    }
+
+    Object.assign(headers, options.headers || {});
+
+    const fetcher = options.fetcher || (typeof globalThis !== "undefined" ? globalThis.fetch : undefined);
+
+    if (!fetcher) {
+      return Promise.reject(new Error("Fetch API is not available in this environment."));
+    }
+
+    return fetcher(url, {
+      ...init,
+      headers,
+      signal: options.signal,
+    });
+  }
+
   /**
    * List game titles that can be managed in the Agents section.
    */
@@ -93,6 +141,35 @@ class Agents {
     return Requests.processRoute(AgentsRoute.routes.runAgent, data, { title_id, agent_id }, params);
   }
 
+  /**
+   * Stream a quick advisory answer for the agent workspace.
+   *
+   * This returns the native Fetch API Response so callers can consume the
+   * ReadableStream body incrementally. A 409 response means streaming is
+   * disabled server-side and the caller should fall back to the normal run
+   * flow.
+   */
+  public static streamAnswer(
+    title_id: string,
+    agent_id: string,
+    data: AgentStreamAnswerRequest | string,
+    options: AgentStreamAnswerOptions = {}
+  ): Promise<globalThis.Response> {
+    const body = typeof data === "string" ? { prompt: data } : data;
+    const path = AgentsRoute.routes.streamAnswer.url
+      .replace("{title_id}", title_id)
+      .replace("{agent_id}", agent_id);
+
+    return Agents.fetchWithAuth(path, {
+      method: AgentsRoute.routes.streamAnswer.method,
+      headers: {
+        "Content-Type": "application/json",
+        Accept: "text/event-stream",
+      },
+      body: JSON.stringify(body),
+    }, options);
+  }
+
   /**
    * Upload one file for an agent run. data can include { agent_run_id }.
    */
@@ -125,6 +202,50 @@ class Agents {
     return Agents.uploadAgentFile(title_id, agent_id, file, data, params, onUploadProgress);
   }
 
+  /**
+   * List Google Drive files/folders available to attach to a title agent.
+   */
+  public static listGoogleDriveFiles<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.listGoogleDriveFiles, {}, { title_id }, params);
+  }
+
+  /**
+   * Attach a Google Drive file as a reference file for an agent.
+   */
+  public static attachGoogleDriveFile<T>(title_id: string, agent_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.attachGoogleDriveFile, data || {}, { title_id, agent_id }, params);
+  }
+
+  /**
+   * Download a protected agent file through the authenticated API route.
+   *
+   * Returns the native Fetch API Response so callers can inspect headers such
+   * as Content-Disposition before creating a browser download or preview blob.
+   */
+  public static downloadAgentFile(
+    title_id: string,
+    file_id: string,
+    options: AgentFetchOptions = {}
+  ): Promise<globalThis.Response> {
+    const path = AgentsRoute.routes.downloadAgentFile.url
+      .replace("{title_id}", title_id)
+      .replace("{file_id}", file_id);
+
+    return Agents.fetchWithAuth(path, {
+      method: AgentsRoute.routes.downloadAgentFile.method,
+      headers: {
+        Accept: "application/octet-stream",
+      },
+    }, options);
+  }
+
+  /**
+   * Export a generated agent artifact to Google Drive.
+   */
+  public static exportAgentFileToGoogleDrive<T>(title_id: string, file_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.exportAgentFileToGoogleDrive, data || {}, { title_id, file_id }, params);
+  }
+
   /**
    * List agent runs for a title.
    */
@@ -217,6 +338,41 @@ class Agents {
     return Requests.processRoute(AgentsRoute.routes.rewriteAgentDraft, data, { title_id }, params);
   }
 
+  /**
+   * Agent workflow convenience wrapper for creator invite context.
+   */
+  public static creatorInviteContext<T>(campaign_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Campaigns.creatorInviteContext<T>(campaign_id, params);
+  }
+
+  /**
+   * Agent workflow convenience wrapper for sending a reviewed creator invite.
+   */
+  public static sendCreatorInvite<T>(campaign_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Campaigns.sendCreatorInvite<T>(campaign_id, data || {}, params);
+  }
+
+  /**
+   * Agent workflow convenience wrapper for updating a drafted social post.
+   */
+  public static updateSocialPost<T>(post_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return SocialPosts.update<T>(post_id, data || {}, params);
+  }
+
+  /**
+   * Agent workflow convenience wrapper for updating campaign settings.
+   */
+  public static updateCampaign<T>(campaign_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Campaigns.update<T>(campaign_id, data || {}, params);
+  }
+
+  /**
+   * Agent workflow convenience wrapper for saving manual access keys.
+   */
+  public static createAccessKeys<T>(title_id: string, data: { platform: string, codes: string }, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return AccessKeys.store<T>(title_id, data, params);
+  }
+
   /**
    * List structured agent memories for a title.
    */
@@ -224,6 +380,20 @@ class Agents {
     return Requests.processRoute(AgentsRoute.routes.listMemories, {}, { title_id }, params);
   }
 
+  /**
+   * Update one structured agent memory.
+   */
+  public static updateMemory<T>(title_id: string, memory_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.updateMemory, data || {}, { title_id, memory_id }, params);
+  }
+
+  /**
+   * Deactivate one structured agent memory.
+   */
+  public static deactivateMemory<T>(title_id: string, memory_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.deactivateMemory, {}, { title_id, memory_id }, params);
+  }
+
   /**
    * Get results and outcome summary for title agents. Returns 402 until subscription or prepaid credits are active.
    */

package/src/api/Campaigns.ts

@@ -560,6 +560,20 @@ class Campaigns {
         return Requests.processRoute(CampaignsRoute.routes.sendInfluencerInvite, data, { campaign_id: campaign_id }, params);
     }
 
+    /**
+     * Get creator context used when preparing a personalized invite.
+     */
+    public static creatorInviteContext<T>(campaign_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(CampaignsRoute.routes.influencerInviteProfileContext, {}, { campaign_id: campaign_id }, params);
+    }
+
+    /**
+     * Send a personalized creator invite after review.
+     */
+    public static sendCreatorInvite<T>(campaign_id: string, data: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(CampaignsRoute.routes.influencerInviteProfileSend, data, { campaign_id: campaign_id }, params);
+    }
+
     /**
      * Invites an influencer to join this campaign.
      * 

package/src/routes/AdminUsersRoute.ts

@@ -8,6 +8,11 @@ class AdminUsersRoute {
       url: '/admin/users',
       method: HTTP_METHODS.GET
     },
+    // Aggregated user analytics for charts on the admin directory.
+    analytics: {
+      url: '/admin/users/analytics',
+      method: HTTP_METHODS.GET
+    },
     // Full profile for a single user (site admin only).
     view: {
       url: '/admin/users/{user_id}',

package/src/routes/AgentsRoute.ts

@@ -14,7 +14,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 },
+    streamAnswer: { url: "/agents/titles/{title_id}/agents/{agent_id}/stream-answer", method: HTTP_METHODS.POST },
     uploadAgentFiles: { url: "/agents/titles/{title_id}/agents/{agent_id}/files", method: HTTP_METHODS.POST },
+    listGoogleDriveFiles: { url: "/agents/titles/{title_id}/gmail/drive/files", method: HTTP_METHODS.GET },
+    attachGoogleDriveFile: { url: "/agents/titles/{title_id}/agents/{agent_id}/drive/files", method: HTTP_METHODS.POST },
+    downloadAgentFile: { url: "/agents/titles/{title_id}/files/{file_id}/download", method: HTTP_METHODS.GET },
+    exportAgentFileToGoogleDrive: { url: "/agents/titles/{title_id}/files/{file_id}/export/google-drive", 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 },
@@ -29,6 +34,8 @@ class AgentsRoute {
     answerGuidance: { url: "/agents/titles/{title_id}/guidance/{guidance_id}/answer", method: HTTP_METHODS.POST },
     rewriteAgentDraft: { url: "/agents/titles/{title_id}/drafts/rewrite", method: HTTP_METHODS.POST },
     listMemories: { url: "/agents/titles/{title_id}/memories", method: HTTP_METHODS.GET },
+    updateMemory: { url: "/agents/titles/{title_id}/memories/{memory_id}", method: HTTP_METHODS.PATCH },
+    deactivateMemory: { url: "/agents/titles/{title_id}/memories/{memory_id}", method: HTTP_METHODS.DELETE },
     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 },

package/src/routes/CampaignsRoute.ts

@@ -45,6 +45,8 @@ class CampaignsRoute {
     addType: { url: '/campaigns/{campaign_id}/addType', method: HTTP_METHODS.POST },
     removeType: { url: '/campaigns/{campaign_id}/removeType/{type_id}', method: HTTP_METHODS.DELETE },
     inviteInfluencer: { url: '/campaigns/{campaign_id}/influencers/invites', method: HTTP_METHODS.POST },
+    influencerInviteProfileContext: { url: '/campaigns/{campaign_id}/influencers/invites/profile-context', method: HTTP_METHODS.GET },
+    influencerInviteProfileSend: { url: '/campaigns/{campaign_id}/influencers/invites/profile-send', method: HTTP_METHODS.POST },
     viewInfluencerInvite: { url: '/campaigns/{campaign_id}/influencers/invites/{influencer_id}', method: HTTP_METHODS.GET },
     updateInfluencerInvite: { url: '/campaigns/{campaign_id}/influencers/invites/{influencer_id}', method: HTTP_METHODS.PUT },
     updateInfluencerCompensationInvite: { url: '/campaigns/{campaign_id}/influencers/invites/{influencer_id}/compensation', method: HTTP_METHODS.PUT },