@arcforges/api-client 1.0.0-ci.74.1 → 1.0.0-ci.82.1

package/NOTICE

@@ -1,23 +1,22 @@
 ArcForges Contracts
 Copyright 2026 ArcForges contributors
 
-@arcforges/api-client 1.0.0-ci.74.1 (Apache-2.0)
+@arcforges/api-client 1.0.0-ci.82.1 (Apache-2.0)
 
 Resolved runtime dependency inventory (dependencies retain their own licences):
-- @arcforges/proto 1.0.0-ci.74.1: Apache-2.0 (pkg:npm/%40arcforges/proto@1.0.0-ci.74.1)
+- @arcforges/proto 1.0.0-ci.82.1: Apache-2.0 (pkg:npm/%40arcforges/proto@1.0.0-ci.82.1)
 - @bufbuild/protobuf 2.15.0: (Apache-2.0 AND BSD-3-Clause) (pkg:npm/%40bufbuild/protobuf@2.15.0)
 - @connectrpc/connect 2.2.0: Apache-2.0 (pkg:npm/%40connectrpc/connect@2.2.0)
 - @connectrpc/connect-web 2.2.0: Apache-2.0 (pkg:npm/%40connectrpc/connect-web@2.2.0)
 
-Third-party dependencies are referenced, not vendored into this package.
-The installed dependency packages supply their original licence and notice files.
+Third-party dependencies are referenced, not vendored into this package. Installed dependencies supply their original licence and notice files.
 
 ArcForges source provenance notices
 
 Generated from reviewed active records. Original licence files and dependency notices remain authoritative.
 
-hello-bindings-r1
-Source: https://github.com/ArcForges/Contracts @ 76a3e0d39e61c7868b497ae7e059e29ac69f44de
+contract-bindings-r2
+Source: https://github.com/ArcForges/Contracts @ 3edb8888b0648c32c5594b567e0157b158e9c915
 Material licence: Apache-2.0
 Notice scope: packages
 Copyright 2026 ArcForges contributors.
@@ -25,7 +24,7 @@ Copyright 2008 Google Inc. All rights reserved.
 Copyright 2015, 2019, 2020 gRPC authors.
 Copyright 2021-2026 Buf Technologies, Inc.
 Copyright 2022-2026 The Connect Authors.
-Hello bindings are generated from the Apache-2.0 ArcForges proto using Grpc.Tools 2.84.0, protoc-gen-es 2.15.0, grpc-java 1.84.0, grpc-kotlin 1.5.0 and Connect-Kotlin 0.9.0. Grpc.Tools provenance binds protobuf submodule 35cd01f9fe9afbeea38cc7b979a3b6bfcde82c03. Generator implementations are build tools and are not bundled in the client packages. Preserve these attributions, Apache-2.0 terms and the protobuf BSD terms below.
+Selected ArcForges contract bindings are generated from Apache-2.0 schemas using Grpc.Tools 2.84.0, protoc-gen-es 2.15.0 and Connect-Kotlin 0.9.0. Shape validators and fixture exports use Apache-2.0 repository tooling. Historical protobuf BSD-3-Clause and applicable generator Apache-2.0 attributions are retained. Build tools are not bundled in client packages. Native-grpc-only Android generation is retired in WP03.00.
 
 protobuf-generator-licence-r1
 Source: https://github.com/protocolbuffers/protobuf @ 35cd01f9fe9afbeea38cc7b979a3b6bfcde82c03

package/build-identity.json

