@acme-engine/core 0.1.0

package/dist/model-execution-identity.js

@@ -0,0 +1,84 @@
+import { AcmeError } from './errors.js';
+import { nodeHashing } from './hashing.js';
+import { validateModelSelection } from './model-validation.js';
+import { DEFAULT_MODEL_EXECUTION_POLICY, } from './model-execution-types.js';
+export const ACME_MODEL_EXECUTION_ID_ALGORITHM = 'acme-model-execution-id-1';
+export const ACME_MODEL_EXECUTION_FINGERPRINT_ALGORITHM = 'acme-model-execution-fingerprint-1';
+const policyKeys = new Set(['timeoutMs', 'retention']);
+function invalid(message, details) {
+    throw new AcmeError({
+        code: 'INVALID_REQUEST',
+        message,
+        stage: 'accepted',
+        retryable: false,
+        ...(details === undefined ? {} : { details }),
+    });
+}
+function requireText(value, field) {
+    if (typeof value !== 'string' || value.trim().length === 0) {
+        invalid(`${field} must be a non-empty string.`, { field });
+    }
+}
+function positiveInteger(value, field) {
+    if (!Number.isSafeInteger(value) || value <= 0) {
+        invalid(`${field} must be a positive safe integer.`, { field });
+    }
+    return value;
+}
+function deepFreeze(value) {
+    if (value !== null && typeof value === 'object' && !Object.isFrozen(value)) {
+        Object.freeze(value);
+        for (const child of Object.values(value)) {
+            deepFreeze(child);
+        }
+    }
+    return value;
+}
+export function resolveModelExecutionPolicy(supplied) {
+    if (supplied !== undefined &&
+        (supplied === null ||
+            typeof supplied !== 'object' ||
+            Array.isArray(supplied))) {
+        invalid('Model execution policy must be an object.');
+    }
+    const policy = supplied ?? {};
+    const unexpected = Object.keys(policy)
+        .filter((key) => !policyKeys.has(key))
+        .sort();
+    if (unexpected.length > 0) {
+        invalid('Model execution policy contains unexpected fields.', {
+            unexpected,
+        });
+    }
+    const timeoutMs = policy.timeoutMs === undefined
+        ? DEFAULT_MODEL_EXECUTION_POLICY.timeoutMs
+        : positiveInteger(policy.timeoutMs, 'policy.timeoutMs');
+    const retention = policy.retention ?? DEFAULT_MODEL_EXECUTION_POLICY.retention;
+    if (retention !== 'none' &&
+        retention !== 'hash-only' &&
+        retention !== 'encrypted-payload') {
+        invalid('policy.retention is invalid.');
+    }
+    return deepFreeze({ timeoutMs, retention });
+}
+export function deriveModelExecutionId(requestKey, hashing = nodeHashing) {
+    requireText(requestKey, 'requestKey');
+    return `model_execution_${hashing.sha256(hashing.canonicalJson({
+        algorithm: ACME_MODEL_EXECUTION_ID_ALGORITHM,
+        requestKey,
+    }))}`;
+}
+export function computeModelExecutionFingerprint(input, hashing = nodeHashing) {
+    requireText(input.requestKey, 'requestKey');
+    requireText(input.requestHash, 'requestHash');
+    const model = validateModelSelection(input.model);
+    return hashing.sha256(hashing.canonicalJson({
+        algorithm: ACME_MODEL_EXECUTION_FINGERPRINT_ALGORITHM,
+        requestKey: input.requestKey,
+        model,
+        requestHash: input.requestHash,
+        requiredCapabilities: input.requiredCapabilities,
+        policy: input.policy,
+    }));
+}
+//# sourceMappingURL=model-execution-identity.js.map

package/dist/model-execution-identity.js.map

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

package/dist/model-execution-types.d.ts

