@arcforges/api-client 1.0.0-ci.247.1 → 1.0.0-ci.250.1

package/NOTICE

@@ -1,10 +1,10 @@
 ArcForges Contracts
 Copyright 2026 ArcForges contributors
 
-@arcforges/api-client 1.0.0-ci.247.1 (Apache-2.0)
+@arcforges/api-client 1.0.0-ci.250.1 (Apache-2.0)
 
 Resolved runtime dependency inventory (dependencies retain their own licences):
-- @arcforges/proto 1.0.0-ci.247.1: Apache-2.0 (pkg:npm/%40arcforges/proto@1.0.0-ci.247.1)
+- @arcforges/proto 1.0.0-ci.250.1: Apache-2.0 (pkg:npm/%40arcforges/proto@1.0.0-ci.250.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-ext-02-r1
-Source: https://github.com/ArcForges/Contracts @ 8833ec80a3ead03048e6a1e8ea01a873b6b7f918
+contract-bindings-con-09-r1
+Source: https://github.com/ArcForges/Contracts @ e045bacb3370d211e557d14e9fc611ac820600ab
 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.247.1"
+    "version": "1.0.0-ci.250.1"
   },
   "build": {
-    "sourceCommit": "affeeae06e563340354698dd5e32d74891c96e78",
+    "sourceCommit": "bf42fef5e4fd28792004c8a16623465784e2bfb7",
     "dirty": false,
     "kind": "ci",
-    "buildId": "36478571433.1",
-    "runId": "36478571433",
+    "buildId": "36523643235.1",
+    "runId": "36523643235",
     "runAttempt": 1,
-    "pipelineRun": "https://github.com/ArcForges/Contracts/actions/runs/36478571433",
-    "sourceDateEpoch": 1790626866
+    "pipelineRun": "https://github.com/ArcForges/Contracts/actions/runs/36523643235",
+    "sourceDateEpoch": 1790657616
   },
   "axes": {
     "AppVersion": {
@@ -30,7 +30,7 @@
             "path": "public/proto/arcforges/catalog/v1/catalog.proto",
             "sha256": "ff77d24be445e107d4fb4a0b3f7fd6b205664317e856a3696e471be1a18f0828"
           },
-          "descriptorSha256": "4735c9b35035a39773980752ae9f541b8fa04cb0e2c8e449596a4bc0cd01bedf"
+          "descriptorSha256": "0a081f188ca51f6b12d07e9a80f05ab5a36f201e126e10f43bc297f956c01644"
         },
         {
           "subject": "arcforges.events",
@@ -39,16 +39,16 @@
             "path": "public/proto/arcforges/events/v1/events.proto",
             "sha256": "ea0ac740c06bbb5b81724b4a7e601110424cabc4940b07e579cf97d852880f43"
           },
-          "descriptorSha256": "4735c9b35035a39773980752ae9f541b8fa04cb0e2c8e449596a4bc0cd01bedf"
+          "descriptorSha256": "0a081f188ca51f6b12d07e9a80f05ab5a36f201e126e10f43bc297f956c01644"
         },
         {
           "subject": "arcforges.foundation",
           "version": "1",
           "source": {
             "path": "public/proto/arcforges/foundation/v1/foundation.proto",
-            "sha256": "adff62f65799bc5523965caf40f1f6bf11cbb4e2d769f46d9e3183a72a6d24d5"
+            "sha256": "e7e634103664dcca4c63383dd0eda5d90b408edb4786bfdf4a148856fed92736"
           },
-          "descriptorSha256": "4735c9b35035a39773980752ae9f541b8fa04cb0e2c8e449596a4bc0cd01bedf"
+          "descriptorSha256": "0a081f188ca51f6b12d07e9a80f05ab5a36f201e126e10f43bc297f956c01644"
         },
         {
           "subject": "arcforges.hello",
@@ -57,12 +57,12 @@
             "path": "public/proto/arcforges/hello/v1/hello.proto",
             "sha256": "92489f89d1898a3d3bbea56c72116416cd0152ae8866c98745739437020c67d9"
           },
