[{"data":1,"prerenderedAt":340},["ShallowReactive",2],{"navigation":3,"\u002Fapi\u002Fdurable-admission":155,"\u002Fapi\u002Fdurable-admission-surround":335},[4,36,57,113,144],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":35},"Getting Started","i-lucide-rocket","\u002Fgetting-started","1.getting-started",[10,15,20,25,30],{"title":11,"path":12,"stem":13,"icon":14},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction","i-lucide-info",{"title":16,"path":17,"stem":18,"icon":19},"Install","\u002Fgetting-started\u002Finstall","1.getting-started\u002F2.install","i-lucide-download",{"title":21,"path":22,"stem":23,"icon":24},"Quickstart","\u002Fgetting-started\u002Fquickstart","1.getting-started\u002F3.quickstart","i-lucide-zap",{"title":26,"path":27,"stem":28,"icon":29},"Testing","\u002Fgetting-started\u002Ftesting","1.getting-started\u002F4.testing","i-lucide-flask-conical",{"title":31,"path":32,"stem":33,"icon":34},"CLI","\u002Fgetting-started\u002Fcli","1.getting-started\u002F5.cli","i-lucide-terminal",false,{"title":37,"icon":38,"path":39,"stem":40,"children":41,"page":35},"Concepts","i-lucide-boxes","\u002Fconcepts","2.concepts",[42,47,52],{"title":43,"path":44,"stem":45,"icon":46},"SQL-first contract","\u002Fconcepts\u002Fsql-first-contract","2.concepts\u002F1.sql-first-contract","i-lucide-database",{"title":48,"path":49,"stem":50,"icon":51},"Jobs and status","\u002Fconcepts\u002Fjobs-and-status","2.concepts\u002F2.jobs-and-status","i-lucide-list-checks",{"title":53,"path":54,"stem":55,"icon":56},"Fencing and settles","\u002Fconcepts\u002Ffencing-and-settles","2.concepts\u002F3.fencing-and-settles","i-lucide-shield",{"title":58,"icon":59,"path":60,"stem":61,"children":62,"page":35},"API","i-lucide-code-2","\u002Fapi","3.api",[63,68,73,78,83,88,93,98,103,108],{"title":64,"path":65,"stem":66,"icon":67},"Enqueue","\u002Fapi\u002Fenqueue","3.api\u002F1.enqueue","i-lucide-plus-circle",{"title":69,"path":70,"stem":71,"icon":72},"Trusted Effects","\u002Fapi\u002Ftrusted-effects","3.api\u002F10.trusted-effects","i-lucide-lock-keyhole",{"title":74,"path":75,"stem":76,"icon":77},"Claim and heartbeat","\u002Fapi\u002Fclaim-and-heartbeat","3.api\u002F2.claim-and-heartbeat","i-lucide-hand",{"title":79,"path":80,"stem":81,"icon":82},"Worker and handlers","\u002Fapi\u002Fworker-and-handlers","3.api\u002F3.worker-and-handlers","i-lucide-cpu",{"title":84,"path":85,"stem":86,"icon":87},"HTTP facade","\u002Fapi\u002Fhttp-facade","3.api\u002F4.http-facade","i-lucide-globe",{"title":89,"path":90,"stem":91,"icon":92},"Authorization","\u002Fapi\u002Fauthorization","3.api\u002F5.authorization","i-lucide-key-round",{"title":94,"path":95,"stem":96,"icon":97},"Follow-ups","\u002Fapi\u002Ffollow-ups","3.api\u002F6.follow-ups","i-lucide-git-branch",{"title":99,"path":100,"stem":101,"icon":102},"Workflows and schedules","\u002Fapi\u002Fworkflows-and-schedules","3.api\u002F7.workflows-and-schedules","i-lucide-workflow",{"title":104,"path":105,"stem":106,"icon":107},"Durable admission","\u002Fapi\u002Fdurable-admission","3.api\u002F8.durable-admission","i-lucide-ticket",{"title":109,"path":110,"stem":111,"icon":112},"Workflow Continuations","\u002Fapi\u002Fworkflow-continuations","3.api\u002F9.workflow-continuations","i-lucide-git-fork",{"title":114,"icon":115,"path":116,"stem":117,"children":118,"page":35},"Operations","i-lucide-activity","\u002Foperations","4.operations",[119,124,129,134,139],{"title":120,"path":121,"stem":122,"icon":123},"Standalone Scheduler","\u002Foperations\u002Fstandalone-scheduler","4.operations\u002F0.standalone-scheduler","i-lucide-calendar-clock",{"title":125,"path":126,"stem":127,"icon":128},"Housekeeping","\u002Foperations\u002Fhousekeeping","4.operations\u002F1.housekeeping","i-lucide-timer",{"title":130,"path":131,"stem":132,"icon":133},"Redrive and dead letters","\u002Foperations\u002Fredrive-and-dlq","4.operations\u002F2.redrive-and-dlq","i-lucide-rotate-ccw",{"title":135,"path":136,"stem":137,"icon":138},"Flow control","\u002Foperations\u002Fflow-control","4.operations\u002F3.flow-control","i-lucide-gauge",{"title":140,"path":141,"stem":142,"icon":143},"Queue Boundaries","\u002Foperations\u002Fqueue-boundaries","4.operations\u002F4.queue-boundaries","i-lucide-panels-top-left",{"title":145,"icon":146,"path":147,"stem":148,"children":149,"page":35},"Reference","i-lucide-book-marked","\u002Freference","5.reference",[150],{"title":151,"path":152,"stem":153,"icon":154},"Configuration","\u002Freference\u002Fconfiguration","5.reference\u002F1.configuration","i-lucide-settings",{"id":156,"title":104,"body":157,"description":328,"extension":329,"links":330,"meta":331,"navigation":332,"path":105,"seo":333,"stem":106,"__hash__":334},"docs\u002F3.api\u002F8.durable-admission.md",{"type":158,"value":159,"toc":325},"minimark",[160,164,301,306,309,321],[161,162,163],"p",{},"Durable admission is a queue-native reserve → finish \u002F cancel state machine for producers that need a durable hold before the final enqueue payload is known (ADR-023).",[165,166,171],"pre",{"className":167,"code":168,"language":169,"meta":170,"style":170},"language-python shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","from uuid import uuid4\n\nhandle = uuid4()\nreservation = await tq.reserve_admission(\n    queue=\"ingest\",\n    idempotency_key=\"upload-123\",\n    intent_hash=intent_hash,\n    handle=handle,\n)\n# …prepare payload \u002F side inputs…\nawait tq.finish_admission(\n    queue=\"ingest\",\n    idempotency_key=\"upload-123\",\n    handle=handle,\n    job={\"job_type\": \"file.process\", \"payload\": {\"path\": path}},\n)\n# or cancel with the same queue \u002F key \u002F handle\nawait tq.cancel_admission(\n    queue=\"ingest\",\n    idempotency_key=\"upload-123\",\n    handle=handle,\n)\n","python","",[172,173,174,182,189,195,201,207,213,219,225,231,237,243,248,253,258,264,269,275,281,286,291,296],"code",{"__ignoreMap":170},[175,176,179],"span",{"class":177,"line":178},"line",1,[175,180,181],{},"from uuid import uuid4\n",[175,183,185],{"class":177,"line":184},2,[175,186,188],{"emptyLinePlaceholder":187},true,"\n",[175,190,192],{"class":177,"line":191},3,[175,193,194],{},"handle = uuid4()\n",[175,196,198],{"class":177,"line":197},4,[175,199,200],{},"reservation = await tq.reserve_admission(\n",[175,202,204],{"class":177,"line":203},5,[175,205,206],{},"    queue=\"ingest\",\n",[175,208,210],{"class":177,"line":209},6,[175,211,212],{},"    idempotency_key=\"upload-123\",\n",[175,214,216],{"class":177,"line":215},7,[175,217,218],{},"    intent_hash=intent_hash,\n",[175,220,222],{"class":177,"line":221},8,[175,223,224],{},"    handle=handle,\n",[175,226,228],{"class":177,"line":227},9,[175,229,230],{},")\n",[175,232,234],{"class":177,"line":233},10,[175,235,236],{},"# …prepare payload \u002F side inputs…\n",[175,238,240],{"class":177,"line":239},11,[175,241,242],{},"await tq.finish_admission(\n",[175,244,246],{"class":177,"line":245},12,[175,247,206],{},[175,249,251],{"class":177,"line":250},13,[175,252,212],{},[175,254,256],{"class":177,"line":255},14,[175,257,224],{},[175,259,261],{"class":177,"line":260},15,[175,262,263],{},"    job={\"job_type\": \"file.process\", \"payload\": {\"path\": path}},\n",[175,265,267],{"class":177,"line":266},16,[175,268,230],{},[175,270,272],{"class":177,"line":271},17,[175,273,274],{},"# or cancel with the same queue \u002F key \u002F handle\n",[175,276,278],{"class":177,"line":277},18,[175,279,280],{},"await tq.cancel_admission(\n",[175,282,284],{"class":177,"line":283},19,[175,285,206],{},[175,287,289],{"class":177,"line":288},20,[175,290,212],{},[175,292,294],{"class":177,"line":293},21,[175,295,224],{},[175,297,299],{"class":177,"line":298},22,[175,300,230],{},[302,303,305],"h2",{"id":304},"why-it-exists","Why it exists",[161,307,308],{},"Plain enqueue is reject-only on uniqueness races. Admission lets a producer claim a durable slot, then finish into a real job or cancel without inventing a second outbox table.",[161,310,311,312,315,316,320],{},"Shipped in migration ",[172,313,314],{},"0007_admission_reservations.sql"," and retained in the\ncurrent SQL contract, ",[317,318,319],"strong",{},"0.6.6",".",[322,323,324],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":170,"searchDepth":178,"depth":184,"links":326},[327],{"id":304,"depth":184,"text":305},"Reserve \u002F finish \u002F cancel two-phase admission for producers that must not lose intent.","md",null,{},{"icon":107},{"title":104,"description":328},"vVFUTQ35HeErUuSN5_laaONztMeS5Et2NAOdkkNOwjw",[336,338],{"title":99,"path":100,"stem":101,"description":337,"icon":102,"children":-1},"Sealed workflows with dependency edges, plus database-time recurring schedules.",{"title":109,"path":110,"stem":111,"description":339,"icon":112,"children":-1},"Grow sealed workflows through compiled, hash-pinned member policies.",1787515776866]