@cellaflow/sdk 0.7.0

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

@@ -0,0 +1,119 @@
+import type { BinaryReadOptions, FieldList, JsonReadOptions, JsonValue, PartialMessage, PlainMessage } from "@bufbuild/protobuf";
+import { Message, proto3 } from "@bufbuild/protobuf";
+/**
+ * StepStatus defines compile-time type-safe execution states for a step.
+ *
+ * @generated from enum cellaflow.v1.StepStatus
+ */
+export declare enum StepStatus {
+    /**
+     * @generated from enum value: STEP_STATUS_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: STEP_STATUS_RUNNING = 1;
+     */
+    RUNNING = 1,
+    /**
+     * @generated from enum value: STEP_STATUS_SUCCESS = 2;
+     */
+    SUCCESS = 2,
+    /**
+     * @generated from enum value: STEP_STATUS_FAILED = 3;
+     */
+    FAILED = 3,
+    /**
+     * @generated from enum value: STEP_STATUS_TIMER_SCHEDULED = 4;
+     */
+    TIMER_SCHEDULED = 4,
+    /**
+     * @generated from enum value: STEP_STATUS_TIMER_FIRED = 5;
+     */
+    TIMER_FIRED = 5
+}
+/**
+ * StepResult represents the outcome of a single step in a workflow execution session.
+ *
+ * @generated from message cellaflow.v1.StepResult
+ */
+export declare class StepResult extends Message<StepResult> {
+    /**
+     * Optional to distinguish between explicit sequence 0 and unset/omitted values.
+     * Validation: Must be greater than 0 during normal execution.
+     *
+     * @generated from field: optional uint64 sequence = 1;
+     */
+    sequence?: bigint;
+    /**
+     * @generated from field: string name = 2;
+     */
+    name: string;
+    /**
+     * Safe enum-typed status to prevent raw string errors (e.g. typos).
+     *
+     * @generated from field: cellaflow.v1.StepStatus status = 3;
+     */
+    status: StepStatus;
+    /**
+     * Output payload generated by this execution step.
+     * Validation: Size must not exceed 4MB (4,194,304 bytes).
+     *
+     * @generated from field: bytes output_payload = 4;
+     */
+    outputPayload: Uint8Array<ArrayBuffer>;
+    /**
+     * Unique idempotency key to prevent duplicate tool execution.
+     * Validation: If specified, must not be empty.
+     *
+     * @generated from field: optional string idempotency_key = 5;
+     */
+    idempotencyKey?: string;
+    /**
+     * Deadline for the sleep operation, represented as a Unix timestamp in milliseconds.
+     * Used when status is STEP_STATUS_TIMER_SCHEDULED.
+     *
+     * @generated from field: optional uint64 deadline_ms = 6;
+     */
+    deadlineMs?: bigint;
+    /**
+     * The sequence number of the originating TimerScheduled event.
+     * Used when status is STEP_STATUS_TIMER_FIRED to explicitly pair events.
+     *
+     * @generated from field: optional uint64 source_sequence = 7;
+     */
+    sourceSequence?: bigint;
+    constructor(data?: PartialMessage<StepResult>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "cellaflow.v1.StepResult";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): StepResult;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): StepResult;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): StepResult;
+    static equals(a: StepResult | PlainMessage<StepResult> | undefined, b: StepResult | PlainMessage<StepResult> | undefined): boolean;
+}
+/**
+ * @generated from message cellaflow.v1.WorkflowDefinition
+ */
+export declare class WorkflowDefinition extends Message<WorkflowDefinition> {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * @generated from field: string version = 2;
+     */
+    version: string;
+    /**
+     * @generated from field: string description = 3;
+     */
+    description: string;
+    constructor(data?: PartialMessage<WorkflowDefinition>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "cellaflow.v1.WorkflowDefinition";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): WorkflowDefinition;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): WorkflowDefinition;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): WorkflowDefinition;
+    static equals(a: WorkflowDefinition | PlainMessage<WorkflowDefinition> | undefined, b: WorkflowDefinition | PlainMessage<WorkflowDefinition> | undefined): boolean;
+}
+//# sourceMappingURL=common_pb.d.ts.map

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

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

package/dist/cellaflow/v1/common_pb.js

