@arcforges/api-client 1.0.0-ci.168.1 → 1.0.0-ci.195.1

package/NOTICE

@@ -1,10 +1,10 @@
 ArcForges Contracts
 Copyright 2026 ArcForges contributors
 
-@arcforges/api-client 1.0.0-ci.168.1 (Apache-2.0)
+@arcforges/api-client 1.0.0-ci.195.1 (Apache-2.0)
 
 Resolved runtime dependency inventory (dependencies retain their own licences):
-- @arcforges/proto 1.0.0-ci.168.1: Apache-2.0 (pkg:npm/%40arcforges/proto@1.0.0-ci.168.1)
+- @arcforges/proto 1.0.0-ci.195.1: Apache-2.0 (pkg:npm/%40arcforges/proto@1.0.0-ci.195.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)
@@ -15,8 +15,8 @@ ArcForges source provenance notices
 
 Generated from reviewed active records. Original licence files and dependency notices remain authoritative.
 
-contract-bindings-con16-r1
-Source: https://github.com/ArcForges/Contracts @ 62e9ed8ca1b7f647289f6060ca87b66453d4e5eb
+con02-descriptor-bindings-r1
+Source: https://github.com/ArcForges/Contracts @ f7b8ffebdbe476e419b227ad1b60a26287582e17
 Material licence: Apache-2.0
 Notice scope: packages
 Copyright 2026 ArcForges contributors.

package/build-identity.json

@@ -3,17 +3,17 @@
   "owner": "Contracts",
   "artifact": {
     "id": "@arcforges/api-client",
-    "version": "1.0.0-ci.168.1"
+    "version": "1.0.0-ci.195.1"
   },
   "build": {
-    "sourceCommit": "7eeaa3b407ca1d99f1320ecf9d1fb752c9c9ba21",
+    "sourceCommit": "dbfb192751a3745626e89c7907ace188e01b41d7",
     "dirty": false,
     "kind": "ci",
-    "buildId": "36345239115.1",
-    "runId": "36345239115",
+    "buildId": "36348240598.1",
+    "runId": "36348240598",
     "runAttempt": 1,
-    "pipelineRun": "https://github.com/ArcForges/Contracts/actions/runs/36345239115",
-    "sourceDateEpoch": 1790538045
+    "pipelineRun": "https://github.com/ArcForges/Contracts/actions/runs/36348240598",
+    "sourceDateEpoch": 1790540988
   },
   "axes": {
     "AppVersion": {
@@ -30,16 +30,16 @@
             "path": "public/proto/arcforges/events/v1/events.proto",
             "sha256": "ea0ac740c06bbb5b81724b4a7e601110424cabc4940b07e579cf97d852880f43"
           },
-          "descriptorSha256": "0e0bd9c21aa0e68be10d5836a4b6c0a294ba58b609462b038b33783da4301d5e"
+          "descriptorSha256": "52f188b0f092fc0d0ee9aae5cbf174ec533cde4faf4895578bc56ff37e3decf9"
         },
         {
           "subject": "arcforges.foundation",
           "version": "1",
           "source": {
             "path": "public/proto/arcforges/foundation/v1/foundation.proto",
-            "sha256": "8412a262ed890e1048680d437c8cbb42ea4e94a31b9c62ee08b0ba3007f53f9e"
+            "sha256": "adff62f65799bc5523965caf40f1f6bf11cbb4e2d769f46d9e3183a72a6d24d5"
           },
-          "descriptorSha256": "0e0bd9c21aa0e68be10d5836a4b6c0a294ba58b609462b038b33783da4301d5e"
+          "descriptorSha256": "52f188b0f092fc0d0ee9aae5cbf174ec533cde4faf4895578bc56ff37e3decf9"
         },
         {
           "subject": "arcforges.hello",
@@ -48,16 +48,22 @@
             "path": "public/proto/arcforges/hello/v1/hello.proto",
             "sha256": "92489f89d1898a3d3bbea56c72116416cd0152ae8866c98745739437020c67d9"
           },
