agents 0.26.0 → 0.27.0

package/dist/index-BB0kqhIz.d.ts

@@ -1,101 +0,0 @@
-import {
-  D as ChannelInboundMessage,
-  F as ChannelMessageSurface,
-  U as UserIdentity,
-  V as ChannelIdentity,
-  a as ChannelApprovalRequestOptions,
-  d as ChannelRoute,
-  h as DeliveryResult,
-  j as ChannelIngressEvent,
-  l as ChannelDeliveryOptions,
-  n as Channel,
-  p as ChannelStreamOptions,
-  s as ChannelChunkSource,
-  u as ChannelMessage,
-  w as ChannelEmailInput,
-  y as ChannelApprovalResponse
-} from "./channel-Bnm4S7T2.js";
-
-//#region src/channels/host/index.d.ts
-type ChannelMessageEvent = {
-  channelKey: string;
-  route: string /** Stable identity derived only from the configured Channel and eventId. */;
-  dispatchId: string;
-  message: ChannelInboundMessage;
-};
-type ChannelApprovalResponseEvent = {
-  channelKey: string;
-  route: string /** Stable identity derived only from the configured Channel and eventId. */;
-  dispatchId: string;
-  response: ChannelApprovalResponse;
-};
-type ChannelRouteEvent = {
-  channelKey: string;
-  event: ChannelIngressEvent;
-  route:
-    | string
-    | null /** Stable identity derived only from the configured Channel and eventId. */;
-  dispatchId: string;
-};
-type ChannelHostOptions = {
-  channels: Record<
-    string,
-    Channel
-  > /** Used when a Channel does not provide a route. Default: event thread id. */;
-  defaultRoute?: ChannelRoute /** Resolve an existing, explicitly linked application user. */;
-  findUser?(
-    identity: ChannelIdentity
-  ): Promise<UserIdentity | null> /** Observes every valid route outcome before application dispatch. */;
-  onRoute?(event: ChannelRouteEvent): void | Promise<void>;
-  onMessage?(event: ChannelMessageEvent): void | Promise<void>;
-  onApprovalResponse?(
-    event: ChannelApprovalResponseEvent
-  ): void | Promise<void>;
-};
-/**
- * Authenticates and normalizes ingress through configured Channel adapters,
- * resolves outbound surfaces, and awaits the application's durable handoff.
- */
-declare class ChannelHost {
-  #private;
-  constructor(options: ChannelHostOptions);
-  handleRequest(request: Request): Promise<Response | undefined>;
-  handleEmail(email: ChannelEmailInput): Promise<boolean>;
-  /** Deliver through the configured Channel or composite named by the surface. */
-  deliver(
-    surface: ChannelMessageSurface,
-    message: ChannelMessage,
-    options?: ChannelDeliveryOptions
-  ): Promise<DeliveryResult>;
-  /**
-   * Deliver a progressively generated answer to the Channel or composite
-   * named by the surface.
-   *
-   * A Channel that can stream consumes the stream itself. A Channel that
-   * cannot never learns it was a stream, because the Host collects the answer
-   * and calls `deliver` once.
-   */
-  stream(
-    surface: ChannelMessageSurface,
-    chunks: ChannelChunkSource,
-    options?: ChannelStreamOptions
-  ): Promise<DeliveryResult>;
-  /** Request approval through the Channel or composite named by the surface. */
-  requestApproval(
-    surface: ChannelMessageSurface,
-    options: ChannelApprovalRequestOptions
-  ): Promise<DeliveryResult>;
-  /** Return the identity's configured Channel destination, when supported. */
-  contactSurface(identity: ChannelIdentity): ChannelMessageSurface | null;
-  /** Resolve whether a surface can currently be selected without delivery. */
-  isAvailable(surface: ChannelMessageSurface): Promise<boolean>;
-}
-//#endregion
-export {
-  ChannelRouteEvent as a,
-  ChannelMessageEvent as i,
-  ChannelHost as n,
-  ChannelHostOptions as r,
-  ChannelApprovalResponseEvent as t
-};
-//# sourceMappingURL=index-BB0kqhIz.d.ts.map

package/dist/ingress-BfetZbMO.js

