@od-oneapp/ai-platform 0.1.0

package/dist/generative-ui-stream.mjs

@@ -0,0 +1,219 @@
+import { n as calculateCost } from "./budget-guard-gyhJS00s.mjs";
+import { n as getAuditLogger } from "./audit-logger-CHIP8bRO.mjs";
+import "server-only";
+
+//#region src/generative-ui/stream.ts
+/**
+* @fileoverview Generative UI Stream (server-only).
+* @module @od-oneapp/ai-platform/generative-ui/stream
+*
+* Creates AI SDK streams that produce generative UI trees.
+* Integrates with budget guards, entitlements, and audit logging
+* from the governance domain.
+*
+* @example
+* ```ts
+* import {
+*   createGenerativeUIStream,
+*   createEnterpriseCatalog,
+*   BASE_CATALOG_COMPONENTS,
+* } from '@od-oneapp/ai-platform/generative-ui';
+*
+* const catalog = createEnterpriseCatalog({
+*   components: BASE_CATALOG_COMPONENTS,
+*   enableEntitlementFiltering: true,
+* });
+*
+* const { partialTreeStream, finalTree } = await createGenerativeUIStream({
+*   userTier: 'pro',
+*   userId: 'user-123',
+*   catalog,
+*   budgetGuard: { maxTokens: 10_000 },
+* }, 'Show me a revenue dashboard');
+*
+* for await (const partial of partialTreeStream) {
+*   // Stream partial UI tree to client
+*   dataStream.write({ type: 'data-uiTreeDelta', data: JSON.stringify(partial) });
+* }
+* ```
+*/
+/**
+* Builds the system prompt for generative UI generation.
+* Includes the catalog description, output format instructions,
+* and any additional context.
+*/
+function buildGenerativeUISystemPrompt(catalog, config) {
+	return [
+		"You are a UI generation assistant. Given a user request, you produce a JSON UITree",
+		"that composes available components into a meaningful interface.",
+		"",
+		"Rules:",
+		"1. ONLY use components listed below. Do not invent new component types.",
+		"2. Return valid JSON matching the UITree schema exactly.",
+		"3. Use layout components (Card, Grid, Stack, Section) to organize content.",
+		"4. Choose the most appropriate visualization for the data described.",
+		"5. Keep the tree depth under 5 levels.",
+		"6. Each element must have a \"type\" and \"props\" field.",
+		"7. Children are optional and must be an array of UIElement objects.",
+		"",
+		catalog.generatePromptSection(config.userTier),
+		"",
+		config.systemPromptSuffix ?? ""
+	].join("\n");
+}
+/**
+* Counts the total number of elements in a UI tree.
+*/
+function countElements(tree) {
+	if (!tree.root) return 0;
+	function count(element) {
+		let total = 1;
+		if (element.children) {
+			for (const child of element.children) if (child && typeof child === "object") total += count(child);
+		}
+		return total;
+	}
+	return count(tree.root);
+}
+/**
+* Extracts all component type names used in a tree.
+*/
+function extractComponentNames(tree) {
+	if (!tree.root) return [];
+	const names = /* @__PURE__ */ new Set();
+	function walk(element) {
+		if (element.type) names.add(element.type);
+		if (element.children) {
+			for (const child of element.children) if (child && typeof child === "object") walk(child);
+		}
+	}
+	walk(tree.root);
+	return [...names];
+}
+/**
+* Creates the configuration for a generative UI stream.
+*
+* This function prepares the system prompt and validation/audit utilities.
+* The actual `streamText()` or `streamObject()` call is made by the caller
+* (typically in a route handler) to avoid coupling to specific AI SDK patterns.
+*
+* @param config - Stream configuration with catalog, user info, and budget.
+* @returns System prompt and audit utilities.
+*
+* @example
+* ```ts
+* import { streamText, Output } from 'ai';
+*
+* const { systemPrompt, logAudit } = createGenerativeUIStreamConfig({
+*   userTier: 'pro',
+*   userId: 'user-123',
+*   catalog,
+* });
+*
+* const { partialOutputStream } = streamText({
+*   model: myModel,
+*   system: systemPrompt,
+*   prompt: userRequest,
+*   output: Output.object({ schema: uiTreeSchema }),
+* });
+*
+* // After streaming completes:
+* await logAudit(finalTree, usage, 'sha256:abc123...');
+* ```
+*/
+function createGenerativeUIStreamConfig(config) {
+	const systemPrompt = buildGenerativeUISystemPrompt(config.catalog, config);
+	const allComponents = config.catalog.components;
+	const tierComponents = config.catalog.getComponentsForTier(config.userTier);
+	const filteredComponents = tierComponents.length < allComponents.length ? allComponents.filter((c) => !new Set(tierComponents.map((t) => t.name)).has(c.name)).map((c) => c.name) : [];
+	return {
+		systemPrompt,
+		async logAudit(finalTree, usage, promptHash) {
+			const costUsd = calculateCost({
+				promptTokens: usage.promptTokens,
+				completionTokens: usage.completionTokens,
+				totalTokens: usage.totalTokens
+			}, config.modelId ?? "gpt-4o");
+			const componentsUsed = extractComponentNames(finalTree);
+			const elementCount = countElements(finalTree);
+			const validation = config.catalog.validateTree(finalTree, config.userTier);
+			const auditEntry = {
+				userId: config.userId,
+				userTier: config.userTier,
+				promptHash,
+				componentsUsed,
+				elementCount,
+				tokenUsage: usage,
+				costUsd,
+				componentsFiltered: filteredComponents,
+				validationPassed: validation.valid,
+				timestamp: (/* @__PURE__ */ new Date()).toISOString()
+			};
+			await getAuditLogger().log({
+				actor: config.userId,
+				action: "generative_ui",
+				input_hash: auditEntry.promptHash,
+				output_snapshot: auditEntry,
+				policy_version: "1.0",
+				metadata: {
+					componentsUsed,
+					elementCount,
+					costUsd,
+					userTier: config.userTier,
+					validationPassed: validation.valid
+				}
+			});
+		}
+	};
+}
+/**
+* Validates and enriches a partial UI tree received from streaming.
+* Applies the catalog's validation rules and adds metadata.
+*
+* @param partialTree - Partial tree from AI output stream.
+* @param catalog - Enterprise catalog for validation.
+* @param tier - User tier for entitlement checking.
+* @returns Validated partial tree, or null if fatally invalid.
+*/
+function validatePartialTree(partialTree, catalog, _tier) {
+	const warnings = [];
+	if (!partialTree.root) {
+		warnings.push("Partial tree has no root element");
+		return {
+			tree: partialTree,
+			warnings
+		};
+	}
+	const names = extractComponentNames(partialTree);
+	for (const name of names) if (!catalog.getComponent(name)) warnings.push(`Unknown component '${name}' in tree`);
+	return {
+		tree: partialTree,
+		warnings
+	};
+}
+/**
+* Budget multiplier for generative UI vs standard text.
+* JSON trees are approximately 2-3x more verbose than markdown.
+* Use this to adjust budget limits for generative UI requests.
+*/
+const GENERATIVE_UI_BUDGET_MULTIPLIER = 2.5;
+/**
+* Estimates the token cost of generating a UI tree for budget pre-flight.
+*
+* @param componentCount - Approximate number of components expected.
+* @param modelId - Model to estimate cost for.
+* @returns Estimated cost in USD.
+*/
+function estimateGenerativeUICost(componentCount, modelId = "gpt-4o") {
+	const estimatedPromptTokens = 500 + componentCount * 50;
+	const estimatedOutputTokens = componentCount * 200;
+	return calculateCost({
+		promptTokens: estimatedPromptTokens,
+		completionTokens: estimatedOutputTokens,
+		totalTokens: estimatedPromptTokens + estimatedOutputTokens
+	}, modelId);
+}
+
+//#endregion
+export { GENERATIVE_UI_BUDGET_MULTIPLIER, createGenerativeUIStreamConfig, estimateGenerativeUICost, validatePartialTree };
+//# sourceMappingURL=generative-ui-stream.mjs.map