@@ -3,17 +3,17 @@
   "owner": "Contracts",
   "artifact": {
     "id": "@arcforges/api-client",
-    "version": "1.0.0-ci.74.1"
+    "version": "1.0.0-ci.82.1"
   },
   "build": {
-    "sourceCommit": "9f0e90f65d57f405fcee311d467a57a255dfd644",
+    "sourceCommit": "0fbb746d3bd46c507a939e2901504f390e7cd2e2",
     "dirty": false,
     "kind": "ci",
-    "buildId": "35642372095.1",
-    "runId": "35642372095",
+    "buildId": "35702693766.1",
+    "runId": "35702693766",
     "runAttempt": 1,
-    "pipelineRun": "https://github.com/ArcForges/Contracts/actions/runs/35642372095",
-    "sourceDateEpoch": 1790017396
+    "pipelineRun": "https://github.com/ArcForges/Contracts/actions/runs/35702693766",
+    "sourceDateEpoch": 1790064171
   },
   "axes": {
     "AppVersion": {
@@ -23,6 +23,24 @@
     "ContractSet": {
       "status": "present",
       "values": [
+        {
+          "subject": "arcforges.events",
+          "version": "1",
+          "source": {
+            "path": "public/proto/arcforges/events/v1/events.proto",
+            "sha256": "ea0ac740c06bbb5b81724b4a7e601110424cabc4940b07e579cf97d852880f43"
+          },
+          "descriptorSha256": "1d9e586eee777509104447b60295d2af63a588f2885555763e8fc598e7d8d3c5"
+        },
+        {
+          "subject": "arcforges.foundation",
+          "version": "1",
+          "source": {
+            "path": "public/proto/arcforges/foundation/v1/foundation.proto",
+            "sha256": "9445c5229ff92c2376fb8bfb49ca98b4503441636544795b9853fba3cd25bdb6"
+          },
+          "descriptorSha256": "1d9e586eee777509104447b60295d2af63a588f2885555763e8fc598e7d8d3c5"
+        },
         {
           "subject": "arcforges.hello",
           "version": "1",
@@ -30,13 +48,29 @@
             "path": "public/proto/arcforges/hello/v1/hello.proto",
             "sha256": "92489f89d1898a3d3bbea56c72116416cd0152ae8866c98745739437020c67d9"
           },
-          "descriptorSha256": "7219a8d730978bcc3b7b8769e159d06711dff3f2b07715a6d487589f8c09b99c"
+          "descriptorSha256": "1d9e586eee777509104447b60295d2af63a588f2885555763e8fc598e7d8d3c5"
+        },
+        {
+          "subject": "json:PackageInventory",
+          "version": "1",
+          "source": {
+            "path": "public/http/v1/inventory.schema.json",
+            "sha256": "fb6929548278f6e16e61491001fecae4143882efbfe732950a1584e1e2f80a5d"
+          }
+        },
+        {
+          "subject": "json:PartReceipt",
+          "version": "1",
+          "source": {
+            "path": "public/http/v1/schema.json",
+            "sha256": "23587b33320fcbe4a917c2839552984eb40e716c4ce317a5c218f35bedf06751"
+          }
         }
       ]
     },
     "CapabilityVersion": {
       "status": "not-produced",
-      "reason": "Hello declares no production capabilities.",
+      "reason": "The selected contract records do not declare implemented product capabilities.",
       "producer": "WP09 and product capability owners"
     },
     "NativeFormatVersion": {
@@ -55,23 +89,22 @@
     },
     "PolicySchemaVersion": {
       "status": "not-produced",
-      "reason": "Hello is not a product policy schema.",
+      "reason": "The selected schemas contain no implemented product policy declaration.",
       "producer": "WP03 and WP44"
     },
     "ExtensionProtocolVersion": {
-      "status": "not-produced",
-      "reason": "Hello is not an extension protocol.",
-      "producer": "WP03 and WP41"
+      "status": "not-applicable",
+      "reason": "This package closure contains no extension protocol."
     },
     "PackageVersion": {
       "status": "present",
       "values": [
         {
           "subject": "pkg:npm/%40arcforges/proto",
-          "version": "1.0.0-ci.74.1",
+          "version": "1.0.0-ci.82.1",
           "source": {
             "path": "sbom.cdx.json#components",
-            "sha256": "cb9b32565c0482c8dc5a2e25e2fafaf18b8192c53dfec6e0b076cbf141f2d055"
+            "sha256": "b81b87c9fa45060e54122df72af02c21ddcb28202e1278f8420d3ef5335ee4d1"
           }
         },
         {
@@ -79,7 +112,7 @@
           "version": "2.15.0",
           "source": {
             "path": "sbom.cdx.json#components",
-            "sha256": "cb9b32565c0482c8dc5a2e25e2fafaf18b8192c53dfec6e0b076cbf141f2d055"
+            "sha256": "b81b87c9fa45060e54122df72af02c21ddcb28202e1278f8420d3ef5335ee4d1"
           }
         },
         {
@@ -87,7 +120,7 @@
           "version": "2.2.0",
           "source": {
             "path": "sbom.cdx.json#components",
-            "sha256": "cb9b32565c0482c8dc5a2e25e2fafaf18b8192c53dfec6e0b076cbf141f2d055"
+            "sha256": "b81b87c9fa45060e54122df72af02c21ddcb28202e1278f8420d3ef5335ee4d1"
           }
         },
         {
@@ -95,7 +128,7 @@
           "version": "2.2.0",
           "source": {
             "path": "sbom.cdx.json#components",
-            "sha256": "cb9b32565c0482c8dc5a2e25e2fafaf18b8192c53dfec6e0b076cbf141f2d055"
+            "sha256": "b81b87c9fa45060e54122df72af02c21ddcb28202e1278f8420d3ef5335ee4d1"
           }
         }
       ]

package/dist/gen/http.d.ts

@@ -0,0 +1,2 @@
+export * from "../shapes/gen/PartReceipt.js";
+export * from "../shapes/gen/PackageInventory.js";

package/dist/gen/http.js

@@ -0,0 +1,5 @@
+// SPDX-License-Identifier: Apache-2.0
+// <auto-generated />
+// Generated by eng/generate_shapes.py; do not edit.
+export * from "../shapes/gen/PartReceipt.js";
+export * from "../shapes/gen/PackageInventory.js";

package/dist/index.d.ts

@@ -7,3 +7,4 @@ export declare function createHelloClient(options: GrpcWebTransportOptions): imp
         output: typeof import("@arcforges/proto").SayHelloResponseSchema;
     };
 }>>;
