@agent-native/core 0.64.0 → 0.65.0

package/dist/embedding/agent.d.ts

@@ -0,0 +1,32 @@
+import { A2AClient, type Message, type Task } from "../a2a/index.js";
+export interface AgentEndpointOptions {
+    /**
+     * Optional URL base used when resolving relative app URLs.
+     */
+    base?: string;
+}
+export interface SendMessageOptions {
+    apiKey?: string;
+    contextId?: string;
+    metadata?: Record<string, unknown>;
+    requestTimeoutMs?: number;
+    /**
+     * If the target does not support streaming, fall back to async send + poll.
+     * Defaults to true.
+     */
+    fallbackToPolling?: boolean;
+    timeoutMs?: number;
+    userEmail?: string;
+    orgDomain?: string;
+    orgSecret?: string;
+}
+export declare function getMcpUrl(url: string, options?: AgentEndpointOptions): string;
+export declare function getA2AUrl(url: string, options?: AgentEndpointOptions): string;
+export declare function getAgentCardUrl(url: string, options?: AgentEndpointOptions): string;
+/**
+ * Send a text prompt to an Agent-Native A2A endpoint and yield text deltas.
+ */
+export declare function sendMessage(url: string, text: string, options?: SendMessageOptions): AsyncGenerator<string>;
+export { A2AClient };
+export type { Message, Task };
+//# sourceMappingURL=agent.d.ts.map

package/dist/embedding/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/embedding/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAa,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEhF,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAiBD,wBAAgB,SAAS,CACvB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,oBAAyB,GACjC,MAAM,CAWR;AAED,wBAAgB,SAAS,CACvB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,oBAAyB,GACjC,MAAM,CAiBR;AAED,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,oBAAyB,GACjC,MAAM,CAMR;AAoBD;;GAEG;AACH,wBAAuB,WAAW,CAChC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,kBAAuB,GAC/B,cAAc,CAAC,MAAM,CAAC,CAsCxB;AAED,OAAO,EAAE,SAAS,EAAE,CAAC;AACrB,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC"}

package/dist/embedding/agent.js

@@ -0,0 +1,110 @@
+import { A2AClient, callAgent } from "../a2a/index.js";
+function appUrl(url, options = {}) {
+    const base = options.base ??
+        (typeof window !== "undefined"
+            ? window.location.href
+            : "http://agent-native.local");
+    return new URL(url, base);
+}
+function trimEndpointPath(pathname, suffix) {
+    const normalized = pathname.replace(/\/$/, "");
+    if (!normalized.endsWith(suffix))
+        return null;
+    return normalized.slice(0, -suffix.length) || "/";
+}
+export function getMcpUrl(url, options = {}) {
+    const parsed = appUrl(url, options);
+    const trimmed = trimEndpointPath(parsed.pathname, "/_agent-native/mcp");
+    if (trimmed !== null) {
+        parsed.pathname = `${trimmed.replace(/\/$/, "")}/_agent-native/mcp`;
+    }
+    else {
+        parsed.pathname = `${parsed.pathname.replace(/\/$/, "")}/_agent-native/mcp`;
+    }
+    parsed.search = "";
+    parsed.hash = "";
+    return parsed.toString();
+}
+export function getA2AUrl(url, options = {}) {
+    const parsed = appUrl(url, options);
+    const agentNativeTrimmed = trimEndpointPath(parsed.pathname, "/_agent-native/a2a");
+    const legacyTrimmed = trimEndpointPath(parsed.pathname, "/a2a");
+    if (agentNativeTrimmed !== null) {
+        parsed.pathname = `${agentNativeTrimmed.replace(/\/$/, "")}/_agent-native/a2a`;
+    }
+    else if (legacyTrimmed !== null) {
+        parsed.pathname = `${legacyTrimmed.replace(/\/$/, "")}/_agent-native/a2a`;
+    }
+    else {
+        parsed.pathname = `${parsed.pathname.replace(/\/$/, "")}/_agent-native/a2a`;
+    }
+    parsed.search = "";
+    parsed.hash = "";
+    return parsed.toString();
+}
+export function getAgentCardUrl(url, options = {}) {
+    const parsed = appUrl(url, options);
+    parsed.pathname = "/.well-known/agent-card.json";
+    parsed.search = "";
+    parsed.hash = "";
+    return parsed.toString();
+}
+function textMessage(text) {
+    return {
+        role: "user",
+        parts: [{ type: "text", text }],
+    };
+}
+function extractTaskText(task) {
+    return (task.status.message?.parts
+        .filter((part) => {
+        return part.type === "text" && typeof part.text === "string";
+    })
+        .map((part) => part.text)
+        .join("\n") ?? "");
+}
+/**
+ * Send a text prompt to an Agent-Native A2A endpoint and yield text deltas.
+ */
+export async function* sendMessage(url, text, options = {}) {
+    const client = new A2AClient(url, options.apiKey, {
+        requestTimeoutMs: options.requestTimeoutMs,
+    });
+    const message = textMessage(text);
+    let previous = "";
+    let yielded = false;
+    try {
+        for await (const task of client.stream(message, {
+            contextId: options.contextId,
+            metadata: options.metadata,
+        })) {
+            const next = extractTaskText(task);
+            const chunk = next.startsWith(previous)
+                ? next.slice(previous.length)
+                : next;
+            previous = next;
+            if (chunk) {
+                yielded = true;
+                yield chunk;
+            }
+        }
+        return;
+    }
+    catch (error) {
+        if (yielded || options.fallbackToPolling === false)
+            throw error;
+    }
+    const answer = await callAgent(url, text, {
+        apiKey: options.apiKey,
+        contextId: options.contextId,
+        timeoutMs: options.timeoutMs,
+        userEmail: options.userEmail,
+        orgDomain: options.orgDomain,
+        orgSecret: options.orgSecret,
+        async: true,
+    });
+    if (answer)
+        yield answer;
+}
+export { A2AClient };
+//# sourceMappingURL=agent.js.map

package/dist/embedding/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/embedding/agent.ts"],"names":[],"mappings":"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","sourcesContent":["import { A2AClient, callAgent, type Message, type Task } from \"../a2a/index.js\";\n\nexport interface AgentEndpointOptions {\n  /**\n   * Optional URL base used when resolving relative app URLs.\n   */\n  base?: string;\n}\n\nexport interface SendMessageOptions {\n  apiKey?: string;\n  contextId?: string;\n  metadata?: Record<string, unknown>;\n  requestTimeoutMs?: number;\n  /**\n   * If the target does not support streaming, fall back to async send + poll.\n   * Defaults to true.\n   */\n  fallbackToPolling?: boolean;\n  timeoutMs?: number;\n  userEmail?: string;\n  orgDomain?: string;\n  orgSecret?: string;\n}\n\nfunction appUrl(url: string, options: AgentEndpointOptions = {}): URL {\n  const base =\n    options.base ??\n    (typeof window !== \"undefined\"\n      ? window.location.href\n      : \"http://agent-native.local\");\n  return new URL(url, base);\n}\n\nfunction trimEndpointPath(pathname: string, suffix: string): string | null {\n  const normalized = pathname.replace(/\\/$/, \"\");\n  if (!normalized.endsWith(suffix)) return null;\n  return normalized.slice(0, -suffix.length) || \"/\";\n}\n\nexport function getMcpUrl(\n  url: string,\n  options: AgentEndpointOptions = {},\n): string {\n  const parsed = appUrl(url, options);\n  const trimmed = trimEndpointPath(parsed.pathname, \"/_agent-native/mcp\");\n  if (trimmed !== null) {\n    parsed.pathname = `${trimmed.replace(/\\/$/, \"\")}/_agent-native/mcp`;\n  } else {\n    parsed.pathname = `${parsed.pathname.replace(/\\/$/, \"\")}/_agent-native/mcp`;\n  }\n  parsed.search = \"\";\n  parsed.hash = \"\";\n  return parsed.toString();\n}\n\nexport function getA2AUrl(\n  url: string,\n  options: AgentEndpointOptions = {},\n): string {\n  const parsed = appUrl(url, options);\n  const agentNativeTrimmed = trimEndpointPath(\n    parsed.pathname,\n    \"/_agent-native/a2a\",\n  );\n  const legacyTrimmed = trimEndpointPath(parsed.pathname, \"/a2a\");\n  if (agentNativeTrimmed !== null) {\n    parsed.pathname = `${agentNativeTrimmed.replace(/\\/$/, \"\")}/_agent-native/a2a`;\n  } else if (legacyTrimmed !== null) {\n    parsed.pathname = `${legacyTrimmed.replace(/\\/$/, \"\")}/_agent-native/a2a`;\n  } else {\n    parsed.pathname = `${parsed.pathname.replace(/\\/$/, \"\")}/_agent-native/a2a`;\n  }\n  parsed.search = \"\";\n  parsed.hash = \"\";\n  return parsed.toString();\n}\n\nexport function getAgentCardUrl(\n  url: string,\n  options: AgentEndpointOptions = {},\n): string {\n  const parsed = appUrl(url, options);\n  parsed.pathname = \"/.well-known/agent-card.json\";\n  parsed.search = \"\";\n  parsed.hash = \"\";\n  return parsed.toString();\n}\n\nfunction textMessage(text: string): Message {\n  return {\n    role: \"user\",\n    parts: [{ type: \"text\", text }],\n  };\n}\n\nfunction extractTaskText(task: Task): string {\n  return (\n    task.status.message?.parts\n      .filter((part): part is { type: \"text\"; text: string } => {\n        return part.type === \"text\" && typeof part.text === \"string\";\n      })\n      .map((part) => part.text)\n      .join(\"\\n\") ?? \"\"\n  );\n}\n\n/**\n * Send a text prompt to an Agent-Native A2A endpoint and yield text deltas.\n */\nexport async function* sendMessage(\n  url: string,\n  text: string,\n  options: SendMessageOptions = {},\n): AsyncGenerator<string> {\n  const client = new A2AClient(url, options.apiKey, {\n    requestTimeoutMs: options.requestTimeoutMs,\n  });\n  const message = textMessage(text);\n  let previous = \"\";\n  let yielded = false;\n\n  try {\n    for await (const task of client.stream(message, {\n      contextId: options.contextId,\n      metadata: options.metadata,\n    })) {\n      const next = extractTaskText(task);\n      const chunk = next.startsWith(previous)\n        ? next.slice(previous.length)\n        : next;\n      previous = next;\n      if (chunk) {\n        yielded = true;\n        yield chunk;\n      }\n    }\n    return;\n  } catch (error) {\n    if (yielded || options.fallbackToPolling === false) throw error;\n  }\n\n  const answer = await callAgent(url, text, {\n    apiKey: options.apiKey,\n    contextId: options.contextId,\n    timeoutMs: options.timeoutMs,\n    userEmail: options.userEmail,\n    orgDomain: options.orgDomain,\n    orgSecret: options.orgSecret,\n    async: true,\n  });\n  if (answer) yield answer;\n}\n\nexport { A2AClient };\nexport type { Message, Task };\n"]}

