@contractspec/lib.evolution 1.56.0 → 1.57.0

package/dist/analyzer/posthog-telemetry-reader.d.mts

@@ -0,0 +1,24 @@
+import { OperationCoordinate, OperationMetricSample, SpecUsageStats } from "../types.mjs";
+import { AnalyticsReader, DateRangeInput } from "@contractspec/lib.contracts/integrations/providers/analytics";
+
+//#region src/analyzer/posthog-telemetry-reader.d.ts
+interface ReadOperationSamplesInput {
+  operations?: OperationCoordinate[];
+  dateRange?: DateRangeInput;
+  limit?: number;
+}
+interface PosthogTelemetryReaderOptions {
+  eventPrefix?: string;
+}
+declare class PosthogTelemetryReader {
+  private readonly reader;
+  private readonly eventPrefix;
+  constructor(reader: AnalyticsReader, options?: PosthogTelemetryReaderOptions);
+  readOperationSamples(input: ReadOperationSamplesInput): Promise<OperationMetricSample[]>;
+  readAnomalyBaseline(operation: OperationCoordinate, windowDays?: number): Promise<SpecUsageStats | null>;
+  private readTopErrors;
+  private queryHogQL;
+}
+//#endregion
+export { PosthogTelemetryReader, PosthogTelemetryReaderOptions, ReadOperationSamplesInput };
+//# sourceMappingURL=posthog-telemetry-reader.d.mts.map

package/dist/analyzer/posthog-telemetry-reader.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"posthog-telemetry-reader.d.mts","names":[],"sources":["../../src/analyzer/posthog-telemetry-reader.ts"],"mappings":";;;;UAWiB,yBAAA;EACf,UAAA,GAAa,mBAAA;EACb,SAAA,GAAY,cAAA;EACZ,KAAA;AAAA;AAAA,UAGe,6BAAA;EACf,WAAA;AAAA;AAAA,cAGW,sBAAA;EAAA,iBACM,MAAA;EAAA,iBACA,WAAA;cAGf,MAAA,EAAQ,eAAA,EACR,OAAA,GAAS,6BAAA;EAML,oBAAA,CACJ,KAAA,EAAO,yBAAA,GACN,OAAA,CAAQ,qBAAA;EAwBL,mBAAA,CACJ,SAAA,EAAW,mBAAA,EACX,UAAA,YACC,OAAA,CAAQ,cAAA;EAAA,QAkCG,aAAA;EAAA,QAiCA,UAAA;AAAA"}

package/dist/analyzer/posthog-telemetry-reader.mjs

@@ -0,0 +1,225 @@
+//#region src/analyzer/posthog-telemetry-reader.ts
+var PosthogTelemetryReader = class {
+	reader;
+	eventPrefix;
+	constructor(reader, options = {}) {
+		this.reader = reader;
+		this.eventPrefix = options.eventPrefix ?? "observability";
+	}
+	async readOperationSamples(input) {
+		return mapOperationSamples(await this.queryHogQL({
+			query: [
+				"select",
+				"  properties.operation as operationKey,",
+				"  properties.version as version,",
+				"  properties.durationMs as durationMs,",
+				"  properties.success as success,",
+				"  properties.errorCode as errorCode,",
+				"  properties.tenantId as tenantId,",
+				"  properties.traceId as traceId,",
+				"  properties.metadata as metadata,",
+				"  timestamp as timestamp",
+				"from events",
+				`where ${buildOperationWhereClause(this.eventPrefix, input)}`,
+				"order by timestamp desc",
+				`limit ${input.limit ?? 1e3}`
+			].join("\n"),
+			values: buildOperationValues(input)
+		}));
+	}
+	async readAnomalyBaseline(operation, windowDays = 7) {
+		const dateRange = buildWindowRange(windowDays);
+		const stats = mapBaselineStats(await this.queryHogQL({
+			query: [
+				"select",
+				"  count() as totalCalls,",
+				"  avg(properties.durationMs) as averageLatencyMs,",
+				"  quantile(0.95)(properties.durationMs) as p95LatencyMs,",
+				"  quantile(0.99)(properties.durationMs) as p99LatencyMs,",
+				"  max(properties.durationMs) as maxLatencyMs,",
+				"  sum(if(properties.success = 1, 1, 0)) as successCount,",
+				"  sum(if(properties.success = 0, 1, 0)) as errorCount",
+				"from events",
+				`where ${buildOperationWhereClause(this.eventPrefix, {
+					operations: [operation],
+					dateRange
+				})}`
+			].join("\n"),
+			values: buildOperationValues({
+				operations: [operation],
+				dateRange
+			})
+		}), operation, dateRange);
+		if (!stats) return null;
+		const topErrors = await this.readTopErrors(operation, dateRange);
+		return {
+			...stats,
+			topErrors
+		};
+	}
+	async readTopErrors(operation, dateRange) {
+		return mapRows(await this.queryHogQL({
+			query: [
+				"select",
+				"  properties.errorCode as errorCode,",
+				"  count() as errorCount",
+				"from events",
+				`where ${buildOperationWhereClause(this.eventPrefix, {
+					operations: [operation],
+					dateRange
+				})} and properties.success = 0`,
+				"group by errorCode",
+				"order by errorCount desc",
+				"limit 5"
+			].join("\n"),
+			values: buildOperationValues({
+				operations: [operation],
+				dateRange
+			})
+		})).reduce((acc, row) => {
+			const code = asString(row.errorCode);
+			if (!code) return acc;
+			acc[code] = asNumber(row.errorCount);
+			return acc;
+		}, {});
+	}
+	async queryHogQL(input) {
+		if (!this.reader.queryHogQL) throw new Error("Analytics reader does not support HogQL queries.");
+		return this.reader.queryHogQL(input);
+	}
+};
+function buildOperationWhereClause(eventPrefix, input) {
+	const clauses = [`event = '${eventPrefix}.operation'`];
+	if (input.operations?.length) clauses.push(`(${buildOperationFilters(input.operations)})`);
+	if (input.dateRange?.from) clauses.push("timestamp >= {dateFrom}");
+	if (input.dateRange?.to) clauses.push("timestamp < {dateTo}");
+	return clauses.join(" and ");
+}
+function buildOperationValues(input) {
+	const values = {
+		dateFrom: toIsoString(input.dateRange?.from),
+		dateTo: toIsoString(input.dateRange?.to)
+	};
+	input.operations?.forEach((op, index) => {
+		values[`operationKey${index}`] = op.key;
+		values[`operationVersion${index}`] = op.version;
+		if (op.tenantId) values[`operationTenant${index}`] = op.tenantId;
+	});
+	return values;
+}
+function buildOperationFilters(operations) {
+	return operations.map((op, index) => {
+		const clauses = [`properties.operation = {operationKey${index}}`, `properties.version = {operationVersion${index}}`];
+		if (op.tenantId) clauses.push(`properties.tenantId = {operationTenant${index}}`);
+		return `(${clauses.join(" and ")})`;
+	}).join(" or ");
+}
+function mapOperationSamples(result) {
+	return mapRows(result).flatMap((row) => {
+		const operationKey = asString(row.operationKey);
+		const version = asString(row.version);
+		const timestamp = asDate(row.timestamp);
+		if (!operationKey || !version || !timestamp) return [];
+		return [{
+			operation: {
+				key: operationKey,
+				version,
+				tenantId: asOptionalString(row.tenantId) ?? void 0
+			},
+			durationMs: asNumber(row.durationMs),
+			success: asBoolean(row.success),
+			timestamp,
+			errorCode: asOptionalString(row.errorCode) ?? void 0,
+			traceId: asOptionalString(row.traceId) ?? void 0,
+			metadata: isRecord(row.metadata) ? row.metadata : void 0
+		}];
+	});
+}
+function mapBaselineStats(result, operation, dateRange) {
+	const row = mapRows(result)[0];
+	if (!row) return null;
+	const totalCalls = asNumber(row.totalCalls);
+	if (!totalCalls) return null;
+	const successCount = asNumber(row.successCount);
+	const errorCount = asNumber(row.errorCount);
+	return {
+		operation,
+		totalCalls,
+		successRate: totalCalls ? successCount / totalCalls : 0,
+		errorRate: totalCalls ? errorCount / totalCalls : 0,
+		averageLatencyMs: asNumber(row.averageLatencyMs),
+		p95LatencyMs: asNumber(row.p95LatencyMs),
+		p99LatencyMs: asNumber(row.p99LatencyMs),
+		maxLatencyMs: asNumber(row.maxLatencyMs),
+		lastSeenAt: /* @__PURE__ */ new Date(),
+		windowStart: toDate(dateRange.from) ?? /* @__PURE__ */ new Date(),
+		windowEnd: toDate(dateRange.to) ?? /* @__PURE__ */ new Date(),
+		topErrors: {}
+	};
+}
+function mapRows(result) {
+	if (!Array.isArray(result.results) || !Array.isArray(result.columns)) return [];
+	const columns = result.columns;
+	return result.results.flatMap((row) => {
+		if (!Array.isArray(row)) return [];
+		const record = {};
+		columns.forEach((column, index) => {
+			record[column] = row[index];
+		});
+		return [record];
+	});
+}
+function buildWindowRange(windowDays) {
+	const windowEnd = /* @__PURE__ */ new Date();
+	return {
+		from: /* @__PURE__ */ new Date(windowEnd.getTime() - windowDays * 24 * 60 * 60 * 1e3),
+		to: windowEnd
+	};
+}
+function asString(value) {
+	if (typeof value === "string" && value.trim()) return value;
+	if (typeof value === "number") return String(value);
+	return null;
+}
+function asOptionalString(value) {
+	if (typeof value === "string") return value;
+	if (typeof value === "number") return String(value);
+	return null;
+}
+function asNumber(value) {
+	if (typeof value === "number" && Number.isFinite(value)) return value;
+	if (typeof value === "string" && value.trim()) {
+		const parsed = Number(value);
+		if (Number.isFinite(parsed)) return parsed;
+	}
+	return 0;
+}
+function asBoolean(value) {
+	if (typeof value === "boolean") return value;
+	if (typeof value === "number") return value !== 0;
+	if (typeof value === "string") return value.toLowerCase() === "true";
+	return false;
+}
+function asDate(value) {
+	if (value instanceof Date) return value;
+	if (typeof value === "string" || typeof value === "number") {
+		const date = new Date(value);
+		if (!Number.isNaN(date.getTime())) return date;
+	}
+	return null;
+}
+function toIsoString(value) {
+	if (!value) return void 0;
+	return typeof value === "string" ? value : value.toISOString();
+}
+function toDate(value) {
+	if (!value) return null;
+	return value instanceof Date ? value : new Date(value);
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null;
+}
+
+//#endregion
+export { PosthogTelemetryReader };
+//# sourceMappingURL=posthog-telemetry-reader.mjs.map