+export * from "./gen/http.js";

package/dist/index.js

@@ -6,3 +6,4 @@ import { createGrpcWebTransport } from "@connectrpc/connect-web";
 export function createHelloClient(options) {
     return createClient(HelloService, createGrpcWebTransport(options));
 }
+export * from "./gen/http.js";

package/dist/shapes/gen/PackageInventory.d.ts

@@ -0,0 +1,10 @@
+export interface PackageInventory {
+    schemaVersion: string;
+    files: InventoryFile[];
+}
+export interface InventoryFile {
+    path: string;
+    size: string;
+    sha256: string;
+}
+export declare function isPackageInventory(value: unknown): value is PackageInventory;

package/dist/shapes/gen/PackageInventory.js

@@ -0,0 +1,133 @@
+export function isPackageInventory(value) { return check0(value); }
+function check0(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return false;
+    const object = value;
+    for (const key of Object.keys(object)) {
+        switch (key) {
+            case "schemaVersion":
+                if (!check1(object[key]))
+                    return false;
+                break;
+            case "files":
+                if (!check2(object[key]))
+                    return false;
+                break;
+            default: return false;
+        }
+    }
+    if (!Object.prototype.hasOwnProperty.call(object, "schemaVersion"))
+        return false;
+    if (!Object.prototype.hasOwnProperty.call(object, "files"))
+        return false;
+    if (!inventoryRules(value))
+        return false;
+    if (!inventoryRules(value))
+        return false;
+    return true;
+}
+function check1(value) {
+    if (typeof value !== 'string' || !validText(value))
+        return false;
+    if (value !== "inventory.v1")
+        return false;
+    return true;
+}
+function check2(value) {
+    if (!Array.isArray(value))
+        return false;
+    if (value.length < 1)
+        return false;
+    if (value.length > 10000)
+        return false;
+    if (!value.every(item => check3(item)))
+        return false;
+    return true;
+}
+function check3(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return false;
+    const object = value;
+    for (const key of Object.keys(object)) {
+        switch (key) {
+            case "path":
+                if (!check4(object[key]))
+                    return false;
+                break;
+            case "size":
+                if (!check5(object[key]))
+                    return false;
+                break;
+            case "sha256":
+                if (!check6(object[key]))
+                    return false;
+                break;
+            default: return false;
+        }
+    }
+    if (!Object.prototype.hasOwnProperty.call(object, "path"))
+        return false;
+    if (!Object.prototype.hasOwnProperty.call(object, "size"))
+        return false;
+    if (!Object.prototype.hasOwnProperty.call(object, "sha256"))
+        return false;
+    return true;
+}
+function check4(value) {
+    if (typeof value !== 'string' || !validText(value))
+        return false;
+    if ((new RegExp("^[A-Za-z0-9_.-]+(/[A-Za-z0-9_.-]+)*$", 'u')).exec(value)?.[0] !== value)
+        return false;
+    return true;
+}
+function check5(value) {
+    if (typeof value !== 'string' || !validText(value))
+        return false;
+    if ([...value].length > 20)
+        return false;
+    if ((new RegExp("^(0|[1-9][0-9]*)$", 'u')).exec(value)?.[0] !== value)
+        return false;
+    if (BigInt(value) > 18446744073709551615n)
+        return false;
+    return true;
+}
+function check6(value) {
+    if (typeof value !== 'string' || !validText(value))
+        return false;
+    if ((new RegExp("^[0-9a-f]{64}$", 'u')).exec(value)?.[0] !== value)
+        return false;
+    return true;
+}
+function validText(value) {
+    for (const scalar of value) {
+        const point = scalar.codePointAt(0);
+        if (point >= 0xd800 && point <= 0xdfff)
+            return false;
+    }
+    return true;
+}
+function inventoryRules(value) {
+    const files = value.files;
+    const seen = new Set();
+    let previous;
+    let total = 0n;
+    for (const file of files) {
+        const path = file.path;
+        const folded = path.toUpperCase();
+        if (path.length === 0 || folded === 'INVENTORY.JSON' || folded === 'SIGNATURE.JSON' || seen.has(folded) || (previous !== undefined && previous >= path))
+            return false;
+        for (const segment of path.split('/')) {
+            if (!/^[A-Za-z0-9_.-]+$/.test(segment) || segment === '.' || segment === '..' || segment.endsWith('.') || /^(CON|PRN|AUX|NUL|COM[1-9]|LPT[1-9])(?:\.|$)/i.test(segment))
+                return false;
+        }
+        const size = BigInt(file.size);
+        if (size > 134217728n)
+            return false;
+        total += size;
+        if (total > 1073741824n)
+            return false;
+        seen.add(folded);
+        previous = path;
+    }
+    return files.some(file => file.path === 'manifest.json');
+}

