@turingfocus/chat-protocol 0.1.0

package/dist/models.d.ts

@@ -0,0 +1,319 @@
+import type { ReadonlyJsonValue } from "./raw.js";
+export type ConversationId = string;
+export type TimelineItemId = string;
+export type RunId = string;
+export interface Conversation {
+    readonly id: ConversationId;
+    readonly title: string;
+    readonly description?: string | undefined;
+    /** Unix epoch milliseconds. */
+    readonly updatedAt?: number | undefined;
+    readonly raw?: ReadonlyJsonValue | undefined;
+}
+export type MessageRole = "assistant" | "system" | "tool" | "unknown" | "user";
+export interface TextMessageContent {
+    readonly kind: "text";
+    readonly text: string;
+}
+export interface MediaMessageContent {
+    readonly kind: "media";
+    readonly mediaType: "audio" | "image" | "video";
+    readonly summary: string;
+    readonly raw?: ReadonlyJsonValue | undefined;
+}
+export interface FileMessageContent {
+    readonly kind: "file";
+    readonly summary: string;
+    readonly raw?: ReadonlyJsonValue | undefined;
+}
+export interface ContactMessageContent {
+    readonly kind: "contact";
+    readonly summary: string;
+    readonly raw?: ReadonlyJsonValue | undefined;
+}
+export interface UrlMessageContent {
+    readonly kind: "url";
+    readonly summary: string;
+    readonly raw?: ReadonlyJsonValue | undefined;
+}
+export interface UnknownMessageContent {
+    readonly kind: "unknown";
+    readonly summary: string;
+    readonly raw?: ReadonlyJsonValue | undefined;
+}
+/**
+ * One normalized received-message variant. Multipart and attachment resource
+ * contracts remain deferred; non-text variants expose only safe fallback data.
+ */
+export type MessageContent = ContactMessageContent | FileMessageContent | MediaMessageContent | TextMessageContent | UnknownMessageContent | UrlMessageContent;
+export interface MessageAuthor {
+    readonly id?: string | undefined;
+    readonly displayName?: string | undefined;
+    readonly avatarUrl?: string | undefined;
+}
+export interface Message {
+    readonly kind: "message";
+    readonly id: TimelineItemId;
+    readonly conversationId: ConversationId;
+    readonly role: MessageRole;
+    readonly content: MessageContent;
+    /** Server-owned Unix epoch milliseconds used for stable ordering. */
+    readonly createdAt: number;
+    readonly updatedAt?: number | undefined;
+    /** Optional server-defined tie breaker for items sharing createdAt. */
+    readonly sequence?: number | undefined;
+    readonly author?: MessageAuthor | undefined;
+    readonly reasoning?: string | undefined;
+    readonly raw?: ReadonlyJsonValue | undefined;
+}
+export type AgentEventStatus = "aborted" | "failed" | "running" | "success" | "timeout" | "unknown";
+export interface AgentEventTransition {
+    /** Gateway-normalized stable ID; duplicate delivery must reuse the same ID. */
+    readonly id: string;
+    readonly status: AgentEventStatus;
+    /** Server-owned Unix epoch milliseconds; array order breaks equal-time ties. */
+    readonly occurredAt: number;
+    readonly sequence?: number | undefined;
+    readonly summary?: string | undefined;
+    readonly error?: ChatError | undefined;
+    readonly raw?: ReadonlyJsonValue | undefined;
+}
+export interface ToolCall {
+    readonly id?: string | undefined;
+    readonly name: string;
+    readonly description?: string | undefined;
+    readonly arguments?: ReadonlyJsonValue | undefined;
+    readonly index?: number | undefined;
+}
+interface ToolReturnFields {
+    readonly result?: ReadonlyJsonValue | undefined;
+    readonly success?: boolean | undefined;
+    readonly done?: boolean | undefined;
+    readonly raw?: ReadonlyJsonValue | undefined;
+}
+/** A normalized Tool return must preserve at least one meaningful field. */
+export type ToolReturn = (ToolReturnFields & {
+    readonly result: ReadonlyJsonValue;
+}) | (ToolReturnFields & {
+    readonly success: boolean;
+}) | (ToolReturnFields & {
+    readonly done: boolean;
+}) | (ToolReturnFields & {
+    readonly raw: ReadonlyJsonValue;
+});
+export interface AskUserInteractionOption {
+    readonly label: string;
+    readonly value: string;
+    readonly description?: string | undefined;
+}
+export interface AskUserInteractionQuestion {
+    readonly id: string;
+    readonly prompt: string;
+    readonly title?: string | undefined;
+    readonly description?: string | undefined;
+    readonly placeholder?: string | undefined;
+    readonly required: boolean;
+    readonly multiple: boolean;
+    readonly defaultValue?: AskUserInteractionValue | undefined;
+    readonly options: readonly AskUserInteractionOption[];
+}
+export type AskUserInteractionValue = string | readonly string[];
+/** One conversation-scoped request for structured user input. */
+export interface AskUserInteractionRequest {
+    readonly kind: "ask-user";
+    readonly conversationId: ConversationId;
+    readonly requestId: string;
+    /** Immutable Gateway-issued identity for this exact request envelope. */
+    readonly revision: string;
+    readonly eventId?: string | undefined;
+    readonly title: string;
+    readonly questions: readonly AskUserInteractionQuestion[];
+    readonly timeoutSeconds?: number | undefined;
+}
+export interface AskUserInteractionAnswer {
+    readonly requestId: string;
+    readonly revision: string;
+    readonly action: "cancel" | "submit";
+    readonly answers: Readonly<Record<string, AskUserInteractionValue>>;
+}
+/** Gateway-normalized terminal Ask User data suitable for history rendering. */
+export interface AskUserInteractionResult {
+    readonly kind: "ask-user";
+    readonly requestId: string;
+    readonly revision?: string | undefined;
+    readonly status: "answered" | "cancelled" | "chat-about-this" | "failed" | "timeout";
+    readonly questions: readonly AskUserInteractionQuestion[];
+    readonly answers?: Readonly<Record<string, AskUserInteractionValue>> | undefined;
+    readonly error?: string | undefined;
+}
+export interface ToolEventTransition extends AgentEventTransition {
+    readonly toolCall?: ToolCall | undefined;
+    readonly toolReturn?: ToolReturn | undefined;
+    readonly interaction?: AskUserInteractionResult | undefined;
+}
+interface AgentEventBase {
+    readonly kind: "agent-event";
+    readonly id: TimelineItemId;
+    readonly conversationId: ConversationId;
+    readonly eventType: string;
+    /** Latest transition status; schemas require it to match transitions.at(-1). */
+    readonly status: AgentEventStatus;
+    readonly createdAt: number;
+    readonly updatedAt?: number | undefined;
+    readonly sequence?: number | undefined;
+    readonly summary?: string | undefined;
+    readonly raw?: ReadonlyJsonValue | undefined;
+}
+export interface GenericAgentEvent extends AgentEventBase {
+    readonly eventCategory: "generic";
+    readonly transitions: readonly AgentEventTransition[];
+}
+/** Structured Tool event preserving partial and terminal transition data. */
+export interface ToolAgentEvent extends AgentEventBase {
+    readonly eventCategory: "tool";
+    readonly transitions: readonly ToolEventTransition[];
+}
+export type AgentEvent = GenericAgentEvent | ToolAgentEvent;
+interface AgentEventTransitionPayloadBase {
+    /** Immutable event identity established by the first accepted transition. */
+    readonly id: TimelineItemId;
+    /** Immutable for an event ID; conflicting updates must be rejected. */
+    readonly eventType: string;
+    /** Immutable for an event ID; conflicting updates must be rejected. */
+    readonly createdAt: number;
+    /** Immutable for an event ID; conflicting updates must be rejected. */
+    readonly sequence?: number | undefined;
+}
+export interface GenericAgentEventTransitionPayload extends AgentEventTransitionPayloadBase {
+    readonly eventCategory: "generic";
+    readonly transition: AgentEventTransition;
+}
+export interface ToolAgentEventTransitionPayload extends AgentEventTransitionPayloadBase {
+    readonly eventCategory: "tool";
+    readonly transition: ToolEventTransition;
+}
+export type AgentEventTransitionPayload = GenericAgentEventTransitionPayload | ToolAgentEventTransitionPayload;
+/** Safe fallback for an event type the Gateway cannot normalize. */
+export interface UnknownEvent {
+    readonly kind: "unknown-event";
+    readonly id: TimelineItemId;
+    readonly conversationId: ConversationId;
+    readonly originalType: string;
+    readonly createdAt: number;
+    readonly updatedAt?: number | undefined;
+    readonly sequence?: number | undefined;
+    readonly summary: string;
+    readonly raw?: ReadonlyJsonValue | undefined;
+}
+export type TimelineItem = AgentEvent | Message | UnknownEvent;
+export type RunStatus = "aborted" | "failed" | "running" | "succeeded" | "unknown";
+export interface Run {
+    readonly id: RunId;
+    readonly conversationId: ConversationId;
+    readonly status: RunStatus;
+    readonly canInterrupt: boolean;
+    readonly startedAt?: number | undefined;
+    readonly finishedAt?: number | undefined;
+    readonly error?: ChatError | undefined;
+}
+export type ChatErrorCode = "authentication" | "authorization" | "conflict" | "network" | "not-found" | "server" | "timeout" | "unknown" | "unsupported" | "validation";
+export interface ChatError {
+    readonly code: ChatErrorCode;
+    readonly message: string;
+    readonly retryable: boolean;
+    readonly conversationId?: ConversationId | undefined;
+    readonly details?: ReadonlyJsonValue | undefined;
+}
+export interface Capabilities {
+    /** Enables ChatGateway.answerInteraction when the optional method exists. */
+    readonly answerInteraction?: boolean | undefined;
+    /** Enables interrupt only while the current run is running and interruptible. */
+    readonly interrupt: boolean;
+    /** Enables ChatGateway.listConversations. */
+    readonly listConversations: boolean;
+    /** Enables ChatGateway.subscribe. */
+    readonly liveUpdates: boolean;
+    /** Enables history requests carrying a previousCursor; initial load remains available. */
+    readonly loadHistory: boolean;
+    /** Enables ChatGateway.sendText. */
+    readonly sendText: boolean;
+}
+export interface TimelinePageInfo {
+    readonly previousCursor?: string | undefined;
+    readonly hasPreviousPage: boolean;
+}
+export interface ChatSnapshot {
+    readonly conversation: Conversation;
+    readonly timeline: readonly TimelineItem[];
+    readonly run: Run | null;
+    readonly capabilities: Capabilities;
+    readonly pageInfo: TimelinePageInfo;
+    readonly pendingInteraction?: AskUserInteractionRequest | undefined;
+    readonly error?: ChatError | undefined;
+}
+export interface AgentEventTransitionUpdate {
+    readonly kind: "event.transition.upsert";
+    readonly conversationId: ConversationId;
+    readonly event: AgentEventTransitionPayload;
+}
+export type ChatUpdate = {
+    readonly kind: "snapshot.replace";
+    readonly snapshot: ChatSnapshot;
+} | {
+    readonly kind: "conversation.upsert";
+    readonly conversation: Conversation;
+} | {
+    /** Full item replacement; use event.transition.upsert for one transition. */
+    readonly kind: "timeline.upsert";
+    readonly conversationId: ConversationId;
+    readonly item: TimelineItem;
+}
+/**
+ * Idempotently upserts one transition without requiring Gateway state.
+ * Runtime groups by conversationId/event.id, upserts by transition.id,
+ * orders by occurredAt/sequence/id, and derives the latest status.
+ */
+ | AgentEventTransitionUpdate | {
+    readonly kind: "run.replace";
+    readonly conversationId: ConversationId;
+    readonly run: Run | null;
+} | {
+    readonly kind: "capabilities.replace";
+    readonly conversationId: ConversationId;
+    readonly capabilities: Capabilities;
+} | {
+    readonly kind: "interaction.replace";
+    readonly conversationId: ConversationId;
+    readonly interaction: AskUserInteractionRequest | null;
+} | {
+    readonly kind: "error.reported";
+    readonly conversationId?: ConversationId | undefined;
+    readonly error: ChatError;
+};
+export declare const conversationSchema: import("./schema.js").RuntimeSchema<Conversation>;
+export declare const askUserInteractionRequestSchema: import("./schema.js").RuntimeSchema<AskUserInteractionRequest>;
+export declare const askUserInteractionAnswerSchema: import("./schema.js").RuntimeSchema<AskUserInteractionAnswer>;
+export declare const askUserInteractionResultSchema: import("./schema.js").RuntimeSchema<AskUserInteractionResult>;
+export declare const messageSchema: import("./schema.js").RuntimeSchema<Message>;
+export declare const agentEventSchema: import("./schema.js").RuntimeSchema<AgentEvent>;
+export declare const unknownEventSchema: import("./schema.js").RuntimeSchema<UnknownEvent>;
+export declare const timelineItemSchema: import("./schema.js").RuntimeSchema<TimelineItem>;
+export declare const runSchema: import("./schema.js").RuntimeSchema<Run>;
+export declare const chatErrorSchema: import("./schema.js").RuntimeSchema<ChatError>;
+export declare const capabilitiesSchema: import("./schema.js").RuntimeSchema<Capabilities>;
+export declare const chatSnapshotSchema: import("./schema.js").RuntimeSchema<ChatSnapshot>;
+export declare const chatUpdateSchema: import("./schema.js").RuntimeSchema<ChatUpdate>;
+/** Stable identity used by Runtime upsert and deduplication. */
+export declare const getTimelineItemKey: (item: TimelineItem) => string;
+/**
+ * Total ordering independent of arrival order. Updating an existing item does
+ * not move it because updatedAt is deliberately excluded from this key.
+ */
+export declare const compareTimelineItems: (left: TimelineItem, right: TimelineItem) => number;
+/**
+ * Enforces the immutable envelope rule for event.transition.upsert. Runtime
+ * ignores and reports conflicting updates instead of guessing an overwrite.
+ */
+export declare const hasCompatibleAgentEventMetadata: (event: AgentEvent, update: AgentEventTransitionUpdate) => boolean;
+export {};
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

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

