@cellaflow/sdk 0.7.0

package/dist/cellaflow/v1/internal_pb.d.ts

@@ -0,0 +1,201 @@
+import type { BinaryReadOptions, FieldList, JsonReadOptions, JsonValue, PartialMessage, PlainMessage } from "@bufbuild/protobuf";
+import { Message, proto3 } from "@bufbuild/protobuf";
+import { StepResult } from "./common_pb.js";
+/**
+ * Internal storage record persisted in RocksDB's idempotency_cache Column Family.
+ * Not exposed via gRPC — used only for serialization/deserialization within the engine.
+ *
+ * @generated from message cellaflow.v1.internal.CacheRecord
+ */
+export declare class CacheRecord extends Message<CacheRecord> {
+    /**
+     * @generated from oneof cellaflow.v1.internal.CacheRecord.record
+     */
+    record: {
+        /**
+         * @generated from field: cellaflow.v1.internal.LeaseRecord leased = 1;
+         */
+        value: LeaseRecord;
+        case: "leased";
+    } | {
+        /**
+         * @generated from field: cellaflow.v1.internal.CompletedRecord completed = 2;
+         */
+        value: CompletedRecord;
+        case: "completed";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+    constructor(data?: PartialMessage<CacheRecord>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "cellaflow.v1.internal.CacheRecord";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): CacheRecord;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): CacheRecord;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): CacheRecord;
+    static equals(a: CacheRecord | PlainMessage<CacheRecord> | undefined, b: CacheRecord | PlainMessage<CacheRecord> | undefined): boolean;
+}
+/**
+ * Represents an active lease held by a worker executing a tool.
+ *
+ * @generated from message cellaflow.v1.internal.LeaseRecord
+ */
+export declare class LeaseRecord extends Message<LeaseRecord> {
+    /**
+     * Global monotonic microsecond epoch timestamp
+     *
+     * @generated from field: uint64 fencing_token = 1;
+     */
+    fencingToken: bigint;
+    /**
+     * Opaque per-attempt identifier for observability
+     *
+     * @generated from field: string holder_id = 2;
+     */
+    holderId: string;
+    /**
+     * When the lease was acquired (epoch ms)
+     *
+     * @generated from field: uint64 acquired_at_ms = 3;
+     */
+    acquiredAtMs: bigint;
+    /**
+     * When the lease expires if not renewed (epoch ms)
+     *
+     * @generated from field: uint64 expires_at_ms = 4;
+     */
+    expiresAtMs: bigint;
+    /**
+     * the graph position this lease claimed, if the caller declared one.
+     *
+     * Carried on the lease rather than passed to release_lease / commit_result so
+     * that clearing the claim is a consequence of releasing the lease rather than
+     * a parameter a caller could get wrong or forget. It also makes "claim and
+     * lease lifetimes are equal" true by construction: the coordinates cannot
+     * outlive the record holding them.
+     *
+     * Empty on a lease acquired without a declared position — nothing to clear.
+     *
+     * @generated from field: string claimed_session_id = 5;
+     */
+    claimedSessionId: string;
+    /**
+     * @generated from field: uint64 claimed_sequence = 6;
+     */
+    claimedSequence: bigint;
+    /**
+     * The wall-clock ceiling on this lease, independent of renewals. Past it the
+     * lease is reclaimable however recently it was renewed, which bounds how long a
+     * holder can hold a position.
+     *
+     * Computed once at acquisition. A value of 0 means no ceiling.
+     *
+     * @generated from field: uint64 hard_expires_at_ms = 7;
+     */
+    hardExpiresAtMs: bigint;
+    constructor(data?: PartialMessage<LeaseRecord>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "cellaflow.v1.internal.LeaseRecord";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): LeaseRecord;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): LeaseRecord;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): LeaseRecord;
+    static equals(a: LeaseRecord | PlainMessage<LeaseRecord> | undefined, b: LeaseRecord | PlainMessage<LeaseRecord> | undefined): boolean;
+}
+/**
+ * Records which idempotency key currently owns a graph position.
+ *
+ * Stored in its own `sequence_claims` column family, keyed by
+ * `<session_id>:<sequence padded to 20>`. Session ids are validated to contain no
+ * colons, so the key parses unambiguously.
+ *
+ * @generated from message cellaflow.v1.internal.SequenceClaimRecord
+ */
+export declare class SequenceClaimRecord extends Message<SequenceClaimRecord> {
+    /**
+     * Who owns the position
+     *
+     * @generated from field: string idempotency_key = 1;
+     */
+    idempotencyKey: string;
+    /**
+     * The lease that created this claim
+     *
+     * @generated from field: uint64 fencing_token = 2;
+     */
+    fencingToken: bigint;
+    /**
+     * Opaque per-attempt id, for diagnostics
+     *
+     * @generated from field: string holder_id = 3;
+     */
+    holderId: string;
+    /**
+     * Advisory: the lease's expiry when this claim was written. Renewal extends the
+     * lease without rewriting the claim, so liveness is read from the owning lease
+     * record. Kept for diagnostics and for the refusal message.
+     *
+     * @generated from field: uint64 expires_at_ms = 4;
+     */
+    expiresAtMs: bigint;
+    constructor(data?: PartialMessage<SequenceClaimRecord>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "cellaflow.v1.internal.SequenceClaimRecord";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): SequenceClaimRecord;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): SequenceClaimRecord;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): SequenceClaimRecord;
+    static equals(a: SequenceClaimRecord | PlainMessage<SequenceClaimRecord> | undefined, b: SequenceClaimRecord | PlainMessage<SequenceClaimRecord> | undefined): boolean;
+}
+/**
+ * Represents a completed tool execution result cached for idempotency.
+ *
+ * @generated from message cellaflow.v1.internal.CompletedRecord
+ */
+export declare class CompletedRecord extends Message<CompletedRecord> {
+    /**
+     * @generated from field: cellaflow.v1.StepResult result = 1;
+     */
+    result?: StepResult;
+    /**
+     * When the result was committed (epoch ms)
+     *
+     * @generated from field: uint64 completed_at_ms = 2;
+     */
+    completedAtMs: bigint;
+    /**
+     * The fencing token held by the worker that committed this result.
+     *
+     * Without it, once a key transitions to Completed the token that completed it
+     * was discarded, so a later caller's token had nothing to be validated against
+     * and a superseded worker received a success response. Records written before
+     * this field existed decode as 0, which is treated as "unknown, skip
+     * validation" — tokens are monotonic epoch-microsecond values and are never
+     * legitimately 0.
+     *
+     * @generated from field: uint64 fencing_token = 3;
+     */
+    fencingToken: bigint;
+    /**
+     * The graph sequence this result was journaled at.
+     *
+     * An AlreadyCommitted outcome only implies a durable event exists at *that*
+     * sequence. A caller committing the same key at a different position has no
+     * event backing it, so letting the actor advance its sequence would leave
+     * in-memory state ahead of the durable log. Same reasoning as the field above:
+     * 0 means a legacy record with no recorded sequence.
+     *
+     * @generated from field: uint64 committed_sequence = 4;
+     */
+    committedSequence: bigint;
+    constructor(data?: PartialMessage<CompletedRecord>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "cellaflow.v1.internal.CompletedRecord";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): CompletedRecord;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): CompletedRecord;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): CompletedRecord;
+    static equals(a: CompletedRecord | PlainMessage<CompletedRecord> | undefined, b: CompletedRecord | PlainMessage<CompletedRecord> | undefined): boolean;
+}
+//# sourceMappingURL=internal_pb.d.ts.map

