@agent-native/core 0.15.13 → 0.16.0

package/dist/client/composer/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/client/composer/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC;IAChC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,cAAc,CAAC;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,YAAY,GAAG,WAAW,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/client/composer/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC;IAChC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,cAAc,CAAC;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,YAAY,GAAG,WAAW,CAAC;AAExE,MAAM,MAAM,0BAA0B,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC"}

package/dist/client/composer/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/client/composer/types.ts"],"names":[],"mappings":"","sourcesContent":["export interface FileResult {\n  path: string;\n  name: string;\n  source: \"codebase\" | \"resource\";\n  type: \"file\" | \"folder\";\n}\n\nexport interface SkillResult {\n  name: string;\n  description: string;\n  path: string;\n  source: \"codebase\" | \"resource\";\n}\n\nexport interface MentionItem {\n  id: string;\n  label: string;\n  description?: string;\n  icon?: string;\n  source: string;\n  refType: string;\n  refPath?: string;\n  refId?: string;\n  section?: string;\n}\n\nexport interface Reference {\n  type: \"file\" | \"skill\" | \"mention\" | \"agent\" | \"custom-agent\";\n  path: string;\n  name: string;\n  source: string;\n  refType?: string;\n  refId?: string;\n}\n\nexport interface SlashCommand {\n  name: string;\n  description: string;\n  icon?: string;\n}\n\nexport type ComposerMode = \"skill\" | \"job\" | \"automation\" | \"extension\";\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/client/composer/types.ts"],"names":[],"mappings":"","sourcesContent":["export interface FileResult {\n  path: string;\n  name: string;\n  source: \"codebase\" | \"resource\";\n  type: \"file\" | \"folder\";\n}\n\nexport interface SkillResult {\n  name: string;\n  description: string;\n  path: string;\n  source: \"codebase\" | \"resource\";\n}\n\nexport interface MentionItem {\n  id: string;\n  label: string;\n  description?: string;\n  icon?: string;\n  source: string;\n  refType: string;\n  refPath?: string;\n  refId?: string;\n  section?: string;\n}\n\nexport interface Reference {\n  type: \"file\" | \"skill\" | \"mention\" | \"agent\" | \"custom-agent\";\n  path: string;\n  name: string;\n  source: string;\n  refType?: string;\n  refId?: string;\n}\n\nexport interface SlashCommand {\n  name: string;\n  description: string;\n  icon?: string;\n}\n\nexport type ComposerMode = \"skill\" | \"job\" | \"automation\" | \"extension\";\n\nexport type AgentComposerLayoutVariant = \"default\" | \"compact\" | \"hero\";\n"]}

package/dist/client/extensions/AgentNativeExtensionFrame.d.ts

