@od-oneapp/ai-platform 0.1.0

package/dist/reranking-Ck8aKZW7.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"reranking-Ck8aKZW7.mjs","names":[],"sources":["../src/grounding/embed/reranking.ts"],"sourcesContent":["/**\n * Reranking Module - AI SDK v6 Compatible\n *\n * Provides document reranking capabilities for RAG pipelines using\n * Cohere, cross-encoders, and other reranking providers.\n *\n * @module @od-oneapp/ai-platform/grounding/embed/reranking\n */\n\nimport { logWarn } from '@repo/shared/logs';\nimport { z } from 'zod';\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * A document to be reranked\n */\nexport interface RerankDocument {\n  /** Unique identifier for the document */\n  id: string;\n  /** The text content to rerank */\n  text: string;\n  /** Optional metadata */\n  metadata?: Record<string, unknown>;\n  /** Original relevance score (e.g., from vector search) */\n  originalScore?: number;\n}\n\n/**\n * Result of reranking a document\n */\nexport interface RerankResult {\n  /** The original document */\n  document: RerankDocument;\n  /** New relevance score from reranker (0-1) */\n  relevanceScore: number;\n  /** Position in original results */\n  originalIndex: number;\n  /** Position after reranking */\n  newIndex: number;\n}\n\n/**\n * Options for reranking\n */\nexport interface RerankOptions {\n  /** The query to rerank against */\n  query: string;\n  /** Documents to rerank */\n  documents: RerankDocument[];\n  /** Maximum number of results to return */\n  topK?: number;\n  /** Minimum relevance score threshold (0-1) */\n  minScore?: number;\n  /** Whether to return documents below threshold */\n  returnAllResults?: boolean;\n  /** Model to use for reranking */\n  model?: string;\n}\n\n/**\n * Reranking provider interface\n */\nexport interface RerankProvider {\n  /** Provider name */\n  readonly name: string;\n  /** Rerank documents */\n  rerank(options: RerankOptions): Promise<RerankResult[]>;\n  /** Check if provider is available */\n  isAvailable(): Promise<boolean>;\n}\n\n/**\n * Cohere reranker configuration\n */\nexport interface CohereRerankConfig {\n  apiKey: string;\n  model?: 'rerank-english-v3.0' | 'rerank-multilingual-v3.0' | 'rerank-english-v2.0';\n  baseUrl?: string;\n  maxRetries?: number;\n  timeout?: number;\n}\n\n/**\n * Cross-encoder reranker configuration\n */\nexport interface CrossEncoderConfig {\n  modelName: string;\n  endpoint: string;\n  apiKey?: string;\n  batchSize?: number;\n  timeout?: number;\n}\n\n// ============================================================================\n// Schemas\n// ============================================================================\n\nexport const RerankDocumentSchema = z.object({\n  id: z.string(),\n  text: z.string(),\n  metadata: z.record(z.string(), z.unknown()).optional(),\n  originalScore: z.number().optional(),\n});\n\nexport const RerankOptionsSchema = z.object({\n  query: z.string().min(1),\n  documents: z.array(RerankDocumentSchema).min(1),\n  topK: z.number().int().positive().optional(),\n  minScore: z.number().min(0).max(1).optional(),\n  returnAllResults: z.boolean().optional(),\n  model: z.string().optional(),\n});\n\n// ============================================================================\n// Cohere Reranker\n// ============================================================================\n\n/**\n * Create a Cohere reranker provider\n *\n * @example\n * ```typescript\n * const reranker = createCohereReranker({\n *   apiKey: process.env.COHERE_API_KEY!,\n *   model: 'rerank-english-v3.0',\n * });\n *\n * const results = await reranker.rerank({\n *   query: 'What is machine learning?',\n *   documents: docs,\n *   topK: 5,\n * });\n * ```\n */\nexport function createCohereReranker(config: CohereRerankConfig): RerankProvider {\n  const {\n    apiKey,\n    model = 'rerank-english-v3.0',\n    baseUrl = 'https://api.cohere.ai/v1',\n    maxRetries = 3,\n    timeout = 30000,\n  } = config;\n\n  return {\n    name: 'cohere',\n\n    async rerank(options: RerankOptions): Promise<RerankResult[]> {\n      const { query, documents, topK, minScore = 0, returnAllResults = false } = options;\n\n      if (documents.length === 0) {\n        return [];\n      }\n\n      // Prepare documents for Cohere API\n      const docTexts = documents.map(d => d.text);\n\n      let lastError: Error | null = null;\n      for (let attempt = 0; attempt < maxRetries; attempt++) {\n        try {\n          const controller = new AbortController();\n          const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n          const response = await fetch(`${baseUrl}/rerank`, {\n            method: 'POST',\n            headers: {\n              Authorization: `Bearer ${apiKey}`,\n              'Content-Type': 'application/json',\n            },\n            body: JSON.stringify({\n              query,\n              documents: docTexts,\n              model: options.model || model,\n              top_n: topK || documents.length,\n              return_documents: false,\n            }),\n            signal: controller.signal,\n          });\n\n          clearTimeout(timeoutId);\n\n          if (!response.ok) {\n            const errorText = await response.text();\n            throw new Error(`Cohere API error: ${response.status} - ${errorText}`);\n          }\n\n          const data = (await response.json()) as {\n            results: Array<{ index: number; relevance_score: number }>;\n          };\n\n          // Map results back to documents\n          const results: RerankResult[] = data.results\n            .map((r, newIndex) => {\n              const document = documents[r.index];\n              if (!document) return null;\n              return {\n                document,\n                relevanceScore: r.relevance_score,\n                originalIndex: r.index,\n                newIndex,\n              };\n            })\n            .filter(\n              (entry): entry is RerankResult =>\n                entry !== null && (returnAllResults || entry.relevanceScore >= minScore),\n            );\n\n          return topK ? results.slice(0, topK) : results;\n        } catch (error) {\n          lastError = error as Error;\n          if (attempt < maxRetries - 1) {\n            // Exponential backoff\n            await new Promise(resolve => setTimeout(resolve, Math.pow(2, attempt) * 1000));\n          }\n        }\n      }\n\n      throw lastError || new Error('Cohere rerank failed after retries');\n    },\n\n    async isAvailable(): Promise<boolean> {\n      try {\n        const response = await fetch(`${baseUrl}/check-api-key`, {\n          method: 'POST',\n          headers: {\n            Authorization: `Bearer ${apiKey}`,\n            'Content-Type': 'application/json',\n          },\n        });\n        return response.ok;\n      } catch {\n        return false;\n      }\n    },\n  };\n}\n\n// ============================================================================\n// Cross-Encoder Reranker\n// ============================================================================\n\n/**\n * Create a cross-encoder reranker (for self-hosted models)\n *\n * @example\n * ```typescript\n * const reranker = createCrossEncoderReranker({\n *   modelName: 'cross-encoder/ms-marco-MiniLM-L-6-v2',\n *   endpoint: 'http://localhost:8080/rerank',\n * });\n * ```\n */\nexport function createCrossEncoderReranker(config: CrossEncoderConfig): RerankProvider {\n  const { modelName, endpoint, apiKey, batchSize = 32, timeout = 60000 } = config;\n\n  return {\n    name: `cross-encoder:${modelName}`,\n\n    async rerank(options: RerankOptions): Promise<RerankResult[]> {\n      const { query, documents, topK, minScore = 0, returnAllResults = false } = options;\n\n      if (documents.length === 0) {\n        return [];\n      }\n\n      // Process in batches\n      const allScores: number[] = [];\n\n      for (let i = 0; i < documents.length; i += batchSize) {\n        const batch = documents.slice(i, i + batchSize);\n\n        const controller = new AbortController();\n        const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n        const headers: Record<string, string> = {\n          'Content-Type': 'application/json',\n        };\n        if (apiKey) {\n          headers['Authorization'] = `Bearer ${apiKey}`;\n        }\n\n        const response = await fetch(endpoint, {\n          method: 'POST',\n          headers,\n          body: JSON.stringify({\n            model: modelName,\n            query,\n            documents: batch.map(d => d.text),\n          }),\n          signal: controller.signal,\n        });\n\n        clearTimeout(timeoutId);\n\n        if (!response.ok) {\n          throw new Error(`Cross-encoder API error: ${response.status}`);\n        }\n\n        const data = (await response.json()) as { scores: number[] };\n        allScores.push(...data.scores);\n      }\n\n      // Create results with scores\n      const results: RerankResult[] = documents\n        .map((doc, index) => {\n          const score = allScores[index];\n          if (score === undefined) return null;\n          return {\n            document: doc,\n            relevanceScore: score,\n            originalIndex: index,\n            newIndex: -1, // Will be set after sorting\n          };\n        })\n        .filter((entry): entry is RerankResult => entry !== null)\n        .sort((a, b) => b.relevanceScore - a.relevanceScore)\n        .map((r, newIndex) => ({ ...r, newIndex }))\n        .filter(r => returnAllResults || r.relevanceScore >= minScore);\n\n      return topK ? results.slice(0, topK) : results;\n    },\n\n    async isAvailable(): Promise<boolean> {\n      try {\n        const response = await fetch(endpoint.replace('/rerank', '/health'), {\n          method: 'GET',\n        });\n        return response.ok;\n      } catch {\n        return false;\n      }\n    },\n  };\n}\n\n// ============================================================================\n// Reciprocal Rank Fusion\n// ============================================================================\n\n/**\n * Combine multiple ranking results using Reciprocal Rank Fusion\n *\n * RRF is useful when combining results from different retrieval methods\n * (e.g., BM25 + vector search + reranker).\n *\n * @example\n * ```typescript\n * const combined = reciprocalRankFusion([\n *   vectorSearchResults,\n *   bm25Results,\n *   rerankResults,\n * ], { k: 60 });\n * ```\n */\nexport function reciprocalRankFusion(\n  rankings: RerankResult[][],\n  options: { k?: number; topK?: number } = {},\n): RerankResult[] {\n  const { k = 60, topK } = options;\n\n  // Calculate RRF scores\n  const scoreMap = new Map<string, { score: number; document: RerankDocument }>();\n\n  for (const ranking of rankings) {\n    for (let rank = 0; rank < ranking.length; rank++) {\n      const result = ranking[rank];\n      if (!result) {\n        continue;\n      }\n      const docId = result.document.id;\n      const rrfScore = 1 / (k + rank + 1);\n\n      const existing = scoreMap.get(docId);\n      if (existing) {\n        existing.score += rrfScore;\n      } else {\n        scoreMap.set(docId, { score: rrfScore, document: result.document });\n      }\n    }\n  }\n\n  // Sort by combined RRF score\n  const results = Array.from(scoreMap.values())\n    .sort((a, b) => b.score - a.score)\n    .map((item, index) => ({\n      document: item.document,\n      relevanceScore: item.score,\n      originalIndex: -1,\n      newIndex: index,\n    }));\n\n  return topK ? results.slice(0, topK) : results;\n}\n\n// ============================================================================\n// Reranking Pipeline\n// ============================================================================\n\n/**\n * Configuration for the reranking pipeline\n */\nexport interface RerankPipelineConfig {\n  /** Primary reranker provider */\n  provider: RerankProvider;\n  /** Fallback provider if primary fails */\n  fallbackProvider?: RerankProvider;\n  /** Whether to use RRF with original scores */\n  useRRFWithOriginal?: boolean;\n  /** RRF k parameter */\n  rrfK?: number;\n  /** Cache rerank results */\n  enableCache?: boolean;\n  /** Cache TTL in seconds */\n  cacheTTL?: number;\n}\n\n/**\n * Create a reranking pipeline with fallback and caching\n *\n * @example\n * ```typescript\n * const pipeline = createRerankPipeline({\n *   provider: createCohereReranker({ apiKey: '...' }),\n *   fallbackProvider: createCrossEncoderReranker({ ... }),\n *   useRRFWithOriginal: true,\n *   enableCache: true,\n * });\n *\n * const results = await pipeline.rerank({\n *   query: 'machine learning',\n *   documents: docs,\n *   topK: 10,\n * });\n * ```\n */\nexport function createRerankPipeline(config: RerankPipelineConfig) {\n  const {\n    provider,\n    fallbackProvider,\n    useRRFWithOriginal = false,\n    rrfK = 60,\n    enableCache = false,\n    cacheTTL = 300,\n  } = config;\n\n  // Simple in-memory cache\n  const cache = new Map<string, { results: RerankResult[]; timestamp: number }>();\n\n  function getCacheKey(query: string, docIds: string[]): string {\n    return `${query}:${docIds.sort().join(',')}`;\n  }\n\n  return {\n    async rerank(options: RerankOptions): Promise<RerankResult[]> {\n      const { query, documents, topK } = options;\n\n      // Check cache\n      if (enableCache) {\n        const cacheKey = getCacheKey(\n          query,\n          documents.map(d => d.id),\n        );\n        const cached = cache.get(cacheKey);\n        if (cached && Date.now() - cached.timestamp < cacheTTL * 1000) {\n          return topK ? cached.results.slice(0, topK) : cached.results;\n        }\n      }\n\n      let rerankResults: RerankResult[];\n\n      try {\n        rerankResults = await provider.rerank(options);\n      } catch (error) {\n        if (fallbackProvider) {\n          logWarn('Primary reranker failed, using fallback', {\n            error: error instanceof Error ? error : new Error(String(error)),\n          });\n          rerankResults = await fallbackProvider.rerank(options);\n        } else {\n          throw error;\n        }\n      }\n\n      // Optionally combine with original scores using RRF\n      if (useRRFWithOriginal && documents.some(d => d.originalScore !== undefined)) {\n        const originalRanking: RerankResult[] = [...documents]\n          .sort((a, b) => (b.originalScore || 0) - (a.originalScore || 0))\n          .map((doc, index) => ({\n            document: doc,\n            relevanceScore: doc.originalScore || 0,\n            originalIndex: documents.indexOf(doc),\n            newIndex: index,\n          }));\n\n        rerankResults = reciprocalRankFusion([rerankResults, originalRanking], {\n          k: rrfK,\n          topK,\n        });\n      }\n\n      // Update cache\n      if (enableCache) {\n        const cacheKey = getCacheKey(\n          query,\n          documents.map(d => d.id),\n        );\n        cache.set(cacheKey, { results: rerankResults, timestamp: Date.now() });\n\n        // Clean old entries\n        const now = Date.now();\n        for (const [key, value] of cache.entries()) {\n          if (now - value.timestamp > cacheTTL * 1000) {\n            cache.delete(key);\n          }\n        }\n      }\n\n      return rerankResults;\n    },\n\n    async isAvailable(): Promise<boolean> {\n      const primaryAvailable = await provider.isAvailable();\n      if (primaryAvailable) return true;\n      if (fallbackProvider) {\n        return fallbackProvider.isAvailable();\n      }\n      return false;\n    },\n\n    clearCache(): void {\n      cache.clear();\n    },\n  };\n}\n\n// ============================================================================\n// Utility Functions\n// ============================================================================\n\n/**\n * Convert vector search results to RerankDocuments\n */\nexport function vectorResultsToDocuments(\n  results: Array<{\n    id: string;\n    content: string;\n    score: number;\n    metadata?: Record<string, unknown>;\n  }>,\n): RerankDocument[] {\n  return results.map(r => ({\n    id: r.id,\n    text: r.content,\n    metadata: r.metadata,\n    originalScore: r.score,\n  }));\n}\n\n/**\n * Calculate Normalized Discounted Cumulative Gain (NDCG)\n * for evaluating reranking quality\n */\nexport function calculateNDCG(\n  results: RerankResult[],\n  relevanceLabels: Map<string, number>,\n  k?: number,\n): number {\n  const resultsToScore = k ? results.slice(0, k) : results;\n\n  // Calculate DCG\n  let dcg = 0;\n  for (let i = 0; i < resultsToScore.length; i++) {\n    const result = resultsToScore[i];\n    if (!result) continue;\n    const relevance = relevanceLabels.get(result.document.id) || 0;\n    dcg += (Math.pow(2, relevance) - 1) / Math.log2(i + 2);\n  }\n\n  // Calculate ideal DCG\n  const idealOrder = Array.from(relevanceLabels.values()).sort((a, b) => b - a);\n  let idcg = 0;\n  const idealLength = k ? Math.min(k, idealOrder.length) : idealOrder.length;\n  for (let i = 0; i < idealLength; i++) {\n    const idealScore = idealOrder[i] ?? 0;\n    idcg += (Math.pow(2, idealScore) - 1) / Math.log2(i + 2);\n  }\n\n  return idcg > 0 ? dcg / idcg : 0;\n}\n\n/**\n * Calculate Mean Reciprocal Rank (MRR)\n */\nexport function calculateMRR(results: RerankResult[], relevantIds: Set<string>): number {\n  for (let i = 0; i < results.length; i++) {\n    const result = results[i];\n    if (result && relevantIds.has(result.document.id)) {\n      return 1 / (i + 1);\n    }\n  }\n  return 0;\n}\n"],"mappings":"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"}

