@immediately-run/sdk 0.2.2 → 0.2.4

package/dist/catalog.cjs

@@ -0,0 +1,83 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var catalog_exports = {};
+__export(catalog_exports, {
+  getCatalog: () => getCatalog,
+  invoke: () => invoke,
+  invokeStream: () => invokeStream,
+  onCatalogChange: () => onCatalogChange,
+  useCatalog: () => useCatalog
+});
+module.exports = __toCommonJS(catalog_exports);
+var import_react = require("react");
+var import_sandboxUtils = require("./sandboxUtils");
+var import_protocolStream = require("./protocolStream");
+const split = (name) => {
+  const i = name.indexOf(":");
+  if (i <= 0) throw new Error(`invalid catalog method name: ${name}`);
+  return [name.slice(0, i), name.slice(i + 1)];
+};
+const invoke = async (name, params = {}) => {
+  const [scheme, method] = split(name);
+  const res = await (0, import_sandboxUtils.protocolRequest)(scheme, method, [params]);
+  if (!res || res.ok !== true) {
+    const err = new Error(res?.message ?? `${name} failed`);
+    err.code = res?.code ?? "unknown";
+    throw err;
+  }
+  return res.data;
+};
+const bundlerTransport = {
+  send: (msg) => (
+    // @ts-ignore - injected by the sandbox runtime
+    module.evaluation.module.bundler.messageBus.sendMessage(msg.type, msg)
+  ),
+  subscribe: (type, handler) => {
+    const d = module.evaluation.module.bundler.messageBus.onMessage((m) => {
+      if (m && m.type === type) handler(m);
+    });
+    return () => d.dispose();
+  }
+};
+function invokeStream(name, params = {}) {
+  const [scheme, method] = split(name);
+  return (0, import_protocolStream.consumeStream)(bundlerTransport, `protocol-${scheme}`, method, [params]);
+}
+const catalogService = () => {
+  return module.evaluation.module.bundler.catalog;
+};
+const getCatalog = () => catalogService().getCatalog();
+const onCatalogChange = (listener) => {
+  const disposable = catalogService().onChange(listener);
+  return () => disposable.dispose();
+};
+const useCatalog = () => {
+  const [catalog, setCatalog] = (0, import_react.useState)(getCatalog);
+  (0, import_react.useEffect)(() => onCatalogChange(setCatalog), []);
+  return catalog;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getCatalog,
+  invoke,
+  invokeStream,
+  onCatalogChange,
+  useCatalog
+});
+//# sourceMappingURL=catalog.cjs.map

