ankka 0.6.0

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

@@ -0,0 +1,75 @@
+import type { GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
+import type { Empty, Error, Metadata, Payload } from "./payload_pb.ts";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ankka/protocol/v1/timed_action.proto.
+ */
+export declare const file_ankka_protocol_v1_timed_action: GenFile;
+/**
+ * @generated from message ankka.protocol.v1.TimedActionRequest
+ */
+export type TimedActionRequest = Message<"ankka.protocol.v1.TimedActionRequest"> & {
+    /**
+     * @generated from field: string component_id = 1;
+     */
+    componentId: string;
+    /**
+     * @generated from field: string name = 2;
+     */
+    name: string;
+    /**
+     * @generated from field: ankka.protocol.v1.Payload payload = 3;
+     */
+    payload?: Payload | undefined;
+    /**
+     * @generated from field: ankka.protocol.v1.Metadata metadata = 4;
+     */
+    metadata?: Metadata | undefined;
+};
+/**
+ * Describes the message ankka.protocol.v1.TimedActionRequest.
+ * Use `create(TimedActionRequestSchema)` to create a new message.
+ */
+export declare const TimedActionRequestSchema: GenMessage<TimedActionRequest>;
+/**
+ * @generated from message ankka.protocol.v1.TimedActionEffect
+ */
+export type TimedActionEffect = Message<"ankka.protocol.v1.TimedActionEffect"> & {
+    /**
+     * @generated from oneof ankka.protocol.v1.TimedActionEffect.effect
+     */
+    effect: {
+        /**
+         * @generated from field: ankka.protocol.v1.Empty done = 1;
+         */
+        value: Empty;
+        case: "done";
+    } | {
+        /**
+         * @generated from field: ankka.protocol.v1.Error fail = 2;
+         */
+        value: Error;
+        case: "fail";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message ankka.protocol.v1.TimedActionEffect.
+ * Use `create(TimedActionEffectSchema)` to create a new message.
+ */
+export declare const TimedActionEffectSchema: GenMessage<TimedActionEffect>;
+/**
+ * @generated from service ankka.protocol.v1.TimedAction
+ */
+export declare const TimedAction: GenService<{
+    /**
+     * @generated from rpc ankka.protocol.v1.TimedAction.Invoke
+     */
+    invoke: {
+        methodKind: "unary";
+        input: typeof TimedActionRequestSchema;
+        output: typeof TimedActionEffectSchema;
+    };
+}>;

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

@@ -0,0 +1,23 @@
+// @generated by protoc-gen-es v2.15.0 with parameter "target=ts,import_extension=ts,erasable_syntax=true"
+// @generated from file ankka/protocol/v1/timed_action.proto (package ankka.protocol.v1, syntax proto3)
+/* eslint-disable */
+import { fileDesc, messageDesc, serviceDesc } from "@bufbuild/protobuf/codegenv2";
+import { file_ankka_protocol_v1_payload } from "./payload_pb.js";
+/**
+ * Describes the file ankka/protocol/v1/timed_action.proto.
+ */
+export const file_ankka_protocol_v1_timed_action = /*@__PURE__*/ fileDesc("CiRhbmtrYS9wcm90b2NvbC92MS90aW1lZF9hY3Rpb24ucHJvdG8SEWFua2thLnByb3RvY29sLnYxIpQBChJUaW1lZEFjdGlvblJlcXVlc3QSFAoMY29tcG9uZW50X2lkGAEgASgJEgwKBG5hbWUYAiABKAkSKwoHcGF5bG9hZBgDIAEoCzIaLmFua2thLnByb3RvY29sLnYxLlBheWxvYWQSLQoIbWV0YWRhdGEYBCABKAsyGy5hbmtrYS5wcm90b2NvbC52MS5NZXRhZGF0YSJxChFUaW1lZEFjdGlvbkVmZmVjdBIoCgRkb25lGAEgASgLMhguYW5ra2EucHJvdG9jb2wudjEuRW1wdHlIABIoCgRmYWlsGAIgASgLMhguYW5ra2EucHJvdG9jb2wudjEuRXJyb3JIAEIICgZlZmZlY3QyZAoLVGltZWRBY3Rpb24SVQoGSW52b2tlEiUuYW5ra2EucHJvdG9jb2wudjEuVGltZWRBY3Rpb25SZXF1ZXN0GiQuYW5ra2EucHJvdG9jb2wudjEuVGltZWRBY3Rpb25FZmZlY3RiBnByb3RvMw", [file_ankka_protocol_v1_payload]);
+/**
+ * Describes the message ankka.protocol.v1.TimedActionRequest.
+ * Use `create(TimedActionRequestSchema)` to create a new message.
+ */
+export const TimedActionRequestSchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_timed_action, 0);
+/**
+ * Describes the message ankka.protocol.v1.TimedActionEffect.
+ * Use `create(TimedActionEffectSchema)` to create a new message.
+ */
+export const TimedActionEffectSchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_timed_action, 1);
+/**
+ * @generated from service ankka.protocol.v1.TimedAction
+ */
+export const TimedAction = /*@__PURE__*/ serviceDesc(file_ankka_protocol_v1_timed_action, 0);

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

@@ -0,0 +1,93 @@
+import type { GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
+import type { Empty, Metadata, Payload } from "./payload_pb.ts";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ankka/protocol/v1/view.proto.
+ */
+export declare const file_ankka_protocol_v1_view: GenFile;
+/**
+ * @generated from message ankka.protocol.v1.ViewRequest
+ */
+export type ViewRequest = Message<"ankka.protocol.v1.ViewRequest"> & {
+    /**
+     * @generated from field: string component_id = 1;
+     */
+    componentId: string;
+    /**
+     * absent when deleted
+     *
+     * @generated from field: ankka.protocol.v1.Payload event = 2;
+     */
+    event?: Payload | undefined;
+    /**
+     * ce-subject: the source's id; ankka.sequence
+     *
+     * @generated from field: ankka.protocol.v1.Metadata metadata = 3;
+     */
+    metadata?: Metadata | undefined;
+    /**
+     * the current row, if any
+     *
+     * @generated from field: optional ankka.protocol.v1.Payload row = 4;
+     */
+    row?: Payload | undefined;
+    /**
+     * the source was deleted: no event, the row is the process's to keep or drop
+     *
+     * @generated from field: bool deleted = 5;
+     */
+    deleted: boolean;
+};
+/**
+ * Describes the message ankka.protocol.v1.ViewRequest.
+ * Use `create(ViewRequestSchema)` to create a new message.
+ */
+export declare const ViewRequestSchema: GenMessage<ViewRequest>;
+/**
+ * @generated from message ankka.protocol.v1.ViewEffect
+ */
+export type ViewEffect = Message<"ankka.protocol.v1.ViewEffect"> & {
+    /**
+     * @generated from oneof ankka.protocol.v1.ViewEffect.effect
+     */
+    effect: {
+        /**
+         * @generated from field: ankka.protocol.v1.Payload update_row = 1;
+         */
+        value: Payload;
+        case: "updateRow";
+    } | {
+        /**
+         * @generated from field: ankka.protocol.v1.Empty delete_row = 2;
+         */
+        value: Empty;
+        case: "deleteRow";
+    } | {
+        /**
+         * @generated from field: ankka.protocol.v1.Empty ignore = 3;
+         */
+        value: Empty;
+        case: "ignore";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message ankka.protocol.v1.ViewEffect.
+ * Use `create(ViewEffectSchema)` to create a new message.
+ */
+export declare const ViewEffectSchema: GenMessage<ViewEffect>;
+/**
+ * @generated from service ankka.protocol.v1.View
+ */
+export declare const View: GenService<{
+    /**
+     * @generated from rpc ankka.protocol.v1.View.Handle
+     */
+    handle: {
+        methodKind: "unary";
+        input: typeof ViewRequestSchema;
+        output: typeof ViewEffectSchema;
+    };
+}>;

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

@@ -0,0 +1,23 @@
+// @generated by protoc-gen-es v2.15.0 with parameter "target=ts,import_extension=ts,erasable_syntax=true"
+// @generated from file ankka/protocol/v1/view.proto (package ankka.protocol.v1, syntax proto3)
+/* eslint-disable */
+import { fileDesc, messageDesc, serviceDesc } from "@bufbuild/protobuf/codegenv2";
+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]);
+/**
+ * Describes the message ankka.protocol.v1.ViewRequest.
+ * Use `create(ViewRequestSchema)` to create a new message.
+ */
+export const ViewRequestSchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_view, 0);
+/**
+ * Describes the message ankka.protocol.v1.ViewEffect.
+ * Use `create(ViewEffectSchema)` to create a new message.
+ */
+export const ViewEffectSchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_view, 1);
+/**
+ * @generated from service ankka.protocol.v1.View
+ */
+export const View = /*@__PURE__*/ serviceDesc(file_ankka_protocol_v1_view, 0);

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