package/dist/analyzer/posthog-telemetry-reader.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"posthog-telemetry-reader.mjs","names":[],"sources":["../../src/analyzer/posthog-telemetry-reader.ts"],"sourcesContent":["import type {\n  AnalyticsReader,\n  AnalyticsQueryResult,\n  DateRangeInput,\n} from '@contractspec/lib.contracts/integrations/providers/analytics';\nimport type {\n  OperationCoordinate,\n  OperationMetricSample,\n  SpecUsageStats,\n} from '../types';\n\nexport interface ReadOperationSamplesInput {\n  operations?: OperationCoordinate[];\n  dateRange?: DateRangeInput;\n  limit?: number;\n}\n\nexport interface PosthogTelemetryReaderOptions {\n  eventPrefix?: string;\n}\n\nexport class PosthogTelemetryReader {\n  private readonly reader: AnalyticsReader;\n  private readonly eventPrefix: string;\n\n  constructor(\n    reader: AnalyticsReader,\n    options: PosthogTelemetryReaderOptions = {}\n  ) {\n    this.reader = reader;\n    this.eventPrefix = options.eventPrefix ?? 'observability';\n  }\n\n  async readOperationSamples(\n    input: ReadOperationSamplesInput\n  ): Promise<OperationMetricSample[]> {\n    const result = await this.queryHogQL({\n      query: [\n        'select',\n        '  properties.operation as operationKey,',\n        '  properties.version as version,',\n        '  properties.durationMs as durationMs,',\n        '  properties.success as success,',\n        '  properties.errorCode as errorCode,',\n        '  properties.tenantId as tenantId,',\n        '  properties.traceId as traceId,',\n        '  properties.metadata as metadata,',\n        '  timestamp as timestamp',\n        'from events',\n        `where ${buildOperationWhereClause(this.eventPrefix, input)}`,\n        'order by timestamp desc',\n        `limit ${input.limit ?? 1000}`,\n      ].join('\\n'),\n      values: buildOperationValues(input),\n    });\n\n    return mapOperationSamples(result);\n  }\n\n  async readAnomalyBaseline(\n    operation: OperationCoordinate,\n    windowDays = 7\n  ): Promise<SpecUsageStats | null> {\n    const dateRange = buildWindowRange(windowDays);\n    const baseResult = await this.queryHogQL({\n      query: [\n        'select',\n        '  count() as totalCalls,',\n        '  avg(properties.durationMs) as averageLatencyMs,',\n        '  quantile(0.95)(properties.durationMs) as p95LatencyMs,',\n        '  quantile(0.99)(properties.durationMs) as p99LatencyMs,',\n        '  max(properties.durationMs) as maxLatencyMs,',\n        '  sum(if(properties.success = 1, 1, 0)) as successCount,',\n        '  sum(if(properties.success = 0, 1, 0)) as errorCount',\n        'from events',\n        `where ${buildOperationWhereClause(this.eventPrefix, {\n          operations: [operation],\n          dateRange,\n        })}`,\n      ].join('\\n'),\n      values: buildOperationValues({\n        operations: [operation],\n        dateRange,\n      }),\n    });\n\n    const stats = mapBaselineStats(baseResult, operation, dateRange);\n    if (!stats) return null;\n\n    const topErrors = await this.readTopErrors(operation, dateRange);\n    return {\n      ...stats,\n      topErrors,\n    };\n  }\n\n  private async readTopErrors(\n    operation: OperationCoordinate,\n    dateRange: DateRangeInput\n  ): Promise<Record<string, number>> {\n    const result = await this.queryHogQL({\n      query: [\n        'select',\n        '  properties.errorCode as errorCode,',\n        '  count() as errorCount',\n        'from events',\n        `where ${buildOperationWhereClause(this.eventPrefix, {\n          operations: [operation],\n          dateRange,\n        })} and properties.success = 0`,\n        'group by errorCode',\n        'order by errorCount desc',\n        'limit 5',\n      ].join('\\n'),\n      values: buildOperationValues({\n        operations: [operation],\n        dateRange,\n      }),\n    });\n\n    const rows = mapRows(result);\n    return rows.reduce<Record<string, number>>((acc, row) => {\n      const code = asString(row.errorCode);\n      if (!code) return acc;\n      acc[code] = asNumber(row.errorCount);\n      return acc;\n    }, {});\n  }\n\n  private async queryHogQL(input: {\n    query: string;\n    values: Record<string, unknown>;\n  }): Promise<AnalyticsQueryResult> {\n    if (!this.reader.queryHogQL) {\n      throw new Error('Analytics reader does not support HogQL queries.');\n    }\n    return this.reader.queryHogQL(input);\n  }\n}\n\nfunction buildOperationWhereClause(\n  eventPrefix: string,\n  input: { operations?: OperationCoordinate[]; dateRange?: DateRangeInput }\n): string {\n  const clauses = [`event = '${eventPrefix}.operation'`];\n  if (input.operations?.length) {\n    clauses.push(`(${buildOperationFilters(input.operations)})`);\n  }\n  if (input.dateRange?.from) {\n    clauses.push('timestamp >= {dateFrom}');\n  }\n  if (input.dateRange?.to) {\n    clauses.push('timestamp < {dateTo}');\n  }\n  return clauses.join(' and ');\n}\n\nfunction buildOperationValues(input: {\n  operations?: OperationCoordinate[];\n  dateRange?: DateRangeInput;\n}): Record<string, unknown> {\n  const values: Record<string, unknown> = {\n    dateFrom: toIsoString(input.dateRange?.from),\n    dateTo: toIsoString(input.dateRange?.to),\n  };\n  input.operations?.forEach((op, index) => {\n    values[`operationKey${index}`] = op.key;\n    values[`operationVersion${index}`] = op.version;\n    if (op.tenantId) {\n      values[`operationTenant${index}`] = op.tenantId;\n    }\n  });\n  return values;\n}\n\nfunction buildOperationFilters(operations: OperationCoordinate[]): string {\n  return operations\n    .map((op, index) => {\n      const clauses = [\n        `properties.operation = {operationKey${index}}`,\n        `properties.version = {operationVersion${index}}`,\n      ];\n      if (op.tenantId) {\n        clauses.push(`properties.tenantId = {operationTenant${index}}`);\n      }\n      return `(${clauses.join(' and ')})`;\n    })\n    .join(' or ');\n}\n\nfunction mapOperationSamples(\n  result: AnalyticsQueryResult\n): OperationMetricSample[] {\n  const rows = mapRows(result);\n  return rows.flatMap((row) => {\n    const operationKey = asString(row.operationKey);\n    const version = asString(row.version);\n    const timestamp = asDate(row.timestamp);\n    if (!operationKey || !version || !timestamp) {\n      return [];\n    }\n    return [\n      {\n        operation: {\n          key: operationKey,\n          version,\n          tenantId: asOptionalString(row.tenantId) ?? undefined,\n        },\n        durationMs: asNumber(row.durationMs),\n        success: asBoolean(row.success),\n        timestamp,\n        errorCode: asOptionalString(row.errorCode) ?? undefined,\n        traceId: asOptionalString(row.traceId) ?? undefined,\n        metadata: isRecord(row.metadata) ? row.metadata : undefined,\n      },\n    ];\n  });\n}\n\nfunction mapBaselineStats(\n  result: AnalyticsQueryResult,\n  operation: OperationCoordinate,\n  dateRange: DateRangeInput\n): SpecUsageStats | null {\n  const rows = mapRows(result);\n  const row = rows[0];\n  if (!row) return null;\n  const totalCalls = asNumber(row.totalCalls);\n  if (!totalCalls) return null;\n  const successCount = asNumber(row.successCount);\n  const errorCount = asNumber(row.errorCount);\n  return {\n    operation,\n    totalCalls,\n    successRate: totalCalls ? successCount / totalCalls : 0,\n    errorRate: totalCalls ? errorCount / totalCalls : 0,\n    averageLatencyMs: asNumber(row.averageLatencyMs),\n    p95LatencyMs: asNumber(row.p95LatencyMs),\n    p99LatencyMs: asNumber(row.p99LatencyMs),\n    maxLatencyMs: asNumber(row.maxLatencyMs),\n    lastSeenAt: new Date(),\n    windowStart: toDate(dateRange.from) ?? new Date(),\n    windowEnd: toDate(dateRange.to) ?? new Date(),\n    topErrors: {},\n  };\n}\n\nfunction mapRows(result: AnalyticsQueryResult): Record<string, unknown>[] {\n  if (!Array.isArray(result.results) || !Array.isArray(result.columns)) {\n    return [];\n  }\n  const columns = result.columns;\n  return result.results.flatMap((row) => {\n    if (!Array.isArray(row)) return [];\n    const record: Record<string, unknown> = {};\n    columns.forEach((column, index) => {\n      record[column] = row[index];\n    });\n    return [record];\n  });\n}\n\nfunction buildWindowRange(windowDays: number): DateRangeInput {\n  const windowEnd = new Date();\n  const windowStart = new Date(\n    windowEnd.getTime() - windowDays * 24 * 60 * 60 * 1000\n  );\n  return {\n    from: windowStart,\n    to: windowEnd,\n  };\n}\n\nfunction asString(value: unknown): string | null {\n  if (typeof value === 'string' && value.trim()) return value;\n  if (typeof value === 'number') return String(value);\n  return null;\n}\n\nfunction asOptionalString(value: unknown): string | null {\n  if (typeof value === 'string') return value;\n  if (typeof value === 'number') return String(value);\n  return null;\n}\n\nfunction asNumber(value: unknown): number {\n  if (typeof value === 'number' && Number.isFinite(value)) return value;\n  if (typeof value === 'string' && value.trim()) {\n    const parsed = Number(value);\n    if (Number.isFinite(parsed)) return parsed;\n  }\n  return 0;\n}\n\nfunction asBoolean(value: unknown): boolean {\n  if (typeof value === 'boolean') return value;\n  if (typeof value === 'number') return value !== 0;\n  if (typeof value === 'string') return value.toLowerCase() === 'true';\n  return false;\n}\n\nfunction asDate(value: unknown): Date | null {\n  if (value instanceof Date) return value;\n  if (typeof value === 'string' || typeof value === 'number') {\n    const date = new Date(value);\n    if (!Number.isNaN(date.getTime())) return date;\n  }\n  return null;\n}\n\nfunction toIsoString(value?: string | Date): string | undefined {\n  if (!value) return undefined;\n  return typeof value === 'string' ? value : value.toISOString();\n}\n\nfunction toDate(value?: string | Date): Date | null {\n  if (!value) return null;\n  return value instanceof Date ? value : new Date(value);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n"],"mappings":"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"}