package/dist/catalog.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/catalog.ts"],"sourcesContent":["// The method catalog (UI_AS_APPS_SPEC §5.5) — the app's own grant-filtered RPC\n// surface, and a generic way to call it. The host advertises exactly the methods\n// this app may invoke (MCP-tool-shaped); `invoke()` calls one by its catalog name.\n// Handing the catalog to an embedded agent as its tool list confines the agent to\n// the app's authority (agent sandboxing falls out of the capability model, §5.9).\nimport { useEffect, useState } from 'react';\nimport { protocolRequest } from './sandboxUtils';\nimport type { StreamFrame } from './protocolStream';\nimport { consumeStream } from './protocolStream';\n\n/** One advertised method, as the host generated it from its gate table. */\nexport interface ApiMethod {\n  /** Catalog name, `protocol-` stripped — e.g. `spaces:share`, `contribute:run`. */\n  name: string;\n  /** The capability this method requires (already held — it's in your catalog). */\n  capability: string;\n  /** True when the method STREAMS (use {@link invokeStream}) vs. single-reply. */\n  stream?: boolean;\n}\n\n// `scheme:method` → ['scheme', 'method'] (the wire protocol is `protocol-scheme`).\nconst split = (name: string): [string, string] => {\n  const i = name.indexOf(':');\n  if (i <= 0) throw new Error(`invalid catalog method name: ${name}`);\n  return [name.slice(0, i), name.slice(i + 1)];\n};\n\n/**\n * Call a catalog method by name — `invoke('spaces:share', { spaceId, login, role })`.\n * A thin generic over the host protocol: the host validates params and gates the\n * call (an un-granted method → `forbidden`, even if you name it directly). For a\n * STREAMING method (`ApiMethod.stream`), use {@link invokeStream}.\n */\nexport const invoke = async <T = unknown>(\n  name: string,\n  params: Record<string, unknown> = {},\n): Promise<T> => {\n  const [scheme, method] = split(name);\n  // The host replies with an `{ ok, data } | { ok:false, code }` envelope; unwrap\n  // it and THROW on refusal (a `.code` like `forbidden` for an off-catalog call)\n  // so callers — and any agent driving `invoke` — see the gate's verdict.\n  const res = (await protocolRequest(scheme, method, [params])) as\n    | { ok: true; data: unknown }\n    | { ok: false; code?: string; message?: string }\n    | undefined;\n  if (!res || res.ok !== true) {\n    const err = new Error(res?.message ?? `${name} failed`) as Error & { code?: string };\n    err.code = res?.code ?? 'unknown';\n    throw err;\n  }\n  return res.data as T;\n};\n\nconst bundlerTransport = {\n  send: (msg: { type: string; method: string; params: unknown[]; msgId: number; stream: true }) =>\n    // @ts-ignore - injected by the sandbox runtime\n    module.evaluation.module.bundler.messageBus.sendMessage(msg.type, msg),\n  subscribe: (type: string, handler: (msg: { msgId?: number; stream?: StreamFrame }) => void) => {\n    // @ts-ignore - injected by the sandbox runtime\n    const d = module.evaluation.module.bundler.messageBus.onMessage((m: { type?: string }) => {\n      if (m && m.type === type) handler(m as { msgId?: number; stream?: StreamFrame });\n    });\n    return () => d.dispose();\n  },\n};\n\n/** Call a STREAMING catalog method by name, yielding its events. */\nexport function invokeStream<T = unknown, R = unknown>(\n  name: string,\n  params: Record<string, unknown> = {},\n): AsyncGenerator<T, R, void> {\n  const [scheme, method] = split(name);\n  return consumeStream<T, R>(bundlerTransport, `protocol-${scheme}`, method, [params]);\n}\n\ninterface CatalogService {\n  getCatalog(): ApiMethod[];\n  onChange(listener: (catalog: ApiMethod[]) => void): { dispose(): void };\n}\n\n// `module.evaluation.module.bundler.catalog` — injected by the sandbox runtime.\nconst catalogService = (): CatalogService => {\n  // @ts-ignore - injected by the sandbox runtime\n  return module.evaluation.module.bundler.catalog;\n};\n\n/** The methods this app may call (grant-filtered, §5.5). Poll for a one-off read;\n *  use {@link onCatalogChange} / {@link useCatalog} to react. */\nexport const getCatalog = (): ApiMethod[] => catalogService().getCatalog();\n\n/** Subscribe to catalog changes (e.g. a grant added/revoked). Invoked immediately\n *  with the current catalog, then on every change. Returns an unsubscribe fn. */\nexport const onCatalogChange = (listener: (catalog: ApiMethod[]) => void): (() => void) => {\n  const disposable = catalogService().onChange(listener);\n  return () => disposable.dispose();\n};\n\n/** React hook returning this app's method catalog, re-rendering on change. Hand\n *  it to an embedded agent as its tool list to confine the agent to the app's\n *  authority (§5.9). */\nexport const useCatalog = (): ApiMethod[] => {\n  const [catalog, setCatalog] = useState<ApiMethod[]>(getCatalog);\n  useEffect(() => onCatalogChange(setCatalog), []);\n  return catalog;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,mBAAoC;AACpC,0BAAgC;AAEhC,4BAA8B;AAa9B,MAAM,QAAQ,CAAC,SAAmC;AAChD,QAAM,IAAI,KAAK,QAAQ,GAAG;AAC1B,MAAI,KAAK,EAAG,OAAM,IAAI,MAAM,gCAAgC,IAAI,EAAE;AAClE,SAAO,CAAC,KAAK,MAAM,GAAG,CAAC,GAAG,KAAK,MAAM,IAAI,CAAC,CAAC;AAC7C;AAQO,MAAM,SAAS,OACpB,MACA,SAAkC,CAAC,MACpB;AACf,QAAM,CAAC,QAAQ,MAAM,IAAI,MAAM,IAAI;AAInC,QAAM,MAAO,UAAM,qCAAgB,QAAQ,QAAQ,CAAC,MAAM,CAAC;AAI3D,MAAI,CAAC,OAAO,IAAI,OAAO,MAAM;AAC3B,UAAM,MAAM,IAAI,MAAM,KAAK,WAAW,GAAG,IAAI,SAAS;AACtD,QAAI,OAAO,KAAK,QAAQ;AACxB,UAAM;AAAA,EACR;AACA,SAAO,IAAI;AACb;AAEA,MAAM,mBAAmB;AAAA,EACvB,MAAM,CAAC;AAAA;AAAA,IAEL,OAAO,WAAW,OAAO,QAAQ,WAAW,YAAY,IAAI,MAAM,GAAG;AAAA;AAAA,EACvE,WAAW,CAAC,MAAc,YAAqE;AAE7F,UAAM,IAAI,OAAO,WAAW,OAAO,QAAQ,WAAW,UAAU,CAAC,MAAyB;AACxF,UAAI,KAAK,EAAE,SAAS,KAAM,SAAQ,CAA6C;AAAA,IACjF,CAAC;AACD,WAAO,MAAM,EAAE,QAAQ;AAAA,EACzB;AACF;AAGO,SAAS,aACd,MACA,SAAkC,CAAC,GACP;AAC5B,QAAM,CAAC,QAAQ,MAAM,IAAI,MAAM,IAAI;AACnC,aAAO,qCAAoB,kBAAkB,YAAY,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC;AACrF;AAQA,MAAM,iBAAiB,MAAsB;AAE3C,SAAO,OAAO,WAAW,OAAO,QAAQ;AAC1C;AAIO,MAAM,aAAa,MAAmB,eAAe,EAAE,WAAW;AAIlE,MAAM,kBAAkB,CAAC,aAA2D;AACzF,QAAM,aAAa,eAAe,EAAE,SAAS,QAAQ;AACrD,SAAO,MAAM,WAAW,QAAQ;AAClC;AAKO,MAAM,aAAa,MAAmB;AAC3C,QAAM,CAAC,SAAS,UAAU,QAAI,uBAAsB,UAAU;AAC9D,8BAAU,MAAM,gBAAgB,UAAU,GAAG,CAAC,CAAC;AAC/C,SAAO;AACT;","names":[]}

