@north-light/crouter 0.3.318 → 0.3.320

package/dist/core/events/serialize.js

@@ -1,199 +1 @@
-export const MAX_EVENT_RECORD_BYTES = 65_536;
-const MAX_STRING_BYTES = 4_096;
-const MAX_KEY_BYTES = 128;
-const MAX_ERROR_STACK_BYTES = 16_384;
-const MAX_DEPTH = 4;
-const MAX_MEMBERS = 64;
-// Bounds total normalize() work regardless of graph shape: MAX_DEPTH/MAX_MEMBERS
-// alone permit a tiny SHARED-reference graph (no cycle, so the WeakSet guard
-// never fires) to fan out combinatorially — e.g. four levels of 64 shared
-// children reach 64^4 visits. This budget caps total node visits so one event
-// cannot stall or exhaust its process regardless of how references are shared.
-const MAX_NORMALIZE_UNITS = 5_000;
-function byteLength(value) { return Buffer.byteLength(value, 'utf8'); }
-function truncate(value, cap) {
-    if (byteLength(value) <= cap)
-        return { value, altered: false };
-    const suffix = '…';
-    const target = cap - byteLength(suffix);
-    let used = 0;
-    let result = '';
-    for (const character of value) {
-        const size = byteLength(character);
-        if (used + size > target)
-            break;
-        result += character;
-        used += size;
-    }
-    return { value: result + suffix, altered: true };
-}
-function unsupported(value) {
-    if (value === undefined)
-        return '[Unsupported undefined]';
-    if (typeof value === 'function')
-        return `[Unsupported function${value.name ? ` ${value.name}` : ''}]`;
-    if (typeof value === 'symbol')
-        return `[Unsupported ${String(value)}]`;
-    return `[Unsupported ${value?.constructor?.name ?? typeof value}]`;
-}
-function normalize(value, depth, active, budget) {
-    if (budget.remaining <= 0)
-        return { value: '[Omitted]', altered: true, dropped: 0 };
-    budget.remaining -= 1;
-    if (value === null || typeof value === 'boolean')
-        return { value, altered: false, dropped: 0 };
-    if (typeof value === 'string') {
-        const limited = truncate(value, MAX_STRING_BYTES);
-        return { value: limited.value, altered: limited.altered, dropped: 0 };
-    }
-    if (typeof value === 'number')
-        return Number.isFinite(value) ? { value, altered: false, dropped: 0 } : { value: String(value), altered: true, dropped: 0 };
-    if (typeof value === 'bigint')
-        return { value: value.toString(), altered: true, dropped: 0 };
-    if (value instanceof Date) {
-        const rendered = Number.isNaN(value.getTime()) ? 'Invalid Date' : value.toISOString();
-        return { value: rendered, altered: true, dropped: 0 };
-    }
-    if (typeof value !== 'object' || value === undefined)
-        return { value: unsupported(value), altered: true, dropped: 0 };
-    if (active.has(value))
-        return { value: '[Circular]', altered: true, dropped: 0 };
-    if (depth >= MAX_DEPTH)
-        return { value: '[Max depth]', altered: true, dropped: 0 };
-    active.add(value);
-    try {
-        if (Array.isArray(value)) {
-            const count = Math.min(value.length, MAX_MEMBERS);
-            const items = [];
-            let altered = value.length > count;
-            let dropped = value.length - count;
-            for (let index = 0; index < count; index += 1) {
-                if (budget.remaining <= 0) {
-                    altered = true;
-                    dropped += count - index;
-                    break;
-                }
-                const item = normalize(value[index], depth + 1, active, budget);
-                items.push(item.value);
-                altered ||= item.altered;
-                dropped += item.dropped;
-            }
-            return { value: items, altered, dropped };
-        }
-        let keys;
-        try {
-            keys = Object.keys(value).sort();
-        }
-        catch {
-            return { value: '[Unsupported object]', altered: true, dropped: 0 };
-        }
-        const selected = keys.slice(0, MAX_MEMBERS);
-        const output = {};
-        let altered = keys.length > selected.length;
-        let dropped = keys.length - selected.length;
-        for (let index = 0; index < selected.length; index += 1) {
-            const key = selected[index];
-            if (budget.remaining <= 0) {
-                altered = true;
-                dropped += selected.length - index;
-                break;
-            }
-            const limitedKey = truncate(key, MAX_KEY_BYTES);
-            let child;
-            try {
-                child = normalize(value[key], depth + 1, active, budget);
-            }
-            catch {
-                child = { value: '[Unsupported property]', altered: true, dropped: 0 };
-            }
-            // Two distinct original keys can truncate to the same bounded key (e.g. two
-            // 200-byte keys sharing their first 127 bytes). Silently overwriting would
-            // under-report the omission; count the collision as dropped instead.
-            if (Object.prototype.hasOwnProperty.call(output, limitedKey.value)) {
-                altered = true;
-                dropped += 1;
-                continue;
-            }
-            output[limitedKey.value] = child.value;
-            altered ||= limitedKey.altered || child.altered;
-            dropped += child.dropped;
-        }
-        return { value: output, altered, dropped };
-    }
-    finally {
-        active.delete(value);
-    }
-}
-function normalizeError(error) {
-    const type = truncate(String(error.type), MAX_KEY_BYTES);
-    const message = truncate(String(error.message), MAX_STRING_BYTES);
-    const result = { type: type.value, message: message.value };
-    let altered = type.altered || message.altered;
-    if (error.stack !== undefined) {
-        const stack = truncate(String(error.stack), MAX_ERROR_STACK_BYTES);
-        result.stack = stack.value;
-        altered ||= stack.altered;
-    }
-    if (error.cause !== undefined) {
-        const cause = truncate(String(error.cause), MAX_STRING_BYTES);
-        result.cause = cause.value;
-        altered ||= cause.altered;
-    }
-    return { value: result, altered };
-}
-function encoded(value) { return JSON.stringify(value); }
-function recordBytes(value) { return byteLength(encoded(value)) + 1; }
-/** Serializes a bounded NDJSON record without its newline; appendRotatingRecord owns that byte. */
-export function serializeEventRecord(envelope) {
-    const normalizedFields = envelope.fields === undefined ? undefined : normalize(envelope.fields, 0, new WeakSet(), { remaining: MAX_NORMALIZE_UNITS });
-    const normalizedError = envelope.error === undefined ? undefined : normalizeError(envelope.error);
-    const record = {
-        v: 1,
-        ts: envelope.ts,
-        level: envelope.level,
-        event: envelope.event,
-        component: envelope.component,
-        operation_id: envelope.operation_id,
-        ...(envelope.node_id === undefined ? {} : { node_id: envelope.node_id }),
-        ...(envelope.stream_id === undefined ? {} : { stream_id: envelope.stream_id }),
-        ...(envelope.duration_ms === undefined ? {} : { duration_ms: envelope.duration_ms }),
-        ...(envelope.outcome === undefined ? {} : { outcome: envelope.outcome }),
-        ...(envelope.attempt === undefined ? {} : { attempt: envelope.attempt }),
-        ...(envelope.error_class === undefined ? {} : { error_class: envelope.error_class }),
-        ...(normalizedError === undefined ? {} : { error: normalizedError.value }),
-        ...(normalizedFields === undefined ? {} : { fields: normalizedFields.value }),
-    };
-    const originalBytes = recordBytes(record);
-    const altered = normalizedFields?.altered === true || normalizedError?.altered === true || originalBytes > MAX_EVENT_RECORD_BYTES;
-    let dropped = normalizedFields?.dropped ?? 0;
-    if (altered)
-        Object.assign(record, { record_truncated: true, original_bytes: originalBytes, dropped_fields_count: dropped });
-    while (recordBytes(record) > MAX_EVENT_RECORD_BYTES && record['fields'] !== undefined) {
-        const fields = record['fields'];
-        const keys = Object.keys(fields);
-        if (keys.length === 0) {
-            delete record['fields'];
-            break;
-        }
-        keys.sort((left, right) => {
-            const bySize = byteLength(encoded(fields[right])) - byteLength(encoded(fields[left]));
-            return bySize !== 0 ? bySize : right < left ? -1 : right > left ? 1 : 0;
-        });
-        delete fields[keys[0]];
-        dropped += 1;
-        record.record_truncated = true;
-        record.original_bytes = originalBytes;
-        record.dropped_fields_count = dropped;
-    }
-    const error = record['error'];
-    if (recordBytes(record) > MAX_EVENT_RECORD_BYTES && error?.stack !== undefined)
-        delete error.stack;
-    if (recordBytes(record) > MAX_EVENT_RECORD_BYTES && error?.cause !== undefined)
-        delete error.cause;
-    if (recordBytes(record) > MAX_EVENT_RECORD_BYTES && error !== undefined)
-        error.message = truncate(error.message, 64).value;
-    const result = encoded(record);
-    if (byteLength(result) + 1 > MAX_EVENT_RECORD_BYTES)
-        throw new RangeError('event record cannot fit within 64 KiB');
-    return result;
-}
+var M=Object.defineProperty;var _=(e,n)=>M(e,"name",{value:n,configurable:!0});const X=65536,h=4096,N=128,O=16384,Y=4,b=64,k=5e3;function E(e){return Buffer.byteLength(e,"utf8")}_(E,"byteLength");function m(e,n){if(E(e)<=n)return{value:e,altered:!1};const i="\u2026",t=n-E(i);let r=0,d="";for(const c of e){const o=E(c);if(r+o>t)break;d+=c,r+=o}return{value:d+i,altered:!0}}_(m,"truncate");function R(e){return e===void 0?"[Unsupported undefined]":typeof e=="function"?`[Unsupported function${e.name?` ${e.name}`:""}]`:typeof e=="symbol"?`[Unsupported ${String(e)}]`:`[Unsupported ${e?.constructor?.name??typeof e}]`}_(R,"unsupported");function g(e,n,i,t){if(t.remaining<=0)return{value:"[Omitted]",altered:!0,dropped:0};if(t.remaining-=1,e===null||typeof e=="boolean")return{value:e,altered:!1,dropped:0};if(typeof e=="string"){const r=m(e,4096);return{value:r.value,altered:r.altered,dropped:0}}if(typeof e=="number")return Number.isFinite(e)?{value:e,altered:!1,dropped:0}:{value:String(e),altered:!0,dropped:0};if(typeof e=="bigint")return{value:e.toString(),altered:!0,dropped:0};if(e instanceof Date)return{value:Number.isNaN(e.getTime())?"Invalid Date":e.toISOString(),altered:!0,dropped:0};if(typeof e!="object"||e===void 0)return{value:R(e),altered:!0,dropped:0};if(i.has(e))return{value:"[Circular]",altered:!0,dropped:0};if(n>=4)return{value:"[Max depth]",altered:!0,dropped:0};i.add(e);try{if(Array.isArray(e)){const s=Math.min(e.length,64),f=[];let a=e.length>s,u=e.length-s;for(let p=0;p<s;p+=1){if(t.remaining<=0){a=!0,u+=s-p;break}const T=g(e[p],n+1,i,t);f.push(T.value),a||=T.altered,u+=T.dropped}return{value:f,altered:a,dropped:u}}let r;try{r=Object.keys(e).sort()}catch{return{value:"[Unsupported object]",altered:!0,dropped:0}}const d=r.slice(0,64),c={};let o=r.length>d.length,l=r.length-d.length;for(let s=0;s<d.length;s+=1){const f=d[s];if(t.remaining<=0){o=!0,l+=d.length-s;break}const a=m(f,128);let u;try{u=g(e[f],n+1,i,t)}catch{u={value:"[Unsupported property]",altered:!0,dropped:0}}if(Object.prototype.hasOwnProperty.call(c,a.value)){o=!0,l+=1;continue}c[a.value]=u.value,o||=a.altered||u.altered,l+=u.dropped}return{value:c,altered:o,dropped:l}}finally{i.delete(e)}}_(g,"normalize");function A(e){const n=m(String(e.type),128),i=m(String(e.message),4096),t={type:n.value,message:i.value};let r=n.altered||i.altered;if(e.stack!==void 0){const d=m(String(e.stack),16384);t.stack=d.value,r||=d.altered}if(e.cause!==void 0){const d=m(String(e.cause),4096);t.cause=d.value,r||=d.altered}return{value:t,altered:r}}_(A,"normalizeError");function y(e){return JSON.stringify(e)}_(y,"encoded");function S(e){return E(y(e))+1}_(S,"recordBytes");function D(e){const n=e.fields===void 0?void 0:g(e.fields,0,new WeakSet,{remaining:5e3}),i=e.error===void 0?void 0:A(e.error),t={v:1,ts:e.ts,level:e.level,event:e.event,component:e.component,operation_id:e.operation_id,...e.node_id===void 0?{}:{node_id:e.node_id},...e.stream_id===void 0?{}:{stream_id:e.stream_id},...e.duration_ms===void 0?{}:{duration_ms:e.duration_ms},...e.outcome===void 0?{}:{outcome:e.outcome},...e.attempt===void 0?{}:{attempt:e.attempt},...e.error_class===void 0?{}:{error_class:e.error_class},...i===void 0?{}:{error:i.value},...n===void 0?{}:{fields:n.value}},r=S(t),d=n?.altered===!0||i?.altered===!0||r>65536;let c=n?.dropped??0;for(d&&Object.assign(t,{record_truncated:!0,original_bytes:r,dropped_fields_count:c});S(t)>65536&&t.fields!==void 0;){const s=t.fields,f=Object.keys(s);if(f.length===0){delete t.fields;break}f.sort((a,u)=>{const p=E(y(s[u]))-E(y(s[a]));return p!==0?p:u<a?-1:u>a?1:0}),delete s[f[0]],c+=1,t.record_truncated=!0,t.original_bytes=r,t.dropped_fields_count=c}const o=t.error;S(t)>65536&&o?.stack!==void 0&&delete o.stack,S(t)>65536&&o?.cause!==void 0&&delete o.cause,S(t)>65536&&o!==void 0&&(o.message=m(o.message,64).value);const l=y(t);if(E(l)+1>65536)throw new RangeError("event record cannot fit within 64 KiB");return l}_(D,"serializeEventRecord");export{X as MAX_EVENT_RECORD_BYTES,D as serializeEventRecord};

