ankka 0.10.0 → 0.12.0

package/dist/_proto/ankka/protocol/v1/view_pb.d.ts

@@ -1,5 +1,5 @@
 import type { GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
-import type { Empty, Metadata, Payload } from "./payload_pb.ts";
+import type { Empty, Metadata, Payload, WorkflowStanding } from "./payload_pb.ts";
 import type { Message } from "@bufbuild/protobuf";
 /**
  * Describes the file ankka/protocol/v1/view.proto.
@@ -37,6 +37,18 @@ export type ViewRequest = Message<"ankka.protocol.v1.ViewRequest"> & {
      * @generated from field: bool deleted = 5;
      */
     deleted: boolean;
+    /**
+     * 1.13: a keyed view: the component this change is from. A keyed view is sent no `row`
+     *
+     * @generated from field: optional string source_id = 6;
+     */
+    sourceId?: string | undefined;
+    /**
+     * 1.16: a change from a workflow source: where it stood once the effect was applied
+     *
+     * @generated from field: optional ankka.protocol.v1.WorkflowStanding standing = 7;
+     */
+    standing?: WorkflowStanding | undefined;
 };
 /**
  * Describes the message ankka.protocol.v1.ViewRequest.
@@ -68,6 +80,14 @@ export type ViewEffect = Message<"ankka.protocol.v1.ViewEffect"> & {
          */
         value: Empty;
         case: "ignore";