@@ -0,0 +1,66 @@
+import type { IsoTimestamp, JsonValue } from './common.js';
+import type { AcmeErrorData } from './errors.js';
+import type { ModelCapabilities, ModelRequest, ModelSelection, NormalizedModelResponse, NormalizedUsage } from './model.js';
+export declare const ACME_MODEL_EXECUTION_MAX_REQUEST_BYTES: 1048576;
+export declare const ACME_MODEL_EXECUTION_MAX_STREAM_EVENT_BYTES: 65536;
+export declare const ACME_MODEL_EXECUTION_MAX_RETAINED_PAYLOAD_BYTES: 1048576;
+export declare const DEFAULT_MODEL_EXECUTION_POLICY: Readonly<{
+    timeoutMs: 30000;
+    retention: "hash-only";
+}>;
+export interface ModelExecutionPolicy {
+    readonly timeoutMs: number;
+    readonly retention: 'none' | 'hash-only' | 'encrypted-payload';
+}
+export interface ModelExecutionRequest {
+    readonly requestKey: string;
+    readonly model: ModelSelection;
+    readonly request: ModelRequest;
+    readonly requiredCapabilities?: Partial<ModelCapabilities>;
+    readonly policy?: Partial<ModelExecutionPolicy>;
+}
+export type ModelExecutionFailureKind = 'timeout' | 'cancel' | 'provider-http' | 'malformed-stream' | 'truncated-stream' | 'ambiguous-delivery' | 'invalid-response' | 'unavailable' | 'auth' | 'rate-limit' | 'content-filter' | 'conflict' | 'unsupported-capability' | 'invalid-request' | 'resume-evidence-unavailable' | 'cancelled' | 'internal';
+export interface ModelExecutionDiagnostic {
+    readonly kind: ModelExecutionFailureKind | 'completed';
+    readonly delivery?: 'not-sent' | 'sent' | 'unknown';
+    readonly httpStatus?: number;
+    readonly finishReason?: NormalizedModelResponse['finishReason'];
+}
+export type ModelExecutionStatus = 'accepted' | 'calling-model' | 'succeeded' | 'failed' | 'cancelled' | 'conflicted' | 'ambiguous';
+export type ModelExecutionResult = {
+    readonly status: 'succeeded';
+    readonly modelExecutionId: string;
+    readonly replayed: boolean;
+    readonly response: NormalizedModelResponse;
+    readonly usage: NormalizedUsage;
+    readonly diagnostic: ModelExecutionDiagnostic;
+} | {
+    readonly status: 'failed' | 'cancelled' | 'conflicted';
+    readonly modelExecutionId: string;
+    readonly error: AcmeErrorData;
+    readonly diagnostic: ModelExecutionDiagnostic;
+};
+export interface ModelExecuteOptions {
+    readonly signal?: AbortSignal;
+    readonly onEvent?: (event: import('./model.js').ModelStreamEvent) => void | Promise<void>;
+}
+export interface ModelExecutionRecord {
+    readonly modelExecutionId: string;
+    readonly requestKey: string;
+    readonly requestFingerprint: string;
+    readonly requestHash: string;
+    readonly selection: ModelSelection;
+    readonly request: ModelRequest;
+    readonly requiredCapabilities: Partial<ModelCapabilities>;
+    readonly policy: ModelExecutionPolicy;
+    readonly status: ModelExecutionStatus;
+    readonly createdAt: IsoTimestamp;
+    readonly updatedAt: IsoTimestamp;
+    readonly error?: AcmeErrorData;
+    readonly diagnostic?: ModelExecutionDiagnostic;
+    readonly result?: ModelExecutionResult;
+}
+export type JsonObject = {
+    readonly [key: string]: JsonValue;
+};
+//# sourceMappingURL=model-execution-types.d.ts.map

package/dist/model-execution-types.d.ts.map

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

package/dist/model-execution-types.js

@@ -0,0 +1,8 @@
+export const ACME_MODEL_EXECUTION_MAX_REQUEST_BYTES = 1_048_576;
+export const ACME_MODEL_EXECUTION_MAX_STREAM_EVENT_BYTES = 65_536;
+export const ACME_MODEL_EXECUTION_MAX_RETAINED_PAYLOAD_BYTES = 1_048_576;
+export const DEFAULT_MODEL_EXECUTION_POLICY = Object.freeze({
+    timeoutMs: 30_000,
+    retention: 'hash-only',
+});
+//# sourceMappingURL=model-execution-types.js.map