@@ -1,83 +0,0 @@
-import { t as TextSegmentJoiner } from "./text-segment-joiner-BtAFQSA_.js";
-//#region src/channels/stream.ts
-/**
-* Read a stream to completion, then finalize exactly once.
-*
-* `onFinish` runs whether the stream closed normally, errored because the
-* generation failed, or stopped because `onChunk` threw. A Channel that
-* finalizes here cannot lose a terminal provider call to an early ending.
-*/
-async function consumeChunks(chunks, consumer) {
-	const reader = chunks.getReader();
-	let outcome = { interrupted: false };
-	let cancellation;
-	try {
-		while (true) {
-			const { done, value } = await reader.read();
-			if (done) break;
-			await consumer.onChunk(value);
-		}
-	} catch (error) {
-		outcome = {
-			interrupted: true,
-			error
-		};
-		cancellation = reader.cancel().catch(() => {});
-	} finally {
-		reader.releaseLock();
-	}
-	try {
-		return await consumer.onFinish(outcome);
-	} finally {
-		await cancellation;
-	}
-}
-/**
-* Collect every `text` chunk into one Markdown answer.
-*
-* The result reports interruption instead of throwing, because a Channel that
-* has partial text still has to decide what to deliver.
-*/
-function collectText(chunks) {
-	let text = "";
-	const joiner = new TextSegmentJoiner();
-	return consumeChunks(chunks, {
-		onChunk(chunk) {
-			for (const event of joiner.pushChunk(chunk.type === "text" ? {
-				type: "text-delta",
-				text: chunk.text
-			} : { type: chunk.type })) if (event.type === "text") text += event.text;
-		},
-		onFinish: (outcome) => ({
-			text,
-			interrupted: outcome.interrupted
-		})
-	});
-}
-/**
-* Pace repeated provider calls without dropping anything.
-*
-* A Channel accumulates into its own buffer and asks whether enough time has
-* passed to flush. Keeping the buffer in the Channel means an interrupted
-* stream leaves its tail in hand, ready for the terminal provider call, rather
-* than stranded inside a transform.
-*/
-function createPacer(intervalMs) {
-	let lastFlushAt = Number.NEGATIVE_INFINITY;
-	return () => {
-		const now = Date.now();
-		if (now - lastFlushAt < intervalMs) return false;
-		lastFlushAt = now;
-		return true;
-	};
-}
-//#endregion
-//#region src/channels/ingress.ts
-/** Match an HTTP request to one exact URL pathname. */
-function matchesPath(request, path) {
-	return new URL(request.url).pathname === path;
-}
-//#endregion
-export { createPacer as i, collectText as n, consumeChunks as r, matchesPath as t };
-
-//# sourceMappingURL=ingress-BfetZbMO.js.map

