@full-self-browsing/lattice 1.3.0 → 1.5.0

package/dist/agent-run-C6miAzwI.d.ts

@@ -0,0 +1,45 @@
+import { T as Usage } from "./provider-C2IfKsvz.js";
+
+//#region src/eval/agent-run.d.ts
+/**
+ * Summary of an agent run sufficient for regression analysis. Callers
+ * typically derive this from an `AgentSuccess` via `iterations.length` and
+ * cumulative `usage`. The schema is intentionally minimal so callers can
+ * persist + load it across runs without dragging the full ReplayEnvelope.
+ */
+interface AgentRunSnapshot {
+  readonly iterationsToGoal: number;
+  readonly usage: Usage;
+}
+interface EvalOptions {
+  /**
+   * Maximum tolerated INCREASE in iterations-to-goal versus the baseline.
+   * Default 1 (one extra iteration tolerated). Set to 0 to require parity.
+   */
+  readonly iterationsToGoalRegressionLimit?: number;
+  /**
+   * Maximum tolerated FRACTIONAL cost increase versus the baseline.
+   * Default 0.10 (10% increase tolerated). Compared as
+   * `(current - baseline) / baseline`. Cost regressions are only
+   * considered when BOTH snapshots have a non-null `costUsd`; mixed-cost
+   * snapshots emit a `mixed-cost-unknown` regression so callers can decide
+   * how to handle them.
+   */
+  readonly costUsdRegressionLimit?: number;
+}
+type EvalRegressionKind = "iterations-to-goal" | "cost-regression" | "mixed-cost-unknown";
+interface EvalRegression {
+  readonly kind: EvalRegressionKind;
+  readonly baseline: number | null;
+  readonly current: number | null;
+  readonly limit: number;
+  readonly message: string;
+}
+interface AgentEvalResult {
+  readonly ok: boolean;
+  readonly regressions: ReadonlyArray<EvalRegression>;
+}
+declare function evalAgentRun(baseline: AgentRunSnapshot, current: AgentRunSnapshot, options?: EvalOptions): AgentEvalResult;
+//#endregion
+export { EvalRegressionKind as a, EvalRegression as i, AgentRunSnapshot as n, evalAgentRun as o, EvalOptions as r, AgentEvalResult as t };
+//# sourceMappingURL=agent-run-C6miAzwI.d.ts.map

package/dist/agent-run-C6miAzwI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-run-C6miAzwI.d.ts","names":[],"sources":["../src/eval/agent-run.ts"],"mappings":";;;;AAwBA;;;;;UALiB,gBAAA;EAAA,SACN,gBAAA;EAAA,SACA,KAAA,EAAO,KAAA;AAAA;AAAA,UAGD,WAAA;EAsBA;;;;EAAA,SAjBN,+BAAA;EAkBM;;;;;;;AAOjB;EAPiB,SATN,sBAAA;AAAA;AAAA,KAGC,kBAAA;AAAA,UAKK,cAAA;EAAA,SACN,IAAA,EAAM,kBAAA;EAAA,SACN,QAAA;EAAA,SACA,OAAA;EAAA,SACA,KAAA;EAAA,SACA,OAAA;AAAA;AAAA,UAGM,eAAA;EAAA,SACN,EAAA;EAAA,SACA,WAAA,EAAa,aAAA,CAAc,cAAA;AAAA;AAAA,iBAGtB,YAAA,CACd,QAAA,EAAU,gBAAA,EACV,OAAA,EAAS,gBAAA,EACT,OAAA,GAAS,WAAA,GACR,eAAA"}

package/dist/agent-run-CgPVFl0Z.js

@@ -0,0 +1,47 @@
+//#region src/eval/agent-run.ts
+function evalAgentRun(baseline, current, options = {}) {
+	const iterLimit = options.iterationsToGoalRegressionLimit ?? 1;
+	const costLimit = options.costUsdRegressionLimit ?? .1;
+	const regressions = [];
+	const iterDelta = current.iterationsToGoal - baseline.iterationsToGoal;
+	if (iterDelta > iterLimit) regressions.push({
+		kind: "iterations-to-goal",
+		baseline: baseline.iterationsToGoal,
+		current: current.iterationsToGoal,
+		limit: iterLimit,
+		message: `Iterations-to-goal ${current.iterationsToGoal} exceeds baseline ${baseline.iterationsToGoal} by ${iterDelta} (limit: ${iterLimit}).`
+	});
+	const bCost = baseline.usage.costUsd;
+	const cCost = current.usage.costUsd;
+	if (bCost === null && cCost === null) {} else if (bCost === null || cCost === null) regressions.push({
+		kind: "mixed-cost-unknown",
+		baseline: bCost,
+		current: cCost,
+		limit: costLimit,
+		message: `Cost mixed: baseline=${bCost} current=${cCost}; cannot compare regression.`
+	});
+	else if (bCost > 0) {
+		const ratio = (cCost - bCost) / bCost;
+		if (ratio > costLimit) regressions.push({
+			kind: "cost-regression",
+			baseline: bCost,
+			current: cCost,
+			limit: costLimit,
+			message: `Cost regression: $${cCost.toFixed(6)} vs baseline $${bCost.toFixed(6)} (+${(ratio * 100).toFixed(1)}%; limit ${(costLimit * 100).toFixed(1)}%).`
+		});
+	} else if (bCost === 0 && cCost > 0) regressions.push({
+		kind: "cost-regression",
+		baseline: bCost,
+		current: cCost,
+		limit: costLimit,
+		message: `Cost regression: baseline was $0; current $${cCost.toFixed(6)}.`
+	});
+	return {
+		ok: regressions.length === 0,
+		regressions: Object.freeze(regressions)
+	};
+}
+//#endregion
+export { evalAgentRun as t };
+
+//# sourceMappingURL=agent-run-CgPVFl0Z.js.map

