@full-self-browsing/lattice 1.4.0 → 1.5.0

package/dist/context-pack-Bz3GXmjv.js

@@ -0,0 +1,99 @@
+import { r as toArtifactRef } from "./artifact-DOfpeXLb.js";
+//#region src/context/context-pack.ts
+function buildContextPack(input) {
+	const routeBudget = input.route?.estimates.inputTokens ?? input.route?.inputModalities.length ?? 0;
+	const tokenBudget = input.tokenBudget ?? Math.max(512, Math.min(input.route?.estimates.inputTokens ?? 4e3, 16e3));
+	const remainingBudget = Math.max(512, tokenBudget - estimateTokens(input.task) - routeBudget);
+	const included = [];
+	const summarized = [];
+	const archived = [];
+	const omitted = [];
+	const warnings = [];
+	let usedTokens = 0;
+	for (const artifact of input.artifacts) {
+		const artifactTokens = estimateArtifactTokens(artifact);
+		const item = {
+			artifactId: artifact.id,
+			reason: "Run artifact included for provider consideration.",
+			estimatedTokens: artifactTokens,
+			trust: trustForArtifact(artifact)
+		};
+		if (usedTokens + artifactTokens <= remainingBudget) {
+			included.push(item);
+			usedTokens += artifactTokens;
+			continue;
+		}
+		if (artifact.kind === "text" || artifact.kind === "document" || artifact.kind === "json") {
+			summarized.push({
+				...item,
+				reason: "Artifact exceeded live context budget and needs summary packaging."
+			});
+			usedTokens += Math.min(artifactTokens, 256);
+			continue;
+		}
+		omitted.push({
+			...item,
+			reason: "Artifact exceeded context budget and cannot be summarized by the default packer."
+		});
+		warnings.push(`Artifact ${artifact.id} omitted from live context budget.`);
+	}
+	for (const turn of input.session?.turns ?? []) {
+		const turnTokens = estimateTokens(turn.task);
+		const item = {
+			sessionTurnId: turn.id,
+			reason: "Prior session turn retained for continuity.",
+			estimatedTokens: turnTokens,
+			trust: "user"
+		};
+		if (usedTokens + turnTokens <= remainingBudget) {
+			included.push(item);
+			usedTokens += turnTokens;
+		} else archived.push({
+			...item,
+			reason: "Prior session turn archived because the run budget was exhausted."
+		});
+	}
+	return {
+		id: createContextPackId(),
+		kind: "context-pack",
+		tokenBudget,
+		estimatedTokens: usedTokens,
+		included,
+		summarized,
+		archived,
+		omitted,
+		warnings
+	};
+}
+function estimateArtifactTokens(artifact) {
+	if (artifact.size?.characters !== void 0) return estimateTokensFromCharacters(artifact.size.characters);
+	if (artifact.size?.bytes !== void 0) return estimateTokensFromCharacters(Math.ceil(artifact.size.bytes / 2));
+	if ("value" in artifact && typeof artifact.value === "string") return estimateTokens(artifact.value);
+	if ("value" in artifact && artifact.value !== void 0) {
+		const serialized = JSON.stringify(artifact.value);
+		return serialized === void 0 ? 64 : estimateTokens(serialized);
+	}
+	return 64;
+}
+function estimateTokens(value) {
+	return Math.max(1, estimateTokensFromCharacters(value.length));
+}
+function toContextArtifactRefs(artifacts) {
+	return artifacts.map(toArtifactRef);
+}
+function estimateTokensFromCharacters(characters) {
+	return Math.ceil(characters / 4);
+}
+function trustForArtifact(artifact) {
+	if (artifact.source === "tool") return "tool";
+	if (artifact.source === "generated") return "model-summary";
+	return "user";
+}
+function createContextPackId() {
+	if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") return `context-pack:${crypto.randomUUID()}`;
+	return `context-pack:${Date.now()}:${Math.random().toString(16).slice(2)}`;
+}
+//#endregion
+export { toContextArtifactRefs as i, estimateArtifactTokens as n, estimateTokens as r, buildContextPack as t };
+
+//# sourceMappingURL=context-pack-Bz3GXmjv.js.map

