@spine-event-engine/proto 2.0.0-snapshot.24 → 2.0.0-snapshot.26

package/proto/spine/client/subscription_record.proto

@@ -15,41 +15,61 @@ syntax = "proto3";
 
 package spine.client;
 
+import "google/protobuf/empty.proto";
 import "google/protobuf/timestamp.proto";
 import "spine/client/subscription.proto";
 import "spine/options.proto";
 
-option (type_url_prefix) = "type.spine.io";
 option java_multiple_files = true;
+option (type_url_prefix) = "type.spine.io";
 
 // A lifecycle status of a stored subscription.
 enum SubscriptionStatus {
+  // An unspecified status.
+  SS_UNSPECIFIED = 0;
 
-    // An unspecified status.
-    SS_UNSPECIFIED = 0;
+  // A subscription that is waiting for activation.
+  PENDING = 1;
+
+  // A subscription that delivers matching updates.
+  ACTIVE = 2;
+}
 
-    // A subscription that is waiting for activation.
-    PENDING = 1;
+// Stable verified reader identity retained with a subscription definition.
+message SubscriptionReaderBinding {
+  // Exactly one admitted reader identity; absence cannot establish reader access.
+  oneof identity {
+    // Application-authenticated principal ID, never ActorContext or provider credentials.
+    string principal_id = 1;
 
-    // A subscription that delivers matching updates.
-    ACTIVE = 2;
+    // Explicit admission without a principal or provider authority facts.
+    google.protobuf.Empty anonymous = 2;
+  }
 }
 
 // A stored definition of one subscription.
 message SubscriptionRecord {
+  // The identifier used to store this record.
+  SubscriptionId id = 1 [
+    (required) = true,
+    (validate) = true
+  ];
 
-    // The identifier used to store this record.
-    SubscriptionId id = 1 [(required) = true, (validate) = true];
+  // The subscription represented by this record.
+  Subscription subscription = 2 [
+    (required) = true,
+    (validate) = true
+  ];
 
-    // The subscription represented by this record.
-    Subscription subscription = 2 [(required) = true, (validate) = true];
+  // The current lifecycle status.
+  SubscriptionStatus status = 3 [(required) = true];
 
-    // The current lifecycle status.
-    SubscriptionStatus status = 3 [(required) = true];
+  // The time when the subscription was created.
+  google.protobuf.Timestamp when_created = 4 [(required) = true];
 
-    // The time when the subscription was created.
-    google.protobuf.Timestamp when_created = 4 [(required) = true];
+  // The deadline for activating a pending subscription.
+  google.protobuf.Timestamp when_activation_expires = 5;
 
-    // The deadline for activating a pending subscription.
-    google.protobuf.Timestamp when_activation_expires = 5;
+  // Stable reader identity admitted when this definition was created.
+  SubscriptionReaderBinding reader = 6;
 }

package/proto/spine/server/agent/acceptance_receipt.proto