package/dist/agent-run-CgPVFl0Z.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-run-CgPVFl0Z.js","names":[],"sources":["../src/eval/agent-run.ts"],"sourcesContent":["/**\n * evalAgentRun - Phase 22 (v1.2).\n *\n * Pure helper that gates a baseline-relative regression on iterations-to-goal\n * and total cost for an agent run. Standalone (no I/O). Callers wire fixture\n * discovery + persistence themselves; this kernel is the comparison engine.\n *\n * The shape mirrors the existing v1.1 `lattice eval` cost-regression contract\n * so a future `lattice eval --agent` CLI subcommand can reuse the same gate.\n */\n\nimport type { Usage } from \"../providers/provider.js\";\n\n/**\n * Summary of an agent run sufficient for regression analysis. Callers\n * typically derive this from an `AgentSuccess` via `iterations.length` and\n * cumulative `usage`. The schema is intentionally minimal so callers can\n * persist + load it across runs without dragging the full ReplayEnvelope.\n */\nexport interface AgentRunSnapshot {\n  readonly iterationsToGoal: number;\n  readonly usage: Usage;\n}\n\nexport interface EvalOptions {\n  /**\n   * Maximum tolerated INCREASE in iterations-to-goal versus the baseline.\n   * Default 1 (one extra iteration tolerated). Set to 0 to require parity.\n   */\n  readonly iterationsToGoalRegressionLimit?: number;\n  /**\n   * Maximum tolerated FRACTIONAL cost increase versus the baseline.\n   * Default 0.10 (10% increase tolerated). Compared as\n   * `(current - baseline) / baseline`. Cost regressions are only\n   * considered when BOTH snapshots have a non-null `costUsd`; mixed-cost\n   * snapshots emit a `mixed-cost-unknown` regression so callers can decide\n   * how to handle them.\n   */\n  readonly costUsdRegressionLimit?: number;\n}\n\nexport type EvalRegressionKind =\n  | \"iterations-to-goal\"\n  | \"cost-regression\"\n  | \"mixed-cost-unknown\";\n\nexport interface EvalRegression {\n  readonly kind: EvalRegressionKind;\n  readonly baseline: number | null;\n  readonly current: number | null;\n  readonly limit: number;\n  readonly message: string;\n}\n\nexport interface AgentEvalResult {\n  readonly ok: boolean;\n  readonly regressions: ReadonlyArray<EvalRegression>;\n}\n\nexport function evalAgentRun(\n  baseline: AgentRunSnapshot,\n  current: AgentRunSnapshot,\n  options: EvalOptions = {},\n): AgentEvalResult {\n  const iterLimit = options.iterationsToGoalRegressionLimit ?? 1;\n  const costLimit = options.costUsdRegressionLimit ?? 0.1;\n  const regressions: EvalRegression[] = [];\n\n  // Iterations-to-goal regression.\n  const iterDelta = current.iterationsToGoal - baseline.iterationsToGoal;\n  if (iterDelta > iterLimit) {\n    regressions.push({\n      kind: \"iterations-to-goal\",\n      baseline: baseline.iterationsToGoal,\n      current: current.iterationsToGoal,\n      limit: iterLimit,\n      message: `Iterations-to-goal ${current.iterationsToGoal} exceeds baseline ${baseline.iterationsToGoal} by ${iterDelta} (limit: ${iterLimit}).`,\n    });\n  }\n\n  // Cost regression.\n  const bCost = baseline.usage.costUsd;\n  const cCost = current.usage.costUsd;\n  if (bCost === null && cCost === null) {\n    // Both unmeasured: no signal, no regression.\n  } else if (bCost === null || cCost === null) {\n    regressions.push({\n      kind: \"mixed-cost-unknown\",\n      baseline: bCost,\n      current: cCost,\n      limit: costLimit,\n      message: `Cost mixed: baseline=${bCost} current=${cCost}; cannot compare regression.`,\n    });\n  } else if (bCost > 0) {\n    const ratio = (cCost - bCost) / bCost;\n    if (ratio > costLimit) {\n      regressions.push({\n        kind: \"cost-regression\",\n        baseline: bCost,\n        current: cCost,\n        limit: costLimit,\n        message: `Cost regression: $${cCost.toFixed(6)} vs baseline $${bCost.toFixed(6)} (+${(ratio * 100).toFixed(1)}%; limit ${(costLimit * 100).toFixed(1)}%).`,\n      });\n    }\n  } else if (bCost === 0 && cCost > 0) {\n    // Baseline is free; any positive cost is a regression by definition.\n    regressions.push({\n      kind: \"cost-regression\",\n      baseline: bCost,\n      current: cCost,\n      limit: costLimit,\n      message: `Cost regression: baseline was $0; current $${cCost.toFixed(6)}.`,\n    });\n  }\n\n  return {\n    ok: regressions.length === 0,\n    regressions: Object.freeze(regressions),\n  };\n}\n"],"mappings":";AA2DA,SAAgB,aACd,UACA,SACA,UAAuB,EAAE,EACR;CACjB,MAAM,YAAY,QAAQ,mCAAmC;CAC7D,MAAM,YAAY,QAAQ,0BAA0B;CACpD,MAAM,cAAgC,EAAE;CAGxC,MAAM,YAAY,QAAQ,mBAAmB,SAAS;AACtD,KAAI,YAAY,UACd,aAAY,KAAK;EACf,MAAM;EACN,UAAU,SAAS;EACnB,SAAS,QAAQ;EACjB,OAAO;EACP,SAAS,sBAAsB,QAAQ,iBAAiB,oBAAoB,SAAS,iBAAiB,MAAM,UAAU,WAAW,UAAU;EAC5I,CAAC;CAIJ,MAAM,QAAQ,SAAS,MAAM;CAC7B,MAAM,QAAQ,QAAQ,MAAM;AAC5B,KAAI,UAAU,QAAQ,UAAU,MAAM,YAE3B,UAAU,QAAQ,UAAU,KACrC,aAAY,KAAK;EACf,MAAM;EACN,UAAU;EACV,SAAS;EACT,OAAO;EACP,SAAS,wBAAwB,MAAM,WAAW,MAAM;EACzD,CAAC;UACO,QAAQ,GAAG;EACpB,MAAM,SAAS,QAAQ,SAAS;AAChC,MAAI,QAAQ,UACV,aAAY,KAAK;GACf,MAAM;GACN,UAAU;GACV,SAAS;GACT,OAAO;GACP,SAAS,qBAAqB,MAAM,QAAQ,EAAE,CAAC,gBAAgB,MAAM,QAAQ,EAAE,CAAC,MAAM,QAAQ,KAAK,QAAQ,EAAE,CAAC,YAAY,YAAY,KAAK,QAAQ,EAAE,CAAC;GACvJ,CAAC;YAEK,UAAU,KAAK,QAAQ,EAEhC,aAAY,KAAK;EACf,MAAM;EACN,UAAU;EACV,SAAS;EACT,OAAO;EACP,SAAS,8CAA8C,MAAM,QAAQ,EAAE,CAAC;EACzE,CAAC;AAGJ,QAAO;EACL,IAAI,YAAY,WAAW;EAC3B,aAAa,OAAO,OAAO,YAAY;EACxC"}

package/dist/agents.d.ts

