@dcdr/contracts 1.9.6

package/dist/capabilities.contract.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CapabilityKey = void 0;
+exports.getRequiredCapabilitiesForIntent = getRequiredCapabilitiesForIntent;
+exports.getRequiredCapabilitiesFromRegistry = getRequiredCapabilitiesFromRegistry;
+exports.getMissingCapabilities = getMissingCapabilities;
+exports.assertCapabilitiesAllowed = assertCapabilitiesAllowed;
+const policies_contract_1 = require("./policies.contract");
+/**
+ * Stable, public capability identifiers derived from configuration/registry usage.
+ *
+ * Purpose
+ * - Provide a single, exportable vocabulary to describe what a given registry/config *requires*.
+ * - Enable:
+ *   - Freeware runtime (`runtime` mode) to reject advanced features (allowlist).
+ *   - Backend tier enforcement to map subscriptions/features to required runtime capabilities.
+ *
+ * Notes
+ * - These are *technical* capabilities, not billing/subscription concepts.
+ * - Keep values stable; they can become part of wire-level compatibility checks.
+ */
+var CapabilityKey;
+(function (CapabilityKey) {
+    /** Prompt canary rollouts (canary prompt + weight). */
+    CapabilityKey["AI_PROMPTS_CANARY"] = "AI_PROMPTS_CANARY";
+    /** Any non-default/advanced execution policy (non-WEIGHTED). */
+    CapabilityKey["AI_INTENTS_ADVANCED_EXECUTION_POLICY"] = "AI_INTENTS_ADVANCED_EXECUTION_POLICY";
+    /** ExecutionPolicy exploration enabled (epsilon-greedy / top-K sampling). */
+    CapabilityKey["AI_INTENTS_EXPLORATION_POLICY"] = "AI_INTENTS_EXPLORATION_POLICY";
+    /** Response caching enabled with per-implementation TTL configuration. */
+    CapabilityKey["AI_RUNTIME_CACHE_TTL_CONFIGURABLE"] = "AI_RUNTIME_CACHE_TTL_CONFIGURABLE";
+    /** Execution window override at the implementation level. */
+    CapabilityKey["AI_BASE_MODEL_EXECUTION_WINDOWS_OVERRIDE_PER_IMPLEMENTATION"] = "AI_BASE_MODEL_EXECUTION_WINDOWS_OVERRIDE_PER_IMPLEMENTATION";
+    // ---------------------------------------------------------------------------
+    // Runtime / platform capabilities (may be enforced by mode, not by registry)
+    // ---------------------------------------------------------------------------
+    /** Backend registry sync (cloud/cloud-pro control plane). */
+    CapabilityKey["AI_RUNTIME_BACKEND_REGISTRY_SYNC"] = "AI_RUNTIME_BACKEND_REGISTRY_SYNC";
+    /** Backend log ingestion (cloud/cloud-pro; runtime/freeware should not send logs to backend). */
+    CapabilityKey["AI_OBSERVABILITY_BACKEND_LOG_INGESTION"] = "AI_OBSERVABILITY_BACKEND_LOG_INGESTION";
+    /** Internal backend bypass auth mode (backend-to-runtime trusted traffic). */
+    CapabilityKey["AI_SECURITY_INTERNAL_BYPASS"] = "AI_SECURITY_INTERNAL_BYPASS";
+})(CapabilityKey || (exports.CapabilityKey = CapabilityKey = {}));
+/**
+ * Extracts required capabilities for a single intent.
+ * @param intent The intent contract to inspect.
+ * @returns Required capabilities for this intent.
+ */
+function getRequiredCapabilitiesForIntent(intent) {
+    const out = [];
+    if (!intent)
+        return out;
+    if (intent.canaryPrompt || (typeof intent.canaryPromptWeight === "number" && intent.canaryPromptWeight > 0)) {
+        out.push(CapabilityKey.AI_PROMPTS_CANARY);
+    }
+    if (intent.executionPolicy && intent.executionPolicy.type !== policies_contract_1.ExecutionPolicyType.WEIGHTED) {
+        out.push(CapabilityKey.AI_INTENTS_ADVANCED_EXECUTION_POLICY);
+    }
+    if (intent.executionPolicy && intent.executionPolicy.exploration) {
+        out.push(CapabilityKey.AI_INTENTS_EXPLORATION_POLICY);
+    }
+    const implementations = Array.isArray(intent.implementations) ? intent.implementations : [];
+    for (const impl of implementations) {
+        if (!impl)
+            continue;
+        if (typeof impl.cacheTTLSeconds === "number" && impl.cacheTTLSeconds > 0) {
+            out.push(CapabilityKey.AI_RUNTIME_CACHE_TTL_CONFIGURABLE);
+        }
+        if (impl.executionWindow) {
+            out.push(CapabilityKey.AI_BASE_MODEL_EXECUTION_WINDOWS_OVERRIDE_PER_IMPLEMENTATION);
+        }
+    }
+    return out;
+}
+/**
+ * Derives the set of required capabilities implied by a registry.
+ *
+ * Intended usage
+ * - Runtime freeware mode: compare with an allowlist and fail loudly when unsupported.
+ * - Backend: map subscription/module-features to capabilities and enforce before emitting a registry.
+ *
+ * @param registry The registry to inspect.
+ * @returns Unique capability keys required by the registry.
+ */
+function getRequiredCapabilitiesFromRegistry(registry) {
+    const unique = new Set();
+    const intents = registry && Array.isArray(registry.intents) ? registry.intents : [];
+    for (const intent of intents) {
+        for (const cap of getRequiredCapabilitiesForIntent(intent)) {
+            unique.add(cap);
+        }
+    }
+    return Array.from(unique.values());
+}
+/**
+ * Returns the capabilities that are required but not present in the allowlist.
+ * @param required Required capabilities.
+ * @param allowed Allowed capabilities.
+ * @returns Missing capabilities.
+ */
+function getMissingCapabilities(required, allowed) {
+    const allowedSet = new Set(Array.isArray(allowed) ? allowed : []);
+    const out = [];
+    for (const cap of Array.isArray(required) ? required : []) {
+        if (!allowedSet.has(cap))
+            out.push(cap);
+    }
+    return out;
+}
+/**
+ * Asserts that all required capabilities are in the allowlist.
+ *
+ * Intended usage
+ * - Freeware runtime mode: reject registries/configurations that require pro/cloud capabilities.
+ *
+ * @param required Required capabilities.
+ * @param allowed Allowed capabilities.
+ * @param context Optional context string included in error messages.
+ */
+function assertCapabilitiesAllowed(required, allowed, context) {
+    const missing = getMissingCapabilities(required, allowed);
+    if (missing.length === 0)
+        return;
+    const ctx = context ? ` (${context})` : "";
+    throw new Error(`Unsupported capabilities${ctx}: ${missing.join(", ")}`);
+}