package/dist/context-pack-Bz3GXmjv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-pack-Bz3GXmjv.js","names":[],"sources":["../src/context/context-pack.ts"],"sourcesContent":["import type { ArtifactInput, ArtifactRef } from \"../artifacts/artifact.js\";\nimport { toArtifactRef } from \"../artifacts/artifact.js\";\nimport type {\n  ContextPackItemPlan,\n  ContextPackPlan,\n  SelectedRoute,\n} from \"../plan/plan.js\";\nimport type { SessionRecord } from \"../sessions/session.js\";\n\nexport type TrustLabel = \"developer\" | \"user\" | \"tool\" | \"model-summary\";\n\nexport interface ContextPack extends ContextPackPlan {\n  readonly kind: \"context-pack\";\n}\n\nexport interface BuildContextPackInput {\n  readonly task: string;\n  readonly artifacts: readonly ArtifactInput[];\n  readonly route?: SelectedRoute;\n  readonly session?: SessionRecord;\n  readonly tokenBudget?: number;\n}\n\nexport interface ContextSummarizer {\n  summarize(input: {\n    readonly artifacts: readonly ArtifactRef[];\n    readonly budgetTokens: number;\n  }): Promise<readonly ArtifactRef[]> | readonly ArtifactRef[];\n}\n\nexport function buildContextPack(input: BuildContextPackInput): ContextPack {\n  const routeBudget =\n    input.route?.estimates.inputTokens ?? input.route?.inputModalities.length ?? 0;\n  const tokenBudget =\n    input.tokenBudget ?? Math.max(512, Math.min(input.route?.estimates.inputTokens ?? 4_000, 16_000));\n  const remainingBudget = Math.max(512, tokenBudget - estimateTokens(input.task) - routeBudget);\n  const included: ContextPackItemPlan[] = [];\n  const summarized: ContextPackItemPlan[] = [];\n  const archived: ContextPackItemPlan[] = [];\n  const omitted: ContextPackItemPlan[] = [];\n  const warnings: string[] = [];\n  let usedTokens = 0;\n\n  for (const artifact of input.artifacts) {\n    const artifactTokens = estimateArtifactTokens(artifact);\n    const item: ContextPackItemPlan = {\n      artifactId: artifact.id,\n      reason: \"Run artifact included for provider consideration.\",\n      estimatedTokens: artifactTokens,\n      trust: trustForArtifact(artifact),\n    };\n\n    if (usedTokens + artifactTokens <= remainingBudget) {\n      included.push(item);\n      usedTokens += artifactTokens;\n      continue;\n    }\n\n    if (artifact.kind === \"text\" || artifact.kind === \"document\" || artifact.kind === \"json\") {\n      summarized.push({\n        ...item,\n        reason: \"Artifact exceeded live context budget and needs summary packaging.\",\n      });\n      usedTokens += Math.min(artifactTokens, 256);\n      continue;\n    }\n\n    omitted.push({\n      ...item,\n      reason: \"Artifact exceeded context budget and cannot be summarized by the default packer.\",\n    });\n    warnings.push(`Artifact ${artifact.id} omitted from live context budget.`);\n  }\n\n  for (const turn of input.session?.turns ?? []) {\n    const turnTokens = estimateTokens(turn.task);\n    const item: ContextPackItemPlan = {\n      sessionTurnId: turn.id,\n      reason: \"Prior session turn retained for continuity.\",\n      estimatedTokens: turnTokens,\n      trust: \"user\",\n    };\n\n    if (usedTokens + turnTokens <= remainingBudget) {\n      included.push(item);\n      usedTokens += turnTokens;\n    } else {\n      archived.push({\n        ...item,\n        reason: \"Prior session turn archived because the run budget was exhausted.\",\n      });\n    }\n  }\n\n  return {\n    id: createContextPackId(),\n    kind: \"context-pack\",\n    tokenBudget,\n    estimatedTokens: usedTokens,\n    included,\n    summarized,\n    archived,\n    omitted,\n    warnings,\n  };\n}\n\nexport function estimateArtifactTokens(artifact: ArtifactInput | ArtifactRef): number {\n  if (artifact.size?.characters !== undefined) {\n    return estimateTokensFromCharacters(artifact.size.characters);\n  }\n\n  if (artifact.size?.bytes !== undefined) {\n    return estimateTokensFromCharacters(Math.ceil(artifact.size.bytes / 2));\n  }\n\n  if (\"value\" in artifact && typeof artifact.value === \"string\") {\n    return estimateTokens(artifact.value);\n  }\n\n  if (\"value\" in artifact && artifact.value !== undefined) {\n    const serialized = JSON.stringify(artifact.value);\n\n    return serialized === undefined ? 64 : estimateTokens(serialized);\n  }\n\n  return 64;\n}\n\nexport function estimateTokens(value: string): number {\n  return Math.max(1, estimateTokensFromCharacters(value.length));\n}\n\nexport function toContextArtifactRefs(\n  artifacts: readonly ArtifactInput[],\n): readonly ArtifactRef[] {\n  return artifacts.map(toArtifactRef);\n}\n\nfunction estimateTokensFromCharacters(characters: number): number {\n  return Math.ceil(characters / 4);\n}\n\nfunction trustForArtifact(artifact: ArtifactRef): TrustLabel {\n  if (artifact.source === \"tool\") {\n    return \"tool\";\n  }\n\n  if (artifact.source === \"generated\") {\n    return \"model-summary\";\n  }\n\n  return \"user\";\n}\n\nfunction createContextPackId(): string {\n  if (typeof crypto !== \"undefined\" && typeof crypto.randomUUID === \"function\") {\n    return `context-pack:${crypto.randomUUID()}`;\n  }\n\n  return `context-pack:${Date.now()}:${Math.random().toString(16).slice(2)}`;\n}\n"],"mappings":";;AA8BA,SAAgB,iBAAiB,OAA2C;CAC1E,MAAM,cACJ,MAAM,OAAO,UAAU,eAAe,MAAM,OAAO,gBAAgB,UAAU;CAC/E,MAAM,cACJ,MAAM,eAAe,KAAK,IAAI,KAAK,KAAK,IAAI,MAAM,OAAO,UAAU,eAAe,KAAO,KAAO,CAAC;CACnG,MAAM,kBAAkB,KAAK,IAAI,KAAK,cAAc,eAAe,MAAM,KAAK,GAAG,YAAY;CAC7F,MAAM,WAAkC,EAAE;CAC1C,MAAM,aAAoC,EAAE;CAC5C,MAAM,WAAkC,EAAE;CAC1C,MAAM,UAAiC,EAAE;CACzC,MAAM,WAAqB,EAAE;CAC7B,IAAI,aAAa;AAEjB,MAAK,MAAM,YAAY,MAAM,WAAW;EACtC,MAAM,iBAAiB,uBAAuB,SAAS;EACvD,MAAM,OAA4B;GAChC,YAAY,SAAS;GACrB,QAAQ;GACR,iBAAiB;GACjB,OAAO,iBAAiB,SAAS;GAClC;AAED,MAAI,aAAa,kBAAkB,iBAAiB;AAClD,YAAS,KAAK,KAAK;AACnB,iBAAc;AACd;;AAGF,MAAI,SAAS,SAAS,UAAU,SAAS,SAAS,cAAc,SAAS,SAAS,QAAQ;AACxF,cAAW,KAAK;IACd,GAAG;IACH,QAAQ;IACT,CAAC;AACF,iBAAc,KAAK,IAAI,gBAAgB,IAAI;AAC3C;;AAGF,UAAQ,KAAK;GACX,GAAG;GACH,QAAQ;GACT,CAAC;AACF,WAAS,KAAK,YAAY,SAAS,GAAG,oCAAoC;;AAG5E,MAAK,MAAM,QAAQ,MAAM,SAAS,SAAS,EAAE,EAAE;EAC7C,MAAM,aAAa,eAAe,KAAK,KAAK;EAC5C,MAAM,OAA4B;GAChC,eAAe,KAAK;GACpB,QAAQ;GACR,iBAAiB;GACjB,OAAO;GACR;AAED,MAAI,aAAa,cAAc,iBAAiB;AAC9C,YAAS,KAAK,KAAK;AACnB,iBAAc;QAEd,UAAS,KAAK;GACZ,GAAG;GACH,QAAQ;GACT,CAAC;;AAIN,QAAO;EACL,IAAI,qBAAqB;EACzB,MAAM;EACN;EACA,iBAAiB;EACjB;EACA;EACA;EACA;EACA;EACD;;AAGH,SAAgB,uBAAuB,UAA+C;AACpF,KAAI,SAAS,MAAM,eAAe,KAAA,EAChC,QAAO,6BAA6B,SAAS,KAAK,WAAW;AAG/D,KAAI,SAAS,MAAM,UAAU,KAAA,EAC3B,QAAO,6BAA6B,KAAK,KAAK,SAAS,KAAK,QAAQ,EAAE,CAAC;AAGzE,KAAI,WAAW,YAAY,OAAO,SAAS,UAAU,SACnD,QAAO,eAAe,SAAS,MAAM;AAGvC,KAAI,WAAW,YAAY,SAAS,UAAU,KAAA,GAAW;EACvD,MAAM,aAAa,KAAK,UAAU,SAAS,MAAM;AAEjD,SAAO,eAAe,KAAA,IAAY,KAAK,eAAe,WAAW;;AAGnE,QAAO;;AAGT,SAAgB,eAAe,OAAuB;AACpD,QAAO,KAAK,IAAI,GAAG,6BAA6B,MAAM,OAAO,CAAC;;AAGhE,SAAgB,sBACd,WACwB;AACxB,QAAO,UAAU,IAAI,cAAc;;AAGrC,SAAS,6BAA6B,YAA4B;AAChE,QAAO,KAAK,KAAK,aAAa,EAAE;;AAGlC,SAAS,iBAAiB,UAAmC;AAC3D,KAAI,SAAS,WAAW,OACtB,QAAO;AAGT,KAAI,SAAS,WAAW,YACtB,QAAO;AAGT,QAAO;;AAGT,SAAS,sBAA8B;AACrC,KAAI,OAAO,WAAW,eAAe,OAAO,OAAO,eAAe,WAChE,QAAO,gBAAgB,OAAO,YAAY;AAG5C,QAAO,gBAAgB,KAAK,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,MAAM,EAAE"}