package/dist/analyzer/spec-analyzer.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"spec-analyzer.d.mts","names":[],"sources":["../../src/analyzer/spec-analyzer.ts"],"sourcesContent":[],"mappings":";;;;;UAciB,mBAAA;WACN;EADM,aAAA,CAAA,EAAA,MAAmB;EAmBvB,kBAAY,CAAA,EAAA,MAAA;EAOF,qBAAA,CAAA,EAAA,MAAA;EAUK,uBAAA,CAAA,EAAA,MAAA;;AAoCjB,cArDE,YAAA,CAqDF;EACI,iBAAA,MAAA;EACV,iBAAA,aAAA;EAsFU,iBAAA,kBAAA;EACJ,iBAAA,qBAAA;EACN,iBAAA,uBAAA;EA8BM,WAAA,CAAA,OAAA,CAAA,EAtKY,mBAsKZ;EACI,gBAAA,CAAA,OAAA,EA7Ja,qBA6Jb,EAAA,CAAA,EA7JuC,cA6JvC,EAAA;EACiB,eAAA,CAAA,KAAA,EA1HrB,cA0HqB,EAAA,EAAA,QAAA,CAAA,EAzHjB,cAyHiB,EAAA,CAAA,EAxH3B,WAwH2B,EAAA;EAC3B,gBAAA,CAAA,SAAA,EAnCU,WAmCV,EAAA,EAAA,KAAA,EAlCM,cAkCN,EAAA,CAAA,EAjCA,aAiCA,EAAA;EAAgB,oBAAA,CAAA,KAAA,EAHV,cAGU,EAAA,EAAA,SAAA,EAFN,WAEM,EAAA,EAAA,iBAAA,EAAA;WADW;MAC3B"}
+{"version":3,"file":"spec-analyzer.d.mts","names":[],"sources":["../../src/analyzer/spec-analyzer.ts"],"mappings":";;;;;UAciB,mBAAA;EACf,MAAA,GAAS,MAAA;EACT,aAAA;EACA,kBAAA;EACA,qBAAA;EACA,uBAAA;AAAA;AAAA,cAcW,YAAA;EAAA,iBACM,MAAA;EAAA,iBACA,aAAA;EAAA,iBACA,kBAAA;EAAA,iBACA,qBAAA;EAAA,iBACA,uBAAA;cAEL,OAAA,GAAS,mBAAA;EAUrB,gBAAA,CAAiB,OAAA,EAAS,qBAAA,KAA0B,cAAA;EAmCpD,eAAA,CACE,KAAA,EAAO,cAAA,IACP,QAAA,GAAW,cAAA,KACV,WAAA;EAqFH,gBAAA,CACE,SAAA,EAAW,WAAA,IACX,KAAA,EAAO,cAAA,KACN,aAAA;EA6BH,oBAAA,CACE,KAAA,EAAO,cAAA,IACP,SAAA,EAAW,WAAA,IACX,gBAAA;IAAqB,KAAA,EAAO,cAAA;EAAA,IAC3B,gBAAA;EAAA,QAsEK,YAAA;EAAA,QAcA,eAAA;EAAA,QAoCA,UAAA;EAAA,QAMA,iBAAA;EAAA,QAeA,gBAAA;EAAA,QAaA,qBAAA;AAAA"}