package/dist/control.contract.d.ts

@@ -0,0 +1,39 @@
+import { CredentialsContract } from "./credentials.contract";
+import { IntentContract } from "./intent.contract";
+/**
+ * DCDR Registry designed in the backend and consumed by DCDR server.
+ */
+export interface DcdrRegistry {
+    /**
+     * SHA256 hash of the registry bundle (stable JSON serialization).
+     * Useful as an immutable fingerprint / audit trail.
+     */
+    sha256: string;
+    /** When the bundle was generated by the backend (ISO string). */
+    generatedAt?: string;
+    /**
+     * Optional cryptographic signature for this registry bundle.
+     *
+     * Intended usage
+     * - When present and valid, the runtime can treat the registry as "trusted backend-issued".
+     * - This allows enabling cloud/cloud-pro capabilities while preventing a fake backend from injecting pro-only configuration.
+     *
+    * Signing payload
+    * - Registry `sha256` string (UTF-8 bytes).
+    *
+    * Recommended algorithm
+    * - Ed25519 signature by backend (private key) verified by runtime (embedded public key).
+    * - This raises the bar against a "fake backend" serving a pro-enabled registry.
+    *
+    * Encoding
+    * - Base64-encoded signature.
+     */
+    signature?: string;
+    /** Optional key id / version for signature rotation (backend-defined). */
+    signatureKeyId?: string;
+    /** Full list of intent contracts */
+    intents: IntentContract[];
+    /** Full list of credential contracts */
+    credentials?: CredentialsContract[];
+}
+//# sourceMappingURL=control.contract.d.ts.map