package/dist/context.d.ts

@@ -0,0 +1,2 @@
+import { Bt as ContextSummarizer, Gt as toContextArtifactRefs, Ht as buildContextPack, Rt as BuildContextPackInput, Ut as estimateArtifactTokens, Vt as TrustLabel, Wt as estimateTokens, Xt as ContextPackItemPlan, Zt as ContextPackPlan, zt as ContextPack } from "./provider-C2IfKsvz.js";
+export { type BuildContextPackInput, type ContextPack, type ContextPackItemPlan, type ContextPackPlan, type ContextSummarizer, type TrustLabel, buildContextPack, estimateArtifactTokens, estimateTokens, toContextArtifactRefs };

package/dist/context.js

@@ -0,0 +1,2 @@
+import { i as toContextArtifactRefs, n as estimateArtifactTokens, r as estimateTokens, t as buildContextPack } from "./context-pack-Bz3GXmjv.js";
+export { buildContextPack, estimateArtifactTokens, estimateTokens, toContextArtifactRefs };

package/dist/contract-S3oJGlc9.d.ts

@@ -0,0 +1,74 @@
+import { Mt as InvariantDeclaration, t as CapabilityModality } from "./provider-C2IfKsvz.js";
+
+//#region src/contract/contract.d.ts
+/**
+ * Budget invariant declaration attached to a CapabilityContract.
+ *
+ * Phase 7 implements `maxCostUsd` enforcement at pre-flight. The
+ * `p95LatencyMs` field is declared per CONTRACT-02 but is informational
+ * only in Phase 7 — latency observations are wired in a later phase.
+ *
+ * Phase 19 (v1.2) adds `maxIterations` and `maxWallTimeMs` for the agent
+ * runtime. Both are additive and optional; non-agent callers ignore them.
+ * `maxIterations` caps the number of `runAgent` iterations; `maxWallTimeMs`
+ * caps wall-clock duration per `runAgent` invocation. Both are enforced
+ * pre-iteration in the agent loop.
+ */
+interface BudgetInvariant {
+  readonly maxCostUsd?: number;
+  readonly maxIterations?: number;
+  readonly maxWallTimeMs?: number;
+  readonly p95LatencyMs?: number;
+}
+/**
+ * Quality-floor invariant.
+ *
+ * `suite` is a fixture-directory path string; `minScore` is in 0..1.
+ * Phase 7 forwards this into the pre-flight evaluator but only enforces
+ * capability-side rejects. Full enforcement lives in Phase 12 (`lattice eval`).
+ */
+interface QualityFloorInvariant {
+  readonly suite: string;
+  readonly minScore: number;
+}
+/**
+ * The full Capability Contract attached to `RunIntent.contract`.
+ *
+ * All fields are optional. v1.0 callers compile and run unchanged when
+ * the field is omitted entirely. PROJECT.md explicitly rejects mandatory
+ * contracts.
+ */
+interface CapabilityContract {
+  readonly kind: "capability-contract";
+  readonly budget?: BudgetInvariant;
+  readonly invariants?: readonly InvariantDeclaration[];
+  readonly qualityFloor?: QualityFloorInvariant;
+  readonly requiredModalities?: readonly CapabilityModality[];
+  readonly requiredPrivacy?: "standard" | "sensitive" | "restricted";
+}
+/**
+ * Reject-reason taxonomy added to `RouteRejectReason.code` by Phase 7's
+ * pre-flight evaluator. Closed four-value union per the locked decisions
+ * in 07-CONTEXT.md.
+ */
+type ContractRejectReasonCode = "contract-budget-exceeded" | "contract-quality-floor" | "contract-modality-missing" | "contract-privacy-mismatch";
+/** Input shape accepted by `contract()`. Mirrors `CapabilityContract` minus `kind`. */
+interface CapabilityContractInput {
+  readonly budget?: BudgetInvariant;
+  readonly invariants?: readonly InvariantDeclaration[];
+  readonly qualityFloor?: QualityFloorInvariant;
+  readonly requiredModalities?: readonly CapabilityModality[];
+  readonly requiredPrivacy?: "standard" | "sensitive" | "restricted";
+}
+/**
+ * Factory for `CapabilityContract` values.
+ *
+ * Mirrors the `output()` and adapter factory style — exact-optional safe
+ * (does not emit `field: undefined` properties under `exactOptionalPropertyTypes`).
+ * Returns a frozen value with frozen nested objects so downstream code can
+ * rely on structural immutability when canonicalizing in Phase 9.
+ */
+declare function contract(input?: CapabilityContractInput): CapabilityContract;
+//#endregion
+export { QualityFloorInvariant as a, ContractRejectReasonCode as i, CapabilityContract as n, contract as o, CapabilityContractInput as r, BudgetInvariant as t };
+//# sourceMappingURL=contract-S3oJGlc9.d.ts.map