package/dist/approval/integration.d.mts

@@ -1,7 +1,6 @@
 import { SpecSuggestion, SpecSuggestionFilters, SpecSuggestionRepository, SpecSuggestionWriter, SuggestionStatus } from "../types.mjs";
-import { AgentSessionState } from "../ai-agent/src/types.mjs";
-import { ApprovalWorkflow } from "../ai-agent/src/approval/workflow.mjs";
-import "../ai-agent/src/approval/index.mjs";
+import { ApprovalWorkflow } from "@contractspec/lib.ai-agent/approval";
+import { AgentSessionState } from "@contractspec/lib.ai-agent/types";
 
 //#region src/approval/integration.d.ts
 interface SpecSuggestionOrchestratorOptions {

package/dist/approval/integration.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"integration.d.mts","names":[],"sources":["../../src/approval/integration.ts"],"sourcesContent":[],"mappings":";;;;;;UAYiB,iCAAA;cACH;aACD;EAFI,MAAA,CAAA,EAGN,oBAHM;;AAEJ,cAIA,0BAAA,CAJA;EACF,iBAAA,OAAA;EAAoB,WAAA,CAAA,OAAA,EAIS,iCAJT;EAGlB,MAAA,CAAA,UAAA,EAIG,cAJuB,EAAA,OAAA,CAAA,EAKzB,iBALyB,EAAA,cAAA,CAAA,EAAA,MAAA,CAAA,EAMZ,OANY,CAMZ,cANY,CAAA;EACC,OAAA,CAAA,EAAA,EAAA,MAAA,EAAA,QAAA,EAAA,MAAA,EAAA,KAAA,CAAA,EAAA,MAAA,CAAA,EAwBoB,OAxBpB,CAAA,IAAA,CAAA;EAGxB,MAAA,CAAA,EAAA,EAAA,MAAA,EAAA,QAAA,EAAA,MAAA,EAAA,KAAA,CAAA,EAAA,MAAA,CAAA,EA0C2C,OA1C3C,CAAA,IAAA,CAAA;EACF,IAAA,CAAA,OAAA,CAAA,EAiDG,qBAjDH,CAAA,EAiDwB,OAjDxB,CAiDwB,cAjDxB,EAAA,CAAA;EACa,QAAA,gBAAA;;AAmBiC,UAwC3C,iCAAA,CAxC2C;EAqBD,SAAA,CAAA,EAAA,MAAA;EAQ1C,gBAAA,CAAA,EAAA,CAAA,UAAA,EAaiB,cAbjB,EAAA,GAAA,MAAA;;AAAqB,cAgBzB,0BAAA,YAAsC,oBAhBb,CAAA;EAAA,iBAAA,SAAA;EAWrB,iBAAA,gBAAA;EAKJ,WAAA,CAAA,OAA2B,CAA3B,EAMU,iCANiB;EAMjB,KAAA,CAAA,UAAA,EAUG,cAVH,CAAA,EAUoB,OAVpB,CAAA,MAAA,CAAA;;AAUoB,cAU9B,gCAAA,YAA4C,wBAVd,CAAA;EAhBQ,iBAAA,KAAA;EAAoB,MAAA,CAAA,UAAA,EA6B5C,cA7B4C,CAAA,EA6B3B,OA7B2B,CAAA,IAAA,CAAA;EA0B1D,OAAA,CAAA,EAAA,EAAA,MAAA,CAAA,EAOgB,OAPhB,CAOwB,cAPS,GAAA,SAAA,CAAA;EAGnB,YAAA,CAAA,EAAA,EAAA,MAAA,EAAA,MAAA,EAUf,gBAVe,EAAA,QAUf,CAVe,EAAA;IAAiB,QAAA,CAAA,EAAA,MAAA;IAIP,KAAA,CAAA,EAAA,MAAA;IAAR,SAAA,CAAA,EAOmC,IAPnC;EAMjB,CAAA,CAAA,EAEP,OAFO,CAAA,IAAA,CAAA;EACoD,IAAA,CAAA,OAAA,CAAA,EAgBzC,qBAhByC,CAAA,EAgBpB,OAhBoB,CAgBpB,cAhBoB,EAAA,CAAA"}
+{"version":3,"file":"integration.d.mts","names":[],"sources":["../../src/approval/integration.ts"],"mappings":";;;;;UAYiB,iCAAA;EACf,UAAA,EAAY,wBAAA;EACZ,QAAA,GAAW,gBAAA;EACX,MAAA,GAAS,oBAAA;AAAA;AAAA,cAGE,0BAAA;EAAA,iBACkB,OAAA;cAAA,OAAA,EAAS,iCAAA;EAEhC,MAAA,CACJ,UAAA,EAAY,cAAA,EACZ,OAAA,GAAU,iBAAA,EACV,cAAA,YAAuB,OAAA,CAAA,cAAA;EAmBnB,OAAA,CAAQ,EAAA,UAAY,QAAA,UAAkB,KAAA,YAAc,OAAA;EAqBpD,MAAA,CAAO,EAAA,UAAY,QAAA,UAAkB,KAAA,YAAc,OAAA;EAQzD,IAAA,CAAK,OAAA,GAAU,qBAAA,GAAqB,OAAA,CAAA,cAAA;EAAA,QAItB,gBAAA;AAAA;AAAA,UAOC,iCAAA;EACf,SAAA;EACA,gBAAA,IAAoB,UAAA,EAAY,cAAA;AAAA;AAAA,cAGrB,0BAAA,YAAsC,oBAAA;EAAA,iBAChC,SAAA;EAAA,iBACA,gBAAA;cAIL,OAAA,GAAS,iCAAA;EAUf,KAAA,CAAM,UAAA,EAAY,cAAA,GAAiB,OAAA;AAAA;AAAA,cAU9B,gCAAA,YAA4C,wBAAA;EAAA,iBACtC,KAAA;EAEX,MAAA,CAAO,UAAA,EAAY,cAAA,GAAiB,OAAA;EAIpC,OAAA,CAAQ,EAAA,WAAa,OAAA,CAAQ,cAAA;EAI7B,YAAA,CACJ,EAAA,UACA,MAAA,EAAQ,gBAAA,EACR,QAAA;IAAa,QAAA;IAAmB,KAAA;IAAgB,SAAA,GAAY,IAAA;EAAA,IAC3D,OAAA;EAeG,IAAA,CAAK,OAAA,GAAU,qBAAA,GAAqB,OAAA,CAAA,cAAA;AAAA"}

