@namzu/sdk 38.1.0 → 39.0.0

package/dist/manager/resident/consumption.d.ts

@@ -0,0 +1,104 @@
+import { z } from 'zod';
+import type { ResidentActivityScope, ResidentActivitySource, ResidentAdmission, ResidentSettlement } from './activity.js';
+declare const receiptSchema: z.ZodEffects<z.ZodObject<{
+    runId: z.ZodString;
+    /** Own usage includes retry and side-call spend; never add cache buckets again. */
+    ownTokens: z.ZodNullable<z.ZodNumber>;
+    treeTokens: z.ZodNullable<z.ZodNumber>;
+    ownCostUsd: z.ZodNullable<z.ZodNumber>;
+    unpricedOwnTokens: z.ZodNullable<z.ZodNumber>;
+    usageFinal: z.ZodBoolean;
+    cleanup: z.ZodEnum<["confirmed", "unconfirmed", "unknown"]>;
+    verification: z.ZodEnum<["recorded", "unconfigured", "unconfirmed"]>;
+}, "strip", z.ZodTypeAny, {
+    runId: string;
+    verification: "unconfirmed" | "recorded" | "unconfigured";
+    ownTokens: number | null;
+    treeTokens: number | null;
+    ownCostUsd: number | null;
+    unpricedOwnTokens: number | null;
+    usageFinal: boolean;
+    cleanup: "unknown" | "confirmed" | "unconfirmed";
+}, {
+    runId: string;
+    verification: "unconfirmed" | "recorded" | "unconfigured";
+    ownTokens: number | null;
+    treeTokens: number | null;
+    ownCostUsd: number | null;
+    unpricedOwnTokens: number | null;
+    usageFinal: boolean;
+    cleanup: "unknown" | "confirmed" | "unconfirmed";
+}>, {
+    runId: string;
+    verification: "unconfirmed" | "recorded" | "unconfigured";
+    ownTokens: number | null;
+    treeTokens: number | null;
+    ownCostUsd: number | null;
+    unpricedOwnTokens: number | null;
+    usageFinal: boolean;
+    cleanup: "unknown" | "confirmed" | "unconfirmed";
+}, {
+    runId: string;
+    verification: "unconfirmed" | "recorded" | "unconfigured";
+    ownTokens: number | null;
+    treeTokens: number | null;
+    ownCostUsd: number | null;
+    unpricedOwnTokens: number | null;
+    usageFinal: boolean;
+    cleanup: "unknown" | "confirmed" | "unconfirmed";
+}>;
+/** @experimental Host-authenticated cumulative root receipt. Cost covers this root only. */
+export type ResidentConsumptionReceipt = z.infer<typeof receiptSchema>;
+/** @experimental A host resolves only authoritative admitted claims and bounds each read. */
+export interface ResidentConsumptionResolver {
+    /** Worst-case bytes read per resolution; reserved before calling the adapter. */
+    readonly maxReadBytes: number;
+    resolve(admission: ResidentAdmission, signal?: AbortSignal): Promise<ResidentConsumptionReceipt | null>;
+}
+/** @experimental Bounds the entire inspection, not just each page. No inference or writes. */
+export interface ResidentConsumptionOptions {
+    readonly cursor?: number;
+    readonly maxRevisions?: number;
+    readonly maxHistoryBytes?: number;
+    readonly maxReceiptBytes?: number;
+}
+/** @experimental Missing and deferred receipts never establish zero usage. */
+export interface ResidentConsumptionAttempt extends ResidentAdmission {
+    readonly settlement: ResidentSettlement | null;
+    readonly receipt: ResidentConsumptionReceipt | null;
+    readonly receiptStatus: 'available' | 'missing' | 'invalid' | 'deferred' | 'duplicate-run';
+}
+/** @experimental An evidence projection, not a bill or an enforced spending cap. */
+export interface ResidentConsumptionReport {
+    readonly scope: ResidentActivityScope;
+    readonly fromRevision: number;
+    readonly throughRevision: number;
+    readonly nextCursor: number | null;
+    readonly historyComplete: boolean;
+    readonly unavailableRevisions: readonly number[];
+    readonly historyBytes: number;
+    readonly receiptBytesReserved: number;
+    readonly archivedPursuits: readonly string[];
+    readonly attempts: readonly ResidentConsumptionAttempt[];
+    readonly recorded: {
+        readonly ownTokens: number;
+        readonly treeTokens: number;
+        readonly ownCostUsd: number;
+        readonly unpricedOwnTokens: number;
+    };
+    readonly unknown: {
+        readonly ownUsageAttempts: number;
+        readonly treeUsageAttempts: number;
+        readonly ownPriceAttempts: number;
+    };
+    /** Requires complete history and final receipts; says nothing about external billing. */
+    readonly usageComplete: boolean;
+}
+/**
+ * @experimental Inspect cumulative root receipts once per admitted claim. Historical
+ * archive/reconcile events never erase consumption. Tree tokens are a separate total:
+ * adding them to own tokens would count the root twice. Descendant prices are unknown.
+ */
+export declare function inspectResidentConsumption(source: ResidentActivitySource, resolver: ResidentConsumptionResolver, options?: ResidentConsumptionOptions, signal?: AbortSignal): Promise<ResidentConsumptionReport>;
+export {};
+//# sourceMappingURL=consumption.d.ts.map