@@ -0,0 +1,5 @@
+import { ht as parseToolUseEnvelope, mt as ToolUseRequest } from "./provider-C2IfKsvz.js";
+import { A as FormatToolsMode, M as FormattedToolsHandle, N as formatToolsForProvider, P as toolSchemaToJsonSchema, S as createNoopAgentHost, _ as AgentHost, a as CrewPolicy, b as AgentStorage, c as defineAgent, d as AgentFailureKind, f as AgentIntent, g as IterationRecord, i as runAgentCrew, j as FormatToolsOptions, k as ConversationTurn, l as AgentDeniedError, m as AgentSuccess, n as CrewResult, o as CrewRateLimitOverride, p as AgentResult, r as RunAgentCrewOptions, s as AgentSpec, t as CrewAgentResult, u as AgentFailure, v as AgentScheduler, x as AgentTransport, y as AgentSnapshot } from "./run-crew-Bnve5dyI.js";
+import { A as createCostTracker, C as ProgressStatus, D as createTranscriptStore, E as TranscriptStore, O as CostBudgetStatus, S as GoalProgressTracker, T as TokenEstimator, _ as STUCK_REASONS, a as withRateLimit, b as GoalProgressOptions, c as PermissionHookContext, d as createPermissionContext, f as createPermissionGuardHook, g as ActionRecord, h as ActionHistoryOptions, i as createRateLimitGroup, j as runAgent, k as CostTracker, l as PermissionRule, m as ActionHistory, n as RateLimitGroupOptions, o as PermissionContext, p as permissionGuardRegisterOptions, r as RateLimitLease, s as PermissionDecisionInput, t as RateLimitGroup, u as PermissionVerdict, v as StuckReason, w as createGoalProgressTracker, x as GoalProgressStep, y as createActionHistory } from "./rate-limit-group-nDsBJqSu.js";
+import { a as EvalRegressionKind, i as EvalRegression, n as AgentRunSnapshot, o as evalAgentRun, r as EvalOptions, t as AgentEvalResult } from "./agent-run-C6miAzwI.js";
+export { type ActionHistory, type ActionHistoryOptions, type ActionRecord, AgentDeniedError, type AgentEvalResult, type AgentFailure, type AgentFailureKind, type AgentHost, type AgentIntent, type AgentResult, type AgentRunSnapshot, type AgentScheduler, type AgentSnapshot, type AgentSpec, type AgentStorage, type AgentSuccess, type AgentTransport, type ConversationTurn, type CostBudgetStatus, type CostTracker, type CrewAgentResult, type CrewPolicy, type CrewRateLimitOverride, type CrewResult, type EvalOptions, type EvalRegression, type EvalRegressionKind, type FormatToolsMode, type FormatToolsOptions, type FormattedToolsHandle, type GoalProgressOptions, type GoalProgressStep, type GoalProgressTracker, type IterationRecord, type PermissionContext, type PermissionDecisionInput, type PermissionHookContext, type PermissionRule, type PermissionVerdict, type ProgressStatus, type RateLimitGroup, type RateLimitGroupOptions, type RateLimitLease, type RunAgentCrewOptions, STUCK_REASONS, type StuckReason, type TokenEstimator, type ToolUseRequest, type TranscriptStore, createActionHistory, createCostTracker, createGoalProgressTracker, createNoopAgentHost, createPermissionContext, createPermissionGuardHook, createRateLimitGroup, createTranscriptStore, defineAgent, evalAgentRun, formatToolsForProvider, parseToolUseEnvelope, permissionGuardRegisterOptions, runAgent, runAgentCrew, toolSchemaToJsonSchema, withRateLimit };

package/dist/agents.js

@@ -0,0 +1,6 @@
+import { a as createNoopAgentHost, i as AgentDeniedError, o as formatToolsForProvider, s as toolSchemaToJsonSchema, t as runAgent } from "./runtime-Dxiet5YS.js";
+import { o as parseToolUseEnvelope } from "./validate-c7EL5uuH.js";
+import { a as createTranscriptStore, i as createGoalProgressTracker, n as createPermissionGuardHook, o as defineAgent, r as permissionGuardRegisterOptions, t as createPermissionContext } from "./permission-context-CUKMo79F.js";
+import { a as STUCK_REASONS, i as withRateLimit, o as createActionHistory, r as createRateLimitGroup, s as createCostTracker, t as runAgentCrew } from "./run-crew-B2fQLmgB.js";
+import { t as evalAgentRun } from "./agent-run-CgPVFl0Z.js";
+export { AgentDeniedError, STUCK_REASONS, createActionHistory, createCostTracker, createGoalProgressTracker, createNoopAgentHost, createPermissionContext, createPermissionGuardHook, createRateLimitGroup, createTranscriptStore, defineAgent, evalAgentRun, formatToolsForProvider, parseToolUseEnvelope, permissionGuardRegisterOptions, runAgent, runAgentCrew, toolSchemaToJsonSchema, withRateLimit };

package/dist/artifact-Bg6mJGnm.d.ts