package/dist/generative-ui-stream.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"generative-ui-stream.mjs","names":[],"sources":["../src/generative-ui/stream.ts"],"sourcesContent":["import 'server-only';\n\n/**\n * @fileoverview Generative UI Stream (server-only).\n * @module @od-oneapp/ai-platform/generative-ui/stream\n *\n * Creates AI SDK streams that produce generative UI trees.\n * Integrates with budget guards, entitlements, and audit logging\n * from the governance domain.\n *\n * @example\n * ```ts\n * import {\n *   createGenerativeUIStream,\n *   createEnterpriseCatalog,\n *   BASE_CATALOG_COMPONENTS,\n * } from '@od-oneapp/ai-platform/generative-ui';\n *\n * const catalog = createEnterpriseCatalog({\n *   components: BASE_CATALOG_COMPONENTS,\n *   enableEntitlementFiltering: true,\n * });\n *\n * const { partialTreeStream, finalTree } = await createGenerativeUIStream({\n *   userTier: 'pro',\n *   userId: 'user-123',\n *   catalog,\n *   budgetGuard: { maxTokens: 10_000 },\n * }, 'Show me a revenue dashboard');\n *\n * for await (const partial of partialTreeStream) {\n *   // Stream partial UI tree to client\n *   dataStream.write({ type: 'data-uiTreeDelta', data: JSON.stringify(partial) });\n * }\n * ```\n */\n\nimport { getAuditLogger } from '../governance/audit/audit-logger';\nimport { calculateCost } from '../streaming/control/budget-guard';\n\nimport type {\n  EnterpriseCatalog,\n  GenerativeUIAuditEntry,\n  GenerativeUIStreamConfig,\n  UITree,\n} from './types';\nimport type { UserTier } from \"../governance/entitlements\";\n\n// ---------------------------------------------------------------------------\n// Prompt Construction\n// ---------------------------------------------------------------------------\n\n/**\n * Builds the system prompt for generative UI generation.\n * Includes the catalog description, output format instructions,\n * and any additional context.\n */\nfunction buildGenerativeUISystemPrompt(\n  catalog: EnterpriseCatalog,\n  config: GenerativeUIStreamConfig,\n): string {\n  const catalogSection = catalog.generatePromptSection(config.userTier);\n\n  return [\n    'You are a UI generation assistant. Given a user request, you produce a JSON UITree',\n    'that composes available components into a meaningful interface.',\n    '',\n    'Rules:',\n    '1. ONLY use components listed below. Do not invent new component types.',\n    '2. Return valid JSON matching the UITree schema exactly.',\n    '3. Use layout components (Card, Grid, Stack, Section) to organize content.',\n    '4. Choose the most appropriate visualization for the data described.',\n    '5. Keep the tree depth under 5 levels.',\n    '6. Each element must have a \"type\" and \"props\" field.',\n    '7. Children are optional and must be an array of UIElement objects.',\n    '',\n    catalogSection,\n    '',\n    config.systemPromptSuffix ?? '',\n  ].join('\\n');\n}\n\n// ---------------------------------------------------------------------------\n// Tree Utilities\n// ---------------------------------------------------------------------------\n\n/**\n * Counts the total number of elements in a UI tree.\n */\nfunction countElements(tree: Partial<UITree>): number {\n  if (!tree.root) return 0;\n\n  function count(element: { children?: readonly unknown[] }): number {\n    let total = 1;\n    if (element.children) {\n      for (const child of element.children) {\n        if (child && typeof child === 'object') {\n          total += count(child as { children?: readonly unknown[] });\n        }\n      }\n    }\n    return total;\n  }\n\n  return count(tree.root);\n}\n\n/**\n * Extracts all component type names used in a tree.\n */\nfunction extractComponentNames(tree: Partial<UITree>): string[] {\n  if (!tree.root) return [];\n\n  const names = new Set<string>();\n\n  function walk(element: { type?: string; children?: readonly unknown[] }): void {\n    if (element.type) names.add(element.type);\n    if (element.children) {\n      for (const child of element.children) {\n        if (child && typeof child === 'object') {\n          walk(child as { type?: string; children?: readonly unknown[] });\n        }\n      }\n    }\n  }\n\n  walk(tree.root);\n  return [...names];\n}\n\n// ---------------------------------------------------------------------------\n// Stream Factory\n// ---------------------------------------------------------------------------\n\n/**\n * Result of creating a generative UI stream configuration.\n * Provides the system prompt for the LLM call and an audit function\n * to log the completed generation.\n */\nexport interface GenerativeUIStreamOutput {\n  /** System prompt containing catalog description and generation rules. */\n  readonly systemPrompt: string;\n\n  /**\n   * Log the completed generation to the audit trail.\n   *\n   * @param finalTree - The fully-generated UI tree.\n   * @param usage - Token usage from the LLM response.\n   * @param promptHash - SHA-256 hash of the user prompt (e.g. `sha256:abc123`).\n   * @returns Resolves when the audit entry has been written.\n   */\n  logAudit(\n    finalTree: UITree,\n    usage: { promptTokens: number; completionTokens: number; totalTokens: number },\n    promptHash: string,\n  ): Promise<void>;\n}\n\n/**\n * Creates the configuration for a generative UI stream.\n *\n * This function prepares the system prompt and validation/audit utilities.\n * The actual `streamText()` or `streamObject()` call is made by the caller\n * (typically in a route handler) to avoid coupling to specific AI SDK patterns.\n *\n * @param config - Stream configuration with catalog, user info, and budget.\n * @returns System prompt and audit utilities.\n *\n * @example\n * ```ts\n * import { streamText, Output } from 'ai';\n *\n * const { systemPrompt, logAudit } = createGenerativeUIStreamConfig({\n *   userTier: 'pro',\n *   userId: 'user-123',\n *   catalog,\n * });\n *\n * const { partialOutputStream } = streamText({\n *   model: myModel,\n *   system: systemPrompt,\n *   prompt: userRequest,\n *   output: Output.object({ schema: uiTreeSchema }),\n * });\n *\n * // After streaming completes:\n * await logAudit(finalTree, usage, 'sha256:abc123...');\n * ```\n */\nexport function createGenerativeUIStreamConfig(\n  config: GenerativeUIStreamConfig,\n): GenerativeUIStreamOutput {\n  const systemPrompt = buildGenerativeUISystemPrompt(config.catalog, config);\n\n  // Get components filtered for this tier (to detect entitlement filtering).\n  // Only compute the diff when filtering is actually enabled; otherwise\n  // no components are being withheld.\n  const allComponents = config.catalog.components;\n  const tierComponents = config.catalog.getComponentsForTier(config.userTier);\n  const filteredComponents: string[] =\n    tierComponents.length < allComponents.length\n      ? allComponents\n          .filter(c => !new Set(tierComponents.map(t => t.name)).has(c.name))\n          .map(c => c.name)\n      : [];\n\n  return {\n    systemPrompt,\n\n    async logAudit(\n      finalTree: UITree,\n      usage: { promptTokens: number; completionTokens: number; totalTokens: number },\n      promptHash: string,\n    ): Promise<void> {\n      const costUsd = calculateCost(\n        {\n          promptTokens: usage.promptTokens,\n          completionTokens: usage.completionTokens,\n          totalTokens: usage.totalTokens,\n        },\n        config.modelId ?? 'gpt-4o',\n      );\n\n      const componentsUsed = extractComponentNames(finalTree);\n      const elementCount = countElements(finalTree);\n\n      // Validate the tree\n      const validation = config.catalog.validateTree(finalTree, config.userTier);\n\n      const auditEntry: GenerativeUIAuditEntry = {\n        userId: config.userId,\n        userTier: config.userTier,\n        promptHash,\n        componentsUsed,\n        elementCount,\n        tokenUsage: usage,\n        costUsd,\n        componentsFiltered: filteredComponents,\n        validationPassed: validation.valid,\n        timestamp: new Date().toISOString(),\n      };\n\n      const logger = getAuditLogger();\n      await logger.log({\n        actor: config.userId,\n        action: 'generative_ui',\n        input_hash: auditEntry.promptHash,\n        output_snapshot: auditEntry,\n        policy_version: '1.0',\n        metadata: {\n          componentsUsed,\n          elementCount,\n          costUsd,\n          userTier: config.userTier,\n          validationPassed: validation.valid,\n        },\n      });\n    },\n  };\n}\n\n/**\n * Validates and enriches a partial UI tree received from streaming.\n * Applies the catalog's validation rules and adds metadata.\n *\n * @param partialTree - Partial tree from AI output stream.\n * @param catalog - Enterprise catalog for validation.\n * @param tier - User tier for entitlement checking.\n * @returns Validated partial tree, or null if fatally invalid.\n */\nexport function validatePartialTree(\n  partialTree: Partial<UITree>,\n  catalog: EnterpriseCatalog,\n  _tier: UserTier,\n): { tree: Partial<UITree>; warnings: string[] } {\n  const warnings: string[] = [];\n\n  if (!partialTree.root) {\n    warnings.push('Partial tree has no root element');\n    return { tree: partialTree, warnings };\n  }\n\n  // Validate component types exist in catalog\n  const names = extractComponentNames(partialTree);\n  for (const name of names) {\n    if (!catalog.getComponent(name)) {\n      warnings.push(`Unknown component '${name}' in tree`);\n    }\n  }\n\n  return { tree: partialTree, warnings };\n}\n\n/**\n * Budget multiplier for generative UI vs standard text.\n * JSON trees are approximately 2-3x more verbose than markdown.\n * Use this to adjust budget limits for generative UI requests.\n */\nexport const GENERATIVE_UI_BUDGET_MULTIPLIER = 2.5;\n\n/**\n * Estimates the token cost of generating a UI tree for budget pre-flight.\n *\n * @param componentCount - Approximate number of components expected.\n * @param modelId - Model to estimate cost for.\n * @returns Estimated cost in USD.\n */\nexport function estimateGenerativeUICost(\n  componentCount: number,\n  modelId: string = 'gpt-4o',\n): number {\n  // Rough heuristic: ~200 output tokens per component, ~500 prompt tokens for catalog\n  const estimatedPromptTokens = 500 + componentCount * 50; // catalog grows with components\n  const estimatedOutputTokens = componentCount * 200;\n\n  return calculateCost(\n    {\n      promptTokens: estimatedPromptTokens,\n      completionTokens: estimatedOutputTokens,\n      totalTokens: estimatedPromptTokens + estimatedOutputTokens,\n    },\n    modelId,\n  );\n}\n"],"mappings":"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"}