package/dist/models.js

@@ -0,0 +1,44 @@
+import { agentEventParser, askUserInteractionAnswerParser, askUserInteractionRequestParser, askUserInteractionResultParser, capabilitiesParser, chatErrorParser, chatSnapshotParser, chatUpdateParser, conversationParser, messageParser, runParser, timelineItemParser, unknownEventParser, } from "./internal-schemas.js";
+import { createRuntimeSchema } from "./internal-runtime-schema.js";
+export const conversationSchema = createRuntimeSchema(conversationParser);
+export const askUserInteractionRequestSchema = createRuntimeSchema(askUserInteractionRequestParser);
+export const askUserInteractionAnswerSchema = createRuntimeSchema(askUserInteractionAnswerParser);
+export const askUserInteractionResultSchema = createRuntimeSchema(askUserInteractionResultParser);
+export const messageSchema = createRuntimeSchema(messageParser);
+export const agentEventSchema = createRuntimeSchema(agentEventParser);
+export const unknownEventSchema = createRuntimeSchema(unknownEventParser);
+export const timelineItemSchema = createRuntimeSchema(timelineItemParser);
+export const runSchema = createRuntimeSchema(runParser);
+export const chatErrorSchema = createRuntimeSchema(chatErrorParser);
+export const capabilitiesSchema = createRuntimeSchema(capabilitiesParser);
+export const chatSnapshotSchema = createRuntimeSchema(chatSnapshotParser);
+export const chatUpdateSchema = createRuntimeSchema(chatUpdateParser);
+/** Stable identity used by Runtime upsert and deduplication. */
+export const getTimelineItemKey = (item) => item.kind === "message" ? `message:${item.id}` : `event:${item.id}`;
+/**
+ * Total ordering independent of arrival order. Updating an existing item does
+ * not move it because updatedAt is deliberately excluded from this key.
+ */
+export const compareTimelineItems = (left, right) => {
+    const timestampOrder = left.createdAt - right.createdAt;
+    if (timestampOrder !== 0)
+        return timestampOrder;
+    const sequenceOrder = (left.sequence ?? Number.MAX_SAFE_INTEGER) -
+        (right.sequence ?? Number.MAX_SAFE_INTEGER);
+    if (sequenceOrder !== 0)
+        return sequenceOrder;
+    const leftKey = getTimelineItemKey(left);
+    const rightKey = getTimelineItemKey(right);
+    return leftKey < rightKey ? -1 : leftKey > rightKey ? 1 : 0;
+};
+/**
+ * Enforces the immutable envelope rule for event.transition.upsert. Runtime
+ * ignores and reports conflicting updates instead of guessing an overwrite.
+ */
+export const hasCompatibleAgentEventMetadata = (event, update) => event.conversationId === update.conversationId &&
+    event.id === update.event.id &&
+    event.eventCategory === update.event.eventCategory &&
+    event.eventType === update.event.eventType &&
+    event.createdAt === update.event.createdAt &&
+    event.sequence === update.event.sequence;
+//# sourceMappingURL=models.js.map