@@ -0,0 +1,57 @@
+/*
+ * Copyright 2026, CodeMatters. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+
+syntax = "proto3";
+
+package spine.server.agent;
+
+import "google/protobuf/any.proto";
+import "spine/core/command.proto";
+import "spine/core/event.proto";
+import "spine/options.proto";
+
+option (SPI_all) = true;
+option (type_url_prefix) = "type.spine.io";
+
+// Complete identity evidence for one Agent delivery within its provider tenant boundary.
+// Its physical record slot is derived separately from these fields.
+message AgentAcceptanceKey {
+  // Generated Agent state type.
+  string state_type = 1 [(required) = true];
+
+  // Original typed recipient, including its exact Any type URL.
+  google.protobuf.Any recipient_id = 2 [(required) = true];
+
+  oneof source {
+    option (choice).required = true;
+
+    // Original Command identity.
+    spine.core.CommandId command = 3 [(validate) = true];
+
+    // Original Event identity.
+    spine.core.EventId event = 4 [(validate) = true];
+  }
+
+  // Original delivery route, such as HANDLE_COMMAND or REACT_UPON_EVENT.
+  string action = 5 [(required) = true];
+}
+
+// Immutable evidence that the Agent delivery was accepted once.
+message AgentAcceptanceReceipt {
+  // Complete identity evidence within the physical tenant boundary.
+  AgentAcceptanceKey key = 1 [
+    (required) = true,
+    (validate) = true
+  ];
+}

package/proto/spine/server/agent/model_preferences_record.proto

@@ -0,0 +1,48 @@
+/*
+ * Copyright 2026, CodeMatters. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+
+syntax = "proto3";
+
+package spine.server.agent;
+
+import "google/protobuf/any.proto";
+import "spine/options.proto";
+import "spine/ts/agent/model.proto";
+
+option (SPI_all) = true;
+option (type_url_prefix) = "type.spine.io";
+
+// Complete Agent instance identity for retained model selections.
+message AgentModelPreferencesKey {
+  // Generated Agent state type name.
+  string state_type = 1 [(required) = true];
+
+  // Exact typed Agent identifier including its original type URL and bytes.
+  google.protobuf.Any recipient_id = 2 [
+    (required) = true,
+    (validate) = true
+  ];
+}
+
+// Current model selections without an executable Agent invocation.
+message AgentModelPreferencesRecord {
+  // Complete identity evidence for the provider's bounded record slot.
+  AgentModelPreferencesKey key = 1 [
+    (required) = true,
+    (validate) = true
+  ];
+
+  // Complete per-instance model selections; an empty list is valid.
+  repeated spine.ts.agent.ModelPreference preferences = 2 [(validate) = true];
+}

package/proto/spine/ts/agent/content.proto

@@ -350,7 +350,7 @@ message DecisionResponse {
 
 // Actual authorized external tool request.
 message ToolRequest {
-  // Logical call identity preserved across recovery.
+  // Logical call identity within the running Agent invocation.
   AiToolCallId call = 1 [
     (required) = true,
     (validate) = true

package/proto/spine/ts/agent/interaction_events.proto

@@ -168,7 +168,7 @@ message AgentModelAttemptFinished {
   AiFailureCode failure = 8;
 }
 
-// Typed result passed local validation and was saved for recovery.
+// Typed result passed local validation during a live Agent invocation.
 message AgentAiResultAdmitted {
   // Logical operation producing the result.
   AgentOperationRef operation = 1 [

package/proto/spine/ts/agent/model.proto

@@ -112,7 +112,7 @@ message AiContentDigest {
   ];
 }
 
-// Identifies one logical tool call and its recovery record.
+// Identifies one logical tool call in a running Agent invocation.
 message AiToolCallId {
   // Spine-assigned ID, distinct from an MCP request ID.
   string value = 1 [(required) = true];

package/proto/spine-sources.json

@@ -54,7 +54,11 @@
       "upstreamPath": "client/src/main/proto/spine/client/filters.proto",
       "sourceUrl": "https://github.com/SpineEventEngine/core-java/blob/a408b0d70dafd603efc55b89c8b4b6f3e8c19d3b/client/src/main/proto/spine/client/filters.proto",
       "rawUrl": "https://raw.githubusercontent.com/SpineEventEngine/core-java/a408b0d70dafd603efc55b89c8b4b6f3e8c19d3b/client/src/main/proto/spine/client/filters.proto",
-      "sha256": "e2b4eef3d4e873cb5f0bc80896c19e538442182cddb54fa796d0ec640dcca6a5"
+      "sha256": "e2b4eef3d4e873cb5f0bc80896c19e538442182cddb54fa796d0ec640dcca6a5",
+      "localAdaptation": {
+        "kind": "target-filters-require",
+        "sha256": "6655d6d56b5e42d4e38bd630970aa2b43e52a1589dbbaed1c0d6ea4304adcc9e"
+      }
     },
     {
       "localPath": "packages/proto/proto/spine/client/query_service.proto",
@@ -63,7 +67,11 @@
       "upstreamPath": "client/src/main/proto/spine/client/query_service.proto",
       "sourceUrl": "https://github.com/SpineEventEngine/core-java/blob/a408b0d70dafd603efc55b89c8b4b6f3e8c19d3b/client/src/main/proto/spine/client/query_service.proto",
       "rawUrl": "https://raw.githubusercontent.com/SpineEventEngine/core-java/a408b0d70dafd603efc55b89c8b4b6f3e8c19d3b/client/src/main/proto/spine/client/query_service.proto",
-      "sha256": "8ad31ac9e18d17c38ed3419f80210f60e7d1b4b1bfc94f0949ba993e19934f41"
+      "sha256": "8ad31ac9e18d17c38ed3419f80210f60e7d1b4b1bfc94f0949ba993e19934f41",
+      "localAdaptation": {
+        "kind": "query-service-execute",
+        "sha256": "af2ad517cb1db9b415390e56573d553a040f3ce62a0fe12c13f535d363ad8636"
+      }
     },
     {
       "localPath": "packages/proto/proto/spine/client/query.proto",
@@ -418,9 +426,17 @@
     }
   ],
   "ownedSources": [
+    {
+      "localPath": "packages/proto/proto/spine/client/app_query.proto",
+      "sha256": "b5b334232dc724f7de606e6655aefde7856a8be1e9742311aa3c23a3ae206140"
+    },
+    {
+      "localPath": "packages/proto/proto/spine/server/agent/acceptance_receipt.proto",
+      "sha256": "daa0f8e724849523cb539b9b6a7503aa8eab0de3f23d926d1aa9d117bd44f007"
+    },
     {
       "localPath": "packages/proto/proto/spine/auth/authenticated_subscription.proto",
-      "sha256": "b6436714f754e6d7c1a6bbd177c5a4f0b606d3c7c1adc4b86fa3c299210ffc76"
+      "sha256": "da3f4c1ff9a0b968bfed0193c8b43deb0bfd71d126b375ab8832532625d15553"
     },
     {
       "localPath": "packages/proto/proto/spine/auth/authentication_service.proto",
@@ -428,23 +444,23 @@
     },
     {
       "localPath": "packages/proto/proto/spine/client/subscription_record.proto",
-      "sha256": "4e760681afba8d531b00ae08f09e52fb298c969e24aeb830fc72d7292afedaf5"
+      "sha256": "614caf2608bf3fc36a419f887305ae6b7b1cfad657800b5bc3a5d886d396bd86"
     },
     {
       "localPath": "packages/proto/proto/spine/deployment/node_discovery.proto",
       "sha256": "7c300d215a1757c17b7bd1a89cebb4825df28a58fcc119f2aa6d5535d7520073"
     },
-    {
-      "localPath": "packages/proto/proto/spine/server/agent/execution_record.proto",
-      "sha256": "98f6b2eef372433da63cdd343aa6bf7163171857396d816a1ffae248d10b85b0"
-    },
     {
       "localPath": "packages/proto/proto/spine/server/agent/history_record.proto",
       "sha256": "24ed282bc0cd901a3b38748ea7b516e972a87b2a7f69db99a2b094458d48e38a"
     },
+    {
+      "localPath": "packages/proto/proto/spine/server/agent/model_preferences_record.proto",
+      "sha256": "33b7f805be70c5435b6d2f7ef558e0fab5dfed34a699ce87734f3c9b2b6f00d5"
+    },
     {
       "localPath": "packages/proto/proto/spine/ts/agent/content.proto",
-      "sha256": "d119c8a71c39dcdd4af8de1dd1c1ceeb22eab08fb02a704d8ee15bae5949f4fe"
+      "sha256": "f4242677c02f546724dbffe9dabb93bdf8d5a63f8d3357e91fab3765e41e058a"
     },
     {
       "localPath": "packages/proto/proto/spine/ts/agent/history.proto",
@@ -452,11 +468,11 @@
     },
     {
       "localPath": "packages/proto/proto/spine/ts/agent/interaction_events.proto",
-      "sha256": "e975e3fae68ff9ee59fb967ac3ae87bc0709e483b139b6d2d31276f5a3bebb8f"
+      "sha256": "26e959ccfa9c9c662087cfab7a01c3f2a28c3f027704601e7a50eb83d28ab401"
     },
     {
       "localPath": "packages/proto/proto/spine/ts/agent/model.proto",
-      "sha256": "f3fc4fe4e244a9d9a397d2a62bc1246bf1bf038c93f07be633d480eb4e44ff9c"
+      "sha256": "d69d290932e43d6932d70041b996cca1efd897e0e418c58462727de9c3ba97f7"
     }
   ]
 }

package/spine-proto-manifest.json

@@ -1,13 +1,14 @@
 {
   "formatVersion": 2,
   "packageName": "@spine-event-engine/proto",
-  "packageVersion": "2.0.0-snapshot.24",
+  "packageVersion": "2.0.0-snapshot.26",
   "protoFiles": [
     "grpc/health/v1/health.proto",
     "spine/auth/authenticated_subscription.proto",
     "spine/auth/authentication_service.proto",
     "spine/base/error.proto",
     "spine/base/field_path.proto",
+    "spine/client/app_query.proto",
     "spine/client/command_service.proto",
     "spine/client/entities.proto",
     "spine/client/filters.proto",
@@ -37,8 +38,9 @@
     "spine/net/email_address.proto",
     "spine/net/internet_domain.proto",
     "spine/options.proto",
-    "spine/server/agent/execution_record.proto",
+    "spine/server/agent/acceptance_receipt.proto",
     "spine/server/agent/history_record.proto",
+    "spine/server/agent/model_preferences_record.proto",
     "spine/server/catchup/catch_up.proto",
     "spine/server/delivery/delivery.proto",
     "spine/server/delivery/delivery_events.proto",
@@ -66,6 +68,7 @@
     "spine/auth/authentication_service.proto": "generated/spine/auth/authentication_service_pb.js",
     "spine/base/error.proto": "generated/spine/base/error_pb.js",
     "spine/base/field_path.proto": "generated/spine/base/field_path_pb.js",
+    "spine/client/app_query.proto": "generated/spine/client/app_query_pb.js",
     "spine/client/command_service.proto": "generated/spine/client/command_service_pb.js",
     "spine/client/entities.proto": "generated/spine/client/entities_pb.js",
     "spine/client/filters.proto": "generated/spine/client/filters_pb.js",
@@ -95,8 +98,9 @@
     "spine/net/email_address.proto": "generated/spine/net/email_address_pb.js",
     "spine/net/internet_domain.proto": "generated/spine/net/internet_domain_pb.js",
     "spine/options.proto": "generated/spine/options_pb.js",
-    "spine/server/agent/execution_record.proto": "generated/spine/server/agent/execution_record_pb.js",
+    "spine/server/agent/acceptance_receipt.proto": "generated/spine/server/agent/acceptance_receipt_pb.js",
     "spine/server/agent/history_record.proto": "generated/spine/server/agent/history_record_pb.js",
+    "spine/server/agent/model_preferences_record.proto": "generated/spine/server/agent/model_preferences_record_pb.js",
     "spine/server/catchup/catch_up.proto": "generated/spine/server/catchup/catch_up_pb.js",
     "spine/server/delivery/delivery.proto": "generated/spine/server/delivery/delivery_pb.js",
     "spine/server/delivery/delivery_events.proto": "generated/spine/server/delivery/delivery_events_pb.js",
@@ -120,5 +124,5 @@
   },
   "dependencies": [],
   "moduleExport": "spineProtoModule",
-  "generationId": "04e547728738b01a4313b4136d2a1ad5dea416c594b47742392201142bc9aa72"
+  "generationId": "bd8cdb457b84a777fe525af300d80944f312fa9b37406bfe5c2501ccb2606076"
 }