package/dist/generative-ui-types.d.mts

@@ -0,0 +1,123 @@
+import { l as UserTier } from "./index-URlW7aD1.mjs";
+
+//#region src/generative-ui/types.d.ts
+interface UIElement {
+  readonly type: string;
+  readonly props: Record<string, unknown>;
+  readonly children?: readonly UIElement[];
+  readonly id?: string;
+}
+interface UITree {
+  readonly version: '1.0';
+  readonly root: UIElement;
+  readonly metadata?: UITreeMetadata;
+}
+interface UITreeMetadata {
+  readonly modelId?: string;
+  readonly promptHash?: string;
+  readonly generatedAt?: string;
+  readonly tokenCost?: number;
+  readonly componentsUsed?: readonly string[];
+  readonly userTier?: UserTier;
+}
+interface PropSchema {
+  readonly name: string;
+  readonly type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+  readonly description: string;
+  readonly required?: boolean;
+  readonly enum?: readonly (string | number | boolean)[];
+  readonly default?: unknown;
+}
+interface CatalogComponent {
+  readonly name: string;
+  readonly description: string;
+  readonly props: readonly PropSchema[];
+  readonly acceptsChildren?: boolean;
+  readonly category: ComponentCategory;
+  readonly minTier?: UserTier;
+  readonly tags?: readonly string[];
+}
+type ComponentCategory = 'layout' | 'data' | 'chart' | 'metric' | 'action' | 'feedback' | 'navigation' | 'media';
+interface EnterpriseCatalogConfig {
+  readonly components: readonly CatalogComponent[];
+  readonly enableEntitlementFiltering?: boolean;
+  readonly enableAuditLogging?: boolean;
+  readonly validateComponent?: (component: CatalogComponent) => boolean;
+  readonly maxComponentsInPrompt?: number;
+}
+interface EnterpriseCatalog {
+  readonly components: readonly CatalogComponent[];
+  getComponentsForTier(tier: UserTier): readonly CatalogComponent[];
+  getComponent(name: string): CatalogComponent | undefined;
+  generatePromptSection(tier: UserTier): string;
+  validateTree(tree: UITree, tier: UserTier): UITreeValidationResult;
+}
+interface UITreeValidationResult {
+  readonly valid: boolean;
+  readonly errors: readonly UITreeValidationError[];
+}
+interface UITreeValidationError {
+  readonly path: string;
+  readonly message: string;
+  readonly severity: 'error' | 'warning';
+}
+interface GenerativeUIStreamConfig {
+  readonly modelId?: string;
+  readonly userTier: UserTier;
+  readonly userId: string;
+  readonly catalog: EnterpriseCatalog;
+  readonly budgetGuard?: {
+    readonly maxTokens?: number;
+    readonly maxCost?: number;
+  };
+  readonly smoothing?: {
+    readonly delayInMs?: number;
+  };
+  readonly systemPromptSuffix?: string;
+  readonly abortSignal?: AbortSignal;
+}
+interface GenerativeUIStreamResult {
+  readonly partialTreeStream: AsyncIterable<Partial<UITree>>;
+  readonly finalTree: Promise<UITree>;
+  readonly usage: Promise<{
+    readonly promptTokens: number;
+    readonly completionTokens: number;
+    readonly totalTokens: number;
+  }>;
+}
+interface UITreeDeltaStreamPart {
+  readonly type: 'data-uiTreeDelta';
+  readonly data: string;
+}
+interface UseGenerativeUIConfig {
+  readonly api?: string;
+  readonly onTree?: (tree: UITree) => void;
+  readonly onError?: (error: Error) => void;
+  readonly onFinish?: (tree: UITree) => void;
+}
+interface UseGenerativeUIReturn {
+  readonly tree: UITree | null;
+  readonly isGenerating: boolean;
+  generate(prompt: string): void;
+  abort(): void;
+  readonly error: Error | null;
+}
+interface GenerativeUIAuditEntry {
+  readonly userId: string;
+  readonly userTier: UserTier;
+  readonly promptHash: string;
+  readonly componentsUsed: readonly string[];
+  readonly elementCount: number;
+  readonly tokenUsage: {
+    readonly promptTokens: number;
+    readonly completionTokens: number;
+    readonly totalTokens: number;
+  };
+  readonly costUsd: number;
+  readonly componentsFiltered: readonly string[];
+  readonly validationPassed: boolean;
+  readonly timestamp: string;
+}
+//#endregion
+export { CatalogComponent, ComponentCategory, EnterpriseCatalog, EnterpriseCatalogConfig, GenerativeUIAuditEntry, GenerativeUIStreamConfig, GenerativeUIStreamResult, PropSchema, UIElement, UITree, UITreeDeltaStreamPart, UITreeMetadata, UITreeValidationError, UITreeValidationResult, UseGenerativeUIConfig, UseGenerativeUIReturn };
+//# sourceMappingURL=generative-ui-types.d.mts.map