package/dist/core/events/source.js

@@ -1,31 +1 @@
-import { join } from 'node:path';
-import { crtrHome, isSafeNodeId, jobDir } from '../canvas/paths.js';
-let bound;
-function equal(left, right) {
-    return left.component === right.component && left.path === right.path && left.node_id === right.node_id && left.stream_id === right.stream_id;
-}
-function bind(source) {
-    if (bound === undefined) {
-        bound = source;
-        return;
-    }
-    if (!equal(bound, source))
-        throw new Error('event source is already bound for this process');
-}
-export function bindDaemonEventSource() {
-    bind({ component: 'daemon', path: join(crtrHome(), 'crtrd.log') });
-}
-export function bindBrokerEventSource(nodeId) {
-    if (!isSafeNodeId(nodeId))
-        throw new TypeError('node_id must be a non-empty path segment of at most 128 UTF-8 bytes');
-    bind({ component: 'broker', node_id: nodeId, path: join(jobDir(nodeId), 'log.jsonl') });
-}
-export function eventSource() { return bound; }
-/** Test-only: clear the process-global binding. A single test process can
- * legitimately play several components in sequence (an in-process revive binds
- * a broker source via host.ts's bind-if-unbound; a later daemon-tick test then
- * inherits it and trips emit's cross-node guard). Production processes bind
- * exactly once and never reset. */
-export function resetEventSourceForTests() {
-    bound = undefined;
-}
+var d=Object.defineProperty;var e=(o,n)=>d(o,"name",{value:n,configurable:!0});import{join as t}from"node:path";import{crtrHome as u,isSafeNodeId as p,jobDir as c}from"../canvas/paths.js";let r;function m(o,n){return o.component===n.component&&o.path===n.path&&o.node_id===n.node_id&&o.stream_id===n.stream_id}e(m,"equal");function i(o){if(r===void 0){r=o;return}if(!m(r,o))throw new Error("event source is already bound for this process")}e(i,"bind");function b(){i({component:"daemon",path:t(u(),"crtrd.log")})}e(b,"bindDaemonEventSource");function _(o){if(!p(o))throw new TypeError("node_id must be a non-empty path segment of at most 128 UTF-8 bytes");i({component:"broker",node_id:o,path:t(c(o),"log.jsonl")})}e(_,"bindBrokerEventSource");function h(){return r}e(h,"eventSource");function v(){r=void 0}e(v,"resetEventSourceForTests");export{_ as bindBrokerEventSource,b as bindDaemonEventSource,h as eventSource,v as resetEventSourceForTests};

