glitch-javascript-sdk 3.2.9 → 3.2.12

package/dist/esm/models/user.d.ts

@@ -23,6 +23,16 @@ interface User {
     twitch_handle?: string;
     youtube_handle?: string;
     paetron_handle?: string;
+    gmail_oauth_token?: string;
+    gmail_refresh_token?: string;
+    gmail_token_expiration?: number;
+    gmail_token_expires_at?: string;
+    gmail_id?: string;
+    gmail_name?: string;
+    gmail_email?: string;
+    gmail_avatar?: string;
+    gmail_scopes?: string[];
+    gmail_connected_at?: string;
     created_at?: string;
     updated_at?: string;
 }

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

@@ -0,0 +1,15 @@
+import Route from "./interface";
+/**
+ * Glitch MCP paid facade (/mcp/v1).
+ *
+ * Mirrors the routes served by McpAgentController. These endpoints authenticate
+ * with either a Glitch user JWT or a title-scoped MCP token and keep all planner,
+ * billing, and executor logic server-side. The public @glitch/mcp adapter calls
+ * the same endpoints; this SDK surface lets first-party TypeScript clients reuse them.
+ */
+declare class McpRoute {
+    static routes: {
+        [key: string]: Route;
+    };
+}
+export default McpRoute;

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

@@ -0,0 +1,15 @@
+import Route from "./interface";
+/**
+ * Route declarations for the PR Directory API.
+ *
+ * These mirror the Laravel routes under `/api/pr/*` and the title-scoped
+ * matcher route under `/api/titles/{title_id}/pr/matches`. Keeping the URL
+ * templates in one place lets the SDK methods stay small and consistent with
+ * the rest of the package's route-wrapper pattern.
+ */
+declare class PrDirectoryRoutes {
+    static routes: {
+        [key: string]: Route;
+    };
+}
+export default PrDirectoryRoutes;

package/dist/esm/util/Requests.d.ts

