@wildo-ai/saas-models 1.0.1 → 1.1.0

package/dist/esm/external-providers/provider-metadata.shared.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-metadata.shared.schemas.js","sourceRoot":"","sources":["../../../../src/external-providers/provider-metadata.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;GAMG;AACH,MAAM,UAAU,gCAAgC,CAAC,WAAmB;IAClE,OAAO,aAAa,WAAW,cAAc,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C;;;;OAIG;IACH,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf;;;;;OAKG;IACH,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1C;;;OAGG;IACH,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC;;;;OAIG;IACH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC","sourcesContent":["/**\n * `ProviderMetadata` — shared, frontend-safe header carried by every\n * provider module across every facet (backend, frontend-app, techdoc,\n * website).\n *\n * Intentionally **frontend-safe**: holds no secrets, no protocol\n * contracts, no backend behavior. The fields are exactly what a UI needs\n * to render a provider entry (translation-ready display-name key, optional\n * legacy fallback label, optional icon ref) plus the stable `ref` used as\n * the join key between facet modules.\n *\n * Phase 0 of the provider-registration refactor introduces this type as\n * the single source of truth for provider header information so that the\n * cross-facet seam (`FrontendBootstrapBackendService`) can project a\n * `BackendProviderModule` into a `FrontendProviderEntry` without ever\n * leaking backend-only fields.\n *\n * See `.cursor/plans/provider-registration-refactor-implementation-plan.md`\n * §Phase 0.1 for the full rationale.\n */\n\nimport { z } from 'zod';\n\n/**\n * Translation key builder for provider display names.\n *\n * Provider modules stay locale-neutral by exporting this stable label key;\n * consuming frontend surfaces resolve it via the app i18n service at render\n * time instead of freezing human copy into generated/runtime artifacts.\n */\nexport function buildProviderDisplayNameLabelKey(providerRef: string): string {\n  return `providers.${providerRef}.displayName`;\n}\n\nexport const ProviderMetadataSchema = z.object({\n  /**\n   * Stable identifier for the provider, e.g. `'resend'`, `'stripe'`,\n   * `'openai'`. Used as the join key across facet modules and as the\n   * map key inside `BackendProviderRegistry.modules`.\n   */\n  ref: z.string(),\n  /**\n   * Translation-ready key for the provider display name.\n   *\n   * Frontend/public surfaces should prefer this field over embedding\n   * locale-bound copy in provider modules or runtime artifacts.\n   */\n  displayNameLabelKey: z.string().optional(),\n  /**\n   * Legacy human-readable fallback label for non-i18n-aware consumers.\n   * When absent, consumers fall back to the `ref`.\n   */\n  displayName: z.string().optional(),\n  /**\n   * Optional icon reference resolved through the frontend icon registry.\n   * Stays a string (not a URL or component reference) to keep this type\n   * frontend-safe AND portable to non-React surfaces.\n   */\n  iconRef: z.string().optional(),\n});\n\nexport type ProviderMetadata = z.infer<typeof ProviderMetadataSchema>;\n"]}

package/dist/esm/external-providers/provider-protocol.shared.schemas.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Closed built-in provider protocol vocabulary used by app authoring and
+ * runtime-provider declarations.
+ *
+ * This is intentionally a pure `as const` object + union type so browser-bound
+ * packages can consume it through `@wildo-ai/saas-models/public-runtime`
+ * without pulling decorators or broader config-authoring seams. Do NOT add an
+ * import here — not even an `import type` of the engine enum this list mirrors.
+ *
+ * ## Relationship to `ExternalProvider_ExchangeProtocol_Kind`
+ *
+ * This list re-states a population the engine owns: every member of
+ * `ExternalProvider_ExchangeProtocol_Kind`
+ * (`@wildo-ai/external-connectors-models`) that an application may legally
+ * WRITE in `wildo.saas.config.ts > providers.scopes.<scope>.providers.<ref>`.
+ * Two hand-maintained enumerations of one population is the shape that drifts,
+ * and this one did: `IMAGE_PROVIDER` and `EMBEDDINGS_PROVIDER` shipped as live
+ * engine protocols — a provider module declares them, discovery reports them,
+ * the backend registry resolves them — while this list had no legal value for
+ * either, so no application could declare what those transports speak.
+ *
+ * The keys are therefore checked against the engine enum by
+ * `__tests__/provider-protocol-vocabulary.drift.test.ts`, which also owns the
+ * documented allow-list of deliberate exclusions. **`AUDIO_PROVIDER` and
+ * `VIDEO_PROVIDER` are deliberately absent** — see that file for the reason and
+ * for the exact condition under which they are admitted.
+ */
+export declare const BUILTIN_PROVIDER_PROTOCOL: {
+    readonly REST_API: "REST_API";
+    readonly WEBHOOK_ORIGINATOR: "WEBHOOK_ORIGINATOR";
+    readonly LLM_PROVIDER: "LLM_PROVIDER";
+    readonly AGENT_CLIENT_PROTOCOL: "AGENT_CLIENT_PROTOCOL";
+    readonly MCP_CONNECTOR: "MCP_CONNECTOR";
+    readonly A2A_CONNECTOR: "A2A_CONNECTOR";
+    /**
+     * Text-to-image generation (wired: gpt-image, via the OpenAI provider's
+     * `IMAGE_PROVIDER` transport). Serves the IMAGE artifact modality.
+     */
+    readonly IMAGE_PROVIDER: "IMAGE_PROVIDER";
+    /**
+     * Text → vector embeddings (wired: OpenAI `text-embedding-3-*`). Serves the
+     * RAG derived-data tier — corpus embedding in the `rag:embedding-drain`
+     * worker, query-time embedding in retrieval. Its own protocol rather than an
+     * `LLM_PROVIDER` operation so a provider can be selected for embeddings
+     * independently of chat.
+     */
+    readonly EMBEDDINGS_PROVIDER: "EMBEDDINGS_PROVIDER";
+    /**
+     * Document bytes → text (wired: Mistral `mistral-ocr-latest`). Serves file text extraction and
+     * the `.ragSource()` corpus built on it, and fills `EngineCapability.AI_DOCUMENT_EXTRACTION` so
+     * an OCR provider is selected independently of chat and embeddings.
+     */
+    readonly DOCUMENT_EXTRACTION_PROVIDER: "DOCUMENT_EXTRACTION_PROVIDER";
+    readonly EMAIL_PROVIDER: "EMAIL_PROVIDER";
+    readonly GIT_PROVIDER: "GIT_PROVIDER";
+    readonly GRPC: "GRPC";
+    readonly SSO_OAUTH2: "SSO_OAUTH2";
+    readonly SSO_SAML: "SSO_SAML";
+    readonly BILLING_PROVIDER: "BILLING_PROVIDER";
+    readonly SMS_PROVIDER: "SMS_PROVIDER";
+    readonly FRONTEND_SDK: "FRONTEND_SDK";
+};
+export type BuiltinProviderProtocol = (typeof BUILTIN_PROVIDER_PROTOCOL)[keyof typeof BUILTIN_PROVIDER_PROTOCOL];
+export type ProviderProtocol = BuiltinProviderProtocol;
+//# sourceMappingURL=provider-protocol.shared.schemas.d.ts.map

package/dist/esm/external-providers/provider-protocol.shared.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-protocol.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/external-providers/provider-protocol.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,yBAAyB;;;;;;;IAOpC;;;OAGG;;IAEH;;;;;;OAMG;;IAEH;;;;OAIG;;;;;;;;;;CAUK,CAAC;AAEX,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,OAAO,yBAAyB,CAAC,CAAC;AAE7E,MAAM,MAAM,gBAAgB,GAAG,uBAAuB,CAAC"}