package/dist/models.js.map

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

package/dist/ordering.d.ts

@@ -0,0 +1,9 @@
+interface OrderedAgentEventTransition {
+    readonly id: string;
+    readonly occurredAt: number;
+    readonly sequence?: number | undefined;
+}
+/** Total ordering used after idempotent transition upsert by transition.id. */
+export declare const compareAgentEventTransitions: (left: OrderedAgentEventTransition, right: OrderedAgentEventTransition) => number;
+export {};
+//# sourceMappingURL=ordering.d.ts.map

package/dist/ordering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ordering.d.ts","sourceRoot":"","sources":["../src/ordering.ts"],"names":[],"mappings":"AAAA,UAAU,2BAA2B;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC;AAED,+EAA+E;AAC/E,eAAO,MAAM,4BAA4B,GACvC,MAAM,2BAA2B,EACjC,OAAO,2BAA2B,KACjC,MAUF,CAAC"}

package/dist/ordering.js

@@ -0,0 +1,12 @@
+/** Total ordering used after idempotent transition upsert by transition.id. */
+export const compareAgentEventTransitions = (left, right) => {
+    const timestampOrder = left.occurredAt - right.occurredAt;
+    if (timestampOrder !== 0)
+        return timestampOrder;
+    const sequenceOrder = (left.sequence ?? Number.MAX_SAFE_INTEGER) -
+        (right.sequence ?? Number.MAX_SAFE_INTEGER);
+    if (sequenceOrder !== 0)
+        return sequenceOrder;
+    return left.id < right.id ? -1 : left.id > right.id ? 1 : 0;
+};
+//# sourceMappingURL=ordering.js.map

