@salesforce/platform-sdk 3.0.0

package/dist/core/mcpapps-session.d.ts

@@ -0,0 +1,107 @@
+import { DisplayMode, HostStyles } from './chat';
+import { JsonRpcClient } from './jsonrpc-client';
+import { ThemeMode } from './view';
+/**
+ * Host context returned by the ui/initialize handshake.
+ *
+ * Represents the raw MCP Apps wire-format fields. SDK classes map
+ * these to their own protocol-agnostic types.
+ */
+export interface McpAppsHostContext {
+    /** Theme mode provided by the host */
+    theme?: ThemeMode;
+    /** Display mode of the widget */
+    displayMode?: DisplayMode;
+    /** Container dimensions */
+    containerDimensions?: {
+        height?: number;
+        maxHeight?: number;
+        width?: number;
+        maxWidth?: number;
+    };
+    /** Safe area insets in CSS pixels */
+    safeAreaInsets?: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    /** Host user agent string */
+    userAgent?: string;
+    /** BCP 47 locale */
+    locale?: string;
+    /** Device capabilities */
+    deviceCapabilities?: {
+        touch?: boolean;
+        hover?: boolean;
+    };
+    /** Tool info for the current tool invocation (name, schema, etc.) */
+    toolInfo?: {
+        /** JSON-RPC id of the tools/call request */
+        id?: string | number;
+        /** Full tool definition */
+        tool: Record<string, unknown>;
+    };
+    /** Initial tool output (structuredContent from CallToolResult), if available at init */
+    toolOutput?: Record<string, unknown> | null;
+    /** Initial tool output structured content, if available at init */
+    toolStructuredContent?: Record<string, unknown> | null;
+    /** Initial tool input arguments, if available at init */
+    toolInput?: Record<string, unknown>;
+    /** Initial tool response metadata (_meta from CallToolResult), if available at init */
+    toolResponseMetadata?: Record<string, unknown> | null;
+    /** Initial widget state, if available at init */
+    widgetState?: Record<string, unknown> | null;
+    /** Styles provided by the host for theming and font loading */
+    styles?: HostStyles;
+}
+/**
+ * Options for McpAppsSession initialization.
+ */
+export interface McpAppsSessionOptions {
+    /** App identity sent during the ui/initialize handshake */
+    appInfo?: {
+        name: string;
+        version: string;
+    };
+    /** Handshake timeout in milliseconds (default 5000) */
+    handshakeTimeoutMs?: number;
+}
+/**
+ * Shared MCP Apps session singleton.
+ *
+ * Provides a single JSON-RPC transport (one postMessage listener, one ID counter)
+ * shared by both MCPAppsChatSDK and MCPAppsViewSDK. Performs the SEP-1865
+ * ui/initialize handshake once and exposes the resulting host context.
+ *
+ * Use {@link McpAppsSession.getInstance} to obtain the singleton. The first call
+ * triggers the handshake; subsequent calls return the same initialized instance.
+ */
+export declare class McpAppsSession extends JsonRpcClient {
+    private static initPromise;
+    private hostCtx;
+    private _handshakeSucceeded;
+    /**
+     * Get or create the shared session singleton.
+     *
+     * The first call performs the SEP-1865 handshake. Concurrent and subsequent
+     * calls reuse the same session and handshake result.
+     */
+    static getInstance(options?: McpAppsSessionOptions): Promise<McpAppsSession>;
+    /**
+     * Perform the ui/initialize → hostContext → ui/notifications/initialized handshake.
+     *
+     * On success, stores the host context and sends the initialized notification.
+     * On timeout or error, falls back to an empty host context so the app can
+     * still render (graceful degradation for non-SEP-1865 hosts).
+     */
+    private handshake;
+    /** Returns the current host context (handshake + notification updates). */
+    getHostContext(): McpAppsHostContext;
+    /** Whether the ui/initialize handshake completed successfully (not timed out). */
+    get handshakeSucceeded(): boolean;
+    request<TParams = unknown, TResult = unknown>(method: string, params: TParams): Promise<TResult>;
+    sendNotification<TParams = unknown>(method: string, params?: TParams): void;
+    registerNotificationHandler(method: string, handler: (params: unknown) => void): void;
+}
+//# sourceMappingURL=mcpapps-session.d.ts.map