package/dist/resumable-adapter-CO1HtsgJ.mjs

@@ -0,0 +1,21 @@
+import { createResumableStreamContext } from "resumable-stream";
+
+//#region src/integrations/stream/resumable-adapter.ts
+/**
+* @fileoverview resumable-stream adapter — the only file that imports resumable-stream.
+* @module @od-oneapp/ai-platform/integrations/stream
+*/
+/** Create a resumable stream context backed by the `resumable-stream` package. */
+function createResumableStream(options) {
+	const ctx = createResumableStreamContext({ waitUntil: options?.waitUntil ?? null });
+	return {
+		resumeExistingStream: async (streamId) => await ctx.resumeExistingStream(streamId) ?? null,
+		createNewResumableStream: async (streamId, streamFactory) => {
+			await ctx.createNewResumableStream(streamId, streamFactory);
+		}
+	};
+}
+
+//#endregion
+export { createResumableStream as t };
+//# sourceMappingURL=resumable-adapter-CO1HtsgJ.mjs.map

package/dist/resumable-adapter-CO1HtsgJ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resumable-adapter-CO1HtsgJ.mjs","names":["createContext"],"sources":["../src/integrations/stream/resumable-adapter.ts"],"sourcesContent":["/**\n * @fileoverview resumable-stream adapter — the only file that imports resumable-stream.\n * @module @od-oneapp/ai-platform/integrations/stream\n */\n\nimport { createResumableStreamContext as createContext } from 'resumable-stream';\n\nimport type { ResumableStreamContext, ResumableStreamOptions } from './types';\n\n/** Create a resumable stream context backed by the `resumable-stream` package. */\nexport function createResumableStream(options?: ResumableStreamOptions): ResumableStreamContext {\n  const ctx = createContext({ waitUntil: options?.waitUntil ?? null });\n  return {\n    resumeExistingStream: async (streamId: string) =>\n      (await ctx.resumeExistingStream(streamId)) ?? null,\n    createNewResumableStream: async (streamId: string, streamFactory: () => ReadableStream) => {\n      await ctx.createNewResumableStream(streamId, streamFactory);\n    },\n  };\n}\n"],"mappings":";;;;;;;;AAUA,SAAgB,sBAAsB,SAA0D;CAC9F,MAAM,MAAMA,6BAAc,EAAE,WAAW,SAAS,aAAa,MAAM,CAAC;AACpE,QAAO;EACL,sBAAsB,OAAO,aAC1B,MAAM,IAAI,qBAAqB,SAAS,IAAK;EAChD,0BAA0B,OAAO,UAAkB,kBAAwC;AACzF,SAAM,IAAI,yBAAyB,UAAU,cAAc;;EAE9D"}

