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

package/dist/index-XzetMf0e.d.mts

@@ -0,0 +1,817 @@
+import { z } from "zod";
+import * as _$_makaio_core0 from "@makaio/framework/core";
+import * as _$_makaio_contracts0 from "@makaio/framework/contracts";
+
+//#region core/contracts/src/materialization/namespace.d.ts
+/**
+ * Request payload for resolving an artifact view through an affordance.
+ *
+ * Extends {@link ArtifactViewRequestSchema} (`level` + optional `params`)
+ * with the artifact identity and the structural affordance selector — the
+ * resolve RPC reuses the shared view-request shape rather than re-declaring
+ * parallel parameter types.
+ * @param ref - Stable framework artifact identity.
+ * @param level - Requested detail level (`link`, `summary`, or `full`).
+ * @param affordance - Structural affordance selector (own-view, inline, or entry).
+ * @param params - Optional JSON-safe runtime parameters.
+ */
+declare const ArtifactViewResolveRequestSchema: z.ZodObject<{
+  level: z.ZodEnum<{
+    link: "link";
+    full: "full";
+    summary: "summary";
+  }>;
+  params: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
+  ref: z.ZodString;
+  affordance: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"own-view">;
+  }, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"inline">;
+    hostRelation: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"entry">;
+    via: z.ZodOptional<z.ZodString>;
+    collection: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>], "kind">;
+}, z.core.$strip>;
+/** Request payload for resolving an artifact view. */
+type ArtifactViewResolveRequest = z.infer<typeof ArtifactViewResolveRequestSchema>;
+/**
+ * Discriminated response for an artifact view resolve request.
+ *
+ * Exactly three closed shapes:
+ * - `ok` — positive result with the rendered view, its builder version, and
+ *   the exact artifact revision that produced the view.
+ * - `artifact-not-found` — the referenced artifact does not exist.
+ * - `not-rendered` — the artifact exists but the requested affordance is not
+ *   available or the projection policy suppresses rendering.
+ */
+declare const ArtifactViewResolveResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  status: z.ZodLiteral<"ok">;
+  view: z.ZodObject<{
+    title: z.ZodString;
+    summary: z.ZodOptional<z.ZodString>;
+    navigation: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      artifactId: z.ZodOptional<z.ZodString>;
+      url: z.ZodOptional<z.ZodString>;
+      label: z.ZodString;
+    }, z.core.$strip>>>;
+    sections: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"summary">;
+      title: z.ZodString;
+      text: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"properties">;
+      title: z.ZodString;
+      rows: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodString;
+      }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"table">;
+      title: z.ZodString;
+      columns: z.ZodArray<z.ZodString>;
+      rows: z.ZodArray<z.ZodObject<{
+        cells: z.ZodArray<z.ZodString>;
+        link: z.ZodOptional<z.ZodObject<{
+          artifactId: z.ZodOptional<z.ZodString>;
+          url: z.ZodOptional<z.ZodString>;
+          label: z.ZodString;
+        }, z.core.$strip>>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"relations">;
+      title: z.ZodString;
+      groups: z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        items: z.ZodArray<z.ZodObject<{
+          artifactId: z.ZodOptional<z.ZodString>;
+          url: z.ZodOptional<z.ZodString>;
+          label: z.ZodString;
+        }, z.core.$strip>>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"evidence">;
+      title: z.ZodString;
+      items: z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        id: z.ZodString;
+        locator: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"raw">;
+      title: z.ZodString;
+      json: z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"code">;
+      title: z.ZodString;
+      language: z.ZodString;
+      content: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"diagram">;
+      title: z.ZodString;
+      notation: z.ZodLiteral<"mermaid">;
+      source: z.ZodString;
+    }, z.core.$strip>], "type">>;
+  }, z.core.$strip>;
+  builderVersion: z.ZodNumber;
+  sourceRevision: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  status: z.ZodLiteral<"artifact-not-found">;
+  view: z.ZodNull;
+}, z.core.$strip>, z.ZodObject<{
+  status: z.ZodLiteral<"not-rendered">;
+  view: z.ZodNull;
+}, z.core.$strip>], "status">;
+/** Response payload for an artifact view resolve request. */
+type ArtifactViewResolveResponse = z.infer<typeof ArtifactViewResolveResponseSchema>;
+/**
+ * Framework-level materialization bus schemas.
+ *
+ * Defines the RPC and event subjects for framework-level materialization
+ * coordination.
+ * The schema set covers:
+ *
+ * - `surfaceBinding.register` — register a surface binding with the registry (RPC)
+ * - `surfaceBinding.list` — query registered surface bindings (RPC)
+ * - `surfaceBinding.changed` — emitted when a surface binding is added (event)
+ * - `ref.changed` — emitted when a provider materialization ref changes (event)
+ * - `capability.resolved` — emitted when a provider surface capability set is resolved (event)
+ * - `artifact.view.resolve` — resolve an artifact view through an affordance (RPC)
+ *
+ * Product hosts that extend the framework materialization surface should
+ * register a product-owned namespace rather than merging additional subjects
+ * into this one.
+ */
+declare const MaterializationSchemas: {
+  /**
+   * Register a surface binding with the surface binding registry (RPC).
+   * Returns `{ registered: true }` when successfully stored.
+   */
+  'surfaceBinding.register': {
+    request: 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<{
+        workpiece: "workpiece";
+        artifact: "artifact";
+        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>;
+    response: z.ZodObject<{
+      registered: z.ZodBoolean;
+    }, z.core.$strip>;
+  }; /** List registered surface bindings, optionally filtered by id, provider, or namespace (RPC). */
+  'surfaceBinding.list': {
+    request: z.ZodObject<{
+      id: z.ZodOptional<z.ZodString>;
+      provider: z.ZodOptional<z.ZodString>;
+      namespace: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      bindings: z.ZodArray<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<{
+          workpiece: "workpiece";
+          artifact: "artifact";
+          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>>;
+    }, z.core.$strip>;
+  }; /** Emitted when a surface binding registration is added. */
+  'surfaceBinding.changed': z.ZodObject<{
+    id: z.ZodString;
+    provider: z.ZodString;
+  }, z.core.$strip>; /** Emitted when a provider materialization ref is upserted or deleted. */
+  'ref.changed': z.ZodObject<{
+    artifactId: z.ZodString;
+    provider: z.ZodString;
+    externalId: z.ZodString;
+    operation: z.ZodEnum<{
+      deleted: "deleted";
+      upserted: "upserted";
+    }>;
+    origin: z.ZodOptional<z.ZodEnum<{
+      external: "external";
+      factory: "factory";
+    }>>;
+  }, z.core.$strip>; /** Emitted when a provider surface capability set has been resolved. */
+  'capability.resolved': z.ZodObject<{
+    provider: z.ZodString;
+    surface: z.ZodString;
+    capabilities: z.ZodRecord<z.ZodString, z.ZodBoolean>;
+    degraded: z.ZodBoolean;
+  }, z.core.$strip>;
+  /**
+   * Resolve an artifact view through an affordance (RPC).
+   *
+   * Returns one of three closed response shapes: `ok` with the rendered view,
+   * its builder version, and exact source revision; `artifact-not-found`; or
+   * `not-rendered`.
+   */
+  'artifact.view.resolve': {
+    request: z.ZodObject<{
+      level: z.ZodEnum<{
+        link: "link";
+        full: "full";
+        summary: "summary";
+      }>;
+      params: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
+      ref: z.ZodString;
+      affordance: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"own-view">;
+      }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"inline">;
+        hostRelation: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"entry">;
+        via: z.ZodOptional<z.ZodString>;
+        collection: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>], "kind">;
+    }, z.core.$strip>;
+    response: z.ZodDiscriminatedUnion<[z.ZodObject<{
+      status: z.ZodLiteral<"ok">;
+      view: z.ZodObject<{
+        title: z.ZodString;
+        summary: z.ZodOptional<z.ZodString>;
+        navigation: z.ZodOptional<z.ZodArray<z.ZodObject<{
+          artifactId: z.ZodOptional<z.ZodString>;
+          url: z.ZodOptional<z.ZodString>;
+          label: z.ZodString;
+        }, z.core.$strip>>>;
+        sections: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+          type: z.ZodLiteral<"summary">;
+          title: z.ZodString;
+          text: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+          type: z.ZodLiteral<"properties">;
+          title: z.ZodString;
+          rows: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodString;
+          }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+          type: z.ZodLiteral<"table">;
+          title: z.ZodString;
+          columns: z.ZodArray<z.ZodString>;
+          rows: z.ZodArray<z.ZodObject<{
+            cells: z.ZodArray<z.ZodString>;
+            link: z.ZodOptional<z.ZodObject<{
+              artifactId: z.ZodOptional<z.ZodString>;
+              url: z.ZodOptional<z.ZodString>;
+              label: z.ZodString;
+            }, z.core.$strip>>;
+          }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+          type: z.ZodLiteral<"relations">;
+          title: z.ZodString;
+          groups: z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            items: z.ZodArray<z.ZodObject<{
+              artifactId: z.ZodOptional<z.ZodString>;
+              url: z.ZodOptional<z.ZodString>;
+              label: z.ZodString;
+            }, z.core.$strip>>;
+          }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+          type: z.ZodLiteral<"evidence">;
+          title: z.ZodString;
+          items: z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            id: z.ZodString;
+            locator: z.ZodOptional<z.ZodString>;
+          }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+          type: z.ZodLiteral<"raw">;
+          title: z.ZodString;
+          json: z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>;
+        }, z.core.$strip>, z.ZodObject<{
+          type: z.ZodLiteral<"code">;
+          title: z.ZodString;
+          language: z.ZodString;
+          content: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+          type: z.ZodLiteral<"diagram">;
+          title: z.ZodString;
+          notation: z.ZodLiteral<"mermaid">;
+          source: z.ZodString;
+        }, z.core.$strip>], "type">>;
+      }, z.core.$strip>;
+      builderVersion: z.ZodNumber;
+      sourceRevision: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      status: z.ZodLiteral<"artifact-not-found">;
+      view: z.ZodNull;
+    }, z.core.$strip>, z.ZodObject<{
+      status: z.ZodLiteral<"not-rendered">;
+      view: z.ZodNull;
+    }, z.core.$strip>], "status">;
+  };
+};
+/**
+ * Materialization bus namespace.
+ *
+ * Registers the `materialization` namespace with framework-level RPC and event
+ * subjects. Use `MaterializationSubjects` to access typed bus subject
+ * descriptors.
+ */
+declare const MaterializationNamespace: _$_makaio_core0.BusNamespaceDefinition<"materialization", {
+  /**
+   * Register a surface binding with the surface binding registry (RPC).
+   * Returns `{ registered: true }` when successfully stored.
+   */
+  'surfaceBinding.register': {
+    request: 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<{
+        workpiece: "workpiece";
+        artifact: "artifact";
+        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>;
+    response: z.ZodObject<{
+      registered: z.ZodBoolean;
+    }, z.core.$strip>;
+  }; /** List registered surface bindings, optionally filtered by id, provider, or namespace (RPC). */
+  'surfaceBinding.list': {
+    request: z.ZodObject<{
+      id: z.ZodOptional<z.ZodString>;
+      provider: z.ZodOptional<z.ZodString>;
+      namespace: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      bindings: z.ZodArray<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<{
+          workpiece: "workpiece";
+          artifact: "artifact";
+          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>>;
+    }, z.core.$strip>;
+  }; /** Emitted when a surface binding registration is added. */
+  'surfaceBinding.changed': z.ZodObject<{
+    id: z.ZodString;
+    provider: z.ZodString;
+  }, z.core.$strip>; /** Emitted when a provider materialization ref is upserted or deleted. */
+  'ref.changed': z.ZodObject<{
+    artifactId: z.ZodString;
+    provider: z.ZodString;
+    externalId: z.ZodString;
+    operation: z.ZodEnum<{
+      deleted: "deleted";
+      upserted: "upserted";
+    }>;
+    origin: z.ZodOptional<z.ZodEnum<{
+      external: "external";
+      factory: "factory";
+    }>>;
+  }, z.core.$strip>; /** Emitted when a provider surface capability set has been resolved. */
+  'capability.resolved': z.ZodObject<{
+    provider: z.ZodString;
+    surface: z.ZodString;
+    capabilities: z.ZodRecord<z.ZodString, z.ZodBoolean>;
+    degraded: z.ZodBoolean;
+  }, z.core.$strip>;
+  /**
+   * Resolve an artifact view through an affordance (RPC).
+   *
+   * Returns one of three closed response shapes: `ok` with the rendered view,
+   * its builder version, and exact source revision; `artifact-not-found`; or
+   * `not-rendered`.
+   */
+  'artifact.view.resolve': {
+    request: z.ZodObject<{
+      level: z.ZodEnum<{
+        link: "link";
+        full: "full";
+        summary: "summary";
+      }>;
+      params: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
+      ref: z.ZodString;
+      affordance: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"own-view">;
+      }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"inline">;
+        hostRelation: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"entry">;
+        via: z.ZodOptional<z.ZodString>;
+        collection: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>], "kind">;
+    }, z.core.$strip>;
+    response: z.ZodDiscriminatedUnion<[z.ZodObject<{
+      status: z.ZodLiteral<"ok">;
+      view: z.ZodObject<{
+        title: z.ZodString;
+        summary: z.ZodOptional<z.ZodString>;
+        navigation: z.ZodOptional<z.ZodArray<z.ZodObject<{
+          artifactId: z.ZodOptional<z.ZodString>;
+          url: z.ZodOptional<z.ZodString>;
+          label: z.ZodString;
+        }, z.core.$strip>>>;
+        sections: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+          type: z.ZodLiteral<"summary">;
+          title: z.ZodString;
+          text: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+          type: z.ZodLiteral<"properties">;
+          title: z.ZodString;
+          rows: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodString;
+          }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+          type: z.ZodLiteral<"table">;
+          title: z.ZodString;
+          columns: z.ZodArray<z.ZodString>;
+          rows: z.ZodArray<z.ZodObject<{
+            cells: z.ZodArray<z.ZodString>;
+            link: z.ZodOptional<z.ZodObject<{
+              artifactId: z.ZodOptional<z.ZodString>;
+              url: z.ZodOptional<z.ZodString>;
+              label: z.ZodString;
+            }, z.core.$strip>>;
+          }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+          type: z.ZodLiteral<"relations">;
+          title: z.ZodString;
+          groups: z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            items: z.ZodArray<z.ZodObject<{
+              artifactId: z.ZodOptional<z.ZodString>;
+              url: z.ZodOptional<z.ZodString>;
+              label: z.ZodString;
+            }, z.core.$strip>>;
+          }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+          type: z.ZodLiteral<"evidence">;
+          title: z.ZodString;
+          items: z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            id: z.ZodString;
+            locator: z.ZodOptional<z.ZodString>;
+          }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+          type: z.ZodLiteral<"raw">;
+          title: z.ZodString;
+          json: z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>;
+        }, z.core.$strip>, z.ZodObject<{
+          type: z.ZodLiteral<"code">;
+          title: z.ZodString;
+          language: z.ZodString;
+          content: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+          type: z.ZodLiteral<"diagram">;
+          title: z.ZodString;
+          notation: z.ZodLiteral<"mermaid">;
+          source: z.ZodString;
+        }, z.core.$strip>], "type">>;
+      }, z.core.$strip>;
+      builderVersion: z.ZodNumber;
+      sourceRevision: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      status: z.ZodLiteral<"artifact-not-found">;
+      view: z.ZodNull;
+    }, z.core.$strip>, z.ZodObject<{
+      status: z.ZodLiteral<"not-rendered">;
+      view: z.ZodNull;
+    }, z.core.$strip>], "status">;
+  };
+}>;
+/**
+ * Typed subjects for materialization bus communication.
+ *
+ * Available subjects:
+ * - `MaterializationSubjects['surfaceBinding.register']` — register a surface binding (RPC)
+ * - `MaterializationSubjects['surfaceBinding.list']` — list surface bindings (RPC)
+ * - `MaterializationSubjects['surfaceBinding.changed']` — binding changed event
+ * - `MaterializationSubjects['ref.changed']` — materialization ref changed event
+ * - `MaterializationSubjects['capability.resolved']` — provider capability resolved event
+ * - `MaterializationSubjects['artifact.view.resolve']` — resolve an artifact view (RPC)
+ *
+ * Nested shorthand (via dot-segment nesting):
+ * - `MaterializationSubjects.surfaceBinding.register` — register (RPC)
+ * - `MaterializationSubjects.surfaceBinding.list` — list (RPC)
+ * - `MaterializationSubjects.surfaceBinding.changed` — changed event
+ * - `MaterializationSubjects.ref.changed` — ref changed event
+ * - `MaterializationSubjects.capability.resolved` — capability resolved event
+ * - `MaterializationSubjects.artifact.view.resolve` — resolve artifact view (RPC)
+ */
+declare const MaterializationSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatSubjectDefinitions<"materialization", {
+  /**
+   * Register a surface binding with the surface binding registry (RPC).
+   * Returns `{ registered: true }` when successfully stored.
+   */
+  'surfaceBinding.register': {
+    request: 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<{
+        workpiece: "workpiece";
+        artifact: "artifact";
+        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>;
+    response: z.ZodObject<{
+      registered: z.ZodBoolean;
+    }, z.core.$strip>;
+  }; /** List registered surface bindings, optionally filtered by id, provider, or namespace (RPC). */
+  'surfaceBinding.list': {
+    request: z.ZodObject<{
+      id: z.ZodOptional<z.ZodString>;
+      provider: z.ZodOptional<z.ZodString>;
+      namespace: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      bindings: z.ZodArray<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<{
+          workpiece: "workpiece";
+          artifact: "artifact";
+          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>>;
+    }, z.core.$strip>;
+  }; /** Emitted when a surface binding registration is added. */
+  'surfaceBinding.changed': z.ZodObject<{
+    id: z.ZodString;
+    provider: z.ZodString;
+  }, z.core.$strip>; /** Emitted when a provider materialization ref is upserted or deleted. */
+  'ref.changed': z.ZodObject<{
+    artifactId: z.ZodString;
+    provider: z.ZodString;
+    externalId: z.ZodString;
+    operation: z.ZodEnum<{
+      deleted: "deleted";
+      upserted: "upserted";
+    }>;
+    origin: z.ZodOptional<z.ZodEnum<{
+      external: "external";
+      factory: "factory";
+    }>>;
+  }, z.core.$strip>; /** Emitted when a provider surface capability set has been resolved. */
+  'capability.resolved': z.ZodObject<{
+    provider: z.ZodString;
+    surface: z.ZodString;
+    capabilities: z.ZodRecord<z.ZodString, z.ZodBoolean>;
+    degraded: z.ZodBoolean;
+  }, z.core.$strip>;
+  /**
+   * Resolve an artifact view through an affordance (RPC).
+   *
+   * Returns one of three closed response shapes: `ok` with the rendered view,
+   * its builder version, and exact source revision; `artifact-not-found`; or
+   * `not-rendered`.
+   */
+  'artifact.view.resolve': {
+    request: z.ZodObject<{
+      level: z.ZodEnum<{
+        link: "link";
+        full: "full";
+        summary: "summary";
+      }>;
+      params: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
+      ref: z.ZodString;
+      affordance: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"own-view">;
+      }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"inline">;
+        hostRelation: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"entry">;
+        via: z.ZodOptional<z.ZodString>;
+        collection: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>], "kind">;
+    }, z.core.$strip>;
+    response: z.ZodDiscriminatedUnion<[z.ZodObject<{
+      status: z.ZodLiteral<"ok">;
+      view: z.ZodObject<{
+        title: z.ZodString;
+        summary: z.ZodOptional<z.ZodString>;
+        navigation: z.ZodOptional<z.ZodArray<z.ZodObject<{
+          artifactId: z.ZodOptional<z.ZodString>;
+          url: z.ZodOptional<z.ZodString>;
+          label: z.ZodString;
+        }, z.core.$strip>>>;
+        sections: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+          type: z.ZodLiteral<"summary">;
+          title: z.ZodString;
+          text: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+          type: z.ZodLiteral<"properties">;
+          title: z.ZodString;
+          rows: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodString;
+          }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+          type: z.ZodLiteral<"table">;
+          title: z.ZodString;
+          columns: z.ZodArray<z.ZodString>;
+          rows: z.ZodArray<z.ZodObject<{
+            cells: z.ZodArray<z.ZodString>;
+            link: z.ZodOptional<z.ZodObject<{
+              artifactId: z.ZodOptional<z.ZodString>;
+              url: z.ZodOptional<z.ZodString>;
+              label: z.ZodString;
+            }, z.core.$strip>>;
+          }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+          type: z.ZodLiteral<"relations">;
+          title: z.ZodString;
+          groups: z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            items: z.ZodArray<z.ZodObject<{
+              artifactId: z.ZodOptional<z.ZodString>;
+              url: z.ZodOptional<z.ZodString>;
+              label: z.ZodString;
+            }, z.core.$strip>>;
+          }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+          type: z.ZodLiteral<"evidence">;
+          title: z.ZodString;
+          items: z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            id: z.ZodString;
+            locator: z.ZodOptional<z.ZodString>;
+          }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+          type: z.ZodLiteral<"raw">;
+          title: z.ZodString;
+          json: z.ZodType<_$_makaio_contracts0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, unknown>>;
+        }, z.core.$strip>, z.ZodObject<{
+          type: z.ZodLiteral<"code">;
+          title: z.ZodString;
+          language: z.ZodString;
+          content: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+          type: z.ZodLiteral<"diagram">;
+          title: z.ZodString;
+          notation: z.ZodLiteral<"mermaid">;
+          source: z.ZodString;
+        }, z.core.$strip>], "type">>;
+      }, z.core.$strip>;
+      builderVersion: z.ZodNumber;
+      sourceRevision: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      status: z.ZodLiteral<"artifact-not-found">;
+      view: z.ZodNull;
+    }, z.core.$strip>, z.ZodObject<{
+      status: z.ZodLiteral<"not-rendered">;
+      view: z.ZodNull;
+    }, z.core.$strip>], "status">;
+  };
+}>, "materialization">;
+/** Request payload for registering a surface binding. */
+type SurfaceBindingRegisterRequest = z.infer<(typeof MaterializationSchemas)['surfaceBinding.register']['request']>;
+/** Response payload for registering a surface binding. */
+type SurfaceBindingRegisterResponse = z.infer<(typeof MaterializationSchemas)['surfaceBinding.register']['response']>;
+/** Request payload for listing surface bindings. */
+type SurfaceBindingListRequest = z.infer<(typeof MaterializationSchemas)['surfaceBinding.list']['request']>;
+/** Response payload for listing surface bindings. */
+type SurfaceBindingListResponse = z.infer<(typeof MaterializationSchemas)['surfaceBinding.list']['response']>;
+/** Payload for the surface binding changed event. */
+type SurfaceBindingChangedPayload = z.infer<(typeof MaterializationSchemas)['surfaceBinding.changed']>;
+/** Payload for the materialization ref changed event. */
+type MaterializationRefChangedPayload = z.infer<(typeof MaterializationSchemas)['ref.changed']>;
+/** Payload for the materialization capability resolved event. */
+type MaterializationCapabilityResolvedPayload = z.infer<(typeof MaterializationSchemas)['capability.resolved']>;
+//#endregion
+export { MaterializationCapabilityResolvedPayload as a, MaterializationSchemas as c, SurfaceBindingListRequest as d, SurfaceBindingListResponse as f, ArtifactViewResolveResponseSchema as i, MaterializationSubjects$1 as l, SurfaceBindingRegisterResponse as m, ArtifactViewResolveRequestSchema as n, MaterializationNamespace as o, SurfaceBindingRegisterRequest as p, ArtifactViewResolveResponse as r, MaterializationRefChangedPayload as s, ArtifactViewResolveRequest as t, SurfaceBindingChangedPayload as u };