@@ -11,6 +11,13 @@ declare class Requests {
     static setBaseUrl(url: string): void;
     static setAuthToken(token: string): void;
     static setCommunityID(community_id: string | undefined): void;
+    /**
+     * Build an absolute API URL using the currently configured base URL.
+     *
+     * This is useful for browser primitives such as EventSource that need a URL
+     * string instead of an Axios request wrapper.
+     */
+    static buildUrl(url: string, params?: Record<string, any>): string;
     private static request;
     static get<T>(url: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
     static post<T>(url: string, data: any, params?: Record<string, any>): AxiosPromise<Response<T>>;

package/dist/index.d.ts

@@ -2060,6 +2060,14 @@ declare class Users {
      * @returns promise
      */
     static clearGoogleAuth<T>(): AxiosPromise<Response<T>>;
+    /**
+     * Clear Gmail Workspace authentication information from the current user.
+     *
+     * @see https://api.glitch.fun/api/documentation#/Users%20Route/clearGmailAuth
+     *
+     * @returns promise
+     */
+    static clearGmailAuth<T>(): AxiosPromise<Response<T>>;
     /**
      * Clear Stripe authentication information from the current user.
      *
@@ -9305,6 +9313,10 @@ declare class Agents {
      * 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>>;
+    /**
+     * 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>>;
     /**
      * List structured agent memories for a title.
      */
@@ -9349,6 +9361,461 @@ declare class Agents {
     static agencyInbox<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
 }
 
+interface McpStartRunRequest {
+    agent_id?: string | null;
+    initial_message?: string | null;
+    prompt?: string | null;
+    run_type?: string;
+    trigger_source?: string;
+    background?: boolean;
+    live_mode?: boolean;
+    attachment_ids?: string[];
+    [key: string]: any;
+}
+/**
+ * Client for the Glitch MCP paid facade (/mcp/v1).
+ *
+ * Authenticate with a Glitch user JWT or a title-scoped MCP token. The facade
+ * enforces subscription, title permissions, scope, and approval guardrails on
+ * every call; this client only forwards requests.
+ */
+declare class Mcp {
+    /** Health/auth probe. Returns authenticated=false (200) when no credential is set. */
+    static authStatus<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** List titles visible to the current user token or title-scoped MCP token. */
+    static listTitles<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** Fetch safe, subscription-gated workspace context for a title. */
+    static titleContext<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** Check subscription, trial, plan, and credit state for a title. */
+    static billing<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** Start a paid Glitch Agent run for a title. */
+    static startRun<T>(title_id: string, data?: McpStartRunRequest, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** Fetch a durable run with status, actions, guidance, events, files, and report. */
+    static viewRun<T>(title_id: string, run_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** List user-visible timeline events for a run. */
+    static runEvents<T>(title_id: string, run_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** Fetch the human-friendly final or partial report for a run. */
+    static finalReport<T>(title_id: string, run_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Server-Sent Events URL for a run's live event stream.
+     *
+     * Returns the absolute URL to open with an EventSource/fetch reader; the
+     * endpoint emits `status`, `run_event`, and a terminal `settled`/`timeout` event.
+     */
+    static runStreamUrl(title_id: string, run_id: string, params?: Record<string, any>): string;
+    /** List downloadable files and hosted report artifacts for a run. */
+    static artifacts<T>(title_id: string, run_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** List proposed/guidance/approval/executed actions for a title. */
+    static listActions<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** Approve a reviewable action. Execution remains guarded server-side. */
+    static approveAction<T>(title_id: string, action_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** Reject a proposed or approval-needed action. */
+    static rejectAction<T>(title_id: string, action_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** Execute an approved action. Public/paid/creator-facing work stays guarded. */
+    static executeAction<T>(title_id: string, action_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** List open or answered guidance requests for a title or run. */
+    static listGuidance<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** Answer a guidance request and resume the server-side workflow when possible. */
+    static answerGuidance<T>(title_id: string, guidance_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** Get instructions for uploading a file (points at uploadFile below). */
+    static createUpload<T>(title_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Upload a file (image, video, or document) to a title or run as multipart/form-data.
+     * The facade re-checks the title scope, subscription, and allowed mime types.
+     */
+    static uploadFile<T>(title_id: string, file: File | Blob, data?: object, params?: Record<string, any>, onUploadProgress?: (progressEvent: AxiosProgressEvent) => void): AxiosPromise<Response<T>>;
+    /** List MCP title tokens (user JWT only). */
+    static listTokens<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** Create a revocable title-scoped MCP token (user JWT only). */
+    static createToken<T>(title_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** Revoke a title-scoped MCP token (user JWT only). */
+    static revokeToken<T>(title_id: string, token_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+}
+
+/**
+ * Allowed outlet types in the PR directory.
+ */
+type PrPublicationType = "blog" | "podcast" | "publication";
+/**
+ * Eligibility state for a PR outlet.
+ */
+type PrEligibilityStatus = "eligible" | "ineligible" | "needs_review" | "duplicate" | "archived";
+/**
+ * Verification state used by PR outlets, people, links, and contact points.
+ */
+type PrVerificationStatus = "unverified" | "verified" | "stale" | "blocked" | "failed" | "needs_review";
+/**
+ * Email health status stored on the outlet-level PR email field.
+ */
+type PrEmailStatus = "unknown" | "verified" | "bounced" | "missing" | "needs_review";
+/**
+ * Contact verification state for normalized contact points.
+ */
+type PrContactVerificationStatus = "unverified" | "verified" | "stale" | "bounced" | "invalid" | "blocked" | "needs_review";
+/**
+ * Link refresh status for evidence URLs.
+ */
+type PrLinkStatus = "unverified" | "ok" | "redirected" | "broken" | "blocked" | "failed" | "stale";
+/**
+ * Filters accepted by `/pr/publications` and `/pr/report`.
+ *
+ * Tag filters are human-readable slugs from `/pr/tags`. The backend accepts
+ * format, genre, platform, and audience as namespace-specific tag filters so
+ * frontend screens can expose simple controls without knowing pivot table
+ * details.
+ */
+interface PrPublicationSearchParams {
+    q?: string;
+    type?: PrPublicationType;
+    eligibility_status?: PrEligibilityStatus;
+    verification_status?: PrVerificationStatus;
+    dedicated_to_gaming?: boolean;
+    has_email?: boolean;
+    country?: string;
+    language?: string;
+    canonical_domain?: string;
+    tag?: string;
+    format?: string;
+    genre?: string;
+    platform?: string;
+    audience?: string;
+    sort?: "name" | "-name" | "type" | "-type" | "eligibility_status" | "-eligibility_status" | "verification_status" | "-verification_status" | "last_verified_at" | "-last_verified_at" | "updated_at" | "-updated_at" | string;
+    page?: number;
+    per_page?: number;
+}
+/**
+ * Filters accepted by `/pr/people`.
+ */
+interface PrPeopleSearchParams {
+    q?: string;
+    publication_id?: string;
+    role_category?: string;
+    is_active?: boolean;
+    verification_status?: PrVerificationStatus;
+    has_email?: boolean;
+    tag?: string;
+    role?: string;
+    sort?: "name" | "-name" | "verification_status" | "-verification_status" | "last_verified_at" | "-last_verified_at" | "updated_at" | "-updated_at" | string;
+    page?: number;
+    per_page?: number;
+}
+/**
+ * Filters accepted by `/pr/tags`.
+ */
+interface PrTagSearchParams {
+    namespace?: string;
+    q?: string;
+}
+/**
+ * Query parameters accepted by `/titles/{title_id}/pr/matches`.
+ *
+ * The title matcher uses the title profile plus optional human-readable search
+ * context to rank eligible outlets and explain why each outlet is a fit.
+ */
+interface PrTitleMatchParams extends PrPublicationSearchParams {
+    genres?: string[];
+    platforms?: string[];
+    audiences?: string[];
+    limit?: number;
+}
+/**
+ * Request body accepted by `/admin/pr/verification/queue`.
+ */
+interface PrQueueVerificationRequest {
+    due?: boolean;
+    limit?: number;
+    link_ids?: string[];
+}
+/**
+ * A normalized metadata tag used to filter and match PR outlets, people, and
+ * roles.
+ */
+interface PrTag {
+    id: string;
+    namespace: string;
+    slug: string;
+    label: string;
+    description?: string | null;
+    pivot?: {
+        confidence?: number | null;
+        source?: string | null;
+        source_link_id?: string | null;
+        verified_at?: string | null;
+        metadata?: Record<string, any> | null;
+    };
+    metadata?: Record<string, any>;
+    created_at?: string | null;
+    updated_at?: string | null;
+}
+/**
+ * A refreshable evidence URL that supports an outlet, person, role, or contact
+ * point.
+ */
+interface PrLink {
+    id: string;
+    linkable_type?: string | null;
+    linkable_id?: string | null;
+    link_type: string;
+    url: string;
+    canonical_url?: string | null;
+    final_url?: string | null;
+    domain?: string | null;
+    priority: number;
+    http_status?: number | null;
+    status: PrLinkStatus;
+    content_type?: string | null;
+    content_hash?: string | null;
+    etag?: string | null;
+    last_modified_at?: string | null;
+    last_checked_at?: string | null;
+    next_check_at?: string | null;
+    last_error?: string | null;
+    is_source_of_truth: boolean;
+    metadata?: Record<string, any>;
+    created_at?: string | null;
+    updated_at?: string | null;
+}
+/**
+ * A normalized way to reach an outlet, person, or publication role.
+ */
+interface PrContactPoint {
+    id: string;
+    contactable_type: string;
+    contactable_id: string;
+    pr_link_id?: string | null;
+    contact_type: "email" | "linkedin" | "x" | "bluesky" | "contact_form" | string;
+    label?: string | null;
+    value: string;
+    normalized_value: string;
+    verification_status: PrContactVerificationStatus;
+    confidence?: number | null;
+    is_primary: boolean;
+    first_seen_at?: string | null;
+    last_seen_at?: string | null;
+    source_link?: PrLink | null;
+    metadata?: Record<string, any>;
+    created_at?: string | null;
+    updated_at?: string | null;
+}
+/**
+ * The role a PR person has at one publication, blog, or podcast.
+ */
+interface PublicationPerson {
+    id: string;
+    publication_id: string;
+    pr_person_id: string;
+    source_link_id?: string | null;
+    role_title?: string | null;
+    role_category?: string | null;
+    email?: string | null;
+    email_status: "unknown" | "verified" | "bounced" | "invalid" | "needs_review";
+    is_primary_contact: boolean;
+    is_current: boolean;
+    confidence?: number | null;
+    started_at?: string | null;
+    ended_at?: string | null;
+    last_verified_at?: string | null;
+    source_notes?: string | null;
+    person?: PrPerson | null;
+    publication?: PrPublication | null;
+    source_link?: PrLink | null;
+    contact_points?: PrContactPoint[];
+    tags?: PrTag[];
+    metadata?: Record<string, any>;
+    created_at?: string | null;
+    updated_at?: string | null;
+}
+/**
+ * A gaming-focused publication, independent blog, or podcast in the PR
+ * directory.
+ */
+interface PrPublication {
+    id: string;
+    name: string;
+    slug?: string | null;
+    type: PrPublicationType;
+    url?: string | null;
+    canonical_domain?: string | null;
+    description?: string | null;
+    main_pr_email?: string | null;
+    main_pr_email_status: PrEmailStatus;
+    dedicated_to_gaming: boolean;
+    eligibility_status: PrEligibilityStatus;
+    exclusion_reason?: string | null;
+    language?: string | null;
+    country?: string | null;
+    network_or_owner?: string | null;
+    verification_status: PrVerificationStatus;
+    last_verified_at?: string | null;
+    next_verification_at?: string | null;
+    source_imported_at?: string | null;
+    people_count?: number;
+    contact_points_count?: number;
+    links_count?: number;
+    people?: PublicationPerson[];
+    contact_points?: PrContactPoint[];
+    links?: PrLink[];
+    tags?: PrTag[];
+    metadata?: Record<string, any>;
+    created_at?: string | null;
+    updated_at?: string | null;
+}
+/**
+ * A journalist, editor, podcast host, producer, contributor, or other PR
+ * contact associated with one or more gaming-focused outlets.
+ */
+interface PrPerson {
+    id: string;
+    name: string;
+    slug?: string | null;
+    bio?: string | null;
+    location?: string | null;
+    linkedin_url?: string | null;
+    x_url?: string | null;
+    bluesky_url?: string | null;
+    website_url?: string | null;
+    is_active: boolean;
+    verification_status: PrVerificationStatus;
+    last_verified_at?: string | null;
+    next_verification_at?: string | null;
+    roles_count?: number;
+    contact_points_count?: number;
+    links_count?: number;
+    roles?: PublicationPerson[];
+    contact_points?: PrContactPoint[];
+    links?: PrLink[];
+    tags?: PrTag[];
+    metadata?: Record<string, any>;
+    created_at?: string | null;
+    updated_at?: string | null;
+}
+/**
+ * Aggregate PR directory health metrics returned by `/pr/report`.
+ */
+interface PrDirectoryReport {
+    generated_at: string;
+    publications: {
+        total: number;
+        by_type: Record<string, number>;
+        by_eligibility_status: Record<string, number>;
+        by_verification_status: Record<string, number>;
+        dedicated_to_gaming: number;
+        with_email: number;
+        due_for_verification: number;
+    };
+    people: {
+        total: number;
+        active: number;
+        with_email: number;
+        by_verification_status: Record<string, number>;
+    };
+    links: {
+        total: number;
+        by_type: Record<string, number>;
+        by_status: Record<string, number>;
+        due_for_check: number;
+    };
+    contacts: {
+        total: number;
+        by_type: Record<string, number>;
+        by_status: Record<string, number>;
+    };
+    tags: {
+        total: number;
+        by_namespace: Record<string, number>;
+    };
+}
+/**
+ * A ranked title-to-outlet match with evidence, contact route, and plain-English
+ * explanation.
+ */
+interface PrTitleMatch {
+    publication: PrPublication;
+    score: number;
+    matched_tags: string[];
+    best_contact_path?: Record<string, any> | null;
+    why: string[];
+    risks: string[];
+    evidence_links: PrLink[];
+}
+/**
+ * Response body returned after queueing PR verification jobs.
+ */
+interface PrQueueVerificationResponse {
+    queued: number;
+}
+/**
+ * SDK wrapper for the PR Directory API.
+ *
+ * The PR directory is read-friendly by default: public endpoints expose
+ * searchable publications, people, tags, and reporting metrics. Authenticated
+ * title admins can request title-specific PR matches, and site admins can queue
+ * monthly-style verification jobs.
+ */
+declare class PrDirectory {
+    /**
+     * Search gaming-focused PR publications, independent blogs, and podcasts.
+     *
+     * @example
+     * ```ts
+     * Glitch.api.PrDirectory.listPublications({
+     *   q: "indie RPG",
+     *   has_email: true,
+     *   eligibility_status: "eligible",
+     *   sort: "-last_verified_at",
+     * });
+     * ```
+     */
+    static listPublications<T = PrPublication[]>(params?: PrPublicationSearchParams): AxiosPromise<Response<T>>;
+    /**
+     * Retrieve one PR publication profile with loaded people, contact points,
+     * evidence links, and tags.
+     */
+    static viewPublication<T = PrPublication>(publication_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Search PR people and roles across all known publications.
+     *
+     * @example
+     * ```ts
+     * Glitch.api.PrDirectory.listPeople({
+     *   q: "reviews editor",
+     *   has_email: true,
+     *   role_category: "editor",
+     * });
+     * ```
+     */
+    static listPeople<T = PrPerson[]>(params?: PrPeopleSearchParams): AxiosPromise<Response<T>>;
+    /**
+     * Retrieve one PR person profile with their outlet roles, profile links,
+     * contact points, and metadata tags.
+     */
+    static viewPerson<T = PrPerson>(person_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * List the normalized tag vocabulary used for PR search, filters, matching,
+     * and reporting.
+     */
+    static listTags<T = PrTag[]>(params?: PrTagSearchParams): AxiosPromise<Response<T>>;
+    /**
+     * Get aggregate PR directory reporting metrics. Publication filters can be
+     * supplied to scope the outlet portion of the report.
+     */
+    static report<T = PrDirectoryReport>(params?: PrPublicationSearchParams): AxiosPromise<Response<T>>;
+    /**
+     * Match a registered game title to PR outlets. Requires an auth token for a
+     * user who can administer the requested title.
+     */
+    static titleMatches<T = PrTitleMatch[]>(title_id: string, params?: PrTitleMatchParams): AxiosPromise<Response<T>>;
+    /**
+     * Queue PR verification jobs. Requires a site-admin auth token.
+     *
+     * @example
+     * ```ts
+     * Glitch.api.PrDirectory.queueVerification({ due: true, limit: 250 });
+     * ```
+     */
+    static queueVerification<T = PrQueueVerificationResponse>(data?: PrQueueVerificationRequest, params?: Record<string, any>): AxiosPromise<Response<T>>;
+}
+
 interface Route {
     url: string;
     method: string;
@@ -9363,6 +9830,13 @@ declare class Requests {
     static setBaseUrl(url: string): void;
     static setAuthToken(token: string): void;
     static setCommunityID(community_id: string | undefined): void;
+    /**
+     * Build an absolute API URL using the currently configured base URL.
+     *
+     * This is useful for browser primitives such as EventSource that need a URL
+     * string instead of an Axios request wrapper.
+     */
+    static buildUrl(url: string, params?: Record<string, any>): string;
     private static request;
     static get<T>(url: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
     static post<T>(url: string, data: any, params?: Record<string, any>): AxiosPromise<Response<T>>;
@@ -9705,6 +10179,8 @@ declare class Glitch {
         Multiplayer: typeof Multiplayer;
         ServerOperations: typeof ServerOperations;
         Agents: typeof Agents;
+        Mcp: typeof Mcp;
+        PrDirectory: typeof PrDirectory;
     };
     static util: {
         Requests: typeof Requests;

package/package.json

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

package/src/api/Agents.ts

@@ -196,6 +196,13 @@ class Agents {
     return Requests.processRoute(AgentsRoute.routes.answerGuidance, data, { title_id, guidance_id }, params);
   }
 
+  /**
+   * Rewrite an editable agent draft for review without executing the parent action.
+   */
+  public static rewriteAgentDraft<T>(title_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.rewriteAgentDraft, data, { title_id }, params);
+  }
+
   /**
    * List structured agent memories for a title.
    */