@sema-agent/server 1.185.0

package/dist/fleet-lease.d.ts

@@ -0,0 +1,76 @@
+import { QuotaLease } from "@sema-agent/registry-core/fleet";
+export declare const NOT_LEASE_TTL_MS: number;
+export declare const EXHAUSTED_RETRY_MS: number;
+export declare const LEASE_PRINCIPAL_CAP = 4096;
+export declare const LEASE_FETCH_TIMEOUT_MS = 2500;
+export type QuotaDenyDetail = {
+    windowType?: "fiveHour" | "weekly" | "budget";
+    remaining?: number;
+    resetAt?: string | null;
+    isEstimate?: boolean;
+    pool?: string;
+};
+type PrincipalState = {
+    kind: "lease";
+    lease: QuotaLease;
+} | {
+    kind: "not-lease";
+    until: number;
+} | {
+    kind: "exhausted";
+    until: number;
+    detail?: QuotaDenyDetail;
+};
+export type LeaseAdmission = {
+    ok: true;
+} | {
+    ok: false;
+    reason: "budget_exhausted";
+    retryAfterSec: number;
+    detail?: QuotaDenyDetail;
+};
+export interface FleetLeaseOpts {
+    center: {
+        baseUrl: string;
+        token: string;
+        worker: string;
+    };
+    fetchImpl?: typeof fetch;
+    logger?: {
+        info?(msg: string, meta?: Record<string, unknown>): void;
+        warn?(msg: string, meta?: Record<string, unknown>): void;
+    };
+    metrics?: {
+        inc(name: string, labels?: Record<string, string>): void;
+    };
+    now?: () => number;
+}
+export declare class FleetLeaseManager {
+    private readonly opts;
+    private readonly state;
+    private readonly inflight;
+    private readonly f;
+    private readonly base;
+    private readonly headers;
+    private readonly now;
+    private failStreak;
+    constructor(opts: FleetLeaseOpts);
+    admit(principal: string): Promise<LeaseAdmission>;
+    recordSpend(principal: string | undefined, d: {
+        weightedTokens?: number;
+        costMicroUsd?: number;
+    }): void;
+    peek(principal: string): PrincipalState["kind"] | undefined;
+    private set;
+    private issueOrRenew;
+    private issueOrRenewInner;
+}
+export declare function buildFleetLeaseFromEnv(cfg: {
+    configCenter?: {
+        baseUrl: string;
+        token: string;
+        worker?: string;
+    };
+}, opts: Omit<FleetLeaseOpts, "center">): FleetLeaseManager | undefined;
+export {};
+//# sourceMappingURL=fleet-lease.d.ts.map

package/dist/fleet-lease.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-lease.d.ts","sourceRoot":"","sources":["../src/fleet-lease.ts"],"names":[],"mappings":"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"}

package/dist/fleet-lease.js