package/dist/generative-ui-types.d.mts.map

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

package/dist/generative-ui-types.mjs

@@ -0,0 +1 @@
+export {  };

package/dist/generative-ui.d.mts

@@ -0,0 +1,13 @@
+import { CatalogComponent, ComponentCategory, EnterpriseCatalog, EnterpriseCatalogConfig, GenerativeUIAuditEntry, GenerativeUIStreamConfig, GenerativeUIStreamResult, PropSchema, UIElement, UITree, UITreeDeltaStreamPart, UITreeMetadata, UITreeValidationError, UITreeValidationResult, UseGenerativeUIConfig, UseGenerativeUIReturn } from "./generative-ui-types.mjs";
+import { BASE_CATALOG_COMPONENTS, createEnterpriseCatalog } from "./generative-ui-catalog.mjs";
+import { BASE_COMPONENT_SCHEMAS, ComponentRegistry, RegisteredComponentName, createComponentRegistry } from "./generative-ui-registry.mjs";
+import { GENERATIVE_UI_BUDGET_MULTIPLIER, GenerativeUIStreamOutput, createGenerativeUIStreamConfig, estimateGenerativeUICost, validatePartialTree } from "./generative-ui-stream.mjs";
+import "server-only";
+
+//#region src/generative-ui/index.d.ts
+declare namespace index_d_exports {
+  export { BASE_CATALOG_COMPONENTS, BASE_COMPONENT_SCHEMAS, CatalogComponent, ComponentCategory, ComponentRegistry, EnterpriseCatalog, EnterpriseCatalogConfig, GENERATIVE_UI_BUDGET_MULTIPLIER, GenerativeUIAuditEntry, GenerativeUIStreamConfig, GenerativeUIStreamOutput, GenerativeUIStreamResult, PropSchema, RegisteredComponentName, UIElement, UITree, UITreeDeltaStreamPart, UITreeMetadata, UITreeValidationError, UITreeValidationResult, UseGenerativeUIConfig, UseGenerativeUIReturn, createComponentRegistry, createEnterpriseCatalog, createGenerativeUIStreamConfig, estimateGenerativeUICost, validatePartialTree };
+}
+//#endregion
+export { BASE_CATALOG_COMPONENTS, BASE_COMPONENT_SCHEMAS, type CatalogComponent, type ComponentCategory, type ComponentRegistry, type EnterpriseCatalog, type EnterpriseCatalogConfig, GENERATIVE_UI_BUDGET_MULTIPLIER, type GenerativeUIAuditEntry, type GenerativeUIStreamConfig, type GenerativeUIStreamOutput, type GenerativeUIStreamResult, type PropSchema, type RegisteredComponentName, type UIElement, type UITree, type UITreeDeltaStreamPart, type UITreeMetadata, type UITreeValidationError, type UITreeValidationResult, type UseGenerativeUIConfig, type UseGenerativeUIReturn, createComponentRegistry, createEnterpriseCatalog, createGenerativeUIStreamConfig, estimateGenerativeUICost, index_d_exports as t, validatePartialTree };
+//# sourceMappingURL=generative-ui.d.mts.map

package/dist/generative-ui.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generative-ui.d.mts","names":[],"sources":["../src/generative-ui/index.ts"],"mappings":""}

package/dist/generative-ui.mjs

@@ -0,0 +1,21 @@
+import { t as __exportAll } from "./chunk-CkzbjWQW.mjs";
+import { BASE_CATALOG_COMPONENTS, createEnterpriseCatalog } from "./generative-ui-catalog.mjs";
+import { BASE_COMPONENT_SCHEMAS, createComponentRegistry } from "./generative-ui-registry.mjs";
+import { GENERATIVE_UI_BUDGET_MULTIPLIER, createGenerativeUIStreamConfig, estimateGenerativeUICost, validatePartialTree } from "./generative-ui-stream.mjs";
+import "server-only";
+
+//#region src/generative-ui/index.ts
+var generative_ui_exports = /* @__PURE__ */ __exportAll({
+	BASE_CATALOG_COMPONENTS: () => BASE_CATALOG_COMPONENTS,
+	BASE_COMPONENT_SCHEMAS: () => BASE_COMPONENT_SCHEMAS,
+	GENERATIVE_UI_BUDGET_MULTIPLIER: () => GENERATIVE_UI_BUDGET_MULTIPLIER,
+	createComponentRegistry: () => createComponentRegistry,
+	createEnterpriseCatalog: () => createEnterpriseCatalog,
+	createGenerativeUIStreamConfig: () => createGenerativeUIStreamConfig,
+	estimateGenerativeUICost: () => estimateGenerativeUICost,
+	validatePartialTree: () => validatePartialTree
+});
+
+//#endregion
+export { BASE_CATALOG_COMPONENTS, BASE_COMPONENT_SCHEMAS, GENERATIVE_UI_BUDGET_MULTIPLIER, createComponentRegistry, createEnterpriseCatalog, createGenerativeUIStreamConfig, estimateGenerativeUICost, generative_ui_exports as t, validatePartialTree };
+//# sourceMappingURL=generative-ui.mjs.map