package/dist/approval/integration.mjs

@@ -1,6 +1,6 @@
 import { mkdir, writeFile } from "node:fs/promises";
 import { join } from "node:path";
-import "@contractspec/lib.ai-agent/approval";
+import { ApprovalWorkflow } from "@contractspec/lib.ai-agent/approval";
 
 //#region src/approval/integration.ts
 var SpecSuggestionOrchestrator = class {

package/dist/generator/ai-spec-generator.d.mts

@@ -2,7 +2,6 @@ import { EvolutionConfig, IntentPattern, SpecSuggestion } from "../types.mjs";
 import { LanguageModel } from "ai";
 
 //#region src/generator/ai-spec-generator.d.ts
-
 /**
  * Configuration for the AI-powered spec generator.
  */

package/dist/generator/ai-spec-generator.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-spec-generator.d.mts","names":[],"sources":["../../src/generator/ai-spec-generator.ts"],"sourcesContent":[],"mappings":";;;;;;;AA2CA;AAea,UAfI,qBAAA,CAeW;EAKL;EAmBX,KAAA,EArCH,aAqCG;EAGS;EAER,eAAA,CAAA,EAxCO,eAwCP;EAAR;EAoBQ,YAAA,CAAA,EAAA,MAAA;;;;;;;AA4Lb;cA7Oa,eAAA;;;;uBAKU;;;;6BAmBX;;mBAGS;MAEhB,QAAQ;;;;yBAoBA;;MAER,QAAQ;;;;gCAmByB,iBAAiB,QAAQ;;;;;;;;;iBAuK/C,qBAAA,SACN,wBACP"}
+{"version":3,"file":"ai-spec-generator.d.mts","names":[],"sources":["../../src/generator/ai-spec-generator.ts"],"mappings":";;;;;;AA2CA;UAAiB,qBAAA;;EAEf,KAAA,EAAO,aAAA;EAAP;EAEA,eAAA,GAAkB,eAAA;EAAlB;EAEA,YAAA;AAAA;;;AASF;;;;cAAa,eAAA;EAAA,iBACM,KAAA;EAAA,iBACA,MAAA;EAAA,iBACA,YAAA;cAEL,OAAA,EAAS,qBAAA;EA8CV;;;EA5BL,kBAAA,CACJ,MAAA,EAAQ,aAAA,EACR,OAAA;IACE,iBAAA;IACA,YAAA,GAAe,MAAA;EAAA,IAEhB,OAAA,CAAQ,cAAA;EA5BM;;;EA+CX,aAAA,CACJ,OAAA,EAAS,aAAA,IACT,OAAA;IAAW,aAAA;EAAA,IACV,OAAA,CAAQ,cAAA;EA5BL;;;EA+CA,iBAAA,CAAkB,UAAA,EAAY,cAAA,GAAiB,OAAA,CAAQ,cAAA;EAAA,QAyCrD,WAAA;EAAA,QAiDA,eAAA;EAAA,QAkCA,iBAAA;EAAA,QA2BA,sBAAA;AAAA;;;;iBAgBM,qBAAA,CACd,MAAA,EAAQ,qBAAA,GACP,eAAA"}

package/dist/generator/spec-generator.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"spec-generator.d.mts","names":[],"sources":["../../src/generator/spec-generator.ts"],"sourcesContent":[],"mappings":";;;;;;UAiBiB,oBAAA;WACN;EADM,MAAA,CAAA,EAEN,MAFM;EACN,KAAA,CAAA,EAAA,GAAA,GAEK,IAFL;EACA,OAAA,CAAA,EAAA,CAAA,GAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAAA,MAAA,EAAA,GAEoC,gBAFpC,GAAA,SAAA;;AAEoC,UAG9B,mBAAA,CAH8B;EAAgB,OAAA,CAAA,EAAA,MAAA;EAG9C,SAAA,CAAA,EAAA,MAAA;EAGF,UAAA,CAAA,EAAA,sBAAA,CAAA,YAAA,CAAA;EACN,IAAA,CAAA,EAAA,sBAAA,CAAA,MAAA,CAAA;EACA,IAAA,CAAA,EAAA,gBAAA;EAEI,IAAA,CAAA,EAAA,MAAA;EACF,QAAA,CAAA,EADE,MACF,CAAA,MAAA,EAAA,OAAA,CAAA;EAAgB,MAAA,CAAA,EAAhB,gBAAgB;EAKf,IAAA,CAAA,EAAA,MAAS,EAAA;EACL,SAAA,CAAA,EAAA,MAAA;;AAAiC,KADrC,SAAA,GAAY,OACyB,CAA/C,aAA+C,CAAjC,cAAiC,EAAjB,cAAiB,GAAA,qBAAA,CAAA,OAAA,CAAA,CAAA,CAAA,GAAA;EAA/C,IAAA,CAAA,EACW,OADX,CACmB,gBADnB,CAAA,MAAA,CAAA,CAAA;CADsB;AAEH,cAER,aAAA,CAFQ;EAAR,iBAAA,MAAA;EAAO,iBAAA,MAAA;EAEP,iBAAa,KAAA;EAMH,iBAAA,OAAA;EAQX,WAAA,CAAA,OAAA,CAAA,EARW,oBAQX;EACC,kBAAA,CAAA,MAAA,EADD,aACC,EAAA,OAAA,CAAA,EAAA,mBAAA,CAAA,EACR,cADQ;EACR,eAAA,CAAA,SAAA,EAyCU,mBAzCV,EAAA,KAAA,EA0CM,SA1CN,EAAA,MAAA,EA2CO,aA3CP,EAAA,OAAA,CAAA,EA4CQ,IA5CR,CA4Ca,mBA5Cb,EAAA,MAAA,CAAA,CAAA,EA4C8C,cA5C9C;EAyCU,kBAAA,CAAA,UAAA,EAmBC,cAnBD,EAAA,MAAA,CAAA,EAoBH,eApBG,CAAA,EAAA;IACJ,EAAA,EAAA,OAAA;IACC,OAAA,EAAA,MAAA,EAAA;EACM,CAAA;EAAL,QAAA,YAAA;EAAsC,QAAA,gBAAA;EAgBnC,QAAA,eAAA"}
+{"version":3,"file":"spec-generator.d.mts","names":[],"sources":["../../src/generator/spec-generator.ts"],"mappings":";;;;;;UAiBiB,oBAAA;EACf,MAAA,GAAS,eAAA;EACT,MAAA,GAAS,MAAA;EACT,KAAA,SAAc,IAAA;EACd,OAAA,IAAW,GAAA,UAAa,OAAA,cAAqB,gBAAA;AAAA;AAAA,UAG9B,mBAAA;EACf,OAAA;EACA,SAAA;EACA,UAAA,GAAa,sBAAA;EACb,IAAA,GAAO,sBAAA;EACP,IAAA,GAAO,gBAAA;EACP,IAAA;EACA,QAAA,GAAW,MAAA;EACX,MAAA,GAAS,gBAAA;EACT,IAAA;EACA,SAAA;AAAA;AAAA,KAGU,SAAA,GAAY,OAAA,CACtB,aAAA,CAAc,cAAA,EAAgB,cAAA,GAAiB,qBAAA;EAC3C,IAAA,GAAO,OAAA,CAAQ,gBAAA;AAAA;AAAA,cAER,aAAA;EAAA,iBACM,MAAA;EAAA,iBACA,MAAA;EAAA,iBACA,KAAA;EAAA,iBACA,OAAA;cAEL,OAAA,GAAS,oBAAA;EAOrB,kBAAA,CACE,MAAA,EAAQ,aAAA,EACR,OAAA,GAAS,mBAAA,GACR,cAAA;EAwCH,eAAA,CACE,SAAA,EAAW,mBAAA,EACX,KAAA,EAAO,SAAA,EACP,MAAA,EAAQ,aAAA,EACR,OAAA,GAAS,IAAA,CAAK,mBAAA,YAAiC,cAAA;EAejD,kBAAA,CACE,UAAA,EAAY,cAAA,EACZ,MAAA,GAAQ,eAAA;;;;UAgCF,YAAA;EAAA,QAeA,gBAAA;EAAA,QAOA,eAAA;AAAA"}