package/dist/embedding/bridge.d.ts

@@ -0,0 +1,37 @@
+export interface EmbeddedAppMessageEvent<TPayload = unknown> {
+    name: string;
+    payload: TPayload;
+    event: MessageEvent;
+}
+export type EmbeddedAppMessageHandler = (message: EmbeddedAppMessageEvent) => void;
+export type EmbeddedAppRequestHandler = (message: EmbeddedAppMessageEvent) => unknown | Promise<unknown>;
+export interface EmbeddedAppBridgeOptions {
+    /**
+     * Exact parent origin to post back to. Defaults to document.referrer's
+     * origin when available. If no origin can be resolved, sends fail closed.
+     */
+    parentOrigin?: string;
+    /**
+     * Origins allowed to send messages to the embedded app. Defaults to the
+     * resolved parent origin.
+     */
+    allowedOrigins?: string[];
+    onMessage?: EmbeddedAppMessageHandler;
+    onRequest?: EmbeddedAppRequestHandler;
+    targetWindow?: Window | null;
+    currentWindow?: Window;
+}
+export interface EmbeddedAppBridge {
+    parentOrigin: string | null;
+    postMessage<TPayload = unknown>(name: string, payload?: TPayload): boolean;
+    request<TResult = unknown, TPayload = unknown>(name: string, payload?: TPayload, options?: {
+        timeoutMs?: number;
+    }): Promise<TResult>;
+    ready<TPayload = unknown>(payload?: TPayload): boolean;
+    close<TPayload = unknown>(payload?: TPayload): boolean;
+    destroy(): void;
+}
+export declare function createEmbeddedAppBridge(options?: EmbeddedAppBridgeOptions): EmbeddedAppBridge;
+export declare function sendEmbeddedAppMessage<TPayload = unknown>(name: string, payload?: TPayload, options?: Pick<EmbeddedAppBridgeOptions, "currentWindow" | "parentOrigin" | "targetWindow">): boolean;
+export declare function announceEmbeddedAppReady<TPayload = unknown>(payload?: TPayload, options?: Pick<EmbeddedAppBridgeOptions, "currentWindow" | "parentOrigin" | "targetWindow">): boolean;
+//# sourceMappingURL=bridge.d.ts.map

package/dist/embedding/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/embedding/bridge.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,uBAAuB,CAAC,QAAQ,GAAG,OAAO;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,QAAQ,CAAC;IAClB,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,MAAM,yBAAyB,GAAG,CACtC,OAAO,EAAE,uBAAuB,KAC7B,IAAI,CAAC;AAEV,MAAM,MAAM,yBAAyB,GAAG,CACtC,OAAO,EAAE,uBAAuB,KAC7B,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEhC,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,yBAAyB,CAAC;IACtC,SAAS,CAAC,EAAE,yBAAyB,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,CAAC,QAAQ,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC3E,OAAO,CAAC,OAAO,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO,EAC3C,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/B,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,KAAK,CAAC,QAAQ,GAAG,OAAO,EAAE,OAAO,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IACvD,KAAK,CAAC,QAAQ,GAAG,OAAO,EAAE,OAAO,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IACvD,OAAO,IAAI,IAAI,CAAC;CACjB;AA2BD,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,wBAA6B,GACrC,iBAAiB,CA6InB;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,GAAG,OAAO,EACvD,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,QAAQ,EAClB,OAAO,GAAE,IAAI,CACX,wBAAwB,EACxB,eAAe,GAAG,cAAc,GAAG,cAAc,CAC7C,GACL,OAAO,CAYT;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,GAAG,OAAO,EACzD,OAAO,CAAC,EAAE,QAAQ,EAClB,OAAO,GAAE,IAAI,CACX,wBAAwB,EACxB,eAAe,GAAG,cAAc,GAAG,cAAc,CAC7C,GACL,OAAO,CAWT"}

package/dist/embedding/bridge.js

@@ -0,0 +1,148 @@
+import { AGENT_NATIVE_EMBED_MESSAGE_TYPES, createAgentNativeEmbedEnvelope, createEmbeddedAppRequestId, embeddedAppOrigin, isAgentNativeEmbedEnvelope, isAllowedEmbeddedAppOrigin, messageErrorPayload, } from "./protocol.js";
+function resolveParentOrigin(win, explicit) {
+    if (explicit)
+        return explicit;
+    const referrerOrigin = embeddedAppOrigin(win.document?.referrer ?? "");
+    return referrerOrigin;
+}
+function postToParent(win, parent, parentOrigin, envelope) {
+    const target = parent ?? (win.parent === win ? null : win.parent);
+    if (!parentOrigin)
+        return false;
+    if (!target)
+        return false;
+    target.postMessage(envelope, parentOrigin);
+    return true;
+}
+export function createEmbeddedAppBridge(options = {}) {
+    const win = options.currentWindow ?? window;
+    const parentOrigin = resolveParentOrigin(win, options.parentOrigin);
+    const allowedOrigins = options.allowedOrigins ??
+        (parentOrigin && parentOrigin !== "*" ? [parentOrigin] : []);
+    const pending = new Map();
+    let destroyed = false;
+    const postEnvelope = (envelope) => postToParent(win, options.targetWindow ?? null, parentOrigin, envelope);
+    const listener = (event) => {
+        if (destroyed)
+            return;
+        if (!isAllowedEmbeddedAppOrigin(event.origin, allowedOrigins))
+            return;
+        if (!isAgentNativeEmbedEnvelope(event.data))
+            return;
+        const envelope = event.data;
+        if (envelope.type === AGENT_NATIVE_EMBED_MESSAGE_TYPES.RESPONSE) {
+            const requestId = envelope.requestId;
+            if (!requestId)
+                return;
+            const entry = pending.get(requestId);
+            if (!entry)
+                return;
+            pending.delete(requestId);
+            if (entry.timer)
+                clearTimeout(entry.timer);
+            entry.resolve(envelope.payload);
+            return;
+        }
+        if (envelope.type === AGENT_NATIVE_EMBED_MESSAGE_TYPES.ERROR) {
+            const requestId = envelope.requestId;
+            if (!requestId)
+                return;
+            const entry = pending.get(requestId);
+            if (!entry)
+                return;
+            pending.delete(requestId);
+            if (entry.timer)
+                clearTimeout(entry.timer);
+            entry.reject(new Error(envelope.error?.message ?? "Embedded app error"));
+            return;
+        }
+        if (!envelope.name)
+            return;
+        const message = {
+            name: envelope.name,
+            payload: envelope.payload,
+            event,
+        };
+        if (envelope.type === AGENT_NATIVE_EMBED_MESSAGE_TYPES.REQUEST) {
+            Promise.resolve(options.onRequest?.(message))
+                .then((payload) => {
+                postEnvelope(createAgentNativeEmbedEnvelope(AGENT_NATIVE_EMBED_MESSAGE_TYPES.RESPONSE, { requestId: envelope.requestId, payload }));
+            })
+                .catch((error) => {
+                postEnvelope(createAgentNativeEmbedEnvelope(AGENT_NATIVE_EMBED_MESSAGE_TYPES.ERROR, {
+                    requestId: envelope.requestId,
+                    error: messageErrorPayload(error),
+                }));
+            });
+            return;
+        }
+        if (envelope.type === AGENT_NATIVE_EMBED_MESSAGE_TYPES.MESSAGE) {
+            options.onMessage?.(message);
+        }
+    };
+    win.addEventListener("message", listener);
+    return {
+        parentOrigin,
+        postMessage(name, payload) {
+            return postEnvelope(createAgentNativeEmbedEnvelope(AGENT_NATIVE_EMBED_MESSAGE_TYPES.MESSAGE, { name, payload }));
+        },
+        request(name, payload, requestOptions) {
+            const requestId = createEmbeddedAppRequestId();
+            return new Promise((resolve, reject) => {
+                const timeoutMs = requestOptions?.timeoutMs ?? 30_000;
+                const timer = timeoutMs > 0
+                    ? setTimeout(() => {
+                        pending.delete(requestId);
+                        reject(new Error(`Embedded app request timed out: ${name}`));
+                    }, timeoutMs)
+                    : undefined;
+                pending.set(requestId, {
+                    resolve: (value) => resolve(value),
+                    reject,
+                    timer,
+                });
+                const posted = postEnvelope(createAgentNativeEmbedEnvelope(AGENT_NATIVE_EMBED_MESSAGE_TYPES.REQUEST, { name, payload, requestId }));
+                if (!posted) {
+                    pending.delete(requestId);
+                    if (timer)
+                        clearTimeout(timer);
+                    reject(new Error("Embedded app parent window is not available"));
+                }
+            });
+        },
+        ready(payload) {
+            return postEnvelope(createAgentNativeEmbedEnvelope(AGENT_NATIVE_EMBED_MESSAGE_TYPES.READY, {
+                payload,
+            }));
+        },
+        close(payload) {
+            return this.postMessage("close", payload);
+        },
+        destroy() {
+            destroyed = true;
+            win.removeEventListener("message", listener);
+            for (const entry of pending.values()) {
+                if (entry.timer)
+                    clearTimeout(entry.timer);
+                entry.reject(new Error("Embedded app bridge destroyed"));
+            }
+            pending.clear();
+        },
+    };
+}
+export function sendEmbeddedAppMessage(name, payload, options = {}) {
+    const win = options.currentWindow ?? window;
+    const parentOrigin = resolveParentOrigin(win, options.parentOrigin);
+    return postToParent(win, options.targetWindow ?? null, parentOrigin, createAgentNativeEmbedEnvelope(AGENT_NATIVE_EMBED_MESSAGE_TYPES.MESSAGE, {
+        name,
+        payload,
+    }));
+}
+export function announceEmbeddedAppReady(payload, options = {}) {
+    const win = options.currentWindow ?? window;
+    const parentOrigin = resolveParentOrigin(win, options.parentOrigin);
+    return postToParent(win, options.targetWindow ?? null, parentOrigin, createAgentNativeEmbedEnvelope(AGENT_NATIVE_EMBED_MESSAGE_TYPES.READY, {
+        payload,
+    }));
+}
+//# sourceMappingURL=bridge.js.map

