agents 0.22.0 → 0.23.0

package/dist/channels/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/channels/fallback.ts","../../src/channels/fanout.ts","../../src/channels/host/index.ts","../../src/channels/identity.ts","../../src/channels/routes.ts"],"sourcesContent":["import type {\n  Channel,\n  ChannelApprovalRequestOptions,\n  ChannelChunk,\n  ChannelDeliveryOptions,\n  ChannelMessage,\n  ChannelStreamOptions,\n  DeliveryResult,\n  OutboundResolver\n} from \"./channel\";\nimport { compositeDestinations, unsupported } from \"./internal\";\nimport type { ChannelMessageSurface } from \"./surface\";\n\nexport type FallbackSurface = ChannelMessageSurface<\n  \"fallback\",\n  { surfaces: readonly ChannelMessageSurface[] }\n>;\n\n/** A non-empty sequence of destinations ordered from preferred to final. */\nexport type FallbackSurfaceOptions = readonly [\n  ChannelMessageSurface,\n  ...ChannelMessageSurface[]\n];\n\ntype FallbackOperation = (\n  surface: ChannelMessageSurface\n) => Promise<DeliveryResult>;\n\n/**\n * Build an inert fallback destination for a `ChannelHost` to resolve.\n *\n * The Host skips unavailable destinations, advances after confirmed failures,\n * and stops after a delivered or uncertain result to avoid duplicates.\n */\nexport function fallback(surfaces: FallbackSurfaceOptions): FallbackSurface {\n  return {\n    channelKey: \"fallback\",\n    version: 1,\n    address: { surfaces },\n    label: surfaces.map((surface) => surface.label).join(\", then \")\n  };\n}\n\n/**\n * Advance only when a failed destination has not started reading the answer.\n *\n * Replaying an arbitrarily large consumed prefix requires an arbitrarily large\n * buffer. Instead, each attempt gets a cancellation-shielded view of the same\n * source. Once an attempt asks for its first chunk, its result is terminal and\n * the source is never handed to another destination.\n */\nasync function streamWithFallbackBeforeRead(\n  resolve: OutboundResolver,\n  destinations: readonly ChannelMessageSurface[],\n  chunks: ReadableStream<ChannelChunk>,\n  options: ChannelStreamOptions\n): Promise<DeliveryResult> {\n  const reader = chunks.getReader();\n  let drained = false;\n\n  function attempt(): {\n    chunks: ReadableStream<ChannelChunk>;\n    startedReading: () => boolean;\n  } {\n    let startedReading = false;\n    return {\n      chunks: new ReadableStream<ChannelChunk>(\n        {\n          async pull(controller) {\n            startedReading = true;\n            const result = await reader.read();\n            if (result.done) {\n              drained = true;\n              controller.close();\n              return;\n            }\n            controller.enqueue(result.value);\n          },\n          // A destination may cancel after an opening failure. Shield the\n          // untouched source so the next destination can still try it.\n          cancel() {}\n        },\n        // Do not prefetch: creating an attempt must not consume the source.\n        { highWaterMark: 0 }\n      ),\n      startedReading: () => startedReading\n    };\n  }\n\n  try {\n    for (let index = 0; index < destinations.length - 1; index += 1) {\n      const destination = destinations[index]!;\n      if (!(await resolve.isAvailable(destination))) continue;\n\n      const current = attempt();\n      const result = await resolve.stream(destination, current.chunks, options);\n      if (result.status !== \"failed\" || current.startedReading()) return result;\n    }\n    const final = attempt();\n    // `return await` so the shared reader is released only after the final\n    // destination has finished consuming it.\n    return await resolve.stream(destinations.at(-1)!, final.chunks, options);\n  } finally {\n    if (!drained) await reader.cancel().catch(() => {});\n    reader.releaseLock();\n  }\n}\n\n/** Build the ordinary Channel installed under the reserved fallback key. */\nexport function fallbackChannel(resolve: OutboundResolver): Channel {\n  async function run(\n    surface: ChannelMessageSurface,\n    operation: FallbackOperation\n  ): Promise<DeliveryResult> {\n    const destinations = compositeDestinations(surface);\n    if (!destinations) {\n      return unsupported(\n        \"FALLBACK_SURFACE_INVALID\",\n        \"Fallback surface must contain at least one valid destination\"\n      );\n    }\n\n    for (let index = 0; index < destinations.length - 1; index += 1) {\n      const destination = destinations[index]!;\n      if (await resolve.isAvailable(destination)) {\n        const result = await operation(destination);\n        if (result.status !== \"failed\") return result;\n      }\n    }\n    // try the last one if we haven't returned yet\n    return operation(destinations.at(-1)!);\n  }\n\n  return {\n    deliver(\n      surface: ChannelMessageSurface,\n      message: ChannelMessage,\n      options?: ChannelDeliveryOptions\n    ) {\n      return run(surface, (destination) =>\n        resolve.deliver(destination, message, options)\n      );\n    },\n\n    async stream(\n      surface: ChannelMessageSurface,\n      chunks: ReadableStream<ChannelChunk>,\n      options: ChannelStreamOptions\n    ) {\n      const destinations = compositeDestinations(surface);\n      if (!destinations) {\n        await chunks.cancel().catch(() => {});\n        return unsupported(\n          \"FALLBACK_SURFACE_INVALID\",\n          \"Fallback surface must contain at least one valid destination\"\n        );\n      }\n      return streamWithFallbackBeforeRead(\n        resolve,\n        destinations,\n        chunks,\n        options\n      );\n    },\n\n    requestApproval(\n      surface: ChannelMessageSurface,\n      options: ChannelApprovalRequestOptions\n    ) {\n      return run(surface, (destination) =>\n        resolve.requestApproval(destination, options)\n      );\n    },\n\n    async isAvailable(surface) {\n      const destinations = compositeDestinations(surface);\n      if (!destinations) return true;\n      for (const destination of destinations) {\n        if (await resolve.isAvailable(destination)) return true;\n      }\n      return false;\n    }\n  };\n}\n","import type {\n  Channel,\n  ChannelApprovalRequestOptions,\n  ChannelChunk,\n  ChannelDeliveryOptions,\n  ChannelMessage,\n  ChannelStreamOptions,\n  DeliveryResult,\n  OutboundResolver\n} from \"./channel\";\nimport { compositeDestinations, unsupported } from \"./internal\";\nimport type { ChannelMessageSurface } from \"./surface\";\n\nexport type FanoutSurface = ChannelMessageSurface<\n  \"fanout\",\n  { surfaces: readonly ChannelMessageSurface[] }\n>;\n\n/** A non-empty set of destinations that must all receive each delivery. */\nexport type FanoutSurfaceOptions = readonly [\n  ChannelMessageSurface,\n  ...ChannelMessageSurface[]\n];\n\ntype FanoutOperation = (\n  surface: ChannelMessageSurface\n) => Promise<DeliveryResult>;\n\nfunction teeAll<T>(\n  source: ReadableStream<T>,\n  count: number\n): ReadableStream<T>[] {\n  const branches: ReadableStream<T>[] = [];\n  let rest = source;\n  for (let index = 0; index < count - 1; index += 1) {\n    const [branch, remainder] = rest.tee();\n    branches.push(branch);\n    rest = remainder;\n  }\n  branches.push(rest);\n  return branches;\n}\n\n/** Build an inert fanout destination for a `ChannelHost` to resolve. */\nexport function fanout(surfaces: FanoutSurfaceOptions): FanoutSurface {\n  return {\n    channelKey: \"fanout\",\n    version: 1,\n    address: { surfaces },\n    label: surfaces.map((surface) => surface.label).join(\" and \")\n  };\n}\n\n/** Build the ordinary Channel installed under the reserved fanout key. */\nexport function fanoutChannel(resolve: OutboundResolver): Channel {\n  async function run(\n    surface: ChannelMessageSurface,\n    operation: FanoutOperation\n  ): Promise<DeliveryResult> {\n    const destinations = compositeDestinations(surface);\n    if (!destinations) {\n      return unsupported(\n        \"FANOUT_SURFACE_INVALID\",\n        \"Fanout surface must contain at least one valid destination\"\n      );\n    }\n\n    return combine(await Promise.all(destinations.map(operation)));\n  }\n\n  function combine(results: readonly DeliveryResult[]): DeliveryResult {\n    if (results.every((result) => result.status === \"delivered\")) {\n      return { status: \"delivered\" };\n    }\n    if (results.every((result) => result.status === \"failed\")) {\n      return {\n        status: \"failed\",\n        retryable: results.every(\n          (result) => result.status === \"failed\" && result.retryable\n        ),\n        error: {\n          code: \"FANOUT_DELIVERY_FAILED\",\n          message: \"Every fanout destination rejected the delivery\"\n        }\n      };\n    }\n    return {\n      status: \"uncertain\",\n      error: {\n        code: \"FANOUT_DELIVERY_UNCERTAIN\",\n        message:\n          \"Fanout delivery was partial or had an uncertain destination outcome\"\n      }\n    };\n  }\n\n  return {\n    deliver(\n      surface: ChannelMessageSurface,\n      message: ChannelMessage,\n      options?: ChannelDeliveryOptions\n    ) {\n      return run(surface, (destination) =>\n        resolve.deliver(destination, message, options)\n      );\n    },\n    async stream(\n      surface: ChannelMessageSurface,\n      chunks: ReadableStream<ChannelChunk>,\n      options: ChannelStreamOptions\n    ) {\n      const destinations = compositeDestinations(surface);\n      if (!destinations) {\n        await chunks.cancel().catch(() => {});\n        return unsupported(\n          \"FANOUT_SURFACE_INVALID\",\n          \"Fanout surface must contain at least one valid destination\"\n        );\n      }\n      // One branch per destination, so a slow reader cannot pace a fast one.\n      const branches = teeAll(chunks, destinations.length);\n      return combine(\n        await Promise.all(\n          destinations.map(async (destination, index) => {\n            const branch = branches[index]!;\n            try {\n              return await resolve.stream(destination, branch, options);\n            } finally {\n              // A destination may return after an opening failure without\n              // reading. Cancel immediately so tee does not retain every chunk\n              // consumed by the remaining destinations. Do not await: one tee\n              // branch's cancellation settles only after its siblings finish.\n              void branch.cancel().catch(() => {});\n            }\n          })\n        )\n      );\n    },\n    requestApproval(\n      surface: ChannelMessageSurface,\n      options: ChannelApprovalRequestOptions\n    ) {\n      return run(surface, (destination) =>\n        resolve.requestApproval(destination, options)\n      );\n    },\n    async isAvailable(surface) {\n      const destinations = compositeDestinations(surface);\n      if (!destinations) return true;\n      const available = await Promise.all(\n        destinations.map((destination) => resolve.isAvailable(destination))\n      );\n      return available.every(Boolean);\n    }\n  };\n}\n","import type {\n  Channel,\n  ChannelApprovalRequestOptions,\n  ChannelChunk,\n  ChannelChunkSource,\n  ChannelDeliveryOptions,\n  ChannelMessage,\n  ChannelRoute,\n  ChannelRouteContext,\n  ChannelStreamOptions,\n  DeliveryResult\n} from \"../channel\";\nimport { fallbackChannel } from \"../fallback\";\nimport { fanoutChannel } from \"../fanout\";\nimport type {\n  ChannelIdentity,\n  ChannelIdentityInput,\n  UserIdentity\n} from \"../identity\";\nimport { unsupported } from \"../internal\";\nimport { collectText } from \"../stream\";\nimport type {\n  ChannelApprovalResponse,\n  ChannelEmailInput,\n  ChannelInboundMessage,\n  ChannelIngressEnvelope,\n  ChannelIngressEvent,\n  ChannelIngressEventInput\n} from \"../ingress\";\nimport {\n  isChannelMessageSurface,\n  type ChannelMessageSurface,\n  type ChannelMessageSurfaceInput\n} from \"../surface\";\n\nexport type ChannelMessageEvent = {\n  channelKey: string;\n  route: string;\n  /** Stable identity derived only from the configured Channel and eventId. */\n  dispatchId: string;\n  message: ChannelInboundMessage;\n};\n\nexport type ChannelApprovalResponseEvent = {\n  channelKey: string;\n  route: string;\n  /** Stable identity derived only from the configured Channel and eventId. */\n  dispatchId: string;\n  response: ChannelApprovalResponse;\n};\n\nexport type ChannelRouteEvent = {\n  channelKey: string;\n  event: ChannelIngressEvent;\n  route: string | null;\n  /** Stable identity derived only from the configured Channel and eventId. */\n  dispatchId: string;\n};\n\nexport type ChannelHostOptions = {\n  channels: Record<string, Channel>;\n  /** Used when a Channel does not provide a route. Default: event thread id. */\n  defaultRoute?: ChannelRoute;\n  /** Resolve an existing, explicitly linked application user. */\n  findUser?(identity: ChannelIdentity): Promise<UserIdentity | null>;\n  /** Observes every valid route outcome before application dispatch. */\n  onRoute?(event: ChannelRouteEvent): void | Promise<void>;\n  onMessage?(event: ChannelMessageEvent): void | Promise<void>;\n  onApprovalResponse?(\n    event: ChannelApprovalResponseEvent\n  ): void | Promise<void>;\n};\n\ntype OutboundOperation = (\n  channel: Channel,\n  surface: ChannelMessageSurface\n) => Promise<DeliveryResult>;\n\nconst POLICY_KEYS = new Set([\"fallback\", \"fanout\"]);\n\n/**\n * Authenticates and normalizes ingress through configured Channel adapters,\n * resolves outbound surfaces, and awaits the application's durable handoff.\n */\nexport class ChannelHost {\n  readonly #channels: Record<string, Channel>;\n  readonly #defaultRoute: ChannelRoute | undefined;\n  readonly #findUser: ChannelHostOptions[\"findUser\"];\n  readonly #onRoute: ChannelHostOptions[\"onRoute\"];\n  readonly #onMessage: ChannelHostOptions[\"onMessage\"];\n  readonly #onApprovalResponse: ChannelHostOptions[\"onApprovalResponse\"];\n\n  constructor(options: ChannelHostOptions) {\n    for (const channelKey of Object.keys(options.channels)) {\n      if (POLICY_KEYS.has(channelKey)) {\n        throw new Error(\n          `Channel key \"${channelKey}\" is reserved for a delivery policy`\n        );\n      }\n    }\n    const channels = { ...options.channels };\n    this.#channels = channels;\n    channels.fallback = fallbackChannel(this);\n    channels.fanout = fanoutChannel(this);\n    this.#defaultRoute = options.defaultRoute;\n    this.#findUser = options.findUser;\n    this.#onRoute = options.onRoute;\n    this.#onMessage = options.onMessage;\n    this.#onApprovalResponse = options.onApprovalResponse;\n  }\n\n  async handleRequest(request: Request): Promise<Response | undefined> {\n    for (const [channelKey, channel] of Object.entries(this.#channels)) {\n      const ingress = channel.ingress;\n      if (!ingress) continue;\n\n      try {\n        const result = await ingress.receive(request);\n        if (!result) continue;\n        for (const envelope of result.events) {\n          await this.#dispatch(channelKey, channel, envelope);\n        }\n        return result.response;\n      } catch {\n        return new Response(\"Failed to handle Channel event\", { status: 500 });\n      }\n    }\n    return undefined;\n  }\n\n  async handleEmail(email: ChannelEmailInput): Promise<boolean> {\n    for (const [channelKey, channel] of Object.entries(this.#channels)) {\n      const ingress = channel.emailIngress;\n      if (!ingress) continue;\n\n      const result = await ingress.receive(email);\n      if (!result) continue;\n      for (const envelope of result.events) {\n        await this.#dispatch(channelKey, channel, envelope);\n      }\n      return true;\n    }\n    return false;\n  }\n\n  /** Deliver through the configured Channel or composite named by the surface. */\n  deliver(\n    surface: ChannelMessageSurface,\n    message: ChannelMessage,\n    options?: ChannelDeliveryOptions\n  ): Promise<DeliveryResult> {\n    return this.#outbound(surface, (channel, destination) => {\n      if (!channel.deliver) {\n        return Promise.resolve(\n          unsupported(\n            \"CHANNEL_DELIVERY_UNSUPPORTED\",\n            `Channel \"${destination.channelKey}\" does not support delivery`\n          )\n        );\n      }\n      return channel.deliver(destination, message, options);\n    });\n  }\n\n  /**\n   * Deliver a progressively generated answer to the Channel or composite\n   * named by the surface.\n   *\n   * A Channel that can stream consumes the stream itself. A Channel that\n   * cannot never learns it was a stream, because the Host collects the answer\n   * and calls `deliver` once.\n   */\n  async stream(\n    surface: ChannelMessageSurface,\n    chunks: ChannelChunkSource,\n    options: ChannelStreamOptions = {}\n  ): Promise<DeliveryResult> {\n    if (!isChannelMessageSurface(surface)) {\n      await chunks.cancel().catch(() => {});\n      return invalidSurface();\n    }\n\n    const channel = this.#configuredChannel(surface.channelKey);\n    if (!channel.stream && !channel.deliver) {\n      await chunks.cancel().catch(() => {});\n      return unsupported(\n        \"CHANNEL_DELIVERY_UNSUPPORTED\",\n        `Channel \"${surface.channelKey}\" does not support delivery`\n      );\n    }\n\n    if (channel.stream) return channel.stream(surface, chunks, options);\n    return collectAndDeliver(channel, surface, chunks, options);\n  }\n\n  /** Request approval through the Channel or composite named by the surface. */\n  requestApproval(\n    surface: ChannelMessageSurface,\n    options: ChannelApprovalRequestOptions\n  ): Promise<DeliveryResult> {\n    return this.#outbound(surface, (channel, destination) => {\n      if (!channel.requestApproval) {\n        return Promise.resolve(\n          unsupported(\n            \"CHANNEL_APPROVAL_UNSUPPORTED\",\n            `Channel \"${destination.channelKey}\" does not support approval requests`\n          )\n        );\n      }\n      return channel.requestApproval(destination, options);\n    });\n  }\n\n  /** Return the identity's configured Channel destination, when supported. */\n  contactSurface(identity: ChannelIdentity): ChannelMessageSurface | null {\n    const channel = Object.prototype.hasOwnProperty.call(\n      this.#channels,\n      identity.channelKey\n    )\n      ? this.#channels[identity.channelKey]\n      : undefined;\n    const surface = channel?.contactSurface?.(identity);\n    return surface ? stampSurface(identity.channelKey, surface) : null;\n  }\n\n  /** Resolve whether a surface can currently be selected without delivery. */\n  async isAvailable(surface: ChannelMessageSurface): Promise<boolean> {\n    if (!isChannelMessageSurface(surface)) return false;\n    const channel = this.#configuredChannel(surface.channelKey);\n    return channel.isAvailable?.(surface) ?? true;\n  }\n\n  async #outbound(\n    surface: ChannelMessageSurface,\n    operation: OutboundOperation\n  ): Promise<DeliveryResult> {\n    if (!isChannelMessageSurface(surface)) return invalidSurface();\n    const channel = this.#configuredChannel(surface.channelKey);\n    return operation(channel, surface);\n  }\n\n  #configuredChannel(channelKey: string): Channel {\n    const channel = Object.prototype.hasOwnProperty.call(\n      this.#channels,\n      channelKey\n    )\n      ? this.#channels[channelKey]\n      : undefined;\n    if (!channel) {\n      throw new Error(\n        `Channel message surface names unknown configured Channel key \"${channelKey}\"`\n      );\n    }\n    return channel;\n  }\n\n  async #dispatch(\n    channelKey: string,\n    channel: Channel,\n    envelope: ChannelIngressEnvelope\n  ): Promise<void> {\n    const rawEvent = envelope.event;\n    const event = stampEvent(channelKey, rawEvent);\n    const route = await this.#route(channelKey, channel, event, envelope.raw);\n    const dispatchId = await createDispatchId(channelKey, event.eventId);\n    await this.#onRoute?.({ channelKey, event, route, dispatchId });\n    if (route === null) return;\n\n    if (event.type === \"message\") {\n      if (!this.#onMessage) {\n        throw new Error(\n          `Channel \"${channelKey}\" received a message without an onMessage callback`\n        );\n      }\n      await this.#onMessage({ channelKey, route, dispatchId, message: event });\n      return;\n    }\n    if (!this.#onApprovalResponse) {\n      throw new Error(\n        `Channel \"${channelKey}\" received an approval response without an onApprovalResponse callback`\n      );\n    }\n    await this.#onApprovalResponse({\n      channelKey,\n      route,\n      dispatchId,\n      response: event\n    });\n  }\n\n  async #route(\n    channelKey: string,\n    channel: Channel,\n    event: ChannelIngressEvent,\n    raw: unknown\n  ): Promise<string | null> {\n    const context = this.#routeContext(event);\n    const route = channel.route\n      ? await channel.route(event, raw, context)\n      : this.#defaultRoute\n        ? await this.#defaultRoute(event, raw, context)\n        : event.thread.id;\n\n    if (route === undefined) {\n      throw new Error(\n        `Channel route for \"${channelKey}\" returned undefined; return null to ignore an event`\n      );\n    }\n    if (route !== null && typeof route !== \"string\") {\n      throw new Error(\n        `Channel route for \"${channelKey}\" must return a string or null`\n      );\n    }\n    return route;\n  }\n\n  #routeContext(event: ChannelIngressEvent): ChannelRouteContext {\n    let linkedUser: Promise<UserIdentity | null> | undefined;\n    return {\n      findUser: () => {\n        if (!linkedUser) {\n          const identity = event.actor?.identity;\n          const findUser = this.#findUser;\n          linkedUser =\n            identity && findUser\n              ? Promise.resolve().then(() => findUser(identity))\n              : Promise.resolve(null);\n        }\n        return linkedUser;\n      }\n    };\n  }\n}\n\n/**\n * Serve a Channel that cannot stream by collecting the answer first.\n *\n * A generation that failed part-way still delivers what it produced, because\n * losing the partial answer helps nobody, but the result is downgraded to\n * `uncertain` since the reader received an incomplete answer.\n */\nfunction invalidSurface(): DeliveryResult {\n  return unsupported(\n    \"CHANNEL_SURFACE_INVALID\",\n    \"Cannot resolve an invalid Channel message surface\"\n  );\n}\n\nasync function collectAndDeliver(\n  channel: Channel,\n  surface: ChannelMessageSurface,\n  stream: ReadableStream<ChannelChunk>,\n  options: ChannelStreamOptions\n): Promise<DeliveryResult> {\n  const collected = await collectText(stream);\n  if (collected.interrupted && collected.text.length === 0) {\n    return {\n      status: \"failed\",\n      retryable: false,\n      error: {\n        code: \"CHANNEL_STREAM_INTERRUPTED\",\n        message: \"The stream ended before producing any content to deliver\"\n      }\n    };\n  }\n\n  const result = await channel.deliver!(\n    surface,\n    {\n      ...(options.title !== undefined && { title: options.title }),\n      markdown: collected.text\n    },\n    options.delivery ? { delivery: options.delivery } : undefined\n  );\n  if (!collected.interrupted || result.status !== \"delivered\") return result;\n  return {\n    status: \"uncertain\",\n    ...(result.reference !== undefined && { reference: result.reference }),\n    error: {\n      code: \"CHANNEL_STREAM_INTERRUPTED\",\n      message:\n        \"An incomplete answer was delivered because the stream ended early\"\n    }\n  };\n}\n\nfunction stampSurface<TAddress extends ChannelMessageSurfaceInput[\"address\"]>(\n  channelKey: string,\n  surface: ChannelMessageSurfaceInput<TAddress>\n): ChannelMessageSurface<string, TAddress> {\n  return { ...surface, channelKey };\n}\n\nfunction stampIdentity(\n  channelKey: string,\n  identity: ChannelIdentityInput\n): ChannelIdentity {\n  return { ...identity, channelKey };\n}\n\nfunction stampEvent(\n  channelKey: string,\n  event: ChannelIngressEventInput\n): ChannelIngressEvent {\n  return {\n    ...event,\n    ...(event.replySurface && {\n      replySurface: stampSurface(channelKey, event.replySurface)\n    }),\n    ...(event.actor && {\n      actor: {\n        ...event.actor,\n        ...(event.actor.identity && {\n          identity: stampIdentity(channelKey, event.actor.identity)\n        })\n      }\n    })\n  } as ChannelIngressEvent;\n}\n\n/** Hash an unambiguous tuple so dispatch identities remain safe to carry. */\nasync function createDispatchId(\n  channelKey: string,\n  eventId: string\n): Promise<string> {\n  const identity = new TextEncoder().encode(\n    JSON.stringify([channelKey, eventId])\n  );\n  const digest = await crypto.subtle.digest(\"SHA-256\", identity);\n  return `sha256:${Array.from(new Uint8Array(digest), (byte) =>\n    byte.toString(16).padStart(2, \"0\")\n  ).join(\"\")}`;\n}\n","export type ChannelIdentity = Readonly<{\n  /** Configured Channel that observed this identity. */\n  channelKey: string;\n  /** Stable Channel namespace in which `subject` is unique. @default \"default\" */\n  scope?: string;\n  /** Stable Channel subject within `scope`. */\n  subject: string;\n}>;\n\n/** A Channel-produced identity before its Host stamps the configured key. */\nexport type ChannelIdentityInput = Readonly<{\n  scope?: string;\n  subject: string;\n}>;\n\nconst DEFAULT_IDENTITY_SCOPE = \"default\";\n\ntype NormalizedChannelIdentity = Readonly<{\n  channelKey: string;\n  scope: string;\n  subject: string;\n}>;\n\nfunction normalizeIdentity(\n  identity: ChannelIdentity\n): NormalizedChannelIdentity {\n  return {\n    channelKey: identity.channelKey,\n    scope: identity.scope ?? DEFAULT_IDENTITY_SCOPE,\n    subject: identity.subject\n  };\n}\n\n/** Build a stable key for comparing or indexing a Channel identity. */\nexport function identityKey(identity: ChannelIdentity): string {\n  const normalized = normalizeIdentity(identity);\n  return JSON.stringify([\n    normalized.channelKey,\n    normalized.scope,\n    normalized.subject\n  ]);\n}\n\nexport type UserIdentity = Readonly<{\n  /** Opaque identity owned by this store. */\n  id: string;\n  /** Channel identities explicitly linked to this user. */\n  channelIdentities: readonly ChannelIdentity[];\n}>;\n\nexport type UserIdentityConflict = Readonly<{\n  channelIdentity: ChannelIdentity;\n  userId: string;\n}>;\n\n/** Raised when an operation would join identities already assigned to users. */\nexport class UserIdentityConflictError extends Error {\n  readonly code = \"USER_IDENTITY_CONFLICT\";\n\n  constructor(\n    readonly conflicts: readonly UserIdentityConflict[],\n    readonly attemptedUserId?: string\n  ) {\n    super(\n      attemptedUserId\n        ? `A channel identity is already linked to a different user than ${attemptedUserId}`\n        : \"Both channel identities are already linked to users\"\n    );\n    this.name = \"UserIdentityConflictError\";\n  }\n}\n\n/**\n * Application-owned user identity links.\n *\n * Implementations never infer links from usernames, email-like values, display\n * names, or message surfaces. Every link is an explicit application decision.\n */\nexport interface UserIdentityStore {\n  /** Link one Channel identity to a user. Repeating the same link is safe. */\n  link(userId: string, identity: ChannelIdentity): Promise<UserIdentity>;\n\n  /** Find the user linked to one Channel identity. */\n  findUser(identity: ChannelIdentity): Promise<UserIdentity | null>;\n\n  /** Get a user and all of its linked Channel identities. */\n  getUser(userId: string): Promise<UserIdentity | null>;\n\n  /** List every user and its linked Channel identities, ordered by user ID. */\n  listUsers(): Promise<UserIdentity[]>;\n\n  /**\n   * Atomically join two previously unjoined Channel identities.\n   *\n   * If one is linked, the other joins that user. If neither is linked, a new\n   * user is created. If both are linked, this raises\n   * `UserIdentityConflictError`, including when both point to the same user.\n   */\n  linkChannelIdentities(\n    first: ChannelIdentity,\n    second: ChannelIdentity\n  ): Promise<UserIdentity>;\n}\n\nexport type UserIdentitySqlValue = ArrayBuffer | string | number | null;\n\n/** Structural storage seam satisfied by Durable Object SQLite storage. */\nexport interface UserIdentityStorage {\n  readonly sql: {\n    exec<Row extends Record<string, UserIdentitySqlValue>>(\n      query: string,\n      ...bindings: UserIdentitySqlValue[]\n    ): { toArray(): Row[] };\n  };\n  transactionSync<Result>(closure: () => Result): Result;\n}\n\nexport type UserIdentityStoreOptions = {\n  /** Generate a new opaque user ID. @default crypto.randomUUID */\n  createUserId?: () => string;\n};\n\nconst USERS_TABLE = \"cf_channels_users_v1\";\nconst LINKS_TABLE = \"cf_channels_user_identity_links_v1\";\n\nfunction requireNonEmpty(label: string, value: string): void {\n  if (value.length === 0) {\n    throw new TypeError(`${label} must be a non-empty string`);\n  }\n}\n\nfunction validatedIdentity(\n  identity: ChannelIdentity\n): NormalizedChannelIdentity {\n  const normalized = normalizeIdentity(identity);\n  requireNonEmpty(\"identity.channelKey\", normalized.channelKey);\n  requireNonEmpty(\"identity.scope\", normalized.scope);\n  requireNonEmpty(\"identity.subject\", normalized.subject);\n  return normalized;\n}\n\nfunction sameIdentity(\n  first: ChannelIdentity,\n  second: ChannelIdentity\n): boolean {\n  return identityKey(first) === identityKey(second);\n}\n\nfunction compareIdentities(\n  first: NormalizedChannelIdentity,\n  second: NormalizedChannelIdentity\n): number {\n  return (\n    first.channelKey.localeCompare(second.channelKey) ||\n    first.scope.localeCompare(second.scope) ||\n    first.subject.localeCompare(second.subject)\n  );\n}\n\n/** Build the off-the-shelf user identity store over application-owned SQLite. */\nexport function createUserIdentityStore(\n  storage: UserIdentityStorage,\n  options: UserIdentityStoreOptions = {}\n): UserIdentityStore {\n  const createUserId = options.createUserId ?? (() => crypto.randomUUID());\n\n  storage.sql.exec(`\n    CREATE TABLE IF NOT EXISTS ${USERS_TABLE} (\n      user_id TEXT PRIMARY KEY\n    ) WITHOUT ROWID\n  `);\n  storage.sql.exec(`\n    CREATE TABLE IF NOT EXISTS ${LINKS_TABLE} (\n      channel_key TEXT NOT NULL,\n      scope TEXT NOT NULL,\n      subject TEXT NOT NULL,\n      user_id TEXT NOT NULL,\n      PRIMARY KEY (channel_key, scope, subject)\n    ) WITHOUT ROWID\n  `);\n  storage.sql.exec(`\n    CREATE INDEX IF NOT EXISTS ${LINKS_TABLE}_user\n    ON ${LINKS_TABLE} (user_id, channel_key, scope, subject)\n  `);\n\n  function linkedUserId(identity: NormalizedChannelIdentity): string | null {\n    const row = storage.sql\n      .exec<{ user_id: string }>(\n        `SELECT user_id FROM ${LINKS_TABLE}\n         WHERE channel_key = ? AND scope = ? AND subject = ?`,\n        identity.channelKey,\n        identity.scope,\n        identity.subject\n      )\n      .toArray()[0];\n    return row?.user_id ?? null;\n  }\n\n  function readUser(userId: string): UserIdentity | null {\n    const user = storage.sql\n      .exec<{ user_id: string }>(\n        `SELECT user_id FROM ${USERS_TABLE} WHERE user_id = ?`,\n        userId\n      )\n      .toArray()[0];\n    if (!user) return null;\n\n    const channelIdentities = storage.sql\n      .exec<{ channelKey: string; scope: string; subject: string }>(\n        `SELECT channel_key AS channelKey, scope, subject FROM ${LINKS_TABLE}\n         WHERE user_id = ?\n         ORDER BY channel_key, scope, subject`,\n        userId\n      )\n      .toArray()\n      .sort(compareIdentities);\n    return { id: user.user_id, channelIdentities };\n  }\n\n  function insertUser(userId: string): boolean {\n    const inserted = storage.sql\n      .exec<{ user_id: string }>(\n        `INSERT INTO ${USERS_TABLE} (user_id) VALUES (?)\n         ON CONFLICT (user_id) DO NOTHING\n         RETURNING user_id`,\n        userId\n      )\n      .toArray()[0];\n    return inserted !== undefined;\n  }\n\n  function createUser(): string {\n    for (let attempt = 0; attempt < 10; attempt += 1) {\n      const userId = createUserId();\n      requireNonEmpty(\"createUserId() result\", userId);\n      if (insertUser(userId)) return userId;\n    }\n    throw new Error(\"createUserId() repeatedly returned existing user IDs\");\n  }\n\n  function insertLink(\n    userId: string,\n    identity: NormalizedChannelIdentity\n  ): void {\n    storage.sql.exec(\n      `INSERT INTO ${LINKS_TABLE} (channel_key, scope, subject, user_id)\n       VALUES (?, ?, ?, ?)`,\n      identity.channelKey,\n      identity.scope,\n      identity.subject,\n      userId\n    );\n  }\n\n  const store: UserIdentityStore = {\n    async link(userId, identity) {\n      requireNonEmpty(\"userId\", userId);\n      const normalized = validatedIdentity(identity);\n\n      return storage.transactionSync(() => {\n        const existingUserId = linkedUserId(normalized);\n        if (existingUserId && existingUserId !== userId) {\n          throw new UserIdentityConflictError(\n            [{ channelIdentity: normalized, userId: existingUserId }],\n            userId\n          );\n        }\n\n        insertUser(userId);\n        if (!existingUserId) insertLink(userId, normalized);\n        const user = readUser(userId);\n        if (!user) throw new Error(\"Linked user identity could not be read\");\n        return user;\n      });\n    },\n\n    async findUser(identity) {\n      const normalized = validatedIdentity(identity);\n      const userId = linkedUserId(normalized);\n      return userId ? readUser(userId) : null;\n    },\n\n    async getUser(userId) {\n      requireNonEmpty(\"userId\", userId);\n      return readUser(userId);\n    },\n\n    async listUsers() {\n      return storage.sql\n        .exec<{ user_id: string }>(\n          `SELECT user_id FROM ${USERS_TABLE} ORDER BY user_id`\n        )\n        .toArray()\n        .map(({ user_id }) => readUser(user_id))\n        .filter((user): user is UserIdentity => user !== null);\n    },\n\n    async linkChannelIdentities(first, second) {\n      const normalizedFirst = validatedIdentity(first);\n      const normalizedSecond = validatedIdentity(second);\n      if (sameIdentity(normalizedFirst, normalizedSecond)) {\n        throw new TypeError(\"Channel identities must be distinct\");\n      }\n\n      return storage.transactionSync(() => {\n        const firstUserId = linkedUserId(normalizedFirst);\n        const secondUserId = linkedUserId(normalizedSecond);\n        if (firstUserId && secondUserId) {\n          throw new UserIdentityConflictError([\n            { channelIdentity: normalizedFirst, userId: firstUserId },\n            { channelIdentity: normalizedSecond, userId: secondUserId }\n          ]);\n        }\n\n        const userId = firstUserId ?? secondUserId ?? createUser();\n        if (!firstUserId) insertLink(userId, normalizedFirst);\n        if (!secondUserId) insertLink(userId, normalizedSecond);\n\n        const user = readUser(userId);\n        if (!user) throw new Error(\"Linked user identity could not be read\");\n        return user;\n      });\n    }\n  };\n\n  return store;\n}\n\n/** Join two Channel identities through a `UserIdentityStore`. */\nexport function linkChannelIdentities(\n  store: UserIdentityStore,\n  first: ChannelIdentity,\n  second: ChannelIdentity\n): Promise<UserIdentity> {\n  return store.linkChannelIdentities(first, second);\n}\n","import type { ChannelRoute } from \"./channel\";\nimport { identityKey } from \"./identity\";\nimport type { ChannelIngressEvent } from \"./ingress\";\n\n/**\n * Common deterministic routing policies for normalized Channel events.\n *\n * Each one maps an event to a namespaced application route. Deciding whether\n * an event is relevant at all is application policy: write that in your own\n * `route` function and return `null` to ignore the event.\n */\nexport const routes = {\n  /**\n   * Give every event its own application route. Useful to kick off a\n   * new conversation for each ingress, and where you don't want subsequent\n   * messages routed back to that same conversation.\n   **/\n  perEvent(event: ChannelIngressEvent): string {\n    return `event:${event.eventId}`;\n  },\n\n  /** Send every event in the same thread to the same conversation */\n  perThread(event: ChannelIngressEvent): string {\n    return `thread:${event.thread.id}`;\n  },\n\n  /**\n   * Prefer the sender's own channel identity, then delegate to another route\n   * policy. Without a fallback, an event carrying no identity is ignored.\n   *\n   * This groups events that carry the *same* identity. It never infers that\n   * two different identities belong to one person: that is an explicit\n   * application decision, exposed to routing through `byUser`.\n   */\n  byIdentity<TRaw>(fallback?: ChannelRoute<TRaw>): ChannelRoute<TRaw> {\n    return (event, raw, context) => {\n      const identity = event.actor?.identity;\n      if (identity) return `identity:${identityKey(identity)}`;\n      return fallback ? fallback(event, raw, context) : null;\n    };\n  },\n\n  /** Prefer an explicitly linked user, then delegate to another route policy. */\n  byUser<TRaw>(fallback: ChannelRoute<TRaw>): ChannelRoute<TRaw> {\n    return async (event, raw, context) => {\n      const user = await context.findUser();\n      return user ? `user:${user.id}` : fallback(event, raw, context);\n    };\n  }\n};\n"],"mappings":"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"}

