@fabric-harness/sdk 1.14.0 → 2.0.1

package/dist/conversation-stream.js

@@ -0,0 +1,159 @@
+export class ConversationStreamStoreError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'ConversationStreamStoreError';
+        this.code = code;
+    }
+}
+export const CONVERSATION_STREAM_DEFAULT_READ_LIMIT = 100;
+export const CONVERSATION_STREAM_MAX_READ_LIMIT = 1000;
+export function clampReadLimit(limit) {
+    if (limit === undefined || !Number.isFinite(limit) || limit <= 0) {
+        return CONVERSATION_STREAM_DEFAULT_READ_LIMIT;
+    }
+    return Math.min(Math.floor(limit), CONVERSATION_STREAM_MAX_READ_LIMIT);
+}
+export function formatStreamOffset(offset) {
+    return String(offset);
+}
+export function parseStreamOffset(offset) {
+    if (offset === undefined || offset === '')
+        return 0;
+    const parsed = Number.parseInt(offset, 10);
+    if (!Number.isFinite(parsed) || parsed < 0)
+        return 0;
+    return parsed;
+}
+/** Stream path for a session's conversation projection. */
+export function conversationStreamPath(storeSessionId) {
+    return `conversations/${storeSessionId}`;
+}
+/**
+ * Process-local listener registry shared by store implementations —
+ * registration, unsubscribe-and-prune, and error-swallowing notify.
+ */
+export class StreamListenerRegistry {
+    listeners = new Map();
+    subscribe(path, listener) {
+        let set = this.listeners.get(path);
+        if (!set) {
+            set = new Set();
+            this.listeners.set(path, set);
+        }
+        set.add(listener);
+        return () => {
+            set.delete(listener);
+            if (set.size === 0)
+                this.listeners.delete(path);
+        };
+    }
+    notify(path) {
+        for (const listener of this.listeners.get(path) ?? []) {
+            try {
+                listener();
+            }
+            catch {
+                // Listener failures never affect the writer.
+            }
+        }
+    }
+}
+/** In-memory conversation stream store (dev / `runtime: 'stateless'` / tests). */
+export class InMemoryConversationStreamStore {
+    streams = new Map();
+    registry = new StreamListenerRegistry();
+    async createStream(path, identity) {
+        if (!this.streams.has(path)) {
+            this.streams.set(path, {
+                identity,
+                batches: [],
+                nextOffset: 0,
+                producerId: null,
+                producerEpoch: 0,
+                nextProducerSequence: 0,
+            });
+        }
+    }
+    async acquireProducer(path, producerId) {
+        const stream = this.requireStream(path);
+        stream.producerId = producerId;
+        stream.producerEpoch += 1;
+        stream.nextProducerSequence = 0;
+        return {
+            producerId,
+            producerEpoch: stream.producerEpoch,
+            nextProducerSequence: stream.nextProducerSequence,
+            offset: formatStreamOffset(stream.nextOffset),
+        };
+    }
+    async append(input) {
+        const stream = this.requireStream(input.path);
+        if (input.producerId !== stream.producerId || input.producerEpoch !== stream.producerEpoch) {
+            throw new ConversationStreamStoreError('PRODUCER_FENCED', `Producer ${input.producerId}@${input.producerEpoch} is fenced; current is ${stream.producerId ?? 'none'}@${stream.producerEpoch}.`);
+        }
+        // Idempotent redelivery: identical coordinates return the committed offset.
+        const existing = stream.batches.find((batch) => batch.producerId === input.producerId &&
+            batch.producerEpoch === input.producerEpoch &&
+            batch.producerSequence === input.producerSequence);
+        if (existing)
+            return { offset: formatStreamOffset(existing.seq) };
+        if (input.producerSequence !== stream.nextProducerSequence) {
+            throw new ConversationStreamStoreError('SEQUENCE_CONFLICT', `Producer sequence ${input.producerSequence} does not match expected ${stream.nextProducerSequence}.`);
+        }
+        const seq = stream.nextOffset;
+        stream.batches.push({
+            seq,
+            producerId: input.producerId,
+            producerEpoch: input.producerEpoch,
+            producerSequence: input.producerSequence,
+            records: input.records.map((record) => structuredClone(record)),
+        });
+        stream.nextOffset = seq + 1;
+        stream.nextProducerSequence = input.producerSequence + 1;
+        this.registry.notify(input.path);
+        return { offset: formatStreamOffset(seq) };
+    }
+    async read(path, options) {
+        const stream = this.requireStream(path);
+        const from = parseStreamOffset(options?.offset);
+        const limit = clampReadLimit(options?.limit);
+        const selected = stream.batches.filter((batch) => batch.seq >= from).slice(0, limit);
+        const last = selected[selected.length - 1];
+        const nextOffset = last ? last.seq + 1 : from;
+        return {
+            batches: selected.map((batch) => ({
+                offset: formatStreamOffset(batch.seq),
+                records: batch.records.map((record) => structuredClone(record)),
+            })),
+            nextOffset: formatStreamOffset(nextOffset),
+            upToDate: nextOffset >= stream.nextOffset,
+        };
+    }
+    async getMeta(path) {
+        const stream = this.streams.get(path);
+        if (!stream)
+            return null;
+        return {
+            identity: stream.identity,
+            nextOffset: formatStreamOffset(stream.nextOffset),
+            producerId: stream.producerId,
+            producerEpoch: stream.producerEpoch,
+            nextProducerSequence: stream.nextProducerSequence,
+        };
+    }
+    async delete(path) {
+        this.streams.delete(path);
+    }
+    subscribe(path, listener) {
+        return this.registry.subscribe(path, listener);
+    }
+    requireStream(path) {
+        const stream = this.streams.get(path);
+        if (!stream) {
+            throw new ConversationStreamStoreError('STREAM_NOT_FOUND', `Conversation stream not found: ${path}`);
+        }
+        return stream;
+    }
+}
+//# sourceMappingURL=conversation-stream.js.map