package/dist/esm/external-providers/provider-protocol.shared.schemas.js

@@ -0,0 +1,63 @@
+/**
+ * Closed built-in provider protocol vocabulary used by app authoring and
+ * runtime-provider declarations.
+ *
+ * This is intentionally a pure `as const` object + union type so browser-bound
+ * packages can consume it through `@wildo-ai/saas-models/public-runtime`
+ * without pulling decorators or broader config-authoring seams. Do NOT add an
+ * import here — not even an `import type` of the engine enum this list mirrors.
+ *
+ * ## Relationship to `ExternalProvider_ExchangeProtocol_Kind`
+ *
+ * This list re-states a population the engine owns: every member of
+ * `ExternalProvider_ExchangeProtocol_Kind`
+ * (`@wildo-ai/external-connectors-models`) that an application may legally
+ * WRITE in `wildo.saas.config.ts > providers.scopes.<scope>.providers.<ref>`.
+ * Two hand-maintained enumerations of one population is the shape that drifts,
+ * and this one did: `IMAGE_PROVIDER` and `EMBEDDINGS_PROVIDER` shipped as live
+ * engine protocols — a provider module declares them, discovery reports them,
+ * the backend registry resolves them — while this list had no legal value for
+ * either, so no application could declare what those transports speak.
+ *
+ * The keys are therefore checked against the engine enum by
+ * `__tests__/provider-protocol-vocabulary.drift.test.ts`, which also owns the
+ * documented allow-list of deliberate exclusions. **`AUDIO_PROVIDER` and
+ * `VIDEO_PROVIDER` are deliberately absent** — see that file for the reason and
+ * for the exact condition under which they are admitted.
+ */
+export const BUILTIN_PROVIDER_PROTOCOL = {
+    REST_API: 'REST_API',
+    WEBHOOK_ORIGINATOR: 'WEBHOOK_ORIGINATOR',
+    LLM_PROVIDER: 'LLM_PROVIDER',
+    AGENT_CLIENT_PROTOCOL: 'AGENT_CLIENT_PROTOCOL',
+    MCP_CONNECTOR: 'MCP_CONNECTOR',
+    A2A_CONNECTOR: 'A2A_CONNECTOR',
+    /**
+     * Text-to-image generation (wired: gpt-image, via the OpenAI provider's
+     * `IMAGE_PROVIDER` transport). Serves the IMAGE artifact modality.
+     */
+    IMAGE_PROVIDER: 'IMAGE_PROVIDER',
+    /**
+     * Text → vector embeddings (wired: OpenAI `text-embedding-3-*`). Serves the
+     * RAG derived-data tier — corpus embedding in the `rag:embedding-drain`
+     * worker, query-time embedding in retrieval. Its own protocol rather than an
+     * `LLM_PROVIDER` operation so a provider can be selected for embeddings
+     * independently of chat.
+     */
+    EMBEDDINGS_PROVIDER: 'EMBEDDINGS_PROVIDER',
+    /**
+     * Document bytes → text (wired: Mistral `mistral-ocr-latest`). Serves file text extraction and
+     * the `.ragSource()` corpus built on it, and fills `EngineCapability.AI_DOCUMENT_EXTRACTION` so
+     * an OCR provider is selected independently of chat and embeddings.
+     */
+    DOCUMENT_EXTRACTION_PROVIDER: 'DOCUMENT_EXTRACTION_PROVIDER',
+    EMAIL_PROVIDER: 'EMAIL_PROVIDER',
+    GIT_PROVIDER: 'GIT_PROVIDER',
+    GRPC: 'GRPC',
+    SSO_OAUTH2: 'SSO_OAUTH2',
+    SSO_SAML: 'SSO_SAML',
+    BILLING_PROVIDER: 'BILLING_PROVIDER',
+    SMS_PROVIDER: 'SMS_PROVIDER',
+    FRONTEND_SDK: 'FRONTEND_SDK',
+};
+//# sourceMappingURL=provider-protocol.shared.schemas.js.map

package/dist/esm/external-providers/provider-protocol.shared.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-protocol.shared.schemas.js","sourceRoot":"","sources":["../../../../src/external-providers/provider-protocol.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,QAAQ,EAAE,UAAU;IACpB,kBAAkB,EAAE,oBAAoB;IACxC,YAAY,EAAE,cAAc;IAC5B,qBAAqB,EAAE,uBAAuB;IAC9C,aAAa,EAAE,eAAe;IAC9B,aAAa,EAAE,eAAe;IAC9B;;;OAGG;IACH,cAAc,EAAE,gBAAgB;IAChC;;;;;;OAMG;IACH,mBAAmB,EAAE,qBAAqB;IAC1C;;;;OAIG;IACH,4BAA4B,EAAE,8BAA8B;IAC5D,cAAc,EAAE,gBAAgB;IAChC,YAAY,EAAE,cAAc;IAC5B,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,YAAY;IACxB,QAAQ,EAAE,UAAU;IACpB,gBAAgB,EAAE,kBAAkB;IACpC,YAAY,EAAE,cAAc;IAC5B,YAAY,EAAE,cAAc;CACpB,CAAC","sourcesContent":["/**\n * Closed built-in provider protocol vocabulary used by app authoring and\n * runtime-provider declarations.\n *\n * This is intentionally a pure `as const` object + union type so browser-bound\n * packages can consume it through `@wildo-ai/saas-models/public-runtime`\n * without pulling decorators or broader config-authoring seams. Do NOT add an\n * import here — not even an `import type` of the engine enum this list mirrors.\n *\n * ## Relationship to `ExternalProvider_ExchangeProtocol_Kind`\n *\n * This list re-states a population the engine owns: every member of\n * `ExternalProvider_ExchangeProtocol_Kind`\n * (`@wildo-ai/external-connectors-models`) that an application may legally\n * WRITE in `wildo.saas.config.ts > providers.scopes.<scope>.providers.<ref>`.\n * Two hand-maintained enumerations of one population is the shape that drifts,\n * and this one did: `IMAGE_PROVIDER` and `EMBEDDINGS_PROVIDER` shipped as live\n * engine protocols — a provider module declares them, discovery reports them,\n * the backend registry resolves them — while this list had no legal value for\n * either, so no application could declare what those transports speak.\n *\n * The keys are therefore checked against the engine enum by\n * `__tests__/provider-protocol-vocabulary.drift.test.ts`, which also owns the\n * documented allow-list of deliberate exclusions. **`AUDIO_PROVIDER` and\n * `VIDEO_PROVIDER` are deliberately absent** — see that file for the reason and\n * for the exact condition under which they are admitted.\n */\nexport const BUILTIN_PROVIDER_PROTOCOL = {\n  REST_API: 'REST_API',\n  WEBHOOK_ORIGINATOR: 'WEBHOOK_ORIGINATOR',\n  LLM_PROVIDER: 'LLM_PROVIDER',\n  AGENT_CLIENT_PROTOCOL: 'AGENT_CLIENT_PROTOCOL',\n  MCP_CONNECTOR: 'MCP_CONNECTOR',\n  A2A_CONNECTOR: 'A2A_CONNECTOR',\n  /**\n   * Text-to-image generation (wired: gpt-image, via the OpenAI provider's\n   * `IMAGE_PROVIDER` transport). Serves the IMAGE artifact modality.\n   */\n  IMAGE_PROVIDER: 'IMAGE_PROVIDER',\n  /**\n   * Text → vector embeddings (wired: OpenAI `text-embedding-3-*`). Serves the\n   * RAG derived-data tier — corpus embedding in the `rag:embedding-drain`\n   * worker, query-time embedding in retrieval. Its own protocol rather than an\n   * `LLM_PROVIDER` operation so a provider can be selected for embeddings\n   * independently of chat.\n   */\n  EMBEDDINGS_PROVIDER: 'EMBEDDINGS_PROVIDER',\n  /**\n   * Document bytes → text (wired: Mistral `mistral-ocr-latest`). Serves file text extraction and\n   * the `.ragSource()` corpus built on it, and fills `EngineCapability.AI_DOCUMENT_EXTRACTION` so\n   * an OCR provider is selected independently of chat and embeddings.\n   */\n  DOCUMENT_EXTRACTION_PROVIDER: 'DOCUMENT_EXTRACTION_PROVIDER',\n  EMAIL_PROVIDER: 'EMAIL_PROVIDER',\n  GIT_PROVIDER: 'GIT_PROVIDER',\n  GRPC: 'GRPC',\n  SSO_OAUTH2: 'SSO_OAUTH2',\n  SSO_SAML: 'SSO_SAML',\n  BILLING_PROVIDER: 'BILLING_PROVIDER',\n  SMS_PROVIDER: 'SMS_PROVIDER',\n  FRONTEND_SDK: 'FRONTEND_SDK',\n} as const;\n\nexport type BuiltinProviderProtocol =\n  (typeof BUILTIN_PROVIDER_PROTOCOL)[keyof typeof BUILTIN_PROVIDER_PROTOCOL];\n\nexport type ProviderProtocol = BuiltinProviderProtocol;\n"]}

