@arcforges/api-client 1.0.0-ci.19.1 → 1.0.0-ci.201.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,373 @@
+// 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";
+
+// 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"]; }
+
+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"];
+  NativeContentRev expected_native = 6 [json_name = "expectedNative"];
+  optional uint64 recovery_generation = 7 [json_name = "recoveryGeneration"];
+  ApplicationScope application_scope = 8 [json_name = "applicationScope"];
+
+  reserved 5;
+  reserved "expected_local";
+}
+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"];
+  NativeContentRev native = 5 [json_name = "native"];
+
+  reserved 4;
+  reserved "local";
+}
+
+enum ResourceAvailability {
+  RESOURCE_AVAILABILITY_UNSPECIFIED = 0;
+  RESOURCE_AVAILABILITY_ALWAYS_KEEP = 1;
+  RESOURCE_AVAILABILITY_AVAILABLE_OFFLINE = 2;
+  RESOURCE_AVAILABILITY_ON_DEMAND = 3;
+  RESOURCE_AVAILABILITY_CLOUD_ONLY = 4;
+  RESOURCE_AVAILABILITY_MISSING_EXTERNAL = 5;
+}
+
+// registry04: ActorChain; complete selected WP03.01 projection.
+message ActorChain {
+  Id initiator = 1 [json_name = "initiator"];
+  Id owner = 2 [json_name = "owner"];
+  optional string actor_kind = 3 [json_name = "actorKind"];
+  Id delegation_id = 4 [json_name = "delegationId"];
+  Id device_id = 5 [json_name = "deviceId"];
+}
+
+// registry04: ArtifactRef; complete selected WP03.01 projection.
+message ArtifactRef {
+  Id artifact_id = 1 [json_name = "artifactId"];
+  optional string kind = 2 [json_name = "kind"];
+  AggregateRef owner = 3 [json_name = "owner"];
+  ResourceRef resource = 4 [json_name = "resource"];
+  Id job_id = 5 [json_name = "jobId"];
+  ContentOrigin origin = 6 [json_name = "origin"];
+  Id producing_task_id = 7 [json_name = "producingTaskId"];
+  Id producing_run_id = 8 [json_name = "producingRunId"];
+  ActorChain actor = 9 [json_name = "actor"];
+  Instant created_at = 10 [json_name = "createdAt"];
+  optional string availability = 11 [json_name = "availability"];
+  repeated VersionedRef provenance = 12 [json_name = "provenance"];
+}
+
+// registry04: BlobRef; complete selected WP03.01 projection.
+message BlobRef {
+  Id blob_id = 1 [json_name = "blobId"];
+  optional string content_hash = 2 [json_name = "contentHash"];
+  optional uint64 size_bytes = 3 [json_name = "sizeBytes"];
+}
+
+// registry04: ByteRange; complete selected WP03.01 projection.
+message ByteRange {
+  optional uint64 offset = 1 [json_name = "offset"];
+  optional uint64 length = 2 [json_name = "length"];
+}
+
+// registry04: ContentOrigin; complete selected WP03.01 projection.
+message ContentOrigin {
+  optional string profile = 1 [json_name = "profile"];
+  Id origin_id = 2 [json_name = "originId"];
+  Id content_unit_id = 3 [json_name = "contentUnitId"];
+  repeated string kinds = 4 [json_name = "kinds"];
+  optional string payload_sha256 = 5 [json_name = "payloadSha256"];
+  optional string producer_kind = 6 [json_name = "producerKind"];
+  Instant created_at = 7 [json_name = "createdAt"];
+  repeated Id parent_origin_ids = 8 [json_name = "parentOriginIds"];
+  optional uint32 omitted_parent_count = 9 [json_name = "omittedParentCount"];
+}
+
+// registry04: MediaRange; complete selected WP03.01 projection.
+message MediaRange {
+  MediaTime start = 1 [json_name = "start"];
+  MediaTime duration = 2 [json_name = "duration"];
+}
+
+// registry04: MediaTime; complete selected WP03.01 projection.
+message MediaTime {
+  optional sint64 ticks = 1 [json_name = "ticks"];
+  Rational rate = 2 [json_name = "rate"];
+}
+
+// registry04: PageRequest; complete selected WP03.01 projection.
+message PageRequest {
+  optional string cursor = 1 [json_name = "cursor"];
+  optional int32 limit = 2 [json_name = "limit"];
+}
+
+// registry04: PageState; complete selected WP03.01 projection.
+message PageState {
+  optional string next_cursor = 1 [json_name = "nextCursor"];
+  optional bool has_more = 2 [json_name = "hasMore"];
+}
+
+// registry04: Rational; complete selected WP03.01 projection.
+message Rational {
+  optional sint64 numerator = 1 [json_name = "numerator"];
+  optional uint64 denominator = 2 [json_name = "denominator"];
+}
+
+// registry04: ResourceRef; complete selected WP03.01 projection.
+message ResourceRef {
+  Id realm_id = 1 [json_name = "realmId"];
+  Id workspace_id = 2 [json_name = "workspaceId"];
+  optional string owner_app_id = 3 [json_name = "ownerAppId"];
+  optional string resource_kind = 4 [json_name = "resourceKind"];
+  Id resource_id = 5 [json_name = "resourceId"];
+  optional string display_hint = 6 [json_name = "displayHint"];
+  optional ResourceAvailability availability = 7 [json_name = "availability"];
+  Id holding_device_id = 8 [json_name = "holdingDeviceId"];
+}
+
+// registry04: ResourceVersionRef; complete selected WP03.01 projection.
+message ResourceVersionRef {
+  ResourceRef resource = 1 [json_name = "resource"];
+  optional string content_hash = 5 [json_name = "contentHash"];
+  BlobRef blob = 6 [json_name = "blob"];
+  oneof revision {
+    Revision cloud = 2 [json_name = "cloud"];
+    NativeContentRev native = 3 [json_name = "native"];
+  }
+
+  reserved 4;
+  reserved "local";
+}
+
+// registry04: TimeRangeUtc; complete selected WP03.01 projection.
+message TimeRangeUtc {
+  Instant from = 1 [json_name = "from"];
+  Instant until = 2 [json_name = "until"];
+}

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;
+}