package/dist/channels/slack.d.ts

@@ -0,0 +1,140 @@
+import {
+  F as ChannelMessageSurface,
+  d as ChannelRoute,
+  k as ChannelIngress,
+  n as Channel,
+  u as ChannelMessage
+} from "../channel-Bnm4S7T2.js";
+
+//#region src/channels/adapters/slack.d.ts
+/** The subset of a Slack event used by the adapter, with unknown fields retained. */
+type SlackEvent = {
+  type?: string;
+  user?: string;
+  text?: string;
+  ts?: string;
+  thread_ts?: string;
+  channel?: string;
+  channel_type?: string;
+  subtype?: string;
+  bot_id?: string;
+  app_id?: string;
+  [key: string]: unknown;
+};
+type SlackAuthorization = {
+  team_id?: string;
+  user_id?: string;
+  is_bot?: boolean;
+  [key: string]: unknown;
+};
+/** A typed Slack Events API callback retained in an ingress envelope. */
+type SlackEventCallback = {
+  type: "event_callback";
+  event_id: string;
+  team_id: string;
+  event: SlackEvent;
+  authorizations?: readonly SlackAuthorization[];
+  [key: string]: unknown;
+};
+/** A typed Slack URL verification request. */
+type SlackUrlVerification = {
+  type: "url_verification";
+  challenge: string;
+  [key: string]: unknown;
+};
+type SlackBlockAction = {
+  action_id?: string;
+  action_ts?: string;
+  value?: string;
+  [key: string]: unknown;
+};
+/** A typed Slack Block Kit interaction retained in an ingress envelope. */
+type SlackBlockActions = {
+  type: "block_actions";
+  team?: {
+    id?: string;
+    [key: string]: unknown;
+  };
+  user?: {
+    id?: string;
+    username?: string;
+    name?: string;
+    [key: string]: unknown;
+  };
+  channel?: {
+    id?: string;
+    [key: string]: unknown;
+  };
+  message?: {
+    ts?: string;
+    thread_ts?: string;
+    [key: string]: unknown;
+  };
+  container?: {
+    channel_id?: string;
+    message_ts?: string;
+    thread_ts?: string;
+    [key: string]: unknown;
+  };
+  actions?: readonly SlackBlockAction[];
+  [key: string]: unknown;
+};
+/** Authenticated Slack payloads which may be passed to a Channel route. */
+type SlackIngressPayload = SlackEventCallback | SlackBlockActions;
+type SlackWebhookOptions = {
+  /** Slack app signing secret. */ signingSecret: string /** Exact webhook pathname accepted by this ingress. @default "/webhooks/slack" */;
+  path?: string /** Maximum accepted request timestamp skew in seconds. @default 300 */;
+  maxSkewSeconds?: number /** Bot user id used to discard events sent by this app. */;
+  botUserId?: string;
+};
+type SlackMessageSurface = ChannelMessageSurface<
+  string,
+  | {
+      channelId: string;
+      threadTs?: string /** The reader a channel stream is rendered for. Slack requires it. */;
+      recipientUserId?: string;
+      recipientTeamId?: string;
+    }
+  | {
+      teamId: string;
+      userId: string;
+    }
+>;
+/** Configuration for a Slack Channel. */
+type SlackChannelOptions = {
+  /** Bot token used with chat.postMessage. */ botToken: string /** Slack Web API origin. @default "https://slack.com/api" */;
+  apiBaseUrl?: string /** Project canonical Channel Markdown into Slack mrkdwn text. */;
+  toText?: (message: ChannelMessage) => string;
+  /**
+   * Smallest gap between `chat.appendStream` calls. Chunks produced inside
+   * one interval are appended together. @default 500
+   */
+  streamIntervalMs?: number /** Add signed Slack HTTP ingress to the returned Channel. */;
+  webhook?: SlackWebhookOptions /** Select an application route from the event, exact payload, and Host context. */;
+  route?: ChannelRoute<SlackIngressPayload> /** Override fetch for testing or custom network routing. */;
+  fetch?: typeof globalThis.fetch;
+};
+/** Create dependency-free, request-signed Slack HTTP ingress. */
+declare function slackWebhook(
+  options: SlackWebhookOptions
+): ChannelIngress<SlackIngressPayload>;
+/** Create a configured Slack Web API Channel. */
+declare function slack(
+  options: SlackChannelOptions
+): Channel<SlackIngressPayload>;
+//#endregion
+export {
+  SlackAuthorization,
+  SlackBlockAction,
+  SlackBlockActions,
+  SlackChannelOptions,
+  SlackEvent,
+  SlackEventCallback,
+  SlackIngressPayload,
+  SlackMessageSurface,
+  SlackUrlVerification,
+  SlackWebhookOptions,
+  slack,
+  slackWebhook
+};
+//# sourceMappingURL=slack.d.ts.map