@ggui-ai/protocol 0.1.0-rc.1

package/dist/types/mcp.d.ts

@@ -0,0 +1,637 @@
+import type { z } from 'zod';
+import type { Action, SessionView } from './session';
+import type { DataContract, JsonObject, JsonSchema, JsonValue, StreamSpec } from './data-contract';
+import type { handshakeInputSchema, handshakeOutputSchema, newSessionInputSchema, newSessionOutputSchema, pushInputSchema, pushOutputSchema, updateInputSchema, updateOutputSchema } from '../schemas/mcp';
+export type { Action };
+/** Target screen size category for responsive layout */
+export type Screen = 'mobile' | 'tablet' | 'desktop' | 'universal';
+/**
+ * Session status for MCP consume responses
+ */
+export type SessionStatus = 'active' | 'completed' | 'expired';
+/**
+ * Pending action stored server-side for agent consumption.
+ *
+ * `envelope` is the canonical {@link ConsumeEventEntry} row. `sequence`
+ * is the session-scoped monotonic assigned at ingestion; it sits on the
+ * row wrapper so consumers can detect gaps without parsing the payload.
+ *
+ * **Storage note**: the envelope is stored as either a JSON object
+ * (direct DDB writes) or a JSON-stringified object (AppSync `a.json()`
+ * semantics). Consume readers MUST accept both — see
+ * {@link parsePendingEnvelope}.
+ */
+export interface PendingEvent {
+    /** Stable row id — UUID assigned at ingestion. */
+    id: string;
+    /**
+     * Canonical {@link ConsumeEventEntry} row payload. JSON object or
+     * stringified JSON on the wire (both shapes round-trip through the
+     * consume helpers).
+     */
+    envelope: ConsumeEventEntry | string;
+    /**
+     * Session-scoped monotonic sequence assigned at ingestion. Mirrors
+     * `Session.eventSequence` at the moment this row was appended so
+     * consumers can detect gaps without reading session state.
+     */
+    sequence: number;
+    /** ISO datetime when the row was appended. */
+    createdAt: string;
+}
+/**
+ * Input for ggui_pop tool - removes top UI from stack
+ */
+export interface GguiPopInput {
+    /** Session ID to pop from */
+    sessionId: string;
+}
+/**
+ * Input for ggui_consume tool — long-poll for buffered events on a
+ * specific stack item.
+ *
+ * Keyed by `stackItemId`, not `sessionId`. The server resolves the
+ * owning session via its `stackItemId` secondary index and tenancy-
+ * checks via `ctx.appId`. The agent gets `stackItemId` from
+ * `pushOutput.stackItemId`.
+ *
+ * Default semantic: long-poll, return on first event or server-default
+ * timeout. Agent loops by re-calling. There is no `until` parameter —
+ * the agent's loop policy is its own concern; the server delivers one
+ * batch per call.
+ *
+ * Each drained entry on the output carries its own `uiContext` snapshot
+ * captured at gesture time on the iframe; the top-level
+ * `contextSnapshot` is intentionally absent from the output (see
+ * {@link GguiConsumeOutput} / {@link ConsumeEventEntry}).
+ */
+export interface GguiConsumeInput {
+    /**
+     * Stack item to consume events from. Globally unique (UUID); the
+     * server resolves the owning session via its secondary index.
+     * Cross-tenant access surfaces uniformly as `stack_item_not_found`.
+     */
+    stackItemId: string;
+    /**
+     * Timeout in seconds for long-poll. Server-side wall-clock cap.
+     * - 0: immediate return (no waiting)
+     * - 1-25: synchronous long-poll (HTTP API, capped by 30s gateway limit)
+     * - 26-900: SSE streaming via server-sent events (up to 15 min)
+     * The MCP client SDK routes to the appropriate endpoint automatically.
+     * Default: 0 (immediate).
+     */
+    timeout?: number;
+}
+/**
+ * Input for `ggui_emit` — emit a new delivery on a declared channel of the
+ * active (or explicitly pinned) stack item's `streamSpec`.
+ *
+ * Canonical, post-rewrite shape. The agent describes what new data
+ * exists; the server describes how the channel behaves.
+ *
+ * Fields the agent MUST NOT supply:
+ *   - `mode` — derived from `streamSpec[channel].mode` (default `'append'`).
+ *   - `seq` — server-assigned via `SessionStreamBuffer`.
+ *   - `timestamp` — server clock.
+ *   - `connectionId` / transport details — fan-out plumbing.
+ *
+ * Any of these appearing on `GguiEmitInput` is a drift regression and
+ * guarded by `types.test.ts`.
+ */
+export interface GguiEmitInput<TPayload = JsonValue> {
+    /** Session to stream to. Server enforces app-ownership. */
+    sessionId: string;
+    /**
+     * Channel name. MUST be declared on the resolved stack item's
+     * `streamSpec`. Undeclared channels are rejected at call time.
+     */
+    channel: string;
+    /**
+     * Payload for this delivery. Validated against
+     * `streamSpec[channel].schema`.
+     */
+    payload: TPayload;
+    /**
+     * Terminal delivery marker. Only valid when the channel was declared
+     * with `complete: true` on the streamSpec. Setting it on a non-
+     * completable channel is rejected at call time.
+     *
+     * Post-complete behavior is NOT enforced server-side — producers
+     * SHOULD NOT emit further deliveries on the same channel after
+     * sending `complete: true`, but the server won't reject them.
+     */
+    complete?: boolean;
+    /**
+     * Pin this delivery to a specific stack item. Mirrors the live-channel
+     * `ActionEnvelope.stackItemId` doctrine — explicit when the agent
+     * cares, implicit `session.currentStackIndex` default otherwise.
+     */
+    stackItemId?: string;
+}
+/**
+ * Output from `ggui_emit`.
+ *
+ * `accepted` — the server validated and enqueued the envelope. Fan-out
+ * to subscribers and buffered retention happen independently; whether
+ * any subscriber is currently connected is a separate concern and does
+ * NOT affect this flag. No-subscriber is not an error.
+ */
+export interface GguiEmitOutput {
+    /** True when the server accepted the delivery at the boundary. */
+    accepted: boolean;
+    /**
+     * Session-scoped monotonic outbound sequence assigned to this
+     * delivery. Omitted on implementations without a
+     * `SessionStreamBuffer` (hosted cloud today); required on OSS
+     * `@ggui-ai/mcp-server`.
+     */
+    seq?: number;
+}
+/**
+ * Input for ggui_get_session tool - retrieves session state
+ */
+export interface GguiGetSessionInput {
+    /** Session ID to get state for */
+    sessionId: string;
+}
+/**
+ * Input for ggui_close tool - terminates session
+ */
+export interface GguiCloseInput {
+    /** Session ID to close */
+    sessionId: string;
+}
+/**
+ * Input for ggui_get_stack tool - lightweight stack navigation metadata
+ */
+export interface GguiGetStackInput {
+    /** Session ID to get stack info for */
+    sessionId: string;
+}
+/**
+ * Lightweight summary of a stack item (no componentCode)
+ */
+export interface StackItemSummary {
+    /** Stack item ID */
+    id: string;
+    /** Natural language prompt that generated this item */
+    prompt?: string;
+    /** Human-readable description */
+    description?: string;
+    /** Whether this item has a generation error */
+    hasError: boolean;
+    /** Stream contract — describes what data the component accepts in real-time via ggui_emit */
+    streamSpec?: StreamSpec;
+    /** Declarative actions wired into this item */
+    actions?: Action[];
+    /** ISO datetime when this item was created */
+    createdAt: string;
+}
+/**
+ * Output from ggui_get_stack tool
+ */
+export interface GguiGetStackOutput {
+    /** Session ID */
+    sessionId: string;
+    /** Number of items in the stack */
+    stackSize: number;
+    /** Currently active stack index */
+    currentIndex: number;
+    /** Lightweight item summaries (no component code) */
+    items: StackItemSummary[];
+    /** Whether back navigation is possible */
+    canGoBack: boolean;
+    /** Whether forward navigation is possible */
+    canGoForward: boolean;
+    /** Session status */
+    status: SessionStatus;
+}
+/** Negotiator's decision on what UI to show. */
+export interface NegotiatorDecision {
+    /** What to do with the UI stack. */
+    action: 'create' | 'update' | 'compose' | 'replace';
+    /** Why — visible to the agent. */
+    reasoning: string;
+    /** Matched blueprint (if any). */
+    blueprintId?: string;
+    /** The agreed data contract. */
+    contract: DataContract;
+    /** For update/compose/replace — which page to target. */
+    targetStackItemId?: string;
+    /** UI adaptations based on user context. */
+    adaptations?: {
+        fontSize?: 'compact' | 'default' | 'large';
+        density?: 'dense' | 'default' | 'spacious';
+        complexity?: 'simplified' | 'default' | 'detailed';
+    };
+}
+/** Alternative option (shown in suggestive/passive modes). */
+export interface NegotiatorAlternative {
+    id: string;
+    type: 'blueprint' | 'brainstorm';
+    description: string;
+    blueprintId?: string;
+    contract?: DataContract;
+    renderTime: 'instant' | 'standard';
+}
+/**
+ * Output from ggui_pop tool
+ */
+export interface GguiPopOutput {
+    /** ID of the card that was popped */
+    poppedId: string | null;
+    /** Current stack size after pop */
+    stackSize: number;
+}
+/**
+ * Per-event entry returned by `ggui_consume`. The shape written by
+ * `ggui_runtime_submit_action`'s `kind:'dispatch'` handler onto the
+ * stackItem-keyed pending-events pipe and surfaced verbatim on drain.
+ *
+ * `actionData` is WHAT the user did; `uiContext` is the snapshot of the
+ * contract's `contextSpec` slot values at the moment they did it.
+ * Capturing both per-event (instead of folding a top-level
+ * `contextSnapshot` at drain time) means agents see the UI state AS IT
+ * WAS WHEN THE USER ACTED, not the post-action state that might already
+ * have mutated by the time consume returns.
+ *
+ * Distinct from the inbound live-channel `ActionEnvelope` (which has
+ * `{sessionId, type, payload?, stackIndex?, ...}` and lives on the
+ * WebSocket inbound seam) — consume reads from a separate stackItem-
+ * scoped pipe whose entries originate at `submit_action`.
+ */
+export interface ConsumeEventEntry {
+    /** Stable discriminator — always the literal `'action'`. */
+    readonly type: 'action';
+    /** Stack item the gesture targeted. */
+    readonly stackItemId: string;
+    /** Which `actionSpec[*]` entry the iframe dispatched against. */
+    readonly intent: string;
+    /**
+     * Typed payload satisfying `actionSpec[intent].schema`. `null` for
+     * no-payload gestures (bare button click).
+     */
+    readonly actionData: JsonValue | null;
+    /**
+     * Snapshot of the contract's `contextSpec` slot values at the moment
+     * the user fired the gesture. Empty object `{}` when the contract
+     * has no `contextSpec` or no slots have been mirrored yet.
+     */
+    readonly uiContext: JsonObject;
+    /**
+     * 8-hex FNV-1a correlation id of the gesture — matches the iframe-
+     * runtime's outstanding-toast key and the server's `drain_ack` frame.
+     */
+    readonly actionId: string;
+    /** ISO 8601 UTC timestamp of the gesture (iframe-local clock). */
+    readonly firedAt: string;
+}
+/**
+ * Output from `ggui_consume` — buffered consume-entries.
+ *
+ * `events` is an array of {@link ConsumeEventEntry} rows in append order.
+ * The pre-2026-05-14 top-level `contextSnapshot` field was RETIRED in
+ * favor of the per-event `uiContext` on each entry. The pipe is the
+ * single source of truth — both the action and the local UI state are
+ * atomic on a single entry.
+ */
+export interface GguiConsumeOutput {
+    /** Buffered consume-entries (cleared after return). */
+    events: ConsumeEventEntry[];
+    /** Session status - 'completed' means no more events will arrive */
+    status: SessionStatus;
+    /**
+     * Client-side observations echoed back to the agent. Same shape
+     * `ggui_handshake` exposes. Lets the agent pick up mid-session
+     * changes (window resize, fullscreen toggle, etc.) without waiting
+     * for the next handshake. Absent ⇒ no client observations yet.
+     *
+     */
+    client?: {
+        readonly hostContext?: import('./host-context.js').HostContextProjection;
+    };
+}
+/**
+ * Output from ggui_get_session tool.
+ * Extends SessionView (spec Section 6.1) — same fields, same structure.
+ */
+export type GguiGetSessionOutput = SessionView;
+/**
+ * Output from ggui_close tool
+ */
+export interface GguiCloseOutput {
+    /** Whether the session was successfully closed */
+    success: boolean;
+}
+/**
+ * Input for ggui_list_featured_blueprints tool - discovers available UI blueprints
+ */
+export interface GguiListFeaturedBlueprintsInput {
+    /** Filter by component level. Canonical four-level hierarchy:
+     *  `primitive` (Button) → `component` (SearchField) → `composite`
+     *  (LoginForm, Modal) → `template` (ListDetail, Dashboard page). */
+    level?: 'primitive' | 'component' | 'composite' | 'template';
+    /** Filter by category */
+    category?: string;
+    /** Filter by tags (any match) */
+    tags?: string[];
+    /** Max results (default: 50) */
+    limit?: number;
+}
+/**
+ * Output from ggui_list_featured_blueprints tool
+ */
+export interface GguiListFeaturedBlueprintsOutput {
+    /** List of matching blueprints */
+    blueprints: Array<{
+        id: string;
+        name: string;
+        source: 'predefined' | 'cached';
+        description: string;
+        category: string;
+        level: string;
+        props: Array<{
+            name: string;
+            type: string;
+            required: boolean;
+            description: string;
+        }>;
+        examples: string[];
+        tags: string[];
+        usageCount?: number;
+    }>;
+    /** Total number of matching blueprints */
+    total: number;
+}
+/**
+ * Input for ggui_search_blueprints tool - semantic search over blueprints
+ */
+export interface GguiSearchBlueprintsInput {
+    /** Natural language description of the UI you're looking for */
+    query: string;
+    /** Max results (default: 10) */
+    limit?: number;
+}
+/**
+ * Output from ggui_search_blueprints tool
+ */
+export interface GguiSearchBlueprintsOutput {
+    /** Matching blueprints ordered by relevance */
+    results: Array<{
+        id: string;
+        name: string;
+        description: string;
+        category: string;
+        props: Array<{
+            name: string;
+            type: string;
+            required: boolean;
+            description: string;
+        }>;
+        callbacks: string[];
+        /** Whether this is a featured/predefined blueprint (curated by the app developer) */
+        featured: boolean;
+        relevance: 'match';
+        /** Cosine similarity score (0-1). Higher = better match. Agents can use this
+         *  to decide whether to use a blueprint or generate from scratch. */
+        score: number;
+    }>;
+    /** Total matches found */
+    total: number;
+    /** The query that was searched */
+    query: string;
+}
+/**
+ * Input for ggui_render_blueprint tool - renders a specific blueprint.
+ * Generic `TProps` defaults to {@link JsonObject} for blueprint props.
+ */
+export interface GguiRenderBlueprintInput<TProps = JsonObject> {
+    /** Blueprint ID to render */
+    blueprintId: string;
+    /** Props to pass to the blueprint */
+    props?: TProps;
+}
+/**
+ * Output from ggui_render_blueprint tool.
+ *
+ * The OSS path returns the compiled bundle inline (`code` + `contentType`)
+ * so agents + viewers can consume it without a second round-trip. When
+ * the hosted cloud re-introduces signed-URL rendering it will layer on
+ * additional optional fields; the inline shape stays the baseline contract
+ * every implementation honors.
+ */
+export interface GguiRenderBlueprintOutput {
+    /** Blueprint ID that was rendered. */
+    blueprintId: string;
+    /** Blueprint name for display. */
+    blueprintName: string;
+    /**
+     * Compiled JS bundle as a string. ESM `export default` producing the
+     * component that should mount. Non-empty on success.
+     */
+    code: string;
+    /**
+     * MIME / content-type of `code`. Typically
+     * `'application/javascript+react'` — pinned on the server's compile
+     * pipeline; agents treat this as opaque.
+     */
+    contentType: string;
+}
+/**
+ * Input for ggui_discover tool - discovers platform capabilities
+ */
+export interface GguiDiscoverInput {
+}
+/**
+ * Output from ggui_discover tool - platform capabilities and app configuration
+ */
+export interface GguiDiscoverOutput {
+    /** Protocol version (e.g., 'draft-2026-04-19'). Prelaunch drafts use
+     *  `draft-YYYY-MM-DD`; the first frozen release will be `1.0.0`. */
+    protocolVersion: string;
+    /** Supported content types (e.g., 'application/javascript+react') */
+    contentTypes: string[];
+    /** Available shell types (e.g., 'chat', 'fullscreen', 'spatial') */
+    shellTypes: string[];
+    /**
+     * Available component capabilities — informational catalog string list
+     * surfaced for discovery clients. The load-bearing per-app permission
+     * grant flows via `DataContract.clientCapabilities.gadgets[*].permission`
+     * (projected onto the bootstrap as `Permissions-Policy`); this field is
+     * not consulted at boot or dispatch time.
+     */
+    componentCapabilities: string[];
+    /** App-specific configuration (present when the app is found in the database) */
+    app?: {
+        /** Adapters enabled for this app */
+        enabledAdapters: string[];
+        /** Component capabilities granted to this app */
+        grantedCapabilities: string[];
+        /** Default shell type for new sessions */
+        defaultShellType: string;
+        /** Authentication mode for end users */
+        authMode: string;
+        /** Rate limit in requests per minute (0 = unlimited) */
+        rateLimitPerMinute: number;
+    };
+}
+/**
+ * Input for ggui_request_credential — request OAuth consent from the user.
+ * Called by agents when MCP proxy returns 401 (credential_required).
+ */
+export interface GguiRequestCredentialInput {
+    /** OAuth service ID (e.g., "bashdoor", "ubot") */
+    serviceId: string;
+    /** Why the agent needs this credential (shown to user) */
+    reason?: string;
+    /** Existing session to push consent UI into */
+    sessionId?: string;
+}
+/**
+ * Output from ggui_request_credential — consent result.
+ */
+export interface GguiRequestCredentialOutput {
+    /** Whether the user granted consent */
+    granted: boolean;
+    /** Grant mode (once or always) — only present when granted=true */
+    mode?: 'once' | 'always';
+    /** Service display info */
+    service?: {
+        name: string;
+        icon: string;
+    };
+    /** Reason for denial (timeout, user denied, error) */
+    reason?: string;
+}
+/**
+ * MCP JSON-RPC request.
+ * Generic `TParams` defaults to {@link JsonObject} for the request parameters.
+ */
+export interface McpRequest<TParams = JsonObject> {
+    jsonrpc: '2.0';
+    id: string | number;
+    method: string;
+    params?: TParams;
+}
+/**
+ * MCP JSON-RPC response.
+ * Generic `TResult` defaults to {@link JsonValue} to accept any JSON-safe result.
+ */
+export interface McpResponse<TResult = JsonValue> {
+    jsonrpc: '2.0';
+    id: string | number;
+    result?: TResult;
+    error?: McpError;
+}
+/**
+ * MCP error object.
+ * The `data` field is {@link JsonValue} to carry any JSON-safe diagnostic data.
+ */
+export interface McpError {
+    code: number;
+    message: string;
+    /** Additional error data. Typed as {@link JsonValue} (any JSON-safe value). */
+    data?: JsonValue;
+}
+/**
+ * MCP tool definition.
+ * Extends {@link JsonObject} for JSON serialization compatibility.
+ */
+export interface McpToolDefinition extends JsonObject {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, JsonSchema>;
+        required?: string[];
+    };
+    outputSchema?: {
+        type: 'object';
+        properties?: Record<string, JsonSchema>;
+        required?: string[];
+    };
+}
+/**
+ * MCP server info for initialize response.
+ * Extends {@link JsonObject} for JSON serialization compatibility.
+ */
+export interface McpServerInfo extends JsonObject {
+    name: string;
+    version: string;
+}
+/**
+ * MCP capabilities.
+ * Extends {@link JsonObject} for JSON serialization compatibility.
+ */
+export interface McpCapabilities extends JsonObject {
+    tools?: Record<string, never>;
+}
+export type GguiNewSessionInput = z.infer<typeof newSessionInputSchema>;
+export type GguiNewSessionOutput = z.infer<typeof newSessionOutputSchema>;
+export type GguiHandshakeInput = z.infer<typeof handshakeInputSchema>;
+export type GguiHandshakeOutput = z.infer<typeof handshakeOutputSchema>;
+/**
+ * Server-side stream-transport capability advertised on every successful
+ * `ggui_handshake` response (see {@link GguiHandshakeOutput.serverCapabilities}).
+ *
+ * Mirrors `handshakeOutputSchema.serverCapabilities` exactly — exported
+ * here as a named TypeScript type so server-side composition layers
+ * (the OSS `createGguiServer` resolver, the cloud pod composer) can hand
+ * one back to the handshake factory without re-deriving the shape from
+ * the schema.
+ *
+ * Semantics + transport-negotiation rules: see the inline docstring on
+ * `handshakeOutputSchema.serverCapabilities` in `schemas/mcp.ts`.
+ *
+ * Absent ⇒ universal iframe-polling fallback. Present ⇒ `@ggui-ai/wire`
+ * negotiates per channel against the allowlist.
+ */
+export interface ServerCapabilities {
+    /**
+     * WebSocket endpoint that fans out
+     * `streamSpec[ch].source.tool` results. Iframe opens this socket on
+     * bootstrap and sends a `channel_subscribe` frame per streamSpec entry
+     * whose `source.tool` is in {@link streamWebSocketLocalTools}.
+     */
+    readonly streamWebSocket?: {
+        readonly url: string;
+    };
+    /**
+     * Whitelist of `source.tool` names the server can subscribe-for on
+     * {@link streamWebSocket}. Channels whose `source.tool` is in this
+     * set use the WebSocket subscribe path; channels whose source is
+     * elsewhere fall through to iframe polling.
+     */
+    readonly streamWebSocketLocalTools?: readonly string[];
+}
+export type GguiPushInput = z.infer<typeof pushInputSchema>;
+export type GguiPushOutput = z.infer<typeof pushOutputSchema>;
+export type GguiUpdateInput = z.infer<typeof updateInputSchema>;
+export type GguiUpdateOutput = z.infer<typeof updateOutputSchema>;
+/**
+ * Core protocol error codes (per spec Section 7.9)
+ */
+export declare const MCP_ERROR_CODES: {
+    readonly PARSE_ERROR: -32700;
+    readonly INVALID_REQUEST: -32600;
+    readonly METHOD_NOT_FOUND: -32601;
+    readonly INVALID_PARAMS: -32602;
+    readonly INTERNAL_ERROR: -32603;
+    readonly UNAUTHORIZED: -32001;
+    readonly SESSION_NOT_FOUND: -32002;
+    readonly APP_NOT_FOUND: -32003;
+    readonly PRODUCTION_FAILED: -32004;
+    readonly CAPABILITY_DENIED: -32005;
+};
+/**
+ * Platform-specific error codes (-32010 range).
+ * These are ggui platform extensions, not part of the core protocol.
+ */
+export declare const PLATFORM_ERROR_CODES: {
+    readonly GENERATION_QUOTA_EXCEEDED: -32010;
+    readonly APP_LIMIT_EXCEEDED: -32011;
+    readonly CONCURRENT_SESSION_LIMIT: -32012;
+    readonly RATE_LIMIT_EXCEEDED: -32013;
+    readonly CONTRACT_VIOLATION: -32020;
+};
+//# sourceMappingURL=mcp.d.ts.map