package/dist/ordering.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ordering.js","sourceRoot":"","sources":["../src/ordering.ts"],"names":[],"mappings":"AAMA,+EAA+E;AAC/E,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAC1C,IAAiC,EACjC,KAAkC,EAC1B,EAAE;IACV,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IAC1D,IAAI,cAAc,KAAK,CAAC;QAAE,OAAO,cAAc,CAAC;IAEhD,MAAM,aAAa,GACjB,CAAC,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,gBAAgB,CAAC;QAC1C,CAAC,KAAK,CAAC,QAAQ,IAAI,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC9C,IAAI,aAAa,KAAK,CAAC;QAAE,OAAO,aAAa,CAAC;IAE9C,OAAO,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC,CAAC"}

package/dist/raw.d.ts

@@ -0,0 +1,17 @@
+export type JsonPrimitive = boolean | null | number | string;
+export type ReadonlyJsonValue = JsonPrimitive | readonly ReadonlyJsonValue[] | {
+    readonly [key: string]: ReadonlyJsonValue;
+};
+export declare const isSensitiveRawKey: (key: string) => boolean;
+/** Removes credential-shaped fragments from user-visible diagnostic text. */
+export declare const sanitizeDiagnosticText: (input: string) => string;
+/**
+ * Produces an immutable JSON value and redacts credential-shaped keys, header
+ * tuples, authorization strings, JWTs, URL userinfo, and signed query values.
+ * The retained result is bounded by depth, nodes, per-string size, and total
+ * key/string characters so many individually valid values cannot amplify it.
+ * Gateway adapters must still allowlist transport fields before retaining raw;
+ * this sanitizer is the final defense rather than permission to keep headers.
+ */
+export declare const sanitizeRaw: (input: unknown) => ReadonlyJsonValue;
+//# sourceMappingURL=raw.d.ts.map