package/dist/shapes/gen/PartReceipt.d.ts

@@ -0,0 +1,7 @@
+export interface PartReceipt {
+    partNumber: number;
+    size: string;
+    sha256: string;
+    etag: string;
+}
+export declare function isPartReceipt(value: unknown): value is PartReceipt;

package/dist/shapes/gen/PartReceipt.js

@@ -0,0 +1,101 @@
+export function isPartReceipt(value) { return check0(value); }
+function check0(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return false;
+    const object = value;
+    for (const key of Object.keys(object)) {
+        switch (key) {
+            case "partNumber":
+                if (!check1(object[key]))
+                    return false;
+                break;
+            case "size":
+                if (!check2(object[key]))
+                    return false;
+                break;
+            case "sha256":
+                if (!check3(object[key]))
+                    return false;
+                break;
+            case "etag":
+                if (!check4(object[key]))
+                    return false;
+                break;
+            default: return false;
+        }
+    }
+    if (!Object.prototype.hasOwnProperty.call(object, "partNumber"))
+        return false;
+    if (!Object.prototype.hasOwnProperty.call(object, "size"))
+        return false;
+    if (!Object.prototype.hasOwnProperty.call(object, "sha256"))
+        return false;
+    if (!Object.prototype.hasOwnProperty.call(object, "etag"))
+        return false;
+    return true;
+}
+function check1(value) {
+    if (typeof value !== 'number' || !Number.isSafeInteger(value))
+        return false;
+    if (value < 0)
+        return false;
+    if (value > 4294967295)
+        return false;
+    return true;
+}
+function check2(value) {
+    if (typeof value !== 'string' || !validText(value))
+        return false;
+    if ([...value].length > 20)
+        return false;
+    if ((new RegExp("^(0|[1-9][0-9]*)$", 'u')).exec(value)?.[0] !== value)
+        return false;
+    if (BigInt(value) > 18446744073709551615n)
+        return false;
+    return true;
+}
+function check3(value) {
+    if (typeof value !== 'string' || !validText(value))
+        return false;
+    if ((new RegExp("^[0-9a-f]{64}$", 'u')).exec(value)?.[0] !== value)
+        return false;
+    return true;
+}
+function check4(value) {
+    if (typeof value !== 'string' || !validText(value))
+        return false;
+    return true;
+}
+function validText(value) {
+    for (const scalar of value) {
+        const point = scalar.codePointAt(0);
+        if (point >= 0xd800 && point <= 0xdfff)
+            return false;
+    }
+    return true;
+}
+function inventoryRules(value) {
+    const files = value.files;
+    const seen = new Set();
+    let previous;
+    let total = 0n;
+    for (const file of files) {
+        const path = file.path;
+        const folded = path.toUpperCase();
+        if (path.length === 0 || folded === 'INVENTORY.JSON' || folded === 'SIGNATURE.JSON' || seen.has(folded) || (previous !== undefined && previous >= path))
+            return false;
+        for (const segment of path.split('/')) {
+            if (!/^[A-Za-z0-9_.-]+$/.test(segment) || segment === '.' || segment === '..' || segment.endsWith('.') || /^(CON|PRN|AUX|NUL|COM[1-9]|LPT[1-9])(?:\.|$)/i.test(segment))
+                return false;
+        }
+        const size = BigInt(file.size);
+        if (size > 134217728n)
+            return false;
+        total += size;
+        if (total > 1073741824n)
+            return false;
+        seen.add(folded);
+        previous = path;
+    }
+    return files.some(file => file.path === 'manifest.json');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcforges/api-client",
-  "version": "1.0.0-ci.74.1",
+  "version": "1.0.0-ci.82.1",
   "description": "ArcForges public gRPC-Web client entry point; initial Hello World example.",
   "type": "module",
   "license": "Apache-2.0",
@@ -22,16 +22,18 @@
     "./build-identity": "./build-identity.json"
   },
   "files": [
-    "dist",
     "LICENSE",
     "NOTICE",
-    "sbom.cdx.json",
-    "source.json",
     "README.md",
-    "build-identity.json"
+    "build-identity.json",
+    "contracts.binpb",
+    "dist",
+    "sbom.cdx.json",
+    "schemas",
+    "source.json"
   ],
   "dependencies": {
-    "@arcforges/proto": "1.0.0-ci.74.1",
+    "@arcforges/proto": "1.0.0-ci.82.1",
     "@bufbuild/protobuf": "2.15.0",
     "@connectrpc/connect": "2.2.0",
     "@connectrpc/connect-web": "2.2.0"
@@ -41,6 +43,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "arcforges": {
-    "licenceBoundary": "Apache"
+    "licenceBoundary": "Apache",
+    "contractAccess": "public"
   }
 }