package/dist/review-trigger-DmAsiQlM.d.mts

@@ -0,0 +1,24 @@
+import { s as ReviewCondition } from "./types-CQ0HFd0u.mjs";
+
+//#region src/hitl/review/review-trigger.d.ts
+interface ReviewContext {
+  confidence?: number;
+  content?: string;
+  action?: string;
+  metadata?: Record<string, unknown>;
+}
+declare function evaluateReviewTriggers(conditions: ReviewCondition[], context: ReviewContext): {
+  requiresReview: boolean;
+  triggeredConditions: string[];
+};
+declare const ReviewConditions: {
+  lowConfidence(threshold: number): ReviewCondition;
+  destructiveActions(): ReviewCondition;
+  publishingActions(): ReviewCondition;
+  sensitiveContent(): ReviewCondition;
+  piiContent(): ReviewCondition;
+  custom(evaluate: (context: unknown) => boolean): ReviewCondition;
+};
+//#endregion
+export { ReviewContext as n, evaluateReviewTriggers as r, ReviewConditions as t };
+//# sourceMappingURL=review-trigger-DmAsiQlM.d.mts.map

package/dist/review-trigger-DmAsiQlM.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-trigger-DmAsiQlM.d.mts","names":[],"sources":["../src/hitl/review/review-trigger.ts"],"mappings":";;;UASiB,aAAA;EAEf,UAAA;EAEA,OAAA;EAEA,MAAA;EAEA,QAAA,GAAW,MAAA;AAAA;AAAA,iBAyBG,sBAAA,CACd,UAAA,EAAY,eAAA,IACZ,OAAA,EAAS,aAAA;EACN,cAAA;EAAyB,mBAAA;AAAA;AAAA,cA8DjB,gBAAA;oCAIuB,eAAA;wBAOZ,eAAA;uBAUD,eAAA;sBAUD,eAAA;gBAUN,eAAA;oBAUI,OAAA,wBAA+B,eAAA;AAAA"}

package/dist/review-trigger-DwXfpww9.mjs

@@ -0,0 +1,112 @@
+//#region src/hitl/review/review-trigger.ts
+/**
+* Evaluate if human review is required
+*
+* @example
+* ```ts
+* const conditions: ReviewCondition[] = [
+*   { type: "confidence", threshold: 0.8 },
+*   { type: "action", actions: ["delete", "publish"] },
+*   { type: "content", pattern: /sensitive|confidential/i },
+* ];
+*
+* const context = {
+*   confidence: 0.7,
+*   action: "update",
+*   content: "This contains sensitive information",
+* };
+*
+* const result = evaluateReviewTriggers(conditions, context);
+* // result.requiresReview = true
+* // result.triggeredConditions = ["confidence", "content"]
+* ```
+*/
+function evaluateReviewTriggers(conditions, context) {
+	const triggeredConditions = [];
+	for (const condition of conditions) if (evaluateCondition(condition, context)) triggeredConditions.push(condition.type);
+	return {
+		requiresReview: triggeredConditions.length > 0,
+		triggeredConditions
+	};
+}
+/**
+* Evaluate a single review condition
+*/
+function evaluateCondition(condition, context) {
+	switch (condition.type) {
+		case "confidence": return evaluateConfidenceCondition(condition, context);
+		case "content": return evaluateContentCondition(condition, context);
+		case "action": return evaluateActionCondition(condition, context);
+		case "custom": return condition.evaluate?.(context) ?? false;
+		default: return false;
+	}
+}
+function evaluateConfidenceCondition(condition, context) {
+	if (context.confidence === void 0 || condition.threshold === void 0) return false;
+	return context.confidence < condition.threshold;
+}
+function evaluateContentCondition(condition, context) {
+	if (!context.content || !condition.pattern) return false;
+	return condition.pattern.test(context.content);
+}
+function evaluateActionCondition(condition, context) {
+	if (!context.action || !condition.actions) return false;
+	return condition.actions.includes(context.action);
+}
+/**
+* Create common review conditions
+*/
+const ReviewConditions = {
+	lowConfidence(threshold) {
+		return {
+			type: "confidence",
+			threshold
+		};
+	},
+	destructiveActions() {
+		return {
+			type: "action",
+			actions: [
+				"delete",
+				"remove",
+				"destroy",
+				"drop",
+				"truncate"
+			]
+		};
+	},
+	publishingActions() {
+		return {
+			type: "action",
+			actions: [
+				"publish",
+				"post",
+				"send",
+				"broadcast",
+				"announce"
+			]
+		};
+	},
+	sensitiveContent() {
+		return {
+			type: "content",
+			pattern: /\b(confidential|secret|private|sensitive|ssn|password|api[_-]?key)\b/i
+		};
+	},
+	piiContent() {
+		return {
+			type: "content",
+			pattern: /\b(\d{3}-\d{2}-\d{4}|\d{16}|\d{4}[- ]?\d{4}[- ]?\d{4}[- ]?\d{4})\b/
+		};
+	},
+	custom(evaluate) {
+		return {
+			type: "custom",
+			evaluate
+		};
+	}
+};
+
+//#endregion
+export { evaluateReviewTriggers as n, ReviewConditions as t };
+//# sourceMappingURL=review-trigger-DwXfpww9.mjs.map