package/dist/manager/resident/consumption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumption.d.ts","sourceRoot":"","sources":["../../../src/manager/resident/consumption.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EACX,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,MAAM,eAAe,CAAA;AAkBtB,QAAA,MAAM,aAAa;;IAGjB,mFAAmF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsBlF,CAAA;AAEH,4FAA4F;AAC5F,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AAEtE,6FAA6F;AAC7F,MAAM,WAAW,2BAA2B;IAC3C,iFAAiF;IACjF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,OAAO,CACN,SAAS,EAAE,iBAAiB,EAC5B,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC,CAAA;CAC7C;AAED,8FAA8F;AAC9F,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CACjC;AAED,8EAA8E;AAC9E,MAAM,WAAW,0BAA2B,SAAQ,iBAAiB;IACpE,QAAQ,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI,CAAA;IAC9C,QAAQ,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAAA;IACnD,QAAQ,CAAC,aAAa,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,eAAe,CAAA;CAC1F;AAED,oFAAoF;AACpF,MAAM,WAAW,yBAAyB;IACzC,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAA;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;IACjC,QAAQ,CAAC,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAA;IAChD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAA;IACrC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5C,QAAQ,CAAC,QAAQ,EAAE,SAAS,0BAA0B,EAAE,CAAA;IACxD,QAAQ,CAAC,QAAQ,EAAE;QAClB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;QAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;QAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;QAC3B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;KAClC,CAAA;IACD,QAAQ,CAAC,OAAO,EAAE;QACjB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;QACjC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;QAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;KACjC,CAAA;IACD,yFAAyF;IACzF,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;CAC/B;AAED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAC/C,MAAM,EAAE,sBAAsB,EAC9B,QAAQ,EAAE,2BAA2B,EACrC,OAAO,GAAE,0BAA+B,EACxC,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,yBAAyB,CAAC,CAkMpC"}

package/dist/manager/resident/consumption.js