package/dist/contract-S3oJGlc9.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-S3oJGlc9.d.ts","names":[],"sources":["../src/contract/contract.ts"],"mappings":";;;AA2BA;;;;;;;;;;AAcA;;;AAdA,UAAiB,eAAA;EAAA,SACN,UAAA;EAAA,SACA,aAAA;EAAA,SACA,aAAA;EAAA,SACA,YAAA;AAAA;;;;;;;;UAUM,qBAAA;EAAA,SACN,KAAA;EAAA,SACA,QAAA;AAAA;;;;;;;AAwBX;UAdiB,kBAAA;EAAA,SACN,IAAA;EAAA,SACA,MAAA,GAAS,eAAA;EAAA,SACT,UAAA,YAAsB,oBAAA;EAAA,SACtB,YAAA,GAAe,qBAAA;EAAA,SACf,kBAAA,YAA8B,kBAAA;EAAA,SAC9B,eAAA;AAAA;;;;;;KAQC,wBAAA;;UAOK,uBAAA;EAAA,SACN,MAAA,GAAS,eAAA;EAAA,SACT,UAAA,YAAsB,oBAAA;EAAA,SACtB,YAAA,GAAe,qBAAA;EAAA,SACf,kBAAA,YAA8B,kBAAA;EAAA,SAC9B,eAAA;AAAA;;;AAWX;;;;;;iBAAgB,QAAA,CAAS,KAAA,GAAO,uBAAA,GAA+B,kBAAA"}

package/dist/core.d.ts