package/dist/embedding/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../src/embedding/bridge.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  AGENT_NATIVE_EMBED_MESSAGE_TYPES,\n  createAgentNativeEmbedEnvelope,\n  createEmbeddedAppRequestId,\n  embeddedAppOrigin,\n  isAgentNativeEmbedEnvelope,\n  isAllowedEmbeddedAppOrigin,\n  messageErrorPayload,\n  type AgentNativeEmbedEnvelope,\n} from \"./protocol.js\";\n\nexport interface EmbeddedAppMessageEvent<TPayload = unknown> {\n  name: string;\n  payload: TPayload;\n  event: MessageEvent;\n}\n\nexport type EmbeddedAppMessageHandler = (\n  message: EmbeddedAppMessageEvent,\n) => void;\n\nexport type EmbeddedAppRequestHandler = (\n  message: EmbeddedAppMessageEvent,\n) => unknown | Promise<unknown>;\n\nexport interface EmbeddedAppBridgeOptions {\n  /**\n   * Exact parent origin to post back to. Defaults to document.referrer's\n   * origin when available. If no origin can be resolved, sends fail closed.\n   */\n  parentOrigin?: string;\n  /**\n   * Origins allowed to send messages to the embedded app. Defaults to the\n   * resolved parent origin.\n   */\n  allowedOrigins?: string[];\n  onMessage?: EmbeddedAppMessageHandler;\n  onRequest?: EmbeddedAppRequestHandler;\n  targetWindow?: Window | null;\n  currentWindow?: Window;\n}\n\nexport interface EmbeddedAppBridge {\n  parentOrigin: string | null;\n  postMessage<TPayload = unknown>(name: string, payload?: TPayload): boolean;\n  request<TResult = unknown, TPayload = unknown>(\n    name: string,\n    payload?: TPayload,\n    options?: { timeoutMs?: number },\n  ): Promise<TResult>;\n  ready<TPayload = unknown>(payload?: TPayload): boolean;\n  close<TPayload = unknown>(payload?: TPayload): boolean;\n  destroy(): void;\n}\n\ntype PendingRequest = {\n  resolve: (value: unknown) => void;\n  reject: (error: Error) => void;\n  timer: ReturnType<typeof setTimeout> | undefined;\n};\n\nfunction resolveParentOrigin(win: Window, explicit?: string): string | null {\n  if (explicit) return explicit;\n  const referrerOrigin = embeddedAppOrigin(win.document?.referrer ?? \"\");\n  return referrerOrigin;\n}\n\nfunction postToParent(\n  win: Window,\n  parent: Window | null,\n  parentOrigin: string | null,\n  envelope: AgentNativeEmbedEnvelope,\n): boolean {\n  const target = parent ?? (win.parent === win ? null : win.parent);\n  if (!parentOrigin) return false;\n  if (!target) return false;\n  target.postMessage(envelope, parentOrigin);\n  return true;\n}\n\nexport function createEmbeddedAppBridge(\n  options: EmbeddedAppBridgeOptions = {},\n): EmbeddedAppBridge {\n  const win = options.currentWindow ?? window;\n  const parentOrigin = resolveParentOrigin(win, options.parentOrigin);\n  const allowedOrigins =\n    options.allowedOrigins ??\n    (parentOrigin && parentOrigin !== \"*\" ? [parentOrigin] : []);\n  const pending = new Map<string, PendingRequest>();\n  let destroyed = false;\n\n  const postEnvelope = (envelope: AgentNativeEmbedEnvelope) =>\n    postToParent(win, options.targetWindow ?? null, parentOrigin, envelope);\n\n  const listener = (event: MessageEvent) => {\n    if (destroyed) return;\n    if (!isAllowedEmbeddedAppOrigin(event.origin, allowedOrigins)) return;\n    if (!isAgentNativeEmbedEnvelope(event.data)) return;\n\n    const envelope = event.data;\n    if (envelope.type === AGENT_NATIVE_EMBED_MESSAGE_TYPES.RESPONSE) {\n      const requestId = envelope.requestId;\n      if (!requestId) return;\n      const entry = pending.get(requestId);\n      if (!entry) return;\n      pending.delete(requestId);\n      if (entry.timer) clearTimeout(entry.timer);\n      entry.resolve(envelope.payload);\n      return;\n    }\n\n    if (envelope.type === AGENT_NATIVE_EMBED_MESSAGE_TYPES.ERROR) {\n      const requestId = envelope.requestId;\n      if (!requestId) return;\n      const entry = pending.get(requestId);\n      if (!entry) return;\n      pending.delete(requestId);\n      if (entry.timer) clearTimeout(entry.timer);\n      entry.reject(new Error(envelope.error?.message ?? \"Embedded app error\"));\n      return;\n    }\n\n    if (!envelope.name) return;\n    const message = {\n      name: envelope.name,\n      payload: envelope.payload,\n      event,\n    } satisfies EmbeddedAppMessageEvent;\n\n    if (envelope.type === AGENT_NATIVE_EMBED_MESSAGE_TYPES.REQUEST) {\n      Promise.resolve(options.onRequest?.(message))\n        .then((payload) => {\n          postEnvelope(\n            createAgentNativeEmbedEnvelope(\n              AGENT_NATIVE_EMBED_MESSAGE_TYPES.RESPONSE,\n              { requestId: envelope.requestId, payload },\n            ),\n          );\n        })\n        .catch((error) => {\n          postEnvelope(\n            createAgentNativeEmbedEnvelope(\n              AGENT_NATIVE_EMBED_MESSAGE_TYPES.ERROR,\n              {\n                requestId: envelope.requestId,\n                error: messageErrorPayload(error),\n              },\n            ),\n          );\n        });\n      return;\n    }\n\n    if (envelope.type === AGENT_NATIVE_EMBED_MESSAGE_TYPES.MESSAGE) {\n      options.onMessage?.(message);\n    }\n  };\n\n  win.addEventListener(\"message\", listener);\n\n  return {\n    parentOrigin,\n    postMessage(name, payload) {\n      return postEnvelope(\n        createAgentNativeEmbedEnvelope(\n          AGENT_NATIVE_EMBED_MESSAGE_TYPES.MESSAGE,\n          { name, payload },\n        ),\n      );\n    },\n    request<TResult = unknown, TPayload = unknown>(\n      name: string,\n      payload?: TPayload,\n      requestOptions?: { timeoutMs?: number },\n    ) {\n      const requestId = createEmbeddedAppRequestId();\n      return new Promise<TResult>((resolve, reject) => {\n        const timeoutMs = requestOptions?.timeoutMs ?? 30_000;\n        const timer =\n          timeoutMs > 0\n            ? setTimeout(() => {\n                pending.delete(requestId);\n                reject(new Error(`Embedded app request timed out: ${name}`));\n              }, timeoutMs)\n            : undefined;\n        pending.set(requestId, {\n          resolve: (value) => resolve(value as TResult),\n          reject,\n          timer,\n        });\n        const posted = postEnvelope(\n          createAgentNativeEmbedEnvelope(\n            AGENT_NATIVE_EMBED_MESSAGE_TYPES.REQUEST,\n            { name, payload, requestId },\n          ),\n        );\n        if (!posted) {\n          pending.delete(requestId);\n          if (timer) clearTimeout(timer);\n          reject(new Error(\"Embedded app parent window is not available\"));\n        }\n      });\n    },\n    ready(payload) {\n      return postEnvelope(\n        createAgentNativeEmbedEnvelope(AGENT_NATIVE_EMBED_MESSAGE_TYPES.READY, {\n          payload,\n        }),\n      );\n    },\n    close(payload) {\n      return this.postMessage(\"close\", payload);\n    },\n    destroy() {\n      destroyed = true;\n      win.removeEventListener(\"message\", listener);\n      for (const entry of pending.values()) {\n        if (entry.timer) clearTimeout(entry.timer);\n        entry.reject(new Error(\"Embedded app bridge destroyed\"));\n      }\n      pending.clear();\n    },\n  };\n}\n\nexport function sendEmbeddedAppMessage<TPayload = unknown>(\n  name: string,\n  payload?: TPayload,\n  options: Pick<\n    EmbeddedAppBridgeOptions,\n    \"currentWindow\" | \"parentOrigin\" | \"targetWindow\"\n  > = {},\n): boolean {\n  const win = options.currentWindow ?? window;\n  const parentOrigin = resolveParentOrigin(win, options.parentOrigin);\n  return postToParent(\n    win,\n    options.targetWindow ?? null,\n    parentOrigin,\n    createAgentNativeEmbedEnvelope(AGENT_NATIVE_EMBED_MESSAGE_TYPES.MESSAGE, {\n      name,\n      payload,\n    }),\n  );\n}\n\nexport function announceEmbeddedAppReady<TPayload = unknown>(\n  payload?: TPayload,\n  options: Pick<\n    EmbeddedAppBridgeOptions,\n    \"currentWindow\" | \"parentOrigin\" | \"targetWindow\"\n  > = {},\n): boolean {\n  const win = options.currentWindow ?? window;\n  const parentOrigin = resolveParentOrigin(win, options.parentOrigin);\n  return postToParent(\n    win,\n    options.targetWindow ?? null,\n    parentOrigin,\n    createAgentNativeEmbedEnvelope(AGENT_NATIVE_EMBED_MESSAGE_TYPES.READY, {\n      payload,\n    }),\n  );\n}\n"]}