@@ -0,0 +1,233 @@
+import { z } from 'zod';
+const count = z.number().int().nonnegative().safe();
+const uuidKey = (id) => id.toLowerCase();
+const admissionSchema = z.object({
+    revision: count.positive(),
+    pursuitRevision: count.positive(),
+    pursuitId: z.string().uuid(),
+    claimId: z.string().uuid(),
+    step: count.positive(),
+    objective: z.string().min(1).max(8000),
+});
+const settlementSchema = z.object({
+    revision: count.positive(),
+    pursuitId: z.string().uuid(),
+    claimId: z.string().uuid(),
+    outcome: z.enum(['wait', 'complete', 'blocked']),
+});
+const receiptSchema = z
+    .object({
+    runId: z.string().uuid(),
+    /** Own usage includes retry and side-call spend; never add cache buckets again. */
+    ownTokens: count.nullable(),
+    treeTokens: count.nullable(),
+    ownCostUsd: z.number().nonnegative().finite().nullable(),
+    unpricedOwnTokens: count.nullable(),
+    usageFinal: z.boolean(),
+    cleanup: z.enum(['confirmed', 'unconfirmed', 'unknown']),
+    verification: z.enum(['recorded', 'unconfigured', 'unconfirmed']),
+})
+    .superRefine((receipt, ctx) => {
+    if (receipt.ownTokens !== null &&
+        receipt.treeTokens !== null &&
+        receipt.treeTokens < receipt.ownTokens)
+        ctx.addIssue({ code: z.ZodIssueCode.custom, message: 'Tree usage is below own usage.' });
+    if (receipt.ownTokens !== null &&
+        receipt.unpricedOwnTokens !== null &&
+        receipt.unpricedOwnTokens > receipt.ownTokens)
+        ctx.addIssue({ code: z.ZodIssueCode.custom, message: 'Unpriced usage exceeds own usage.' });
+});
+/**
+ * @experimental Inspect cumulative root receipts once per admitted claim. Historical
+ * archive/reconcile events never erase consumption. Tree tokens are a separate total:
+ * adding them to own tokens would count the root twice. Descendant prices are unknown.
+ */
+export async function inspectResidentConsumption(source, resolver, options = {}, signal) {
+    const scope = z
+        .object({
+        tenantId: z.string().uuid(),
+        agentKey: z.string().min(1).max(200),
+        throughRevision: count.positive(),
+    })
+        .parse(source.scope);
+    const from = z
+        .number()
+        .int()
+        .positive()
+        .max(scope.throughRevision)
+        .parse(options.cursor ?? 1);
+    const maxRevisions = z
+        .number()
+        .int()
+        .positive()
+        .max(4096)
+        .parse(options.maxRevisions ?? 256);
+    const maxHistoryBytes = z
+        .number()
+        .int()
+        .positive()
+        .max(8 * 1024 * 1024)
+        .parse(options.maxHistoryBytes ?? 8 * 1024 * 1024);
+    const maxReceiptBytes = z
+        .number()
+        .int()
+        .nonnegative()
+        .max(64 * 1024 * 1024)
+        .parse(options.maxReceiptBytes ?? 16 * 1024 * 1024);
+    const resolutionBytes = z
+        .number()
+        .int()
+        .positive()
+        .max(1024 * 1024)
+        .parse(resolver.maxReadBytes);
+    const admissions = new Map();
+    const settlements = new Map();
+    const unavailable = new Set();
+    const archived = new Map();
+    let cursor = from;
+    let through = from - 1;
+    let historyBytes = 0;
+    while (cursor !== null && through - from + 1 < maxRevisions && historyBytes < maxHistoryBytes) {
+        signal?.throwIfAborted();
+        const page = await source.read({
+            cursor,
+            maxRevisions: Math.min(32, maxRevisions - (through - from + 1)),
+            maxReadBytes: maxHistoryBytes - historyBytes,
+        }, signal);
+        signal?.throwIfAborted();
+        if (page.scope.tenantId !== scope.tenantId ||
+            page.scope.agentKey !== scope.agentKey ||
+            page.scope.throughRevision !== scope.throughRevision ||
+            page.fromRevision !== cursor ||
+            !Number.isSafeInteger(page.throughRevision) ||
+            page.throughRevision < cursor - 1 ||
+            page.throughRevision > Math.min(scope.throughRevision, from + maxRevisions - 1) ||
+            !Number.isSafeInteger(page.scannedBytes) ||
+            page.scannedBytes < 0 ||
+            page.scannedBytes > maxHistoryBytes - historyBytes ||
+            page.nextCursor !==
+                (page.throughRevision === scope.throughRevision ? null : page.throughRevision + 1))
+            throw new Error('Invalid resident activity page.');
+        if (page.admissions.length > 32 ||
+            page.settlements.length > 32 ||
+            page.archivedPursuits.length > 1024)
+            throw new Error('Resident activity page exceeds event bounds.');
+        if (page.unavailableRevisions.length > 33)
+            throw new Error('Invalid unavailable revision list.');
+        for (const revision of page.unavailableRevisions) {
+            count.positive().parse(revision);
+            if (revision < Math.max(1, cursor - 1) || revision > page.throughRevision)
+                throw new Error('Unavailable revision is outside the page.');
+            unavailable.add(revision);
+        }
+        for (const raw of page.admissions) {
+            const admission = Object.freeze(admissionSchema.parse(raw));
+            if (admission.revision < cursor || admission.revision > page.throughRevision)
+                throw new Error('Resident admission is outside its history page.');
+            if (admissions.has(uuidKey(admission.claimId)))
+                throw new Error('Duplicate resident admission.');
+            admissions.set(uuidKey(admission.claimId), admission);
+        }
+        for (const raw of page.settlements) {
+            const settlement = Object.freeze(settlementSchema.parse(raw));
+            if (settlement.revision < cursor || settlement.revision > page.throughRevision)
+                throw new Error('Resident settlement is outside its history page.');
+            if (settlements.has(uuidKey(settlement.claimId)))
+                throw new Error('Duplicate resident settlement.');
+            settlements.set(uuidKey(settlement.claimId), settlement);
+        }
+        for (const id of page.archivedPursuits)
+            archived.set(uuidKey(z.string().uuid().parse(id)), id);
+        historyBytes += page.scannedBytes;
+        through = page.throughRevision;
+        if (page.nextCursor === cursor)
+            break;
+        cursor = page.nextCursor;
+    }
+    const attempts = [];
+    let receiptBytesReserved = 0;
+    for (const admission of admissions.values()) {
+        signal?.throwIfAborted();
+        const settlement = settlements.get(uuidKey(admission.claimId));
+        if (settlement &&
+            (uuidKey(settlement.pursuitId) !== uuidKey(admission.pursuitId) ||
+                settlement.revision <= admission.revision))
+            throw new Error('Resident settlement does not follow its admitted claim.');
+        let receipt = null;
+        let receiptStatus = 'deferred';
+        if (receiptBytesReserved + resolutionBytes <= maxReceiptBytes) {
+            receiptBytesReserved += resolutionBytes;
+            try {
+                const value = await resolver.resolve(admission, signal);
+                signal?.throwIfAborted();
+                receipt = value === null ? null : receiptSchema.parse(value);
+                receiptStatus = receipt ? 'available' : 'missing';
+            }
+            catch {
+                signal?.throwIfAborted();
+                receiptStatus = 'invalid';
+            }
+        }
+        attempts.push({
+            ...admission,
+            settlement: settlements.get(uuidKey(admission.claimId)) ?? null,
+            receipt,
+            receiptStatus,
+        });
+    }
+    // A copied root receipt must not authenticate two claims. Exclude BOTH records.
+    const runCounts = new Map();
+    for (const { receipt } of attempts)
+        if (receipt)
+            runCounts.set(uuidKey(receipt.runId), (runCounts.get(uuidKey(receipt.runId)) ?? 0) + 1);
+    const checked = attempts.map((attempt) => attempt.receipt && (runCounts.get(uuidKey(attempt.receipt.runId)) ?? 0) > 1
+        ? { ...attempt, receipt: null, receiptStatus: 'duplicate-run' }
+        : attempt);
+    const recorded = { ownTokens: 0, treeTokens: 0, ownCostUsd: 0, unpricedOwnTokens: 0 };
+    const unknown = { ownUsageAttempts: 0, treeUsageAttempts: 0, ownPriceAttempts: 0 };
+    const add = (a, b) => {
+        const result = a + b;
+        if (!Number.isSafeInteger(result))
+            throw new Error('Resident consumption exceeds the safe integer range.');
+        return result;
+    };
+    let priceCorrection = 0;
+    for (const { receipt } of checked) {
+        if (!receipt?.usageFinal || receipt.ownTokens === null)
+            unknown.ownUsageAttempts++;
+        if (!receipt?.usageFinal || receipt.treeTokens === null)
+            unknown.treeUsageAttempts++;
+        if (!receipt?.usageFinal ||
+            receipt.ownCostUsd === null ||
+            receipt.unpricedOwnTokens === null ||
+            receipt.unpricedOwnTokens > 0)
+            unknown.ownPriceAttempts++;
+        recorded.ownTokens = add(recorded.ownTokens, receipt?.ownTokens ?? 0);
+        recorded.treeTokens = add(recorded.treeTokens, receipt?.treeTokens ?? 0);
+        recorded.unpricedOwnTokens = add(recorded.unpricedOwnTokens, receipt?.unpricedOwnTokens ?? 0);
+        // Compensated addition limits drift; provider prices are still estimates, not a bill.
+        const y = (receipt?.ownCostUsd ?? 0) - priceCorrection;
+        const next = recorded.ownCostUsd + y;
+        priceCorrection = next - recorded.ownCostUsd - y;
+        if (!Number.isFinite(next))
+            throw new Error('Resident cost exceeds the supported range.');
+        recorded.ownCostUsd = next;
+    }
+    const historyComplete = from === 1 && cursor === null && unavailable.size === 0;
+    return {
+        scope,
+        fromRevision: from,
+        throughRevision: through,
+        nextCursor: cursor,
+        historyComplete,
+        unavailableRevisions: [...unavailable],
+        historyBytes,
+        receiptBytesReserved,
+        archivedPursuits: [...archived.values()],
+        attempts: checked,
+        recorded,
+        unknown,
+        usageComplete: historyComplete && unknown.ownUsageAttempts === 0 && unknown.treeUsageAttempts === 0,
+    };
+}
+//# sourceMappingURL=consumption.js.map