@@ -0,0 +1,124 @@
+import { QuotaLease, leaseExhausted, shouldRenewLease } from "@sema-agent/registry-core/fleet";
+export const NOT_LEASE_TTL_MS = 10 * 60 * 1000;
+export const EXHAUSTED_RETRY_MS = 30 * 1000;
+export const LEASE_PRINCIPAL_CAP = 4096;
+export const LEASE_FETCH_TIMEOUT_MS = 2500;
+export class FleetLeaseManager {
+    opts;
+    state = new Map();
+    inflight = new Map();
+    f;
+    base;
+    headers;
+    now;
+    failStreak = 0;
+    constructor(opts) {
+        this.opts = opts;
+        this.f = opts.fetchImpl ?? fetch;
+        this.base = opts.center.baseUrl.replace(/\/+$/, "");
+        this.headers = { authorization: `Bearer ${opts.center.token}`, "content-type": "application/json" };
+        this.now = opts.now ?? Date.now;
+    }
+    async admit(principal) {
+        const now = this.now();
+        const st = this.state.get(principal);
+        if (st?.kind === "not-lease" && now < st.until)
+            return { ok: true };
+        if (st?.kind === "exhausted" && now < st.until) {
+            return { ok: false, reason: "budget_exhausted", retryAfterSec: Math.ceil((st.until - now) / 1000), ...(st.detail ? { detail: st.detail } : {}) };
+        }
+        if (st?.kind === "lease" && !leaseExhausted(st.lease, now)) {
+            if (shouldRenewLease(st.lease, now))
+                void this.issueOrRenew(principal).catch(() => undefined);
+            return { ok: true };
+        }
+        return this.issueOrRenew(principal);
+    }
+    recordSpend(principal, d) {
+        if (!principal)
+            return;
+        const st = this.state.get(principal);
+        if (st?.kind !== "lease")
+            return;
+        st.lease.consumed.weightedTokens += d.weightedTokens ?? 0;
+        st.lease.consumed.costMicroUsd += d.costMicroUsd ?? 0;
+    }
+    peek(principal) {
+        return this.state.get(principal)?.kind;
+    }
+    set(principal, st) {
+        if (!this.state.has(principal) && this.state.size >= LEASE_PRINCIPAL_CAP) {
+            const oldest = this.state.keys().next().value;
+            this.state.delete(oldest);
+        }
+        this.state.delete(principal);
+        this.state.set(principal, st);
+    }
+    issueOrRenew(principal) {
+        const existing = this.inflight.get(principal);
+        if (existing)
+            return existing;
+        const p = this.issueOrRenewInner(principal).finally(() => this.inflight.delete(principal));
+        this.inflight.set(principal, p);
+        return p;
+    }
+    async issueOrRenewInner(principal) {
+        try {
+            const res = await this.f(`${this.base}/api/fleet/leases`, {
+                method: "POST",
+                headers: this.headers,
+                body: JSON.stringify({ principal, worker: this.opts.center.worker }),
+                signal: AbortSignal.timeout(LEASE_FETCH_TIMEOUT_MS),
+            });
+            if (res.status === 200) {
+                const body = (await res.json());
+                const lease = QuotaLease.parse(body.lease);
+                this.set(principal, { kind: "lease", lease });
+                if (this.failStreak > 0)
+                    this.opts.logger?.info?.("fleet_lease_recovered", { after: this.failStreak });
+                this.failStreak = 0;
+                this.opts.metrics?.inc("fleet_lease_issued_total");
+                return { ok: true };
+            }
+            if (res.status === 409) {
+                const body = (await res.json().catch(() => ({})));
+                if (body.code === "quota_exhausted") {
+                    const until = this.now() + EXHAUSTED_RETRY_MS;
+                    const detail = {
+                        ...(body.windowType !== undefined ? { windowType: body.windowType } : {}),
+                        ...(body.remaining !== undefined ? { remaining: body.remaining } : {}),
+                        ...(body.resetAt !== undefined ? { resetAt: body.resetAt } : {}),
+                        ...(body.isEstimate !== undefined ? { isEstimate: body.isEstimate } : {}),
+                        ...(body.pool !== undefined ? { pool: body.pool } : {}),
+                    };
+                    const hasDetail = Object.keys(detail).length > 0;
+                    this.set(principal, { kind: "exhausted", until, ...(hasDetail ? { detail } : {}) });
+                    this.opts.metrics?.inc("fleet_lease_exhausted_total");
+                    return { ok: false, reason: "budget_exhausted", retryAfterSec: Math.ceil(EXHAUSTED_RETRY_MS / 1000), ...(hasDetail ? { detail } : {}) };
+                }
+                this.set(principal, { kind: "not-lease", until: this.now() + NOT_LEASE_TTL_MS });
+                return { ok: true };
+            }
+            if (res.status === 401 || res.status === 403 || res.status === 400) {
+                this.opts.logger?.warn?.("fleet_lease_auth_error_fail_open", { status: res.status, principal, note: "center rejected the lease request — check the service token / worker id / center URL (budget NOT enforced until fixed)" });
+                this.opts.metrics?.inc("fleet_lease_auth_error_total", { status: String(res.status) });
+                return { ok: true };
+            }
+            throw new Error(`lease ${res.status}`);
+        }
+        catch (err) {
+            this.failStreak += 1;
+            if (this.failStreak === 1)
+                this.opts.logger?.warn?.("fleet_lease_unavailable_fail_open", { error: err instanceof Error ? err.message : String(err) });
+            this.opts.metrics?.inc("fleet_lease_fail_open_total");
+            return { ok: true };
+        }
+    }
+}
+export function buildFleetLeaseFromEnv(cfg, opts) {
+    const cc = cfg.configCenter;
+    if (!cc?.baseUrl || !cc.token || !cc.worker)
+        return undefined;
+    return new FleetLeaseManager({ ...opts, center: { baseUrl: cc.baseUrl, token: cc.token, worker: cc.worker } });
+}
+//# sourceMappingURL=fleet-lease.js.map