package/dist/embedding/index.d.ts

@@ -0,0 +1,5 @@
+export { EmbeddedApp, type EmbeddedAppMessageInfo, type EmbeddedAppProps, type EmbeddedAppRef, } from "./react.js";
+export { announceEmbeddedAppReady, createEmbeddedAppBridge, sendEmbeddedAppMessage, type EmbeddedAppBridge, type EmbeddedAppBridgeOptions, type EmbeddedAppMessageEvent, type EmbeddedAppMessageHandler, type EmbeddedAppRequestHandler, } from "./bridge.js";
+export { A2AClient, getA2AUrl, getAgentCardUrl, getMcpUrl, sendMessage, type AgentEndpointOptions, type Message, type SendMessageOptions, type Task, } from "./agent.js";
+export { AGENT_NATIVE_EMBED_MESSAGE_TYPES, AGENT_NATIVE_EMBED_PROTOCOL, AGENT_NATIVE_EMBED_VERSION, createAgentNativeEmbedEnvelope, createEmbeddedAppRequestId, embeddedAppOrigin, isAgentNativeEmbedEnvelope, isAllowedEmbeddedAppOrigin, messageErrorPayload, withEmbeddedAppParams, type AgentNativeEmbedEnvelope, type AgentNativeEmbedErrorPayload, type AgentNativeEmbedMessageType, type EmbeddedAppUrlOptions, } from "./protocol.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/embedding/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/embedding/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,GAC/B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,SAAS,EACT,SAAS,EACT,eAAe,EACf,SAAS,EACT,WAAW,EACX,KAAK,oBAAoB,EACzB,KAAK,OAAO,EACZ,KAAK,kBAAkB,EACvB,KAAK,IAAI,GACV,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,gCAAgC,EAChC,2BAA2B,EAC3B,0BAA0B,EAC1B,8BAA8B,EAC9B,0BAA0B,EAC1B,iBAAiB,EACjB,0BAA0B,EAC1B,0BAA0B,EAC1B,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EAChC,KAAK,qBAAqB,GAC3B,MAAM,eAAe,CAAC"}

package/dist/embedding/index.js

@@ -0,0 +1,5 @@
+export { EmbeddedApp, } from "./react.js";
+export { announceEmbeddedAppReady, createEmbeddedAppBridge, sendEmbeddedAppMessage, } from "./bridge.js";
+export { A2AClient, getA2AUrl, getAgentCardUrl, getMcpUrl, sendMessage, } from "./agent.js";
+export { AGENT_NATIVE_EMBED_MESSAGE_TYPES, AGENT_NATIVE_EMBED_PROTOCOL, AGENT_NATIVE_EMBED_VERSION, createAgentNativeEmbedEnvelope, createEmbeddedAppRequestId, embeddedAppOrigin, isAgentNativeEmbedEnvelope, isAllowedEmbeddedAppOrigin, messageErrorPayload, withEmbeddedAppParams, } from "./protocol.js";
+//# sourceMappingURL=index.js.map

package/dist/embedding/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/embedding/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,GAIZ,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,GAMvB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,SAAS,EACT,SAAS,EACT,eAAe,EACf,SAAS,EACT,WAAW,GAKZ,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,gCAAgC,EAChC,2BAA2B,EAC3B,0BAA0B,EAC1B,8BAA8B,EAC9B,0BAA0B,EAC1B,iBAAiB,EACjB,0BAA0B,EAC1B,0BAA0B,EAC1B,mBAAmB,EACnB,qBAAqB,GAKtB,MAAM,eAAe,CAAC","sourcesContent":["export {\n  EmbeddedApp,\n  type EmbeddedAppMessageInfo,\n  type EmbeddedAppProps,\n  type EmbeddedAppRef,\n} from \"./react.js\";\nexport {\n  announceEmbeddedAppReady,\n  createEmbeddedAppBridge,\n  sendEmbeddedAppMessage,\n  type EmbeddedAppBridge,\n  type EmbeddedAppBridgeOptions,\n  type EmbeddedAppMessageEvent,\n  type EmbeddedAppMessageHandler,\n  type EmbeddedAppRequestHandler,\n} from \"./bridge.js\";\nexport {\n  A2AClient,\n  getA2AUrl,\n  getAgentCardUrl,\n  getMcpUrl,\n  sendMessage,\n  type AgentEndpointOptions,\n  type Message,\n  type SendMessageOptions,\n  type Task,\n} from \"./agent.js\";\nexport {\n  AGENT_NATIVE_EMBED_MESSAGE_TYPES,\n  AGENT_NATIVE_EMBED_PROTOCOL,\n  AGENT_NATIVE_EMBED_VERSION,\n  createAgentNativeEmbedEnvelope,\n  createEmbeddedAppRequestId,\n  embeddedAppOrigin,\n  isAgentNativeEmbedEnvelope,\n  isAllowedEmbeddedAppOrigin,\n  messageErrorPayload,\n  withEmbeddedAppParams,\n  type AgentNativeEmbedEnvelope,\n  type AgentNativeEmbedErrorPayload,\n  type AgentNativeEmbedMessageType,\n  type EmbeddedAppUrlOptions,\n} from \"./protocol.js\";\n"]}

package/dist/embedding/protocol.d.ts

@@ -0,0 +1,46 @@
+export declare const AGENT_NATIVE_EMBED_PROTOCOL: "agent-native.embed";
+export declare const AGENT_NATIVE_EMBED_VERSION: 1;
+export declare const AGENT_NATIVE_EMBED_MESSAGE_TYPES: {
+    readonly READY: "ready";
+    readonly MESSAGE: "message";
+    readonly REQUEST: "request";
+    readonly RESPONSE: "response";
+    readonly ERROR: "error";
+};
+export type AgentNativeEmbedMessageType = (typeof AGENT_NATIVE_EMBED_MESSAGE_TYPES)[keyof typeof AGENT_NATIVE_EMBED_MESSAGE_TYPES];
+export interface AgentNativeEmbedErrorPayload {
+    message: string;
+    code?: string;
+}
+export interface AgentNativeEmbedEnvelope<TPayload = unknown> {
+    protocol: typeof AGENT_NATIVE_EMBED_PROTOCOL;
+    version: typeof AGENT_NATIVE_EMBED_VERSION;
+    type: AgentNativeEmbedMessageType;
+    name?: string;
+    payload?: TPayload;
+    requestId?: string;
+    error?: AgentNativeEmbedErrorPayload;
+}
+export interface EmbeddedAppUrlOptions {
+    /**
+     * Add the framework's embedded route marker. Defaults to true.
+     */
+    embedded?: boolean;
+    /**
+     * Extra query params to include in the iframe URL.
+     */
+    params?: Record<string, string | number | boolean | null | undefined>;
+}
+export declare function isAgentNativeEmbedEnvelope(value: unknown): value is AgentNativeEmbedEnvelope;
+export declare function createAgentNativeEmbedEnvelope<TPayload>(type: AgentNativeEmbedMessageType, options?: {
+    name?: string;
+    payload?: TPayload;
+    requestId?: string;
+    error?: AgentNativeEmbedErrorPayload;
+}): AgentNativeEmbedEnvelope<TPayload>;
+export declare function embeddedAppOrigin(url: string, base?: string): string | null;
+export declare function isAllowedEmbeddedAppOrigin(origin: string, allowedOrigins: readonly string[] | undefined): boolean;
+export declare function withEmbeddedAppParams(url: string, options?: EmbeddedAppUrlOptions): string;
+export declare function createEmbeddedAppRequestId(): string;
+export declare function messageErrorPayload(error: unknown): AgentNativeEmbedErrorPayload;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/embedding/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/embedding/protocol.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,EAAG,oBAA6B,CAAC;AACzE,eAAO,MAAM,0BAA0B,EAAG,CAAU,CAAC;AAErD,eAAO,MAAM,gCAAgC;;;;;;CAMnC,CAAC;AAEX,MAAM,MAAM,2BAA2B,GACrC,CAAC,OAAO,gCAAgC,CAAC,CAAC,MAAM,OAAO,gCAAgC,CAAC,CAAC;AAE3F,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB,CAAC,QAAQ,GAAG,OAAO;IAC1D,QAAQ,EAAE,OAAO,2BAA2B,CAAC;IAC7C,OAAO,EAAE,OAAO,0BAA0B,CAAC;IAC3C,IAAI,EAAE,2BAA2B,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,4BAA4B,CAAC;CACtC;AAED,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CACvE;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,wBAAwB,CAuCnC;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,EACrD,IAAI,EAAE,2BAA2B,EACjC,OAAO,GAAE;IACP,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,4BAA4B,CAAC;CACjC,GACL,wBAAwB,CAAC,QAAQ,CAAC,CAOpC;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW3E;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAC5C,OAAO,CAKT;AAED,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,qBAA0B,GAClC,MAAM,CAyCR;AAED,wBAAgB,0BAA0B,IAAI,MAAM,CAQnD;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,GACb,4BAA4B,CAG9B"}