-          "descriptorSha256": "4735c9b35035a39773980752ae9f541b8fa04cb0e2c8e449596a4bc0cd01bedf"
+          "descriptorSha256": "0a081f188ca51f6b12d07e9a80f05ab5a36f201e126e10f43bc297f956c01644"
         },
         {
           "subject": "arcforges.publicapi",
           "version": "1",
-          "descriptorSha256": "4735c9b35035a39773980752ae9f541b8fa04cb0e2c8e449596a4bc0cd01bedf",
+          "descriptorSha256": "0a081f188ca51f6b12d07e9a80f05ab5a36f201e126e10f43bc297f956c01644",
           "sources": [
             {
               "path": "public/proto/arcforges/publicapi/v1/commerce.proto",
@@ -79,6 +79,14 @@
             {
               "path": "public/proto/arcforges/publicapi/v1/inprocess-values.proto",
               "sha256": "24921ae4f54f48800ea1201a9eee27a4e23a476b738cc3903665dff137a10eea"
+            },
+            {
+              "path": "public/proto/arcforges/publicapi/v1/sync.proto",
+              "sha256": "2e7861c2cbb6d55aa36c9703b4409f3149365f2f1f53741f2dce3f0589cb84d6"
+            },
+            {
+              "path": "public/proto/arcforges/publicapi/v1/transfer.proto",
+              "sha256": "f7d53346a43cd977224154b33d8f1f3f3f4b973c67e513caf384b195654abc0e"
             }
           ]
         },
@@ -173,10 +181,10 @@
       "values": [
         {
           "subject": "pkg:npm/%40arcforges/proto",
-          "version": "1.0.0-ci.247.1",
+          "version": "1.0.0-ci.250.1",
           "source": {
             "path": "sbom.cdx.json#components",
-            "sha256": "6c25b89642d9cdac5690555f6d952c2d54147e101a229f9d6f88fa83d6293b98"
+            "sha256": "419e414ae051c42360478cd6f19bf2fe95402d91454bf92ad42442cec4c1911e"
           }
         },
         {
@@ -184,7 +192,7 @@
           "version": "2.15.0",
           "source": {
             "path": "sbom.cdx.json#components",
-            "sha256": "6c25b89642d9cdac5690555f6d952c2d54147e101a229f9d6f88fa83d6293b98"
+            "sha256": "419e414ae051c42360478cd6f19bf2fe95402d91454bf92ad42442cec4c1911e"
           }
         },
         {
@@ -192,7 +200,7 @@
           "version": "2.2.0",
           "source": {
             "path": "sbom.cdx.json#components",
-            "sha256": "6c25b89642d9cdac5690555f6d952c2d54147e101a229f9d6f88fa83d6293b98"
+            "sha256": "419e414ae051c42360478cd6f19bf2fe95402d91454bf92ad42442cec4c1911e"
           }
         },
         {
@@ -200,7 +208,7 @@
           "version": "2.2.0",
           "source": {
             "path": "sbom.cdx.json#components",
-            "sha256": "6c25b89642d9cdac5690555f6d952c2d54147e101a229f9d6f88fa83d6293b98"
+            "sha256": "419e414ae051c42360478cd6f19bf2fe95402d91454bf92ad42442cec4c1911e"
           }
         }
       ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcforges/api-client",
-  "version": "1.0.0-ci.247.1",
+  "version": "1.0.0-ci.250.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.247.1",
+    "@arcforges/proto": "1.0.0-ci.250.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.247.1",
+      "bom-ref": "pkg:npm/%40arcforges/api-client@1.0.0-ci.250.1",
       "name": "@arcforges/api-client",
-      "version": "1.0.0-ci.247.1",
-      "purl": "pkg:npm/%40arcforges/api-client@1.0.0-ci.247.1",
+      "version": "1.0.0-ci.250.1",
+      "purl": "pkg:npm/%40arcforges/api-client@1.0.0-ci.250.1",
       "licenses": [
         {
           "expression": "Apache-2.0"
@@ -19,10 +19,10 @@
   "components": [
     {
       "type": "library",
-      "bom-ref": "pkg:npm/%40arcforges/proto@1.0.0-ci.247.1",
+      "bom-ref": "pkg:npm/%40arcforges/proto@1.0.0-ci.250.1",
       "name": "@arcforges/proto",
-      "version": "1.0.0-ci.247.1",
-      "purl": "pkg:npm/%40arcforges/proto@1.0.0-ci.247.1",
+      "version": "1.0.0-ci.250.1",
+      "purl": "pkg:npm/%40arcforges/proto@1.0.0-ci.250.1",
       "licenses": [
         {
           "expression": "Apache-2.0"
@@ -72,7 +72,7 @@
       "dependsOn": []
     },
     {
-      "ref": "pkg:npm/%40arcforges/proto@1.0.0-ci.247.1",
+      "ref": "pkg:npm/%40arcforges/proto@1.0.0-ci.250.1",
       "dependsOn": [
         "pkg:npm/%40bufbuild/protobuf@2.15.0"
       ]
@@ -91,9 +91,9 @@
       ]
     },
     {
-      "ref": "pkg:npm/%40arcforges/api-client@1.0.0-ci.247.1",
+      "ref": "pkg:npm/%40arcforges/api-client@1.0.0-ci.250.1",
       "dependsOn": [
-        "pkg:npm/%40arcforges/proto@1.0.0-ci.247.1",
+        "pkg:npm/%40arcforges/proto@1.0.0-ci.250.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

@@ -371,3 +371,14 @@ message TimeRangeUtc {
   Instant from = 1 [json_name = "from"];
   Instant until = 2 [json_name = "until"];
 }
+
+// registry04: opaque object-facade route, bound to the current session and
+// allowed verb. This public value never contains storage credentials.
+message TransferTicket {
+  Id ticket_id = 1 [json_name = "ticketId"];
+  optional string url = 2 [json_name = "url"];
+  Instant expires_at = 3 [json_name = "expiresAt"];
+  Id resource_id = 4 [json_name = "resourceId"];
+  ByteRange range = 5 [json_name = "range"];
+  optional uint32 max_part_bytes = 6 [json_name = "maxPartBytes"];
+}

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

@@ -0,0 +1,459 @@
+// SPDX-License-Identifier: Apache-2.0
+syntax = "proto3";
+
+package arcforges.publicapi.v1;
+
+import "arcforges/foundation/v1/foundation.proto";
+import "arcforges/publicapi/v1/content.proto";
+import "arcforges/publicapi/v1/inprocess-values.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 = "SyncProto";
+
+// Public Sync and resource-transfer contracts from registry04. These schemas
+// describe typed owner operations; they do not implement owner transactions.
+service SyncService {
+  rpc ListScopes(SyncServiceListScopesRequest) returns (SyncServiceListScopesResponse);
+  rpc SetScope(SyncServiceSetScopeRequest) returns (SyncServiceSetScopeResponse);
+  rpc PullChanges(SyncServicePullChangesRequest) returns (SyncServicePullChangesResponse);
+  rpc PushChange(SyncServicePushChangeRequest) returns (SyncServicePushChangeResponse);
+  rpc PushBatch(SyncServicePushBatchRequest) returns (SyncServicePushBatchResponse);
+  rpc GetAggregate(SyncServiceGetAggregateRequest) returns (SyncServiceGetAggregateResponse);
+  rpc ListConflicts(SyncServiceListConflictsRequest) returns (SyncServiceListConflictsResponse);
+  rpc ResolveConflict(SyncServiceResolveConflictRequest) returns (SyncServiceResolveConflictResponse);
+  rpc RequestFullResync(SyncServiceRequestFullResyncRequest) returns (SyncServiceRequestFullResyncResponse);
+  rpc GetBootstrapPage(SyncServiceGetBootstrapPageRequest) returns (SyncServiceGetBootstrapPageResponse);
+}
+
+service ResourceService {
+  rpc BeginUpload(ResourceServiceBeginUploadRequest) returns (ResourceServiceBeginUploadResponse);
+  rpc CompleteUpload(ResourceServiceCompleteUploadRequest) returns (ResourceServiceCompleteUploadResponse);
+  rpc GetDownloadTicket(ResourceServiceGetDownloadTicketRequest) returns (ResourceServiceGetDownloadTicketResponse);
+  rpc GetMetadata(ResourceServiceGetMetadataRequest) returns (ResourceServiceGetMetadataResponse);
+  rpc Release(ResourceServiceReleaseRequest) returns (ResourceServiceReleaseResponse);
+  rpc GetUploadStatus(ResourceServiceGetUploadStatusRequest) returns (ResourceServiceGetUploadStatusResponse);
+  rpc RenewUploadTicket(ResourceServiceRenewUploadTicketRequest) returns (ResourceServiceRenewUploadTicketResponse);
+}
+
+enum ResourcePurpose {
+  RESOURCE_PURPOSE_UNSPECIFIED = 0;
+  RESOURCE_PURPOSE_ATTACHMENT = 1;
+  RESOURCE_PURPOSE_EXPORT = 2;
+  RESOURCE_PURPOSE_SIMULATOR_SEGMENT = 3;
+  RESOURCE_PURPOSE_AI_OUTPUT = 4;
+  RESOURCE_PURPOSE_DIAGNOSTIC = 5;
+  RESOURCE_PURPOSE_MANAGED_ASSET = 6;
+  RESOURCE_PURPOSE_TRANSIENT_INPUT = 7;
+}
+
+message SyncScope {
+  arcforges.foundation.v1.Id scope_id = 1 [json_name = "scopeId"];
+  string kind = 2 [json_name = "kind"];
+  bool enabled = 3 [json_name = "enabled"];
+  repeated string exclusions = 4 [json_name = "exclusions"];
+  arcforges.foundation.v1.Revision revision = 5 [json_name = "revision"];
+}
+
+message SyncChange {
+  arcforges.foundation.v1.AggregateRef root = 1 [json_name = "root"];
+  arcforges.foundation.v1.Revision revision = 2 [json_name = "revision"];
+  string schema_version = 3 [json_name = "schemaVersion"];
+  bool tombstone = 4 [json_name = "tombstone"];
+  arcforges.foundation.v1.Id origin_device_id = 5 [json_name = "originDeviceId"];
+  uint64 publication_sequence = 6 [json_name = "publicationSequence"];
+}
+
+message ChangeProposal {
+  arcforges.foundation.v1.AggregateRef root = 1 [json_name = "root"];
+  arcforges.foundation.v1.Revision base_rev = 2 [json_name = "baseRev"];
+  uint64 local_sequence = 3 [json_name = "localSequence"];
+  arcforges.foundation.v1.Id command_id = 4 [json_name = "commandId"];
+  string schema_version = 5 [json_name = "schemaVersion"];
+  AggregateBody body = 6 [json_name = "body"];
+  string content_hash = 7 [json_name = "contentHash"];
+}
+
+message ChangeReceipt {
+  arcforges.foundation.v1.Id command_id = 1 [json_name = "commandId"];
+  oneof outcome {
+    AggregateView accepted = 2 [json_name = "accepted"];
+    arcforges.foundation.v1.ArcError error = 3 [json_name = "error"];
+  }
+}
+
+message AggregateView {
+  arcforges.foundation.v1.AggregateRef root = 1 [json_name = "root"];
+  arcforges.foundation.v1.Revision revision = 2 [json_name = "revision"];
+  string schema_version = 3 [json_name = "schemaVersion"];
+  AggregateBody body = 4 [json_name = "body"];
+  bool tombstone = 5 [json_name = "tombstone"];
+  string content_hash = 6 [json_name = "contentHash"];
+}
+
+message ConflictView {
+  arcforges.foundation.v1.Id conflict_id = 1 [json_name = "conflictId"];
+  arcforges.foundation.v1.AggregateRef root = 2 [json_name = "root"];
+  arcforges.foundation.v1.Revision base_rev = 3 [json_name = "baseRev"];
+  arcforges.foundation.v1.Revision current_rev = 4 [json_name = "currentRev"];
+  ChangeProposal proposal = 5 [json_name = "proposal"];
+  string state = 6 [json_name = "state"];
+}
+
+message ConflictResolution {
+  string choice = 1 [json_name = "choice"];
+  AggregateBody merged_body = 2 [json_name = "mergedBody"];
+  string source_proposal_hash = 3 [json_name = "sourceProposalHash"];
+}
+
+message BootstrapManifest {
+  arcforges.foundation.v1.Id bootstrap_id = 1 [json_name = "bootstrapId"];
+  arcforges.foundation.v1.Id scope_id = 2 [json_name = "scopeId"];
+  string snapshot_token = 3 [json_name = "snapshotToken"];
+  arcforges.foundation.v1.Instant expires_at = 4 [json_name = "expiresAt"];
+  string resume_cursor = 5 [json_name = "resumeCursor"];
+}
+
+message PartReceipt {
+  uint32 part_number = 1 [json_name = "partNumber"];
+  uint64 size = 2 [json_name = "size"];
+  string sha256 = 3 [json_name = "sha256"];
+  string etag = 4 [json_name = "etag"];
+}
+
+message UploadTicket {
+  arcforges.foundation.v1.Id upload_id = 1 [json_name = "uploadId"];
+  arcforges.foundation.v1.Id resource_id = 2 [json_name = "resourceId"];
+  arcforges.foundation.v1.TransferTicket ticket = 3 [json_name = "ticket"];
+  uint32 part_bytes = 4 [json_name = "partBytes"];
+  repeated PartReceipt uploaded = 5 [json_name = "uploaded"];
+}
+
+message UploadStatus {
+  arcforges.foundation.v1.Id upload_id = 1 [json_name = "uploadId"];
+  string state = 2 [json_name = "state"];
+  repeated PartReceipt parts = 3 [json_name = "parts"];
+  arcforges.foundation.v1.ResourceRef resource = 4 [json_name = "resource"];
+  arcforges.foundation.v1.Id provisional_pin = 5 [json_name = "provisionalPin"];
+  arcforges.foundation.v1.Instant expires_at = 6 [json_name = "expiresAt"];
+  optional string reason = 7 [json_name = "reason"];
+  arcforges.foundation.v1.PageState parts_page = 8 [json_name = "partsPage"];
+}
+
+message SyncServiceListScopesRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.PageRequest page = 10 [json_name = "page"];
+}
+message SyncServiceListScopesValue {
+  repeated SyncScope items = 10 [json_name = "items"];
+  arcforges.foundation.v1.PageState page = 11 [json_name = "page"];
+}
+message SyncServiceListScopesResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    SyncServiceListScopesValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3 [json_name = "error"];
+  }
+  reserved 4 to 9;
+}
+
+message SyncServiceSetScopeRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.Id scope_id = 10 [json_name = "scopeId"];
+  bool enabled = 11 [json_name = "enabled"];
+  repeated string exclusions = 12 [json_name = "exclusions"];
+}
+message SyncServiceSetScopeValue {
+  SyncScope scope = 10 [json_name = "scope"];
+}
+message SyncServiceSetScopeResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    SyncServiceSetScopeValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3 [json_name = "error"];
+  }
+  reserved 4 to 9;
+}
+
+message SyncServicePullChangesRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.Id scope_id = 10 [json_name = "scopeId"];
+  optional string cursor = 11 [json_name = "cursor"];
+  int32 limit = 12 [json_name = "limit"];
+}
+message SyncServicePullChangesValue {
+  repeated SyncChange changes = 10 [json_name = "changes"];
+  string next_cursor = 11 [json_name = "nextCursor"];
+  bool has_more = 12 [json_name = "hasMore"];
+}
+message SyncServicePullChangesResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    SyncServicePullChangesValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3;
+  }
+  reserved 4 to 9;
+}
+
+message SyncServicePushChangeRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  ChangeProposal change = 10 [json_name = "change"];
+}
+message SyncServicePushChangeValue {
+  ChangeReceipt result = 10 [json_name = "result"];
+}
+message SyncServicePushChangeResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    SyncServicePushChangeValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3;
+  }
+  reserved 4 to 9;
+}
+
+message SyncServicePushBatchRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  repeated ChangeProposal changes = 10 [json_name = "changes"];
+}
+message SyncServicePushBatchValue {
+  repeated ChangeReceipt results = 10 [json_name = "results"];
+}
+message SyncServicePushBatchResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    SyncServicePushBatchValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3;
+  }
+  reserved 4 to 9;
+}
+
+message SyncServiceGetAggregateRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.AggregateRef root = 10 [json_name = "root"];
+  arcforges.foundation.v1.Revision min_revision = 11 [json_name = "minRevision"];
+}
+message SyncServiceGetAggregateValue {
+  AggregateView aggregate = 10 [json_name = "aggregate"];
+}
+message SyncServiceGetAggregateResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    SyncServiceGetAggregateValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3;
+    arcforges.foundation.v1.EncodedBodyRef encoded_body = 4 [json_name = "encodedBody"];
+  }
+  reserved 5 to 9;
+}
+
+message SyncServiceListConflictsRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.Id scope_id = 10 [json_name = "scopeId"];
+  arcforges.foundation.v1.PageRequest page = 11 [json_name = "page"];
+}
+message SyncServiceListConflictsValue {
+  repeated ConflictView items = 10 [json_name = "items"];
+  arcforges.foundation.v1.PageState page = 11 [json_name = "page"];
+}
+message SyncServiceListConflictsResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    SyncServiceListConflictsValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3;
+    arcforges.foundation.v1.EncodedBodyRef encoded_body = 4 [json_name = "encodedBody"];
+  }
+  reserved 5 to 9;
+}
+
+message SyncServiceResolveConflictRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.Id conflict_id = 10 [json_name = "conflictId"];
+  ConflictResolution resolution = 11 [json_name = "resolution"];
+}
+message SyncServiceResolveConflictValue {
+  ChangeReceipt result = 10 [json_name = "result"];
+}
+message SyncServiceResolveConflictResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    SyncServiceResolveConflictValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3;
+  }
+  reserved 4 to 9;
+}
+
+message SyncServiceRequestFullResyncRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.Id scope_id = 10 [json_name = "scopeId"];
+}
+message SyncServiceRequestFullResyncValue {
+  BootstrapManifest bootstrap = 10 [json_name = "bootstrap"];
+}
+message SyncServiceRequestFullResyncResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    SyncServiceRequestFullResyncValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3;
+  }
+  reserved 4 to 9;
+}
+
+message SyncServiceGetBootstrapPageRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.Id bootstrap_id = 10 [json_name = "bootstrapId"];
+  optional string cursor = 11 [json_name = "cursor"];
+}
+message SyncServiceGetBootstrapPageValue {
+  repeated AggregateView items = 10 [json_name = "items"];
+  arcforges.foundation.v1.PageState page = 11 [json_name = "page"];
+  optional string resume_cursor = 12 [json_name = "resumeCursor"];
+}
+message SyncServiceGetBootstrapPageResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    SyncServiceGetBootstrapPageValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3;
+    arcforges.foundation.v1.EncodedBodyRef encoded_body = 4 [json_name = "encodedBody"];
+  }
+  reserved 5 to 9;
+}
+
+message ResourceServiceBeginUploadRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.Id upload_id = 10 [json_name = "uploadId"];
+  arcforges.foundation.v1.Id resource_id = 11 [json_name = "resourceId"];
+  uint64 size = 12 [json_name = "size"];
+  string sha256 = 13 [json_name = "sha256"];
+  string media_type = 14 [json_name = "mediaType"];
+  ResourcePurpose purpose = 15 [json_name = "purpose"];
+  arcforges.foundation.v1.AggregateRef owner = 16 [json_name = "owner"];
+}
+message ResourceServiceBeginUploadValue {
+  UploadTicket ticket = 10 [json_name = "ticket"];
+}
+message ResourceServiceBeginUploadResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    ResourceServiceBeginUploadValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3;
+  }
+  reserved 4 to 9;
+}
+
+message ResourceServiceCompleteUploadRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.Id upload_id = 10 [json_name = "uploadId"];
+  repeated PartReceipt parts = 11 [json_name = "parts"];
+}
+message ResourceServiceCompleteUploadValue {
+  UploadStatus status = 10 [json_name = "status"];
+}
+message ResourceServiceCompleteUploadResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    ResourceServiceCompleteUploadValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3;
+  }
+  reserved 4 to 9;
+}
+
+message ResourceServiceGetDownloadTicketRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.Id resource_id = 10 [json_name = "resourceId"];
+  arcforges.foundation.v1.ByteRange range = 11 [json_name = "range"];
+  arcforges.foundation.v1.ResourceVersionRef version = 12 [json_name = "version"];
+}
+message ResourceServiceGetDownloadTicketValue {
+  arcforges.foundation.v1.TransferTicket ticket = 10 [json_name = "ticket"];
+}
+message ResourceServiceGetDownloadTicketResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    ResourceServiceGetDownloadTicketValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3;
+  }
+  reserved 4 to 9;
+}
+
+message ResourceServiceGetMetadataRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.Id resource_id = 10 [json_name = "resourceId"];
+}
+message ResourceServiceGetMetadataValue {
+  ResourceMetadata metadata = 10 [json_name = "metadata"];
+}
+message ResourceServiceGetMetadataResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    ResourceServiceGetMetadataValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3;
+  }
+  reserved 4 to 9;
+}
+
+message ResourceServiceReleaseRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.Id resource_id = 10 [json_name = "resourceId"];
+  arcforges.foundation.v1.AggregateRef referrer = 11 [json_name = "referrer"];
+}
+message ResourceServiceReleaseValue {
+  arcforges.foundation.v1.Receipt receipt = 10 [json_name = "receipt"];
+}
+message ResourceServiceReleaseResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    ResourceServiceReleaseValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3;
+  }
+  reserved 4 to 9;
+}
+
+message ResourceServiceGetUploadStatusRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.Id upload_id = 10 [json_name = "uploadId"];
+  arcforges.foundation.v1.PageRequest page = 11 [json_name = "page"];
+}
+message ResourceServiceGetUploadStatusValue {
+  UploadStatus status = 10 [json_name = "status"];
+}
+message ResourceServiceGetUploadStatusResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    ResourceServiceGetUploadStatusValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3;
+  }
+  reserved 4 to 9;
+}
+
+message ResourceServiceRenewUploadTicketRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.Id upload_id = 10 [json_name = "uploadId"];
+}
+message ResourceServiceRenewUploadTicketValue {
+  arcforges.foundation.v1.TransferTicket ticket = 10 [json_name = "ticket"];
+}
+message ResourceServiceRenewUploadTicketResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    ResourceServiceRenewUploadTicketValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3;
+  }
+  reserved 4 to 9;
+}

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