package/dist/manager/resident/consumption.js.map

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

package/dist/manager/resident/delivery-window.d.ts

@@ -0,0 +1,22 @@
+import type { ResidentDeliveryGate } from './outbox.js';
+/** @experimental A daily allowed delivery window in an explicit named time zone. */
+export interface ResidentDeliveryWindowConfig {
+    readonly timeZone: string;
+    /** Inclusive local minute of the day, from 0 through 1439. */
+    readonly startMinute: number;
+    /** Exclusive local minute of the day; less than startMinute means overnight. */
+    readonly endMinute: number;
+}
+/**
+ * @experimental Admit delivery within a daily local-time window, without model
+ * calls. The start is inclusive and the end exclusive; equal boundaries are
+ * rejected. Omit this gate when no time restriction is wanted.
+ *
+ * Future admission searches actual UTC minute boundaries, so nonexistent local
+ * times are skipped and repeated times can open the window twice. The search
+ * is bounded to 72 hours and the Date range; no opening returns nextCheckAt:null.
+ * Historic time zones with second-based offsets may defer up to one extra minute.
+ * This gate does not schedule a timer, authorize a destination or send a message.
+ */
+export declare function createResidentDeliveryWindow(config: ResidentDeliveryWindowConfig): ResidentDeliveryGate;
+//# sourceMappingURL=delivery-window.d.ts.map