package/dist/catalog.d.cts

@@ -0,0 +1,30 @@
+/** One advertised method, as the host generated it from its gate table. */
+interface ApiMethod {
+    /** Catalog name, `protocol-` stripped — e.g. `spaces:share`, `contribute:run`. */
+    name: string;
+    /** The capability this method requires (already held — it's in your catalog). */
+    capability: string;
+    /** True when the method STREAMS (use {@link invokeStream}) vs. single-reply. */
+    stream?: boolean;
+}
+/**
+ * Call a catalog method by name — `invoke('spaces:share', { spaceId, login, role })`.
+ * A thin generic over the host protocol: the host validates params and gates the
+ * call (an un-granted method → `forbidden`, even if you name it directly). For a
+ * STREAMING method (`ApiMethod.stream`), use {@link invokeStream}.
+ */
+declare const invoke: <T = unknown>(name: string, params?: Record<string, unknown>) => Promise<T>;
+/** Call a STREAMING catalog method by name, yielding its events. */
+declare function invokeStream<T = unknown, R = unknown>(name: string, params?: Record<string, unknown>): AsyncGenerator<T, R, void>;
+/** The methods this app may call (grant-filtered, §5.5). Poll for a one-off read;
+ *  use {@link onCatalogChange} / {@link useCatalog} to react. */
+declare const getCatalog: () => ApiMethod[];
+/** Subscribe to catalog changes (e.g. a grant added/revoked). Invoked immediately
+ *  with the current catalog, then on every change. Returns an unsubscribe fn. */
+declare const onCatalogChange: (listener: (catalog: ApiMethod[]) => void) => (() => void);
+/** React hook returning this app's method catalog, re-rendering on change. Hand
+ *  it to an embedded agent as its tool list to confine the agent to the app's
+ *  authority (§5.9). */
+declare const useCatalog: () => ApiMethod[];
+
+export { type ApiMethod, getCatalog, invoke, invokeStream, onCatalogChange, useCatalog };