package/dist/esm/external-providers/provider-usage-pricing.shared.schemas.d.ts

@@ -0,0 +1,99 @@
+import { z } from 'zod';
+/** Billable provider-usage dimensions. These are acquisition-cost categories, not customer billing units. */
+export declare enum ProviderUsagePricingCategory {
+    INPUT_TOKEN = "INPUT_TOKEN",
+    CACHED_INPUT_TOKEN = "CACHED_INPUT_TOKEN",
+    CACHE_WRITE_INPUT_TOKEN = "CACHE_WRITE_INPUT_TOKEN",
+    OUTPUT_TOKEN = "OUTPUT_TOKEN",
+    REASONING_TOKEN = "REASONING_TOKEN"
+}
+export declare const PROVIDER_USAGE_PRICING_CATEGORY_ORDER: readonly ProviderUsagePricingCategory[];
+/** V1 rounds once after aggregating every supported category into the authority's common denominator. */
+export declare enum ProviderUsagePricingRoundingMode {
+    CEILING_AGGREGATE_TO_MINOR_UNIT = "CEILING_AGGREGATE_TO_MINOR_UNIT"
+}
+/** Closed trigger vocabulary for provider pricing tiers. */
+export declare enum ProviderUsagePricingTierRuleKind {
+    INPUT_TOKEN_QUANTITY_ABOVE = "INPUT_TOKEN_QUANTITY_ABOVE"
+}
+export declare const ProviderUsagePricingTierRuleSchema: z.ZodObject<{
+    kind: z.ZodLiteral<ProviderUsagePricingTierRuleKind>;
+    inputTokenThresholdExclusive: z.ZodNumber;
+    inputRateMultiplierBasisPoints: z.ZodNumber;
+    outputRateMultiplierBasisPoints: z.ZodNumber;
+}, z.core.$strict>;
+export type ProviderUsagePricingTierRule = z.infer<typeof ProviderUsagePricingTierRuleSchema>;
+export declare const ProviderUsagePricingRateSchema: z.ZodObject<{
+    category: z.ZodEnum<typeof ProviderUsagePricingCategory>;
+    /** Minor-currency units charged per `unitsDenominator` billable units. */
+    amountMinorNumerator: z.ZodNumber;
+}, z.core.$strict>;
+export type ProviderUsagePricingRate = z.infer<typeof ProviderUsagePricingRateSchema>;
+/**
+ * Canonical registered provider/model acquisition-cost authority.
+ *
+ * This is deliberately separate from billing `PriceSchema`, which represents what an application
+ * charges its customers. Runtime budget consumers retain this record's identity/digest and never
+ * copy its rates into a workflow-local table.
+ */
+export declare const ProviderUsagePricingAuthorityV1Schema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    pricingAuthorityRef: z.ZodString;
+    pricingAuthorityVersion: z.ZodNumber;
+    providerRef: z.ZodString;
+    modelRef: z.ZodString;
+    modelVersion: z.ZodString;
+    currency: z.ZodString;
+    unitsDenominator: z.ZodNumber;
+    roundingMode: z.ZodLiteral<ProviderUsagePricingRoundingMode>;
+    rates: z.ZodArray<z.ZodObject<{
+        category: z.ZodEnum<typeof ProviderUsagePricingCategory>;
+        /** Minor-currency units charged per `unitsDenominator` billable units. */
+        amountMinorNumerator: z.ZodNumber;
+    }, z.core.$strict>>;
+    /** Ordered full-request price tiers; the highest matching input threshold wins. */
+    usageTierRules: z.ZodArray<z.ZodObject<{
+        kind: z.ZodLiteral<ProviderUsagePricingTierRuleKind>;
+        inputTokenThresholdExclusive: z.ZodNumber;
+        inputRateMultiplierBasisPoints: z.ZodNumber;
+        outputRateMultiplierBasisPoints: z.ZodNumber;
+    }, z.core.$strict>>;
+    effectiveFrom: z.ZodISODateTime;
+    sourceRef: z.ZodString;
+    sourceVersion: z.ZodString;
+    implementationDigest: z.ZodString;
+    pricingDigest: z.ZodString;
+}, z.core.$strict>;
+export type ProviderUsagePricingAuthorityV1 = z.infer<typeof ProviderUsagePricingAuthorityV1Schema>;
+/**
+ * Registry input owned by provider/model configuration. The backend calculator
+ * supplies its own implementation identity and seals the final authority, so
+ * an application or workflow can neither choose rates nor mint the algorithm
+ * digest it later asks the registry to trust.
+ */
+export type ProviderUsagePricingAuthorityBasisV1 = Omit<ProviderUsagePricingAuthorityV1, 'implementationDigest' | 'pricingDigest' | 'rates' | 'usageTierRules'> & {
+    readonly rates: readonly ProviderUsagePricingRate[];
+    readonly usageTierRules: readonly ProviderUsagePricingTierRule[];
+};
+/**
+ * Canonical acquisition-cost basis for the selected app-creation model.
+ *
+ * The source is the provider's public model page observed on 2026-08-13. This
+ * is not customer billing data and is never copied into a Work Cycle or Driver
+ * request; those consumers retain only the sealed registry identity.
+ */
+export declare const OPENAI_GPT_5_6_TERRA_PROVIDER_USAGE_PRICING_BASIS_V1: ProviderUsagePricingAuthorityBasisV1;
+export declare const ProviderUsageAmountSchema: z.ZodObject<{
+    category: z.ZodEnum<typeof ProviderUsagePricingCategory>;
+    quantity: z.ZodNumber;
+}, z.core.$strict>;
+export type ProviderUsageAmount = z.infer<typeof ProviderUsageAmountSchema>;
+export declare const ProviderUsageCostResultSchema: z.ZodObject<{
+    pricingAuthorityRef: z.ZodString;
+    pricingAuthorityVersion: z.ZodNumber;
+    pricingDigest: z.ZodString;
+    currency: z.ZodString;
+    amountMinor: z.ZodNumber;
+}, z.core.$strict>;
+export type ProviderUsageCostResult = z.infer<typeof ProviderUsageCostResultSchema>;
+//# sourceMappingURL=provider-usage-pricing.shared.schemas.d.ts.map