package/dist/generative-ui.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"generative-ui.mjs","names":[],"sources":["../src/generative-ui/index.ts"],"sourcesContent":["import 'server-only';\n\n/**\n * @fileoverview Generative UI Module (server-only barrel).\n * @module @od-oneapp/ai-platform/generative-ui\n *\n * AI-driven dynamic interface generation with enterprise governance.\n *\n * **Important — Server/Client boundary:**\n * This barrel re-exports `stream.ts` which depends on `node:crypto` via the\n * audit logger. It is therefore **server-only**.\n *\n * Client code (e.g., `'use client'` components) should use the subpath exports:\n * - `@od-oneapp/ai-platform/generative-ui/types` — all type definitions (client-safe)\n * - `@od-oneapp/ai-platform/generative-ui/catalog` — catalog factory (client-safe)\n * - `@od-oneapp/ai-platform/generative-ui/registry` — Zod registry (client-safe)\n *\n * Core capabilities:\n * - **Catalog**: Define and manage available UI components with entitlement filtering\n * - **Registry**: Runtime Zod validation of AI-generated component props\n * - **Stream**: Build streaming configs for generative UI with budget guards and audit\n * - **Types**: Full type system for UI trees, elements, and enterprise extensions\n *\n * Architecture:\n * - ai-platform owns: catalog definition, prompt generation, streaming config, governance\n * - uni-ui owns: `<GenerativeUIRenderer>` component, component mapping, visual rendering\n *\n * @example\n * ```ts\n * // Server-side (route handlers, server actions):\n * import {\n *   createEnterpriseCatalog,\n *   createComponentRegistry,\n *   createGenerativeUIStreamConfig,\n *   BASE_CATALOG_COMPONENTS,\n *   BASE_COMPONENT_SCHEMAS,\n * } from '@od-oneapp/ai-platform/generative-ui';\n *\n * // Client-side ('use client' components):\n * import type { UITree, UIElement } from '@od-oneapp/ai-platform/generative-ui/types';\n * ```\n */\n\n// Types\nexport type {\n  UIElement,\n  UITree,\n  UITreeMetadata,\n  PropSchema,\n  CatalogComponent,\n  ComponentCategory,\n  EnterpriseCatalogConfig,\n  EnterpriseCatalog,\n  UITreeValidationResult,\n  UITreeValidationError,\n  GenerativeUIStreamConfig,\n  GenerativeUIStreamResult,\n  UITreeDeltaStreamPart,\n  UseGenerativeUIConfig,\n  UseGenerativeUIReturn,\n  GenerativeUIAuditEntry,\n} from './types';\n\n// Catalog\nexport { BASE_CATALOG_COMPONENTS, createEnterpriseCatalog } from './catalog';\n\n// Registry\nexport {\n  BASE_COMPONENT_SCHEMAS,\n  createComponentRegistry,\n  type RegisteredComponentName,\n  type ComponentRegistry,\n} from './registry';\n\n// Stream\nexport {\n  createGenerativeUIStreamConfig,\n  validatePartialTree,\n  estimateGenerativeUICost,\n  GENERATIVE_UI_BUDGET_MULTIPLIER,\n  type GenerativeUIStreamOutput,\n} from './stream';\n"],"mappings":""}

package/dist/governance-audit.d.mts

@@ -0,0 +1,3 @@
+import { a as AuditActionSchema, c as AuditQueryFilter, d as validateQueryFilter, i as AuditAction, l as AuditQueryFilterSchema, n as ABACDecision, o as AuditEntry, r as ABACDecisionSchema, s as AuditEntrySchema, u as validateAuditEntry } from "./types-DJnugQX0.mjs";
+import { a as logToolCall, i as logRedaction, n as getAuditLogger, o as setAuditLogger, r as logGeneration, t as createAuditLogger } from "./audit-logger-Bb2JIcIk.mjs";
+export { ABACDecision, ABACDecisionSchema, AuditAction, AuditActionSchema, AuditEntry, AuditEntrySchema, AuditQueryFilter, AuditQueryFilterSchema, createAuditLogger, getAuditLogger, logGeneration, logRedaction, logToolCall, setAuditLogger, validateAuditEntry, validateQueryFilter };

package/dist/governance-audit.mjs

@@ -0,0 +1,3 @@
+import { a as logToolCall, c as AuditActionSchema, d as validateAuditEntry, f as validateQueryFilter, i as logRedaction, l as AuditEntrySchema, n as getAuditLogger, o as setAuditLogger, r as logGeneration, s as ABACDecisionSchema, t as createAuditLogger, u as AuditQueryFilterSchema } from "./audit-logger-CHIP8bRO.mjs";
+
+export { ABACDecisionSchema, AuditActionSchema, AuditEntrySchema, AuditQueryFilterSchema, createAuditLogger, getAuditLogger, logGeneration, logRedaction, logToolCall, setAuditLogger, validateAuditEntry, validateQueryFilter };

package/dist/governance-compliance.d.mts

@@ -0,0 +1,5 @@
+import "./schemas-DBOhxgW7.mjs";
+import "./types-DJnugQX0.mjs";
+import "./types-CLBWFRZN.mjs";
+import { A as PolicyRegistry, C as hasRole, D as ABACEvaluationResult, E as unregisterPolicy, O as Policy, S as hasAnyRole, T as registerPolicy, _ as createABACContext, a as SAFE_HARBOR_PATTERNS, b as getPolicies, c as previewRedactions, d as sanitizeForLogging, f as analyzePHI, g as allow, h as isSafeHarborCompliant, i as HIGH_CONFIDENCE_PATTERNS, k as PolicyEvaluator, l as redactPHI, m as detectPHI, n as getApprovalQueue, o as getConfidenceScore, p as containsPHI, r as setApprovalQueue, s as isFalsePositive, t as createApprovalQueue, u as redactSpecificTypes, v as deny, w as isResourceSensitive, x as hasAllRoles, y as evaluatePolicy } from "./compliance-approval-queue-IrMxFfSJ.mjs";
+export { ABACEvaluationResult, HIGH_CONFIDENCE_PATTERNS, Policy, PolicyEvaluator, PolicyRegistry, SAFE_HARBOR_PATTERNS, allow, analyzePHI, containsPHI, createABACContext, createApprovalQueue, deny, detectPHI, evaluatePolicy, getApprovalQueue, getConfidenceScore, getPolicies, hasAllRoles, hasAnyRole, hasRole, isFalsePositive, isResourceSensitive, isSafeHarborCompliant, previewRedactions, redactPHI, redactSpecificTypes, registerPolicy, sanitizeForLogging, setApprovalQueue, unregisterPolicy };

