@od-oneapp/ai-platform 0.1.0

package/dist/grounding-attribution.mjs

@@ -0,0 +1,259 @@
+//#region src/grounding/attribution/index.ts
+/**
+* Creates an attribution tracker for source attribution analysis.
+*
+* @example
+* ```typescript
+* const tracker = createAttributionTracker({
+*   minSimilarityThreshold: 0.6,
+*   extractClaims: true
+* });
+*
+* tracker.addSource({
+*   id: 'wiki-climate',
+*   content: 'Global warming is the long-term rise in temperature...',
+*   metadata: { url: 'https://example.com/climate' }
+* });
+*
+* const report = await tracker.generateReport(
+*   'Global warming causes temperature rise worldwide.'
+* );
+* console.log(`Coverage: ${report.attributionCoverage * 100}%`);
+* ```
+*/
+function createAttributionTracker(config = {}) {
+	const { minSimilarityThreshold = .5, maxClaimsPerSource = 50, extractClaims: shouldExtractClaims = true, computeContribution = true } = config;
+	const sources = /* @__PURE__ */ new Map();
+	function addSource(source) {
+		sources.set(source.id, source);
+	}
+	function removeSource(sourceId) {
+		sources.delete(sourceId);
+	}
+	function getSources() {
+		return Array.from(sources.values());
+	}
+	/**
+	* Extract claims from text using simple sentence-based extraction.
+	*/
+	function extractClaims(text) {
+		if (!shouldExtractClaims) return [];
+		const claims = [];
+		const sentences = text.match(/[^.!?]+[.!?]+/g) ?? [text];
+		let offset = 0;
+		for (const sentence of sentences) {
+			const trimmed = sentence.trim();
+			if (trimmed.length < 10) {
+				offset += sentence.length;
+				continue;
+			}
+			const startOffset = text.indexOf(trimmed, offset);
+			const claim = {
+				id: generateClaimId(),
+				text: trimmed,
+				startOffset,
+				endOffset: startOffset + trimmed.length,
+				type: classifyClaimType(trimmed)
+			};
+			claims.push(claim);
+			offset = startOffset + trimmed.length;
+		}
+		return claims;
+	}
+	/**
+	* Generate attribution report analyzing how text relates to sources.
+	*/
+	async function generateReport(text, sourceIds) {
+		const sourcesToCheck = sourceIds ? sourceIds.map((id) => sources.get(id)).filter((s) => s !== void 0) : Array.from(sources.values());
+		const claims = extractClaims(text);
+		const attributions = [];
+		const attributedClaimIds = /* @__PURE__ */ new Set();
+		for (const source of sourcesToCheck) {
+			const matchedClaims = [];
+			const matchedSegments = [];
+			for (const claim of claims) {
+				if (matchedClaims.length >= maxClaimsPerSource) break;
+				const similarity = computeSimilarity(claim.text, source.content);
+				if (similarity >= minSimilarityThreshold) {
+					matchedClaims.push(claim.id);
+					attributedClaimIds.add(claim.id);
+					const sourceMatch = findBestMatch(claim.text, source.content);
+					if (sourceMatch) matchedSegments.push({
+						sourceSpan: sourceMatch.span,
+						claimSpan: {
+							start: claim.startOffset,
+							end: claim.endOffset
+						},
+						similarity
+					});
+				}
+			}
+			if (matchedClaims.length > 0) {
+				const contributionScore = computeContribution ? matchedClaims.length / claims.length : matchedClaims.length / Math.max(claims.length, 1);
+				attributions.push({
+					sourceId: source.id,
+					contributionScore,
+					claimIds: matchedClaims,
+					matchedSegments
+				});
+			}
+		}
+		const unattributedClaims = claims.filter((c) => !attributedClaimIds.has(c.id)).map((c) => c.id);
+		const attributionCoverage = claims.length > 0 ? attributedClaimIds.size / claims.length : 0;
+		return {
+			totalSources: sourcesToCheck.length,
+			totalClaims: claims.length,
+			attributions,
+			unattributedClaims,
+			attributionCoverage,
+			generatedAt: /* @__PURE__ */ new Date()
+		};
+	}
+	function getConfig() {
+		return {
+			minSimilarityThreshold,
+			maxClaimsPerSource,
+			extractClaims: shouldExtractClaims,
+			computeContribution
+		};
+	}
+	return {
+		addSource,
+		removeSource,
+		getSources,
+		extractClaims,
+		generateReport,
+		getConfig
+	};
+}
+/**
+* Generate an attribution report for text against sources.
+* @deprecated Use createAttributionTracker() instead
+*/
+function generateAttributionReport(text, sources) {
+	const tracker = createAttributionTracker();
+	for (const source of sources) tracker.addSource(source);
+	const claims = tracker.extractClaims(text);
+	const attributions = [];
+	const attributedClaimIds = /* @__PURE__ */ new Set();
+	for (const source of sources) {
+		const matchedClaims = [];
+		const matchedSegments = [];
+		for (const claim of claims) {
+			const similarity = computeSimilarity(claim.text, source.content);
+			if (similarity >= .5) {
+				matchedClaims.push(claim.id);
+				attributedClaimIds.add(claim.id);
+				matchedSegments.push({
+					sourceSpan: {
+						start: 0,
+						end: Math.min(100, source.content.length)
+					},
+					claimSpan: {
+						start: claim.startOffset,
+						end: claim.endOffset
+					},
+					similarity
+				});
+			}
+		}
+		if (matchedClaims.length > 0) attributions.push({
+			sourceId: source.id,
+			contributionScore: matchedClaims.length / Math.max(claims.length, 1),
+			claimIds: matchedClaims,
+			matchedSegments
+		});
+	}
+	return {
+		totalSources: sources.length,
+		totalClaims: claims.length,
+		attributions,
+		unattributedClaims: claims.filter((c) => !attributedClaimIds.has(c.id)).map((c) => c.id),
+		attributionCoverage: claims.length > 0 ? attributedClaimIds.size / claims.length : 0,
+		generatedAt: /* @__PURE__ */ new Date()
+	};
+}
+function generateClaimId() {
+	return `claim-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;
+}
+/**
+* Classify a claim as factual, opinion, inference, or unknown.
+*/
+function classifyClaimType(text) {
+	const lower = text.toLowerCase();
+	if ([
+		"believe",
+		"think",
+		"feel",
+		"opinion",
+		"suggest",
+		"might",
+		"could",
+		"may"
+	].some((w) => lower.includes(w))) return "opinion";
+	if ([
+		"therefore",
+		"thus",
+		"hence",
+		"implies",
+		"suggests that",
+		"indicates"
+	].some((w) => lower.includes(w))) return "inference";
+	const hasNumbers = /\d+/.test(text);
+	const hasProperNouns = text.split(/\s+/).filter(Boolean).some((token) => {
+		const first = token[0];
+		if (!first) return false;
+		const rest = token.slice(1);
+		return first === first.toUpperCase() && rest === rest.toLowerCase();
+	});
+	if (hasNumbers || hasProperNouns) return "factual";
+	return "unknown";
+}
+/**
+* Compute text similarity using word overlap (Jaccard-like).
+*/
+function computeSimilarity(text1, text2) {
+	const words1 = new Set(tokenize(text1));
+	const words2 = new Set(tokenize(text2));
+	if (words1.size === 0 || words2.size === 0) return 0;
+	let intersection = 0;
+	for (const word of words1) if (words2.has(word)) intersection++;
+	const union = words1.size + words2.size - intersection;
+	return union > 0 ? intersection / union : 0;
+}
+/**
+* Tokenize text into lowercase words.
+*/
+function tokenize(text) {
+	return text.toLowerCase().replace(/[^\w\s]/g, " ").split(/\s+/).filter((w) => w.length > 2);
+}
+/**
+* Find the best matching segment in source for a claim.
+*/
+function findBestMatch(claim, source) {
+	if (tokenize(claim).length === 0) return null;
+	const windowSize = Math.min(claim.length * 2, 200);
+	let bestSimilarity = 0;
+	let bestSpan = {
+		start: 0,
+		end: windowSize
+	};
+	for (let i = 0; i < source.length - 50; i += 20) {
+		const similarity = computeSimilarity(claim, source.slice(i, i + windowSize));
+		if (similarity > bestSimilarity) {
+			bestSimilarity = similarity;
+			bestSpan = {
+				start: i,
+				end: Math.min(i + windowSize, source.length)
+			};
+		}
+	}
+	return bestSimilarity > 0 ? {
+		span: bestSpan,
+		similarity: bestSimilarity
+	} : null;
+}
+
+//#endregion
+export { createAttributionTracker, generateAttributionReport };
+//# sourceMappingURL=grounding-attribution.mjs.map

package/dist/grounding-attribution.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"grounding-attribution.mjs","names":[],"sources":["../src/grounding/attribution/index.ts"],"sourcesContent":["/**\n * Source Attribution\n *\n * Tracks and reports how AI outputs are attributed to source documents,\n * enabling transparency and auditability of AI-generated content.\n *\n * @module @od-oneapp/ai-platform/grounding/attribution\n *\n * @example\n * ```typescript\n * import { createAttributionTracker } from '@od-oneapp/ai-platform/grounding/attribution';\n *\n * const tracker = createAttributionTracker();\n *\n * // Register sources\n * tracker.addSource({ id: 'doc-1', content: 'Climate change affects...' });\n *\n * // Analyze text for attribution\n * const report = await tracker.generateReport(\n *   'Climate change affects weather patterns significantly.',\n *   ['doc-1']\n * );\n * ```\n */\n\n// -----------------------------------------------------------------------------\n// Types\n// -----------------------------------------------------------------------------\n\n/** Source document for attribution */\nexport interface AttributionSource {\n  readonly id: string;\n  readonly content: string;\n  readonly metadata?: {\n    title?: string;\n    url?: string;\n    author?: string;\n    date?: Date;\n    reliability?: number; // 0-1 score\n  };\n}\n\n/** A specific claim extracted from text */\nexport interface Claim {\n  readonly id: string;\n  readonly text: string;\n  readonly startOffset: number;\n  readonly endOffset: number;\n  readonly type: 'factual' | 'opinion' | 'inference' | 'unknown';\n}\n\n/** Attribution entry linking a source to claims */\nexport interface AttributionEntry {\n  readonly sourceId: string;\n  readonly contributionScore: number; // 0-1, how much this source contributed\n  readonly claimIds: string[];\n  readonly matchedSegments: Array<{\n    sourceSpan: { start: number; end: number };\n    claimSpan: { start: number; end: number };\n    similarity: number;\n  }>;\n}\n\n/** Complete attribution report */\nexport interface AttributionReport {\n  readonly totalSources: number;\n  readonly totalClaims: number;\n  readonly attributions: AttributionEntry[];\n  readonly unattributedClaims: string[];\n  readonly attributionCoverage: number; // 0-1, % of text with sources\n  readonly generatedAt: Date;\n  readonly metadata?: Record<string, unknown>;\n}\n\n/** Tracker configuration */\nexport interface AttributionTrackerConfig {\n  readonly minSimilarityThreshold?: number;\n  readonly maxClaimsPerSource?: number;\n  readonly extractClaims?: boolean;\n  readonly computeContribution?: boolean;\n}\n\n/** Attribution tracker interface */\nexport interface AttributionTracker {\n  addSource(source: AttributionSource): void;\n  removeSource(sourceId: string): void;\n  getSources(): AttributionSource[];\n  extractClaims(text: string): Claim[];\n  generateReport(text: string, sourceIds?: string[]): Promise<AttributionReport>;\n  getConfig(): AttributionTrackerConfig;\n}\n\n// -----------------------------------------------------------------------------\n// Implementation\n// -----------------------------------------------------------------------------\n\n/**\n * Creates an attribution tracker for source attribution analysis.\n *\n * @example\n * ```typescript\n * const tracker = createAttributionTracker({\n *   minSimilarityThreshold: 0.6,\n *   extractClaims: true\n * });\n *\n * tracker.addSource({\n *   id: 'wiki-climate',\n *   content: 'Global warming is the long-term rise in temperature...',\n *   metadata: { url: 'https://example.com/climate' }\n * });\n *\n * const report = await tracker.generateReport(\n *   'Global warming causes temperature rise worldwide.'\n * );\n * console.log(`Coverage: ${report.attributionCoverage * 100}%`);\n * ```\n */\nexport function createAttributionTracker(\n  config: AttributionTrackerConfig = {},\n): AttributionTracker {\n  const {\n    minSimilarityThreshold = 0.5,\n    maxClaimsPerSource = 50,\n    extractClaims: shouldExtractClaims = true,\n    computeContribution = true,\n  } = config;\n\n  const sources = new Map<string, AttributionSource>();\n\n  function addSource(source: AttributionSource): void {\n    sources.set(source.id, source);\n  }\n\n  function removeSource(sourceId: string): void {\n    sources.delete(sourceId);\n  }\n\n  function getSources(): AttributionSource[] {\n    return Array.from(sources.values());\n  }\n\n  /**\n   * Extract claims from text using simple sentence-based extraction.\n   */\n  function extractClaims(text: string): Claim[] {\n    if (!shouldExtractClaims) return [];\n\n    const claims: Claim[] = [];\n    // Simple sentence splitter - split on . ! ? followed by space or end\n    const sentences = text.match(/[^.!?]+[.!?]+/g) ?? [text];\n\n    let offset = 0;\n    for (const sentence of sentences) {\n      const trimmed = sentence.trim();\n      if (trimmed.length < 10) {\n        offset += sentence.length;\n        continue;\n      }\n\n      const startOffset = text.indexOf(trimmed, offset);\n      const claim: Claim = {\n        id: generateClaimId(),\n        text: trimmed,\n        startOffset,\n        endOffset: startOffset + trimmed.length,\n        type: classifyClaimType(trimmed),\n      };\n\n      claims.push(claim);\n      offset = startOffset + trimmed.length;\n    }\n\n    return claims;\n  }\n\n  /**\n   * Generate attribution report analyzing how text relates to sources.\n   */\n  async function generateReport(text: string, sourceIds?: string[]): Promise<AttributionReport> {\n    // Get sources to analyze\n    const sourcesToCheck = sourceIds\n      ? sourceIds.map(id => sources.get(id)).filter((s): s is AttributionSource => s !== undefined)\n      : Array.from(sources.values());\n\n    // Extract claims from text\n    const claims = extractClaims(text);\n    // Build attributions\n    const attributions: AttributionEntry[] = [];\n    const attributedClaimIds = new Set<string>();\n\n    for (const source of sourcesToCheck) {\n      const matchedClaims: string[] = [];\n      const matchedSegments: AttributionEntry['matchedSegments'] = [];\n\n      // Compare each claim to source\n      for (const claim of claims) {\n        if (matchedClaims.length >= maxClaimsPerSource) break;\n\n        const similarity = computeSimilarity(claim.text, source.content);\n\n        if (similarity >= minSimilarityThreshold) {\n          matchedClaims.push(claim.id);\n          attributedClaimIds.add(claim.id);\n\n          // Find best matching segment in source\n          const sourceMatch = findBestMatch(claim.text, source.content);\n          if (sourceMatch) {\n            matchedSegments.push({\n              sourceSpan: sourceMatch.span,\n              claimSpan: { start: claim.startOffset, end: claim.endOffset },\n              similarity,\n            });\n          }\n        }\n      }\n\n      if (matchedClaims.length > 0) {\n        const contributionScore = computeContribution\n          ? matchedClaims.length / claims.length\n          : matchedClaims.length / Math.max(claims.length, 1);\n\n        attributions.push({\n          sourceId: source.id,\n          contributionScore,\n          claimIds: matchedClaims,\n          matchedSegments,\n        });\n      }\n    }\n\n    // Find unattributed claims\n    const unattributedClaims = claims.filter(c => !attributedClaimIds.has(c.id)).map(c => c.id);\n\n    // Calculate coverage\n    const attributionCoverage = claims.length > 0 ? attributedClaimIds.size / claims.length : 0;\n\n    return {\n      totalSources: sourcesToCheck.length,\n      totalClaims: claims.length,\n      attributions,\n      unattributedClaims,\n      attributionCoverage,\n      generatedAt: new Date(),\n    };\n  }\n\n  function getConfig(): AttributionTrackerConfig {\n    return {\n      minSimilarityThreshold,\n      maxClaimsPerSource,\n      extractClaims: shouldExtractClaims,\n      computeContribution,\n    };\n  }\n\n  return {\n    addSource,\n    removeSource,\n    getSources,\n    extractClaims,\n    generateReport,\n    getConfig,\n  };\n}\n\n// -----------------------------------------------------------------------------\n// Legacy API (for backwards compatibility)\n// -----------------------------------------------------------------------------\n\n/**\n * Generate an attribution report for text against sources.\n * @deprecated Use createAttributionTracker() instead\n */\nexport function generateAttributionReport(\n  text: string,\n  sources: AttributionSource[],\n): AttributionReport {\n  const tracker = createAttributionTracker();\n  for (const source of sources) {\n    tracker.addSource(source);\n  }\n\n  // Synchronous wrapper - extracts claims and matches\n  const claims = tracker.extractClaims(text);\n  const attributions: AttributionEntry[] = [];\n  const attributedClaimIds = new Set<string>();\n\n  for (const source of sources) {\n    const matchedClaims: string[] = [];\n    const matchedSegments: AttributionEntry['matchedSegments'] = [];\n\n    for (const claim of claims) {\n      const similarity = computeSimilarity(claim.text, source.content);\n      if (similarity >= 0.5) {\n        matchedClaims.push(claim.id);\n        attributedClaimIds.add(claim.id);\n        matchedSegments.push({\n          sourceSpan: { start: 0, end: Math.min(100, source.content.length) },\n          claimSpan: { start: claim.startOffset, end: claim.endOffset },\n          similarity,\n        });\n      }\n    }\n\n    if (matchedClaims.length > 0) {\n      attributions.push({\n        sourceId: source.id,\n        contributionScore: matchedClaims.length / Math.max(claims.length, 1),\n        claimIds: matchedClaims,\n        matchedSegments,\n      });\n    }\n  }\n\n  return {\n    totalSources: sources.length,\n    totalClaims: claims.length,\n    attributions,\n    unattributedClaims: claims.filter(c => !attributedClaimIds.has(c.id)).map(c => c.id),\n    attributionCoverage: claims.length > 0 ? attributedClaimIds.size / claims.length : 0,\n    generatedAt: new Date(),\n  };\n}\n\n// -----------------------------------------------------------------------------\n// Utilities\n// -----------------------------------------------------------------------------\n\nfunction generateClaimId(): string {\n  return `claim-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;\n}\n\n/**\n * Classify a claim as factual, opinion, inference, or unknown.\n */\nfunction classifyClaimType(text: string): Claim['type'] {\n  const lower = text.toLowerCase();\n\n  // Opinion indicators\n  const opinionWords = ['believe', 'think', 'feel', 'opinion', 'suggest', 'might', 'could', 'may'];\n  if (opinionWords.some(w => lower.includes(w))) {\n    return 'opinion';\n  }\n\n  // Inference indicators\n  const inferenceWords = ['therefore', 'thus', 'hence', 'implies', 'suggests that', 'indicates'];\n  if (inferenceWords.some(w => lower.includes(w))) {\n    return 'inference';\n  }\n\n  // Factual indicators (numbers, dates, proper nouns pattern)\n  const hasNumbers = /\\d+/.test(text);\n  const tokens = text.split(/\\s+/).filter(Boolean);\n  const hasProperNouns = tokens.some(token => {\n    const first = token[0];\n    if (!first) return false;\n    const rest = token.slice(1);\n    return first === first.toUpperCase() && rest === rest.toLowerCase();\n  });\n  if (hasNumbers || hasProperNouns) {\n    return 'factual';\n  }\n\n  return 'unknown';\n}\n\n/**\n * Compute text similarity using word overlap (Jaccard-like).\n */\nfunction computeSimilarity(text1: string, text2: string): number {\n  const words1 = new Set(tokenize(text1));\n  const words2 = new Set(tokenize(text2));\n\n  if (words1.size === 0 || words2.size === 0) return 0;\n\n  let intersection = 0;\n  for (const word of words1) {\n    if (words2.has(word)) intersection++;\n  }\n\n  // Jaccard similarity\n  const union = words1.size + words2.size - intersection;\n  return union > 0 ? intersection / union : 0;\n}\n\n/**\n * Tokenize text into lowercase words.\n */\nfunction tokenize(text: string): string[] {\n  return text\n    .toLowerCase()\n    .replace(/[^\\w\\s]/g, ' ')\n    .split(/\\s+/)\n    .filter(w => w.length > 2); // Skip very short words\n}\n\n/**\n * Find the best matching segment in source for a claim.\n */\nfunction findBestMatch(\n  claim: string,\n  source: string,\n): { span: { start: number; end: number }; similarity: number } | null {\n  const claimWords = tokenize(claim);\n  if (claimWords.length === 0) return null;\n\n  // Sliding window over source\n  const windowSize = Math.min(claim.length * 2, 200);\n  let bestSimilarity = 0;\n  let bestSpan = { start: 0, end: windowSize };\n\n  for (let i = 0; i < source.length - 50; i += 20) {\n    const segment = source.slice(i, i + windowSize);\n    const similarity = computeSimilarity(claim, segment);\n\n    if (similarity > bestSimilarity) {\n      bestSimilarity = similarity;\n      bestSpan = { start: i, end: Math.min(i + windowSize, source.length) };\n    }\n  }\n\n  return bestSimilarity > 0 ? { span: bestSpan, similarity: bestSimilarity } : null;\n}\n"],"mappings":"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"}

package/dist/grounding-citation.d.mts

@@ -0,0 +1,2 @@
+import { a as verifyClaims, i as generateCitations, n as CitationGeneratorOptions, r as formatAsFootnotes, t as CitationFormat } from "./citation-generator-CDSymDs_.mjs";
+export { type CitationFormat, type CitationGeneratorOptions, formatAsFootnotes, generateCitations, verifyClaims };

package/dist/grounding-citation.mjs

@@ -0,0 +1,3 @@
+import { n as generateCitations, r as verifyClaims, t as formatAsFootnotes } from "./citation-generator-C-9RpbHq.mjs";
+
+export { formatAsFootnotes, generateCitations, verifyClaims };

package/dist/grounding-context.d.mts

@@ -0,0 +1,9 @@
+import { a as hasAnyPermission, c as IdentityContextSchema, d as RequestContext, f as RequestContextSchema, i as hasAllPermissions, l as MinimalContext, n as getSafeIdentityContext, o as hasPermission, r as getSafeRequestContext, s as IdentityContext, t as createRequestContext, u as MinimalContextSchema } from "./safe-context-BynhkTKR.mjs";
+
+//#region src/grounding/context/index.d.ts
+declare namespace index_d_exports {
+  export { IdentityContext, IdentityContextSchema, MinimalContext, MinimalContextSchema, RequestContext, RequestContextSchema, createRequestContext, getSafeIdentityContext, getSafeRequestContext, hasAllPermissions, hasAnyPermission, hasPermission };
+}
+//#endregion
+export { type IdentityContext, IdentityContextSchema, type MinimalContext, MinimalContextSchema, type RequestContext, RequestContextSchema, createRequestContext, getSafeIdentityContext, getSafeRequestContext, hasAllPermissions, hasAnyPermission, hasPermission, index_d_exports as t };
+//# sourceMappingURL=grounding-context.d.mts.map

package/dist/grounding-context.d.mts.map

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

package/dist/grounding-context.mjs

@@ -0,0 +1,19 @@
+import { t as __exportAll } from "./chunk-CkzbjWQW.mjs";
+import { a as hasAnyPermission, c as MinimalContextSchema, i as hasAllPermissions, l as RequestContextSchema, n as getSafeIdentityContext, o as hasPermission, r as getSafeRequestContext, s as IdentityContextSchema, t as createRequestContext } from "./safe-context-C5A3Wv3b.mjs";
+
+//#region src/grounding/context/index.ts
+var context_exports = /* @__PURE__ */ __exportAll({
+	IdentityContextSchema: () => IdentityContextSchema,
+	MinimalContextSchema: () => MinimalContextSchema,
+	RequestContextSchema: () => RequestContextSchema,
+	createRequestContext: () => createRequestContext,
+	getSafeIdentityContext: () => getSafeIdentityContext,
+	getSafeRequestContext: () => getSafeRequestContext,
+	hasAllPermissions: () => hasAllPermissions,
+	hasAnyPermission: () => hasAnyPermission,
+	hasPermission: () => hasPermission
+});
+
+//#endregion
+export { IdentityContextSchema, MinimalContextSchema, RequestContextSchema, createRequestContext, getSafeIdentityContext, getSafeRequestContext, hasAllPermissions, hasAnyPermission, hasPermission, context_exports as t };
+//# sourceMappingURL=grounding-context.mjs.map

package/dist/grounding-context.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"grounding-context.mjs","names":[],"sources":["../src/grounding/context/index.ts"],"sourcesContent":["/**\n * @fileoverview Context module for identity and request context management.\n * @module @od-oneapp/ai-platform/context\n *\n * @example\n * ```ts\n * import { getSafeIdentityContext, hasPermission } from '@od-oneapp/ai-platform/context';\n *\n * const ctx = getSafeIdentityContext(rawInput);\n * if (hasPermission(ctx, 'documents:write')) {\n *   // Allow operation\n * }\n * ```\n */\n\nexport {\n  IdentityContextSchema,\n  RequestContextSchema,\n  MinimalContextSchema,\n  type IdentityContext,\n  type RequestContext,\n  type MinimalContext,\n} from './types';\n\nexport {\n  getSafeIdentityContext,\n  getSafeRequestContext,\n  createRequestContext,\n  hasPermission,\n  hasAnyPermission,\n  hasAllPermissions,\n} from './safe-context';\n"],"mappings":""}