package/dist/manager/resident/delivery-window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-window.d.ts","sourceRoot":"","sources":["../../../src/manager/resident/delivery-window.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAEvD,oFAAoF;AACpF,MAAM,WAAW,4BAA4B;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,8DAA8D;IAC9D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,gFAAgF;IAChF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC1B;AAKD;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAC3C,MAAM,EAAE,4BAA4B,GAClC,oBAAoB,CAiEtB"}

package/dist/manager/resident/delivery-window.js

@@ -0,0 +1,78 @@
+const minuteMs = 60_000;
+const searchMinutes = 72 * 60;
+/**
+ * @experimental Admit delivery within a daily local-time window, without model
+ * calls. The start is inclusive and the end exclusive; equal boundaries are
+ * rejected. Omit this gate when no time restriction is wanted.
+ *
+ * Future admission searches actual UTC minute boundaries, so nonexistent local
+ * times are skipped and repeated times can open the window twice. The search
+ * is bounded to 72 hours and the Date range; no opening returns nextCheckAt:null.
+ * Historic time zones with second-based offsets may defer up to one extra minute.
+ * This gate does not schedule a timer, authorize a destination or send a message.
+ */
+export function createResidentDeliveryWindow(config) {
+    if (!config ||
+        typeof config.timeZone !== 'string' ||
+        config.timeZone.length === 0 ||
+        config.timeZone !== config.timeZone.trim() ||
+        /^[+-]/.test(config.timeZone) ||
+        !Number.isInteger(config.startMinute) ||
+        config.startMinute < 0 ||
+        config.startMinute > 1439 ||
+        !Number.isInteger(config.endMinute) ||
+        config.endMinute < 0 ||
+        config.endMinute > 1439 ||
+        config.startMinute === config.endMinute) {
+        throw new TypeError('Delivery window requires a named time zone and distinct minutes 0–1439.');
+    }
+    let formatter;
+    try {
+        formatter = new Intl.DateTimeFormat('en-US', {
+            timeZone: config.timeZone,
+            hour: '2-digit',
+            minute: '2-digit',
+            hourCycle: 'h23',
+        });
+    }
+    catch {
+        throw new TypeError('Delivery window requires a valid named time zone.');
+    }
+    const { startMinute, endMinute } = config;
+    const timeZone = formatter.resolvedOptions().timeZone;
+    const allowed = (at) => {
+        const parts = formatter.formatToParts(at);
+        const hour = Number(parts.find((part) => part.type === 'hour')?.value);
+        const minute = Number(parts.find((part) => part.type === 'minute')?.value);
+        const localMinute = hour * 60 + minute;
+        return startMinute < endMinute
+            ? localMinute >= startMinute && localMinute < endMinute
+            : localMinute >= startMinute || localMinute < endMinute;
+    };
+    return (_message, now) => {
+        if (!Number.isFinite(now) || !Number.isFinite(new Date(now).getTime())) {
+            throw new TypeError('Delivery window requires a finite timestamp within the Date range.');
+        }
+        if (allowed(now))
+            return { allow: true };
+        const firstMinute = (Math.floor(now / minuteMs) + 1) * minuteMs;
+        for (let offset = 0; offset < searchMinutes; offset++) {
+            const candidate = firstMinute + offset * minuteMs;
+            if (!Number.isFinite(new Date(candidate).getTime()))
+                break;
+            if (allowed(candidate)) {
+                return {
+                    allow: false,
+                    nextCheckAt: candidate,
+                    reason: `Outside the allowed daily delivery window in ${timeZone}.`,
+                };
+            }
+        }
+        return {
+            allow: false,
+            nextCheckAt: null,
+            reason: `No allowed delivery minute found within the next 72 hours and Date range in ${timeZone}.`,
+        };
+    };
+}
+//# sourceMappingURL=delivery-window.js.map

