@makaio/framework 1.0.0-dev-1782138936821 → 1.0.0-dev-1782480236258

package/dist/{index-ekpUAYVC.d.mts → index-0WhPbKnH.d.mts}

@@ -1,4 +1,4 @@
-import { r as ArtifactProjectionPolicy$1 } from "./schemas-CJ2JvA7d.mjs";
+import { r as ArtifactProjectionPolicy$1 } from "./schemas-D512XweP.mjs";
 import { z } from "zod";
 import * as _$_makaio_core0 from "@makaio/framework/core";
 import { MakaioBusLike } from "@makaio/framework/core";
@@ -462,9 +462,9 @@ declare const ArtifactKindRegistrationSchema: z.ZodObject<{
   lifecycle: z.ZodOptional<z.ZodObject<{
     defaultRelevance: z.ZodOptional<z.ZodEnum<{
       active: "active";
+      archived: "archived";
       fading: "fading";
       retired: "retired";
-      archived: "archived";
     }>>;
     decayPolicy: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>>;
@@ -477,8 +477,8 @@ declare const ArtifactKindRegistrationSchema: z.ZodObject<{
       comment: "comment";
     }>;
     defaultRole: z.ZodOptional<z.ZodEnum<{
-      workpiece: "workpiece";
       artifact: "artifact";
+      workpiece: "workpiece";
     }>>;
     semanticEvents: z.ZodOptional<z.ZodArray<z.ZodEnum<{
       created: "created";
@@ -495,6 +495,7 @@ declare const ArtifactKindRegistrationSchema: z.ZodObject<{
       }>>;
     }, z.core.$strip>>>;
   }, 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.
@@ -782,7 +783,7 @@ 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 = z.infer<typeof ArtifactRefSchema>;
+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. */
@@ -827,6 +828,43 @@ type ArtifactCompareRequest = z.infer<typeof ArtifactCompareRequestSchema>;
 /** Result of comparing two artifact revisions. */
 type ArtifactCompareResponse = z.infer<typeof ArtifactCompareResponseSchema>;
 //#endregion
+//#region core/contracts/src/artifact/context-selectors.d.ts
+/** Known render hints for artifact context resolution. */
+declare const ARTIFACT_CONTEXT_RENDER_HINTS: readonly ["inline", "summary", "link", "omit"];
+/** A known render hint from the initial vocabulary. */
+type ArtifactContextKnownRenderHint = (typeof ARTIFACT_CONTEXT_RENDER_HINTS)[number];
+/**
+ * Render hint for artifact context entries.
+ *
+ * Starts with a closed initial vocabulary but the runtime schema accepts
+ * any non-empty string so product code can extend the vocabulary without
+ * a contract change.
+ */
+type ArtifactContextRenderHint = ArtifactContextKnownRenderHint | (string & {});
+/**
+ * Per-relation selector controlling which outbound relations to follow
+ * and how to render the resolved context.
+ */
+interface ArtifactContextRelationSelector {
+  readonly kinds?: readonly string[];
+  readonly hint?: ArtifactContextRenderHint;
+  readonly depth?: number;
+  readonly nested?: ArtifactContextSelector$1;
+}
+/**
+ * Map from relation type to per-relation selector.
+ *
+ * Only relation types present in the map are followed during resolution.
+ * Missing relation types fall through to kind defaults when available.
+ */
+type ArtifactContextSelector$1 = Readonly<Record<string, ArtifactContextRelationSelector>>;
+/** Runtime schema for render hint strings. Accepts any non-empty string. */
+declare const ArtifactContextRenderHintSchema: z.ZodString;
+/** Runtime schema for per-relation selectors. */
+declare const ArtifactContextRelationSelectorSchema: z.ZodType<ArtifactContextRelationSelector, ArtifactContextRelationSelector>;
+/** Runtime schema for selector maps keyed by relation type. */
+declare const ArtifactContextSelectorSchema: z.ZodType<ArtifactContextSelector$1, ArtifactContextSelector$1>;
+//#endregion
 //#region core/contracts/src/artifact/lifecycle-hooks.d.ts
 /**
  * Semantic lifecycle event names used to describe what happened to an artifact
@@ -951,7 +989,7 @@ interface ArtifactReactionHookContext<TBus extends MakaioBusLike = MakaioBusLike
   /** The persisted artifact revision that was just written. */
   readonly artifact: ArtifactRevision$1;
   /** Reference to the previous revision, if this is a revise or status-change. */
-  readonly previous?: ArtifactRef;
+  readonly previous?: ArtifactRef$1;
   /** The observation that was just appended, present only for `afterObservationAdded`. */
   readonly observation?: ArtifactObservation$1;
   /** Kind registration metadata, if the kind has been registered. */
@@ -1162,6 +1200,8 @@ interface ArtifactKindDefinition<TData extends Record<string, unknown>, TScope e
    * defaults.
    */
   readonly projection?: ArtifactProjectionPolicy$1;
+  /** Optional default context selectors for artifact context resolution. */
+  readonly defaultContext?: ArtifactContextSelector$1;
   /**
    * Optional live-only lifecycle hooks owned by this kind definition.
    *
@@ -1268,6 +1308,8 @@ interface DefineArtifactKindOptions<TData extends Record<string, unknown>, TScop
    * external providers.
    */
   readonly projection?: ArtifactProjectionPolicy$1;
+  /** Optional default context selectors for artifact context resolution. */
+  readonly defaultContext?: ArtifactContextSelector$1;
   /**
    * Optional live-only lifecycle hooks. Not included in `toRegistration()`.
    *
@@ -1304,6 +1346,276 @@ interface DefineArtifactKindOptions<TData extends Record<string, unknown>, TScop
  */
 declare function defineArtifactKind<TData extends Record<string, unknown>, TScope extends ArtifactScope = ArtifactScope>(options: DefineArtifactKindOptions<TData, TScope>): ArtifactKindDefinition<TData, TScope>;
 //#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<{
+        assumed: "assumed";
+        inferred: "inferred";
+        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
+//#region core/contracts/src/artifact/context-tree.d.ts
+/**
+ * Hydrated tree representation of a resolved artifact context graph.
+ *
+ * The root is always a resolved node. Children may be resolved or
+ * unresolved depending on resolution status.
+ */
+interface ArtifactContextTree {
+  /** The root artifact node — always resolved. */
+  readonly root: ArtifactContextRootNode;
+  /**
+   * Collect all resolved artifact revisions in depth-first order.
+   * @returns Ordered list of resolved artifact revisions.
+   */
+  flatten(): readonly ArtifactRevision$1[];
+}
+/** A node in the hydrated artifact context tree. */
+type ArtifactContextNode = ResolvedArtifactContextNode | UnresolvedArtifactContextNode;
+/** Shared resolved node fields for root and relation children. */
+interface ResolvedArtifactContextNodeBase {
+  readonly status: 'resolved';
+  /** Artifact reference for this node. */
+  readonly ref: ArtifactRef$1;
+  /** Full artifact revision data. */
+  readonly artifact: ArtifactRevision$1;
+  /** Render hint applied to this node. */
+  readonly hint: ArtifactContextRenderHint;
+  /** Child nodes from this artifact's outbound relations. */
+  readonly children: readonly ArtifactContextNode[];
+}
+/** The resolved root node; it has no parent relation. */
+type ArtifactContextRootNode = ResolvedArtifactContextNodeBase;
+/** A resolved child node with artifact data and relation metadata. */
+interface ResolvedArtifactContextNode extends ResolvedArtifactContextNodeBase {
+  /** Relation type that led to this node from its parent. */
+  readonly relation: string;
+}
+/** An unresolved node representing a relation that could not be followed. */
+interface UnresolvedArtifactContextNode {
+  readonly status: 'unresolved';
+  /** The relation target that was not resolved. */
+  readonly target: ArtifactRelationTarget;
+  /** Relation type that led to this node from its parent. */
+  readonly relation: string;
+  /** Render hint applied to this node. */
+  readonly hint: ArtifactContextRenderHint;
+  /** Reason the target was not resolved. */
+  readonly reason: ArtifactContextUnresolvedReason;
+}
+//#endregion
+//#region core/contracts/src/artifact/hydrate-context.d.ts
+/**
+ * Hydrate a normalized artifact context wire payload into a tree.
+ * @param wire - Normalized resolved artifact context payload.
+ * @returns Tree view with a convenience flatten method.
+ */
+declare function hydrateArtifactContextTree(wire: ResolvedArtifactContextWire$1): ArtifactContextTree;
+//#endregion
 //#region core/contracts/src/artifact/namespace.d.ts
 /**
  * Framework-level artifact bus schemas.
@@ -1342,9 +1654,9 @@ declare const ArtifactSchemas: {
       lifecycle: z.ZodOptional<z.ZodObject<{
         defaultRelevance: z.ZodOptional<z.ZodEnum<{
           active: "active";
+          archived: "archived";
           fading: "fading";
           retired: "retired";
-          archived: "archived";
         }>>;
         decayPolicy: z.ZodOptional<z.ZodString>;
       }, z.core.$strip>>;
@@ -1357,8 +1669,8 @@ declare const ArtifactSchemas: {
           comment: "comment";
         }>;
         defaultRole: z.ZodOptional<z.ZodEnum<{
-          workpiece: "workpiece";
           artifact: "artifact";
+          workpiece: "workpiece";
         }>>;
         semanticEvents: z.ZodOptional<z.ZodArray<z.ZodEnum<{
           created: "created";
@@ -1375,6 +1687,7 @@ declare const ArtifactSchemas: {
           }>>;
         }, z.core.$strip>>>;
       }, 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>;
     response: z.ZodObject<{
       registered: z.ZodBoolean;
@@ -1405,9 +1718,9 @@ declare const ArtifactSchemas: {
         lifecycle: z.ZodOptional<z.ZodObject<{
           defaultRelevance: z.ZodOptional<z.ZodEnum<{
             active: "active";
+            archived: "archived";
             fading: "fading";
             retired: "retired";
-            archived: "archived";
           }>>;
           decayPolicy: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
@@ -1420,8 +1733,8 @@ declare const ArtifactSchemas: {
             comment: "comment";
           }>;
           defaultRole: z.ZodOptional<z.ZodEnum<{
-            workpiece: "workpiece";
             artifact: "artifact";
+            workpiece: "workpiece";
           }>>;
           semanticEvents: z.ZodOptional<z.ZodArray<z.ZodEnum<{
             created: "created";
@@ -1438,6 +1751,7 @@ declare const ArtifactSchemas: {
             }>>;
           }, z.core.$strip>>>;
         }, 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>>;
     }, z.core.$strip>;
   }; /** Register a new relation type with the artifact service (RPC). */
@@ -1487,12 +1801,11 @@ declare const ArtifactSchemas: {
     request: z.ZodObject<{
       data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
       kind: z.ZodString;
-      createdAt: z.ZodOptional<z.ZodNumber>;
-      schemaVersion: z.ZodString;
       scope: z.ZodObject<{
         level: z.ZodString;
         ids: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
       }, z.core.$strip>;
+      schemaVersion: z.ZodString;
       actor: z.ZodObject<{
         kind: z.ZodString;
         id: z.ZodString;
@@ -1567,6 +1880,7 @@ declare const ArtifactSchemas: {
         summary: z.ZodOptional<z.ZodString>;
         plaintext: z.ZodOptional<z.ZodString>;
       }, z.core.$strip>>;
+      createdAt: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     response: z.ZodObject<{
       artifact: z.ZodObject<{
@@ -1669,12 +1983,11 @@ declare const ArtifactSchemas: {
       revision: z.ZodObject<{
         data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
         kind: z.ZodString;
-        createdAt: z.ZodOptional<z.ZodNumber>;
-        schemaVersion: z.ZodString;
         scope: z.ZodObject<{
           level: z.ZodString;
           ids: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         }, z.core.$strip>;
+        schemaVersion: z.ZodString;
         actor: z.ZodObject<{
           kind: z.ZodString;
           id: z.ZodString;
@@ -1749,6 +2062,7 @@ declare const ArtifactSchemas: {
           summary: z.ZodOptional<z.ZodString>;
           plaintext: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
+        createdAt: z.ZodOptional<z.ZodNumber>;
       }, z.core.$strip>;
     }, z.core.$strip>;
     response: z.ZodObject<{
@@ -2275,6 +2589,157 @@ declare const ArtifactSchemas: {
       }, z.core.$strip>;
       changedPaths: z.ZodArray<z.ZodString>;
     }, z.core.$strip>;
+  }; /** Resolve a selector-driven outbound artifact context graph (RPC). */
+  resolveContext: {
+    request: z.ZodObject<{
+      ref: z.ZodObject<{
+        refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+        kind: z.ZodString;
+        id: z.ZodString;
+        revision: z.ZodString;
+      }, z.core.$strip>;
+      selectors: 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>>>>>;
+      maxDepth: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      context: 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<{
+              assumed: "assumed";
+              inferred: "inferred";
+              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>;
+    }, z.core.$strip>;
   }; /** Emitted when a new artifact is created. */
   created: z.ZodObject<{
     artifact: z.ZodObject<{
@@ -2590,9 +3055,9 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
       lifecycle: z.ZodOptional<z.ZodObject<{
         defaultRelevance: z.ZodOptional<z.ZodEnum<{
           active: "active";
+          archived: "archived";
           fading: "fading";
           retired: "retired";
-          archived: "archived";
         }>>;
         decayPolicy: z.ZodOptional<z.ZodString>;
       }, z.core.$strip>>;
@@ -2605,8 +3070,8 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
           comment: "comment";
         }>;
         defaultRole: z.ZodOptional<z.ZodEnum<{
-          workpiece: "workpiece";
           artifact: "artifact";
+          workpiece: "workpiece";
         }>>;
         semanticEvents: z.ZodOptional<z.ZodArray<z.ZodEnum<{
           created: "created";
@@ -2623,6 +3088,7 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
           }>>;
         }, z.core.$strip>>>;
       }, 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>;
     response: z.ZodObject<{
       registered: z.ZodBoolean;
@@ -2653,9 +3119,9 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
         lifecycle: z.ZodOptional<z.ZodObject<{
           defaultRelevance: z.ZodOptional<z.ZodEnum<{
             active: "active";
+            archived: "archived";
             fading: "fading";
             retired: "retired";
-            archived: "archived";
           }>>;
           decayPolicy: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
@@ -2668,8 +3134,8 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
             comment: "comment";
           }>;
           defaultRole: z.ZodOptional<z.ZodEnum<{
-            workpiece: "workpiece";
             artifact: "artifact";
+            workpiece: "workpiece";
           }>>;
           semanticEvents: z.ZodOptional<z.ZodArray<z.ZodEnum<{
             created: "created";
@@ -2686,6 +3152,7 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
             }>>;
           }, z.core.$strip>>>;
         }, 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>>;
     }, z.core.$strip>;
   }; /** Register a new relation type with the artifact service (RPC). */
@@ -2735,12 +3202,11 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
     request: z.ZodObject<{
       data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
       kind: z.ZodString;
-      createdAt: z.ZodOptional<z.ZodNumber>;
-      schemaVersion: z.ZodString;
       scope: z.ZodObject<{
         level: z.ZodString;
         ids: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
       }, z.core.$strip>;
+      schemaVersion: z.ZodString;
       actor: z.ZodObject<{
         kind: z.ZodString;
         id: z.ZodString;
@@ -2815,6 +3281,7 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
         summary: z.ZodOptional<z.ZodString>;
         plaintext: z.ZodOptional<z.ZodString>;
       }, z.core.$strip>>;
+      createdAt: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     response: z.ZodObject<{
       artifact: z.ZodObject<{
@@ -2917,12 +3384,11 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
       revision: z.ZodObject<{
         data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
         kind: z.ZodString;
-        createdAt: z.ZodOptional<z.ZodNumber>;
-        schemaVersion: z.ZodString;
         scope: z.ZodObject<{
           level: z.ZodString;
           ids: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         }, z.core.$strip>;
+        schemaVersion: z.ZodString;
         actor: z.ZodObject<{
           kind: z.ZodString;
           id: z.ZodString;
@@ -2997,6 +3463,7 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
           summary: z.ZodOptional<z.ZodString>;
           plaintext: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
+        createdAt: z.ZodOptional<z.ZodNumber>;
       }, z.core.$strip>;
     }, z.core.$strip>;
     response: z.ZodObject<{
@@ -3523,6 +3990,157 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
       }, z.core.$strip>;
       changedPaths: z.ZodArray<z.ZodString>;
     }, z.core.$strip>;
+  }; /** Resolve a selector-driven outbound artifact context graph (RPC). */
+  resolveContext: {
+    request: z.ZodObject<{
+      ref: z.ZodObject<{
+        refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+        kind: z.ZodString;
+        id: z.ZodString;
+        revision: z.ZodString;
+      }, z.core.$strip>;
+      selectors: 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>>>>>;
+      maxDepth: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      context: 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<{
+              assumed: "assumed";
+              inferred: "inferred";
+              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>;
+    }, z.core.$strip>;
   }; /** Emitted when a new artifact is created. */
   created: z.ZodObject<{
     artifact: z.ZodObject<{
@@ -3822,6 +4440,7 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
  * - `ArtifactSubjects.resolve` — resolve artifact by ref (RPC)
  * - `ArtifactSubjects.query` — query artifacts (RPC)
  * - `ArtifactSubjects.compare` — compare two revisions (RPC)
+ * - `ArtifactSubjects.resolveContext` — resolve artifact context graph (RPC)
  * - `ArtifactSubjects.created` — artifact created event
  * - `ArtifactSubjects.revised` — artifact revised event
  * - `ArtifactSubjects['relation.added']` — relation added event
@@ -3851,9 +4470,9 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
       lifecycle: z.ZodOptional<z.ZodObject<{
         defaultRelevance: z.ZodOptional<z.ZodEnum<{
           active: "active";
+          archived: "archived";
           fading: "fading";
           retired: "retired";
-          archived: "archived";
         }>>;
         decayPolicy: z.ZodOptional<z.ZodString>;
       }, z.core.$strip>>;
@@ -3866,8 +4485,8 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
           comment: "comment";
         }>;
         defaultRole: z.ZodOptional<z.ZodEnum<{
-          workpiece: "workpiece";
           artifact: "artifact";
+          workpiece: "workpiece";
         }>>;
         semanticEvents: z.ZodOptional<z.ZodArray<z.ZodEnum<{
           created: "created";
@@ -3884,6 +4503,7 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
           }>>;
         }, z.core.$strip>>>;
       }, 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>;
     response: z.ZodObject<{
       registered: z.ZodBoolean;
@@ -3914,9 +4534,9 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
         lifecycle: z.ZodOptional<z.ZodObject<{
           defaultRelevance: z.ZodOptional<z.ZodEnum<{
             active: "active";
+            archived: "archived";
             fading: "fading";
             retired: "retired";
-            archived: "archived";
           }>>;
           decayPolicy: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
@@ -3929,8 +4549,8 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
             comment: "comment";
           }>;
           defaultRole: z.ZodOptional<z.ZodEnum<{
-            workpiece: "workpiece";
             artifact: "artifact";
+            workpiece: "workpiece";
           }>>;
           semanticEvents: z.ZodOptional<z.ZodArray<z.ZodEnum<{
             created: "created";
@@ -3947,6 +4567,7 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
             }>>;
           }, z.core.$strip>>>;
         }, 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>>;
     }, z.core.$strip>;
   }; /** Register a new relation type with the artifact service (RPC). */
@@ -3996,12 +4617,11 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
     request: z.ZodObject<{
       data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
       kind: z.ZodString;
-      createdAt: z.ZodOptional<z.ZodNumber>;
-      schemaVersion: z.ZodString;
       scope: z.ZodObject<{
         level: z.ZodString;
         ids: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
       }, z.core.$strip>;
+      schemaVersion: z.ZodString;
       actor: z.ZodObject<{
         kind: z.ZodString;
         id: z.ZodString;
@@ -4076,6 +4696,7 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
         summary: z.ZodOptional<z.ZodString>;
         plaintext: z.ZodOptional<z.ZodString>;
       }, z.core.$strip>>;
+      createdAt: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     response: z.ZodObject<{
       artifact: z.ZodObject<{
@@ -4178,12 +4799,11 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
       revision: z.ZodObject<{
         data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
         kind: z.ZodString;
-        createdAt: z.ZodOptional<z.ZodNumber>;
-        schemaVersion: z.ZodString;
         scope: z.ZodObject<{
           level: z.ZodString;
           ids: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         }, z.core.$strip>;
+        schemaVersion: z.ZodString;
         actor: z.ZodObject<{
           kind: z.ZodString;
           id: z.ZodString;
@@ -4258,6 +4878,7 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
           summary: z.ZodOptional<z.ZodString>;
           plaintext: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
+        createdAt: z.ZodOptional<z.ZodNumber>;
       }, z.core.$strip>;
     }, z.core.$strip>;
     response: z.ZodObject<{
@@ -4784,6 +5405,157 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
       }, z.core.$strip>;
       changedPaths: z.ZodArray<z.ZodString>;
     }, z.core.$strip>;
+  }; /** Resolve a selector-driven outbound artifact context graph (RPC). */
+  resolveContext: {
+    request: z.ZodObject<{
+      ref: z.ZodObject<{
+        refClass: z.ZodDefault<z.ZodLiteral<"artifact">>;
+        kind: z.ZodString;
+        id: z.ZodString;
+        revision: z.ZodString;
+      }, z.core.$strip>;
+      selectors: 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>>>>>;
+      maxDepth: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      context: 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<{
+              assumed: "assumed";
+              inferred: "inferred";
+              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>;
+    }, z.core.$strip>;
   }; /** Emitted when a new artifact is created. */
   created: z.ZodObject<{
     artifact: z.ZodObject<{
@@ -5100,6 +5872,10 @@ type ArtifactResolveRequest = z.infer<(typeof ArtifactSchemas)['resolve']['reque
 type ArtifactResolveResponse = z.infer<(typeof ArtifactSchemas)['resolve']['response']>;
 /** Response payload for querying artifacts. */
 type ArtifactQueryResponse = z.infer<(typeof ArtifactSchemas)['query']['response']>;
+/** Request payload for resolving artifact context. */
+type ArtifactResolveContextRequest = z.infer<(typeof ArtifactSchemas)['resolveContext']['request']>;
+/** Response payload for resolving artifact context. */
+type ArtifactResolveContextResponse = z.infer<(typeof ArtifactSchemas)['resolveContext']['response']>;
 /** Payload for the artifact created event. */
 type ArtifactCreatedPayload = z.infer<(typeof ArtifactSchemas)['created']>;
 /** Payload for the artifact revised event. */
@@ -5113,4 +5889,4 @@ type ArtifactStatusChangedPayload = z.infer<(typeof ArtifactSchemas)['status.cha
 /** Payload for the kind registration changed event. */
 type ArtifactKindChangedPayload = z.infer<(typeof ArtifactSchemas)['kind.changed']>;
 //#endregion
-export { ArtifactObservationSchema as $, ArtifactDraft as A, BeforeArtifactHookRegistration as B, ArtifactStatusChangedPayload as C, ConfidenceMetadataSchema as Ct, ArtifactKindDefinition as D, LocalRefSchema as Dt, ArtifactDataOf as E, LocalRef as Et, ArtifactLifecycleHookRegistration$1 as F, ArtifactCompareRequestSchema as G, ArtifactActor as H, ArtifactLifecycleSemanticEvent as I, ArtifactConflictPolicy as J, ArtifactCompareResponse as K, ArtifactReactionHookContext as L, ArtifactHookFilter as M, ArtifactLifecycleHookDefinition as N, ArtifactOf as O, RelationTypeRegistration$1 as Ot, ArtifactLifecycleHookEvent as P, ArtifactObservation$1 as Q, ArtifactReactionHookRegistration as R, ArtifactSchemas as S, ConfidenceMetadata as St, AnyArtifactKindDefinition as T, EvidenceRefSchema as Tt, ArtifactActorSchema as U, defineArtifactLifecycleHooks as V, ArtifactCompareRequest as W, ArtifactKindRegistration$1 as X, ArtifactConflictPolicySchema as Y, ArtifactKindRegistrationSchema as Z, ArtifactResolveRequest as _, ArtifactScopeSchema as _t, ArtifactKindListRequest as a, ArtifactRefSchema as at, ArtifactReviseResponse as b, ConfidenceLevel as bt, ArtifactKindRegisterResponse as c, ArtifactRelationQueryTargetSchema as ct, ArtifactQueryResponse as d, ArtifactRelationTargetSchema as dt, ArtifactQueryRequest as et, ArtifactRelationAddedPayload as f, ArtifactRepresentations as ft, ArtifactRelationTypeRegisterResponse as g, ArtifactScope as gt, ArtifactRelationTypeRegisterRequest as h, ArtifactRevisionSchema as ht, ArtifactKindChangedPayload as i, ArtifactRef as it, ArtifactDraftPatch as j, defineArtifactKind as k, RelationTypeRegistrationSchema as kt, ArtifactNamespace as l, ArtifactRelationSchema as lt, ArtifactRelationTypeListResponse as m, ArtifactRevision$1 as mt, ArtifactCreateResponse as n, ArtifactQueryScope as nt, ArtifactKindListResponse as o, ArtifactRelation as ot, ArtifactRelationTypeListRequest as p, ArtifactRepresentationsSchema as pt, ArtifactCompareResponseSchema as q, ArtifactCreatedPayload as r, ArtifactQueryScopeSchema as rt, ArtifactKindRegisterRequest as s, ArtifactRelationQueryTarget as st, ArtifactCreateRequest as t, ArtifactQueryRequestSchema as tt, ArtifactObservationAddedPayload as u, ArtifactRelationTarget as ut, ArtifactResolveResponse as v, ConfidenceBasis as vt, ArtifactSubjects$1 as w, EvidenceRef as wt, ArtifactRevisedPayload as x, ConfidenceLevelSchema as xt, ArtifactReviseRequest as y, ConfidenceBasisSchema as yt, BeforeArtifactHookContext as z };
+export { BeforeArtifactHookContext as $, ArtifactContextTree as A, ArtifactRelationQueryTargetSchema as At, ArtifactDataOf as B, ConfidenceBasis as Bt, ArtifactRevisedPayload as C, ArtifactQueryRequestSchema as Ct, hydrateArtifactContextTree as D, ArtifactRefSchema as Dt, ArtifactSubjects$1 as E, ArtifactRef$1 as Et, ArtifactContextUnresolvedReason as F, ArtifactRepresentationsSchema as Ft, ArtifactDraftPatch as G, ConfidenceMetadataSchema as Gt, ArtifactOf as H, ConfidenceLevel as Ht, ArtifactContextUnresolvedReasonSchema as I, ArtifactRevision$1 as It, ArtifactLifecycleHookEvent as J, LocalRef as Jt, ArtifactHookFilter as K, EvidenceRef as Kt, ResolvedArtifactContextWire$1 as L, ArtifactRevisionSchema as Lt, UnresolvedArtifactContextNode as M, ArtifactRelationTarget as Mt, ArtifactContextRefEntry as N, ArtifactRelationTargetSchema as Nt, ArtifactContextNode as O, ArtifactRelation as Ot, ArtifactContextRefEntrySchema as P, ArtifactRepresentations as Pt, ArtifactReactionHookRegistration as Q, ResolvedArtifactContextWireSchema as R, ArtifactScope as Rt, ArtifactReviseResponse as S, ArtifactQueryRequest as St, ArtifactStatusChangedPayload as T, ArtifactQueryScopeSchema as Tt, defineArtifactKind as U, ConfidenceLevelSchema as Ut, ArtifactKindDefinition as V, ConfidenceBasisSchema as Vt, ArtifactDraft as W, ConfidenceMetadata as Wt, ArtifactLifecycleSemanticEvent as X, RelationTypeRegistration$1 as Xt, ArtifactLifecycleHookRegistration$1 as Y, LocalRefSchema as Yt, ArtifactReactionHookContext as Z, RelationTypeRegistrationSchema as Zt, ArtifactResolveContextRequest as _, ArtifactConflictPolicySchema as _t, ArtifactKindListRequest as a, ArtifactContextRelationSelectorSchema as at, ArtifactResolveResponse as b, ArtifactObservation$1 as bt, ArtifactKindRegisterResponse as c, ArtifactContextSelector$1 as ct, ArtifactQueryResponse as d, ArtifactActorSchema as dt, BeforeArtifactHookRegistration as et, ArtifactRelationAddedPayload as f, ArtifactCompareRequest as ft, ArtifactRelationTypeRegisterResponse as g, ArtifactConflictPolicy as gt, ArtifactRelationTypeRegisterRequest as h, ArtifactCompareResponseSchema as ht, ArtifactKindChangedPayload as i, ArtifactContextRelationSelector as it, ResolvedArtifactContextNode as j, ArtifactRelationSchema as jt, ArtifactContextRootNode as k, ArtifactRelationQueryTarget as kt, ArtifactNamespace as l, ArtifactContextSelectorSchema as lt, ArtifactRelationTypeListResponse as m, ArtifactCompareResponse as mt, ArtifactCreateResponse as n, ARTIFACT_CONTEXT_RENDER_HINTS as nt, ArtifactKindListResponse as o, ArtifactContextRenderHint as ot, ArtifactRelationTypeListRequest as p, ArtifactCompareRequestSchema as pt, ArtifactLifecycleHookDefinition as q, EvidenceRefSchema as qt, ArtifactCreatedPayload as r, ArtifactContextKnownRenderHint as rt, ArtifactKindRegisterRequest as s, ArtifactContextRenderHintSchema as st, ArtifactCreateRequest as t, defineArtifactLifecycleHooks as tt, ArtifactObservationAddedPayload as u, ArtifactActor as ut, ArtifactResolveContextResponse as v, ArtifactKindRegistration$1 as vt, ArtifactSchemas as w, ArtifactQueryScope as wt, ArtifactReviseRequest as x, ArtifactObservationSchema as xt, ArtifactResolveRequest as y, ArtifactKindRegistrationSchema as yt, AnyArtifactKindDefinition as z, ArtifactScopeSchema as zt };