@hyperscale0/adl 1.0.248 → 1.0.251

package/README.md

@@ -10,9 +10,12 @@
 
 # ADL
 
+Read [how Hyperscale fits](https://hyperscale0.ai/docs/runtime.md#how-hyperscale-fits) for provider authority and the shared operation API.
+
 ADL declares provider bindings and the instruction and observation contract for external work. HSX authors money behavior; UDL carries that contract into execution. The runtime owns money accounts, reservations and evidence consumption.
 
-ADL is the translation layer between Hyperscale and the providers underneath it. The provider originates the loan, policy, account or payout and carries its risk; an adapter maps that provider's real lifecycle and schema onto one canonical shape and reports its evidence. Hyperscale never originates anything, so a shape that no real provider exposes does not belong in ADL.
+An adapter maps a real provider's lifecycle and schema onto a canonical shape and
+returns its evidence. Shapes follow real provider contracts.
 
 ## Install
 

package/conformance/insurance-policy-adapter.ts

@@ -0,0 +1,59 @@
+import * as z from "zod";
+import { createProviderAdapterRegistry } from "@hyperscale0/adl";
+
+/** Quote and issuance only. The insurer supplies every commercial decision. */
+export interface InsurancePolicyVocabulary {
+  readonly capability: "insurance_policy";
+  readonly obligation: "insurance_quote" | "insurance_policy";
+  readonly operation:
+    | "insurance.quote"
+    | "insurance.bind"
+    | "insurance.policy.observe";
+  readonly resource: "insurance_quote" | "insurance_policy";
+}
+
+export const insurancePolicyAdapter =
+  createProviderAdapterRegistry<InsurancePolicyVocabulary>()([
+    {
+      provider: "conformance_insurance",
+      capability: "insurance_policy",
+      bindings: { insurance_quote: "strict", insurance_policy: "strict" },
+      operationMap: {
+        "insurance.quote": {
+          operation: "insurance.quote",
+          direction: "tenant_initiated",
+          obligationKind: "insurance_quote",
+          resourceKind: "insurance_quote",
+          resourceIdPath: "quoteId",
+        },
+        "insurance.bind": {
+          operation: "insurance.bind",
+          direction: "tenant_initiated",
+          obligationKind: "insurance_policy",
+          resourceKind: "insurance_policy",
+          resourceIdPath: "policyId",
+        },
+        "insurance.policy.observe": {
+          operation: "insurance.policy.observe",
+          direction: "system_settlement",
+          obligationKind: "insurance_policy",
+          resourceKind: "insurance_policy",
+          resourceIdPath: "policyId",
+        },
+      },
+    },
+  ])[0];
+
+/** Minimal normalized issuance evidence, not a rating or underwriting schema. */
+export function insurancePolicyIssuanceSchema(quoteId: string) {
+  return z.strictObject({
+    provider: z.literal(insurancePolicyAdapter.provider),
+    policyId: z.string().min(1),
+    quoteId: z.literal(quoteId),
+    insurerId: z.string().min(1),
+    state: z.literal("issued"),
+    issuedAt: z.iso.datetime(),
+    effectiveFrom: z.iso.datetime(),
+    effectiveTo: z.iso.datetime(),
+  });
+}

package/docs/authoring-guide.md

@@ -1,11 +1,21 @@
 # Writing a provider adapter in ADL
 
+Read [how Hyperscale fits](https://hyperscale0.ai/docs/runtime.md#how-hyperscale-fits) for provider authority and the shared operation API.
+
 `ProviderAdapter` declares an adapter's identity, operation bindings and subject
 requirements. `BoundaryAdapter` implements dispatch and observation. The runtime
 owns instruction identity and money accounts.
 
 ## Declare the binding
 
+For a domain example, see
+[`conformance/insurance-policy-adapter.ts`](../conformance/insurance-policy-adapter.ts).
+It uses a custom vocabulary for quote, bind and policy observation. A completed
+bind identifies the downstream insurer's issued policy and must correlate with
+the bound quote. An accepted request without issuance evidence remains pending.
+The fixture does not rate a policy, collect premium or register a live engine
+adapter.
+
 Use `createProviderAdapterRegistry` to validate declarations. Each operation map
 key must equal its binding's `operation`. Its `resourceKind` must appear in
 `bindings`. Subject requirements describe required authored fields or attachments;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperscale0/adl",
-  "version": "1.0.248",
+  "version": "1.0.251",
   "description": "The Adapter Declaration Language: generic evidence, provider declarations and conformance.",
   "keywords": [
     "adl",
@@ -63,7 +63,7 @@
     "typecheck": "tsc -p tsconfig.json"
   },
   "dependencies": {
-    "@hyperscale0/udl": "1.0.248",
+    "@hyperscale0/udl": "1.0.251",
     "zod": "4.6.5"
   },
   "devDependencies": {
@@ -76,5 +76,5 @@
     "Amir Ayub",
     "Sara AlBakaawi"
   ],
-  "gitHead": "4c62dd1d7e0f2d210a66e0c5e899f02e84987029"
+  "gitHead": "82a83298f59fbc5ac14bbe837173ed735bdb491c"
 }