package/dist/manager/resident/delivery-window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-window.js","sourceRoot":"","sources":["../../../src/manager/resident/delivery-window.ts"],"names":[],"mappings":"AAWA,MAAM,QAAQ,GAAG,MAAM,CAAA;AACvB,MAAM,aAAa,GAAG,EAAE,GAAG,EAAE,CAAA;AAE7B;;;;;;;;;;GAUG;AACH,MAAM,UAAU,4BAA4B,CAC3C,MAAoC;IAEpC,IACC,CAAC,MAAM;QACP,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ;QACnC,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAC5B,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE;QAC1C,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC7B,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC;QACrC,MAAM,CAAC,WAAW,GAAG,CAAC;QACtB,MAAM,CAAC,WAAW,GAAG,IAAI;QACzB,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC;QACnC,MAAM,CAAC,SAAS,GAAG,CAAC;QACpB,MAAM,CAAC,SAAS,GAAG,IAAI;QACvB,MAAM,CAAC,WAAW,KAAK,MAAM,CAAC,SAAS,EACtC,CAAC;QACF,MAAM,IAAI,SAAS,CAAC,yEAAyE,CAAC,CAAA;IAC/F,CAAC;IAED,IAAI,SAA8B,CAAA;IAClC,IAAI,CAAC;QACJ,SAAS,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;YAC5C,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,KAAK;SAChB,CAAC,CAAA;IACH,CAAC;IAAC,MAAM,CAAC;QACR,MAAM,IAAI,SAAS,CAAC,mDAAmD,CAAC,CAAA;IACzE,CAAC;IACD,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,MAAM,CAAA;IACzC,MAAM,QAAQ,GAAG,SAAS,CAAC,eAAe,EAAE,CAAC,QAAQ,CAAA;IACrD,MAAM,OAAO,GAAG,CAAC,EAAU,EAAW,EAAE;QACvC,MAAM,KAAK,GAAG,SAAS,CAAC,aAAa,CAAC,EAAE,CAAC,CAAA;QACzC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC,CAAA;QACtE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAA;QAC1E,MAAM,WAAW,GAAG,IAAI,GAAG,EAAE,GAAG,MAAM,CAAA;QACtC,OAAO,WAAW,GAAG,SAAS;YAC7B,CAAC,CAAC,WAAW,IAAI,WAAW,IAAI,WAAW,GAAG,SAAS;YACvD,CAAC,CAAC,WAAW,IAAI,WAAW,IAAI,WAAW,GAAG,SAAS,CAAA;IACzD,CAAC,CAAA;IAED,OAAO,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE;QACxB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,SAAS,CAAC,oEAAoE,CAAC,CAAA;QAC1F,CAAC;QACD,IAAI,OAAO,CAAC,GAAG,CAAC;YAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;QAExC,MAAM,WAAW,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAA;QAC/D,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,MAAM,EAAE,EAAE,CAAC;YACvD,MAAM,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAA;YACjD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;gBAAE,MAAK;YAC1D,IAAI,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;gBACxB,OAAO;oBACN,KAAK,EAAE,KAAK;oBACZ,WAAW,EAAE,SAAS;oBACtB,MAAM,EAAE,gDAAgD,QAAQ,GAAG;iBACnE,CAAA;YACF,CAAC;QACF,CAAC;QACD,OAAO;YACN,KAAK,EAAE,KAAK;YACZ,WAAW,EAAE,IAAI;YACjB,MAAM,EAAE,+EAA+E,QAAQ,GAAG;SAClG,CAAA;IACF,CAAC,CAAA;AACF,CAAC"}