@@ -0,0 +1,298 @@
+import type { GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
+import type { Error, Failure, Metadata, Outcome, Payload } from "./payload_pb.ts";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ankka/protocol/v1/workflow.proto.
+ */
+export declare const file_ankka_protocol_v1_workflow: GenFile;
+/**
+ * @generated from message ankka.protocol.v1.WorkflowIn
+ */
+export type WorkflowIn = Message<"ankka.protocol.v1.WorkflowIn"> & {
+    /**
+     * @generated from oneof ankka.protocol.v1.WorkflowIn.message
+     */
+    message: {
+        /**
+         * @generated from field: ankka.protocol.v1.WorkflowIn.Init init = 1;
+         */
+        value: WorkflowIn_Init;
+        case: "init";
+    } | {
+        /**
+         * @generated from field: ankka.protocol.v1.WorkflowIn.Command command = 2;
+         */
+        value: WorkflowIn_Command;
+        case: "command";
+    } | {
+        /**
+         * @generated from field: ankka.protocol.v1.WorkflowIn.RunStep run_step = 3;
+         */
+        value: WorkflowIn_RunStep;
+        case: "runStep";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message ankka.protocol.v1.WorkflowIn.
+ * Use `create(WorkflowInSchema)` to create a new message.
+ */
+export declare const WorkflowInSchema: GenMessage<WorkflowIn>;
+/**
+ * @generated from message ankka.protocol.v1.WorkflowIn.Init
+ */
+export type WorkflowIn_Init = Message<"ankka.protocol.v1.WorkflowIn.Init"> & {
+    /**
+     * @generated from field: string component_id = 1;
+     */
+    componentId: string;
+    /**
+     * @generated from field: string entity_id = 2;
+     */
+    entityId: string;
+    /**
+     * @generated from field: optional ankka.protocol.v1.Payload state = 3;
+     */
+    state?: Payload | undefined;
+};
+/**
+ * Describes the message ankka.protocol.v1.WorkflowIn.Init.
+ * Use `create(WorkflowIn_InitSchema)` to create a new message.
+ */
+export declare const WorkflowIn_InitSchema: GenMessage<WorkflowIn_Init>;
+/**
+ * @generated from message ankka.protocol.v1.WorkflowIn.Command
+ */
+export type WorkflowIn_Command = Message<"ankka.protocol.v1.WorkflowIn.Command"> & {
+    /**
+     * @generated from field: int64 id = 1;
+     */
+    id: bigint;
+    /**
+     * @generated from field: string name = 2;
+     */
+    name: string;
+    /**
+     * @generated from field: ankka.protocol.v1.Payload payload = 3;
+     */
+    payload?: Payload | undefined;
+    /**
+     * @generated from field: ankka.protocol.v1.Metadata metadata = 4;
+     */
+    metadata?: Metadata | undefined;
+};
+/**
+ * Describes the message ankka.protocol.v1.WorkflowIn.Command.
+ * Use `create(WorkflowIn_CommandSchema)` to create a new message.
+ */
+export declare const WorkflowIn_CommandSchema: GenMessage<WorkflowIn_Command>;
+/**
+ * @generated from message ankka.protocol.v1.WorkflowIn.RunStep
+ */
+export type WorkflowIn_RunStep = Message<"ankka.protocol.v1.WorkflowIn.RunStep"> & {
+    /**
+     * @generated from field: int64 id = 1;
+     */
+    id: bigint;
+    /**
+     * @generated from field: string step = 2;
+     */
+    step: string;
+    /**
+     * @generated from field: optional ankka.protocol.v1.Payload input = 3;
+     */
+    input?: Payload | undefined;
+};
+/**
+ * Describes the message ankka.protocol.v1.WorkflowIn.RunStep.
+ * Use `create(WorkflowIn_RunStepSchema)` to create a new message.
+ */
+export declare const WorkflowIn_RunStepSchema: GenMessage<WorkflowIn_RunStep>;
+/**
+ * @generated from message ankka.protocol.v1.WorkflowOut
+ */
+export type WorkflowOut = Message<"ankka.protocol.v1.WorkflowOut"> & {
+    /**
+     * @generated from oneof ankka.protocol.v1.WorkflowOut.message
+     */
+    message: {
+        /**
+         * @generated from field: ankka.protocol.v1.WorkflowOut.Reply reply = 1;
+         */
+        value: WorkflowOut_Reply;
+        case: "reply";
+    } | {
+        /**
+         * @generated from field: ankka.protocol.v1.WorkflowOut.StepReply step_reply = 2;
+         */
+        value: WorkflowOut_StepReply;
+        case: "stepReply";
+    } | {
+        /**
+         * @generated from field: ankka.protocol.v1.Failure failure = 3;
+         */
+        value: Failure;
+        case: "failure";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message ankka.protocol.v1.WorkflowOut.
+ * Use `create(WorkflowOutSchema)` to create a new message.
+ */
+export declare const WorkflowOutSchema: GenMessage<WorkflowOut>;
+/**
+ * a command handler's WorkflowEffect
+ *
+ * @generated from message ankka.protocol.v1.WorkflowOut.Reply
+ */
+export type WorkflowOut_Reply = Message<"ankka.protocol.v1.WorkflowOut.Reply"> & {
+    /**
+     * @generated from field: int64 command_id = 1;
+     */
+    commandId: bigint;
+    /**
+     * @generated from field: optional ankka.protocol.v1.Payload new_state = 2;
+     */
+    newState?: Payload | undefined;
+    /**
+     * @generated from field: optional ankka.protocol.v1.StepRef transition = 3;
+     */
+    transition?: StepRef | undefined;
+    /**
+     * @generated from field: ankka.protocol.v1.Outcome outcome = 4;
+     */
+    outcome?: Outcome | undefined;
+};
+/**
+ * Describes the message ankka.protocol.v1.WorkflowOut.Reply.
+ * Use `create(WorkflowOut_ReplySchema)` to create a new message.
+ */
+export declare const WorkflowOut_ReplySchema: GenMessage<WorkflowOut_Reply>;
+/**
+ * a step's WorkflowStepEffect
+ *
+ * @generated from message ankka.protocol.v1.WorkflowOut.StepReply
+ */
+export type WorkflowOut_StepReply = Message<"ankka.protocol.v1.WorkflowOut.StepReply"> & {
+    /**
+     * @generated from field: int64 command_id = 1;
+     */
+    commandId: bigint;
+    /**
+     * @generated from field: optional ankka.protocol.v1.Payload new_state = 2;
+     */
+    newState?: Payload | undefined;
+    /**
+     * @generated from field: ankka.protocol.v1.StepOutcome next = 3;
+     */
+    next?: StepOutcome | undefined;
+};
+/**
+ * Describes the message ankka.protocol.v1.WorkflowOut.StepReply.
+ * Use `create(WorkflowOut_StepReplySchema)` to create a new message.
+ */
+export declare const WorkflowOut_StepReplySchema: GenMessage<WorkflowOut_StepReply>;
+/**
+ * @generated from message ankka.protocol.v1.StepRef
+ */
+export type StepRef = Message<"ankka.protocol.v1.StepRef"> & {
+    /**
+     * @generated from field: string step = 1;
+     */
+    step: string;
+    /**
+     * @generated from field: optional ankka.protocol.v1.Payload input = 2;
+     */
+    input?: Payload | undefined;
+};
+/**
+ * Describes the message ankka.protocol.v1.StepRef.
+ * Use `create(StepRefSchema)` to create a new message.
+ */
+export declare const StepRefSchema: GenMessage<StepRef>;
+/**
+ * @generated from message ankka.protocol.v1.StepOutcome
+ */
+export type StepOutcome = Message<"ankka.protocol.v1.StepOutcome"> & {
+    /**
+     * @generated from oneof ankka.protocol.v1.StepOutcome.outcome
+     */
+    outcome: {
+        /**
+         * @generated from field: ankka.protocol.v1.StepRef transition_to = 1;
+         */
+        value: StepRef;
+        case: "transitionTo";
+    } | {
+        /**
+         * @generated from field: ankka.protocol.v1.StepOutcome.Pause pause = 2;
+         */
+        value: StepOutcome_Pause;
+        case: "pause";
+    } | {
+        /**
+         * @generated from field: ankka.protocol.v1.StepOutcome.End end = 3;
+         */
+        value: StepOutcome_End;
+        case: "end";
+    } | {
+        /**
+         * @generated from field: ankka.protocol.v1.Error fail = 4;
+         */
+        value: Error;
+        case: "fail";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message ankka.protocol.v1.StepOutcome.
+ * Use `create(StepOutcomeSchema)` to create a new message.
+ */
+export declare const StepOutcomeSchema: GenMessage<StepOutcome>;
+/**
+ * @generated from message ankka.protocol.v1.StepOutcome.Pause
+ */
+export type StepOutcome_Pause = Message<"ankka.protocol.v1.StepOutcome.Pause"> & {
+    /**
+     * @generated from field: optional int64 after_millis = 1;
+     */
+    afterMillis?: bigint | undefined;
+    /**
+     * @generated from field: optional ankka.protocol.v1.StepRef on_timeout = 2;
+     */
+    onTimeout?: StepRef | undefined;
+};
+/**
+ * Describes the message ankka.protocol.v1.StepOutcome.Pause.
+ * Use `create(StepOutcome_PauseSchema)` to create a new message.
+ */
+export declare const StepOutcome_PauseSchema: GenMessage<StepOutcome_Pause>;
+/**
+ * @generated from message ankka.protocol.v1.StepOutcome.End
+ */
+export type StepOutcome_End = Message<"ankka.protocol.v1.StepOutcome.End"> & {};
+/**
+ * Describes the message ankka.protocol.v1.StepOutcome.End.
+ * Use `create(StepOutcome_EndSchema)` to create a new message.
+ */
+export declare const StepOutcome_EndSchema: GenMessage<StepOutcome_End>;
+/**
+ * @generated from service ankka.protocol.v1.Workflow
+ */
+export declare const Workflow: GenService<{
+    /**
+     * @generated from rpc ankka.protocol.v1.Workflow.Handle
+     */
+    handle: {
+        methodKind: "bidi_streaming";
+        input: typeof WorkflowInSchema;
+        output: typeof WorkflowOutSchema;
+    };
+}>;

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

@@ -0,0 +1,67 @@
+// One bidirectional stream per loaded workflow instance. Commands and steps share it; the sidecar's
+// engine journals every transition and runs a step only after its transition is journaled.
+import { fileDesc, messageDesc, serviceDesc } from "@bufbuild/protobuf/codegenv2";
+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]);
+/**
+ * Describes the message ankka.protocol.v1.WorkflowIn.
+ * Use `create(WorkflowInSchema)` to create a new message.
+ */
+export const WorkflowInSchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_workflow, 0);
+/**
+ * Describes the message ankka.protocol.v1.WorkflowIn.Init.
+ * Use `create(WorkflowIn_InitSchema)` to create a new message.
+ */
+export const WorkflowIn_InitSchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_workflow, 0, 0);
+/**
+ * Describes the message ankka.protocol.v1.WorkflowIn.Command.
+ * Use `create(WorkflowIn_CommandSchema)` to create a new message.
+ */
+export const WorkflowIn_CommandSchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_workflow, 0, 1);
+/**
+ * Describes the message ankka.protocol.v1.WorkflowIn.RunStep.
+ * Use `create(WorkflowIn_RunStepSchema)` to create a new message.
+ */
+export const WorkflowIn_RunStepSchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_workflow, 0, 2);
+/**
+ * Describes the message ankka.protocol.v1.WorkflowOut.
+ * Use `create(WorkflowOutSchema)` to create a new message.
+ */
+export const WorkflowOutSchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_workflow, 1);
+/**
+ * Describes the message ankka.protocol.v1.WorkflowOut.Reply.
+ * Use `create(WorkflowOut_ReplySchema)` to create a new message.
+ */
+export const WorkflowOut_ReplySchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_workflow, 1, 0);
+/**
+ * Describes the message ankka.protocol.v1.WorkflowOut.StepReply.
+ * Use `create(WorkflowOut_StepReplySchema)` to create a new message.
+ */
+export const WorkflowOut_StepReplySchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_workflow, 1, 1);
+/**
+ * Describes the message ankka.protocol.v1.StepRef.
+ * Use `create(StepRefSchema)` to create a new message.
+ */
+export const StepRefSchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_workflow, 2);
+/**
+ * Describes the message ankka.protocol.v1.StepOutcome.
+ * Use `create(StepOutcomeSchema)` to create a new message.
+ */
+export const StepOutcomeSchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_workflow, 3);
+/**
+ * Describes the message ankka.protocol.v1.StepOutcome.Pause.
+ * Use `create(StepOutcome_PauseSchema)` to create a new message.
+ */
+export const StepOutcome_PauseSchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_workflow, 3, 0);
+/**
+ * Describes the message ankka.protocol.v1.StepOutcome.End.
+ * Use `create(StepOutcome_EndSchema)` to create a new message.
+ */
+export const StepOutcome_EndSchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_workflow, 3, 1);
+/**
+ * @generated from service ankka.protocol.v1.Workflow
+ */
+export const Workflow = /*@__PURE__*/ serviceDesc(file_ankka_protocol_v1_workflow, 0);