package/dist/core/mcpapps-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpapps-session.d.ts","sourceRoot":"","sources":["../../src/core/mcpapps-session.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAExC;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IAClC,sCAAsC;IACtC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,iCAAiC;IACjC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,2BAA2B;IAC3B,mBAAmB,CAAC,EAAE;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,qCAAqC;IACrC,cAAc,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9E,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,kBAAkB,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC1D,qEAAqE;IACrE,QAAQ,CAAC,EAAE;QACV,4CAA4C;QAC5C,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACrB,2BAA2B;QAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC9B,CAAC;IACF,wFAAwF;IACxF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5C,mEAAmE;IACnE,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACvD,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,uFAAuF;IACvF,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACtD,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7C,+DAA+D;IAC/D,MAAM,CAAC,EAAE,UAAU,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,2DAA2D;IAC3D,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,uDAAuD;IACvD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAQD;;;;;;;;;GASG;AACH,qBAAa,cAAe,SAAQ,aAAa;IAChD,OAAO,CAAC,MAAM,CAAC,WAAW,CAAwC;IAElE,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,mBAAmB,CAAS;IAEpC;;;;;OAKG;WACU,WAAW,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC;IAmBlF;;;;;;OAMG;YACW,SAAS;IAuCvB,2EAA2E;IAC3E,cAAc,IAAI,kBAAkB;IAIpC,kFAAkF;IAClF,IAAI,kBAAkB,IAAI,OAAO,CAEhC;IAMe,OAAO,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAC3D,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,GACb,OAAO,CAAC,OAAO,CAAC;IAIH,gBAAgB,CAAC,OAAO,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI;IAI3E,2BAA2B,CAC1C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAChC,IAAI;CAGP"}

package/dist/core/mfe-protocol/message-channel-transport.d.ts