package/dist/fleet-lease.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-lease.js","sourceRoot":"","sources":["../src/fleet-lease.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAG/F,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,GAAG,IAAI,CAAC;AAG5C,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAGxC,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AA0B3C,MAAM,OAAO,iBAAiB;IASC;IARZ,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC1C,QAAQ,GAAG,IAAI,GAAG,EAAmC,CAAC;IACtD,CAAC,CAAe;IAChB,IAAI,CAAS;IACb,OAAO,CAAyB;IAChC,GAAG,CAAe;IAC3B,UAAU,GAAG,CAAC,CAAC;IAEvB,YAA6B,IAAoB;QAApB,SAAI,GAAJ,IAAI,CAAgB;QAC/C,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO,GAAG,EAAE,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC;QACpG,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IAClC,CAAC;IAMD,KAAK,CAAC,KAAK,CAAC,SAAiB;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,EAAE,EAAE,IAAI,KAAK,WAAW,IAAI,GAAG,GAAG,EAAE,CAAC,KAAK;YAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;QACpE,IAAI,EAAE,EAAE,IAAI,KAAK,WAAW,IAAI,GAAG,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC;YAC/C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACnJ,CAAC;QACD,IAAI,EAAE,EAAE,IAAI,KAAK,OAAO,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;YAE3D,IAAI,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC;gBAAE,KAAK,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAC9F,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;QACtB,CAAC;QAED,OAAO,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAMD,WAAW,CAAC,SAA6B,EAAE,CAAqD;QAC9F,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,EAAE,EAAE,IAAI,KAAK,OAAO;YAAE,OAAO;QACjC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,cAAc,IAAI,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC;QAC1D,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,IAAI,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC;IACxD,CAAC;IAGD,IAAI,CAAC,SAAiB;QACpB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC;IACzC,CAAC;IAEO,GAAG,CAAC,SAAiB,EAAE,EAAkB;QAC/C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,mBAAmB,EAAE,CAAC;YACzE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAe,CAAC;YACxD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAChC,CAAC;IAEO,YAAY,CAAC,SAAiB;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QAC3F,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QAChC,OAAO,CAAC,CAAC;IACX,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAAC,SAAiB;QAC/C,IAAI,CAAC;YAMH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,mBAAmB,EAAE;gBACxD,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBACpE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,sBAAsB,CAAC;aACpD,CAAC,CAAC;YACH,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACvB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAwB,CAAC;gBACvD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC3C,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;gBAC9C,IAAI,IAAI,CAAC,UAAU,GAAG,CAAC;oBAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,uBAAuB,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;gBACvG,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;gBACpB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,0BAA0B,CAAC,CAAC;gBACnD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;YACtB,CAAC;YACD,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACvB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAwD,CAAC;gBAOzG,IAAI,IAAI,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;oBACpC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,kBAAkB,CAAC;oBAG9C,MAAM,MAAM,GAAoB;wBAC9B,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBACzE,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBACtE,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBAChE,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBACzE,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBACxD,CAAC;oBACF,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;oBACjD,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;oBACpF,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,6BAA6B,CAAC,CAAC;oBACtD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC1I,CAAC;gBAED,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,gBAAgB,EAAE,CAAC,CAAC;gBACjF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;YACtB,CAAC;YAOD,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACnE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,kCAAkC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,wHAAwH,EAAE,CAAC,CAAC;gBAChO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,8BAA8B,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACvF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;YACtB,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,SAAS,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YAEb,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;YACrB,IAAI,IAAI,CAAC,UAAU,KAAK,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,mCAAmC,EAAE,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACtJ,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,6BAA6B,CAAC,CAAC;YACtD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;QACtB,CAAC;IACH,CAAC;CACF;AAOD,MAAM,UAAU,sBAAsB,CACpC,GAA2E,EAC3E,IAAoC;IAEpC,MAAM,EAAE,GAAG,GAAG,CAAC,YAAY,CAAC;IAC5B,IAAI,CAAC,EAAE,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9D,OAAO,IAAI,iBAAiB,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACjH,CAAC"}