package/dist/catalog.d.ts

@@ -0,0 +1,30 @@
+/** One advertised method, as the host generated it from its gate table. */
+interface ApiMethod {
+    /** Catalog name, `protocol-` stripped — e.g. `spaces:share`, `contribute:run`. */
+    name: string;
+    /** The capability this method requires (already held — it's in your catalog). */
+    capability: string;
+    /** True when the method STREAMS (use {@link invokeStream}) vs. single-reply. */
+    stream?: boolean;
+}
+/**
+ * Call a catalog method by name — `invoke('spaces:share', { spaceId, login, role })`.
+ * A thin generic over the host protocol: the host validates params and gates the
+ * call (an un-granted method → `forbidden`, even if you name it directly). For a
+ * STREAMING method (`ApiMethod.stream`), use {@link invokeStream}.
+ */
+declare const invoke: <T = unknown>(name: string, params?: Record<string, unknown>) => Promise<T>;
+/** Call a STREAMING catalog method by name, yielding its events. */
+declare function invokeStream<T = unknown, R = unknown>(name: string, params?: Record<string, unknown>): AsyncGenerator<T, R, void>;
+/** The methods this app may call (grant-filtered, §5.5). Poll for a one-off read;
+ *  use {@link onCatalogChange} / {@link useCatalog} to react. */
+declare const getCatalog: () => ApiMethod[];
+/** Subscribe to catalog changes (e.g. a grant added/revoked). Invoked immediately
+ *  with the current catalog, then on every change. Returns an unsubscribe fn. */
+declare const onCatalogChange: (listener: (catalog: ApiMethod[]) => void) => (() => void);
+/** React hook returning this app's method catalog, re-rendering on change. Hand
+ *  it to an embedded agent as its tool list to confine the agent to the app's
+ *  authority (§5.9). */
+declare const useCatalog: () => ApiMethod[];
+
+export { type ApiMethod, getCatalog, invoke, invokeStream, onCatalogChange, useCatalog };

package/dist/catalog.js

