@lostgradient/weft 0.20.0 → 0.22.0

package/dist/json-schema.js

@@ -1,4 +1,4 @@
 // @bun
-var O=import.meta.require,T=(j,q,z)=>{if(q!=null){if(typeof q!=="object"&&typeof q!=="function")throw TypeError('Object expected to be assigned to "using" declaration');let A;if(z)A=q[Symbol.asyncDispose];if(A===void 0)A=q[Symbol.dispose];if(typeof A!=="function")throw TypeError("Object not disposable");j.push([z,A,q])}else if(z)j.push([z]);return q},y=(j,q,z)=>{let A=(G)=>q=z?new SuppressedError(G,q,"An error was suppressed during disposal"):(z=!0,G),H=(G)=>{while(G=j.pop())try{var $=G[1]&&G[1].call(G[2]);if(G[0])return Promise.resolve($).then(H,(Q)=>(A(Q),H()))}catch(Q){A(Q)}if(z)throw q};return H()};class X extends Error{code;constructor(j,q,z){super(q,z);this.code=j,this.name=j}}var B={WorkflowAlreadyExistsError:!0,BulkDeleteRequiresTerminalWorkflowsError:!0,BulkOperationConfirmationError:!0,WorkflowTypeNotRegisteredForRecoveryError:!0,EngineCreateNameMismatchError:!0,EngineDisposedError:!0,EngineDisposalError:!0,WorkflowNotFoundError:!0,WorkflowNotRegisteredError:!0,WorkflowConcurrencyLimitExceededError:!0,WorkflowSuspendNotSupportedError:!0,ActivityResolutionError:!0,BranchTopologyChangedError:!0,PersistedDataIncompatibleError:!0,WorkflowTimeoutError:!0,HttpClientError:!0,WorkerProtocolIncompatibleError:!0,UpdateTimeoutError:!0,UpdateValidationError:!0,WorkflowTerminalError:!0,WorkflowBuilderError:!0,VersionMismatchError:!0,EffectReplayConflictError:!0,ReviewTimeoutError:!0,AtomicStateConflictError:!0,StandardSchemaValidationError:!0,ActivityReconciliationCapabilityError:!0,ActivityReconciliationConflictError:!0,ActivityReconciliationIndeterminateError:!0,DurableActivityScopeError:!0,DurableActivityUnsupportedError:!0,AsyncActivityTokenNotFoundError:!0,ActivityScheduleToCloseTimeoutError:!0,ActivityPerAttemptTimeoutError:!0,PayloadSizeExceededError:!0,StartOrSignalConflictError:!0,WorkflowTeardownPendingError:!0,IdempotencyKeyPurgedError:!0,WorkerManifestBuildError:!0},R=new Set(Object.keys(B));class K extends X{fieldName;operation;issues;constructor(j){super("StandardSchemaValidationError",M(j.fieldName,j.operation,j.issues));this.fieldName=j.fieldName,this.operation=j.operation,this.issues=j.issues}}async function Z(j,q,z){let A=j["~standard"];if(!D(A))throw TypeError(`Schema for ${z.fieldName} does not provide runtime validation. Attach a Standard Schema validator (Zod, Valibot, or another vendor) or supply a runtime-validating schema at this boundary.`);let H=await A.validate(q);if(H.issues===void 0)return H.value;throw new K({fieldName:z.fieldName,operation:z.operation,issues:H.issues.map(U)})}function Y(j){return j.map((q)=>q.path===""?q.message:`${q.path}: ${q.message}`).join(`
-`)}function D(j){return typeof j.validate==="function"}function U(j){return{message:j.message,path:b(j.path)}}function b(j){if(j===void 0||j.length===0)return"";let q="";for(let z of j)q+="/",q+=w(z);return q}function w(j){let q=F(j)?j.key:j;return J(String(q))}function F(j){return j!==null&&typeof j==="object"&&"key"in j}function J(j){return j.replace(/~/g,"~0").replace(/\//g,"~1")}function M(j,q,z){return`Validation failed for ${q===void 0?j:`${q} ${j}`}:
-${Y(z)}`}var V=Y,k=K,P=Z;export{P as validateStandardSchema,V as formatStandardSchemaIssues,k as StandardSchemaValidationError};
+var h=import.meta.require;class i extends Error{code;constructor(r,e,t){super(e,t);this.code=r,this.name=r}}var c={WorkflowAlreadyExistsError:!0,BulkDeleteRequiresTerminalWorkflowsError:!0,BulkOperationConfirmationError:!0,WorkflowTypeNotRegisteredForRecoveryError:!0,EngineCreateNameMismatchError:!0,EngineDisposedError:!0,EngineDisposalError:!0,WorkflowNotFoundError:!0,WorkflowNotRegisteredError:!0,WorkflowConcurrencyLimitExceededError:!0,WorkflowSuspendNotSupportedError:!0,ActivityResolutionError:!0,BranchTopologyChangedError:!0,PersistedDataIncompatibleError:!0,WorkflowTimeoutError:!0,HttpClientError:!0,WorkerProtocolIncompatibleError:!0,UpdateTimeoutError:!0,UpdateValidationError:!0,WorkflowTerminalError:!0,WorkflowBuilderError:!0,VersionMismatchError:!0,EffectReplayConflictError:!0,ReviewTimeoutError:!0,AtomicStateConflictError:!0,StandardSchemaValidationError:!0,ActivityReconciliationCapabilityError:!0,ActivityReconciliationConflictError:!0,ActivityReconciliationIndeterminateError:!0,DurableActivityScopeError:!0,DurableActivityUnsupportedError:!0,AsyncActivityTokenNotFoundError:!0,ActivityScheduleToCloseTimeoutError:!0,ActivityPerAttemptTimeoutError:!0,PayloadSizeExceededError:!0,StartOrSignalConflictError:!0,WorkflowTeardownPendingError:!0,IdempotencyKeyPurgedError:!0,WorkerManifestBuildError:!0,OwnershipModeMismatchError:!0},g=new Set(Object.keys(c));class o extends i{fieldName;operation;issues;constructor(r){super("StandardSchemaValidationError",p(r.fieldName,r.operation,r.issues));this.fieldName=r.fieldName,this.operation=r.operation,this.issues=r.issues}}async function s(r,e,t){let n=r["~standard"];if(!u(n))throw TypeError(`Schema for ${t.fieldName} does not provide runtime validation. Attach a Standard Schema validator (Zod, Valibot, or another vendor) or supply a runtime-validating schema at this boundary.`);let a=await n.validate(e);if(a.issues===void 0)return a.value;throw new o({fieldName:t.fieldName,operation:t.operation,issues:a.issues.map(l)})}function d(r){return r.map((e)=>e.path===""?e.message:`${e.path}: ${e.message}`).join(`
+`)}function u(r){return typeof r.validate==="function"}function l(r){return{message:r.message,path:f(r.path)}}function f(r){if(r===void 0||r.length===0)return"";let e="";for(let t of r)e+="/",e+=m(t);return e}function m(r){let e=S(r)?r.key:r;return E(String(e))}function S(r){return r!==null&&typeof r==="object"&&"key"in r}function E(r){return r.replace(/~/g,"~0").replace(/\//g,"~1")}function p(r,e,t){return`Validation failed for ${e===void 0?r:`${e} ${r}`}:
+${d(t)}`}var W=d,T=o,R=s;export{T as StandardSchemaValidationError,W as formatStandardSchemaIssues,R as validateStandardSchema};

package/dist/observability/index.js

@@ -1,4 +1,4 @@
 // @bun
-var Jn=import.meta.require,Qn=(n,w,i)=>{if(w!=null){if(typeof w!=="object"&&typeof w!=="function")throw TypeError('Object expected to be assigned to "using" declaration');let S;if(i)S=w[Symbol.asyncDispose];if(S===void 0)S=w[Symbol.dispose];if(typeof S!=="function")throw TypeError("Object not disposable");n.push([i,S,w])}else if(i)n.push([i]);return w},jn=(n,w,i)=>{let S=(f)=>w=i?new SuppressedError(f,w,"An error was suppressed during disposal"):(i=!0,f),k=(f)=>{while(f=n.pop())try{var y=f[1]&&f[1].call(f[2]);if(f[0])return Promise.resolve(y).then(k,(p)=>(S(p),k()))}catch(p){S(p)}if(i)throw w};return k()};var h={traceId:"0".repeat(32),spanId:"0".repeat(16),traceFlags:0},T={setAttribute(){},setStatus(){},recordException(){},end(){},spanContext(){return h}},q={setAttribute:(...n)=>T.setAttribute(...n),setStatus:(...n)=>T.setStatus(...n),recordException:(...n)=>T.recordException(...n),end:(...n)=>T.end(...n)},l={startSpan(){return T}},P={record(){},add(){}},t={createHistogram(){return P},createCounter(){return P},createUpDownCounter(){return P}},r=Symbol("ROOT_CONTEXT"),a={trace:{getTracer(){return l},setSpan(n){return n}},metrics:{getMeter(){return t}},context:{ROOT_CONTEXT:r,with(n,w){return w()}},SpanStatusCode:{OK:1,ERROR:2,UNSET:0}},o;function s(){let n=globalThis.require;if(typeof n==="function")return(w)=>n(w);return()=>{return}}function e(n){return n?.trace?.getTracer!=null&&n.SpanStatusCode!=null}function nn(n=s()){try{let w=n("@opentelemetry/api");if(e(w))return w}catch{}return}function K(n){if(o)return o;let w=nn(n);if(w)return o=w,o;return o=a,o}function H(n){let w=new Uint8Array(n);return crypto.getRandomValues(w),Array.from(w,(i)=>i.toString(16).padStart(2,"0")).join("")}var Y="traceparent",wn=/^([0-9a-f]{2})-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/,Sn="00000000000000000000000000000000",kn="0000000000000000";function Z(n){let w=wn.exec(n);if(!w)return null;let[,i,S,k,f]=w;if(S===Sn)return null;if(k===kn)return null;return{version:i,traceId:S,spanId:k,traceFlags:parseInt(f,16)}}function M(n){let w=n.traceFlags.toString(16).padStart(2,"0");return`${n.version}-${n.traceId}-${n.spanId}-${w}`}function J(n){let w=n.get(Y);if(!w)return null;return Z(w)}function U(n,w){n.set(Y,M(w))}function fn(){return H(16)}function vn(){return H(8)}var O=1024;function C(n,w){let i;try{i=JSON.stringify(n)}catch{i=String(n)}if(i.length>w)return i.slice(0,w)+"...";return i}function yn(n){return n instanceof Error?n.message:String(n)}function Wn(n){return n instanceof Error?n:Error(String(n))}function Q(n,w){let i=n.spanContext();U(w,{version:"00",traceId:i.traceId,spanId:i.spanId,traceFlags:i.traceFlags})}function A(n,w,i){let S=n.attributeExtractor;if(!S)return;let k=S(i);for(let[f,y]of Object.entries(k))w.setAttribute(f,y)}function j(n,w){let i=n.workflowSpans.get(w);return i?n.trace.setSpan(n.api.context.ROOT_CONTEXT,i.span):n.api.context.ROOT_CONTEXT}function V(n,w,i){w.setStatus({code:n.SpanStatusCode.ERROR,message:yn(i)}),w.recordException(Wn(i))}function _(n,w,i,S){try{let k=i();return w.setStatus({code:n.SpanStatusCode.OK}),S?.(k),k}catch(k){throw V(n,w,k),k}finally{w.end()}}async function x(n,w,i,S){try{let k=await i();return w.setStatus({code:n.SpanStatusCode.OK}),S?.(k),k}catch(k){throw V(n,w,k),k}finally{w.end()}}function*B(n,w,i,S){try{let k=yield*i();return w.setStatus({code:n.SpanStatusCode.OK}),S?.(k),k}catch(k){throw V(n,w,k),k}finally{w.end()}}function g(n){return{async execute(w,i){let S=J(w.headers),k=n.api.context.ROOT_CONTEXT;if(S){let y={...q,spanContext(){return{traceId:S.traceId,spanId:S.spanId,traceFlags:S.traceFlags}}};k=n.trace.setSpan(n.api.context.ROOT_CONTEXT,y)}let f=n.tracer.startSpan(`activity:execute:${w.activityName}`,{attributes:{"weft.activity.name":w.activityName,"weft.activity.attempt":w.attempt,...S?{"weft.parent.trace_id":S.traceId}:{}}},k);if(n.recordPayloads&&w.input!==void 0)f.setAttribute("weft.payload.input",C(w.input,n.maxPayloadSize));return x(n,f,()=>i(w))}}}var X={workflowDuration:{name:"weft.workflow.duration",description:"Duration of workflow execution in milliseconds",unit:"ms",type:"histogram"},activityDuration:{name:"weft.activity.duration",description:"Duration of activity execution in milliseconds",unit:"ms",type:"histogram"},activityAttempts:{name:"weft.activity.attempts",description:"Total activity execution attempts",unit:"attempts",type:"counter"},workflowActive:{name:"weft.workflow.active",description:"Number of currently active workflows",unit:"workflows",type:"gauge"},workflowStarted:{name:"weft.workflow.started",description:"Total workflows started",unit:"workflows",type:"counter"},workflowCompleted:{name:"weft.workflow.completed",description:"Total workflows completed",unit:"workflows",type:"counter"},workflowFailed:{name:"weft.workflow.failed",description:"Total workflows failed",unit:"workflows",type:"counter"},promptCacheHits:{name:"weft.prompt_cache.hits",description:"Total prompt prefix cache hits",unit:"hits",type:"counter"},promptCacheMisses:{name:"weft.prompt_cache.misses",description:"Total prompt prefix cache misses",unit:"misses",type:"counter"},dpmoDefects:{name:"weft.dpmo.defects",description:"Total failed workflows (DPMO numerator)",unit:"workflows",type:"counter"},dpmoOperations:{name:"weft.dpmo.operations",description:"Total started workflows (DPMO denominator)",unit:"workflows",type:"counter"},taskBacklog:{name:"weft.task.backlog",description:"Number of queued tasks waiting for workers",unit:"tasks",type:"gauge"},taskQueueLatency:{name:"weft.task.queue_latency",description:"Time tasks spend queued before dispatch in milliseconds",unit:"ms",type:"histogram"},taskExecutionLatency:{name:"weft.task.execution_latency",description:"Time tasks spend executing after worker start in milliseconds",unit:"ms",type:"histogram"},taskRetries:{name:"weft.task.retries",description:"Total task retry attempts after the first dispatch attempt",unit:"retries",type:"counter"},taskRequeues:{name:"weft.task.requeues",description:"Total visibility-timeout or disconnect task requeues",unit:"requeues",type:"counter"},taskStaleHeartbeats:{name:"weft.task.stale_heartbeats",description:"Number of in-flight tasks whose heartbeat age exceeds the diagnostic threshold",unit:"tasks",type:"gauge"},workerCapacitySaturation:{name:"weft.worker.capacity_saturation",description:"Ratio of in-flight worker slots to total worker concurrency",unit:"ratio",type:"gauge"}};var dn=1e4;class z{#n;#i=0;#w=0;constructor(n){this.#n=new Float64Array(n)}push(n){if(this.#n[this.#i]=n,this.#i=(this.#i+1)%this.#n.length,this.#w<this.#n.length)this.#w++}toArray(){if(this.#w<this.#n.length)return Array.from(this.#n.subarray(0,this.#w));let n=Array.from({length:this.#w});for(let w=0;w<this.#w;w++)n[w]=this.#n[(this.#i+w)%this.#n.length];return n}}class D{#n;#i;#w;constructor(){this.#n=new Map,this.#i=new Map,this.#w=new Map}increment(n,w=1){this.#n.set(n,(this.#n.get(n)??0)+w)}record(n,w){let i=this.#i.get(n);if(!i)i=new z(dn),this.#i.set(n,i);i.push(w)}gauge(n,w){this.#w.set(n,w)}snapshot(){let n={};for(let[w,i]of this.#n)n[w]={type:"counter",value:i};for(let[w,i]of this.#i){let S=i.toArray(),k=In(S);n[w]={type:"histogram",count:S.length,sum:Fn(S),p50:k[Math.floor(k.length*0.5)]??0,p99:k[Math.floor(k.length*0.99)]??0,min:k[0]??0,max:k[k.length-1]??0}}for(let[w,i]of this.#w)n[w]={type:"gauge",value:i};return n}reset(){this.#n.clear(),this.#i.clear(),this.#w.clear()}}function pn(n){let w;if(typeof n==="string")w=K().metrics.getMeter(n);else if(n)w=n;else w=K().metrics.getMeter("weft");return{workflowDuration:w.createHistogram("weft.workflow.duration",{unit:"ms"}),activityDuration:w.createHistogram("weft.activity.duration",{unit:"ms"}),activityAttempts:w.createCounter("weft.activity.attempts"),activeWorkflows:w.createUpDownCounter("weft.workflow.active")}}function In(n){let w=[...n];return w.sort((i,S)=>i-S),w}function Fn(n){let w=0;for(let i of n)w+=i;return w}function Ln(n,w){let i=w?.type==="histogram"?w.count:0,S=w?.type==="histogram"?w.sum:0;return[`# TYPE ${n} histogram`,`${n}_count ${i}`,`${n}_sum ${S}`]}function $n(n,w){let i=w?.type==="counter"?w.value:0;return[`# TYPE ${n} counter`,`${n}_total ${i}`]}function Gn(n,w){let i=w?.type==="gauge"?w.value:0;return[`# TYPE ${n} gauge`,`${n} ${i}`]}var on={histogram:Ln,counter:$n,gauge:Gn};function Kn(n,w){let i=n.name.replace(/\./g,"_"),S=w[n.name];return[`# HELP ${i} ${n.description}`,...on[n.type](i,S)]}function Cn(n){let w=n[X.dpmoDefects.name],i=n[X.dpmoOperations.name],S=w?.type==="counter"?w.value:0,k=i?.type==="counter"?i.value:0,f=k===0?0:S*1e6/k,y="weft_dpmo";return["# HELP weft_dpmo Defects per million operations (failed workflows / started workflows * 1e6)","# TYPE weft_dpmo gauge",`weft_dpmo ${f}`]}function b(n){let w=[];for(let i of Object.values(X))w.push(...Kn(i,n));return w.push(...Cn(n)),w.join(`
+var be=import.meta.require;var q={traceId:"0".repeat(32),spanId:"0".repeat(16),traceFlags:0},v={setAttribute(){},setStatus(){},recordException(){},end(){},spanContext(){return q}},_={setAttribute:(...e)=>v.setAttribute(...e),setStatus:(...e)=>v.setStatus(...e),recordException:(...e)=>v.recordException(...e),end:(...e)=>v.end(...e)},Z={startSpan(){return v}},M={record(){},add(){}},V={createHistogram(){return M},createCounter(){return M},createUpDownCounter(){return M}},B=Symbol("ROOT_CONTEXT"),J={trace:{getTracer(){return Z},setSpan(e){return e}},metrics:{getMeter(){return V}},context:{ROOT_CONTEXT:B,with(e,t){return t()}},SpanStatusCode:{OK:1,ERROR:2,UNSET:0}},w;function Q(){let e=globalThis.require;if(typeof e==="function")return(t)=>e(t);return()=>{return}}function ee(e){return e?.trace?.getTracer!=null&&e.SpanStatusCode!=null}function te(e=Q()){try{let t=e("@opentelemetry/api");if(ee(t))return t}catch{}return}function y(e){if(w)return w;let t=te(e);if(t)return w=t,w;return w=J,w}function P(e){let t=new Uint8Array(e);return crypto.getRandomValues(t),Array.from(t,(r)=>r.toString(16).padStart(2,"0")).join("")}var W="traceparent",re=/^([0-9a-f]{2})-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/,ne="00000000000000000000000000000000",oe="0000000000000000";function L(e){let t=re.exec(e);if(!t)return null;let[,r,n,o,s]=t;if(n===ne)return null;if(o===oe)return null;return{version:r,traceId:n,spanId:o,traceFlags:parseInt(s,16)}}function D(e){let t=e.traceFlags.toString(16).padStart(2,"0");return`${e.version}-${e.traceId}-${e.spanId}-${t}`}function h(e){let t=e.get(W);if(!t)return null;return L(t)}function C(e,t){e.set(W,D(t))}function ie(){return P(16)}function se(){return P(8)}var N=1024;function g(e,t){let r;try{r=JSON.stringify(e)}catch{r=String(e)}if(r.length>t)return r.slice(0,t)+"...";return r}function ae(e){return e instanceof Error?e.message:String(e)}function pe(e){return e instanceof Error?e:Error(String(e))}function b(e,t){let r=e.spanContext();C(t,{version:"00",traceId:r.traceId,spanId:r.spanId,traceFlags:r.traceFlags})}function S(e,t,r){let n=e.attributeExtractor;if(!n)return;let o=n(r);for(let[s,a]of Object.entries(o))t.setAttribute(s,a)}function O(e,t){let r=e.workflowSpans.get(t);return r?e.trace.setSpan(e.api.context.ROOT_CONTEXT,r.span):e.api.context.ROOT_CONTEXT}function R(e,t,r){t.setStatus({code:e.SpanStatusCode.ERROR,message:ae(r)}),t.recordException(pe(r))}function F(e,t,r,n){try{let o=r();return t.setStatus({code:e.SpanStatusCode.OK}),n?.(o),o}catch(o){throw R(e,t,o),o}finally{t.end()}}async function x(e,t,r,n){try{let o=await r();return t.setStatus({code:e.SpanStatusCode.OK}),n?.(o),o}catch(o){throw R(e,t,o),o}finally{t.end()}}function*I(e,t,r,n){try{let o=yield*r();return t.setStatus({code:e.SpanStatusCode.OK}),n?.(o),o}catch(o){throw R(e,t,o),o}finally{t.end()}}function H(e){return{async execute(t,r){let n=h(t.headers),o=e.api.context.ROOT_CONTEXT;if(n){let a={..._,spanContext(){return{traceId:n.traceId,spanId:n.spanId,traceFlags:n.traceFlags}}};o=e.trace.setSpan(e.api.context.ROOT_CONTEXT,a)}let s=e.tracer.startSpan(`activity:execute:${t.activityName}`,{attributes:{"weft.activity.name":t.activityName,"weft.activity.attempt":t.attempt,...n?{"weft.parent.trace_id":n.traceId}:{}}},o);if(e.recordPayloads&&t.input!==void 0)s.setAttribute("weft.payload.input",g(t.input,e.maxPayloadSize));return x(e,s,()=>r(t))}}}var k={workflowDuration:{name:"weft.workflow.duration",description:"Duration of workflow execution in milliseconds",unit:"ms",type:"histogram"},activityDuration:{name:"weft.activity.duration",description:"Duration of activity execution in milliseconds",unit:"ms",type:"histogram"},activityAttempts:{name:"weft.activity.attempts",description:"Total activity execution attempts",unit:"attempts",type:"counter"},workflowActive:{name:"weft.workflow.active",description:"Number of currently active workflows",unit:"workflows",type:"gauge"},workflowStarted:{name:"weft.workflow.started",description:"Total workflows started",unit:"workflows",type:"counter"},workflowCompleted:{name:"weft.workflow.completed",description:"Total workflows completed",unit:"workflows",type:"counter"},workflowFailed:{name:"weft.workflow.failed",description:"Total workflows failed",unit:"workflows",type:"counter"},promptCacheHits:{name:"weft.prompt_cache.hits",description:"Total prompt prefix cache hits",unit:"hits",type:"counter"},promptCacheMisses:{name:"weft.prompt_cache.misses",description:"Total prompt prefix cache misses",unit:"misses",type:"counter"},dpmoDefects:{name:"weft.dpmo.defects",description:"Total failed workflows (DPMO numerator)",unit:"workflows",type:"counter"},dpmoOperations:{name:"weft.dpmo.operations",description:"Total started workflows (DPMO denominator)",unit:"workflows",type:"counter"},taskBacklog:{name:"weft.task.backlog",description:"Number of queued tasks waiting for workers",unit:"tasks",type:"gauge"},taskQueueLatency:{name:"weft.task.queue_latency",description:"Time tasks spend queued before dispatch in milliseconds",unit:"ms",type:"histogram"},taskExecutionLatency:{name:"weft.task.execution_latency",description:"Time tasks spend executing after worker start in milliseconds",unit:"ms",type:"histogram"},taskRetries:{name:"weft.task.retries",description:"Total task retry attempts after the first dispatch attempt",unit:"retries",type:"counter"},taskRequeues:{name:"weft.task.requeues",description:"Total visibility-timeout or disconnect task requeues",unit:"requeues",type:"counter"},taskStaleHeartbeats:{name:"weft.task.stale_heartbeats",description:"Number of in-flight tasks whose heartbeat age exceeds the diagnostic threshold",unit:"tasks",type:"gauge"},workerCapacitySaturation:{name:"weft.worker.capacity_saturation",description:"Ratio of in-flight worker slots to total worker concurrency",unit:"ratio",type:"gauge"}};var ce=1e4;class G{#e;#r=0;#t=0;constructor(e){this.#e=new Float64Array(e)}push(e){if(this.#e[this.#r]=e,this.#r=(this.#r+1)%this.#e.length,this.#t<this.#e.length)this.#t++}toArray(){if(this.#t<this.#e.length)return Array.from(this.#e.subarray(0,this.#t));let e=Array.from({length:this.#t});for(let t=0;t<this.#t;t++)e[t]=this.#e[(this.#r+t)%this.#e.length];return e}}class E{#e;#r;#t;constructor(){this.#e=new Map,this.#r=new Map,this.#t=new Map}increment(e,t=1){this.#e.set(e,(this.#e.get(e)??0)+t)}record(e,t){let r=this.#r.get(e);if(!r)r=new G(ce),this.#r.set(e,r);r.push(t)}gauge(e,t){this.#t.set(e,t)}snapshot(){let e={};for(let[t,r]of this.#e)e[t]={type:"counter",value:r};for(let[t,r]of this.#r){let n=r.toArray(),o=ue(n);e[t]={type:"histogram",count:n.length,sum:de(n),p50:o[Math.floor(o.length*0.5)]??0,p99:o[Math.floor(o.length*0.99)]??0,min:o[0]??0,max:o[o.length-1]??0}}for(let[t,r]of this.#t)e[t]={type:"gauge",value:r};return e}reset(){this.#e.clear(),this.#r.clear(),this.#t.clear()}}function le(e){let t;if(typeof e==="string")t=y().metrics.getMeter(e);else if(e)t=e;else t=y().metrics.getMeter("weft");return{workflowDuration:t.createHistogram("weft.workflow.duration",{unit:"ms"}),activityDuration:t.createHistogram("weft.activity.duration",{unit:"ms"}),activityAttempts:t.createCounter("weft.activity.attempts"),activeWorkflows:t.createUpDownCounter("weft.workflow.active")}}function ue(e){let t=[...e];return t.sort((r,n)=>r-n),t}function de(e){let t=0;for(let r of e)t+=r;return t}function fe(e,t){let r=t?.type==="histogram"?t.count:0,n=t?.type==="histogram"?t.sum:0;return[`# TYPE ${e} histogram`,`${e}_count ${r}`,`${e}_sum ${n}`]}function me(e,t){let r=t?.type==="counter"?t.value:0;return[`# TYPE ${e} counter`,`${e}_total ${r}`]}function we(e,t){let r=t?.type==="gauge"?t.value:0;return[`# TYPE ${e} gauge`,`${e} ${r}`]}var ye={histogram:fe,counter:me,gauge:we};function ge(e,t){let r=e.name.replace(/\./g,"_"),n=t[e.name];return[`# HELP ${r} ${e.description}`,...ye[e.type](r,n)]}function Se(e){let t=e[k.dpmoDefects.name],r=e[k.dpmoOperations.name],n=t?.type==="counter"?t.value:0,o=r?.type==="counter"?r.value:0,s=o===0?0:n*1e6/o,a="weft_dpmo";return["# HELP weft_dpmo Defects per million operations (failed workflows / started workflows * 1e6)","# TYPE weft_dpmo gauge",`weft_dpmo ${s}`]}function z(e){let t=[];for(let r of Object.values(k))t.push(...ge(r,e));return t.push(...Se(e)),t.join(`
 `)+`
-`}function An(n){return{serialize(){let w=n?.snapshot()??{};return b(w)}}}class I extends Event{static type="workflow:completed";workflowId;result;duration;constructor(n,w,i){super(I.type);this.workflowId=n,this.result=w,this.duration=i}}class F extends Event{static type="workflow:failed";workflowId;error;constructor(n,w){super(F.type);this.workflowId=n,this.error=w}}class L extends Event{static type="workflow:cancelled";workflowId;constructor(n){super(L.type);this.workflowId=n}}class $ extends Event{static type="workflow:timed-out";workflowId;timeoutType;elapsed;reason;constructor(n,w,i,S){super($.type);if(this.workflowId=n,this.timeoutType=w,this.elapsed=i,S!==void 0)this.reason=S}}var zn=new Set([I.type,F.type,L.type,$.type]);var Xn=3600000,E=1e4,Rn=3600000;function c(n){let w=Date.now();for(let[i,S]of n.workflowSpans)if(w-S.createdAt>Xn)S.span.end(),n.workflowSpans.delete(i);if(n.workflowSpans.size>E){let i=n.workflowSpans.size-E,S=0;for(let[k,f]of n.workflowSpans){if(S>=i)break;f.span.end(),n.workflowSpans.delete(k),S++}}}function N(n,w){let i=n.workflowSpans.get(w);if(i)i.span.end(),n.workflowSpans.delete(w)}function u(n){function w(v,G,W){let d=n.workflowSpans.get(v);if(!d)return;if(G==="error")d.span.setStatus({code:n.SpanStatusCode.ERROR,...W?{message:W}:{}});else d.span.setStatus({code:n.SpanStatusCode.OK});d.span.end(),n.workflowSpans.delete(v)}let i=(v)=>{if(!(v instanceof I))return;w(v.workflowId,"ok")},S=(v)=>{if(!(v instanceof F))return;w(v.workflowId,"error",v.error.message),n.metrics.increment("weft.dpmo.defects")},k=(v)=>{if(!(v instanceof L))return;w(v.workflowId,"error","Workflow cancelled")},f=(v)=>{if(!(v instanceof $))return;w(v.workflowId,"error",`Workflow timed out (${v.timeoutType}) after ${v.elapsed}ms`),n.metrics.increment("weft.dpmo.defects")};if(n.eventTarget)n.eventTarget.addEventListener(I.type,i),n.eventTarget.addEventListener(F.type,S),n.eventTarget.addEventListener(L.type,k),n.eventTarget.addEventListener($.type,f);function y(v=Rn){let G=Date.now()-v,W=0;for(let[d,R]of n.workflowSpans)if(R.createdAt<=G)R.span.setStatus({code:n.SpanStatusCode.ERROR,message:"span evicted (stale)"}),R.span.end(),n.workflowSpans.delete(d),W++;return W}function p(){if(n.eventTarget)n.eventTarget.removeEventListener(I.type,i),n.eventTarget.removeEventListener(F.type,S),n.eventTarget.removeEventListener(L.type,k),n.eventTarget.removeEventListener($.type,f);for(let v of n.workflowSpans.values())v.span.setStatus({code:n.SpanStatusCode.ERROR,message:"Observability disposed"}),v.span.end();n.workflowSpans.clear()}return{endWorkflowSpan:w,evictStaleSpans:y,dispose:p}}function m(n){return{workflowStart(w,i){c(n);let S=n.workflowSpans.get(w.workflowId);if(S)S.span.setStatus({code:n.SpanStatusCode.OK}),N(n,w.workflowId);let k=n.tracer.startSpan(`workflow:${w.workflowType}`,{attributes:{"weft.workflow.id":w.workflowId,"weft.workflow.type":w.workflowType}});if(n.workflowSpans.set(w.workflowId,{span:k,createdAt:Date.now()}),Q(k,w.headers),n.recordPayloads&&w.input!==void 0)k.setAttribute("weft.payload.input",C(w.input,n.maxPayloadSize));A(n,k,w),n.metrics.increment("weft.workflow.started"),n.metrics.increment("weft.dpmo.operations"),i(w)},*activity(w,i){let S=n.tracer.startSpan(`activity:${w.activityName}`,{attributes:{"weft.activity.name":w.activityName,"weft.activity.attempt":w.attempt}},j(n,w.workflowId));if(Q(S,w.headers),n.recordPayloads&&w.input!==void 0)S.setAttribute("weft.payload.input",C(w.input,n.maxPayloadSize));A(n,S,w);let k=Date.now();return yield*B(n,S,()=>i(w),()=>{n.metrics.record("weft.activity.duration",Date.now()-k),n.metrics.increment("weft.activity.attempts")})},*sleep(w,i){let S=n.tracer.startSpan("sleep",{attributes:{"weft.sleep.duration":w.duration}},j(n,w.workflowId));A(n,S,w),yield*B(n,S,()=>i(w))},*waitForSignal(w,i){let S=n.tracer.startSpan("waitForSignal",{attributes:{"weft.signal.name":w.signalName}},j(n,w.workflowId));return A(n,S,w),yield*B(n,S,()=>i(w))},async childWorkflow(w,i){let S=[],k=J(w.parentHeaders);if(k)S.push({context:{traceId:k.traceId,spanId:k.spanId,traceFlags:k.traceFlags}});let f=n.tracer.startSpan(`childWorkflow:${w.workflowType}`,{attributes:{"weft.child_workflow.type":w.workflowType,"weft.child_workflow.id":w.childWorkflowId,"weft.child_workflow.parent_id":w.workflowId},links:S},n.api.context.ROOT_CONTEXT);if(Q(f,w.headers),n.recordPayloads&&w.input!==void 0)f.setAttribute("weft.payload.input",C(w.input,n.maxPayloadSize));return n.metrics.increment("weft.child_workflow.started"),x(n,f,()=>i(w))},signalReceived(w,i){let S=n.tracer.startSpan(`signal:received:${w.signalName}`,{attributes:{"weft.signal.name":w.signalName,"weft.signal.workflow_id":w.workflowId}});A(n,S,w),_(n,S,()=>i(w))}}}function Tn(n){let{attributeExtractor:w,eventTarget:i,maxPayloadSize:S=O,metrics:k=new D,openTelemetryApi:f=K(),recordPayloads:y=!1,tracerName:p="weft",tracerVersion:v}=n??{},G=f,{trace:W,SpanStatusCode:d}=G,R=W.getTracer(p,v);return{api:G,trace:W,SpanStatusCode:d,tracer:R,recordPayloads:y,maxPayloadSize:S,attributeExtractor:w,eventTarget:i,metrics:k,workflowSpans:new Map}}function nw(n){let w=Tn(n),i=m(w),S=g(w),k={...i,...S},f=u(w);return{interceptor:k,metrics:w.metrics,...f}}export{b as serializeMetricsSnapshotForPrometheus,Z as parseTraceParent,U as injectTraceParent,K as getOpenTelemetryApi,fn as generateTraceId,vn as generateSpanId,M as formatTraceParent,J as extractTraceParent,pn as createOpenTelemetryMetrics,nw as createObservabilityInterceptors,An as createMetricsCollectorExporter,D as MetricsCollector,X as METRICS};
+`}function ke(e){return{serialize(){let t=e?.snapshot()??{};return z(t)}}}class l extends Event{static type="workflow:completed";workflowId;result;duration;constructor(e,t,r){super(l.type);this.workflowId=e,this.result=t,this.duration=r}}class u extends Event{static type="workflow:failed";workflowId;error;constructor(e,t){super(u.type);this.workflowId=e,this.error=t}}class d extends Event{static type="workflow:cancelled";workflowId;constructor(e){super(d.type);this.workflowId=e}}class f extends Event{static type="workflow:timed-out";workflowId;timeoutType;elapsed;reason;constructor(e,t,r,n){super(f.type);if(this.workflowId=e,this.timeoutType=t,this.elapsed=r,n!==void 0)this.reason=n}}var Fe=new Set([l.type,u.type,d.type,f.type]);var Te=3600000,X=1e4,ve=3600000;function U(e){let t=Date.now();for(let[r,n]of e.workflowSpans)if(t-n.createdAt>Te)n.span.end(),e.workflowSpans.delete(r);if(e.workflowSpans.size>X){let r=e.workflowSpans.size-X,n=0;for(let[o,s]of e.workflowSpans){if(n>=r)break;s.span.end(),e.workflowSpans.delete(o),n++}}}function K(e,t){let r=e.workflowSpans.get(t);if(r)r.span.end(),e.workflowSpans.delete(t)}function Y(e){function t(i,m,p){let c=e.workflowSpans.get(i);if(!c)return;if(m==="error")c.span.setStatus({code:e.SpanStatusCode.ERROR,...p?{message:p}:{}});else c.span.setStatus({code:e.SpanStatusCode.OK});c.span.end(),e.workflowSpans.delete(i)}let r=(i)=>{if(!(i instanceof l))return;t(i.workflowId,"ok")},n=(i)=>{if(!(i instanceof u))return;t(i.workflowId,"error",i.error.message),e.metrics.increment("weft.dpmo.defects")},o=(i)=>{if(!(i instanceof d))return;t(i.workflowId,"error","Workflow cancelled")},s=(i)=>{if(!(i instanceof f))return;t(i.workflowId,"error",`Workflow timed out (${i.timeoutType}) after ${i.elapsed}ms`),e.metrics.increment("weft.dpmo.defects")};if(e.eventTarget)e.eventTarget.addEventListener(l.type,r),e.eventTarget.addEventListener(u.type,n),e.eventTarget.addEventListener(d.type,o),e.eventTarget.addEventListener(f.type,s);function a(i=ve){let m=Date.now()-i,p=0;for(let[c,T]of e.workflowSpans)if(T.createdAt<=m)T.span.setStatus({code:e.SpanStatusCode.ERROR,message:"span evicted (stale)"}),T.span.end(),e.workflowSpans.delete(c),p++;return p}function A(){if(e.eventTarget)e.eventTarget.removeEventListener(l.type,r),e.eventTarget.removeEventListener(u.type,n),e.eventTarget.removeEventListener(d.type,o),e.eventTarget.removeEventListener(f.type,s);for(let i of e.workflowSpans.values())i.span.setStatus({code:e.SpanStatusCode.ERROR,message:"Observability disposed"}),i.span.end();e.workflowSpans.clear()}return{endWorkflowSpan:t,evictStaleSpans:a,dispose:A}}function j(e){return{workflowStart(t,r){U(e);let n=e.workflowSpans.get(t.workflowId);if(n)n.span.setStatus({code:e.SpanStatusCode.OK}),K(e,t.workflowId);let o=e.tracer.startSpan(`workflow:${t.workflowType}`,{attributes:{"weft.workflow.id":t.workflowId,"weft.workflow.type":t.workflowType}});if(e.workflowSpans.set(t.workflowId,{span:o,createdAt:Date.now()}),b(o,t.headers),e.recordPayloads&&t.input!==void 0)o.setAttribute("weft.payload.input",g(t.input,e.maxPayloadSize));S(e,o,t),e.metrics.increment("weft.workflow.started"),e.metrics.increment("weft.dpmo.operations"),r(t)},*activity(t,r){let n=e.tracer.startSpan(`activity:${t.activityName}`,{attributes:{"weft.activity.name":t.activityName,"weft.activity.attempt":t.attempt}},O(e,t.workflowId));if(b(n,t.headers),e.recordPayloads&&t.input!==void 0)n.setAttribute("weft.payload.input",g(t.input,e.maxPayloadSize));S(e,n,t);let o=Date.now();return yield*I(e,n,()=>r(t),()=>{e.metrics.record("weft.activity.duration",Date.now()-o),e.metrics.increment("weft.activity.attempts")})},*sleep(t,r){let n=e.tracer.startSpan("sleep",{attributes:{"weft.sleep.duration":t.duration}},O(e,t.workflowId));S(e,n,t),yield*I(e,n,()=>r(t))},*waitForSignal(t,r){let n=e.tracer.startSpan("waitForSignal",{attributes:{"weft.signal.name":t.signalName}},O(e,t.workflowId));return S(e,n,t),yield*I(e,n,()=>r(t))},async childWorkflow(t,r){let n=[],o=h(t.parentHeaders);if(o)n.push({context:{traceId:o.traceId,spanId:o.spanId,traceFlags:o.traceFlags}});let s=e.tracer.startSpan(`childWorkflow:${t.workflowType}`,{attributes:{"weft.child_workflow.type":t.workflowType,"weft.child_workflow.id":t.childWorkflowId,"weft.child_workflow.parent_id":t.workflowId},links:n},e.api.context.ROOT_CONTEXT);if(b(s,t.headers),e.recordPayloads&&t.input!==void 0)s.setAttribute("weft.payload.input",g(t.input,e.maxPayloadSize));return e.metrics.increment("weft.child_workflow.started"),x(e,s,()=>r(t))},signalReceived(t,r){let n=e.tracer.startSpan(`signal:received:${t.signalName}`,{attributes:{"weft.signal.name":t.signalName,"weft.signal.workflow_id":t.workflowId}});S(e,n,t),F(e,n,()=>r(t))}}}function he(e){let{attributeExtractor:t,eventTarget:r,maxPayloadSize:n=N,metrics:o=new E,openTelemetryApi:s=y(),recordPayloads:a=!1,tracerName:A="weft",tracerVersion:i}=e??{},m=s,{trace:p,SpanStatusCode:c}=m,T=p.getTracer(A,i);return{api:m,trace:p,SpanStatusCode:c,tracer:T,recordPayloads:a,maxPayloadSize:n,attributeExtractor:t,eventTarget:r,metrics:o,workflowSpans:new Map}}function Je(e){let t=he(e),r=j(t),n=H(t),o={...r,...n},s=Y(t);return{interceptor:o,metrics:t.metrics,...s}}export{k as METRICS,E as MetricsCollector,ke as createMetricsCollectorExporter,Je as createObservabilityInterceptors,le as createOpenTelemetryMetrics,h as extractTraceParent,D as formatTraceParent,se as generateSpanId,ie as generateTraceId,y as getOpenTelemetryApi,C as injectTraceParent,L as parseTraceParent,z as serializeMetricsSnapshotForPrometheus};

package/dist/server/operations/get-task-diagnostics.d.ts

@@ -4,29 +4,27 @@
  * Scans the durable task ledger (WFT-24 — previously the retired
  * `op:queued:`/`op:inflight:`/`op:resolved:`/`op:dead-letter:` keys, which
  * nothing has written since the WFT-22 ledger cutover) and live worker state
- * to identify queue pressure, stale in-flight work, retry storms, dead
- * letters, and worker capacity saturation. Results are intentionally bounded
- * and low-cardinality so operators can use them in a dashboard without
- * turning workflow or worker identifiers into metrics labels.
+ * to identify queue pressure, expected delayed attempts, stale in-flight
+ * work, retry storms, elapsed terminal non-adoption, dead letters, and worker
+ * capacity saturation. Results are intentionally bounded and low-cardinality
+ * so operators can use them in a dashboard without turning workflow or worker
+ * identifiers into metrics labels.
  *
- * The output schema's field names and `kind`/`state` vocabulary are
- * unchanged from the pre-ledger version — only the internal scan and
- * classification logic changed — so existing dashboards built against this
- * endpoint's shape keep working. `leased`, `completing`, and `cancelling`
- * ledger states are all reported as diagnostic `state: 'inflight'`: they
- * share the same lease-holder/heartbeat shape and the same operator
- * question ("is a worker still making progress on this attempt?"), so
- * exposing the ledger's more granular internal states here would add
- * distinctions operators cannot act on differently.
+ * `leased`, `completing`, and `cancelling` ledger states are all reported as
+ * diagnostic `state: 'inflight'`: they share the same lease-holder/heartbeat
+ * shape and the same operator question ("is a worker still making progress on
+ * this attempt?"), so exposing the ledger's more granular internal states
+ * here would add distinctions operators cannot act on differently. Terminal
+ * records reported as `unadopted-terminal` use the coarse `resolved` state and
+ * expose no attempt-count history.
  *
  * Retry-storm detection (`kind: 'retry-storm'`) no longer covers `terminal`
  * records: `RemoteTaskTerminal` carries no `retryCount`/`requeueCount` (WFT-25
  * deliberately dropped attempt-count history once a task resolves), so
  * there is nothing left to detect a storm from once an attempt reaches a
- * disposition. The `resolved` value in the `state` enum is kept in the
- * output schema for backward compatibility but nothing produces it anymore.
- * `dead-lettered` diagnostics are unaffected — that is a distinct, separate
- * `kind`.
+ * disposition. Terminal records are classified only by elapsed non-adoption;
+ * that diagnostic does not claim an adoption attempt failed. `dead-lettered`
+ * diagnostics remain a distinct kind for result-persistence exhaustion.
  *
  * Unlike the pre-ledger scan, the full ledger scan this operation performs
  * is one combined keyspace across every state (queued through terminal),
@@ -49,8 +47,10 @@ declare const taskDiagnosticKindSchema: z.ZodEnum<{
     "stale-inflight": "stale-inflight";
     "retry-storm": "retry-storm";
     "all-workers-at-capacity": "all-workers-at-capacity";
+    delayed: "delayed";
+    "unadopted-terminal": "unadopted-terminal";
 }>;
-declare const taskDiagnosticItemSchema: z.ZodObject<{
+declare const taskDiagnosticItemSchema: z.ZodUnion<readonly [z.ZodObject<{
     kind: z.ZodEnum<{
         "dead-lettered": "dead-lettered";
         "stuck-queued": "stuck-queued";
@@ -82,16 +82,37 @@ declare const taskDiagnosticItemSchema: z.ZodObject<{
     storageError: z.ZodOptional<z.ZodString>;
     retryAttempts: z.ZodOptional<z.ZodNumber>;
     evidence: z.ZodArray<z.ZodString>;
-}, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"delayed">;
+    state: z.ZodLiteral<"queued">;
+    operationId: z.ZodString;
+    workflowId: z.ZodOptional<z.ZodString>;
+    queue: z.ZodString;
+    retryCount: z.ZodNumber;
+    requeueCount: z.ZodNumber;
+    availableAt: z.ZodNumber;
+    evidence: z.ZodArray<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"unadopted-terminal">;
+    state: z.ZodLiteral<"resolved">;
+    operationId: z.ZodString;
+    workflowId: z.ZodOptional<z.ZodString>;
+    queue: z.ZodString;
+    terminalAt: z.ZodNumber;
+    adopted: z.ZodLiteral<false>;
+    evidence: z.ZodArray<z.ZodString>;
+}, z.core.$strict>]>;
 declare const taskDiagnosticsSummarySchema: z.ZodObject<{
     stuckQueued: z.ZodNumber;
     staleInflight: z.ZodNumber;
     retryStorms: z.ZodNumber;
     allWorkersAtCapacity: z.ZodNumber;
     deadLettered: z.ZodNumber;
+    delayed: z.ZodNumber;
+    unadoptedTerminal: z.ZodNumber;
 }, z.core.$strict>;
 declare const getTaskDiagnosticsOutput: z.ZodObject<{
-    items: z.ZodArray<z.ZodObject<{
+    items: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
         kind: z.ZodEnum<{
             "dead-lettered": "dead-lettered";
             "stuck-queued": "stuck-queued";
@@ -123,13 +144,34 @@ declare const getTaskDiagnosticsOutput: z.ZodObject<{
         storageError: z.ZodOptional<z.ZodString>;
         retryAttempts: z.ZodOptional<z.ZodNumber>;
         evidence: z.ZodArray<z.ZodString>;
-    }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"delayed">;
+        state: z.ZodLiteral<"queued">;
+        operationId: z.ZodString;
+        workflowId: z.ZodOptional<z.ZodString>;
+        queue: z.ZodString;
+        retryCount: z.ZodNumber;
+        requeueCount: z.ZodNumber;
+        availableAt: z.ZodNumber;
+        evidence: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"unadopted-terminal">;
+        state: z.ZodLiteral<"resolved">;
+        operationId: z.ZodString;
+        workflowId: z.ZodOptional<z.ZodString>;
+        queue: z.ZodString;
+        terminalAt: z.ZodNumber;
+        adopted: z.ZodLiteral<false>;
+        evidence: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>]>>;
     summary: z.ZodObject<{
         stuckQueued: z.ZodNumber;
         staleInflight: z.ZodNumber;
         retryStorms: z.ZodNumber;
         allWorkersAtCapacity: z.ZodNumber;
         deadLettered: z.ZodNumber;
+        delayed: z.ZodNumber;
+        unadoptedTerminal: z.ZodNumber;
     }, z.core.$strict>;
     limit: z.ZodNumber;
 }, z.core.$strict>;
@@ -140,6 +182,8 @@ declare const getTaskDiagnosticsInput: z.ZodObject<{
     staleQueuedAfterMs: z.ZodDefault<z.ZodNumber>;
     staleHeartbeatAfterMs: z.ZodDefault<z.ZodNumber>;
     retryStormMinimumAttempts: z.ZodDefault<z.ZodNumber>;
+    includeExpectedDelayed: z.ZodDefault<z.ZodBoolean>;
+    unadoptedAfterMs: z.ZodDefault<z.ZodNumber>;
     limit: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 declare const clearTaskDeadLetterInput: z.ZodObject<{
@@ -164,12 +208,14 @@ export declare function createGetTaskDiagnosticsOperation(options?: GetTaskDiagn
     staleQueuedAfterMs: number;
     staleHeartbeatAfterMs: number;
     retryStormMinimumAttempts: number;
+    includeExpectedDelayed: boolean;
+    unadoptedAfterMs: number;
     limit: number;
     operationId?: string | undefined;
     workflowId?: string | undefined;
     queue?: string | undefined;
 }, {
-    items: {
+    items: ({
         kind: "dead-lettered" | "stuck-queued" | "stale-inflight" | "retry-storm" | "all-workers-at-capacity";
         state: "dead-lettered" | "queued" | "resolved" | "inflight" | "capacity";
         retryCount: number;
@@ -189,13 +235,34 @@ export declare function createGetTaskDiagnosticsOperation(options?: GetTaskDiagn
         deadLetterReason?: "result-resolution-storage-exhausted" | undefined;
         storageError?: string | undefined;
         retryAttempts?: number | undefined;
-    }[];
+    } | {
+        kind: "delayed";
+        state: "queued";
+        operationId: string;
+        queue: string;
+        retryCount: number;
+        requeueCount: number;
+        availableAt: number;
+        evidence: string[];
+        workflowId?: string | undefined;
+    } | {
+        kind: "unadopted-terminal";
+        state: "resolved";
+        operationId: string;
+        queue: string;
+        terminalAt: number;
+        adopted: false;
+        evidence: string[];
+        workflowId?: string | undefined;
+    })[];
     summary: {
         stuckQueued: number;
         staleInflight: number;
         retryStorms: number;
         allWorkersAtCapacity: number;
         deadLettered: number;
+        delayed: number;
+        unadoptedTerminal: number;
     };
     limit: number;
 }, unknown>;
@@ -203,12 +270,14 @@ export declare const getTaskDiagnosticsOperation: import("../operation-catalog.t
     staleQueuedAfterMs: number;
     staleHeartbeatAfterMs: number;
     retryStormMinimumAttempts: number;
+    includeExpectedDelayed: boolean;
+    unadoptedAfterMs: number;
     limit: number;
     operationId?: string | undefined;
     workflowId?: string | undefined;
     queue?: string | undefined;
 }, {
-    items: {
+    items: ({
         kind: "dead-lettered" | "stuck-queued" | "stale-inflight" | "retry-storm" | "all-workers-at-capacity";
         state: "dead-lettered" | "queued" | "resolved" | "inflight" | "capacity";
         retryCount: number;
@@ -228,13 +297,34 @@ export declare const getTaskDiagnosticsOperation: import("../operation-catalog.t
         deadLetterReason?: "result-resolution-storage-exhausted" | undefined;
         storageError?: string | undefined;
         retryAttempts?: number | undefined;
-    }[];
+    } | {
+        kind: "delayed";
+        state: "queued";
+        operationId: string;
+        queue: string;
+        retryCount: number;
+        requeueCount: number;
+        availableAt: number;
+        evidence: string[];
+        workflowId?: string | undefined;
+    } | {
+        kind: "unadopted-terminal";
+        state: "resolved";
+        operationId: string;
+        queue: string;
+        terminalAt: number;
+        adopted: false;
+        evidence: string[];
+        workflowId?: string | undefined;
+    })[];
     summary: {
         stuckQueued: number;
         staleInflight: number;
         retryStorms: number;
         allWorkersAtCapacity: number;
         deadLettered: number;
+        delayed: number;
+        unadoptedTerminal: number;
     };
     limit: number;
 }, unknown>;

package/dist/server/operations/get-task-diagnostics.js

@@ -9,14 +9,22 @@ import {
   calculateHeartbeatAgeMs,
   calculateQueueLatencyMs
 } from "../task-state.js";
-const DEFAULT_STALE_QUEUED_AFTER_MS = 60000, DEFAULT_STALE_HEARTBEAT_AFTER_MS = 60000, DEFAULT_RETRY_STORM_MINIMUM_ATTEMPTS = 3, DEFAULT_LIMIT = 50, MAX_LIMIT = 200, taskDiagnosticKindSchema = z.enum([
+const DEFAULT_STALE_QUEUED_AFTER_MS = 60000, DEFAULT_STALE_HEARTBEAT_AFTER_MS = 60000, DEFAULT_RETRY_STORM_MINIMUM_ATTEMPTS = 3, DEFAULT_UNADOPTED_AFTER_MS = 60000, DEFAULT_LIMIT = 50, MAX_LIMIT = 200, taskDiagnosticKindSchema = z.enum([
   "stuck-queued",
   "stale-inflight",
   "retry-storm",
   "all-workers-at-capacity",
-  "dead-lettered"
-]), taskDiagnosticItemSchema = z.object({
-  kind: taskDiagnosticKindSchema,
+  "dead-lettered",
+  "delayed",
+  "unadopted-terminal"
+]), existingTaskDiagnosticItemSchema = z.object({
+  kind: z.enum([
+    "stuck-queued",
+    "stale-inflight",
+    "retry-storm",
+    "all-workers-at-capacity",
+    "dead-lettered"
+  ]),
   state: z.enum(["queued", "inflight", "resolved", "capacity", "dead-lettered"]),
   operationId: z.string().optional(),
   workflowId: z.string().optional(),
@@ -35,12 +43,37 @@ const DEFAULT_STALE_QUEUED_AFTER_MS = 60000, DEFAULT_STALE_HEARTBEAT_AFTER_MS =
   storageError: z.string().optional(),
   retryAttempts: z.number().int().nonnegative().optional(),
   evidence: z.array(z.string())
-}).strict(), taskDiagnosticsSummarySchema = z.object({
+}).strict(), delayedTaskDiagnosticItemSchema = z.object({
+  kind: z.literal("delayed"),
+  state: z.literal("queued"),
+  operationId: z.string(),
+  workflowId: z.string().optional(),
+  queue: z.string(),
+  retryCount: z.number().int().nonnegative(),
+  requeueCount: z.number().int().nonnegative(),
+  availableAt: z.number().nonnegative(),
+  evidence: z.array(z.string())
+}).strict(), unadoptedTerminalTaskDiagnosticItemSchema = z.object({
+  kind: z.literal("unadopted-terminal"),
+  state: z.literal("resolved"),
+  operationId: z.string(),
+  workflowId: z.string().optional(),
+  queue: z.string(),
+  terminalAt: z.number().nonnegative(),
+  adopted: z.literal(!1),
+  evidence: z.array(z.string())
+}).strict(), taskDiagnosticItemSchema = z.union([
+  existingTaskDiagnosticItemSchema,
+  delayedTaskDiagnosticItemSchema,
+  unadoptedTerminalTaskDiagnosticItemSchema
+]), taskDiagnosticsSummarySchema = z.object({
   stuckQueued: z.number().int().nonnegative(),
   staleInflight: z.number().int().nonnegative(),
   retryStorms: z.number().int().nonnegative(),
   allWorkersAtCapacity: z.number().int().nonnegative(),
-  deadLettered: z.number().int().nonnegative()
+  deadLettered: z.number().int().nonnegative(),
+  delayed: z.number().int().nonnegative(),
+  unadoptedTerminal: z.number().int().nonnegative()
 }).strict(), getTaskDiagnosticsOutput = z.object({
   items: z.array(taskDiagnosticItemSchema),
   summary: taskDiagnosticsSummarySchema,
@@ -52,6 +85,8 @@ const DEFAULT_STALE_QUEUED_AFTER_MS = 60000, DEFAULT_STALE_HEARTBEAT_AFTER_MS =
   staleQueuedAfterMs: z.number().int().nonnegative().default(DEFAULT_STALE_QUEUED_AFTER_MS),
   staleHeartbeatAfterMs: z.number().int().nonnegative().default(DEFAULT_STALE_HEARTBEAT_AFTER_MS),
   retryStormMinimumAttempts: z.number().int().min(1).default(DEFAULT_RETRY_STORM_MINIMUM_ATTEMPTS),
+  includeExpectedDelayed: z.boolean().default(!1),
+  unadoptedAfterMs: z.number().int().nonnegative().default(DEFAULT_UNADOPTED_AFTER_MS),
   limit: z.number().int().min(1).max(MAX_LIMIT).default(DEFAULT_LIMIT)
 }), clearTaskDeadLetterInput = z.object({
   operationId: z.string().min(1)
@@ -128,7 +163,9 @@ async function collectTaskDiagnostics({
     staleInflight: 0,
     retryStorms: 0,
     allWorkersAtCapacity: 0,
-    deadLettered: 0
+    deadLettered: 0,
+    delayed: 0,
+    unadoptedTerminal: 0
   }, relevantQueues = new Set, addItem = (item) => {
     incrementSummary(summary, item.kind);
     if (items.length < input.limit)
@@ -155,6 +192,8 @@ async function collectTaskDiagnostics({
 function addRecordDiagnostics(decoded, input, currentTime, addItem) {
   switch (decoded.state) {
     case "queued":
+      if (input.includeExpectedDelayed && decoded.availableAt > currentTime)
+        addDelayedDiagnostic(decoded, addItem);
       if (decoded.availableAt <= currentTime)
         addQueuedDiagnostics(decoded, input, currentTime, addItem);
       addRetryStormDiagnostic(decoded, "queued", input, addItem);
@@ -166,6 +205,7 @@ function addRecordDiagnostics(decoded, input, currentTime, addItem) {
       addRetryStormDiagnostic(decoded, "inflight", input, addItem);
       return;
     case "terminal":
+      addUnadoptedTerminalDiagnostic(decoded, input, currentTime, addItem);
       return;
     case "deadLettered":
       addDeadLetterDiagnostics(decoded, addItem);
@@ -175,6 +215,33 @@ function addRecordDiagnostics(decoded, input, currentTime, addItem) {
     }
   }
 }
+function addDelayedDiagnostic(record, addItem) {
+  addItem({
+    kind: "delayed",
+    state: "queued",
+    operationId: record.operationId,
+    workflowId: record.workflowId,
+    queue: record.queue,
+    retryCount: record.retryCount,
+    requeueCount: record.requeueCount,
+    availableAt: record.availableAt,
+    evidence: [`Task is delayed until ${record.availableAt} on queue "${record.queue}"`]
+  });
+}
+function addUnadoptedTerminalDiagnostic(record, input, currentTime, addItem) {
+  if (record.adopted || record.terminalAt > currentTime - input.unadoptedAfterMs)
+    return;
+  addItem({
+    kind: "unadopted-terminal",
+    state: "resolved",
+    operationId: record.operationId,
+    workflowId: record.workflowId,
+    queue: record.queue,
+    terminalAt: record.terminalAt,
+    adopted: !1,
+    evidence: [`Terminal task has remained unadopted for ${currentTime - record.terminalAt}ms`]
+  });
+}
 function addQueuedDiagnostics(record, input, currentTime, addItem) {
   const queueLatencyMs = Math.max(0, currentTime - record.lastQueuedAt);
   if (queueLatencyMs < input.staleQueuedAfterMs)
@@ -337,11 +404,26 @@ function incrementSummary(summary, kind) {
     case "dead-lettered":
       summary.deadLettered += 1;
       return;
+    case "delayed":
+      summary.delayed += 1;
+      return;
+    case "unadopted-terminal":
+      summary.unadoptedTerminal += 1;
+      return;
   }
 }
 function parseOptionalNumber(value) {
   return value === null || value.length === 0 ? void 0 : Number(value);
 }
+function parseOptionalBoolean(value) {
+  if (value === null || value.length === 0)
+    return;
+  if (value === "true")
+    return !0;
+  if (value === "false")
+    return !1;
+  return value;
+}
 export const getTaskDiagnosticsRestBinding = {
   method: "GET",
   path: "/v1/tasks/diagnostics",
@@ -354,6 +436,8 @@ export const getTaskDiagnosticsRestBinding = {
     staleQueuedAfterMs: { kind: "query", queryParam: "staleQueuedAfterMs" },
     staleHeartbeatAfterMs: { kind: "query", queryParam: "staleHeartbeatAfterMs" },
     retryStormMinimumAttempts: { kind: "query", queryParam: "retryStormMinimumAttempts" },
+    includeExpectedDelayed: { kind: "query", queryParam: "includeExpectedDelayed" },
+    unadoptedAfterMs: { kind: "query", queryParam: "unadoptedAfterMs" },
     limit: { kind: "query", queryParam: "limit" }
   },
   extractInput: async (request) => {
@@ -365,6 +449,8 @@ export const getTaskDiagnosticsRestBinding = {
       staleQueuedAfterMs: parseOptionalNumber(url.searchParams.get("staleQueuedAfterMs")),
       staleHeartbeatAfterMs: parseOptionalNumber(url.searchParams.get("staleHeartbeatAfterMs")),
       retryStormMinimumAttempts: parseOptionalNumber(url.searchParams.get("retryStormMinimumAttempts")),
+      includeExpectedDelayed: parseOptionalBoolean(url.searchParams.get("includeExpectedDelayed")),
+      unadoptedAfterMs: parseOptionalNumber(url.searchParams.get("unadoptedAfterMs")),
       limit: parseOptionalNumber(url.searchParams.get("limit"))
     };
   },

package/dist/storage/auto.js

@@ -1,2 +1,2 @@
 // @bun
-var Z=import.meta.require,I=(z,C,J)=>{if(C!=null){if(typeof C!=="object"&&typeof C!=="function")throw TypeError('Object expected to be assigned to "using" declaration');let K;if(J)K=C[Symbol.asyncDispose];if(K===void 0)K=C[Symbol.dispose];if(typeof K!=="function")throw TypeError("Object not disposable");z.push([J,K,C])}else if(J)z.push([J]);return C},L=(z,C,J)=>{let K=(V)=>C=J?new SuppressedError(V,C,"An error was suppressed during disposal"):(J=!0,V),Y=(V)=>{while(V=z.pop())try{var A=V[1]&&V[1].call(V[2]);if(V[0])return Promise.resolve(A).then(Y,(q)=>(K(q),Y()))}catch(q){K(q)}if(J)throw C};return Y()};function F(z){return{hasBun:typeof z.Bun<"u",hasIndexedDB:typeof z.indexedDB<"u",hasNode:z.process!==void 0&&typeof z.process.versions?.node==="string",hasWebExtensionStorage:z.browser?.storage!==void 0||z.chrome?.storage!==void 0}}async function P(z){let{createHash:C}=await import("crypto"),J=z.process?.cwd?.()??"weft-default";return C("sha256").update(J).digest("hex").slice(0,16)}async function X(z){let[{mkdirSync:C},{tmpdir:J},K]=await Promise.all([import("fs"),import("os"),import("path")]),Y=z.process?.env?.WEFT_DEFAULT_STORAGE_PATH,V=Y!==void 0&&Y.length>0?Y:K.join(J(),"weft-default",`${await P(z)}.db`);return C(K.dirname(V),{recursive:!0}),V}function H(z,C){if(C==="Bun")return typeof z.Bun;if(C==="browser.storage")return typeof(z.browser?.storage??z.chrome?.storage);return typeof z.process}function j(z,C){return import.meta.url.endsWith(".ts")?z:C}async function $(z){return await import(z)}function k(z){if(z.browser?.storage!==void 0)return z.browser;if(z.chrome?.storage!==void 0)return z.chrome;return{}}function Q(z){let{indexedDB:C,IDBKeyRange:J}=z;if(C===void 0||J===void 0)throw Error("resolveDefaultStorage: IndexedDB resolution requires both indexedDB and IDBKeyRange.");return{indexedDB:C,IDBKeyRange:J}}function U(z){let C=typeof z.indexedDB,J=typeof z.IDBKeyRange;return`typeof indexedDB=${C}, typeof IDBKeyRange=${J}`}var W=j("./bun-sql.ts","./bun-sql.js"),B=j("./node-sqlite.ts","./node-sqlite.js"),N=j("./indexeddb.ts","./indexeddb.js"),w=j("./web-extension.ts","./web-extension.js");async function T(z=globalThis){let C=F(z);if(C.hasBun){let{BunSQLiteStorage:J}=await $(W);return new J(await X(z))}if(C.hasNode){let{NodeSQLiteStorage:J}=await $(B);return new J(await X(z))}if(C.hasWebExtensionStorage){let{WebExtensionStorage:J}=await $(w);return new J({},k(z))}if(C.hasIndexedDB){let{IndexedDBStorage:J}=await $(N);return new J("weft",Q(z))}throw Error(`resolveDefaultStorage: requires Bun, Node, WebExtension storage, or IndexedDB. Detected: typeof Bun=${H(z,"Bun")}, typeof process=${H(z,"process")}, typeof browser.storage=${H(z,"browser.storage")}, ${U(z)}.`)}export{T as resolveDefaultStorage};
+var o=import.meta.require;function f(e){return{hasBun:typeof e.Bun<"u",hasIndexedDB:typeof e.indexedDB<"u",hasNode:e.process!==void 0&&typeof e.process.versions?.node==="string",hasWebExtensionStorage:e.browser?.storage!==void 0||e.chrome?.storage!==void 0}}async function g(e){let{createHash:n}=await import("crypto"),t=e.process?.cwd?.()??"weft-default";return n("sha256").update(t).digest("hex").slice(0,16)}async function u(e){let[{mkdirSync:n},{tmpdir:t},a]=await Promise.all([import("fs"),import("os"),import("path")]),i=e.process?.env?.WEFT_DEFAULT_STORAGE_PATH,c=i!==void 0&&i.length>0?i:a.join(t(),"weft-default",`${await g(e)}.db`);return n(a.dirname(c),{recursive:!0}),c}function d(e,n){if(n==="Bun")return typeof e.Bun;if(n==="browser.storage")return typeof(e.browser?.storage??e.chrome?.storage);return typeof e.process}function s(e,n){return import.meta.url.endsWith(".ts")?e:n}async function r(e){return await import(e)}function p(e){if(e.browser?.storage!==void 0)return e.browser;if(e.chrome?.storage!==void 0)return e.chrome;return{}}function y(e){let{indexedDB:n,IDBKeyRange:t}=e;if(n===void 0||t===void 0)throw Error("resolveDefaultStorage: IndexedDB resolution requires both indexedDB and IDBKeyRange.");return{indexedDB:n,IDBKeyRange:t}}function D(e){let n=typeof e.indexedDB,t=typeof e.IDBKeyRange;return`typeof indexedDB=${n}, typeof IDBKeyRange=${t}`}var w=s("./bun-sql.ts","./bun-sql.js"),B=s("./node-sqlite.ts","./node-sqlite.js"),x=s("./indexeddb.ts","./indexeddb.js"),b=s("./web-extension.ts","./web-extension.js");async function S(e=globalThis){let n=f(e);if(n.hasBun){let{BunSQLiteStorage:t}=await r(w);return new t(await u(e))}if(n.hasNode){let{NodeSQLiteStorage:t}=await r(B);return new t(await u(e))}if(n.hasWebExtensionStorage){let{WebExtensionStorage:t}=await r(b);return new t({},p(e))}if(n.hasIndexedDB){let{IndexedDBStorage:t}=await r(x);return new t("weft",y(e))}throw Error(`resolveDefaultStorage: requires Bun, Node, WebExtension storage, or IndexedDB. Detected: typeof Bun=${d(e,"Bun")}, typeof process=${d(e,"process")}, typeof browser.storage=${d(e,"browser.storage")}, ${D(e)}.`)}export{S as resolveDefaultStorage};