package/dist/governance-compliance.mjs

@@ -0,0 +1,4 @@
+import { C as unregisterPolicy, S as registerPolicy, _ as getPolicies, a as analyzePHI, b as hasRole, c as isSafeHarborCompliant, d as getConfidenceScore, f as isFalsePositive, g as evaluatePolicy, h as deny, i as sanitizeForLogging, l as HIGH_CONFIDENCE_PATTERNS, m as createABACContext, n as redactPHI, o as containsPHI, p as allow, r as redactSpecificTypes, s as detectPHI, t as previewRedactions, u as SAFE_HARBOR_PATTERNS, v as hasAllRoles, x as isResourceSensitive, y as hasAnyRole } from "./redaction-utils-DcQwsiNh.mjs";
+import { n as getApprovalQueue, r as setApprovalQueue, t as createApprovalQueue } from "./compliance-approval-queue-DQGLojAm.mjs";
+
+export { HIGH_CONFIDENCE_PATTERNS, SAFE_HARBOR_PATTERNS, allow, analyzePHI, containsPHI, createABACContext, createApprovalQueue, deny, detectPHI, evaluatePolicy, getApprovalQueue, getConfidenceScore, getPolicies, hasAllRoles, hasAnyRole, hasRole, isFalsePositive, isResourceSensitive, isSafeHarborCompliant, previewRedactions, redactPHI, redactSpecificTypes, registerPolicy, sanitizeForLogging, setApprovalQueue, unregisterPolicy };

package/dist/governance-policies.d.mts

@@ -0,0 +1,4 @@
+import "./ai-runtime-DIwOEc6g.mjs";
+import { n as RiskLevel, t as ComplianceSignal } from "./schemas-DBOhxgW7.mjs";
+import { a as resolveLoopPolicy, c as TOKEN_LIMITS, d as detectRiskFromMessages, f as getTokenLimitForRisk, i as mergeActiveTools, l as applyDefaultGuardrails, n as defaultTelemetry, o as GuardrailResult, r as LoopPolicy, s as PromptInjectionResult, t as createTelemetrySettings, u as detectPromptInjection } from "./telemetry-C2t03dwD.mjs";
+export { type ComplianceSignal, GuardrailResult, LoopPolicy, PromptInjectionResult, type RiskLevel, TOKEN_LIMITS, applyDefaultGuardrails, createTelemetrySettings, defaultTelemetry, detectPromptInjection, detectRiskFromMessages, getTokenLimitForRisk, mergeActiveTools, resolveLoopPolicy };

package/dist/governance-policies.mjs

@@ -0,0 +1,4 @@
+import "./schemas-CxQtxIga.mjs";
+import { a as TOKEN_LIMITS, c as detectRiskFromMessages, i as resolveLoopPolicy, l as getTokenLimitForRisk, n as defaultTelemetry, o as applyDefaultGuardrails, r as mergeActiveTools, s as detectPromptInjection, t as createTelemetrySettings } from "./telemetry-2eKMojIb.mjs";
+
+export { TOKEN_LIMITS, applyDefaultGuardrails, createTelemetrySettings, defaultTelemetry, detectPromptInjection, detectRiskFromMessages, getTokenLimitForRisk, mergeActiveTools, resolveLoopPolicy };

package/dist/governance-tenancy.d.mts

@@ -0,0 +1,3 @@
+import "./ai-runtime-DIwOEc6g.mjs";
+import { a as clearTenantContext, c as getTenantContextOrNull, d as TenantConfig, f as TenantContext, h as TenantTier, i as createQuotaMiddleware, l as setTenantContext, m as TenantQuotas, n as QuotaTracker, o as createTenantContext, p as TenantQuotaExceededError, r as QuotaUsage, s as getTenantContext, t as InMemoryQuotaTracker, u as withTenantContext } from "./quota-manager-0iPMkQWN.mjs";
+export { InMemoryQuotaTracker, type QuotaTracker, type QuotaUsage, type TenantConfig, type TenantContext, TenantQuotaExceededError, type TenantQuotas, type TenantTier, clearTenantContext, createQuotaMiddleware, createTenantContext, getTenantContext, getTenantContextOrNull, setTenantContext, withTenantContext };

package/dist/governance-tenancy.mjs

@@ -0,0 +1,3 @@
+import { a as getTenantContext, c as withTenantContext, i as createTenantContext, l as TenantQuotaExceededError, n as createQuotaMiddleware, o as getTenantContextOrNull, r as clearTenantContext, s as setTenantContext, t as InMemoryQuotaTracker } from "./quota-manager-D_N7FuQ2.mjs";
+
+export { InMemoryQuotaTracker, TenantQuotaExceededError, clearTenantContext, createQuotaMiddleware, createTenantContext, getTenantContext, getTenantContextOrNull, setTenantContext, withTenantContext };

package/dist/governance.d.mts

