@yanib/reverb-adapter-sdk 0.1.0

package/LICENSE

@@ -0,0 +1,202 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 YanibHQ
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+

package/README.md

@@ -0,0 +1,21 @@
+# @yanib/reverb-adapter-sdk
+
+Contract-adapter interfaces, validation, and admission helpers for Reverb.
+
+## Installation
+
+```bash
+pnpm add --save-exact @yanib/reverb-adapter-sdk@0.1.0
+```
+
+Import only the documented package root. See the
+[public package API](https://github.com/YanibHQ/reverb-impact/blob/main/docs/api/public-packages.md)
+and [compatibility policy](https://github.com/YanibHQ/reverb-impact/blob/main/docs/compatibility/versioning.md)
+before embedding Reverb in a host.
+
+Reverb 0.x is a pre-1.0 release line. Pin an exact version and review release metadata before
+upgrading.
+
+## License
+
+Apache-2.0

package/dist/admission.d.ts

@@ -0,0 +1,15 @@
+import type { AdapterAdmissionReport, AdapterManifest, AdmissionCheck } from './types.js';
+export interface CreateAdmissionReportInput {
+    readonly manifest: AdapterManifest;
+    readonly demand: string;
+    readonly designPartner?: string;
+    readonly identitySummary: string;
+    readonly compatibilitySummary: string;
+    readonly evidenceRendering: string;
+    readonly latencyResourceSummary?: string;
+    readonly dependenciesAndLicenses?: readonly string[];
+    readonly checks: readonly AdmissionCheck[];
+    readonly realLabelledCorpusState?: 'absent' | 'available';
+}
+export declare function createAdmissionReport(input: CreateAdmissionReportInput): AdapterAdmissionReport;
+//# sourceMappingURL=admission.d.ts.map

package/dist/admission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admission.d.ts","sourceRoot":"","sources":["../src/admission.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG1F,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;IAC3C,QAAQ,CAAC,uBAAuB,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;CAC3D;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,GAAG,sBAAsB,CA2B/F"}

package/dist/admission.js

@@ -0,0 +1,29 @@
+import { contentHash, hashCanonical } from '@yanib/reverb-domain';
+import { validateAdapterManifest } from './validation.js';
+export function createAdmissionReport(input) {
+    const manifest = validateAdapterManifest(input.manifest);
+    const withoutHash = {
+        schema: 'reverb.adapter-admission',
+        schemaVersion: '1.0',
+        adapterId: manifest.id,
+        adapterVersion: manifest.version,
+        identityVersion: manifest.identityVersion,
+        demand: input.demand,
+        designPartner: input.designPartner ?? 'none',
+        identitySummary: input.identitySummary,
+        compatibilitySummary: input.compatibilitySummary,
+        evidenceRendering: input.evidenceRendering,
+        latencyResourceSummary: input.latencyResourceSummary ??
+            `timeout=${manifest.resourceBudget.timeoutMs}ms memory=${manifest.resourceBudget.memoryMiB}MiB output=${manifest.resourceBudget.maximumOutputBytes}B`,
+        dependenciesAndLicenses: input.dependenciesAndLicenses ??
+            manifest.externalTools.map((tool) => `${tool.id}@${tool.version}: ${tool.license}`),
+        limitations: manifest.limitations,
+        maintainer: manifest.maintainer,
+        checks: [...input.checks].sort((left, right) => left.id.localeCompare(right.id)),
+        realLabelledCorpusState: input.realLabelledCorpusState ?? 'absent',
+        promotionState: 'UNMEASURED',
+        deliveryReady: false,
+    };
+    return { ...withoutHash, outputHash: contentHash(hashCanonical(withoutHash)) };
+}
+//# sourceMappingURL=admission.js.map

package/dist/admission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admission.js","sourceRoot":"","sources":["../src/admission.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGlE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAe1D,MAAM,UAAU,qBAAqB,CAAC,KAAiC;IACrE,MAAM,QAAQ,GAAG,uBAAuB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACzD,MAAM,WAAW,GAAG;QAClB,MAAM,EAAE,0BAAmC;QAC3C,aAAa,EAAE,KAAc;QAC7B,SAAS,EAAE,QAAQ,CAAC,EAAE;QACtB,cAAc,EAAE,QAAQ,CAAC,OAAO;QAChC,eAAe,EAAE,QAAQ,CAAC,eAAe;QACzC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,MAAM;QAC5C,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;QAChD,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;QAC1C,sBAAsB,EACpB,KAAK,CAAC,sBAAsB;YAC5B,WAAW,QAAQ,CAAC,cAAc,CAAC,SAAS,aAAa,QAAQ,CAAC,cAAc,CAAC,SAAS,cAAc,QAAQ,CAAC,cAAc,CAAC,kBAAkB,GAAG;QACvJ,uBAAuB,EACrB,KAAK,CAAC,uBAAuB;YAC7B,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;QACrF,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAChF,uBAAuB,EAAE,KAAK,CAAC,uBAAuB,IAAK,QAAkB;QAC7E,cAAc,EAAE,YAAqB;QACrC,aAAa,EAAE,KAAc;KAC9B,CAAC;IACF,OAAO,EAAE,GAAG,WAAW,EAAE,UAAU,EAAE,WAAW,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;AACjF,CAAC"}

package/dist/harness.d.ts

@@ -0,0 +1,9 @@
+import type { AdapterExtractionResult, ContractAdapter, ExtractRequest } from './types.js';
+export interface DeterminismReport {
+    readonly stable: boolean;
+    readonly outputHash: AdapterExtractionResult['outputHash'];
+    readonly byteLength: number;
+}
+export declare function verifyExtractionDeterminism(adapter: ContractAdapter, request: ExtractRequest): Promise<DeterminismReport>;
+export declare function verifyIdentityRoundTrip(canonicalize: (raw: Readonly<Record<string, string>>) => string, producer: Readonly<Record<string, string>>, consumer: Readonly<Record<string, string>>): string;
+//# sourceMappingURL=harness.d.ts.map

package/dist/harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../src/harness.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG3F,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,uBAAuB,CAAC,YAAY,CAAC,CAAC;IAC3D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAuB5B;AAED,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KAAK,MAAM,EAC/D,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAC1C,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACzC,MAAM,CAUR"}

package/dist/harness.js

@@ -0,0 +1,30 @@
+import { canonicalJson } from '@yanib/reverb-domain';
+import { AdapterValidationError, validateAdapterManifest } from './validation.js';
+export async function verifyExtractionDeterminism(adapter, request) {
+    validateAdapterManifest(adapter.manifest);
+    const first = await adapter.extract(request);
+    const second = await adapter.extract(request);
+    const firstJson = canonicalJson(first);
+    const secondJson = canonicalJson(second);
+    if (firstJson !== secondJson || first.outputHash !== second.outputHash) {
+        throw new AdapterValidationError('nondeterministic_output', 'Repeated extraction produced different canonical output.');
+    }
+    const byteLength = Buffer.byteLength(firstJson);
+    if (byteLength > adapter.manifest.resourceBudget.maximumOutputBytes) {
+        throw new AdapterValidationError('output_limit', 'Adapter output exceeds its declared limit.');
+    }
+    if (first.definitions.length + first.references.length >
+        adapter.manifest.resourceBudget.maximumItems) {
+        throw new AdapterValidationError('item_limit', 'Adapter output exceeds its item limit.');
+    }
+    return { stable: true, outputHash: first.outputHash, byteLength };
+}
+export function verifyIdentityRoundTrip(canonicalize, producer, consumer) {
+    const producerKey = canonicalize(producer);
+    const consumerKey = canonicalize(consumer);
+    if (producerKey !== consumerKey) {
+        throw new AdapterValidationError('identity_round_trip_failed', 'Producer and consumer identity variants do not canonicalize equally.');
+    }
+    return producerKey;
+}
+//# sourceMappingURL=harness.js.map

package/dist/harness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.js","sourceRoot":"","sources":["../src/harness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAQlF,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,OAAwB,EACxB,OAAuB;IAEvB,uBAAuB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,SAAS,KAAK,UAAU,IAAI,KAAK,CAAC,UAAU,KAAK,MAAM,CAAC,UAAU,EAAE,CAAC;QACvE,MAAM,IAAI,sBAAsB,CAC9B,yBAAyB,EACzB,0DAA0D,CAC3D,CAAC;IACJ,CAAC;IACD,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAChD,IAAI,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,kBAAkB,EAAE,CAAC;QACpE,MAAM,IAAI,sBAAsB,CAAC,cAAc,EAAE,4CAA4C,CAAC,CAAC;IACjG,CAAC;IACD,IACE,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM;QAClD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,YAAY,EAC5C,CAAC;QACD,MAAM,IAAI,sBAAsB,CAAC,YAAY,EAAE,wCAAwC,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,YAA+D,EAC/D,QAA0C,EAC1C,QAA0C;IAE1C,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;QAChC,MAAM,IAAI,sBAAsB,CAC9B,4BAA4B,EAC5B,sEAAsE,CACvE,CAAC;IACJ,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/identity.d.ts

@@ -0,0 +1,11 @@
+import { contentHash } from '@yanib/reverb-domain';
+export declare function canonicalIdentitySegment(value: string, name: string): string;
+export declare function canonicalContractKey(scheme: string, segments: readonly {
+    readonly name: string;
+    readonly value: string;
+}[]): string;
+export declare function canonicalShape(value: Readonly<Record<string, unknown>>): {
+    readonly shape: Readonly<Record<string, unknown>>;
+    readonly shapeHash: ReturnType<typeof contentHash>;
+};
+//# sourceMappingURL=identity.d.ts.map

package/dist/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,WAAW,EAAiB,MAAM,sBAAsB,CAAC;AAIjF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAM5E;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,GACrE,MAAM,CAKR;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG;IACxE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;CACpD,CAGA"}

package/dist/identity.js

@@ -0,0 +1,20 @@
+import { canonicalJson, contentHash, hashCanonical } from '@yanib/reverb-domain';
+import { AdapterValidationError } from './validation.js';
+export function canonicalIdentitySegment(value, name) {
+    const normalized = value.normalize('NFC').trim();
+    if (normalized.length === 0 || normalized.length > 512 || normalized.includes('\0')) {
+        throw new AdapterValidationError('invalid_identity', `${name} is not a bounded identity.`);
+    }
+    return encodeURIComponent(normalized);
+}
+export function canonicalContractKey(scheme, segments) {
+    const prefix = canonicalIdentitySegment(scheme.toLowerCase(), 'Identity scheme');
+    return `${prefix}:${segments
+        .map((segment) => canonicalIdentitySegment(segment.value, segment.name))
+        .join('#')}`;
+}
+export function canonicalShape(value) {
+    JSON.parse(canonicalJson(value));
+    return { shape: value, shapeHash: contentHash(hashCanonical(value)) };
+}
+//# sourceMappingURL=identity.js.map

package/dist/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,MAAM,UAAU,wBAAwB,CAAC,KAAa,EAAE,IAAY;IAClE,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,CAAC,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACpF,MAAM,IAAI,sBAAsB,CAAC,kBAAkB,EAAE,GAAG,IAAI,6BAA6B,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,kBAAkB,CAAC,UAAU,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,MAAc,EACd,QAAsE;IAEtE,MAAM,MAAM,GAAG,wBAAwB,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,iBAAiB,CAAC,CAAC;IACjF,OAAO,GAAG,MAAM,IAAI,QAAQ;SACzB,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,wBAAwB,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;SACvE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAwC;IAIrE,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IACjC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;AACxE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from './admission.js';
+export * from './harness.js';
+export * from './identity.js';
+export * from './materialize.js';
+export * from './sandbox.js';
+export * from './types.js';
+export * from './validation.js';
+export declare const ADAPTER_SDK_PACKAGE_ID = "@yanib/reverb-adapter-sdk";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAEhC,eAAO,MAAM,sBAAsB,8BAA8B,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export * from './admission.js';
+export * from './harness.js';
+export * from './identity.js';
+export * from './materialize.js';
+export * from './sandbox.js';
+export * from './types.js';
+export * from './validation.js';
+export const ADAPTER_SDK_PACKAGE_ID = '@yanib/reverb-adapter-sdk';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAEhC,MAAM,CAAC,MAAM,sBAAsB,GAAG,2BAA2B,CAAC"}

package/dist/materialize.d.ts

@@ -0,0 +1,21 @@
+import { type CommitSha, type ContractGenerationObservation, type GenerationId, type IndexedContractChange, type Instant, type RepositoryStableId, type WorkspaceId } from '@yanib/reverb-domain';
+import type { AdapterDiffResult, AdapterExtractionResult } from './types.js';
+export declare function materializeContractObservation(input: {
+    readonly workspaceId: WorkspaceId;
+    readonly repositoryId: RepositoryStableId;
+    readonly generationId: GenerationId;
+    readonly commitSha: CommitSha;
+    readonly observedAt: Instant;
+    readonly extractions: readonly AdapterExtractionResult[];
+    readonly serviceId?: string;
+}): ContractGenerationObservation;
+export declare function materializeContractChanges(input: {
+    readonly workspaceId: WorkspaceId;
+    readonly producerRepositoryId: RepositoryStableId;
+    readonly baseGenerationId: GenerationId;
+    readonly headGenerationId?: GenerationId;
+    readonly baseSha: CommitSha;
+    readonly headSha: CommitSha;
+    readonly diffs: readonly AdapterDiffResult[];
+}): readonly IndexedContractChange[];
+//# sourceMappingURL=materialize.d.ts.map

package/dist/materialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize.d.ts","sourceRoot":"","sources":["../src/materialize.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,6BAA6B,EAClC,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAG1B,KAAK,OAAO,EACZ,KAAK,kBAAkB,EACvB,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAwB7E,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACpD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,GAAG,6BAA6B,CA+EhC;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,oBAAoB,EAAE,kBAAkB,CAAC;IAClD,QAAQ,CAAC,gBAAgB,EAAE,YAAY,CAAC;IACxC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,YAAY,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC9C,GAAG,SAAS,qBAAqB,EAAE,CAgCnC"}

package/dist/materialize.js

@@ -0,0 +1,113 @@
+import { contentHash, deriveStableReferenceId, hashCanonical, } from '@yanib/reverb-domain';
+function observationCoverage(extractions) {
+    const itemCount = extractions.reduce((count, extraction) => count + extraction.definitions.length + extraction.references.length, 0);
+    if (extractions.length === 0)
+        return 'unsupported';
+    if (extractions.every((value) => value.coverage.state === 'unsupported') && itemCount === 0) {
+        return 'unsupported';
+    }
+    if (extractions.every((value) => value.coverage.state === 'failed' || value.coverage.state === 'unsupported') &&
+        itemCount === 0) {
+        return 'failed';
+    }
+    return extractions.every((value) => value.coverage.state === 'complete') ? 'complete' : 'partial';
+}
+export function materializeContractObservation(input) {
+    const definitions = input.extractions.flatMap((extraction) => extraction.definitions.map((definition) => ({
+        workspaceId: input.workspaceId,
+        repositoryId: input.repositoryId,
+        generationId: input.generationId,
+        commitSha: input.commitSha,
+        ...(input.serviceId === undefined ? {} : { serviceId: input.serviceId }),
+        contractKind: definition.contractKind,
+        canonicalKey: definition.canonicalKey,
+        path: definition.path,
+        ...(definition.range === undefined ? {} : { range: definition.range }),
+        contentHash: definition.contentHash,
+        shapeHash: definition.shapeHash,
+        adapterId: definition.extractorId,
+        adapterVersion: definition.extractorVersion,
+        identityVersion: definition.identityVersion,
+        configRevision: definition.configRevision,
+        evidenceStratum: definition.evidenceStratum,
+    })));
+    const referencesById = new Map();
+    for (const extraction of input.extractions) {
+        for (const reference of extraction.references) {
+            const stableId = deriveStableReferenceId({
+                contractKind: reference.contractKind,
+                ...(reference.canonicalKey === undefined
+                    ? { unresolvedPattern: reference.unresolvedPattern ?? 'unknown' }
+                    : { canonicalKey: reference.canonicalKey }),
+                ...(reference.semanticOwner === undefined
+                    ? {}
+                    : { semanticOwner: reference.semanticOwner }),
+                evidenceStratum: reference.evidenceStratum,
+            });
+            const indexed = {
+                workspaceId: input.workspaceId,
+                repositoryId: input.repositoryId,
+                generationId: input.generationId,
+                commitSha: input.commitSha,
+                ...(input.serviceId === undefined ? {} : { consumerServiceId: input.serviceId }),
+                contractKind: reference.contractKind,
+                ...(reference.canonicalKey === undefined ? {} : { canonicalKey: reference.canonicalKey }),
+                ...(reference.unresolvedPattern === undefined
+                    ? {}
+                    : { unresolvedPattern: reference.unresolvedPattern }),
+                stableReferenceId: stableId,
+                path: reference.path,
+                ...(reference.range === undefined ? {} : { range: reference.range }),
+                contentHash: reference.contentHash,
+                adapterId: reference.extractorId,
+                adapterVersion: reference.extractorVersion,
+                identityVersion: reference.identityVersion,
+                configRevision: reference.configRevision,
+                evidenceStratum: reference.evidenceStratum,
+                activation: reference.activation,
+            };
+            const prior = referencesById.get(stableId);
+            if (prior === undefined || indexed.path < prior.path)
+                referencesById.set(stableId, indexed);
+        }
+    }
+    const canonicalDefinitions = definitions.sort((left, right) => `${left.contractKind}\0${left.canonicalKey}\0${left.path}`.localeCompare(`${right.contractKind}\0${right.canonicalKey}\0${right.path}`));
+    const references = [...referencesById.values()].sort((left, right) => left.stableReferenceId.localeCompare(right.stableReferenceId));
+    const canonical = {
+        workspaceId: input.workspaceId,
+        repositoryId: input.repositoryId,
+        generationId: input.generationId,
+        commitSha: input.commitSha,
+        coverageState: observationCoverage(input.extractions),
+        definitions: canonicalDefinitions,
+        references,
+        observedAt: input.observedAt,
+    };
+    return { ...canonical, outputHash: contentHash(hashCanonical(canonical)) };
+}
+export function materializeContractChanges(input) {
+    return input.diffs
+        .flatMap((diff) => diff.changes.map((change) => ({
+        workspaceId: input.workspaceId,
+        producerRepositoryId: input.producerRepositoryId,
+        baseGenerationId: input.baseGenerationId,
+        ...(input.headGenerationId === undefined
+            ? {}
+            : { headGenerationId: input.headGenerationId }),
+        baseSha: input.baseSha,
+        headSha: input.headSha,
+        contractKind: change.contractKind,
+        canonicalKey: change.canonicalKey,
+        changeKind: change.changeKind,
+        compatibility: change.compatibility,
+        activation: change.activation,
+        adapterId: diff.adapterId,
+        adapterVersion: diff.adapterVersion,
+        identityVersion: diff.identityVersion,
+        coverageState: diff.coverage.state,
+        coverageDependencies: change.coverageDependencies,
+        remedy: change.remedy,
+    })))
+        .sort((left, right) => `${left.contractKind}\0${left.canonicalKey}`.localeCompare(`${right.contractKind}\0${right.canonicalKey}`));
+}
+//# sourceMappingURL=materialize.js.map

package/dist/materialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize.js","sourceRoot":"","sources":["../src/materialize.ts"],"names":[],"mappings":"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"}

package/dist/sandbox.d.ts

@@ -0,0 +1,62 @@
+import type { ContentHash } from '@yanib/reverb-domain';
+import type { DifferMetadata, ExternalToolDeclaration } from './types.js';
+export interface AdapterSandboxRequest {
+    readonly toolId: string;
+    readonly argv: readonly string[];
+    readonly inputRefs: readonly string[];
+    readonly timeoutMs: number;
+    readonly maximumOutputBytes: number;
+    readonly network: false;
+    readonly readOnlyInputs: true;
+    readonly scratchOutput: true;
+    readonly memoryMiB: number;
+    readonly environment: Readonly<Record<string, never>>;
+}
+export interface AdapterSandboxResult {
+    readonly exitCode: number | null;
+    readonly stdout: Uint8Array;
+    readonly stderrCode: string | null;
+    readonly timedOut: boolean;
+    readonly outputTruncated: boolean;
+}
+export type AdapterSandboxPortResult<Value> = {
+    readonly ok: true;
+    readonly value: Value;
+} | {
+    readonly ok: false;
+    readonly failure: {
+        readonly kind: string;
+        readonly code: string;
+        readonly safeMessage: string;
+        readonly retryable: boolean;
+    };
+};
+export interface AdapterSandboxRunner {
+    run(request: AdapterSandboxRequest): Promise<AdapterSandboxPortResult<AdapterSandboxResult>>;
+}
+export interface DifferExitMap {
+    readonly compatible: readonly number[];
+    readonly breaking: readonly number[];
+    readonly unknown: readonly number[];
+}
+export interface DeclaredDifferResult {
+    readonly state: 'compatible' | 'breaking' | 'unknown' | 'tool_failure';
+    readonly stdout: Uint8Array;
+    readonly failureCode?: string;
+    readonly metadata: DifferMetadata;
+}
+export declare class DeclaredExternalDiffer {
+    private readonly tool;
+    private readonly sandbox;
+    private readonly options;
+    constructor(tool: ExternalToolDeclaration, sandbox: AdapterSandboxRunner, options: {
+        readonly timeoutMs: number;
+        readonly memoryMiB: number;
+        readonly maximumOutputBytes: number;
+        readonly exitMap: DifferExitMap;
+        readonly category: string;
+    });
+    run(argv: readonly string[], inputRefs: readonly string[]): Promise<DeclaredDifferResult>;
+}
+export declare function contentInputReference(hash: ContentHash): string;
+//# sourceMappingURL=sandbox.d.ts.map

package/dist/sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../src/sandbox.ts"],"names":[],"mappings":"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"}

package/dist/sandbox.js

@@ -0,0 +1,88 @@
+import { AdapterValidationError } from './validation.js';
+const INPUT_REF = /^blob:sha256:[0-9a-f]{64}$/;
+function metadata(tool, category) {
+    return {
+        toolId: tool.id,
+        toolVersion: tool.version,
+        toolDigest: tool.digest,
+        toolLicense: tool.license,
+        category,
+    };
+}
+export class DeclaredExternalDiffer {
+    tool;
+    sandbox;
+    options;
+    constructor(tool, sandbox, options) {
+        this.tool = tool;
+        this.sandbox = sandbox;
+        this.options = options;
+        if (tool.network !== false)
+            throw new AdapterValidationError('unsafe_tool', 'Differ tools must deny network.');
+    }
+    async run(argv, inputRefs) {
+        if (argv.length === 0 ||
+            argv.length > 64 ||
+            argv.some((argument) => argument.length > 2048 || argument.includes('\0'))) {
+            throw new AdapterValidationError('invalid_tool_argv', 'Differ argv is invalid.');
+        }
+        if (inputRefs.length === 0 || inputRefs.some((reference) => !INPUT_REF.test(reference))) {
+            throw new AdapterValidationError('unsafe_tool_input', 'Differ inputs must be content-addressed read-only blobs.');
+        }
+        const result = await this.sandbox.run({
+            toolId: this.tool.id,
+            argv: [...argv],
+            inputRefs: [...inputRefs],
+            timeoutMs: this.options.timeoutMs,
+            maximumOutputBytes: this.options.maximumOutputBytes,
+            network: false,
+            readOnlyInputs: true,
+            scratchOutput: true,
+            memoryMiB: this.options.memoryMiB,
+            environment: {},
+        });
+        const toolMetadata = metadata(this.tool, this.options.category);
+        if (!result.ok) {
+            return {
+                state: 'tool_failure',
+                stdout: new Uint8Array(),
+                failureCode: result.failure.code,
+                metadata: toolMetadata,
+            };
+        }
+        if (result.value.timedOut)
+            return {
+                state: 'tool_failure',
+                stdout: new Uint8Array(),
+                failureCode: 'tool_timeout',
+                metadata: toolMetadata,
+            };
+        if (result.value.outputTruncated)
+            return {
+                state: 'tool_failure',
+                stdout: new Uint8Array(),
+                failureCode: 'tool_output_truncated',
+                metadata: toolMetadata,
+            };
+        const exitCode = result.value.exitCode;
+        if (exitCode !== null && this.options.exitMap.compatible.includes(exitCode)) {
+            return { state: 'compatible', stdout: result.value.stdout, metadata: toolMetadata };
+        }
+        if (exitCode !== null && this.options.exitMap.breaking.includes(exitCode)) {
+            return { state: 'breaking', stdout: result.value.stdout, metadata: toolMetadata };
+        }
+        if (exitCode !== null && this.options.exitMap.unknown.includes(exitCode)) {
+            return { state: 'unknown', stdout: result.value.stdout, metadata: toolMetadata };
+        }
+        return {
+            state: 'tool_failure',
+            stdout: new Uint8Array(),
+            failureCode: result.value.stderrCode ?? 'unmapped_tool_exit',
+            metadata: toolMetadata,
+        };
+    }
+}
+export function contentInputReference(hash) {
+    return `blob:${hash}`;
+}
+//# sourceMappingURL=sandbox.js.map

package/dist/sandbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.js","sourceRoot":"","sources":["../src/sandbox.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,195 @@
+import type { AdapterId, BoundedDiagnostic, ConfigRevision, ContractKind, ContentHash, RepoPath } from '@yanib/reverb-domain';
+export { CONTRACT_KINDS } from '@yanib/reverb-domain';
+export type { ContractKind } from '@yanib/reverb-domain';
+export declare const CAPABILITY_TIERS: readonly ["contract_grade", "structural", "preview"];
+export type CapabilityTier = (typeof CAPABILITY_TIERS)[number];
+export declare const COMPATIBILITY_RESULTS: readonly ["breaking", "potentially_breaking", "compatible", "unknown"];
+export type CompatibilityResult = (typeof COMPATIBILITY_RESULTS)[number];
+export declare const ACTIVATION_TIMINGS: readonly ["current_runtime", "on_upgrade", "on_deploy", "unknown"];
+export type ActivationTiming = (typeof ACTIVATION_TIMINGS)[number];
+export interface EvidenceStratumDeclaration {
+    readonly id: string;
+    readonly family: 'exact_schema' | 'exact_symbol' | 'fallback_identity';
+    readonly requiredEvidence: readonly string[];
+    readonly promotionState: 'UNMEASURED';
+}
+export interface ExternalToolDeclaration {
+    readonly id: string;
+    readonly version: string;
+    readonly digest: ContentHash;
+    readonly license: string;
+    readonly network: false;
+}
+export interface AdapterResourceBudget {
+    readonly timeoutMs: number;
+    readonly memoryMiB: number;
+    readonly maximumInputBytes: number;
+    readonly maximumOutputBytes: number;
+    readonly maximumItems: number;
+}
+export interface AdapterManifest {
+    readonly schema: 'reverb.adapter-manifest';
+    readonly schemaVersion: '1.0';
+    readonly id: AdapterId;
+    readonly version: string;
+    readonly identityVersion: number;
+    readonly contractKinds: readonly ContractKind[];
+    readonly capabilityTiers: readonly {
+        readonly input: string;
+        readonly tier: CapabilityTier;
+    }[];
+    readonly evidenceStrata: readonly EvidenceStratumDeclaration[];
+    readonly externalTools: readonly ExternalToolDeclaration[];
+    readonly limitations: readonly string[];
+    readonly resourceBudget: AdapterResourceBudget;
+    readonly maintainer: string;
+    readonly deprecated?: {
+        readonly replacement?: AdapterId;
+        readonly removeAfter?: string;
+    };
+}
+export interface ArtifactInput {
+    readonly path: RepoPath;
+    readonly contentHash: ContentHash;
+    readonly bytes: Uint8Array;
+    readonly classification: 'source' | 'generated' | 'vendored' | 'test' | 'example';
+}
+export interface SourceRange {
+    readonly startLine: number;
+    readonly startColumn: number;
+    readonly endLine: number;
+    readonly endColumn: number;
+}
+export interface ContractDefinition {
+    readonly contractKind: ContractKind;
+    readonly canonicalKey: string;
+    readonly displayName: string;
+    readonly path: RepoPath;
+    readonly range?: SourceRange;
+    readonly contentHash: ContentHash;
+    readonly shapeHash: ContentHash;
+    readonly shape: Readonly<Record<string, unknown>>;
+    readonly extractorId: AdapterId;
+    readonly extractorVersion: string;
+    readonly identityVersion: number;
+    readonly configRevision: ConfigRevision;
+    readonly evidenceStratum: string;
+}
+export interface ContractReference {
+    readonly contractKind: ContractKind;
+    readonly canonicalKey?: string;
+    readonly unresolvedPattern?: string;
+    readonly unresolvedReason?: string;
+    readonly semanticOwner?: string;
+    readonly path: RepoPath;
+    readonly range?: SourceRange;
+    readonly contentHash: ContentHash;
+    readonly extractorId: AdapterId;
+    readonly extractorVersion: string;
+    readonly identityVersion: number;
+    readonly configRevision: ConfigRevision;
+    readonly evidenceStratum: string;
+    readonly activation: ActivationTiming;
+}
+export interface AdapterLimitation {
+    readonly code: string;
+    readonly scope?: RepoPath;
+}
+export interface AdapterCoverage {
+    readonly state: 'complete' | 'partial' | 'failed' | 'unsupported';
+    readonly eligibleArtifacts: number;
+    readonly processedArtifacts: number;
+    readonly skippedArtifacts: number;
+    readonly failedArtifacts: number;
+    readonly limitations: readonly AdapterLimitation[];
+}
+export interface AdapterExtractionResult {
+    readonly schema: 'reverb.adapter-extraction';
+    readonly schemaVersion: '1.0';
+    readonly adapterId: AdapterId;
+    readonly adapterVersion: string;
+    readonly identityVersion: number;
+    readonly configRevision: ConfigRevision;
+    readonly definitions: readonly ContractDefinition[];
+    readonly references: readonly ContractReference[];
+    readonly coverage: AdapterCoverage;
+    readonly diagnostics: readonly BoundedDiagnostic[];
+    readonly sourceFingerprint: ContentHash;
+    readonly outputHash: ContentHash;
+}
+export interface DifferMetadata {
+    readonly toolId: string;
+    readonly toolVersion: string;
+    readonly toolDigest: ContentHash;
+    readonly toolLicense: string;
+    readonly category: string;
+}
+export interface ContractChange {
+    readonly contractKind: ContractKind;
+    readonly canonicalKey: string;
+    readonly changeKind: string;
+    readonly compatibility: CompatibilityResult;
+    readonly activation: ActivationTiming;
+    readonly baseShapeHash?: ContentHash;
+    readonly headShapeHash?: ContentHash;
+    readonly coverageDependencies: readonly string[];
+    readonly remedy: {
+        readonly kind: string;
+        readonly text: string;
+    };
+    readonly differ: DifferMetadata;
+}
+export interface AdapterDiffResult {
+    readonly schema: 'reverb.adapter-diff';
+    readonly schemaVersion: '1.0';
+    readonly adapterId: AdapterId;
+    readonly adapterVersion: string;
+    readonly identityVersion: number;
+    readonly changes: readonly ContractChange[];
+    readonly coverage: AdapterCoverage;
+    readonly diagnostics: readonly BoundedDiagnostic[];
+    readonly outputHash: ContentHash;
+}
+export interface ExtractRequest {
+    readonly artifacts: readonly ArtifactInput[];
+    readonly configRevision: ConfigRevision;
+    readonly context: Readonly<Record<string, unknown>>;
+}
+export interface DiffRequest {
+    readonly base: AdapterExtractionResult;
+    readonly head: AdapterExtractionResult;
+    readonly configRevision: ConfigRevision;
+    readonly context: Readonly<Record<string, unknown>>;
+}
+export interface ContractAdapter {
+    readonly manifest: AdapterManifest;
+    extract(request: ExtractRequest): Promise<AdapterExtractionResult>;
+    diff(request: DiffRequest): Promise<AdapterDiffResult>;
+}
+export interface AdmissionCheck {
+    readonly id: string;
+    readonly state: 'pass' | 'fail' | 'not_measured';
+    readonly evidence: string;
+}
+export interface AdapterAdmissionReport {
+    readonly schema: 'reverb.adapter-admission';
+    readonly schemaVersion: '1.0';
+    readonly adapterId: AdapterId;
+    readonly adapterVersion: string;
+    readonly identityVersion: number;
+    readonly demand: string;
+    readonly designPartner: string;
+    readonly identitySummary: string;
+    readonly compatibilitySummary: string;
+    readonly evidenceRendering: string;
+    readonly latencyResourceSummary: string;
+    readonly dependenciesAndLicenses: readonly string[];
+    readonly limitations: readonly string[];
+    readonly maintainer: string;
+    readonly checks: readonly AdmissionCheck[];
+    readonly realLabelledCorpusState: 'absent' | 'available';
+    readonly promotionState: 'UNMEASURED';
+    readonly deliveryReady: false;
+    readonly outputHash: ContentHash;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,15 @@
+export { CONTRACT_KINDS } from '@yanib/reverb-domain';
+export const CAPABILITY_TIERS = ['contract_grade', 'structural', 'preview'];
+export const COMPATIBILITY_RESULTS = [
+    'breaking',
+    'potentially_breaking',
+    'compatible',
+    'unknown',
+];
+export const ACTIVATION_TIMINGS = [
+    'current_runtime',
+    'on_upgrade',
+    'on_deploy',
+    'unknown',
+];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,gBAAgB,EAAE,YAAY,EAAE,SAAS,CAAU,CAAC;AAGrF,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,UAAU;IACV,sBAAsB;IACtB,YAAY;IACZ,SAAS;CACD,CAAC;AAGX,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,iBAAiB;IACjB,YAAY;IACZ,WAAW;IACX,SAAS;CACD,CAAC"}

package/dist/validation.d.ts

@@ -0,0 +1,14 @@
+import { configRevision } from '@yanib/reverb-domain';
+import { type AdapterCoverage, type AdapterDiffResult, type AdapterExtractionResult, type AdapterManifest } from './types.js';
+export declare class AdapterValidationError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare function validateAdapterManifest(manifest: AdapterManifest): AdapterManifest;
+export declare function validateCoverage(coverage: AdapterCoverage): AdapterCoverage;
+export declare function finalizeExtraction(input: Omit<AdapterExtractionResult, 'outputHash'>): AdapterExtractionResult;
+export declare function finalizeDiff(input: Omit<AdapterDiffResult, 'outputHash'>): AdapterDiffResult;
+export declare function assertComparableExtractions(manifest: AdapterManifest, base: AdapterExtractionResult, head: AdapterExtractionResult, expectedConfigRevision?: AdapterExtractionResult['configRevision']): void;
+export declare function canonicalAdapterJson(value: unknown): string;
+export declare function validateConfigRevision(value: string): ReturnType<typeof configRevision>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,cAAc,EAKf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAKL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EAIrB,MAAM,YAAY,CAAC;AAKpB,qBAAa,sBAAuB,SAAQ,KAAK;aAE7B,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM;CAKlB;AAWD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,eAAe,CAyElF;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,eAAe,CA4B3E;AAkID,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,IAAI,CAAC,uBAAuB,EAAE,YAAY,CAAC,GACjD,uBAAuB,CA0CzB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,YAAY,CAAC,GAAG,iBAAiB,CAoB5F;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,eAAe,EACzB,IAAI,EAAE,uBAAuB,EAC7B,IAAI,EAAE,uBAAuB,EAC7B,sBAAsB,CAAC,EAAE,uBAAuB,CAAC,gBAAgB,CAAC,GACjE,IAAI,CAeN;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE3D;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAEvF"}

package/dist/validation.js

@@ -0,0 +1,198 @@
+import { adapterId, canonicalJson, configRevision, contentHash, hashCanonical, repoPath, } from '@yanib/reverb-domain';
+import { ACTIVATION_TIMINGS, CAPABILITY_TIERS, COMPATIBILITY_RESULTS, CONTRACT_KINDS, } from './types.js';
+const SEMVER = /^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)(?:-[0-9A-Za-z.-]+)?$/;
+const TOKEN = /^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)*$/;
+export class AdapterValidationError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'AdapterValidationError';
+    }
+}
+function requireCondition(condition, code, message) {
+    if (!condition)
+        throw new AdapterValidationError(code, message);
+}
+function boundedText(value, name, maximum = 256) {
+    requireCondition(value.trim().length > 0, 'invalid_manifest', `${name} cannot be empty.`);
+    requireCondition(value.length <= maximum, 'invalid_manifest', `${name} exceeds its limit.`);
+}
+export function validateAdapterManifest(manifest) {
+    requireCondition(manifest.schema === 'reverb.adapter-manifest' && manifest.schemaVersion === '1.0', 'unsupported_manifest_schema', 'Adapter manifest schema is unsupported.');
+    adapterId(manifest.id);
+    requireCondition(SEMVER.test(manifest.version), 'invalid_manifest', 'Version must be SemVer.');
+    requireCondition(Number.isSafeInteger(manifest.identityVersion) && manifest.identityVersion > 0, 'invalid_manifest', 'Identity version must be positive.');
+    requireCondition(manifest.contractKinds.length > 0, 'invalid_manifest', 'Kinds are required.');
+    requireCondition(new Set(manifest.contractKinds).size === manifest.contractKinds.length &&
+        manifest.contractKinds.every((kind) => CONTRACT_KINDS.includes(kind)), 'invalid_manifest', 'Contract kinds must be unique and closed.');
+    requireCondition(manifest.capabilityTiers.length > 0 &&
+        manifest.capabilityTiers.every((entry) => entry.input.length > 0 && CAPABILITY_TIERS.includes(entry.tier)), 'invalid_manifest', 'Capability tiers are invalid.');
+    const strata = new Set();
+    for (const stratum of manifest.evidenceStrata) {
+        requireCondition(TOKEN.test(stratum.id), 'invalid_manifest', 'Stratum ID is invalid.');
+        requireCondition(!strata.has(stratum.id), 'invalid_manifest', 'Stratum ID is duplicated.');
+        requireCondition(stratum.promotionState === 'UNMEASURED', 'invalid_manifest', 'New adapter strata must be unmeasured.');
+        requireCondition(stratum.requiredEvidence.length > 0, 'invalid_manifest', 'Strata require evidence declarations.');
+        strata.add(stratum.id);
+    }
+    requireCondition(strata.size > 0, 'invalid_manifest', 'At least one evidence stratum is required.');
+    const tools = new Set();
+    for (const tool of manifest.externalTools) {
+        boundedText(tool.id, 'Tool ID');
+        boundedText(tool.version, 'Tool version');
+        contentHash(tool.digest);
+        boundedText(tool.license, 'Tool license');
+        requireCondition(tool.network === false, 'invalid_manifest', 'External tools must deny network.');
+        requireCondition(!tools.has(tool.id), 'invalid_manifest', 'External tool is duplicated.');
+        tools.add(tool.id);
+    }
+    for (const limitation of manifest.limitations)
+        boundedText(limitation, 'Limitation', 512);
+    boundedText(manifest.maintainer, 'Maintainer');
+    for (const [name, value] of Object.entries(manifest.resourceBudget)) {
+        requireCondition(Number.isSafeInteger(value) && value > 0, 'invalid_manifest', `${name} must be positive.`);
+    }
+    return manifest;
+}
+export function validateCoverage(coverage) {
+    for (const value of [
+        coverage.eligibleArtifacts,
+        coverage.processedArtifacts,
+        coverage.skippedArtifacts,
+        coverage.failedArtifacts,
+    ]) {
+        requireCondition(Number.isSafeInteger(value) && value >= 0, 'invalid_coverage', 'Coverage counts must be non-negative integers.');
+    }
+    requireCondition(coverage.processedArtifacts + coverage.skippedArtifacts + coverage.failedArtifacts <=
+        coverage.eligibleArtifacts, 'invalid_coverage', 'Coverage accounting exceeds eligible artifacts.');
+    if (coverage.state === 'complete') {
+        requireCondition(coverage.failedArtifacts === 0 &&
+            coverage.processedArtifacts + coverage.skippedArtifacts === coverage.eligibleArtifacts, 'invalid_coverage', 'Complete coverage must account for every artifact.');
+    }
+    return coverage;
+}
+function validateDiagnostic(diagnostic) {
+    requireCondition(diagnostic.safeMessage.length > 0 && diagnostic.safeMessage.length <= 256, 'invalid_diagnostic', 'Diagnostic text must be bounded.');
+    if (diagnostic.scope)
+        repoPath(diagnostic.scope);
+    if (diagnostic.detailHash)
+        contentHash(diagnostic.detailHash);
+}
+function validateRange(range) {
+    if (range === undefined)
+        return;
+    for (const value of [range.startLine, range.startColumn, range.endLine, range.endColumn]) {
+        requireCondition(Number.isSafeInteger(value) && value > 0, 'invalid_output', 'Source ranges must contain positive integers.');
+    }
+    requireCondition(range.endLine > range.startLine ||
+        (range.endLine === range.startLine && range.endColumn >= range.startColumn), 'invalid_output', 'Source range end precedes its start.');
+}
+function validateContractKey(value) {
+    requireCondition(value.length > 0 && value.length <= 2048 && !value.includes('\0'), 'invalid_output', 'Canonical contract key is not bounded.');
+}
+function validateDefinition(value) {
+    requireCondition(CONTRACT_KINDS.includes(value.contractKind), 'invalid_output', 'Contract kind is invalid.');
+    validateContractKey(value.canonicalKey);
+    boundedText(value.displayName, 'Definition display name', 512);
+    repoPath(value.path);
+    validateRange(value.range);
+    contentHash(value.contentHash);
+    contentHash(value.shapeHash);
+    requireCondition(value.shapeHash === contentHash(hashCanonical(value.shape)), 'invalid_output', 'Definition shape hash does not match its shape.');
+    boundedText(value.evidenceStratum, 'Evidence stratum', 128);
+}
+function validateReference(value) {
+    requireCondition(CONTRACT_KINDS.includes(value.contractKind), 'invalid_output', 'Contract kind is invalid.');
+    const resolved = value.canonicalKey !== undefined;
+    const unresolved = value.unresolvedPattern !== undefined && value.unresolvedReason !== undefined;
+    requireCondition(resolved !== unresolved, 'invalid_output', 'Reference must be exactly resolved or unresolved.');
+    if (value.canonicalKey !== undefined)
+        validateContractKey(value.canonicalKey);
+    if (value.unresolvedPattern !== undefined)
+        boundedText(value.unresolvedPattern, 'Unresolved pattern', 2048);
+    if (value.unresolvedReason !== undefined)
+        boundedText(value.unresolvedReason, 'Unresolved reason', 256);
+    repoPath(value.path);
+    validateRange(value.range);
+    contentHash(value.contentHash);
+    requireCondition(ACTIVATION_TIMINGS.includes(value.activation), 'invalid_output', 'Activation is invalid.');
+    boundedText(value.evidenceStratum, 'Evidence stratum', 128);
+}
+function validateChange(value) {
+    requireCondition(CONTRACT_KINDS.includes(value.contractKind), 'invalid_output', 'Contract kind is invalid.');
+    validateContractKey(value.canonicalKey);
+    boundedText(value.changeKind, 'Change kind', 128);
+    requireCondition(COMPATIBILITY_RESULTS.includes(value.compatibility), 'invalid_output', 'Compatibility result is invalid.');
+    requireCondition(ACTIVATION_TIMINGS.includes(value.activation), 'invalid_output', 'Activation is invalid.');
+    if (value.baseShapeHash)
+        contentHash(value.baseShapeHash);
+    if (value.headShapeHash)
+        contentHash(value.headShapeHash);
+    value.coverageDependencies.forEach((dependency) => boundedText(dependency, 'Coverage dependency', 256));
+    boundedText(value.remedy.kind, 'Remedy kind', 128);
+    boundedText(value.remedy.text, 'Remedy text', 1024);
+    boundedText(value.differ.toolId, 'Differ tool ID');
+    boundedText(value.differ.toolVersion, 'Differ tool version');
+    contentHash(value.differ.toolDigest);
+    boundedText(value.differ.toolLicense, 'Differ tool license');
+    boundedText(value.differ.category, 'Differ category');
+}
+function definitionSortKey(value) {
+    return `${value.contractKind}\u0000${value.canonicalKey}\u0000${value.path}`;
+}
+function referenceSortKey(value) {
+    return `${value.contractKind}\u0000${value.canonicalKey ?? value.unresolvedPattern ?? ''}\u0000${value.path}`;
+}
+function changeSortKey(value) {
+    return `${value.contractKind}\u0000${value.canonicalKey}\u0000${value.changeKind}`;
+}
+export function finalizeExtraction(input) {
+    validateCoverage(input.coverage);
+    input.diagnostics.forEach(validateDiagnostic);
+    adapterId(input.adapterId);
+    requireCondition(SEMVER.test(input.adapterVersion), 'invalid_output', 'Adapter output version is invalid.');
+    requireCondition(Number.isSafeInteger(input.identityVersion) && input.identityVersion > 0, 'invalid_output', 'Identity version is invalid.');
+    configRevision(input.configRevision);
+    contentHash(input.sourceFingerprint);
+    input.definitions.forEach(validateDefinition);
+    input.references.forEach(validateReference);
+    const definitions = [...input.definitions].sort((left, right) => definitionSortKey(left).localeCompare(definitionSortKey(right)));
+    const references = [...input.references].sort((left, right) => referenceSortKey(left).localeCompare(referenceSortKey(right)));
+    const identity = `${input.adapterId}@${input.adapterVersion}#${input.identityVersion}`;
+    for (const item of [...definitions, ...references]) {
+        requireCondition(`${item.extractorId}@${item.extractorVersion}#${item.identityVersion}` === identity, 'incompatible_output_version', 'Adapter output version stamps do not match its result.');
+        requireCondition(item.configRevision === input.configRevision, 'incompatible_output_version', 'Adapter output config revision does not match its result.');
+    }
+    const withoutHash = { ...input, definitions, references };
+    return {
+        ...withoutHash,
+        outputHash: contentHash(hashCanonical(withoutHash)),
+    };
+}
+export function finalizeDiff(input) {
+    validateCoverage(input.coverage);
+    input.diagnostics.forEach(validateDiagnostic);
+    adapterId(input.adapterId);
+    requireCondition(SEMVER.test(input.adapterVersion), 'invalid_output', 'Adapter output version is invalid.');
+    requireCondition(Number.isSafeInteger(input.identityVersion) && input.identityVersion > 0, 'invalid_output', 'Identity version is invalid.');
+    input.changes.forEach(validateChange);
+    const changes = [...input.changes].sort((left, right) => changeSortKey(left).localeCompare(changeSortKey(right)));
+    const withoutHash = { ...input, changes };
+    return { ...withoutHash, outputHash: contentHash(hashCanonical(withoutHash)) };
+}
+export function assertComparableExtractions(manifest, base, head, expectedConfigRevision) {
+    const expected = `${manifest.id}@${manifest.version}#${manifest.identityVersion}`;
+    for (const result of [base, head]) {
+        requireCondition(`${result.adapterId}@${result.adapterVersion}#${result.identityVersion}` === expected, 'incompatible_extraction', 'Extraction was produced by an incompatible adapter or identity version.');
+    }
+    requireCondition(base.configRevision === head.configRevision &&
+        (expectedConfigRevision === undefined || base.configRevision === expectedConfigRevision), 'incompatible_extraction', 'Extraction config revisions are incompatible.');
+}
+export function canonicalAdapterJson(value) {
+    return canonicalJson(value);
+}
+export function validateConfigRevision(value) {
+    return configRevision(value);
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@yanib/reverb-adapter-sdk",
+  "version": "0.1.0",
+  "description": "Contract adapter interfaces and validation for Reverb",
+  "type": "module",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/YanibHQ/reverb-impact.git",
+    "directory": "packages/adapter-sdk"
+  },
+  "homepage": "https://github.com/YanibHQ/reverb-impact#readme",
+  "bugs": {
+    "url": "https://github.com/YanibHQ/reverb-impact/issues"
+  },
+  "engines": {
+    "node": ">=24 <26"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@yanib/reverb-domain": "0.1.0",
+    "@yanib/reverb-schema": "0.1.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsc -b"
+  }
+}