@arcforges/proto 1.0.0-ci.86.1 → 1.0.0-ci.89.1

package/NOTICE

@@ -1,7 +1,7 @@
 ArcForges Contracts
 Copyright 2026 ArcForges contributors
 
-@arcforges/proto 1.0.0-ci.86.1 (Apache-2.0)
+@arcforges/proto 1.0.0-ci.89.1 (Apache-2.0)
 
 Resolved runtime dependency inventory (dependencies retain their own licences):
 - @bufbuild/protobuf 2.15.0: (Apache-2.0 AND BSD-3-Clause) (pkg:npm/%40bufbuild/protobuf@2.15.0)
@@ -12,8 +12,8 @@ ArcForges source provenance notices
 
 Generated from reviewed active records. Original licence files and dependency notices remain authoritative.
 
-contract-bindings-r2
-Source: https://github.com/ArcForges/Contracts @ 3edb8888b0648c32c5594b567e0157b158e9c915
+contract-bindings-r4
+Source: https://github.com/ArcForges/Contracts @ af7b6cca5e14a51735512d283b03d3ae9d96d170
 Material licence: Apache-2.0
 Notice scope: packages
 Copyright 2026 ArcForges contributors.
@@ -21,7 +21,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.
-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.
+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, domain identity adapters 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 remains retired.
 
 protobuf-generator-licence-r1
 Source: https://github.com/protocolbuffers/protobuf @ 35cd01f9fe9afbeea38cc7b979a3b6bfcde82c03

package/README.md

@@ -1,14 +1,23 @@
 # @arcforges/proto
 
-Generated public Protocol Buffers messages and service descriptors, shared by
-TypeScript Web consumers. This first prerelease contains only
-the `arcforges.hello.v1` packaging example. There are no Node or DOM imports in
-this package and it does not implement networking.
+Generated public Protocol Buffers messages, shape validators and exact value
+adapters, shared by TypeScript Web consumers. The selected public closure includes
+Foundation, Notes scalar/query, Scope measurement, all owner-body variants and
+events, alongside the retained `arcforges.hello.v1` packaging example. There are
+no Node or DOM imports in this package and it does not implement networking.
 
 Use `create(SayHelloRequestSchema, { name: "World" })`, `toBinary` and
 `fromBinary` from `@bufbuild/protobuf`. Use the exported `HelloService`
 descriptor with a compatible gRPC/gRPC-Web client transport.
 
+Use `parseId` and `idToWire` to preserve an explicit identifier domain, bigint for
+exact 64-bit values, and `notesDecimal`/`decimalParts` for Notes decimal boundaries.
+The generated `is<Type>` functions check the current supported mutation profile.
+`readProjection` and `preserveProjection` retain compatible unknown read data;
+revalidate the actual message before a mutation. These checks do not authorize
+access, query product state or execute numerical engines. See the
+[Foundation API and coverage profile](https://github.com/ArcForges/Contracts/blob/main/docs/wp03-01-foundation.md).
+
 The package ships ESM JavaScript, TypeScript declarations, the authored proto and
 its descriptor set. Pin the exact version in your dependency manifest and lock
 file. Android uses separately generated Kotlin artifacts from the same authored

package/build-identity.json

@@ -3,17 +3,17 @@
   "owner": "Contracts",
   "artifact": {
     "id": "@arcforges/proto",
-    "version": "1.0.0-ci.86.1"
+    "version": "1.0.0-ci.89.1"
   },
   "build": {
-    "sourceCommit": "30ddcad2bcb3634e089abb5e29d6c9ce05d38386",
+    "sourceCommit": "4b8134eaf8a4174922d6378da003ed390b85a94a",
     "dirty": false,
     "kind": "ci",
-    "buildId": "35716069370.1",
-    "runId": "35716069370",
+    "buildId": "35730204418.1",
+    "runId": "35730204418",
     "runAttempt": 1,
-    "pipelineRun": "https://github.com/ArcForges/Contracts/actions/runs/35716069370",
-    "sourceDateEpoch": 1790072840
+    "pipelineRun": "https://github.com/ArcForges/Contracts/actions/runs/35730204418",
+    "sourceDateEpoch": 1790081756
   },
   "axes": {
     "AppVersion": {
@@ -30,16 +30,16 @@
             "path": "public/proto/arcforges/events/v1/events.proto",
             "sha256": "ea0ac740c06bbb5b81724b4a7e601110424cabc4940b07e579cf97d852880f43"
           },
-          "descriptorSha256": "1d9e586eee777509104447b60295d2af63a588f2885555763e8fc598e7d8d3c5"
+          "descriptorSha256": "f735938a31ead03abb331db2dd04dd12ace5335b6793e47feaeb4c5623386aba"
         },
         {
           "subject": "arcforges.foundation",
           "version": "1",
           "source": {
             "path": "public/proto/arcforges/foundation/v1/foundation.proto",
-            "sha256": "9445c5229ff92c2376fb8bfb49ca98b4503441636544795b9853fba3cd25bdb6"
+            "sha256": "ceda869bf2998ca4bc21c4b7504c365a4662e7f28183e6db81660592d5bcdb3f"
           },
-          "descriptorSha256": "1d9e586eee777509104447b60295d2af63a588f2885555763e8fc598e7d8d3c5"
+          "descriptorSha256": "f735938a31ead03abb331db2dd04dd12ace5335b6793e47feaeb4c5623386aba"
         },
         {
           "subject": "arcforges.hello",
@@ -48,7 +48,16 @@
             "path": "public/proto/arcforges/hello/v1/hello.proto",
             "sha256": "92489f89d1898a3d3bbea56c72116416cd0152ae8866c98745739437020c67d9"
           },
-          "descriptorSha256": "1d9e586eee777509104447b60295d2af63a588f2885555763e8fc598e7d8d3c5"
+          "descriptorSha256": "f735938a31ead03abb331db2dd04dd12ace5335b6793e47feaeb4c5623386aba"
+        },
+        {
+          "subject": "arcforges.publicapi",
+          "version": "1",
+          "source": {
+            "path": "public/proto/arcforges/publicapi/v1/content.proto",
+            "sha256": "a352f31e0bcee5e5523e59cb6bcfe2af04423e78389c67fc0d8d0ab52f104dee"
+          },
+          "descriptorSha256": "f735938a31ead03abb331db2dd04dd12ace5335b6793e47feaeb4c5623386aba"
         }
       ]
     },