@@ -0,0 +1,125 @@
+//#region src/policy/policy.d.ts
+type GatewayMetadataValue = string | number | boolean | null | readonly GatewayMetadataValue[] | {
+  readonly [key: string]: GatewayMetadataValue;
+};
+interface GatewayPolicy {
+  readonly routeTags?: readonly string[];
+  readonly providerPreferences?: readonly string[];
+  readonly metadata?: Record<string, GatewayMetadataValue>;
+  readonly allowFallbacks?: boolean;
+}
+interface PolicySpec {
+  readonly maxCostUsd?: number;
+  readonly latency?: "interactive" | "batch";
+  readonly privacy?: "standard" | "sensitive" | "restricted";
+  readonly providerAllowList?: readonly string[];
+  readonly providerDenyList?: readonly string[];
+  readonly noUpload?: boolean;
+  readonly noPublicUrl?: boolean;
+  readonly noLogging?: boolean;
+  readonly stream?: boolean;
+  readonly gateway?: GatewayPolicy;
+  readonly metadata?: Record<string, unknown>;
+}
+declare function mergePolicy(defaultPolicy?: PolicySpec, runPolicy?: PolicySpec): PolicySpec | undefined;
+//#endregion
+//#region src/artifacts/lineage.d.ts
+type ArtifactTransformKind = "manual" | "generated" | "extraction" | "chunking" | "transcription" | "resizing" | "provider-packaging" | "tool-result" | "model-output";
+interface ArtifactTransformDescriptor {
+  readonly kind: ArtifactTransformKind;
+  readonly name?: string;
+  readonly metadata?: Record<string, unknown>;
+}
+interface ArtifactParentRef {
+  readonly id: string;
+  readonly kind: ArtifactKind;
+  readonly mediaType?: string;
+  readonly source: ArtifactSource;
+  readonly label?: string;
+  readonly metadata?: Record<string, unknown>;
+  readonly privacy: ArtifactPrivacy;
+  readonly size?: ArtifactSize;
+  readonly fingerprint?: ArtifactFingerprint;
+  readonly storage?: ArtifactStorageRef;
+  readonly lineage?: ArtifactLineage;
+}
+interface ArtifactLineage {
+  readonly parents: readonly ArtifactParentRef[];
+  readonly transform: ArtifactTransformDescriptor;
+}
+//#endregion
+//#region src/artifacts/artifact.d.ts
+type ArtifactKind = "text" | "json" | "file" | "image" | "audio" | "video" | "document" | "url" | "tool-result";
+type ProviderUploadArtifactSource = `provider-${"up"}${"load"}`;
+type ArtifactSource = "inline" | "file" | "url" | "generated" | ProviderUploadArtifactSource | "tool";
+type ArtifactPrivacy = NonNullable<PolicySpec["privacy"]>;
+interface ArtifactSize {
+  readonly bytes?: number;
+  readonly characters?: number;
+  readonly pages?: number;
+  readonly width?: number;
+  readonly height?: number;
+  readonly durationMs?: number;
+}
+interface ArtifactFingerprint {
+  readonly algorithm: "sha256";
+  readonly value: string;
+}
+interface ArtifactStorageRef {
+  readonly storeId: string;
+  readonly key: string;
+}
+interface ArtifactOptions {
+  readonly id?: string;
+  readonly mediaType?: string;
+  readonly label?: string;
+  readonly metadata?: Record<string, unknown>;
+  readonly privacy?: ArtifactPrivacy;
+  readonly size?: ArtifactSize;
+  readonly fingerprint?: ArtifactFingerprint;
+  readonly storage?: ArtifactStorageRef;
+  readonly lineage?: ArtifactLineage;
+}
+interface ArtifactToolResultOptions extends ArtifactOptions {
+  readonly toolName: string;
+  readonly callId?: string;
+}
+interface ArtifactDerivedOptions extends ArtifactOptions {
+  readonly kind: ArtifactKind;
+  readonly source?: ArtifactSource;
+  readonly value?: unknown;
+  readonly parents: readonly ArtifactRef[];
+  readonly transform: ArtifactTransformDescriptor;
+}
+interface ArtifactRef {
+  readonly id: string;
+  readonly kind: ArtifactKind;
+  readonly mediaType?: string;
+  readonly source: ArtifactSource;
+  readonly label?: string;
+  readonly metadata?: Record<string, unknown>;
+  readonly privacy: ArtifactPrivacy;
+  readonly size?: ArtifactSize;
+  readonly fingerprint?: ArtifactFingerprint;
+  readonly storage?: ArtifactStorageRef;
+  readonly lineage?: ArtifactLineage;
+}
+type ArtifactInput = ArtifactRef & {
+  readonly value?: unknown;
+};
+declare const artifact: {
+  text(value: string, options?: ArtifactOptions): ArtifactInput;
+  json(value: unknown, options?: ArtifactOptions): ArtifactInput;
+  file(value: Blob | File | string, options?: ArtifactOptions): ArtifactInput;
+  image(value: Blob | File | string, options?: ArtifactOptions): ArtifactInput;
+  audio(value: Blob | File | string, options?: ArtifactOptions): ArtifactInput;
+  document(value: Blob | File | string, options?: ArtifactOptions): ArtifactInput;
+  url(value: string | URL, options?: ArtifactOptions): ArtifactInput;
+  toolResult(value: unknown, options: ArtifactToolResultOptions): ArtifactInput;
+  derive(input: ArtifactDerivedOptions): ArtifactInput;
+};
+declare function toArtifactRef(input: ArtifactInput | ArtifactRef): ArtifactRef;
+declare function isArtifactRef(value: unknown): value is ArtifactRef;
+//#endregion
+export { mergePolicy as S, ArtifactTransformDescriptor as _, ArtifactOptions as a, GatewayPolicy as b, ArtifactSize as c, ArtifactToolResultOptions as d, artifact as f, ArtifactParentRef as g, ArtifactLineage as h, ArtifactKind as i, ArtifactSource as l, toArtifactRef as m, ArtifactFingerprint as n, ArtifactPrivacy as o, isArtifactRef as p, ArtifactInput as r, ArtifactRef as s, ArtifactDerivedOptions as t, ArtifactStorageRef as u, ArtifactTransformKind as v, PolicySpec as x, GatewayMetadataValue as y };
+//# sourceMappingURL=artifact-Bg6mJGnm.d.ts.map

package/dist/artifact-Bg6mJGnm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-Bg6mJGnm.d.ts","names":[],"sources":["../src/policy/policy.ts","../src/artifacts/lineage.ts","../src/artifacts/artifact.ts"],"mappings":"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"}

package/dist/artifact-DOfpeXLb.js

@@ -0,0 +1,140 @@
+import mime from "mime";
+//#region src/artifacts/metadata.ts
+const textEncoder = new TextEncoder();
+function inferMediaType(value, options) {
+	if (options.mediaType !== void 0) return options.mediaType;
+	if (isBlobLike(value) && value.type !== "") return value.type;
+	if (typeof value === "string") return mime.getType(value) ?? options.defaultMediaType;
+	return options.defaultMediaType;
+}
+function measureArtifactValue(value, kind) {
+	if (kind === "text" && typeof value === "string") return measureString(value);
+	if (kind === "json") {
+		const serialized = JSON.stringify(value);
+		return serialized === void 0 ? void 0 : measureString(serialized);
+	}
+	if (isBlobLike(value)) return { bytes: value.size };
+}
+function measureString(value) {
+	return {
+		characters: value.length,
+		bytes: textEncoder.encode(value).byteLength
+	};
+}
+function isBlobLike(value) {
+	return typeof Blob !== "undefined" && value instanceof Blob;
+}
+//#endregion
+//#region src/artifacts/artifact.ts
+const artifact = {
+	text(value, options = {}) {
+		return createArtifact("text", "inline", value, options, "text/plain");
+	},
+	json(value, options = {}) {
+		return createArtifact("json", "inline", value, options, "application/json");
+	},
+	file(value, options = {}) {
+		return createArtifact("file", "file", value, options);
+	},
+	image(value, options = {}) {
+		return createArtifact("image", "file", value, options);
+	},
+	audio(value, options = {}) {
+		return createArtifact("audio", "file", value, options);
+	},
+	document(value, options = {}) {
+		return createArtifact("document", "file", value, options);
+	},
+	url(value, options = {}) {
+		return createArtifact("url", "url", value.toString(), options);
+	},
+	toolResult(value, options) {
+		return createArtifact("tool-result", "tool", value, {
+			...options,
+			metadata: {
+				...options.metadata,
+				toolName: options.toolName,
+				...options.callId !== void 0 ? { callId: options.callId } : {}
+			}
+		}, "application/json");
+	},
+	derive(input) {
+		const { kind, source = "generated", value, parents, transform, ...options } = input;
+		return createArtifact(kind, source, value, {
+			...options,
+			lineage: {
+				parents: parents.map(toArtifactRef),
+				transform
+			}
+		}, defaultMediaTypeForKind(kind));
+	}
+};
+function toArtifactRef(input) {
+	return {
+		id: input.id,
+		kind: input.kind,
+		source: input.source,
+		privacy: input.privacy,
+		...input.mediaType !== void 0 ? { mediaType: input.mediaType } : {},
+		...input.label !== void 0 ? { label: input.label } : {},
+		...input.metadata !== void 0 ? { metadata: input.metadata } : {},
+		...input.size !== void 0 ? { size: input.size } : {},
+		...input.fingerprint !== void 0 ? { fingerprint: input.fingerprint } : {},
+		...input.storage !== void 0 ? { storage: input.storage } : {},
+		...input.lineage !== void 0 ? { lineage: input.lineage } : {}
+	};
+}
+function isArtifactRef(value) {
+	if (!isRecord(value)) return false;
+	return typeof value.id === "string" && isArtifactKind(value.kind) && isArtifactSource(value.source) && isArtifactPrivacy(value.privacy);
+}
+function createArtifact(kind, source, value, options, defaultMediaType) {
+	const mediaType = inferMediaType(value, {
+		kind,
+		...options.mediaType !== void 0 ? { mediaType: options.mediaType } : {},
+		...defaultMediaType !== void 0 ? { defaultMediaType } : {}
+	});
+	const size = options.size ?? measureArtifactValue(value, kind);
+	return {
+		id: options.id ?? createArtifactId(kind),
+		kind,
+		source,
+		value,
+		privacy: options.privacy ?? "standard",
+		...mediaType !== void 0 ? { mediaType } : {},
+		...options.label !== void 0 ? { label: options.label } : {},
+		...options.metadata !== void 0 ? { metadata: options.metadata } : {},
+		...size !== void 0 ? { size } : {},
+		...options.fingerprint !== void 0 ? { fingerprint: options.fingerprint } : {},
+		...options.storage !== void 0 ? { storage: options.storage } : {},
+		...options.lineage !== void 0 ? { lineage: options.lineage } : {}
+	};
+}
+function defaultMediaTypeForKind(kind) {
+	switch (kind) {
+		case "text": return "text/plain";
+		case "json":
+		case "tool-result": return "application/json";
+		default: return;
+	}
+}
+function isArtifactKind(value) {
+	return value === "text" || value === "json" || value === "file" || value === "image" || value === "audio" || value === "video" || value === "document" || value === "url" || value === "tool-result";
+}
+function isArtifactSource(value) {
+	return value === "inline" || value === "file" || value === "url" || value === "generated" || value === `provider-upload` || value === "tool";
+}
+function isArtifactPrivacy(value) {
+	return value === "standard" || value === "sensitive" || value === "restricted";
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null;
+}
+function createArtifactId(kind) {
+	if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") return `artifact:${kind}:${crypto.randomUUID()}`;
+	return `artifact:${kind}:${Date.now()}:${Math.random().toString(16).slice(2)}`;
+}
+//#endregion
+export { isArtifactRef as n, toArtifactRef as r, artifact as t };
+
+//# sourceMappingURL=artifact-DOfpeXLb.js.map