package/dist/esm/external-providers/provider-usage-pricing.shared.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-usage-pricing.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/external-providers/provider-usage-pricing.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,6GAA6G;AAC7G,oBAAY,4BAA4B;IACtC,WAAW,gBAAgB;IAC3B,kBAAkB,uBAAuB;IACzC,uBAAuB,4BAA4B;IACnD,YAAY,iBAAiB;IAC7B,eAAe,oBAAoB;CACpC;AAED,eAAO,MAAM,qCAAqC,EAAE,SAAS,4BAA4B,EAMvF,CAAC;AAEH,yGAAyG;AACzG,oBAAY,gCAAgC;IAC1C,+BAA+B,oCAAoC;CACpE;AAED,4DAA4D;AAC5D,oBAAY,gCAAgC;IAC1C,0BAA0B,+BAA+B;CAC1D;AAID,eAAO,MAAM,kCAAkC;;;;;kBAK7C,CAAC;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F,eAAO,MAAM,8BAA8B;;IAEzC,0EAA0E;;kBAE1E,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF;;;;;;GAMG;AACH,eAAO,MAAM,qCAAqC;;;;;;;;;;;;QAZhD,0EAA0E;;;IAuB1E,mFAAmF;;;;;;;;;;;;kBA2BnF,CAAC;AACH,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AAEpG;;;;;GAKG;AACH,MAAM,MAAM,oCAAoC,GAAG,IAAI,CACrD,+BAA+B,EAC/B,sBAAsB,GAAG,eAAe,GAAG,OAAO,GAAG,gBAAgB,CACtE,GAAG;IACF,QAAQ,CAAC,KAAK,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACpD,QAAQ,CAAC,cAAc,EAAE,SAAS,4BAA4B,EAAE,CAAC;CAClE,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oDAAoD,EAAE,oCA2BjE,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;kBAGpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,6BAA6B;;;;;;kBAMxC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC"}

package/dist/esm/external-providers/provider-usage-pricing.shared.schemas.js

@@ -0,0 +1,137 @@
+import { z } from 'zod';
+const nonnegativeSafeIntegerSchema = z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER).refine((value) => !Object.is(value, -0), 'negative zero is not canonical');
+const positiveSafeIntegerSchema = nonnegativeSafeIntegerSchema.refine((value) => value > 0, 'value must be positive');
+const sha256DigestSchema = z.string().regex(/^sha256:[a-f0-9]{64}$/);
+const isoDateTimeSchema = z.iso.datetime({ offset: true });
+/** Billable provider-usage dimensions. These are acquisition-cost categories, not customer billing units. */
+export var ProviderUsagePricingCategory;
+(function (ProviderUsagePricingCategory) {
+    ProviderUsagePricingCategory["INPUT_TOKEN"] = "INPUT_TOKEN";
+    ProviderUsagePricingCategory["CACHED_INPUT_TOKEN"] = "CACHED_INPUT_TOKEN";
+    ProviderUsagePricingCategory["CACHE_WRITE_INPUT_TOKEN"] = "CACHE_WRITE_INPUT_TOKEN";
+    ProviderUsagePricingCategory["OUTPUT_TOKEN"] = "OUTPUT_TOKEN";
+    ProviderUsagePricingCategory["REASONING_TOKEN"] = "REASONING_TOKEN";
+})(ProviderUsagePricingCategory || (ProviderUsagePricingCategory = {}));
+export const PROVIDER_USAGE_PRICING_CATEGORY_ORDER = Object.freeze([
+    ProviderUsagePricingCategory.INPUT_TOKEN,
+    ProviderUsagePricingCategory.CACHED_INPUT_TOKEN,
+    ProviderUsagePricingCategory.CACHE_WRITE_INPUT_TOKEN,
+    ProviderUsagePricingCategory.OUTPUT_TOKEN,
+    ProviderUsagePricingCategory.REASONING_TOKEN,
+]);
+/** V1 rounds once after aggregating every supported category into the authority's common denominator. */
+export var ProviderUsagePricingRoundingMode;
+(function (ProviderUsagePricingRoundingMode) {
+    ProviderUsagePricingRoundingMode["CEILING_AGGREGATE_TO_MINOR_UNIT"] = "CEILING_AGGREGATE_TO_MINOR_UNIT";
+})(ProviderUsagePricingRoundingMode || (ProviderUsagePricingRoundingMode = {}));
+/** Closed trigger vocabulary for provider pricing tiers. */
+export var ProviderUsagePricingTierRuleKind;
+(function (ProviderUsagePricingTierRuleKind) {
+    ProviderUsagePricingTierRuleKind["INPUT_TOKEN_QUANTITY_ABOVE"] = "INPUT_TOKEN_QUANTITY_ABOVE";
+})(ProviderUsagePricingTierRuleKind || (ProviderUsagePricingTierRuleKind = {}));
+const RATE_MULTIPLIER_BASIS_POINTS = 10_000;
+export const ProviderUsagePricingTierRuleSchema = z.strictObject({
+    kind: z.literal(ProviderUsagePricingTierRuleKind.INPUT_TOKEN_QUANTITY_ABOVE),
+    inputTokenThresholdExclusive: nonnegativeSafeIntegerSchema,
+    inputRateMultiplierBasisPoints: positiveSafeIntegerSchema,
+    outputRateMultiplierBasisPoints: positiveSafeIntegerSchema,
+});
+export const ProviderUsagePricingRateSchema = z.strictObject({
+    category: z.enum(ProviderUsagePricingCategory),
+    /** Minor-currency units charged per `unitsDenominator` billable units. */
+    amountMinorNumerator: nonnegativeSafeIntegerSchema,
+});
+/**
+ * Canonical registered provider/model acquisition-cost authority.
+ *
+ * This is deliberately separate from billing `PriceSchema`, which represents what an application
+ * charges its customers. Runtime budget consumers retain this record's identity/digest and never
+ * copy its rates into a workflow-local table.
+ */
+export const ProviderUsagePricingAuthorityV1Schema = z.strictObject({
+    schemaVersion: z.literal(1),
+    pricingAuthorityRef: z.string().min(1),
+    pricingAuthorityVersion: positiveSafeIntegerSchema,
+    providerRef: z.string().min(1),
+    modelRef: z.string().min(1),
+    modelVersion: z.string().min(1),
+    currency: z.string().regex(/^[A-Z]{3}$/),
+    unitsDenominator: positiveSafeIntegerSchema,
+    roundingMode: z.literal(ProviderUsagePricingRoundingMode.CEILING_AGGREGATE_TO_MINOR_UNIT),
+    rates: z.array(ProviderUsagePricingRateSchema).min(1),
+    /** Ordered full-request price tiers; the highest matching input threshold wins. */
+    usageTierRules: z.array(ProviderUsagePricingTierRuleSchema),
+    effectiveFrom: isoDateTimeSchema,
+    sourceRef: z.string().min(1),
+    sourceVersion: z.string().min(1),
+    implementationDigest: sha256DigestSchema,
+    pricingDigest: sha256DigestSchema,
+}).superRefine((authority, context) => {
+    const categories = authority.rates.map((rate) => rate.category);
+    if (new Set(categories).size !== categories.length) {
+        context.addIssue({ code: 'custom', message: 'pricing categories must be unique', path: ['rates'] });
+    }
+    const order = new Map(PROVIDER_USAGE_PRICING_CATEGORY_ORDER.map((category, index) => [category, index]));
+    if (!categories.every((category, index) => index === 0 || order.get(categories[index - 1]) < order.get(category))) {
+        context.addIssue({ code: 'custom', message: 'pricing categories must use canonical order', path: ['rates'] });
+    }
+    for (const required of [ProviderUsagePricingCategory.INPUT_TOKEN, ProviderUsagePricingCategory.OUTPUT_TOKEN]) {
+        if (!categories.includes(required))
+            context.addIssue({ code: 'custom', message: `${required} pricing is required`, path: ['rates'] });
+    }
+    if (!authority.usageTierRules.every((rule, index) => index === 0 || authority.usageTierRules[index - 1].inputTokenThresholdExclusive < rule.inputTokenThresholdExclusive)) {
+        context.addIssue({ code: 'custom', message: 'usage pricing tiers must use unique ascending thresholds', path: ['usageTierRules'] });
+    }
+    for (const [index, rule] of authority.usageTierRules.entries()) {
+        if (rule.inputRateMultiplierBasisPoints < RATE_MULTIPLIER_BASIS_POINTS || rule.outputRateMultiplierBasisPoints < RATE_MULTIPLIER_BASIS_POINTS) {
+            context.addIssue({ code: 'custom', message: 'usage pricing tier multipliers cannot discount the registered base rate', path: ['usageTierRules', index] });
+        }
+    }
+});
+/**
+ * Canonical acquisition-cost basis for the selected app-creation model.
+ *
+ * The source is the provider's public model page observed on 2026-08-13. This
+ * is not customer billing data and is never copied into a Work Cycle or Driver
+ * request; those consumers retain only the sealed registry identity.
+ */
+export const OPENAI_GPT_5_6_TERRA_PROVIDER_USAGE_PRICING_BASIS_V1 = Object.freeze({
+    schemaVersion: 1,
+    pricingAuthorityRef: 'pricing:openai/gpt-5.6-terra',
+    pricingAuthorityVersion: 1,
+    providerRef: 'openai',
+    modelRef: 'llm-model:gpt-5.6-terra',
+    modelVersion: 'gpt-5.6-terra',
+    currency: 'USD',
+    unitsDenominator: 1_000_000,
+    roundingMode: ProviderUsagePricingRoundingMode.CEILING_AGGREGATE_TO_MINOR_UNIT,
+    rates: Object.freeze([
+        Object.freeze({ category: ProviderUsagePricingCategory.INPUT_TOKEN, amountMinorNumerator: 200 }),
+        Object.freeze({ category: ProviderUsagePricingCategory.CACHED_INPUT_TOKEN, amountMinorNumerator: 20 }),
+        Object.freeze({ category: ProviderUsagePricingCategory.CACHE_WRITE_INPUT_TOKEN, amountMinorNumerator: 250 }),
+        Object.freeze({ category: ProviderUsagePricingCategory.OUTPUT_TOKEN, amountMinorNumerator: 1_200 }),
+    ]),
+    usageTierRules: Object.freeze([
+        Object.freeze({
+            kind: ProviderUsagePricingTierRuleKind.INPUT_TOKEN_QUANTITY_ABOVE,
+            inputTokenThresholdExclusive: 272_000,
+            inputRateMultiplierBasisPoints: 20_000,
+            outputRateMultiplierBasisPoints: 15_000,
+        }),
+    ]),
+    effectiveFrom: '2026-08-13T00:00:00.000Z',
+    sourceRef: 'https://developers.openai.com/api/docs/models/gpt-5.6-terra',
+    sourceVersion: 'observed:2026-08-13',
+});
+export const ProviderUsageAmountSchema = z.strictObject({
+    category: z.enum(ProviderUsagePricingCategory),
+    quantity: nonnegativeSafeIntegerSchema,
+});
+export const ProviderUsageCostResultSchema = z.strictObject({
+    pricingAuthorityRef: z.string().min(1),
+    pricingAuthorityVersion: positiveSafeIntegerSchema,
+    pricingDigest: sha256DigestSchema,
+    currency: z.string().regex(/^[A-Z]{3}$/),
+    amountMinor: nonnegativeSafeIntegerSchema,
+});
+//# sourceMappingURL=provider-usage-pricing.shared.schemas.js.map