package/dist/agent.d.ts

@@ -0,0 +1,27 @@
+import type { Metadata } from "./effects/common.ts";
+import type { ComponentClient } from "./client.ts";
+import type { GuardrailRef, HandlerTable, ToolRef } from "./handlers.ts";
+import { AgentEffects } from "./effects/agent.ts";
+export declare abstract class Agent {
+    #private;
+    readonly effects: AgentEffects;
+    /** The session this request belongs to. Captured when the plan is made; tools run after the handler has returned. */
+    get sessionId(): string;
+    get metadata(): Metadata;
+    get client(): ComponentClient;
+    /** @internal */
+    get _kind(): "agent";
+    /** @internal */
+    _bind(sessionId: string, metadata: Metadata, client: ComponentClient): void;
+}
+export interface AgentClass<C extends Agent = Agent> {
+    new (): C;
+    readonly componentId: string;
+    /** A description of the agent, for the console and the model's system context. */
+    readonly role?: string;
+    /** How many tool calls one turn may make; 100 by default. */
+    readonly maxToolCallSteps?: number;
+    readonly tools?: Readonly<Record<string, ToolRef<C, any>>>;
+    readonly guardrails?: Readonly<Record<string, GuardrailRef>>;
+    readonly handlers: HandlerTable<C>;
+}

package/dist/agent.js

@@ -0,0 +1,36 @@
+// An agent: this process declares the instructions, the tools and the guardrails; the sidecar runs the
+// loop — the model call, tool dispatch, session memory, compaction and token accounting. The process
+// is asked to plan an interaction, to run a tool and to check a guardrail, and nothing else.
+//
+//   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 { AgentEffects } from "./effects/agent.js";
+export class Agent {
+    effects = new AgentEffects();
+    #sessionId = "";
+    #metadata = {};
+    #client;
+    /** The session this request belongs to. Captured when the plan is made; tools run after the handler has returned. */
+    get sessionId() {
+        return this.#sessionId;
+    }
+    get metadata() {
+        return this.#metadata;
+    }
+    get client() {
+        if (!this.#client)
+            throw new Error("client is only available inside a handler, a tool or a guardrail");
+        return this.#client;
+    }
+    /** @internal */
+    get _kind() {
+        return "agent";
+    }
+    /** @internal */
+    _bind(sessionId, metadata, client) {
+        this.#sessionId = sessionId;
+        this.#metadata = metadata;
+        this.#client = client;
+    }
+}