package/dist/conversation-stream.js.map

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

package/dist/delivered-message.d.ts

@@ -0,0 +1,90 @@
+import type { SignalEntryData } from './types.js';
+/**
+ * DeliveredMessage — the single unified input shape for everything that
+ * enters a persistent agent's session: direct HTTP prompts, dispatch,
+ * channels/webhooks, Databricks events, SDK clients, and tests.
+ *
+ * `kind: 'user'` is a direct user talking to the assistant (1:1 chat
+ * surface), optionally carrying attachments.
+ *
+ * `kind: 'signal'` models everything beyond that direct exchange — a Slack
+ * thread or a Lakeflow job event is activity the agent observes, not the
+ * assistant's own user speaking. Sender identity and structured metadata go
+ * in `attributes`; the message itself in `body`. Signals render into model
+ * context as an XML envelope (`<tagName ...attributes>body</tagName>`).
+ *
+ * `body` (not `text`/`content`) is named for headroom — a future revision may
+ * accept a real JSON value and stringify internally without a field rename.
+ */
+export type DeliveredMessage = {
+    kind: 'user';
+    body: string;
+    attachments?: DeliveredAttachment[];
+} | {
+    kind: 'signal';
+    /** Caller-defined event/signal type, e.g. `'slack.message'` or `'databricks.job_run'`. */
+    type: string;
+    body: string;
+    attributes?: Record<string, string>;
+    tagName?: string;
+};
+/**
+ * One attachment on a `kind: 'user'` message. Today the only supported
+ * attachment is an image, carried either inline (`data`, base64) or as a
+ * durable content-addressed reference (`ref`) once an attachment store is
+ * configured — admission materializes inline bytes into refs. An attachment
+ * must carry `data` or `ref` (or both, transiently during materialization).
+ */
+export interface DeliveredAttachment {
+    type: 'image';
+    /** Base64-encoded bytes (inline form). */
+    data?: string;
+    mimeType: string;
+    /** Uploader-provided display name; not part of byte identity. */
+    filename?: string;
+    /** Durable content-addressed reference (materialized form). */
+    ref?: DeliveredAttachmentRef;
+}
+/** Durable reference to attachment bytes in an attachment store. */
+export interface DeliveredAttachmentRef {
+    /** Attachment id assigned at materialization. */
+    id: string;
+    /** Lowercase hex SHA-256 of the bytes — the content address. */
+    digest: string;
+    sizeBytes: number;
+}
+/** Maximum accepted base64 length for a single inline attachment. */
+export declare const MAX_ATTACHMENT_DATA_LENGTH: number;
+/** Thrown by {@link parseDeliveredMessage} on malformed input. */
+export declare class InvalidDeliveredMessageError extends Error {
+    readonly code = "INVALID_DELIVERED_MESSAGE";
+    constructor(reason: string);
+}
+/**
+ * Validate a raw value as a {@link DeliveredMessage}. Shared by dispatch
+ * admission and the direct HTTP route so every transport produces the same
+ * structured error on bad input.
+ */
+export declare function parseDeliveredMessage(value: unknown): DeliveredMessage;
+/** True when a raw value already looks like a {@link DeliveredMessage} (has a valid `kind`). */
+export declare function isDeliveredMessageShape(value: unknown): boolean;
+/**
+ * Normalize legacy inputs into a {@link DeliveredMessage}:
+ * - a string → a user message with that body
+ * - a value with a `kind` discriminator → validated as a DeliveredMessage
+ * - any other JSON value → a user message with the JSON-stringified body
+ *   (matching the historical dispatch rendering, so behavior is unchanged
+ *   for pre-DeliveredMessage callers)
+ */
+export declare function normalizeDeliveredMessage(input: unknown): DeliveredMessage;
+/**
+ * Render a delivered message to the prompt text form. User messages pass
+ * their body through verbatim; signals render as their XML envelope via the
+ * shared {@link renderSignalMessage} machinery.
+ */
+export declare function renderDeliveredMessage(message: DeliveredMessage): string;
+/** Map a signal-kind message onto the persisted `signal` entry's data shape. */
+export declare function deliveredSignalToEntryData(message: Extract<DeliveredMessage, {
+    kind: 'signal';
+}>): SignalEntryData;
+//# sourceMappingURL=delivered-message.d.ts.map