@@ -0,0 +1,58 @@
+import React, { type CSSProperties, type IframeHTMLAttributes } from "react";
+import { type AgentNativeClientActions, type AgentNativeHostAuth, type AgentNativeHostBridge, type AgentNativeHostBridgeEvent, type AgentNativeHostCommandHandlers, type AgentNativeHostContextGetter, type AgentNativeHostSession } from "../host-bridge.js";
+import { type AgentNativeExtensionDefinition, type AgentNativeExtensionStorage, type AgentNativeExtensionStorageContext, type AgentNativeExtensionStorageOptions, type AgentNativeExtensionStorageScope } from "./portable-extension.js";
+export type AgentNativeExtensionPermissionList = readonly string[] | ((extension: AgentNativeExtensionDefinition) => readonly string[] | undefined) | undefined;
+export type AgentNativeExtensionStorageScopeList = readonly AgentNativeExtensionStorageScope[] | ((extension: AgentNativeExtensionDefinition) => readonly AgentNativeExtensionStorageScope[] | undefined) | undefined;
+export interface AgentNativeExtensionFrameProps extends Omit<IframeHTMLAttributes<HTMLIFrameElement>, "src" | "srcDoc"> {
+    extension: AgentNativeExtensionDefinition;
+    /** Stable slot identifier, for example `customer-detail.sidebar`. */
+    slotId?: string;
+    /** Context pushed into `window.slotContext` and merged into host context. */
+    context?: Record<string, unknown> | null;
+    /** Live actions exposed to the extension through `appAction()` and `agentNative.action()`. */
+    actions?: AgentNativeClientActions;
+    /** Page/app context exposed through `agentNative.context()`. */
+    getContext?: AgentNativeHostContextGetter;
+    /** Host commands exposed through `agentNative.command()` and `agentNative.refresh()`. */
+    commands?: AgentNativeHostCommandHandlers;
+    /** Host-enforced action allowlist. Defaults to extension manifest requestedActions. */
+    allowedActions?: AgentNativeExtensionPermissionList;
+    /** Host-enforced command allowlist. Defaults to extension manifest requestedCommands. */
+    allowedCommands?: AgentNativeExtensionPermissionList;
+    auth?: AgentNativeHostAuth;
+    session?: string | Partial<AgentNativeHostSession>;
+    /** Storage adapter used by `extensionData.*`. Defaults to browser localStorage. */
+    storage?: AgentNativeExtensionStorage | false;
+    /** Host-enforced storage scope allowlist. Defaults to extension manifest storageScopes. */
+    allowedStorageScopes?: AgentNativeExtensionStorageScopeList;
+    storageNamespace?: string;
+    storageContext?: Omit<AgentNativeExtensionStorageContext, "extensionId" | "slotId">;
+    themeCss?: string;
+    isDark?: boolean;
+    autoHeight?: boolean;
+    initialHeight?: number;
+    onBridgeEvent?: (event: AgentNativeHostBridgeEvent) => void;
+    onBridgeReady?: (bridge: AgentNativeHostBridge) => void;
+    onStorageError?: (error: Error, request: AgentNativeExtensionStorageRequest) => void;
+}
+export interface AgentNativeExtensionSlotProps extends Omit<AgentNativeExtensionFrameProps, "extension" | "className" | "style" | "children"> {
+    id: string;
+    extensions: AgentNativeExtensionDefinition[];
+    className?: string;
+    extensionClassName?: string;
+    extensionStyle?: CSSProperties;
+    empty?: React.ReactNode;
+    showEmptyAffordance?: boolean;
+}
+interface AgentNativeExtensionStorageRequest {
+    requestId: string;
+    op: "list" | "get" | "set" | "remove";
+    collection: string;
+    id?: string;
+    data?: unknown;
+    options?: AgentNativeExtensionStorageOptions;
+}
+export declare const AgentNativeExtensionFrame: React.ForwardRefExoticComponent<AgentNativeExtensionFrameProps & React.RefAttributes<HTMLIFrameElement>>;
+export declare function AgentNativeExtensionSlot({ id, extensions, context, actions, getContext, commands, allowedActions, allowedCommands, auth, session, storage, allowedStorageScopes, storageNamespace, storageContext, themeCss, isDark, autoHeight, initialHeight, onBridgeEvent, onBridgeReady, onStorageError, className, extensionClassName, extensionStyle, empty, showEmptyAffordance, ...iframeProps }: AgentNativeExtensionSlotProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=AgentNativeExtensionFrame.d.ts.map

package/dist/client/extensions/AgentNativeExtensionFrame.d.ts.map

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

package/dist/client/extensions/AgentNativeExtensionFrame.e2e-host.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=AgentNativeExtensionFrame.e2e-host.d.ts.map

package/dist/client/extensions/AgentNativeExtensionFrame.e2e-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentNativeExtensionFrame.e2e-host.d.ts","sourceRoot":"","sources":["../../../src/client/extensions/AgentNativeExtensionFrame.e2e-host.tsx"],"names":[],"mappings":""}

package/dist/client/extensions/AgentNativeExtensionFrame.e2e-host.js

@@ -0,0 +1,110 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { createRoot } from "react-dom/client";
+import { defineClientAction } from "../client-action.js";
+import { AgentNativeExtensionSlot } from "./AgentNativeExtensionFrame.js";
+const extensionContent = `
+<div id="status">pending</div>
+<pre id="results"></pre>
+<script>
+  (async function() {
+    const result = {};
+    async function capture(name, fn) {
+      try {
+        result[name] = { ok: true, value: await fn() };
+      } catch (error) {
+        result[name] = {
+          ok: false,
+          error: error && error.message ? error.message : String(error),
+        };
+      }
+    }
+
+    await capture('context', () => agentNative.context());
+    await capture('actions', () => agentNative.listActions());
+    await capture('allowedAction', () => appAction('allowed-action', { value: 3 }));
+    await capture('blockedAction', () => appAction('blocked-action', {}));
+    await capture('allowedCommand', () =>
+      agentNative.command('refreshData', { customerId: slotContext.customerId })
+    );
+    await capture('blockedCommand', () => agentNative.command('hardReload', {}));
+    await capture('storageSet', () =>
+      extensionData.set('notes', 'note-1', { text: 'Saved note' }, { scope: 'user' })
+    );
+    await capture('storageGet', () =>
+      extensionData.get('notes', 'note-1', { scope: 'user' })
+    );
+    await capture('blockedStorageScope', () =>
+      extensionData.set('notes', 'note-2', { text: 'Org note' }, { scope: 'org' })
+    );
+
+    result.done = true;
+    document.getElementById('status').textContent = 'done';
+    document.getElementById('results').textContent = JSON.stringify(result);
+    window.parent.postMessage({ type: 'extension-e2e.done', result }, '*');
+  })();
+</script>
+`;
+const hostWindow = window;
+const extension = {
+    id: "allowed-extension",
+    name: "Allowed extension",
+    content: extensionContent,
+    manifest: {
+        slots: ["crm.customer.sidebar"],
+        requestedActions: ["allowed-action"],
+        requestedCommands: ["refreshData"],
+        storageScopes: ["user"],
+    },
+};
+const wrongSlotExtension = {
+    id: "wrong-slot-extension",
+    name: "Wrong slot extension",
+    content: "<div>should not render</div>",
+    manifest: { slots: ["crm.billing.sidebar"] },
+};
+hostWindow.__extensionE2ECommands = [];
+window.addEventListener("message", (event) => {
+    if (event.data?.type !== "extension-e2e.done")
+        return;
+    hostWindow.__extensionE2EResult = event.data.result;
+    const results = document.getElementById("host-results");
+    if (results)
+        results.textContent = JSON.stringify(event.data.result);
+});
+const actions = [
+    defineClientAction({
+        name: "allowed-action",
+        description: "Allowed test action",
+        schema: {
+            type: "object",
+            properties: { value: { type: "number" } },
+            required: ["value"],
+        },
+        run: async (args) => ({ doubled: args.value * 2 }),
+    }),
+    defineClientAction({
+        name: "blocked-action",
+        description: "Blocked test action",
+        schema: { type: "object", properties: {} },
+        run: async () => ({ shouldNotRun: true }),
+    }),
+];
+function Host() {
+    return (_jsxs("main", { children: [_jsx("div", { id: "command-count", children: hostWindow.__extensionE2ECommands?.length }), _jsx("div", { id: "host-results" }), _jsx(AgentNativeExtensionSlot, { id: "crm.customer.sidebar", extensions: [extension, wrongSlotExtension], context: { customerId: "customer-1" }, actions: actions, getContext: () => ({
+                    resource: { type: "customer", id: "customer-1", name: "Ada Co" },
+                }), commands: {
+                    refreshData: async ({ payload }) => {
+                        hostWindow.__extensionE2ECommands?.push({
+                            command: "refreshData",
+                            payload,
+                        });
+                        const count = document.getElementById("command-count");
+                        if (count) {
+                            count.textContent = String(hostWindow.__extensionE2ECommands?.length ?? 0);
+                        }
+                        return { refreshed: true, payload };
+                    },
+                } })] }));
+}
+createRoot(document.getElementById("root")).render(_jsx(Host, {}));
+//# sourceMappingURL=AgentNativeExtensionFrame.e2e-host.js.map

package/dist/client/extensions/AgentNativeExtensionFrame.e2e-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentNativeExtensionFrame.e2e-host.js","sourceRoot":"","sources":["../../../src/client/extensions/AgentNativeExtensionFrame.e2e-host.tsx"],"names":[],"mappings":"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","sourcesContent":["import React from \"react\";\nimport { createRoot } from \"react-dom/client\";\nimport { defineClientAction } from \"../client-action.js\";\nimport { AgentNativeExtensionSlot } from \"./AgentNativeExtensionFrame.js\";\n\nconst extensionContent = `\n<div id=\"status\">pending</div>\n<pre id=\"results\"></pre>\n<script>\n  (async function() {\n    const result = {};\n    async function capture(name, fn) {\n      try {\n        result[name] = { ok: true, value: await fn() };\n      } catch (error) {\n        result[name] = {\n          ok: false,\n          error: error && error.message ? error.message : String(error),\n        };\n      }\n    }\n\n    await capture('context', () => agentNative.context());\n    await capture('actions', () => agentNative.listActions());\n    await capture('allowedAction', () => appAction('allowed-action', { value: 3 }));\n    await capture('blockedAction', () => appAction('blocked-action', {}));\n    await capture('allowedCommand', () =>\n      agentNative.command('refreshData', { customerId: slotContext.customerId })\n    );\n    await capture('blockedCommand', () => agentNative.command('hardReload', {}));\n    await capture('storageSet', () =>\n      extensionData.set('notes', 'note-1', { text: 'Saved note' }, { scope: 'user' })\n    );\n    await capture('storageGet', () =>\n      extensionData.get('notes', 'note-1', { scope: 'user' })\n    );\n    await capture('blockedStorageScope', () =>\n      extensionData.set('notes', 'note-2', { text: 'Org note' }, { scope: 'org' })\n    );\n\n    result.done = true;\n    document.getElementById('status').textContent = 'done';\n    document.getElementById('results').textContent = JSON.stringify(result);\n    window.parent.postMessage({ type: 'extension-e2e.done', result }, '*');\n  })();\n</script>\n`;\n\ninterface ExtensionE2EWindow {\n  __extensionE2EResult?: unknown;\n  __extensionE2ECommands?: Array<{ command: string; payload: unknown }>;\n}\n\nconst hostWindow = window as Window & ExtensionE2EWindow;\n\nconst extension = {\n  id: \"allowed-extension\",\n  name: \"Allowed extension\",\n  content: extensionContent,\n  manifest: {\n    slots: [\"crm.customer.sidebar\"],\n    requestedActions: [\"allowed-action\"],\n    requestedCommands: [\"refreshData\"],\n    storageScopes: [\"user\"],\n  },\n};\n\nconst wrongSlotExtension = {\n  id: \"wrong-slot-extension\",\n  name: \"Wrong slot extension\",\n  content: \"<div>should not render</div>\",\n  manifest: { slots: [\"crm.billing.sidebar\"] },\n};\n\nhostWindow.__extensionE2ECommands = [];\nwindow.addEventListener(\"message\", (event) => {\n  if (event.data?.type !== \"extension-e2e.done\") return;\n  hostWindow.__extensionE2EResult = event.data.result;\n  const results = document.getElementById(\"host-results\");\n  if (results) results.textContent = JSON.stringify(event.data.result);\n});\n\nconst actions = [\n  defineClientAction<{ value: number }, { doubled: number }>({\n    name: \"allowed-action\",\n    description: \"Allowed test action\",\n    schema: {\n      type: \"object\",\n      properties: { value: { type: \"number\" } },\n      required: [\"value\"],\n    },\n    run: async (args) => ({ doubled: args.value * 2 }),\n  }),\n  defineClientAction<Record<string, never>, { shouldNotRun: true }>({\n    name: \"blocked-action\",\n    description: \"Blocked test action\",\n    schema: { type: \"object\", properties: {} },\n    run: async () => ({ shouldNotRun: true }),\n  }),\n];\n\nfunction Host() {\n  return (\n    <main>\n      <div id=\"command-count\">{hostWindow.__extensionE2ECommands?.length}</div>\n      <div id=\"host-results\"></div>\n      <AgentNativeExtensionSlot\n        id=\"crm.customer.sidebar\"\n        extensions={[extension, wrongSlotExtension]}\n        context={{ customerId: \"customer-1\" }}\n        actions={actions}\n        getContext={() => ({\n          resource: { type: \"customer\", id: \"customer-1\", name: \"Ada Co\" },\n        })}\n        commands={{\n          refreshData: async ({ payload }) => {\n            hostWindow.__extensionE2ECommands?.push({\n              command: \"refreshData\",\n              payload,\n            });\n            const count = document.getElementById(\"command-count\");\n            if (count) {\n              count.textContent = String(\n                hostWindow.__extensionE2ECommands?.length ?? 0,\n              );\n            }\n            return { refreshed: true, payload };\n          },\n        }}\n      />\n    </main>\n  );\n}\n\ncreateRoot(document.getElementById(\"root\") as HTMLElement).render(<Host />);\n"]}