package/dist/grounding-embed.d.mts

@@ -0,0 +1,102 @@
+import { Jn as SDKEmbeddingModel } from "./ai-runtime-DIwOEc6g.mjs";
+import "./shared.mjs";
+import { a as RerankPipelineConfig, c as calculateMRR, d as createCrossEncoderReranker, f as createRerankPipeline, i as RerankOptions, l as calculateNDCG, m as vectorResultsToDocuments, n as CrossEncoderConfig, o as RerankProvider, p as reciprocalRankFusion, r as RerankDocument, s as RerankResult, t as CohereRerankConfig, u as createCohereReranker } from "./reranking-BpWYhYzl.mjs";
+import * as ai from "ai";
+
+//#region src/grounding/embed/index.d.ts
+interface TextChunk {
+  readonly id: string;
+  readonly content: string;
+  readonly metadata: ChunkMetadata;
+  embedding?: number[];
+}
+interface ChunkMetadata {
+  readonly sourceId?: string;
+  readonly sourceName?: string;
+  readonly startIndex?: number;
+  readonly endIndex?: number;
+  readonly chunkIndex?: number;
+  readonly totalChunks?: number;
+  readonly [key: string]: unknown;
+}
+type ChunkingStrategy = 'fixed' | 'sentence' | 'paragraph' | 'semantic';
+interface ChunkingConfig {
+  readonly strategy: ChunkingStrategy;
+  readonly chunkSize: number;
+  readonly chunkOverlap: number;
+  readonly minChunkSize?: number;
+}
+interface EmbeddingModel {
+  embed: (text: string) => Promise<number[]>;
+  embedBatch: (texts: string[]) => Promise<number[][]>;
+  readonly dimensions: number;
+  readonly modelId: string;
+}
+interface SearchResult {
+  readonly chunk: TextChunk;
+  readonly score: number;
+  readonly rank: number;
+}
+interface RAGContext {
+  readonly query: string;
+  readonly results: SearchResult[];
+  readonly totalTokens: number;
+  formattedContext: string;
+}
+interface VectorStore {
+  upsert: (chunks: TextChunk[]) => Promise<void>;
+  search: (embedding: number[], options?: SearchOptions) => Promise<SearchResult[]>;
+  delete: (ids: string[]) => Promise<void>;
+  clear: () => Promise<void>;
+}
+interface SearchOptions {
+  readonly topK?: number;
+  readonly minScore?: number;
+  readonly filter?: Record<string, unknown>;
+}
+declare function createChunker(config: ChunkingConfig): Chunker;
+interface Chunker {
+  chunk: (text: string, metadata?: Partial<ChunkMetadata>) => TextChunk[];
+  config: ChunkingConfig;
+}
+declare function createEmbedder(options: {
+  model: EmbeddingModel;
+  batchSize?: number;
+  cache?: Map<string, number[]>;
+  onProgress?: (processed: number, total: number) => void;
+}): Embedder;
+interface Embedder {
+  embed: (text: string) => Promise<number[]>;
+  embedBatch: (texts: string[]) => Promise<number[][]>;
+  embedChunks: (chunks: TextChunk[]) => Promise<TextChunk[]>;
+  readonly dimensions: number;
+  readonly modelId: string;
+}
+declare function cosineSimilarity(a: number[], b: number[]): number;
+declare function createInMemoryVectorStore(): VectorStore;
+declare function createRAGPipeline(options: {
+  embedder: Embedder;
+  vectorStore: VectorStore;
+  topK?: number;
+  maxTokens?: number;
+  minScore?: number;
+}): RAGPipeline;
+interface RAGPipeline {
+  ingest: (documents: {
+    id: string;
+    content: string;
+    metadata?: Record<string, unknown>;
+  }[], chunker: Chunker) => Promise<void>;
+  retrieve: (query: string) => Promise<RAGContext>;
+  buildPrompt: (context: RAGContext, systemPrompt?: string) => string;
+}
+declare function embedText(model: SDKEmbeddingModel, value: string, options?: {
+  maxRetries?: number;
+}): Promise<ai.EmbedResult>;
+declare function embedBatch(model: SDKEmbeddingModel, values: string[], options?: {
+  maxParallelCalls?: number;
+}): Promise<ai.EmbedManyResult>;
+declare function calculateTextSimilarity(model: SDKEmbeddingModel, text1: string, text2: string): Promise<number>;
+//#endregion
+export { ChunkMetadata, Chunker, ChunkingConfig, ChunkingStrategy, type CohereRerankConfig, type CrossEncoderConfig, Embedder, EmbeddingModel, RAGContext, RAGPipeline, type RerankDocument, type RerankOptions, type RerankPipelineConfig, type RerankProvider, type RerankResult, SearchOptions, SearchResult, TextChunk, VectorStore, calculateMRR, calculateNDCG, calculateTextSimilarity, cosineSimilarity, createChunker, createCohereReranker, createCrossEncoderReranker, createEmbedder, createInMemoryVectorStore, createRAGPipeline, createRerankPipeline, embedBatch, embedText, reciprocalRankFusion, vectorResultsToDocuments };
+//# sourceMappingURL=grounding-embed.d.mts.map