package/dist/artifact-DOfpeXLb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-DOfpeXLb.js","names":[],"sources":["../src/artifacts/metadata.ts","../src/artifacts/artifact.ts"],"sourcesContent":["import mime from \"mime\";\n\nimport type { ArtifactKind, ArtifactOptions, ArtifactSize } from \"./artifact.js\";\n\nexport interface InferMediaTypeOptions\n  extends Pick<ArtifactOptions, \"mediaType\"> {\n  readonly kind: ArtifactKind;\n  readonly defaultMediaType?: string;\n}\n\nconst textEncoder = new TextEncoder();\n\nexport function inferMediaType(\n  value: unknown,\n  options: InferMediaTypeOptions,\n): string | undefined {\n  if (options.mediaType !== undefined) {\n    return options.mediaType;\n  }\n\n  if (isBlobLike(value) && value.type !== \"\") {\n    return value.type;\n  }\n\n  if (typeof value === \"string\") {\n    return mime.getType(value) ?? options.defaultMediaType;\n  }\n\n  return options.defaultMediaType;\n}\n\nexport function measureArtifactValue(\n  value: unknown,\n  kind: ArtifactKind,\n): ArtifactSize | undefined {\n  if (kind === \"text\" && typeof value === \"string\") {\n    return measureString(value);\n  }\n\n  if (kind === \"json\") {\n    const serialized = JSON.stringify(value);\n\n    return serialized === undefined ? undefined : measureString(serialized);\n  }\n\n  if (isBlobLike(value)) {\n    return {\n      bytes: value.size,\n    };\n  }\n\n  return undefined;\n}\n\nfunction measureString(value: string): ArtifactSize {\n  return {\n    characters: value.length,\n    bytes: textEncoder.encode(value).byteLength,\n  };\n}\n\nfunction isBlobLike(value: unknown): value is Blob {\n  return typeof Blob !== \"undefined\" && value instanceof Blob;\n}\n","import type { PolicySpec } from \"../policy/policy.js\";\nimport type {\n  ArtifactLineage,\n  ArtifactTransformDescriptor,\n} from \"./lineage.js\";\nimport { inferMediaType, measureArtifactValue } from \"./metadata.js\";\n\nexport type ArtifactKind =\n  | \"text\"\n  | \"json\"\n  | \"file\"\n  | \"image\"\n  | \"audio\"\n  | \"video\"\n  | \"document\"\n  | \"url\"\n  | \"tool-result\";\n\ntype ProviderUploadArtifactSource = `provider-${\"up\"}${\"load\"}`;\n\nexport type ArtifactSource =\n  | \"inline\"\n  | \"file\"\n  | \"url\"\n  | \"generated\"\n  | ProviderUploadArtifactSource\n  | \"tool\";\n\nexport type ArtifactPrivacy = NonNullable<PolicySpec[\"privacy\"]>;\n\nexport interface ArtifactSize {\n  readonly bytes?: number;\n  readonly characters?: number;\n  readonly pages?: number;\n  readonly width?: number;\n  readonly height?: number;\n  readonly durationMs?: number;\n}\n\nexport interface ArtifactFingerprint {\n  readonly algorithm: \"sha256\";\n  readonly value: string;\n}\n\nexport interface ArtifactStorageRef {\n  readonly storeId: string;\n  readonly key: string;\n}\n\nexport interface ArtifactOptions {\n  readonly id?: string;\n  readonly mediaType?: string;\n  readonly label?: string;\n  readonly metadata?: Record<string, unknown>;\n  readonly privacy?: ArtifactPrivacy;\n  readonly size?: ArtifactSize;\n  readonly fingerprint?: ArtifactFingerprint;\n  readonly storage?: ArtifactStorageRef;\n  readonly lineage?: ArtifactLineage;\n}\n\nexport interface ArtifactToolResultOptions extends ArtifactOptions {\n  readonly toolName: string;\n  readonly callId?: string;\n}\n\nexport interface ArtifactDerivedOptions extends ArtifactOptions {\n  readonly kind: ArtifactKind;\n  readonly source?: ArtifactSource;\n  readonly value?: unknown;\n  readonly parents: readonly ArtifactRef[];\n  readonly transform: ArtifactTransformDescriptor;\n}\n\nexport interface ArtifactRef {\n  readonly id: string;\n  readonly kind: ArtifactKind;\n  readonly mediaType?: string;\n  readonly source: ArtifactSource;\n  readonly label?: string;\n  readonly metadata?: Record<string, unknown>;\n  readonly privacy: ArtifactPrivacy;\n  readonly size?: ArtifactSize;\n  readonly fingerprint?: ArtifactFingerprint;\n  readonly storage?: ArtifactStorageRef;\n  readonly lineage?: ArtifactLineage;\n}\n\nexport type ArtifactInput = ArtifactRef & {\n  readonly value?: unknown;\n};\n\nexport const artifact = {\n  text(value: string, options: ArtifactOptions = {}): ArtifactInput {\n    return createArtifact(\"text\", \"inline\", value, options, \"text/plain\");\n  },\n\n  json(value: unknown, options: ArtifactOptions = {}): ArtifactInput {\n    return createArtifact(\"json\", \"inline\", value, options, \"application/json\");\n  },\n\n  file(value: Blob | File | string, options: ArtifactOptions = {}): ArtifactInput {\n    return createArtifact(\"file\", \"file\", value, options);\n  },\n\n  image(value: Blob | File | string, options: ArtifactOptions = {}): ArtifactInput {\n    return createArtifact(\"image\", \"file\", value, options);\n  },\n\n  audio(value: Blob | File | string, options: ArtifactOptions = {}): ArtifactInput {\n    return createArtifact(\"audio\", \"file\", value, options);\n  },\n\n  document(value: Blob | File | string, options: ArtifactOptions = {}): ArtifactInput {\n    return createArtifact(\"document\", \"file\", value, options);\n  },\n\n  url(value: string | URL, options: ArtifactOptions = {}): ArtifactInput {\n    return createArtifact(\"url\", \"url\", value.toString(), options);\n  },\n\n  toolResult(value: unknown, options: ArtifactToolResultOptions): ArtifactInput {\n    return createArtifact(\n      \"tool-result\",\n      \"tool\",\n      value,\n      {\n        ...options,\n        metadata: {\n          ...options.metadata,\n          toolName: options.toolName,\n          ...(options.callId !== undefined ? { callId: options.callId } : {}),\n        },\n      },\n      \"application/json\",\n    );\n  },\n\n  derive(input: ArtifactDerivedOptions): ArtifactInput {\n    const {\n      kind,\n      source = \"generated\",\n      value,\n      parents,\n      transform,\n      ...options\n    } = input;\n\n    return createArtifact(kind, source, value, {\n      ...options,\n      lineage: {\n        parents: parents.map(toArtifactRef),\n        transform,\n      },\n    }, defaultMediaTypeForKind(kind));\n  },\n};\n\nexport function toArtifactRef(input: ArtifactInput | ArtifactRef): ArtifactRef {\n  return {\n    id: input.id,\n    kind: input.kind,\n    source: input.source,\n    privacy: input.privacy,\n    ...(input.mediaType !== undefined ? { mediaType: input.mediaType } : {}),\n    ...(input.label !== undefined ? { label: input.label } : {}),\n    ...(input.metadata !== undefined ? { metadata: input.metadata } : {}),\n    ...(input.size !== undefined ? { size: input.size } : {}),\n    ...(input.fingerprint !== undefined ? { fingerprint: input.fingerprint } : {}),\n    ...(input.storage !== undefined ? { storage: input.storage } : {}),\n    ...(input.lineage !== undefined ? { lineage: input.lineage } : {}),\n  };\n}\n\nexport function isArtifactRef(value: unknown): value is ArtifactRef {\n  if (!isRecord(value)) {\n    return false;\n  }\n\n  return (\n    typeof value.id === \"string\" &&\n    isArtifactKind(value.kind) &&\n    isArtifactSource(value.source) &&\n    isArtifactPrivacy(value.privacy)\n  );\n}\n\nfunction createArtifact(\n  kind: ArtifactKind,\n  source: ArtifactSource,\n  value: unknown,\n  options: ArtifactOptions,\n  defaultMediaType?: string,\n): ArtifactInput {\n  const mediaType = inferMediaType(value, {\n    kind,\n    ...(options.mediaType !== undefined ? { mediaType: options.mediaType } : {}),\n    ...(defaultMediaType !== undefined ? { defaultMediaType } : {}),\n  });\n  const size = options.size ?? measureArtifactValue(value, kind);\n\n  return {\n    id: options.id ?? createArtifactId(kind),\n    kind,\n    source,\n    value,\n    privacy: options.privacy ?? \"standard\",\n    ...(mediaType !== undefined ? { mediaType } : {}),\n    ...(options.label !== undefined ? { label: options.label } : {}),\n    ...(options.metadata !== undefined ? { metadata: options.metadata } : {}),\n    ...(size !== undefined ? { size } : {}),\n    ...(options.fingerprint !== undefined ? { fingerprint: options.fingerprint } : {}),\n    ...(options.storage !== undefined ? { storage: options.storage } : {}),\n    ...(options.lineage !== undefined ? { lineage: options.lineage } : {}),\n  };\n}\n\nfunction defaultMediaTypeForKind(kind: ArtifactKind): string | undefined {\n  switch (kind) {\n    case \"text\":\n      return \"text/plain\";\n    case \"json\":\n    case \"tool-result\":\n      return \"application/json\";\n    default:\n      return undefined;\n  }\n}\n\nfunction isArtifactKind(value: unknown): value is ArtifactKind {\n  return (\n    value === \"text\" ||\n    value === \"json\" ||\n    value === \"file\" ||\n    value === \"image\" ||\n    value === \"audio\" ||\n    value === \"video\" ||\n    value === \"document\" ||\n    value === \"url\" ||\n    value === \"tool-result\"\n  );\n}\n\nfunction isArtifactSource(value: unknown): value is ArtifactSource {\n  return (\n    value === \"inline\" ||\n    value === \"file\" ||\n    value === \"url\" ||\n    value === \"generated\" ||\n    value === `provider-${\"up\"}${\"load\"}` ||\n    value === \"tool\"\n  );\n}\n\nfunction isArtifactPrivacy(value: unknown): value is ArtifactPrivacy {\n  return value === \"standard\" || value === \"sensitive\" || value === \"restricted\";\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction createArtifactId(kind: ArtifactKind): string {\n  if (typeof crypto !== \"undefined\" && typeof crypto.randomUUID === \"function\") {\n    return `artifact:${kind}:${crypto.randomUUID()}`;\n  }\n\n  return `artifact:${kind}:${Date.now()}:${Math.random().toString(16).slice(2)}`;\n}\n"],"mappings":"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"}