package/dist/manager/resident/evidence-recall.d.ts

@@ -0,0 +1,24 @@
+import type { RunEvidenceScope } from '../../store/evidence/types.js';
+import type { PrepareStep } from '../../types/run/prepare-step.js';
+import { type ResidentState } from './store.js';
+import type { ResidentToolEvidenceSource } from './tool-evidence.js';
+/** @experimental Automatic original-tool recall for exactly one admitted resident run. */
+export interface ResidentEvidenceRecallOptions {
+    readonly source: ResidentToolEvidenceSource;
+    /** Already admitted state; summaries supply search words, never new observations. */
+    readonly state: ResidentState;
+    /** The current executor, distinct from historical Session/run addresses. */
+    readonly scope: RunEvidenceScope;
+    readonly maxChars?: number;
+    readonly maxPassages?: number;
+    readonly timeoutMs?: number;
+    /** Host tool names whose successful archival copies should not occupy result slots. */
+    readonly excludeSuccessfulTools?: readonly string[];
+}
+/**
+ * Reuses the shared bounded ranking/rendering engine while retaining the
+ * pursuit's settlement authority. No arbitrary Session discovery, saved fact
+ * cache, inference, workspace reread or action replay is performed here.
+ */
+export declare function createResidentEvidenceRecallStep(options: ResidentEvidenceRecallOptions): PrepareStep;
+//# sourceMappingURL=evidence-recall.d.ts.map

package/dist/manager/resident/evidence-recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence-recall.d.ts","sourceRoot":"","sources":["../../../src/manager/resident/evidence-recall.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAElE,OAAO,EAAE,KAAK,aAAa,EAAuB,MAAM,YAAY,CAAA;AACpE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAA;AAEpE,0FAA0F;AAC1F,MAAM,WAAW,6BAA6B;IAC7C,QAAQ,CAAC,MAAM,EAAE,0BAA0B,CAAA;IAC3C,qFAAqF;IACrF,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;IAC7B,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAA;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,uFAAuF;IACvF,QAAQ,CAAC,sBAAsB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACnD;AA6CD;;;;GAIG;AACH,wBAAgB,gCAAgC,CAC/C,OAAO,EAAE,6BAA6B,GACpC,WAAW,CA2Rb"}