package/dist/client/extensions/AgentNativeExtensionFrame.js

@@ -0,0 +1,354 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createElement as _createElement } from "react";
+import { forwardRef, useCallback, useEffect, useMemo, useRef, useState, } from "react";
+import { createAgentNativeHostBridge, } from "../host-bridge.js";
+import { AGENT_NATIVE_EXTENSION_MESSAGE_TYPES, buildAgentNativeExtensionHtml, createLocalStorageAgentNativeExtensionStorage, getAgentNativeExtensionManifest, isAgentNativeExtensionAllowedInSlot, normalizeAgentNativeExtensionSandbox, } from "./portable-extension.js";
+const defaultFrameStyle = {
+    border: 0,
+    display: "block",
+    width: "100%",
+};
+const BUILT_IN_COMMAND_NAMES = [
+    "navigate",
+    "refreshData",
+    "refresh-data",
+    "remountView",
+    "remount-view",
+    "hardReload",
+    "hard-reload",
+    "openResource",
+    "open-resource",
+    "requestApproval",
+    "request-approval",
+];
+const COMMAND_ALIASES = {
+    refreshData: ["refreshData", "refresh-data"],
+    "refresh-data": ["refreshData", "refresh-data"],
+    remountView: ["remountView", "remount-view"],
+    "remount-view": ["remountView", "remount-view"],
+    hardReload: ["hardReload", "hard-reload"],
+    "hard-reload": ["hardReload", "hard-reload"],
+    openResource: ["openResource", "open-resource"],
+    "open-resource": ["openResource", "open-resource"],
+    requestApproval: ["requestApproval", "request-approval"],
+    "request-approval": ["requestApproval", "request-approval"],
+};
+function setForwardedRef(ref, value) {
+    if (typeof ref === "function")
+        ref(value);
+    else if (ref)
+        ref.current = value;
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function safeError(error) {
+    return error instanceof Error ? error : new Error(String(error));
+}
+function safeStringify(value) {
+    try {
+        return JSON.stringify(value ?? {});
+    }
+    catch {
+        return "{}";
+    }
+}
+function resolvePermissionList(value, extension, fallback) {
+    if (typeof value === "function")
+        return value(extension);
+    if (Array.isArray(value))
+        return value;
+    return fallback;
+}
+function resolveStorageScopeList(value, extension, fallback) {
+    if (typeof value === "function")
+        return value(extension);
+    if (Array.isArray(value))
+        return value;
+    return fallback;
+}
+function toPermissionSet(value) {
+    return value ? new Set(value) : null;
+}
+function commandPermissionSet(value) {
+    if (!value)
+        return null;
+    const expanded = new Set();
+    for (const command of value) {
+        expanded.add(command);
+        for (const alias of COMMAND_ALIASES[command] ?? [])
+            expanded.add(alias);
+    }
+    return expanded;
+}
+async function resolveActions(actions) {
+    const resolved = typeof actions === "function" ? await actions() : actions;
+    return Array.isArray(resolved) ? resolved : [];
+}
+function scopeExtensionActions(actions, allowedNames) {
+    if (!actions || !allowedNames)
+        return actions;
+    return async () => (await resolveActions(actions)).filter((action) => allowedNames.has(action.name));
+}
+function blockedCommand(command) {
+    return () => {
+        throw new Error(`Extension is not allowed to call host command "${command}"`);
+    };
+}
+function scopeExtensionCommands(commands, allowedNames) {
+    if (!allowedNames)
+        return commands;
+    const scoped = {};
+    for (const command of BUILT_IN_COMMAND_NAMES) {
+        if (!allowedNames.has(command))
+            scoped[command] = blockedCommand(command);
+    }
+    for (const [command, handler] of Object.entries(commands ?? {})) {
+        scoped[command] = allowedNames.has(command)
+            ? handler
+            : blockedCommand(command);
+    }
+    return scoped;
+}
+function normalizeStorageRequest(value) {
+    if (!isRecord(value))
+        return null;
+    const requestId = typeof value.requestId === "string" ? value.requestId : "";
+    const op = value.op === "list" ||
+        value.op === "get" ||
+        value.op === "set" ||
+        value.op === "remove"
+        ? value.op
+        : null;
+    const collection = typeof value.collection === "string" ? value.collection.trim() : "";
+    const id = typeof value.id === "string" ? value.id : undefined;
+    const options = isRecord(value.options)
+        ? value.options
+        : undefined;
+    if (!requestId || !op || !collection)
+        return null;
+    if ((op === "get" || op === "set" || op === "remove") && !id) {
+        return null;
+    }
+    return {
+        requestId,
+        op,
+        collection,
+        id,
+        data: value.data,
+        options,
+    };
+}
+function mergeExtensionContext(base, extension, slotId, slotContext) {
+    return {
+        ...(base ?? {}),
+        extension: {
+            id: extension.id,
+            name: extension.name,
+            description: extension.description,
+        },
+        slot: slotId
+            ? {
+                id: slotId,
+                context: slotContext ?? {},
+            }
+            : undefined,
+        data: {
+            ...(base?.data ?? {}),
+            extension: {
+                id: extension.id,
+                name: extension.name,
+            },
+            slotContext: slotContext ?? {},
+        },
+    };
+}
+export const AgentNativeExtensionFrame = forwardRef(function AgentNativeExtensionFrame({ extension, slotId, context, actions, getContext, commands, allowedActions, allowedCommands, auth, session, storage, allowedStorageScopes, storageNamespace = "default", storageContext, themeCss, isDark, autoHeight = true, initialHeight = 120, onBridgeEvent, onBridgeReady, onStorageError, title, sandbox, allow = "clipboard-read; clipboard-write", referrerPolicy = "no-referrer", style, onLoad, ...iframeProps }, forwardedRef) {
+    const iframeRef = useRef(null);
+    const bridgeRef = useRef(null);
+    const [height, setHeight] = useState(initialHeight);
+    const localStorageAdapter = useMemo(() => createLocalStorageAgentNativeExtensionStorage(storageNamespace), [storageNamespace]);
+    const storageAdapter = storage === undefined ? localStorageAdapter : storage;
+    const contextJson = safeStringify(context);
+    const sandboxValue = useMemo(() => normalizeAgentNativeExtensionSandbox(sandbox), [sandbox]);
+    const sessionValue = session ?? `extension:${extension.id}:${slotId ?? "standalone"}`;
+    const manifest = useMemo(() => getAgentNativeExtensionManifest(extension), [extension]);
+    const actionAllowlist = useMemo(() => toPermissionSet(resolvePermissionList(allowedActions, extension, manifest.requestedActions)), [allowedActions, extension, manifest.requestedActions]);
+    const commandAllowlist = useMemo(() => commandPermissionSet(resolvePermissionList(allowedCommands, extension, manifest.requestedCommands)), [allowedCommands, extension, manifest.requestedCommands]);
+    const storageScopeAllowlist = useMemo(() => {
+        const scopes = resolveStorageScopeList(allowedStorageScopes, extension, manifest.storageScopes);
+        return scopes ? new Set(scopes) : null;
+    }, [allowedStorageScopes, extension, manifest.storageScopes]);
+    const scopedActions = useMemo(() => scopeExtensionActions(actions, actionAllowlist), [actions, actionAllowlist]);
+    const scopedCommands = useMemo(() => scopeExtensionCommands(commands, commandAllowlist), [commands, commandAllowlist]);
+    const getMergedContext = useCallback(async () => {
+        const base = getContext ? await getContext() : {};
+        return mergeExtensionContext(base, extension, slotId, context);
+    }, [contextJson, extension, getContext, slotId]);
+    const srcDoc = useMemo(() => buildAgentNativeExtensionHtml({
+        extensionId: extension.id,
+        title: title ?? extension.name,
+        content: extension.content,
+        slotId,
+        slotContext: context,
+        themeCss,
+        isDark,
+    }), [
+        contextJson,
+        extension.content,
+        extension.id,
+        extension.name,
+        isDark,
+        slotId,
+        themeCss,
+        title,
+    ]);
+    const postSlotContext = useCallback(() => {
+        iframeRef.current?.contentWindow?.postMessage({
+            type: AGENT_NATIVE_EXTENSION_MESSAGE_TYPES.SLOT_CONTEXT,
+            extensionId: extension.id,
+            slotId,
+            context: context ?? {},
+        }, "*");
+    }, [contextJson, extension.id, slotId]);
+    useEffect(() => {
+        const bridge = createAgentNativeHostBridge({
+            session: sessionValue,
+            getContext: getMergedContext,
+            commands: scopedCommands,
+            actions: scopedActions,
+            auth,
+            onEvent: onBridgeEvent,
+            targetWindow: iframeRef.current?.contentWindow ?? null,
+        }).start();
+        bridgeRef.current = bridge;
+        onBridgeReady?.(bridge);
+        return () => {
+            bridge.stop();
+            if (bridgeRef.current === bridge)
+                bridgeRef.current = null;
+        };
+    }, [
+        actions,
+        auth,
+        getMergedContext,
+        onBridgeEvent,
+        onBridgeReady,
+        sessionValue,
+        scopedActions,
+        scopedCommands,
+    ]);
+    useEffect(() => {
+        postSlotContext();
+        void bridgeRef.current?.refreshContext();
+    }, [postSlotContext]);
+    useEffect(() => {
+        if (typeof window === "undefined")
+            return;
+        const respond = (requestId, payload) => {
+            iframeRef.current?.contentWindow?.postMessage({
+                type: AGENT_NATIVE_EXTENSION_MESSAGE_TYPES.STORAGE_RESPONSE,
+                requestId,
+                ...payload,
+            }, "*");
+        };
+        const handleStorageRequest = async (request) => {
+            try {
+                if (!storageAdapter) {
+                    throw new Error("No extension storage adapter is registered");
+                }
+                const requestContext = {
+                    ...(storageContext ?? {}),
+                    extensionId: extension.id,
+                    slotId,
+                };
+                const { op, collection, id, data, options } = request;
+                const requestedScope = typeof options?.scope === "string"
+                    ? options.scope
+                    : (requestContext.scope ?? "user");
+                if (storageScopeAllowlist &&
+                    !storageScopeAllowlist.has(requestedScope)) {
+                    throw new Error(`Extension is not allowed to use storage scope "${requestedScope}"`);
+                }
+                const result = op === "list"
+                    ? await storageAdapter.list(collection, options, requestContext)
+                    : op === "get"
+                        ? await storageAdapter.get(collection, id, options, requestContext)
+                        : op === "set"
+                            ? await storageAdapter.set(collection, id, data, options, requestContext)
+                            : await storageAdapter.remove(collection, id, options, requestContext);
+                respond(request.requestId, { ok: true, result });
+            }
+            catch (error) {
+                const err = safeError(error);
+                onStorageError?.(err, request);
+                respond(request.requestId, { ok: false, error: err.message });
+            }
+        };
+        function onMessage(event) {
+            if (event.source !== iframeRef.current?.contentWindow)
+                return;
+            const message = event.data;
+            if (!isRecord(message))
+                return;
+            if (message.type === AGENT_NATIVE_EXTENSION_MESSAGE_TYPES.RESIZE) {
+                if (!autoHeight)
+                    return;
+                const nextHeight = Number(message.height);
+                if (Number.isFinite(nextHeight) && nextHeight > 0) {
+                    setHeight(Math.ceil(nextHeight));
+                }
+                return;
+            }
+            if (message.type !== AGENT_NATIVE_EXTENSION_MESSAGE_TYPES.STORAGE_REQUEST) {
+                return;
+            }
+            const request = normalizeStorageRequest(message);
+            if (!request) {
+                const requestId = typeof message.requestId === "string" ? message.requestId : "";
+                if (requestId) {
+                    respond(requestId, {
+                        ok: false,
+                        error: "Invalid extension storage request",
+                    });
+                }
+                return;
+            }
+            void handleStorageRequest(request);
+        }
+        window.addEventListener("message", onMessage);
+        return () => window.removeEventListener("message", onMessage);
+    }, [
+        autoHeight,
+        extension.id,
+        onStorageError,
+        slotId,
+        storageAdapter,
+        storageContext,
+        storageScopeAllowlist,
+    ]);
+    return (_createElement("iframe", { ...iframeProps, key: `${extension.id}:${extension.updatedAt ?? ""}`, ref: (node) => {
+            iframeRef.current = node;
+            setForwardedRef(forwardedRef, node);
+            bridgeRef.current?.setTargetWindow(node?.contentWindow ?? null);
+        }, title: title ?? extension.name, srcDoc: srcDoc, sandbox: sandboxValue, allow: allow, referrerPolicy: referrerPolicy, style: {
+            ...defaultFrameStyle,
+            height: autoHeight ? height : "100%",
+            ...style,
+        }, onLoad: (event) => {
+            bridgeRef.current?.setTargetWindow(event.currentTarget.contentWindow ?? null);
+            postSlotContext();
+            void bridgeRef.current?.sendInit();
+            onLoad?.(event);
+        } }));
+});
+export function AgentNativeExtensionSlot({ id, extensions, context, actions, getContext, commands, allowedActions, allowedCommands, auth, session, storage, allowedStorageScopes, storageNamespace, storageContext, themeCss, isDark, autoHeight, initialHeight, onBridgeEvent, onBridgeReady, onStorageError, className, extensionClassName, extensionStyle, empty = null, showEmptyAffordance = false, ...iframeProps }) {
+    const slotExtensions = extensions.filter((extension) => isAgentNativeExtensionAllowedInSlot(extension, id));
+    if (slotExtensions.length === 0) {
+        if (!showEmptyAffordance)
+            return null;
+        return _jsx("div", { className: className, children: empty });
+    }
+    return (_jsx("div", { className: className, children: slotExtensions.map((extension) => (_createElement(AgentNativeExtensionFrame, { ...iframeProps, key: extension.id, extension: extension, slotId: id, context: context, actions: actions, getContext: getContext, commands: commands, allowedActions: allowedActions, allowedCommands: allowedCommands, auth: auth, session: session, storage: storage, allowedStorageScopes: allowedStorageScopes, storageNamespace: storageNamespace, storageContext: storageContext, themeCss: themeCss, isDark: isDark, autoHeight: autoHeight, initialHeight: initialHeight, onBridgeEvent: onBridgeEvent, onBridgeReady: onBridgeReady, onStorageError: onStorageError, className: extensionClassName, style: extensionStyle }))) }));
+}
+//# sourceMappingURL=AgentNativeExtensionFrame.js.map