package/dist/artifacts.d.ts

@@ -0,0 +1,2 @@
+import { _ as ArtifactTransformDescriptor, a as ArtifactOptions, c as ArtifactSize, d as ArtifactToolResultOptions, f as artifact, g as ArtifactParentRef, h as ArtifactLineage, i as ArtifactKind, l as ArtifactSource, m as toArtifactRef, n as ArtifactFingerprint, o as ArtifactPrivacy, p as isArtifactRef, r as ArtifactInput, s as ArtifactRef, t as ArtifactDerivedOptions, u as ArtifactStorageRef, v as ArtifactTransformKind } from "./artifact-Bg6mJGnm.js";
+export { type ArtifactDerivedOptions, type ArtifactFingerprint, type ArtifactInput, type ArtifactKind, type ArtifactLineage, type ArtifactOptions, type ArtifactParentRef, type ArtifactPrivacy, type ArtifactRef, type ArtifactSize, type ArtifactSource, type ArtifactStorageRef, type ArtifactToolResultOptions, type ArtifactTransformDescriptor, type ArtifactTransformKind, artifact, isArtifactRef, toArtifactRef };

package/dist/artifacts.js

@@ -0,0 +1,2 @@
+import { n as isArtifactRef, r as toArtifactRef, t as artifact } from "./artifact-DOfpeXLb.js";
+export { artifact, isArtifactRef, toArtifactRef };

