ringo-task-queue 0.1.0.dev0__py3-none-win_amd64.whl → 0.1.0.dev2__py3-none-win_amd64.whl

ringo_task_queue/_proto/ringo/v1/queue_pb2.py

@@ -28,7 +28,7 @@ from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
 from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n,ringo_task_queue/_proto/ringo/v1/queue.proto\x12\x08ringo.v1\x1a\x1egoogle/protobuf/duration.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"i\n\x10NegotiateRequest\x12\x10\n\x08sdk_name\x18\x01 \x01(\t\x12\x13\n\x0bsdk_version\x18\x02 \x01(\t\x12\x16\n\x0eprotocol_major\x18\x03 \x01(\r\x12\x16\n\x0eprotocol_minor\x18\x04 \x01(\r\"\x88\x01\n\x11NegotiateResponse\x12\x16\n\x0eserver_version\x18\x01 \x01(\t\x12\x16\n\x0eprotocol_major\x18\x02 \x01(\r\x12\x16\n\x0eprotocol_minor\x18\x03 \x01(\r\x12\x14\n\x0c\x63\x61pabilities\x18\x04 \x03(\t\x12\x15\n\rsession_token\x18\x05 \x01(\t\"W\n\x0eRequestContext\x12\x16\n\x0eprotocol_major\x18\x01 \x01(\r\x12\x16\n\x0eprotocol_minor\x18\x02 \x01(\r\x12\x15\n\rsession_token\x18\x03 \x01(\t\"\xbd\x01\n\x0b\x45rrorDetail\x12!\n\x04\x63ode\x18\x01 \x01(\x0e\x32\x13.ringo.v1.ErrorCode\x12\x0f\n\x07message\x18\x02 \x01(\t\x12\x12\n\nrequest_id\x18\x03 \x01(\t\x12\x35\n\x08metadata\x18\x04 \x03(\x0b\x32#.ringo.v1.ErrorDetail.MetadataEntry\x1a/\n\rMetadataEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\xed\x01\n\x0bRetryPolicy\x12\x14\n\x0cmax_attempts\x18\x01 \x01(\r\x12)\n\x08strategy\x18\x02 \x01(\x0e\x32\x17.ringo.v1.RetryStrategy\x12\x30\n\rinitial_delay\x18\x03 \x01(\x0b\x32\x19.google.protobuf.Duration\x12,\n\tmax_delay\x18\x04 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x12\n\nmultiplier\x18\x05 \x01(\x01\x12\x0e\n\x06jitter\x18\x06 \x01(\x01\x12\x19\n\x11\x64\x65\x63rease_priority\x18\x07 \x01(\x08\"\xc6\x01\n\x08TaskSpec\x12\x12\n\nunique_key\x18\x01 \x01(\t\x12\x0c\n\x04type\x18\x02 \x01(\t\x12\'\n\x07payload\x18\x03 \x01(\x0b\x32\x16.google.protobuf.Value\x12\x10\n\x08priority\x18\x04 \x01(\x05\x12+\n\x0cretry_policy\x18\x05 \x01(\x0b\x32\x15.ringo.v1.RetryPolicy\x12\x30\n\x0c\x61vailable_at\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xb8\x04\n\x04Task\x12\n\n\x02id\x18\x01 \x01(\t\x12\r\n\x05queue\x18\x02 \x01(\t\x12\x12\n\nunique_key\x18\x03 \x01(\t\x12\x0c\n\x04type\x18\x04 \x01(\t\x12\'\n\x07payload\x18\x05 \x01(\x0b\x32\x16.google.protobuf.Value\x12\x10\n\x08priority\x18\x06 \x01(\x05\x12$\n\x06status\x18\x07 \x01(\x0e\x32\x14.ringo.v1.TaskStatus\x12\x0f\n\x07\x61ttempt\x18\x08 \x01(\r\x12\x14\n\x0cmax_attempts\x18\t \x01(\r\x12\x30\n\x0c\x61vailable_at\x18\n \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12.\n\ncreated_at\x18\x0b \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12.\n\nupdated_at\x18\x0c \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x30\n\x0c\x63ompleted_at\x18\r \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x12\n\nlast_error\x18\x0e \x01(\t\x12\x1c\n\x14last_error_truncated\x18\x0f \x01(\x08\x12#\n\x08\x61ttempts\x18\x10 \x03(\x0b\x32\x11.ringo.v1.Attempt\x12$\n\x08progress\x18\x11 \x01(\x0b\x32\x12.ringo.v1.Progress\x12*\n\rcurrent_lease\x18\x12 \x01(\x0b\x32\x13.ringo.v1.LeaseInfo\"\xc6\x01\n\x07\x41ttempt\x12\x0e\n\x06number\x18\x01 \x01(\r\x12\x11\n\tworker_id\x18\x02 \x01(\t\x12.\n\nstarted_at\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x66inished_at\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x0f\n\x07outcome\x18\x05 \x01(\t\x12\r\n\x05\x65rror\x18\x06 \x01(\t\x12\x17\n\x0f\x65rror_truncated\x18\x07 \x01(\x08\"k\n\x08Progress\x12\x0f\n\x07\x63urrent\x18\x01 \x01(\x01\x12\r\n\x05total\x18\x02 \x01(\x01\x12\x0f\n\x07message\x18\x03 \x01(\t\x12.\n\nupdated_at\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"Z\n\tLeaseInfo\x12\x0f\n\x07\x61ttempt\x18\x01 \x01(\r\x12\x11\n\tworker_id\x18\x02 \x01(\t\x12)\n\x05until\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"|\n\x05Lease\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0f\n\x07\x61ttempt\x18\x02 \x01(\r\x12\x13\n\x0blease_token\x18\x03 \x01(\t\x12\x11\n\tworker_id\x18\x04 \x01(\t\x12)\n\x05until\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"J\n\nLeasedTask\x12\x1c\n\x04task\x18\x01 \x01(\x0b\x32\x0e.ringo.v1.Task\x12\x1e\n\x05lease\x18\x02 \x01(\x0b\x32\x0f.ringo.v1.Lease\"l\n\x0e\x45nqueueRequest\x12\r\n\x05queue\x18\x01 \x01(\t\x12 \n\x04task\x18\x02 \x01(\x0b\x32\x12.ringo.v1.TaskSpec\x12)\n\x07\x63ontext\x18\x0f \x01(\x0b\x32\x18.ringo.v1.RequestContext\"O\n\rEnqueueResult\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0f\n\x07\x63reated\x18\x02 \x01(\x08\x12\x1c\n\x04task\x18\x03 \x01(\x0b\x32\x0e.ringo.v1.Task\":\n\x0f\x45nqueueResponse\x12\'\n\x06result\x18\x01 \x01(\x0b\x32\x17.ringo.v1.EnqueueResult\"q\n\x12\x45nqueueManyRequest\x12\r\n\x05queue\x18\x01 \x01(\t\x12!\n\x05tasks\x18\x02 \x03(\x0b\x32\x12.ringo.v1.TaskSpec\x12)\n\x07\x63ontext\x18\x0f \x01(\x0b\x32\x18.ringo.v1.RequestContext\"o\n\x13\x45nqueueManyResponse\x12(\n\x07results\x18\x01 \x03(\x0b\x32\x17.ringo.v1.EnqueueResult\x12\x15\n\rcreated_count\x18\x02 \x01(\r\x12\x17\n\x0f\x64uplicate_count\x18\x03 \x01(\r\"z\n\x0eGetTaskRequest\x12\r\n\x05queue\x18\x01 \x01(\t\x12\x11\n\x07task_id\x18\x02 \x01(\tH\x00\x12\x14\n\nunique_key\x18\x03 \x01(\tH\x00\x12)\n\x07\x63ontext\x18\x0f \x01(\x0b\x32\x18.ringo.v1.RequestContextB\x05\n\x03key\"/\n\x0fGetTaskResponse\x12\x1c\n\x04task\x18\x01 \x01(\x0b\x32\x0e.ringo.v1.Task\"|\n\x10RetryTaskRequest\x12\r\n\x05queue\x18\x01 \x01(\t\x12\x11\n\x07task_id\x18\x02 \x01(\tH\x00\x12\x14\n\nunique_key\x18\x03 \x01(\tH\x00\x12)\n\x07\x63ontext\x18\x0f \x01(\x0b\x32\x18.ringo.v1.RequestContextB\x05\n\x03key\"1\n\x11RetryTaskResponse\x12\x1c\n\x04task\x18\x01 \x01(\x0b\x32\x0e.ringo.v1.Task\"\xe2\x01\n\x0c\x43laimRequest\x12\r\n\x05queue\x18\x01 \x01(\t\x12\x11\n\tworker_id\x18\x02 \x01(\t\x12\x12\n\ntask_types\x18\x03 \x03(\t\x12\r\n\x05limit\x18\x04 \x01(\r\x12/\n\x0cwait_timeout\x18\x05 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x31\n\x0elease_duration\x18\x06 \x01(\x0b\x32\x19.google.protobuf.Duration\x12)\n\x07\x63ontext\x18\x0f \x01(\x0b\x32\x18.ringo.v1.RequestContext\"4\n\rClaimResponse\x12#\n\x05tasks\x18\x01 \x03(\x0b\x32\x14.ringo.v1.LeasedTask\"A\n\x08LeaseRef\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0f\n\x07\x61ttempt\x18\x02 \x01(\r\x12\x13\n\x0blease_token\x18\x03 \x01(\t\"Z\n\nAckRequest\x12!\n\x05lease\x18\x01 \x01(\x0b\x32\x12.ringo.v1.LeaseRef\x12)\n\x07\x63ontext\x18\x0f \x01(\x0b\x32\x18.ringo.v1.RequestContext\"\r\n\x0b\x41\x63kResponse\"\xa3\x01\n\x0bNackRequest\x12!\n\x05lease\x18\x01 \x01(\x0b\x32\x12.ringo.v1.LeaseRef\x12\r\n\x05\x65rror\x18\x02 \x01(\t\x12\x37\n\x14retry_delay_override\x18\x03 \x01(\x0b\x32\x19.google.protobuf.Duration\x12)\n\x07\x63ontext\x18\x0f \x01(\x0b\x32\x18.ringo.v1.RequestContext\",\n\x0cNackResponse\x12\x1c\n\x04task\x18\x01 \x01(\x0b\x32\x0e.ringo.v1.Task\"l\n\rRejectRequest\x12!\n\x05lease\x18\x01 \x01(\x0b\x32\x12.ringo.v1.LeaseRef\x12\r\n\x05\x65rror\x18\x02 \x01(\t\x12)\n\x07\x63ontext\x18\x0f \x01(\x0b\x32\x18.ringo.v1.RequestContext\".\n\x0eRejectResponse\x12\x1c\n\x04task\x18\x01 \x01(\x0b\x32\x0e.ringo.v1.Task\"\x90\x01\n\x12\x45xtendLeaseRequest\x12!\n\x05lease\x18\x01 \x01(\x0b\x32\x12.ringo.v1.LeaseRef\x12,\n\textension\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x12)\n\x07\x63ontext\x18\x0f \x01(\x0b\x32\x18.ringo.v1.RequestContext\"5\n\x13\x45xtendLeaseResponse\x12\x1e\n\x05lease\x18\x01 \x01(\x0b\x32\x0f.ringo.v1.Lease\"\x96\x01\n\x15ReportProgressRequest\x12!\n\x05lease\x18\x01 \x01(\x0b\x32\x12.ringo.v1.LeaseRef\x12\x0f\n\x07\x63urrent\x18\x02 \x01(\x01\x12\r\n\x05total\x18\x03 \x01(\x01\x12\x0f\n\x07message\x18\x04 \x01(\t\x12)\n\x07\x63ontext\x18\x0f \x01(\x0b\x32\x18.ringo.v1.RequestContext\"\x18\n\x16ReportProgressResponse\"\xc1\x01\n\x12WorkerRegistration\x12\r\n\x05queue\x18\x01 \x01(\t\x12\x11\n\tworker_id\x18\x02 \x01(\t\x12\x12\n\ntask_types\x18\x03 \x03(\t\x12\x17\n\x0fmax_concurrency\x18\x04 \x01(\r\x12\x31\n\x0elease_duration\x18\x05 \x01(\x0b\x32\x19.google.protobuf.Duration\x12)\n\x07\x63ontext\x18\x0f \x01(\x0b\x32\x18.ringo.v1.RequestContext\"!\n\x0c\x43reditUpdate\x12\x11\n\tavailable\x18\x01 \x01(\r\"\x1c\n\x0bWorkerDrain\x12\r\n\x05\x62\x65gin\x18\x01 \x01(\x08\"q\n\x10WorkerRegistered\x12\x11\n\tworker_id\x18\x01 \x01(\t\x12\x17\n\x0fmax_concurrency\x18\x02 \x01(\r\x12\x31\n\x0elease_duration\x18\x03 \x01(\x0b\x32\x19.google.protobuf.Duration\"\x8f\x03\n\x0bWorkRequest\x12\x12\n\nrequest_id\x18\x01 \x01(\x04\x12\x30\n\x08register\x18\x02 \x01(\x0b\x32\x1c.ringo.v1.WorkerRegistrationH\x00\x12(\n\x06\x63redit\x18\x03 \x01(\x0b\x32\x16.ringo.v1.CreditUpdateH\x00\x12#\n\x03\x61\x63k\x18\x04 \x01(\x0b\x32\x14.ringo.v1.AckRequestH\x00\x12%\n\x04nack\x18\x05 \x01(\x0b\x32\x15.ringo.v1.NackRequestH\x00\x12)\n\x06reject\x18\x06 \x01(\x0b\x32\x17.ringo.v1.RejectRequestH\x00\x12\x34\n\x0c\x65xtend_lease\x18\x07 \x01(\x0b\x32\x1c.ringo.v1.ExtendLeaseRequestH\x00\x12\x33\n\x08progress\x18\x08 \x01(\x0b\x32\x1f.ringo.v1.ReportProgressRequestH\x00\x12&\n\x05\x64rain\x18\t \x01(\x0b\x32\x15.ringo.v1.WorkerDrainH\x00\x42\x06\n\x04\x62ody\"F\n\nWorkResult\x12\x12\n\nrequest_id\x18\x01 \x01(\x04\x12$\n\x05\x65rror\x18\x02 \x01(\x0b\x32\x15.ringo.v1.ErrorDetail\"\xc7\x01\n\x0cWorkResponse\x12$\n\x04task\x18\x01 \x01(\x0b\x32\x14.ringo.v1.LeasedTaskH\x00\x12&\n\x06result\x18\x02 \x01(\x0b\x32\x14.ringo.v1.WorkResultH\x00\x12/\n\theartbeat\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x12\x30\n\nregistered\x18\x04 \x01(\x0b\x32\x1a.ringo.v1.WorkerRegisteredH\x00\x42\x06\n\x04\x62ody*\xbf\x01\n\nTaskStatus\x12\x1b\n\x17TASK_STATUS_UNSPECIFIED\x10\x00\x12\x19\n\x15TASK_STATUS_SCHEDULED\x10\x01\x12\x15\n\x11TASK_STATUS_READY\x10\x02\x12\x16\n\x12TASK_STATUS_LEASED\x10\x03\x12\x19\n\x15TASK_STATUS_SUCCEEDED\x10\x04\x12\x14\n\x10TASK_STATUS_DEAD\x10\x05\x12\x19\n\x15TASK_STATUS_CANCELLED\x10\x06*i\n\rRetryStrategy\x12\x1e\n\x1aRETRY_STRATEGY_UNSPECIFIED\x10\x00\x12\x18\n\x14RETRY_STRATEGY_FIXED\x10\x01\x12\x1e\n\x1aRETRY_STRATEGY_EXPONENTIAL\x10\x02*\xac\x02\n\tErrorCode\x12\x1a\n\x16\x45RROR_CODE_UNSPECIFIED\x10\x00\x12\x1f\n\x1b\x45RROR_CODE_INVALID_ARGUMENT\x10\x01\x12\x18\n\x14\x45RROR_CODE_DUPLICATE\x10\x02\x12\x18\n\x14\x45RROR_CODE_NOT_FOUND\x10\x03\x12\x17\n\x13\x45RROR_CODE_CONFLICT\x10\x04\x12\x19\n\x15\x45RROR_CODE_LEASE_LOST\x10\x05\x12\x1a\n\x16\x45RROR_CODE_UNAVAILABLE\x10\x06\x12 \n\x1c\x45RROR_CODE_DEADLINE_EXCEEDED\x10\x07\x12#\n\x1f\x45RROR_CODE_INCOMPATIBLE_VERSION\x10\x08\x12\x17\n\x13\x45RROR_CODE_INTERNAL\x10\t2\xa4\x06\n\x0cQueueService\x12\x44\n\tNegotiate\x12\x1a.ringo.v1.NegotiateRequest\x1a\x1b.ringo.v1.NegotiateResponse\x12>\n\x07\x45nqueue\x12\x18.ringo.v1.EnqueueRequest\x1a\x19.ringo.v1.EnqueueResponse\x12J\n\x0b\x45nqueueMany\x12\x1c.ringo.v1.EnqueueManyRequest\x1a\x1d.ringo.v1.EnqueueManyResponse\x12>\n\x07GetTask\x12\x18.ringo.v1.GetTaskRequest\x1a\x19.ringo.v1.GetTaskResponse\x12\x44\n\tRetryTask\x12\x1a.ringo.v1.RetryTaskRequest\x1a\x1b.ringo.v1.RetryTaskResponse\x12\x38\n\x05\x43laim\x12\x16.ringo.v1.ClaimRequest\x1a\x17.ringo.v1.ClaimResponse\x12\x32\n\x03\x41\x63k\x12\x14.ringo.v1.AckRequest\x1a\x15.ringo.v1.AckResponse\x12\x35\n\x04Nack\x12\x15.ringo.v1.NackRequest\x1a\x16.ringo.v1.NackResponse\x12;\n\x06Reject\x12\x17.ringo.v1.RejectRequest\x1a\x18.ringo.v1.RejectResponse\x12J\n\x0b\x45xtendLease\x12\x1c.ringo.v1.ExtendLeaseRequest\x1a\x1d.ringo.v1.ExtendLeaseResponse\x12S\n\x0eReportProgress\x12\x1f.ringo.v1.ReportProgressRequest\x1a .ringo.v1.ReportProgressResponse\x12\x39\n\x04Work\x12\x15.ringo.v1.WorkRequest\x1a\x16.ringo.v1.WorkResponse(\x01\x30\x01\x42l\n\x16\x64\x65v.ringo.taskqueue.v1B\nQueueProtoP\x01ZDgithub.com/ringo-task-queue/ringo-task-queue/gen/go/ringo/v1;ringov1b\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n,ringo_task_queue/_proto/ringo/v1/queue.proto\x12\x08ringo.v1\x1a\x1egoogle/protobuf/duration.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"i\n\x10NegotiateRequest\x12\x10\n\x08sdk_name\x18\x01 \x01(\t\x12\x13\n\x0bsdk_version\x18\x02 \x01(\t\x12\x16\n\x0eprotocol_major\x18\x03 \x01(\r\x12\x16\n\x0eprotocol_minor\x18\x04 \x01(\r\"\x88\x01\n\x11NegotiateResponse\x12\x16\n\x0eserver_version\x18\x01 \x01(\t\x12\x16\n\x0eprotocol_major\x18\x02 \x01(\r\x12\x16\n\x0eprotocol_minor\x18\x03 \x01(\r\x12\x14\n\x0c\x63\x61pabilities\x18\x04 \x03(\t\x12\x15\n\rsession_token\x18\x05 \x01(\t\"W\n\x0eRequestContext\x12\x16\n\x0eprotocol_major\x18\x01 \x01(\r\x12\x16\n\x0eprotocol_minor\x18\x02 \x01(\r\x12\x15\n\rsession_token\x18\x03 \x01(\t\"\xbd\x01\n\x0b\x45rrorDetail\x12!\n\x04\x63ode\x18\x01 \x01(\x0e\x32\x13.ringo.v1.ErrorCode\x12\x0f\n\x07message\x18\x02 \x01(\t\x12\x12\n\nrequest_id\x18\x03 \x01(\t\x12\x35\n\x08metadata\x18\x04 \x03(\x0b\x32#.ringo.v1.ErrorDetail.MetadataEntry\x1a/\n\rMetadataEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\xed\x01\n\x0bRetryPolicy\x12\x14\n\x0cmax_attempts\x18\x01 \x01(\r\x12)\n\x08strategy\x18\x02 \x01(\x0e\x32\x17.ringo.v1.RetryStrategy\x12\x30\n\rinitial_delay\x18\x03 \x01(\x0b\x32\x19.google.protobuf.Duration\x12,\n\tmax_delay\x18\x04 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x12\n\nmultiplier\x18\x05 \x01(\x01\x12\x0e\n\x06jitter\x18\x06 \x01(\x01\x12\x19\n\x11\x64\x65\x63rease_priority\x18\x07 \x01(\x08\"\xc6\x01\n\x08TaskSpec\x12\x12\n\nunique_key\x18\x01 \x01(\t\x12\x0c\n\x04type\x18\x02 \x01(\t\x12\'\n\x07payload\x18\x03 \x01(\x0b\x32\x16.google.protobuf.Value\x12\x10\n\x08priority\x18\x04 \x01(\x05\x12+\n\x0cretry_policy\x18\x05 \x01(\x0b\x32\x15.ringo.v1.RetryPolicy\x12\x30\n\x0c\x61vailable_at\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xb8\x04\n\x04Task\x12\n\n\x02id\x18\x01 \x01(\t\x12\r\n\x05queue\x18\x02 \x01(\t\x12\x12\n\nunique_key\x18\x03 \x01(\t\x12\x0c\n\x04type\x18\x04 \x01(\t\x12\'\n\x07payload\x18\x05 \x01(\x0b\x32\x16.google.protobuf.Value\x12\x10\n\x08priority\x18\x06 \x01(\x05\x12$\n\x06status\x18\x07 \x01(\x0e\x32\x14.ringo.v1.TaskStatus\x12\x0f\n\x07\x61ttempt\x18\x08 \x01(\r\x12\x14\n\x0cmax_attempts\x18\t \x01(\r\x12\x30\n\x0c\x61vailable_at\x18\n \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12.\n\ncreated_at\x18\x0b \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12.\n\nupdated_at\x18\x0c \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x30\n\x0c\x63ompleted_at\x18\r \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x12\n\nlast_error\x18\x0e \x01(\t\x12\x1c\n\x14last_error_truncated\x18\x0f \x01(\x08\x12#\n\x08\x61ttempts\x18\x10 \x03(\x0b\x32\x11.ringo.v1.Attempt\x12$\n\x08progress\x18\x11 \x01(\x0b\x32\x12.ringo.v1.Progress\x12*\n\rcurrent_lease\x18\x12 \x01(\x0b\x32\x13.ringo.v1.LeaseInfo\"\xc6\x01\n\x07\x41ttempt\x12\x0e\n\x06number\x18\x01 \x01(\r\x12\x11\n\tworker_id\x18\x02 \x01(\t\x12.\n\nstarted_at\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x66inished_at\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x0f\n\x07outcome\x18\x05 \x01(\t\x12\r\n\x05\x65rror\x18\x06 \x01(\t\x12\x17\n\x0f\x65rror_truncated\x18\x07 \x01(\x08\"k\n\x08Progress\x12\x0f\n\x07\x63urrent\x18\x01 \x01(\x01\x12\r\n\x05total\x18\x02 \x01(\x01\x12\x0f\n\x07message\x18\x03 \x01(\t\x12.\n\nupdated_at\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"Z\n\tLeaseInfo\x12\x0f\n\x07\x61ttempt\x18\x01 \x01(\r\x12\x11\n\tworker_id\x18\x02 \x01(\t\x12)\n\x05until\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"|\n\x05Lease\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0f\n\x07\x61ttempt\x18\x02 \x01(\r\x12\x13\n\x0blease_token\x18\x03 \x01(\t\x12\x11\n\tworker_id\x18\x04 \x01(\t\x12)\n\x05until\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"J\n\nLeasedTask\x12\x1c\n\x04task\x18\x01 \x01(\x0b\x32\x0e.ringo.v1.Task\x12\x1e\n\x05lease\x18\x02 \x01(\x0b\x32\x0f.ringo.v1.Lease\"l\n\x0e\x45nqueueRequest\x12\r\n\x05queue\x18\x01 \x01(\t\x12 \n\x04task\x18\x02 \x01(\x0b\x32\x12.ringo.v1.TaskSpec\x12)\n\x07\x63ontext\x18\x0f \x01(\x0b\x32\x18.ringo.v1.RequestContext\"O\n\rEnqueueResult\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0f\n\x07\x63reated\x18\x02 \x01(\x08\x12\x1c\n\x04task\x18\x03 \x01(\x0b\x32\x0e.ringo.v1.Task\":\n\x0f\x45nqueueResponse\x12\'\n\x06result\x18\x01 \x01(\x0b\x32\x17.ringo.v1.EnqueueResult\"q\n\x12\x45nqueueManyRequest\x12\r\n\x05queue\x18\x01 \x01(\t\x12!\n\x05tasks\x18\x02 \x03(\x0b\x32\x12.ringo.v1.TaskSpec\x12)\n\x07\x63ontext\x18\x0f \x01(\x0b\x32\x18.ringo.v1.RequestContext\"o\n\x13\x45nqueueManyResponse\x12(\n\x07results\x18\x01 \x03(\x0b\x32\x17.ringo.v1.EnqueueResult\x12\x15\n\rcreated_count\x18\x02 \x01(\r\x12\x17\n\x0f\x64uplicate_count\x18\x03 \x01(\r\"z\n\x0eGetTaskRequest\x12\r\n\x05queue\x18\x01 \x01(\t\x12\x11\n\x07task_id\x18\x02 \x01(\tH\x00\x12\x14\n\nunique_key\x18\x03 \x01(\tH\x00\x12)\n\x07\x63ontext\x18\x0f \x01(\x0b\x32\x18.ringo.v1.RequestContextB\x05\n\x03key\"/\n\x0fGetTaskResponse\x12\x1c\n\x04task\x18\x01 \x01(\x0b\x32\x0e.ringo.v1.Task\"g\n\x17GetQueueActivityRequest\x12\r\n\x05queue\x18\x01 \x01(\t\x12\x12\n\ntask_types\x18\x02 \x03(\t\x12)\n\x07\x63ontext\x18\x0f \x01(\x0b\x32\x18.ringo.v1.RequestContext\"5\n\x18GetQueueActivityResponse\x12\x19\n\x11\x61\x63tive_task_count\x18\x01 \x01(\x04\"|\n\x10RetryTaskRequest\x12\r\n\x05queue\x18\x01 \x01(\t\x12\x11\n\x07task_id\x18\x02 \x01(\tH\x00\x12\x14\n\nunique_key\x18\x03 \x01(\tH\x00\x12)\n\x07\x63ontext\x18\x0f \x01(\x0b\x32\x18.ringo.v1.RequestContextB\x05\n\x03key\"1\n\x11RetryTaskResponse\x12\x1c\n\x04task\x18\x01 \x01(\x0b\x32\x0e.ringo.v1.Task\"\xe2\x01\n\x0c\x43laimRequest\x12\r\n\x05queue\x18\x01 \x01(\t\x12\x11\n\tworker_id\x18\x02 \x01(\t\x12\x12\n\ntask_types\x18\x03 \x03(\t\x12\r\n\x05limit\x18\x04 \x01(\r\x12/\n\x0cwait_timeout\x18\x05 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x31\n\x0elease_duration\x18\x06 \x01(\x0b\x32\x19.google.protobuf.Duration\x12)\n\x07\x63ontext\x18\x0f \x01(\x0b\x32\x18.ringo.v1.RequestContext\"4\n\rClaimResponse\x12#\n\x05tasks\x18\x01 \x03(\x0b\x32\x14.ringo.v1.LeasedTask\"A\n\x08LeaseRef\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0f\n\x07\x61ttempt\x18\x02 \x01(\r\x12\x13\n\x0blease_token\x18\x03 \x01(\t\"Z\n\nAckRequest\x12!\n\x05lease\x18\x01 \x01(\x0b\x32\x12.ringo.v1.LeaseRef\x12)\n\x07\x63ontext\x18\x0f \x01(\x0b\x32\x18.ringo.v1.RequestContext\"\r\n\x0b\x41\x63kResponse\"\xa3\x01\n\x0bNackRequest\x12!\n\x05lease\x18\x01 \x01(\x0b\x32\x12.ringo.v1.LeaseRef\x12\r\n\x05\x65rror\x18\x02 \x01(\t\x12\x37\n\x14retry_delay_override\x18\x03 \x01(\x0b\x32\x19.google.protobuf.Duration\x12)\n\x07\x63ontext\x18\x0f \x01(\x0b\x32\x18.ringo.v1.RequestContext\",\n\x0cNackResponse\x12\x1c\n\x04task\x18\x01 \x01(\x0b\x32\x0e.ringo.v1.Task\"l\n\rRejectRequest\x12!\n\x05lease\x18\x01 \x01(\x0b\x32\x12.ringo.v1.LeaseRef\x12\r\n\x05\x65rror\x18\x02 \x01(\t\x12)\n\x07\x63ontext\x18\x0f \x01(\x0b\x32\x18.ringo.v1.RequestContext\".\n\x0eRejectResponse\x12\x1c\n\x04task\x18\x01 \x01(\x0b\x32\x0e.ringo.v1.Task\"\x90\x01\n\x12\x45xtendLeaseRequest\x12!\n\x05lease\x18\x01 \x01(\x0b\x32\x12.ringo.v1.LeaseRef\x12,\n\textension\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x12)\n\x07\x63ontext\x18\x0f \x01(\x0b\x32\x18.ringo.v1.RequestContext\"5\n\x13\x45xtendLeaseResponse\x12\x1e\n\x05lease\x18\x01 \x01(\x0b\x32\x0f.ringo.v1.Lease\"\x96\x01\n\x15ReportProgressRequest\x12!\n\x05lease\x18\x01 \x01(\x0b\x32\x12.ringo.v1.LeaseRef\x12\x0f\n\x07\x63urrent\x18\x02 \x01(\x01\x12\r\n\x05total\x18\x03 \x01(\x01\x12\x0f\n\x07message\x18\x04 \x01(\t\x12)\n\x07\x63ontext\x18\x0f \x01(\x0b\x32\x18.ringo.v1.RequestContext\"\x18\n\x16ReportProgressResponse\"\xc1\x01\n\x12WorkerRegistration\x12\r\n\x05queue\x18\x01 \x01(\t\x12\x11\n\tworker_id\x18\x02 \x01(\t\x12\x12\n\ntask_types\x18\x03 \x03(\t\x12\x17\n\x0fmax_concurrency\x18\x04 \x01(\r\x12\x31\n\x0elease_duration\x18\x05 \x01(\x0b\x32\x19.google.protobuf.Duration\x12)\n\x07\x63ontext\x18\x0f \x01(\x0b\x32\x18.ringo.v1.RequestContext\"!\n\x0c\x43reditUpdate\x12\x11\n\tavailable\x18\x01 \x01(\r\"\x1c\n\x0bWorkerDrain\x12\r\n\x05\x62\x65gin\x18\x01 \x01(\x08\"q\n\x10WorkerRegistered\x12\x11\n\tworker_id\x18\x01 \x01(\t\x12\x17\n\x0fmax_concurrency\x18\x02 \x01(\r\x12\x31\n\x0elease_duration\x18\x03 \x01(\x0b\x32\x19.google.protobuf.Duration\"\x8f\x03\n\x0bWorkRequest\x12\x12\n\nrequest_id\x18\x01 \x01(\x04\x12\x30\n\x08register\x18\x02 \x01(\x0b\x32\x1c.ringo.v1.WorkerRegistrationH\x00\x12(\n\x06\x63redit\x18\x03 \x01(\x0b\x32\x16.ringo.v1.CreditUpdateH\x00\x12#\n\x03\x61\x63k\x18\x04 \x01(\x0b\x32\x14.ringo.v1.AckRequestH\x00\x12%\n\x04nack\x18\x05 \x01(\x0b\x32\x15.ringo.v1.NackRequestH\x00\x12)\n\x06reject\x18\x06 \x01(\x0b\x32\x17.ringo.v1.RejectRequestH\x00\x12\x34\n\x0c\x65xtend_lease\x18\x07 \x01(\x0b\x32\x1c.ringo.v1.ExtendLeaseRequestH\x00\x12\x33\n\x08progress\x18\x08 \x01(\x0b\x32\x1f.ringo.v1.ReportProgressRequestH\x00\x12&\n\x05\x64rain\x18\t \x01(\x0b\x32\x15.ringo.v1.WorkerDrainH\x00\x42\x06\n\x04\x62ody\"F\n\nWorkResult\x12\x12\n\nrequest_id\x18\x01 \x01(\x04\x12$\n\x05\x65rror\x18\x02 \x01(\x0b\x32\x15.ringo.v1.ErrorDetail\"\xc7\x01\n\x0cWorkResponse\x12$\n\x04task\x18\x01 \x01(\x0b\x32\x14.ringo.v1.LeasedTaskH\x00\x12&\n\x06result\x18\x02 \x01(\x0b\x32\x14.ringo.v1.WorkResultH\x00\x12/\n\theartbeat\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x12\x30\n\nregistered\x18\x04 \x01(\x0b\x32\x1a.ringo.v1.WorkerRegisteredH\x00\x42\x06\n\x04\x62ody*\xbf\x01\n\nTaskStatus\x12\x1b\n\x17TASK_STATUS_UNSPECIFIED\x10\x00\x12\x19\n\x15TASK_STATUS_SCHEDULED\x10\x01\x12\x15\n\x11TASK_STATUS_READY\x10\x02\x12\x16\n\x12TASK_STATUS_LEASED\x10\x03\x12\x19\n\x15TASK_STATUS_SUCCEEDED\x10\x04\x12\x14\n\x10TASK_STATUS_DEAD\x10\x05\x12\x19\n\x15TASK_STATUS_CANCELLED\x10\x06*i\n\rRetryStrategy\x12\x1e\n\x1aRETRY_STRATEGY_UNSPECIFIED\x10\x00\x12\x18\n\x14RETRY_STRATEGY_FIXED\x10\x01\x12\x1e\n\x1aRETRY_STRATEGY_EXPONENTIAL\x10\x02*\xac\x02\n\tErrorCode\x12\x1a\n\x16\x45RROR_CODE_UNSPECIFIED\x10\x00\x12\x1f\n\x1b\x45RROR_CODE_INVALID_ARGUMENT\x10\x01\x12\x18\n\x14\x45RROR_CODE_DUPLICATE\x10\x02\x12\x18\n\x14\x45RROR_CODE_NOT_FOUND\x10\x03\x12\x17\n\x13\x45RROR_CODE_CONFLICT\x10\x04\x12\x19\n\x15\x45RROR_CODE_LEASE_LOST\x10\x05\x12\x1a\n\x16\x45RROR_CODE_UNAVAILABLE\x10\x06\x12 \n\x1c\x45RROR_CODE_DEADLINE_EXCEEDED\x10\x07\x12#\n\x1f\x45RROR_CODE_INCOMPATIBLE_VERSION\x10\x08\x12\x17\n\x13\x45RROR_CODE_INTERNAL\x10\t2\xff\x06\n\x0cQueueService\x12\x44\n\tNegotiate\x12\x1a.ringo.v1.NegotiateRequest\x1a\x1b.ringo.v1.NegotiateResponse\x12>\n\x07\x45nqueue\x12\x18.ringo.v1.EnqueueRequest\x1a\x19.ringo.v1.EnqueueResponse\x12J\n\x0b\x45nqueueMany\x12\x1c.ringo.v1.EnqueueManyRequest\x1a\x1d.ringo.v1.EnqueueManyResponse\x12>\n\x07GetTask\x12\x18.ringo.v1.GetTaskRequest\x1a\x19.ringo.v1.GetTaskResponse\x12Y\n\x10GetQueueActivity\x12!.ringo.v1.GetQueueActivityRequest\x1a\".ringo.v1.GetQueueActivityResponse\x12\x44\n\tRetryTask\x12\x1a.ringo.v1.RetryTaskRequest\x1a\x1b.ringo.v1.RetryTaskResponse\x12\x38\n\x05\x43laim\x12\x16.ringo.v1.ClaimRequest\x1a\x17.ringo.v1.ClaimResponse\x12\x32\n\x03\x41\x63k\x12\x14.ringo.v1.AckRequest\x1a\x15.ringo.v1.AckResponse\x12\x35\n\x04Nack\x12\x15.ringo.v1.NackRequest\x1a\x16.ringo.v1.NackResponse\x12;\n\x06Reject\x12\x17.ringo.v1.RejectRequest\x1a\x18.ringo.v1.RejectResponse\x12J\n\x0b\x45xtendLease\x12\x1c.ringo.v1.ExtendLeaseRequest\x1a\x1d.ringo.v1.ExtendLeaseResponse\x12S\n\x0eReportProgress\x12\x1f.ringo.v1.ReportProgressRequest\x1a .ringo.v1.ReportProgressResponse\x12\x39\n\x04Work\x12\x15.ringo.v1.WorkRequest\x1a\x16.ringo.v1.WorkResponse(\x01\x30\x01\x42l\n\x16\x64\x65v.ringo.taskqueue.v1B\nQueueProtoP\x01ZDgithub.com/ringo-task-queue/ringo-task-queue/gen/go/ringo/v1;ringov1b\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -38,12 +38,12 @@ if not _descriptor._USE_C_DESCRIPTORS:
   _globals['DESCRIPTOR']._serialized_options = b'\n\026dev.ringo.taskqueue.v1B\nQueueProtoP\001ZDgithub.com/ringo-task-queue/ringo-task-queue/gen/go/ringo/v1;ringov1'
   _globals['_ERRORDETAIL_METADATAENTRY']._loaded_options = None
   _globals['_ERRORDETAIL_METADATAENTRY']._serialized_options = b'8\001'
-  _globals['_TASKSTATUS']._serialized_start=5386
-  _globals['_TASKSTATUS']._serialized_end=5577
-  _globals['_RETRYSTRATEGY']._serialized_start=5579
-  _globals['_RETRYSTRATEGY']._serialized_end=5684
-  _globals['_ERRORCODE']._serialized_start=5687
-  _globals['_ERRORCODE']._serialized_end=5987
+  _globals['_TASKSTATUS']._serialized_start=5546
+  _globals['_TASKSTATUS']._serialized_end=5737
+  _globals['_RETRYSTRATEGY']._serialized_start=5739
+  _globals['_RETRYSTRATEGY']._serialized_end=5844
+  _globals['_ERRORCODE']._serialized_start=5847
+  _globals['_ERRORCODE']._serialized_end=6147
   _globals['_NEGOTIATEREQUEST']._serialized_start=153
   _globals['_NEGOTIATEREQUEST']._serialized_end=258
   _globals['_NEGOTIATERESPONSE']._serialized_start=261
@@ -84,50 +84,54 @@ if not _descriptor._USE_C_DESCRIPTORS:
   _globals['_GETTASKREQUEST']._serialized_end=2897
   _globals['_GETTASKRESPONSE']._serialized_start=2899
   _globals['_GETTASKRESPONSE']._serialized_end=2946
-  _globals['_RETRYTASKREQUEST']._serialized_start=2948
-  _globals['_RETRYTASKREQUEST']._serialized_end=3072
-  _globals['_RETRYTASKRESPONSE']._serialized_start=3074
-  _globals['_RETRYTASKRESPONSE']._serialized_end=3123
-  _globals['_CLAIMREQUEST']._serialized_start=3126
-  _globals['_CLAIMREQUEST']._serialized_end=3352
-  _globals['_CLAIMRESPONSE']._serialized_start=3354
-  _globals['_CLAIMRESPONSE']._serialized_end=3406
-  _globals['_LEASEREF']._serialized_start=3408
-  _globals['_LEASEREF']._serialized_end=3473
-  _globals['_ACKREQUEST']._serialized_start=3475
-  _globals['_ACKREQUEST']._serialized_end=3565
-  _globals['_ACKRESPONSE']._serialized_start=3567
-  _globals['_ACKRESPONSE']._serialized_end=3580
-  _globals['_NACKREQUEST']._serialized_start=3583
-  _globals['_NACKREQUEST']._serialized_end=3746
-  _globals['_NACKRESPONSE']._serialized_start=3748
-  _globals['_NACKRESPONSE']._serialized_end=3792
-  _globals['_REJECTREQUEST']._serialized_start=3794
-  _globals['_REJECTREQUEST']._serialized_end=3902
-  _globals['_REJECTRESPONSE']._serialized_start=3904
-  _globals['_REJECTRESPONSE']._serialized_end=3950
-  _globals['_EXTENDLEASEREQUEST']._serialized_start=3953
-  _globals['_EXTENDLEASEREQUEST']._serialized_end=4097
-  _globals['_EXTENDLEASERESPONSE']._serialized_start=4099
-  _globals['_EXTENDLEASERESPONSE']._serialized_end=4152
-  _globals['_REPORTPROGRESSREQUEST']._serialized_start=4155
-  _globals['_REPORTPROGRESSREQUEST']._serialized_end=4305
-  _globals['_REPORTPROGRESSRESPONSE']._serialized_start=4307
-  _globals['_REPORTPROGRESSRESPONSE']._serialized_end=4331
-  _globals['_WORKERREGISTRATION']._serialized_start=4334
-  _globals['_WORKERREGISTRATION']._serialized_end=4527
-  _globals['_CREDITUPDATE']._serialized_start=4529
-  _globals['_CREDITUPDATE']._serialized_end=4562
-  _globals['_WORKERDRAIN']._serialized_start=4564
-  _globals['_WORKERDRAIN']._serialized_end=4592
-  _globals['_WORKERREGISTERED']._serialized_start=4594
-  _globals['_WORKERREGISTERED']._serialized_end=4707
-  _globals['_WORKREQUEST']._serialized_start=4710
-  _globals['_WORKREQUEST']._serialized_end=5109
-  _globals['_WORKRESULT']._serialized_start=5111
-  _globals['_WORKRESULT']._serialized_end=5181
-  _globals['_WORKRESPONSE']._serialized_start=5184
-  _globals['_WORKRESPONSE']._serialized_end=5383
-  _globals['_QUEUESERVICE']._serialized_start=5990
-  _globals['_QUEUESERVICE']._serialized_end=6794
+  _globals['_GETQUEUEACTIVITYREQUEST']._serialized_start=2948
+  _globals['_GETQUEUEACTIVITYREQUEST']._serialized_end=3051
+  _globals['_GETQUEUEACTIVITYRESPONSE']._serialized_start=3053
+  _globals['_GETQUEUEACTIVITYRESPONSE']._serialized_end=3106
+  _globals['_RETRYTASKREQUEST']._serialized_start=3108
+  _globals['_RETRYTASKREQUEST']._serialized_end=3232
+  _globals['_RETRYTASKRESPONSE']._serialized_start=3234
+  _globals['_RETRYTASKRESPONSE']._serialized_end=3283
+  _globals['_CLAIMREQUEST']._serialized_start=3286
+  _globals['_CLAIMREQUEST']._serialized_end=3512
+  _globals['_CLAIMRESPONSE']._serialized_start=3514
+  _globals['_CLAIMRESPONSE']._serialized_end=3566
+  _globals['_LEASEREF']._serialized_start=3568
+  _globals['_LEASEREF']._serialized_end=3633
+  _globals['_ACKREQUEST']._serialized_start=3635
+  _globals['_ACKREQUEST']._serialized_end=3725
+  _globals['_ACKRESPONSE']._serialized_start=3727
+  _globals['_ACKRESPONSE']._serialized_end=3740
+  _globals['_NACKREQUEST']._serialized_start=3743
+  _globals['_NACKREQUEST']._serialized_end=3906
+  _globals['_NACKRESPONSE']._serialized_start=3908
+  _globals['_NACKRESPONSE']._serialized_end=3952
+  _globals['_REJECTREQUEST']._serialized_start=3954
+  _globals['_REJECTREQUEST']._serialized_end=4062
+  _globals['_REJECTRESPONSE']._serialized_start=4064
+  _globals['_REJECTRESPONSE']._serialized_end=4110
+  _globals['_EXTENDLEASEREQUEST']._serialized_start=4113
+  _globals['_EXTENDLEASEREQUEST']._serialized_end=4257
+  _globals['_EXTENDLEASERESPONSE']._serialized_start=4259
+  _globals['_EXTENDLEASERESPONSE']._serialized_end=4312
+  _globals['_REPORTPROGRESSREQUEST']._serialized_start=4315
+  _globals['_REPORTPROGRESSREQUEST']._serialized_end=4465
+  _globals['_REPORTPROGRESSRESPONSE']._serialized_start=4467
+  _globals['_REPORTPROGRESSRESPONSE']._serialized_end=4491
+  _globals['_WORKERREGISTRATION']._serialized_start=4494
+  _globals['_WORKERREGISTRATION']._serialized_end=4687
+  _globals['_CREDITUPDATE']._serialized_start=4689
+  _globals['_CREDITUPDATE']._serialized_end=4722
+  _globals['_WORKERDRAIN']._serialized_start=4724
+  _globals['_WORKERDRAIN']._serialized_end=4752
+  _globals['_WORKERREGISTERED']._serialized_start=4754
+  _globals['_WORKERREGISTERED']._serialized_end=4867
+  _globals['_WORKREQUEST']._serialized_start=4870
+  _globals['_WORKREQUEST']._serialized_end=5269
+  _globals['_WORKRESULT']._serialized_start=5271
+  _globals['_WORKRESULT']._serialized_end=5341
+  _globals['_WORKRESPONSE']._serialized_start=5344
+  _globals['_WORKRESPONSE']._serialized_end=5543
+  _globals['_QUEUESERVICE']._serialized_start=6150
+  _globals['_QUEUESERVICE']._serialized_end=7045
 # @@protoc_insertion_point(module_scope)

ringo_task_queue/_proto/ringo/v1/queue_pb2_grpc.py

@@ -56,6 +56,11 @@ class QueueServiceStub(object):
                 request_serializer=ringo__task__queue_dot___proto_dot_ringo_dot_v1_dot_queue__pb2.GetTaskRequest.SerializeToString,
                 response_deserializer=ringo__task__queue_dot___proto_dot_ringo_dot_v1_dot_queue__pb2.GetTaskResponse.FromString,
                 _registered_method=True)
+        self.GetQueueActivity = channel.unary_unary(
+                '/ringo.v1.QueueService/GetQueueActivity',
+                request_serializer=ringo__task__queue_dot___proto_dot_ringo_dot_v1_dot_queue__pb2.GetQueueActivityRequest.SerializeToString,
+                response_deserializer=ringo__task__queue_dot___proto_dot_ringo_dot_v1_dot_queue__pb2.GetQueueActivityResponse.FromString,
+                _registered_method=True)
         self.RetryTask = channel.unary_unary(
                 '/ringo.v1.QueueService/RetryTask',
                 request_serializer=ringo__task__queue_dot___proto_dot_ringo_dot_v1_dot_queue__pb2.RetryTaskRequest.SerializeToString,
@@ -126,6 +131,14 @@ class QueueServiceServicer(object):
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
+    def GetQueueActivity(self, request, context):
+        """GetQueueActivity returns a point-in-time queue/type-scope activity count.
+        It is read-only and does not seal the queue or promise durable completion.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
     def RetryTask(self, request, context):
         """Missing associated documentation comment in .proto file."""
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
@@ -197,6 +210,11 @@ def add_QueueServiceServicer_to_server(servicer, server):
                     request_deserializer=ringo__task__queue_dot___proto_dot_ringo_dot_v1_dot_queue__pb2.GetTaskRequest.FromString,
                     response_serializer=ringo__task__queue_dot___proto_dot_ringo_dot_v1_dot_queue__pb2.GetTaskResponse.SerializeToString,
             ),
+            'GetQueueActivity': grpc.unary_unary_rpc_method_handler(
+                    servicer.GetQueueActivity,
+                    request_deserializer=ringo__task__queue_dot___proto_dot_ringo_dot_v1_dot_queue__pb2.GetQueueActivityRequest.FromString,
+                    response_serializer=ringo__task__queue_dot___proto_dot_ringo_dot_v1_dot_queue__pb2.GetQueueActivityResponse.SerializeToString,
+            ),
             'RetryTask': grpc.unary_unary_rpc_method_handler(
                     servicer.RetryTask,
                     request_deserializer=ringo__task__queue_dot___proto_dot_ringo_dot_v1_dot_queue__pb2.RetryTaskRequest.FromString,
@@ -357,6 +375,33 @@ class QueueService(object):
             metadata,
             _registered_method=True)
 
+    @staticmethod
+    def GetQueueActivity(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/ringo.v1.QueueService/GetQueueActivity',
+            ringo__task__queue_dot___proto_dot_ringo_dot_v1_dot_queue__pb2.GetQueueActivityRequest.SerializeToString,
+            ringo__task__queue_dot___proto_dot_ringo_dot_v1_dot_queue__pb2.GetQueueActivityResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
     @staticmethod
     def RetryTask(request,
             target,

ringo_task_queue/_version.py

@@ -1,13 +1,15 @@
 """Release-line constants shared by runtime packaging checks."""
 
-SDK_VERSION = "0.1.0.dev0"
+SDK_VERSION = "0.1.0.dev2"
 PROTOCOL_MAJOR = 1
-PROTOCOL_MINOR = 0
+PROTOCOL_MINOR = 1
 SCHEMA_VERSION = 3
 
 
 def daemon_version_for_sdk(version: str = SDK_VERSION) -> str:
     """Map the Python package line to the canonical Go daemon line."""
-    if version.endswith(".dev0"):
-        return version[: -len(".dev0")] + "-dev"
+    if ".dev" in version:
+        base, _, suffix = version.rpartition(".dev")
+        if suffix.isdigit():
+            return f"{base}-dev"
     return version

ringo_task_queue/bin/manifest.json

@@ -4,17 +4,17 @@
       "arch": "amd64",
       "filename": "ringo-task-queue-windows-amd64.exe",
       "os": "windows",
-      "sha256": "b798bf7c05b77ead06223392a620d8e4cdb8e9b3187ef8951e764f8431cbe4df",
-      "size": 22699520
+      "sha256": "ad38397d8fe70fb4712f43b32d336e6ebb8550a552c9ab376da5f3785686571a",
+      "size": 22874624
     }
   ],
-  "buildCommit": "bench",
+  "buildCommit": "38c81fd",
   "buildDate": "2026-03-01T00:00:00Z",
   "manifestVersion": 1,
   "name": "ringo-task-queue",
   "protocolMajor": 1,
-  "protocolMinor": 0,
-  "releaseManifestSha256": "a51e43f79e1a7324c77f9069b1358540a4142b6a24d88fa14a300da945183071",
+  "protocolMinor": 1,
+  "releaseManifestSha256": "23e6bb426c34fa417ca0921acfb9d57bbd726616f597894b40cef224fd469eb5",
   "schemaVersion": 3,
-  "version": "0.1.0-dev"
+  "version": "0.1.0-dev.2"
 }

ringo_task_queue/client.py

@@ -670,23 +670,36 @@ class TaskQueue:
         return EnqueueResult.from_proto(response.result)
 
     async def enqueue_many(self, specs: Iterable[TaskSpec]) -> BatchResult:
-        """Enqueue a batch (max 1000), reporting every item individually."""
+        """Enqueue any number of tasks, auto-batching under the server limit.
+
+        The server enforces a hard limit of ``_MAX_ENQUEUE_BATCH`` (1000)
+        tasks per gRPC call.  This method transparently splits larger
+        iterables into sequential sub-batches, preserving creation order,
+        and aggregates the per-item results into a single :class:`BatchResult`.
+
+        Fail-fast: if any sub-batch fails, the exception propagates and no
+        partial result is returned.
+        """
         specs = list(specs)
-        if not specs:
-            raise InvalidArgumentError("enqueue_many requires at least one TaskSpec")
-        if len(specs) > _MAX_ENQUEUE_BATCH:
-            raise InvalidArgumentError(
-                f"enqueue_many accepts at most {_MAX_ENQUEUE_BATCH} tasks"
+        all_results: list[EnqueueResult] = []
+        total_created = 0
+        total_duplicates = 0
+
+        for start in range(0, len(specs), _MAX_ENQUEUE_BATCH):
+            chunk = specs[start : start + _MAX_ENQUEUE_BATCH]
+            request = queue_pb2.EnqueueManyRequest(
+                queue=self.name, tasks=[s.to_proto() for s in chunk]
             )
-        request = queue_pb2.EnqueueManyRequest(
-            queue=self.name, tasks=[s.to_proto() for s in specs]
-        )
-        request.context.CopyFrom(self._client._require_conn().request_context())
-        response = await self._client._require_conn().call("EnqueueMany", request)
+            request.context.CopyFrom(self._client._require_conn().request_context())
+            response = await self._client._require_conn().call("EnqueueMany", request)
+            all_results.extend(EnqueueResult.from_proto(r) for r in response.results)
+            total_created += response.created_count
+            total_duplicates += response.duplicate_count
+
         return BatchResult(
-            results=[EnqueueResult.from_proto(r) for r in response.results],
-            created_count=response.created_count,
-            duplicate_count=response.duplicate_count,
+            results=all_results,
+            created_count=total_created,
+            duplicate_count=total_duplicates,
         )
 
     # -- queries ------------------------------------------------------------
@@ -779,12 +792,32 @@ class TaskQueue:
         concurrency: int = 1,
         lease_duration: timedelta = timedelta(seconds=60),
         grace_period: timedelta = timedelta(seconds=30),
+        on_idle: Callable[[], Any] | None = None,
     ) -> "Worker":
-        """Create a credit-controlled worker over the frozen Work stream."""
+        """Create a credit-controlled worker over the frozen Work stream.
+
+        ``on_idle`` is an optional zero-argument callable (sync or awaitable)
+        for bounded batch runs: once the worker has registered and sent its
+        initial credit, the SDK polls queue activity every 250 ms via the
+        read-only ``GetQueueActivity`` RPC scoped to this worker's
+        ``task_types``; after the activity count has been continuously zero
+        for at least 1 s the callback fires exactly once, inline on the
+        ``run()`` coroutine. A callback that returns normally leaves the
+        worker running (and never fires again); any exception it raises —
+        including ``SystemExit`` — propagates verbatim out of
+        ``await worker.run()`` without becoming a task NACK. Workers without
+        ``on_idle`` never send activity RPCs and stay compatible with
+        protocol minor 0 servers; ``on_idle`` requires minor >= 1 and raises
+        :class:`IncompatibleVersionError` from ``run()`` otherwise. Never
+        call ``worker.close()`` from inside the callback (it would wait on
+        the very coroutine executing it).
+        """
         from .worker import Worker
 
         if not callable(handler):
             raise InvalidArgumentError("handler must be callable")
+        if on_idle is not None and not callable(on_idle):
+            raise InvalidArgumentError("on_idle must be callable")
         if concurrency < 1 or concurrency > 2**32 - 1:
             raise InvalidArgumentError("concurrency must fit in a non-zero uint32")
         if lease_duration < timedelta(0):
@@ -798,6 +831,7 @@ class TaskQueue:
             concurrency=concurrency,
             lease_duration=lease_duration,
             grace_period=grace_period,
+            on_idle=on_idle,
         )
         self._client._register_worker(worker)
         return worker

ringo_task_queue/worker.py

@@ -18,19 +18,27 @@ import grpc
 from . import _pb
 from ._proto.ringo.v1 import queue_pb2
 from .errors import (
+    IncompatibleVersionError,
     LeaseLostError,
     PermanentTaskError,
-    RingoError,
     RetryTaskError,
+    RingoError,
     UnavailableError,
     error_from_detail,
     map_rpc_error,
 )
 from .models import Task
 
-
 _MAX_ERROR_BYTES = 256 * 1024
 
+#: Fixed on_idle monitor cadence (design §10.6). These are deliberately not
+#: exposed as Worker parameters: the poll interval and the continuous-idle
+#: quiet period are protocol-level constants of the idle-observation feature.
+_IDLE_POLL_SECONDS = 0.25
+_IDLE_QUIET_SECONDS = 1.0
+#: GetQueueActivity was introduced in protocol minor 1.
+_IDLE_MIN_PROTOCOL_MINOR = 1
+
 
 def _consume_task_exception(task: asyncio.Task[Any]) -> None:
     if not task.cancelled():
@@ -152,7 +160,8 @@ class Worker:
 
     ``run`` is intentionally a blocking coroutine: it remains active until
     ``close`` is called.  The client registers workers and drains them before
-    closing its channel.
+    closing its channel.  When ``on_idle`` is configured, ``run`` additionally
+    observes queue activity and executes the callback inline at most once.
     """
 
     def __init__(
@@ -164,6 +173,7 @@ class Worker:
         concurrency: int,
         lease_duration: timedelta,
         grace_period: timedelta,
+        on_idle: Callable[[], Any] | None = None,
     ) -> None:
         if concurrency < 1:
             raise ValueError("concurrency must be >= 1")
@@ -175,6 +185,21 @@ class Worker:
         self._lease_duration = lease_duration
         self._grace_period = max(0.0, grace_period.total_seconds())
         self._worker_id = self._new_worker_id()
+        self._on_idle = on_idle
+        # on_idle monitor state (design §10.6). ``_idle_candidate`` arms only
+        # after WorkerRegistered plus the initial credit of the *current*
+        # session; every reset condition disarms it or clears the zero timer.
+        self._idle_candidate = False
+        self._idle_zero_since: float | None = None
+        self._idle_fired = False
+        #: Session token captured at WorkerRegistered + initial credit. The
+        #: candidate is only observable while the connection still carries
+        #: this token: a unary-triggered renegotiation rotates the token
+        #: without touching the Work stream and must disarm the monitor.
+        self._idle_session_token: str | None = None
+        #: Set when the on_idle callback raised: run() must re-raise verbatim
+        #: instead of counting it as a Work-stream reconnect failure.
+        self._idle_error: BaseException | None = None
 
         # close_started means no new stream may be opened, while force_cancel
         # is raised only after the graceful drain window expires.  Existing
@@ -220,14 +245,34 @@ class Worker:
         self._run_started = True
         failures = 0
         try:
+            if self._on_idle is not None:
+                # GetQueueActivity arrived in protocol minor 1; fail fast
+                # instead of silently running without idle observation.
+                conn = self._client._require_conn()
+                if conn._session_minor < _IDLE_MIN_PROTOCOL_MINOR:
+                    raise IncompatibleVersionError(
+                        "on_idle requires a server speaking protocol minor"
+                        f" >= {_IDLE_MIN_PROTOCOL_MINOR}; negotiated minor"
+                        f" is {conn._session_minor}"
+                    )
             while not self._close_started.is_set():
                 try:
-                    await self._run_session()
+                    await self._run_session_monitored()
                 except asyncio.CancelledError:
                     if not self._close_started.is_set():
                         raise
                     break
                 except Exception as exc:
+                    if self._idle_error is not None:
+                        # An on_idle callback failure is not a transport
+                        # error: it must not be retried, reconnected, or
+                        # converted into a task NACK.
+                        raise
+                    if isinstance(exc, IncompatibleVersionError):
+                        # A reconnect may have renegotiated a protocol
+                        # downgrade that makes on_idle unservable; surface
+                        # it instead of burning the reconnect budget.
+                        raise
                     self._stream_error = exc
                     failures += 1
                     if self._close_started.is_set():
@@ -259,6 +304,9 @@ class Worker:
         async with self._close_lock:
             if self._close_task is None:
                 self._close_started.set()
+                self._idle_candidate = False
+                self._idle_zero_since = None
+                self._idle_session_token = None
                 self._close_task = asyncio.create_task(
                     self._close_impl(), name=f"ringo-close-{self._worker_id}"
                 )
@@ -314,6 +362,10 @@ class Worker:
             await asyncio.gather(*tasks, return_exceptions=True)
 
     async def _cancel_assignments(self) -> None:
+        # Local assignments were reset, so the idle observation restarts too.
+        self._idle_candidate = False
+        self._idle_zero_since = None
+        self._idle_session_token = None
         assignments = list(self._inflight.values())
         self._inflight.clear()
         for assignment in assignments:
@@ -339,8 +391,156 @@ class Worker:
         if assignment.context is not None:
             assignment.context._cancel()
 
+    async def _run_session_monitored(self) -> None:
+        """Run one Work session, observing queue activity when on_idle is set.
+
+        Without ``on_idle`` this is exactly ``_run_session()``. With it, the
+        poll loop is executed inline by the ``run()`` coroutine itself (never
+        in a child task) so a callback exception — including ``SystemExit`` —
+        unwinds verbatim through ``await worker.run()``.
+        """
+        if self._on_idle is None:
+            await self._run_session()
+            return
+        session_task = asyncio.create_task(
+            self._run_session(), name="ringo-worker-session"
+        )
+        try:
+            while True:
+                done, _pending = await asyncio.wait(
+                    (session_task,), timeout=_IDLE_POLL_SECONDS
+                )
+                if done:
+                    # Propagate the session outcome (result or stream error).
+                    return await session_task
+                if await self._idle_poll_once():
+                    # Single-shot fired and returned normally: park on the
+                    # session instead of waking every poll interval.
+                    return await session_task
+        finally:
+            if not session_task.done():
+                session_task.cancel()
+            await asyncio.gather(session_task, return_exceptions=True)
+
+    async def _idle_poll_once(self) -> bool:
+        """One read-only, retry-safe activity observation tick.
+
+        Returns True exactly when the callback fired and returned normally.
+        """
+        callback = self._on_idle
+        if (
+            callback is None
+            or self._idle_fired
+            or not self._idle_candidate
+            or self._close_started.is_set()
+            or self._force_cancel.is_set()
+        ):
+            return False
+        # Local assignments make the queue non-idle for this worker.
+        if self._inflight:
+            self._idle_zero_since = None
+            return False
+        session = self._session_done
+        if session is None or session.is_set():
+            return False
+        # The observation is bound to the token captured at registration: a
+        # unary-triggered renegotiation rotates the token without restarting
+        # the Work stream. End this session so the run loop re-registers the
+        # stream under the fresh token instead of observing a stale session.
+        conn = self._client._require_conn()
+        if conn._session_token != self._idle_session_token:
+            self._end_stale_idle_session(session)
+            return False
+        request = queue_pb2.GetQueueActivityRequest(
+            queue=self._queue.name, task_types=self._task_types
+        )
+        try:
+            response = await conn.call(
+                "GetQueueActivity", request, retry_safe=True
+            )
+        except asyncio.CancelledError:
+            raise
+        except Exception:
+            # A failed observation restarts the quiet window; a later poll
+            # may succeed again without tearing the session down.
+            self._idle_zero_since = None
+            return False
+        # The session or its token may have changed while the query was in
+        # flight; a stale response must not advance or complete the window.
+        if (
+            not self._idle_candidate
+            or self._session_done is not session
+            or session.is_set()
+        ):
+            self._idle_zero_since = None
+            return False
+        if self._client._require_conn()._session_token != self._idle_session_token:
+            self._end_stale_idle_session(session)
+            return False
+        if response.active_task_count > 0:
+            self._idle_zero_since = None
+            return False
+        now = asyncio.get_running_loop().time()
+        if self._idle_zero_since is None:
+            self._idle_zero_since = now
+            return False
+        if now - self._idle_zero_since < _IDLE_QUIET_SECONDS:
+            return False
+        # Final atomic gate: no await separates these checks from marking
+        # fired and invoking the callback, so an assignment landing in a
+        # query in-flight window cannot produce a false trigger.
+        if (
+            self._inflight
+            or self._close_started.is_set()
+            or self._force_cancel.is_set()
+        ):
+            self._idle_zero_since = None
+            return False
+        # Single-shot: mark before invoking so the callback can never
+        # re-enter the monitor, and so a normal return never fires twice.
+        self._idle_fired = True
+        try:
+            result = callback()
+            if inspect.isawaitable(result):
+                await result
+        except BaseException as exc:
+            # Tag callback failures so run() propagates them verbatim
+            # instead of feeding them to the reconnect loop.
+            self._idle_error = exc
+            raise
+        return True
+
+    def _end_stale_idle_session(self, session: asyncio.Event) -> None:
+        """End the current Work session after a token rotation.
+
+        Setting ``session_done`` is idempotent and is observed as a clean
+        stream end: ``_run_session`` returns without a stream error, the run
+        loop reconnects, and the next session re-registers (and re-arms the
+        idle candidate) under the fresh token. It is neither a callback
+        failure nor a reconnect-worthy stream error.
+        """
+        self._idle_candidate = False
+        self._idle_zero_since = None
+        session.set()
+
     async def _run_session(self) -> None:
         conn = self._client._require_conn()
+        # A new session invalidates any in-flight idle observation.
+        self._idle_candidate = False
+        self._idle_zero_since = None
+        self._idle_session_token = None
+        if (
+            self._on_idle is not None
+            and conn._session_minor < _IDLE_MIN_PROTOCOL_MINOR
+        ):
+            # A reconnect may have renegotiated a downgrade to minor 0.
+            # Fail fast before opening the Work stream; run() surfaces this
+            # verbatim instead of counting it as a reconnect failure.
+            raise IncompatibleVersionError(
+                "on_idle requires a server speaking protocol minor"
+                f" >= {_IDLE_MIN_PROTOCOL_MINOR}; negotiated minor"
+                f" is {conn._session_minor}"
+            )
         reg = queue_pb2.WorkerRegistration(
             queue=self._queue.name,
             worker_id=self._worker_id,
@@ -372,6 +572,15 @@ class Worker:
                 return
             # Initial credit is sent only after WorkerRegistered was observed.
             await self._send_credit(self._concurrency)
+            if self._on_idle is not None and not self._close_started.is_set():
+                # Eligible only from the first/current WorkerRegistered plus
+                # a successful initial credit of this session. The candidate
+                # is bound to the token this stream was registered with: a
+                # later unary renegotiation that rotates the token disarms
+                # the monitor until the next session.
+                self._idle_session_token = reg.context.session_token
+                self._idle_candidate = True
+                self._idle_zero_since = None
             await self._wait_event_or_session(self._session_done)
             if self._stream_error is not None and not self._close_started.is_set():
                 raise self._stream_error

{ringo_task_queue-0.1.0.dev0.dist-info → ringo_task_queue-0.1.0.dev2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ringo-task-queue
-Version: 0.1.0.dev0
+Version: 0.1.0.dev2
 Summary: Python asyncio SDK for Ringo Task Queue with a bundled offline Go daemon
 Author: Ringo Task Queue contributors
 License-Expression: MIT
@@ -217,7 +217,7 @@ batch = await queue.enqueue_many(
 print(batch.created_count, batch.duplicate_count)
 ```
 
-每批 1–1,000 条，`batch.results` 保留逐项结果。
+`enqueue_many` 接受任意数量任务，SDK 自动按服务端单批上限 1,000 条切分并顺序发送，最终聚合为单个 `BatchResult`；`batch.results` 保留逐项结果。若任一批次失败，异常直接抛出，不返回部分结果。
 
 ## 查询和手工重试
 
@@ -234,7 +234,9 @@ reopened = await queue.retry_by_id(result.task_id)
 
 状态包括 `SCHEDULED`、`READY`、`LEASED`、`SUCCEEDED`、`DEAD` 和 `CANCELLED`。`Task` 还提供 attempt 历史、最后错误、进度和当前 lease 摘要。手工 retry 保留历史和永久去重关系。
 
-## Worker
+## Worker（推荐）
+
+处理队列任务推荐直接使用 `Worker`，而不是下面的手工 Claim：Worker 自动管理注册、credit、lease 续租、并发和优雅关闭。
 
 ```python
 from datetime import timedelta
@@ -260,7 +262,7 @@ worker = queue.worker(
 await worker.run()
 ```
 
-`run()` 一直运行到其他协程调用 `await worker.close()`，并且只能调用一次。通常用 `asyncio.create_task(worker.run())` 启动。
+`run()` 一直运行到其他协程调用 `await worker.close()`，并且只能调用一次。常驻消费时用 `asyncio.create_task(worker.run())` 启动；已知有限批次（见下）直接 `await worker.run()`。
 
 Handler 映射：
 
@@ -276,8 +278,60 @@ Worker 持有 lease token，自动续租并严格控制并发。`TaskContext`
 
 这是至少一次系统：handler 的外部副作用必须使用 `unique_key` 或任务 ID 实现幂等。
 
+### 有限批次与 `on_idle`（PyPI 推荐范式）
+
+已知有限批次（例如"把这批 seed 跑完就退出"）的推荐写法：**先在 `run()` 之前提交幂等 seed**，再给 Worker 配置一次性的 `on_idle` 回调，并**直接 `await worker.run()`**：
+
+```python
+import asyncio
+import sys
+
+from ringo_task_queue import Ringo
+
+
+async def main() -> None:
+    async with Ringo.local("./data/ringo") as client:
+        queue = client.queue("email")
+
+        # 1. 先提交幂等 seed（run() 之前 enqueue）。
+        for user_id in (101, 102, 103):
+            await queue.enqueue(
+                unique_key=f"welcome:{user_id}",
+                task_type="send-email",
+                payload={"user_id": user_id},
+            )
+
+        async def handle(task, ctx) -> None:
+            await send_welcome(task.payload["user_id"])
+
+        # 2. 队列在该 Worker 的 task type 范围内连续空闲满 1 秒后触发一次。
+        worker = queue.worker(
+            handle,
+            task_types=["send-email"],
+            concurrency=4,
+            on_idle=lambda: sys.exit(0),
+        )
+
+        # 3. 前台直接 await run()；on_idle 触发后整个批次随之结束。
+        await worker.run()
+
+
+asyncio.run(main())
+```
+
+语义与限制（务必阅读）：
+
+- **固定参数**：SDK 以 250 ms 间隔轮询、连续空闲满 1 秒触发一次；这两个值是协议级常量，不提供配置参数。
+- **单次触发**：回调最多触发一次。正常返回后 Worker 继续常驻运行且不再触发；要结束进程请在回调里退出（如 `sys.exit(0)`），异常会原样从 `await worker.run()` 传播。
+- **type scope**：活动数只统计该 Worker `task_types` 范围内的任务（`SCHEDULED`/`READY`/`LEASED` 都算活动），不影响队列里其他类型的任务。
+- **开放队列竞态**：空闲观察只是开放队列上的观测快照，不是持久完成判定。回调**正常返回**且 Worker 保持常驻时，观察之后提交的新任务仍会被正常消费；但如果回调直接退出进程（如 `sys.exit(0)`），观测之后、退出之前竞态提交的任务不会被本 Worker 处理，可能留给其他 Worker 或下一次运行。因此 `sys.exit(0)` 范式只适合生产者已经停止的有限批次。需要严格分布式完成判定时，必须另行设计 queue seal/generation。
+- **不要在回调里 `close()`**：`on_idle` 由 `worker.run()` 协程内联执行，在回调里等待同一 Worker/client 的关闭会造成自等待。外层资源作用域（如上面的 `async with`）负责清理。
+- **兼容性**：不带 `on_idle` 的 Worker 从不发送活动查询 RPC，与协议 minor 0 的旧 server 完全兼容；配置 `on_idle` 需要 minor ≥ 1 的 server，旧 server 会在 `run()` 快速抛出 `IncompatibleVersionError`。
+
 ## 手工 Claim
 
+> 常规消费任务优先使用上面推荐的 `Worker`；手工 Claim 适用于需要自行控制 claim/ACK 时序的高级场景。
+
 ```python
 from datetime import timedelta
 
@@ -367,14 +421,14 @@ except RingoError as exc:
 
 | 项目 | 默认值或限制 |
 |---|---|
-| 协议 | 1.0 |
+| 协议 | 1.1 |
 | schema | 3 |
 | lease | 60 秒 |
 | worker concurrency | 1 |
 | graceful shutdown | 30 秒 |
 | retry attempts | 默认 3，最大 32 |
 | retry | 指数退避，1 秒到 60 秒，multiplier 2，jitter 0.2 |
-| batch | 最大 1,000 |
+| batch | SDK 自动分批，单批最大 1,000 |
 | payload | 最大 1 MiB UTF-8 JSON |
 | error text | 最大 256 KiB UTF-8 |
 | daemon 自动重启 | 最多 3 次 |

ringo_task_queue-0.1.0.dev2.dist-info/RECORD

@@ -0,0 +1,18 @@
+ringo_task_queue/__init__.py,sha256=MUeo1atWuaoNITczk6hDs4zYLI18IEpkVBHOE3wGhFc,1381
+ringo_task_queue/_pb.py,sha256=gA8HMCx9ZXEMB-ca6me8CYXdRLLPzUXVIz63Q4bz75I,5683
+ringo_task_queue/_version.py,sha256=ZzMLs6sHjRJhsqQlzaUywRpm7l_Fnt6prJ6UH1e1vAY,446
+ringo_task_queue/binary.py,sha256=lJtFz_t5BuxDV4dMAqQDpP3mhTvJlnPBGnaiB0Z9D04,9526
+ringo_task_queue/client.py,sha256=c7tCI5q2P0EQc_7RZcofHQHewBPVXGwtiLmKk_KUCsI,35380
+ringo_task_queue/daemon.py,sha256=YS8otZpD9hqKeASb2S8ZWLCWzQj6-FYUb-grmYSnrIs,19849
+ringo_task_queue/errors.py,sha256=UCPl1GJSlHzvGPO5WOmkYwLBqZj8Aozlz7sChAXR8pw,4719
+ringo_task_queue/models.py,sha256=MEXh2JKgCbf3vo0EmnjJ_TscwabaW5Yd9i98LSPIrnk,11691
+ringo_task_queue/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ringo_task_queue/worker.py,sha256=lminZk8MQgOE2Gf6-8cNymaNb4iXpmtLERSaMxgMDqg,40317
+ringo_task_queue/_proto/ringo/v1/queue_pb2.py,sha256=EyddzrHyXbndhxHm_EMlzLXFVMJGQNZEWgV665NM6IQ,18691
+ringo_task_queue/_proto/ringo/v1/queue_pb2_grpc.py,sha256=b_F-9z6npDpHs3VdIJAhYfPKF6e3pJYSQTonripfWLA,28290
+ringo_task_queue/bin/manifest.json,sha256=VXBi2vZJbqz6Cn-nl8Tp0DO402tHIEjwCR5qm-WlNsc,576
+ringo_task_queue/bin/ringo-task-queue-windows-amd64.exe,sha256=rTg5fY_nD7RxL0OzLTNubruFUKVSyas3baXzeFaGVxo,22874624
+ringo_task_queue-0.1.0.dev2.dist-info/METADATA,sha256=jrL95c9BbnhlnFYpq682KHt2DQ76xGF7nCNo1FIxXhY,16957
+ringo_task_queue-0.1.0.dev2.dist-info/WHEEL,sha256=0nQjyt02uAQbhbYKWZzlDb_ZXUmJUwgypQJ-m16yWKo,94
+ringo_task_queue-0.1.0.dev2.dist-info/licenses/LICENSE,sha256=yK3nnJz_bbOAPlcJqAooYcvecNJnBH9miT_X8Qrerv4,1086
+ringo_task_queue-0.1.0.dev2.dist-info/RECORD,,

ringo_task_queue-0.1.0.dev0.dist-info/RECORD

@@ -1,18 +0,0 @@
-ringo_task_queue/__init__.py,sha256=MUeo1atWuaoNITczk6hDs4zYLI18IEpkVBHOE3wGhFc,1381
-ringo_task_queue/_pb.py,sha256=gA8HMCx9ZXEMB-ca6me8CYXdRLLPzUXVIz63Q4bz75I,5683
-ringo_task_queue/_version.py,sha256=5fU57YlC-4FhzBd2ppLripDFU1qd0QMs-5SWFnFz_9U,388
-ringo_task_queue/binary.py,sha256=lJtFz_t5BuxDV4dMAqQDpP3mhTvJlnPBGnaiB0Z9D04,9526
-ringo_task_queue/client.py,sha256=GT-JiCMshtf_SFUFvjU_ayi7C0JyuQYOeLrmwISoFLc,33570
-ringo_task_queue/daemon.py,sha256=YS8otZpD9hqKeASb2S8ZWLCWzQj6-FYUb-grmYSnrIs,19849
-ringo_task_queue/errors.py,sha256=UCPl1GJSlHzvGPO5WOmkYwLBqZj8Aozlz7sChAXR8pw,4719
-ringo_task_queue/models.py,sha256=MEXh2JKgCbf3vo0EmnjJ_TscwabaW5Yd9i98LSPIrnk,11691
-ringo_task_queue/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-ringo_task_queue/worker.py,sha256=LD-J9XnQBxJWC2xvVi4tCAzms-O7wfkflSnoEFZXwnM,30366
-ringo_task_queue/_proto/ringo/v1/queue_pb2.py,sha256=Z4S0mNwPerMshRr7DUooj9oeecbaYG4JUpMJJlwVb0o,18074
-ringo_task_queue/_proto/ringo/v1/queue_pb2_grpc.py,sha256=eKtdXhZk3BP1I9IaYQlEgUF_K2WZLzBuIq7koWLhQ00,26066
-ringo_task_queue/bin/manifest.json,sha256=6mfoRB8VFN4NAX1NVfYHx4IJmmImAV1eBgJZhK9UrFY,572
-ringo_task_queue/bin/ringo-task-queue-windows-amd64.exe,sha256=t5i_fAW3fq0GIjOSpiDY5M246bMYfviVHnZPhDHL5N8,22699520
-ringo_task_queue-0.1.0.dev0.dist-info/METADATA,sha256=s_SkJVKmqC2OqhdIDGGKlu0hZvPWqFypqbhtdT5iF7A,13515
-ringo_task_queue-0.1.0.dev0.dist-info/WHEEL,sha256=0nQjyt02uAQbhbYKWZzlDb_ZXUmJUwgypQJ-m16yWKo,94
-ringo_task_queue-0.1.0.dev0.dist-info/licenses/LICENSE,sha256=yK3nnJz_bbOAPlcJqAooYcvecNJnBH9miT_X8Qrerv4,1086
-ringo_task_queue-0.1.0.dev0.dist-info/RECORD,,