package/dist/index.d.mts

@@ -1,6 +1,7 @@
 import { AnomalySeverity, EvolutionConfig, IntentPattern, OperationCoordinate, OperationMetricSample, OptimizationHint, PatternConfidence, SpecAnomaly, SpecSuggestion, SpecSuggestionFilters, SpecSuggestionProposal, SpecSuggestionRepository, SpecSuggestionWriter, SpecUsageStats, SuggestionEvidence, SuggestionStatus } from "./types.mjs";
 import { SpecAnalyzer, SpecAnalyzerOptions } from "./analyzer/spec-analyzer.mjs";
+import { PosthogTelemetryReader, PosthogTelemetryReaderOptions, ReadOperationSamplesInput } from "./analyzer/posthog-telemetry-reader.mjs";
 import { GenerateSpecOptions, SpecGenerator, SpecGeneratorOptions, SpecPatch } from "./generator/spec-generator.mjs";
 import { AISpecGenerator, AISpecGeneratorConfig, createAISpecGenerator } from "./generator/ai-spec-generator.mjs";
 import { FileSystemSuggestionWriter, FileSystemSuggestionWriterOptions, InMemorySpecSuggestionRepository, SpecSuggestionOrchestrator, SpecSuggestionOrchestratorOptions } from "./approval/integration.mjs";
-export { AISpecGenerator, AISpecGeneratorConfig, AnomalySeverity, EvolutionConfig, FileSystemSuggestionWriter, FileSystemSuggestionWriterOptions, GenerateSpecOptions, InMemorySpecSuggestionRepository, IntentPattern, OperationCoordinate, OperationMetricSample, OptimizationHint, PatternConfidence, SpecAnalyzer, SpecAnalyzerOptions, SpecAnomaly, SpecGenerator, SpecGeneratorOptions, SpecPatch, SpecSuggestion, SpecSuggestionFilters, SpecSuggestionOrchestrator, SpecSuggestionOrchestratorOptions, SpecSuggestionProposal, SpecSuggestionRepository, SpecSuggestionWriter, SpecUsageStats, SuggestionEvidence, SuggestionStatus, createAISpecGenerator };
+export { AISpecGenerator, AISpecGeneratorConfig, AnomalySeverity, EvolutionConfig, FileSystemSuggestionWriter, FileSystemSuggestionWriterOptions, GenerateSpecOptions, InMemorySpecSuggestionRepository, IntentPattern, OperationCoordinate, OperationMetricSample, OptimizationHint, PatternConfidence, PosthogTelemetryReader, PosthogTelemetryReaderOptions, ReadOperationSamplesInput, SpecAnalyzer, SpecAnalyzerOptions, SpecAnomaly, SpecGenerator, SpecGeneratorOptions, SpecPatch, SpecSuggestion, SpecSuggestionFilters, SpecSuggestionOrchestrator, SpecSuggestionOrchestratorOptions, SpecSuggestionProposal, SpecSuggestionRepository, SpecSuggestionWriter, SpecUsageStats, SuggestionEvidence, SuggestionStatus, createAISpecGenerator };

package/dist/index.mjs

@@ -1,6 +1,7 @@
 import { SpecAnalyzer } from "./analyzer/spec-analyzer.mjs";
+import { PosthogTelemetryReader } from "./analyzer/posthog-telemetry-reader.mjs";
 import { SpecGenerator } from "./generator/spec-generator.mjs";
 import { AISpecGenerator, createAISpecGenerator } from "./generator/ai-spec-generator.mjs";
 import { FileSystemSuggestionWriter, InMemorySpecSuggestionRepository, SpecSuggestionOrchestrator } from "./approval/integration.mjs";
 
-export { AISpecGenerator, FileSystemSuggestionWriter, InMemorySpecSuggestionRepository, SpecAnalyzer, SpecGenerator, SpecSuggestionOrchestrator, createAISpecGenerator };
+export { AISpecGenerator, FileSystemSuggestionWriter, InMemorySpecSuggestionRepository, PosthogTelemetryReader, SpecAnalyzer, SpecGenerator, SpecSuggestionOrchestrator, createAISpecGenerator };