package/dist/cellaflow/v1/internal_pb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal_pb.d.ts","sourceRoot":"","sources":["../../../src/cellaflow/v1/internal_pb.ts"],"names":[],"mappings":"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"}

package/dist/cellaflow/v1/internal_pb.js

@@ -0,0 +1,254 @@
+// @generated by protoc-gen-es v1.10.1 with parameter "target=ts,import_extension=.js"
+// @generated from file cellaflow/v1/internal.proto (package cellaflow.v1.internal, syntax proto3)
+/* eslint-disable */
+// @ts-nocheck
+import { Message, proto3, protoInt64 } from "@bufbuild/protobuf";
+import { StepResult } from "./common_pb.js";
+/**
+ * Internal storage record persisted in RocksDB's idempotency_cache Column Family.
+ * Not exposed via gRPC — used only for serialization/deserialization within the engine.
+ *
+ * @generated from message cellaflow.v1.internal.CacheRecord
+ */
+export class CacheRecord extends Message {
+    /**
+     * @generated from oneof cellaflow.v1.internal.CacheRecord.record
+     */
+    record = { case: undefined };
+    constructor(data) {
+        super();
+        proto3.util.initPartial(data, this);
+    }
+    static runtime = proto3;
+    static typeName = "cellaflow.v1.internal.CacheRecord";
+    static fields = proto3.util.newFieldList(() => [
+        { no: 1, name: "leased", kind: "message", T: LeaseRecord, oneof: "record" },
+        { no: 2, name: "completed", kind: "message", T: CompletedRecord, oneof: "record" },
+    ]);
+    static fromBinary(bytes, options) {
+        return new CacheRecord().fromBinary(bytes, options);
+    }
+    static fromJson(jsonValue, options) {
+        return new CacheRecord().fromJson(jsonValue, options);
+    }
+    static fromJsonString(jsonString, options) {
+        return new CacheRecord().fromJsonString(jsonString, options);
+    }
+    static equals(a, b) {
+        return proto3.util.equals(CacheRecord, a, b);
+    }
+}
+/**
+ * Represents an active lease held by a worker executing a tool.
+ *
+ * @generated from message cellaflow.v1.internal.LeaseRecord
+ */
+export class LeaseRecord extends Message {
+    /**
+     * Global monotonic microsecond epoch timestamp
+     *
+     * @generated from field: uint64 fencing_token = 1;
+     */
+    fencingToken = protoInt64.zero;
+    /**
+     * Opaque per-attempt identifier for observability
+     *
+     * @generated from field: string holder_id = 2;
+     */
+    holderId = "";
+    /**
+     * When the lease was acquired (epoch ms)
+     *
+     * @generated from field: uint64 acquired_at_ms = 3;
+     */
+    acquiredAtMs = protoInt64.zero;
+    /**
+     * When the lease expires if not renewed (epoch ms)
+     *
+     * @generated from field: uint64 expires_at_ms = 4;
+     */
+    expiresAtMs = protoInt64.zero;
+    /**
+     * the graph position this lease claimed, if the caller declared one.
+     *
+     * Carried on the lease rather than passed to release_lease / commit_result so
+     * that clearing the claim is a consequence of releasing the lease rather than
+     * a parameter a caller could get wrong or forget. It also makes "claim and
+     * lease lifetimes are equal" true by construction: the coordinates cannot
+     * outlive the record holding them.
+     *
+     * Empty on a lease acquired without a declared position — nothing to clear.
+     *
+     * @generated from field: string claimed_session_id = 5;
+     */
+    claimedSessionId = "";
+    /**
+     * @generated from field: uint64 claimed_sequence = 6;
+     */
+    claimedSequence = protoInt64.zero;
+    /**
+     * The wall-clock ceiling on this lease, independent of renewals. Past it the
+     * lease is reclaimable however recently it was renewed, which bounds how long a
+     * holder can hold a position.
+     *
+     * Computed once at acquisition. A value of 0 means no ceiling.
+     *
+     * @generated from field: uint64 hard_expires_at_ms = 7;
+     */
+    hardExpiresAtMs = protoInt64.zero;
+    constructor(data) {
+        super();
+        proto3.util.initPartial(data, this);
+    }
+    static runtime = proto3;
+    static typeName = "cellaflow.v1.internal.LeaseRecord";
+    static fields = proto3.util.newFieldList(() => [
+        { no: 1, name: "fencing_token", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
+        { no: 2, name: "holder_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+        { no: 3, name: "acquired_at_ms", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
+        { no: 4, name: "expires_at_ms", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
+        { no: 5, name: "claimed_session_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+        { no: 6, name: "claimed_sequence", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
+        { no: 7, name: "hard_expires_at_ms", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
+    ]);
+    static fromBinary(bytes, options) {
+        return new LeaseRecord().fromBinary(bytes, options);
+    }
+    static fromJson(jsonValue, options) {
+        return new LeaseRecord().fromJson(jsonValue, options);
+    }
+    static fromJsonString(jsonString, options) {
+        return new LeaseRecord().fromJsonString(jsonString, options);
+    }
+    static equals(a, b) {
+        return proto3.util.equals(LeaseRecord, a, b);
+    }
+}
+/**
+ * Records which idempotency key currently owns a graph position.
+ *
+ * Stored in its own `sequence_claims` column family, keyed by
+ * `<session_id>:<sequence padded to 20>`. Session ids are validated to contain no
+ * colons, so the key parses unambiguously.
+ *
+ * @generated from message cellaflow.v1.internal.SequenceClaimRecord
+ */
+export class SequenceClaimRecord extends Message {
+    /**
+     * Who owns the position
+     *
+     * @generated from field: string idempotency_key = 1;
+     */
+    idempotencyKey = "";
+    /**
+     * The lease that created this claim
+     *
+     * @generated from field: uint64 fencing_token = 2;
+     */
+    fencingToken = protoInt64.zero;
+    /**
+     * Opaque per-attempt id, for diagnostics
+     *
+     * @generated from field: string holder_id = 3;
+     */
+    holderId = "";
+    /**
+     * Advisory: the lease's expiry when this claim was written. Renewal extends the
+     * lease without rewriting the claim, so liveness is read from the owning lease
+     * record. Kept for diagnostics and for the refusal message.
+     *
+     * @generated from field: uint64 expires_at_ms = 4;
+     */
+    expiresAtMs = protoInt64.zero;
+    constructor(data) {
+        super();
+        proto3.util.initPartial(data, this);
+    }
+    static runtime = proto3;
+    static typeName = "cellaflow.v1.internal.SequenceClaimRecord";
+    static fields = proto3.util.newFieldList(() => [
+        { no: 1, name: "idempotency_key", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+        { no: 2, name: "fencing_token", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
+        { no: 3, name: "holder_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+        { no: 4, name: "expires_at_ms", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
+    ]);
+    static fromBinary(bytes, options) {
+        return new SequenceClaimRecord().fromBinary(bytes, options);
+    }
+    static fromJson(jsonValue, options) {
+        return new SequenceClaimRecord().fromJson(jsonValue, options);
+    }
+    static fromJsonString(jsonString, options) {
+        return new SequenceClaimRecord().fromJsonString(jsonString, options);
+    }
+    static equals(a, b) {
+        return proto3.util.equals(SequenceClaimRecord, a, b);
+    }
+}
+/**
+ * Represents a completed tool execution result cached for idempotency.
+ *
+ * @generated from message cellaflow.v1.internal.CompletedRecord
+ */
+export class CompletedRecord extends Message {
+    /**
+     * @generated from field: cellaflow.v1.StepResult result = 1;
+     */
+    result;
+    /**
+     * When the result was committed (epoch ms)
+     *
+     * @generated from field: uint64 completed_at_ms = 2;
+     */
+    completedAtMs = protoInt64.zero;
+    /**
+     * The fencing token held by the worker that committed this result.
+     *
+     * Without it, once a key transitions to Completed the token that completed it
+     * was discarded, so a later caller's token had nothing to be validated against
+     * and a superseded worker received a success response. Records written before
+     * this field existed decode as 0, which is treated as "unknown, skip
+     * validation" — tokens are monotonic epoch-microsecond values and are never
+     * legitimately 0.
+     *
+     * @generated from field: uint64 fencing_token = 3;
+     */
+    fencingToken = protoInt64.zero;
+    /**
+     * The graph sequence this result was journaled at.
+     *
+     * An AlreadyCommitted outcome only implies a durable event exists at *that*
+     * sequence. A caller committing the same key at a different position has no
+     * event backing it, so letting the actor advance its sequence would leave
+     * in-memory state ahead of the durable log. Same reasoning as the field above:
+     * 0 means a legacy record with no recorded sequence.
+     *
+     * @generated from field: uint64 committed_sequence = 4;
+     */
+    committedSequence = protoInt64.zero;
+    constructor(data) {
+        super();
+        proto3.util.initPartial(data, this);
+    }
+    static runtime = proto3;
+    static typeName = "cellaflow.v1.internal.CompletedRecord";
+    static fields = proto3.util.newFieldList(() => [
+        { no: 1, name: "result", kind: "message", T: StepResult },
+        { no: 2, name: "completed_at_ms", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
+        { no: 3, name: "fencing_token", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
+        { no: 4, name: "committed_sequence", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
+    ]);
+    static fromBinary(bytes, options) {
+        return new CompletedRecord().fromBinary(bytes, options);
+    }
+    static fromJson(jsonValue, options) {
+        return new CompletedRecord().fromJson(jsonValue, options);
+    }
+    static fromJsonString(jsonString, options) {
+        return new CompletedRecord().fromJsonString(jsonString, options);
+    }
+    static equals(a, b) {
+        return proto3.util.equals(CompletedRecord, a, b);
+    }
+}
+//# sourceMappingURL=internal_pb.js.map

package/dist/cellaflow/v1/internal_pb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal_pb.js","sourceRoot":"","sources":["../../../src/cellaflow/v1/internal_pb.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,kGAAkG;AAClG,oBAAoB;AACpB,cAAc;AAGd,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,OAAO,WAAY,SAAQ,OAAoB;IACnD;;OAEG;IACH,MAAM,GAYuC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAEjE,YAAY,IAAkC;QAC5C,KAAK,EAAE,CAAC;QACR,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,CAAU,OAAO,GAAkB,MAAM,CAAC;IAChD,MAAM,CAAU,QAAQ,GAAG,mCAAmC,CAAC;IAC/D,MAAM,CAAU,MAAM,GAAc,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC;QACjE,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE;QAC3E,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAE;KACnF,CAAC,CAAC;IAEH,MAAM,CAAC,UAAU,CAAC,KAAiB,EAAE,OAAoC;QACvE,OAAO,IAAI,WAAW,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,SAAoB,EAAE,OAAkC;QACtE,OAAO,IAAI,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,UAAkB,EAAE,OAAkC;QAC1E,OAAO,IAAI,WAAW,EAAE,CAAC,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,CAAsD,EAAE,CAAsD;QAC1H,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/C,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,WAAY,SAAQ,OAAoB;IACnD;;;;OAIG;IACH,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC;IAE/B;;;;OAIG;IACH,QAAQ,GAAG,EAAE,CAAC;IAEd;;;;OAIG;IACH,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC;IAE/B;;;;OAIG;IACH,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC;IAE9B;;;;;;;;;;;;OAYG;IACH,gBAAgB,GAAG,EAAE,CAAC;IAEtB;;OAEG;IACH,eAAe,GAAG,UAAU,CAAC,IAAI,CAAC;IAElC;;;;;;;;OAQG;IACH,eAAe,GAAG,UAAU,CAAC,IAAI,CAAC;IAElC,YAAY,IAAkC;QAC5C,KAAK,EAAE,CAAC;QACR,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,CAAU,OAAO,GAAkB,MAAM,CAAC;IAChD,MAAM,CAAU,QAAQ,GAAG,mCAAmC,CAAC;IAC/D,MAAM,CAAU,MAAM,GAAc,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC;QACjE,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,uBAAuB,EAAE;QAC9E,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,uBAAuB,EAAE;QAC1E,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,uBAAuB,EAAE;QAC/E,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,uBAAuB,EAAE;QAC9E,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,uBAAuB,EAAE;QACnF,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,uBAAuB,EAAE;QACjF,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,uBAAuB,EAAE;KACpF,CAAC,CAAC;IAEH,MAAM,CAAC,UAAU,CAAC,KAAiB,EAAE,OAAoC;QACvE,OAAO,IAAI,WAAW,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,SAAoB,EAAE,OAAkC;QACtE,OAAO,IAAI,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,UAAkB,EAAE,OAAkC;QAC1E,OAAO,IAAI,WAAW,EAAE,CAAC,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,CAAsD,EAAE,CAAsD;QAC1H,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/C,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,mBAAoB,SAAQ,OAA4B;IACnE;;;;OAIG;IACH,cAAc,GAAG,EAAE,CAAC;IAEpB;;;;OAIG;IACH,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC;IAE/B;;;;OAIG;IACH,QAAQ,GAAG,EAAE,CAAC;IAEd;;;;;;OAMG;IACH,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC;IAE9B,YAAY,IAA0C;QACpD,KAAK,EAAE,CAAC;QACR,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,CAAU,OAAO,GAAkB,MAAM,CAAC;IAChD,MAAM,CAAU,QAAQ,GAAG,2CAA2C,CAAC;IACvE,MAAM,CAAU,MAAM,GAAc,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC;QACjE,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,uBAAuB,EAAE;QAChF,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,uBAAuB,EAAE;QAC9E,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,uBAAuB,EAAE;QAC1E,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,uBAAuB,EAAE;KAC/E,CAAC,CAAC;IAEH,MAAM,CAAC,UAAU,CAAC,KAAiB,EAAE,OAAoC;QACvE,OAAO,IAAI,mBAAmB,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,SAAoB,EAAE,OAAkC;QACtE,OAAO,IAAI,mBAAmB,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,UAAkB,EAAE,OAAkC;QAC1E,OAAO,IAAI,mBAAmB,EAAE,CAAC,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,CAAsE,EAAE,CAAsE;QAC1J,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACvD,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,eAAgB,SAAQ,OAAwB;IAC3D;;OAEG;IACH,MAAM,CAAc;IAEpB;;;;OAIG;IACH,aAAa,GAAG,UAAU,CAAC,IAAI,CAAC;IAEhC;;;;;;;;;;;OAWG;IACH,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC;IAE/B;;;;;;;;;;OAUG;IACH,iBAAiB,GAAG,UAAU,CAAC,IAAI,CAAC;IAEpC,YAAY,IAAsC;QAChD,KAAK,EAAE,CAAC;QACR,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,CAAU,OAAO,GAAkB,MAAM,CAAC;IAChD,MAAM,CAAU,QAAQ,GAAG,uCAAuC,CAAC;IACnE,MAAM,CAAU,MAAM,GAAc,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC;QACjE,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE;QACzD,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,uBAAuB,EAAE;QAChF,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,uBAAuB,EAAE;QAC9E,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,uBAAuB,EAAE;KACpF,CAAC,CAAC;IAEH,MAAM,CAAC,UAAU,CAAC,KAAiB,EAAE,OAAoC;QACvE,OAAO,IAAI,eAAe,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,SAAoB,EAAE,OAAkC;QACtE,OAAO,IAAI,eAAe,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,UAAkB,EAAE,OAAkC;QAC1E,OAAO,IAAI,eAAe,EAAE,CAAC,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,CAA8D,EAAE,CAA8D;QAC1I,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/cellaflow/v1/service_connect.d.ts

@@ -0,0 +1,84 @@
+import { CommitStepRequest, CommitStepResponse, GetGraphRequest, GetGraphResponse, StartSessionRequest, StartSessionResponse } from "./service_pb.js";
+import { MethodKind } from "@bufbuild/protobuf";
+import { CheckCacheRequest, CheckCacheResponse, ReleaseLeaseRequest, ReleaseLeaseResponse, RenewLeaseRequest, RenewLeaseResponse } from "./idempotency_pb.js";
+/**
+ * @generated from service cellaflow.v1.WorkflowEngineService
+ */
+export declare const WorkflowEngineService: {
+    readonly typeName: "cellaflow.v1.WorkflowEngineService";
+    readonly methods: {
+        /**
+         * Starts a new workflow execution session.
+         * Concurrency Guard: If the client proposes a custom `session_id` inside StartSessionRequest,
+         * the engine MUST perform transactional check-and-insert to prevent concurrent race conditions
+         * that would result in double-initialization or state overwriting.
+         *
+         * @generated from rpc cellaflow.v1.WorkflowEngineService.StartSession
+         */
+        readonly startSession: {
+            readonly name: "StartSession";
+            readonly I: typeof StartSessionRequest;
+            readonly O: typeof StartSessionResponse;
+            readonly kind: MethodKind.Unary;
+        };
+        /**
+         * Commits the result of an execution step (Cognitive Graph event).
+         * Ordering Guard: The engine MUST validate that `step_result.sequence` matches the expected
+         * next sequence number (i.e. expected = current_sequence + 1).
+         * Concurrency Guard: The write transaction MUST perform an optimistic concurrency check
+         * comparing expected vs actual current sequence to fail gracefully in case of race conditions.
+         *
+         * @generated from rpc cellaflow.v1.WorkflowEngineService.CommitStep
+         */
+        readonly commitStep: {
+            readonly name: "CommitStep";
+            readonly I: typeof CommitStepRequest;
+            readonly O: typeof CommitStepResponse;
+            readonly kind: MethodKind.Unary;
+        };
+        /**
+         * Retrieves the Cognitive Graph history (sequence of steps) for a session.
+         * Pagination Guard: GetGraphResponse is paginated. The implementation must enforce a default
+         * pagination limit (e.g. 100) and a maximum pagination limit (e.g. 1000) to prevent OOM errors
+         * on large graph histories.
+         *
+         * @generated from rpc cellaflow.v1.WorkflowEngineService.GetGraph
+         */
+        readonly getGraph: {
+            readonly name: "GetGraph";
+            readonly I: typeof GetGraphRequest;
+            readonly O: typeof GetGraphResponse;
+            readonly kind: MethodKind.Unary;
+        };
+        /**
+         * Idempotency cache RPCs
+         *
+         * @generated from rpc cellaflow.v1.WorkflowEngineService.CheckIdempotencyCache
+         */
+        readonly checkIdempotencyCache: {
+            readonly name: "CheckIdempotencyCache";
+            readonly I: typeof CheckCacheRequest;
+            readonly O: typeof CheckCacheResponse;
+            readonly kind: MethodKind.Unary;
+        };
+        /**
+         * @generated from rpc cellaflow.v1.WorkflowEngineService.RenewLease
+         */
+        readonly renewLease: {
+            readonly name: "RenewLease";
+            readonly I: typeof RenewLeaseRequest;
+            readonly O: typeof RenewLeaseResponse;
+            readonly kind: MethodKind.Unary;
+        };
+        /**
+         * @generated from rpc cellaflow.v1.WorkflowEngineService.ReleaseLease
+         */
+        readonly releaseLease: {
+            readonly name: "ReleaseLease";
+            readonly I: typeof ReleaseLeaseRequest;
+            readonly O: typeof ReleaseLeaseResponse;
+            readonly kind: MethodKind.Unary;
+        };
+    };
+};
+//# sourceMappingURL=service_connect.d.ts.map

package/dist/cellaflow/v1/service_connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service_connect.d.ts","sourceRoot":"","sources":["../../../src/cellaflow/v1/service_connect.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,eAAe,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACtJ,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9J;;GAEG;AACH,eAAO,MAAM,qBAAqB;aAChC,QAAQ,EAAE,oCAAoC;aAC9C,OAAO;QACL;;;;;;;WAOG;iBACH,YAAY;qBACV,IAAI,EAAE,cAAc;qBACpB,CAAC;qBACD,CAAC;qBACD,IAAI;;QAEN;;;;;;;;WAQG;iBACH,UAAU;qBACR,IAAI,EAAE,YAAY;qBAClB,CAAC;qBACD,CAAC;qBACD,IAAI;;QAEN;;;;;;;WAOG;iBACH,QAAQ;qBACN,IAAI,EAAE,UAAU;qBAChB,CAAC;qBACD,CAAC;qBACD,IAAI;;QAEN;;;;WAIG;iBACH,qBAAqB;qBACnB,IAAI,EAAE,uBAAuB;qBAC7B,CAAC;qBACD,CAAC;qBACD,IAAI;;QAEN;;WAEG;iBACH,UAAU;qBACR,IAAI,EAAE,YAAY;qBAClB,CAAC;qBACD,CAAC;qBACD,IAAI;;QAEN;;WAEG;iBACH,YAAY;qBACV,IAAI,EAAE,cAAc;qBACpB,CAAC;qBACD,CAAC;qBACD,IAAI;;;CAGA,CAAC"}

package/dist/cellaflow/v1/service_connect.js

@@ -0,0 +1,88 @@
+// @generated by protoc-gen-connect-es v1.7.0 with parameter "target=ts,import_extension=.js"
+// @generated from file cellaflow/v1/service.proto (package cellaflow.v1, syntax proto3)
+/* eslint-disable */
+// @ts-nocheck
+import { CommitStepRequest, CommitStepResponse, GetGraphRequest, GetGraphResponse, StartSessionRequest, StartSessionResponse } from "./service_pb.js";
+import { MethodKind } from "@bufbuild/protobuf";
+import { CheckCacheRequest, CheckCacheResponse, ReleaseLeaseRequest, ReleaseLeaseResponse, RenewLeaseRequest, RenewLeaseResponse } from "./idempotency_pb.js";
+/**
+ * @generated from service cellaflow.v1.WorkflowEngineService
+ */
+export const WorkflowEngineService = {
+    typeName: "cellaflow.v1.WorkflowEngineService",
+    methods: {
+        /**
+         * Starts a new workflow execution session.
+         * Concurrency Guard: If the client proposes a custom `session_id` inside StartSessionRequest,
+         * the engine MUST perform transactional check-and-insert to prevent concurrent race conditions
+         * that would result in double-initialization or state overwriting.
+         *
+         * @generated from rpc cellaflow.v1.WorkflowEngineService.StartSession
+         */
+        startSession: {
+            name: "StartSession",
+            I: StartSessionRequest,
+            O: StartSessionResponse,
+            kind: MethodKind.Unary,
+        },
+        /**
+         * Commits the result of an execution step (Cognitive Graph event).
+         * Ordering Guard: The engine MUST validate that `step_result.sequence` matches the expected
+         * next sequence number (i.e. expected = current_sequence + 1).
+         * Concurrency Guard: The write transaction MUST perform an optimistic concurrency check
+         * comparing expected vs actual current sequence to fail gracefully in case of race conditions.
+         *
+         * @generated from rpc cellaflow.v1.WorkflowEngineService.CommitStep
+         */
+        commitStep: {
+            name: "CommitStep",
+            I: CommitStepRequest,
+            O: CommitStepResponse,
+            kind: MethodKind.Unary,
+        },
+        /**
+         * Retrieves the Cognitive Graph history (sequence of steps) for a session.
+         * Pagination Guard: GetGraphResponse is paginated. The implementation must enforce a default
+         * pagination limit (e.g. 100) and a maximum pagination limit (e.g. 1000) to prevent OOM errors
+         * on large graph histories.
+         *
+         * @generated from rpc cellaflow.v1.WorkflowEngineService.GetGraph
+         */
+        getGraph: {
+            name: "GetGraph",
+            I: GetGraphRequest,
+            O: GetGraphResponse,
+            kind: MethodKind.Unary,
+        },
+        /**
+         * Idempotency cache RPCs
+         *
+         * @generated from rpc cellaflow.v1.WorkflowEngineService.CheckIdempotencyCache
+         */
+        checkIdempotencyCache: {
+            name: "CheckIdempotencyCache",
+            I: CheckCacheRequest,
+            O: CheckCacheResponse,
+            kind: MethodKind.Unary,
+        },
+        /**
+         * @generated from rpc cellaflow.v1.WorkflowEngineService.RenewLease
+         */
+        renewLease: {
+            name: "RenewLease",
+            I: RenewLeaseRequest,
+            O: RenewLeaseResponse,
+            kind: MethodKind.Unary,
+        },
+        /**
+         * @generated from rpc cellaflow.v1.WorkflowEngineService.ReleaseLease
+         */
+        releaseLease: {
+            name: "ReleaseLease",
+            I: ReleaseLeaseRequest,
+            O: ReleaseLeaseResponse,
+            kind: MethodKind.Unary,
+        },
+    }
+};
+//# sourceMappingURL=service_connect.js.map

package/dist/cellaflow/v1/service_connect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service_connect.js","sourceRoot":"","sources":["../../../src/cellaflow/v1/service_connect.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,wFAAwF;AACxF,oBAAoB;AACpB,cAAc;AAEd,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,eAAe,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACtJ,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9J;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,QAAQ,EAAE,oCAAoC;IAC9C,OAAO,EAAE;QACP;;;;;;;WAOG;QACH,YAAY,EAAE;YACZ,IAAI,EAAE,cAAc;YACpB,CAAC,EAAE,mBAAmB;YACtB,CAAC,EAAE,oBAAoB;YACvB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;WAQG;QACH,UAAU,EAAE;YACV,IAAI,EAAE,YAAY;YAClB,CAAC,EAAE,iBAAiB;YACpB,CAAC,EAAE,kBAAkB;YACrB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;WAOG;QACH,QAAQ,EAAE;YACR,IAAI,EAAE,UAAU;YAChB,CAAC,EAAE,eAAe;YAClB,CAAC,EAAE,gBAAgB;YACnB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;WAIG;QACH,qBAAqB,EAAE;YACrB,IAAI,EAAE,uBAAuB;YAC7B,CAAC,EAAE,iBAAiB;YACpB,CAAC,EAAE,kBAAkB;YACrB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;WAEG;QACH,UAAU,EAAE;YACV,IAAI,EAAE,YAAY;YAClB,CAAC,EAAE,iBAAiB;YACpB,CAAC,EAAE,kBAAkB;YACrB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;WAEG;QACH,YAAY,EAAE;YACZ,IAAI,EAAE,cAAc;YACpB,CAAC,EAAE,mBAAmB;YACtB,CAAC,EAAE,oBAAoB;YACvB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;KACF;CACO,CAAC"}