package/dist/delivered-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivered-message.d.ts","sourceRoot":"","sources":["../src/delivered-message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,mBAAmB,EAAE,CAAA;CAAE,GACnE;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,0FAA0F;IAC1F,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEN;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,GAAG,CAAC,EAAE,sBAAsB,CAAC;CAC9B;AAED,oEAAoE;AACpE,MAAM,WAAW,sBAAsB;IACrC,iDAAiD;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qEAAqE;AACrE,eAAO,MAAM,0BAA0B,QAAmB,CAAC;AAU3D,kEAAkE;AAClE,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,IAAI,+BAA+B;gBAChC,MAAM,EAAE,MAAM;CAI3B;AAUD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAiDtE;AAkDD,gGAAgG;AAChG,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE/D;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAI1E;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAGxE;AAED,gFAAgF;AAChF,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,CAAC,gBAAgB,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,GACrD,eAAe,CAOjB"}

package/dist/delivered-message.js

@@ -0,0 +1,154 @@
+import { renderSignalMessage } from './history.js';
+/** Maximum accepted base64 length for a single inline attachment. */
+export const MAX_ATTACHMENT_DATA_LENGTH = 14 * 1024 * 1024;
+/**
+ * The tag name is rendered (escaped attributes/body, but the tag itself is
+ * structural) as the signal's XML envelope in model context, so it must be a
+ * valid XML name — anything looser would let a caller-controlled value
+ * inject markup that the body/attribute escaping exists to prevent.
+ */
+const XML_TAG_NAME_RE = /^[A-Za-z_][A-Za-z0-9_.-]*$/;
+/** Thrown by {@link parseDeliveredMessage} on malformed input. */
+export class InvalidDeliveredMessageError extends Error {
+    code = 'INVALID_DELIVERED_MESSAGE';
+    constructor(reason) {
+        super(reason);
+        this.name = 'InvalidDeliveredMessageError';
+    }
+}
+const SHAPE_HINT = 'Delivered messages must be { kind: "user", body: string, attachments?: attachment[] } ' +
+    'or { kind: "signal", type: string, body: string, attributes?: Record<string, string>, tagName?: string }.';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Validate a raw value as a {@link DeliveredMessage}. Shared by dispatch
+ * admission and the direct HTTP route so every transport produces the same
+ * structured error on bad input.
+ */
+export function parseDeliveredMessage(value) {
+    if (!isRecord(value))
+        throw new InvalidDeliveredMessageError(SHAPE_HINT);
+    if (value.kind === 'user') {
+        if (typeof value.body !== 'string')
+            throw new InvalidDeliveredMessageError(SHAPE_HINT);
+        let attachments;
+        if (value.attachments !== undefined) {
+            if (!Array.isArray(value.attachments))
+                throw new InvalidDeliveredMessageError(SHAPE_HINT);
+            attachments = value.attachments.map((raw) => parseDeliveredAttachment(raw));
+        }
+        return { kind: 'user', body: value.body, ...(attachments ? { attachments } : {}) };
+    }
+    if (value.kind === 'signal') {
+        if (typeof value.type !== 'string' || value.type.length === 0) {
+            throw new InvalidDeliveredMessageError('Signal message "type" must be a non-empty string.');
+        }
+        if (typeof value.body !== 'string')
+            throw new InvalidDeliveredMessageError(SHAPE_HINT);
+        let attributes;
+        if (value.attributes !== undefined) {
+            if (!isRecord(value.attributes))
+                throw new InvalidDeliveredMessageError(SHAPE_HINT);
+            attributes = {};
+            for (const [key, attr] of Object.entries(value.attributes)) {
+                if (typeof attr !== 'string') {
+                    throw new InvalidDeliveredMessageError('Signal message "attributes" values must be strings.');
+                }
+                attributes[key] = attr;
+            }
+        }
+        let tagName;
+        if (value.tagName !== undefined) {
+            if (typeof value.tagName !== 'string' || !XML_TAG_NAME_RE.test(value.tagName)) {
+                throw new InvalidDeliveredMessageError('Signal message "tagName" must be a valid XML tag name ' +
+                    '(letters, digits, "_", "-", "."; must not start with a digit, "-", or ".").');
+            }
+            tagName = value.tagName;
+        }
+        return {
+            kind: 'signal',
+            type: value.type,
+            body: value.body,
+            ...(attributes ? { attributes } : {}),
+            ...(tagName ? { tagName } : {}),
+        };
+    }
+    throw new InvalidDeliveredMessageError(SHAPE_HINT);
+}
+function parseDeliveredAttachment(value) {
+    if (!isRecord(value) || value.type !== 'image' || typeof value.mimeType !== 'string') {
+        throw new InvalidDeliveredMessageError('Attachments must be { type: "image", data?: base64 string, ref?: { id, digest, sizeBytes }, mimeType: string, filename?: string }.');
+    }
+    if (value.data === undefined && value.ref === undefined) {
+        throw new InvalidDeliveredMessageError('Attachments must carry inline "data" (base64) or a durable "ref".');
+    }
+    if (value.data !== undefined) {
+        if (typeof value.data !== 'string') {
+            throw new InvalidDeliveredMessageError('Attachment "data" must be a base64 string when provided.');
+        }
+        if (value.data.length > MAX_ATTACHMENT_DATA_LENGTH) {
+            throw new InvalidDeliveredMessageError(`Attachment data exceeds the ${MAX_ATTACHMENT_DATA_LENGTH} character limit.`);
+        }
+    }
+    let ref;
+    if (value.ref !== undefined) {
+        const raw = value.ref;
+        if (!isRecord(raw) ||
+            typeof raw.id !== 'string' ||
+            typeof raw.digest !== 'string' ||
+            typeof raw.sizeBytes !== 'number') {
+            throw new InvalidDeliveredMessageError('Attachment "ref" must be { id: string, digest: string, sizeBytes: number }.');
+        }
+        ref = { id: raw.id, digest: raw.digest, sizeBytes: raw.sizeBytes };
+    }
+    if (value.filename !== undefined && typeof value.filename !== 'string') {
+        throw new InvalidDeliveredMessageError('Attachment "filename" must be a string when provided.');
+    }
+    return {
+        type: 'image',
+        ...(typeof value.data === 'string' ? { data: value.data } : {}),
+        mimeType: value.mimeType,
+        ...(typeof value.filename === 'string' ? { filename: value.filename } : {}),
+        ...(ref ? { ref } : {}),
+    };
+}
+/** True when a raw value already looks like a {@link DeliveredMessage} (has a valid `kind`). */
+export function isDeliveredMessageShape(value) {
+    return isRecord(value) && (value.kind === 'user' || value.kind === 'signal');
+}
+/**
+ * Normalize legacy inputs into a {@link DeliveredMessage}:
+ * - a string → a user message with that body
+ * - a value with a `kind` discriminator → validated as a DeliveredMessage
+ * - any other JSON value → a user message with the JSON-stringified body
+ *   (matching the historical dispatch rendering, so behavior is unchanged
+ *   for pre-DeliveredMessage callers)
+ */
+export function normalizeDeliveredMessage(input) {
+    if (typeof input === 'string')
+        return { kind: 'user', body: input };
+    if (isDeliveredMessageShape(input))
+        return parseDeliveredMessage(input);
+    return { kind: 'user', body: JSON.stringify(input ?? null) };
+}
+/**
+ * Render a delivered message to the prompt text form. User messages pass
+ * their body through verbatim; signals render as their XML envelope via the
+ * shared {@link renderSignalMessage} machinery.
+ */
+export function renderDeliveredMessage(message) {
+    if (message.kind === 'user')
+        return message.body;
+    return renderSignalMessage(deliveredSignalToEntryData(message));
+}
+/** Map a signal-kind message onto the persisted `signal` entry's data shape. */
+export function deliveredSignalToEntryData(message) {
+    return {
+        signalType: message.type,
+        content: message.body,
+        ...(message.attributes ? { attributes: message.attributes } : {}),
+        ...(message.tagName ? { tagName: message.tagName } : {}),
+    };
+}
+//# sourceMappingURL=delivered-message.js.map