@@ -0,0 +1,55 @@
+import { useEffect, useState } from "react";
+import { protocolRequest } from "./sandboxUtils";
+import { consumeStream } from "./protocolStream";
+const split = (name) => {
+  const i = name.indexOf(":");
+  if (i <= 0) throw new Error(`invalid catalog method name: ${name}`);
+  return [name.slice(0, i), name.slice(i + 1)];
+};
+const invoke = async (name, params = {}) => {
+  const [scheme, method] = split(name);
+  const res = await protocolRequest(scheme, method, [params]);
+  if (!res || res.ok !== true) {
+    const err = new Error(res?.message ?? `${name} failed`);
+    err.code = res?.code ?? "unknown";
+    throw err;
+  }
+  return res.data;
+};
+const bundlerTransport = {
+  send: (msg) => (
+    // @ts-ignore - injected by the sandbox runtime
+    module.evaluation.module.bundler.messageBus.sendMessage(msg.type, msg)
+  ),
+  subscribe: (type, handler) => {
+    const d = module.evaluation.module.bundler.messageBus.onMessage((m) => {
+      if (m && m.type === type) handler(m);
+    });
+    return () => d.dispose();
+  }
+};
+function invokeStream(name, params = {}) {
+  const [scheme, method] = split(name);
+  return consumeStream(bundlerTransport, `protocol-${scheme}`, method, [params]);
+}
+const catalogService = () => {
+  return module.evaluation.module.bundler.catalog;
+};
+const getCatalog = () => catalogService().getCatalog();
+const onCatalogChange = (listener) => {
+  const disposable = catalogService().onChange(listener);
+  return () => disposable.dispose();
+};
+const useCatalog = () => {
+  const [catalog, setCatalog] = useState(getCatalog);
+  useEffect(() => onCatalogChange(setCatalog), []);
+  return catalog;
+};
+export {
+  getCatalog,
+  invoke,
+  invokeStream,
+  onCatalogChange,
+  useCatalog
+};
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/catalog.ts"],"sourcesContent":["// The method catalog (UI_AS_APPS_SPEC §5.5) — the app's own grant-filtered RPC\n// surface, and a generic way to call it. The host advertises exactly the methods\n// this app may invoke (MCP-tool-shaped); `invoke()` calls one by its catalog name.\n// Handing the catalog to an embedded agent as its tool list confines the agent to\n// the app's authority (agent sandboxing falls out of the capability model, §5.9).\nimport { useEffect, useState } from 'react';\nimport { protocolRequest } from './sandboxUtils';\nimport type { StreamFrame } from './protocolStream';\nimport { consumeStream } from './protocolStream';\n\n/** One advertised method, as the host generated it from its gate table. */\nexport interface ApiMethod {\n  /** Catalog name, `protocol-` stripped — e.g. `spaces:share`, `contribute:run`. */\n  name: string;\n  /** The capability this method requires (already held — it's in your catalog). */\n  capability: string;\n  /** True when the method STREAMS (use {@link invokeStream}) vs. single-reply. */\n  stream?: boolean;\n}\n\n// `scheme:method` → ['scheme', 'method'] (the wire protocol is `protocol-scheme`).\nconst split = (name: string): [string, string] => {\n  const i = name.indexOf(':');\n  if (i <= 0) throw new Error(`invalid catalog method name: ${name}`);\n  return [name.slice(0, i), name.slice(i + 1)];\n};\n\n/**\n * Call a catalog method by name — `invoke('spaces:share', { spaceId, login, role })`.\n * A thin generic over the host protocol: the host validates params and gates the\n * call (an un-granted method → `forbidden`, even if you name it directly). For a\n * STREAMING method (`ApiMethod.stream`), use {@link invokeStream}.\n */\nexport const invoke = async <T = unknown>(\n  name: string,\n  params: Record<string, unknown> = {},\n): Promise<T> => {\n  const [scheme, method] = split(name);\n  // The host replies with an `{ ok, data } | { ok:false, code }` envelope; unwrap\n  // it and THROW on refusal (a `.code` like `forbidden` for an off-catalog call)\n  // so callers — and any agent driving `invoke` — see the gate's verdict.\n  const res = (await protocolRequest(scheme, method, [params])) as\n    | { ok: true; data: unknown }\n    | { ok: false; code?: string; message?: string }\n    | undefined;\n  if (!res || res.ok !== true) {\n    const err = new Error(res?.message ?? `${name} failed`) as Error & { code?: string };\n    err.code = res?.code ?? 'unknown';\n    throw err;\n  }\n  return res.data as T;\n};\n\nconst bundlerTransport = {\n  send: (msg: { type: string; method: string; params: unknown[]; msgId: number; stream: true }) =>\n    // @ts-ignore - injected by the sandbox runtime\n    module.evaluation.module.bundler.messageBus.sendMessage(msg.type, msg),\n  subscribe: (type: string, handler: (msg: { msgId?: number; stream?: StreamFrame }) => void) => {\n    // @ts-ignore - injected by the sandbox runtime\n    const d = module.evaluation.module.bundler.messageBus.onMessage((m: { type?: string }) => {\n      if (m && m.type === type) handler(m as { msgId?: number; stream?: StreamFrame });\n    });\n    return () => d.dispose();\n  },\n};\n\n/** Call a STREAMING catalog method by name, yielding its events. */\nexport function invokeStream<T = unknown, R = unknown>(\n  name: string,\n  params: Record<string, unknown> = {},\n): AsyncGenerator<T, R, void> {\n  const [scheme, method] = split(name);\n  return consumeStream<T, R>(bundlerTransport, `protocol-${scheme}`, method, [params]);\n}\n\ninterface CatalogService {\n  getCatalog(): ApiMethod[];\n  onChange(listener: (catalog: ApiMethod[]) => void): { dispose(): void };\n}\n\n// `module.evaluation.module.bundler.catalog` — injected by the sandbox runtime.\nconst catalogService = (): CatalogService => {\n  // @ts-ignore - injected by the sandbox runtime\n  return module.evaluation.module.bundler.catalog;\n};\n\n/** The methods this app may call (grant-filtered, §5.5). Poll for a one-off read;\n *  use {@link onCatalogChange} / {@link useCatalog} to react. */\nexport const getCatalog = (): ApiMethod[] => catalogService().getCatalog();\n\n/** Subscribe to catalog changes (e.g. a grant added/revoked). Invoked immediately\n *  with the current catalog, then on every change. Returns an unsubscribe fn. */\nexport const onCatalogChange = (listener: (catalog: ApiMethod[]) => void): (() => void) => {\n  const disposable = catalogService().onChange(listener);\n  return () => disposable.dispose();\n};\n\n/** React hook returning this app's method catalog, re-rendering on change. Hand\n *  it to an embedded agent as its tool list to confine the agent to the app's\n *  authority (§5.9). */\nexport const useCatalog = (): ApiMethod[] => {\n  const [catalog, setCatalog] = useState<ApiMethod[]>(getCatalog);\n  useEffect(() => onCatalogChange(setCatalog), []);\n  return catalog;\n};\n"],"mappings":"AAKA,SAAS,WAAW,gBAAgB;AACpC,SAAS,uBAAuB;AAEhC,SAAS,qBAAqB;AAa9B,MAAM,QAAQ,CAAC,SAAmC;AAChD,QAAM,IAAI,KAAK,QAAQ,GAAG;AAC1B,MAAI,KAAK,EAAG,OAAM,IAAI,MAAM,gCAAgC,IAAI,EAAE;AAClE,SAAO,CAAC,KAAK,MAAM,GAAG,CAAC,GAAG,KAAK,MAAM,IAAI,CAAC,CAAC;AAC7C;AAQO,MAAM,SAAS,OACpB,MACA,SAAkC,CAAC,MACpB;AACf,QAAM,CAAC,QAAQ,MAAM,IAAI,MAAM,IAAI;AAInC,QAAM,MAAO,MAAM,gBAAgB,QAAQ,QAAQ,CAAC,MAAM,CAAC;AAI3D,MAAI,CAAC,OAAO,IAAI,OAAO,MAAM;AAC3B,UAAM,MAAM,IAAI,MAAM,KAAK,WAAW,GAAG,IAAI,SAAS;AACtD,QAAI,OAAO,KAAK,QAAQ;AACxB,UAAM;AAAA,EACR;AACA,SAAO,IAAI;AACb;AAEA,MAAM,mBAAmB;AAAA,EACvB,MAAM,CAAC;AAAA;AAAA,IAEL,OAAO,WAAW,OAAO,QAAQ,WAAW,YAAY,IAAI,MAAM,GAAG;AAAA;AAAA,EACvE,WAAW,CAAC,MAAc,YAAqE;AAE7F,UAAM,IAAI,OAAO,WAAW,OAAO,QAAQ,WAAW,UAAU,CAAC,MAAyB;AACxF,UAAI,KAAK,EAAE,SAAS,KAAM,SAAQ,CAA6C;AAAA,IACjF,CAAC;AACD,WAAO,MAAM,EAAE,QAAQ;AAAA,EACzB;AACF;AAGO,SAAS,aACd,MACA,SAAkC,CAAC,GACP;AAC5B,QAAM,CAAC,QAAQ,MAAM,IAAI,MAAM,IAAI;AACnC,SAAO,cAAoB,kBAAkB,YAAY,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC;AACrF;AAQA,MAAM,iBAAiB,MAAsB;AAE3C,SAAO,OAAO,WAAW,OAAO,QAAQ;AAC1C;AAIO,MAAM,aAAa,MAAmB,eAAe,EAAE,WAAW;AAIlE,MAAM,kBAAkB,CAAC,aAA2D;AACzF,QAAM,aAAa,eAAe,EAAE,SAAS,QAAQ;AACrD,SAAO,MAAM,WAAW,QAAQ;AAClC;AAKO,MAAM,aAAa,MAAmB;AAC3C,QAAM,CAAC,SAAS,UAAU,IAAI,SAAsB,UAAU;AAC9D,YAAU,MAAM,gBAAgB,UAAU,GAAG,CAAC,CAAC;AAC/C,SAAO;AACT;","names":[]}

