@murphai/gateway-core 0.1.1

package/dist/contracts.js

@@ -0,0 +1,231 @@
+import { z } from 'incur';
+import { isoTimestampSchema } from './shared.js';
+export const gatewayConversationDirectnessValues = [
+    'direct',
+    'group',
+    'unknown',
+];
+export const gatewayMessageDirectionValues = [
+    'inbound',
+    'outbound',
+    'system',
+];
+export const gatewayReplyRouteKindValues = ['participant', 'thread'];
+export const gatewayDeliveryTargetKindValues = [
+    'explicit',
+    'participant',
+    'thread',
+];
+export const gatewayEventKindValues = [
+    'message.created',
+    'conversation.updated',
+    'permission.requested',
+    'permission.resolved',
+];
+export const gatewayPermissionStatusValues = [
+    'open',
+    'approved',
+    'denied',
+    'expired',
+];
+export const gatewayPermissionDecisionValues = ['approve', 'deny'];
+export const gatewayConversationTitleSourceValues = [
+    'alias',
+    'thread-title',
+    'participant-display-name',
+    'participant-id',
+    'thread-id',
+    'channel',
+];
+const gatewayOptionalStringSchema = z.string().min(1).nullable().default(null);
+export const gatewayReplyRouteSchema = z
+    .object({
+    kind: z.enum(gatewayReplyRouteKindValues).nullable().default(null),
+    target: gatewayOptionalStringSchema,
+})
+    .strict();
+export const gatewayConversationRouteSchema = z
+    .object({
+    channel: gatewayOptionalStringSchema,
+    identityId: gatewayOptionalStringSchema,
+    participantId: gatewayOptionalStringSchema,
+    threadId: gatewayOptionalStringSchema,
+    directness: z.enum(gatewayConversationDirectnessValues).nullable().default(null),
+    reply: gatewayReplyRouteSchema.default({
+        kind: null,
+        target: null,
+    }),
+})
+    .strict();
+export const gatewayConversationSchema = z
+    .object({
+    schema: z.literal('murph.gateway-conversation.v1'),
+    sessionKey: z.string().min(1),
+    title: gatewayOptionalStringSchema,
+    titleSource: z.enum(gatewayConversationTitleSourceValues).nullable().default(null),
+    lastMessagePreview: gatewayOptionalStringSchema,
+    lastActivityAt: isoTimestampSchema.nullable().default(null),
+    messageCount: z.number().int().nonnegative().nullable().default(null),
+    canSend: z.boolean().default(false),
+    route: gatewayConversationRouteSchema,
+})
+    .strict();
+export const gatewayAttachmentSchema = z
+    .object({
+    schema: z.literal('murph.gateway-attachment.v1'),
+    attachmentId: z.string().min(1),
+    messageId: z.string().min(1),
+    kind: z.enum(['image', 'audio', 'video', 'document', 'other']),
+    mime: gatewayOptionalStringSchema,
+    fileName: gatewayOptionalStringSchema,
+    byteSize: z.number().int().nonnegative().nullable().default(null),
+    parseState: gatewayOptionalStringSchema,
+    extractedText: z.string().nullable().default(null),
+    transcriptText: z.string().nullable().default(null),
+})
+    .strict();
+export const gatewayMessageSchema = z
+    .object({
+    schema: z.literal('murph.gateway-message.v1'),
+    messageId: z.string().min(1),
+    sessionKey: z.string().min(1),
+    direction: z.enum(gatewayMessageDirectionValues),
+    createdAt: isoTimestampSchema,
+    actorDisplayName: gatewayOptionalStringSchema,
+    text: z.string().nullable().default(null),
+    attachments: z.array(gatewayAttachmentSchema).default([]),
+})
+    .strict();
+export const gatewayEventSchema = z
+    .object({
+    schema: z.literal('murph.gateway-event.v1'),
+    cursor: z.number().int().nonnegative(),
+    kind: z.enum(gatewayEventKindValues),
+    createdAt: isoTimestampSchema,
+    sessionKey: gatewayOptionalStringSchema,
+    messageId: gatewayOptionalStringSchema,
+    permissionRequestId: gatewayOptionalStringSchema,
+    summary: gatewayOptionalStringSchema,
+})
+    .strict();
+export const gatewayPermissionRequestSchema = z
+    .object({
+    schema: z.literal('murph.gateway-permission-request.v1'),
+    requestId: z.string().min(1),
+    sessionKey: gatewayOptionalStringSchema,
+    action: z.string().min(1),
+    description: gatewayOptionalStringSchema,
+    status: z.enum(gatewayPermissionStatusValues),
+    requestedAt: isoTimestampSchema,
+    resolvedAt: isoTimestampSchema.nullable().default(null),
+    note: gatewayOptionalStringSchema,
+})
+    .strict();
+export const gatewayProjectionSnapshotSchema = z
+    .object({
+    schema: z.literal('murph.gateway-projection-snapshot.v1'),
+    generatedAt: isoTimestampSchema,
+    conversations: z.array(gatewayConversationSchema).default([]),
+    messages: z.array(gatewayMessageSchema).default([]),
+    permissions: z.array(gatewayPermissionRequestSchema).default([]),
+})
+    .strict();
+export const gatewayListConversationsInputSchema = z
+    .object({
+    channel: gatewayOptionalStringSchema,
+    includeDerivedTitles: z.boolean().optional().default(true),
+    includeLastMessage: z.boolean().optional().default(true),
+    limit: z.number().int().positive().max(200).optional().default(50),
+    search: gatewayOptionalStringSchema,
+})
+    .strict();
+export const gatewayListConversationsResultSchema = z
+    .object({
+    conversations: z.array(gatewayConversationSchema).default([]),
+    nextCursor: gatewayOptionalStringSchema,
+})
+    .strict();
+export const gatewayGetConversationInputSchema = z
+    .object({
+    sessionKey: z.string().min(1),
+})
+    .strict();
+export const gatewayReadMessagesInputSchema = z
+    .object({
+    afterMessageId: gatewayOptionalStringSchema,
+    limit: z.number().int().positive().max(500).optional().default(100),
+    oldestFirst: z.boolean().optional().default(false),
+    sessionKey: z.string().min(1),
+})
+    .strict();
+export const gatewayReadMessagesResultSchema = z
+    .object({
+    messages: z.array(gatewayMessageSchema).default([]),
+    nextCursor: gatewayOptionalStringSchema,
+})
+    .strict();
+export const gatewayFetchAttachmentsInputSchema = z
+    .object({
+    attachmentIds: z.array(z.string().min(1)).optional().default([]),
+    messageId: gatewayOptionalStringSchema,
+    sessionKey: gatewayOptionalStringSchema,
+})
+    .strict();
+export const gatewayPollEventsInputSchema = z
+    .object({
+    cursor: z.number().int().nonnegative().optional().default(0),
+    kinds: z.array(z.enum(gatewayEventKindValues)).optional().default([]),
+    limit: z.number().int().positive().max(200).optional().default(50),
+    sessionKey: gatewayOptionalStringSchema,
+})
+    .strict();
+export const gatewayPollEventsResultSchema = z
+    .object({
+    events: z.array(gatewayEventSchema).default([]),
+    nextCursor: z.number().int().nonnegative(),
+    live: z.boolean().default(true),
+})
+    .strict();
+export const gatewayWaitForEventsInputSchema = gatewayPollEventsInputSchema.extend({
+    timeoutMs: z.number().int().positive().max(120_000).optional().default(30_000),
+});
+export const gatewaySendMessageInputSchema = z
+    .object({
+    clientRequestId: gatewayOptionalStringSchema,
+    replyToMessageId: gatewayOptionalStringSchema,
+    sessionKey: z.string().min(1),
+    text: z.string().min(1),
+})
+    .strict();
+export const gatewaySendMessageResultSchema = z
+    .object({
+    sessionKey: z.string().min(1),
+    messageId: gatewayOptionalStringSchema,
+    queued: z.boolean().default(false),
+    delivery: z
+        .object({
+        channel: z.string().min(1),
+        idempotencyKey: gatewayOptionalStringSchema,
+        target: z.string().min(1),
+        targetKind: z.enum(gatewayDeliveryTargetKindValues),
+        sentAt: isoTimestampSchema,
+        messageLength: z.number().int().nonnegative(),
+    })
+        .strict()
+        .nullable()
+        .default(null),
+})
+    .strict();
+export const gatewayListOpenPermissionsInputSchema = z
+    .object({
+    sessionKey: gatewayOptionalStringSchema,
+})
+    .strict();
+export const gatewayRespondToPermissionInputSchema = z
+    .object({
+    decision: z.enum(gatewayPermissionDecisionValues),
+    note: gatewayOptionalStringSchema,
+    requestId: z.string().min(1),
+})
+    .strict();
+//# sourceMappingURL=contracts.js.map

