@shadowob/sdk 1.1.7 → 1.1.9

package/bin/shadow-server-app.mjs

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs'
+import { dirname, relative, resolve } from 'node:path'
+
+function usage(exitCode = 1) {
+  const out = exitCode === 0 ? console.log : console.error
+  out(`Usage:
+  shadow-server-app typegen <manifest.json> <output.ts>
+
+Generates a typed TypeScript manifest module from a Shadow server app JSON manifest.`)
+  process.exit(exitCode)
+}
+
+function readJson(filePath) {
+  try {
+    return JSON.parse(readFileSync(filePath, 'utf8'))
+  } catch (error) {
+    throw new Error(`Failed to read JSON manifest at ${filePath}: ${error.message}`)
+  }
+}
+
+function importPath(fromFile, toFile) {
+  let value = relative(dirname(fromFile), toFile).replaceAll('\\', '/')
+  if (!value.startsWith('.')) value = `./${value}`
+  return value.replace(/\.[cm]?ts$/, '.js')
+}
+
+function generateTypeModule(manifestPath, outputPath) {
+  const manifest = readJson(manifestPath)
+  const sdkImport = '@shadowob/sdk'
+  const sourceImport = importPath(outputPath, manifestPath)
+  const contents = `// Generated by shadow-server-app typegen from ${sourceImport}.
+// Do not edit by hand. Update the JSON manifest and regenerate this file.
+import type { ShadowServerAppManifest } from '${sdkImport}'
+
+export const shadowServerAppManifest = ${JSON.stringify(manifest, null, 2)} as const satisfies ShadowServerAppManifest
+
+export type ShadowServerAppManifestDefinition = typeof shadowServerAppManifest
+`
+  mkdirSync(dirname(outputPath), { recursive: true })
+  writeFileSync(outputPath, contents)
+}
+
+const [, , command, manifestArg, outputArg] = process.argv
+
+if (!command || command === '--help' || command === '-h') usage(command ? 0 : 1)
+
+if (command !== 'typegen' || !manifestArg || !outputArg) usage()
+
+try {
+  const manifestPath = resolve(process.cwd(), manifestArg)
+  const outputPath = resolve(process.cwd(), outputArg)
+  generateTypeModule(manifestPath, outputPath)
+  console.log(`Generated ${relative(process.cwd(), outputPath)}`)
+} catch (error) {
+  console.error(error instanceof Error ? error.message : String(error))
+  process.exit(1)
+}

package/dist/bridge.cjs