@@ -0,0 +1,48 @@
+import { At as defaultPiiDetectors, Bt as ContextSummarizer, Ct as ValidationIssue, Dt as evaluateTripwires, Et as TripwireResult, Ft as MustCiteInvariant, Gt as toContextArtifactRefs, Ht as buildContextPack, It as NoPiiInvariant, Kt as SessionRecord, Lt as inv, Mt as InvariantDeclaration, Nt as InvariantOptions, Ot as PiiDetector, Pt as MatchesInvariant, Qt as ExecutionPlan, Rt as BuildContextPackInput, St as ValidationError, T as Usage, Tt as TripwireEvidence, Ut as estimateArtifactTokens, Vt as TrustLabel, Wt as estimateTokens, _ as ProviderStreamOutputChunk, _n as output, _t as NoContractMatchError, an as RouteDecision, b as ProviderStreamUsageChunk, bt as TimeoutError, c as ProviderPricingHint, cn as SelectedRoute, d as ProviderRunRequest, dn as CitationRef, en as FallbackRoute, f as ProviderRunResponse, fn as CitationsOutputContract, g as ProviderStreamGatewayChunk, gn as TextOutputContract, gt as LatticeRunError, h as ProviderStreamCompleteChunk, hn as SchemaOutputContract, i as ProviderDataPolicyHints, in as RouteCandidate, jt as FieldFromTableInvariant, kt as PiiDetectorResult, l as ProviderRef, ln as UsageRecord, m as ProviderStreamChunk, mn as OutputContractMap, mt as ToolUseRequest, n as ModelCapability, nn as ProviderPackagingPlan, o as ProviderGatewayMetadata, on as RouteEstimates, p as ProviderStream, pn as OutputContract, r as ProviderAdapter, s as ProviderLatencyClass, sn as RouteRejectReason, t as CapabilityModality, tn as ProviderAttemptRecord, u as ProviderRegistryInput, un as ArtifactRefsOutputContract, v as ProviderStreamTextDeltaChunk, vt as NoRouteError, w as ProviderTransportMode, wt as isTerminal, xt as TripwireViolationError, y as ProviderStreamToolCallChunk, yt as ProviderExecutionError, zt as ContextPack } from "./provider-C2IfKsvz.js";
+import { S as mergePolicy, _ as ArtifactTransformDescriptor, a as ArtifactOptions, b as GatewayPolicy, 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, x as PolicySpec, y as GatewayMetadataValue } from "./artifact-Bg6mJGnm.js";
+import { n as InferOutputMap, t as InferOutput } from "./infer-DLqp5QIM.js";
+import { i as StoredArtifactPayloadDescriptor, n as StorageLike, r as StoredArtifactEnvelope, t as ArtifactStore } from "./storage-DJKmsaEI.js";
+import { a as QualityFloorInvariant, i as ContractRejectReasonCode, n as CapabilityContract, o as contract, r as CapabilityContractInput, t as BudgetInvariant } from "./contract-S3oJGlc9.js";
+import { n as RunResult, r as RunSuccess, t as RunFailure } from "./result-DLEx2WvU.js";
+import { a as createCapabilityCatalog, c as modalRank, i as DEFAULT_CATALOG_VERSION, n as routeDeterministically, o as defaultCapabilityForProvider, r as CapabilityCatalog, s as effectivePer1kPricing, t as RouteRequest } from "./router-Yo1-aDOv.js";
+import { a as evaluateContractAgainstRoute, i as estimateRouteCost, n as EstimateRouteCostInput, r as EvaluateContractInput, t as ContractPreflightResult } from "./preflight-DNHWuJ46.js";
+import { n as createMemoryArtifactStore, t as MemoryArtifactStoreOptions } from "./memory-DRig5EHV.js";
+
+//#region src/core/standalone.d.ts
+interface PrepareCoreRunInput<TOutputs extends OutputContractMap = OutputContractMap> {
+  readonly task: string;
+  readonly artifacts?: readonly ArtifactInput[];
+  readonly outputs: TOutputs;
+  readonly catalog?: CapabilityCatalog;
+  readonly policy?: PolicySpec;
+  readonly provider?: string;
+  readonly model?: string;
+  readonly contract?: CapabilityContract;
+  readonly session?: SessionRecord;
+  readonly tokenBudget?: number;
+  readonly storage?: ArtifactStore;
+  readonly metadata?: Record<string, unknown>;
+}
+interface PreparedCoreArtifact {
+  readonly ref: ArtifactRef;
+  readonly stored: boolean;
+  readonly inputHash?: string;
+}
+interface PreparedCoreRun<TOutputs extends OutputContractMap = OutputContractMap> {
+  readonly kind: "prepared-core-run";
+  readonly version: 1;
+  readonly createdAt: string;
+  readonly task: string;
+  readonly outputNames: readonly (keyof TOutputs & string)[];
+  readonly artifacts: readonly PreparedCoreArtifact[];
+  readonly artifactRefs: readonly ArtifactRef[];
+  readonly context: ContextPack;
+  readonly route: RouteDecision;
+  readonly plan: ExecutionPlan;
+  readonly inputHashes: readonly string[];
+  readonly warnings: readonly string[];
+}
+declare function prepareCoreRun<TOutputs extends OutputContractMap>(input: PrepareCoreRunInput<TOutputs>): Promise<PreparedCoreRun<TOutputs>>;
+//#endregion
+export { type ArtifactDerivedOptions, type ArtifactFingerprint, type ArtifactInput, type ArtifactKind, type ArtifactLineage, type ArtifactOptions, type ArtifactParentRef, type ArtifactPrivacy, type ArtifactRef, type ArtifactRefsOutputContract, type ArtifactSize, type ArtifactSource, type ArtifactStorageRef, type ArtifactStore, type ArtifactToolResultOptions, type ArtifactTransformDescriptor, type ArtifactTransformKind, type BudgetInvariant, type BuildContextPackInput, type CapabilityCatalog, type CapabilityContract, type CapabilityContractInput, type CapabilityModality, type CitationRef, type CitationsOutputContract, type ContextPack, type ContextSummarizer, type ContractPreflightResult, type ContractRejectReasonCode, DEFAULT_CATALOG_VERSION, type EstimateRouteCostInput, type EvaluateContractInput, type ExecutionPlan, type FallbackRoute, type FieldFromTableInvariant, type GatewayMetadataValue, type GatewayPolicy, type InferOutput, type InferOutputMap, type InvariantDeclaration, type InvariantOptions, type LatticeRunError, type MatchesInvariant, type MemoryArtifactStoreOptions, type ModelCapability, type MustCiteInvariant, type NoContractMatchError, type NoPiiInvariant, type NoRouteError, type OutputContract, type OutputContractMap, type PiiDetector, type PiiDetectorResult, type PolicySpec, type PrepareCoreRunInput, type PreparedCoreArtifact, type PreparedCoreRun, type ProviderAdapter, type ProviderAttemptRecord, type ProviderDataPolicyHints, type ProviderExecutionError, type ProviderGatewayMetadata, type ProviderLatencyClass, type ProviderPackagingPlan, type ProviderPricingHint, type ProviderRef, type ProviderRegistryInput, type ProviderRunRequest, type ProviderRunResponse, type ProviderStream, type ProviderStreamChunk, type ProviderStreamCompleteChunk, type ProviderStreamGatewayChunk, type ProviderStreamOutputChunk, type ProviderStreamTextDeltaChunk, type ProviderStreamToolCallChunk, type ProviderStreamUsageChunk, type ProviderTransportMode, type QualityFloorInvariant, type RouteCandidate, type RouteDecision, type RouteEstimates, type RouteRejectReason, type RouteRequest, type RunFailure, type RunResult, type RunSuccess, type SchemaOutputContract, type SelectedRoute, type StorageLike, type StoredArtifactEnvelope, type StoredArtifactPayloadDescriptor, type TextOutputContract, type TimeoutError, type ToolUseRequest, type TripwireEvidence, type TripwireResult, type TripwireViolationError, type TrustLabel, type Usage, type UsageRecord, type ValidationError, type ValidationIssue, artifact, buildContextPack, contract, createCapabilityCatalog, createMemoryArtifactStore, defaultCapabilityForProvider, defaultPiiDetectors, effectivePer1kPricing, estimateArtifactTokens, estimateRouteCost, estimateTokens, evaluateContractAgainstRoute, evaluateTripwires, inv, isArtifactRef, isTerminal, mergePolicy, modalRank, output, prepareCoreRun, routeDeterministically, toArtifactRef, toContextArtifactRefs };
+//# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","names":[],"sources":["../src/core/standalone.ts"],"mappings":";;;;;;;;;;;UAeiB,mBAAA,kBAAqC,iBAAA,GAAoB,iBAAA;EAAA,SAC/D,IAAA;EAAA,SACA,SAAA,YAAqB,aAAA;EAAA,SACrB,OAAA,EAAS,QAAA;EAAA,SACT,OAAA,GAAU,iBAAA;EAAA,SACV,MAAA,GAAS,UAAA;EAAA,SACT,QAAA;EAAA,SACA,KAAA;EAAA,SACA,QAAA,GAAW,kBAAA;EAAA,SACX,OAAA,GAAU,aAAA;EAAA,SACV,WAAA;EAAA,SACA,OAAA,GAAU,aAAA;EAAA,SACV,QAAA,GAAW,MAAA;AAAA;AAAA,UAGL,oBAAA;EAAA,SACN,GAAA,EAAK,WAAA;EAAA,SACL,MAAA;EAAA,SACA,SAAA;AAAA;AAAA,UAGM,eAAA,kBAAiC,iBAAA,GAAoB,iBAAA;EAAA,SAC3D,IAAA;EAAA,SACA,OAAA;EAAA,SACA,SAAA;EAAA,SACA,IAAA;EAAA,SACA,WAAA,kBAA6B,QAAA;EAAA,SAC7B,SAAA,WAAoB,oBAAA;EAAA,SACpB,YAAA,WAAuB,WAAA;EAAA,SACvB,OAAA,EAAS,WAAA;EAAA,SACT,KAAA,EAAO,aAAA;EAAA,SACP,IAAA,EAAM,aAAA;EAAA,SACN,WAAA;EAAA,SACA,QAAA;AAAA;AAAA,iBAQW,cAAA,kBAAgC,iBAAA,CAAA,CACpD,KAAA,EAAO,mBAAA,CAAoB,QAAA,IAC1B,OAAA,CAAQ,eAAA,CAAgB,QAAA"}