package/dist/grounding-embed.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grounding-embed.d.mts","names":[],"sources":["../src/grounding/embed/index.ts"],"mappings":";;;;;;UAiBiB,SAAA;EAAA,SACN,EAAA;EAAA,SACA,OAAA;EAAA,SACA,QAAA,EAAU,aAAA;EACnB,SAAA;AAAA;AAAA,UAIe,aAAA;EAAA,SACN,QAAA;EAAA,SACA,UAAA;EAAA,SACA,UAAA;EAAA,SACA,QAAA;EAAA,SACA,UAAA;EAAA,SACA,WAAA;EAAA,UACC,GAAA;AAAA;AAAA,KAIA,gBAAA;AAAA,UAGK,cAAA;EAAA,SACN,QAAA,EAAU,gBAAA;EAAA,SACV,SAAA;EAAA,SACA,YAAA;EAAA,SACA,YAAA;AAAA;AAAA,UAIM,cAAA;EACf,KAAA,GAAQ,IAAA,aAAiB,OAAA;EACzB,UAAA,GAAa,KAAA,eAAoB,OAAA;EAAA,SACxB,UAAA;EAAA,SACA,OAAA;AAAA;AAAA,UAIM,YAAA;EAAA,SACN,KAAA,EAAO,SAAA;EAAA,SACP,KAAA;EAAA,SACA,IAAA;AAAA;AAAA,UAIM,UAAA;EAAA,SACN,KAAA;EAAA,SACA,OAAA,EAAS,YAAA;EAAA,SACT,WAAA;EACT,gBAAA;AAAA;AAAA,UAIe,WAAA;EACf,MAAA,GAAS,MAAA,EAAQ,SAAA,OAAgB,OAAA;EACjC,MAAA,GAAS,SAAA,YAAqB,OAAA,GAAU,aAAA,KAAkB,OAAA,CAAQ,YAAA;EAClE,MAAA,GAAS,GAAA,eAAkB,OAAA;EAC3B,KAAA,QAAa,OAAA;AAAA;AAAA,UAIE,aAAA;EAAA,SACN,IAAA;EAAA,SACA,QAAA;EAAA,SACA,MAAA,GAAS,MAAA;AAAA;AAAA,iBAqBJ,aAAA,CAAc,MAAA,EAAQ,cAAA,GAAiB,OAAA;AAAA,UA8FtC,OAAA;EACf,KAAA,GAAQ,IAAA,UAAc,QAAA,GAAW,OAAA,CAAQ,aAAA,MAAmB,SAAA;EAC5D,MAAA,EAAQ,cAAA;AAAA;AAAA,iBAsEM,cAAA,CAAe,OAAA;EAC7B,KAAA,EAAO,cAAA;EACP,SAAA;EACA,KAAA,GAAQ,GAAA;EACR,UAAA,IAAc,SAAA,UAAmB,KAAA;AAAA,IAC/B,QAAA;AAAA,UAkFa,QAAA;EACf,KAAA,GAAQ,IAAA,aAAiB,OAAA;EACzB,UAAA,GAAa,KAAA,eAAoB,OAAA;EACjC,WAAA,GAAc,MAAA,EAAQ,SAAA,OAAgB,OAAA,CAAQ,SAAA;EAAA,SACrC,UAAA;EAAA,SACA,OAAA;AAAA;AAAA,iBAyBK,gBAAA,CAAiB,CAAA,YAAa,CAAA;AAAA,iBAgC9B,yBAAA,CAAA,GAA6B,WAAA;AAAA,iBAqE7B,iBAAA,CAAkB,OAAA;EAChC,QAAA,EAAU,QAAA;EACV,WAAA,EAAa,WAAA;EACb,IAAA;EACA,SAAA;EACA,QAAA;AAAA,IACE,WAAA;AAAA,UAuEa,WAAA;EACf,MAAA,GACE,SAAA;IAAa,EAAA;IAAY,OAAA;IAAiB,QAAA,GAAW,MAAA;EAAA,KACrD,OAAA,EAAS,OAAA,KACN,OAAA;EACL,QAAA,GAAW,KAAA,aAAkB,OAAA,CAAQ,UAAA;EACrC,WAAA,GAAc,OAAA,EAAS,UAAA,EAAY,YAAA;AAAA;AAAA,iBA2Df,SAAA,CACpB,KAAA,EAAO,iBAAA,EACP,KAAA,UACA,OAAA;EAAY,UAAA;AAAA,IAAqB,OAAA,CAFT,EAAA,CAES,WAAA;AAAA,iBA6Bb,UAAA,CACpB,KAAA,EAAO,iBAAA,EACP,MAAA,YACA,OAAA;EAAY,gBAAA;AAAA,IAA2B,OAAA,CAFf,EAAA,CAEe,eAAA;AAAA,iBA8BnB,uBAAA,CACpB,KAAA,EAAO,iBAAA,EACP,KAAA,UACA,KAAA,WACC,OAAA"}