package/dist/model-execution-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-execution-types.js","sourceRoot":"","sources":["../src/model-execution-types.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,sCAAsC,GAAG,SAAkB,CAAC;AACzE,MAAM,CAAC,MAAM,2CAA2C,GAAG,MAAe,CAAC;AAC3E,MAAM,CAAC,MAAM,+CAA+C,GAC1D,SAAkB,CAAC;AAErB,MAAM,CAAC,MAAM,8BAA8B,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1D,SAAS,EAAE,MAAM;IACjB,SAAS,EAAE,WAAW;CACvB,CAAgC,CAAC"}

package/dist/model-gateway-router.d.ts

@@ -0,0 +1,11 @@
+import { type ModelGateway } from './model.js';
+export interface RoutedModelGatewayOptions {
+    readonly routes: Readonly<Record<string, ModelGateway>>;
+}
+/**
+ * Composition-time ModelGateway that delegates only to a route whose key
+ * equals the caller-owned providerHint. Missing and unknown hints fail
+ * before dispatch. Core does not infer a provider from the model name.
+ */
+export declare function createRoutedModelGateway(options: RoutedModelGatewayOptions): ModelGateway;
+//# sourceMappingURL=model-gateway-router.d.ts.map

package/dist/model-gateway-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-gateway-router.d.ts","sourceRoot":"","sources":["../src/model-gateway-router.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,YAAY,EAKlB,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;CACzD;AA2CD;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,yBAAyB,GACjC,YAAY,CA8Cd"}

package/dist/model-gateway-router.js

@@ -0,0 +1,69 @@
+import { AcmeError } from './errors.js';
+import {} from './model.js';
+import { validateModelSelection } from './model-validation.js';
+function fail(code, message, details) {
+    throw new AcmeError({
+        code,
+        message,
+        stage: 'calling-model',
+        retryable: false,
+        ...(details === undefined ? {} : { details }),
+    });
+}
+function resolveRoute(routes, selection) {
+    const normalized = validateModelSelection(selection);
+    const hint = normalized.providerHint;
+    if (hint === undefined) {
+        fail('INVALID_REQUEST', 'Routed model execution requires an explicit providerHint.', { selection: normalized });
+    }
+    const gateway = routes.get(hint);
+    if (gateway === undefined) {
+        fail('INVALID_REQUEST', 'No configured provider route matches the selection.', {
+            providerHint: hint,
+            configured: [...routes.keys()],
+        });
+    }
+    return gateway;
+}
+/**
+ * Composition-time ModelGateway that delegates only to a route whose key
+ * equals the caller-owned providerHint. Missing and unknown hints fail
+ * before dispatch. Core does not infer a provider from the model name.
+ */
+export function createRoutedModelGateway(options) {
+    const routes = new Map();
+    for (const [key, gateway] of Object.entries(options.routes)) {
+        const trimmed = key.trim();
+        if (trimmed.length === 0) {
+            throw new Error('Routed model gateway route keys must be non-empty.');
+        }
+        if (routes.has(trimmed)) {
+            throw new Error(`Duplicate routed model gateway route: ${trimmed}`);
+        }
+        routes.set(trimmed, gateway);
+    }
+    if (routes.size === 0) {
+        throw new Error('Routed model gateway requires at least one route.');
+    }
+    return {
+        async capabilities(selection) {
+            return resolveRoute(routes, selection).capabilities(selection);
+        },
+        async generate(request, context) {
+            return resolveRoute(routes, context.selection).generate(request, context);
+        },
+        async *stream(request, context) {
+            const gateway = resolveRoute(routes, context.selection);
+            const stream = gateway.stream?.bind(gateway);
+            if (stream === undefined) {
+                fail('UNSUPPORTED_CAPABILITY', 'The selected provider route cannot stream.', {
+                    ...(context.selection.providerHint === undefined
+                        ? {}
+                        : { providerHint: context.selection.providerHint }),
+                });
+            }
+            yield* stream(request, context);
+        },
+    };
+}
+//# sourceMappingURL=model-gateway-router.js.map