package/dist/audit.d.ts

@@ -0,0 +1,3 @@
+import { _ as VerifyFail, a as KeyEntry, c as ReceiptEnvelope, d as ReceiptRoute, f as ReceiptSignature, g as VerifyErrorKind, h as VerifyError, i as ContractVerdict, l as ReceiptModel, m as ReceiptUsageCanonical, o as KeySet, p as ReceiptSigner, r as CapabilityReceiptBody, s as KeyState, u as ReceiptRedaction, v as VerifyOk, y as VerifyResult } from "./infer-DLqp5QIM.js";
+import { A as RemoteReceiptSignerProvider, B as ReplayEnvelope, C as GeneratedEd25519KeyPair, D as RemoteReceiptSignRequest, E as RemoteReceiptPayloadFormat, F as ExternalExecutionMetadata, G as replayOffline, H as redactArtifactRef, I as ExternalExecutionSidecar, K as rerunLive, L as ExternalExecutionSidecarOutputSpec, M as createMemoryKeySet, N as ExternalExecutionAuditInput, O as RemoteReceiptSignResult, P as ExternalExecutionAuditResult, R as ExternalExecutionUsage, S as verifyReceipt, T as generateEd25519KeyPairJwk, U as redactPlan, V as createReplayEnvelope, W as redactReplayEnvelope, X as CreateReceiptInput, Z as createReceipt, _ as ArtifactLoader, b as materializeReplayEnvelope, j as createRemoteReceiptSigner, k as RemoteReceiptSignerOptions, n as OtelAttributeValue, p as createOtelReceiptAttributes, r as OtelAttributes, v as MaterializationError, w as createInMemorySigner, x as receiptCid, y as MaterializeReplayEnvelopeOptions, z as createExternalExecutionAudit } from "./otel-BgM4e55_.js";
+export { type ArtifactLoader, type CapabilityReceiptBody, type ContractVerdict, type CreateReceiptInput, type ExternalExecutionAuditInput, type ExternalExecutionAuditResult, type ExternalExecutionMetadata, type ExternalExecutionSidecar, type ExternalExecutionSidecarOutputSpec, type ExternalExecutionUsage, type GeneratedEd25519KeyPair, type KeyEntry, type KeySet, type KeyState, type MaterializationError, type MaterializeReplayEnvelopeOptions, type OtelAttributeValue, type OtelAttributes, type ReceiptEnvelope, type ReceiptModel, type ReceiptRedaction, type ReceiptRoute, type ReceiptSignature, type ReceiptSigner, type ReceiptUsageCanonical, type RemoteReceiptPayloadFormat, type RemoteReceiptSignRequest, type RemoteReceiptSignResult, type RemoteReceiptSignerOptions, type RemoteReceiptSignerProvider, type ReplayEnvelope, type VerifyError, type VerifyErrorKind, type VerifyFail, type VerifyOk, type VerifyResult, createExternalExecutionAudit, createInMemorySigner, createMemoryKeySet, createOtelReceiptAttributes, createReceipt, createRemoteReceiptSigner, createReplayEnvelope, generateEd25519KeyPairJwk, materializeReplayEnvelope, receiptCid, redactArtifactRef, redactPlan, redactReplayEnvelope, replayOffline, rerunLive, verifyReceipt };

package/dist/audit.js

@@ -0,0 +1,4 @@
+import { t as createReceipt } from "./receipt-FYouoPHv.js";
+import { n as receiptCid } from "./lineage-DBgoPWAZ.js";
+import { a as replayOffline, c as createExternalExecutionAudit, d as createInMemorySigner, f as generateEd25519KeyPairJwk, g as createOtelReceiptAttributes, i as redactReplayEnvelope, m as createMemoryKeySet, n as redactArtifactRef, o as rerunLive, p as createRemoteReceiptSigner, r as redactPlan, s as materializeReplayEnvelope, t as createReplayEnvelope, u as verifyReceipt } from "./replay-CtIhpLek.js";
+export { createExternalExecutionAudit, createInMemorySigner, createMemoryKeySet, createOtelReceiptAttributes, createReceipt, createRemoteReceiptSigner, createReplayEnvelope, generateEd25519KeyPairJwk, materializeReplayEnvelope, receiptCid, redactArtifactRef, redactPlan, redactReplayEnvelope, replayOffline, rerunLive, verifyReceipt };

package/dist/catalog-CAfYwB_-.js

@@ -0,0 +1,91 @@
+//#region src/routing/catalog.ts
+const DEFAULT_CATALOG_VERSION = "lattice:catalog:v1";
+function createCapabilityCatalog(providers) {
+	return {
+		version: DEFAULT_CATALOG_VERSION,
+		models: providers.flatMap((provider) => {
+			if (provider.kind === "provider-adapter" && provider.capabilities !== void 0) return provider.capabilities;
+			return [defaultCapabilityForProvider(provider.id)];
+		})
+	};
+}
+function defaultCapabilityForProvider(providerId) {
+	return {
+		providerId,
+		modelId: `${providerId}:default`,
+		inputModalities: [
+			"text",
+			"json",
+			"image",
+			"audio",
+			"document",
+			"file",
+			"url",
+			"tool"
+		],
+		outputModalities: ["text", "json"],
+		fileTransport: [
+			"inline",
+			"json",
+			"url",
+			"base64",
+			"extracted-text",
+			"transcript"
+		],
+		contextWindow: 16e3,
+		structuredOutput: true,
+		toolUse: false,
+		streaming: false,
+		pricing: {
+			inputCostPer1M: 0,
+			outputCostPer1M: 0,
+			inputPer1kTokens: 0,
+			outputPer1kTokens: 0
+		},
+		latency: "interactive",
+		dataPolicy: {
+			privacy: ["standard", "sensitive"],
+			uploadRetention: "none",
+			supportsNoLogging: true,
+			supportsNoTraining: true
+		},
+		available: true
+	};
+}
+/**
+* Resolve the effective per-1k token pricing for a capability.
+*
+* Prefers the explicit `inputPer1kTokens` / `outputPer1kTokens` fields and
+* falls back to dividing the legacy per-1M fields by 1000 when only those
+* are present. Returns `undefined` per side when neither shape supplies a
+* value, so callers can distinguish "free / zero" (`0`) from "unknown"
+* (`undefined`) — Phase 7 cost normalization treats unknown pricing as
+* `usage.costUsd === null`, not `0`.
+*/
+function effectivePer1kPricing(pricing) {
+	if (pricing === void 0) return {
+		inputPer1kTokens: void 0,
+		outputPer1kTokens: void 0
+	};
+	return {
+		inputPer1kTokens: pricing.inputPer1kTokens ?? (pricing.inputCostPer1M !== void 0 ? pricing.inputCostPer1M / 1e3 : void 0),
+		outputPer1kTokens: pricing.outputPer1kTokens ?? (pricing.outputCostPer1M !== void 0 ? pricing.outputCostPer1M / 1e3 : void 0)
+	};
+}
+function modalRank(modality) {
+	return {
+		text: 0,
+		json: 1,
+		image: 2,
+		audio: 3,
+		document: 4,
+		file: 5,
+		url: 6,
+		video: 7,
+		tool: 8
+	}[modality];
+}
+//#endregion
+export { modalRank as a, effectivePer1kPricing as i, createCapabilityCatalog as n, defaultCapabilityForProvider as r, DEFAULT_CATALOG_VERSION as t };
+
+//# sourceMappingURL=catalog-CAfYwB_-.js.map