@@ -0,0 +1,364 @@
+"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);
+
+// src/bridge.ts
+var bridge_exports = {};
+__export(bridge_exports, {
+  SHADOW_SERVER_APP_COMMAND_COMPLETED_EVENT: () => SHADOW_SERVER_APP_COMMAND_COMPLETED_EVENT,
+  SHADOW_SERVER_APP_COMMAND_EVENTS: () => SHADOW_SERVER_APP_COMMAND_EVENTS,
+  SHADOW_SERVER_APP_COMMAND_FAILED_EVENT: () => SHADOW_SERVER_APP_COMMAND_FAILED_EVENT,
+  ShadowBridge: () => ShadowBridge,
+  buildShadowServerAppInboxDelivery: () => buildShadowServerAppInboxDelivery,
+  buildShadowServerAppInboxTaskRequest: () => buildShadowServerAppInboxTaskRequest,
+  getShadowServerAppChannelMessageDeliveries: () => getShadowServerAppChannelMessageDeliveries,
+  getShadowServerAppChannelMessageErrors: () => getShadowServerAppChannelMessageErrors,
+  getShadowServerAppTaskCardId: () => getShadowServerAppTaskCardId,
+  shadowServerAppInboxTaskEndpoint: () => shadowServerAppInboxTaskEndpoint
+});
+module.exports = __toCommonJS(bridge_exports);
+
+// src/server-app.ts
+var SHADOW_SERVER_APP_PROTOCOL = "shadow.app/1";
+var SHADOW_SERVER_APP_COMMAND_COMPLETED_EVENT = "server_app.command.completed";
+var SHADOW_SERVER_APP_COMMAND_FAILED_EVENT = "server_app.command.failed";
+var SHADOW_SERVER_APP_COMMAND_EVENTS = [
+  SHADOW_SERVER_APP_COMMAND_COMPLETED_EVENT,
+  SHADOW_SERVER_APP_COMMAND_FAILED_EVENT
+];
+function isProtocolRecord(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function optionalProtocolString(value) {
+  return typeof value === "string" && value ? value : void 0;
+}
+function protocolPathSegment(value) {
+  return encodeURIComponent(value);
+}
+function shadowServerAppInboxTaskEndpoint(serverIdOrSlug, target) {
+  if ("channelId" in target && target.channelId) {
+    return `/api/channels/${protocolPathSegment(target.channelId)}/inbox/tasks`;
+  }
+  if ("agentId" in target && target.agentId) {
+    return `/api/servers/${protocolPathSegment(serverIdOrSlug)}/inboxes/${protocolPathSegment(
+      target.agentId
+    )}/tasks`;
+  }
+  throw new Error("Missing Inbox task target");
+}
+function buildShadowServerAppInboxTaskRequest(input) {
+  const appId = input.app.id ?? input.app.appId ?? input.app.appKey;
+  const serverAppData = isProtocolRecord(input.task.data?.serverApp) ? input.task.data.serverApp : {};
+  return {
+    endpoint: shadowServerAppInboxTaskEndpoint(input.serverIdOrSlug, input.target),
+    body: {
+      title: input.task.title,
+      body: input.task.body,
+      priority: input.task.priority,
+      idempotencyKey: input.task.idempotencyKey,
+      source: {
+        kind: "server_app",
+        id: appId,
+        appId,
+        appKey: input.app.appKey,
+        ...input.app.serverId ? { serverId: input.app.serverId } : {},
+        ...input.commandName ? { command: input.commandName } : {},
+        label: input.app.label ?? input.app.name ?? input.app.appKey,
+        ...input.task.resource ? { resource: input.task.resource } : {}
+      },
+      data: {
+        ...input.task.data ?? {},
+        serverApp: {
+          ...serverAppData,
+          appKey: input.app.appKey,
+          ...input.commandName ? { command: input.commandName } : {}
+        }
+      }
+    }
+  };
+}
+function getShadowServerAppTaskCardId(message) {
+  const metadata = isProtocolRecord(message) ? message.metadata : null;
+  const cards = isProtocolRecord(metadata) && Array.isArray(metadata.cards) ? metadata.cards : [];
+  for (const item of cards) {
+    if (!isProtocolRecord(item)) continue;
+    if (item.kind === "task" && typeof item.id === "string" && item.id) return item.id;
+  }
+  return null;
+}
+function buildShadowServerAppInboxDelivery(input) {
+  const message = isProtocolRecord(input.message) ? input.message : {};
+  return {
+    ..."agentId" in input.target && input.target.agentId ? { agentId: input.target.agentId } : {},
+    channelId: optionalProtocolString(message.channelId),
+    messageId: optionalProtocolString(message.id),
+    cardId: getShadowServerAppTaskCardId(message),
+    idempotencyKey: input.idempotencyKey
+  };
+}
+function shadowFromPayload(payload) {
+  if (payload.protocol === SHADOW_SERVER_APP_PROTOCOL) {
+    return payload;
+  }
+  const shadow = isProtocolRecord(payload.shadow) ? payload.shadow : null;
+  if (shadow?.protocol === SHADOW_SERVER_APP_PROTOCOL) {
+    return shadow;
+  }
+  return null;
+}
+function mergeShadowResult(value, shadow) {
+  if (!shadow) return value;
+  const existing = shadowFromPayload(value);
+  if (!existing) return { ...value, shadow };
+  return {
+    ...value,
+    shadow: {
+      protocol: SHADOW_SERVER_APP_PROTOCOL,
+      outbox: {
+        ...existing.outbox ?? {},
+        ...shadow.outbox ?? {}
+      }
+    }
+  };
+}
+function getShadowServerAppInboxDeliveries(payload) {
+  if (!isProtocolRecord(payload)) return [];
+  const shadow = shadowFromPayload(payload);
+  return shadow?.outbox?.deliveries ?? [];
+}
+function getShadowServerAppInboxErrors(payload) {
+  if (!isProtocolRecord(payload)) return [];
+  const shadow = shadowFromPayload(payload);
+  return shadow?.outbox?.errors ?? [];
+}
+function getShadowServerAppChannelMessageDeliveries(payload) {
+  if (!isProtocolRecord(payload)) return [];
+  const shadow = shadowFromPayload(payload);
+  return shadow?.outbox?.channelMessageDeliveries ?? [];
+}
+function getShadowServerAppChannelMessageErrors(payload) {
+  if (!isProtocolRecord(payload)) return [];
+  const shadow = shadowFromPayload(payload);
+  return shadow?.outbox?.channelMessageErrors ?? [];
+}
+function unwrapShadowServerAppCommandPayload(payload) {
+  if (isProtocolRecord(payload) && payload.ok === false) {
+    throw new Error(typeof payload.error === "string" ? payload.error : "Command failed");
+  }
+  if (isProtocolRecord(payload) && "result" in payload && payload.result !== void 0) {
+    const nested = unwrapShadowServerAppCommandPayload(payload.result);
+    const shadow = shadowFromPayload(payload);
+    if (isProtocolRecord(nested)) return mergeShadowResult(nested, shadow);
+    return nested;
+  }
+  return payload;
+}
+
+// src/bridge.ts
+var ShadowBridge = class _ShadowBridge {
+  static commandRequestType = "shadow.app.command.request";
+  static commandResponseType = "shadow.app.command.response";
+  static inboxesRequestType = "shadow.app.inboxes.request";
+  static inboxesResponseType = "shadow.app.inboxes.response";
+  static enqueueInboxTaskRequestType = "shadow.app.inbox.enqueue.request";
+  static enqueueInboxTaskResponseType = "shadow.app.inbox.enqueue.response";
+  static openBuddyCreatorRequestType = "shadow.app.buddy.create.request";
+  static openBuddyCreatorResponseType = "shadow.app.buddy.create.response";
+  static inboxDeliveries(payload) {
+    return getShadowServerAppInboxDeliveries(payload);
+  }
+  static inboxErrors(payload) {
+    return getShadowServerAppInboxErrors(payload);
+  }
+  static channelMessageDeliveries(payload) {
+    return getShadowServerAppChannelMessageDeliveries(payload);
+  }
+  static channelMessageErrors(payload) {
+    return getShadowServerAppChannelMessageErrors(payload);
+  }
+  static unwrapCommandPayload(payload) {
+    return unwrapShadowServerAppCommandPayload(payload);
+  }
+  appKey;
+  targetOrigin;
+  timeoutMs;
+  win;
+  hasLaunchContext;
+  pending = /* @__PURE__ */ new Map();
+  onMessage = (event) => {
+    let data = event.data;
+    if (typeof data === "string") {
+      try {
+        data = JSON.parse(data || "{}");
+      } catch {
+        return;
+      }
+    }
+    if (!data || typeof data !== "object") return;
+    const record = data;
+    if (typeof record.requestId !== "string" || typeof record.type !== "string") return;
+    const entry = this.pending.get(record.requestId);
+    if (!entry || record.type !== entry.responseType) return;
+    this.pending.delete(record.requestId);
+    if (record.ok) entry.resolve(record.result);
+    else
+      entry.reject(
+        new Error(typeof record.error === "string" ? record.error : "Bridge request failed")
+      );
+  };
+  constructor(options) {
+    this.appKey = options.appKey;
+    this.targetOrigin = options.targetOrigin ?? "*";
+    this.timeoutMs = options.timeoutMs ?? 6e4;
+    this.win = options.windowRef ?? (typeof window === "undefined" ? null : window);
+    this.hasLaunchContext = this.resolveLaunchContext();
+    this.win?.addEventListener("message", this.onMessage);
+  }
+  dispose() {
+    this.win?.removeEventListener("message", this.onMessage);
+    for (const entry of this.pending.values()) {
+      entry.reject(new Error("ShadowBridge disposed"));
+    }
+    this.pending.clear();
+  }
+  isAvailable() {
+    if (!this.win) return false;
+    return this.hasLaunchContext && (this.win.parent !== this.win || !!this.win.ReactNativeWebView);
+  }
+  command(commandName, input, options = {}) {
+    return this.request(
+      _ShadowBridge.commandRequestType,
+      _ShadowBridge.commandResponseType,
+      {
+        commandName,
+        input,
+        ...options.channelId ? { channelId: options.channelId } : {},
+        ...options.task ? { task: options.task } : {}
+      },
+      options.timeoutMs
+    ).then(
+      (payload) => unwrapShadowServerAppCommandPayload(payload)
+    );
+  }
+  inboxes(options = {}) {
+    return this.request(
+      _ShadowBridge.inboxesRequestType,
+      _ShadowBridge.inboxesResponseType,
+      {},
+      options.timeoutMs ?? 15e3
+    );
+  }
+  enqueueInboxTask(input, options = {}) {
+    return this.request(
+      _ShadowBridge.enqueueInboxTaskRequestType,
+      _ShadowBridge.enqueueInboxTaskResponseType,
+      input,
+      options.timeoutMs
+    );
+  }
+  openBuddyCreator(input = {}, options = {}) {
+    return this.request(
+      _ShadowBridge.openBuddyCreatorRequestType,
+      _ShadowBridge.openBuddyCreatorResponseType,
+      input,
+      options.timeoutMs ?? 10 * 60 * 1e3
+    );
+  }
+  unwrapCommandPayload(payload) {
+    return unwrapShadowServerAppCommandPayload(payload);
+  }
+  inboxDeliveries(payload) {
+    return getShadowServerAppInboxDeliveries(payload);
+  }
+  inboxErrors(payload) {
+    return getShadowServerAppInboxErrors(payload);
+  }
+  channelMessageDeliveries(payload) {
+    return getShadowServerAppChannelMessageDeliveries(payload);
+  }
+  channelMessageErrors(payload) {
+    return getShadowServerAppChannelMessageErrors(payload);
+  }
+  request(requestType, responseType, payload, timeoutMs = this.timeoutMs) {
+    if (!this.isAvailable()) {
+      return Promise.reject(
+        new Error("ShadowBridge is not available outside a Shadow launch frame")
+      );
+    }
+    const requestId = `req_${Math.random().toString(36).slice(2)}`;
+    this.postMessage({
+      type: requestType,
+      requestId,
+      appKey: this.appKey,
+      ...payload
+    });
+    return new Promise((resolve, reject) => {
+      this.pending.set(requestId, {
+        responseType,
+        resolve,
+        reject
+      });
+      this.win?.setTimeout(() => {
+        if (!this.pending.has(requestId)) return;
+        this.pending.delete(requestId);
+        reject(new Error("Bridge request timed out"));
+      }, timeoutMs);
+    });
+  }
+  postMessage(message) {
+    if (!this.win) return;
+    if (this.win.ReactNativeWebView) {
+      this.win.ReactNativeWebView.postMessage(JSON.stringify(message));
+      return;
+    }
+    this.win.parent.postMessage(message, this.targetOrigin);
+  }
+  resolveLaunchContext() {
+    if (!this.win) return false;
+    const storageKey = `shadow.bridge.launch:${this.appKey}`;
+    const memoryContexts = this.win.__shadowBridgeLaunchContexts ??= {};
+    const hasLaunchToken = new URLSearchParams(this.win.location.search).has("shadow_launch");
+    if (hasLaunchToken) {
+      memoryContexts[this.appKey] = true;
+      try {
+        this.win.sessionStorage?.setItem(storageKey, "1");
+      } catch {
+      }
+      return true;
+    }
+    if (memoryContexts[this.appKey]) return true;
+    try {
+      return this.win.sessionStorage?.getItem(storageKey) === "1";
+    } catch {
+      return false;
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SHADOW_SERVER_APP_COMMAND_COMPLETED_EVENT,
+  SHADOW_SERVER_APP_COMMAND_EVENTS,
+  SHADOW_SERVER_APP_COMMAND_FAILED_EVENT,
+  ShadowBridge,
+  buildShadowServerAppInboxDelivery,
+  buildShadowServerAppInboxTaskRequest,
+  getShadowServerAppChannelMessageDeliveries,
+  getShadowServerAppChannelMessageErrors,
+  getShadowServerAppTaskCardId,
+  shadowServerAppInboxTaskEndpoint
+});

package/dist/bridge.d.cts

@@ -0,0 +1,105 @@
+import { c9 as ShadowServerAppInboxDelivery, ca as ShadowServerAppInboxDeliveryError, bK as ShadowServerAppChannelMessageDelivery, bL as ShadowServerAppChannelMessageDeliveryError, cc as ShadowServerAppInboxTarget, cd as ShadowServerAppInboxTaskOutbox } from './server-app-qqsBtGmE.cjs';
+export { b7 as SHADOW_SERVER_APP_COMMAND_COMPLETED_EVENT, b8 as SHADOW_SERVER_APP_COMMAND_EVENTS, b9 as SHADOW_SERVER_APP_COMMAND_FAILED_EVENT, bM as ShadowServerAppChannelMessageOutbox, bS as ShadowServerAppCommandEventType, c7 as ShadowServerAppHostAppRef, c8 as ShadowServerAppHostInboxTaskRequestInput, cb as ShadowServerAppInboxDeliveryFromMessageInput, cl as ShadowServerAppResolvedInboxTaskRequest, cm as ShadowServerAppResultShadow, cx as buildShadowServerAppInboxDelivery, cy as buildShadowServerAppInboxTaskRequest, cC as getShadowServerAppChannelMessageDeliveries, cD as getShadowServerAppChannelMessageErrors, cE as getShadowServerAppTaskCardId, cM as shadowServerAppInboxTaskEndpoint } from './server-app-qqsBtGmE.cjs';
+import '@shadowob/shared';
+
+type ShadowBridgeCommandSpec<TInput = unknown, TResult = unknown> = {
+    input: TInput;
+    result: TResult;
+};
+type ShadowBridgeCommandMap = Record<string, ShadowBridgeCommandSpec>;
+type BridgeCommandInput<TCommand> = TCommand extends ShadowBridgeCommandSpec<infer TInput, unknown> ? TInput : unknown;
+type BridgeCommandResult<TCommand> = TCommand extends ShadowBridgeCommandSpec<unknown, infer TResult> ? TResult : unknown;
+interface ShadowBridgeBuddyInbox {
+    agent: {
+        id: string;
+        ownerId?: string | null;
+        status?: string | null;
+        user?: {
+            id?: string | null;
+            username?: string | null;
+            displayName?: string | null;
+            avatarUrl?: string | null;
+            isBot?: boolean | null;
+        } | null;
+    };
+    channel?: {
+        id?: string | null;
+        name?: string | null;
+    } | null;
+    canManage?: boolean;
+}
+interface ShadowBridgeEnqueueInboxTaskInput {
+    target: ShadowServerAppInboxTarget;
+    task: ShadowServerAppInboxTaskOutbox;
+}
+interface ShadowBridgeOpenBuddyCreatorInput {
+    landing?: {
+        title?: string;
+        description?: string;
+        source?: string;
+    };
+}
+interface ShadowBridgeOptions {
+    appKey: string;
+    targetOrigin?: string;
+    timeoutMs?: number;
+    windowRef?: Window;
+}
+declare class ShadowBridge<TCommands extends ShadowBridgeCommandMap = ShadowBridgeCommandMap> {
+    static readonly commandRequestType = "shadow.app.command.request";
+    static readonly commandResponseType = "shadow.app.command.response";
+    static readonly inboxesRequestType = "shadow.app.inboxes.request";
+    static readonly inboxesResponseType = "shadow.app.inboxes.response";
+    static readonly enqueueInboxTaskRequestType = "shadow.app.inbox.enqueue.request";
+    static readonly enqueueInboxTaskResponseType = "shadow.app.inbox.enqueue.response";
+    static readonly openBuddyCreatorRequestType = "shadow.app.buddy.create.request";
+    static readonly openBuddyCreatorResponseType = "shadow.app.buddy.create.response";
+    static inboxDeliveries(payload: unknown): ShadowServerAppInboxDelivery[];
+    static inboxErrors(payload: unknown): ShadowServerAppInboxDeliveryError[];
+    static channelMessageDeliveries(payload: unknown): ShadowServerAppChannelMessageDelivery[];
+    static channelMessageErrors(payload: unknown): ShadowServerAppChannelMessageDeliveryError[];
+    static unwrapCommandPayload<TResult = unknown>(payload: unknown): TResult;
+    private readonly appKey;
+    private readonly targetOrigin;
+    private readonly timeoutMs;
+    private readonly win;
+    private readonly hasLaunchContext;
+    private readonly pending;
+    private readonly onMessage;
+    constructor(options: ShadowBridgeOptions);
+    dispose(): void;
+    isAvailable(): boolean;
+    command<TCommandName extends Extract<keyof TCommands, string>>(commandName: TCommandName, input: BridgeCommandInput<TCommands[TCommandName]>, options?: {
+        channelId?: string;
+        timeoutMs?: number;
+        task?: {
+            messageId: string;
+            cardId: string;
+            claimId?: string;
+        };
+    }): Promise<BridgeCommandResult<TCommands[TCommandName]>>;
+    inboxes(options?: {
+        timeoutMs?: number;
+    }): Promise<{
+        inboxes: ShadowBridgeBuddyInbox[];
+    }>;
+    enqueueInboxTask(input: ShadowBridgeEnqueueInboxTaskInput, options?: {
+        timeoutMs?: number;
+    }): Promise<ShadowServerAppInboxDelivery>;
+    openBuddyCreator(input?: ShadowBridgeOpenBuddyCreatorInput, options?: {
+        timeoutMs?: number;
+    }): Promise<{
+        opened: boolean;
+        agent?: unknown;
+    }>;
+    unwrapCommandPayload<TResult = unknown>(payload: unknown): TResult;
+    inboxDeliveries(payload: unknown): ShadowServerAppInboxDelivery[];
+    inboxErrors(payload: unknown): ShadowServerAppInboxDeliveryError[];
+    channelMessageDeliveries(payload: unknown): ShadowServerAppChannelMessageDelivery[];
+    channelMessageErrors(payload: unknown): ShadowServerAppChannelMessageDeliveryError[];
+    private request;
+    private postMessage;
+    private resolveLaunchContext;
+}
+
+export { ShadowBridge, type ShadowBridgeBuddyInbox, type ShadowBridgeCommandMap, type ShadowBridgeCommandSpec, type ShadowBridgeEnqueueInboxTaskInput, type ShadowBridgeOpenBuddyCreatorInput, type ShadowBridgeOptions, ShadowServerAppChannelMessageDelivery, ShadowServerAppChannelMessageDeliveryError, ShadowServerAppInboxDelivery, ShadowServerAppInboxDeliveryError, ShadowServerAppInboxTarget, ShadowServerAppInboxTaskOutbox };

package/dist/bridge.d.ts

@@ -0,0 +1,105 @@
+import { c9 as ShadowServerAppInboxDelivery, ca as ShadowServerAppInboxDeliveryError, bK as ShadowServerAppChannelMessageDelivery, bL as ShadowServerAppChannelMessageDeliveryError, cc as ShadowServerAppInboxTarget, cd as ShadowServerAppInboxTaskOutbox } from './server-app-qqsBtGmE.js';
+export { b7 as SHADOW_SERVER_APP_COMMAND_COMPLETED_EVENT, b8 as SHADOW_SERVER_APP_COMMAND_EVENTS, b9 as SHADOW_SERVER_APP_COMMAND_FAILED_EVENT, bM as ShadowServerAppChannelMessageOutbox, bS as ShadowServerAppCommandEventType, c7 as ShadowServerAppHostAppRef, c8 as ShadowServerAppHostInboxTaskRequestInput, cb as ShadowServerAppInboxDeliveryFromMessageInput, cl as ShadowServerAppResolvedInboxTaskRequest, cm as ShadowServerAppResultShadow, cx as buildShadowServerAppInboxDelivery, cy as buildShadowServerAppInboxTaskRequest, cC as getShadowServerAppChannelMessageDeliveries, cD as getShadowServerAppChannelMessageErrors, cE as getShadowServerAppTaskCardId, cM as shadowServerAppInboxTaskEndpoint } from './server-app-qqsBtGmE.js';
+import '@shadowob/shared';
+
+type ShadowBridgeCommandSpec<TInput = unknown, TResult = unknown> = {
+    input: TInput;
+    result: TResult;
+};
+type ShadowBridgeCommandMap = Record<string, ShadowBridgeCommandSpec>;
+type BridgeCommandInput<TCommand> = TCommand extends ShadowBridgeCommandSpec<infer TInput, unknown> ? TInput : unknown;
+type BridgeCommandResult<TCommand> = TCommand extends ShadowBridgeCommandSpec<unknown, infer TResult> ? TResult : unknown;
+interface ShadowBridgeBuddyInbox {
+    agent: {
+        id: string;
+        ownerId?: string | null;
+        status?: string | null;
+        user?: {
+            id?: string | null;
+            username?: string | null;
+            displayName?: string | null;
+            avatarUrl?: string | null;
+            isBot?: boolean | null;
+        } | null;
+    };
+    channel?: {
+        id?: string | null;
+        name?: string | null;
+    } | null;
+    canManage?: boolean;
+}
+interface ShadowBridgeEnqueueInboxTaskInput {
+    target: ShadowServerAppInboxTarget;
+    task: ShadowServerAppInboxTaskOutbox;
+}
+interface ShadowBridgeOpenBuddyCreatorInput {
+    landing?: {
+        title?: string;
+        description?: string;
+        source?: string;
+    };
+}
+interface ShadowBridgeOptions {
+    appKey: string;
+    targetOrigin?: string;
+    timeoutMs?: number;
+    windowRef?: Window;
+}
+declare class ShadowBridge<TCommands extends ShadowBridgeCommandMap = ShadowBridgeCommandMap> {
+    static readonly commandRequestType = "shadow.app.command.request";
+    static readonly commandResponseType = "shadow.app.command.response";
+    static readonly inboxesRequestType = "shadow.app.inboxes.request";
+    static readonly inboxesResponseType = "shadow.app.inboxes.response";
+    static readonly enqueueInboxTaskRequestType = "shadow.app.inbox.enqueue.request";
+    static readonly enqueueInboxTaskResponseType = "shadow.app.inbox.enqueue.response";
+    static readonly openBuddyCreatorRequestType = "shadow.app.buddy.create.request";
+    static readonly openBuddyCreatorResponseType = "shadow.app.buddy.create.response";
+    static inboxDeliveries(payload: unknown): ShadowServerAppInboxDelivery[];
+    static inboxErrors(payload: unknown): ShadowServerAppInboxDeliveryError[];
+    static channelMessageDeliveries(payload: unknown): ShadowServerAppChannelMessageDelivery[];
+    static channelMessageErrors(payload: unknown): ShadowServerAppChannelMessageDeliveryError[];
+    static unwrapCommandPayload<TResult = unknown>(payload: unknown): TResult;
+    private readonly appKey;
+    private readonly targetOrigin;
+    private readonly timeoutMs;
+    private readonly win;
+    private readonly hasLaunchContext;
+    private readonly pending;
+    private readonly onMessage;
+    constructor(options: ShadowBridgeOptions);
+    dispose(): void;
+    isAvailable(): boolean;
+    command<TCommandName extends Extract<keyof TCommands, string>>(commandName: TCommandName, input: BridgeCommandInput<TCommands[TCommandName]>, options?: {
+        channelId?: string;
+        timeoutMs?: number;
+        task?: {
+            messageId: string;
+            cardId: string;
+            claimId?: string;
+        };
+    }): Promise<BridgeCommandResult<TCommands[TCommandName]>>;
+    inboxes(options?: {
+        timeoutMs?: number;
+    }): Promise<{
+        inboxes: ShadowBridgeBuddyInbox[];
+    }>;
+    enqueueInboxTask(input: ShadowBridgeEnqueueInboxTaskInput, options?: {
+        timeoutMs?: number;
+    }): Promise<ShadowServerAppInboxDelivery>;
+    openBuddyCreator(input?: ShadowBridgeOpenBuddyCreatorInput, options?: {
+        timeoutMs?: number;
+    }): Promise<{
+        opened: boolean;
+        agent?: unknown;
+    }>;
+    unwrapCommandPayload<TResult = unknown>(payload: unknown): TResult;
+    inboxDeliveries(payload: unknown): ShadowServerAppInboxDelivery[];
+    inboxErrors(payload: unknown): ShadowServerAppInboxDeliveryError[];
+    channelMessageDeliveries(payload: unknown): ShadowServerAppChannelMessageDelivery[];
+    channelMessageErrors(payload: unknown): ShadowServerAppChannelMessageDeliveryError[];
+    private request;
+    private postMessage;
+    private resolveLaunchContext;
+}
+
+export { ShadowBridge, type ShadowBridgeBuddyInbox, type ShadowBridgeCommandMap, type ShadowBridgeCommandSpec, type ShadowBridgeEnqueueInboxTaskInput, type ShadowBridgeOpenBuddyCreatorInput, type ShadowBridgeOptions, ShadowServerAppChannelMessageDelivery, ShadowServerAppChannelMessageDeliveryError, ShadowServerAppInboxDelivery, ShadowServerAppInboxDeliveryError, ShadowServerAppInboxTarget, ShadowServerAppInboxTaskOutbox };

package/dist/bridge.js

@@ -0,0 +1,26 @@
+import {
+  ShadowBridge
+} from "./chunk-5QQ7ZR6B.js";
+import {
+  SHADOW_SERVER_APP_COMMAND_COMPLETED_EVENT,
+  SHADOW_SERVER_APP_COMMAND_EVENTS,
+  SHADOW_SERVER_APP_COMMAND_FAILED_EVENT,
+  buildShadowServerAppInboxDelivery,
+  buildShadowServerAppInboxTaskRequest,
+  getShadowServerAppChannelMessageDeliveries,
+  getShadowServerAppChannelMessageErrors,
+  getShadowServerAppTaskCardId,
+  shadowServerAppInboxTaskEndpoint
+} from "./chunk-OMTGSMTQ.js";
+export {
+  SHADOW_SERVER_APP_COMMAND_COMPLETED_EVENT,
+  SHADOW_SERVER_APP_COMMAND_EVENTS,
+  SHADOW_SERVER_APP_COMMAND_FAILED_EVENT,
+  ShadowBridge,
+  buildShadowServerAppInboxDelivery,
+  buildShadowServerAppInboxTaskRequest,
+  getShadowServerAppChannelMessageDeliveries,
+  getShadowServerAppChannelMessageErrors,
+  getShadowServerAppTaskCardId,
+  shadowServerAppInboxTaskEndpoint
+};