package/dist/types/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/types/mcp.ts"],"names":[],"mappings":"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"}

package/dist/types/mcp.js

@@ -0,0 +1,30 @@
+// =============================================================================
+// MCP Error Codes
+// =============================================================================
+/**
+ * Core protocol error codes (per spec Section 7.9)
+ */
+export const MCP_ERROR_CODES = {
+    PARSE_ERROR: -32700,
+    INVALID_REQUEST: -32600,
+    METHOD_NOT_FOUND: -32601,
+    INVALID_PARAMS: -32602,
+    INTERNAL_ERROR: -32603,
+    // Protocol-specific error codes
+    UNAUTHORIZED: -32001,
+    SESSION_NOT_FOUND: -32002,
+    APP_NOT_FOUND: -32003,
+    PRODUCTION_FAILED: -32004,
+    CAPABILITY_DENIED: -32005,
+};
+/**
+ * Platform-specific error codes (-32010 range).
+ * These are ggui platform extensions, not part of the core protocol.
+ */
+export const PLATFORM_ERROR_CODES = {
+    GENERATION_QUOTA_EXCEEDED: -32010,
+    APP_LIMIT_EXCEEDED: -32011,
+    CONCURRENT_SESSION_LIMIT: -32012,
+    RATE_LIMIT_EXCEEDED: -32013,
+    CONTRACT_VIOLATION: -32020,
+};