package/dist/control.contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.contract.d.ts","sourceRoot":"","sources":["../src/control.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD;;GAEG;AACH,MAAM,WAAW,YAAY;IAG3B;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;;;;;;;;;;;;OAgBG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,oCAAoC;IACpC,OAAO,EAAE,cAAc,EAAE,CAAC;IAE1B,wCAAwC;IACxC,WAAW,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACrC"}

package/dist/control.contract.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/credentials.contract.d.ts

@@ -0,0 +1,37 @@
+import { IntentProvider } from "./provider.contract";
+import { HttpRequestParams } from "./http.contract";
+/**
+ * How a credential is resolved into concrete HTTP request parameters.
+ *
+ * Security model
+ * - `INLINE`: Secrets (headers/query/cookies) are carried inside the registry.
+ * - `BACKEND`: Registry carries only a reference; runtime resolves secrets from backend at execution time.
+ */
+export declare enum CredentialsResolutionMode {
+    INLINE = "INLINE",
+    BACKEND = "BACKEND"
+}
+/**
+ * Represents credentials used to authenticate provider requests.
+ * Implementations reference credentials via credentialRef.
+ */
+export interface CredentialsContract {
+    id: string;
+    name: string;
+    description?: string;
+    /**
+     * Resolution strategy.
+     * - Omitted defaults to `INLINE` for backward compatibility.
+     */
+    resolution?: CredentialsResolutionMode;
+    /**
+     * Optional provider hint for UI, filtering or validation.
+     * Credentials remain provider-agnostic at runtime.
+     */
+    provider?: IntentProvider;
+    /** HTTP headers/query injected into provider requests */
+    readonly headers?: HttpRequestParams["headers"];
+    readonly query?: HttpRequestParams["query"];
+    readonly cookies?: HttpRequestParams["cookies"];
+}
+//# sourceMappingURL=credentials.contract.d.ts.map

package/dist/credentials.contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.contract.d.ts","sourceRoot":"","sources":["../src/credentials.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;;;;;GAMG;AACH,oBAAY,yBAAyB;IACnC,MAAM,WAAW;IACjB,OAAO,YAAY;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,UAAU,CAAC,EAAE,yBAAyB,CAAC;IAEvC;;;OAGG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;IAE1B,yDAAyD;IACzD,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;CACjD"}

package/dist/credentials.contract.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CredentialsResolutionMode = void 0;
+/**
+ * How a credential is resolved into concrete HTTP request parameters.
+ *
+ * Security model
+ * - `INLINE`: Secrets (headers/query/cookies) are carried inside the registry.
+ * - `BACKEND`: Registry carries only a reference; runtime resolves secrets from backend at execution time.
+ */
+var CredentialsResolutionMode;
+(function (CredentialsResolutionMode) {
+    CredentialsResolutionMode["INLINE"] = "INLINE";
+    CredentialsResolutionMode["BACKEND"] = "BACKEND";
+})(CredentialsResolutionMode || (exports.CredentialsResolutionMode = CredentialsResolutionMode = {}));