package/dist/embedding/protocol.js

@@ -0,0 +1,122 @@
+export const AGENT_NATIVE_EMBED_PROTOCOL = "agent-native.embed";
+export const AGENT_NATIVE_EMBED_VERSION = 1;
+export const AGENT_NATIVE_EMBED_MESSAGE_TYPES = {
+    READY: "ready",
+    MESSAGE: "message",
+    REQUEST: "request",
+    RESPONSE: "response",
+    ERROR: "error",
+};
+export function isAgentNativeEmbedEnvelope(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return false;
+    }
+    const candidate = value;
+    if (candidate.protocol !== AGENT_NATIVE_EMBED_PROTOCOL ||
+        candidate.version !== AGENT_NATIVE_EMBED_VERSION ||
+        typeof candidate.type !== "string" ||
+        !Object.values(AGENT_NATIVE_EMBED_MESSAGE_TYPES).includes(candidate.type)) {
+        return false;
+    }
+    if (candidate.name !== undefined && typeof candidate.name !== "string") {
+        return false;
+    }
+    if (candidate.requestId !== undefined &&
+        typeof candidate.requestId !== "string") {
+        return false;
+    }
+    if (candidate.error !== undefined) {
+        if (!candidate.error ||
+            typeof candidate.error !== "object" ||
+            Array.isArray(candidate.error)) {
+            return false;
+        }
+        const error = candidate.error;
+        if (typeof error.message !== "string")
+            return false;
+        if (error.code !== undefined && typeof error.code !== "string") {
+            return false;
+        }
+    }
+    return true;
+}
+export function createAgentNativeEmbedEnvelope(type, options = {}) {
+    return {
+        protocol: AGENT_NATIVE_EMBED_PROTOCOL,
+        version: AGENT_NATIVE_EMBED_VERSION,
+        type,
+        ...options,
+    };
+}
+export function embeddedAppOrigin(url, base) {
+    try {
+        const resolvedBase = base ??
+            (typeof window !== "undefined"
+                ? window.location.href
+                : "http://agent-native.local");
+        return new URL(url, resolvedBase).origin;
+    }
+    catch {
+        return null;
+    }
+}
+export function isAllowedEmbeddedAppOrigin(origin, allowedOrigins) {
+    if (!allowedOrigins?.length)
+        return false;
+    return allowedOrigins.some((allowed) => allowed === "*" || allowed === origin);
+}
+export function withEmbeddedAppParams(url, options = {}) {
+    const shouldMarkEmbedded = options.embedded ?? true;
+    const hasScheme = /^[a-z][a-z0-9+.-]*:/i.test(url);
+    const isProtocolRelative = url.startsWith("//");
+    const isAbsolutePath = url.startsWith("/");
+    const isRelative = !hasScheme && !isProtocolRelative;
+    try {
+        const base = typeof window !== "undefined"
+            ? window.location.href
+            : "http://agent-native.local";
+        const parsed = new URL(url, base);
+        if (shouldMarkEmbedded && !parsed.searchParams.has("embedded")) {
+            parsed.searchParams.set("embedded", "1");
+        }
+        for (const [key, value] of Object.entries(options.params ?? {})) {
+            if (value === undefined || value === null)
+                continue;
+            parsed.searchParams.set(key, String(value));
+        }
+        if (isRelative) {
+            const path = `${parsed.pathname}${parsed.search}${parsed.hash}`;
+            return isAbsolutePath ? path : path.replace(/^\//, "");
+        }
+        return parsed.toString();
+    }
+    catch {
+        const [beforeHash, hash = ""] = url.split("#", 2);
+        const separator = beforeHash.includes("?") ? "&" : "?";
+        const params = new URLSearchParams();
+        if (shouldMarkEmbedded)
+            params.set("embedded", "1");
+        for (const [key, value] of Object.entries(options.params ?? {})) {
+            if (value === undefined || value === null)
+                continue;
+            params.set(key, String(value));
+        }
+        const query = params.toString();
+        if (!query)
+            return url;
+        return `${beforeHash}${separator}${query}${hash ? `#${hash}` : ""}`;
+    }
+}
+export function createEmbeddedAppRequestId() {
+    if (typeof crypto !== "undefined" &&
+        typeof crypto.randomUUID === "function") {
+        return `embed-${crypto.randomUUID()}`;
+    }
+    return `embed-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
+}
+export function messageErrorPayload(error) {
+    if (error instanceof Error)
+        return { message: error.message };
+    return { message: String(error) };
+}
+//# sourceMappingURL=protocol.js.map

package/dist/embedding/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/embedding/protocol.ts"],"names":[],"mappings":"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","sourcesContent":["export const AGENT_NATIVE_EMBED_PROTOCOL = \"agent-native.embed\" as const;\nexport const AGENT_NATIVE_EMBED_VERSION = 1 as const;\n\nexport const AGENT_NATIVE_EMBED_MESSAGE_TYPES = {\n  READY: \"ready\",\n  MESSAGE: \"message\",\n  REQUEST: \"request\",\n  RESPONSE: \"response\",\n  ERROR: \"error\",\n} as const;\n\nexport type AgentNativeEmbedMessageType =\n  (typeof AGENT_NATIVE_EMBED_MESSAGE_TYPES)[keyof typeof AGENT_NATIVE_EMBED_MESSAGE_TYPES];\n\nexport interface AgentNativeEmbedErrorPayload {\n  message: string;\n  code?: string;\n}\n\nexport interface AgentNativeEmbedEnvelope<TPayload = unknown> {\n  protocol: typeof AGENT_NATIVE_EMBED_PROTOCOL;\n  version: typeof AGENT_NATIVE_EMBED_VERSION;\n  type: AgentNativeEmbedMessageType;\n  name?: string;\n  payload?: TPayload;\n  requestId?: string;\n  error?: AgentNativeEmbedErrorPayload;\n}\n\nexport interface EmbeddedAppUrlOptions {\n  /**\n   * Add the framework's embedded route marker. Defaults to true.\n   */\n  embedded?: boolean;\n  /**\n   * Extra query params to include in the iframe URL.\n   */\n  params?: Record<string, string | number | boolean | null | undefined>;\n}\n\nexport function isAgentNativeEmbedEnvelope(\n  value: unknown,\n): value is AgentNativeEmbedEnvelope {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n    return false;\n  }\n  const candidate = value as Partial<AgentNativeEmbedEnvelope>;\n  if (\n    candidate.protocol !== AGENT_NATIVE_EMBED_PROTOCOL ||\n    candidate.version !== AGENT_NATIVE_EMBED_VERSION ||\n    typeof candidate.type !== \"string\" ||\n    !Object.values(AGENT_NATIVE_EMBED_MESSAGE_TYPES).includes(\n      candidate.type as AgentNativeEmbedMessageType,\n    )\n  ) {\n    return false;\n  }\n  if (candidate.name !== undefined && typeof candidate.name !== \"string\") {\n    return false;\n  }\n  if (\n    candidate.requestId !== undefined &&\n    typeof candidate.requestId !== \"string\"\n  ) {\n    return false;\n  }\n  if (candidate.error !== undefined) {\n    if (\n      !candidate.error ||\n      typeof candidate.error !== \"object\" ||\n      Array.isArray(candidate.error)\n    ) {\n      return false;\n    }\n    const error = candidate.error as Partial<AgentNativeEmbedErrorPayload>;\n    if (typeof error.message !== \"string\") return false;\n    if (error.code !== undefined && typeof error.code !== \"string\") {\n      return false;\n    }\n  }\n  return true;\n}\n\nexport function createAgentNativeEmbedEnvelope<TPayload>(\n  type: AgentNativeEmbedMessageType,\n  options: {\n    name?: string;\n    payload?: TPayload;\n    requestId?: string;\n    error?: AgentNativeEmbedErrorPayload;\n  } = {},\n): AgentNativeEmbedEnvelope<TPayload> {\n  return {\n    protocol: AGENT_NATIVE_EMBED_PROTOCOL,\n    version: AGENT_NATIVE_EMBED_VERSION,\n    type,\n    ...options,\n  };\n}\n\nexport function embeddedAppOrigin(url: string, base?: string): string | null {\n  try {\n    const resolvedBase =\n      base ??\n      (typeof window !== \"undefined\"\n        ? window.location.href\n        : \"http://agent-native.local\");\n    return new URL(url, resolvedBase).origin;\n  } catch {\n    return null;\n  }\n}\n\nexport function isAllowedEmbeddedAppOrigin(\n  origin: string,\n  allowedOrigins: readonly string[] | undefined,\n): boolean {\n  if (!allowedOrigins?.length) return false;\n  return allowedOrigins.some(\n    (allowed) => allowed === \"*\" || allowed === origin,\n  );\n}\n\nexport function withEmbeddedAppParams(\n  url: string,\n  options: EmbeddedAppUrlOptions = {},\n): string {\n  const shouldMarkEmbedded = options.embedded ?? true;\n  const hasScheme = /^[a-z][a-z0-9+.-]*:/i.test(url);\n  const isProtocolRelative = url.startsWith(\"//\");\n  const isAbsolutePath = url.startsWith(\"/\");\n  const isRelative = !hasScheme && !isProtocolRelative;\n\n  try {\n    const base =\n      typeof window !== \"undefined\"\n        ? window.location.href\n        : \"http://agent-native.local\";\n    const parsed = new URL(url, base);\n\n    if (shouldMarkEmbedded && !parsed.searchParams.has(\"embedded\")) {\n      parsed.searchParams.set(\"embedded\", \"1\");\n    }\n\n    for (const [key, value] of Object.entries(options.params ?? {})) {\n      if (value === undefined || value === null) continue;\n      parsed.searchParams.set(key, String(value));\n    }\n\n    if (isRelative) {\n      const path = `${parsed.pathname}${parsed.search}${parsed.hash}`;\n      return isAbsolutePath ? path : path.replace(/^\\//, \"\");\n    }\n    return parsed.toString();\n  } catch {\n    const [beforeHash, hash = \"\"] = url.split(\"#\", 2);\n    const separator = beforeHash.includes(\"?\") ? \"&\" : \"?\";\n    const params = new URLSearchParams();\n    if (shouldMarkEmbedded) params.set(\"embedded\", \"1\");\n    for (const [key, value] of Object.entries(options.params ?? {})) {\n      if (value === undefined || value === null) continue;\n      params.set(key, String(value));\n    }\n    const query = params.toString();\n    if (!query) return url;\n    return `${beforeHash}${separator}${query}${hash ? `#${hash}` : \"\"}`;\n  }\n}\n\nexport function createEmbeddedAppRequestId(): string {\n  if (\n    typeof crypto !== \"undefined\" &&\n    typeof crypto.randomUUID === \"function\"\n  ) {\n    return `embed-${crypto.randomUUID()}`;\n  }\n  return `embed-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;\n}\n\nexport function messageErrorPayload(\n  error: unknown,\n): AgentNativeEmbedErrorPayload {\n  if (error instanceof Error) return { message: error.message };\n  return { message: String(error) };\n}\n"]}

package/dist/embedding/react.d.ts

@@ -0,0 +1,39 @@
+import { type IframeHTMLAttributes } from "react";
+import { type EmbeddedAppUrlOptions } from "./protocol.js";
+export interface EmbeddedAppRef {
+    iframe: HTMLIFrameElement | null;
+    origin: string | null;
+    postMessage<TPayload = unknown>(name: string, payload?: TPayload): boolean;
+    request<TResult = unknown, TPayload = unknown>(name: string, payload?: TPayload, options?: {
+        timeoutMs?: number;
+    }): Promise<TResult>;
+    focus(): void;
+}
+export interface EmbeddedAppMessageInfo<TPayload = unknown> {
+    name: string;
+    payload: TPayload;
+    event: MessageEvent;
+    ref: EmbeddedAppRef;
+}
+export interface EmbeddedAppProps extends Omit<IframeHTMLAttributes<HTMLIFrameElement>, "src" | "onLoad"> {
+    url: string;
+    /**
+     * Origin used when posting messages to the iframe. Defaults to url's origin.
+     */
+    targetOrigin?: string;
+    /**
+     * Origins allowed to send messages back. Defaults to targetOrigin.
+     */
+    allowedOrigins?: string[];
+    /**
+     * Adds `embedded=1` by default. Pass false to use the URL untouched.
+     */
+    embed?: boolean | EmbeddedAppUrlOptions;
+    onLoad?: (ref: EmbeddedAppRef) => void;
+    onReady?: (payload: unknown, event: MessageEvent, ref: EmbeddedAppRef) => void;
+    onMessage?: <TPayload = unknown>(name: string, payload: TPayload, event: MessageEvent, ref: EmbeddedAppRef) => void;
+    onRequest?: (name: string, payload: unknown, event: MessageEvent, ref: EmbeddedAppRef) => unknown | Promise<unknown>;
+}
+export declare function isEmbeddedAppMessageSource(event: Pick<MessageEvent, "source">, iframe: Pick<HTMLIFrameElement, "contentWindow"> | null): boolean;
+export declare const EmbeddedApp: import("react").ForwardRefExoticComponent<EmbeddedAppProps & import("react").RefAttributes<EmbeddedAppRef>>;
+//# sourceMappingURL=react.d.ts.map

package/dist/embedding/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../src/embedding/react.tsx"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,oBAAoB,EAC1B,MAAM,OAAO,CAAC;AACf,OAAO,EAUL,KAAK,qBAAqB,EAC3B,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,CAAC,QAAQ,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC3E,OAAO,CAAC,OAAO,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO,EAC3C,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/B,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB,CAAC,QAAQ,GAAG,OAAO;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,QAAQ,CAAC;IAClB,KAAK,EAAE,YAAY,CAAC;IACpB,GAAG,EAAE,cAAc,CAAC;CACrB;AAED,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAC5C,oBAAoB,CAAC,iBAAiB,CAAC,EACvC,KAAK,GAAG,QAAQ,CACjB;IACC,GAAG,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,qBAAqB,CAAC;IACxC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,CAAC;IACvC,OAAO,CAAC,EAAE,CACR,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,cAAc,KAChB,IAAI,CAAC;IACV,SAAS,CAAC,EAAE,CAAC,QAAQ,GAAG,OAAO,EAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,QAAQ,EACjB,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,cAAc,KAChB,IAAI,CAAC;IACV,SAAS,CAAC,EAAE,CACV,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,cAAc,KAChB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC;AA0BD,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,EACnC,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,CAAC,GAAG,IAAI,WAKxD;AAED,eAAO,MAAM,WAAW,6GA6MvB,CAAC"}