package/dist/ingress-BfetZbMO.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ingress-BfetZbMO.js","names":[],"sources":["../src/channels/stream.ts","../src/channels/ingress.ts"],"sourcesContent":["import { TextSegmentJoiner } from \"../chat/text-segment-joiner\";\nimport type { Awaitable, ChannelChunk } from \"./channel\";\n\n/** Why a consumption loop stopped reading. */\nexport type StreamOutcome =\n  | { interrupted: false }\n  | { interrupted: true; error: unknown };\n\nexport type ChunkConsumer<TChunk, TResult> = {\n  onChunk(chunk: TChunk): Awaitable<void>;\n  /** Runs exactly once, whether the stream closed or ended abnormally. */\n  onFinish(outcome: StreamOutcome): Awaitable<TResult>;\n};\n\n/** The complete text of a stream, and whether it ended before its answer did. */\nexport type CollectedText = {\n  text: string;\n  interrupted: boolean;\n};\n\n/**\n * Read a stream to completion, then finalize exactly once.\n *\n * `onFinish` runs whether the stream closed normally, errored because the\n * generation failed, or stopped because `onChunk` threw. A Channel that\n * finalizes here cannot lose a terminal provider call to an early ending.\n */\nexport async function consumeChunks<TChunk, TResult>(\n  chunks: ReadableStream<TChunk>,\n  consumer: ChunkConsumer<TChunk, TResult>\n): Promise<TResult> {\n  const reader = chunks.getReader();\n  let outcome: StreamOutcome = { interrupted: false };\n  let cancellation: Promise<void> | undefined;\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) break;\n      await consumer.onChunk(value);\n    }\n  } catch (error) {\n    outcome = { interrupted: true, error };\n    // Start cancellation before finalizing, but do not block the terminal\n    // provider call on sibling tee branches. Await cleanup only afterward.\n    cancellation = reader.cancel().catch(() => {});\n  } finally {\n    reader.releaseLock();\n  }\n  try {\n    return await consumer.onFinish(outcome);\n  } finally {\n    await cancellation;\n  }\n}\n\n/**\n * Collect every `text` chunk into one Markdown answer.\n *\n * The result reports interruption instead of throwing, because a Channel that\n * has partial text still has to decide what to deliver.\n */\nexport function collectText(\n  chunks: ReadableStream<ChannelChunk>\n): Promise<CollectedText> {\n  let text = \"\";\n  const joiner = new TextSegmentJoiner();\n  return consumeChunks(chunks, {\n    onChunk(chunk) {\n      for (const event of joiner.pushChunk(\n        chunk.type === \"text\"\n          ? { type: \"text-delta\", text: chunk.text }\n          : { type: chunk.type }\n      )) {\n        if (event.type === \"text\") text += event.text;\n      }\n    },\n    onFinish: (outcome) => ({ text, interrupted: outcome.interrupted })\n  });\n}\n\n/**\n * Pace repeated provider calls without dropping anything.\n *\n * A Channel accumulates into its own buffer and asks whether enough time has\n * passed to flush. Keeping the buffer in the Channel means an interrupted\n * stream leaves its tail in hand, ready for the terminal provider call, rather\n * than stranded inside a transform.\n */\nexport function createPacer(intervalMs: number): () => boolean {\n  let lastFlushAt = Number.NEGATIVE_INFINITY;\n  return () => {\n    const now = Date.now();\n    if (now - lastFlushAt < intervalMs) return false;\n    lastFlushAt = now;\n    return true;\n  };\n}\n","import type { ChannelIdentity, ChannelIdentityInput } from \"./identity\";\nimport type {\n  ChannelMessageSurface,\n  ChannelMessageSurfaceInput\n} from \"./surface\";\n\n/** Serializable provider attachment facts available after ingress returns. */\nexport type ChannelAttachment = {\n  id?: string;\n  mediaType?: string;\n  name?: string;\n  size?: number;\n  text?: string;\n  url?: string;\n};\n\nexport type ChannelActor = {\n  readonly id: string;\n  /** Stable Channel identity suitable for explicit application linking. */\n  readonly identity?: ChannelIdentity;\n  readonly username?: string;\n  readonly fullName?: string;\n  readonly isBot?: boolean | \"unknown\";\n  readonly isSelf?: boolean;\n};\n\n/** An actor before the Host stamps its configured Channel key. */\nexport type ChannelActorInput = Omit<ChannelActor, \"identity\"> & {\n  readonly identity?: ChannelIdentityInput;\n};\n\nexport type ChannelEventContext = {\n  /** Immutable Channel-scoped identity, independent of application routing. */\n  readonly eventId: string;\n  readonly thread: {\n    readonly id: string;\n    readonly isDirectMessage: boolean | \"unknown\";\n  };\n  /** Exact provider destination for responding to this inbound event. */\n  readonly replySurface?: ChannelMessageSurface;\n  readonly actor?: ChannelActor;\n};\n\n/** A normalized inbound message from a Channel adapter. */\nexport type ChannelInboundMessage = ChannelEventContext & {\n  readonly type: \"message\";\n  readonly message: {\n    readonly id: string;\n    readonly text: string;\n    readonly title?: string;\n    readonly markdown?: string;\n    readonly attachments?: readonly ChannelAttachment[];\n    readonly isMention?: boolean;\n    readonly reply?: {\n      readonly id: string;\n      readonly text?: string;\n    };\n    readonly metadata?: {\n      /** ISO 8601 timestamp supplied by the provider. */\n      readonly sentAt?: string;\n      readonly edited?: boolean;\n      /** ISO 8601 timestamp supplied by the provider. */\n      readonly editedAt?: string;\n      readonly autoReply?: boolean;\n    };\n  };\n};\n\n/** A provider-normalized response to an external approval request. */\nexport type ChannelApprovalResponse = ChannelEventContext & {\n  readonly type: \"approval-response\";\n  readonly interactionId: string;\n  readonly decision: \"approve\" | \"reject\";\n  /** Provider reference for this inbound response. */\n  readonly reference: string;\n};\n\nexport type ChannelIngressEvent =\n  | ChannelInboundMessage\n  | ChannelApprovalResponse;\n\n/** A normalized message before the Host stamps its configured Channel key. */\nexport type ChannelEventContextInput = Omit<\n  ChannelEventContext,\n  \"replySurface\" | \"actor\"\n> & {\n  readonly replySurface?: ChannelMessageSurfaceInput;\n  readonly actor?: ChannelActorInput;\n};\n\nexport type ChannelInboundMessageInput = Omit<\n  ChannelInboundMessage,\n  \"replySurface\" | \"actor\"\n> & {\n  readonly replySurface?: ChannelMessageSurfaceInput;\n  readonly actor?: ChannelActorInput;\n};\n\n/** A normalized approval before the Host stamps its configured Channel key. */\nexport type ChannelApprovalResponseInput = Omit<\n  ChannelApprovalResponse,\n  \"replySurface\" | \"actor\"\n> & {\n  readonly replySurface?: ChannelMessageSurfaceInput;\n  readonly actor?: ChannelActorInput;\n};\n\n/** Authenticated event produced by a Channel before Host dispatch. */\nexport type ChannelIngressEventInput =\n  | ChannelInboundMessageInput\n  | ChannelApprovalResponseInput;\n\n/** Authenticated adapter output retained only until Host routing completes. */\nexport type ChannelIngressEnvelope<TRaw = unknown> = {\n  event: ChannelIngressEventInput;\n  raw: TRaw;\n};\n\n/** The normalized envelopes and provider acknowledgement produced by ingress. */\nexport type ChannelIngressResult<TRaw = unknown> = {\n  events: readonly ChannelIngressEnvelope<TRaw>[];\n  response: Response;\n};\n\n/** Match an HTTP request to one exact URL pathname. */\nexport function matchesPath(request: Request, path: string): boolean {\n  return new URL(request.url).pathname === path;\n}\n\n/** Webhook-shaped inbound support owned by a Channel. */\nexport interface ChannelIngress<TRaw = unknown> {\n  /** Return null when this Channel does not own the request. */\n  receive(request: Request): Promise<ChannelIngressResult<TRaw> | null>;\n}\n\n/** Structural input supported by Workers Email and Agent email handlers. */\nexport type ChannelEmailInput = {\n  from: string;\n  to: string;\n  headers: Headers;\n  raw?: ReadableStream<Uint8Array>;\n  getRaw?: () => Promise<Uint8Array>;\n};\n\nexport type ChannelEmailIngressResult<TRaw = unknown> = {\n  events: readonly ChannelIngressEnvelope<TRaw>[];\n};\n\n/** Non-HTTP ingress for a Workers Email event. */\nexport interface ChannelEmailIngress<TRaw = unknown> {\n  /** Return null when this Channel does not own the email. */\n  receive(\n    email: ChannelEmailInput\n  ): Promise<ChannelEmailIngressResult<TRaw> | null>;\n}\n"],"mappings":";;;;;;;;;AA2BA,eAAsB,cACpB,QACA,UACkB;CAClB,MAAM,SAAS,OAAO,UAAU;CAChC,IAAI,UAAyB,EAAE,aAAa,MAAM;CAClD,IAAI;CACJ,IAAI;EACF,OAAO,MAAM;GACX,MAAM,EAAE,MAAM,UAAU,MAAM,OAAO,KAAK;GAC1C,IAAI,MAAM;GACV,MAAM,SAAS,QAAQ,KAAK;EAC9B;CACF,SAAS,OAAO;EACd,UAAU;GAAE,aAAa;GAAM;EAAM;EAGrC,eAAe,OAAO,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC;CAC/C,UAAU;EACR,OAAO,YAAY;CACrB;CACA,IAAI;EACF,OAAO,MAAM,SAAS,SAAS,OAAO;CACxC,UAAU;EACR,MAAM;CACR;AACF;;;;;;;AAQA,SAAgB,YACd,QACwB;CACxB,IAAI,OAAO;CACX,MAAM,SAAS,IAAI,kBAAkB;CACrC,OAAO,cAAc,QAAQ;EAC3B,QAAQ,OAAO;GACb,KAAK,MAAM,SAAS,OAAO,UACzB,MAAM,SAAS,SACX;IAAE,MAAM;IAAc,MAAM,MAAM;GAAK,IACvC,EAAE,MAAM,MAAM,KAAK,CACzB,GACE,IAAI,MAAM,SAAS,QAAQ,QAAQ,MAAM;EAE7C;EACA,WAAW,aAAa;GAAE;GAAM,aAAa,QAAQ;EAAY;CACnE,CAAC;AACH;;;;;;;;;AAUA,SAAgB,YAAY,YAAmC;CAC7D,IAAI,cAAc,OAAO;CACzB,aAAa;EACX,MAAM,MAAM,KAAK,IAAI;EACrB,IAAI,MAAM,cAAc,YAAY,OAAO;EAC3C,cAAc;EACd,OAAO;CACT;AACF;;;;AC6BA,SAAgB,YAAY,SAAkB,MAAuB;CACnE,OAAO,IAAI,IAAI,QAAQ,GAAG,CAAC,CAAC,aAAa;AAC3C"}