package/dist/esm/external-providers/provider-usage-pricing.shared.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-usage-pricing.shared.schemas.js","sourceRoot":"","sources":["../../../../src/external-providers/provider-usage-pricing.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,gCAAgC,CAAC,CAAC;AAC5K,MAAM,yBAAyB,GAAG,4BAA4B,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,EAAE,wBAAwB,CAAC,CAAC;AACtH,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;AACrE,MAAM,iBAAiB,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAE3D,6GAA6G;AAC7G,MAAM,CAAN,IAAY,4BAMX;AAND,WAAY,4BAA4B;IACtC,2DAA2B,CAAA;IAC3B,yEAAyC,CAAA;IACzC,mFAAmD,CAAA;IACnD,6DAA6B,CAAA;IAC7B,mEAAmC,CAAA;AACrC,CAAC,EANW,4BAA4B,KAA5B,4BAA4B,QAMvC;AAED,MAAM,CAAC,MAAM,qCAAqC,GAA4C,MAAM,CAAC,MAAM,CAAC;IAC1G,4BAA4B,CAAC,WAAW;IACxC,4BAA4B,CAAC,kBAAkB;IAC/C,4BAA4B,CAAC,uBAAuB;IACpD,4BAA4B,CAAC,YAAY;IACzC,4BAA4B,CAAC,eAAe;CAC7C,CAAC,CAAC;AAEH,yGAAyG;AACzG,MAAM,CAAN,IAAY,gCAEX;AAFD,WAAY,gCAAgC;IAC1C,uGAAmE,CAAA;AACrE,CAAC,EAFW,gCAAgC,KAAhC,gCAAgC,QAE3C;AAED,4DAA4D;AAC5D,MAAM,CAAN,IAAY,gCAEX;AAFD,WAAY,gCAAgC;IAC1C,6FAAyD,CAAA;AAC3D,CAAC,EAFW,gCAAgC,KAAhC,gCAAgC,QAE3C;AAED,MAAM,4BAA4B,GAAG,MAAM,CAAC;AAE5C,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC,YAAY,CAAC;IAC/D,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,gCAAgC,CAAC,0BAA0B,CAAC;IAC5E,4BAA4B,EAAE,4BAA4B;IAC1D,8BAA8B,EAAE,yBAAyB;IACzD,+BAA+B,EAAE,yBAAyB;CAC3D,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,YAAY,CAAC;IAC3D,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC;IAC9C,0EAA0E;IAC1E,oBAAoB,EAAE,4BAA4B;CACnD,CAAC,CAAC;AAGH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,CAAC,YAAY,CAAC;IAClE,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3B,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtC,uBAAuB,EAAE,yBAAyB;IAClD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC;IACxC,gBAAgB,EAAE,yBAAyB;IAC3C,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,gCAAgC,CAAC,+BAA+B,CAAC;IACzF,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,mFAAmF;IACnF,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,kCAAkC,CAAC;IAC3D,aAAa,EAAE,iBAAiB;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,oBAAoB,EAAE,kBAAkB;IACxC,aAAa,EAAE,kBAAkB;CAClC,CAAC,CAAC,WAAW,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE;IACpC,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChE,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,MAAM,EAAE,CAAC;QACnD,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,mCAAmC,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACtG,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,qCAAqC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACzG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,CAAE,CAAE,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC,EAAE,CAAC;QACrH,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,6CAA6C,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAChH,CAAC;IACD,KAAK,MAAM,QAAQ,IAAI,CAAC,4BAA4B,CAAC,WAAW,EAAE,4BAA4B,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7G,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,QAAQ,sBAAsB,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACxI,CAAC;IACD,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,IAAI,SAAS,CAAC,cAAc,CAAC,KAAK,GAAG,CAAC,CAAE,CAAC,4BAA4B,GAAG,IAAI,CAAC,4BAA4B,CAAC,EAAE,CAAC;QAC3K,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,0DAA0D,EAAE,IAAI,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;IACtI,CAAC;IACD,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,SAAS,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/D,IAAI,IAAI,CAAC,8BAA8B,GAAG,4BAA4B,IAAI,IAAI,CAAC,+BAA+B,GAAG,4BAA4B,EAAE,CAAC;YAC9I,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,yEAAyE,EAAE,IAAI,EAAE,CAAC,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;QAC5J,CAAC;IACH,CAAC;AACH,CAAC,CAAC,CAAC;AAiBH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oDAAoD,GAAyC,MAAM,CAAC,MAAM,CAAC;IACtH,aAAa,EAAE,CAAC;IAChB,mBAAmB,EAAE,8BAA8B;IACnD,uBAAuB,EAAE,CAAC;IAC1B,WAAW,EAAE,QAAQ;IACrB,QAAQ,EAAE,yBAAyB;IACnC,YAAY,EAAE,eAAe;IAC7B,QAAQ,EAAE,KAAK;IACf,gBAAgB,EAAE,SAAS;IAC3B,YAAY,EAAE,gCAAgC,CAAC,+BAA+B;IAC9E,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,4BAA4B,CAAC,WAAW,EAAE,oBAAoB,EAAE,GAAG,EAAE,CAAC;QAChG,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,4BAA4B,CAAC,kBAAkB,EAAE,oBAAoB,EAAE,EAAE,EAAE,CAAC;QACtG,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,4BAA4B,CAAC,uBAAuB,EAAE,oBAAoB,EAAE,GAAG,EAAE,CAAC;QAC5G,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,4BAA4B,CAAC,YAAY,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC;KACpG,CAAC;IACF,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC;YACZ,IAAI,EAAE,gCAAgC,CAAC,0BAA0B;YACjE,4BAA4B,EAAE,OAAO;YACrC,8BAA8B,EAAE,MAAM;YACtC,+BAA+B,EAAE,MAAM;SACxC,CAAC;KACH,CAAC;IACF,aAAa,EAAE,0BAA0B;IACzC,SAAS,EAAE,6DAA6D;IACxE,aAAa,EAAE,qBAAqB;CACrC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,YAAY,CAAC;IACtD,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC;IAC9C,QAAQ,EAAE,4BAA4B;CACvC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,YAAY,CAAC;IAC1D,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtC,uBAAuB,EAAE,yBAAyB;IAClD,aAAa,EAAE,kBAAkB;IACjC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC;IACxC,WAAW,EAAE,4BAA4B;CAC1C,CAAC,CAAC","sourcesContent":["import { z } from 'zod';\n\nconst nonnegativeSafeIntegerSchema = z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER).refine((value) => !Object.is(value, -0), 'negative zero is not canonical');\nconst positiveSafeIntegerSchema = nonnegativeSafeIntegerSchema.refine((value) => value > 0, 'value must be positive');\nconst sha256DigestSchema = z.string().regex(/^sha256:[a-f0-9]{64}$/);\nconst isoDateTimeSchema = z.iso.datetime({ offset: true });\n\n/** Billable provider-usage dimensions. These are acquisition-cost categories, not customer billing units. */\nexport enum ProviderUsagePricingCategory {\n  INPUT_TOKEN = 'INPUT_TOKEN',\n  CACHED_INPUT_TOKEN = 'CACHED_INPUT_TOKEN',\n  CACHE_WRITE_INPUT_TOKEN = 'CACHE_WRITE_INPUT_TOKEN',\n  OUTPUT_TOKEN = 'OUTPUT_TOKEN',\n  REASONING_TOKEN = 'REASONING_TOKEN',\n}\n\nexport const PROVIDER_USAGE_PRICING_CATEGORY_ORDER: readonly ProviderUsagePricingCategory[] = Object.freeze([\n  ProviderUsagePricingCategory.INPUT_TOKEN,\n  ProviderUsagePricingCategory.CACHED_INPUT_TOKEN,\n  ProviderUsagePricingCategory.CACHE_WRITE_INPUT_TOKEN,\n  ProviderUsagePricingCategory.OUTPUT_TOKEN,\n  ProviderUsagePricingCategory.REASONING_TOKEN,\n]);\n\n/** V1 rounds once after aggregating every supported category into the authority's common denominator. */\nexport enum ProviderUsagePricingRoundingMode {\n  CEILING_AGGREGATE_TO_MINOR_UNIT = 'CEILING_AGGREGATE_TO_MINOR_UNIT',\n}\n\n/** Closed trigger vocabulary for provider pricing tiers. */\nexport enum ProviderUsagePricingTierRuleKind {\n  INPUT_TOKEN_QUANTITY_ABOVE = 'INPUT_TOKEN_QUANTITY_ABOVE',\n}\n\nconst RATE_MULTIPLIER_BASIS_POINTS = 10_000;\n\nexport const ProviderUsagePricingTierRuleSchema = z.strictObject({\n  kind: z.literal(ProviderUsagePricingTierRuleKind.INPUT_TOKEN_QUANTITY_ABOVE),\n  inputTokenThresholdExclusive: nonnegativeSafeIntegerSchema,\n  inputRateMultiplierBasisPoints: positiveSafeIntegerSchema,\n  outputRateMultiplierBasisPoints: positiveSafeIntegerSchema,\n});\nexport type ProviderUsagePricingTierRule = z.infer<typeof ProviderUsagePricingTierRuleSchema>;\n\nexport const ProviderUsagePricingRateSchema = z.strictObject({\n  category: z.enum(ProviderUsagePricingCategory),\n  /** Minor-currency units charged per `unitsDenominator` billable units. */\n  amountMinorNumerator: nonnegativeSafeIntegerSchema,\n});\nexport type ProviderUsagePricingRate = z.infer<typeof ProviderUsagePricingRateSchema>;\n\n/**\n * Canonical registered provider/model acquisition-cost authority.\n *\n * This is deliberately separate from billing `PriceSchema`, which represents what an application\n * charges its customers. Runtime budget consumers retain this record's identity/digest and never\n * copy its rates into a workflow-local table.\n */\nexport const ProviderUsagePricingAuthorityV1Schema = z.strictObject({\n  schemaVersion: z.literal(1),\n  pricingAuthorityRef: z.string().min(1),\n  pricingAuthorityVersion: positiveSafeIntegerSchema,\n  providerRef: z.string().min(1),\n  modelRef: z.string().min(1),\n  modelVersion: z.string().min(1),\n  currency: z.string().regex(/^[A-Z]{3}$/),\n  unitsDenominator: positiveSafeIntegerSchema,\n  roundingMode: z.literal(ProviderUsagePricingRoundingMode.CEILING_AGGREGATE_TO_MINOR_UNIT),\n  rates: z.array(ProviderUsagePricingRateSchema).min(1),\n  /** Ordered full-request price tiers; the highest matching input threshold wins. */\n  usageTierRules: z.array(ProviderUsagePricingTierRuleSchema),\n  effectiveFrom: isoDateTimeSchema,\n  sourceRef: z.string().min(1),\n  sourceVersion: z.string().min(1),\n  implementationDigest: sha256DigestSchema,\n  pricingDigest: sha256DigestSchema,\n}).superRefine((authority, context) => {\n  const categories = authority.rates.map((rate) => rate.category);\n  if (new Set(categories).size !== categories.length) {\n    context.addIssue({ code: 'custom', message: 'pricing categories must be unique', path: ['rates'] });\n  }\n  const order = new Map(PROVIDER_USAGE_PRICING_CATEGORY_ORDER.map((category, index) => [category, index]));\n  if (!categories.every((category, index) => index === 0 || order.get(categories[index - 1]!)! < order.get(category)!)) {\n    context.addIssue({ code: 'custom', message: 'pricing categories must use canonical order', path: ['rates'] });\n  }\n  for (const required of [ProviderUsagePricingCategory.INPUT_TOKEN, ProviderUsagePricingCategory.OUTPUT_TOKEN]) {\n    if (!categories.includes(required)) context.addIssue({ code: 'custom', message: `${required} pricing is required`, path: ['rates'] });\n  }\n  if (!authority.usageTierRules.every((rule, index) => index === 0 || authority.usageTierRules[index - 1]!.inputTokenThresholdExclusive < rule.inputTokenThresholdExclusive)) {\n    context.addIssue({ code: 'custom', message: 'usage pricing tiers must use unique ascending thresholds', path: ['usageTierRules'] });\n  }\n  for (const [index, rule] of authority.usageTierRules.entries()) {\n    if (rule.inputRateMultiplierBasisPoints < RATE_MULTIPLIER_BASIS_POINTS || rule.outputRateMultiplierBasisPoints < RATE_MULTIPLIER_BASIS_POINTS) {\n      context.addIssue({ code: 'custom', message: 'usage pricing tier multipliers cannot discount the registered base rate', path: ['usageTierRules', index] });\n    }\n  }\n});\nexport type ProviderUsagePricingAuthorityV1 = z.infer<typeof ProviderUsagePricingAuthorityV1Schema>;\n\n/**\n * Registry input owned by provider/model configuration. The backend calculator\n * supplies its own implementation identity and seals the final authority, so\n * an application or workflow can neither choose rates nor mint the algorithm\n * digest it later asks the registry to trust.\n */\nexport type ProviderUsagePricingAuthorityBasisV1 = Omit<\n  ProviderUsagePricingAuthorityV1,\n  'implementationDigest' | 'pricingDigest' | 'rates' | 'usageTierRules'\n> & {\n  readonly rates: readonly ProviderUsagePricingRate[];\n  readonly usageTierRules: readonly ProviderUsagePricingTierRule[];\n};\n\n/**\n * Canonical acquisition-cost basis for the selected app-creation model.\n *\n * The source is the provider's public model page observed on 2026-08-13. This\n * is not customer billing data and is never copied into a Work Cycle or Driver\n * request; those consumers retain only the sealed registry identity.\n */\nexport const OPENAI_GPT_5_6_TERRA_PROVIDER_USAGE_PRICING_BASIS_V1: ProviderUsagePricingAuthorityBasisV1 = Object.freeze({\n  schemaVersion: 1,\n  pricingAuthorityRef: 'pricing:openai/gpt-5.6-terra',\n  pricingAuthorityVersion: 1,\n  providerRef: 'openai',\n  modelRef: 'llm-model:gpt-5.6-terra',\n  modelVersion: 'gpt-5.6-terra',\n  currency: 'USD',\n  unitsDenominator: 1_000_000,\n  roundingMode: ProviderUsagePricingRoundingMode.CEILING_AGGREGATE_TO_MINOR_UNIT,\n  rates: Object.freeze([\n    Object.freeze({ category: ProviderUsagePricingCategory.INPUT_TOKEN, amountMinorNumerator: 200 }),\n    Object.freeze({ category: ProviderUsagePricingCategory.CACHED_INPUT_TOKEN, amountMinorNumerator: 20 }),\n    Object.freeze({ category: ProviderUsagePricingCategory.CACHE_WRITE_INPUT_TOKEN, amountMinorNumerator: 250 }),\n    Object.freeze({ category: ProviderUsagePricingCategory.OUTPUT_TOKEN, amountMinorNumerator: 1_200 }),\n  ]),\n  usageTierRules: Object.freeze([\n    Object.freeze({\n      kind: ProviderUsagePricingTierRuleKind.INPUT_TOKEN_QUANTITY_ABOVE,\n      inputTokenThresholdExclusive: 272_000,\n      inputRateMultiplierBasisPoints: 20_000,\n      outputRateMultiplierBasisPoints: 15_000,\n    }),\n  ]),\n  effectiveFrom: '2026-08-13T00:00:00.000Z',\n  sourceRef: 'https://developers.openai.com/api/docs/models/gpt-5.6-terra',\n  sourceVersion: 'observed:2026-08-13',\n});\n\nexport const ProviderUsageAmountSchema = z.strictObject({\n  category: z.enum(ProviderUsagePricingCategory),\n  quantity: nonnegativeSafeIntegerSchema,\n});\nexport type ProviderUsageAmount = z.infer<typeof ProviderUsageAmountSchema>;\n\nexport const ProviderUsageCostResultSchema = z.strictObject({\n  pricingAuthorityRef: z.string().min(1),\n  pricingAuthorityVersion: positiveSafeIntegerSchema,\n  pricingDigest: sha256DigestSchema,\n  currency: z.string().regex(/^[A-Z]{3}$/),\n  amountMinor: nonnegativeSafeIntegerSchema,\n});\nexport type ProviderUsageCostResult = z.infer<typeof ProviderUsageCostResultSchema>;\n"]}