package/sbom.cdx.json

@@ -5,10 +5,10 @@
   "metadata": {
     "component": {
       "type": "library",
-      "bom-ref": "pkg:npm/%40arcforges/api-client@1.0.0-ci.74.1",
+      "bom-ref": "pkg:npm/%40arcforges/api-client@1.0.0-ci.82.1",
       "name": "@arcforges/api-client",
-      "version": "1.0.0-ci.74.1",
-      "purl": "pkg:npm/%40arcforges/api-client@1.0.0-ci.74.1",
+      "version": "1.0.0-ci.82.1",
+      "purl": "pkg:npm/%40arcforges/api-client@1.0.0-ci.82.1",
       "licenses": [
         {
           "expression": "Apache-2.0"
@@ -19,10 +19,10 @@
   "components": [
     {
       "type": "library",
-      "bom-ref": "pkg:npm/%40arcforges/proto@1.0.0-ci.74.1",
+      "bom-ref": "pkg:npm/%40arcforges/proto@1.0.0-ci.82.1",
       "name": "@arcforges/proto",
-      "version": "1.0.0-ci.74.1",
-      "purl": "pkg:npm/%40arcforges/proto@1.0.0-ci.74.1",
+      "version": "1.0.0-ci.82.1",
+      "purl": "pkg:npm/%40arcforges/proto@1.0.0-ci.82.1",
       "licenses": [
         {
           "expression": "Apache-2.0"
@@ -72,7 +72,7 @@
       "dependsOn": []
     },
     {
-      "ref": "pkg:npm/%40arcforges/proto@1.0.0-ci.74.1",
+      "ref": "pkg:npm/%40arcforges/proto@1.0.0-ci.82.1",
       "dependsOn": [
         "pkg:npm/%40bufbuild/protobuf@2.15.0"
       ]
@@ -91,9 +91,9 @@
       ]
     },
     {
-      "ref": "pkg:npm/%40arcforges/api-client@1.0.0-ci.74.1",
+      "ref": "pkg:npm/%40arcforges/api-client@1.0.0-ci.82.1",
       "dependsOn": [
-        "pkg:npm/%40arcforges/proto@1.0.0-ci.74.1",
+        "pkg:npm/%40arcforges/proto@1.0.0-ci.82.1",
         "pkg:npm/%40bufbuild/protobuf@2.15.0",
         "pkg:npm/%40connectrpc/connect@2.2.0",
         "pkg:npm/%40connectrpc/connect-web@2.2.0"

package/schemas/public/http/v1/inventory.schema.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$comment": "SPDX-License-Identifier: Apache-2.0",
+  "title": "PackageInventory",
+  "type": "object",
+  "properties": {
+    "schemaVersion": {
+      "type": "string",
+      "const": "inventory.v1"
+    },
+    "files": {
+      "type": "array",
+      "maxItems": 10000,
+      "items": {
+        "$ref": "#/$defs/InventoryFile"
+      },
+      "minItems": 1
+    }
+  },
+  "required": ["schemaVersion", "files"],
+  "additionalProperties": false,
+  "$defs": {
+    "InventoryFile": {
+      "title": "InventoryFile",
+      "type": "object",
+      "properties": {
+        "path": {
+          "type": "string",
+          "pattern": "^[A-Za-z0-9_.-]+(/[A-Za-z0-9_.-]+)*$"
+        },
+        "size": {
+          "type": "string",
+          "pattern": "^(0|[1-9][0-9]*)$",
+          "maxLength": 20,
+          "x-arcforges-rules": ["uint64String"]
+        },
+        "sha256": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$"
+        }
+      },
+      "required": ["path", "size", "sha256"],
+      "additionalProperties": false
+    }
+  },
+  "x-arcforges-rules": ["inventoryPaths", "inventoryBounds"],
+  "x-arcforges-schema-version": "1"
+}

package/schemas/public/http/v1/schema.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$comment": "SPDX-License-Identifier: Apache-2.0",
+  "title": "PartReceipt",
+  "type": "object",
+  "properties": {
+    "partNumber": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 4294967295
+    },
+    "size": {
+      "type": "string",
+      "pattern": "^(0|[1-9][0-9]*)$",
+      "maxLength": 20,
+      "x-arcforges-rules": ["uint64String"]
+    },
+    "sha256": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{64}$"
+    },
+    "etag": {
+      "type": "string"
+    }
+  },
+  "required": ["partNumber", "size", "sha256", "etag"],
+  "additionalProperties": false,
+  "x-arcforges-schema-version": "1"
+}

package/schemas/public/proto/arcforges/events/v1/events.proto

@@ -0,0 +1,14 @@
+// SPDX-License-Identifier: Apache-2.0
+syntax = "proto3";
+
+package arcforges.events.v1;
+
+option csharp_namespace = "ArcForges.Contracts.Events.V1";
+option java_package = "io.github.arcforges.contracts.events.v1";
+option java_multiple_files = true;
+option java_outer_classname = "EventsProto";
+
+// The complete entitlement.changed hint payload; not the full Event envelope.
+message EntitlementChanged {
+  optional int64 entitlement_version = 1 [json_name = "entitlementVersion"];
+}

package/schemas/public/proto/arcforges/foundation/v1/foundation.proto

@@ -0,0 +1,128 @@
+// SPDX-License-Identifier: Apache-2.0
+syntax = "proto3";
+
+package arcforges.foundation.v1;
+
+option csharp_namespace = "ArcForges.Contracts.Foundation.V1";
+option java_package = "io.github.arcforges.contracts.foundation.v1";
+option java_multiple_files = true;
+option java_outer_classname = "FoundationProto";
+
+// Complete selected registry04 records; shape constraints are owned beside this schema.
+message Id { optional bytes value = 1 [json_name = "value"]; }
+message Revision { optional int64 value = 1 [json_name = "value"]; }
+message LocalNotesVersion {
+  Revision acked_rev = 1 [json_name = "ackedRev"];
+  optional uint64 head_local_seq = 2 [json_name = "headLocalSeq"];
+}
+message NativeContentRev { optional uint64 value = 1 [json_name = "value"]; }
+message Instant {
+  optional sint64 unix_seconds = 1 [json_name = "unixSeconds"];
+  optional uint32 nanos = 2 [json_name = "nanos"];
+}
+message Decimal { optional string value = 1 [json_name = "value"]; }
+message AggregateRef {
+  optional string kind = 1 [json_name = "kind"];
+  Id id = 2 [json_name = "id"];
+}
+message VersionedRef {
+  AggregateRef root = 1 [json_name = "root"];
+  Revision revision = 2 [json_name = "revision"];
+  optional string sha256 = 3 [json_name = "sha256"];
+}
+enum EffectCertainty {
+  EFFECT_CERTAINTY_UNSPECIFIED = 0;
+  EFFECT_CERTAINTY_DID_NOT_HAPPEN = 1;
+  EFFECT_CERTAINTY_HAPPENED = 2;
+  EFFECT_CERTAINTY_UNKNOWN = 3;
+}
+enum RetryMode {
+  RETRY_MODE_UNSPECIFIED = 0;
+  RETRY_MODE_NEVER = 1;
+  RETRY_MODE_SAME_COMMAND = 2;
+  RETRY_MODE_AFTER_TIME = 3;
+  RETRY_MODE_RECONCILE = 4;
+}
+enum ErrorCategory {
+  ERROR_CATEGORY_UNSPECIFIED = 0;
+  ERROR_CATEGORY_VALIDATION = 1;
+  ERROR_CATEGORY_AUTHENTICATION = 2;
+  ERROR_CATEGORY_AUTHORIZATION = 3;
+  ERROR_CATEGORY_ENTITLEMENT = 4;
+  ERROR_CATEGORY_CONFLICT = 5;
+  ERROR_CATEGORY_STATE = 6;
+  ERROR_CATEGORY_RESOURCE = 7;
+  ERROR_CATEGORY_EXECUTION = 8;
+  ERROR_CATEGORY_INTERNAL = 9;
+}
+message Receipt {
+  Id command_id = 1 [json_name = "commandId"];
+  Revision result_revision = 2 [json_name = "resultRevision"];
+  optional EffectCertainty effect = 3 [json_name = "effect"];
+}
+message ApplicationScope {
+  optional string product_id = 1 [json_name = "productId"];
+  Id installation_id = 2 [json_name = "installationId"];
+}
+message RequestMeta {
+  Id command_id = 1 [json_name = "commandId"];
+  Revision expected_rev = 2 [json_name = "expectedRev"];
+  Id correlation_id = 3 [json_name = "correlationId"];
+  Id workspace_id = 4 [json_name = "workspaceId"];
+  LocalNotesVersion expected_local = 5 [json_name = "expectedLocal"];
+  NativeContentRev expected_native = 6 [json_name = "expectedNative"];
+  optional uint64 recovery_generation = 7 [json_name = "recoveryGeneration"];
+  ApplicationScope application_scope = 8 [json_name = "applicationScope"];
+}
+message ResponseMeta {
+  Revision result_rev = 1 [json_name = "resultRev"];
+  optional int64 entitlement_version = 2 [json_name = "entitlementVersion"];
+  repeated string warnings = 3 [json_name = "warnings"];
+  Id correlation_id = 4 [json_name = "correlationId"];
+  optional uint64 recovery_generation = 5 [json_name = "recoveryGeneration"];
+}
+message ArcError {
+  optional string code = 1 [json_name = "code"];
+  optional ErrorCategory category = 2 [json_name = "category"];
+  optional string message_key = 3 [json_name = "messageKey"];
+  RetryAdvice retry = 4 [json_name = "retry"];
+  optional EffectCertainty effect = 5 [json_name = "effect"];
+  Id correlation_id = 6 [json_name = "correlationId"];
+  ErrorDetails details = 7 [json_name = "details"];
+}
+message RetryAdvice {
+  optional RetryMode mode = 1 [json_name = "mode"];
+  Instant retry_at = 2 [json_name = "retryAt"];
+  optional string reconciliation_operation = 3 [json_name = "reconciliationOperation"];
+}
+message ErrorDetails {
+  oneof detail {
+    RevisionConflict revision = 1 [json_name = "revision"];
+    LimitFailure limit = 2 [json_name = "limit"];
+    VersionFailure upgrade = 3 [json_name = "upgrade"];
+    StateFailure state = 4 [json_name = "state"];
+  }
+}
+message RevisionConflict {
+  Revision expected = 1 [json_name = "expected"];
+  Revision actual = 2 [json_name = "actual"];
+  Id conflict_id = 3 [json_name = "conflictId"];
+}
+message LimitFailure {
+  optional string limit_name = 1 [json_name = "limitName"];
+  Decimal maximum = 2 [json_name = "maximum"];
+  Decimal available = 3 [json_name = "available"];
+  Instant recovery_at = 4 [json_name = "recoveryAt"];
+}
+message VersionFailure {
+  optional string min_readable = 1 [json_name = "minReadable"];
+  optional string min_writable = 2 [json_name = "minWritable"];
+  optional string received = 3 [json_name = "received"];
+}
+message StateFailure {
+  optional string state = 1 [json_name = "state"];
+  optional string reason = 2 [json_name = "reason"];
+  AggregateRef resource = 3 [json_name = "resource"];
+  LocalNotesVersion local = 4 [json_name = "local"];
+  NativeContentRev native = 5 [json_name = "native"];
+}

package/schemas/public/proto/arcforges/hello/v1/hello.proto

@@ -0,0 +1,23 @@
+// SPDX-License-Identifier: Apache-2.0
+syntax = "proto3";
+
+package arcforges.hello.v1;
+
+option csharp_namespace = "ArcForges.Contracts.Hello.V1";
+option java_package = "io.github.arcforges.contracts.hello.v1";
+option java_multiple_files = true;
+option java_outer_classname = "HelloProto";
+
+// Packaging and transport demonstration, not a product API.
+service HelloService {
+  // Returns "Hello, <name>!". An empty name returns INVALID_ARGUMENT.
+  rpc SayHello(SayHelloRequest) returns (SayHelloResponse);
+}
+
+message SayHelloRequest {
+  string name = 1;
+}
+
+message SayHelloResponse {
+  string message = 1;
+}

package/source.json

@@ -1,16 +1,35 @@
 {
   "repository": "https://github.com/ArcForges/Contracts",
-  "commit": "9f0e90f65d57f405fcee311d467a57a255dfd644",
+  "commit": "0fbb746d3bd46c507a939e2901504f390e7cd2e2",
   "dirty": false,
-  "version": "1.0.0-ci.74.1",
-  "schema": "arcforges.hello.v1",
-  "descriptorSha256": "7219a8d730978bcc3b7b8769e159d06711dff3f2b07715a6d487589f8c09b99c",
+  "version": "1.0.0-ci.82.1",
+  "contractAccess": "public",
+  "schemaSources": {
+    "public/http/v1/inventory.schema.json": "fb6929548278f6e16e61491001fecae4143882efbfe732950a1584e1e2f80a5d",
+    "public/http/v1/schema.json": "23587b33320fcbe4a917c2839552984eb40e716c4ce317a5c218f35bedf06751",
+    "public/proto/arcforges/events/v1/events.proto": "ea0ac740c06bbb5b81724b4a7e601110424cabc4940b07e579cf97d852880f43",
+    "public/proto/arcforges/foundation/v1/foundation.proto": "9445c5229ff92c2376fb8bfb49ca98b4503441636544795b9853fba3cd25bdb6",
+    "public/proto/arcforges/hello/v1/hello.proto": "92489f89d1898a3d3bbea56c72116416cd0152ae8866c98745739437020c67d9"
+  },
+  "descriptorSha256": "1d9e586eee777509104447b60295d2af63a588f2885555763e8fc598e7d8d3c5",
   "dependencyLocks": {
-    "package-lock.json": "5ccbb6790ac9f6995b28d33a66f9c06192eeed2434892bdae8f9badde1614f7d",
-    "PublicApi/packages.lock.json": "6081ad4fb578234a0fb55b07cc28f635269fc9441be05a1d7c484bc423c25706",
-    "gradle.lockfile": "410eb7817f1bdf23eb5c2563b1953c4c2ee0403d54f687cb1ccdf82c0bd816de",
+    "package-lock.json": "9315666370bc19c05eed6023ef932f1c5305fe52cd64da4af74cbfe114c3681f",
+    "src/public/dotnet/ArcForges.Contracts.Foundation/packages.lock.json": "fa17fe6057706e36ae0b9370a457536d05d0f3a8f0f72df622881bfc1628337e",
+    "src/public/dotnet/ArcForges.Contracts.PublicApi/packages.lock.json": "6081ad4fb578234a0fb55b07cc28f635269fc9441be05a1d7c484bc423c25706",
+    "src/public/dotnet/ArcForges.Contracts.Events/packages.lock.json": "bfc4981894f94a4ee6f2518f6e1f5997d7d20e17749125c5711794cd2ee10d94",
+    "src/public/dotnet/ArcForges.Sdk.Contracts/packages.lock.json": "0244d57ce10e1aaf95d4e29c6d5794684c3a1e7bc64ba6543cf3232a08a3851b",
+    "src/public/dotnet/ArcForges.Contracts.Validation/packages.lock.json": "33ce7598a49127dbadcd5cac91b76f27bce523a5d226596df2bb3cc488317e52",
+    "src/public/dotnet/ArcForges.Sdk.Client/packages.lock.json": "4a9cd785831a5d0785bc43867548f2e6c4052552b1bd1734bd22166c925af61f",
+    "src/public/dotnet/ArcForges.Cli/packages.lock.json": "09563c12da99098f1aed0d2966cd8e45509e4b2b6a2a13cfc01dbb212128d858",
+    "src/internal/dotnet/ArcForges.Contracts.LocalRpc.Platform/packages.lock.json": "fa17fe6057706e36ae0b9370a457536d05d0f3a8f0f72df622881bfc1628337e",
+    "src/internal/dotnet/ArcForges.Contracts.LocalRpc.Sandbox/packages.lock.json": "fa17fe6057706e36ae0b9370a457536d05d0f3a8f0f72df622881bfc1628337e",
+    "src/internal/dotnet/ArcForges.Contracts.LocalRpc.Chat/packages.lock.json": "bfc4981894f94a4ee6f2518f6e1f5997d7d20e17749125c5711794cd2ee10d94",
+    "src/internal/dotnet/ArcForges.Contracts.LocalRpc.Notes/packages.lock.json": "bfc4981894f94a4ee6f2518f6e1f5997d7d20e17749125c5711794cd2ee10d94",
+    "src/internal/dotnet/ArcForges.Contracts.LocalRpc.Scope/packages.lock.json": "bfc4981894f94a4ee6f2518f6e1f5997d7d20e17749125c5711794cd2ee10d94",
+    "src/internal/dotnet/ArcForges.Contracts.LocalRpc.Slate/packages.lock.json": "bfc4981894f94a4ee6f2518f6e1f5997d7d20e17749125c5711794cd2ee10d94",
+    "src/internal/dotnet/ArcForges.Contracts.CloudInternal/packages.lock.json": "bfc4981894f94a4ee6f2518f6e1f5997d7d20e17749125c5711794cd2ee10d94",
+    "gradle.lockfile": "b176c43fe3fdb8fc99e36c8ccafc6dd1c07c2a2c0c0e9e5cbb3a328b70d128df",
     "src/public/kotlin/contract-fixtures/gradle.lockfile": "14dc5803d23ab183aa24b2849ee51541e52e4d26fbada80e19082d15e0b1c654",
-    "src/public/kotlin/contracts-client/gradle.lockfile": "8f73565fdf42782b54bc63075e9daa435f7301dcee0654657f47235975e640ce",
     "src/public/kotlin/contracts-connect-client/gradle.lockfile": "560f3bf8fa2d38cc4b9a87717342c7a3e003ed1243f405519f5b73e6de0acfb9",
     "src/public/kotlin/contracts-proto/gradle.lockfile": "766ba7a9c4101ae5149d0200ddc2bfc45d54aa1e3187717171a1dfab28a1ec4b"
   }