package/dist/entitlements.contract.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Generic entitlement snapshot for a gateway/runtime.
+ *
+ * Keep this contract business-agnostic:
+ * - "limits" are pure technical quotas
+ * - "usageBaseline" is a snapshot for the current billing window
+ *
+ * Backend remains source-of-truth; runtime uses snapshot + local delta.
+ */
+import { SubscriptionStatus } from "./subscription.contract";
+/**
+ * Hard/soft technical limits enforced by the runtime.
+ */
+export interface DcdrEntitlementLimits {
+    /** Hard limit (monthly). Null = unlimited. */
+    maxCallsPerMonth: number | null;
+    /** Optional hard limits for shorter windows. Null = unlimited / not enforced. */
+    maxCallsPerHour?: number | null;
+    maxCallsPerDay?: number | null;
+    /** Soft limit: after this, runtime should disable I/O tracking/log enrichment. */
+    maxTrackedCallsPerMonth?: number | null;
+}
+/**
+ * Backend-provided usage baseline for the current billing window.
+ * Runtime uses this + local counters to enforce quotas.
+ */
+export interface DcdrEntitlementUsageBaseline {
+    /** Billing window key in UTC, e.g. "2026-03" */
+    periodKey: string;
+    /** Baseline calls already accounted for in backend for this period. */
+    callsThisMonth: number;
+    /** Baseline tracked calls already accounted for (optional). */
+    trackedCallsThisMonth?: number;
+}
+/**
+ * Optional business-level limits (primarily used by UI/control plane).
+ *
+ * Notes
+ * - Runtime should not rely on these for critical enforcement.
+ * - These fields are included so clients can display subscription/plan info.
+ */
+export interface DcdrBusinessLimitsContract {
+    maxUsers?: number;
+    maxServiceTokens?: number;
+    logRetentionDays?: number;
+    maxIntents?: number;
+    maxImplementations?: number;
+    maxPromptTemplates?: number;
+    maxCredentials?: number;
+    maxExecutionWindows?: number;
+    maxWebhooks?: number;
+}
+/**
+ * Optional business-level usage counters (primarily used by UI/control plane).
+ */
+export interface DcdrBusinessUsageContract {
+    users?: number;
+    serviceTokens?: number;
+    implementations?: number;
+    intents?: number;
+    promptTemplates?: number;
+    credentials?: number;
+    executionWindows?: number;
+    webhooks?: number;
+}
+/**
+ * Entitlements snapshot returned by the backend and cached in the runtime.
+ *
+ * Notes
+ * - Runtime enforces `limits` and uses `usageBaseline`.
+ * - Other fields are optional and mainly for diagnostics / UI parity.
+ */
+export interface DcdrEntitlementsContract {
+    cid: string;
+    limits: DcdrEntitlementLimits;
+    usageBaseline: DcdrEntitlementUsageBaseline;
+    /**
+     * Optional gate controlling whether the tenant can use the paid DCDR virtual provider.
+     *
+     * Notes
+     * - Additive and fail-open: when omitted, the runtime must assume the virtual provider is enabled.
+     * - Intended for wallet/balance enforcement in managed (cloud) mode without affecting BYOK providers.
+     */
+    dcdrVirtual?: {
+        /** When false, runtime must block executions that target `IntentProvider.DCDR`. */
+        enabled: boolean;
+        /** Optional business-friendly reason code (no sensitive details). */
+        reason?: string;
+        /** Optional hint for clients on when to retry (ms). */
+        retryAfterMs?: number;
+    };
+    /** Optional reset time for quotas (unix ms). */
+    resetAt?: number;
+    /** Issued at (unix ms). Optional. */
+    iat?: number;
+    /** Optional subscription/contract status (backend-defined), e.g. `TRIAL`. */
+    subscriptionStatus?: SubscriptionStatus;
+    /** Optional subscription end date (unix ms). */
+    subscriptionEndDateMs?: number;
+    /** Optional log retention in days (may mirror businessLimits.logRetentionDays). */
+    logRetentionDays?: number;
+    /** Optional business/UI limits snapshot. */
+    businessLimits?: DcdrBusinessLimitsContract;
+    /** Optional business/UI usage snapshot. */
+    businessUsage?: DcdrBusinessUsageContract;
+}
+//# sourceMappingURL=entitlements.contract.d.ts.map

package/dist/entitlements.contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entitlements.contract.d.ts","sourceRoot":"","sources":["../src/entitlements.contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,8CAA8C;IAC9C,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B,kFAAkF;IAClF,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IAC3C,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAElB,uEAAuE;IACvE,cAAc,EAAE,MAAM,CAAC;IAEvB,+DAA+D;IAC/D,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,qBAAqB,CAAC;IAC9B,aAAa,EAAE,4BAA4B,CAAC;IAE5C;;;;;;OAMG;IACH,WAAW,CAAC,EAAE;QACZ,mFAAmF;QACnF,OAAO,EAAE,OAAO,CAAC;QAEjB,qEAAqE;QACrE,MAAM,CAAC,EAAE,MAAM,CAAC;QAEhB,uDAAuD;QACvD,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IAEF,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,qCAAqC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,6EAA6E;IAC7E,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IAExC,gDAAgD;IAChD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B,mFAAmF;IACnF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,4CAA4C;IAC5C,cAAc,CAAC,EAAE,0BAA0B,CAAC;IAE5C,2CAA2C;IAC3C,aAAa,CAAC,EAAE,yBAAyB,CAAC;CAC3C"}