@@ -0,0 +1,190 @@
+// SPDX-License-Identifier: Apache-2.0
+syntax = "proto3";
+
+package arcforges.publicapi.v1;
+
+import "arcforges/foundation/v1/foundation.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 = "TransferProto";
+
+// realm-transfer.v1 schema surface. Included roots and per-root fidelity are
+// represented by the typed TransferRoot and TransferIssue records. These
+// declarations do not implement import/export jobs or owner authorization.
+service TransferService {
+  rpc RequestExport(TransferServiceRequestExportRequest) returns (TransferServiceRequestExportResponse);
+  rpc PreviewImport(TransferServicePreviewImportRequest) returns (TransferServicePreviewImportResponse);
+  rpc CommitImport(TransferServiceCommitImportRequest) returns (TransferServiceCommitImportResponse);
+  rpc Get(TransferServiceGetRequest) returns (TransferServiceGetResponse);
+  rpc List(TransferServiceListRequest) returns (TransferServiceListResponse);
+  rpc Cancel(TransferServiceCancelRequest) returns (TransferServiceCancelResponse);
+}
+
+enum TransferState {
+  TRANSFER_STATE_UNSPECIFIED = 0;
+  TRANSFER_STATE_QUEUED = 1;
+  TRANSFER_STATE_VALIDATING = 2;
+  TRANSFER_STATE_WAITING_CONSENT = 3;
+  TRANSFER_STATE_IMPORTING = 4;
+  TRANSFER_STATE_SUCCEEDED = 5;
+  TRANSFER_STATE_PARTIALLY_SUCCEEDED = 6;
+  TRANSFER_STATE_FAILED = 7;
+  TRANSFER_STATE_CANCELED = 8;
+}
+
+message TransferManifest {
+  arcforges.foundation.v1.Id transfer_id = 1 [json_name = "transferId"];
+  string version = 2 [json_name = "version"];
+  string source_realm = 3 [json_name = "sourceRealm"];
+  arcforges.foundation.v1.Id source_workspace_id = 4 [json_name = "sourceWorkspaceId"];
+  arcforges.foundation.v1.Instant created_at = 5 [json_name = "createdAt"];
+  repeated TransferRoot roots = 6 [json_name = "roots"];
+  repeated arcforges.foundation.v1.ResourceVersionRef blobs = 7 [json_name = "blobs"];
+  string sha256 = 8 [json_name = "sha256"];
+}
+
+message TransferRoot {
+  arcforges.foundation.v1.VersionedRef source = 1 [json_name = "source"];
+  string kind = 2 [json_name = "kind"];
+  arcforges.foundation.v1.ResourceVersionRef body = 3 [json_name = "body"];
+  arcforges.foundation.v1.ContentOrigin origin = 4 [json_name = "origin"];
+  repeated arcforges.foundation.v1.AggregateRef dependencies = 5 [json_name = "dependencies"];
+}
+
+message TransferIssue {
+  string code = 1 [json_name = "code"];
+  arcforges.foundation.v1.AggregateRef source = 2 [json_name = "source"];
+  string detail = 3 [json_name = "detail"];
+  optional bool blocks_commit = 4 [json_name = "blocksCommit"];
+}
+
+message TransferJob {
+  arcforges.foundation.v1.Id transfer_id = 1 [json_name = "transferId"];
+  TransferState state = 2 [json_name = "state"];
+  arcforges.foundation.v1.Revision revision = 3 [json_name = "revision"];
+  arcforges.foundation.v1.ResourceVersionRef manifest = 4 [json_name = "manifest"];
+  optional string preview_hash = 5 [json_name = "previewHash"];
+  uint64 committed_roots = 6 [json_name = "committedRoots"];
+  uint64 total_roots = 7 [json_name = "totalRoots"];
+  repeated TransferIssue issues = 8 [json_name = "issues"];
+  arcforges.foundation.v1.PageState page = 9 [json_name = "page"];
+  arcforges.foundation.v1.Instant expires_at = 10 [json_name = "expiresAt"];
+}
+
+message TransferMapping {
+  arcforges.foundation.v1.AggregateRef source = 1 [json_name = "source"];
+  arcforges.foundation.v1.AggregateRef target = 2 [json_name = "target"];
+  arcforges.foundation.v1.Revision target_revision = 3 [json_name = "targetRevision"];
+  string state = 4 [json_name = "state"];
+}
+
+message TransferServiceRequestExportRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.Id transfer_id = 10 [json_name = "transferId"];
+  repeated arcforges.foundation.v1.AggregateRef roots = 11 [json_name = "roots"];
+}
+message TransferServiceRequestExportValue {
+  TransferJob job = 10 [json_name = "job"];
+}
+message TransferServiceRequestExportResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    TransferServiceRequestExportValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3;
+  }
+  reserved 4 to 9;
+}
+
+message TransferServicePreviewImportRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.Id transfer_id = 10 [json_name = "transferId"];
+  arcforges.foundation.v1.ResourceVersionRef manifest = 11 [json_name = "manifest"];
+}
+message TransferServicePreviewImportValue {
+  TransferJob job = 10 [json_name = "job"];
+}
+message TransferServicePreviewImportResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    TransferServicePreviewImportValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3;
+  }
+  reserved 4 to 9;
+}
+
+message TransferServiceCommitImportRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.Id transfer_id = 10 [json_name = "transferId"];
+  string preview_hash = 11 [json_name = "previewHash"];
+  repeated string accepted_issues = 12 [json_name = "acceptedIssues"];
+}
+message TransferServiceCommitImportValue {
+  TransferJob job = 10 [json_name = "job"];
+}
+message TransferServiceCommitImportResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    TransferServiceCommitImportValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3;
+  }
+  reserved 4 to 9;
+}
+
+message TransferServiceGetRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.Id transfer_id = 10 [json_name = "transferId"];
+  arcforges.foundation.v1.PageRequest page = 11 [json_name = "page"];
+}
+message TransferServiceGetValue {
+  TransferJob job = 10 [json_name = "job"];
+  repeated TransferMapping mappings = 11 [json_name = "mappings"];
+}
+message TransferServiceGetResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    TransferServiceGetValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3;
+  }
+  reserved 4 to 9;
+}
+
+message TransferServiceListRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.PageRequest page = 10 [json_name = "page"];
+}
+message TransferServiceListValue {
+  repeated TransferJob jobs = 10 [json_name = "jobs"];
+  arcforges.foundation.v1.PageState page = 11 [json_name = "page"];
+}
+message TransferServiceListResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    TransferServiceListValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3;
+  }
+  reserved 4 to 9;
+}
+
+message TransferServiceCancelRequest {
+  arcforges.foundation.v1.RequestMeta meta = 1 [json_name = "meta"];
+  reserved 2 to 9;
+  arcforges.foundation.v1.Id transfer_id = 10 [json_name = "transferId"];
+}
+message TransferServiceCancelValue {
+  TransferJob job = 10 [json_name = "job"];
+}
+message TransferServiceCancelResponse {
+  arcforges.foundation.v1.ResponseMeta meta = 1 [json_name = "meta"];
+  oneof outcome {
+    TransferServiceCancelValue value = 2 [json_name = "value"];
+    arcforges.foundation.v1.ArcError error = 3;
+  }
+  reserved 4 to 9;
+}