package/dist/core/events/types.js

@@ -1,11 +1 @@
-export const errorClassCodes = [
-    'rate_limit',
-    'overloaded',
-    'connection',
-    'auth',
-    'protocol',
-    'context_overflow',
-    'wedged',
-    'model_not_found',
-    'unknown',
-];
+const o=["rate_limit","overloaded","connection","auth","protocol","context_overflow","wedged","model_not_found","unknown"];export{o as errorClassCodes};

package/dist/core/exclusive-lock.js

@@ -1,197 +1 @@
-import { existsSync, mkdirSync, readdirSync, rmSync, rmdirSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
-import { randomUUID } from 'node:crypto';
-const MARKER_PREFIX = 'owner.';
-// Contention backoff. The first polls stay tight so an uncontended hand-off is
-// still effectively immediate; the interval then doubles to a ceiling so a lock
-// held across a long operation (a corpus migration, say) cannot turn a crowd of
-// waiters into a filesystem hot loop — N waiters at a fixed 10ms is N*100
-// tryAcquire() syscall bursts per second on one directory.
-const POLL_MS = 10;
-const POLL_MAX_MS = 250;
-const DEFAULT_STALE_MS = 30_000;
-const DEFAULT_TIMEOUT_MS = 5_000;
-function nextPollMs(current) { return Math.min(current * 2, POLL_MAX_MS); }
-function pause(ms) { Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms); }
-function pauseAsync(ms) { return new Promise((resolve) => setTimeout(resolve, ms)); }
-function markerPath(path, token) { return `${path}/${MARKER_PREFIX}${token}`; }
-function observedMarkerToken(path) {
-    try {
-        return readdirSync(path).find((entry) => entry.startsWith(MARKER_PREFIX))?.slice(MARKER_PREFIX.length) ?? null;
-    }
-    catch {
-        return null;
-    }
-}
-/** The token opens with the owner's pid, so liveness reads off the name. */
-function ownerIsAlive(token) {
-    const pid = Number(token.split('.', 1)[0]);
-    if (!Number.isSafeInteger(pid) || pid <= 0)
-        return false;
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch (error) {
-        return error.code === 'EPERM';
-    }
-}
-function isEmptyDirectory(path) {
-    try {
-        return readdirSync(path).length === 0;
-    }
-    catch {
-        return false;
-    }
-}
-function ageMs(path) {
-    try {
-        return Date.now() - statSync(path).mtimeMs;
-    }
-    catch {
-        return 0;
-    }
-}
-// Reclamation is bound to the exact instance it observed: it unlinks ONLY that
-// token's marker, then removes the now-empty directory with an empty-guarded
-// rmdir. A successor holds a different random token — a different marker name —
-// so a lagging reclaimer that saw the old dead lock can never strip a live
-// successor: its unlink targets a name that no longer exists.
-function reclaimIfOwnerGone(path, staleMs) {
-    const token = observedMarkerToken(path);
-    if (token !== null) {
-        if (ownerIsAlive(token))
-            return;
-        try {
-            unlinkSync(markerPath(path, token));
-        }
-        catch (error) {
-            if (error.code === 'ENOENT')
-                return;
-            throw error;
-        }
-    }
-    else {
-        // Nothing names an owner. A live holder always has its marker, so this is a
-        // crash between mkdir and the marker write, or a lock left in some older
-        // shape; age is the only evidence, and an empty-guarded rmdir still cannot
-        // take a successor that has since claimed the name.
-        if (ageMs(path) <= staleMs)
-            return;
-        if (!isEmptyDirectory(path)) {
-            rmSync(path, { recursive: true, force: true });
-            return;
-        }
-    }
-    try {
-        rmdirSync(path);
-    }
-    catch (error) {
-        const code = error.code;
-        if (code !== 'ENOENT' && code !== 'ENOTEMPTY' && code !== 'EEXIST')
-            throw error;
-    }
-}
-/** The pid currently holding this lock, read straight off the marker name (the
- *  token opens with the owner's pid). Null when the lock is free, unowned, or
- *  names a token we cannot parse. Lets a caller tell "my child is doing the
- *  work" apart from "my child is queued behind someone else's work" without
- *  any new bookkeeping. */
-export function exclusiveLockOwnerPid(path) {
-    const token = observedMarkerToken(path);
-    if (token === null)
-        return null;
-    const pid = Number(token.split('.', 1)[0]);
-    return Number.isSafeInteger(pid) && pid > 0 ? pid : null;
-}
-/**
- * Block until `path` is no longer held by a LIVE other process, or the wait
- * runs out. Unlike `withExclusiveDirectoryLock*` this never CLAIMS the lock —
- * it is for a reader that only needs the holder's transition to be over before
- * it looks at the directory the holder is rewriting.
- *
- * Returns immediately when the lock is free, when its marker names this very
- * process (a caller waiting on its own lock would otherwise deadlock), or when
- * the named owner is gone — a dead holder's transition is already over, however
- * it ended.
- */
-export function awaitExclusiveLockRelease(path, timeoutMs) {
-    const deadline = Date.now() + timeoutMs;
-    let pollMs = POLL_MS;
-    for (;;) {
-        const token = observedMarkerToken(path);
-        if (token === null)
-            return;
-        if (Number(token.split('.', 1)[0]) === process.pid)
-            return;
-        if (!ownerIsAlive(token))
-            return;
-        const remaining = deadline - Date.now();
-        if (remaining <= 0)
-            return;
-        pause(Math.min(pollMs, remaining));
-        pollMs = nextPollMs(pollMs);
-    }
-}
-function tryAcquire(path, staleMs) {
-    const token = `${process.pid}.${randomUUID()}`;
-    try {
-        mkdirSync(path, { mode: 0o700 });
-        writeFileSync(markerPath(path, token), '', { flag: 'wx', mode: 0o600 });
-        return { path, token };
-    }
-    catch (error) {
-        if (error.code !== 'EEXIST')
-            throw error;
-        reclaimIfOwnerGone(path, staleMs);
-        return null;
-    }
-}
-/**
- * Run a short filesystem transition under a token-checked, crash-reclaimable
- * directory lock. A holder that dies releases immediately — the next contender
- * sees a dead pid in the marker name — while a live holder is never stolen from,
- * however long its operation runs.
- */
-export function withExclusiveDirectoryLock(path, operation, options = {}) {
-    const staleMs = options.staleMs ?? DEFAULT_STALE_MS;
-    const deadline = Date.now() + (options.timeoutMs ?? DEFAULT_TIMEOUT_MS);
-    let pollMs = POLL_MS;
-    let lock = tryAcquire(path, staleMs);
-    while (lock === null) {
-        if (Date.now() >= deadline) {
-            throw options.timeoutError?.() ?? new Error(`timed out waiting for the exclusive lock: ${path}`);
-        }
-        pause(Math.min(pollMs, Math.max(0, deadline - Date.now())));
-        pollMs = nextPollMs(pollMs);
-        lock = tryAcquire(path, staleMs);
-    }
-    try {
-        return operation();
-    }
-    finally {
-        if (existsSync(markerPath(lock.path, lock.token)))
-            rmSync(lock.path, { recursive: true, force: true });
-    }
-}
-/** Run an awaited operation under the same token-checked directory lock. */
-export async function withExclusiveDirectoryLockAsync(path, operation, options = {}) {
-    const staleMs = options.staleMs ?? DEFAULT_STALE_MS;
-    const deadline = Date.now() + (options.timeoutMs ?? DEFAULT_TIMEOUT_MS);
-    let pollMs = POLL_MS;
-    let lock = tryAcquire(path, staleMs);
-    while (lock === null) {
-        if (Date.now() >= deadline) {
-            throw options.timeoutError?.() ?? new Error(`timed out waiting for the exclusive lock: ${path}`);
-        }
-        await pauseAsync(Math.min(pollMs, Math.max(0, deadline - Date.now())));
-        pollMs = nextPollMs(pollMs);
-        lock = tryAcquire(path, staleMs);
-    }
-    try {
-        return await operation();
-    }
-    finally {
-        if (existsSync(markerPath(lock.path, lock.token)))
-            rmSync(lock.path, { recursive: true, force: true });
-    }
-}
+var x=Object.defineProperty;var o=(e,r)=>x(e,"name",{value:r,configurable:!0});import{existsSync as d,mkdirSync as D,readdirSync as M,rmSync as a,rmdirSync as T,statSync as A,unlinkSync as v,writeFileSync as L}from"node:fs";import{randomUUID as p}from"node:crypto";const f="owner.",m=10,I=250,E=3e4,h=5e3;function w(e){return Math.min(e*2,I)}o(w,"nextPollMs");function k(e){Atomics.wait(new Int32Array(new SharedArrayBuffer(4)),0,0,e)}o(k,"pause");function N(e){return new Promise(r=>setTimeout(r,e))}o(N,"pauseAsync");function l(e,r){return`${e}/${f}${r}`}o(l,"markerPath");function y(e){try{return M(e).find(r=>r.startsWith(f))?.slice(f.length)??null}catch{return null}}o(y,"observedMarkerToken");function S(e){const r=Number(e.split(".",1)[0]);if(!Number.isSafeInteger(r)||r<=0)return!1;try{return process.kill(r,0),!0}catch(t){return t.code==="EPERM"}}o(S,"ownerIsAlive");function _(e){try{return M(e).length===0}catch{return!1}}o(_,"isEmptyDirectory");function g(e){try{return Date.now()-A(e).mtimeMs}catch{return 0}}o(g,"ageMs");function P(e,r){const t=y(e);if(t!==null){if(S(t))return;try{v(l(e,t))}catch(n){if(n.code==="ENOENT")return;throw n}}else{if(g(e)<=r)return;if(!_(e)){a(e,{recursive:!0,force:!0});return}}try{T(e)}catch(n){const i=n.code;if(i!=="ENOENT"&&i!=="ENOTEMPTY"&&i!=="EEXIST")throw n}}o(P,"reclaimIfOwnerGone");function R(e){const r=y(e);if(r===null)return null;const t=Number(r.split(".",1)[0]);return Number.isSafeInteger(t)&&t>0?t:null}o(R,"exclusiveLockOwnerPid");function U(e,r){const t=Date.now()+r;let n=m;for(;;){const i=y(e);if(i===null||Number(i.split(".",1)[0])===process.pid||!S(i))return;const u=t-Date.now();if(u<=0)return;k(Math.min(n,u)),n=w(n)}}o(U,"awaitExclusiveLockRelease");function s(e,r){const t=`${process.pid}.${p()}`;try{return D(e,{mode:448}),L(l(e,t),"",{flag:"wx",mode:384}),{path:e,token:t}}catch(n){if(n.code!=="EEXIST")throw n;return P(e,r),null}}o(s,"tryAcquire");function F(e,r,t={}){const n=t.staleMs??E,i=Date.now()+(t.timeoutMs??h);let u=m,c=s(e,n);for(;c===null;){if(Date.now()>=i)throw t.timeoutError?.()??new Error(`timed out waiting for the exclusive lock: ${e}`);k(Math.min(u,Math.max(0,i-Date.now()))),u=w(u),c=s(e,n)}try{return r()}finally{d(l(c.path,c.token))&&a(c.path,{recursive:!0,force:!0})}}o(F,"withExclusiveDirectoryLock");async function X(e,r,t={}){const n=t.staleMs??E,i=Date.now()+(t.timeoutMs??h);let u=m,c=s(e,n);for(;c===null;){if(Date.now()>=i)throw t.timeoutError?.()??new Error(`timed out waiting for the exclusive lock: ${e}`);await N(Math.min(u,Math.max(0,i-Date.now()))),u=w(u),c=s(e,n)}try{return await r()}finally{d(l(c.path,c.token))&&a(c.path,{recursive:!0,force:!0})}}o(X,"withExclusiveDirectoryLockAsync");export{U as awaitExclusiveLockRelease,R as exclusiveLockOwnerPid,F as withExclusiveDirectoryLock,X as withExclusiveDirectoryLockAsync};