package/dist/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,13 @@
+export declare const INVALID_GATEWAY_RUNTIME_ID_CODE = "ASSISTANT_INVALID_RUNTIME_ID";
+export declare const GATEWAY_UNSUPPORTED_OPERATION_CODE = "ASSISTANT_GATEWAY_UNSUPPORTED_OPERATION";
+export declare const GATEWAY_SESSION_NOT_FOUND_CODE = "ASSISTANT_GATEWAY_SESSION_NOT_FOUND";
+export declare function createGatewayInvalidRuntimeIdError(message: string): Error & {
+    code: string;
+};
+export declare function createGatewayUnsupportedOperationError(message: string): Error & {
+    code: string;
+};
+export declare function createGatewaySessionNotFoundError(message: string): Error & {
+    code: string;
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,+BAA+B,iCAAiC,CAAA;AAC7E,eAAO,MAAM,kCAAkC,4CAA4C,CAAA;AAC3F,eAAO,MAAM,8BAA8B,wCAAwC,CAAA;AAEnF,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,MAAM,GACd,KAAK,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAI1B;AAED,wBAAgB,sCAAsC,CACpD,OAAO,EAAE,MAAM,GACd,KAAK,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAI1B;AAED,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,MAAM,GACd,KAAK,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAI1B"}

package/dist/errors.js

@@ -0,0 +1,19 @@
+export const INVALID_GATEWAY_RUNTIME_ID_CODE = 'ASSISTANT_INVALID_RUNTIME_ID';
+export const GATEWAY_UNSUPPORTED_OPERATION_CODE = 'ASSISTANT_GATEWAY_UNSUPPORTED_OPERATION';
+export const GATEWAY_SESSION_NOT_FOUND_CODE = 'ASSISTANT_GATEWAY_SESSION_NOT_FOUND';
+export function createGatewayInvalidRuntimeIdError(message) {
+    const error = new Error(message);
+    error.code = INVALID_GATEWAY_RUNTIME_ID_CODE;
+    return error;
+}
+export function createGatewayUnsupportedOperationError(message) {
+    const error = new Error(message);
+    error.code = GATEWAY_UNSUPPORTED_OPERATION_CODE;
+    return error;
+}
+export function createGatewaySessionNotFoundError(message) {
+    const error = new Error(message);
+    error.code = GATEWAY_SESSION_NOT_FOUND_CODE;
+    return error;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,+BAA+B,GAAG,8BAA8B,CAAA;AAC7E,MAAM,CAAC,MAAM,kCAAkC,GAAG,yCAAyC,CAAA;AAC3F,MAAM,CAAC,MAAM,8BAA8B,GAAG,qCAAqC,CAAA;AAEnF,MAAM,UAAU,kCAAkC,CAChD,OAAe;IAEf,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,CAA6B,CAAA;IAC5D,KAAK,CAAC,IAAI,GAAG,+BAA+B,CAAA;IAC5C,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,UAAU,sCAAsC,CACpD,OAAe;IAEf,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,CAA6B,CAAA;IAC5D,KAAK,CAAC,IAAI,GAAG,kCAAkC,CAAA;IAC/C,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,OAAe;IAEf,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,CAA6B,CAAA;IAC5D,KAAK,CAAC,IAAI,GAAG,8BAA8B,CAAA;IAC3C,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/event-log.d.ts

@@ -0,0 +1,8 @@
+import { type GatewayPollEventsInput, type GatewayPollEventsResult, type GatewayWaitForEventsInput } from './contracts.js';
+export { applyGatewayProjectionSnapshotToEventLog, DEFAULT_GATEWAY_EVENT_RETENTION, pollGatewayEventLogState, type GatewayEventEmission, type GatewayEventLogState, } from './snapshot.js';
+export declare const DEFAULT_GATEWAY_EVENT_POLL_INTERVAL_MS = 250;
+export declare function waitForGatewayEventsByPolling(poll: (input?: GatewayPollEventsInput) => Promise<GatewayPollEventsResult>, input?: GatewayWaitForEventsInput, options?: {
+    intervalMs?: number;
+    sleep?: (ms: number) => Promise<void>;
+}): Promise<GatewayPollEventsResult>;
+//# sourceMappingURL=event-log.d.ts.map

package/dist/event-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-log.d.ts","sourceRoot":"","sources":["../src/event-log.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC/B,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EACL,wCAAwC,EACxC,+BAA+B,EAC/B,wBAAwB,EACxB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,eAAe,CAAA;AAEtB,eAAO,MAAM,sCAAsC,MAAM,CAAA;AAEzD,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,sBAAsB,KAAK,OAAO,CAAC,uBAAuB,CAAC,EAC1E,KAAK,CAAC,EAAE,yBAAyB,EACjC,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACtC,GACA,OAAO,CAAC,uBAAuB,CAAC,CAiClC"}

package/dist/event-log.js

@@ -0,0 +1,35 @@
+import { gatewayWaitForEventsInputSchema, } from './contracts.js';
+export { applyGatewayProjectionSnapshotToEventLog, DEFAULT_GATEWAY_EVENT_RETENTION, pollGatewayEventLogState, } from './snapshot.js';
+export const DEFAULT_GATEWAY_EVENT_POLL_INTERVAL_MS = 250;
+export async function waitForGatewayEventsByPolling(poll, input, options) {
+    const parsed = gatewayWaitForEventsInputSchema.parse(input ?? {});
+    const intervalMs = Math.max(1, Math.trunc(options?.intervalMs ?? DEFAULT_GATEWAY_EVENT_POLL_INTERVAL_MS));
+    const sleeper = options?.sleep ?? defaultGatewayEventSleep;
+    let result = await poll({
+        cursor: parsed.cursor,
+        kinds: parsed.kinds,
+        limit: parsed.limit,
+        sessionKey: parsed.sessionKey,
+    });
+    if (result.events.length > 0) {
+        return result;
+    }
+    const deadline = Date.now() + parsed.timeoutMs;
+    while (Date.now() < deadline) {
+        await sleeper(Math.min(intervalMs, Math.max(1, deadline - Date.now())));
+        result = await poll({
+            cursor: parsed.cursor,
+            kinds: parsed.kinds,
+            limit: parsed.limit,
+            sessionKey: parsed.sessionKey,
+        });
+        if (result.events.length > 0) {
+            return result;
+        }
+    }
+    return result;
+}
+function defaultGatewayEventSleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=event-log.js.map

package/dist/event-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-log.js","sourceRoot":"","sources":["../src/event-log.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,GAIhC,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EACL,wCAAwC,EACxC,+BAA+B,EAC/B,wBAAwB,GAGzB,MAAM,eAAe,CAAA;AAEtB,MAAM,CAAC,MAAM,sCAAsC,GAAG,GAAG,CAAA;AAEzD,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,IAA0E,EAC1E,KAAiC,EACjC,OAGC;IAED,MAAM,MAAM,GAAG,+BAA+B,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAA;IACjE,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CACzB,CAAC,EACD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,IAAI,sCAAsC,CAAC,CAC1E,CAAA;IACD,MAAM,OAAO,GAAG,OAAO,EAAE,KAAK,IAAI,wBAAwB,CAAA;IAE1D,IAAI,MAAM,GAAG,MAAM,IAAI,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAC,CAAA;IACF,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAA;IACf,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,CAAA;IAC9C,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAA;QACvE,MAAM,GAAG,MAAM,IAAI,CAAC;YAClB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC,CAAA;QACF,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,OAAO,MAAM,CAAA;QACf,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED,SAAS,wBAAwB,CAAC,EAAU;IAC1C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;AAC1D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './contracts.js';
+export * from './routes.js';
+export * from './event-log.js';
+export * from './snapshot.js';
+export * from './opaque-ids.js';
+export * from './errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from './contracts.js';
+export * from './routes.js';
+export * from './event-log.js';
+export * from './snapshot.js';
+export * from './opaque-ids.js';
+export * from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA"}

package/dist/opaque-ids.d.ts

@@ -0,0 +1,33 @@
+interface GatewayOpaqueEnvelope {
+    kind: string;
+    routeToken?: string;
+    version: 2;
+}
+interface GatewayMessageEnvelope extends GatewayOpaqueEnvelope {
+    kind: 'capture-message' | 'outbox-message';
+    sourceToken?: string;
+}
+interface GatewayAttachmentEnvelope extends GatewayOpaqueEnvelope {
+    kind: 'attachment';
+    sourceToken?: string;
+}
+/**
+ * Gateway ids behave like opaque transport identifiers and only accept the current
+ * route-token envelope shape.
+ */
+export declare function createGatewayConversationSessionKey(routeKeyOrToken: string): string;
+export declare function readGatewayConversationSessionToken(sessionKey: string): string;
+export declare function assertGatewayConversationSessionKey(sessionKey: string): string;
+export declare function sameGatewayConversationSession(leftSessionKey: string, rightSessionKey: string): boolean;
+export declare function createGatewayCaptureMessageId(routeKeyOrToken: string, captureId: string): string;
+export declare function createGatewayOutboxMessageId(routeKeyOrToken: string, intentId: string): string;
+export declare function readGatewayMessageRouteToken(messageId: string): string;
+export declare function readGatewayMessageKind(messageId: string): GatewayMessageEnvelope['kind'];
+export declare function assertGatewayMessageId(messageId: string): string;
+export declare function createGatewayAttachmentId(routeKeyOrToken: string, captureId: string, attachmentId: string): string;
+export declare function readGatewayAttachmentId(attachmentId: string): GatewayAttachmentEnvelope & {
+    routeToken: string;
+};
+export declare function assertGatewayAttachmentId(attachmentId: string): string;
+export {};
+//# sourceMappingURL=opaque-ids.d.ts.map

package/dist/opaque-ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opaque-ids.d.ts","sourceRoot":"","sources":["../src/opaque-ids.ts"],"names":[],"mappings":"AAEA,UAAU,qBAAqB;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,CAAC,CAAA;CACX;AAMD,UAAU,sBAAuB,SAAQ,qBAAqB;IAC5D,IAAI,EAAE,iBAAiB,GAAG,gBAAgB,CAAA;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,UAAU,yBAA0B,SAAQ,qBAAqB;IAC/D,IAAI,EAAE,YAAY,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAMD;;;GAGG;AACH,wBAAgB,mCAAmC,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAOnF;AAED,wBAAgB,mCAAmC,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,wBAAgB,mCAAmC,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAG9E;AAED,wBAAgB,8BAA8B,CAC5C,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,GACtB,OAAO,CAST;AAED,wBAAgB,6BAA6B,CAC3C,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,GAChB,MAAM,CAQR;AAED,wBAAgB,4BAA4B,CAC1C,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,GACf,MAAM,CAQR;AAED,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,GAChB,sBAAsB,CAAC,MAAM,CAAC,CAEhC;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGhE;AAED,wBAAgB,yBAAyB,CACvC,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,MAAM,CAQR;AAED,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,GACnB,yBAAyB,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAQpD;AAED,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAGtE"}

package/dist/opaque-ids.js

@@ -0,0 +1,168 @@
+import { createHash } from 'node:crypto';
+const GATEWAY_CONVERSATION_PREFIX = 'gwcs_';
+const GATEWAY_MESSAGE_PREFIX = 'gwcm_';
+const GATEWAY_ATTACHMENT_PREFIX = 'gwca_';
+/**
+ * Gateway ids behave like opaque transport identifiers and only accept the current
+ * route-token envelope shape.
+ */
+export function createGatewayConversationSessionKey(routeKeyOrToken) {
+    const envelope = {
+        kind: 'conversation',
+        routeToken: normalizeGatewayRouteToken(routeKeyOrToken),
+        version: 2,
+    };
+    return encodeGatewayOpaqueId(GATEWAY_CONVERSATION_PREFIX, envelope);
+}
+export function readGatewayConversationSessionToken(sessionKey) {
+    return readGatewayConversationEnvelope(sessionKey).routeToken;
+}
+export function assertGatewayConversationSessionKey(sessionKey) {
+    readGatewayConversationEnvelope(sessionKey);
+    return sessionKey;
+}
+export function sameGatewayConversationSession(leftSessionKey, rightSessionKey) {
+    try {
+        return (readGatewayConversationSessionToken(leftSessionKey) ===
+            readGatewayConversationSessionToken(rightSessionKey));
+    }
+    catch {
+        return false;
+    }
+}
+export function createGatewayCaptureMessageId(routeKeyOrToken, captureId) {
+    const envelope = {
+        kind: 'capture-message',
+        routeToken: normalizeGatewayRouteToken(routeKeyOrToken),
+        sourceToken: createGatewaySourceToken('capture', captureId),
+        version: 2,
+    };
+    return encodeGatewayOpaqueId(GATEWAY_MESSAGE_PREFIX, envelope);
+}
+export function createGatewayOutboxMessageId(routeKeyOrToken, intentId) {
+    const envelope = {
+        kind: 'outbox-message',
+        routeToken: normalizeGatewayRouteToken(routeKeyOrToken),
+        sourceToken: createGatewaySourceToken('outbox', intentId),
+        version: 2,
+    };
+    return encodeGatewayOpaqueId(GATEWAY_MESSAGE_PREFIX, envelope);
+}
+export function readGatewayMessageRouteToken(messageId) {
+    return readGatewayMessageEnvelope(messageId).routeToken;
+}
+export function readGatewayMessageKind(messageId) {
+    return readGatewayMessageEnvelope(messageId).kind;
+}
+export function assertGatewayMessageId(messageId) {
+    readGatewayMessageEnvelope(messageId);
+    return messageId;
+}
+export function createGatewayAttachmentId(routeKeyOrToken, captureId, attachmentId) {
+    const envelope = {
+        kind: 'attachment',
+        routeToken: normalizeGatewayRouteToken(routeKeyOrToken),
+        sourceToken: createGatewaySourceToken('attachment', `${captureId}:${attachmentId}`),
+        version: 2,
+    };
+    return encodeGatewayOpaqueId(GATEWAY_ATTACHMENT_PREFIX, envelope);
+}
+export function readGatewayAttachmentId(attachmentId) {
+    const envelope = normalizeGatewayAttachmentEnvelope(decodeGatewayOpaqueId(attachmentId, GATEWAY_ATTACHMENT_PREFIX));
+    if (envelope.kind !== 'attachment') {
+        throw new Error('Gateway attachment id is invalid.');
+    }
+    return envelope;
+}
+export function assertGatewayAttachmentId(attachmentId) {
+    readGatewayAttachmentId(attachmentId);
+    return attachmentId;
+}
+function readGatewayConversationEnvelope(sessionKey) {
+    const envelope = normalizeGatewayOpaqueEnvelope(decodeGatewayOpaqueId(sessionKey, GATEWAY_CONVERSATION_PREFIX));
+    if (envelope.kind !== 'conversation') {
+        throw new Error('Gateway session key is invalid.');
+    }
+    return envelope;
+}
+function readGatewayMessageEnvelope(messageId) {
+    const envelope = normalizeGatewayOpaqueEnvelope(decodeGatewayOpaqueId(messageId, GATEWAY_MESSAGE_PREFIX));
+    if (envelope.kind !== 'capture-message' && envelope.kind !== 'outbox-message') {
+        throw new Error('Gateway message id is invalid.');
+    }
+    return envelope;
+}
+function encodeGatewayOpaqueId(prefix, envelope) {
+    return `${prefix}${Buffer.from(JSON.stringify(envelope), 'utf8').toString('base64url')}`;
+}
+function decodeGatewayOpaqueId(value, prefix) {
+    if (typeof value !== 'string' || !value.startsWith(prefix)) {
+        throw new Error('Gateway opaque id is invalid.');
+    }
+    const encoded = value.slice(prefix.length);
+    if (encoded.length === 0) {
+        throw new Error('Gateway opaque id is invalid.');
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(Buffer.from(encoded, 'base64url').toString('utf8'));
+    }
+    catch {
+        throw new Error('Gateway opaque id is invalid.');
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        throw new Error('Gateway opaque id is invalid.');
+    }
+    const envelope = parsed;
+    if (envelope.version !== 2) {
+        throw new Error('Gateway opaque id version is unsupported.');
+    }
+    if (typeof envelope.kind !== 'string' || envelope.kind.length === 0) {
+        throw new Error('Gateway opaque id was missing the kind field.');
+    }
+    return envelope;
+}
+function normalizeGatewayOpaqueEnvelope(envelope) {
+    return {
+        ...envelope,
+        routeToken: readGatewayRouteTokenField(envelope),
+    };
+}
+function normalizeGatewayAttachmentEnvelope(envelope) {
+    const normalized = normalizeGatewayOpaqueEnvelope(envelope);
+    if (typeof normalized.sourceToken !== 'string' || normalized.sourceToken.length === 0) {
+        throw new Error('Gateway attachment id was missing the attachment reference.');
+    }
+    return normalized;
+}
+function readGatewayRouteTokenField(envelope) {
+    if (typeof envelope.routeToken === 'string' && envelope.routeToken.length > 0) {
+        return envelope.routeToken;
+    }
+    throw new Error('Gateway opaque id was missing the route token.');
+}
+function normalizeGatewayRouteToken(routeKeyOrToken) {
+    if (typeof routeKeyOrToken !== 'string' || routeKeyOrToken.length === 0) {
+        throw new Error('Gateway route token input is invalid.');
+    }
+    return looksLikeGatewayRouteToken(routeKeyOrToken)
+        ? routeKeyOrToken
+        : createGatewayRouteToken(routeKeyOrToken);
+}
+function looksLikeGatewayRouteToken(value) {
+    return !value.includes(':') && !value.includes('|');
+}
+function createGatewayRouteToken(routeKey) {
+    return createGatewayOpaqueToken('route', routeKey);
+}
+function createGatewaySourceToken(scope, value) {
+    return createGatewayOpaqueToken(scope, value);
+}
+function createGatewayOpaqueToken(scope, value) {
+    return createHash('sha256')
+        .update(scope)
+        .update('\u0000')
+        .update(value)
+        .digest('base64url');
+}
+//# sourceMappingURL=opaque-ids.js.map

package/dist/opaque-ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opaque-ids.js","sourceRoot":"","sources":["../src/opaque-ids.ts"],"names":[],"mappings":"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"}

package/dist/routes.d.ts

@@ -0,0 +1,59 @@
+import { type GatewayConversationDirectness, type GatewayConversationRoute, type GatewayReplyRouteKind } from './contracts.js';
+export interface GatewayConversationRouteInput {
+    channel?: string | null;
+    directness?: GatewayConversationDirectness | null;
+    identityId?: string | null;
+    participantId?: string | null;
+    reply?: {
+        kind?: GatewayReplyRouteKind | null;
+        target?: string | null;
+    } | null;
+    threadId?: string | null;
+}
+export interface GatewayInboundCaptureRouteInput {
+    accountId?: string | null;
+    actor: {
+        id?: string | null;
+    };
+    source: string;
+    thread: {
+        id: string;
+        isDirect?: boolean | null;
+    };
+}
+interface GatewayBindingLike {
+    actorId?: string | null;
+    channel?: string | null;
+    delivery?: {
+        kind?: GatewayReplyRouteKind | null;
+        target?: string | null;
+    } | null;
+    identityId?: string | null;
+    threadId?: string | null;
+    threadIsDirect?: boolean | null;
+}
+interface GatewayOutboxIntentLike {
+    actorId?: string | null;
+    bindingDelivery?: {
+        kind?: GatewayReplyRouteKind | null;
+        target?: string | null;
+    } | null;
+    channel?: string | null;
+    identityId?: string | null;
+    threadId?: string | null;
+    threadIsDirect?: boolean | null;
+}
+export declare function normalizeGatewayConversationRoute(input: GatewayConversationRouteInput | null | undefined): GatewayConversationRoute;
+export declare function gatewayConversationRouteFromBinding(binding: GatewayBindingLike): GatewayConversationRoute;
+export declare function gatewayConversationRouteFromOutboxIntent(intent: GatewayOutboxIntentLike): GatewayConversationRoute;
+export declare function gatewayConversationRouteFromCapture(capture: GatewayInboundCaptureRouteInput): GatewayConversationRoute;
+export declare function mergeGatewayConversationRoutes(base: GatewayConversationRoute | null | undefined, patch: GatewayConversationRouteInput | null | undefined): GatewayConversationRoute;
+export declare function resolveGatewayConversationRouteKey(route: GatewayConversationRoute | null | undefined): string | null;
+export declare function gatewayConversationRouteCanSend(route: GatewayConversationRoute | null | undefined): boolean;
+export declare function gatewayChannelSupportsReplyToMessage(channel: string | null | undefined): boolean;
+export declare function gatewayBindingDeliveryFromRoute(route: GatewayConversationRoute | null | undefined): {
+    kind: GatewayReplyRouteKind;
+    target: string;
+} | null;
+export {};
+//# sourceMappingURL=routes.d.ts.map

package/dist/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"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"}