-          "descriptorSha256": "0e0bd9c21aa0e68be10d5836a4b6c0a294ba58b609462b038b33783da4301d5e"
+          "descriptorSha256": "52f188b0f092fc0d0ee9aae5cbf174ec533cde4faf4895578bc56ff37e3decf9"
         },
         {
           "subject": "arcforges.publicapi",
           "version": "1",
-          "source": {
-            "path": "public/proto/arcforges/publicapi/v1/content.proto",
-            "sha256": "15acce6e5618843a24115f8e5ddf64aba5e4fb60ca55dcb926a1900dc46d078f"
-          },
-          "descriptorSha256": "0e0bd9c21aa0e68be10d5836a4b6c0a294ba58b609462b038b33783da4301d5e"
+          "descriptorSha256": "52f188b0f092fc0d0ee9aae5cbf174ec533cde4faf4895578bc56ff37e3decf9",
+          "sources": [
+            {
+              "path": "public/proto/arcforges/publicapi/v1/content.proto",
+              "sha256": "15acce6e5618843a24115f8e5ddf64aba5e4fb60ca55dcb926a1900dc46d078f"
+            },
+            {
+              "path": "public/proto/arcforges/publicapi/v1/descriptors.proto",
+              "sha256": "d8a43c27fd345d55786a67ce9776efa0b4bc089f57361c3e532dd1b5f9326161"
+            }
+          ]
         },
         {
           "subject": "json:PackageInventory",
@@ -118,10 +124,10 @@
       "values": [
         {
           "subject": "pkg:npm/%40arcforges/proto",
-          "version": "1.0.0-ci.168.1",
+          "version": "1.0.0-ci.195.1",
           "source": {
             "path": "sbom.cdx.json#components",
-            "sha256": "a10e6aac477473fffdca812bf5225d4a81f85fbb40564f08d93440a0d16f8ced"
+            "sha256": "9d6556f926230219f32c5e554c4f126806a53f5e5f1a4be5a9480192703db619"
           }
         },
         {
@@ -129,7 +135,7 @@
           "version": "2.15.0",
           "source": {
             "path": "sbom.cdx.json#components",
-            "sha256": "a10e6aac477473fffdca812bf5225d4a81f85fbb40564f08d93440a0d16f8ced"
+            "sha256": "9d6556f926230219f32c5e554c4f126806a53f5e5f1a4be5a9480192703db619"
           }
         },
         {
@@ -137,7 +143,7 @@
           "version": "2.2.0",
           "source": {
             "path": "sbom.cdx.json#components",
-            "sha256": "a10e6aac477473fffdca812bf5225d4a81f85fbb40564f08d93440a0d16f8ced"
+            "sha256": "9d6556f926230219f32c5e554c4f126806a53f5e5f1a4be5a9480192703db619"
           }
         },
         {
@@ -145,7 +151,7 @@
           "version": "2.2.0",
           "source": {
             "path": "sbom.cdx.json#components",
-            "sha256": "a10e6aac477473fffdca812bf5225d4a81f85fbb40564f08d93440a0d16f8ced"
+            "sha256": "9d6556f926230219f32c5e554c4f126806a53f5e5f1a4be5a9480192703db619"
           }
         }
       ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcforges/api-client",
-  "version": "1.0.0-ci.168.1",
+  "version": "1.0.0-ci.195.1",
   "description": "ArcForges public gRPC-Web client entry point; initial Hello World example.",
   "type": "module",
   "license": "Apache-2.0",
@@ -33,7 +33,7 @@
     "source.json"
   ],
   "dependencies": {
-    "@arcforges/proto": "1.0.0-ci.168.1",
+    "@arcforges/proto": "1.0.0-ci.195.1",
     "@bufbuild/protobuf": "2.15.0",
     "@connectrpc/connect": "2.2.0",
     "@connectrpc/connect-web": "2.2.0"

package/sbom.cdx.json

@@ -5,10 +5,10 @@
   "metadata": {
     "component": {
       "type": "library",
-      "bom-ref": "pkg:npm/%40arcforges/api-client@1.0.0-ci.168.1",
+      "bom-ref": "pkg:npm/%40arcforges/api-client@1.0.0-ci.195.1",
       "name": "@arcforges/api-client",
-      "version": "1.0.0-ci.168.1",
-      "purl": "pkg:npm/%40arcforges/api-client@1.0.0-ci.168.1",
+      "version": "1.0.0-ci.195.1",
+      "purl": "pkg:npm/%40arcforges/api-client@1.0.0-ci.195.1",
       "licenses": [
         {
           "expression": "Apache-2.0"
@@ -19,10 +19,10 @@
   "components": [
     {
       "type": "library",
-      "bom-ref": "pkg:npm/%40arcforges/proto@1.0.0-ci.168.1",
+      "bom-ref": "pkg:npm/%40arcforges/proto@1.0.0-ci.195.1",
       "name": "@arcforges/proto",
-      "version": "1.0.0-ci.168.1",
-      "purl": "pkg:npm/%40arcforges/proto@1.0.0-ci.168.1",
+      "version": "1.0.0-ci.195.1",
+      "purl": "pkg:npm/%40arcforges/proto@1.0.0-ci.195.1",
       "licenses": [
         {
           "expression": "Apache-2.0"
@@ -72,7 +72,7 @@
       "dependsOn": []
     },
     {
-      "ref": "pkg:npm/%40arcforges/proto@1.0.0-ci.168.1",
+      "ref": "pkg:npm/%40arcforges/proto@1.0.0-ci.195.1",
       "dependsOn": [
         "pkg:npm/%40bufbuild/protobuf@2.15.0"
       ]
@@ -91,9 +91,9 @@
       ]
     },
     {
-      "ref": "pkg:npm/%40arcforges/api-client@1.0.0-ci.168.1",
+      "ref": "pkg:npm/%40arcforges/api-client@1.0.0-ci.195.1",
       "dependsOn": [
-        "pkg:npm/%40arcforges/proto@1.0.0-ci.168.1",
+        "pkg:npm/%40arcforges/proto@1.0.0-ci.195.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/proto/arcforges/foundation/v1/foundation.proto

@@ -8,6 +8,128 @@ option java_package = "io.github.arcforges.contracts.foundation.v1";
 option java_multiple_files = true;
 option java_outer_classname = "FoundationProto";
 
+// Registry04 descriptors describe compiled bindings; they never grant authority.
+enum ToolLocality {
+  TOOL_LOCALITY_UNSPECIFIED = 0;
+  TOOL_LOCALITY_CLOUD = 1;
+  TOOL_LOCALITY_DEVICE = 2;
+}
+enum ExecutionLocus {
+  EXECUTION_LOCUS_UNSPECIFIED = 0;
+  EXECUTION_LOCUS_CLOUD = 1;
+  EXECUTION_LOCUS_DEVICE = 2;
+  EXECUTION_LOCUS_EITHER = 3;
+}
+enum EffectKind {
+  EFFECT_KIND_UNSPECIFIED = 0;
+  EFFECT_KIND_PURE_READ = 1;
+  EFFECT_KIND_LOCAL_WRITE = 2;
+  EFFECT_KIND_CLOUD_WRITE = 3;
+  EFFECT_KIND_EXTERNAL_WRITE = 4;
+}
+enum BindingProtocol {
+  BINDING_PROTOCOL_UNSPECIFIED = 0;
+  BINDING_PROTOCOL_PUBLIC_GRPC = 1;
+  BINDING_PROTOCOL_LOCAL_GRPC = 2;
+  BINDING_PROTOCOL_EXTENSION_GRPC = 3;
+  BINDING_PROTOCOL_PROVIDER_HTTP = 4;
+  BINDING_PROTOCOL_MACHINE_TOOL = 5;
+  BINDING_PROTOCOL_IN_PROCESS = 6;
+}
+enum InstanceHealth {
+  INSTANCE_HEALTH_UNSPECIFIED = 0;
+  INSTANCE_HEALTH_READY = 1;
+  INSTANCE_HEALTH_BUSY = 2;
+  INSTANCE_HEALTH_DEGRADED = 3;
+  INSTANCE_HEALTH_DRAINING = 4;
+}
+message OperationBinding {
+  optional string operation_id = 1 [json_name = "operationId"];
+  optional BindingProtocol protocol = 2 [json_name = "protocol"];
+  optional string service = 3 [json_name = "service"];
+  optional string method = 4 [json_name = "method"];
+  optional uint32 contract_major = 5 [json_name = "contractMajor"];
+}
+message CancelSupport {
+  optional bool accepted = 1 [json_name = "accepted"];
+  optional bool before_dispatch_only = 2 [json_name = "beforeDispatchOnly"];
+  optional string status_operation = 3 [json_name = "statusOperation"];
+}
+message CapabilityLimits {
+  optional uint64 max_input_bytes = 1 [json_name = "maxInputBytes"];
+  optional uint64 max_output_bytes = 2 [json_name = "maxOutputBytes"];
+  optional uint64 max_duration_ms = 3 [json_name = "maxDurationMs"];
+  optional uint32 max_concurrency = 4 [json_name = "maxConcurrency"];
+  optional uint32 max_context_items = 5 [json_name = "maxContextItems"];
+}
+message CapabilityDescriptor {
+  optional string key = 1 [json_name = "key"];
+  optional string version = 2 [json_name = "version"];
+  optional string request_schema = 3 [json_name = "requestSchema"];
+  optional string response_schema = 4 [json_name = "responseSchema"];
+  optional string risk = 5 [json_name = "risk"];
+  optional ToolLocality locality = 6 [json_name = "locality"];
+  optional string idempotency = 7 [json_name = "idempotency"];
+  optional string status_operation = 8 [json_name = "statusOperation"];
+  repeated string reads = 9 [json_name = "reads"];
+  repeated string writes = 10 [json_name = "writes"];
+  optional bool exclusive = 11 [json_name = "exclusive"];
+  optional string egress = 12 [json_name = "egress"];
+  optional string approval = 13 [json_name = "approval"];
+  OperationBinding binding = 14 [json_name = "binding"];
+  optional ExecutionLocus execution = 15 [json_name = "execution"];
+  optional EffectKind effect = 16 [json_name = "effect"];
+  optional RetryMode retry = 17 [json_name = "retry"];
+  CancelSupport cancel = 18 [json_name = "cancel"];
+  OperationBinding preview = 19 [json_name = "preview"];
+  OperationBinding compensation = 20 [json_name = "compensation"];
+  optional bool checkpoint = 21 [json_name = "checkpoint"];
+  CapabilityLimits limits = 22 [json_name = "limits"];
+  repeated string accepted_context = 23 [json_name = "acceptedContext"];
+}
+message ActionDescriptor {
+  optional string key = 1 [json_name = "key"];
+  optional string title_key = 2 [json_name = "titleKey"];
+  optional string description_key = 3 [json_name = "descriptionKey"];
+  repeated string accepted_context = 4 [json_name = "acceptedContext"];
+  repeated string capabilities = 5 [json_name = "capabilities"];
+  optional string availability_rule = 6 [json_name = "availabilityRule"];
+}
+message ContractVersion {
+  optional string key = 1 [json_name = "key"];
+  optional string version = 2 [json_name = "version"];
+}
+message ContractCompatibility {
+  ContractVersion contract = 1 [json_name = "contract"];
+  optional string min_readable = 2 [json_name = "minReadable"];
+  optional string min_writable = 3 [json_name = "minWritable"];
+}
+message FeatureSet { repeated string features = 1 [json_name = "features"]; }
+message CompatibilityDescriptor {
+  ContractCompatibility foundation = 1 [json_name = "foundation"];
+  repeated ContractCompatibility contracts = 2 [json_name = "contracts"];
+  repeated ContractCompatibility capabilities = 3 [json_name = "capabilities"];
+  FeatureSet features = 4 [json_name = "features"];
+}
+message InstanceReadiness {
+  optional bool accepts_work = 1 [json_name = "acceptsWork"];
+  repeated string reasons = 2 [json_name = "reasons"];
+}
+message HealthSnapshot {
+  Id instance_id = 1 [json_name = "instanceId"];
+  Instant observed_at = 2 [json_name = "observedAt"];
+  optional InstanceHealth health = 3 [json_name = "health"];
+  InstanceReadiness readiness = 4 [json_name = "readiness"];
+}
+message EncodedBodyRef {
+  ResourceVersionRef resource = 1 [json_name = "resource"];
+  optional string message_type = 2 [json_name = "messageType"];
+  optional string descriptor_hash = 3 [json_name = "descriptorHash"];
+  optional uint64 byte_length = 4 [json_name = "byteLength"];
+  optional string snapshot_token = 5 [json_name = "snapshotToken"];
+  Instant expires_at = 6 [json_name = "expiresAt"];
+}
+
 // 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"]; }

package/schemas/public/proto/arcforges/publicapi/v1/descriptors.proto

@@ -0,0 +1,27 @@
+// SPDX-License-Identifier: Apache-2.0
+syntax = "proto3";
+package arcforges.publicapi.v1;
+import "arcforges/foundation/v1/foundation.proto";
+import "arcforges/publicapi/v1/content.proto";
+option csharp_namespace = "ArcForges.Contracts.PublicApi.V1";
+option java_package = "io.github.arcforges.contracts.publicapi.v1";
+option java_multiple_files = true;
+option java_outer_classname = "DescriptorsProto";
+
+// Descriptions reference registered providers and preserve ContextRef authority.
+message ContextProvider {
+  optional string key = 1 [json_name = "key"];
+  optional string app_id = 2 [json_name = "appId"];
+  optional string title_key = 3 [json_name = "titleKey"];
+  repeated string context_kinds = 4 [json_name = "contextKinds"];
+  optional uint32 max_items = 5 [json_name = "maxItems"];
+  optional uint32 max_bytes = 6 [json_name = "maxBytes"];
+}
+message ContextDescriptor {
+  optional string key = 1 [json_name = "key"];
+  optional string provider = 2 [json_name = "provider"];
+  optional string kind = 3 [json_name = "kind"];
+  optional string title_key = 4 [json_name = "titleKey"];
+  ContextRef context = 5 [json_name = "context"];
+  arcforges.foundation.v1.Instant observed_at = 6 [json_name = "observedAt"];
+}

package/source.json

@@ -1,19 +1,20 @@
 {
   "repository": "https://github.com/ArcForges/Contracts",
-  "commit": "7eeaa3b407ca1d99f1320ecf9d1fb752c9c9ba21",
+  "commit": "dbfb192751a3745626e89c7907ace188e01b41d7",
   "dirty": false,
-  "version": "1.0.0-ci.168.1",
+  "version": "1.0.0-ci.195.1",
   "contractAccess": "public",
   "schemaSources": {
     "public/http/v1/inventory.schema.json": "2d17acc663de43ff847e522ddb16f32b1e7ec356df7db7dcafe8342d3fb014ce",
     "public/http/v1/schema.json": "8d4c1282c0f93452a0304e44c832179d4c6f65fa563ae53517aa324af87105ce",
     "public/http/v1/signed-formats.schema.json": "9719004a495ae2475841dc3506b86a7ba8faa2eeb33d774dbf12effa5d495a03",
     "public/proto/arcforges/events/v1/events.proto": "ea0ac740c06bbb5b81724b4a7e601110424cabc4940b07e579cf97d852880f43",
-    "public/proto/arcforges/foundation/v1/foundation.proto": "8412a262ed890e1048680d437c8cbb42ea4e94a31b9c62ee08b0ba3007f53f9e",
+    "public/proto/arcforges/foundation/v1/foundation.proto": "adff62f65799bc5523965caf40f1f6bf11cbb4e2d769f46d9e3183a72a6d24d5",
     "public/proto/arcforges/hello/v1/hello.proto": "92489f89d1898a3d3bbea56c72116416cd0152ae8866c98745739437020c67d9",
-    "public/proto/arcforges/publicapi/v1/content.proto": "15acce6e5618843a24115f8e5ddf64aba5e4fb60ca55dcb926a1900dc46d078f"
+    "public/proto/arcforges/publicapi/v1/content.proto": "15acce6e5618843a24115f8e5ddf64aba5e4fb60ca55dcb926a1900dc46d078f",
+    "public/proto/arcforges/publicapi/v1/descriptors.proto": "d8a43c27fd345d55786a67ce9776efa0b4bc089f57361c3e532dd1b5f9326161"
   },
-  "descriptorSha256": "0e0bd9c21aa0e68be10d5836a4b6c0a294ba58b609462b038b33783da4301d5e",
+  "descriptorSha256": "52f188b0f092fc0d0ee9aae5cbf174ec533cde4faf4895578bc56ff37e3decf9",
   "dependencyLocks": {
     "package-lock.json": "3e536db25743ceb5a021559dbc1f31d57112211c62d94f84df34daca5382709c",
     "src/public/dotnet/ArcForges.Contracts.Foundation/packages.lock.json": "fa17fe6057706e36ae0b9370a457536d05d0f3a8f0f72df622881bfc1628337e",