package/dist/review-trigger-DwXfpww9.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-trigger-DwXfpww9.mjs","names":[],"sources":["../src/hitl/review/review-trigger.ts"],"sourcesContent":["/**\n * Review trigger evaluation\n */\n\nimport type { ReviewCondition } from '../types';\n\n/**\n * Context for evaluating review triggers\n */\nexport interface ReviewContext {\n  /** Confidence score (0-1) */\n  confidence?: number;\n  /** Content being generated */\n  content?: string;\n  /** Action being taken */\n  action?: string;\n  /** Additional context */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Evaluate if human review is required\n *\n * @example\n * ```ts\n * const conditions: ReviewCondition[] = [\n *   { type: \"confidence\", threshold: 0.8 },\n *   { type: \"action\", actions: [\"delete\", \"publish\"] },\n *   { type: \"content\", pattern: /sensitive|confidential/i },\n * ];\n *\n * const context = {\n *   confidence: 0.7,\n *   action: \"update\",\n *   content: \"This contains sensitive information\",\n * };\n *\n * const result = evaluateReviewTriggers(conditions, context);\n * // result.requiresReview = true\n * // result.triggeredConditions = [\"confidence\", \"content\"]\n * ```\n */\nexport function evaluateReviewTriggers(\n  conditions: ReviewCondition[],\n  context: ReviewContext,\n): { requiresReview: boolean; triggeredConditions: string[] } {\n  const triggeredConditions: string[] = [];\n\n  for (const condition of conditions) {\n    if (evaluateCondition(condition, context)) {\n      triggeredConditions.push(condition.type);\n    }\n  }\n\n  return {\n    requiresReview: triggeredConditions.length > 0,\n    triggeredConditions,\n  };\n}\n\n/**\n * Evaluate a single review condition\n */\nfunction evaluateCondition(condition: ReviewCondition, context: ReviewContext): boolean {\n  switch (condition.type) {\n    case 'confidence':\n      return evaluateConfidenceCondition(condition, context);\n\n    case 'content':\n      return evaluateContentCondition(condition, context);\n\n    case 'action':\n      return evaluateActionCondition(condition, context);\n\n    case 'custom':\n      return condition.evaluate?.(context) ?? false;\n\n    default:\n      return false;\n  }\n}\n\nfunction evaluateConfidenceCondition(condition: ReviewCondition, context: ReviewContext): boolean {\n  if (context.confidence === undefined || condition.threshold === undefined) {\n    return false;\n  }\n  // Trigger review if confidence is BELOW threshold\n  return context.confidence < condition.threshold;\n}\n\nfunction evaluateContentCondition(condition: ReviewCondition, context: ReviewContext): boolean {\n  if (!context.content || !condition.pattern) {\n    return false;\n  }\n  return condition.pattern.test(context.content);\n}\n\nfunction evaluateActionCondition(condition: ReviewCondition, context: ReviewContext): boolean {\n  if (!context.action || !condition.actions) {\n    return false;\n  }\n  return condition.actions.includes(context.action);\n}\n\n/**\n * Create common review conditions\n */\nexport const ReviewConditions = {\n  /**\n   * Require review when confidence is below threshold\n   */\n  lowConfidence(threshold: number): ReviewCondition {\n    return { type: 'confidence', threshold };\n  },\n\n  /**\n   * Require review for destructive actions\n   */\n  destructiveActions(): ReviewCondition {\n    return {\n      type: 'action',\n      actions: ['delete', 'remove', 'destroy', 'drop', 'truncate'],\n    };\n  },\n\n  /**\n   * Require review for publishing actions\n   */\n  publishingActions(): ReviewCondition {\n    return {\n      type: 'action',\n      actions: ['publish', 'post', 'send', 'broadcast', 'announce'],\n    };\n  },\n\n  /**\n   * Require review for sensitive content patterns\n   */\n  sensitiveContent(): ReviewCondition {\n    return {\n      type: 'content',\n      pattern: /\\b(confidential|secret|private|sensitive|ssn|password|api[_-]?key)\\b/i,\n    };\n  },\n\n  /**\n   * Require review for PII patterns\n   */\n  piiContent(): ReviewCondition {\n    return {\n      type: 'content',\n      pattern: /\\b(\\d{3}-\\d{2}-\\d{4}|\\d{16}|\\d{4}[- ]?\\d{4}[- ]?\\d{4}[- ]?\\d{4})\\b/,\n    };\n  },\n\n  /**\n   * Custom condition\n   */\n  custom(evaluate: (context: unknown) => boolean): ReviewCondition {\n    return { type: 'custom', evaluate };\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA0CA,SAAgB,uBACd,YACA,SAC4D;CAC5D,MAAM,sBAAgC,EAAE;AAExC,MAAK,MAAM,aAAa,WACtB,KAAI,kBAAkB,WAAW,QAAQ,CACvC,qBAAoB,KAAK,UAAU,KAAK;AAI5C,QAAO;EACL,gBAAgB,oBAAoB,SAAS;EAC7C;EACD;;;;;AAMH,SAAS,kBAAkB,WAA4B,SAAiC;AACtF,SAAQ,UAAU,MAAlB;EACE,KAAK,aACH,QAAO,4BAA4B,WAAW,QAAQ;EAExD,KAAK,UACH,QAAO,yBAAyB,WAAW,QAAQ;EAErD,KAAK,SACH,QAAO,wBAAwB,WAAW,QAAQ;EAEpD,KAAK,SACH,QAAO,UAAU,WAAW,QAAQ,IAAI;EAE1C,QACE,QAAO;;;AAIb,SAAS,4BAA4B,WAA4B,SAAiC;AAChG,KAAI,QAAQ,eAAe,UAAa,UAAU,cAAc,OAC9D,QAAO;AAGT,QAAO,QAAQ,aAAa,UAAU;;AAGxC,SAAS,yBAAyB,WAA4B,SAAiC;AAC7F,KAAI,CAAC,QAAQ,WAAW,CAAC,UAAU,QACjC,QAAO;AAET,QAAO,UAAU,QAAQ,KAAK,QAAQ,QAAQ;;AAGhD,SAAS,wBAAwB,WAA4B,SAAiC;AAC5F,KAAI,CAAC,QAAQ,UAAU,CAAC,UAAU,QAChC,QAAO;AAET,QAAO,UAAU,QAAQ,SAAS,QAAQ,OAAO;;;;;AAMnD,MAAa,mBAAmB;CAI9B,cAAc,WAAoC;AAChD,SAAO;GAAE,MAAM;GAAc;GAAW;;CAM1C,qBAAsC;AACpC,SAAO;GACL,MAAM;GACN,SAAS;IAAC;IAAU;IAAU;IAAW;IAAQ;IAAW;GAC7D;;CAMH,oBAAqC;AACnC,SAAO;GACL,MAAM;GACN,SAAS;IAAC;IAAW;IAAQ;IAAQ;IAAa;IAAW;GAC9D;;CAMH,mBAAoC;AAClC,SAAO;GACL,MAAM;GACN,SAAS;GACV;;CAMH,aAA8B;AAC5B,SAAO;GACL,MAAM;GACN,SAAS;GACV;;CAMH,OAAO,UAA0D;AAC/D,SAAO;GAAE,MAAM;GAAU;GAAU;;CAEtC"}

package/dist/safe-context-BynhkTKR.d.mts

@@ -0,0 +1,54 @@
+import { z } from "zod";
+
+//#region src/grounding/context/types.d.ts
+declare const IdentityContextSchema: z.ZodObject<{
+  userId: z.ZodString;
+  name: z.ZodOptional<z.ZodString>;
+  email: z.ZodOptional<z.ZodString>;
+  role: z.ZodDefault<z.ZodEnum<{
+    user: "user";
+    system: "system";
+    admin: "admin";
+  }>>;
+  permissions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  organizationId: z.ZodOptional<z.ZodString>;
+  sessionId: z.ZodOptional<z.ZodString>;
+  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+type IdentityContext = z.infer<typeof IdentityContextSchema>;
+declare const RequestContextSchema: z.ZodObject<{
+  userId: z.ZodString;
+  name: z.ZodOptional<z.ZodString>;
+  email: z.ZodOptional<z.ZodString>;
+  role: z.ZodDefault<z.ZodEnum<{
+    user: "user";
+    system: "system";
+    admin: "admin";
+  }>>;
+  permissions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  organizationId: z.ZodOptional<z.ZodString>;
+  sessionId: z.ZodOptional<z.ZodString>;
+  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  timestamp: z.ZodDefault<z.ZodDate>;
+  locale: z.ZodDefault<z.ZodString>;
+  timezone: z.ZodDefault<z.ZodString>;
+  ipCountry: z.ZodOptional<z.ZodString>;
+  userAgent: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type RequestContext = z.infer<typeof RequestContextSchema>;
+declare const MinimalContextSchema: z.ZodObject<{
+  operation: z.ZodString;
+  timestamp: z.ZodDefault<z.ZodDate>;
+}, z.core.$strip>;
+type MinimalContext = z.infer<typeof MinimalContextSchema>;
+//#endregion
+//#region src/grounding/context/safe-context.d.ts
+declare function getSafeIdentityContext(input: unknown): IdentityContext;
+declare function getSafeRequestContext(input: unknown): RequestContext;
+declare function createRequestContext(identity: IdentityContext, overrides?: Partial<RequestContext>): RequestContext;
+declare function hasPermission(context: IdentityContext, permission: string): boolean;
+declare function hasAnyPermission(context: IdentityContext, permissions: string[]): boolean;
+declare function hasAllPermissions(context: IdentityContext, permissions: string[]): boolean;
+//#endregion
+export { hasAnyPermission as a, IdentityContextSchema as c, RequestContext as d, RequestContextSchema as f, hasAllPermissions as i, MinimalContext as l, getSafeIdentityContext as n, hasPermission as o, getSafeRequestContext as r, IdentityContext as s, createRequestContext as t, MinimalContextSchema as u };
+//# sourceMappingURL=safe-context-BynhkTKR.d.mts.map

package/dist/safe-context-BynhkTKR.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-context-BynhkTKR.d.mts","names":[],"sources":["../src/grounding/context/types.ts","../src/grounding/context/safe-context.ts"],"mappings":";;;cAWa,qBAAA,EAAqB,CAAA,CAAA,SAAA;;;;;;;;;;;;;;KAmBtB,eAAA,GAAkB,CAAA,CAAE,KAAA,QAAa,qBAAA;AAAA,cAMhC,oBAAA,EAAoB,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;KAarB,cAAA,GAAiB,CAAA,CAAE,KAAA,QAAa,oBAAA;AAAA,cAK/B,oBAAA,EAAoB,CAAA,CAAA,SAAA;;;;KAOrB,cAAA,GAAiB,CAAA,CAAE,KAAA,QAAa,oBAAA;;;iBCvC5B,sBAAA,CAAuB,KAAA,YAAiB,eAAA;AAAA,iBAqBxC,qBAAA,CAAsB,KAAA,YAAiB,cAAA;AAAA,iBA0BvC,oBAAA,CACd,QAAA,EAAU,eAAA,EACV,SAAA,GAAY,OAAA,CAAQ,cAAA,IACnB,cAAA;AAAA,iBAiBa,aAAA,CAAc,OAAA,EAAS,eAAA,EAAiB,UAAA;AAAA,iBAWxC,gBAAA,CAAiB,OAAA,EAAS,eAAA,EAAiB,WAAA;AAAA,iBAY3C,iBAAA,CAAkB,OAAA,EAAS,eAAA,EAAiB,WAAA"}

package/dist/safe-context-C5A3Wv3b.mjs

@@ -0,0 +1,143 @@
+import { z } from "zod";
+
+//#region src/grounding/context/types.ts
+/**
+* @fileoverview Context types for AI operations.
+* @module @od-oneapp/ai-platform/context
+*/
+/**
+* User identity context for AI operations.
+* Provides user information for tool authorization and personalization.
+*/
+const IdentityContextSchema = z.object({
+	userId: z.string(),
+	name: z.string().optional(),
+	email: z.string().email().optional(),
+	role: z.enum([
+		"user",
+		"admin",
+		"system"
+	]).default("user"),
+	permissions: z.array(z.string()).default([]),
+	organizationId: z.string().optional(),
+	sessionId: z.string().optional(),
+	metadata: z.record(z.string(), z.unknown()).optional()
+});
+/**
+* Request context for AI operations.
+* Extends identity with request-specific information.
+*/
+const RequestContextSchema = IdentityContextSchema.extend({
+	timestamp: z.date().default(() => /* @__PURE__ */ new Date()),
+	locale: z.string().default("en-US"),
+	timezone: z.string().default("UTC"),
+	ipCountry: z.string().optional(),
+	userAgent: z.string().optional()
+});
+/**
+* Minimal context for anonymous or system operations.
+*/
+const MinimalContextSchema = z.object({
+	operation: z.string(),
+	timestamp: z.date().default(() => /* @__PURE__ */ new Date())
+});
+
+//#endregion
+//#region src/grounding/context/safe-context.ts
+/**
+* @fileoverview Safe context extraction and validation utilities.
+* @module @od-oneapp/ai-platform/context
+*/
+/**
+* Safely extracts identity context, returning a minimal safe context if validation fails.
+* Never throws - returns a safe default for anonymous/system operations.
+*
+* @param input - Raw context input (potentially untrusted)
+* @returns Validated IdentityContext or safe default
+*
+* @example
+* ```ts
+* const ctx = getSafeIdentityContext(request.headers);
+* // Always returns valid IdentityContext, never throws
+* ```
+*/
+function getSafeIdentityContext(input) {
+	const result = IdentityContextSchema.safeParse(input);
+	if (result.success) return result.data;
+	return {
+		userId: "anonymous",
+		role: "user",
+		permissions: []
+	};
+}
+/**
+* Safely extracts request context with timestamp and locale defaults.
+*
+* @param input - Raw context input
+* @returns Validated RequestContext or safe default
+*/
+function getSafeRequestContext(input) {
+	const result = RequestContextSchema.safeParse(input);
+	if (result.success) return result.data;
+	return {
+		userId: "anonymous",
+		role: "user",
+		permissions: [],
+		timestamp: /* @__PURE__ */ new Date(),
+		locale: "en-US",
+		timezone: "UTC"
+	};
+}
+/**
+* Creates a fresh request context from identity context.
+* Adds request-scoped fields like timestamp.
+*
+* @param identity - Base identity context
+* @param overrides - Optional field overrides
+* @returns Fresh RequestContext
+*/
+function createRequestContext(identity, overrides) {
+	return {
+		...identity,
+		timestamp: /* @__PURE__ */ new Date(),
+		locale: "en-US",
+		timezone: "UTC",
+		...overrides
+	};
+}
+/**
+* Checks if context has a specific permission.
+*
+* @param context - Identity context to check
+* @param permission - Permission string to look for
+* @returns True if permission exists
+*/
+function hasPermission(context, permission) {
+	return context.permissions.includes(permission) || context.role === "admin";
+}
+/**
+* Checks if context has any of the specified permissions.
+*
+* @param context - Identity context to check
+* @param permissions - Permission strings to check
+* @returns True if any permission exists
+*/
+function hasAnyPermission(context, permissions) {
+	if (context.role === "admin") return true;
+	return permissions.some((p) => context.permissions.includes(p));
+}
+/**
+* Checks if context has all specified permissions.
+*
+* @param context - Identity context to check
+* @param permissions - Permission strings to check
+* @returns True if all permissions exist
+*/
+function hasAllPermissions(context, permissions) {
+	if (context.role === "admin") return true;
+	return permissions.every((p) => context.permissions.includes(p));
+}
+
+//#endregion
+export { hasAnyPermission as a, MinimalContextSchema as c, hasAllPermissions as i, RequestContextSchema as l, getSafeIdentityContext as n, hasPermission as o, getSafeRequestContext as r, IdentityContextSchema as s, createRequestContext as t };
+//# sourceMappingURL=safe-context-C5A3Wv3b.mjs.map

package/dist/safe-context-C5A3Wv3b.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-context-C5A3Wv3b.mjs","names":[],"sources":["../src/grounding/context/types.ts","../src/grounding/context/safe-context.ts"],"sourcesContent":["/**\n * @fileoverview Context types for AI operations.\n * @module @od-oneapp/ai-platform/context\n */\n\nimport { z } from 'zod';\n\n/**\n * User identity context for AI operations.\n * Provides user information for tool authorization and personalization.\n */\nexport const IdentityContextSchema = z.object({\n  /** Unique user identifier */\n  userId: z.string(),\n  /** User's display name */\n  name: z.string().optional(),\n  /** User's email address */\n  email: z.string().email().optional(),\n  /** User's role in the system */\n  role: z.enum(['user', 'admin', 'system']).default('user'),\n  /** Permissions granted to the user */\n  permissions: z.array(z.string()).default([]),\n  /** Organization or tenant ID */\n  organizationId: z.string().optional(),\n  /** Session ID for tracking */\n  sessionId: z.string().optional(),\n  /** Additional metadata */\n  metadata: z.record(z.string(), z.unknown()).optional(),\n});\n\nexport type IdentityContext = z.infer<typeof IdentityContextSchema>;\n\n/**\n * Request context for AI operations.\n * Extends identity with request-specific information.\n */\nexport const RequestContextSchema = IdentityContextSchema.extend({\n  /** Request timestamp */\n  timestamp: z.date().default(() => new Date()),\n  /** Request locale */\n  locale: z.string().default('en-US'),\n  /** Request timezone */\n  timezone: z.string().default('UTC'),\n  /** Client IP address (anonymized) */\n  ipCountry: z.string().optional(),\n  /** User agent string */\n  userAgent: z.string().optional(),\n});\n\nexport type RequestContext = z.infer<typeof RequestContextSchema>;\n\n/**\n * Minimal context for anonymous or system operations.\n */\nexport const MinimalContextSchema = z.object({\n  /** Operation type */\n  operation: z.string(),\n  /** Timestamp */\n  timestamp: z.date().default(() => new Date()),\n});\n\nexport type MinimalContext = z.infer<typeof MinimalContextSchema>;\n","/**\n * @fileoverview Safe context extraction and validation utilities.\n * @module @od-oneapp/ai-platform/context\n */\n\nimport { IdentityContextSchema, RequestContextSchema } from './types';\n\nimport type { IdentityContext, RequestContext } from './types';\n\n/**\n * Safely extracts identity context, returning a minimal safe context if validation fails.\n * Never throws - returns a safe default for anonymous/system operations.\n *\n * @param input - Raw context input (potentially untrusted)\n * @returns Validated IdentityContext or safe default\n *\n * @example\n * ```ts\n * const ctx = getSafeIdentityContext(request.headers);\n * // Always returns valid IdentityContext, never throws\n * ```\n */\nexport function getSafeIdentityContext(input: unknown): IdentityContext {\n  const result = IdentityContextSchema.safeParse(input);\n\n  if (result.success) {\n    return result.data;\n  }\n\n  // Return anonymous context for failed validation\n  return {\n    userId: 'anonymous',\n    role: 'user',\n    permissions: [],\n  };\n}\n\n/**\n * Safely extracts request context with timestamp and locale defaults.\n *\n * @param input - Raw context input\n * @returns Validated RequestContext or safe default\n */\nexport function getSafeRequestContext(input: unknown): RequestContext {\n  const result = RequestContextSchema.safeParse(input);\n\n  if (result.success) {\n    return result.data;\n  }\n\n  // Return minimal request context\n  return {\n    userId: 'anonymous',\n    role: 'user',\n    permissions: [],\n    timestamp: new Date(),\n    locale: 'en-US',\n    timezone: 'UTC',\n  };\n}\n\n/**\n * Creates a fresh request context from identity context.\n * Adds request-scoped fields like timestamp.\n *\n * @param identity - Base identity context\n * @param overrides - Optional field overrides\n * @returns Fresh RequestContext\n */\nexport function createRequestContext(\n  identity: IdentityContext,\n  overrides?: Partial<RequestContext>,\n): RequestContext {\n  return {\n    ...identity,\n    timestamp: new Date(),\n    locale: 'en-US',\n    timezone: 'UTC',\n    ...overrides,\n  };\n}\n\n/**\n * Checks if context has a specific permission.\n *\n * @param context - Identity context to check\n * @param permission - Permission string to look for\n * @returns True if permission exists\n */\nexport function hasPermission(context: IdentityContext, permission: string): boolean {\n  return context.permissions.includes(permission) || context.role === 'admin';\n}\n\n/**\n * Checks if context has any of the specified permissions.\n *\n * @param context - Identity context to check\n * @param permissions - Permission strings to check\n * @returns True if any permission exists\n */\nexport function hasAnyPermission(context: IdentityContext, permissions: string[]): boolean {\n  if (context.role === 'admin') return true;\n  return permissions.some(p => context.permissions.includes(p));\n}\n\n/**\n * Checks if context has all specified permissions.\n *\n * @param context - Identity context to check\n * @param permissions - Permission strings to check\n * @returns True if all permissions exist\n */\nexport function hasAllPermissions(context: IdentityContext, permissions: string[]): boolean {\n  if (context.role === 'admin') return true;\n  return permissions.every(p => context.permissions.includes(p));\n}\n"],"mappings":";;;;;;;;;;;AAWA,MAAa,wBAAwB,EAAE,OAAO;CAE5C,QAAQ,EAAE,QAAQ;CAElB,MAAM,EAAE,QAAQ,CAAC,UAAU;CAE3B,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,UAAU;CAEpC,MAAM,EAAE,KAAK;EAAC;EAAQ;EAAS;EAAS,CAAC,CAAC,QAAQ,OAAO;CAEzD,aAAa,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;CAE5C,gBAAgB,EAAE,QAAQ,CAAC,UAAU;CAErC,WAAW,EAAE,QAAQ,CAAC,UAAU;CAEhC,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,SAAS,CAAC,CAAC,UAAU;CACvD,CAAC;;;;;AAQF,MAAa,uBAAuB,sBAAsB,OAAO;CAE/D,WAAW,EAAE,MAAM,CAAC,8BAAc,IAAI,MAAM,CAAC;CAE7C,QAAQ,EAAE,QAAQ,CAAC,QAAQ,QAAQ;CAEnC,UAAU,EAAE,QAAQ,CAAC,QAAQ,MAAM;CAEnC,WAAW,EAAE,QAAQ,CAAC,UAAU;CAEhC,WAAW,EAAE,QAAQ,CAAC,UAAU;CACjC,CAAC;;;;AAOF,MAAa,uBAAuB,EAAE,OAAO;CAE3C,WAAW,EAAE,QAAQ;CAErB,WAAW,EAAE,MAAM,CAAC,8BAAc,IAAI,MAAM,CAAC;CAC9C,CAAC;;;;;;;;;;;;;;;;;;;;;ACrCF,SAAgB,uBAAuB,OAAiC;CACtE,MAAM,SAAS,sBAAsB,UAAU,MAAM;AAErD,KAAI,OAAO,QACT,QAAO,OAAO;AAIhB,QAAO;EACL,QAAQ;EACR,MAAM;EACN,aAAa,EAAE;EAChB;;;;;;;;AASH,SAAgB,sBAAsB,OAAgC;CACpE,MAAM,SAAS,qBAAqB,UAAU,MAAM;AAEpD,KAAI,OAAO,QACT,QAAO,OAAO;AAIhB,QAAO;EACL,QAAQ;EACR,MAAM;EACN,aAAa,EAAE;EACf,2BAAW,IAAI,MAAM;EACrB,QAAQ;EACR,UAAU;EACX;;;;;;;;;;AAWH,SAAgB,qBACd,UACA,WACgB;AAChB,QAAO;EACL,GAAG;EACH,2BAAW,IAAI,MAAM;EACrB,QAAQ;EACR,UAAU;EACV,GAAG;EACJ;;;;;;;;;AAUH,SAAgB,cAAc,SAA0B,YAA6B;AACnF,QAAO,QAAQ,YAAY,SAAS,WAAW,IAAI,QAAQ,SAAS;;;;;;;;;AAUtE,SAAgB,iBAAiB,SAA0B,aAAgC;AACzF,KAAI,QAAQ,SAAS,QAAS,QAAO;AACrC,QAAO,YAAY,MAAK,MAAK,QAAQ,YAAY,SAAS,EAAE,CAAC;;;;;;;;;AAU/D,SAAgB,kBAAkB,SAA0B,aAAgC;AAC1F,KAAI,QAAQ,SAAS,QAAS,QAAO;AACrC,QAAO,YAAY,OAAM,MAAK,QAAQ,YAAY,SAAS,EAAE,CAAC"}

package/dist/schema-Bu2noOZ4.mjs

@@ -0,0 +1,27 @@
+import { z } from "zod";
+
+//#region src/agents/workflows/schema.ts
+/**
+* @fileoverview Workflow Schemas
+*
+* Zod schemas for workflow state management.
+*
+* @module @od-oneapp/ai-platform/workflows/schema
+*/
+const workflowStateSchema = z.object({
+	id: z.string(),
+	status: z.enum([
+		"pending",
+		"running",
+		"completed",
+		"failed"
+	]),
+	currentStepId: z.string().optional(),
+	data: z.record(z.string(), z.unknown()),
+	error: z.string().optional(),
+	updatedAt: z.string().datetime()
+});
+
+//#endregion
+export { workflowStateSchema as t };
+//# sourceMappingURL=schema-Bu2noOZ4.mjs.map

package/dist/schema-Bu2noOZ4.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-Bu2noOZ4.mjs","names":[],"sources":["../src/agents/workflows/schema.ts"],"sourcesContent":["/**\n * @fileoverview Workflow Schemas\n *\n * Zod schemas for workflow state management.\n *\n * @module @od-oneapp/ai-platform/workflows/schema\n */\n\nimport { z } from 'zod';\n\nexport const workflowStateSchema = z.object({\n  id: z.string(),\n  status: z.enum(['pending', 'running', 'completed', 'failed']),\n  currentStepId: z.string().optional(),\n  data: z.record(z.string(), z.unknown()),\n  error: z.string().optional(),\n  updatedAt: z.string().datetime(),\n});\n\nexport type WorkflowState = z.infer<typeof workflowStateSchema>;\n"],"mappings":";;;;;;;;;;AAUA,MAAa,sBAAsB,EAAE,OAAO;CAC1C,IAAI,EAAE,QAAQ;CACd,QAAQ,EAAE,KAAK;EAAC;EAAW;EAAW;EAAa;EAAS,CAAC;CAC7D,eAAe,EAAE,QAAQ,CAAC,UAAU;CACpC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,SAAS,CAAC;CACvC,OAAO,EAAE,QAAQ,CAAC,UAAU;CAC5B,WAAW,EAAE,QAAQ,CAAC,UAAU;CACjC,CAAC"}

package/dist/schema-CwFvuCnA.mjs

@@ -0,0 +1,97 @@
+import { z } from "zod";
+
+//#region src/agents/evaluator-optimizer/schema.ts
+/**
+* Evaluator-Optimizer Schema Definitions
+* Based on VERCEL_AI_SDK_V6_PATTERNS.md section 4.2
+* Comprehensive type definitions for iterative quality refinement
+*/
+/** Minimum iteration number. */
+const MIN_ITERATION_NUMBER = 1;
+/** Maximum iteration number for safety. */
+const MAX_ITERATION_NUMBER = 100;
+/** Minimum quality threshold. */
+const MIN_QUALITY_THRESHOLD = 1;
+/** Maximum quality threshold. */
+const MAX_QUALITY_THRESHOLD = 10;
+/** Maximum allowed issues before failing threshold. */
+const MAX_ALLOWED_ISSUES = 100;
+/**
+* Evaluation result schema with 9-dimensional assessment
+* Used by evaluator tool to assess content quality across multiple criteria
+*/
+const EvaluationResultSchema = z.object({
+	qualityScore: z.number().min(1).max(10),
+	preservesTone: z.boolean(),
+	preservesNuance: z.boolean(),
+	culturallyAccurate: z.boolean(),
+	technicallyCorrect: z.boolean(),
+	specificIssues: z.array(z.string()),
+	improvementSuggestions: z.array(z.string()),
+	strengths: z.array(z.string()),
+	overallAssessment: z.string(),
+	meetsThreshold: z.boolean()
+});
+/**
+* Optimizer tool input schema
+* Defines what information optimizer receives to improve content
+*/
+const OptimizerInputSchema = z.object({
+	content: z.string(),
+	evaluationFeedback: EvaluationResultSchema,
+	originalRequest: z.string(),
+	iterationNumber: z.number().min(MIN_ITERATION_NUMBER).max(MAX_ITERATION_NUMBER).optional(),
+	previousVersions: z.array(z.string()).optional()
+});
+/**
+* Evaluator tool input schema
+* Defines what information evaluator receives
+*/
+const EvaluatorInputSchema = z.object({
+	content: z.string(),
+	originalRequest: z.string(),
+	criteria: z.object({
+		threshold: z.number().min(MIN_QUALITY_THRESHOLD).max(MAX_QUALITY_THRESHOLD).default(8),
+		focusAreas: z.array(z.string()).optional(),
+		maxAllowedIssues: z.number().min(0).max(MAX_ALLOWED_ISSUES).optional()
+	}).optional(),
+	iterationNumber: z.number().min(MIN_ITERATION_NUMBER).max(MAX_ITERATION_NUMBER).optional()
+});
+/**
+* Feedback loop configuration
+*/
+const FeedbackLoopConfigSchema = z.object({
+	maxIterations: z.number().min(1).max(10).default(5),
+	targetScore: z.number().min(1).max(10).default(8),
+	enableLogging: z.boolean().default(false),
+	stopOnThreshold: z.boolean().default(true),
+	diminishingReturnThreshold: z.number().min(1).default(2)
+});
+/**
+* Complete optimization result returned by feedback loop
+*/
+const OptimizedResultSchema = z.object({
+	finalContent: z.string(),
+	finalEvaluation: EvaluationResultSchema,
+	cyclesCompleted: z.number(),
+	meetsThreshold: z.boolean(),
+	scoreHistory: z.array(z.number()),
+	contentHistory: z.array(z.string()),
+	terminationReason: z.enum([
+		"threshold_met",
+		"max_iterations",
+		"diminishing_returns",
+		"error"
+	]),
+	error: z.string().optional(),
+	metadata: z.object({
+		startTime: z.string(),
+		endTime: z.string(),
+		processingTimeMs: z.number(),
+		averageScoreImprovement: z.number()
+	}).optional()
+});
+
+//#endregion
+export { FeedbackLoopConfigSchema as n, EvaluationResultSchema as t };
+//# sourceMappingURL=schema-CwFvuCnA.mjs.map

package/dist/schema-CwFvuCnA.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-CwFvuCnA.mjs","names":[],"sources":["../src/agents/evaluator-optimizer/schema.ts"],"sourcesContent":["/**\n * Evaluator-Optimizer Schema Definitions\n * Based on VERCEL_AI_SDK_V6_PATTERNS.md section 4.2\n * Comprehensive type definitions for iterative quality refinement\n */\n\nimport { z } from 'zod';\n\n/** Minimum iteration number. */\nconst MIN_ITERATION_NUMBER = 1;\n\n/** Maximum iteration number for safety. */\nconst MAX_ITERATION_NUMBER = 100;\n\n/** Minimum quality threshold. */\nconst MIN_QUALITY_THRESHOLD = 1;\n\n/** Maximum quality threshold. */\nconst MAX_QUALITY_THRESHOLD = 10;\n\n/** Maximum allowed issues before failing threshold. */\nconst MAX_ALLOWED_ISSUES = 100;\n\n/**\n * Evaluation result schema with 9-dimensional assessment\n * Used by evaluator tool to assess content quality across multiple criteria\n */\nexport const EvaluationResultSchema = z.object({\n  /**\n   * Overall quality score (1-10)\n   * 1-3: Poor, significant issues\n   * 4-6: Fair, notable problems\n   * 7-8: Good, minor improvements needed\n   * 9-10: Excellent, meets or exceeds threshold\n   */\n  qualityScore: z.number().min(1).max(10),\n\n  /**\n   * Checks if original tone is preserved in the content\n   * True: Tone maintained appropriately\n   * False: Tone has been altered inappropriately\n   */\n  preservesTone: z.boolean(),\n\n  /**\n   * Checks if nuance and subtlety are preserved\n   * True: Nuanced meaning preserved\n   * False: Oversimplified or missing context\n   */\n  preservesNuance: z.boolean(),\n\n  /**\n   * Cultural sensitivity and accuracy assessment\n   * True: Culturally appropriate and accurate\n   * False: Contains cultural inaccuracies or insensitivity\n   */\n  culturallyAccurate: z.boolean(),\n\n  /**\n   * Technical accuracy and correctness\n   * True: All technical content is accurate\n   * False: Contains technical errors or inaccuracies\n   */\n  technicallyCorrect: z.boolean(),\n\n  /**\n   * Array of specific issues found during evaluation\n   * Each string describes a concrete problem\n   * Examples: \"Missing context\", \"Grammatical error\", \"Unclear reference\"\n   */\n  specificIssues: z.array(z.string()),\n\n  /**\n   * Actionable suggestions for improvement\n   * Each string provides specific guidance on how to improve\n   * Examples: \"Expand paragraph 2\", \"Add examples\", \"Clarify terminology\"\n   */\n  improvementSuggestions: z.array(z.string()),\n\n  /**\n   * Identified strengths to preserve during optimization\n   * These aspects should be maintained and not changed during optimization\n   * Examples: \"Strong opening\", \"Clear methodology\", \"Engaging examples\"\n   */\n  strengths: z.array(z.string()),\n\n  /**\n   * Summary assessment of the overall content quality\n   * Brief narrative summary combining all evaluation dimensions\n   */\n  overallAssessment: z.string(),\n\n  /**\n   * Boolean indicating if content meets quality threshold\n   * Automatically determined: meetsThreshold = qualityScore >= targetThreshold\n   * True: Content meets or exceeds threshold, ready to deliver\n   * False: Content needs optimization cycle\n   */\n  meetsThreshold: z.boolean(),\n});\n\n/**\n * Type extracted from EvaluationResultSchema\n */\nexport type EvaluationResult = z.infer<typeof EvaluationResultSchema>;\n\n/**\n * Optimizer tool input schema\n * Defines what information optimizer receives to improve content\n */\nexport const OptimizerInputSchema = z.object({\n  /**\n   * The current content that needs optimization\n   */\n  content: z.string(),\n\n  /**\n   * Evaluation feedback from the evaluator tool\n   * Contains scores, issues, and suggestions\n   */\n  evaluationFeedback: EvaluationResultSchema,\n\n  /**\n   * The original user request that spawned this content generation\n   * Used to ensure optimizations stay aligned with original intent\n   */\n  originalRequest: z.string(),\n\n  /**\n   * Optional iteration context (1-100).\n   */\n  iterationNumber: z.number().min(MIN_ITERATION_NUMBER).max(MAX_ITERATION_NUMBER).optional(),\n\n  /**\n   * Optional previous versions for comparison.\n   */\n  previousVersions: z.array(z.string()).optional(),\n});\n\nexport type OptimizerInput = z.infer<typeof OptimizerInputSchema>;\n\n/**\n * Evaluator tool input schema\n * Defines what information evaluator receives\n */\nexport const EvaluatorInputSchema = z.object({\n  /**\n   * Content to evaluate\n   */\n  content: z.string(),\n\n  /**\n   * Original request that generated this content\n   * Provides context for evaluation\n   */\n  originalRequest: z.string(),\n\n  /**\n   * Optional evaluation criteria and thresholds.\n   */\n  criteria: z\n    .object({\n      /**\n       * Target quality threshold (default: 8).\n       * Content must reach this score to pass.\n       */\n      threshold: z.number().min(MIN_QUALITY_THRESHOLD).max(MAX_QUALITY_THRESHOLD).default(8),\n\n      /**\n       * Specific evaluation focus areas.\n       * If provided, evaluator emphasizes these dimensions.\n       */\n      focusAreas: z.array(z.string()).optional(),\n\n      /**\n       * Maximum allowed issues before failing threshold.\n       * If provided, helps determine meetsThreshold.\n       */\n      maxAllowedIssues: z.number().min(0).max(MAX_ALLOWED_ISSUES).optional(),\n    })\n    .optional(),\n\n  /**\n   * Optional iteration context (1-100).\n   */\n  iterationNumber: z.number().min(MIN_ITERATION_NUMBER).max(MAX_ITERATION_NUMBER).optional(),\n});\n\nexport type EvaluatorInput = z.infer<typeof EvaluatorInputSchema>;\n\n/**\n * Feedback loop configuration\n */\nexport const FeedbackLoopConfigSchema = z.object({\n  /**\n   * Maximum number of evaluation-optimization cycles (default: 5)\n   */\n  maxIterations: z.number().min(1).max(10).default(5),\n\n  /**\n   * Target quality score threshold (default: 8, range 1-10)\n   * Content must reach this score to exit the loop\n   */\n  targetScore: z.number().min(1).max(10).default(8),\n\n  /**\n   * Enable detailed logging of each cycle (default: false)\n   */\n  enableLogging: z.boolean().default(false),\n\n  /**\n   * Stop on first threshold achievement (default: true)\n   * If false, continues to attempt reaching even higher scores\n   */\n  stopOnThreshold: z.boolean().default(true),\n\n  /**\n   * Detect diminishing returns after N cycles without improvement\n   */\n  diminishingReturnThreshold: z.number().min(1).default(2),\n});\n\nexport type FeedbackLoopConfig = z.infer<typeof FeedbackLoopConfigSchema>;\n\n/**\n * Complete optimization result returned by feedback loop\n */\nexport const OptimizedResultSchema = z.object({\n  /**\n   * Final optimized content\n   */\n  finalContent: z.string(),\n\n  /**\n   * Final evaluation result\n   */\n  finalEvaluation: EvaluationResultSchema,\n\n  /**\n   * Total number of cycles completed\n   */\n  cyclesCompleted: z.number(),\n\n  /**\n   * Whether content met threshold\n   */\n  meetsThreshold: z.boolean(),\n\n  /**\n   * History of evaluation scores across cycles\n   * Index 0 = initial evaluation, last index = final evaluation\n   */\n  scoreHistory: z.array(z.number()),\n\n  /**\n   * History of content versions\n   * Index 0 = initial content, last index = final content\n   */\n  contentHistory: z.array(z.string()),\n\n  /**\n   * Reason for loop termination\n   * - \"threshold_met\": reached target score\n   * - \"max_iterations\": reached max cycles without meeting threshold\n   * - \"diminishing_returns\": detected diminishing returns\n   * - \"error\": error occurred during processing\n   */\n  terminationReason: z.enum(['threshold_met', 'max_iterations', 'diminishing_returns', 'error']),\n\n  /**\n   * Optional error message if termination reason is \"error\"\n   */\n  error: z.string().optional(),\n\n  /**\n   * Metadata about the optimization process\n   */\n  metadata: z\n    .object({\n      startTime: z.string(),\n      endTime: z.string(),\n      processingTimeMs: z.number(),\n      averageScoreImprovement: z.number(),\n    })\n    .optional(),\n});\n\nexport type OptimizedResult = z.infer<typeof OptimizedResultSchema>;\n\n/**\n * Evaluator interface for dependency injection\n */\nexport interface Evaluator {\n  evaluate(input: EvaluatorInput): Promise<EvaluationResult>;\n}\n\n/**\n * Optimizer interface for dependency injection\n */\nexport interface Optimizer {\n  optimize(input: OptimizerInput): Promise<string>;\n}\n"],"mappings":";;;;;;;;;AASA,MAAM,uBAAuB;;AAG7B,MAAM,uBAAuB;;AAG7B,MAAM,wBAAwB;;AAG9B,MAAM,wBAAwB;;AAG9B,MAAM,qBAAqB;;;;;AAM3B,MAAa,yBAAyB,EAAE,OAAO;CAQ7C,cAAc,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,GAAG;CAOvC,eAAe,EAAE,SAAS;CAO1B,iBAAiB,EAAE,SAAS;CAO5B,oBAAoB,EAAE,SAAS;CAO/B,oBAAoB,EAAE,SAAS;CAO/B,gBAAgB,EAAE,MAAM,EAAE,QAAQ,CAAC;CAOnC,wBAAwB,EAAE,MAAM,EAAE,QAAQ,CAAC;CAO3C,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC;CAM9B,mBAAmB,EAAE,QAAQ;CAQ7B,gBAAgB,EAAE,SAAS;CAC5B,CAAC;;;;;AAWF,MAAa,uBAAuB,EAAE,OAAO;CAI3C,SAAS,EAAE,QAAQ;CAMnB,oBAAoB;CAMpB,iBAAiB,EAAE,QAAQ;CAK3B,iBAAiB,EAAE,QAAQ,CAAC,IAAI,qBAAqB,CAAC,IAAI,qBAAqB,CAAC,UAAU;CAK1F,kBAAkB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;CACjD,CAAC;;;;;AAQF,MAAa,uBAAuB,EAAE,OAAO;CAI3C,SAAS,EAAE,QAAQ;CAMnB,iBAAiB,EAAE,QAAQ;CAK3B,UAAU,EACP,OAAO;EAKN,WAAW,EAAE,QAAQ,CAAC,IAAI,sBAAsB,CAAC,IAAI,sBAAsB,CAAC,QAAQ,EAAE;EAMtF,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;EAM1C,kBAAkB,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,mBAAmB,CAAC,UAAU;EACvE,CAAC,CACD,UAAU;CAKb,iBAAiB,EAAE,QAAQ,CAAC,IAAI,qBAAqB,CAAC,IAAI,qBAAqB,CAAC,UAAU;CAC3F,CAAC;;;;AAOF,MAAa,2BAA2B,EAAE,OAAO;CAI/C,eAAe,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE;CAMnD,aAAa,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE;CAKjD,eAAe,EAAE,SAAS,CAAC,QAAQ,MAAM;CAMzC,iBAAiB,EAAE,SAAS,CAAC,QAAQ,KAAK;CAK1C,4BAA4B,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;CACzD,CAAC;;;;AAOF,MAAa,wBAAwB,EAAE,OAAO;CAI5C,cAAc,EAAE,QAAQ;CAKxB,iBAAiB;CAKjB,iBAAiB,EAAE,QAAQ;CAK3B,gBAAgB,EAAE,SAAS;CAM3B,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC;CAMjC,gBAAgB,EAAE,MAAM,EAAE,QAAQ,CAAC;CASnC,mBAAmB,EAAE,KAAK;EAAC;EAAiB;EAAkB;EAAuB;EAAQ,CAAC;CAK9F,OAAO,EAAE,QAAQ,CAAC,UAAU;CAK5B,UAAU,EACP,OAAO;EACN,WAAW,EAAE,QAAQ;EACrB,SAAS,EAAE,QAAQ;EACnB,kBAAkB,EAAE,QAAQ;EAC5B,yBAAyB,EAAE,QAAQ;EACpC,CAAC,CACD,UAAU;CACd,CAAC"}

package/dist/schema-Wz-1-ro9.d.mts

@@ -0,0 +1,37 @@
+import { z } from "zod";
+
+//#region src/agents/workflows/interfaces.d.ts
+interface WorkflowStep<TInput = unknown, TOutput = unknown> {
+  id: string;
+  name: string;
+  execute(input: TInput): Promise<TOutput>;
+}
+interface Workflow<TState> {
+  id: string;
+  state: TState;
+  steps: WorkflowStep<unknown, unknown>[];
+  run(): Promise<TState>;
+}
+interface StateSerializer<T> {
+  serialize(state: T): string;
+  deserialize(json: string): T;
+}
+//#endregion
+//#region src/agents/workflows/schema.d.ts
+declare const workflowStateSchema: z.ZodObject<{
+  id: z.ZodString;
+  status: z.ZodEnum<{
+    running: "running";
+    completed: "completed";
+    failed: "failed";
+    pending: "pending";
+  }>;
+  currentStepId: z.ZodOptional<z.ZodString>;
+  data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  error: z.ZodOptional<z.ZodString>;
+  updatedAt: z.ZodString;
+}, z.core.$strip>;
+type WorkflowState = z.infer<typeof workflowStateSchema>;
+//#endregion
+export { WorkflowStep as a, Workflow as i, workflowStateSchema as n, StateSerializer as r, WorkflowState as t };
+//# sourceMappingURL=schema-Wz-1-ro9.d.mts.map