package/dist/model-gateway-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-gateway-router.js","sourceRoot":"","sources":["../src/model-gateway-router.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAsB,MAAM,aAAa,CAAC;AAC5D,OAAO,EAQN,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAM/D,SAAS,IAAI,CACX,IAAmB,EACnB,OAAe,EACf,OAAmB;IAEnB,MAAM,IAAI,SAAS,CAAC;QAClB,IAAI;QACJ,OAAO;QACP,KAAK,EAAE,eAAe;QACtB,SAAS,EAAE,KAAK;QAChB,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;KAC9C,CAAC,CAAC;AACL,CAAC;AAED,SAAS,YAAY,CACnB,MAAyC,EACzC,SAAyB;IAEzB,MAAM,UAAU,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,UAAU,CAAC,YAAY,CAAC;IACrC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,IAAI,CACF,iBAAiB,EACjB,2DAA2D,EAC3D,EAAE,SAAS,EAAE,UAAkC,EAAE,CAClD,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,IAAI,CACF,iBAAiB,EACjB,qDAAqD,EACrD;YACE,YAAY,EAAE,IAAI;YAClB,UAAU,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;SAC/B,CACF,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAkC;IAElC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC/C,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5D,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAC3B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,yCAAyC,OAAO,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IAED,OAAO;QACL,KAAK,CAAC,YAAY,CAAC,SAAyB;YAC1C,OAAO,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QACjE,CAAC;QACD,KAAK,CAAC,QAAQ,CACZ,OAAqB,EACrB,OAA2B;YAE3B,OAAO,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5E,CAAC;QACD,KAAK,CAAC,CAAC,MAAM,CACX,OAAqB,EACrB,OAA2B;YAE3B,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;YACxD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,IAAI,CACF,wBAAwB,EACxB,4CAA4C,EAC5C;oBACE,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,KAAK,SAAS;wBAC9C,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;iBACtD,CACF,CAAC;YACJ,CAAC;YACD,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAClC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/model-request-hash.d.ts

@@ -0,0 +1,5 @@
+import type { Hashing } from './common.js';
+import type { ModelRequest } from './model.js';
+export declare const ACME_MODEL_REQUEST_HASH_ALGORITHM: "acme-model-request-hash-1";
+export declare function computeModelRequestHash(request: ModelRequest, hashing?: Hashing): string;
+//# sourceMappingURL=model-request-hash.d.ts.map

package/dist/model-request-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-request-hash.d.ts","sourceRoot":"","sources":["../src/model-request-hash.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAa,MAAM,aAAa,CAAC;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,eAAO,MAAM,iCAAiC,EAC5C,2BAAoC,CAAC;AAEvC,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,OAAqB,GAC7B,MAAM,CAQR"}

package/dist/model-request-hash.js

@@ -0,0 +1,11 @@
+import { nodeHashing } from './hashing.js';
+import { validateModelRequest } from './model-validation.js';
+export const ACME_MODEL_REQUEST_HASH_ALGORITHM = 'acme-model-request-hash-1';
+export function computeModelRequestHash(request, hashing = nodeHashing) {
+    const validated = validateModelRequest(request);
+    return hashing.sha256(hashing.canonicalJson({
+        algorithm: ACME_MODEL_REQUEST_HASH_ALGORITHM,
+        request: validated,
+    }));
+}
+//# sourceMappingURL=model-request-hash.js.map

package/dist/model-request-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-request-hash.js","sourceRoot":"","sources":["../src/model-request-hash.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,CAAC,MAAM,iCAAiC,GAC5C,2BAAoC,CAAC;AAEvC,MAAM,UAAU,uBAAuB,CACrC,OAAqB,EACrB,UAAmB,WAAW;IAE9B,MAAM,SAAS,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAChD,OAAO,OAAO,CAAC,MAAM,CACnB,OAAO,CAAC,aAAa,CAAC;QACpB,SAAS,EAAE,iCAAiC;QAC5C,OAAO,EAAE,SAAS;KACK,CAAC,CAC3B,CAAC;AACJ,CAAC"}

package/dist/model-response-hash.d.ts

@@ -0,0 +1,5 @@
+import type { Hashing } from './common.js';
+import type { NormalizedModelResponse } from './model.js';
+export declare const ACME_MODEL_RESPONSE_HASH_ALGORITHM: "acme-model-response-hash-1";
+export declare function computeModelResponseHash(response: NormalizedModelResponse, hashing?: Hashing): string;
+//# sourceMappingURL=model-response-hash.d.ts.map

