@spine-event-engine/proto 2.0.0-snapshot.23 → 2.0.0-snapshot.25

package/generated/spine/ts/agent/content_pb.ts

@@ -921,7 +921,7 @@ export const DecisionResponseSchema: GenMessage<DecisionResponse> = /*@__PURE__*
  */
 export type ToolRequest = Message<"spine.ts.agent.ToolRequest"> & {
   /**
-   * Logical call identity preserved across recovery.
+   * Logical call identity within the running Agent invocation.
    *
    * @generated from field: spine.ts.agent.AiToolCallId call = 1;
    */

package/generated/spine/ts/agent/interaction_events_pb.ts

@@ -283,7 +283,7 @@ export const AgentModelAttemptFinishedSchema: GenMessage<AgentModelAttemptFinish
   messageDesc(file_spine_ts_agent_interaction_events, 3);
 
 /**
- * Typed result passed local validation and was saved for recovery.
+ * Typed result passed local validation during a live Agent invocation.
  *
  * @generated from message spine.ts.agent.AgentAiResultAdmitted
  * Generated from Proto: spine/ts/agent/interaction_events.proto.

package/generated/spine/ts/agent/model_pb.ts

@@ -238,7 +238,7 @@ export const AiContentDigestSchema: GenMessage<AiContentDigest> = /*@__PURE__*/
   messageDesc(file_spine_ts_agent_model, 7);
 
 /**
- * Identifies one logical tool call and its recovery record.
+ * Identifies one logical tool call in a running Agent invocation.
  *
  * @generated from message spine.ts.agent.AiToolCallId
  * Generated from Proto: spine/ts/agent/model.proto.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spine-event-engine/proto",
-  "version": "2.0.0-snapshot.23",
+  "version": "2.0.0-snapshot.25",
   "license": "Apache-2.0",
   "type": "module",
   "repository": {
@@ -42,6 +42,10 @@
       "types": "./dist/src/agent/index.d.ts",
       "default": "./dist/src/agent/index.js"
     },
+    "./codegen": {
+      "types": "./dist/src/codegen/index.d.ts",
+      "default": "./dist/src/codegen/index.js"
+    },
     "./spine-proto-manifest.json": "./spine-proto-manifest.json",
     "./proto/*": "./proto/*",
     "./generated/*.js": {

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

@@ -418,6 +418,10 @@
     }
   ],
   "ownedSources": [
+    {
+      "localPath": "packages/proto/proto/spine/server/agent/acceptance_receipt.proto",
+      "sha256": "daa0f8e724849523cb539b9b6a7503aa8eab0de3f23d926d1aa9d117bd44f007"
+    },
     {
       "localPath": "packages/proto/proto/spine/auth/authenticated_subscription.proto",
       "sha256": "b6436714f754e6d7c1a6bbd177c5a4f0b606d3c7c1adc4b86fa3c299210ffc76"
@@ -434,17 +438,17 @@
       "localPath": "packages/proto/proto/spine/deployment/node_discovery.proto",
       "sha256": "7c300d215a1757c17b7bd1a89cebb4825df28a58fcc119f2aa6d5535d7520073"
     },
-    {
-      "localPath": "packages/proto/proto/spine/server/agent/execution_record.proto",
-      "sha256": "059ddc8d09b006f3854f7ed877bcab26141ab1228d3de0ad8871c8c243b4543b"
-    },
     {
       "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 +456,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,7 +1,7 @@
 {
   "formatVersion": 2,
   "packageName": "@spine-event-engine/proto",
-  "packageVersion": "2.0.0-snapshot.23",
+  "packageVersion": "2.0.0-snapshot.25",
   "protoFiles": [
     "grpc/health/v1/health.proto",
     "spine/auth/authenticated_subscription.proto",
@@ -37,8 +37,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",
@@ -95,8 +96,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 +122,5 @@
   },
   "dependencies": [],
   "moduleExport": "spineProtoModule",
-  "generationId": "fec1f80b11d2ce3194ac1ec265543e66464b8ed91a2edecb9fd6626925b5e9f0"
+  "generationId": "cb452a495b14cc11b88343ee1f89421cbfda09d126a9450b87b25ee71cd99cad"
 }