package/dist/index.cjs

@@ -27,6 +27,7 @@ __reExport(index_exports, require("./editorContext"), module.exports);
 __reExport(index_exports, require("./formFactor"), module.exports);
 __reExport(index_exports, require("./mounts"), module.exports);
 __reExport(index_exports, require("./contribute"), module.exports);
+__reExport(index_exports, require("./catalog"), module.exports);
 __reExport(index_exports, require("./protocolStream"), module.exports);
 __reExport(index_exports, require("./sandboxTypes"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
@@ -43,6 +44,7 @@ __reExport(index_exports, require("./sandboxTypes"), module.exports);
   ...require("./formFactor"),
   ...require("./mounts"),
   ...require("./contribute"),
+  ...require("./catalog"),
   ...require("./protocolStream"),
   ...require("./sandboxTypes")
 });

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from \"./MDXProvider\";\nexport * from \"./routing\";\nexport * from \"./boot\";\nexport * from './components/Include';\nexport * from './components/MDXComponents';\nexport * from './hooks'\nexport * from './auth';\nexport * from './theme';\nexport * from './editorContext';\nexport * from './formFactor';\nexport * from './mounts';\nexport * from './contribute';\nexport * from './protocolStream';\nexport * from './sandboxTypes';\n"],"mappings":";;;;;;;;;;;;;;;AAAA;AAAA;AAAA,0BAAc,0BAAd;AACA,0BAAc,sBADd;AAEA,0BAAc,mBAFd;AAGA,0BAAc,iCAHd;AAIA,0BAAc,uCAJd;AAKA,0BAAc,oBALd;AAMA,0BAAc,mBANd;AAOA,0BAAc,oBAPd;AAQA,0BAAc,4BARd;AASA,0BAAc,yBATd;AAUA,0BAAc,qBAVd;AAWA,0BAAc,yBAXd;AAYA,0BAAc,6BAZd;AAaA,0BAAc,2BAbd;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from \"./MDXProvider\";\nexport * from \"./routing\";\nexport * from \"./boot\";\nexport * from './components/Include';\nexport * from './components/MDXComponents';\nexport * from './hooks'\nexport * from './auth';\nexport * from './theme';\nexport * from './editorContext';\nexport * from './formFactor';\nexport * from './mounts';\nexport * from './contribute';\nexport * from './catalog';\nexport * from './protocolStream';\nexport * from './sandboxTypes';\n"],"mappings":";;;;;;;;;;;;;;;AAAA;AAAA;AAAA,0BAAc,0BAAd;AACA,0BAAc,sBADd;AAEA,0BAAc,mBAFd;AAGA,0BAAc,iCAHd;AAIA,0BAAc,uCAJd;AAKA,0BAAc,oBALd;AAMA,0BAAc,mBANd;AAOA,0BAAc,oBAPd;AAQA,0BAAc,4BARd;AASA,0BAAc,yBATd;AAUA,0BAAc,qBAVd;AAWA,0BAAc,yBAXd;AAYA,0BAAc,sBAZd;AAaA,0BAAc,6BAbd;AAcA,0BAAc,2BAdd;","names":[]}

