@sequenceholdings/managed-functions 0.4.0 → 0.4.2

package/dist/monitoring-contract.d.ts

@@ -0,0 +1,463 @@
+import { z } from 'zod';
+import { functionMonitoringAnnotationSchema } from './monitoring-annotations';
+export type { DeltaEventInput as MonitoringDeltaEvent } from './monitoring-events';
+export declare const FUNCTION_MONITORING_TOKEN_HEADER = "x-sequence-monitoring-service-token";
+export declare const FUNCTION_MONITORING_DELIVERIES_PATH = "/api/managed-functions/monitoring/deliveries";
+export declare const MONITORING_PRODUCER_CAPABILITY = "emit_monitoring";
+export declare const MONITORING_CATALOG_CAPABILITY = "read_monitoring_catalog";
+export declare const MAX_MONITORING_DELIVERY_BYTES: number;
+export declare const functionMonitoringScopesSchema: z.ZodObject<{
+    producers: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export declare function readFunctionMonitoringScopes(manifest: unknown): string[];
+export declare const monitoringEventsSchema: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    contextType: z.ZodLiteral<"artifact_delta">;
+    context: z.ZodObject<{
+        artifactKind: z.ZodString;
+        sectionPath: z.ZodString;
+        before: z.ZodString;
+        after: z.ZodString;
+        changeKind: z.ZodEnum<{
+            added: "added";
+            removed: "removed";
+            modified: "modified";
+        }>;
+        category: z.ZodOptional<z.ZodString>;
+        sourceRefs: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        workflowId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    idempotencyKey: z.ZodString;
+    subjectId: z.ZodString;
+    subjectKind: z.ZodEnum<{
+        workflow: "workflow";
+        agent: "agent";
+    }>;
+    occurredAt: z.ZodString;
+    deltaReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    deltaSource: z.ZodDefault<z.ZodEnum<{
+        unknown: "unknown";
+        human: "human";
+        llm: "llm";
+    }>>;
+    actionability: z.ZodDefault<z.ZodLiteral<"unknown">>;
+}, z.core.$strict>, z.ZodObject<{
+    contextType: z.ZodLiteral<"dti_delta">;
+    context: z.ZodObject<{
+        stageId: z.ZodString;
+        loanId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        fieldPath: z.ZodString;
+        before: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        after: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        section: z.ZodOptional<z.ZodEnum<{
+            debt: "debt";
+            income: "income";
+            other: "other";
+        }>>;
+        itemLabel: z.ZodOptional<z.ZodString>;
+        calculatorType: z.ZodOptional<z.ZodEnum<{
+            basic: "basic";
+            advanced: "advanced";
+        }>>;
+        workflowId: z.ZodOptional<z.ZodString>;
+        sourceDocRefs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>;
+    idempotencyKey: z.ZodString;
+    subjectId: z.ZodString;
+    subjectKind: z.ZodEnum<{
+        workflow: "workflow";
+        agent: "agent";
+    }>;
+    occurredAt: z.ZodString;
+    deltaReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    deltaSource: z.ZodDefault<z.ZodEnum<{
+        unknown: "unknown";
+        human: "human";
+        llm: "llm";
+    }>>;
+    actionability: z.ZodDefault<z.ZodLiteral<"unknown">>;
+}, z.core.$strict>, z.ZodObject<{
+    contextType: z.ZodLiteral<"doc_extract_edit">;
+    context: z.ZodObject<{
+        documentId: z.ZodString;
+        docType: z.ZodString;
+        fieldPath: z.ZodString;
+        oldValue: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        newValue: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        rowKey: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+        stageId: z.ZodOptional<z.ZodString>;
+        workflowId: z.ZodOptional<z.ZodString>;
+        citation: z.ZodOptional<z.ZodObject<{
+            page: z.ZodNumber;
+            region: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    idempotencyKey: z.ZodString;
+    subjectId: z.ZodString;
+    subjectKind: z.ZodEnum<{
+        workflow: "workflow";
+        agent: "agent";
+    }>;
+    occurredAt: z.ZodString;
+    deltaReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    deltaSource: z.ZodDefault<z.ZodEnum<{
+        unknown: "unknown";
+        human: "human";
+        llm: "llm";
+    }>>;
+    actionability: z.ZodDefault<z.ZodLiteral<"unknown">>;
+}, z.core.$strict>], "contextType">>;
+export declare function monitoringPayloadHash({ events, observation }: {
+    events: z.input<typeof monitoringEventsSchema>;
+    observation?: z.input<typeof functionMonitoringAnnotationSchema>;
+}): string;
+export declare const monitoringDeliveryKeySchema: z.ZodObject<{
+    producer: z.ZodString;
+    businessKey: z.ZodString;
+}, z.core.$strict>;
+export declare const monitoringCatalogQuerySchema: z.ZodObject<{
+    producer: z.ZodString;
+}, z.core.$strict>;
+export declare const monitoringBucketCatalogSchema: z.ZodObject<{
+    producer: z.ZodString;
+    complete: z.ZodLiteral<true>;
+    buckets: z.ZodArray<z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodString;
+        severity: z.ZodEnum<{
+            critical: "critical";
+            high: "high";
+            medium: "medium";
+            low: "low";
+        }>;
+        category: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type MonitoringCatalogQuery = z.infer<typeof monitoringCatalogQuerySchema>;
+export type MonitoringBucketCatalog = z.infer<typeof monitoringBucketCatalogSchema>;
+export declare const monitoringPublishSchema: z.ZodObject<{
+    producer: z.ZodString;
+    businessKey: z.ZodString;
+    payloadHash: z.ZodString;
+    events: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        contextType: z.ZodLiteral<"artifact_delta">;
+        context: z.ZodObject<{
+            artifactKind: z.ZodString;
+            sectionPath: z.ZodString;
+            before: z.ZodString;
+            after: z.ZodString;
+            changeKind: z.ZodEnum<{
+                added: "added";
+                removed: "removed";
+                modified: "modified";
+            }>;
+            category: z.ZodOptional<z.ZodString>;
+            sourceRefs: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            workflowId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        idempotencyKey: z.ZodString;
+        subjectId: z.ZodString;
+        subjectKind: z.ZodEnum<{
+            workflow: "workflow";
+            agent: "agent";
+        }>;
+        occurredAt: z.ZodString;
+        deltaReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        deltaSource: z.ZodDefault<z.ZodEnum<{
+            unknown: "unknown";
+            human: "human";
+            llm: "llm";
+        }>>;
+        actionability: z.ZodDefault<z.ZodLiteral<"unknown">>;
+    }, z.core.$strict>, z.ZodObject<{
+        contextType: z.ZodLiteral<"dti_delta">;
+        context: z.ZodObject<{
+            stageId: z.ZodString;
+            loanId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            fieldPath: z.ZodString;
+            before: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+            after: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+            section: z.ZodOptional<z.ZodEnum<{
+                debt: "debt";
+                income: "income";
+                other: "other";
+            }>>;
+            itemLabel: z.ZodOptional<z.ZodString>;
+            calculatorType: z.ZodOptional<z.ZodEnum<{
+                basic: "basic";
+                advanced: "advanced";
+            }>>;
+            workflowId: z.ZodOptional<z.ZodString>;
+            sourceDocRefs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>;
+        idempotencyKey: z.ZodString;
+        subjectId: z.ZodString;
+        subjectKind: z.ZodEnum<{
+            workflow: "workflow";
+            agent: "agent";
+        }>;
+        occurredAt: z.ZodString;
+        deltaReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        deltaSource: z.ZodDefault<z.ZodEnum<{
+            unknown: "unknown";
+            human: "human";
+            llm: "llm";
+        }>>;
+        actionability: z.ZodDefault<z.ZodLiteral<"unknown">>;
+    }, z.core.$strict>, z.ZodObject<{
+        contextType: z.ZodLiteral<"doc_extract_edit">;
+        context: z.ZodObject<{
+            documentId: z.ZodString;
+            docType: z.ZodString;
+            fieldPath: z.ZodString;
+            oldValue: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+            newValue: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+            rowKey: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+            stageId: z.ZodOptional<z.ZodString>;
+            workflowId: z.ZodOptional<z.ZodString>;
+            citation: z.ZodOptional<z.ZodObject<{
+                page: z.ZodNumber;
+                region: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        idempotencyKey: z.ZodString;
+        subjectId: z.ZodString;
+        subjectKind: z.ZodEnum<{
+            workflow: "workflow";
+            agent: "agent";
+        }>;
+        occurredAt: z.ZodString;
+        deltaReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        deltaSource: z.ZodDefault<z.ZodEnum<{
+            unknown: "unknown";
+            human: "human";
+            llm: "llm";
+        }>>;
+        actionability: z.ZodDefault<z.ZodLiteral<"unknown">>;
+    }, z.core.$strict>], "contextType">>;
+    observation: z.ZodOptional<z.ZodObject<{
+        sourceType: z.ZodString;
+        sourceRef: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        generatingSubject: z.ZodObject<{
+            subjectId: z.ZodString;
+            subjectKind: z.ZodEnum<{
+                workflow: "workflow";
+                agent: "agent";
+            }>;
+        }, z.core.$strict>;
+        occurredAt: z.ZodISODateTime;
+        summary: z.ZodNullable<z.ZodString>;
+        metrics: z.ZodCustom<import("./monitoring-annotations").MonitoringJson, import("./monitoring-annotations").MonitoringJson>;
+        conversationFindings: z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            description: z.ZodString;
+            excerpt: z.ZodString;
+            severity: z.ZodEnum<{
+                high: "high";
+                medium: "medium";
+                low: "low";
+            }>;
+        }, z.core.$strict>>;
+        classifications: z.ZodArray<z.ZodObject<{
+            matchedBucketSlug: z.ZodNullable<z.ZodString>;
+            newBucketProposal: z.ZodNullable<z.ZodObject<{
+                name: z.ZodString;
+                description: z.ZodString;
+                severity: z.ZodEnum<{
+                    critical: "critical";
+                    high: "high";
+                    medium: "medium";
+                    low: "low";
+                }>;
+                category: z.ZodString;
+            }, z.core.$strict>>;
+            excerpt: z.ZodString;
+            inputTags: z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                value: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        coarseFallbacks: z.ZodArray<z.ZodObject<{
+            bucketSlug: z.ZodString;
+            excerpt: z.ZodString;
+            coarseCategory: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const functionMonitoringRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    producer: z.ZodString;
+    businessKey: z.ZodString;
+    payloadHash: z.ZodString;
+    events: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        contextType: z.ZodLiteral<"artifact_delta">;
+        context: z.ZodObject<{
+            artifactKind: z.ZodString;
+            sectionPath: z.ZodString;
+            before: z.ZodString;
+            after: z.ZodString;
+            changeKind: z.ZodEnum<{
+                added: "added";
+                removed: "removed";
+                modified: "modified";
+            }>;
+            category: z.ZodOptional<z.ZodString>;
+            sourceRefs: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            workflowId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        idempotencyKey: z.ZodString;
+        subjectId: z.ZodString;
+        subjectKind: z.ZodEnum<{
+            workflow: "workflow";
+            agent: "agent";
+        }>;
+        occurredAt: z.ZodString;
+        deltaReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        deltaSource: z.ZodDefault<z.ZodEnum<{
+            unknown: "unknown";
+            human: "human";
+            llm: "llm";
+        }>>;
+        actionability: z.ZodDefault<z.ZodLiteral<"unknown">>;
+    }, z.core.$strict>, z.ZodObject<{
+        contextType: z.ZodLiteral<"dti_delta">;
+        context: z.ZodObject<{
+            stageId: z.ZodString;
+            loanId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            fieldPath: z.ZodString;
+            before: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+            after: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+            section: z.ZodOptional<z.ZodEnum<{
+                debt: "debt";
+                income: "income";
+                other: "other";
+            }>>;
+            itemLabel: z.ZodOptional<z.ZodString>;
+            calculatorType: z.ZodOptional<z.ZodEnum<{
+                basic: "basic";
+                advanced: "advanced";
+            }>>;
+            workflowId: z.ZodOptional<z.ZodString>;
+            sourceDocRefs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>;
+        idempotencyKey: z.ZodString;
+        subjectId: z.ZodString;
+        subjectKind: z.ZodEnum<{
+            workflow: "workflow";
+            agent: "agent";
+        }>;
+        occurredAt: z.ZodString;
+        deltaReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        deltaSource: z.ZodDefault<z.ZodEnum<{
+            unknown: "unknown";
+            human: "human";
+            llm: "llm";
+        }>>;
+        actionability: z.ZodDefault<z.ZodLiteral<"unknown">>;
+    }, z.core.$strict>, z.ZodObject<{
+        contextType: z.ZodLiteral<"doc_extract_edit">;
+        context: z.ZodObject<{
+            documentId: z.ZodString;
+            docType: z.ZodString;
+            fieldPath: z.ZodString;
+            oldValue: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+            newValue: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+            rowKey: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+            stageId: z.ZodOptional<z.ZodString>;
+            workflowId: z.ZodOptional<z.ZodString>;
+            citation: z.ZodOptional<z.ZodObject<{
+                page: z.ZodNumber;
+                region: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        idempotencyKey: z.ZodString;
+        subjectId: z.ZodString;
+        subjectKind: z.ZodEnum<{
+            workflow: "workflow";
+            agent: "agent";
+        }>;
+        occurredAt: z.ZodString;
+        deltaReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        deltaSource: z.ZodDefault<z.ZodEnum<{
+            unknown: "unknown";
+            human: "human";
+            llm: "llm";
+        }>>;
+        actionability: z.ZodDefault<z.ZodLiteral<"unknown">>;
+    }, z.core.$strict>], "contextType">>;
+    observation: z.ZodOptional<z.ZodObject<{
+        sourceType: z.ZodString;
+        sourceRef: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        generatingSubject: z.ZodObject<{
+            subjectId: z.ZodString;
+            subjectKind: z.ZodEnum<{
+                workflow: "workflow";
+                agent: "agent";
+            }>;
+        }, z.core.$strict>;
+        occurredAt: z.ZodISODateTime;
+        summary: z.ZodNullable<z.ZodString>;
+        metrics: z.ZodCustom<import("./monitoring-annotations").MonitoringJson, import("./monitoring-annotations").MonitoringJson>;
+        conversationFindings: z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            description: z.ZodString;
+            excerpt: z.ZodString;
+            severity: z.ZodEnum<{
+                high: "high";
+                medium: "medium";
+                low: "low";
+            }>;
+        }, z.core.$strict>>;
+        classifications: z.ZodArray<z.ZodObject<{
+            matchedBucketSlug: z.ZodNullable<z.ZodString>;
+            newBucketProposal: z.ZodNullable<z.ZodObject<{
+                name: z.ZodString;
+                description: z.ZodString;
+                severity: z.ZodEnum<{
+                    critical: "critical";
+                    high: "high";
+                    medium: "medium";
+                    low: "low";
+                }>;
+                category: z.ZodString;
+            }, z.core.$strict>>;
+            excerpt: z.ZodString;
+            inputTags: z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                value: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        coarseFallbacks: z.ZodArray<z.ZodObject<{
+            bucketSlug: z.ZodString;
+            excerpt: z.ZodString;
+            coarseCategory: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    operation: z.ZodLiteral<"publish">;
+}, z.core.$strict>, z.ZodObject<{
+    producer: z.ZodString;
+    businessKey: z.ZodString;
+    operation: z.ZodLiteral<"get">;
+}, z.core.$strict>, z.ZodObject<{
+    producer: z.ZodString;
+    operation: z.ZodLiteral<"getBucketCatalog">;
+}, z.core.$strict>], "operation">;
+export type MonitoringPublish = z.input<typeof monitoringPublishSchema>;
+export type MonitoringDeliveryKey = z.infer<typeof monitoringDeliveryKeySchema>;
+export type FunctionMonitoringRequest = z.infer<typeof functionMonitoringRequestSchema>;
+export declare const monitoringDeliveryReceiptSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    producer: z.ZodString;
+    businessKey: z.ZodString;
+    payloadHash: z.ZodString;
+    status: z.ZodLiteral<"confirmed">;
+    eventCount: z.ZodNumber;
+    confirmedAt: z.ZodISODateTime;
+    eventIds: z.ZodArray<z.ZodUUID>;
+}, z.core.$strict>;
+export type MonitoringDeliveryReceipt = z.infer<typeof monitoringDeliveryReceiptSchema>;
+export declare class FunctionMonitoringError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly name = "FunctionMonitoringError";
+    constructor(status: number, code: string, message: string);
+}

package/dist/monitoring-contract.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FunctionMonitoringError = exports.monitoringDeliveryReceiptSchema = exports.functionMonitoringRequestSchema = exports.monitoringPublishSchema = exports.monitoringBucketCatalogSchema = exports.monitoringCatalogQuerySchema = exports.monitoringDeliveryKeySchema = exports.monitoringEventsSchema = exports.functionMonitoringScopesSchema = exports.MAX_MONITORING_DELIVERY_BYTES = exports.MONITORING_CATALOG_CAPABILITY = exports.MONITORING_PRODUCER_CAPABILITY = exports.FUNCTION_MONITORING_DELIVERIES_PATH = exports.FUNCTION_MONITORING_TOKEN_HEADER = void 0;
+exports.readFunctionMonitoringScopes = readFunctionMonitoringScopes;
+exports.monitoringPayloadHash = monitoringPayloadHash;
+const node_crypto_1 = require("node:crypto");
+const zod_1 = require("zod");
+const monitoring_events_1 = require("./monitoring-events");
+const monitoring_annotations_1 = require("./monitoring-annotations");
+exports.FUNCTION_MONITORING_TOKEN_HEADER = 'x-sequence-monitoring-service-token';
+exports.FUNCTION_MONITORING_DELIVERIES_PATH = '/api/managed-functions/monitoring/deliveries';
+exports.MONITORING_PRODUCER_CAPABILITY = 'emit_monitoring';
+exports.MONITORING_CATALOG_CAPABILITY = 'read_monitoring_catalog';
+exports.MAX_MONITORING_DELIVERY_BYTES = 512 * 1024;
+const producer = zod_1.z.string().min(1).max(41).regex(/^[a-z][a-z0-9_]{0,40}$/);
+exports.functionMonitoringScopesSchema = zod_1.z.strictObject({
+    producers: zod_1.z.array(producer).min(1).max(16).refine(ids => new Set(ids).size === ids.length, 'Producer namespaces must be distinct'),
+});
+function readFunctionMonitoringScopes(manifest) {
+    if (typeof manifest !== 'object' || manifest === null)
+        return [];
+    const capabilities = Reflect.get(manifest, 'capabilities');
+    if (typeof capabilities !== 'object' || capabilities === null)
+        return [];
+    const monitoring = Reflect.get(capabilities, 'monitoring');
+    return monitoring === undefined ? [] : exports.functionMonitoringScopesSchema.parse(monitoring).producers;
+}
+exports.monitoringEventsSchema = zod_1.z.array(monitoring_events_1.deltaEventSchema).max(monitoring_events_1.MAX_DELTA_EVENTS_PER_REQUEST).superRefine((events, context) => {
+    const seen = new Set();
+    for (const [index, event] of events.entries()) {
+        if (seen.has(event.idempotencyKey))
+            context.addIssue({ code: 'custom', path: [index, 'idempotencyKey'], message: 'Event keys must be distinct within a delivery' });
+        seen.add(event.idempotencyKey);
+    }
+    if (Buffer.byteLength(JSON.stringify(events), 'utf8') > exports.MAX_MONITORING_DELIVERY_BYTES) {
+        context.addIssue({ code: 'custom', message: 'Monitoring events exceed the delivery size limit' });
+    }
+});
+function canonical(value) {
+    if (Array.isArray(value))
+        return `[${value.map(canonical).join(',')}]`;
+    if (typeof value === 'object' && value !== null) {
+        return `{${Object.entries(value).filter(([, entry]) => entry !== undefined).sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0).map(([key, entry]) => `${JSON.stringify(key)}:${canonical(entry)}`).join(',')}}`;
+    }
+    const serialized = JSON.stringify(value);
+    if (serialized === undefined)
+        throw new Error('Monitoring payload is not JSON');
+    return serialized;
+}
+function monitoringPayloadHash({ events, observation }) {
+    return (0, node_crypto_1.createHash)('sha256').update(canonical({ events: exports.monitoringEventsSchema.parse(events), ...(observation === undefined ? {} : { observation: monitoring_annotations_1.functionMonitoringAnnotationSchema.parse(observation) }) })).digest('hex');
+}
+const key = zod_1.z.string().min(1).max(512);
+exports.monitoringDeliveryKeySchema = zod_1.z.strictObject({ producer, businessKey: key });
+exports.monitoringCatalogQuerySchema = zod_1.z.strictObject({ producer });
+exports.monitoringBucketCatalogSchema = zod_1.z.strictObject({
+    producer, complete: zod_1.z.literal(true), buckets: zod_1.z.array(zod_1.z.strictObject({
+        slug: zod_1.z.string().min(1).max(512), name: zod_1.z.string().max(512), description: zod_1.z.string().max(50_000),
+        severity: zod_1.z.enum(['critical', 'high', 'medium', 'low']), category: zod_1.z.string().max(512),
+    })).max(2000),
+});
+exports.monitoringPublishSchema = exports.monitoringDeliveryKeySchema.extend({
+    payloadHash: zod_1.z.string().regex(/^[a-f0-9]{64}$/), events: exports.monitoringEventsSchema,
+    observation: monitoring_annotations_1.functionMonitoringAnnotationSchema.optional(),
+});
+exports.functionMonitoringRequestSchema = zod_1.z.discriminatedUnion('operation', [
+    exports.monitoringPublishSchema.extend({ operation: zod_1.z.literal('publish') }),
+    exports.monitoringDeliveryKeySchema.extend({ operation: zod_1.z.literal('get') }),
+    exports.monitoringCatalogQuerySchema.extend({ operation: zod_1.z.literal('getBucketCatalog') }),
+]).superRefine((request, context) => {
+    if (Buffer.byteLength(JSON.stringify(request), 'utf8') > exports.MAX_MONITORING_DELIVERY_BYTES)
+        context.addIssue({ code: 'custom', message: 'Monitoring delivery exceeds the size limit' });
+});
+exports.monitoringDeliveryReceiptSchema = zod_1.z.strictObject({
+    id: zod_1.z.uuid(), producer, businessKey: key, payloadHash: zod_1.z.string().regex(/^[a-f0-9]{64}$/),
+    status: zod_1.z.literal('confirmed'), eventCount: zod_1.z.number().int().min(0).max(monitoring_events_1.MAX_DELTA_EVENTS_PER_REQUEST),
+    confirmedAt: zod_1.z.iso.datetime({ offset: true }), eventIds: zod_1.z.array(zod_1.z.uuid()).max(monitoring_events_1.MAX_DELTA_EVENTS_PER_REQUEST),
+}).refine(receipt => receipt.eventCount === receipt.eventIds.length && new Set(receipt.eventIds).size === receipt.eventIds.length, 'Receipt count must match distinct event ids');
+class FunctionMonitoringError extends Error {
+    status;
+    code;
+    name = 'FunctionMonitoringError';
+    constructor(status, code, message) {
+        super(message);
+        this.status = status;
+        this.code = code;
+    }
+}
+exports.FunctionMonitoringError = FunctionMonitoringError;