package/dist/entitlements.contract.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Generic entitlement snapshot for a gateway/runtime.
+ *
+ * Keep this contract business-agnostic:
+ * - "limits" are pure technical quotas
+ * - "usageBaseline" is a snapshot for the current billing window
+ *
+ * Backend remains source-of-truth; runtime uses snapshot + local delta.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/errors.contract.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Error info for a single attempt or final result.
+ * Keep codes stable because your backend may do analytics on them.
+ */
+export declare enum ExecutionErrorCode {
+    BAD_REQUEST = "BAD_REQUEST",
+    TOKEN_BUDGET_TOO_LOW = "TOKEN_BUDGET_TOO_LOW",
+    INVALID_INPUT = "INVALID_INPUT",
+    VALIDATION_ERROR = "VALIDATION_ERROR",
+    UNSUPPORTED_OPERATION = "UNSUPPORTED_OPERATION",
+    MISSING_VARIABLE = "MISSING_VARIABLE",
+    CONFIG_ERROR = "CONFIG_ERROR",
+    RULES_ERROR = "RULES_ERROR",
+    INVALID_OPERATION = "INVALID_OPERATION",
+    MODEL_NOT_FOUND = "MODEL_NOT_FOUND",
+    MODEL_UNSUPPORTED = "MODEL_UNSUPPORTED",
+    PAYMENT_REQUIRED = "PAYMENT_REQUIRED",
+    INVALID_CREDENTIALS = "INVALID_CREDENTIALS",
+    NO_CONFIG = "NO_CONFIG",
+    NO_ACTIVE_MODEL = "NO_ACTIVE_MODEL",
+    NO_ELIGIBLE_IMPLEMENTATION = "NO_ELIGIBLE_IMPLEMENTATION",
+    PROVIDER_ERROR = "PROVIDER_ERROR",
+    PROVIDER_EMPTY_RESPONSE = "PROVIDER_EMPTY_RESPONSE",
+    TIMEOUT = "TIMEOUT",
+    RATE_LIMIT = "RATE_LIMIT",
+    UPSTREAM_5XX = "UPSTREAM_5XX",
+    NETWORK = "NETWORK",
+    PARSE_FAIL = "PARSE_FAIL",
+    SCHEMA_FAIL = "SCHEMA_FAIL",
+    INTERNAL_ERROR = "INTERNAL_ERROR",
+    CIRCUIT_OPEN = "CIRCUIT_OPEN"
+}
+export interface ExecutionError {
+    /**
+     * Stable, analytics-friendly code.
+     */
+    code: ExecutionErrorCode;
+    message: string;
+    providerStatus?: number;
+    details?: any;
+}
+/**
+ * Runtime guard for checking whether a string is a known execution error code.
+ */
+export declare function isExecutionErrorCode(code: string): code is ExecutionErrorCode;
+export declare function createExecutionError(code: ExecutionErrorCode, message: string, details?: any, providerStatus?: number): ExecutionError;
+//# sourceMappingURL=errors.contract.d.ts.map

package/dist/errors.contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.contract.d.ts","sourceRoot":"","sources":["../src/errors.contract.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,kBAAkB;IAC5B,WAAW,gBAAgB;IAC3B,oBAAoB,yBAAyB;IAC7C,aAAa,kBAAkB;IAC/B,gBAAgB,qBAAqB;IACrC,qBAAqB,0BAA0B;IAC/C,gBAAgB,qBAAqB;IACrC,YAAY,iBAAiB;IAC7B,WAAW,gBAAgB;IAC3B,iBAAiB,sBAAsB;IACvC,eAAe,oBAAoB;IACnC,iBAAiB,sBAAsB;IACvC,gBAAgB,qBAAqB;IACrC,mBAAmB,wBAAwB;IAC3C,SAAS,cAAc;IACvB,eAAe,oBAAoB;IACnC,0BAA0B,+BAA+B;IACzD,cAAc,mBAAmB;IACjC,uBAAuB,4BAA4B;IACnD,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,YAAY,iBAAiB;IAC7B,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,WAAW,gBAAgB;IAC3B,cAAc,mBAAmB;IACjC,YAAY,iBAAiB;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,GAAG,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,kBAAkB,CAG7E;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,kBAAkB,EACxB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,GAAG,EACb,cAAc,CAAC,EAAE,MAAM,GACtB,cAAc,CAEhB"}