package/dist/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;;KAQY,eAAA;KACA,gBAAA;AADA,UAGK,mBAAA,CAHU;EACf,GAAA,EAAA,MAAA;EAEK,OAAA,EAAA,MAAA;EAMA,QAAA,CAAA,EAAA,MAAA;;AAIJ,UAJI,qBAAA,CAIJ;EAOA,SAAA,EAVA,mBAUA;EAAM,UAAA,EAAA,MAAA;EAGF,OAAA,EAAA,OAAA;EACJ,SAAA,EAXA,IAWA;EAQC,gBAAA,CAAA,EAAA,MAAA;EACC,SAAA,CAAA,EAAA,MAAA;EACF,YAAA,CAAA,EAAA,MAAA;EACA,KAAA,CAAA,EAAA,MAAA;EAAM,OAAA,CAAA,EAAA,MAAA;EAGF,OAAA,CAAA,EAAA,MAAA;EAMA,QAAA,CAAA,EAxBJ,MAwBe,CAAA,MAAA,EAAA,OAAA,CAAA;;AAEhB,UAvBK,cAAA,CAuBL;EAGE,SAAA,EAzBD,mBAyBC;EAGF,UAAA,EAAA,MAAA;EAAkB,WAAA,EAAA,MAAA;EAGb,SAAA,EAAA,MAAA;EAMA,gBAAa,EAAA,MAAA;EAUhB,YAAA,EAAA,MAAA;EACA,YAAA,EAAA,MAAA;EACD,YAAA,EAAA,MAAA;EACD,UAAA,EA1CE,IA0CF;EAAkB,WAAA,EAzCf,IAyCe;EAGb,SAAA,EA3CJ,IA2CI;EAIR,SAAA,EA9CI,MA8CJ,CAAA,MAAA,EAAA,MAAA,CAAA;;AAGL,UA9Ca,kBAAA,CA8Cb;EAAiB,IAAA,EAAA,WAAA,GAAA,eAAA,GAAA,YAAA,GAAA,MAAA;EAFZ,WAAA,EAAA,MAAA;EAKI,IAAA,CAAA,EA9CJ,MA8CI,CAAA,MAAA,EAAA,OAAA,CAAA;;AAGI,UA9CA,WAAA,CA8Cc;EAErB,SAAA,EA/CG,mBA+CH;EACC,QAAA,EA/CC,eA+CD;EACC,MAAA,EAAA,SAAA,GAAA,YAAA,GAAA,YAAA,GAAA,QAAA,GAAA,QAAA;EAEC,WAAA,EAAA,MAAA;EAEH,UAAA,EAjDI,IAiDJ;EACE,SAAA,CAAA,EAAA,MAAA;EAMI,aAAA,CAAA,EAAA,MAAA;EACH,QAAA,EAtDD,kBAsDC,EAAA;;AAII,UAvDA,iBAAA,CAuDe;EAQf,KAAA,EAAA,MAAA;EAKA,UAAA,EAAA,MAAA;EACI,MAAA,CAAA,EAAA,MAAA;;AACU,UAhEd,aAAA,CAgEc;EAAR,EAAA,EAAA,MAAA;EAGX,IAAA,EAAA,oBAAA,GAAA,aAAA,GAAA,mBAAA,GAAA,gBAAA,GAAA,iBAAA,GAAA,iBAAA;EACoD,WAAA,EAAA,MAAA;EAC3D,SAAA,CAAA,EA3DS,mBA2DT;EACY,UAAA,EA3DH,iBA2DG;EAAgC,QAAA,CAAA,EA1DpC,MA0DoC,CAAA,MAAA,EAAA,OAAA,CAAA;EAAR,QAAA,EAzD7B,kBAyD6B,EAAA;;AAGxB,UAzDA,sBAAA,CA0DG;EAGH,OAAA,EAAA,MAAA;;;SAzDR;SACA,cACL,gBACA,iBAAiB;;aAGR;;UAGI,cAAA;;UAEP;WACC;YACC;;aAEC;;UAEH;YACE;;;;;;gBAMI;aACH;;;UAII,eAAA;;;;;;;UAQA,qBAAA;WACN;;;UAIM,wBAAA;qBACI,iBAAiB;uBACf,QAAQ;mCAGnB;;;gBACoD;MAC3D;iBACY,wBAAwB,QAAQ;;UAGhC,oBAAA;oBACG,iBAAiB;;UAGpB,gBAAA;aACJ;;;;;mBAKM"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../src/types.ts"],"mappings":";;;;;KAQY,eAAA;AAAA,KACA,gBAAA;AAAA,UAEK,mBAAA;EACf,GAAA;EACA,OAAA;EACA,QAAA;AAAA;AAAA,UAGe,qBAAA;EACf,SAAA,EAAW,mBAAA;EACX,UAAA;EACA,OAAA;EACA,SAAA,EAAW,IAAA;EACX,gBAAA;EACA,SAAA;EACA,YAAA;EACA,KAAA;EACA,OAAA;EACA,OAAA;EACA,QAAA,GAAW,MAAA;AAAA;AAAA,UAGI,cAAA;EACf,SAAA,EAAW,mBAAA;EACX,UAAA;EACA,WAAA;EACA,SAAA;EACA,gBAAA;EACA,YAAA;EACA,YAAA;EACA,YAAA;EACA,UAAA,EAAY,IAAA;EACZ,WAAA,EAAa,IAAA;EACb,SAAA,EAAW,IAAA;EACX,SAAA,EAAW,MAAA;AAAA;AAAA,UAGI,kBAAA;EACf,IAAA;EACA,WAAA;EACA,IAAA,GAAO,MAAA;AAAA;AAAA,UAGQ,WAAA;EACf,SAAA,EAAW,mBAAA;EACX,QAAA,EAAU,eAAA;EACV,MAAA;EACA,WAAA;EACA,UAAA,EAAY,IAAA;EACZ,SAAA;EACA,aAAA;EACA,QAAA,EAAU,kBAAA;AAAA;AAAA,UAGK,iBAAA;EACf,KAAA;EACA,UAAA;EACA,MAAA;AAAA;AAAA,UAGe,aAAA;EACf,EAAA;EACA,IAAA;EAOA,WAAA;EACA,SAAA,GAAY,mBAAA;EACZ,UAAA,EAAY,iBAAA;EACZ,QAAA,GAAW,MAAA;EACX,QAAA,EAAU,kBAAA;AAAA;AAAA,UAGK,sBAAA;EACf,OAAA;EACA,SAAA;EACA,UAAA;EACA,IAAA,GAAO,MAAA;EACP,IAAA,GAAO,aAAA,CACL,cAAA,EACA,cAAA,GAAiB,qBAAA;EAEnB,IAAA;EACA,QAAA,GAAW,MAAA;AAAA;AAAA,UAGI,cAAA;EACf,EAAA;EACA,MAAA,EAAQ,aAAA;EACR,MAAA,GAAS,mBAAA;EACT,QAAA,EAAU,sBAAA;EACV,UAAA;EACA,SAAA,EAAW,IAAA;EACX,SAAA;EACA,MAAA,EAAQ,gBAAA;EACR,QAAA,EAAU,kBAAA;EACV,QAAA;EACA,IAAA;EACA,SAAA;IACE,QAAA;IACA,KAAA;IACA,SAAA,GAAY,IAAA;IACZ,MAAA,GAAS,gBAAA;EAAA;AAAA;AAAA,UAII,eAAA;EACf,aAAA;EACA,oBAAA;EACA,0BAAA;EACA,eAAA;EACA,wBAAA;AAAA;AAAA,UAGe,qBAAA;EACf,MAAA,GAAS,gBAAA;EACT,YAAA;AAAA;AAAA,UAGe,wBAAA;EACf,MAAA,CAAO,UAAA,EAAY,cAAA,GAAiB,OAAA;EACpC,OAAA,CAAQ,EAAA,WAAa,OAAA,CAAQ,cAAA;EAC7B,YAAA,CACE,EAAA,UACA,MAAA,EAAQ,gBAAA,EACR,QAAA;IAAa,QAAA;IAAmB,KAAA;IAAgB,SAAA,GAAY,IAAA;EAAA,IAC3D,OAAA;EACH,IAAA,CAAK,OAAA,GAAU,qBAAA,GAAwB,OAAA,CAAQ,cAAA;AAAA;AAAA,UAGhC,oBAAA;EACf,KAAA,CAAM,UAAA,EAAY,cAAA,GAAiB,OAAA;AAAA;AAAA,UAGpB,gBAAA;EACf,SAAA,EAAW,mBAAA;EACX,QAAA;EACA,OAAA;EACA,aAAA;EACA,kBAAA;EACA,cAAA,GAAiB,cAAA;EACjB,cAAA;AAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/lib.evolution",
-  "version": "1.56.0",
+  "version": "1.57.0",
   "description": "AI-powered contract evolution engine",
   "keywords": [
     "contractspec",
@@ -29,21 +29,21 @@
     "test": "bun test"
   },
   "dependencies": {
-    "ai": "6.0.67",
+    "ai": "6.0.73",
     "zod": "^4.3.5",
-    "@contractspec/lib.ai-agent": "1.56.0",
-    "@contractspec/lib.contracts": "1.56.0",
-    "@contractspec/lib.lifecycle": "1.56.0",
-    "@contractspec/lib.observability": "1.56.0",
-    "@contractspec/lib.schema": "1.56.0"
+    "@contractspec/lib.ai-agent": "1.57.0",
+    "@contractspec/lib.contracts": "1.57.0",
+    "@contractspec/lib.lifecycle": "1.57.0",
+    "@contractspec/lib.observability": "1.57.0",
+    "@contractspec/lib.schema": "1.57.0"
   },
   "peerDependencies": {
     "@prisma/client": "7.3.0"
   },
   "devDependencies": {
-    "@contractspec/tool.tsdown": "1.56.0",
-    "@contractspec/tool.typescript": "1.56.0",
-    "tsdown": "^0.19.0",
+    "@contractspec/tool.tsdown": "1.57.0",
+    "@contractspec/tool.typescript": "1.57.0",
+    "tsdown": "^0.20.3",
     "typescript": "^5.9.3"
   },
   "exports": {

package/dist/ai-agent/src/approval/index.d.mts

@@ -1 +0,0 @@
-import { ApprovalRequest, ApprovalStatus, ApprovalStore, ApprovalWorkflow } from "./workflow.mjs";

package/dist/ai-agent/src/approval/workflow.d.mts

@@ -1,136 +0,0 @@
-import { ToolCallInfo } from "../types.mjs";
-
-//#region ../ai-agent/src/approval/workflow.d.ts
-type ApprovalStatus = 'pending' | 'approved' | 'rejected';
-/**
- * Approval request for a tool execution.
- *
- * When a tool has `needsApproval: true` in AI SDK v6, the agent
- * will pause and wait for approval before executing the tool.
- */
-interface ApprovalRequest {
-  /** Unique request ID */
-  id: string;
-  /** Agent session ID */
-  sessionId: string;
-  /** Agent ID */
-  agentId: string;
-  /** Tenant ID for scoping */
-  tenantId?: string;
-  /** Tool name requiring approval */
-  toolName: string;
-  /** Tool call ID from AI SDK */
-  toolCallId: string;
-  /** Tool arguments */
-  toolArgs: unknown;
-  /** Human-readable reason for approval */
-  reason: string;
-  /** When the approval was requested */
-  requestedAt: Date;
-  /** Current status */
-  status: ApprovalStatus;
-  /** Additional context payload */
-  payload?: Record<string, unknown>;
-  /** Who resolved the approval */
-  reviewer?: string;
-  /** When the approval was resolved */
-  resolvedAt?: Date;
-  /** Reviewer notes */
-  notes?: string;
-}
-/**
- * Storage interface for approval requests.
- */
-interface ApprovalStore {
-  create(request: ApprovalRequest): Promise<void>;
-  get(id: string): Promise<ApprovalRequest | null>;
-  getByToolCallId(toolCallId: string): Promise<ApprovalRequest | null>;
-  update(id: string, updates: Partial<Omit<ApprovalRequest, 'id' | 'sessionId'>>): Promise<void>;
-  list(options?: {
-    status?: ApprovalStatus;
-    agentId?: string;
-    tenantId?: string;
-  }): Promise<ApprovalRequest[]>;
-}
-/**
- * Approval workflow for managing tool execution approvals.
- *
- * Integrates with AI SDK v6's `needsApproval` feature on tools.
- *
- * @example
- * ```typescript
- * const workflow = new ApprovalWorkflow();
- *
- * // When a tool needs approval
- * const request = await workflow.requestApproval({
- *   sessionId: 'sess_123',
- *   agentId: 'support.bot.v1',
- *   toolName: 'delete_account',
- *   toolCallId: 'call_abc',
- *   toolArgs: { userId: 'user_123' },
- *   reason: 'Account deletion requires human approval',
- * });
- *
- * // When approval is granted
- * await workflow.approve(request.id, 'admin@example.com', 'Verified identity');
- *
- * // Or rejected
- * await workflow.reject(request.id, 'admin@example.com', 'Suspicious activity');
- * ```
- */
-declare class ApprovalWorkflow {
-  private readonly store;
-  constructor(store?: ApprovalStore);
-  /**
-   * Request approval for a tool execution.
-   */
-  requestApproval(params: {
-    sessionId: string;
-    agentId: string;
-    tenantId?: string;
-    toolName: string;
-    toolCallId: string;
-    toolArgs: unknown;
-    reason: string;
-    payload?: Record<string, unknown>;
-  }): Promise<ApprovalRequest>;
-  /**
-   * Request approval from an AI SDK tool call.
-   */
-  requestApprovalFromToolCall(toolCall: ToolCallInfo, context: {
-    sessionId: string;
-    agentId: string;
-    tenantId?: string;
-    reason?: string;
-  }): Promise<ApprovalRequest>;
-  /**
-   * Approve a pending request.
-   */
-  approve(id: string, reviewer: string, notes?: string): Promise<void>;
-  /**
-   * Reject a pending request.
-   */
-  reject(id: string, reviewer: string, notes?: string): Promise<void>;
-  /**
-   * Get approval status for a tool call.
-   */
-  getStatus(toolCallId: string): Promise<ApprovalStatus | null>;
-  /**
-   * Check if a tool call is approved.
-   */
-  isApproved(toolCallId: string): Promise<boolean>;
-  /**
-   * List pending approvals.
-   */
-  listPending(options?: {
-    agentId?: string;
-    tenantId?: string;
-  }): Promise<ApprovalRequest[]>;
-  /**
-   * Get approval request by ID.
-   */
-  get(id: string): Promise<ApprovalRequest | null>;
-}
-//#endregion
-export { ApprovalRequest, ApprovalStatus, ApprovalStore, ApprovalWorkflow };
-//# sourceMappingURL=workflow.d.mts.map

package/dist/ai-agent/src/approval/workflow.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"workflow.d.mts","names":[],"sources":["../../../../../ai-agent/src/approval/workflow.ts"],"sourcesContent":[],"mappings":";;;KAGY,cAAA;;AAAZ;AAQA;;;;AA0Be,UA1BE,eAAA,CA0BF;EAAI;EAQF,EAAA,EAAA,MAAA;EACC;EAAkB,SAAA,EAAA,MAAA;EACT;EAAR,OAAA,EAAA,MAAA;EAC4B;EAAR,QAAA,CAAA,EAAA,MAAA;EAGb;EAAL,QAAA,EAAA,MAAA;EAAR;EACR,UAAA,EAAA,MAAA;EAEQ;EAGC,QAAA,EAAA,OAAA;EAAR;EAAO,MAAA,EAAA,MAAA;EAyFA;EAEe,WAAA,EAvHb,IAuHa;EAcd;EACA,MAAA,EApIJ,cAoII;EAAR;EAuBQ,OAAA,CAAA,EAzJF,MAyJE,CAAA,MAAA,EAAA,OAAA,CAAA;EAOD;EAAR,QAAA,CAAA,EAAA,MAAA;EAe0D;EAYD,UAAA,CAAA,EAvL/C,IAuL+C;EAYf;EAAR,KAAA,CAAA,EAAA,MAAA;;;;;AA0Bd,UArNR,aAAA,CAqNQ;EAAO,MAAA,CAAA,OAAA,EApNd,eAoNc,CAAA,EApNI,OAoNJ,CAAA,IAAA,CAAA;mBAnNb,QAAQ;uCACY,QAAQ;8BAGlC,QAAQ,KAAK,wCACrB;;aAEQ;;;MAGP,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAyFD,gBAAA;;sBAEe;;;;;;;;;;;;cAcd;MACR,QAAQ;;;;wCAuBA;;;;;MAOT,QAAQ;;;;yDAekD;;;;wDAYD;;;;iCAYvB,QAAQ;;;;kCAQP;;;;;;;MAWlC,QAAQ;;;;mBAOW,QAAQ"}