@@ -0,0 +1,166 @@
+// @generated by protoc-gen-es v1.10.1 with parameter "target=ts,import_extension=.js"
+// @generated from file cellaflow/v1/common.proto (package cellaflow.v1, syntax proto3)
+/* eslint-disable */
+// @ts-nocheck
+import { Message, proto3 } from "@bufbuild/protobuf";
+/**
+ * StepStatus defines compile-time type-safe execution states for a step.
+ *
+ * @generated from enum cellaflow.v1.StepStatus
+ */
+export var StepStatus;
+(function (StepStatus) {
+    /**
+     * @generated from enum value: STEP_STATUS_UNSPECIFIED = 0;
+     */
+    StepStatus[StepStatus["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    /**
+     * @generated from enum value: STEP_STATUS_RUNNING = 1;
+     */
+    StepStatus[StepStatus["RUNNING"] = 1] = "RUNNING";
+    /**
+     * @generated from enum value: STEP_STATUS_SUCCESS = 2;
+     */
+    StepStatus[StepStatus["SUCCESS"] = 2] = "SUCCESS";
+    /**
+     * @generated from enum value: STEP_STATUS_FAILED = 3;
+     */
+    StepStatus[StepStatus["FAILED"] = 3] = "FAILED";
+    /**
+     * @generated from enum value: STEP_STATUS_TIMER_SCHEDULED = 4;
+     */
+    StepStatus[StepStatus["TIMER_SCHEDULED"] = 4] = "TIMER_SCHEDULED";
+    /**
+     * @generated from enum value: STEP_STATUS_TIMER_FIRED = 5;
+     */
+    StepStatus[StepStatus["TIMER_FIRED"] = 5] = "TIMER_FIRED";
+})(StepStatus || (StepStatus = {}));
+// Retrieve enum metadata with: proto3.getEnumType(StepStatus)
+proto3.util.setEnumType(StepStatus, "cellaflow.v1.StepStatus", [
+    { no: 0, name: "STEP_STATUS_UNSPECIFIED" },
+    { no: 1, name: "STEP_STATUS_RUNNING" },
+    { no: 2, name: "STEP_STATUS_SUCCESS" },
+    { no: 3, name: "STEP_STATUS_FAILED" },
+    { no: 4, name: "STEP_STATUS_TIMER_SCHEDULED" },
+    { no: 5, name: "STEP_STATUS_TIMER_FIRED" },
+]);
+/**
+ * StepResult represents the outcome of a single step in a workflow execution session.
+ *
+ * @generated from message cellaflow.v1.StepResult
+ */
+export class StepResult extends Message {
+    /**
+     * Optional to distinguish between explicit sequence 0 and unset/omitted values.
+     * Validation: Must be greater than 0 during normal execution.
+     *
+     * @generated from field: optional uint64 sequence = 1;
+     */
+    sequence;
+    /**
+     * @generated from field: string name = 2;
+     */
+    name = "";
+    /**
+     * Safe enum-typed status to prevent raw string errors (e.g. typos).
+     *
+     * @generated from field: cellaflow.v1.StepStatus status = 3;
+     */
+    status = StepStatus.UNSPECIFIED;
+    /**
+     * Output payload generated by this execution step.
+     * Validation: Size must not exceed 4MB (4,194,304 bytes).
+     *
+     * @generated from field: bytes output_payload = 4;
+     */
+    outputPayload = new Uint8Array(0);
+    /**
+     * Unique idempotency key to prevent duplicate tool execution.
+     * Validation: If specified, must not be empty.
+     *
+     * @generated from field: optional string idempotency_key = 5;
+     */
+    idempotencyKey;
+    /**
+     * Deadline for the sleep operation, represented as a Unix timestamp in milliseconds.
+     * Used when status is STEP_STATUS_TIMER_SCHEDULED.
+     *
+     * @generated from field: optional uint64 deadline_ms = 6;
+     */
+    deadlineMs;
+    /**
+     * The sequence number of the originating TimerScheduled event.
+     * Used when status is STEP_STATUS_TIMER_FIRED to explicitly pair events.
+     *
+     * @generated from field: optional uint64 source_sequence = 7;
+     */
+    sourceSequence;
+    constructor(data) {
+        super();
+        proto3.util.initPartial(data, this);
+    }
+    static runtime = proto3;
+    static typeName = "cellaflow.v1.StepResult";
+    static fields = proto3.util.newFieldList(() => [
+        { no: 1, name: "sequence", kind: "scalar", T: 4 /* ScalarType.UINT64 */, opt: true },
+        { no: 2, name: "name", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+        { no: 3, name: "status", kind: "enum", T: proto3.getEnumType(StepStatus) },
+        { no: 4, name: "output_payload", kind: "scalar", T: 12 /* ScalarType.BYTES */ },
+        { no: 5, name: "idempotency_key", kind: "scalar", T: 9 /* ScalarType.STRING */, opt: true },
+        { no: 6, name: "deadline_ms", kind: "scalar", T: 4 /* ScalarType.UINT64 */, opt: true },
+        { no: 7, name: "source_sequence", kind: "scalar", T: 4 /* ScalarType.UINT64 */, opt: true },
+    ]);
+    static fromBinary(bytes, options) {
+        return new StepResult().fromBinary(bytes, options);
+    }
+    static fromJson(jsonValue, options) {
+        return new StepResult().fromJson(jsonValue, options);
+    }
+    static fromJsonString(jsonString, options) {
+        return new StepResult().fromJsonString(jsonString, options);
+    }
+    static equals(a, b) {
+        return proto3.util.equals(StepResult, a, b);
+    }
+}
+/**
+ * @generated from message cellaflow.v1.WorkflowDefinition
+ */
+export class WorkflowDefinition extends Message {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id = "";
+    /**
+     * @generated from field: string version = 2;
+     */
+    version = "";
+    /**
+     * @generated from field: string description = 3;
+     */
+    description = "";
+    constructor(data) {
+        super();
+        proto3.util.initPartial(data, this);
+    }
+    static runtime = proto3;
+    static typeName = "cellaflow.v1.WorkflowDefinition";
+    static fields = proto3.util.newFieldList(() => [
+        { no: 1, name: "id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+        { no: 2, name: "version", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+        { no: 3, name: "description", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    ]);
+    static fromBinary(bytes, options) {
+        return new WorkflowDefinition().fromBinary(bytes, options);
+    }
+    static fromJson(jsonValue, options) {
+        return new WorkflowDefinition().fromJson(jsonValue, options);
+    }
+    static fromJsonString(jsonString, options) {
+        return new WorkflowDefinition().fromJsonString(jsonString, options);
+    }
+    static equals(a, b) {
+        return proto3.util.equals(WorkflowDefinition, a, b);
+    }
+}
+//# sourceMappingURL=common_pb.js.map

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

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

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

@@ -0,0 +1,378 @@
+import type { BinaryReadOptions, FieldList, JsonReadOptions, JsonValue, PartialMessage, PlainMessage } from "@bufbuild/protobuf";
+import { Message, proto3 } from "@bufbuild/protobuf";
+import { StepResult } from "./common_pb.js";
+/**
+ * Key construction scope used by SDKs during key auto-derivation.
+ * The SDK uses this to prefix the opaque idempotency_key before sending it
+ * to the engine. The engine never parses this — it is purely an SDK concern.
+ *
+ * @generated from enum cellaflow.v1.IdempotencyScope
+ */
+export declare enum IdempotencyScope {
+    /**
+     * @generated from enum value: SCOPE_UNSPECIFIED = 0;
+     */
+    SCOPE_UNSPECIFIED = 0,
+    /**
+     * Shared across all agents in the session (Default)
+     *
+     * @generated from enum value: SCOPE_SESSION_WIDE = 1;
+     */
+    SCOPE_SESSION_WIDE = 1,
+    /**
+     * Isolated to the executing agent
+     *
+     * @generated from enum value: SCOPE_AGENT_PRIVATE = 2;
+     */
+    SCOPE_AGENT_PRIVATE = 2,
+    /**
+     * Isolated to the specific superstep / node
+     *
+     * @generated from enum value: SCOPE_STEP_LOCAL = 3;
+     */
+    SCOPE_STEP_LOCAL = 3
+}
+/**
+ * @generated from enum cellaflow.v1.CacheStatus
+ */
+export declare enum CacheStatus {
+    /**
+     * @generated from enum value: CACHE_STATUS_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * Found in cache (or completed by in-flight worker)
+     *
+     * @generated from enum value: CACHE_STATUS_HIT = 1;
+     */
+    HIT = 1,
+    /**
+     * Miss & lease granted: caller should execute tool
+     *
+     * @generated from enum value: CACHE_STATUS_ACQUIRED = 2;
+     */
+    ACQUIRED = 2,
+    /**
+     * Miss & currently running by another worker
+     *
+     * @generated from enum value: CACHE_STATUS_IN_PROGRESS = 3;
+     */
+    IN_PROGRESS = 3
+}
+/**
+ * @generated from enum cellaflow.v1.RenewFailureReason
+ */
+export declare enum RenewFailureReason {
+    /**
+     * @generated from enum value: RENEW_FAILURE_REASON_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * Lease timed out before renewal arrived
+     *
+     * @generated from enum value: RENEW_FAILURE_REASON_EXPIRED = 1;
+     */
+    EXPIRED = 1,
+    /**
+     * A newer worker acquired a higher fencing token
+     *
+     * @generated from enum value: RENEW_FAILURE_REASON_SUPERSEDED = 2;
+     */
+    SUPERSEDED = 2,
+    /**
+     * Key does not exist or was deleted
+     *
+     * @generated from enum value: RENEW_FAILURE_REASON_NOT_FOUND = 3;
+     */
+    NOT_FOUND = 3,
+    /**
+     * Step was already committed by another worker
+     *
+     * @generated from enum value: RENEW_FAILURE_REASON_COMPLETED = 4;
+     */
+    COMPLETED = 4,
+    /**
+     * The lease hit its maximum total lifetime and was reclaimed.
+     *
+     * Distinct from EXPIRED: the holder kept renewing and is likely still running,
+     * so it must learn the engine took the lease back rather than that its own
+     * renewal lapsed.
+     *
+     * @generated from enum value: RENEW_FAILURE_REASON_MAX_LIFETIME_EXCEEDED = 5;
+     */
+    MAX_LIFETIME_EXCEEDED = 5
+}
+/**
+ * @generated from enum cellaflow.v1.IdempotencyCommitStatus
+ */
+export declare enum IdempotencyCommitStatus {
+    /**
+     * @generated from enum value: IDEMPOTENCY_COMMIT_UNSPECIFIED = 0;
+     */
+    IDEMPOTENCY_COMMIT_UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: IDEMPOTENCY_COMMIT_COMMITTED = 1;
+     */
+    IDEMPOTENCY_COMMIT_COMMITTED = 1,
+    /**
+     * Idempotent retry of the commit call itself
+     *
+     * @generated from enum value: IDEMPOTENCY_COMMIT_ALREADY_COMMITTED = 2;
+     */
+    IDEMPOTENCY_COMMIT_ALREADY_COMMITTED = 2,
+    /**
+     * Fencing token invalid — caller was fenced out
+     *
+     * @generated from enum value: IDEMPOTENCY_COMMIT_STALE_LEASE_REJECTED = 3;
+     */
+    IDEMPOTENCY_COMMIT_STALE_LEASE_REJECTED = 3
+}
+/**
+ * @generated from message cellaflow.v1.CheckCacheRequest
+ */
+export declare class CheckCacheRequest extends Message<CheckCacheRequest> {
+    /**
+     * Opaque caller-supplied label, carried for logging and diagnostics.
+     *
+     * Not parsed into the idempotency key: key derivation is an SDK concern and the
+     * engine treats the key as opaque.
+     *
+     * @generated from field: string agent_id = 1;
+     */
+    agentId: string;
+    /**
+     * Fully formed, opaque composite key
+     *
+     * @generated from field: string idempotency_key = 2;
+     */
+    idempotencyKey: string;
+    /**
+     * @generated from field: optional uint64 wait_timeout_ms = 3;
+     */
+    waitTimeoutMs?: bigint;
+    /**
+     * Crash-detection window; defaults to engine config
+     *
+     * @generated from field: optional uint64 lease_ttl_ms = 4;
+     */
+    leaseTtlMs?: bigint;
+    /**
+     * The session this check is being made on behalf of.
+     *
+     * The idempotency key is opaque to the engine and deliberately stays that way,
+     * so the session cannot be recovered from it. Without this field the engine
+     * cannot tell the caller where its session currently sits, which is what a
+     * caller needs after a cache hit — see `current_sequence` on the response.
+     *
+     * Optional for wire compatibility: clients predating this field still work,
+     * they simply receive no `current_sequence` back.
+     *
+     * @generated from field: optional string session_id = 5;
+     */
+    sessionId?: string;
+    /**
+     * The graph position this caller intends to write to.
+     *
+     * The engine already knows which session is asking (field 5) and where that
+     * session has committed to (`latest_committed_sequence`). This supplies the
+     * one missing input: where the caller is going. With all three, a lease that
+     * would authorise a side effect at an already-committed position can be
+     * refused *before* the side effect happens, rather than rejected at commit
+     * time after the money has moved.
+     *
+     * Note this is the caller's *intended* position, not the response's
+     * `current_sequence`, which reports where the session already sits.
+     *
+     * Optional for wire compatibility: clients that omit it keep the previous
+     * behaviour and are still granted leases. Sending 0 is an error rather than
+     * a synonym for "unset" -- sequences are 1-based, so 0 is never a position a
+     * caller could legitimately intend to write.
+     *
+     * @generated from field: optional uint64 sequence = 6;
+     */
+    sequence?: bigint;
+    constructor(data?: PartialMessage<CheckCacheRequest>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "cellaflow.v1.CheckCacheRequest";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): CheckCacheRequest;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): CheckCacheRequest;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): CheckCacheRequest;
+    static equals(a: CheckCacheRequest | PlainMessage<CheckCacheRequest> | undefined, b: CheckCacheRequest | PlainMessage<CheckCacheRequest> | undefined): boolean;
+}
+/**
+ * @generated from message cellaflow.v1.CheckCacheResponse
+ */
+export declare class CheckCacheResponse extends Message<CheckCacheResponse> {
+    /**
+     * @generated from field: cellaflow.v1.CacheStatus status = 1;
+     */
+    status: CacheStatus;
+    /**
+     * @generated from field: optional cellaflow.v1.StepResult cached_result = 2;
+     */
+    cachedResult?: StepResult;
+    /**
+     * Present iff ACQUIRED
+     *
+     * @generated from field: optional uint64 fencing_token = 3;
+     */
+    fencingToken?: bigint;
+    /**
+     * Present iff ACQUIRED or IN_PROGRESS
+     *
+     * @generated from field: optional uint64 lease_expires_at_ms = 4;
+     */
+    leaseExpiresAtMs?: bigint;
+    /**
+     * Present iff ACQUIRED — caller MUST renew
+     *
+     * @generated from field: optional uint64 heartbeat_interval_ms = 5;
+     */
+    heartbeatIntervalMs?: bigint;
+    /**
+     * Present iff IN_PROGRESS and wait exhausted
+     *
+     * @generated from field: optional uint64 retry_after_ms = 6;
+     */
+    retryAfterMs?: bigint;
+    /**
+     * Present iff IN_PROGRESS (for distributed tracing)
+     *
+     * @generated from field: optional string current_holder_id = 7;
+     */
+    currentHolderId?: string;
+    /**
+     * The requested session's highest committed sequence, or 0 if it has
+     * none. Present whenever `session_id` was supplied — on every status, not only
+     * on HIT.
+     *
+     * A caller that takes a HIT returns without committing, so its local counter
+     * advances while the session's does not, and its next commit fails the
+     * ordering check one step after the real cause. This lets it re-align.
+     *
+     * Returned on ACQUIRED and IN_PROGRESS too because it costs one seek on a call
+     * that already performs a storage transaction, and it lets a caller about to
+     * execute confirm it is where it thinks it is.
+     *
+     * @generated from field: optional uint64 current_sequence = 8;
+     */
+    currentSequence?: bigint;
+    constructor(data?: PartialMessage<CheckCacheResponse>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "cellaflow.v1.CheckCacheResponse";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): CheckCacheResponse;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): CheckCacheResponse;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): CheckCacheResponse;
+    static equals(a: CheckCacheResponse | PlainMessage<CheckCacheResponse> | undefined, b: CheckCacheResponse | PlainMessage<CheckCacheResponse> | undefined): boolean;
+}
+/**
+ * @generated from message cellaflow.v1.RenewLeaseRequest
+ */
+export declare class RenewLeaseRequest extends Message<RenewLeaseRequest> {
+    /**
+     * @generated from field: string agent_id = 1;
+     */
+    agentId: string;
+    /**
+     * @generated from field: string idempotency_key = 2;
+     */
+    idempotencyKey: string;
+    /**
+     * @generated from field: uint64 fencing_token = 3;
+     */
+    fencingToken: bigint;
+    /**
+     * @generated from field: uint64 extend_ms = 4;
+     */
+    extendMs: bigint;
+    constructor(data?: PartialMessage<RenewLeaseRequest>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "cellaflow.v1.RenewLeaseRequest";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): RenewLeaseRequest;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): RenewLeaseRequest;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): RenewLeaseRequest;
+    static equals(a: RenewLeaseRequest | PlainMessage<RenewLeaseRequest> | undefined, b: RenewLeaseRequest | PlainMessage<RenewLeaseRequest> | undefined): boolean;
+}
+/**
+ * @generated from message cellaflow.v1.RenewLeaseResponse
+ */
+export declare class RenewLeaseResponse extends Message<RenewLeaseResponse> {
+    /**
+     * False => lease was reclaimed/completed; stop execution
+     *
+     * @generated from field: bool renewed = 1;
+     */
+    renewed: boolean;
+    /**
+     * Present iff renewed = true
+     *
+     * @generated from field: optional uint64 new_expires_at_ms = 2;
+     */
+    newExpiresAtMs?: bigint;
+    /**
+     * Present iff renewed = false
+     *
+     * @generated from field: optional cellaflow.v1.RenewFailureReason failure_reason = 3;
+     */
+    failureReason?: RenewFailureReason;
+    constructor(data?: PartialMessage<RenewLeaseResponse>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "cellaflow.v1.RenewLeaseResponse";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): RenewLeaseResponse;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): RenewLeaseResponse;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): RenewLeaseResponse;
+    static equals(a: RenewLeaseResponse | PlainMessage<RenewLeaseResponse> | undefined, b: RenewLeaseResponse | PlainMessage<RenewLeaseResponse> | undefined): boolean;
+}
+/**
+ * @generated from message cellaflow.v1.ReleaseLeaseRequest
+ */
+export declare class ReleaseLeaseRequest extends Message<ReleaseLeaseRequest> {
+    /**
+     * @generated from field: string agent_id = 1;
+     */
+    agentId: string;
+    /**
+     * @generated from field: string idempotency_key = 2;
+     */
+    idempotencyKey: string;
+    /**
+     * @generated from field: uint64 fencing_token = 3;
+     */
+    fencingToken: bigint;
+    /**
+     * e.g. "RATE_LIMITED_429", "CANCELLED", "TOOL_ERROR"
+     *
+     * @generated from field: optional string reason = 4;
+     */
+    reason?: string;
+    constructor(data?: PartialMessage<ReleaseLeaseRequest>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "cellaflow.v1.ReleaseLeaseRequest";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): ReleaseLeaseRequest;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): ReleaseLeaseRequest;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): ReleaseLeaseRequest;
+    static equals(a: ReleaseLeaseRequest | PlainMessage<ReleaseLeaseRequest> | undefined, b: ReleaseLeaseRequest | PlainMessage<ReleaseLeaseRequest> | undefined): boolean;
+}
+/**
+ * @generated from message cellaflow.v1.ReleaseLeaseResponse
+ */
+export declare class ReleaseLeaseResponse extends Message<ReleaseLeaseResponse> {
+    /**
+     * @generated from field: bool released = 1;
+     */
+    released: boolean;
+    constructor(data?: PartialMessage<ReleaseLeaseResponse>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "cellaflow.v1.ReleaseLeaseResponse";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): ReleaseLeaseResponse;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): ReleaseLeaseResponse;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): ReleaseLeaseResponse;
+    static equals(a: ReleaseLeaseResponse | PlainMessage<ReleaseLeaseResponse> | undefined, b: ReleaseLeaseResponse | PlainMessage<ReleaseLeaseResponse> | undefined): boolean;
+}
+//# sourceMappingURL=idempotency_pb.d.ts.map