package/dist/core/fault-classifier.js

@@ -1,96 +1 @@
-import { hasManagedProviderCoolingDiagnostic } from './runtime/managed-provider-cooling.js';
-import { recognizeProviderError } from './provider-error-recognition.js';
-import { extractProviderFailureDetails } from './provider-failure.js';
-import { isRecord } from '../shared/predicates.js';
-const errorClassByFaultKind = {
-    'rate-limit': 'rate_limit',
-    overloaded: 'overloaded',
-    connection: 'connection',
-    auth: 'auth',
-    protocol: 'protocol',
-    'context-overflow': 'context_overflow',
-    wedged: 'wedged',
-    'model-not-found': 'model_not_found',
-    other: 'unknown',
-};
-export function errorClassFromFault(fault) {
-    return {
-        class: errorClassByFaultKind[fault.kind],
-        retry_disposition: fault.retry.disposition,
-    };
-}
-function faultKindFromProviderSignal(signal) {
-    switch (signal.kind) {
-        case 'rate-limit': return 'rate-limit';
-        case 'auth': return 'auth';
-        case 'protocol': return 'protocol';
-        case 'context-overflow': return 'context-overflow';
-        case 'overloaded':
-        case 'overloaded-only':
-        case 'transient-http': return 'overloaded';
-        case 'connection':
-        case 'connection-only': return 'connection';
-        case 'socket':
-        case 'service-unavailable':
-        case 'other': return 'other';
-    }
-}
-function classifyDisposition(link, kind) {
-    if (kind === 'auth' || kind === 'protocol' || kind === 'context-overflow')
-        return 'fatal';
-    if (link === 'pi→provider') {
-        if (kind === 'connection' || kind === 'rate-limit' || kind === 'overloaded')
-            return 'auto';
-        return 'fatal';
-    }
-    return 'manual';
-}
-function rawText(raw) {
-    if (typeof raw === 'string')
-        return raw;
-    if (!isRecord(raw))
-        return '';
-    const candidates = [
-        raw['message'],
-        raw['errorMessage'],
-        raw['reason'],
-        raw['body'],
-        raw['statusText'],
-    ];
-    for (const candidate of candidates) {
-        if (typeof candidate === 'string' && candidate !== '')
-            return candidate;
-    }
-    const nested = raw['error'];
-    if (isRecord(nested)) {
-        const nestedMessage = nested['message'];
-        if (typeof nestedMessage === 'string' && nestedMessage !== '')
-            return nestedMessage;
-        const nestedReason = nested['reason'];
-        if (typeof nestedReason === 'string' && nestedReason !== '')
-            return nestedReason;
-    }
-    return '';
-}
-export function classify(link, raw) {
-    // This diagnostic is the stable machine carrier for an all-managed-pools
-    // cooldown. Do not make its retryability depend on explanatory error prose.
-    if (link === 'pi→provider' && hasManagedProviderCoolingDiagnostic(raw)) {
-        return { kind: 'rate-limit', disposition: 'auto' };
-    }
-    const value = isRecord(raw) ? raw : {};
-    const failure = extractProviderFailureDetails(raw);
-    const nested = failure?.causes ?? [];
-    const signal = recognizeProviderError({
-        code: value['code'] ?? failure?.code ?? nested.find((cause) => cause.code !== undefined)?.code,
-        errno: value['errno'] ?? failure?.errno ?? nested.find((cause) => cause.errno !== undefined)?.errno,
-        status: value['status'] ?? failure?.status,
-        wsCloseCode: value['code'],
-        wsCloseReason: value['reason'],
-        message: [rawText(raw), failure?.body, ...nested.flatMap((cause) => [cause.message, cause.body])]
-            .filter((part) => typeof part === 'string' && part !== '')
-            .join(' '),
-    });
-    const kind = faultKindFromProviderSignal(signal);
-    return { kind, disposition: classifyDisposition(link, kind) };
-}
+var l=Object.defineProperty;var i=(e,o)=>l(e,"name",{value:o,configurable:!0});import{hasManagedProviderCoolingDiagnostic as u}from"./runtime/managed-provider-cooling.js";import{recognizeProviderError as f}from"./provider-error-recognition.js";import{extractProviderFailureDetails as p}from"./provider-failure.js";import{isRecord as a}from"../shared/predicates.js";const m={"rate-limit":"rate_limit",overloaded:"overloaded",connection:"connection",auth:"auth",protocol:"protocol","context-overflow":"context_overflow",wedged:"wedged","model-not-found":"model_not_found",other:"unknown"};function b(e){return{class:m[e.kind],retry_disposition:e.retry.disposition}}i(b,"errorClassFromFault");function v(e){switch(e.kind){case"rate-limit":return"rate-limit";case"auth":return"auth";case"protocol":return"protocol";case"context-overflow":return"context-overflow";case"overloaded":case"overloaded-only":case"transient-http":return"overloaded";case"connection":case"connection-only":return"connection";case"socket":case"service-unavailable":case"other":return"other"}}i(v,"faultKindFromProviderSignal");function g(e,o){return o==="auth"||o==="protocol"||o==="context-overflow"?"fatal":e==="pi\u2192provider"?o==="connection"||o==="rate-limit"||o==="overloaded"?"auto":"fatal":"manual"}i(g,"classifyDisposition");function y(e){if(typeof e=="string")return e;if(!a(e))return"";const o=[e.message,e.errorMessage,e.reason,e.body,e.statusText];for(const t of o)if(typeof t=="string"&&t!=="")return t;const r=e.error;if(a(r)){const t=r.message;if(typeof t=="string"&&t!=="")return t;const s=r.reason;if(typeof s=="string"&&s!=="")return s}return""}i(y,"rawText");function M(e,o){if(e==="pi\u2192provider"&&u(o))return{kind:"rate-limit",disposition:"auto"};const r=a(o)?o:{},t=p(o),s=t?.causes??[],d=f({code:r.code??t?.code??s.find(n=>n.code!==void 0)?.code,errno:r.errno??t?.errno??s.find(n=>n.errno!==void 0)?.errno,status:r.status??t?.status,wsCloseCode:r.code,wsCloseReason:r.reason,message:[y(o),t?.body,...s.flatMap(n=>[n.message,n.body])].filter(n=>typeof n=="string"&&n!=="").join(" ")}),c=v(d);return{kind:c,disposition:g(e,c)}}i(M,"classify");export{M as classify,b as errorClassFromFault};