package/dist/ai-agent/src/types.d.mts

@@ -1,30 +0,0 @@
-import { ModelMessage, StepResult, ToolSet } from "ai";
-
-//#region ../ai-agent/src/types.d.ts
-
-/**
- * Simplified tool call type for ContractSpec usage.
- * Compatible with AI SDK v6 TypedToolCall.
- */
-interface ToolCallInfo {
-  type: 'tool-call';
-  toolCallId: string;
-  toolName: string;
-  args: unknown;
-}
-type AgentStatus = 'idle' | 'running' | 'waiting' | 'completed' | 'failed' | 'escalated';
-interface AgentSessionState {
-  sessionId: string;
-  agentId: string;
-  tenantId?: string;
-  actorId?: string;
-  status: AgentStatus;
-  messages: ModelMessage[];
-  steps: StepResult<ToolSet>[];
-  createdAt: Date;
-  updatedAt: Date;
-  metadata?: Record<string, string>;
-}
-//#endregion
-export { AgentSessionState, ToolCallInfo };
-//# sourceMappingURL=types.d.mts.map

package/dist/ai-agent/src/types.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../ai-agent/src/types.ts"],"sourcesContent":[],"mappings":";;;;;AAWA;AAoCA;AA8DA;AAKU,UAvGO,YAAA,CAuGP;EACE,IAAA,EAAA,WAAA;EACQ,UAAA,EAAA,MAAA;EAAX,QAAA,EAAA,MAAA;EACI,IAAA,EAAA,OAAA;;KAtED,WAAA;UA8DK,iBAAA;;;;;UAKP;YACE;SACH,WAAW;aACP;aACA;aACA"}