package/dist/core.js

@@ -0,0 +1,95 @@
+import { n as isArtifactRef, r as toArtifactRef, t as artifact } from "./artifact-DOfpeXLb.js";
+import { a as inv, i as defaultPiiDetectors, n as output, o as contract, r as evaluateTripwires, t as isTerminal } from "./errors-eEuEIx6X.js";
+import { a as modalRank, i as effectivePer1kPricing, n as createCapabilityCatalog, r as defaultCapabilityForProvider, t as DEFAULT_CATALOG_VERSION } from "./catalog-CAfYwB_-.js";
+import { i as evaluateContractAgainstRoute, n as mergePolicy, r as estimateRouteCost, t as routeDeterministically } from "./router-DU4Z3pTd.js";
+import { t as createExecutionPlan } from "./plan-DFm8Llep.js";
+import { t as fingerprintArtifactValue } from "./fingerprint-DodDbQKN.js";
+import { i as toContextArtifactRefs, n as estimateArtifactTokens, r as estimateTokens, t as buildContextPack } from "./context-pack-Bz3GXmjv.js";
+import { t as createMemoryArtifactStore } from "./memory-CkQEW6m5.js";
+//#region src/core/standalone.ts
+const EMPTY_STANDALONE_CATALOG = {
+	version: "standalone-empty",
+	models: []
+};
+async function prepareCoreRun(input) {
+	const preparedArtifacts = await Promise.all((input.artifacts ?? []).map((artifact) => prepareArtifact(artifact, input.storage)));
+	const preparedInputs = preparedArtifacts.map((prepared) => prepared.input);
+	const artifactRefs = preparedArtifacts.map((prepared) => prepared.artifact.ref);
+	const route = routeDeterministically(input.catalog ?? EMPTY_STANDALONE_CATALOG, {
+		task: input.task,
+		artifacts: preparedInputs,
+		outputs: input.outputs,
+		...input.policy !== void 0 ? { policy: input.policy } : {},
+		...input.provider !== void 0 ? { provider: input.provider } : {},
+		...input.model !== void 0 ? { model: input.model } : {},
+		...input.contract !== void 0 ? { contract: input.contract } : {}
+	});
+	const context = buildContextPack({
+		task: input.task,
+		artifacts: preparedInputs,
+		...route.selected !== void 0 ? { route: route.selected } : {},
+		...input.session !== void 0 ? { session: input.session } : {},
+		...input.tokenBudget !== void 0 ? { tokenBudget: input.tokenBudget } : {}
+	});
+	const outputNames = Object.keys(input.outputs);
+	const plan = createExecutionPlan({
+		task: input.task,
+		artifacts: artifactRefs,
+		outputs: input.outputs,
+		route,
+		context,
+		metadata: {
+			...input.metadata,
+			standaloneCore: true
+		}
+	});
+	const artifacts = preparedArtifacts.map((prepared) => prepared.artifact);
+	return {
+		kind: "prepared-core-run",
+		version: 1,
+		createdAt: plan.createdAt,
+		task: input.task,
+		outputNames,
+		artifacts,
+		artifactRefs,
+		context,
+		route,
+		plan,
+		inputHashes: artifacts.flatMap((artifact) => artifact.inputHash === void 0 ? [] : [artifact.inputHash]),
+		warnings: plan.warnings
+	};
+}
+async function prepareArtifact(input, storage) {
+	if (storage !== void 0) {
+		const ref = await storage.put(input);
+		const inputHash = ref.fingerprint?.value ?? input.fingerprint?.value ?? (await fingerprintArtifactValue(input.value))?.value;
+		return {
+			input: {
+				...input,
+				...ref
+			},
+			artifact: {
+				ref,
+				stored: true,
+				...inputHash !== void 0 ? { inputHash } : {}
+			}
+		};
+	}
+	const fingerprint = input.fingerprint ?? await fingerprintArtifactValue(input.value);
+	const preparedInput = {
+		...input,
+		...fingerprint !== void 0 ? { fingerprint } : {}
+	};
+	return {
+		input: preparedInput,
+		artifact: {
+			ref: toArtifactRef(preparedInput),
+			stored: false,
+			...fingerprint?.value !== void 0 ? { inputHash: fingerprint.value } : {}
+		}
+	};
+}
+//#endregion
+export { DEFAULT_CATALOG_VERSION, artifact, buildContextPack, contract, createCapabilityCatalog, createMemoryArtifactStore, defaultCapabilityForProvider, defaultPiiDetectors, effectivePer1kPricing, estimateArtifactTokens, estimateRouteCost, estimateTokens, evaluateContractAgainstRoute, evaluateTripwires, inv, isArtifactRef, isTerminal, mergePolicy, modalRank, output, prepareCoreRun, routeDeterministically, toArtifactRef, toContextArtifactRefs };
+
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","names":[],"sources":["../src/core/standalone.ts"],"sourcesContent":["import type { ArtifactInput, ArtifactRef } from \"../artifacts/artifact.js\";\nimport { toArtifactRef } from \"../artifacts/artifact.js\";\nimport type { CapabilityContract } from \"../contract/contract.js\";\nimport type { BuildContextPackInput, ContextPack } from \"../context/context-pack.js\";\nimport { buildContextPack } from \"../context/context-pack.js\";\nimport type { OutputContractMap } from \"../outputs/contracts.js\";\nimport type { ExecutionPlan, RouteDecision } from \"../plan/plan.js\";\nimport { createExecutionPlan } from \"../plan/plan.js\";\nimport type { PolicySpec } from \"../policy/policy.js\";\nimport type { CapabilityCatalog } from \"../routing/catalog.js\";\nimport { routeDeterministically } from \"../routing/router.js\";\nimport type { SessionRecord } from \"../sessions/session.js\";\nimport { fingerprintArtifactValue } from \"../storage/fingerprint.js\";\nimport type { ArtifactStore } from \"../storage/storage.js\";\n\nexport interface PrepareCoreRunInput<TOutputs extends OutputContractMap = OutputContractMap> {\n  readonly task: string;\n  readonly artifacts?: readonly ArtifactInput[];\n  readonly outputs: TOutputs;\n  readonly catalog?: CapabilityCatalog;\n  readonly policy?: PolicySpec;\n  readonly provider?: string;\n  readonly model?: string;\n  readonly contract?: CapabilityContract;\n  readonly session?: SessionRecord;\n  readonly tokenBudget?: number;\n  readonly storage?: ArtifactStore;\n  readonly metadata?: Record<string, unknown>;\n}\n\nexport interface PreparedCoreArtifact {\n  readonly ref: ArtifactRef;\n  readonly stored: boolean;\n  readonly inputHash?: string;\n}\n\nexport interface PreparedCoreRun<TOutputs extends OutputContractMap = OutputContractMap> {\n  readonly kind: \"prepared-core-run\";\n  readonly version: 1;\n  readonly createdAt: string;\n  readonly task: string;\n  readonly outputNames: readonly (keyof TOutputs & string)[];\n  readonly artifacts: readonly PreparedCoreArtifact[];\n  readonly artifactRefs: readonly ArtifactRef[];\n  readonly context: ContextPack;\n  readonly route: RouteDecision;\n  readonly plan: ExecutionPlan;\n  readonly inputHashes: readonly string[];\n  readonly warnings: readonly string[];\n}\n\nconst EMPTY_STANDALONE_CATALOG: CapabilityCatalog = {\n  version: \"standalone-empty\",\n  models: [],\n};\n\nexport async function prepareCoreRun<TOutputs extends OutputContractMap>(\n  input: PrepareCoreRunInput<TOutputs>,\n): Promise<PreparedCoreRun<TOutputs>> {\n  const preparedArtifacts = await Promise.all(\n    (input.artifacts ?? []).map((artifact) => prepareArtifact(artifact, input.storage)),\n  );\n  const preparedInputs = preparedArtifacts.map((prepared) => prepared.input);\n  const artifactRefs = preparedArtifacts.map((prepared) => prepared.artifact.ref);\n  const catalog = input.catalog ?? EMPTY_STANDALONE_CATALOG;\n  const route = routeDeterministically(catalog, {\n    task: input.task,\n    artifacts: preparedInputs,\n    outputs: input.outputs,\n    ...(input.policy !== undefined ? { policy: input.policy } : {}),\n    ...(input.provider !== undefined ? { provider: input.provider } : {}),\n    ...(input.model !== undefined ? { model: input.model } : {}),\n    ...(input.contract !== undefined ? { contract: input.contract } : {}),\n  });\n  const contextInput: BuildContextPackInput = {\n    task: input.task,\n    artifacts: preparedInputs,\n    ...(route.selected !== undefined ? { route: route.selected } : {}),\n    ...(input.session !== undefined ? { session: input.session } : {}),\n    ...(input.tokenBudget !== undefined ? { tokenBudget: input.tokenBudget } : {}),\n  };\n  const context = buildContextPack(contextInput);\n  const outputNames = Object.keys(input.outputs) as readonly (keyof TOutputs & string)[];\n  const plan = createExecutionPlan({\n    task: input.task,\n    artifacts: artifactRefs,\n    outputs: input.outputs,\n    route,\n    context,\n    metadata: {\n      ...input.metadata,\n      standaloneCore: true,\n    },\n  });\n  const artifacts = preparedArtifacts.map((prepared) => prepared.artifact);\n\n  return {\n    kind: \"prepared-core-run\",\n    version: 1,\n    createdAt: plan.createdAt,\n    task: input.task,\n    outputNames,\n    artifacts,\n    artifactRefs,\n    context,\n    route,\n    plan,\n    inputHashes: artifacts.flatMap((artifact) =>\n      artifact.inputHash === undefined ? [] : [artifact.inputHash],\n    ),\n    warnings: plan.warnings,\n  };\n}\n\ninterface PreparedArtifactInternal {\n  readonly input: ArtifactInput;\n  readonly artifact: PreparedCoreArtifact;\n}\n\nasync function prepareArtifact(\n  input: ArtifactInput,\n  storage: ArtifactStore | undefined,\n): Promise<PreparedArtifactInternal> {\n  if (storage !== undefined) {\n    const ref = await storage.put(input);\n    const inputHash =\n      ref.fingerprint?.value ??\n      input.fingerprint?.value ??\n      (await fingerprintArtifactValue(input.value))?.value;\n    const preparedInput: ArtifactInput = {\n      ...input,\n      ...ref,\n    };\n\n    return {\n      input: preparedInput,\n      artifact: {\n        ref,\n        stored: true,\n        ...(inputHash !== undefined ? { inputHash } : {}),\n      },\n    };\n  }\n\n  const fingerprint = input.fingerprint ?? await fingerprintArtifactValue(input.value);\n  const preparedInput: ArtifactInput = {\n    ...input,\n    ...(fingerprint !== undefined ? { fingerprint } : {}),\n  };\n  const ref = toArtifactRef(preparedInput);\n\n  return {\n    input: preparedInput,\n    artifact: {\n      ref,\n      stored: false,\n      ...(fingerprint?.value !== undefined ? { inputHash: fingerprint.value } : {}),\n    },\n  };\n}\n"],"mappings":";;;;;;;;;AAmDA,MAAM,2BAA8C;CAClD,SAAS;CACT,QAAQ,EAAE;CACX;AAED,eAAsB,eACpB,OACoC;CACpC,MAAM,oBAAoB,MAAM,QAAQ,KACrC,MAAM,aAAa,EAAE,EAAE,KAAK,aAAa,gBAAgB,UAAU,MAAM,QAAQ,CAAC,CACpF;CACD,MAAM,iBAAiB,kBAAkB,KAAK,aAAa,SAAS,MAAM;CAC1E,MAAM,eAAe,kBAAkB,KAAK,aAAa,SAAS,SAAS,IAAI;CAE/E,MAAM,QAAQ,uBADE,MAAM,WAAW,0BACa;EAC5C,MAAM,MAAM;EACZ,WAAW;EACX,SAAS,MAAM;EACf,GAAI,MAAM,WAAW,KAAA,IAAY,EAAE,QAAQ,MAAM,QAAQ,GAAG,EAAE;EAC9D,GAAI,MAAM,aAAa,KAAA,IAAY,EAAE,UAAU,MAAM,UAAU,GAAG,EAAE;EACpE,GAAI,MAAM,UAAU,KAAA,IAAY,EAAE,OAAO,MAAM,OAAO,GAAG,EAAE;EAC3D,GAAI,MAAM,aAAa,KAAA,IAAY,EAAE,UAAU,MAAM,UAAU,GAAG,EAAE;EACrE,CAAC;CAQF,MAAM,UAAU,iBAP4B;EAC1C,MAAM,MAAM;EACZ,WAAW;EACX,GAAI,MAAM,aAAa,KAAA,IAAY,EAAE,OAAO,MAAM,UAAU,GAAG,EAAE;EACjE,GAAI,MAAM,YAAY,KAAA,IAAY,EAAE,SAAS,MAAM,SAAS,GAAG,EAAE;EACjE,GAAI,MAAM,gBAAgB,KAAA,IAAY,EAAE,aAAa,MAAM,aAAa,GAAG,EAAE;EAC9E,CAC6C;CAC9C,MAAM,cAAc,OAAO,KAAK,MAAM,QAAQ;CAC9C,MAAM,OAAO,oBAAoB;EAC/B,MAAM,MAAM;EACZ,WAAW;EACX,SAAS,MAAM;EACf;EACA;EACA,UAAU;GACR,GAAG,MAAM;GACT,gBAAgB;GACjB;EACF,CAAC;CACF,MAAM,YAAY,kBAAkB,KAAK,aAAa,SAAS,SAAS;AAExE,QAAO;EACL,MAAM;EACN,SAAS;EACT,WAAW,KAAK;EAChB,MAAM,MAAM;EACZ;EACA;EACA;EACA;EACA;EACA;EACA,aAAa,UAAU,SAAS,aAC9B,SAAS,cAAc,KAAA,IAAY,EAAE,GAAG,CAAC,SAAS,UAAU,CAC7D;EACD,UAAU,KAAK;EAChB;;AAQH,eAAe,gBACb,OACA,SACmC;AACnC,KAAI,YAAY,KAAA,GAAW;EACzB,MAAM,MAAM,MAAM,QAAQ,IAAI,MAAM;EACpC,MAAM,YACJ,IAAI,aAAa,SACjB,MAAM,aAAa,UAClB,MAAM,yBAAyB,MAAM,MAAM,GAAG;AAMjD,SAAO;GACL,OANmC;IACnC,GAAG;IACH,GAAG;IACJ;GAIC,UAAU;IACR;IACA,QAAQ;IACR,GAAI,cAAc,KAAA,IAAY,EAAE,WAAW,GAAG,EAAE;IACjD;GACF;;CAGH,MAAM,cAAc,MAAM,eAAe,MAAM,yBAAyB,MAAM,MAAM;CACpF,MAAM,gBAA+B;EACnC,GAAG;EACH,GAAI,gBAAgB,KAAA,IAAY,EAAE,aAAa,GAAG,EAAE;EACrD;AAGD,QAAO;EACL,OAAO;EACP,UAAU;GACR,KALQ,cAAc,cAAc;GAMpC,QAAQ;GACR,GAAI,aAAa,UAAU,KAAA,IAAY,EAAE,WAAW,YAAY,OAAO,GAAG,EAAE;GAC7E;EACF"}