@corvohq/client 0.2.0

package/dist/gen/corvo/v1/worker_pb.d.ts

@@ -0,0 +1,689 @@
+import type { GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
+import type { Timestamp } from "@bufbuild/protobuf/wkt";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file corvo/v1/worker.proto.
+ */
+export declare const file_corvo_v1_worker: GenFile;
+/**
+ * @generated from message corvo.v1.EnqueueRequest
+ */
+export type EnqueueRequest = Message<"corvo.v1.EnqueueRequest"> & {
+    /**
+     * @generated from field: string queue = 1;
+     */
+    queue: string;
+    /**
+     * @generated from field: string payload_json = 2;
+     */
+    payloadJson: string;
+    /**
+     * @generated from field: corvo.v1.AgentConfig agent = 3;
+     */
+    agent?: AgentConfig;
+};
+/**
+ * Describes the message corvo.v1.EnqueueRequest.
+ * Use `create(EnqueueRequestSchema)` to create a new message.
+ */
+export declare const EnqueueRequestSchema: GenMessage<EnqueueRequest>;
+/**
+ * @generated from message corvo.v1.EnqueueResponse
+ */
+export type EnqueueResponse = Message<"corvo.v1.EnqueueResponse"> & {
+    /**
+     * @generated from field: string job_id = 1;
+     */
+    jobId: string;
+    /**
+     * @generated from field: string status = 2;
+     */
+    status: string;
+    /**
+     * @generated from field: bool unique_existing = 3;
+     */
+    uniqueExisting: boolean;
+};
+/**
+ * Describes the message corvo.v1.EnqueueResponse.
+ * Use `create(EnqueueResponseSchema)` to create a new message.
+ */
+export declare const EnqueueResponseSchema: GenMessage<EnqueueResponse>;
+/**
+ * @generated from message corvo.v1.FetchRequest
+ */
+export type FetchRequest = Message<"corvo.v1.FetchRequest"> & {
+    /**
+     * @generated from field: repeated string queues = 1;
+     */
+    queues: string[];
+    /**
+     * @generated from field: string worker_id = 2;
+     */
+    workerId: string;
+    /**
+     * @generated from field: string hostname = 3;
+     */
+    hostname: string;
+    /**
+     * @generated from field: int32 lease_duration = 4;
+     */
+    leaseDuration: number;
+};
+/**
+ * Describes the message corvo.v1.FetchRequest.
+ * Use `create(FetchRequestSchema)` to create a new message.
+ */
+export declare const FetchRequestSchema: GenMessage<FetchRequest>;
+/**
+ * @generated from message corvo.v1.FetchResponse
+ */
+export type FetchResponse = Message<"corvo.v1.FetchResponse"> & {
+    /**
+     * @generated from field: bool found = 1;
+     */
+    found: boolean;
+    /**
+     * @generated from field: string job_id = 2;
+     */
+    jobId: string;
+    /**
+     * @generated from field: string queue = 3;
+     */
+    queue: string;
+    /**
+     * @generated from field: string payload_json = 4;
+     */
+    payloadJson: string;
+    /**
+     * @generated from field: int32 attempt = 5;
+     */
+    attempt: number;
+    /**
+     * @generated from field: int32 max_retries = 6;
+     */
+    maxRetries: number;
+    /**
+     * @generated from field: int32 lease_duration = 7;
+     */
+    leaseDuration: number;
+    /**
+     * @generated from field: string checkpoint_json = 8;
+     */
+    checkpointJson: string;
+    /**
+     * @generated from field: string tags_json = 9;
+     */
+    tagsJson: string;
+    /**
+     * @generated from field: corvo.v1.AgentState agent = 10;
+     */
+    agent?: AgentState;
+};
+/**
+ * Describes the message corvo.v1.FetchResponse.
+ * Use `create(FetchResponseSchema)` to create a new message.
+ */
+export declare const FetchResponseSchema: GenMessage<FetchResponse>;
+/**
+ * @generated from message corvo.v1.FetchBatchRequest
+ */
+export type FetchBatchRequest = Message<"corvo.v1.FetchBatchRequest"> & {
+    /**
+     * @generated from field: repeated string queues = 1;
+     */
+    queues: string[];
+    /**
+     * @generated from field: string worker_id = 2;
+     */
+    workerId: string;
+    /**
+     * @generated from field: string hostname = 3;
+     */
+    hostname: string;
+    /**
+     * @generated from field: int32 lease_duration = 4;
+     */
+    leaseDuration: number;
+    /**
+     * @generated from field: int32 count = 5;
+     */
+    count: number;
+};
+/**
+ * Describes the message corvo.v1.FetchBatchRequest.
+ * Use `create(FetchBatchRequestSchema)` to create a new message.
+ */
+export declare const FetchBatchRequestSchema: GenMessage<FetchBatchRequest>;
+/**
+ * @generated from message corvo.v1.FetchBatchJob
+ */
+export type FetchBatchJob = Message<"corvo.v1.FetchBatchJob"> & {
+    /**
+     * @generated from field: string job_id = 1;
+     */
+    jobId: string;
+    /**
+     * @generated from field: string queue = 2;
+     */
+    queue: string;
+    /**
+     * @generated from field: string payload_json = 3;
+     */
+    payloadJson: string;
+    /**
+     * @generated from field: int32 attempt = 4;
+     */
+    attempt: number;
+    /**
+     * @generated from field: int32 max_retries = 5;
+     */
+    maxRetries: number;
+    /**
+     * @generated from field: int32 lease_duration = 6;
+     */
+    leaseDuration: number;
+    /**
+     * @generated from field: string checkpoint_json = 7;
+     */
+    checkpointJson: string;
+    /**
+     * @generated from field: string tags_json = 8;
+     */
+    tagsJson: string;
+    /**
+     * @generated from field: corvo.v1.AgentState agent = 9;
+     */
+    agent?: AgentState;
+};
+/**
+ * Describes the message corvo.v1.FetchBatchJob.
+ * Use `create(FetchBatchJobSchema)` to create a new message.
+ */
+export declare const FetchBatchJobSchema: GenMessage<FetchBatchJob>;
+/**
+ * @generated from message corvo.v1.FetchBatchResponse
+ */
+export type FetchBatchResponse = Message<"corvo.v1.FetchBatchResponse"> & {
+    /**
+     * @generated from field: repeated corvo.v1.FetchBatchJob jobs = 1;
+     */
+    jobs: FetchBatchJob[];
+};
+/**
+ * Describes the message corvo.v1.FetchBatchResponse.
+ * Use `create(FetchBatchResponseSchema)` to create a new message.
+ */
+export declare const FetchBatchResponseSchema: GenMessage<FetchBatchResponse>;
+/**
+ * @generated from message corvo.v1.UsageReport
+ */
+export type UsageReport = Message<"corvo.v1.UsageReport"> & {
+    /**
+     * @generated from field: int64 input_tokens = 1;
+     */
+    inputTokens: bigint;
+    /**
+     * @generated from field: int64 output_tokens = 2;
+     */
+    outputTokens: bigint;
+    /**
+     * @generated from field: int64 cache_creation_tokens = 3;
+     */
+    cacheCreationTokens: bigint;
+    /**
+     * @generated from field: int64 cache_read_tokens = 4;
+     */
+    cacheReadTokens: bigint;
+    /**
+     * @generated from field: string model = 5;
+     */
+    model: string;
+    /**
+     * @generated from field: string provider = 6;
+     */
+    provider: string;
+    /**
+     * @generated from field: double cost_usd = 7;
+     */
+    costUsd: number;
+};
+/**
+ * Describes the message corvo.v1.UsageReport.
+ * Use `create(UsageReportSchema)` to create a new message.
+ */
+export declare const UsageReportSchema: GenMessage<UsageReport>;
+/**
+ * @generated from message corvo.v1.AckRequest
+ */
+export type AckRequest = Message<"corvo.v1.AckRequest"> & {
+    /**
+     * @generated from field: string job_id = 1;
+     */
+    jobId: string;
+    /**
+     * @generated from field: string result_json = 2;
+     */
+    resultJson: string;
+    /**
+     * @generated from field: corvo.v1.UsageReport usage = 3;
+     */
+    usage?: UsageReport;
+    /**
+     * @generated from field: string checkpoint_json = 4;
+     */
+    checkpointJson: string;
+    /**
+     * @generated from field: string agent_status = 5;
+     */
+    agentStatus: string;
+    /**
+     * @generated from field: string hold_reason = 6;
+     */
+    holdReason: string;
+    /**
+     * @generated from field: string trace_json = 7;
+     */
+    traceJson: string;
+};
+/**
+ * Describes the message corvo.v1.AckRequest.
+ * Use `create(AckRequestSchema)` to create a new message.
+ */
+export declare const AckRequestSchema: GenMessage<AckRequest>;
+/**
+ * @generated from message corvo.v1.AckResponse
+ */
+export type AckResponse = Message<"corvo.v1.AckResponse"> & {};
+/**
+ * Describes the message corvo.v1.AckResponse.
+ * Use `create(AckResponseSchema)` to create a new message.
+ */
+export declare const AckResponseSchema: GenMessage<AckResponse>;
+/**
+ * @generated from message corvo.v1.AckBatchItem
+ */
+export type AckBatchItem = Message<"corvo.v1.AckBatchItem"> & {
+    /**
+     * @generated from field: string job_id = 1;
+     */
+    jobId: string;
+    /**
+     * @generated from field: string result_json = 2;
+     */
+    resultJson: string;
+    /**
+     * @generated from field: corvo.v1.UsageReport usage = 3;
+     */
+    usage?: UsageReport;
+};
+/**
+ * Describes the message corvo.v1.AckBatchItem.
+ * Use `create(AckBatchItemSchema)` to create a new message.
+ */
+export declare const AckBatchItemSchema: GenMessage<AckBatchItem>;
+/**
+ * @generated from message corvo.v1.AckBatchRequest
+ */
+export type AckBatchRequest = Message<"corvo.v1.AckBatchRequest"> & {
+    /**
+     * @generated from field: repeated corvo.v1.AckBatchItem items = 1;
+     */
+    items: AckBatchItem[];
+};
+/**
+ * Describes the message corvo.v1.AckBatchRequest.
+ * Use `create(AckBatchRequestSchema)` to create a new message.
+ */
+export declare const AckBatchRequestSchema: GenMessage<AckBatchRequest>;
+/**
+ * @generated from message corvo.v1.AckBatchResponse
+ */
+export type AckBatchResponse = Message<"corvo.v1.AckBatchResponse"> & {
+    /**
+     * @generated from field: int32 acked = 1;
+     */
+    acked: number;
+};
+/**
+ * Describes the message corvo.v1.AckBatchResponse.
+ * Use `create(AckBatchResponseSchema)` to create a new message.
+ */
+export declare const AckBatchResponseSchema: GenMessage<AckBatchResponse>;
+/**
+ * @generated from message corvo.v1.LifecycleStreamRequest
+ */
+export type LifecycleStreamRequest = Message<"corvo.v1.LifecycleStreamRequest"> & {
+    /**
+     * @generated from field: uint64 request_id = 1;
+     */
+    requestId: bigint;
+    /**
+     * @generated from field: repeated string queues = 2;
+     */
+    queues: string[];
+    /**
+     * @generated from field: string worker_id = 3;
+     */
+    workerId: string;
+    /**
+     * @generated from field: string hostname = 4;
+     */
+    hostname: string;
+    /**
+     * @generated from field: int32 lease_duration = 5;
+     */
+    leaseDuration: number;
+    /**
+     * @generated from field: int32 fetch_count = 6;
+     */
+    fetchCount: number;
+    /**
+     * @generated from field: repeated corvo.v1.AckBatchItem acks = 7;
+     */
+    acks: AckBatchItem[];
+    /**
+     * @generated from field: repeated corvo.v1.LifecycleEnqueueItem enqueues = 8;
+     */
+    enqueues: LifecycleEnqueueItem[];
+};
+/**
+ * Describes the message corvo.v1.LifecycleStreamRequest.
+ * Use `create(LifecycleStreamRequestSchema)` to create a new message.
+ */
+export declare const LifecycleStreamRequestSchema: GenMessage<LifecycleStreamRequest>;
+/**
+ * @generated from message corvo.v1.LifecycleEnqueueItem
+ */
+export type LifecycleEnqueueItem = Message<"corvo.v1.LifecycleEnqueueItem"> & {
+    /**
+     * @generated from field: string queue = 1;
+     */
+    queue: string;
+    /**
+     * @generated from field: string payload_json = 2;
+     */
+    payloadJson: string;
+    /**
+     * @generated from field: corvo.v1.AgentConfig agent = 3;
+     */
+    agent?: AgentConfig;
+};
+/**
+ * Describes the message corvo.v1.LifecycleEnqueueItem.
+ * Use `create(LifecycleEnqueueItemSchema)` to create a new message.
+ */
+export declare const LifecycleEnqueueItemSchema: GenMessage<LifecycleEnqueueItem>;
+/**
+ * @generated from message corvo.v1.AgentConfig
+ */
+export type AgentConfig = Message<"corvo.v1.AgentConfig"> & {
+    /**
+     * @generated from field: int32 max_iterations = 1;
+     */
+    maxIterations: number;
+    /**
+     * @generated from field: double max_cost_usd = 2;
+     */
+    maxCostUsd: number;
+    /**
+     * @generated from field: string iteration_timeout = 3;
+     */
+    iterationTimeout: string;
+};
+/**
+ * Describes the message corvo.v1.AgentConfig.
+ * Use `create(AgentConfigSchema)` to create a new message.
+ */
+export declare const AgentConfigSchema: GenMessage<AgentConfig>;
+/**
+ * @generated from message corvo.v1.AgentState
+ */
+export type AgentState = Message<"corvo.v1.AgentState"> & {
+    /**
+     * @generated from field: int32 max_iterations = 1;
+     */
+    maxIterations: number;
+    /**
+     * @generated from field: double max_cost_usd = 2;
+     */
+    maxCostUsd: number;
+    /**
+     * @generated from field: string iteration_timeout = 3;
+     */
+    iterationTimeout: string;
+    /**
+     * @generated from field: int32 iteration = 4;
+     */
+    iteration: number;
+    /**
+     * @generated from field: double total_cost_usd = 5;
+     */
+    totalCostUsd: number;
+};
+/**
+ * Describes the message corvo.v1.AgentState.
+ * Use `create(AgentStateSchema)` to create a new message.
+ */
+export declare const AgentStateSchema: GenMessage<AgentState>;
+/**
+ * @generated from message corvo.v1.LifecycleStreamResponse
+ */
+export type LifecycleStreamResponse = Message<"corvo.v1.LifecycleStreamResponse"> & {
+    /**
+     * @generated from field: uint64 request_id = 1;
+     */
+    requestId: bigint;
+    /**
+     * @generated from field: repeated corvo.v1.FetchBatchJob jobs = 2;
+     */
+    jobs: FetchBatchJob[];
+    /**
+     * @generated from field: int32 acked = 3;
+     */
+    acked: number;
+    /**
+     * @generated from field: string error = 4;
+     */
+    error: string;
+    /**
+     * @generated from field: repeated string enqueued_job_ids = 5;
+     */
+    enqueuedJobIds: string[];
+    /**
+     * HTTP URL of leader, set when error="NOT_LEADER"
+     *
+     * @generated from field: string leader_addr = 6;
+     */
+    leaderAddr: string;
+};
+/**
+ * Describes the message corvo.v1.LifecycleStreamResponse.
+ * Use `create(LifecycleStreamResponseSchema)` to create a new message.
+ */
+export declare const LifecycleStreamResponseSchema: GenMessage<LifecycleStreamResponse>;
+/**
+ * @generated from message corvo.v1.FailRequest
+ */
+export type FailRequest = Message<"corvo.v1.FailRequest"> & {
+    /**
+     * @generated from field: string job_id = 1;
+     */
+    jobId: string;
+    /**
+     * @generated from field: string error = 2;
+     */
+    error: string;
+    /**
+     * @generated from field: string backtrace = 3;
+     */
+    backtrace: string;
+};
+/**
+ * Describes the message corvo.v1.FailRequest.
+ * Use `create(FailRequestSchema)` to create a new message.
+ */
+export declare const FailRequestSchema: GenMessage<FailRequest>;
+/**
+ * @generated from message corvo.v1.FailResponse
+ */
+export type FailResponse = Message<"corvo.v1.FailResponse"> & {
+    /**
+     * @generated from field: string status = 1;
+     */
+    status: string;
+    /**
+     * @generated from field: google.protobuf.Timestamp next_attempt_at = 2;
+     */
+    nextAttemptAt?: Timestamp;
+    /**
+     * @generated from field: int32 attempts_remaining = 3;
+     */
+    attemptsRemaining: number;
+};
+/**
+ * Describes the message corvo.v1.FailResponse.
+ * Use `create(FailResponseSchema)` to create a new message.
+ */
+export declare const FailResponseSchema: GenMessage<FailResponse>;
+/**
+ * @generated from message corvo.v1.HeartbeatJobUpdate
+ */
+export type HeartbeatJobUpdate = Message<"corvo.v1.HeartbeatJobUpdate"> & {
+    /**
+     * @generated from field: string progress_json = 1;
+     */
+    progressJson: string;
+    /**
+     * @generated from field: string checkpoint_json = 2;
+     */
+    checkpointJson: string;
+    /**
+     * @generated from field: corvo.v1.UsageReport usage = 3;
+     */
+    usage?: UsageReport;
+    /**
+     * @generated from field: string stream_delta = 4;
+     */
+    streamDelta: string;
+};
+/**
+ * Describes the message corvo.v1.HeartbeatJobUpdate.
+ * Use `create(HeartbeatJobUpdateSchema)` to create a new message.
+ */
+export declare const HeartbeatJobUpdateSchema: GenMessage<HeartbeatJobUpdate>;
+/**
+ * @generated from message corvo.v1.HeartbeatRequest
+ */
+export type HeartbeatRequest = Message<"corvo.v1.HeartbeatRequest"> & {
+    /**
+     * @generated from field: map<string, corvo.v1.HeartbeatJobUpdate> jobs = 1;
+     */
+    jobs: {
+        [key: string]: HeartbeatJobUpdate;
+    };
+};
+/**
+ * Describes the message corvo.v1.HeartbeatRequest.
+ * Use `create(HeartbeatRequestSchema)` to create a new message.
+ */
+export declare const HeartbeatRequestSchema: GenMessage<HeartbeatRequest>;
+/**
+ * @generated from message corvo.v1.HeartbeatJobResponse
+ */
+export type HeartbeatJobResponse = Message<"corvo.v1.HeartbeatJobResponse"> & {
+    /**
+     * @generated from field: string status = 1;
+     */
+    status: string;
+};
+/**
+ * Describes the message corvo.v1.HeartbeatJobResponse.
+ * Use `create(HeartbeatJobResponseSchema)` to create a new message.
+ */
+export declare const HeartbeatJobResponseSchema: GenMessage<HeartbeatJobResponse>;
+/**
+ * @generated from message corvo.v1.HeartbeatResponse
+ */
+export type HeartbeatResponse = Message<"corvo.v1.HeartbeatResponse"> & {
+    /**
+     * @generated from field: map<string, corvo.v1.HeartbeatJobResponse> jobs = 1;
+     */
+    jobs: {
+        [key: string]: HeartbeatJobResponse;
+    };
+};
+/**
+ * Describes the message corvo.v1.HeartbeatResponse.
+ * Use `create(HeartbeatResponseSchema)` to create a new message.
+ */
+export declare const HeartbeatResponseSchema: GenMessage<HeartbeatResponse>;
+/**
+ * @generated from service corvo.v1.WorkerService
+ */
+export declare const WorkerService: GenService<{
+    /**
+     * @generated from rpc corvo.v1.WorkerService.Enqueue
+     */
+    enqueue: {
+        methodKind: "unary";
+        input: typeof EnqueueRequestSchema;
+        output: typeof EnqueueResponseSchema;
+    };
+    /**
+     * @generated from rpc corvo.v1.WorkerService.Fetch
+     */
+    fetch: {
+        methodKind: "unary";
+        input: typeof FetchRequestSchema;
+        output: typeof FetchResponseSchema;
+    };
+    /**
+     * @generated from rpc corvo.v1.WorkerService.FetchBatch
+     */
+    fetchBatch: {
+        methodKind: "unary";
+        input: typeof FetchBatchRequestSchema;
+        output: typeof FetchBatchResponseSchema;
+    };
+    /**
+     * @generated from rpc corvo.v1.WorkerService.Ack
+     */
+    ack: {
+        methodKind: "unary";
+        input: typeof AckRequestSchema;
+        output: typeof AckResponseSchema;
+    };
+    /**
+     * @generated from rpc corvo.v1.WorkerService.AckBatch
+     */
+    ackBatch: {
+        methodKind: "unary";
+        input: typeof AckBatchRequestSchema;
+        output: typeof AckBatchResponseSchema;
+    };
+    /**
+     * @generated from rpc corvo.v1.WorkerService.StreamLifecycle
+     */
+    streamLifecycle: {
+        methodKind: "bidi_streaming";
+        input: typeof LifecycleStreamRequestSchema;
+        output: typeof LifecycleStreamResponseSchema;
+    };
+    /**
+     * @generated from rpc corvo.v1.WorkerService.Fail
+     */
+    fail: {
+        methodKind: "unary";
+        input: typeof FailRequestSchema;
+        output: typeof FailResponseSchema;
+    };
+    /**
+     * @generated from rpc corvo.v1.WorkerService.Heartbeat
+     */
+    heartbeat: {
+        methodKind: "unary";
+        input: typeof HeartbeatRequestSchema;
+        output: typeof HeartbeatResponseSchema;
+    };
+}>;

package/dist/gen/corvo/v1/worker_pb.js

@@ -0,0 +1,133 @@
+// @generated by protoc-gen-es v2.11.0 with parameter "target=ts"
+// @generated from file corvo/v1/worker.proto (package corvo.v1, syntax proto3)
+/* eslint-disable */
+import { fileDesc, messageDesc, serviceDesc } from "@bufbuild/protobuf/codegenv2";
+import { file_google_protobuf_timestamp } from "@bufbuild/protobuf/wkt";
+/**
+ * Describes the file corvo/v1/worker.proto.
+ */
+export const file_corvo_v1_worker = /*@__PURE__*/ fileDesc("ChVjb3J2by92MS93b3JrZXIucHJvdG8SCGNvcnZvLnYxIlsKDkVucXVldWVSZXF1ZXN0Eg0KBXF1ZXVlGAEgASgJEhQKDHBheWxvYWRfanNvbhgCIAEoCRIkCgVhZ2VudBgDIAEoCzIVLmNvcnZvLnYxLkFnZW50Q29uZmlnIkoKD0VucXVldWVSZXNwb25zZRIOCgZqb2JfaWQYASABKAkSDgoGc3RhdHVzGAIgASgJEhcKD3VuaXF1ZV9leGlzdGluZxgDIAEoCCJbCgxGZXRjaFJlcXVlc3QSDgoGcXVldWVzGAEgAygJEhEKCXdvcmtlcl9pZBgCIAEoCRIQCghob3N0bmFtZRgDIAEoCRIWCg5sZWFzZV9kdXJhdGlvbhgEIAEoBSLiAQoNRmV0Y2hSZXNwb25zZRINCgVmb3VuZBgBIAEoCBIOCgZqb2JfaWQYAiABKAkSDQoFcXVldWUYAyABKAkSFAoMcGF5bG9hZF9qc29uGAQgASgJEg8KB2F0dGVtcHQYBSABKAUSEwoLbWF4X3JldHJpZXMYBiABKAUSFgoObGVhc2VfZHVyYXRpb24YByABKAUSFwoPY2hlY2twb2ludF9qc29uGAggASgJEhEKCXRhZ3NfanNvbhgJIAEoCRIjCgVhZ2VudBgKIAEoCzIULmNvcnZvLnYxLkFnZW50U3RhdGUibwoRRmV0Y2hCYXRjaFJlcXVlc3QSDgoGcXVldWVzGAEgAygJEhEKCXdvcmtlcl9pZBgCIAEoCRIQCghob3N0bmFtZRgDIAEoCRIWCg5sZWFzZV9kdXJhdGlvbhgEIAEoBRINCgVjb3VudBgFIAEoBSLTAQoNRmV0Y2hCYXRjaEpvYhIOCgZqb2JfaWQYASABKAkSDQoFcXVldWUYAiABKAkSFAoMcGF5bG9hZF9qc29uGAMgASgJEg8KB2F0dGVtcHQYBCABKAUSEwoLbWF4X3JldHJpZXMYBSABKAUSFgoObGVhc2VfZHVyYXRpb24YBiABKAUSFwoPY2hlY2twb2ludF9qc29uGAcgASgJEhEKCXRhZ3NfanNvbhgIIAEoCRIjCgVhZ2VudBgJIAEoCzIULmNvcnZvLnYxLkFnZW50U3RhdGUiOwoSRmV0Y2hCYXRjaFJlc3BvbnNlEiUKBGpvYnMYASADKAsyFy5jb3J2by52MS5GZXRjaEJhdGNoSm9iIqcBCgtVc2FnZVJlcG9ydBIUCgxpbnB1dF90b2tlbnMYASABKAMSFQoNb3V0cHV0X3Rva2VucxgCIAEoAxIdChVjYWNoZV9jcmVhdGlvbl90b2tlbnMYAyABKAMSGQoRY2FjaGVfcmVhZF90b2tlbnMYBCABKAMSDQoFbW9kZWwYBSABKAkSEAoIcHJvdmlkZXIYBiABKAkSEAoIY29zdF91c2QYByABKAEirwEKCkFja1JlcXVlc3QSDgoGam9iX2lkGAEgASgJEhMKC3Jlc3VsdF9qc29uGAIgASgJEiQKBXVzYWdlGAMgASgLMhUuY29ydm8udjEuVXNhZ2VSZXBvcnQSFwoPY2hlY2twb2ludF9qc29uGAQgASgJEhQKDGFnZW50X3N0YXR1cxgFIAEoCRITCgtob2xkX3JlYXNvbhgGIAEoCRISCgp0cmFjZV9qc29uGAcgASgJIg0KC0Fja1Jlc3BvbnNlIlkKDEFja0JhdGNoSXRlbRIOCgZqb2JfaWQYASABKAkSEwoLcmVzdWx0X2pzb24YAiABKAkSJAoFdXNhZ2UYAyABKAsyFS5jb3J2by52MS5Vc2FnZVJlcG9ydCI4Cg9BY2tCYXRjaFJlcXVlc3QSJQoFaXRlbXMYASADKAsyFi5jb3J2by52MS5BY2tCYXRjaEl0ZW0iIQoQQWNrQmF0Y2hSZXNwb25zZRINCgVhY2tlZBgBIAEoBSLmAQoWTGlmZWN5Y2xlU3RyZWFtUmVxdWVzdBISCgpyZXF1ZXN0X2lkGAEgASgEEg4KBnF1ZXVlcxgCIAMoCRIRCgl3b3JrZXJfaWQYAyABKAkSEAoIaG9zdG5hbWUYBCABKAkSFgoObGVhc2VfZHVyYXRpb24YBSABKAUSEwoLZmV0Y2hfY291bnQYBiABKAUSJAoEYWNrcxgHIAMoCzIWLmNvcnZvLnYxLkFja0JhdGNoSXRlbRIwCghlbnF1ZXVlcxgIIAMoCzIeLmNvcnZvLnYxLkxpZmVjeWNsZUVucXVldWVJdGVtImEKFExpZmVjeWNsZUVucXVldWVJdGVtEg0KBXF1ZXVlGAEgASgJEhQKDHBheWxvYWRfanNvbhgCIAEoCRIkCgVhZ2VudBgDIAEoCzIVLmNvcnZvLnYxLkFnZW50Q29uZmlnIlYKC0FnZW50Q29uZmlnEhYKDm1heF9pdGVyYXRpb25zGAEgASgFEhQKDG1heF9jb3N0X3VzZBgCIAEoARIZChFpdGVyYXRpb25fdGltZW91dBgDIAEoCSKAAQoKQWdlbnRTdGF0ZRIWCg5tYXhfaXRlcmF0aW9ucxgBIAEoBRIUCgxtYXhfY29zdF91c2QYAiABKAESGQoRaXRlcmF0aW9uX3RpbWVvdXQYAyABKAkSEQoJaXRlcmF0aW9uGAQgASgFEhYKDnRvdGFsX2Nvc3RfdXNkGAUgASgBIqEBChdMaWZlY3ljbGVTdHJlYW1SZXNwb25zZRISCgpyZXF1ZXN0X2lkGAEgASgEEiUKBGpvYnMYAiADKAsyFy5jb3J2by52MS5GZXRjaEJhdGNoSm9iEg0KBWFja2VkGAMgASgFEg0KBWVycm9yGAQgASgJEhgKEGVucXVldWVkX2pvYl9pZHMYBSADKAkSEwoLbGVhZGVyX2FkZHIYBiABKAkiPwoLRmFpbFJlcXVlc3QSDgoGam9iX2lkGAEgASgJEg0KBWVycm9yGAIgASgJEhEKCWJhY2t0cmFjZRgDIAEoCSJvCgxGYWlsUmVzcG9uc2USDgoGc3RhdHVzGAEgASgJEjMKD25leHRfYXR0ZW1wdF9hdBgCIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASGgoSYXR0ZW1wdHNfcmVtYWluaW5nGAMgASgFIoABChJIZWFydGJlYXRKb2JVcGRhdGUSFQoNcHJvZ3Jlc3NfanNvbhgBIAEoCRIXCg9jaGVja3BvaW50X2pzb24YAiABKAkSJAoFdXNhZ2UYAyABKAsyFS5jb3J2by52MS5Vc2FnZVJlcG9ydBIUCgxzdHJlYW1fZGVsdGEYBCABKAkikQEKEEhlYXJ0YmVhdFJlcXVlc3QSMgoEam9icxgBIAMoCzIkLmNvcnZvLnYxLkhlYXJ0YmVhdFJlcXVlc3QuSm9ic0VudHJ5GkkKCUpvYnNFbnRyeRILCgNrZXkYASABKAkSKwoFdmFsdWUYAiABKAsyHC5jb3J2by52MS5IZWFydGJlYXRKb2JVcGRhdGU6AjgBIiYKFEhlYXJ0YmVhdEpvYlJlc3BvbnNlEg4KBnN0YXR1cxgBIAEoCSKVAQoRSGVhcnRiZWF0UmVzcG9uc2USMwoEam9icxgBIAMoCzIlLmNvcnZvLnYxLkhlYXJ0YmVhdFJlc3BvbnNlLkpvYnNFbnRyeRpLCglKb2JzRW50cnkSCwoDa2V5GAEgASgJEi0KBXZhbHVlGAIgASgLMh4uY29ydm8udjEuSGVhcnRiZWF0Sm9iUmVzcG9uc2U6AjgBMrIECg1Xb3JrZXJTZXJ2aWNlEkAKB0VucXVldWUSGC5jb3J2by52MS5FbnF1ZXVlUmVxdWVzdBoZLmNvcnZvLnYxLkVucXVldWVSZXNwb25zZSIAEjoKBUZldGNoEhYuY29ydm8udjEuRmV0Y2hSZXF1ZXN0GhcuY29ydm8udjEuRmV0Y2hSZXNwb25zZSIAEkkKCkZldGNoQmF0Y2gSGy5jb3J2by52MS5GZXRjaEJhdGNoUmVxdWVzdBocLmNvcnZvLnYxLkZldGNoQmF0Y2hSZXNwb25zZSIAEjQKA0FjaxIULmNvcnZvLnYxLkFja1JlcXVlc3QaFS5jb3J2by52MS5BY2tSZXNwb25zZSIAEkMKCEFja0JhdGNoEhkuY29ydm8udjEuQWNrQmF0Y2hSZXF1ZXN0GhouY29ydm8udjEuQWNrQmF0Y2hSZXNwb25zZSIAElwKD1N0cmVhbUxpZmVjeWNsZRIgLmNvcnZvLnYxLkxpZmVjeWNsZVN0cmVhbVJlcXVlc3QaIS5jb3J2by52MS5MaWZlY3ljbGVTdHJlYW1SZXNwb25zZSIAKAEwARI3CgRGYWlsEhUuY29ydm8udjEuRmFpbFJlcXVlc3QaFi5jb3J2by52MS5GYWlsUmVzcG9uc2UiABJGCglIZWFydGJlYXQSGi5jb3J2by52MS5IZWFydGJlYXRSZXF1ZXN0GhsuY29ydm8udjEuSGVhcnRiZWF0UmVzcG9uc2UiAGIGcHJvdG8z", [file_google_protobuf_timestamp]);
+/**
+ * Describes the message corvo.v1.EnqueueRequest.
+ * Use `create(EnqueueRequestSchema)` to create a new message.
+ */
+export const EnqueueRequestSchema = /*@__PURE__*/ messageDesc(file_corvo_v1_worker, 0);
+/**
+ * Describes the message corvo.v1.EnqueueResponse.
+ * Use `create(EnqueueResponseSchema)` to create a new message.
+ */
+export const EnqueueResponseSchema = /*@__PURE__*/ messageDesc(file_corvo_v1_worker, 1);
+/**
+ * Describes the message corvo.v1.FetchRequest.
+ * Use `create(FetchRequestSchema)` to create a new message.
+ */
+export const FetchRequestSchema = /*@__PURE__*/ messageDesc(file_corvo_v1_worker, 2);
+/**
+ * Describes the message corvo.v1.FetchResponse.
+ * Use `create(FetchResponseSchema)` to create a new message.
+ */
+export const FetchResponseSchema = /*@__PURE__*/ messageDesc(file_corvo_v1_worker, 3);
+/**
+ * Describes the message corvo.v1.FetchBatchRequest.
+ * Use `create(FetchBatchRequestSchema)` to create a new message.
+ */
+export const FetchBatchRequestSchema = /*@__PURE__*/ messageDesc(file_corvo_v1_worker, 4);
+/**
+ * Describes the message corvo.v1.FetchBatchJob.
+ * Use `create(FetchBatchJobSchema)` to create a new message.
+ */
+export const FetchBatchJobSchema = /*@__PURE__*/ messageDesc(file_corvo_v1_worker, 5);
+/**
+ * Describes the message corvo.v1.FetchBatchResponse.
+ * Use `create(FetchBatchResponseSchema)` to create a new message.
+ */
+export const FetchBatchResponseSchema = /*@__PURE__*/ messageDesc(file_corvo_v1_worker, 6);
+/**
+ * Describes the message corvo.v1.UsageReport.
+ * Use `create(UsageReportSchema)` to create a new message.
+ */
+export const UsageReportSchema = /*@__PURE__*/ messageDesc(file_corvo_v1_worker, 7);
+/**
+ * Describes the message corvo.v1.AckRequest.
+ * Use `create(AckRequestSchema)` to create a new message.
+ */
+export const AckRequestSchema = /*@__PURE__*/ messageDesc(file_corvo_v1_worker, 8);
+/**
+ * Describes the message corvo.v1.AckResponse.
+ * Use `create(AckResponseSchema)` to create a new message.
+ */
+export const AckResponseSchema = /*@__PURE__*/ messageDesc(file_corvo_v1_worker, 9);
+/**
+ * Describes the message corvo.v1.AckBatchItem.
+ * Use `create(AckBatchItemSchema)` to create a new message.
+ */
+export const AckBatchItemSchema = /*@__PURE__*/ messageDesc(file_corvo_v1_worker, 10);
+/**
+ * Describes the message corvo.v1.AckBatchRequest.
+ * Use `create(AckBatchRequestSchema)` to create a new message.
+ */
+export const AckBatchRequestSchema = /*@__PURE__*/ messageDesc(file_corvo_v1_worker, 11);
+/**
+ * Describes the message corvo.v1.AckBatchResponse.
+ * Use `create(AckBatchResponseSchema)` to create a new message.
+ */
+export const AckBatchResponseSchema = /*@__PURE__*/ messageDesc(file_corvo_v1_worker, 12);
+/**
+ * Describes the message corvo.v1.LifecycleStreamRequest.
+ * Use `create(LifecycleStreamRequestSchema)` to create a new message.
+ */
+export const LifecycleStreamRequestSchema = /*@__PURE__*/ messageDesc(file_corvo_v1_worker, 13);
+/**
+ * Describes the message corvo.v1.LifecycleEnqueueItem.
+ * Use `create(LifecycleEnqueueItemSchema)` to create a new message.
+ */
+export const LifecycleEnqueueItemSchema = /*@__PURE__*/ messageDesc(file_corvo_v1_worker, 14);
+/**
+ * Describes the message corvo.v1.AgentConfig.
+ * Use `create(AgentConfigSchema)` to create a new message.
+ */
+export const AgentConfigSchema = /*@__PURE__*/ messageDesc(file_corvo_v1_worker, 15);
+/**
+ * Describes the message corvo.v1.AgentState.
+ * Use `create(AgentStateSchema)` to create a new message.
+ */
+export const AgentStateSchema = /*@__PURE__*/ messageDesc(file_corvo_v1_worker, 16);
+/**
+ * Describes the message corvo.v1.LifecycleStreamResponse.
+ * Use `create(LifecycleStreamResponseSchema)` to create a new message.
+ */
+export const LifecycleStreamResponseSchema = /*@__PURE__*/ messageDesc(file_corvo_v1_worker, 17);
+/**
+ * Describes the message corvo.v1.FailRequest.
+ * Use `create(FailRequestSchema)` to create a new message.
+ */
+export const FailRequestSchema = /*@__PURE__*/ messageDesc(file_corvo_v1_worker, 18);
+/**
+ * Describes the message corvo.v1.FailResponse.
+ * Use `create(FailResponseSchema)` to create a new message.
+ */
+export const FailResponseSchema = /*@__PURE__*/ messageDesc(file_corvo_v1_worker, 19);
+/**
+ * Describes the message corvo.v1.HeartbeatJobUpdate.
+ * Use `create(HeartbeatJobUpdateSchema)` to create a new message.
+ */
+export const HeartbeatJobUpdateSchema = /*@__PURE__*/ messageDesc(file_corvo_v1_worker, 20);
+/**
+ * Describes the message corvo.v1.HeartbeatRequest.
+ * Use `create(HeartbeatRequestSchema)` to create a new message.
+ */
+export const HeartbeatRequestSchema = /*@__PURE__*/ messageDesc(file_corvo_v1_worker, 21);
+/**
+ * Describes the message corvo.v1.HeartbeatJobResponse.
+ * Use `create(HeartbeatJobResponseSchema)` to create a new message.
+ */
+export const HeartbeatJobResponseSchema = /*@__PURE__*/ messageDesc(file_corvo_v1_worker, 22);
+/**
+ * Describes the message corvo.v1.HeartbeatResponse.
+ * Use `create(HeartbeatResponseSchema)` to create a new message.
+ */
+export const HeartbeatResponseSchema = /*@__PURE__*/ messageDesc(file_corvo_v1_worker, 23);
+/**
+ * @generated from service corvo.v1.WorkerService
+ */
+export const WorkerService = /*@__PURE__*/ serviceDesc(file_corvo_v1_worker, 0);

package/dist/index.d.ts

@@ -0,0 +1,156 @@
+export type EnqueueResult = {
+    job_id: string;
+    status: string;
+    unique_existing?: boolean;
+};
+export type SearchFilter = {
+    queue?: string;
+    state?: string[];
+    priority?: string;
+    tags?: Record<string, string>;
+    payload_contains?: string;
+    payload_jq?: string;
+    sort?: string;
+    order?: "asc" | "desc";
+    limit?: number;
+    cursor?: string;
+};
+export type SearchResult<T = Record<string, unknown>> = {
+    jobs: T[];
+    total: number;
+    cursor?: string;
+    has_more: boolean;
+};
+export type BulkRequest = {
+    job_ids?: string[];
+    filter?: SearchFilter;
+    action: "retry" | "delete" | "cancel" | "move" | "requeue" | "change_priority" | "hold" | "approve" | "reject";
+    move_to_queue?: string;
+    priority?: string;
+    async?: boolean;
+};
+export type BulkResult = {
+    affected: number;
+    errors: number;
+    duration_ms: number;
+};
+export type BulkAsyncStart = {
+    bulk_operation_id: string;
+    status: string;
+    estimated_total: number;
+    progress_url: string;
+};
+export type BulkTask = {
+    id: string;
+    status: "queued" | "running" | "completed" | "failed";
+    action: string;
+    total: number;
+    processed: number;
+    affected: number;
+    errors: number;
+    error?: string;
+    created_at: string;
+    updated_at: string;
+    finished_at?: string;
+};
+export type BatchJob = {
+    queue: string;
+    payload: unknown;
+    [key: string]: unknown;
+};
+export type BatchConfig = {
+    callback_queue: string;
+    callback_payload?: unknown;
+};
+export type BatchResult = {
+    job_ids: string[];
+    batch_id: string;
+};
+export type FetchedJob = {
+    job_id: string;
+    queue: string;
+    payload: unknown;
+    attempt: number;
+};
+export type HeartbeatResult = {
+    acked: string[];
+    unknown: string[];
+    canceled: string[];
+};
+export type ChainStep = {
+    queue: string;
+    payload: unknown;
+};
+export type ChainConfig = {
+    steps: ChainStep[];
+    on_failure?: "stop" | "continue";
+    on_exit?: ChainStep;
+};
+export type EnqueueOptions = {
+    queue: string;
+    payload: unknown;
+    priority?: string;
+    unique_key?: string;
+    unique_period?: number;
+    max_retries?: number;
+    scheduled_at?: string;
+    tags?: Record<string, string>;
+    expire_after?: string;
+    retry_backoff?: string;
+    retry_base_delay?: string;
+    retry_max_delay?: string;
+    chain?: ChainConfig;
+};
+export type AuthOptions = {
+    headers?: Record<string, string>;
+    bearerToken?: string;
+    apiKey?: string;
+    apiKeyHeader?: string;
+    tokenProvider?: () => Promise<string> | string;
+};
+export type ClientOptions = {
+    useRpc?: boolean;
+};
+export declare class PayloadTooLargeError extends Error {
+    constructor(message: string);
+}
+export declare function isPayloadTooLargeError(err: unknown): err is PayloadTooLargeError;
+export declare class CorvoClient {
+    readonly baseURL: string;
+    readonly fetchImpl: typeof fetch;
+    readonly auth: AuthOptions;
+    private readonly useRpc;
+    private rpcClient;
+    constructor(baseURL: string, fetchImpl?: typeof fetch, auth?: AuthOptions, opts?: ClientOptions);
+    private getRpc;
+    enqueue(queue: string, payload: unknown, extra?: Record<string, unknown>): Promise<EnqueueResult>;
+    enqueueWith(opts: EnqueueOptions): Promise<EnqueueResult>;
+    getJob<T = Record<string, unknown>>(id: string): Promise<T>;
+    search<T = Record<string, unknown>>(filter: SearchFilter): Promise<SearchResult<T>>;
+    bulk(req: BulkRequest): Promise<BulkResult | BulkAsyncStart>;
+    bulkStatus(id: string): Promise<BulkTask>;
+    fetchBatch(queues: string[], workerID: string, hostname?: string, timeout?: number, count?: number): Promise<{
+        jobs: FetchedJob[];
+    }>;
+    ackBatch(acks: {
+        job_id: string;
+        result?: Record<string, unknown>;
+    }[]): Promise<{
+        acked: number;
+    }>;
+    enqueueBatch(jobs: BatchJob[], batch?: BatchConfig): Promise<BatchResult>;
+    fetch(queues: string[], workerID: string, hostname?: string, timeout?: number): Promise<FetchedJob | null>;
+    ack(jobID: string, body?: Record<string, unknown>): Promise<{
+        status: string;
+    }>;
+    fail(jobID: string, error: string, backtrace?: string): Promise<{
+        status: string;
+    }>;
+    heartbeat(jobs: Record<string, Record<string, unknown>>): Promise<HeartbeatResult>;
+    retryJob(id: string): Promise<void>;
+    cancelJob(id: string): Promise<void>;
+    moveJob(id: string, targetQueue: string): Promise<void>;
+    deleteJob(id: string): Promise<void>;
+    private request;
+    authHeaders(): Promise<Record<string, string>>;
+}

package/dist/index.js

@@ -0,0 +1,178 @@
+export class PayloadTooLargeError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "PayloadTooLargeError";
+    }
+}
+export function isPayloadTooLargeError(err) {
+    return err instanceof PayloadTooLargeError;
+}
+export class CorvoClient {
+    constructor(baseURL, fetchImpl = fetch, auth = {}, opts = {}) {
+        this.rpcClient = null;
+        this.baseURL = baseURL.replace(/\/$/, "");
+        this.fetchImpl = fetchImpl;
+        this.auth = auth;
+        this.useRpc = opts.useRpc ?? false;
+    }
+    async getRpc() {
+        if (!this.rpcClient) {
+            const { ClientRpc } = await import("./rpc.js");
+            this.rpcClient = new ClientRpc(this.baseURL, this.auth);
+        }
+        return this.rpcClient;
+    }
+    async enqueue(queue, payload, extra = {}) {
+        if (this.useRpc && Object.keys(extra).length === 0) {
+            const rpc = await this.getRpc();
+            return rpc.enqueue(queue, payload);
+        }
+        return this.request("/api/v1/enqueue", {
+            method: "POST",
+            body: JSON.stringify({ queue, payload, ...extra }),
+        });
+    }
+    async enqueueWith(opts) {
+        return this.request("/api/v1/enqueue", {
+            method: "POST",
+            body: JSON.stringify(opts),
+        });
+    }
+    async getJob(id) {
+        return this.request(`/api/v1/jobs/${encodeURIComponent(id)}`, { method: "GET" });
+    }
+    async search(filter) {
+        return this.request("/api/v1/jobs/search", {
+            method: "POST",
+            body: JSON.stringify(filter),
+        });
+    }
+    async bulk(req) {
+        return this.request("/api/v1/jobs/bulk", {
+            method: "POST",
+            body: JSON.stringify(req),
+        });
+    }
+    async bulkStatus(id) {
+        return this.request(`/api/v1/bulk/${encodeURIComponent(id)}`, { method: "GET" });
+    }
+    async fetchBatch(queues, workerID, hostname = "corvo-worker", timeout = 30, count = 10) {
+        return this.request("/api/v1/fetch/batch", {
+            method: "POST",
+            body: JSON.stringify({ queues, worker_id: workerID, hostname, timeout, count }),
+        });
+    }
+    async ackBatch(acks) {
+        return this.request("/api/v1/ack/batch", {
+            method: "POST",
+            body: JSON.stringify({ acks }),
+        });
+    }
+    async enqueueBatch(jobs, batch) {
+        return this.request("/api/v1/enqueue/batch", {
+            method: "POST",
+            body: JSON.stringify({ jobs, batch }),
+        });
+    }
+    async fetch(queues, workerID, hostname = "corvo-worker", timeout = 30) {
+        const result = await this.request("/api/v1/fetch", {
+            method: "POST",
+            body: JSON.stringify({ queues, worker_id: workerID, hostname, timeout }),
+        });
+        if (!result || !result.job_id)
+            return null;
+        return result;
+    }
+    async ack(jobID, body = {}) {
+        return this.request(`/api/v1/ack/${encodeURIComponent(jobID)}`, {
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+    }
+    async fail(jobID, error, backtrace) {
+        if (this.useRpc) {
+            const rpc = await this.getRpc();
+            return rpc.fail(jobID, error, backtrace ?? "");
+        }
+        return this.request(`/api/v1/fail/${encodeURIComponent(jobID)}`, {
+            method: "POST",
+            body: JSON.stringify({ error, backtrace }),
+        });
+    }
+    async heartbeat(jobs) {
+        if (this.useRpc) {
+            const rpc = await this.getRpc();
+            // HeartbeatResult shape from HTTP differs from proto; adapt here
+            const resp = await rpc.heartbeat(jobs);
+            return resp;
+        }
+        return this.request("/api/v1/heartbeat", {
+            method: "POST",
+            body: JSON.stringify({ jobs }),
+        });
+    }
+    async retryJob(id) {
+        await this.request(`/api/v1/jobs/${encodeURIComponent(id)}/retry`, { method: "POST" });
+    }
+    async cancelJob(id) {
+        await this.request(`/api/v1/jobs/${encodeURIComponent(id)}/cancel`, { method: "POST" });
+    }
+    async moveJob(id, targetQueue) {
+        await this.request(`/api/v1/jobs/${encodeURIComponent(id)}/move`, {
+            method: "POST",
+            body: JSON.stringify({ queue: targetQueue }),
+        });
+    }
+    async deleteJob(id) {
+        await this.request(`/api/v1/jobs/${encodeURIComponent(id)}`, { method: "DELETE" });
+    }
+    async request(path, init) {
+        const authHeaders = await this.authHeaders();
+        const res = await this.fetchImpl(this.baseURL + path, {
+            ...init,
+            headers: {
+                "content-type": "application/json",
+                ...authHeaders,
+                ...(init.headers || {}),
+            },
+        });
+        if (!res.ok) {
+            let details = `HTTP ${res.status}`;
+            let code = "";
+            try {
+                const body = (await res.json());
+                if (body.error)
+                    details = body.error;
+                if (body.code)
+                    code = body.code;
+            }
+            catch {
+                // ignore decode errors for non-JSON responses
+            }
+            if (code === "PAYLOAD_TOO_LARGE")
+                throw new PayloadTooLargeError(details);
+            throw new Error(details);
+        }
+        if (res.status === 204) {
+            return {};
+        }
+        return (await res.json());
+    }
+    async authHeaders() {
+        const out = {};
+        if (this.auth.headers) {
+            Object.assign(out, this.auth.headers);
+        }
+        if (this.auth.apiKey) {
+            out[this.auth.apiKeyHeader || "X-API-Key"] = this.auth.apiKey;
+        }
+        let token = this.auth.bearerToken || "";
+        if (this.auth.tokenProvider) {
+            token = await this.auth.tokenProvider();
+        }
+        if (token) {
+            out.Authorization = `Bearer ${token}`;
+        }
+        return out;
+    }
+}

package/dist/rpc.d.ts

@@ -0,0 +1,18 @@
+import type { AuthOptions } from "./index.js";
+export declare class ClientRpc {
+    private readonly client;
+    constructor(baseUrl: string, auth?: AuthOptions);
+    enqueue(queue: string, payload: unknown): Promise<{
+        job_id: string;
+        status: string;
+        unique_existing?: boolean;
+    }>;
+    fail(jobId: string, error: string, backtrace?: string): Promise<{
+        status: string;
+    }>;
+    heartbeat(jobs: Record<string, Record<string, unknown>>): Promise<{
+        jobs: Record<string, {
+            status: string;
+        }>;
+    }>;
+}

package/dist/rpc.js

@@ -0,0 +1,71 @@
+import { createClient } from "@connectrpc/connect";
+import { createConnectTransport } from "@connectrpc/connect-node";
+import { create } from "@bufbuild/protobuf";
+import { WorkerService, HeartbeatJobUpdateSchema, } from "./gen/corvo/v1/worker_pb.js";
+// ---------------------------------------------------------------------------
+// Auth interceptor
+// ---------------------------------------------------------------------------
+const SDK_NAME = "corvo-typescript";
+const SDK_VERSION = "0.2.0";
+function authInterceptor(auth) {
+    return (next) => async (req) => {
+        req.header.set("x-corvo-client-name", SDK_NAME);
+        req.header.set("x-corvo-client-version", SDK_VERSION);
+        if (auth.headers) {
+            for (const [k, v] of Object.entries(auth.headers)) {
+                req.header.set(k, v);
+            }
+        }
+        if (auth.apiKey) {
+            req.header.set(auth.apiKeyHeader || "X-API-Key", auth.apiKey);
+        }
+        let token = auth.bearerToken || "";
+        if (auth.tokenProvider) {
+            token = await auth.tokenProvider();
+        }
+        if (token) {
+            req.header.set("authorization", `Bearer ${token}`);
+        }
+        return next(req);
+    };
+}
+export class ClientRpc {
+    constructor(baseUrl, auth = {}) {
+        const transport = createConnectTransport({
+            baseUrl: baseUrl.replace(/\/$/, ""),
+            httpVersion: "1.1",
+            useBinaryFormat: false,
+            interceptors: [authInterceptor(auth)],
+        });
+        this.client = createClient(WorkerService, transport);
+    }
+    async enqueue(queue, payload) {
+        const payloadJson = JSON.stringify(payload ?? {});
+        const resp = await this.client.enqueue({ queue, payloadJson });
+        return {
+            job_id: resp.jobId,
+            status: resp.status,
+            unique_existing: resp.uniqueExisting || undefined,
+        };
+    }
+    async fail(jobId, error, backtrace = "") {
+        const resp = await this.client.fail({ jobId, error, backtrace });
+        return { status: resp.status };
+    }
+    async heartbeat(jobs) {
+        const protoJobs = {};
+        for (const [id, update] of Object.entries(jobs)) {
+            protoJobs[id] = create(HeartbeatJobUpdateSchema, {
+                progressJson: update.progress ? JSON.stringify(update.progress) : "",
+                checkpointJson: update.checkpoint ? JSON.stringify(update.checkpoint) : "",
+                streamDelta: "",
+            });
+        }
+        const resp = await this.client.heartbeat({ jobs: protoJobs });
+        const out = {};
+        for (const [id, jr] of Object.entries(resp.jobs)) {
+            out[id] = { status: jr.status };
+        }
+        return { jobs: out };
+    }
+}

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@corvohq/client",
+  "version": "0.2.0",
+  "description": "TypeScript client for Corvo",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  },
+  "dependencies": {
+    "@connectrpc/connect": "^2.1.1",
+    "@connectrpc/connect-node": "^2.1.1",
+    "@bufbuild/protobuf": "^2.11.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.3"
+  }
+}