package/source.json

@@ -1,8 +1,8 @@
 {
   "repository": "https://github.com/ArcForges/Contracts",
-  "commit": "affeeae06e563340354698dd5e32d74891c96e78",
+  "commit": "bf42fef5e4fd28792004c8a16623465784e2bfb7",
   "dirty": false,
-  "version": "1.0.0-ci.247.1",
+  "version": "1.0.0-ci.250.1",
   "contractAccess": "public",
   "schemaSources": {
     "public/http/v1/inventory.schema.json": "2d17acc663de43ff847e522ddb16f32b1e7ec356df7db7dcafe8342d3fb014ce",
@@ -14,14 +14,16 @@
     "public/http/v1/workflow.schema.json": "a23961e89badb790abca4f7fef01a833d647394b16194c51d7b4f79352181b42",
     "public/proto/arcforges/catalog/v1/catalog.proto": "ff77d24be445e107d4fb4a0b3f7fd6b205664317e856a3696e471be1a18f0828",
     "public/proto/arcforges/events/v1/events.proto": "ea0ac740c06bbb5b81724b4a7e601110424cabc4940b07e579cf97d852880f43",
-    "public/proto/arcforges/foundation/v1/foundation.proto": "adff62f65799bc5523965caf40f1f6bf11cbb4e2d769f46d9e3183a72a6d24d5",
+    "public/proto/arcforges/foundation/v1/foundation.proto": "e7e634103664dcca4c63383dd0eda5d90b408edb4786bfdf4a148856fed92736",
     "public/proto/arcforges/hello/v1/hello.proto": "92489f89d1898a3d3bbea56c72116416cd0152ae8866c98745739437020c67d9",
     "public/proto/arcforges/publicapi/v1/commerce.proto": "e0ed5700197fdb20006c7ea699d9071dd8c4ac9d4248651f8a148363ad8af9dc",
     "public/proto/arcforges/publicapi/v1/content.proto": "1c912ac9fa37633a3e5d186cb6f3838bd886f09f935e1ce41c5a665640c54abd",
     "public/proto/arcforges/publicapi/v1/descriptors.proto": "d8a43c27fd345d55786a67ce9776efa0b4bc089f57361c3e532dd1b5f9326161",
-    "public/proto/arcforges/publicapi/v1/inprocess-values.proto": "24921ae4f54f48800ea1201a9eee27a4e23a476b738cc3903665dff137a10eea"
+    "public/proto/arcforges/publicapi/v1/inprocess-values.proto": "24921ae4f54f48800ea1201a9eee27a4e23a476b738cc3903665dff137a10eea",
+    "public/proto/arcforges/publicapi/v1/sync.proto": "2e7861c2cbb6d55aa36c9703b4409f3149365f2f1f53741f2dce3f0589cb84d6",
+    "public/proto/arcforges/publicapi/v1/transfer.proto": "f7d53346a43cd977224154b33d8f1f3f3f4b973c67e513caf384b195654abc0e"
   },
-  "descriptorSha256": "4735c9b35035a39773980752ae9f541b8fa04cb0e2c8e449596a4bc0cd01bedf",
+  "descriptorSha256": "0a081f188ca51f6b12d07e9a80f05ab5a36f201e126e10f43bc297f956c01644",
   "dependencyLocks": {
     "package-lock.json": "3e536db25743ceb5a021559dbc1f31d57112211c62d94f84df34daca5382709c",
     "src/public/dotnet/ArcForges.Contracts.Foundation/packages.lock.json": "fa17fe6057706e36ae0b9370a457536d05d0f3a8f0f72df622881bfc1628337e",