@shadowob/sdk 1.1.7 → 1.1.9

package/dist/chunk-OMTGSMTQ.js

@@ -0,0 +1,525 @@
+// 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;
+}
+var ShadowServerAppOutbox = class {
+  inboxTasks = [];
+  channelMessages = [];
+  enqueueInboxTask(task) {
+    this.inboxTasks.push(task);
+    return this;
+  }
+  enqueueInboxTasks(tasks) {
+    for (const task of tasks) this.enqueueInboxTask(task);
+    return this;
+  }
+  sendChannelMessage(message) {
+    this.channelMessages.push(message);
+    return this;
+  }
+  sendChannelMessages(messages) {
+    for (const message of messages) this.sendChannelMessage(message);
+    return this;
+  }
+  toShadow() {
+    return {
+      protocol: SHADOW_SERVER_APP_PROTOCOL,
+      outbox: {
+        ...this.inboxTasks.length > 0 ? { inboxTasks: [...this.inboxTasks] } : {},
+        ...this.channelMessages.length > 0 ? { channelMessages: [...this.channelMessages] } : {}
+      }
+    };
+  }
+  attachTo(result) {
+    return { ...result, shadow: this.toShadow() };
+  }
+};
+function trimTrailingSlash(value) {
+  return value.replace(/\/$/, "");
+}
+function joinBasePath(baseUrl, path) {
+  const cleanBase = trimTrailingSlash(baseUrl);
+  const cleanPath = path.startsWith("/") ? path : `/${path}`;
+  return `${cleanBase}${cleanPath}`;
+}
+function extractShadowServerAppBearerToken(value) {
+  if (!value) return null;
+  return value.toLowerCase().startsWith("bearer ") ? value.slice(7).trim() : null;
+}
+function normalizeShadowServerAppCommandInput(value) {
+  if (value && typeof value === "object" && !Array.isArray(value) && "input" in value && Object.keys(value).every((key) => key === "input" || key === "channelId")) {
+    return value.input ?? {};
+  }
+  return value;
+}
+function createShadowServerAppManifest(manifest, options = {}) {
+  const publicBaseUrl = trimTrailingSlash(
+    options.publicBaseUrl ?? `http://localhost:${options.port ?? 4201}`
+  );
+  const apiBaseUrl = trimTrailingSlash(options.apiBaseUrl ?? publicBaseUrl);
+  const iframePath = options.iframePath ?? "/shadow/server";
+  const iconPath = options.iconPath ?? "/assets/icon.svg";
+  return {
+    ...manifest,
+    iconUrl: joinBasePath(publicBaseUrl, iconPath),
+    iframe: manifest.iframe ? {
+      ...manifest.iframe,
+      entry: joinBasePath(publicBaseUrl, iframePath),
+      allowedOrigins: options.allowedOrigins ?? [publicBaseUrl]
+    } : manifest.iframe,
+    api: {
+      ...manifest.api,
+      baseUrl: apiBaseUrl
+    }
+  };
+}
+function defineShadowServerApp(manifest, options = {}) {
+  return new ShadowServerAppRuntime(manifest, options);
+}
+var ShadowServerAppCommandError = class extends Error {
+  status;
+  issues;
+  constructor(status, error, issues) {
+    super(error);
+    this.name = "ShadowServerAppCommandError";
+    this.status = status;
+    this.issues = issues;
+  }
+};
+function shadowServerAppError(status, error, issues) {
+  return new ShadowServerAppCommandError(status, error, issues);
+}
+var ShadowServerAppRuntime = class {
+  constructor(sourceManifest, options = {}) {
+    this.sourceManifest = sourceManifest;
+    this.options = options;
+  }
+  manifest(options = {}) {
+    return createShadowServerAppManifest(this.sourceManifest, options);
+  }
+  defineCommands(handlers) {
+    return handlers;
+  }
+  actor(envelopeOrContext) {
+    return shadowServerAppActorRef(envelopeOrContext);
+  }
+  error(status, error, issues) {
+    return shadowServerAppError(status, error, issues);
+  }
+  async parseCommand(commandName, request) {
+    return parseShadowServerAppCommandRequest(
+      {
+        ...request,
+        expectedCommand: commandName,
+        shadowBaseUrl: this.options.shadowBaseUrl,
+        fetchImpl: this.options.fetchImpl
+      }
+    );
+  }
+  async executeCommand(commandName, request, handlers) {
+    const parsed = await this.parseCommand(commandName, request);
+    if (!parsed.ok) return parseErrorResult(parsed);
+    return this.executeEnvelope(commandName, parsed.envelope, handlers);
+  }
+  async executeLocal(commandName, input, context, handlers) {
+    return this.executeEnvelope(
+      commandName,
+      {
+        input,
+        context: {
+          ...context,
+          command: commandName
+        }
+      },
+      handlers
+    );
+  }
+  async executeEnvelope(commandName, envelope, handlers) {
+    const command = this.sourceManifest.commands.find((item) => item.name === commandName);
+    if (!command) return failureResult(404, "command_not_found");
+    const validation = validateShadowServerAppJsonSchema(command.inputSchema, envelope.input);
+    if (!validation.ok) return failureResult(422, "invalid_input", validation.issues);
+    const handler = handlers[commandName];
+    if (!handler) return failureResult(404, "command_not_found");
+    try {
+      const result = await handler(envelope.input, {
+        context: envelope.context,
+        actor: this.actor(envelope)
+      });
+      return { ok: true, status: 200, body: { ok: true, result } };
+    } catch (error) {
+      if (error instanceof ShadowServerAppCommandError) {
+        return failureResult(error.status, error.message, error.issues);
+      }
+      throw error;
+    }
+  }
+};
+async function introspectShadowServerAppToken(input) {
+  const baseUrl = trimTrailingSlash(input.shadowBaseUrl ?? "http://localhost:3002");
+  const fetchImpl = input.fetchImpl ?? fetch;
+  const response = await fetchImpl(
+    `${baseUrl}/api/servers/${encodeURIComponent(input.serverId)}/apps/${encodeURIComponent(
+      input.appKey
+    )}/oauth/introspect`,
+    {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${input.token}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ token: input.token })
+    }
+  );
+  if (!response.ok) return null;
+  const payload = await response.json();
+  return payload.active ? payload : null;
+}
+async function parseShadowServerAppCommandRequest(input) {
+  const token = extractShadowServerAppBearerToken(input.authorizationHeader);
+  const serverId = input.serverIdHeader;
+  const appKey = input.appKeyHeader;
+  if (!token || !serverId || !appKey) {
+    return { ok: false, status: 401, error: "missing_oauth" };
+  }
+  const introspection = await introspectShadowServerAppToken({
+    token,
+    serverId,
+    appKey,
+    shadowBaseUrl: input.shadowBaseUrl,
+    fetchImpl: input.fetchImpl
+  }).catch(() => null);
+  const context = introspection?.shadow;
+  if (!context) return { ok: false, status: 401, error: "invalid_token" };
+  if (context.command !== input.expectedCommand) {
+    return { ok: false, status: 403, error: "wrong_command" };
+  }
+  let commandInput;
+  if (input.requestInput !== void 0) {
+    commandInput = input.requestInput;
+  } else {
+    let body;
+    try {
+      body = JSON.parse(input.requestBody ?? "{}");
+    } catch {
+      return { ok: false, status: 400, error: "invalid_json" };
+    }
+    commandInput = body.input ?? {};
+  }
+  return {
+    ok: true,
+    envelope: {
+      input: commandInput,
+      context
+    }
+  };
+}
+function validateShadowServerAppJsonSchema(schema, value) {
+  if (!schema) return { ok: true };
+  const issues = [];
+  validateJsonSchemaValue(schema, value, "", issues);
+  return issues.length ? { ok: false, issues } : { ok: true };
+}
+function shadowServerAppActorDisplayName(envelopeOrContext) {
+  const context = "context" in envelopeOrContext ? envelopeOrContext.context : envelopeOrContext;
+  const actor = context.actor;
+  const profile = actor.profile;
+  return profile?.displayName?.trim() || profile?.username?.trim() || (actor.buddyAgentId ? `Buddy ${actor.buddyAgentId.slice(0, 8)}` : null) || (actor.userId ? `${actor.kind}:${actor.userId.slice(0, 8)}` : null) || `${actor.kind}:unknown`;
+}
+function shadowServerAppActorAvatarUrl(envelopeOrContext) {
+  const context = "context" in envelopeOrContext ? envelopeOrContext.context : envelopeOrContext;
+  return context.actor.profile?.avatarUrl ?? null;
+}
+function shadowServerAppActorRef(envelopeOrContext) {
+  const context = "context" in envelopeOrContext ? envelopeOrContext.context : envelopeOrContext;
+  const actor = context.actor;
+  return {
+    kind: actor.kind,
+    id: actor.buddyAgentId ?? actor.userId ?? actor.ownerId ?? "unknown",
+    userId: actor.userId ?? null,
+    buddyAgentId: actor.buddyAgentId ?? null,
+    ownerId: actor.ownerId ?? null,
+    displayName: shadowServerAppActorDisplayName(context),
+    avatarUrl: shadowServerAppActorAvatarUrl(context)
+  };
+}
+function parseErrorResult(error) {
+  return failureResult(error.status, error.error, error.issues);
+}
+function failureResult(status, error, issues) {
+  return {
+    ok: false,
+    status,
+    body: issues === void 0 ? { ok: false, error } : { ok: false, error, issues }
+  };
+}
+function validateJsonSchemaValue(schema, value, path, issues) {
+  if (Array.isArray(schema.oneOf)) {
+    const matches = schema.oneOf.some((option) => {
+      const nestedIssues = [];
+      if (option && typeof option === "object" && !Array.isArray(option)) {
+        validateJsonSchemaValue(
+          option,
+          value,
+          path,
+          nestedIssues
+        );
+      }
+      return nestedIssues.length === 0;
+    });
+    if (!matches) issues.push({ path, message: "Expected value matching one schema option" });
+    return;
+  }
+  const enumValues = schema.enum;
+  if (Array.isArray(enumValues) && !enumValues.includes(value)) {
+    issues.push({ path, message: `Expected one of ${enumValues.map(String).join(", ")}` });
+    return;
+  }
+  const type = schema.type;
+  if (type === "object") {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+      issues.push({ path, message: "Expected object" });
+      return;
+    }
+    const record = value;
+    const properties = schema.properties && typeof schema.properties === "object" && !Array.isArray(schema.properties) ? schema.properties : {};
+    const required = Array.isArray(schema.required) ? schema.required.map(String) : [];
+    for (const key of required) {
+      if (!(key in record)) issues.push({ path: joinJsonPath(path, key), message: "Required" });
+    }
+    for (const [key, propertySchema] of Object.entries(properties)) {
+      if (record[key] !== void 0) {
+        validateJsonSchemaValue(propertySchema, record[key], joinJsonPath(path, key), issues);
+      }
+    }
+    const additionalProperties = schema.additionalProperties && typeof schema.additionalProperties === "object" && !Array.isArray(schema.additionalProperties) ? schema.additionalProperties : null;
+    if (additionalProperties) {
+      for (const [key, nestedValue] of Object.entries(record)) {
+        if (!(key in properties)) {
+          validateJsonSchemaValue(
+            additionalProperties,
+            nestedValue,
+            joinJsonPath(path, key),
+            issues
+          );
+        }
+      }
+    } else if (schema.additionalProperties === false) {
+      for (const key of Object.keys(record)) {
+        if (!(key in properties)) {
+          issues.push({ path: joinJsonPath(path, key), message: "Unknown property" });
+        }
+      }
+    }
+    return;
+  }
+  if (type === "array") {
+    if (!Array.isArray(value)) {
+      issues.push({ path, message: "Expected array" });
+      return;
+    }
+    const maxItems = typeof schema.maxItems === "number" ? schema.maxItems : null;
+    if (maxItems !== null && value.length > maxItems) {
+      issues.push({ path, message: `Expected at most ${maxItems} items` });
+    }
+    const itemSchema = schema.items && typeof schema.items === "object" && !Array.isArray(schema.items) ? schema.items : null;
+    if (itemSchema) {
+      value.forEach(
+        (item, index) => validateJsonSchemaValue(itemSchema, item, `${path}[${index}]`, issues)
+      );
+    }
+    return;
+  }
+  if (type === "string") {
+    if (typeof value !== "string") {
+      issues.push({ path, message: "Expected string" });
+      return;
+    }
+    const maxLength = typeof schema.maxLength === "number" ? schema.maxLength : null;
+    const minLength = typeof schema.minLength === "number" ? schema.minLength : null;
+    if (minLength !== null && value.length < minLength) {
+      issues.push({ path, message: `Expected at least ${minLength} characters` });
+    }
+    if (maxLength !== null && value.length > maxLength) {
+      issues.push({ path, message: `Expected at most ${maxLength} characters` });
+    }
+    return;
+  }
+  if (type === "number" || type === "integer") {
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+      issues.push({ path, message: "Expected number" });
+      return;
+    }
+    if (type === "integer" && !Number.isInteger(value)) {
+      issues.push({ path, message: "Expected integer" });
+    }
+    return;
+  }
+  if (type === "boolean" && typeof value !== "boolean") {
+    issues.push({ path, message: "Expected boolean" });
+  }
+}
+function joinJsonPath(parent, key) {
+  return parent ? `${parent}.${key}` : key;
+}
+
+export {
+  SHADOW_SERVER_APP_PROTOCOL,
+  SHADOW_SERVER_APP_COMMAND_COMPLETED_EVENT,
+  SHADOW_SERVER_APP_COMMAND_FAILED_EVENT,
+  SHADOW_SERVER_APP_COMMAND_EVENTS,
+  shadowServerAppInboxTaskEndpoint,
+  buildShadowServerAppInboxTaskRequest,
+  getShadowServerAppTaskCardId,
+  buildShadowServerAppInboxDelivery,
+  getShadowServerAppInboxDeliveries,
+  getShadowServerAppInboxErrors,
+  getShadowServerAppChannelMessageDeliveries,
+  getShadowServerAppChannelMessageErrors,
+  unwrapShadowServerAppCommandPayload,
+  ShadowServerAppOutbox,
+  extractShadowServerAppBearerToken,
+  normalizeShadowServerAppCommandInput,
+  createShadowServerAppManifest,
+  defineShadowServerApp,
+  ShadowServerAppCommandError,
+  shadowServerAppError,
+  ShadowServerAppRuntime,
+  introspectShadowServerAppToken,
+  parseShadowServerAppCommandRequest,
+  validateShadowServerAppJsonSchema,
+  shadowServerAppActorDisplayName,
+  shadowServerAppActorAvatarUrl,
+  shadowServerAppActorRef
+};