package/dist/embedding/react.js

@@ -0,0 +1,147 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { forwardRef, useCallback, useEffect, useImperativeHandle, useMemo, useRef, } from "react";
+import { AGENT_NATIVE_EMBED_MESSAGE_TYPES, createAgentNativeEmbedEnvelope, createEmbeddedAppRequestId, embeddedAppOrigin, isAgentNativeEmbedEnvelope, isAllowedEmbeddedAppOrigin, messageErrorPayload, withEmbeddedAppParams, } from "./protocol.js";
+const defaultStyle = {
+    border: 0,
+    width: "100%",
+    height: "100%",
+};
+function postEnvelope(iframe, targetOrigin, envelope) {
+    const targetWindow = iframe?.contentWindow;
+    if (!targetOrigin)
+        return false;
+    if (!targetWindow)
+        return false;
+    targetWindow.postMessage(envelope, targetOrigin);
+    return true;
+}
+export function isEmbeddedAppMessageSource(event, iframe) {
+    return Boolean(iframe?.contentWindow && event.source === iframe.contentWindow);
+}
+export const EmbeddedApp = forwardRef(function EmbeddedApp({ url, targetOrigin, allowedOrigins, embed = true, onLoad, onReady, onMessage, onRequest, title = "Agent-Native embedded app", sandbox = "allow-scripts allow-same-origin allow-forms allow-popups allow-downloads", allow = "clipboard-read; clipboard-write; microphone; fullscreen", referrerPolicy = "strict-origin-when-cross-origin", style, ...iframeProps }, forwardedRef) {
+    const iframeRef = useRef(null);
+    const pendingRef = useRef(new Map());
+    const resolvedOrigin = useMemo(() => targetOrigin ?? embeddedAppOrigin(url), [targetOrigin, url]);
+    const trustedOrigins = useMemo(() => allowedOrigins ??
+        (resolvedOrigin && resolvedOrigin !== "*" ? [resolvedOrigin] : []), [allowedOrigins, resolvedOrigin]);
+    const src = useMemo(() => {
+        if (embed === false)
+            return url;
+        const options = typeof embed === "object" ? embed : {};
+        return withEmbeddedAppParams(url, options);
+    }, [embed, url]);
+    const refValue = useMemo(() => ({
+        get iframe() {
+            return iframeRef.current;
+        },
+        origin: resolvedOrigin,
+        postMessage(name, payload) {
+            return postEnvelope(iframeRef.current, resolvedOrigin ?? undefined, createAgentNativeEmbedEnvelope(AGENT_NATIVE_EMBED_MESSAGE_TYPES.MESSAGE, { name, payload }));
+        },
+        request(name, payload, options) {
+            const requestId = createEmbeddedAppRequestId();
+            return new Promise((resolve, reject) => {
+                const timeoutMs = options?.timeoutMs ?? 30_000;
+                const timer = timeoutMs > 0
+                    ? setTimeout(() => {
+                        pendingRef.current.delete(requestId);
+                        reject(new Error(`Embedded app request timed out: ${name}`));
+                    }, timeoutMs)
+                    : undefined;
+                pendingRef.current.set(requestId, {
+                    resolve: (value) => resolve(value),
+                    reject,
+                    timer,
+                });
+                const posted = postEnvelope(iframeRef.current, resolvedOrigin ?? undefined, createAgentNativeEmbedEnvelope(AGENT_NATIVE_EMBED_MESSAGE_TYPES.REQUEST, { name, payload, requestId }));
+                if (!posted) {
+                    pendingRef.current.delete(requestId);
+                    if (timer)
+                        clearTimeout(timer);
+                    reject(new Error("Embedded app iframe is not ready"));
+                }
+            });
+        },
+        focus() {
+            iframeRef.current?.focus();
+        },
+    }), [resolvedOrigin]);
+    useImperativeHandle(forwardedRef, () => refValue, [refValue]);
+    const respond = useCallback((requestId, type, value) => {
+        if (!requestId)
+            return;
+        postEnvelope(iframeRef.current, resolvedOrigin ?? undefined, createAgentNativeEmbedEnvelope(type === "response"
+            ? AGENT_NATIVE_EMBED_MESSAGE_TYPES.RESPONSE
+            : AGENT_NATIVE_EMBED_MESSAGE_TYPES.ERROR, type === "response"
+            ? { requestId, payload: value }
+            : { requestId, error: messageErrorPayload(value) }));
+    }, [resolvedOrigin]);
+    useEffect(() => {
+        const listener = (event) => {
+            if (!isEmbeddedAppMessageSource(event, iframeRef.current))
+                return;
+            if (!isAllowedEmbeddedAppOrigin(event.origin, trustedOrigins))
+                return;
+            if (!isAgentNativeEmbedEnvelope(event.data))
+                return;
+            const envelope = event.data;
+            if (envelope.type === AGENT_NATIVE_EMBED_MESSAGE_TYPES.READY) {
+                onReady?.(envelope.payload, event, refValue);
+                return;
+            }
+            if (envelope.type === AGENT_NATIVE_EMBED_MESSAGE_TYPES.RESPONSE) {
+                const requestId = envelope.requestId;
+                if (!requestId)
+                    return;
+                const pending = pendingRef.current.get(requestId);
+                if (!pending)
+                    return;
+                pendingRef.current.delete(requestId);
+                if (pending.timer)
+                    clearTimeout(pending.timer);
+                pending.resolve(envelope.payload);
+                return;
+            }
+            if (envelope.type === AGENT_NATIVE_EMBED_MESSAGE_TYPES.ERROR) {
+                const requestId = envelope.requestId;
+                if (!requestId)
+                    return;
+                const pending = pendingRef.current.get(requestId);
+                if (!pending)
+                    return;
+                pendingRef.current.delete(requestId);
+                if (pending.timer)
+                    clearTimeout(pending.timer);
+                pending.reject(new Error(envelope.error?.message ?? "Embedded app error"));
+                return;
+            }
+            if (!envelope.name)
+                return;
+            if (envelope.type === AGENT_NATIVE_EMBED_MESSAGE_TYPES.REQUEST) {
+                Promise.resolve(onRequest?.(envelope.name, envelope.payload, event, refValue))
+                    .then((payload) => respond(envelope.requestId, "response", payload))
+                    .catch((error) => respond(envelope.requestId, "error", error));
+                return;
+            }
+            if (envelope.type === AGENT_NATIVE_EMBED_MESSAGE_TYPES.MESSAGE) {
+                onMessage?.(envelope.name, envelope.payload, event, refValue);
+            }
+        };
+        window.addEventListener("message", listener);
+        return () => {
+            window.removeEventListener("message", listener);
+        };
+    }, [onMessage, onReady, onRequest, refValue, respond, trustedOrigins]);
+    useEffect(() => {
+        return () => {
+            for (const pending of pendingRef.current.values()) {
+                if (pending.timer)
+                    clearTimeout(pending.timer);
+                pending.reject(new Error("Embedded app unmounted"));
+            }
+            pendingRef.current.clear();
+        };
+    }, []);
+    return (_jsx("iframe", { ...iframeProps, ref: iframeRef, src: src, title: title, sandbox: sandbox, allow: allow, referrerPolicy: referrerPolicy, style: { ...defaultStyle, ...style }, onLoad: () => onLoad?.(refValue) }));
+});
+//# sourceMappingURL=react.js.map