package/dist/esm/features/application-features.shared.resources-config.schemas.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Application Features Shared Resource Configuration
+ *
+ * Application-scope entitlement ledger. This mirrors organization/user feature
+ * ledgers so exact-scope gates such as `M2M_WEBHOOK_DELIVERY` can be enabled
+ * for `WEBHOOK_APPLICATION` without leaking app enablement to every org.
+ */
+import { z } from 'zod';
+import { CoreFeature } from '../organizations/organization-features.shared.schemas';
+import { CoreResourceOperation } from '../resources/resources.shared.core.definitions';
+import { ResourceRelationship } from '../resources/resources.shared.schemas';
+export declare enum ApplicationFeatures_Operations {
+    ENABLE_FEATURE = "enable_feature",
+    DISABLE_FEATURE = "disable_feature",
+    RESET_FEATURES = "reset_features"
+}
+export declare const ApplicationFeaturesEnableFeatureRequestDtoSchema: z.ZodObject<{
+    featureId: z.ZodEnum<typeof CoreFeature>;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ApplicationFeaturesDisableFeatureRequestDtoSchema: z.ZodObject<{
+    featureId: z.ZodEnum<typeof CoreFeature>;
+    reason: z.ZodString;
+}, z.core.$strip>;
+export declare const ApplicationFeaturesResetFeaturesRequestDtoSchema: z.ZodObject<{
+    reason: z.ZodString;
+}, z.core.$strip>;
+type ApplicationFeaturesCoreOperations = CoreResourceOperation.CREATE | CoreResourceOperation.READ | CoreResourceOperation.SEARCH | CoreResourceOperation.UPDATE | CoreResourceOperation.DELETE;
+export declare const applicationFeaturesResourceConfiguration_InitializationFactory: (resourcesRelationships: ResourceRelationship[]) => import("..").ResourceConfiguration<typeof ApplicationFeatures_Operations, ApplicationFeaturesCoreOperations, z.ZodObject<{
+    features: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<typeof CoreFeature>, z.ZodString]>>>>>;
+    limits: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>>>;
+    manualOverrides: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodObject<{
+        addedFeatures: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        removedFeatures: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        limitOverrides: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>>;
+export {};
+//# sourceMappingURL=application-features.shared.resources-config.schemas.d.ts.map

package/dist/esm/features/application-features.shared.resources-config.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-features.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../../src/features/application-features.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,uDAAuD,CAAC;AAGpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,EAA8B,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAMzG,oBAAY,8BAA8B;IACxC,cAAc,mBAAmB;IACjC,eAAe,oBAAoB;IACnC,cAAc,mBAAmB;CAClC;AAED,eAAO,MAAM,gDAAgD;;;iBAG3D,CAAC;AAEH,eAAO,MAAM,iDAAiD;;;iBAG5D,CAAC;AAEH,eAAO,MAAM,gDAAgD;;iBAE3D,CAAC;AAEH,KAAK,iCAAiC,GAClC,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,CAAC;AAEjC,eAAO,MAAM,8DAA8D,GAAI,wBAAwB,oBAAoB,EAAE;;;;;;;;kBA8H3H,CAAC"}

package/dist/esm/features/application-features.shared.resources-config.schemas.js

@@ -0,0 +1,147 @@
+/**
+ * Application Features Shared Resource Configuration
+ *
+ * Application-scope entitlement ledger. This mirrors organization/user feature
+ * ledgers so exact-scope gates such as `M2M_WEBHOOK_DELIVERY` can be enabled
+ * for `WEBHOOK_APPLICATION` without leaking app enablement to every org.
+ */
+import { z } from 'zod';
+import { CoreFeature } from '../organizations/organization-features.shared.schemas.js';
+import { ScopeFeaturesWithOverridesSchema } from './scope-features.shared.schemas.js';
+import { CoreResourceOperation } from '../resources/resources.shared.core.definitions.js';
+import { ResourceOperationRiskLevel } from '../resources/resources.shared.schemas.js';
+import { CoreResourceType, coreResourceShared_FieldIdentifier } from '../resources/resources.shared.core.definitions.js';
+import { ResourceOperationVariantType } from '../resources/resources.shared.schemas.js';
+import { createResourceConfiguration_Initialization } from '../resources/resources-config.shared.factory.js';
+import { CORE_APP_ROLES } from '../security/authorizations/roles.shared.schemas.js';
+export var ApplicationFeatures_Operations;
+(function (ApplicationFeatures_Operations) {
+    ApplicationFeatures_Operations["ENABLE_FEATURE"] = "enable_feature";
+    ApplicationFeatures_Operations["DISABLE_FEATURE"] = "disable_feature";
+    ApplicationFeatures_Operations["RESET_FEATURES"] = "reset_features";
+})(ApplicationFeatures_Operations || (ApplicationFeatures_Operations = {}));
+export const ApplicationFeaturesEnableFeatureRequestDtoSchema = z.object({
+    featureId: z.enum(CoreFeature),
+    reason: z.string().max(500).optional(),
+});
+export const ApplicationFeaturesDisableFeatureRequestDtoSchema = z.object({
+    featureId: z.enum(CoreFeature),
+    reason: z.string().min(1).max(500),
+});
+export const ApplicationFeaturesResetFeaturesRequestDtoSchema = z.object({
+    reason: z.string().min(1).max(500),
+});
+export const applicationFeaturesResourceConfiguration_InitializationFactory = (resourcesRelationships) => createResourceConfiguration_Initialization({
+    mainSchema: ScopeFeaturesWithOverridesSchema,
+    resourceIdentifier: CoreResourceType.APPLICATION_FEATURES,
+    resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.APPLICATION_FEATURES],
+    resourceRelationships: resourcesRelationships,
+    isSystemResource: true,
+    coreOperations: [
+        CoreResourceOperation.CREATE,
+        CoreResourceOperation.READ,
+        CoreResourceOperation.SEARCH,
+        CoreResourceOperation.UPDATE,
+        // DELETE is REPOSITORY_ONLY (no HTTP route): powers the composition onParentDelete
+        // cascade so the row is physically removed when its application is deleted. Without
+        // it the cascade throws ErrorType.CONFIGURATION on any app that has a features row.
+        CoreResourceOperation.DELETE,
+    ],
+    customOperation: ApplicationFeatures_Operations,
+    operationsConfiguration: {
+        [CoreResourceOperation.CREATE]: {
+            variants: [
+                {
+                    variantType: ResourceOperationVariantType.REPOSITORY_ONLY,
+                    isDefault: true,
+                    roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],
+                    riskLevel: ResourceOperationRiskLevel.MEDIUM,
+                },
+            ],
+        },
+        [CoreResourceOperation.READ]: {
+            variants: [
+                {
+                    variantType: ResourceOperationVariantType.API_CALL,
+                    isDefault: true,
+                    roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],
+                    riskLevel: ResourceOperationRiskLevel.LOW,
+                },
+            ],
+        },
+        [CoreResourceOperation.SEARCH]: {
+            variants: [{
+                    variantType: ResourceOperationVariantType.API_CALL,
+                    isDefault: true,
+                    roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],
+                    riskLevel: ResourceOperationRiskLevel.LOW,
+                    isSearchable: false,
+                    searchableFields: [],
+                    searchableOptions: { caseSensitive: false, fullMatchOnly: false },
+                    filterFields: {},
+                    sortFields: [],
+                    maxPaginatedResultPerPageLimit: 50,
+                }],
+        },
+        [CoreResourceOperation.UPDATE]: {
+            variants: [
+                {
+                    variantType: ResourceOperationVariantType.API_CALL,
+                    isDefault: true,
+                    roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],
+                    riskLevel: ResourceOperationRiskLevel.HIGH,
+                    requestDto: ScopeFeaturesWithOverridesSchema.partial(),
+                },
+            ],
+        },
+        // Internal-only (REPOSITORY_ONLY): powers the composition onParentDelete cascade,
+        // not a public API surface — the ledger is reset, never DELETEd, over HTTP.
+        [CoreResourceOperation.DELETE]: {
+            variants: [
+                {
+                    variantType: ResourceOperationVariantType.REPOSITORY_ONLY,
+                    isDefault: true,
+                    roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],
+                    riskLevel: ResourceOperationRiskLevel.HIGH,
+                },
+            ],
+        },
+        [ApplicationFeatures_Operations.ENABLE_FEATURE]: {
+            variants: [
+                {
+                    variantType: ResourceOperationVariantType.API_CALL,
+                    isDefault: true,
+                    roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],
+                    riskLevel: ResourceOperationRiskLevel.MEDIUM,
+                    resourceOperationLike: CoreResourceOperation.UPDATE_MANY,
+                    requestDto: ApplicationFeaturesEnableFeatureRequestDtoSchema,
+                },
+            ],
+        },
+        [ApplicationFeatures_Operations.DISABLE_FEATURE]: {
+            variants: [
+                {
+                    variantType: ResourceOperationVariantType.API_CALL,
+                    isDefault: true,
+                    roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],
+                    riskLevel: ResourceOperationRiskLevel.HIGH,
+                    resourceOperationLike: CoreResourceOperation.UPDATE_MANY,
+                    requestDto: ApplicationFeaturesDisableFeatureRequestDtoSchema,
+                },
+            ],
+        },
+        [ApplicationFeatures_Operations.RESET_FEATURES]: {
+            variants: [
+                {
+                    variantType: ResourceOperationVariantType.API_CALL,
+                    isDefault: true,
+                    roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],
+                    riskLevel: ResourceOperationRiskLevel.CRITICAL,
+                    resourceOperationLike: CoreResourceOperation.UPDATE_MANY,
+                    requestDto: ApplicationFeaturesResetFeaturesRequestDtoSchema,
+                },
+            ],
+        },
+    },
+});
+//# sourceMappingURL=application-features.shared.resources-config.schemas.js.map