package/dist/raw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw.d.ts","sourceRoot":"","sources":["../src/raw.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;AAE7D,MAAM,MAAM,iBAAiB,GACzB,aAAa,GACb,SAAS,iBAAiB,EAAE,GAC5B;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAAA;CAAE,CAAC;AAoDlD,eAAO,MAAM,iBAAiB,GAAI,KAAK,MAAM,KAAG,OAM/C,CAAC;AA0BF,6EAA6E;AAC7E,eAAO,MAAM,sBAAsB,GAAI,OAAO,MAAM,KAAG,MAgCtD,CAAC;AAoJF;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,iBAKzC,CAAC"}

package/dist/raw.js

@@ -0,0 +1,208 @@
+const MAX_RAW_DEPTH = 32;
+const MAX_RAW_KEY_LENGTH = 1_024;
+const MAX_RAW_NODES = 10_000;
+const MAX_RAW_STRING_LENGTH = 262_144;
+const MAX_RAW_TOTAL_CHARACTERS = 1_048_576;
+const REDACTED_VALUE = "[REDACTED]";
+const sensitiveKeyNames = new Set([
+    "adminkey",
+    "apikey",
+    "auth",
+    "authorization",
+    "bearer",
+    "clientsecret",
+    "cookie",
+    "credentials",
+    "credential",
+    "password",
+    "privatekey",
+    "refreshtoken",
+    "jwt",
+    "secret",
+    "secretkey",
+    "setcookie",
+    "sig",
+    "signature",
+    "token",
+    "accesstoken",
+    "xamzcredential",
+    "xamzsignature",
+]);
+const sensitiveKeySuffixes = [
+    "adminkey",
+    "apikey",
+    "authorization",
+    "clientsecret",
+    "cookie",
+    "credentials",
+    "credential",
+    "password",
+    "privatekey",
+    "secret",
+    "secretkey",
+    "signature",
+    "token",
+];
+const canonicalizeKey = (key) => key.toLocaleLowerCase("en-US").replaceAll(/[^a-z0-9]/gu, "");
+export const isSensitiveRawKey = (key) => {
+    const canonicalKey = canonicalizeKey(key);
+    return (sensitiveKeyNames.has(canonicalKey) ||
+        sensitiveKeySuffixes.some((suffix) => canonicalKey.endsWith(suffix)));
+};
+const authorizationValuePattern = /\b(?:basic|bearer)\s+[A-Za-z0-9+/_:.~-]+={0,}/giu;
+const credentialHeaderValuePattern = /\b(?:(?:x[-_])?(?:admin|api)[-_]?key|(?:proxy[-_])?authorization|cookie|set-cookie)\s*[:=]\s*[^\r\n]+/giu;
+const jwtValuePattern = /\b(?:[A-Za-z0-9_-]{8,}\.){2,4}[A-Za-z0-9_-]+\b/gu;
+const pemPrivateKeyPattern = /-----BEGIN (?:[A-Z0-9]+ )*PRIVATE KEY(?: BLOCK)?-----/iu;
+const providerTokenPattern = /\b(?:gh[pousr]_[A-Za-z0-9]{20,}|github_pat_[A-Za-z0-9_]{20,}|glpat-[A-Za-z0-9_-]{20,}|sk-[A-Za-z0-9_-]{20,}|xox[baprs]-[A-Za-z0-9-]{10,})\b/gu;
+const awsAccessKeyPattern = /\b(?:A3T[A-Z0-9]{17}|A(?:GPA|IDA|IPA|KIA|NPA|NVA|ROA|SCA|SIA)[A-Z0-9]{16})\b/gu;
+const urlParameterPattern = /([?&#])([^?&#=]+)=([^&#]*)/gu;
+const urlUserInfoPattern = /((?:\b[A-Za-z][A-Za-z0-9+.-]*:)?\/\/)([^/@\s]+)@/gu;
+const embeddedParameterPattern = /(^|[\s,;])([^?&#:=\s,;]+)\s*([:=])\s*([^\s,;&#]+)/gu;
+const decodeUrlKey = (key) => {
+    try {
+        return decodeURIComponent(key.replaceAll("+", " "));
+    }
+    catch {
+        return key;
+    }
+};
+/** Removes credential-shaped fragments from user-visible diagnostic text. */
+export const sanitizeDiagnosticText = (input) => {
+    const trimmed = input.trim();
+    const standaloneParameter = /^([^?&#:=\s]+)\s*[:=]\s*\S+/u.exec(trimmed);
+    if (pemPrivateKeyPattern.test(trimmed) ||
+        (standaloneParameter !== null &&
+            isSensitiveRawKey(decodeUrlKey(standaloneParameter[1])))) {
+        return REDACTED_VALUE;
+    }
+    return input
+        .replace(urlUserInfoPattern, `$1${REDACTED_VALUE}@`)
+        .replace(urlParameterPattern, (match, separator, encodedKey) => isSensitiveRawKey(decodeUrlKey(encodedKey))
+        ? `${separator}${encodedKey}=${encodeURIComponent(REDACTED_VALUE)}`
+        : match)
+        .replace(credentialHeaderValuePattern, REDACTED_VALUE)
+        .replace(authorizationValuePattern, REDACTED_VALUE)
+        .replace(jwtValuePattern, REDACTED_VALUE)
+        .replace(providerTokenPattern, REDACTED_VALUE)
+        .replace(awsAccessKeyPattern, REDACTED_VALUE)
+        .replace(embeddedParameterPattern, (match, prefix, encodedKey, separator) => isSensitiveRawKey(decodeUrlKey(encodedKey))
+        ? `${prefix}${encodedKey}${separator}${REDACTED_VALUE}`
+        : match);
+};
+const addCharacters = (state, count) => {
+    state.totalCharacters += count;
+    if (state.totalCharacters > MAX_RAW_TOTAL_CHARACTERS) {
+        throw new TypeError(`raw data exceeds the maximum total character count of ${MAX_RAW_TOTAL_CHARACTERS}`);
+    }
+};
+const addNodes = (state, count = 1) => {
+    state.nodes += count;
+    if (state.nodes > MAX_RAW_NODES) {
+        throw new TypeError(`raw data exceeds the maximum node count of ${MAX_RAW_NODES}`);
+    }
+};
+const addRedactedLeaf = (state) => {
+    addNodes(state);
+    addCharacters(state, REDACTED_VALUE.length);
+    return REDACTED_VALUE;
+};
+const sanitizeValue = (input, depth, state) => {
+    addNodes(state);
+    if (depth > MAX_RAW_DEPTH) {
+        throw new TypeError(`raw data exceeds the maximum depth of ${MAX_RAW_DEPTH}`);
+    }
+    if (input === null || typeof input === "boolean") {
+        return input;
+    }
+    if (typeof input === "string") {
+        if (input.length > MAX_RAW_STRING_LENGTH) {
+            throw new TypeError(`raw data strings must not exceed ${MAX_RAW_STRING_LENGTH} characters`);
+        }
+        const sanitized = sanitizeDiagnosticText(input);
+        if (sanitized.length > MAX_RAW_STRING_LENGTH) {
+            throw new TypeError(`sanitized raw data strings must not exceed ${MAX_RAW_STRING_LENGTH} characters`);
+        }
+        addCharacters(state, sanitized.length);
+        return sanitized;
+    }
+    if (typeof input === "number") {
+        if (!Number.isFinite(input)) {
+            throw new TypeError("raw data numbers must be finite");
+        }
+        return input;
+    }
+    if (typeof input !== "object") {
+        throw new TypeError(`raw data contains unsupported ${typeof input} value`);
+    }
+    if (state.ancestors.has(input)) {
+        throw new TypeError("raw data must not contain circular references");
+    }
+    state.ancestors.add(input);
+    try {
+        if (Array.isArray(input)) {
+            if (input.length > MAX_RAW_NODES - state.nodes) {
+                throw new TypeError(`raw data exceeds the maximum node count of ${MAX_RAW_NODES}`);
+            }
+            if (input.length === 2 &&
+                Object.hasOwn(input, 0) &&
+                Object.hasOwn(input, 1) &&
+                typeof input[0] === "string" &&
+                isSensitiveRawKey(input[0])) {
+                if (input[0].length > MAX_RAW_STRING_LENGTH) {
+                    throw new TypeError(`raw data strings must not exceed ${MAX_RAW_STRING_LENGTH} characters`);
+                }
+                addNodes(state, 2);
+                addCharacters(state, input[0].length + REDACTED_VALUE.length);
+                return Object.freeze([input[0], REDACTED_VALUE]);
+            }
+            const output = [];
+            for (let index = 0; index < input.length; index += 1) {
+                if (!Object.hasOwn(input, index)) {
+                    throw new TypeError("raw data arrays must not be sparse");
+                }
+                output.push(sanitizeValue(input[index], depth + 1, state));
+            }
+            return Object.freeze(output);
+        }
+        const prototype = Object.getPrototypeOf(input);
+        if (prototype !== Object.prototype && prototype !== null) {
+            throw new TypeError("raw data objects must be plain JSON objects");
+        }
+        const output = {};
+        for (const key in input) {
+            if (!Object.hasOwn(input, key))
+                continue;
+            if (key.length > MAX_RAW_KEY_LENGTH) {
+                throw new TypeError(`raw data keys must not exceed ${MAX_RAW_KEY_LENGTH} characters`);
+            }
+            addCharacters(state, key.length);
+            const sanitizedValue = isSensitiveRawKey(key)
+                ? addRedactedLeaf(state)
+                : sanitizeValue(input[key], depth + 1, state);
+            Object.defineProperty(output, key, {
+                configurable: false,
+                enumerable: true,
+                writable: false,
+                value: sanitizedValue,
+            });
+        }
+        return Object.freeze(output);
+    }
+    finally {
+        state.ancestors.delete(input);
+    }
+};
+/**
+ * Produces an immutable JSON value and redacts credential-shaped keys, header
+ * tuples, authorization strings, JWTs, URL userinfo, and signed query values.
+ * The retained result is bounded by depth, nodes, per-string size, and total
+ * key/string characters so many individually valid values cannot amplify it.
+ * Gateway adapters must still allowlist transport fields before retaining raw;
+ * this sanitizer is the final defense rather than permission to keep headers.
+ */
+export const sanitizeRaw = (input) => sanitizeValue(input, 0, {
+    ancestors: new WeakSet(),
+    nodes: 0,
+    totalCharacters: 0,
+});
+//# sourceMappingURL=raw.js.map