@makaio/framework 1.0.0-dev-1783977266352 → 1.0.0-dev-1784144891135

package/dist/context-resolution-CE1o3wTv.d.mts

@@ -0,0 +1,1268 @@
+import { z } from "zod";
+import * as _$_makaio_contracts0 from "@makaio/framework/contracts";
+
+//#region core/contracts/src/artifact/schemas.d.ts
+/**
+ * Identifies the actor (agent, user, system) that produced or asserted
+ * an artifact revision or confidence basis.
+ */
+declare const ArtifactActorSchema: z.ZodObject<{
+  kind: z.ZodString;
+  id: z.ZodString;
+  displayName: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Describes the scope at which an artifact revision is relevant.
+ *
+ * `level` is an open string (e.g. `'session'`, `'project'`, `'global'`)
+ * so that product-owned kinds can declare domain-specific scope levels
+ * without modifying the framework contract.
+ *
+ * `ids` carries the scope-identifying foreign keys when `level` names a
+ * concrete artifact owner. Query filters use {@link ArtifactQueryScopeSchema}
+ * because level-only queries are valid there but not for persisted revisions.
+ */
+declare const ArtifactScopeSchema: z.ZodObject<{
+  level: z.ZodString;
+  ids: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Scope filter for artifact queries.
+ *
+ * Unlike persisted artifact scopes, query scopes may be level-only to request
+ * all revisions at a level, e.g. `{ level: 'session' }`.
+ */
+declare const ArtifactQueryScopeSchema: z.ZodObject<{
+  level: z.ZodString;
+  ids: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * An immutable pointer to a specific revision of an artifact.
+ *
+ * All three fields together uniquely identify a persisted snapshot
+ * and are safe to store as foreign keys.
+ *
+ * `refClass` is a literal discriminant that allows {@link ArtifactRelationTargetSchema}
+ * to use a discriminated union and prevents silent field-stripping when an
+ * {@link EvidenceRefSchema} carrying a `locator` is parsed against this schema.
+ */
+declare const ArtifactRefSchema: z.ZodObject<{
+  refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+  kind: z.ZodString;
+  id: z.ZodString;
+  revision: z.ZodString;
+}, z.core.$strip>;
+/**
+ * A pointer to a named sub-element within a specific artifact revision.
+ *
+ * Used when a relation target is a structural part of an artifact rather
+ * than the artifact itself (e.g. a specific line in a code-review artifact).
+ *
+ * `refClass` is a literal discriminant for {@link ArtifactRelationTargetSchema}.
+ */
+declare const LocalRefSchema: z.ZodObject<{
+  refClass: z.ZodDefault<z.ZodLiteral<"local">>;
+  artifact: z.ZodObject<{
+    refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+    kind: z.ZodString;
+    id: z.ZodString;
+    revision: z.ZodString;
+  }, z.core.$strip>;
+  localId: z.ZodString;
+}, z.core.$strip>;
+/**
+ * A pointer to external evidence — a source outside the artifact store.
+ *
+ * `revision` and `locator` are both optional so callers can supply as
+ * much precision as is available (e.g. a commit SHA + file path, or just
+ * a document URL).
+ *
+ * `refClass` is a literal discriminant for {@link ArtifactRelationTargetSchema}.
+ */
+declare const EvidenceRefSchema: z.ZodObject<{
+  refClass: z.ZodDefault<z.ZodLiteral<"evidence">>;
+  kind: z.ZodString;
+  id: z.ZodString;
+  revision: z.ZodOptional<z.ZodString>;
+  locator: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const ArtifactRelationTargetSchema: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+  refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+  kind: z.ZodString;
+  id: z.ZodString;
+  revision: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  refClass: z.ZodDefault<z.ZodLiteral<"local">>;
+  artifact: z.ZodObject<{
+    refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+    kind: z.ZodString;
+    id: z.ZodString;
+    revision: z.ZodString;
+  }, z.core.$strip>;
+  localId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  refClass: z.ZodDefault<z.ZodLiteral<"evidence">>;
+  kind: z.ZodString;
+  id: z.ZodString;
+  revision: z.ZodOptional<z.ZodString>;
+  locator: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "refClass">>;
+/**
+ * Relation target schema for use in {@link ArtifactQueryRequestSchema}.
+ *
+ * Relaxes the `artifact` variant to allow identity-only lookups (kind + id)
+ * without a specific revision. Storage relations must still use the exact
+ * {@link ArtifactRelationTargetSchema} which requires revision.
+ *
+ * Supports `refClass` inference via {@link inferArtifactRelationQueryTargetRefClass}
+ * for wire payloads that omit the discriminant. Defaults to `'artifact'` when
+ * neither local-ref nor evidence fields are present, unlike storage inference
+ * which requires `revision` to distinguish artifact from evidence refs.
+ */
+declare const ArtifactRelationQueryTargetSchema: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+  refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+  kind: z.ZodString;
+  id: z.ZodString;
+  revision: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  refClass: z.ZodDefault<z.ZodLiteral<"local">>;
+  artifact: z.ZodObject<{
+    refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+    kind: z.ZodString;
+    id: z.ZodString;
+    revision: z.ZodString;
+  }, z.core.$strip>;
+  localId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  refClass: z.ZodDefault<z.ZodLiteral<"evidence">>;
+  kind: z.ZodString;
+  id: z.ZodString;
+  revision: z.ZodOptional<z.ZodString>;
+  locator: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "refClass">>;
+/**
+ * A typed directional link from one artifact to a relation target.
+ *
+ * `type` is an open string registered via {@link RelationTypeRegistrationSchema}.
+ */
+declare const ArtifactRelationSchema: z.ZodObject<{
+  type: z.ZodString;
+  target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+    kind: z.ZodString;
+    id: z.ZodString;
+    revision: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    refClass: z.ZodDefault<z.ZodLiteral<"local">>;
+    artifact: z.ZodObject<{
+      refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+      kind: z.ZodString;
+      id: z.ZodString;
+      revision: z.ZodString;
+    }, z.core.$strip>;
+    localId: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    refClass: z.ZodDefault<z.ZodLiteral<"evidence">>;
+    kind: z.ZodString;
+    id: z.ZodString;
+    revision: z.ZodOptional<z.ZodString>;
+    locator: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>], "refClass">>;
+}, z.core.$strip>;
+/**
+ * Ordered confidence levels for artifact assertions.
+ *
+ * Levels progress from weakest to strongest epistemic warrant:
+ * `assumed` → `inferred` → `stated` → `confirmed` → `verified`
+ */
+declare const ConfidenceLevelSchema: z.ZodEnum<{
+  inferred: "inferred";
+  assumed: "assumed";
+  stated: "stated";
+  confirmed: "confirmed";
+  verified: "verified";
+}>;
+/**
+ * One piece of evidence contributing to the overall confidence of an artifact.
+ *
+ * Multiple bases can be accumulated for the same artifact revision as
+ * additional actors review or verify it.
+ */
+declare const ConfidenceBasisSchema: z.ZodObject<{
+  kind: z.ZodString;
+  actor: z.ZodObject<{
+    kind: z.ZodString;
+    id: z.ZodString;
+    displayName: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>;
+  timestamp: z.ZodNumber;
+  detail: z.ZodOptional<z.ZodString>;
+  evidenceRef: z.ZodOptional<z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+    kind: z.ZodString;
+    id: z.ZodString;
+    revision: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    refClass: z.ZodDefault<z.ZodLiteral<"local">>;
+    artifact: z.ZodObject<{
+      refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+      kind: z.ZodString;
+      id: z.ZodString;
+      revision: z.ZodString;
+    }, z.core.$strip>;
+    localId: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    refClass: z.ZodDefault<z.ZodLiteral<"evidence">>;
+    kind: z.ZodString;
+    id: z.ZodString;
+    revision: z.ZodOptional<z.ZodString>;
+    locator: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>], "refClass">>>;
+}, z.core.$strip>;
+/**
+ * Aggregated confidence metadata for an artifact revision.
+ *
+ * `basis` carries the ordered set of individual evidence entries that
+ * together justify the overall `level`.
+ */
+declare const ConfidenceMetadataSchema: z.ZodObject<{
+  level: z.ZodEnum<{
+    inferred: "inferred";
+    assumed: "assumed";
+    stated: "stated";
+    confirmed: "confirmed";
+    verified: "verified";
+  }>;
+  basis: z.ZodArray<z.ZodObject<{
+    kind: z.ZodString;
+    actor: z.ZodObject<{
+      kind: z.ZodString;
+      id: z.ZodString;
+      displayName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    timestamp: z.ZodNumber;
+    detail: z.ZodOptional<z.ZodString>;
+    evidenceRef: z.ZodOptional<z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+      refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+      kind: z.ZodString;
+      id: z.ZodString;
+      revision: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      refClass: z.ZodDefault<z.ZodLiteral<"local">>;
+      artifact: z.ZodObject<{
+        refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+        kind: z.ZodString;
+        id: z.ZodString;
+        revision: z.ZodString;
+      }, z.core.$strip>;
+      localId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      refClass: z.ZodDefault<z.ZodLiteral<"evidence">>;
+      kind: z.ZodString;
+      id: z.ZodString;
+      revision: z.ZodOptional<z.ZodString>;
+      locator: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "refClass">>>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * A single typed observation attached to an artifact revision.
+ *
+ * Observations are append-only — they do not mutate the revision's `data`
+ * but augment it with actor-sourced findings.
+ */
+declare const ArtifactObservationSchema: z.ZodObject<{
+  id: z.ZodString;
+  kind: z.ZodString;
+  summary: z.ZodString;
+  detail: z.ZodOptional<z.ZodString>;
+  severity: z.ZodOptional<z.ZodEnum<{
+    info: "info";
+    warning: "warning";
+    blocker: "blocker";
+  }>>;
+  tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  regarding: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+    refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+    kind: z.ZodString;
+    id: z.ZodString;
+    revision: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    refClass: z.ZodDefault<z.ZodLiteral<"local">>;
+    artifact: z.ZodObject<{
+      refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+      kind: z.ZodString;
+      id: z.ZodString;
+      revision: z.ZodString;
+    }, z.core.$strip>;
+    localId: z.ZodString;
+  }, z.core.$strip>]>>;
+  evidence: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+    refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+    kind: z.ZodString;
+    id: z.ZodString;
+    revision: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    refClass: z.ZodDefault<z.ZodLiteral<"evidence">>;
+    kind: z.ZodString;
+    id: z.ZodString;
+    revision: z.ZodOptional<z.ZodString>;
+    locator: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>]>>;
+  actor: z.ZodObject<{
+    kind: z.ZodString;
+    id: z.ZodString;
+    displayName: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>;
+  timestamp: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Human-readable rendering hints for an artifact revision.
+ *
+ * All fields are optional — consumers may fall back to raw `data` when
+ * none are provided.
+ */
+declare const ArtifactRepresentationsSchema: z.ZodObject<{
+  markdown: z.ZodOptional<z.ZodString>;
+  summary: z.ZodOptional<z.ZodString>;
+  plaintext: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * A complete, immutable artifact revision.
+ *
+ * Each write to the artifact store creates a new revision; the previous
+ * revision is never mutated. Callers should use the generic {@link ArtifactRevision}
+ * type alias when they need a strongly-typed `data` field.
+ */
+declare const ArtifactRevisionSchema: z.ZodObject<{
+  kind: z.ZodString;
+  id: z.ZodString;
+  revision: z.ZodString;
+  scope: z.ZodObject<{
+    level: z.ZodString;
+    ids: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  }, z.core.$strip>;
+  schemaVersion: z.ZodString;
+  data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
+  relations: z.ZodArray<z.ZodObject<{
+    type: z.ZodString;
+    target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+      refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+      kind: z.ZodString;
+      id: z.ZodString;
+      revision: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      refClass: z.ZodDefault<z.ZodLiteral<"local">>;
+      artifact: z.ZodObject<{
+        refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+        kind: z.ZodString;
+        id: z.ZodString;
+        revision: z.ZodString;
+      }, z.core.$strip>;
+      localId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      refClass: z.ZodDefault<z.ZodLiteral<"evidence">>;
+      kind: z.ZodString;
+      id: z.ZodString;
+      revision: z.ZodOptional<z.ZodString>;
+      locator: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "refClass">>;
+  }, z.core.$strip>>;
+  confidence: z.ZodOptional<z.ZodObject<{
+    level: z.ZodEnum<{
+      inferred: "inferred";
+      assumed: "assumed";
+      stated: "stated";
+      confirmed: "confirmed";
+      verified: "verified";
+    }>;
+    basis: z.ZodArray<z.ZodObject<{
+      kind: z.ZodString;
+      actor: z.ZodObject<{
+        kind: z.ZodString;
+        id: z.ZodString;
+        displayName: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>;
+      timestamp: z.ZodNumber;
+      detail: z.ZodOptional<z.ZodString>;
+      evidenceRef: z.ZodOptional<z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+        kind: z.ZodString;
+        id: z.ZodString;
+        revision: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        refClass: z.ZodDefault<z.ZodLiteral<"local">>;
+        artifact: z.ZodObject<{
+          refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+          kind: z.ZodString;
+          id: z.ZodString;
+          revision: z.ZodString;
+        }, z.core.$strip>;
+        localId: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        refClass: z.ZodDefault<z.ZodLiteral<"evidence">>;
+        kind: z.ZodString;
+        id: z.ZodString;
+        revision: z.ZodOptional<z.ZodString>;
+        locator: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>], "refClass">>>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
+  representations: z.ZodOptional<z.ZodObject<{
+    markdown: z.ZodOptional<z.ZodString>;
+    summary: z.ZodOptional<z.ZodString>;
+    plaintext: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+  actor: z.ZodObject<{
+    kind: z.ZodString;
+    id: z.ZodString;
+    displayName: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>;
+  timestamp: z.ZodNumber;
+  createdAt: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Strategy used when two revisions of the same artifact conflict.
+ *
+ * - `supersedes` — newer revision wins; older is archived automatically
+ * - `manual` — host must resolve the conflict explicitly
+ * - `coexist` — both revisions are kept; conflict is surfaced to consumers
+ */
+declare const ArtifactConflictPolicySchema: z.ZodEnum<{
+  manual: "manual";
+  supersedes: "supersedes";
+  coexist: "coexist";
+}>;
+/**
+ * Registration record for a named artifact kind.
+ *
+ * Kind registrations are declared by product extensions and consumed by the
+ * artifact service to validate, index, and lifecycle-manage revisions of that kind.
+ */
+declare const ArtifactKindRegistrationSchema: z.ZodObject<{
+  kind: z.ZodString;
+  description: z.ZodString;
+  schemaVersion: z.ZodString;
+  dataSchema: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
+  scopeSchema: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
+  observationSchema: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
+  discriminator: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+  conflictPolicy: z.ZodEnum<{
+    manual: "manual";
+    supersedes: "supersedes";
+    coexist: "coexist";
+  }>;
+  status: z.ZodOptional<z.ZodObject<{
+    path: z.ZodString;
+    values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>;
+  lifecycle: z.ZodOptional<z.ZodObject<{
+    defaultRelevance: z.ZodOptional<z.ZodEnum<{
+      active: "active";
+      fading: "fading";
+      retired: "retired";
+      archived: "archived";
+    }>>;
+    decayPolicy: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+  indexedFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  searchableFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  projection: z.ZodOptional<z.ZodObject<{
+    mode: z.ZodEnum<{
+      none: "none";
+      comment: "comment";
+      surface: "surface";
+    }>;
+    defaultRole: z.ZodOptional<z.ZodEnum<{
+      artifact: "artifact";
+      workpiece: "workpiece";
+    }>>;
+    semanticEvents: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+      created: "created";
+      revised: "revised";
+      "status-changed": "status-changed";
+      "observation-added": "observation-added";
+    }>>>;
+    projectedFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      path: z.ZodString;
+      semantic: z.ZodOptional<z.ZodEnum<{
+        status: "status";
+        workflow: "workflow";
+        priority: "priority";
+      }>>;
+      fromLevel: z.ZodOptional<z.ZodEnum<{
+        link: "link";
+        summary: "summary";
+        full: "full";
+      }>>;
+      viewRole: z.ZodOptional<z.ZodEnum<{
+        title: "title";
+        summary: "summary";
+      }>>;
+    }, z.core.$strip>>>;
+    affordances: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+      kind: z.ZodLiteral<"own-view">;
+    }, z.core.$strip>, z.ZodObject<{
+      kind: z.ZodLiteral<"inline">;
+      hostRelation: z.ZodString;
+      as: z.ZodOptional<z.ZodEnum<{
+        link: "link";
+        summary: "summary";
+        full: "full";
+      }>>;
+    }, z.core.$strip>, z.ZodObject<{
+      kind: z.ZodLiteral<"entry">;
+      via: z.ZodOptional<z.ZodString>;
+      collection: z.ZodOptional<z.ZodString>;
+      title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "kind">>>;
+  }, z.core.$strip>>;
+  defaultContext: z.ZodOptional<z.ZodType<Readonly<Record<string, _$_makaio_contracts0.ArtifactContextRelationSelector>>, Readonly<Record<string, _$_makaio_contracts0.ArtifactContextRelationSelector>>, z.core.$ZodTypeInternals<Readonly<Record<string, _$_makaio_contracts0.ArtifactContextRelationSelector>>, Readonly<Record<string, _$_makaio_contracts0.ArtifactContextRelationSelector>>>>>;
+}, z.core.$strip>;
+/**
+ * Registration record for a named relation type.
+ *
+ * Relation type registrations declare the semantics and valid endpoints
+ * for a given relation `type` string.
+ */
+declare const RelationTypeRegistrationSchema: z.ZodObject<{
+  type: z.ZodString;
+  symmetry: z.ZodEnum<{
+    asymmetric: "asymmetric";
+    symmetric: "symmetric";
+  }>;
+  implication: z.ZodOptional<z.ZodString>;
+  sourceKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  targetKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  targetRefClasses: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+    local: "local";
+    artifact: "artifact";
+    evidence: "evidence";
+  }>>>;
+}, z.core.$strip>;
+/**
+ * Query parameters for retrieving artifact revisions from the store.
+ *
+ * All fields are optional and composed with AND semantics; omitting a field
+ * leaves that dimension unconstrained.
+ */
+declare const ArtifactQueryRequestSchema: z.ZodObject<{
+  kind: z.ZodOptional<z.ZodString>;
+  scope: z.ZodOptional<z.ZodObject<{
+    level: z.ZodString;
+    ids: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  }, z.core.$strip>>;
+  ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  currentOnly: z.ZodOptional<z.ZodBoolean>;
+  search: z.ZodOptional<z.ZodString>;
+  relation: z.ZodOptional<z.ZodObject<{
+    type: z.ZodOptional<z.ZodString>;
+    target: z.ZodOptional<z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+      refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+      kind: z.ZodString;
+      id: z.ZodString;
+      revision: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+      refClass: z.ZodDefault<z.ZodLiteral<"local">>;
+      artifact: z.ZodObject<{
+        refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+        kind: z.ZodString;
+        id: z.ZodString;
+        revision: z.ZodString;
+      }, z.core.$strip>;
+      localId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      refClass: z.ZodDefault<z.ZodLiteral<"evidence">>;
+      kind: z.ZodString;
+      id: z.ZodString;
+      revision: z.ZodOptional<z.ZodString>;
+      locator: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "refClass">>>;
+  }, z.core.$strip>>;
+  confidence: z.ZodOptional<z.ZodObject<{
+    maxLevel: z.ZodOptional<z.ZodEnum<{
+      inferred: "inferred";
+      assumed: "assumed";
+      stated: "stated";
+      confirmed: "confirmed";
+      verified: "verified";
+    }>>;
+    minLevel: z.ZodOptional<z.ZodEnum<{
+      inferred: "inferred";
+      assumed: "assumed";
+      stated: "stated";
+      confirmed: "confirmed";
+      verified: "verified";
+    }>>;
+  }, z.core.$strip>>;
+  indexed: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>>>;
+  limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Request to compare two artifact revisions.
+ */
+declare const ArtifactCompareRequestSchema: z.ZodObject<{
+  base: z.ZodObject<{
+    refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+    kind: z.ZodString;
+    id: z.ZodString;
+    revision: z.ZodString;
+  }, z.core.$strip>;
+  target: z.ZodObject<{
+    refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+    kind: z.ZodString;
+    id: z.ZodString;
+    revision: z.ZodString;
+  }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * Result of comparing two artifact revisions.
+ *
+ * `changedPaths` lists the dot-separated paths within `data` that differ
+ * between `base` and `target`.
+ */
+declare const ArtifactCompareResponseSchema: z.ZodObject<{
+  base: z.ZodObject<{
+    kind: z.ZodString;
+    id: z.ZodString;
+    revision: z.ZodString;
+    scope: z.ZodObject<{
+      level: z.ZodString;
+      ids: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>;
+    schemaVersion: z.ZodString;
+    data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
+    relations: z.ZodArray<z.ZodObject<{
+      type: z.ZodString;
+      target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+        kind: z.ZodString;
+        id: z.ZodString;
+        revision: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        refClass: z.ZodDefault<z.ZodLiteral<"local">>;
+        artifact: z.ZodObject<{
+          refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+          kind: z.ZodString;
+          id: z.ZodString;
+          revision: z.ZodString;
+        }, z.core.$strip>;
+        localId: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        refClass: z.ZodDefault<z.ZodLiteral<"evidence">>;
+        kind: z.ZodString;
+        id: z.ZodString;
+        revision: z.ZodOptional<z.ZodString>;
+        locator: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>], "refClass">>;
+    }, z.core.$strip>>;
+    confidence: z.ZodOptional<z.ZodObject<{
+      level: z.ZodEnum<{
+        inferred: "inferred";
+        assumed: "assumed";
+        stated: "stated";
+        confirmed: "confirmed";
+        verified: "verified";
+      }>;
+      basis: z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        actor: z.ZodObject<{
+          kind: z.ZodString;
+          id: z.ZodString;
+          displayName: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        timestamp: z.ZodNumber;
+        detail: z.ZodOptional<z.ZodString>;
+        evidenceRef: z.ZodOptional<z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+          refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+          kind: z.ZodString;
+          id: z.ZodString;
+          revision: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+          refClass: z.ZodDefault<z.ZodLiteral<"local">>;
+          artifact: z.ZodObject<{
+            refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+            kind: z.ZodString;
+            id: z.ZodString;
+            revision: z.ZodString;
+          }, z.core.$strip>;
+          localId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+          refClass: z.ZodDefault<z.ZodLiteral<"evidence">>;
+          kind: z.ZodString;
+          id: z.ZodString;
+          revision: z.ZodOptional<z.ZodString>;
+          locator: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], "refClass">>>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    representations: z.ZodOptional<z.ZodObject<{
+      markdown: z.ZodOptional<z.ZodString>;
+      summary: z.ZodOptional<z.ZodString>;
+      plaintext: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    actor: z.ZodObject<{
+      kind: z.ZodString;
+      id: z.ZodString;
+      displayName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    timestamp: z.ZodNumber;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strip>;
+  target: z.ZodObject<{
+    kind: z.ZodString;
+    id: z.ZodString;
+    revision: z.ZodString;
+    scope: z.ZodObject<{
+      level: z.ZodString;
+      ids: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>;
+    schemaVersion: z.ZodString;
+    data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
+    relations: z.ZodArray<z.ZodObject<{
+      type: z.ZodString;
+      target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+        kind: z.ZodString;
+        id: z.ZodString;
+        revision: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        refClass: z.ZodDefault<z.ZodLiteral<"local">>;
+        artifact: z.ZodObject<{
+          refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+          kind: z.ZodString;
+          id: z.ZodString;
+          revision: z.ZodString;
+        }, z.core.$strip>;
+        localId: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        refClass: z.ZodDefault<z.ZodLiteral<"evidence">>;
+        kind: z.ZodString;
+        id: z.ZodString;
+        revision: z.ZodOptional<z.ZodString>;
+        locator: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>], "refClass">>;
+    }, z.core.$strip>>;
+    confidence: z.ZodOptional<z.ZodObject<{
+      level: z.ZodEnum<{
+        inferred: "inferred";
+        assumed: "assumed";
+        stated: "stated";
+        confirmed: "confirmed";
+        verified: "verified";
+      }>;
+      basis: z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        actor: z.ZodObject<{
+          kind: z.ZodString;
+          id: z.ZodString;
+          displayName: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        timestamp: z.ZodNumber;
+        detail: z.ZodOptional<z.ZodString>;
+        evidenceRef: z.ZodOptional<z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+          refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+          kind: z.ZodString;
+          id: z.ZodString;
+          revision: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+          refClass: z.ZodDefault<z.ZodLiteral<"local">>;
+          artifact: z.ZodObject<{
+            refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+            kind: z.ZodString;
+            id: z.ZodString;
+            revision: z.ZodString;
+          }, z.core.$strip>;
+          localId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+          refClass: z.ZodDefault<z.ZodLiteral<"evidence">>;
+          kind: z.ZodString;
+          id: z.ZodString;
+          revision: z.ZodOptional<z.ZodString>;
+          locator: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], "refClass">>>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    representations: z.ZodOptional<z.ZodObject<{
+      markdown: z.ZodOptional<z.ZodString>;
+      summary: z.ZodOptional<z.ZodString>;
+      plaintext: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    actor: z.ZodObject<{
+      kind: z.ZodString;
+      id: z.ZodString;
+      displayName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    timestamp: z.ZodNumber;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strip>;
+  changedPaths: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/** Actor identity for artifact authorship and confidence attribution. */
+type ArtifactActor = z.infer<typeof ArtifactActorSchema>;
+/** Scope descriptor for an artifact revision. */
+type ArtifactScope = z.infer<typeof ArtifactScopeSchema>;
+/** Scope descriptor for artifact query filters. */
+type ArtifactQueryScope = z.infer<typeof ArtifactQueryScopeSchema>;
+/** Immutable pointer to a specific artifact revision. */
+type ArtifactRef$1 = z.infer<typeof ArtifactRefSchema>;
+/** Pointer to a named sub-element within a specific artifact revision. */
+type LocalRef = z.infer<typeof LocalRefSchema>;
+/** Pointer to external evidence outside the artifact store. */
+type EvidenceRef = z.infer<typeof EvidenceRefSchema>;
+/** Union of all valid relation-target reference classes. */
+type ArtifactRelationTarget = z.infer<typeof ArtifactRelationTargetSchema>;
+/** Union of all valid relation-target reference classes for query filters. Artifact refs may omit revision. */
+type ArtifactRelationQueryTarget = z.infer<typeof ArtifactRelationQueryTargetSchema>;
+/** A typed directional link from an artifact to a relation target. */
+type ArtifactRelation = z.infer<typeof ArtifactRelationSchema>;
+/** Ordered confidence level for an artifact assertion. */
+type ConfidenceLevel = z.infer<typeof ConfidenceLevelSchema>;
+/** One piece of evidence contributing to overall artifact confidence. */
+type ConfidenceBasis = z.infer<typeof ConfidenceBasisSchema>;
+/** Aggregated confidence metadata for an artifact revision. */
+type ConfidenceMetadata = z.infer<typeof ConfidenceMetadataSchema>;
+/** A typed observation attached to an artifact revision. */
+type ArtifactObservation$1 = z.infer<typeof ArtifactObservationSchema>;
+/** Human-readable rendering hints for an artifact revision. */
+type ArtifactRepresentations = z.infer<typeof ArtifactRepresentationsSchema>;
+/**
+ * A complete, immutable artifact revision.
+ *
+ * The generic `TData` parameter narrows the `data` field to a specific
+ * kind-validated shape, while defaulting to `Record<string, unknown>` for
+ * untyped call sites.
+ * @typeParam TData - Kind-specific payload type for the `data` field.
+ */
+type ArtifactRevision$1<TData extends Record<string, unknown> = Record<string, unknown>> = Omit<z.infer<typeof ArtifactRevisionSchema>, 'data'> & {
+  data: TData;
+};
+/** Conflict resolution strategy for an artifact kind. */
+type ArtifactConflictPolicy = z.infer<typeof ArtifactConflictPolicySchema>;
+/** Registration record for a named artifact kind. */
+type ArtifactKindRegistration$1 = z.infer<typeof ArtifactKindRegistrationSchema>;
+/** Registration record for a named relation type. */
+type RelationTypeRegistration$1 = z.infer<typeof RelationTypeRegistrationSchema>;
+/** Query parameters for retrieving artifact revisions from the store. */
+type ArtifactQueryRequest = z.infer<typeof ArtifactQueryRequestSchema>;
+/** Request to compare two artifact revisions. */
+type ArtifactCompareRequest = z.infer<typeof ArtifactCompareRequestSchema>;
+/** Result of comparing two artifact revisions. */
+type ArtifactCompareResponse = z.infer<typeof ArtifactCompareResponseSchema>;
+//#endregion
+//#region core/contracts/src/materialization/schemas.d.ts
+/** View role that a projected field may declare for view rendering. */
+declare const ProjectedFieldViewRoleSchema: z.ZodEnum<{
+  title: "title";
+  summary: "summary";
+}>;
+/**
+ * Discriminated target that a surface binding maps to on the external provider.
+ *
+ * Each variant carries the fields required to identify the target element
+ * on the provider surface:
+ *
+ * - `'label'` — a label or tag on the issue/work item (optional prefix filter)
+ * - `'field'` — a named custom field on the work item (optional external field id)
+ * - `'issue-type'` — a named issue type classification (optional external type id)
+ * - `'body-fragment'` — a named slot in the issue or PR body
+ * - `'comment'` — a structured comment rendered from a template string
+ */
+declare const SurfaceBindingTargetSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  kind: z.ZodLiteral<"label">;
+  prefix: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  kind: z.ZodLiteral<"field">;
+  name: z.ZodString;
+  fieldId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  kind: z.ZodLiteral<"issue-type">;
+  name: z.ZodString;
+  typeId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  kind: z.ZodLiteral<"body-fragment">;
+  slot: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  kind: z.ZodLiteral<"comment">;
+  template: z.ZodString;
+}, z.core.$strip>], "kind">;
+/**
+ * Serializable registration record for a surface binding.
+ *
+ * Surface binding registrations describe how a framework namespace maps to a
+ * provider-specific surface element (field, label, issue type, etc.).
+ * Registrations are declared by product extensions and consumed by
+ * materialization adapters at sync time.
+ *
+ * The `id` field is a dot-namespaced stable string (e.g. `'github.status.field'`).
+ */
+declare const SurfaceBindingRegistrationSchema: z.ZodObject<{
+  id: z.ZodString;
+  provider: z.ZodString;
+  namespace: z.ZodString;
+  target: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"label">;
+    prefix: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"field">;
+    name: z.ZodString;
+    fieldId: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"issue-type">;
+    name: z.ZodString;
+    typeId: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"body-fragment">;
+    slot: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"comment">;
+    template: z.ZodString;
+  }, z.core.$strip>], "kind">;
+  appliesTo: z.ZodArray<z.ZodEnum<{
+    artifact: "artifact";
+    workpiece: "workpiece";
+    surface: "surface";
+  }>>;
+  valueMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  description: z.ZodOptional<z.ZodString>;
+  params: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
+}, z.core.$strip>;
+/** Serializable registration record for a surface binding. */
+type SurfaceBindingRegistration = z.infer<typeof SurfaceBindingRegistrationSchema>;
+/** Discriminated target on the external provider surface. */
+type SurfaceBindingTarget = z.infer<typeof SurfaceBindingTargetSchema>;
+/** Semantic hint for provider-neutral artifact projected fields. */
+declare const ProjectedFieldSemanticSchema: z.ZodEnum<{
+  status: "status";
+  workflow: "workflow";
+  priority: "priority";
+}>;
+/**
+ * A provider-neutral field from artifact data that may be projected to an
+ * external surface or used in view rendering.
+ *
+ * Extended fields for the view projection system:
+ * - `fromLevel` — the minimum detail level at which this field becomes
+ *   available. Levels order monotonically: `link < summary < full`. Omitted
+ *   `fromLevel` means `full` during generic resolution.
+ * - `viewRole` — declares whether this field serves as the artifact's display
+ *   `title` or `summary` in rendered views. At most one of each role may be
+ *   declared per artifact kind.
+ */
+declare const ProjectedFieldSchema: z.ZodObject<{
+  path: z.ZodString;
+  semantic: z.ZodOptional<z.ZodEnum<{
+    status: "status";
+    workflow: "workflow";
+    priority: "priority";
+  }>>;
+  fromLevel: z.ZodOptional<z.ZodEnum<{
+    link: "link";
+    summary: "summary";
+    full: "full";
+  }>>;
+  viewRole: z.ZodOptional<z.ZodEnum<{
+    title: "title";
+    summary: "summary";
+  }>>;
+}, z.core.$strip>;
+/** Semantic hint for provider-neutral artifact projected fields. */
+type ProjectedFieldSemantic = z.infer<typeof ProjectedFieldSemanticSchema>;
+/** View role for a projected field. */
+type ProjectedFieldViewRole = z.infer<typeof ProjectedFieldViewRoleSchema>;
+/** A provider-neutral artifact field projection declaration. */
+type ProjectedField = z.infer<typeof ProjectedFieldSchema>;
+/**
+ * Projection policy that controls how an artifact kind surfaces on a provider.
+ *
+ * - `'none'` — the artifact is never materialized to a provider surface
+ * - `'surface'` — the artifact maps to a provider work item or issue
+ * - `'comment'` — the artifact is rendered as a structured comment on an existing item
+ */
+declare const ArtifactProjectionPolicySchema: z.ZodObject<{
+  mode: z.ZodEnum<{
+    none: "none";
+    comment: "comment";
+    surface: "surface";
+  }>;
+  defaultRole: z.ZodOptional<z.ZodEnum<{
+    artifact: "artifact";
+    workpiece: "workpiece";
+  }>>;
+  semanticEvents: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+    created: "created";
+    revised: "revised";
+    "status-changed": "status-changed";
+    "observation-added": "observation-added";
+  }>>>;
+  projectedFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    path: z.ZodString;
+    semantic: z.ZodOptional<z.ZodEnum<{
+      status: "status";
+      workflow: "workflow";
+      priority: "priority";
+    }>>;
+    fromLevel: z.ZodOptional<z.ZodEnum<{
+      link: "link";
+      summary: "summary";
+      full: "full";
+    }>>;
+    viewRole: z.ZodOptional<z.ZodEnum<{
+      title: "title";
+      summary: "summary";
+    }>>;
+  }, z.core.$strip>>>;
+  affordances: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"own-view">;
+  }, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"inline">;
+    hostRelation: z.ZodString;
+    as: z.ZodOptional<z.ZodEnum<{
+      link: "link";
+      summary: "summary";
+      full: "full";
+    }>>;
+  }, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"entry">;
+    via: z.ZodOptional<z.ZodString>;
+    collection: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>], "kind">>>;
+}, z.core.$strip>;
+/** Projection policy that controls how an artifact kind surfaces on a provider. */
+type ArtifactProjectionPolicy$1 = z.infer<typeof ArtifactProjectionPolicySchema>;
+/**
+ * A reference linking a framework artifact to an external provider object.
+ *
+ * `artifactId` and `provider`+`externalId` together form the composite primary
+ * key for a materialization ref. The `surfaceRole` captures whether the artifact
+ * was materialized as the top-level workpiece or as a subordinate artifact record.
+ */
+declare const ArtifactMaterializationRefSchema: z.ZodObject<{
+  artifactId: z.ZodString;
+  provider: z.ZodString;
+  externalId: z.ZodString;
+  externalUrl: z.ZodOptional<z.ZodString>;
+  surfaceRole: z.ZodEnum<{
+    artifact: "artifact";
+    workpiece: "workpiece";
+  }>;
+  lastSyncedRevision: z.ZodOptional<z.ZodString>;
+  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+/** A reference linking a framework artifact to an external provider object. */
+type ArtifactMaterializationRef = z.infer<typeof ArtifactMaterializationRefSchema>;
+//#endregion
+//#region core/contracts/src/artifact/context-resolution.d.ts
+/**
+ * Reasons why a relation target was not resolved during context resolution.
+ *
+ * v1 omits `scope-denied` -- no scope policy seam exists yet.
+ */
+declare const ArtifactContextUnresolvedReasonSchema: z.ZodEnum<{
+  "not-selected": "not-selected";
+  "not-found": "not-found";
+  "depth-exceeded": "depth-exceeded";
+  "unsupported-ref-class": "unsupported-ref-class";
+  "cycle-detected": "cycle-detected";
+}>;
+/** An unresolved reason for a context ref entry. */
+type ArtifactContextUnresolvedReason = z.infer<typeof ArtifactContextUnresolvedReasonSchema>;
+/**
+ * A single entry in the normalized artifact context wire format.
+ *
+ * Each entry records one outbound relation from a source artifact to a
+ * target, along with resolution status and the render hint used.
+ */
+declare const ArtifactContextRefEntrySchema: z.ZodObject<{
+  target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+    kind: z.ZodString;
+    id: z.ZodString;
+    revision: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    refClass: z.ZodDefault<z.ZodLiteral<"local">>;
+    artifact: z.ZodObject<{
+      refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+      kind: z.ZodString;
+      id: z.ZodString;
+      revision: z.ZodString;
+    }, z.core.$strip>;
+    localId: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    refClass: z.ZodDefault<z.ZodLiteral<"evidence">>;
+    kind: z.ZodString;
+    id: z.ZodString;
+    revision: z.ZodOptional<z.ZodString>;
+    locator: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>], "refClass">>;
+  sourceRef: z.ZodObject<{
+    refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+    kind: z.ZodString;
+    id: z.ZodString;
+    revision: z.ZodString;
+  }, z.core.$strip>;
+  relationType: z.ZodString;
+  hint: z.ZodString;
+  status: z.ZodEnum<{
+    resolved: "resolved";
+    unresolved: "unresolved";
+  }>;
+  reason: z.ZodOptional<z.ZodEnum<{
+    "not-selected": "not-selected";
+    "not-found": "not-found";
+    "depth-exceeded": "depth-exceeded";
+    "unsupported-ref-class": "unsupported-ref-class";
+    "cycle-detected": "cycle-detected";
+  }>>;
+}, z.core.$strip>;
+/** A single resolved or unresolved context ref entry. */
+type ArtifactContextRefEntry = z.infer<typeof ArtifactContextRefEntrySchema>;
+/**
+ * Normalized wire format for a resolved artifact context graph.
+ *
+ * Contains the root artifact reference, all encountered relation entries
+ * (both resolved and unresolved), and the pool of resolved artifact
+ * revisions referenced by the entries.
+ */
+declare const ResolvedArtifactContextWireSchema: z.ZodObject<{
+  rootRef: z.ZodObject<{
+    refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+    kind: z.ZodString;
+    id: z.ZodString;
+    revision: z.ZodString;
+  }, z.core.$strip>;
+  refs: z.ZodArray<z.ZodObject<{
+    target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+      refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+      kind: z.ZodString;
+      id: z.ZodString;
+      revision: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      refClass: z.ZodDefault<z.ZodLiteral<"local">>;
+      artifact: z.ZodObject<{
+        refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+        kind: z.ZodString;
+        id: z.ZodString;
+        revision: z.ZodString;
+      }, z.core.$strip>;
+      localId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      refClass: z.ZodDefault<z.ZodLiteral<"evidence">>;
+      kind: z.ZodString;
+      id: z.ZodString;
+      revision: z.ZodOptional<z.ZodString>;
+      locator: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "refClass">>;
+    sourceRef: z.ZodObject<{
+      refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+      kind: z.ZodString;
+      id: z.ZodString;
+      revision: z.ZodString;
+    }, z.core.$strip>;
+    relationType: z.ZodString;
+    hint: z.ZodString;
+    status: z.ZodEnum<{
+      resolved: "resolved";
+      unresolved: "unresolved";
+    }>;
+    reason: z.ZodOptional<z.ZodEnum<{
+      "not-selected": "not-selected";
+      "not-found": "not-found";
+      "depth-exceeded": "depth-exceeded";
+      "unsupported-ref-class": "unsupported-ref-class";
+      "cycle-detected": "cycle-detected";
+    }>>;
+  }, z.core.$strip>>;
+  resolved: z.ZodArray<z.ZodObject<{
+    kind: z.ZodString;
+    id: z.ZodString;
+    revision: z.ZodString;
+    scope: z.ZodObject<{
+      level: z.ZodString;
+      ids: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>;
+    schemaVersion: z.ZodString;
+    data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
+    relations: z.ZodArray<z.ZodObject<{
+      type: z.ZodString;
+      target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+        kind: z.ZodString;
+        id: z.ZodString;
+        revision: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        refClass: z.ZodDefault<z.ZodLiteral<"local">>;
+        artifact: z.ZodObject<{
+          refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+          kind: z.ZodString;
+          id: z.ZodString;
+          revision: z.ZodString;
+        }, z.core.$strip>;
+        localId: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        refClass: z.ZodDefault<z.ZodLiteral<"evidence">>;
+        kind: z.ZodString;
+        id: z.ZodString;
+        revision: z.ZodOptional<z.ZodString>;
+        locator: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>], "refClass">>;
+    }, z.core.$strip>>;
+    confidence: z.ZodOptional<z.ZodObject<{
+      level: z.ZodEnum<{
+        inferred: "inferred";
+        assumed: "assumed";
+        stated: "stated";
+        confirmed: "confirmed";
+        verified: "verified";
+      }>;
+      basis: z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        actor: z.ZodObject<{
+          kind: z.ZodString;
+          id: z.ZodString;
+          displayName: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        timestamp: z.ZodNumber;
+        detail: z.ZodOptional<z.ZodString>;
+        evidenceRef: z.ZodOptional<z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+          refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+          kind: z.ZodString;
+          id: z.ZodString;
+          revision: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+          refClass: z.ZodDefault<z.ZodLiteral<"local">>;
+          artifact: z.ZodObject<{
+            refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+            kind: z.ZodString;
+            id: z.ZodString;
+            revision: z.ZodString;
+          }, z.core.$strip>;
+          localId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+          refClass: z.ZodDefault<z.ZodLiteral<"evidence">>;
+          kind: z.ZodString;
+          id: z.ZodString;
+          revision: z.ZodOptional<z.ZodString>;
+          locator: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], "refClass">>>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    representations: z.ZodOptional<z.ZodObject<{
+      markdown: z.ZodOptional<z.ZodString>;
+      summary: z.ZodOptional<z.ZodString>;
+      plaintext: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    actor: z.ZodObject<{
+      kind: z.ZodString;
+      id: z.ZodString;
+      displayName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    timestamp: z.ZodNumber;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Normalized wire format for a resolved artifact context graph. */
+type ResolvedArtifactContextWire$1 = z.infer<typeof ResolvedArtifactContextWireSchema>;
+//#endregion
+export { ConfidenceLevel as $, ArtifactKindRegistrationSchema as A, ArtifactRelationQueryTarget as B, ArtifactCompareRequest as C, ArtifactConflictPolicy as D, ArtifactCompareResponseSchema as E, ArtifactQueryScope as F, ArtifactRepresentations as G, ArtifactRelationSchema as H, ArtifactQueryScopeSchema as I, ArtifactRevisionSchema as J, ArtifactRepresentationsSchema as K, ArtifactRef$1 as L, ArtifactObservationSchema as M, ArtifactQueryRequest as N, ArtifactConflictPolicySchema as O, ArtifactQueryRequestSchema as P, ConfidenceBasisSchema as Q, ArtifactRefSchema as R, ArtifactActorSchema as S, ArtifactCompareResponse as T, ArtifactRelationTarget as U, ArtifactRelationQueryTargetSchema as V, ArtifactRelationTargetSchema as W, ArtifactScopeSchema as X, ArtifactScope as Y, ConfidenceBasis as Z, SurfaceBindingRegistration as _, ResolvedArtifactContextWire$1 as a, LocalRef as at, SurfaceBindingTargetSchema as b, ArtifactMaterializationRefSchema as c, RelationTypeRegistrationSchema as ct, ProjectedField as d, ConfidenceLevelSchema as et, ProjectedFieldSchema as f, ProjectedFieldViewRoleSchema as g, ProjectedFieldViewRole as h, ArtifactContextUnresolvedReasonSchema as i, EvidenceRefSchema as it, ArtifactObservation$1 as j, ArtifactKindRegistration$1 as k, ArtifactProjectionPolicy$1 as l, ProjectedFieldSemanticSchema as m, ArtifactContextRefEntrySchema as n, ConfidenceMetadataSchema as nt, ResolvedArtifactContextWireSchema as o, LocalRefSchema as ot, ProjectedFieldSemantic as p, ArtifactRevision$1 as q, ArtifactContextUnresolvedReason as r, EvidenceRef as rt, ArtifactMaterializationRef as s, RelationTypeRegistration$1 as st, ArtifactContextRefEntry as t, ConfidenceMetadata as tt, ArtifactProjectionPolicySchema as u, SurfaceBindingRegistrationSchema as v, ArtifactCompareRequestSchema as w, ArtifactActor as x, SurfaceBindingTarget as y, ArtifactRelation as z };