@@ -0,0 +1,88 @@
+import "./ai-runtime-DIwOEc6g.mjs";
+import { n as RiskLevel, t as ComplianceSignal } from "./schemas-DBOhxgW7.mjs";
+import { a as QuotaStats, c as UserEntitlements, d as checkModelAccess, f as createEntitlementChecker, i as EntitlementConfig, l as UserTier, n as EntitlementCheckResult, o as QuotaStorage, r as EntitlementChecker, s as User, t as DEFAULT_ENTITLEMENTS, u as checkFeatureAccess } from "./index-URlW7aD1.mjs";
+import { a as AuditActionSchema, c as AuditQueryFilter, d as validateQueryFilter, i as AuditAction, l as AuditQueryFilterSchema, n as ABACDecision, o as AuditEntry, r as ABACDecisionSchema, s as AuditEntrySchema, u as validateAuditEntry } from "./types-DJnugQX0.mjs";
+import { a as logToolCall, i as logRedaction, n as getAuditLogger, o as setAuditLogger, r as logGeneration, t as createAuditLogger } from "./audit-logger-Bb2JIcIk.mjs";
+import "./governance-audit.mjs";
+import "./types-CLBWFRZN.mjs";
+import { A as PolicyRegistry, C as hasRole, D as ABACEvaluationResult, E as unregisterPolicy, O as Policy, S as hasAnyRole, T as registerPolicy, _ as createABACContext, a as SAFE_HARBOR_PATTERNS, b as getPolicies, c as previewRedactions, d as sanitizeForLogging, f as analyzePHI, g as allow, h as isSafeHarborCompliant, i as HIGH_CONFIDENCE_PATTERNS, k as PolicyEvaluator, l as redactPHI, m as detectPHI, n as getApprovalQueue, o as getConfidenceScore, p as containsPHI, r as setApprovalQueue, s as isFalsePositive, t as createApprovalQueue, u as redactSpecificTypes, v as deny, w as isResourceSensitive, x as hasAllRoles, y as evaluatePolicy } from "./compliance-approval-queue-IrMxFfSJ.mjs";
+import "./governance-compliance.mjs";
+import { a as resolveLoopPolicy, c as TOKEN_LIMITS, d as detectRiskFromMessages, f as getTokenLimitForRisk, i as mergeActiveTools, l as applyDefaultGuardrails, n as defaultTelemetry, o as GuardrailResult, r as LoopPolicy, s as PromptInjectionResult, t as createTelemetrySettings, u as detectPromptInjection } from "./telemetry-C2t03dwD.mjs";
+import "./governance-policies.mjs";
+import { a as clearTenantContext, c as getTenantContextOrNull, d as TenantConfig, f as TenantContext, h as TenantTier, i as createQuotaMiddleware, l as setTenantContext, m as TenantQuotas, n as QuotaTracker, o as createTenantContext, p as TenantQuotaExceededError, r as QuotaUsage, s as getTenantContext, t as InMemoryQuotaTracker, u as withTenantContext } from "./quota-manager-0iPMkQWN.mjs";
+import "./governance-tenancy.mjs";
+
+//#region src/governance/versioning/index.d.ts
+declare const POLICY_VERSION: "2.0.0";
+declare const SCHEMA_VERSION: "1.0.0";
+declare const PLATFORM_VERSION: "1.0.0";
+type SemVer = `${number}.${number}.${number}`;
+interface VersionMetadata {
+  version: SemVer;
+  releasedAt: Date;
+  deprecated: boolean;
+  migrateToVersion?: SemVer;
+  breakingChanges?: string[];
+  features?: string[];
+  bugFixes?: string[];
+  metadata?: Record<string, unknown>;
+}
+interface VersionChange {
+  id: string;
+  type: 'breaking' | 'feature' | 'fix' | 'deprecation';
+  description: string;
+  affectedComponents: string[];
+  migrationGuide?: string;
+}
+interface VersionedConfig<T = unknown> {
+  schemaVersion: SemVer;
+  data: T;
+  createdAt: Date;
+  updatedAt: Date;
+  hash?: string;
+}
+type MigrationFn<TFrom = unknown, TTo = unknown> = (config: TFrom) => TTo;
+interface Migration {
+  fromVersion: SemVer;
+  toVersion: SemVer;
+  migrate: MigrationFn;
+  description?: string;
+}
+interface VersionRegistry {
+  registerVersion(metadata: VersionMetadata): void;
+  getVersion(version: SemVer): VersionMetadata | undefined;
+  getAllVersions(): VersionMetadata[];
+  getLatestVersion(): VersionMetadata | undefined;
+  deprecateVersion(version: SemVer, migrateToVersion: SemVer): void;
+  hasVersion(version: SemVer): boolean;
+  registerMigration(migration: Migration): void;
+  getMigrationPath(fromVersion: SemVer, toVersion: SemVer): Migration[];
+  migrate<T>(config: T, fromVersion: SemVer, toVersion: SemVer): T;
+}
+interface VersionRegistryConfig {
+  versions?: VersionMetadata[];
+  migrations?: Migration[];
+}
+declare function createVersionRegistry(config?: VersionRegistryConfig): VersionRegistry;
+declare function parseVersion(version: string): {
+  major: number;
+  minor: number;
+  patch: number;
+};
+declare function compareVersions(a: string, b: string): number;
+declare function isVersionCompatible(configVersion: string, targetVersion: string): boolean;
+declare function satisfiesRange(version: string, range: string): boolean;
+declare function getCurrentVersion(): SemVer;
+declare function getCurrentPolicyVersion(): SemVer;
+declare function getCurrentSchemaVersion(): SemVer;
+declare function createVersionedConfig<T>(data: T, schemaVersion?: SemVer): VersionedConfig<T>;
+declare function updateVersionedConfig<T>(config: VersionedConfig<T>, updates: Partial<T>): VersionedConfig<T>;
+declare function migrateVersionedConfig<T>(config: VersionedConfig<T>, targetVersion: SemVer, registry: VersionRegistry): VersionedConfig<T>;
+declare function validateConfigIntegrity<T>(config: VersionedConfig<T>): boolean;
+declare const defaultRegistry: VersionRegistry;
+declare namespace index_d_exports {
+  export { ABACDecision, ABACDecisionSchema, ABACEvaluationResult, AuditAction, AuditActionSchema, AuditEntry, AuditEntrySchema, AuditQueryFilter, AuditQueryFilterSchema, ComplianceSignal, DEFAULT_ENTITLEMENTS, EntitlementCheckResult, EntitlementChecker, EntitlementConfig, GuardrailResult, HIGH_CONFIDENCE_PATTERNS, InMemoryQuotaTracker, LoopPolicy, Migration, MigrationFn, PLATFORM_VERSION, POLICY_VERSION, Policy, PolicyEvaluator, PolicyRegistry, PromptInjectionResult, QuotaStats, QuotaStorage, QuotaTracker, QuotaUsage, RiskLevel, SAFE_HARBOR_PATTERNS, SCHEMA_VERSION, SemVer, TOKEN_LIMITS, TenantConfig, TenantContext, TenantQuotaExceededError, TenantQuotas, TenantTier, User, UserEntitlements, UserTier, VersionChange, VersionMetadata, VersionRegistry, VersionRegistryConfig, VersionedConfig, allow, analyzePHI, applyDefaultGuardrails, checkFeatureAccess, checkModelAccess, clearTenantContext, compareVersions, containsPHI, createABACContext, createApprovalQueue, createAuditLogger, createEntitlementChecker, createQuotaMiddleware, createTelemetrySettings, createTenantContext, createVersionRegistry, createVersionedConfig, defaultRegistry, defaultTelemetry, deny, detectPHI, detectPromptInjection, detectRiskFromMessages, evaluatePolicy, getApprovalQueue, getAuditLogger, getConfidenceScore, getCurrentPolicyVersion, getCurrentSchemaVersion, getCurrentVersion, getPolicies, getTenantContext, getTenantContextOrNull, getTokenLimitForRisk, hasAllRoles, hasAnyRole, hasRole, isFalsePositive, isResourceSensitive, isSafeHarborCompliant, isVersionCompatible, logGeneration, logRedaction, logToolCall, mergeActiveTools, migrateVersionedConfig, parseVersion, previewRedactions, redactPHI, redactSpecificTypes, registerPolicy, resolveLoopPolicy, sanitizeForLogging, satisfiesRange, setApprovalQueue, setAuditLogger, setTenantContext, unregisterPolicy, updateVersionedConfig, validateAuditEntry, validateConfigIntegrity, validateQueryFilter, withTenantContext };
+}
+//#endregion
+export { ABACDecision, ABACDecisionSchema, ABACEvaluationResult, AuditAction, AuditActionSchema, AuditEntry, AuditEntrySchema, AuditQueryFilter, AuditQueryFilterSchema, ComplianceSignal, DEFAULT_ENTITLEMENTS, EntitlementCheckResult, EntitlementChecker, EntitlementConfig, GuardrailResult, HIGH_CONFIDENCE_PATTERNS, InMemoryQuotaTracker, LoopPolicy, Migration, MigrationFn, PLATFORM_VERSION, POLICY_VERSION, Policy, PolicyEvaluator, PolicyRegistry, PromptInjectionResult, QuotaStats, QuotaStorage, QuotaTracker, QuotaUsage, RiskLevel, SAFE_HARBOR_PATTERNS, SCHEMA_VERSION, SemVer, TOKEN_LIMITS, TenantConfig, TenantContext, TenantQuotaExceededError, TenantQuotas, TenantTier, User, UserEntitlements, UserTier, VersionChange, VersionMetadata, VersionRegistry, VersionRegistryConfig, VersionedConfig, allow, analyzePHI, applyDefaultGuardrails, checkFeatureAccess, checkModelAccess, clearTenantContext, compareVersions, containsPHI, createABACContext, createApprovalQueue, createAuditLogger, createEntitlementChecker, createQuotaMiddleware, createTelemetrySettings, createTenantContext, createVersionRegistry, createVersionedConfig, defaultRegistry, defaultTelemetry, deny, detectPHI, detectPromptInjection, detectRiskFromMessages, evaluatePolicy, getApprovalQueue, getAuditLogger, getConfidenceScore, getCurrentPolicyVersion, getCurrentSchemaVersion, getCurrentVersion, getPolicies, getTenantContext, getTenantContextOrNull, getTokenLimitForRisk, hasAllRoles, hasAnyRole, hasRole, isFalsePositive, isResourceSensitive, isSafeHarborCompliant, isVersionCompatible, logGeneration, logRedaction, logToolCall, mergeActiveTools, migrateVersionedConfig, parseVersion, previewRedactions, redactPHI, redactSpecificTypes, registerPolicy, resolveLoopPolicy, sanitizeForLogging, satisfiesRange, setApprovalQueue, setAuditLogger, setTenantContext, index_d_exports as t, unregisterPolicy, updateVersionedConfig, validateAuditEntry, validateConfigIntegrity, validateQueryFilter, withTenantContext };
+//# sourceMappingURL=governance.d.mts.map