package/dist/model-response-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-response-hash.d.ts","sourceRoot":"","sources":["../src/model-response-hash.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAa,MAAM,aAAa,CAAC;AAEtD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAG1D,eAAO,MAAM,kCAAkC,EAC7C,4BAAqC,CAAC;AAExC,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,uBAAuB,EACjC,OAAO,GAAE,OAAqB,GAC7B,MAAM,CAQR"}

package/dist/model-response-hash.js

@@ -0,0 +1,11 @@
+import { nodeHashing } from './hashing.js';
+import { validateNormalizedModelResponse } from './model-validation.js';
+export const ACME_MODEL_RESPONSE_HASH_ALGORITHM = 'acme-model-response-hash-1';
+export function computeModelResponseHash(response, hashing = nodeHashing) {
+    const validated = validateNormalizedModelResponse(response);
+    return hashing.sha256(hashing.canonicalJson({
+        algorithm: ACME_MODEL_RESPONSE_HASH_ALGORITHM,
+        response: validated,
+    }));
+}
+//# sourceMappingURL=model-response-hash.js.map

package/dist/model-response-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-response-hash.js","sourceRoot":"","sources":["../src/model-response-hash.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,+BAA+B,EAAE,MAAM,uBAAuB,CAAC;AAExE,MAAM,CAAC,MAAM,kCAAkC,GAC7C,4BAAqC,CAAC;AAExC,MAAM,UAAU,wBAAwB,CACtC,QAAiC,EACjC,UAAmB,WAAW;IAE9B,MAAM,SAAS,GAAG,+BAA+B,CAAC,QAAQ,CAAC,CAAC;IAC5D,OAAO,OAAO,CAAC,MAAM,CACnB,OAAO,CAAC,aAAa,CAAC;QACpB,SAAS,EAAE,kCAAkC;QAC7C,QAAQ,EAAE,SAAS;KACI,CAAC,CAC3B,CAAC;AACJ,CAAC"}

package/dist/model-validation.d.ts

@@ -0,0 +1,11 @@
+import type { GatewayCallContext, ModelCapabilities, ModelRequest, ModelSelection, ModelStreamEvent, NormalizedModelResponse } from './model.js';
+export declare function validateModelSelection(value: ModelSelection): ModelSelection;
+export declare function validateModelCapabilities(value: ModelCapabilities): ModelCapabilities;
+export declare function validateRequiredModelCapabilities(value: Partial<ModelCapabilities>): Partial<ModelCapabilities>;
+export declare function validateModelRequest(value: ModelRequest): ModelRequest;
+export declare function validateNormalizedModelResponse(value: NormalizedModelResponse): NormalizedModelResponse;
+export declare function validateModelStreamEvent(value: ModelStreamEvent): ModelStreamEvent;
+export declare function validateGatewayCallContext(value: GatewayCallContext): GatewayCallContext;
+export declare function missingRequiredModelCapabilities(available: ModelCapabilities, required: Partial<ModelCapabilities>): readonly string[];
+export declare function assertRequiredModelCapabilities(available: ModelCapabilities, required: Partial<ModelCapabilities>): void;
+//# sourceMappingURL=model-validation.d.ts.map

package/dist/model-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-validation.d.ts","sourceRoot":"","sources":["../src/model-validation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EAKjB,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,uBAAuB,EAGxB,MAAM,YAAY,CAAC;AA+jBpB,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CAG5E;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,iBAAiB,GACvB,iBAAiB,CAMnB;AAED,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAChC,OAAO,CAAC,iBAAiB,CAAC,CAM5B;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CAGtE;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,uBAAuB,GAC7B,uBAAuB,CAGzB;AAgHD,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,gBAAgB,GACtB,gBAAgB,CAGlB;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,kBAAkB,GACxB,kBAAkB,CAgDpB;AAED,wBAAgB,gCAAgC,CAC9C,SAAS,EAAE,iBAAiB,EAC5B,QAAQ,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACnC,SAAS,MAAM,EAAE,CAqBnB;AAED,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,iBAAiB,EAC5B,QAAQ,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACnC,IAAI,CAWN"}