+    } | {
+        /**
+         * 1.13: a keyed view's answer; empty is nothing
+         *
+         * @generated from field: ankka.protocol.v1.RowChanges rows = 4;
+         */
+        value: RowChanges;
+        case: "rows";
     } | {
         case: undefined;
         value?: undefined;
@@ -78,6 +98,55 @@ export type ViewEffect = Message<"ankka.protocol.v1.ViewEffect"> & {
  * Use `create(ViewEffectSchema)` to create a new message.
  */
 export declare const ViewEffectSchema: GenMessage<ViewEffect>;
+/**
+ * 1.13: the rows one change writes and deletes, in order; a later change to a key wins.
+ *
+ * @generated from message ankka.protocol.v1.RowChanges
+ */
+export type RowChanges = Message<"ankka.protocol.v1.RowChanges"> & {
+    /**
+     * @generated from field: repeated ankka.protocol.v1.RowChange changes = 1;
+     */
+    changes: RowChange[];
+};
+/**
+ * Describes the message ankka.protocol.v1.RowChanges.
+ * Use `create(RowChangesSchema)` to create a new message.
+ */
+export declare const RowChangesSchema: GenMessage<RowChanges>;
+/**
+ * @generated from message ankka.protocol.v1.RowChange
+ */
+export type RowChange = Message<"ankka.protocol.v1.RowChange"> & {
+    /**
+     * @generated from field: string key = 1;
+     */
+    key: string;
+    /**
+     * @generated from oneof ankka.protocol.v1.RowChange.change
+     */
+    change: {
+        /**
+         * @generated from field: ankka.protocol.v1.Payload upsert = 2;
+         */
+        value: Payload;
+        case: "upsert";
+    } | {
+        /**
+         * @generated from field: ankka.protocol.v1.Empty delete = 3;
+         */
+        value: Empty;
+        case: "delete";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message ankka.protocol.v1.RowChange.
+ * Use `create(RowChangeSchema)` to create a new message.
+ */
+export declare const RowChangeSchema: GenMessage<RowChange>;
 /**
  * @generated from service ankka.protocol.v1.View
  */

package/dist/_proto/ankka/protocol/v1/view_pb.js

@@ -6,7 +6,7 @@ import { file_ankka_protocol_v1_payload } from "./payload_pb.js";
 /**
  * Describes the file ankka/protocol/v1/view.proto.
  */
-export const file_ankka_protocol_v1_view = /*@__PURE__*/ fileDesc("ChxhbmtrYS9wcm90b2NvbC92MS92aWV3LnByb3RvEhFhbmtrYS5wcm90b2NvbC52MSLEAQoLVmlld1JlcXVlc3QSFAoMY29tcG9uZW50X2lkGAEgASgJEikKBWV2ZW50GAIgASgLMhouYW5ra2EucHJvdG9jb2wudjEuUGF5bG9hZBItCghtZXRhZGF0YRgDIAEoCzIbLmFua2thLnByb3RvY29sLnYxLk1ldGFkYXRhEiwKA3JvdxgEIAEoCzIaLmFua2thLnByb3RvY29sLnYxLlBheWxvYWRIAIgBARIPCgdkZWxldGVkGAUgASgIQgYKBF9yb3cipAEKClZpZXdFZmZlY3QSMAoKdXBkYXRlX3JvdxgBIAEoCzIaLmFua2thLnByb3RvY29sLnYxLlBheWxvYWRIABIuCgpkZWxldGVfcm93GAIgASgLMhguYW5ra2EucHJvdG9jb2wudjEuRW1wdHlIABIqCgZpZ25vcmUYAyABKAsyGC5hbmtrYS5wcm90b2NvbC52MS5FbXB0eUgAQggKBmVmZmVjdDJPCgRWaWV3EkcKBkhhbmRsZRIeLmFua2thLnByb3RvY29sLnYxLlZpZXdSZXF1ZXN0Gh0uYW5ra2EucHJvdG9jb2wudjEuVmlld0VmZmVjdGIGcHJvdG8z", [file_ankka_protocol_v1_payload]);
+export const file_ankka_protocol_v1_view = /*@__PURE__*/ fileDesc("ChxhbmtrYS9wcm90b2NvbC92MS92aWV3LnByb3RvEhFhbmtrYS5wcm90b2NvbC52MSKzAgoLVmlld1JlcXVlc3QSFAoMY29tcG9uZW50X2lkGAEgASgJEikKBWV2ZW50GAIgASgLMhouYW5ra2EucHJvdG9jb2wudjEuUGF5bG9hZBItCghtZXRhZGF0YRgDIAEoCzIbLmFua2thLnByb3RvY29sLnYxLk1ldGFkYXRhEiwKA3JvdxgEIAEoCzIaLmFua2thLnByb3RvY29sLnYxLlBheWxvYWRIAIgBARIPCgdkZWxldGVkGAUgASgIEhYKCXNvdXJjZV9pZBgGIAEoCUgBiAEBEjoKCHN0YW5kaW5nGAcgASgLMiMuYW5ra2EucHJvdG9jb2wudjEuV29ya2Zsb3dTdGFuZGluZ0gCiAEBQgYKBF9yb3dCDAoKX3NvdXJjZV9pZEILCglfc3RhbmRpbmci0wEKClZpZXdFZmZlY3QSMAoKdXBkYXRlX3JvdxgBIAEoCzIaLmFua2thLnByb3RvY29sLnYxLlBheWxvYWRIABIuCgpkZWxldGVfcm93GAIgASgLMhguYW5ra2EucHJvdG9jb2wudjEuRW1wdHlIABIqCgZpZ25vcmUYAyABKAsyGC5hbmtrYS5wcm90b2NvbC52MS5FbXB0eUgAEi0KBHJvd3MYBCABKAsyHS5hbmtrYS5wcm90b2NvbC52MS5Sb3dDaGFuZ2VzSABCCAoGZWZmZWN0IjsKClJvd0NoYW5nZXMSLQoHY2hhbmdlcxgBIAMoCzIcLmFua2thLnByb3RvY29sLnYxLlJvd0NoYW5nZSJ8CglSb3dDaGFuZ2USCwoDa2V5GAEgASgJEiwKBnVwc2VydBgCIAEoCzIaLmFua2thLnByb3RvY29sLnYxLlBheWxvYWRIABIqCgZkZWxldGUYAyABKAsyGC5hbmtrYS5wcm90b2NvbC52MS5FbXB0eUgAQggKBmNoYW5nZTJPCgRWaWV3EkcKBkhhbmRsZRIeLmFua2thLnByb3RvY29sLnYxLlZpZXdSZXF1ZXN0Gh0uYW5ra2EucHJvdG9jb2wudjEuVmlld0VmZmVjdGIGcHJvdG8z", [file_ankka_protocol_v1_payload]);
 /**
  * Describes the message ankka.protocol.v1.ViewRequest.
  * Use `create(ViewRequestSchema)` to create a new message.
@@ -17,6 +17,16 @@ export const ViewRequestSchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v
  * Use `create(ViewEffectSchema)` to create a new message.
  */
 export const ViewEffectSchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_view, 1);
+/**
+ * Describes the message ankka.protocol.v1.RowChanges.
+ * Use `create(RowChangesSchema)` to create a new message.
+ */
+export const RowChangesSchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_view, 2);
+/**
+ * Describes the message ankka.protocol.v1.RowChange.
+ * Use `create(RowChangeSchema)` to create a new message.
+ */
+export const RowChangeSchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_view, 3);
 /**
  * @generated from service ankka.protocol.v1.View
  */

package/dist/_proto/ankka/protocol/v1/wasm_pb.d.ts

@@ -167,6 +167,18 @@ export type FoldRequest = Message<"ankka.protocol.v1.FoldRequest"> & {
      * @generated from field: int64 sequence = 5;
      */
     sequence: bigint;
+    /**
+     * 1.19: where the event was written; empty when none is named
+     *
+     * @generated from field: string installation = 6;
+     */
+    installation: string;
+    /**
+     * 1.19: written at another installation than this one
+     *
+     * @generated from field: bool mirrored = 7;
+     */
+    mirrored: boolean;
 };
 /**
  * Describes the message ankka.protocol.v1.FoldRequest.

package/dist/_proto/ankka/protocol/v1/wasm_pb.js

@@ -14,7 +14,7 @@ import { file_ankka_protocol_v1_client } from "./client_pb.js";
 /**
  * Describes the file ankka/protocol/v1/wasm.proto.
  */
-export const file_ankka_protocol_v1_wasm = /*@__PURE__*/ fileDesc("ChxhbmtrYS9wcm90b2NvbC92MS93YXNtLnByb3RvEhFhbmtrYS5wcm90b2NvbC52MSJYCghXYXNtU3BlYxIlCgRzcGVjGAEgASgLMhcuYW5ra2EucHJvdG9jb2wudjEuU3BlYxIQCghzdGF0ZWZ1bBgCIAMoCRITCgthYmlfdmVyc2lvbhgDIAEoCSLfAgoNSGFuZGxlUmVxdWVzdBIlCgRraW5kGAEgASgOMhcuYW5ra2EucHJvdG9jb2wudjEuS2luZBIUCgxjb21wb25lbnRfaWQYAiABKAkSEQoJZW50aXR5X2lkGAMgASgJEi4KBXN0YXRlGAQgASgLMhouYW5ra2EucHJvdG9jb2wudjEuUGF5bG9hZEgBiAEBEkIKDWV2ZW50X3NvdXJjZWQYCiABKAsyKS5hbmtrYS5wcm90b2NvbC52MS5FdmVudFNvdXJjZWRJbi5Db21tYW5kSAASOgoJa2V5X3ZhbHVlGAsgASgLMiUuYW5ra2EucHJvdG9jb2wudjEuS2V5VmFsdWVJbi5Db21tYW5kSAASOQoId29ya2Zsb3cYDCABKAsyJS5hbmtrYS5wcm90b2NvbC52MS5Xb3JrZmxvd0luLkNvbW1hbmRIAEIJCgdjb21tYW5kQggKBl9zdGF0ZSLGAgoLSGFuZGxlUmVwbHkSQQoNZXZlbnRfc291cmNlZBgKIAEoCzIoLmFua2thLnByb3RvY29sLnYxLkV2ZW50U291cmNlZE91dC5SZXBseUgAEjkKCWtleV92YWx1ZRgLIAEoCzIkLmFua2thLnByb3RvY29sLnYxLktleVZhbHVlT3V0LlJlcGx5SAASOAoId29ya2Zsb3cYDCABKAsyJC5hbmtrYS5wcm90b2NvbC52MS5Xb3JrZmxvd091dC5SZXBseUgAEi4KBXN0YXRlGAIgASgLMhouYW5ra2EucHJvdG9jb2wudjEuUGF5bG9hZEgBiAEBEjAKB2ZhaWx1cmUYAyABKAsyGi5hbmtrYS5wcm90b2NvbC52MS5GYWlsdXJlSAKIAQFCBwoFcmVwbHlCCAoGX3N0YXRlQgoKCF9mYWlsdXJlIq0BCgtGb2xkUmVxdWVzdBIUCgxjb21wb25lbnRfaWQYASABKAkSEQoJZW50aXR5X2lkGAIgASgJEi4KBXN0YXRlGAMgASgLMhouYW5ra2EucHJvdG9jb2wudjEuUGF5bG9hZEgAiAEBEikKBWV2ZW50GAQgASgLMhouYW5ra2EucHJvdG9jb2wudjEuUGF5bG9hZBIQCghzZXF1ZW5jZRgFIAEoA0IICgZfc3RhdGUidAoJRm9sZFJlcGx5EikKBXN0YXRlGAEgASgLMhouYW5ra2EucHJvdG9jb2wudjEuUGF5bG9hZBIwCgdmYWlsdXJlGAIgASgLMhouYW5ra2EucHJvdG9jb2wudjEuRmFpbHVyZUgAiAEBQgoKCF9mYWlsdXJlIqkBCgtTdGVwUmVxdWVzdBIUCgxjb21wb25lbnRfaWQYASABKAkSEQoJZW50aXR5X2lkGAIgASgJEi4KBXN0YXRlGAMgASgLMhouYW5ra2EucHJvdG9jb2wudjEuUGF5bG9hZEgAiAEBEjcKCHJ1bl9zdGVwGAQgASgLMiUuYW5ra2EucHJvdG9jb2wudjEuV29ya2Zsb3dJbi5SdW5TdGVwQggKBl9zdGF0ZSK8AQoJU3RlcFJlcGx5EjcKBXJlcGx5GAEgASgLMiguYW5ra2EucHJvdG9jb2wudjEuV29ya2Zsb3dPdXQuU3RlcFJlcGx5Ei4KBXN0YXRlGAIgASgLMhouYW5ra2EucHJvdG9jb2wudjEuUGF5bG9hZEgAiAEBEjAKB2ZhaWx1cmUYAyABKAsyGi5hbmtrYS5wcm90b2NvbC52MS5GYWlsdXJlSAGIAQFCCAoGX3N0YXRlQgoKCF9mYWlsdXJlIjQKCVBhc3NpdmF0ZRIUCgxjb21wb25lbnRfaWQYASABKAkSEQoJZW50aXR5X2lkGAIgASgJIh0KDUNvbmZpZ1JlcXVlc3QSDAoEbmFtZRgBIAEoCSIrCgtDb25maWdSZXBseRISCgV2YWx1ZRgBIAEoCUgAiAEBQggKBl92YWx1ZSI+CgxTdHJlYW1Ub2tlbnMSLgoGdG9rZW5zGAEgAygLMh4uYW5ra2EucHJvdG9jb2wudjEuU3RyZWFtVG9rZW5iBnByb3RvMw", [file_ankka_protocol_v1_payload, file_ankka_protocol_v1_discovery, file_ankka_protocol_v1_event_sourced, file_ankka_protocol_v1_key_value, file_ankka_protocol_v1_workflow, file_ankka_protocol_v1_client]);
+export const file_ankka_protocol_v1_wasm = /*@__PURE__*/ fileDesc("ChxhbmtrYS9wcm90b2NvbC92MS93YXNtLnByb3RvEhFhbmtrYS5wcm90b2NvbC52MSJYCghXYXNtU3BlYxIlCgRzcGVjGAEgASgLMhcuYW5ra2EucHJvdG9jb2wudjEuU3BlYxIQCghzdGF0ZWZ1bBgCIAMoCRITCgthYmlfdmVyc2lvbhgDIAEoCSLfAgoNSGFuZGxlUmVxdWVzdBIlCgRraW5kGAEgASgOMhcuYW5ra2EucHJvdG9jb2wudjEuS2luZBIUCgxjb21wb25lbnRfaWQYAiABKAkSEQoJZW50aXR5X2lkGAMgASgJEi4KBXN0YXRlGAQgASgLMhouYW5ra2EucHJvdG9jb2wudjEuUGF5bG9hZEgBiAEBEkIKDWV2ZW50X3NvdXJjZWQYCiABKAsyKS5hbmtrYS5wcm90b2NvbC52MS5FdmVudFNvdXJjZWRJbi5Db21tYW5kSAASOgoJa2V5X3ZhbHVlGAsgASgLMiUuYW5ra2EucHJvdG9jb2wudjEuS2V5VmFsdWVJbi5Db21tYW5kSAASOQoId29ya2Zsb3cYDCABKAsyJS5hbmtrYS5wcm90b2NvbC52MS5Xb3JrZmxvd0luLkNvbW1hbmRIAEIJCgdjb21tYW5kQggKBl9zdGF0ZSLGAgoLSGFuZGxlUmVwbHkSQQoNZXZlbnRfc291cmNlZBgKIAEoCzIoLmFua2thLnByb3RvY29sLnYxLkV2ZW50U291cmNlZE91dC5SZXBseUgAEjkKCWtleV92YWx1ZRgLIAEoCzIkLmFua2thLnByb3RvY29sLnYxLktleVZhbHVlT3V0LlJlcGx5SAASOAoId29ya2Zsb3cYDCABKAsyJC5hbmtrYS5wcm90b2NvbC52MS5Xb3JrZmxvd091dC5SZXBseUgAEi4KBXN0YXRlGAIgASgLMhouYW5ra2EucHJvdG9jb2wudjEuUGF5bG9hZEgBiAEBEjAKB2ZhaWx1cmUYAyABKAsyGi5hbmtrYS5wcm90b2NvbC52MS5GYWlsdXJlSAKIAQFCBwoFcmVwbHlCCAoGX3N0YXRlQgoKCF9mYWlsdXJlItUBCgtGb2xkUmVxdWVzdBIUCgxjb21wb25lbnRfaWQYASABKAkSEQoJZW50aXR5X2lkGAIgASgJEi4KBXN0YXRlGAMgASgLMhouYW5ra2EucHJvdG9jb2wudjEuUGF5bG9hZEgAiAEBEikKBWV2ZW50GAQgASgLMhouYW5ra2EucHJvdG9jb2wudjEuUGF5bG9hZBIQCghzZXF1ZW5jZRgFIAEoAxIUCgxpbnN0YWxsYXRpb24YBiABKAkSEAoIbWlycm9yZWQYByABKAhCCAoGX3N0YXRlInQKCUZvbGRSZXBseRIpCgVzdGF0ZRgBIAEoCzIaLmFua2thLnByb3RvY29sLnYxLlBheWxvYWQSMAoHZmFpbHVyZRgCIAEoCzIaLmFua2thLnByb3RvY29sLnYxLkZhaWx1cmVIAIgBAUIKCghfZmFpbHVyZSKpAQoLU3RlcFJlcXVlc3QSFAoMY29tcG9uZW50X2lkGAEgASgJEhEKCWVudGl0eV9pZBgCIAEoCRIuCgVzdGF0ZRgDIAEoCzIaLmFua2thLnByb3RvY29sLnYxLlBheWxvYWRIAIgBARI3CghydW5fc3RlcBgEIAEoCzIlLmFua2thLnByb3RvY29sLnYxLldvcmtmbG93SW4uUnVuU3RlcEIICgZfc3RhdGUivAEKCVN0ZXBSZXBseRI3CgVyZXBseRgBIAEoCzIoLmFua2thLnByb3RvY29sLnYxLldvcmtmbG93T3V0LlN0ZXBSZXBseRIuCgVzdGF0ZRgCIAEoCzIaLmFua2thLnByb3RvY29sLnYxLlBheWxvYWRIAIgBARIwCgdmYWlsdXJlGAMgASgLMhouYW5ra2EucHJvdG9jb2wudjEuRmFpbHVyZUgBiAEBQggKBl9zdGF0ZUIKCghfZmFpbHVyZSI0CglQYXNzaXZhdGUSFAoMY29tcG9uZW50X2lkGAEgASgJEhEKCWVudGl0eV9pZBgCIAEoCSIdCg1Db25maWdSZXF1ZXN0EgwKBG5hbWUYASABKAkiKwoLQ29uZmlnUmVwbHkSEgoFdmFsdWUYASABKAlIAIgBAUIICgZfdmFsdWUiPgoMU3RyZWFtVG9rZW5zEi4KBnRva2VucxgBIAMoCzIeLmFua2thLnByb3RvY29sLnYxLlN0cmVhbVRva2VuYgZwcm90bzM", [file_ankka_protocol_v1_payload, file_ankka_protocol_v1_discovery, file_ankka_protocol_v1_event_sourced, file_ankka_protocol_v1_key_value, file_ankka_protocol_v1_workflow, file_ankka_protocol_v1_client]);
 /**
  * Describes the message ankka.protocol.v1.WasmSpec.
  * Use `create(WasmSpecSchema)` to create a new message.

package/dist/_proto/ankka/protocol/v1/workflow_pb.d.ts

@@ -89,6 +89,9 @@ export type WorkflowIn_Command = Message<"ankka.protocol.v1.WorkflowIn.Command">
  */
 export declare const WorkflowIn_CommandSchema: GenMessage<WorkflowIn_Command>;
 /**
+ * `metadata` (1.3): the trace this step belongs to and the step's own name as the caller of
+ * whatever it calls, for the process to forward on those calls as it does a command's.
+ *
  * @generated from message ankka.protocol.v1.WorkflowIn.RunStep
  */
 export type WorkflowIn_RunStep = Message<"ankka.protocol.v1.WorkflowIn.RunStep"> & {
@@ -104,6 +107,10 @@ export type WorkflowIn_RunStep = Message<"ankka.protocol.v1.WorkflowIn.RunStep">
      * @generated from field: optional ankka.protocol.v1.Payload input = 3;
      */
     input?: Payload | undefined;
+    /**
+     * @generated from field: ankka.protocol.v1.Metadata metadata = 4;
+     */
+    metadata?: Metadata | undefined;
 };
 /**
  * Describes the message ankka.protocol.v1.WorkflowIn.RunStep.

package/dist/_proto/ankka/protocol/v1/workflow_pb.js

@@ -5,7 +5,7 @@ import { file_ankka_protocol_v1_payload } from "./payload_pb.js";
 /**
  * Describes the file ankka/protocol/v1/workflow.proto.
  */
-export const file_ankka_protocol_v1_workflow = /*@__PURE__*/ fileDesc("CiBhbmtrYS9wcm90b2NvbC92MS93b3JrZmxvdy5wcm90bxIRYW5ra2EucHJvdG9jb2wudjEiiwQKCldvcmtmbG93SW4SMgoEaW5pdBgBIAEoCzIiLmFua2thLnByb3RvY29sLnYxLldvcmtmbG93SW4uSW5pdEgAEjgKB2NvbW1hbmQYAiABKAsyJS5hbmtrYS5wcm90b2NvbC52MS5Xb3JrZmxvd0luLkNvbW1hbmRIABI5CghydW5fc3RlcBgDIAEoCzIlLmFua2thLnByb3RvY29sLnYxLldvcmtmbG93SW4uUnVuU3RlcEgAGmkKBEluaXQSFAoMY29tcG9uZW50X2lkGAEgASgJEhEKCWVudGl0eV9pZBgCIAEoCRIuCgVzdGF0ZRgDIAEoCzIaLmFua2thLnByb3RvY29sLnYxLlBheWxvYWRIAIgBAUIICgZfc3RhdGUafwoHQ29tbWFuZBIKCgJpZBgBIAEoAxIMCgRuYW1lGAIgASgJEisKB3BheWxvYWQYAyABKAsyGi5hbmtrYS5wcm90b2NvbC52MS5QYXlsb2FkEi0KCG1ldGFkYXRhGAQgASgLMhsuYW5ra2EucHJvdG9jb2wudjEuTWV0YWRhdGEaXQoHUnVuU3RlcBIKCgJpZBgBIAEoAxIMCgRzdGVwGAIgASgJEi4KBWlucHV0GAMgASgLMhouYW5ra2EucHJvdG9jb2wudjEuUGF5bG9hZEgAiAEBQggKBl9pbnB1dEIJCgdtZXNzYWdlIqEECgtXb3JrZmxvd091dBI1CgVyZXBseRgBIAEoCzIkLmFua2thLnByb3RvY29sLnYxLldvcmtmbG93T3V0LlJlcGx5SAASPgoKc3RlcF9yZXBseRgCIAEoCzIoLmFua2thLnByb3RvY29sLnYxLldvcmtmbG93T3V0LlN0ZXBSZXBseUgAEi0KB2ZhaWx1cmUYAyABKAsyGi5hbmtrYS5wcm90b2NvbC52MS5GYWlsdXJlSAAazgEKBVJlcGx5EhIKCmNvbW1hbmRfaWQYASABKAMSMgoJbmV3X3N0YXRlGAIgASgLMhouYW5ra2EucHJvdG9jb2wudjEuUGF5bG9hZEgAiAEBEjMKCnRyYW5zaXRpb24YAyABKAsyGi5hbmtrYS5wcm90b2NvbC52MS5TdGVwUmVmSAGIAQESKwoHb3V0Y29tZRgEIAEoCzIaLmFua2thLnByb3RvY29sLnYxLk91dGNvbWVCDAoKX25ld19zdGF0ZUINCgtfdHJhbnNpdGlvbhqPAQoJU3RlcFJlcGx5EhIKCmNvbW1hbmRfaWQYASABKAMSMgoJbmV3X3N0YXRlGAIgASgLMhouYW5ra2EucHJvdG9jb2wudjEuUGF5bG9hZEgAiAEBEiwKBG5leHQYAyABKAsyHi5hbmtrYS5wcm90b2NvbC52MS5TdGVwT3V0Y29tZUIMCgpfbmV3X3N0YXRlQgkKB21lc3NhZ2UiUQoHU3RlcFJlZhIMCgRzdGVwGAEgASgJEi4KBWlucHV0GAIgASgLMhouYW5ra2EucHJvdG9jb2wudjEuUGF5bG9hZEgAiAEBQggKBl9pbnB1dCLhAgoLU3RlcE91dGNvbWUSMwoNdHJhbnNpdGlvbl90bxgBIAEoCzIaLmFua2thLnByb3RvY29sLnYxLlN0ZXBSZWZIABI1CgVwYXVzZRgCIAEoCzIkLmFua2thLnByb3RvY29sLnYxLlN0ZXBPdXRjb21lLlBhdXNlSAASMQoDZW5kGAMgASgLMiIuYW5ra2EucHJvdG9jb2wudjEuU3RlcE91dGNvbWUuRW5kSAASKAoEZmFpbBgEIAEoCzIYLmFua2thLnByb3RvY29sLnYxLkVycm9ySAAadwoFUGF1c2USGQoMYWZ0ZXJfbWlsbGlzGAEgASgDSACIAQESMwoKb25fdGltZW91dBgCIAEoCzIaLmFua2thLnByb3RvY29sLnYxLlN0ZXBSZWZIAYgBAUIPCg1fYWZ0ZXJfbWlsbGlzQg0KC19vbl90aW1lb3V0GgUKA0VuZEIJCgdvdXRjb21lMlcKCFdvcmtmbG93EksKBkhhbmRsZRIdLmFua2thLnByb3RvY29sLnYxLldvcmtmbG93SW4aHi5hbmtrYS5wcm90b2NvbC52MS5Xb3JrZmxvd091dCgBMAFiBnByb3RvMw", [file_ankka_protocol_v1_payload]);
+export const file_ankka_protocol_v1_workflow = /*@__PURE__*/ fileDesc("CiBhbmtrYS9wcm90b2NvbC92MS93b3JrZmxvdy5wcm90bxIRYW5ra2EucHJvdG9jb2wudjEiuwQKCldvcmtmbG93SW4SMgoEaW5pdBgBIAEoCzIiLmFua2thLnByb3RvY29sLnYxLldvcmtmbG93SW4uSW5pdEgAEjgKB2NvbW1hbmQYAiABKAsyJS5hbmtrYS5wcm90b2NvbC52MS5Xb3JrZmxvd0luLkNvbW1hbmRIABI5CghydW5fc3RlcBgDIAEoCzIlLmFua2thLnByb3RvY29sLnYxLldvcmtmbG93SW4uUnVuU3RlcEgAGmkKBEluaXQSFAoMY29tcG9uZW50X2lkGAEgASgJEhEKCWVudGl0eV9pZBgCIAEoCRIuCgVzdGF0ZRgDIAEoCzIaLmFua2thLnByb3RvY29sLnYxLlBheWxvYWRIAIgBAUIICgZfc3RhdGUafwoHQ29tbWFuZBIKCgJpZBgBIAEoAxIMCgRuYW1lGAIgASgJEisKB3BheWxvYWQYAyABKAsyGi5hbmtrYS5wcm90b2NvbC52MS5QYXlsb2FkEi0KCG1ldGFkYXRhGAQgASgLMhsuYW5ra2EucHJvdG9jb2wudjEuTWV0YWRhdGEajAEKB1J1blN0ZXASCgoCaWQYASABKAMSDAoEc3RlcBgCIAEoCRIuCgVpbnB1dBgDIAEoCzIaLmFua2thLnByb3RvY29sLnYxLlBheWxvYWRIAIgBARItCghtZXRhZGF0YRgEIAEoCzIbLmFua2thLnByb3RvY29sLnYxLk1ldGFkYXRhQggKBl9pbnB1dEIJCgdtZXNzYWdlIqEECgtXb3JrZmxvd091dBI1CgVyZXBseRgBIAEoCzIkLmFua2thLnByb3RvY29sLnYxLldvcmtmbG93T3V0LlJlcGx5SAASPgoKc3RlcF9yZXBseRgCIAEoCzIoLmFua2thLnByb3RvY29sLnYxLldvcmtmbG93T3V0LlN0ZXBSZXBseUgAEi0KB2ZhaWx1cmUYAyABKAsyGi5hbmtrYS5wcm90b2NvbC52MS5GYWlsdXJlSAAazgEKBVJlcGx5EhIKCmNvbW1hbmRfaWQYASABKAMSMgoJbmV3X3N0YXRlGAIgASgLMhouYW5ra2EucHJvdG9jb2wudjEuUGF5bG9hZEgAiAEBEjMKCnRyYW5zaXRpb24YAyABKAsyGi5hbmtrYS5wcm90b2NvbC52MS5TdGVwUmVmSAGIAQESKwoHb3V0Y29tZRgEIAEoCzIaLmFua2thLnByb3RvY29sLnYxLk91dGNvbWVCDAoKX25ld19zdGF0ZUINCgtfdHJhbnNpdGlvbhqPAQoJU3RlcFJlcGx5EhIKCmNvbW1hbmRfaWQYASABKAMSMgoJbmV3X3N0YXRlGAIgASgLMhouYW5ra2EucHJvdG9jb2wudjEuUGF5bG9hZEgAiAEBEiwKBG5leHQYAyABKAsyHi5hbmtrYS5wcm90b2NvbC52MS5TdGVwT3V0Y29tZUIMCgpfbmV3X3N0YXRlQgkKB21lc3NhZ2UiUQoHU3RlcFJlZhIMCgRzdGVwGAEgASgJEi4KBWlucHV0GAIgASgLMhouYW5ra2EucHJvdG9jb2wudjEuUGF5bG9hZEgAiAEBQggKBl9pbnB1dCLhAgoLU3RlcE91dGNvbWUSMwoNdHJhbnNpdGlvbl90bxgBIAEoCzIaLmFua2thLnByb3RvY29sLnYxLlN0ZXBSZWZIABI1CgVwYXVzZRgCIAEoCzIkLmFua2thLnByb3RvY29sLnYxLlN0ZXBPdXRjb21lLlBhdXNlSAASMQoDZW5kGAMgASgLMiIuYW5ra2EucHJvdG9jb2wudjEuU3RlcE91dGNvbWUuRW5kSAASKAoEZmFpbBgEIAEoCzIYLmFua2thLnByb3RvY29sLnYxLkVycm9ySAAadwoFUGF1c2USGQoMYWZ0ZXJfbWlsbGlzGAEgASgDSACIAQESMwoKb25fdGltZW91dBgCIAEoCzIaLmFua2thLnByb3RvY29sLnYxLlN0ZXBSZWZIAYgBAUIPCg1fYWZ0ZXJfbWlsbGlzQg0KC19vbl90aW1lb3V0GgUKA0VuZEIJCgdvdXRjb21lMlcKCFdvcmtmbG93EksKBkhhbmRsZRIdLmFua2thLnByb3RvY29sLnYxLldvcmtmbG93SW4aHi5hbmtrYS5wcm90b2NvbC52MS5Xb3JrZmxvd091dCgBMAFiBnByb3RvMw", [file_ankka_protocol_v1_payload]);
 /**
  * Describes the message ankka.protocol.v1.WorkflowIn.
  * Use `create(WorkflowInSchema)` to create a new message.

package/dist/agent.d.ts

@@ -1,7 +1,9 @@
 import type { Metadata } from "./effects/common.ts";
-import type { ComponentClient } from "./client.ts";
+import { type ComponentClient, type Secrets } from "./client.ts";
 import type { GuardrailRef, HandlerTable, ToolRef } from "./handlers.ts";
 import { AgentEffects } from "./effects/agent.ts";
+import { type Services } from "./services.ts";
+import type { McpServerRef, ResultGuardrailRef } from "./mcp.ts";
 export declare abstract class Agent {
     #private;
     readonly effects: AgentEffects;
@@ -9,6 +11,14 @@ export declare abstract class Agent {
     get sessionId(): string;
     get metadata(): Metadata;
     get client(): ComponentClient;
+    /** The service's secret store: values kept encrypted in the service's own database, never in a journal or a view. */
+    get secrets(): Secrets;
+    /** A unit test's store in place of the runtime's: `component.secrets = new InMemorySecrets()`. */
+    set secrets(store: Secrets);
+    /** Other services, called as this one, through the runtime: `this.services.service("orders")`. */
+    get services(): Services;
+    /** A unit test's in place of the runtime's: `component.services = new ScriptedServices()`. */
+    set services(services: Services);
     /** @internal */
     get _kind(): "agent";
     /** @internal */
@@ -23,5 +33,9 @@ export interface AgentClass<C extends Agent = Agent> {
     readonly maxToolCallSteps?: number;
     readonly tools?: Readonly<Record<string, ToolRef<C, any>>>;
     readonly guardrails?: Readonly<Record<string, GuardrailRef>>;
+    /** MCP servers whose tools are offered beside the agent's own, as `mcp__<server>__<tool>`. */
+    readonly mcpServers?: Readonly<Record<string, McpServerRef>>;
+    /** Checks on what an MCP server's tool answered, before the model is told it. */
+    readonly resultGuardrails?: Readonly<Record<string, ResultGuardrailRef>>;
     readonly handlers: HandlerTable<C>;
 }

package/dist/agent.js

@@ -5,7 +5,9 @@
 //   static readonly tools = { lookup: tool("lookup", "Looks up a cart by id.", CartLookup, (a: Assistant, input) => a.lookup(input.cartId)) }
 //   static readonly guardrails = { noSecrets: guardrail("no-secrets", (stage, text) => text.includes("sk-") ? "a key leaked" : null) }
 //   static readonly handlers = { ask: command("ask", s.string, s.string, (a: Assistant, q) => a.ask(q)), chat: stream("chat", s.string, (a: Assistant, q) => a.ask(q)) }
+import { secretsFor } from "./client.js";
 import { AgentEffects } from "./effects/agent.js";
+import { servicesFor } from "./services.js";
 export class Agent {
     effects = new AgentEffects();
     #sessionId = "";
@@ -23,6 +25,24 @@ export class Agent {
             throw new Error("client is only available inside a handler, a tool or a guardrail");
         return this.#client;
     }
+    #secrets;
+    /** The service's secret store: values kept encrypted in the service's own database, never in a journal or a view. */
+    get secrets() {
+        return this.#secrets ?? secretsFor(this.client);
+    }
+    /** A unit test's store in place of the runtime's: `component.secrets = new InMemorySecrets()`. */
+    set secrets(store) {
+        this.#secrets = store;
+    }
+    #services;
+    /** Other services, called as this one, through the runtime: `this.services.service("orders")`. */
+    get services() {
+        return this.#services ?? servicesFor(this.client);
+    }
+    /** A unit test's in place of the runtime's: `component.services = new ScriptedServices()`. */
+    set services(services) {
+        this.#services = services;
+    }
     /** @internal */
     get _kind() {
         return "agent";

package/dist/approvals.d.ts

@@ -0,0 +1,47 @@
+import type { ApprovalAwaited as ApprovalAwaitedProto, ApprovalRequest as ApprovalRequestProto } from "./_proto/ankka/protocol/v1/client_pb.ts";
+/** The protocol version that carries approvals: a runtime before it cannot record a decision. */
+export declare const APPROVALS_SINCE = "1.11";
+/** That a tool, or every tool of an MCP server, waits for a person; with `withinMs`, the platform refuses it when that much time passes undecided. */
+export type Approval = true | {
+    readonly withinMs: number;
+};
+/** A problem with an approval as declared, or undefined. */
+export declare function approvalProblem(approval: Approval | undefined): string | undefined;
+/** The discovery form: absent for none, empty for no time limit. */
+export declare function approvalToProto(approval: Approval | undefined): {
+    withinMillis?: bigint;
+} | undefined;
+/** What an agent records when the model calls a tool that requires approval: the id a decision names, the tool and the model's arguments. */
+export interface ApprovalRequest {
+    readonly id: string;
+    readonly tool: string;
+    readonly arguments: unknown;
+    readonly requestedAt: number;
+    readonly expiresAt?: number;
+}
+export declare function requestFromProto(pb: ApprovalRequestProto): ApprovalRequest;
+/** A request as an autonomous agent's record holds it. */
+export declare function requestFromJson(body: Record<string, any>): ApprovalRequest;
+/** What a turn that may wait came to: the model's answer, or the requests it waits on. */
+export type AgentOutcome<R> = {
+    readonly kind: "answered";
+    readonly value: R;
+} | {
+    readonly kind: "awaiting-approval";
+    readonly requests: readonly ApprovalRequest[];
+};
+export declare function awaitingOf(pb: ApprovalAwaitedProto): AgentOutcome<never>;
+/**
+ * Thrown by the calls that answer only with a value — `invoke` and `stream` — when the turn waits. Use
+ * `ask`, `streamParts` or `decide` to be answered with the requests instead.
+ */
+export declare class ApprovalAwaited extends Error {
+    readonly requests: readonly ApprovalRequest[];
+    constructor(requests: readonly ApprovalRequest[]);
+}
+/** A person's decision: `by` names who decided and is required; a refusal may carry a note the model is told. */
+export interface DecisionInput {
+    readonly approved: boolean;
+    readonly by: string;
+    readonly note?: string;
+}

package/dist/approvals.js

@@ -0,0 +1,57 @@
+// Approvals: a tool that waits for a person's decision before it runs.
+//
+// A tool declared with `approval` is never run when the model calls it. The sidecar records an approval
+// request and answers the caller with it instead of an answer; the turn goes on when a person decides,
+// through `decide`. Approved, the tool runs once and the model is told its result; refused, the model is
+// told who refused it and why, and the tool never runs. Who decided is required and recorded; who *may*
+// decide is the ACL of whatever route sends the decision.
+/** The protocol version that carries approvals: a runtime before it cannot record a decision. */
+export const APPROVALS_SINCE = "1.11";
+/** A problem with an approval as declared, or undefined. */
+export function approvalProblem(approval) {
+    if (approval === undefined || approval === true)
+        return undefined;
+    if (!Number.isFinite(approval.withinMs) || approval.withinMs <= 0)
+        return `a time limit for approval must be positive, not ${approval.withinMs}ms`;
+    return undefined;
+}
+/** The discovery form: absent for none, empty for no time limit. */
+export function approvalToProto(approval) {
+    if (approval === undefined)
+        return undefined;
+    return approval === true ? {} : { withinMillis: BigInt(Math.trunc(approval.withinMs)) };
+}
+export function requestFromProto(pb) {
+    return Object.freeze({
+        id: pb.id,
+        tool: pb.tool,
+        arguments: pb.argumentsJson ? JSON.parse(pb.argumentsJson) : {},
+        requestedAt: Number(pb.requestedAtMillis),
+        ...(pb.expiresAtMillis !== undefined ? { expiresAt: Number(pb.expiresAtMillis) } : {}),
+    });
+}
+/** A request as an autonomous agent's record holds it. */
+export function requestFromJson(body) {
+    return Object.freeze({
+        id: String(body.id),
+        tool: String(body.tool),
+        arguments: body.arguments ?? {},
+        requestedAt: Number(body.requestedAt ?? 0),
+        ...(body.expiresAt !== undefined ? { expiresAt: Number(body.expiresAt) } : {}),
+    });
+}
+export function awaitingOf(pb) {
+    return Object.freeze({ kind: "awaiting-approval", requests: pb.requests.map(requestFromProto) });
+}
+/**
+ * Thrown by the calls that answer only with a value — `invoke` and `stream` — when the turn waits. Use
+ * `ask`, `streamParts` or `decide` to be answered with the requests instead.
+ */
+export class ApprovalAwaited extends Error {
+    requests;
+    constructor(requests) {
+        super(`approval awaited for ${requests.map((r) => `'${r.tool}' (${r.id})`).join(", ")}`);
+        this.name = "ApprovalAwaited";
+        this.requests = requests;
+    }
+}

package/dist/autonomous.d.ts

@@ -1,6 +1,9 @@
-import type { ComponentClient } from "./client.ts";
+import { type ApprovalRequest, type DecisionInput } from "./approvals.ts";
+import type { McpServerRef, ResultGuardrailRef } from "./mcp.ts";
+import { type ComponentClient, type Secrets } from "./client.ts";
 import type { GuardrailRef, ToolRef } from "./handlers.ts";
 import type { Schema } from "./schema.ts";
+import { type Services } from "./services.ts";
 type MaybePromise<T> = T | Promise<T>;
 export declare const COMPLETE_TASK = "complete_task";
 export declare const FAIL_TASK = "fail_task";
@@ -51,6 +54,14 @@ export declare abstract class AutonomousAgent {
     /** The task a tool, a guardrail or a rule is running for. */
     get taskId(): string;
     get client(): ComponentClient;
+    /** The service's secret store: values kept encrypted in the service's own database, never in a journal or a view. */
+    get secrets(): Secrets;
+    /** A unit test's store in place of the runtime's: `component.secrets = new InMemorySecrets()`. */
+    set secrets(store: Secrets);
+    /** Other services, called as this one, through the runtime: `this.services.service("orders")`. */
+    get services(): Services;
+    /** A unit test's in place of the runtime's: `component.services = new ScriptedServices()`. */
+    set services(services: Services);
     /** @internal */
     get _kind(): "autonomous-agent";
     /** @internal */
@@ -67,6 +78,10 @@ export interface AutonomousAgentClass<C extends AutonomousAgent = AutonomousAgen
     readonly guardrails?: Readonly<Record<string, GuardrailRef>>;
     readonly accepts: readonly TaskAcceptance[];
     readonly settings?: AutonomousSettings;
+    /** MCP servers whose tools are offered beside the agent's own, as `mcp__<server>__<tool>`. */
+    readonly mcpServers?: Readonly<Record<string, McpServerRef>>;
+    /** Checks on what an MCP server's tool answered, before the model is told it. */
+    readonly resultGuardrails?: Readonly<Record<string, ResultGuardrailRef>>;
 }
 /** The discovery form of a result schema. */
 export declare function resultSchemaJson(type: TaskType<any>): string | undefined;
@@ -94,6 +109,8 @@ export interface AgentState {
     readonly currentTask: string | undefined;
     readonly iteration: number;
     readonly queued: readonly string[];
+    /** The approval requests the current task's tool calls await; while any does, the instance calls no model. */
+    readonly awaiting: readonly ApprovalRequest[];
 }
 /** One thing an instance did: `type` names it, and the rest of its fields are as sent. */
 export interface Notification {
@@ -148,6 +165,11 @@ export declare class AutonomousAgentCalls {
     /** Stops the instance for good; its tasks go back to pending for another to take. */
     terminate(): Promise<void>;
     state(): Promise<AgentState>;
+    /**
+     * Decides one of the instance's approval requests. `by` names who decided and is required. Approved, the
+     * tool runs and the task goes on; refused, the model is told so. A request already decided is a conflict.
+     */
+    decide(approvalId: string, decision: DecisionInput): Promise<void>;
     /** What the instance does from now on, as it happens. Nothing is replayed. */
     notifications(): AsyncIterable<Notification>;
 }

package/dist/autonomous.js

@@ -14,8 +14,11 @@
 //
 // A tool may run more than once for one request of the model — after a crash, the last recorded
 // request's tools run again — so a tool with a side effect should tolerate a repeat.
+import { requestFromJson } from "./approvals.js";
+import { secretsFor } from "./client.js";
 import { decodeJsonValue, reviver } from "./json.js";
 import { toJsonSchema } from "./schema.js";
+import { servicesFor } from "./services.js";
 export const COMPLETE_TASK = "complete_task";
 export const FAIL_TASK = "fail_task";
 export const accepted = () => Object.freeze({ verdict: "accepted" });
@@ -56,6 +59,24 @@ export class AutonomousAgent {
             throw new Error("client is only available inside a tool, a guardrail or a rule");
         return this.#client;
     }
+    #secrets;
+    /** The service's secret store: values kept encrypted in the service's own database, never in a journal or a view. */
+    get secrets() {
+        return this.#secrets ?? secretsFor(this.client);
+    }
+    /** A unit test's store in place of the runtime's: `component.secrets = new InMemorySecrets()`. */
+    set secrets(store) {
+        this.#secrets = store;
+    }
+    #services;
+    /** Other services, called as this one, through the runtime: `this.services.service("orders")`. */
+    get services() {
+        return this.#services ?? servicesFor(this.client);
+    }
+    /** A unit test's in place of the runtime's: `component.services = new ScriptedServices()`. */
+    set services(services) {
+        this.#services = services;
+    }
     /** @internal */
     get _kind() {
         return "autonomous-agent";
@@ -188,7 +209,15 @@ export class AutonomousAgentCalls {
         const r = (await this.#client._raw("event-sourced", INSTANCE, `${this.componentId}/${this.#instance()}`, "get"));
         const current = r.current;
         const phase = r.terminated ? "terminated" : r.suspended ? "suspended" : current ? "working" : (r.queue ?? []).length > 0 ? "waiting" : "idle";
-        return Object.freeze({ phase, currentTask: current?.taskId, iteration: current?.iteration ?? 0, queued: [...(r.queue ?? [])] });
+        const awaiting = (current?.approvals ?? []).filter((a) => a.decision === undefined || a.decision === null).map(requestFromJson);
+        return Object.freeze({ phase, currentTask: current?.taskId, iteration: current?.iteration ?? 0, queued: [...(r.queue ?? [])], awaiting });
+    }
+    /**
+     * Decides one of the instance's approval requests. `by` names who decided and is required. Approved, the
+     * tool runs and the task goes on; refused, the model is told so. A request already decided is a conflict.
+     */
+    async decide(approvalId, decision) {
+        await this.#client._decide("autonomous-agent", this.componentId, this.#instance(), "", approvalId, decision);
     }
     /** What the instance does from now on, as it happens. Nothing is replayed. */
     async *notifications() {