package/dist/gen/arcforges/foundation/v1/foundation_pb.d.ts

@@ -451,6 +451,403 @@ export type StateFailure = Message<"arcforges.foundation.v1.StateFailure"> & {
  * Use `create(StateFailureSchema)` to create a new message.
  */
 export declare const StateFailureSchema: GenMessage<StateFailure>;
+/**
+ * registry04: ActorChain; complete selected WP03.01 projection.
+ *
+ * @generated from message arcforges.foundation.v1.ActorChain
+ */
+export type ActorChain = Message<"arcforges.foundation.v1.ActorChain"> & {
+    /**
+     * @generated from field: arcforges.foundation.v1.Id initiator = 1;
+     */
+    initiator?: Id | undefined;
+    /**
+     * @generated from field: arcforges.foundation.v1.Id owner = 2;
+     */
+    owner?: Id | undefined;
+    /**
+     * @generated from field: optional string actor_kind = 3;
+     */
+    actorKind?: string | undefined;
+    /**
+     * @generated from field: arcforges.foundation.v1.Id delegation_id = 4;
+     */
+    delegationId?: Id | undefined;
+    /**
+     * @generated from field: arcforges.foundation.v1.Id device_id = 5;
+     */
+    deviceId?: Id | undefined;
+};
+/**
+ * Describes the message arcforges.foundation.v1.ActorChain.
+ * Use `create(ActorChainSchema)` to create a new message.
+ */
+export declare const ActorChainSchema: GenMessage<ActorChain>;
+/**
+ * registry04: ArtifactRef; complete selected WP03.01 projection.
+ *
+ * @generated from message arcforges.foundation.v1.ArtifactRef
+ */
+export type ArtifactRef = Message<"arcforges.foundation.v1.ArtifactRef"> & {
+    /**
+     * @generated from field: arcforges.foundation.v1.Id artifact_id = 1;
+     */
+    artifactId?: Id | undefined;
+    /**
+     * @generated from field: optional string kind = 2;
+     */
+    kind?: string | undefined;
+    /**
+     * @generated from field: arcforges.foundation.v1.AggregateRef owner = 3;
+     */
+    owner?: AggregateRef | undefined;
+    /**
+     * @generated from field: arcforges.foundation.v1.ResourceRef resource = 4;
+     */
+    resource?: ResourceRef | undefined;
+    /**
+     * @generated from field: arcforges.foundation.v1.Id job_id = 5;
+     */
+    jobId?: Id | undefined;
+    /**
+     * @generated from field: arcforges.foundation.v1.ContentOrigin origin = 6;
+     */
+    origin?: ContentOrigin | undefined;
+    /**
+     * @generated from field: arcforges.foundation.v1.Id producing_task_id = 7;
+     */
+    producingTaskId?: Id | undefined;
+    /**
+     * @generated from field: arcforges.foundation.v1.Id producing_run_id = 8;
+     */
+    producingRunId?: Id | undefined;
+    /**
+     * @generated from field: arcforges.foundation.v1.ActorChain actor = 9;
+     */
+    actor?: ActorChain | undefined;
+    /**
+     * @generated from field: arcforges.foundation.v1.Instant created_at = 10;
+     */
+    createdAt?: Instant | undefined;
+    /**
+     * @generated from field: optional string availability = 11;
+     */
+    availability?: string | undefined;
+    /**
+     * @generated from field: repeated arcforges.foundation.v1.VersionedRef provenance = 12;
+     */
+    provenance: VersionedRef[];
+};
+/**
+ * Describes the message arcforges.foundation.v1.ArtifactRef.
+ * Use `create(ArtifactRefSchema)` to create a new message.
+ */
+export declare const ArtifactRefSchema: GenMessage<ArtifactRef>;
+/**
+ * registry04: BlobRef; complete selected WP03.01 projection.
+ *
+ * @generated from message arcforges.foundation.v1.BlobRef
+ */
+export type BlobRef = Message<"arcforges.foundation.v1.BlobRef"> & {
+    /**
+     * @generated from field: arcforges.foundation.v1.Id blob_id = 1;
+     */
+    blobId?: Id | undefined;
+    /**
+     * @generated from field: optional string content_hash = 2;
+     */
+    contentHash?: string | undefined;
+    /**
+     * @generated from field: optional uint64 size_bytes = 3;
+     */
+    sizeBytes?: bigint | undefined;
+};
+/**
+ * Describes the message arcforges.foundation.v1.BlobRef.
+ * Use `create(BlobRefSchema)` to create a new message.
+ */
+export declare const BlobRefSchema: GenMessage<BlobRef>;
+/**
+ * registry04: ByteRange; complete selected WP03.01 projection.
+ *
+ * @generated from message arcforges.foundation.v1.ByteRange
+ */
+export type ByteRange = Message<"arcforges.foundation.v1.ByteRange"> & {
+    /**
+     * @generated from field: optional uint64 offset = 1;
+     */
+    offset?: bigint | undefined;
+    /**
+     * @generated from field: optional uint64 length = 2;
+     */
+    length?: bigint | undefined;
+};
+/**
+ * Describes the message arcforges.foundation.v1.ByteRange.
+ * Use `create(ByteRangeSchema)` to create a new message.
+ */
+export declare const ByteRangeSchema: GenMessage<ByteRange>;
+/**
+ * registry04: ContentOrigin; complete selected WP03.01 projection.
+ *
+ * @generated from message arcforges.foundation.v1.ContentOrigin
+ */
+export type ContentOrigin = Message<"arcforges.foundation.v1.ContentOrigin"> & {
+    /**
+     * @generated from field: optional string profile = 1;
+     */
+    profile?: string | undefined;
+    /**
+     * @generated from field: arcforges.foundation.v1.Id origin_id = 2;
+     */
+    originId?: Id | undefined;
+    /**
+     * @generated from field: arcforges.foundation.v1.Id content_unit_id = 3;
+     */
+    contentUnitId?: Id | undefined;
+    /**
+     * @generated from field: repeated string kinds = 4;
+     */
+    kinds: string[];
+    /**
+     * @generated from field: optional string payload_sha256 = 5;
+     */
+    payloadSha256?: string | undefined;
+    /**
+     * @generated from field: optional string producer_kind = 6;
+     */
+    producerKind?: string | undefined;
+    /**
+     * @generated from field: arcforges.foundation.v1.Instant created_at = 7;
+     */
+    createdAt?: Instant | undefined;
+    /**
+     * @generated from field: repeated arcforges.foundation.v1.Id parent_origin_ids = 8;
+     */
+    parentOriginIds: Id[];
+    /**
+     * @generated from field: optional uint32 omitted_parent_count = 9;
+     */
+    omittedParentCount?: number | undefined;
+};
+/**
+ * Describes the message arcforges.foundation.v1.ContentOrigin.
+ * Use `create(ContentOriginSchema)` to create a new message.
+ */
+export declare const ContentOriginSchema: GenMessage<ContentOrigin>;
+/**
+ * registry04: MediaRange; complete selected WP03.01 projection.
+ *
+ * @generated from message arcforges.foundation.v1.MediaRange
+ */
+export type MediaRange = Message<"arcforges.foundation.v1.MediaRange"> & {
+    /**
+     * @generated from field: arcforges.foundation.v1.MediaTime start = 1;
+     */
+    start?: MediaTime | undefined;
+    /**
+     * @generated from field: arcforges.foundation.v1.MediaTime duration = 2;
+     */
+    duration?: MediaTime | undefined;
+};
+/**
+ * Describes the message arcforges.foundation.v1.MediaRange.
+ * Use `create(MediaRangeSchema)` to create a new message.
+ */
+export declare const MediaRangeSchema: GenMessage<MediaRange>;
+/**
+ * registry04: MediaTime; complete selected WP03.01 projection.
+ *
+ * @generated from message arcforges.foundation.v1.MediaTime
+ */
+export type MediaTime = Message<"arcforges.foundation.v1.MediaTime"> & {
+    /**
+     * @generated from field: optional sint64 ticks = 1;
+     */
+    ticks?: bigint | undefined;
+    /**
+     * @generated from field: arcforges.foundation.v1.Rational rate = 2;
+     */
+    rate?: Rational | undefined;
+};
+/**
+ * Describes the message arcforges.foundation.v1.MediaTime.
+ * Use `create(MediaTimeSchema)` to create a new message.
+ */
+export declare const MediaTimeSchema: GenMessage<MediaTime>;
+/**
+ * registry04: PageRequest; complete selected WP03.01 projection.
+ *
+ * @generated from message arcforges.foundation.v1.PageRequest
+ */
+export type PageRequest = Message<"arcforges.foundation.v1.PageRequest"> & {
+    /**
+     * @generated from field: optional string cursor = 1;
+     */
+    cursor?: string | undefined;
+    /**
+     * @generated from field: optional int32 limit = 2;
+     */
+    limit?: number | undefined;
+};
+/**
+ * Describes the message arcforges.foundation.v1.PageRequest.
+ * Use `create(PageRequestSchema)` to create a new message.
+ */
+export declare const PageRequestSchema: GenMessage<PageRequest>;
+/**
+ * registry04: PageState; complete selected WP03.01 projection.
+ *
+ * @generated from message arcforges.foundation.v1.PageState
+ */
+export type PageState = Message<"arcforges.foundation.v1.PageState"> & {
+    /**
+     * @generated from field: optional string next_cursor = 1;
+     */
+    nextCursor?: string | undefined;
+    /**
+     * @generated from field: optional bool has_more = 2;
+     */
+    hasMore?: boolean | undefined;
+};
+/**
+ * Describes the message arcforges.foundation.v1.PageState.
+ * Use `create(PageStateSchema)` to create a new message.
+ */
+export declare const PageStateSchema: GenMessage<PageState>;
+/**
+ * registry04: Rational; complete selected WP03.01 projection.
+ *
+ * @generated from message arcforges.foundation.v1.Rational
+ */
+export type Rational = Message<"arcforges.foundation.v1.Rational"> & {
+    /**
+     * @generated from field: optional sint64 numerator = 1;
+     */
+    numerator?: bigint | undefined;
+    /**
+     * @generated from field: optional uint64 denominator = 2;
+     */
+    denominator?: bigint | undefined;
+};
+/**
+ * Describes the message arcforges.foundation.v1.Rational.
+ * Use `create(RationalSchema)` to create a new message.
+ */
+export declare const RationalSchema: GenMessage<Rational>;
+/**
+ * registry04: ResourceRef; complete selected WP03.01 projection.
+ *
+ * @generated from message arcforges.foundation.v1.ResourceRef
+ */
+export type ResourceRef = Message<"arcforges.foundation.v1.ResourceRef"> & {
+    /**
+     * @generated from field: arcforges.foundation.v1.Id realm_id = 1;
+     */
+    realmId?: Id | undefined;
+    /**
+     * @generated from field: arcforges.foundation.v1.Id workspace_id = 2;
+     */
+    workspaceId?: Id | undefined;
+    /**
+     * @generated from field: optional string owner_app_id = 3;
+     */
+    ownerAppId?: string | undefined;
+    /**
+     * @generated from field: optional string resource_kind = 4;
+     */
+    resourceKind?: string | undefined;
+    /**
+     * @generated from field: arcforges.foundation.v1.Id resource_id = 5;
+     */
+    resourceId?: Id | undefined;
+    /**
+     * @generated from field: optional string display_hint = 6;
+     */
+    displayHint?: string | undefined;
+    /**
+     * @generated from field: optional arcforges.foundation.v1.ResourceAvailability availability = 7;
+     */
+    availability?: ResourceAvailability | undefined;
+    /**
+     * @generated from field: arcforges.foundation.v1.Id holding_device_id = 8;
+     */
+    holdingDeviceId?: Id | undefined;
+};
+/**
+ * Describes the message arcforges.foundation.v1.ResourceRef.
+ * Use `create(ResourceRefSchema)` to create a new message.
+ */
+export declare const ResourceRefSchema: GenMessage<ResourceRef>;
+/**
+ * registry04: ResourceVersionRef; complete selected WP03.01 projection.
+ *
+ * @generated from message arcforges.foundation.v1.ResourceVersionRef
+ */
+export type ResourceVersionRef = Message<"arcforges.foundation.v1.ResourceVersionRef"> & {
+    /**
+     * @generated from field: arcforges.foundation.v1.ResourceRef resource = 1;
+     */
+    resource?: ResourceRef | undefined;
+    /**
+     * @generated from field: optional string content_hash = 5;
+     */
+    contentHash?: string | undefined;
+    /**
+     * @generated from field: arcforges.foundation.v1.BlobRef blob = 6;
+     */
+    blob?: BlobRef | undefined;
+    /**
+     * @generated from oneof arcforges.foundation.v1.ResourceVersionRef.revision
+     */
+    revision: {
+        /**
+         * @generated from field: arcforges.foundation.v1.Revision cloud = 2;
+         */
+        value: Revision;
+        case: "cloud";
+    } | {
+        /**
+         * @generated from field: arcforges.foundation.v1.NativeContentRev native = 3;
+         */
+        value: NativeContentRev;
+        case: "native";
+    } | {
+        /**
+         * @generated from field: arcforges.foundation.v1.LocalNotesVersion local = 4;
+         */
+        value: LocalNotesVersion;
+        case: "local";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message arcforges.foundation.v1.ResourceVersionRef.
+ * Use `create(ResourceVersionRefSchema)` to create a new message.
+ */
+export declare const ResourceVersionRefSchema: GenMessage<ResourceVersionRef>;
+/**
+ * registry04: TimeRangeUtc; complete selected WP03.01 projection.
+ *
+ * @generated from message arcforges.foundation.v1.TimeRangeUtc
+ */
+export type TimeRangeUtc = Message<"arcforges.foundation.v1.TimeRangeUtc"> & {
+    /**
+     * @generated from field: arcforges.foundation.v1.Instant from = 1;
+     */
+    from?: Instant | undefined;
+    /**
+     * @generated from field: arcforges.foundation.v1.Instant until = 2;
+     */
+    until?: Instant | undefined;
+};
+/**
+ * Describes the message arcforges.foundation.v1.TimeRangeUtc.
+ * Use `create(TimeRangeUtcSchema)` to create a new message.
+ */
+export declare const TimeRangeUtcSchema: GenMessage<TimeRangeUtc>;
 /**
  * @generated from enum arcforges.foundation.v1.EffectCertainty
  */
@@ -554,3 +951,36 @@ export declare enum ErrorCategory {
  * Describes the enum arcforges.foundation.v1.ErrorCategory.
  */
 export declare const ErrorCategorySchema: GenEnum<ErrorCategory>;
+/**
+ * @generated from enum arcforges.foundation.v1.ResourceAvailability
+ */
+export declare enum ResourceAvailability {
+    /**
+     * @generated from enum value: RESOURCE_AVAILABILITY_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: RESOURCE_AVAILABILITY_ALWAYS_KEEP = 1;
+     */
+    ALWAYS_KEEP = 1,
+    /**
+     * @generated from enum value: RESOURCE_AVAILABILITY_AVAILABLE_OFFLINE = 2;
+     */
+    AVAILABLE_OFFLINE = 2,
+    /**
+     * @generated from enum value: RESOURCE_AVAILABILITY_ON_DEMAND = 3;
+     */
+    ON_DEMAND = 3,
+    /**
+     * @generated from enum value: RESOURCE_AVAILABILITY_CLOUD_ONLY = 4;
+     */
+    CLOUD_ONLY = 4,
+    /**
+     * @generated from enum value: RESOURCE_AVAILABILITY_MISSING_EXTERNAL = 5;
+     */
+    MISSING_EXTERNAL = 5
+}
+/**
+ * Describes the enum arcforges.foundation.v1.ResourceAvailability.
+ */
+export declare const ResourceAvailabilitySchema: GenEnum<ResourceAvailability>;