package/dist/hooks/hook-runner.d.ts

@@ -0,0 +1,41 @@
+import { HooksConfig } from "@sema-agent/registry-core/hooks";
+import type { Hooks } from "@sema-agent/core";
+import type { Logger } from "../observability/logger.js";
+export declare const MAX_HOOK_ENTRIES_PER_EVENT = 32;
+export declare const MAX_HOOK_COMMAND_CHARS = 8192;
+export declare const MAX_HOOK_TIMEOUT_SECONDS = 600;
+export declare const MAX_HOOK_EVENT_TOTAL_SECONDS = 120;
+export declare const MAX_HOOK_MATCHER_GROUPS = 16;
+export declare const MAX_HOOK_HTTP_HEADERS = 32;
+export declare const MAX_HOOK_OUTPUT_BYTES: number;
+export interface ParseHooksConfigResult {
+    config?: HooksConfig;
+    error?: string;
+}
+export declare function parseHooksConfig(raw: unknown): ParseHooksConfigResult;
+export declare function hookMatcherMatches(matcher: string | undefined, value: string): boolean | "invalid";
+export declare function hookIfMatches(cond: string, payload: unknown): true | "not_matched" | "unevaluable";
+export interface HookRunnerContext {
+    logger: Logger;
+    sessionId: string;
+    cwd: string;
+    permissionMode?: string;
+    shellEnv?: Record<string, string>;
+    hookLlm?: HookLlmCall;
+    hookAgent?: HookLlmCall;
+    wake?: (text: string) => Promise<boolean>;
+}
+export type HookLlmCall = (opts: {
+    prompt: string;
+    model?: string;
+    timeoutMs: number;
+}) => Promise<{
+    ok: true;
+    text: string;
+} | {
+    ok: false;
+    error: string;
+}>;
+export declare function buildTaskHooks(config: HooksConfig, ctx: HookRunnerContext): Hooks | undefined;
+export declare function composeHooks(deployment: Hooks | undefined, task: Hooks): Hooks;
+//# sourceMappingURL=hook-runner.d.ts.map

package/dist/hooks/hook-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-runner.d.ts","sourceRoot":"","sources":["../../src/hooks/hook-runner.ts"],"names":[],"mappings":"AA2CA,OAAO,EACL,WAAW,EAWZ,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EACV,KAAK,EAaN,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAIzD,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAC7C,eAAO,MAAM,sBAAsB,OAAQ,CAAC;AAE5C,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAG5C,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAEhD,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,eAAO,MAAM,qBAAqB,QAAc,CAAC;AAgEjD,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,sBAAsB,CA4CrE;AAID,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAQlG;AAQD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,aAAa,GAAG,aAAa,CAwBlG;AAGD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAElB,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAGlC,OAAO,CAAC,EAAE,WAAW,CAAC;IAEtB,SAAS,CAAC,EAAE,WAAW,CAAC;IAIxB,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3C;AAID,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAmb9J,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,iBAAiB,GAAG,KAAK,GAAG,SAAS,CA6Y7F;AAcD,wBAAgB,YAAY,CAAC,UAAU,EAAE,KAAK,GAAG,SAAS,EAAE,IAAI,EAAE,KAAK,GAAG,KAAK,CA+H9E"}