package/dist/delivered-message.js.map

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

package/dist/dispatch.d.ts

@@ -1,13 +1,19 @@
+import type { DeliveredMessage } from './delivered-message.js';
 import type { CreatedAgent } from './persistent-agent.js';
-import type { FabricActor } from './types.js';
+import type { FabricActor, JsonObject } from './types.js';
 /** Async delivery request to a persistent agent instance + session. */
 export interface AgentDispatchRequest {
     /** Instance id of the target persistent agent. */
     id: string;
     /** Named session within the instance. Defaults to `"default"`. */
     session?: string;
-    /** JSON-serializable payload delivered to the instance. */
-    input: unknown;
+    /**
+     * The message delivered to the session. Preferred over `input`; a string
+     * or plain JSON `input` is normalized into a user-kind message.
+     */
+    message?: DeliveredMessage;
+    /** Legacy JSON-serializable payload. Normalized into `message` at admission. */
+    input?: DeliveredMessage | string | JsonObject;
 }
 /** A dispatch request that names its target agent. */
 export interface NamedAgentDispatchRequest extends AgentDispatchRequest {
@@ -24,6 +30,13 @@ export interface DispatchInput {
     agent: string;
     id: string;
     session: string;
+    /** The normalized message delivered to the session. */
+    message: DeliveredMessage;
+    /**
+     * Legacy payload, retained for wire compatibility with pre-2.0 queue
+     * implementations. New code should read `message`.
+     * @deprecated Read `message` instead.
+     */
     input: unknown;
     acceptedAt: string;
     tenantId?: string;

package/dist/dispatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE1D,uEAAuE;AACvE,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,gFAAgF;IAChF,KAAK,CAAC,EAAE,gBAAgB,GAAG,MAAM,GAAG,UAAU,CAAC;CAChD;AAED,sDAAsD;AACtD,MAAM,WAAW,yBAA0B,SAAQ,oBAAoB;IACrE,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,OAAO,EAAE,gBAAgB,CAAC;IAC1B;;;;OAIG;IACH,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2FAA2F;IAC3F,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,4EAA4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACrD;AAED,4GAA4G;AAC5G,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,4BAA4B;IAC3C,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,qBAAa,qBAAsB,YAAW,aAAa;IAWvD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAV5B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAC9D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAC7D,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,SAAS,CAAS;gBAGP,SAAS,EAAE,iBAAiB,EAC7C,OAAO,CAAC,EAAE,4BAA4B;IAMlC,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC;IAY7D,mDAAmD;IACnD,QAAQ,IAAI,IAAI;IAIhB,yEAAyE;IACnE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAS/B,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,aAAa;YAUP,sBAAsB;IAiCpC,OAAO,CAAC,WAAW;CAiBpB;AAED,UAAU,eAAe;IACvB,KAAK,EAAE,aAAa,CAAC;CACtB;AAKD,qEAAqE;AACrE,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAEvE;AAED,2DAA2D;AAC3D,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED,2FAA2F;AAC3F,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAEhF;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AACvG,wBAAgB,QAAQ,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAgCvF,uFAAuF;AACvF,wBAAsB,eAAe,CACnC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,yBAAyB,EAClC,KAAK,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GAC1E,OAAO,CAAC,eAAe,CAAC,CA4B1B"}

package/dist/dispatch.js

@@ -1,3 +1,4 @@
+import { normalizeDeliveredMessage } from './delivered-message.js';
 /**
  * In-process dispatch queue: microtask-drained, concurrent across sessions,
  * serialized within a single session. Suitable for the `inline`/`stateless`
@@ -153,11 +154,13 @@ export async function enqueueDispatch(queue, request, extra = {}) {
     }
     let input;
     try {
-        input = JSON.parse(JSON.stringify(request.input ?? null));
+        // Snapshot at admission time (also proves JSON-serializability).
+        input = JSON.parse(JSON.stringify(request.message ?? request.input ?? null));
     }
     catch {
         throw new Error('dispatch: input must be JSON-serializable.');
     }
+    const message = normalizeDeliveredMessage(input);
     const dispatchInput = {
         // A caller-supplied id (e.g. derived from a platform event id) gives exactly-once delivery via
         // the persistent-run idempotency marker; otherwise mint a fresh one.
@@ -165,6 +168,7 @@ export async function enqueueDispatch(queue, request, extra = {}) {
         agent: request.agent,
         id: request.id,
         session: request.session ?? 'default',
+        message,
         input,
         acceptedAt: new Date().toISOString(),
         ...(extra.tenantId ? { tenantId: extra.tenantId } : {}),

package/dist/dispatch.js.map

@@ -1 +1 @@
-{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAyDA;;;;;GAKG;AACH,MAAM,OAAO,qBAAqB;IAWb;IAVF,cAAc,CAAS;IACvB,aAAa,CAAS;IACtB,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC7C,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;IACrD,WAAW,GAAG,CAAC,CAAC;IAChB,YAAY,GAAG,KAAK,CAAC;IACrB,YAAY,CAA4B;IACxC,SAAS,GAAG,KAAK,CAAC;IAE1B,YACmB,SAA4B,EAC7C,OAAsC;QADrB,cAAS,GAAT,SAAS,CAAmB;QAG7C,IAAI,CAAC,cAAc,GAAG,OAAO,EAAE,cAAc,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;QAC/D,IAAI,CAAC,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,MAAM,CAAC,iBAAiB,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAoB;QAChC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAChF,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC7B,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC;IACxE,CAAC;IAED,mDAAmD;IACnD,QAAQ;QACN,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED,yEAAyE;IACzE,KAAK,CAAC,QAAQ;QACZ,OAAO,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAChD,IAAI,IAAI,CAAC,YAAY;gBAAE,MAAM,IAAI,CAAC,YAAY,CAAC;YAC/C,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBAC3B,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;IACH,CAAC;IAEO,UAAU,CAAC,KAAoB;QACrC,OAAO,GAAG,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IACzD,CAAC;IAEO,aAAa;QACnB,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,YAAY,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAChD,cAAc,CAAC,GAAG,EAAE;gBAClB,KAAK,IAAI,CAAC,sBAAsB,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACtD,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,sBAAsB;QAClC,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;gBAC1B,IAAI,UAAU,GAAG,KAAK,CAAC;gBACvB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;oBACxC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;wBAAE,SAAS;oBACrC,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,aAAa;wBAAE,MAAM;oBAElD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;oBAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;wBACX,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;wBACzB,SAAS;oBACX,CAAC;oBAED,UAAU,GAAG,IAAI,CAAC;oBAClB,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC;oBACxD,IAAI,CAAC,WAAW,EAAE,CAAC;oBACnB,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBAC/B,CAAC;gBAED,IAAI,CAAC,UAAU;oBAAE,MAAM;YACzB,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;YACvB,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CACnD,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAC9D,CAAC;YACF,IAAI,YAAY,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;gBAChF,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,GAAW,EAAE,KAAoB;QACnD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE;aAC9B,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;aACzC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACf,OAAO,CAAC,KAAK,CAAC,6CAA6C,EAAE,KAAK,CAAC,CAAC;QACtE,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1B,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACpC,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAChC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC3B,CAAC;YACD,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,CAAC,CAAC,CAAC;QACL,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC;CACF;AAMD,IAAI,eAA4C,CAAC;AACjD,MAAM,iBAAiB,GAAG,IAAI,OAAO,EAAwB,CAAC;AAE9D,qEAAqE;AACrE,MAAM,UAAU,wBAAwB,CAAC,OAAwB;IAC/D,eAAe,GAAG,OAAO,CAAC;AAC5B,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,oBAAoB;IAClC,eAAe,GAAG,SAAS,CAAC;AAC9B,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,wBAAwB,CAAC,KAAmB,EAAE,IAAY;IACxE,iBAAiB,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AACrC,CAAC;AAID,MAAM,UAAU,QAAQ,CACtB,cAAwD,EACxD,YAAmC;IAEnC,IAAI,CAAC,eAAe,EAAE,KAAK,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAC;IAChG,CAAC;IACD,MAAM,KAAK,GAAG,mBAAmB,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;IAChE,OAAO,eAAe,CAAC,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,mBAAmB,CAC1B,cAAwD,EACxD,YAAmC;IAEnC,IAAI,cAAc,CAAC,cAAc,CAAC;QAAE,OAAO,cAAc,CAAC;IAC1D,IAAI,CAAC,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACpG,MAAM,IAAI,GAAG,iBAAiB,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACnD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,2EAA2E;YACzE,qGAAqG,CACxG,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,GAAG,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAQ,KAA6B,CAAC,KAAK,KAAK,QAAQ,CAAC;AACjH,CAAC;AAED,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAoB,EACpB,OAAkC,EAClC,QAAyE,EAAE;IAE3E,IAAI,CAAC,OAAO,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACrF,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACnF,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IACD,MAAM,aAAa,GAAkB;QACnC,+FAA+F;QAC/F,qEAAqE;QACrE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC,UAAU,EAAE;QAC3D,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,SAAS;QACrC,KAAK;QACL,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/C,CAAC;IACF,OAAO,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;AACtC,CAAC"}
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"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"}

package/dist/history.d.ts

@@ -45,9 +45,36 @@ export declare class SessionHistory {
      */
     getActivePathSince(afterLeafId: string | null | undefined): SessionEntry[];
     getLatestCompaction(): SessionEntry | undefined;
+    /** Trailing dangling tool calls on THIS history's active path. See {@link findTrailingDanglingToolCalls}. */
+    findTrailingDanglingToolCalls(): SessionEntry[];
     buildContextEntries(): SessionEntry[];
     buildModelMessages(role?: Role): ModelMessage[];
 }
 export declare function buildModelMessagesFromHistory(data: SessionData | undefined, role?: Role): ModelMessage[];
+/**
+ * Find trailing `tool_call` entries on the active path that were never
+ * settled — no matching `tool_result` (paired by `toolCallId`, falling back
+ * to tool name) and no subsequent `error` entry for the same tool.
+ *
+ * A dangling call means a model turn died (crash/abort) between recording
+ * the call and recording its outcome. Left in place it produces an
+ * assistant `tool_use` with no `tool_result` on resume, which providers
+ * reject — the repair path appends synthetic interrupted outcomes for
+ * exactly the entries returned here.
+ *
+ * Conservative by construction: only the window after the last turn
+ * boundary (user prompt / assistant message / result / compaction / signal)
+ * is examined, so historical, already-settled turns are never re-judged.
+ * Both the resume-repair and the submission terminalization derive the
+ * dangling set through this single function so they can never disagree.
+ */
+export declare function findTrailingDanglingToolCalls(path: SessionEntry[]): SessionEntry[];
+/**
+ * Trailing `task_start` entries in the same window with no matching
+ * `task_end` — a subtask that was in flight when the turn died. These do not
+ * corrupt model context (task entries are bookkeeping), but settling them
+ * keeps UI/audit state coherent.
+ */
+export declare function findTrailingUnfinishedTasks(path: SessionEntry[]): SessionEntry[];
 export declare function renderSignalMessage(data: SignalEntryData): string;
 //# sourceMappingURL=history.d.ts.map

package/dist/history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEnF,eAAO,MAAM,yBAAyB,4iBAA4iB,CAAC;AAEnlB,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4B;IACjD,OAAO,CAAC,MAAM,CAAqB;IAEnC,OAAO;IAMP,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,cAAc;IAI9D;;;;;;OAMG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,YAAY,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAUzF;;;;OAIG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAWzD,aAAa,IAAI,YAAY,EAAE;IAU/B;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO9B;;;;;;;;;;;OAWG;IACH,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,YAAY,EAAE;IAQ1E,mBAAmB,IAAI,YAAY,GAAG,SAAS;IAS/C,mBAAmB,IAAI,YAAY,EAAE;IAgBrC,kBAAkB,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,YAAY,EAAE;CAiChD;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,YAAY,EAAE,CAExG;AAoDD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAYjE"}
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEnF,eAAO,MAAM,yBAAyB,4iBAA4iB,CAAC;AAEnlB,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4B;IACjD,OAAO,CAAC,MAAM,CAAqB;IAEnC,OAAO;IAMP,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,cAAc;IAI9D;;;;;;OAMG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,YAAY,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAUzF;;;;OAIG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAWzD,aAAa,IAAI,YAAY,EAAE;IAU/B;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO9B;;;;;;;;;;;OAWG;IACH,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,YAAY,EAAE;IAQ1E,mBAAmB,IAAI,YAAY,GAAG,SAAS;IAS/C,6GAA6G;IAC7G,6BAA6B,IAAI,YAAY,EAAE;IAI/C,mBAAmB,IAAI,YAAY,EAAE;IAgBrC,kBAAkB,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,YAAY,EAAE;CAiChD;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,YAAY,EAAE,CAExG;AAiBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAiClF;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAqBhF;AAoDD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAYjE"}