package/dist/governance.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance.d.mts","names":[],"sources":["../src/governance/versioning/index.ts","../src/governance/index.ts"],"mappings":";;;;;;;;;;;;;;;cAmCa,cAAA;AAAA,cAGA,cAAA;AAAA,cAGA,gBAAA;AAAA,KAOD,MAAA;AAAA,UAGK,eAAA;EAEf,OAAA,EAAS,MAAA;EAET,UAAA,EAAY,IAAA;EAEZ,UAAA;EAEA,gBAAA,GAAmB,MAAA;EAEnB,eAAA;EAEA,QAAA;EAEA,QAAA;EAEA,QAAA,GAAW,MAAA;AAAA;AAAA,UAII,aAAA;EAEf,EAAA;EAEA,IAAA;EAEA,WAAA;EAEA,kBAAA;EAEA,cAAA;AAAA;AAAA,UAIe,eAAA;EAEf,aAAA,EAAe,MAAA;EAEf,IAAA,EAAM,CAAA;EAEN,SAAA,EAAW,IAAA;EAEX,SAAA,EAAW,IAAA;EAEX,IAAA;AAAA;AAAA,KAIU,WAAA,oCAA+C,MAAA,EAAQ,KAAA,KAAU,GAAA;AAAA,UAG5D,SAAA;EAEf,WAAA,EAAa,MAAA;EAEb,SAAA,EAAW,MAAA;EAEX,OAAA,EAAS,WAAA;EAET,WAAA;AAAA;AAAA,UAIe,eAAA;EAEf,eAAA,CAAgB,QAAA,EAAU,eAAA;EAE1B,UAAA,CAAW,OAAA,EAAS,MAAA,GAAS,eAAA;EAE7B,cAAA,IAAkB,eAAA;EAElB,gBAAA,IAAoB,eAAA;EAEpB,gBAAA,CAAiB,OAAA,EAAS,MAAA,EAAQ,gBAAA,EAAkB,MAAA;EAEpD,UAAA,CAAW,OAAA,EAAS,MAAA;EAEpB,iBAAA,CAAkB,SAAA,EAAW,SAAA;EAE7B,gBAAA,CAAiB,WAAA,EAAa,MAAA,EAAQ,SAAA,EAAW,MAAA,GAAS,SAAA;EAE1D,OAAA,IAAW,MAAA,EAAQ,CAAA,EAAG,WAAA,EAAa,MAAA,EAAQ,SAAA,EAAW,MAAA,GAAS,CAAA;AAAA;AAAA,UAIhD,qBAAA;EAEf,QAAA,GAAW,eAAA;EAEX,UAAA,GAAa,SAAA;AAAA;AAAA,iBAmCC,qBAAA,CAAsB,MAAA,GAAQ,qBAAA,GAA6B,eAAA;AAAA,iBAgI3D,YAAA,CAAa,OAAA;EAAoB,KAAA;EAAe,KAAA;EAAe,KAAA;AAAA;AAAA,iBA6B/D,eAAA,CAAgB,CAAA,UAAW,CAAA;AAAA,iBAsB3B,mBAAA,CAAoB,aAAA,UAAuB,aAAA;AAAA,iBAkB3C,cAAA,CAAe,OAAA,UAAiB,KAAA;AAAA,iBA2ChC,iBAAA,CAAA,GAAqB,MAAA;AAAA,iBAOrB,uBAAA,CAAA,GAA2B,MAAA;AAAA,iBAO3B,uBAAA,CAAA,GAA2B,MAAA;AAAA,iBAmB3B,qBAAA,GAAA,CACd,IAAA,EAAM,CAAA,EACN,aAAA,GAAe,MAAA,GACd,eAAA,CAAgB,CAAA;AAAA,iBAmBH,qBAAA,GAAA,CACd,MAAA,EAAQ,eAAA,CAAgB,CAAA,GACxB,OAAA,EAAS,OAAA,CAAQ,CAAA,IAChB,eAAA,CAAgB,CAAA;AAAA,iBAmBH,sBAAA,GAAA,CACd,MAAA,EAAQ,eAAA,CAAgB,CAAA,GACxB,aAAA,EAAe,MAAA,EACf,QAAA,EAAU,eAAA,GACT,eAAA,CAAgB,CAAA;AAAA,iBAmBH,uBAAA,GAAA,CAA2B,MAAA,EAAQ,eAAA,CAAgB,CAAA;AAAA,cAUtD,eAAA,EAAe,eAAA;AAAA"}