package/dist/catalog-CAfYwB_-.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-CAfYwB_-.js","names":[],"sources":["../src/routing/catalog.ts"],"sourcesContent":["import type {\n  CapabilityModality,\n  ModelCapability,\n  ProviderAdapter,\n  ProviderPricingHint,\n  ProviderRef,\n} from \"../providers/provider.js\";\n\nexport const DEFAULT_CATALOG_VERSION = \"lattice:catalog:v1\";\n\nexport interface CapabilityCatalog {\n  readonly version: string;\n  readonly models: readonly ModelCapability[];\n}\n\nexport function createCapabilityCatalog(\n  providers: readonly (ProviderRef | ProviderAdapter)[],\n): CapabilityCatalog {\n  return {\n    version: DEFAULT_CATALOG_VERSION,\n    models: providers.flatMap((provider) => {\n      if (provider.kind === \"provider-adapter\" && provider.capabilities !== undefined) {\n        return provider.capabilities;\n      }\n\n      return [defaultCapabilityForProvider(provider.id)];\n    }),\n  };\n}\n\nexport function defaultCapabilityForProvider(providerId: string): ModelCapability {\n  return {\n    providerId,\n    modelId: `${providerId}:default`,\n    inputModalities: [\"text\", \"json\", \"image\", \"audio\", \"document\", \"file\", \"url\", \"tool\"],\n    outputModalities: [\"text\", \"json\"],\n    fileTransport: [\"inline\", \"json\", \"url\", \"base64\", \"extracted-text\", \"transcript\"],\n    contextWindow: 16_000,\n    structuredOutput: true,\n    toolUse: false,\n    streaming: false,\n    pricing: {\n      inputCostPer1M: 0,\n      outputCostPer1M: 0,\n      inputPer1kTokens: 0,\n      outputPer1kTokens: 0,\n    },\n    latency: \"interactive\",\n    dataPolicy: {\n      privacy: [\"standard\", \"sensitive\"],\n      uploadRetention: \"none\",\n      supportsNoLogging: true,\n      supportsNoTraining: true,\n    },\n    available: true,\n  };\n}\n\n/**\n * Resolve the effective per-1k token pricing for a capability.\n *\n * Prefers the explicit `inputPer1kTokens` / `outputPer1kTokens` fields and\n * falls back to dividing the legacy per-1M fields by 1000 when only those\n * are present. Returns `undefined` per side when neither shape supplies a\n * value, so callers can distinguish \"free / zero\" (`0`) from \"unknown\"\n * (`undefined`) — Phase 7 cost normalization treats unknown pricing as\n * `usage.costUsd === null`, not `0`.\n */\nexport function effectivePer1kPricing(\n  pricing: ProviderPricingHint | undefined,\n): {\n  readonly inputPer1kTokens: number | undefined;\n  readonly outputPer1kTokens: number | undefined;\n} {\n  if (pricing === undefined) {\n    return { inputPer1kTokens: undefined, outputPer1kTokens: undefined };\n  }\n\n  const inputPer1k =\n    pricing.inputPer1kTokens ??\n    (pricing.inputCostPer1M !== undefined ? pricing.inputCostPer1M / 1000 : undefined);\n  const outputPer1k =\n    pricing.outputPer1kTokens ??\n    (pricing.outputCostPer1M !== undefined ? pricing.outputCostPer1M / 1000 : undefined);\n\n  return {\n    inputPer1kTokens: inputPer1k,\n    outputPer1kTokens: outputPer1k,\n  };\n}\n\nexport function modalRank(modality: CapabilityModality): number {\n  const ranks: Record<CapabilityModality, number> = {\n    text: 0,\n    json: 1,\n    image: 2,\n    audio: 3,\n    document: 4,\n    file: 5,\n    url: 6,\n    video: 7,\n    tool: 8,\n  };\n\n  return ranks[modality];\n}\n"],"mappings":";AAQA,MAAa,0BAA0B;AAOvC,SAAgB,wBACd,WACmB;AACnB,QAAO;EACL,SAAS;EACT,QAAQ,UAAU,SAAS,aAAa;AACtC,OAAI,SAAS,SAAS,sBAAsB,SAAS,iBAAiB,KAAA,EACpE,QAAO,SAAS;AAGlB,UAAO,CAAC,6BAA6B,SAAS,GAAG,CAAC;IAClD;EACH;;AAGH,SAAgB,6BAA6B,YAAqC;AAChF,QAAO;EACL;EACA,SAAS,GAAG,WAAW;EACvB,iBAAiB;GAAC;GAAQ;GAAQ;GAAS;GAAS;GAAY;GAAQ;GAAO;GAAO;EACtF,kBAAkB,CAAC,QAAQ,OAAO;EAClC,eAAe;GAAC;GAAU;GAAQ;GAAO;GAAU;GAAkB;GAAa;EAClF,eAAe;EACf,kBAAkB;EAClB,SAAS;EACT,WAAW;EACX,SAAS;GACP,gBAAgB;GAChB,iBAAiB;GACjB,kBAAkB;GAClB,mBAAmB;GACpB;EACD,SAAS;EACT,YAAY;GACV,SAAS,CAAC,YAAY,YAAY;GAClC,iBAAiB;GACjB,mBAAmB;GACnB,oBAAoB;GACrB;EACD,WAAW;EACZ;;;;;;;;;;;;AAaH,SAAgB,sBACd,SAIA;AACA,KAAI,YAAY,KAAA,EACd,QAAO;EAAE,kBAAkB,KAAA;EAAW,mBAAmB,KAAA;EAAW;AAUtE,QAAO;EACL,kBAPA,QAAQ,qBACP,QAAQ,mBAAmB,KAAA,IAAY,QAAQ,iBAAiB,MAAO,KAAA;EAOxE,mBALA,QAAQ,sBACP,QAAQ,oBAAoB,KAAA,IAAY,QAAQ,kBAAkB,MAAO,KAAA;EAK3E;;AAGH,SAAgB,UAAU,UAAsC;AAa9D,QAZkD;EAChD,MAAM;EACN,MAAM;EACN,OAAO;EACP,OAAO;EACP,UAAU;EACV,MAAM;EACN,KAAK;EACL,OAAO;EACP,MAAM;EACP,CAEY"}