package/dist/index.d.cts

@@ -10,6 +10,7 @@ export { EditorContext, getEditorContext, onEditorContextChange, useEditorContex
 export { FormFactor, FormFactorClass, Orientation, getFormFactor, onFormFactorChange, useFormFactor } from './formFactor.cjs';
 export { GrantRecord, Member, MountQuery, ResolvedUser, Role, SandboxMount, SpaceError, SpaceInfo, createSpace, findMount, getMounts, getSpaceMembers, listAllSpaces, listGrants, listSpaces, lookupUser, mount, mountSpace, onMountsChange, openAppSpace, requestMount, requestSpace, revokeGrant, setSpaceRole, shareSpace, unmountSpace, unshareSpace, useMounts, waitForMount } from './mounts.cjs';
 export { ContributeMode, ContributeOptions, ContributionEvent, ContributionResult, contribute } from './contribute.cjs';
+export { ApiMethod, getCatalog, invoke, invokeStream, onCatalogChange, useCatalog } from './catalog.cjs';
 export { StreamError, StreamFrame, StreamTransport, consumeStream, protocolStream } from './protocolStream.cjs';
 export { EvaluationContext, FileQueryResult, FilesMetadata, Metadata, MetadataQueryFunction, MetadataQueryResult, ModuleExports } from './sandboxTypes.cjs';
 import 'react';

package/dist/index.d.ts

@@ -10,6 +10,7 @@ export { EditorContext, getEditorContext, onEditorContextChange, useEditorContex
 export { FormFactor, FormFactorClass, Orientation, getFormFactor, onFormFactorChange, useFormFactor } from './formFactor.js';
 export { GrantRecord, Member, MountQuery, ResolvedUser, Role, SandboxMount, SpaceError, SpaceInfo, createSpace, findMount, getMounts, getSpaceMembers, listAllSpaces, listGrants, listSpaces, lookupUser, mount, mountSpace, onMountsChange, openAppSpace, requestMount, requestSpace, revokeGrant, setSpaceRole, shareSpace, unmountSpace, unshareSpace, useMounts, waitForMount } from './mounts.js';
 export { ContributeMode, ContributeOptions, ContributionEvent, ContributionResult, contribute } from './contribute.js';
+export { ApiMethod, getCatalog, invoke, invokeStream, onCatalogChange, useCatalog } from './catalog.js';
 export { StreamError, StreamFrame, StreamTransport, consumeStream, protocolStream } from './protocolStream.js';
 export { EvaluationContext, FileQueryResult, FilesMetadata, Metadata, MetadataQueryFunction, MetadataQueryResult, ModuleExports } from './sandboxTypes.js';
 import 'react';

package/dist/index.js

@@ -10,6 +10,7 @@ export * from "./editorContext";
 export * from "./formFactor";
 export * from "./mounts";
 export * from "./contribute";
+export * from "./catalog";
 export * from "./protocolStream";
 export * from "./sandboxTypes";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from \"./MDXProvider\";\nexport * from \"./routing\";\nexport * from \"./boot\";\nexport * from './components/Include';\nexport * from './components/MDXComponents';\nexport * from './hooks'\nexport * from './auth';\nexport * from './theme';\nexport * from './editorContext';\nexport * from './formFactor';\nexport * from './mounts';\nexport * from './contribute';\nexport * from './protocolStream';\nexport * from './sandboxTypes';\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from \"./MDXProvider\";\nexport * from \"./routing\";\nexport * from \"./boot\";\nexport * from './components/Include';\nexport * from './components/MDXComponents';\nexport * from './hooks'\nexport * from './auth';\nexport * from './theme';\nexport * from './editorContext';\nexport * from './formFactor';\nexport * from './mounts';\nexport * from './contribute';\nexport * from './catalog';\nexport * from './protocolStream';\nexport * from './sandboxTypes';\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@immediately-run/sdk",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Runtime SDK for code executing inside an immediately.run sandbox.",
   "license": "MIT",
   "repository": "github:immediately-run/immediately-run-sdk",