@@ -0,0 +1,79 @@
+import { Transport } from '../jsonrpc-client';
+/**
+ * Subscriber callback invoked for each unwrapped payload delivered on the
+ * port. Receivers get the `MessageEvent.data` directly — they do not need
+ * to reach into a `MessageEvent` wrapper.
+ */
+export type MessageChannelTransportListener = (msg: unknown) => void;
+/**
+ * MFE-side `Transport` backed by a `MessagePort`.
+ *
+ * During the MFE handshake, the iframe receives a transferred `MessagePort`
+ * (`event.ports[0]`) in the single bootstrap envelope posted by the host.
+ * That port is the `port1` half of the host's `MessageChannel`. Wrapping it
+ * in this class produces the same `Transport` shape that `JsonRpcClient`
+ * already consumes, so callers can swap in MessagePort-backed traffic
+ * without changing any of the JSON-RPC request/response/notification
+ * semantics.
+ *
+ * The implementation mirrors the host-side `MessageChannelTransport` that
+ * ships from `packages/core/src/MessageChannelTransport.ts` in the
+ * `ui-embedding` repo. Both sides MUST honour the same contract so one
+ * `JsonRpcClient` can drive either end.
+ *
+ * Contract (symmetric with the host-side transport, and with the
+ * `Transport` interface defined next to `WindowPostMessageTransport`):
+ *
+ *  - `post(msg)` never throws on transient failure. A closed / neutered /
+ *    disposed port silently drops the message. This matches the
+ *    optional-chaining behaviour of `WindowPostMessageTransport.post`.
+ *  - `onMessage(cb)` delivers the **unwrapped** payload (`MessageEvent.data`),
+ *    not the raw `MessageEvent`. Returns an unsubscribe function.
+ *  - The port is started (`port.start()`) lazily on the first `onMessage`
+ *    subscription. Messages queued via `post` before that first subscribe
+ *    are buffered in-process and flushed FIFO when the port starts.
+ *  - `dispose()` removes listeners, closes the port, clears the outbound
+ *    buffer, and puts the transport into a terminal state where further
+ *    `post` calls silently no-op and further `onMessage` calls return a
+ *    no-op unsubscribe.
+ *
+ * Usage from the container bootstrap:
+ * ```ts
+ * const transport = new MessageChannelTransport(event.ports[0]);
+ * // Hand the transport to the session layer; subscription drives start().
+ * ```
+ */
+export declare class MessageChannelTransport implements Transport {
+    #private;
+    constructor(port: MessagePort);
+    /**
+     * Post a message to the peer.
+     *
+     * Never throws on transient failure — a closed / neutered / disposed
+     * port silently drops the message. If the transport has not yet
+     * started (no `onMessage` subscriber), the message is buffered and
+     * flushed on first subscription.
+     */
+    post(message: unknown): void;
+    /**
+     * Subscribe to inbound messages from the peer. The callback receives
+     * the **unwrapped** payload (`MessageEvent.data`) — callers never see
+     * the `MessageEvent` wrapper.
+     *
+     * Starts the underlying port on first subscription and flushes any
+     * messages queued via `post` before the port was started.
+     *
+     * Returns an unsubscribe function. Calling it is idempotent.
+     */
+    onMessage(callback: MessageChannelTransportListener): () => void;
+    /**
+     * Tear down the transport:
+     *  - remove the internal `message` listener
+     *  - call `port.close()`
+     *  - clear subscriber set and outbound buffer
+     *  - subsequent `post` calls silently no-op
+     *  - subsequent `onMessage` calls return a no-op unsubscribe
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=message-channel-transport.d.ts.map

package/dist/core/mfe-protocol/message-channel-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-channel-transport.d.ts","sourceRoot":"","sources":["../../../src/core/mfe-protocol/message-channel-transport.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,MAAM,+BAA+B,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;AAUrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBAAa,uBAAwB,YAAW,SAAS;;gBAQ5C,IAAI,EAAE,WAAW;IAI7B;;;;;;;OAOG;IACH,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAqB5B;;;;;;;;;OASG;IACH,SAAS,CAAC,QAAQ,EAAE,+BAA+B,GAAG,MAAM,IAAI;IAoBhE;;;;;;;OAOG;IACH,OAAO,IAAI,IAAI;CAyDf"}

package/dist/core/options.d.ts

@@ -0,0 +1,16 @@
+import { Surface } from './surface';
+/**
+ * Base options bag for all SDK factory functions.
+ *
+ * Individual SDKs extend this interface to add SDK-specific options.
+ */
+export interface SDKOptions {
+    /**
+     * Override the auto-detected surface.
+     *
+     * When provided, the SDK will use this value instead of the
+     * result of the runtime surface detection.
+     */
+    surface?: Surface;
+}
+//# sourceMappingURL=options.d.ts.map

package/dist/core/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/core/options.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;GAIG;AACH,MAAM,WAAW,UAAU;IAC1B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB"}

package/dist/core/platforms.d.ts

@@ -0,0 +1,229 @@
+import { DisplayMode } from './chat';
+import { Theme, ThemeMode } from './view';
+export interface OpenAISDK {
+    sendFollowUpMessage: (options: {
+        prompt: string;
+    }) => Promise<void>;
+    callTool: (toolName: string, args: Record<string, unknown>) => Promise<unknown>;
+    requestModal: (options: ModalOptions) => Promise<void>;
+    requestDisplayMode: (options: {
+        mode: DisplayMode;
+    }) => Promise<{
+        mode: DisplayMode;
+    }>;
+    toolInput: Record<string, unknown>;
+    toolOutput: Record<string, unknown> | null;
+    toolResponseMetadata: Record<string, unknown>;
+    widgetState: Record<string, unknown>;
+    setWidgetState: (state: Record<string, unknown>) => void;
+    theme: ThemeMode;
+}
+/**
+ * Salesforce ACC SDK interface exposed on window (stub)
+ * TODO: Define actual interface once specification is available
+ */
+export type SalesforceACCSDK = Record<string, unknown>;
+declare global {
+    interface Window {
+        openai?: OpenAISDK;
+        salesforceACC?: SalesforceACCSDK;
+    }
+}
+/**
+ * Message payload for chat stream
+ */
+export interface ChatMessage {
+    content: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Tool execution payload
+ */
+export interface ToolCall {
+    toolName: string;
+    params?: Record<string, unknown>;
+}
+/**
+ * Resource read request
+ */
+export interface ResourceRequest {
+    uri: string;
+}
+/**
+ * Tool input/output state
+ */
+export interface ToolState<T = unknown> {
+    data: T;
+    timestamp?: number;
+}
+/**
+ * Chat SDK API with optional methods based on surface capabilities
+ */
+export interface ChatSDK {
+    /**
+     * Send a message to the host
+     *
+     * @param message - The message to send
+     */
+    sendMessageToHost?: (message: ChatMessage) => Promise<void>;
+    /**
+     * Execute a tool on the MCP Server
+     *
+     * @param toolCall - The tool to call with parameters
+     */
+    callTool?: <T>(toolCall: ToolCall) => Promise<T>;
+    /**
+     * Access the current tool input data
+     *
+     * @returns The tool input data or null if not available
+     */
+    accessToolInput?: <T>() => ToolState<T> | null;
+    /**
+     * Access the current tool output data
+     *
+     * @returns The tool output data or null if not available
+     */
+    accessToolOutput?: <T>() => ToolState<T> | null;
+    /**
+     * Access metadata about the current tool
+     *
+     * @returns Tool metadata including schema, description, etc.
+     */
+    accessToolMetadata?: <T>() => T | null;
+    /**
+     * Get the current widget state
+     *
+     * @returns The widget state or null if not available
+     */
+    getWidgetState?: <T>() => T | null;
+    /**
+     * Set the widget state
+     *
+     * @param state - The widget state to persist
+     */
+    setWidgetState?: <T>(state: T) => void;
+    /**
+     * Read resource content by URI
+     *
+     * @param request - The resource request with URI
+     */
+    readResource?: <T>(request: ResourceRequest) => Promise<T>;
+    /**
+     * Register a callback for when tool execution is canceled
+     *
+     * @param callback - Function to call when tool is canceled
+     */
+    onToolCanceled?: (callback: () => void) => void;
+    /**
+     * Get available follow-up actions
+     *
+     * @returns Array of available actions
+     */
+    followUpActions?: <T>() => T[];
+}
+/**
+ * Message severity level
+ */
+export type MessageLevel = "info" | "success" | "warning" | "error";
+/**
+ * Alert options
+ */
+export interface AlertOptions {
+    /**
+     * The message to display
+     */
+    message: string;
+    /**
+     * The severity level of the alert (optional, defaults to "info")
+     */
+    level?: MessageLevel;
+}
+/**
+ * Toast options
+ */
+export interface ToastOptions {
+    /**
+     * The message to display
+     */
+    message: string;
+    /**
+     * The severity level of the toast (optional, defaults to "info")
+     */
+    level?: MessageLevel;
+}
+/**
+ * Modal options
+ */
+export interface ModalOptions {
+    /**
+     * Template URI for the custom modal UI
+     * Format: "ui://widget/[name].html"
+     */
+    template: string;
+    /**
+     * Parameters to pass to the modal
+     * Accessible via window.openai.view.params in the modal
+     */
+    params?: Record<string, unknown>;
+}
+/**
+ * ViewSDK API
+ */
+export interface ViewSDK {
+    /**
+     * Display an alert in the host
+     *
+     * @param options - Alert configuration options
+     * @returns Promise that resolves when the alert is displayed
+     */
+    displayAlert?(options: AlertOptions): Promise<void>;
+    /**
+     * Display a toast notification in the host
+     *
+     * @param options - Toast configuration options
+     * @returns Promise that resolves when the toast is displayed
+     */
+    displayToast?(options: ToastOptions): Promise<void>;
+    /**
+     * Display a modal in the host
+     *
+     * @param options - Modal configuration options
+     * @returns Promise that resolves when the modal is displayed
+     */
+    displayModal?(options: ModalOptions): Promise<void>;
+    /**
+     * Get the current theme
+     *
+     * @returns The current theme or null if not available
+     */
+    getTheme(): Theme | null;
+}
+export interface DataSDK {
+    /**
+     * Run a GraphQL query
+     *
+     * @param query
+     * @param variables
+     */
+    graphql?: <T, V = Record<string, unknown>>(query: string, variables?: V) => Promise<GraphQLResponse<T>>;
+    /**
+     * Make a request using the Fetch API.
+     *
+     * @param input - The URL or Request object
+     * @param init - Optional RequestInit configuration
+     * @returns Promise resolving to Response
+     */
+    fetch?: typeof fetch;
+}
+export interface GraphQLResponse<T> {
+    data: T;
+    errors?: {
+        message: string;
+        locations?: {
+            line: number;
+            column: number;
+        }[];
+        path?: string[];
+    }[];
+}
+//# sourceMappingURL=platforms.d.ts.map

package/dist/core/platforms.d.ts.map

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

package/dist/core/sdk-promise.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+/**
+ * Wraps an SDK factory Promise in a Proxy that throws a clear error if a
+ * non-Promise method is accessed, guiding callers who forgot to `await`.
+ *
+ * Symbol-keyed properties (e.g. Symbol.toStringTag, Symbol.iterator) are
+ * always forwarded so the value continues to behave as a proper thenable.
+ */
+export declare function wrapSDKPromise<T>(promise: Promise<T>, factoryName: string): Promise<T>;
+//# sourceMappingURL=sdk-promise.d.ts.map

package/dist/core/sdk-promise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-promise.d.ts","sourceRoot":"","sources":["../../src/core/sdk-promise.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAetF"}

package/dist/core/surface.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+/**
+ * Enumeration of possible runtime surfaces
+ */
+export declare enum Surface {
+    WebApp = "WebApp",
+    MicroFrontend = "Micro-Frontend",
+    OpenAI = "OpenAI",
+    SalesforceACC = "Salesforce-ACC",
+    MCPApps = "MCP-Apps",
+    Mosaic = "Mosaic"
+}
+/**
+ * Returns the surface to use for SDK initialization.
+ *
+ * Returns the override surface if provided, otherwise falls back
+ * to the auto-detected surface.
+ */
+export declare function getSurface(override?: Surface): Surface;
+//# sourceMappingURL=surface.d.ts.map

package/dist/core/surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface.d.ts","sourceRoot":"","sources":["../../src/core/surface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,oBAAY,OAAO;IAClB,MAAM,WAAW;IACjB,aAAa,mBAAmB;IAChC,MAAM,WAAW;IACjB,aAAa,mBAAmB;IAChC,OAAO,aAAa;IACpB,MAAM,WAAW;CACjB;AAoCD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAEtD"}