package/dist/embedding/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../../src/embedding/react.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n  forwardRef,\n  useCallback,\n  useEffect,\n  useImperativeHandle,\n  useMemo,\n  useRef,\n  type CSSProperties,\n  type IframeHTMLAttributes,\n} from \"react\";\nimport {\n  AGENT_NATIVE_EMBED_MESSAGE_TYPES,\n  createAgentNativeEmbedEnvelope,\n  createEmbeddedAppRequestId,\n  embeddedAppOrigin,\n  isAgentNativeEmbedEnvelope,\n  isAllowedEmbeddedAppOrigin,\n  messageErrorPayload,\n  withEmbeddedAppParams,\n  type AgentNativeEmbedEnvelope,\n  type EmbeddedAppUrlOptions,\n} from \"./protocol.js\";\n\nexport interface EmbeddedAppRef {\n  iframe: HTMLIFrameElement | null;\n  origin: string | null;\n  postMessage<TPayload = unknown>(name: string, payload?: TPayload): boolean;\n  request<TResult = unknown, TPayload = unknown>(\n    name: string,\n    payload?: TPayload,\n    options?: { timeoutMs?: number },\n  ): Promise<TResult>;\n  focus(): void;\n}\n\nexport interface EmbeddedAppMessageInfo<TPayload = unknown> {\n  name: string;\n  payload: TPayload;\n  event: MessageEvent;\n  ref: EmbeddedAppRef;\n}\n\nexport interface EmbeddedAppProps extends Omit<\n  IframeHTMLAttributes<HTMLIFrameElement>,\n  \"src\" | \"onLoad\"\n> {\n  url: string;\n  /**\n   * Origin used when posting messages to the iframe. Defaults to url's origin.\n   */\n  targetOrigin?: string;\n  /**\n   * Origins allowed to send messages back. Defaults to targetOrigin.\n   */\n  allowedOrigins?: string[];\n  /**\n   * Adds `embedded=1` by default. Pass false to use the URL untouched.\n   */\n  embed?: boolean | EmbeddedAppUrlOptions;\n  onLoad?: (ref: EmbeddedAppRef) => void;\n  onReady?: (\n    payload: unknown,\n    event: MessageEvent,\n    ref: EmbeddedAppRef,\n  ) => void;\n  onMessage?: <TPayload = unknown>(\n    name: string,\n    payload: TPayload,\n    event: MessageEvent,\n    ref: EmbeddedAppRef,\n  ) => void;\n  onRequest?: (\n    name: string,\n    payload: unknown,\n    event: MessageEvent,\n    ref: EmbeddedAppRef,\n  ) => unknown | Promise<unknown>;\n}\n\ntype PendingRequest = {\n  resolve: (value: unknown) => void;\n  reject: (error: Error) => void;\n  timer: ReturnType<typeof setTimeout> | undefined;\n};\n\nconst defaultStyle: CSSProperties = {\n  border: 0,\n  width: \"100%\",\n  height: \"100%\",\n};\n\nfunction postEnvelope(\n  iframe: HTMLIFrameElement | null,\n  targetOrigin: string | null | undefined,\n  envelope: AgentNativeEmbedEnvelope,\n): boolean {\n  const targetWindow = iframe?.contentWindow;\n  if (!targetOrigin) return false;\n  if (!targetWindow) return false;\n  targetWindow.postMessage(envelope, targetOrigin);\n  return true;\n}\n\nexport function isEmbeddedAppMessageSource(\n  event: Pick<MessageEvent, \"source\">,\n  iframe: Pick<HTMLIFrameElement, \"contentWindow\"> | null,\n) {\n  return Boolean(\n    iframe?.contentWindow && event.source === iframe.contentWindow,\n  );\n}\n\nexport const EmbeddedApp = forwardRef<EmbeddedAppRef, EmbeddedAppProps>(\n  function EmbeddedApp(\n    {\n      url,\n      targetOrigin,\n      allowedOrigins,\n      embed = true,\n      onLoad,\n      onReady,\n      onMessage,\n      onRequest,\n      title = \"Agent-Native embedded app\",\n      sandbox = \"allow-scripts allow-same-origin allow-forms allow-popups allow-downloads\",\n      allow = \"clipboard-read; clipboard-write; microphone; fullscreen\",\n      referrerPolicy = \"strict-origin-when-cross-origin\",\n      style,\n      ...iframeProps\n    },\n    forwardedRef,\n  ) {\n    const iframeRef = useRef<HTMLIFrameElement | null>(null);\n    const pendingRef = useRef(new Map<string, PendingRequest>());\n    const resolvedOrigin = useMemo(\n      () => targetOrigin ?? embeddedAppOrigin(url),\n      [targetOrigin, url],\n    );\n    const trustedOrigins = useMemo(\n      () =>\n        allowedOrigins ??\n        (resolvedOrigin && resolvedOrigin !== \"*\" ? [resolvedOrigin] : []),\n      [allowedOrigins, resolvedOrigin],\n    );\n    const src = useMemo(() => {\n      if (embed === false) return url;\n      const options = typeof embed === \"object\" ? embed : {};\n      return withEmbeddedAppParams(url, options);\n    }, [embed, url]);\n\n    const refValue = useMemo<EmbeddedAppRef>(\n      () => ({\n        get iframe() {\n          return iframeRef.current;\n        },\n        origin: resolvedOrigin,\n        postMessage(name, payload) {\n          return postEnvelope(\n            iframeRef.current,\n            resolvedOrigin ?? undefined,\n            createAgentNativeEmbedEnvelope(\n              AGENT_NATIVE_EMBED_MESSAGE_TYPES.MESSAGE,\n              { name, payload },\n            ),\n          );\n        },\n        request<TResult = unknown, TPayload = unknown>(\n          name: string,\n          payload?: TPayload,\n          options?: { timeoutMs?: number },\n        ) {\n          const requestId = createEmbeddedAppRequestId();\n          return new Promise<TResult>((resolve, reject) => {\n            const timeoutMs = options?.timeoutMs ?? 30_000;\n            const timer =\n              timeoutMs > 0\n                ? setTimeout(() => {\n                    pendingRef.current.delete(requestId);\n                    reject(\n                      new Error(`Embedded app request timed out: ${name}`),\n                    );\n                  }, timeoutMs)\n                : undefined;\n            pendingRef.current.set(requestId, {\n              resolve: (value) => resolve(value as TResult),\n              reject,\n              timer,\n            });\n            const posted = postEnvelope(\n              iframeRef.current,\n              resolvedOrigin ?? undefined,\n              createAgentNativeEmbedEnvelope(\n                AGENT_NATIVE_EMBED_MESSAGE_TYPES.REQUEST,\n                { name, payload, requestId },\n              ),\n            );\n            if (!posted) {\n              pendingRef.current.delete(requestId);\n              if (timer) clearTimeout(timer);\n              reject(new Error(\"Embedded app iframe is not ready\"));\n            }\n          });\n        },\n        focus() {\n          iframeRef.current?.focus();\n        },\n      }),\n      [resolvedOrigin],\n    );\n\n    useImperativeHandle(forwardedRef, () => refValue, [refValue]);\n\n    const respond = useCallback(\n      (\n        requestId: string | undefined,\n        type: \"response\" | \"error\",\n        value: unknown,\n      ) => {\n        if (!requestId) return;\n        postEnvelope(\n          iframeRef.current,\n          resolvedOrigin ?? undefined,\n          createAgentNativeEmbedEnvelope(\n            type === \"response\"\n              ? AGENT_NATIVE_EMBED_MESSAGE_TYPES.RESPONSE\n              : AGENT_NATIVE_EMBED_MESSAGE_TYPES.ERROR,\n            type === \"response\"\n              ? { requestId, payload: value }\n              : { requestId, error: messageErrorPayload(value) },\n          ),\n        );\n      },\n      [resolvedOrigin],\n    );\n\n    useEffect(() => {\n      const listener = (event: MessageEvent) => {\n        if (!isEmbeddedAppMessageSource(event, iframeRef.current)) return;\n        if (!isAllowedEmbeddedAppOrigin(event.origin, trustedOrigins)) return;\n        if (!isAgentNativeEmbedEnvelope(event.data)) return;\n\n        const envelope = event.data;\n        if (envelope.type === AGENT_NATIVE_EMBED_MESSAGE_TYPES.READY) {\n          onReady?.(envelope.payload, event, refValue);\n          return;\n        }\n\n        if (envelope.type === AGENT_NATIVE_EMBED_MESSAGE_TYPES.RESPONSE) {\n          const requestId = envelope.requestId;\n          if (!requestId) return;\n          const pending = pendingRef.current.get(requestId);\n          if (!pending) return;\n          pendingRef.current.delete(requestId);\n          if (pending.timer) clearTimeout(pending.timer);\n          pending.resolve(envelope.payload);\n          return;\n        }\n\n        if (envelope.type === AGENT_NATIVE_EMBED_MESSAGE_TYPES.ERROR) {\n          const requestId = envelope.requestId;\n          if (!requestId) return;\n          const pending = pendingRef.current.get(requestId);\n          if (!pending) return;\n          pendingRef.current.delete(requestId);\n          if (pending.timer) clearTimeout(pending.timer);\n          pending.reject(\n            new Error(envelope.error?.message ?? \"Embedded app error\"),\n          );\n          return;\n        }\n\n        if (!envelope.name) return;\n\n        if (envelope.type === AGENT_NATIVE_EMBED_MESSAGE_TYPES.REQUEST) {\n          Promise.resolve(\n            onRequest?.(envelope.name, envelope.payload, event, refValue),\n          )\n            .then((payload) => respond(envelope.requestId, \"response\", payload))\n            .catch((error) => respond(envelope.requestId, \"error\", error));\n          return;\n        }\n\n        if (envelope.type === AGENT_NATIVE_EMBED_MESSAGE_TYPES.MESSAGE) {\n          onMessage?.(envelope.name, envelope.payload, event, refValue);\n        }\n      };\n\n      window.addEventListener(\"message\", listener);\n      return () => {\n        window.removeEventListener(\"message\", listener);\n      };\n    }, [onMessage, onReady, onRequest, refValue, respond, trustedOrigins]);\n\n    useEffect(() => {\n      return () => {\n        for (const pending of pendingRef.current.values()) {\n          if (pending.timer) clearTimeout(pending.timer);\n          pending.reject(new Error(\"Embedded app unmounted\"));\n        }\n        pendingRef.current.clear();\n      };\n    }, []);\n\n    return (\n      <iframe\n        {...iframeProps}\n        ref={iframeRef}\n        src={src}\n        title={title}\n        sandbox={sandbox}\n        allow={allow}\n        referrerPolicy={referrerPolicy}\n        style={{ ...defaultStyle, ...style }}\n        onLoad={() => onLoad?.(refValue)}\n      />\n    );\n  },\n);\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.64.0",
+  "version": "0.65.0",
   "type": "module",
   "engines": {
     "node": ">=22"
@@ -116,6 +116,11 @@
     "./router": "./dist/router/index.js",
     "./collab": "./dist/collab/index.js",
     "./a2a": "./dist/a2a/index.js",
+    "./embedding": "./dist/embedding/index.js",
+    "./embedding/react": "./dist/embedding/react.js",
+    "./embedding/bridge": "./dist/embedding/bridge.js",
+    "./embedding/agent": "./dist/embedding/agent.js",
+    "./embedding/protocol": "./dist/embedding/protocol.js",
     "./mcp": "./dist/mcp/index.js",
     "./mcp-client": "./dist/mcp-client/index.js",
     "./tracking": "./dist/tracking/index.js",
@@ -196,23 +201,23 @@
     "@sentry/node": "^10.50.0",
     "@standard-schema/spec": "^1.1.0",
     "@tanstack/react-table": "^8.21.3",
-    "@tiptap/core": "^3.26.0",
-    "@tiptap/extension-code-block-lowlight": "^3.26.0",
-    "@tiptap/extension-collaboration": "^3.26.0",
-    "@tiptap/extension-collaboration-caret": "^3.26.0",
-    "@tiptap/extension-image": "^3.26.0",
-    "@tiptap/extension-link": "^3.26.0",
-    "@tiptap/extension-placeholder": "^3.26.0",
-    "@tiptap/extension-table": "^3.26.0",
-    "@tiptap/extension-table-cell": "^3.26.0",
-    "@tiptap/extension-table-header": "^3.26.0",
-    "@tiptap/extension-table-row": "^3.26.0",
-    "@tiptap/extension-task-item": "^3.26.0",
-    "@tiptap/extension-task-list": "^3.26.0",
-    "@tiptap/pm": "^3.26.0",
-    "@tiptap/react": "^3.26.0",
-    "@tiptap/starter-kit": "^3.26.0",
-    "@tiptap/y-tiptap": "^3.0.4",
+    "@tiptap/core": "3.27.1",
+    "@tiptap/extension-code-block-lowlight": "3.27.1",
+    "@tiptap/extension-collaboration": "3.27.1",
+    "@tiptap/extension-collaboration-caret": "3.27.1",
+    "@tiptap/extension-image": "3.27.1",
+    "@tiptap/extension-link": "3.27.1",
+    "@tiptap/extension-placeholder": "3.27.1",
+    "@tiptap/extension-table": "3.27.1",
+    "@tiptap/extension-table-cell": "3.27.1",
+    "@tiptap/extension-table-header": "3.27.1",
+    "@tiptap/extension-table-row": "3.27.1",
+    "@tiptap/extension-task-item": "3.27.1",
+    "@tiptap/extension-task-list": "3.27.1",
+    "@tiptap/pm": "3.27.1",
+    "@tiptap/react": "3.27.1",
+    "@tiptap/starter-kit": "3.27.1",
+    "@tiptap/y-tiptap": "^3.0.5",
     "@uiw/react-codemirror": "^4.25.10",
     "ajv": "^8.20.0",
     "better-auth": "1.6.16",