package/dist/errors.contract.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExecutionErrorCode = void 0;
+exports.isExecutionErrorCode = isExecutionErrorCode;
+exports.createExecutionError = createExecutionError;
+/**
+ * Error info for a single attempt or final result.
+ * Keep codes stable because your backend may do analytics on them.
+ */
+var ExecutionErrorCode;
+(function (ExecutionErrorCode) {
+    ExecutionErrorCode["BAD_REQUEST"] = "BAD_REQUEST";
+    ExecutionErrorCode["TOKEN_BUDGET_TOO_LOW"] = "TOKEN_BUDGET_TOO_LOW";
+    ExecutionErrorCode["INVALID_INPUT"] = "INVALID_INPUT";
+    ExecutionErrorCode["VALIDATION_ERROR"] = "VALIDATION_ERROR";
+    ExecutionErrorCode["UNSUPPORTED_OPERATION"] = "UNSUPPORTED_OPERATION";
+    ExecutionErrorCode["MISSING_VARIABLE"] = "MISSING_VARIABLE";
+    ExecutionErrorCode["CONFIG_ERROR"] = "CONFIG_ERROR";
+    ExecutionErrorCode["RULES_ERROR"] = "RULES_ERROR";
+    ExecutionErrorCode["INVALID_OPERATION"] = "INVALID_OPERATION";
+    ExecutionErrorCode["MODEL_NOT_FOUND"] = "MODEL_NOT_FOUND";
+    ExecutionErrorCode["MODEL_UNSUPPORTED"] = "MODEL_UNSUPPORTED";
+    ExecutionErrorCode["PAYMENT_REQUIRED"] = "PAYMENT_REQUIRED";
+    ExecutionErrorCode["INVALID_CREDENTIALS"] = "INVALID_CREDENTIALS";
+    ExecutionErrorCode["NO_CONFIG"] = "NO_CONFIG";
+    ExecutionErrorCode["NO_ACTIVE_MODEL"] = "NO_ACTIVE_MODEL";
+    ExecutionErrorCode["NO_ELIGIBLE_IMPLEMENTATION"] = "NO_ELIGIBLE_IMPLEMENTATION";
+    ExecutionErrorCode["PROVIDER_ERROR"] = "PROVIDER_ERROR";
+    ExecutionErrorCode["PROVIDER_EMPTY_RESPONSE"] = "PROVIDER_EMPTY_RESPONSE";
+    ExecutionErrorCode["TIMEOUT"] = "TIMEOUT";
+    ExecutionErrorCode["RATE_LIMIT"] = "RATE_LIMIT";
+    ExecutionErrorCode["UPSTREAM_5XX"] = "UPSTREAM_5XX";
+    ExecutionErrorCode["NETWORK"] = "NETWORK";
+    ExecutionErrorCode["PARSE_FAIL"] = "PARSE_FAIL";
+    ExecutionErrorCode["SCHEMA_FAIL"] = "SCHEMA_FAIL";
+    ExecutionErrorCode["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+    ExecutionErrorCode["CIRCUIT_OPEN"] = "CIRCUIT_OPEN";
+})(ExecutionErrorCode || (exports.ExecutionErrorCode = ExecutionErrorCode = {}));
+/**
+ * Runtime guard for checking whether a string is a known execution error code.
+ */
+function isExecutionErrorCode(code) {
+    // Object.values on string enums returns the string values.
+    return Object.values(ExecutionErrorCode).includes(code);
+}
+function createExecutionError(code, message, details, providerStatus) {
+    return { code, message, details, providerStatus };
+}