package/dist/internal-CYlgHl1l.js

@@ -1,59 +0,0 @@
-import { t as isChannelMessageSurface } from "./surface-bZZJqBka.js";
-//#region src/channels/internal.ts
-const textEncoder = new TextEncoder();
-function encodeUtf8(value) {
-	return textEncoder.encode(value);
-}
-function utf8ByteLength(value) {
-	return encodeUtf8(value).byteLength;
-}
-function isRecord(value) {
-	return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-function defaultText(message) {
-	return message.title ? `${message.title}\n\n${message.markdown}` : message.markdown;
-}
-function renderInput(input) {
-	if (typeof input === "string") return input;
-	try {
-		return JSON.stringify(input, null, 2) ?? String(input);
-	} catch {
-		return String(input);
-	}
-}
-function uncertain(code, message, reference) {
-	return {
-		status: "uncertain",
-		...reference !== void 0 && { reference },
-		error: {
-			code,
-			message
-		}
-	};
-}
-function emptyIngressResponse(status = 200) {
-	return {
-		events: [],
-		response: new Response(null, { status })
-	};
-}
-function compositeDestinations(surface) {
-	if (surface.address === null || typeof surface.address !== "object" || Array.isArray(surface.address)) return;
-	const destinations = surface.address.surfaces;
-	if (!Array.isArray(destinations) || destinations.length === 0 || !destinations.every(isChannelMessageSurface)) return;
-	return destinations;
-}
-function unsupported(code, message) {
-	return {
-		status: "failed",
-		retryable: false,
-		error: {
-			code,
-			message
-		}
-	};
-}
-//#endregion
-export { isRecord as a, unsupported as c, encodeUtf8 as i, utf8ByteLength as l, defaultText as n, renderInput as o, emptyIngressResponse as r, uncertain as s, compositeDestinations as t };
-
-//# sourceMappingURL=internal-CYlgHl1l.js.map

package/dist/internal-CYlgHl1l.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"internal-CYlgHl1l.js","names":[],"sources":["../src/channels/internal.ts"],"sourcesContent":["import type { ChannelMessage, DeliveryResult } from \"./channel\";\nimport type { ChannelIngressResult } from \"./ingress\";\nimport { isChannelMessageSurface, type ChannelMessageSurface } from \"./surface\";\n\nconst textEncoder = new TextEncoder();\n\nexport function encodeUtf8(value: string): Uint8Array<ArrayBuffer> {\n  return textEncoder.encode(value);\n}\n\nexport function utf8ByteLength(value: string): number {\n  return encodeUtf8(value).byteLength;\n}\n\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n\nexport function defaultText(message: ChannelMessage): string {\n  return message.title\n    ? `${message.title}\\n\\n${message.markdown}`\n    : message.markdown;\n}\n\nexport function renderInput(input: unknown): string {\n  if (typeof input === \"string\") return input;\n  try {\n    return JSON.stringify(input, null, 2) ?? String(input);\n  } catch {\n    return String(input);\n  }\n}\n\nexport function uncertain(\n  code: string,\n  message: string,\n  reference?: string\n): Extract<DeliveryResult, { status: \"uncertain\" }> {\n  return {\n    status: \"uncertain\",\n    ...(reference !== undefined && { reference }),\n    error: { code, message }\n  };\n}\n\nexport function emptyIngressResponse<TRaw>(\n  status = 200\n): ChannelIngressResult<TRaw> {\n  return { events: [], response: new Response(null, { status }) };\n}\n\nexport function compositeDestinations(\n  surface: ChannelMessageSurface\n): readonly ChannelMessageSurface[] | undefined {\n  if (\n    surface.address === null ||\n    typeof surface.address !== \"object\" ||\n    Array.isArray(surface.address)\n  ) {\n    return undefined;\n  }\n  const destinations = (surface.address as Record<string, unknown>).surfaces;\n  if (\n    !Array.isArray(destinations) ||\n    destinations.length === 0 ||\n    !destinations.every(isChannelMessageSurface)\n  ) {\n    return undefined;\n  }\n  return destinations;\n}\n\nexport function unsupported(\n  code: string,\n  message: string\n): Extract<DeliveryResult, { status: \"failed\" }> {\n  return {\n    status: \"failed\",\n    retryable: false,\n    error: { code, message }\n  };\n}\n"],"mappings":";;AAIA,MAAM,cAAc,IAAI,YAAY;AAEpC,SAAgB,WAAW,OAAwC;CACjE,OAAO,YAAY,OAAO,KAAK;AACjC;AAEA,SAAgB,eAAe,OAAuB;CACpD,OAAO,WAAW,KAAK,CAAC,CAAC;AAC3B;AAEA,SAAgB,SAAS,OAAkD;CACzE,OAAO,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAEA,SAAgB,YAAY,SAAiC;CAC3D,OAAO,QAAQ,QACX,GAAG,QAAQ,MAAM,MAAM,QAAQ,aAC/B,QAAQ;AACd;AAEA,SAAgB,YAAY,OAAwB;CAClD,IAAI,OAAO,UAAU,UAAU,OAAO;CACtC,IAAI;EACF,OAAO,KAAK,UAAU,OAAO,MAAM,CAAC,KAAK,OAAO,KAAK;CACvD,QAAQ;EACN,OAAO,OAAO,KAAK;CACrB;AACF;AAEA,SAAgB,UACd,MACA,SACA,WACkD;CAClD,OAAO;EACL,QAAQ;EACR,GAAI,cAAc,KAAA,KAAa,EAAE,UAAU;EAC3C,OAAO;GAAE;GAAM;EAAQ;CACzB;AACF;AAEA,SAAgB,qBACd,SAAS,KACmB;CAC5B,OAAO;EAAE,QAAQ,CAAC;EAAG,UAAU,IAAI,SAAS,MAAM,EAAE,OAAO,CAAC;CAAE;AAChE;AAEA,SAAgB,sBACd,SAC8C;CAC9C,IACE,QAAQ,YAAY,QACpB,OAAO,QAAQ,YAAY,YAC3B,MAAM,QAAQ,QAAQ,OAAO,GAE7B;CAEF,MAAM,eAAgB,QAAQ,QAAoC;CAClE,IACE,CAAC,MAAM,QAAQ,YAAY,KAC3B,aAAa,WAAW,KACxB,CAAC,aAAa,MAAM,uBAAuB,GAE3C;CAEF,OAAO;AACT;AAEA,SAAgB,YACd,MACA,SAC+C;CAC/C,OAAO;EACL,QAAQ;EACR,WAAW;EACX,OAAO;GAAE;GAAM;EAAQ;CACzB;AACF"}