@namzu/sdk 38.1.0 → 39.0.0

package/dist/manager/resident/history.js

@@ -0,0 +1,203 @@
+import { z } from 'zod';
+import { ResidentHistoryPageLimit } from './history-disk.js';
+const SCAN_BYTES = 8 * 1024 * 1024;
+const SCAN_REVISIONS = 32;
+const TEXT_PAGE_CHARS = 6_000;
+function episode(before, after, id) {
+    const previous = before?.pursuits.find((p) => p.id === id)?.state;
+    const current = after?.pursuits.find((p) => p.id === id)?.state;
+    if (!before ||
+        !after ||
+        !previous ||
+        !current ||
+        previous.phase !== 'running' ||
+        !previous.claimId ||
+        current.phase === 'running' ||
+        current.claimId !== null ||
+        current.summary === null ||
+        current.stepsAdmitted !== previous.stepsAdmitted ||
+        current.revision !== previous.revision + 1)
+        return null;
+    return {
+        step: current.stepsAdmitted,
+        claimId: previous.claimId,
+        kind: current.phase === 'waiting' ? 'wait' : current.phase,
+        parts: [
+            { source: 'summary', text: current.summary },
+            ...(previous.wakeEvidence ?? []).map((entry) => ({
+                source: 'wake',
+                text: entry.reason,
+                receivedAt: entry.receivedAt,
+            })),
+        ],
+    };
+}
+function boundary(text, offset) {
+    const current = text.charCodeAt(offset);
+    const previous = text.charCodeAt(offset - 1);
+    return !(current >= 0xdc00 && current <= 0xdfff && previous >= 0xd800 && previous <= 0xdbff);
+}
+function textSlice(text, offset, maxChars) {
+    let end = Math.min(text.length, offset + maxChars);
+    if (!boundary(text, end))
+        end--;
+    return text.slice(offset, end);
+}
+/** Internal disk adapter. Other backends may implement ResidentHistorySource directly. */
+export function createResidentHistorySource(scopeInput, identity, load) {
+    const scope = Object.freeze({ ...scopeInput });
+    const expected = { ...identity };
+    const revisionSchema = z.number().int().min(1).max(scope.throughRevision).safe();
+    function page(signal, requestedBytes) {
+        const limit = z
+            .number()
+            .int()
+            .min(1)
+            .max(SCAN_BYTES)
+            .parse(requestedBytes ?? SCAN_BYTES);
+        const budget = { remaining: limit, bytesRead: 0, signal };
+        const unavailable = new Set();
+        let scanned = 0;
+        const cache = new Map();
+        return {
+            budget,
+            async load(revision) {
+                signal?.throwIfAborted();
+                if (cache.has(revision))
+                    return cache.get(revision) ?? null;
+                if (scanned >= SCAN_REVISIONS)
+                    throw new ResidentHistoryPageLimit();
+                scanned++;
+                let record = null;
+                try {
+                    record = await load(revision, budget);
+                    const pursuit = record.pursuits.find((p) => p.id === scope.pursuitId);
+                    if (record.revision !== revision ||
+                        record.tenantId !== scope.tenantId ||
+                        record.agentKey !== scope.agentKey ||
+                        (pursuit &&
+                            (pursuit.state.identity !== expected.identity ||
+                                pursuit.state.objective !== expected.objective)))
+                        throw new Error('History identity does not match its bound pursuit.');
+                }
+                catch (error) {
+                    signal?.throwIfAborted();
+                    if (error instanceof ResidentHistoryPageLimit)
+                        throw error;
+                    unavailable.add(revision);
+                    record = null;
+                }
+                // Adjacent revisions are reused on the next scan iteration, without
+                // keeping the whole archive in memory.
+                if (cache.size >= 2)
+                    cache.delete(cache.keys().next().value);
+                cache.set(revision, record);
+                return record;
+            },
+            counts: () => ({
+                scannedRevisions: scanned,
+                scannedBytes: budget.bytesRead,
+                unavailableRevisions: [...unavailable],
+            }),
+        };
+    }
+    return Object.freeze({
+        scope,
+        async search(options = {}, signal) {
+            signal?.throwIfAborted();
+            const query = z
+                .string()
+                .max(256)
+                .parse(options.query ?? '');
+            const limit = z
+                .number()
+                .int()
+                .min(1)
+                .max(8)
+                .parse(options.limit ?? 5);
+            let revision = revisionSchema.parse(options.cursor ?? scope.throughRevision);
+            const reader = page(signal, options.maxReadBytes);
+            const matches = [];
+            while (revision >= 2 && matches.length < limit) {
+                let found;
+                try {
+                    const after = await reader.load(revision);
+                    const before = await reader.load(revision - 1);
+                    found = episode(before, after, scope.pursuitId);
+                }
+                catch (error) {
+                    if (!(error instanceof ResidentHistoryPageLimit))
+                        throw error;
+                    break;
+                }
+                if (found) {
+                    const matchingParts = found.parts.flatMap((part, index) => part.text.includes(query) ? [index] : []);
+                    const part = matchingParts[0];
+                    const matched = part === undefined ? undefined : found.parts[part];
+                    if (matched && part !== undefined) {
+                        let start = Math.max(0, matched.text.indexOf(query) - 120);
+                        if (!boundary(matched.text, start))
+                            start--;
+                        matches.push({
+                            revision,
+                            part,
+                            step: found.step,
+                            claimId: found.claimId,
+                            kind: found.kind,
+                            source: matched.source,
+                            excerpt: textSlice(matched.text, start, 512),
+                            matchingParts,
+                        });
+                    }
+                }
+                revision--;
+            }
+            const nextCursor = revision >= 2 ? revision : null;
+            const counts = reader.counts();
+            return {
+                matches,
+                nextCursor,
+                ...counts,
+                incomplete: nextCursor !== null || counts.unavailableRevisions.length > 0,
+            };
+        },
+        async read(options, signal) {
+            const revision = revisionSchema.parse(options.revision);
+            const part = z.number().int().min(0).max(16).parse(options.part);
+            const offset = z
+                .number()
+                .int()
+                .nonnegative()
+                .safe()
+                .parse(options.offset ?? 0);
+            const reader = page(signal, options.maxReadBytes);
+            const after = await reader.load(revision);
+            const before = revision >= 2 ? await reader.load(revision - 1) : null;
+            const found = episode(before, after, scope.pursuitId);
+            const selected = found?.parts[part];
+            if (!selected || !found)
+                return { entry: null, ...reader.counts() };
+            if (offset > selected.text.length || !boundary(selected.text, offset))
+                throw new Error('Invalid retained text offset; use nextOffset from the previous page.');
+            const text = textSlice(selected.text, offset, TEXT_PAGE_CHARS);
+            const end = offset + text.length;
+            return {
+                entry: {
+                    revision,
+                    part,
+                    step: found.step,
+                    claimId: found.claimId,
+                    kind: found.kind,
+                    source: selected.source,
+                    ...(selected.receivedAt !== undefined ? { receivedAt: selected.receivedAt } : {}),
+                    text,
+                    offset,
+                    totalChars: selected.text.length,
+                    nextOffset: end < selected.text.length ? end : null,
+                },
+                ...reader.counts(),
+            };
+        },
+    });
+}
+//# sourceMappingURL=history.js.map

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

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

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

@@ -0,0 +1,78 @@
+import type { ResidentAgendaStore, ResidentPursuit } from './agenda.js';
+import { type ResidentObservation, type ResidentSelection, type ResidentSelector } from './initiative.js';
+import { type ResidentLearningState } from './learning.js';
+import { type ResidentStep } from './loop.js';
+import { type ResidentMessageInput } from './outbox.js';
+import { type ResidentDecision } from './store.js';
+/** @experimental Host result describes execution, not external-effect rollback. */
+export interface ResidentHostResult {
+    readonly status: 'idle' | 'paused' | 'unresolved' | 'cancelled' | 'limit' | 'contended';
+    readonly stepsSettled: number;
+    readonly nextWakeAt: number | null;
+    readonly selection?: ResidentSelection;
+}
+/** @experimental Explicit authorization to drive a finite number of background steps. */
+export interface ResidentHostRunOptions {
+    readonly signal: AbortSignal;
+    readonly maxSteps: number;
+    /** Maximum single idle wait; with keepAlive, also bounds local agenda polling. */
+    readonly maxIdleMs?: number;
+    /** Keep waiting for useful work within this invocation's finite step cap. Default false. */
+    readonly keepAlive?: boolean;
+}
+/** @experimental Immutable context from the agenda snapshot that authorized this admission. */
+export interface ResidentStepContext {
+    readonly agendaRevision: number;
+    readonly learning?: ResidentLearningState;
+}
+/** @experimental A developer callback may bind a different SDK run for each pursuit. */
+export type ResidentPursuitStep = (pursuit: ResidentPursuit, signal: AbortSignal) => ReturnType<ResidentStep>;
+/** @experimental Context-aware callback; existing two-argument steps remain assignable. */
+export type ResidentContextualStep = (pursuit: ResidentPursuit, signal: AbortSignal, context: ResidentStepContext) => ReturnType<ResidentStep>;
+/** @experimental Inspect actual outcomes and resource receipts independently of model prose. */
+export type ResidentObserver = (pursuit: ResidentPursuit, decision: ResidentDecision, signal: AbortSignal) => Promise<ResidentObservation>;
+/** @experimental Host validates content and destination; null means no communication. */
+export type ResidentMessageFactory = (pursuit: ResidentPursuit, decision: ResidentDecision, signal: AbortSignal) => Promise<ResidentMessageInput | null>;
+/** @experimental Opt-in local selection, observed settlement and atomic outbound intent. */
+export interface ResidentHostOptions {
+    readonly select?: ResidentSelector;
+    readonly observe?: ResidentObserver;
+    readonly prepareMessage?: ResidentMessageFactory;
+    /** Bind approved learning to the exact admission snapshot. Default false. */
+    readonly learning?: boolean;
+}
+/**
+ * @experimental Local driver for one durable agenda. Shared agenda admission
+ * prevents overlapping pursuits across processes. Notifications are local;
+ * opt-in keepAlive also rereads durable state on bounded idle timers.
+ */
+export declare class ResidentHost {
+    private readonly agenda;
+    private readonly step;
+    private controller;
+    private active;
+    private idle;
+    private generation;
+    private controls;
+    private controlsPending;
+    private readonly options;
+    constructor(agenda: ResidentAgendaStore, step: ResidentContextualStep, options?: ResidentHostOptions);
+    /** Interrupt local idle waiting after the host learns of new durable state. */
+    notify(): void;
+    private snapshot;
+    private paused;
+    private control;
+    /**
+     * Signal current work and durably close future admission. Resolving this method
+     * is NOT quiescence: await the run promise before claiming the callback stopped.
+     * An interrupted admitted pursuit remains unresolved until reconciled explicitly.
+     */
+    pause(): Promise<void>;
+    /** Reauthorize future work only after this host's previous invocation drained. */
+    resume(): Promise<void>;
+    /** Persist fresh evidence and interrupt this host's idle timer. */
+    wake(id: string, reason: string): Promise<void>;
+    run(options: ResidentHostRunOptions): Promise<ResidentHostResult>;
+    private drive;
+}
+//# sourceMappingURL=host.d.ts.map

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

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

package/dist/manager/resident/host.js

@@ -0,0 +1,252 @@
+import { setTimeout as sleep } from 'node:timers/promises';
+import { residentObservationSchema, } from './initiative.js';
+import { freezeResidentLearning } from './learning.js';
+import { stepResident } from './loop.js';
+import { residentMessageInputSchema } from './outbox.js';
+import { ResidentConflictError, residentDecisionSchema } from './store.js';
+/**
+ * @experimental Local driver for one durable agenda. Shared agenda admission
+ * prevents overlapping pursuits across processes. Notifications are local;
+ * opt-in keepAlive also rereads durable state on bounded idle timers.
+ */
+export class ResidentHost {
+    agenda;
+    step;
+    controller;
+    active;
+    idle;
+    generation = 0;
+    controls = Promise.resolve();
+    controlsPending = 0;
+    options;
+    constructor(agenda, step, options = {}) {
+        this.agenda = agenda;
+        this.step = step;
+        if (options.learning !== undefined && typeof options.learning !== 'boolean')
+            throw new TypeError('Resident learning must be explicitly enabled with a boolean.');
+        if ((options.select || options.learning) && !agenda.executionAt)
+            throw new TypeError('Resident selection or learning requires atomic executionAt support.');
+        if (options.observe && !agenda.settleObserved)
+            throw new TypeError('Resident observation requires atomic settleObserved support.');
+        if (options.prepareMessage && !agenda.settleWithMessage)
+            throw new TypeError('Resident messages require atomic settleWithMessage support.');
+        this.options = Object.freeze({ ...options });
+    }
+    /** Interrupt local idle waiting after the host learns of new durable state. */
+    notify() {
+        this.generation++;
+        this.idle?.abort();
+    }
+    async snapshot() {
+        const state = await this.agenda.read();
+        if (!state)
+            throw new Error('Create the resident agenda before running the host.');
+        return state;
+    }
+    async paused(value) {
+        for (let attempt = 0; attempt < 8; attempt++) {
+            const state = await this.snapshot();
+            if (state.paused === value)
+                return;
+            try {
+                await this.agenda.setPaused(state, value);
+                return;
+            }
+            catch (error) {
+                if (!(error instanceof ResidentConflictError) || attempt === 7)
+                    throw error;
+            }
+        }
+    }
+    control(update) {
+        this.controlsPending++;
+        const pending = this.controls.then(update);
+        this.controls = pending.catch(() => { });
+        return pending.finally(() => {
+            this.controlsPending--;
+        });
+    }
+    /**
+     * Signal current work and durably close future admission. Resolving this method
+     * is NOT quiescence: await the run promise before claiming the callback stopped.
+     * An interrupted admitted pursuit remains unresolved until reconciled explicitly.
+     */
+    async pause() {
+        this.controller?.abort();
+        this.notify();
+        await this.control(() => this.paused(true));
+    }
+    /** Reauthorize future work only after this host's previous invocation drained. */
+    async resume() {
+        if (this.controlsPending)
+            throw new Error('Wait for pending resident controls before resuming.');
+        if (this.active)
+            throw new Error('Wait for the active resident invocation to drain before resuming.');
+        await this.control(() => this.paused(false));
+        this.notify();
+    }
+    /** Persist fresh evidence and interrupt this host's idle timer. */
+    async wake(id, reason) {
+        const state = await this.snapshot();
+        const pursuit = state.pursuits.find((p) => p.id === id);
+        if (!pursuit)
+            throw new Error('Unknown resident pursuit.');
+        await this.agenda.wake(id, pursuit.state, reason, Date.now());
+        this.notify();
+    }
+    run(options) {
+        if (this.controlsPending)
+            throw new Error('Wait for pending resident controls before running.');
+        if (this.active)
+            throw new Error('A resident host invocation is already active.');
+        const maxIdleMs = options.maxIdleMs ?? 60_000;
+        const keepAlive = options.keepAlive ?? false;
+        if (options.keepAlive !== undefined && typeof options.keepAlive !== 'boolean')
+            throw new TypeError('Resident keepAlive must be explicitly enabled with a boolean.');
+        if (!Number.isSafeInteger(options.maxSteps) ||
+            options.maxSteps < 1 ||
+            !Number.isSafeInteger(maxIdleMs) ||
+            maxIdleMs < 0 ||
+            maxIdleMs > 2_147_483_647 ||
+            (keepAlive && maxIdleMs === 0))
+            throw new TypeError('Invalid resident host limits.');
+        const controller = new AbortController();
+        this.controller = controller;
+        const signal = AbortSignal.any([controller.signal, options.signal]);
+        this.active = this.drive(options.maxSteps, maxIdleMs, keepAlive, signal).finally(() => {
+            this.active = undefined;
+            this.controller = undefined;
+            this.idle = undefined;
+        });
+        return this.active;
+    }
+    async drive(maxSteps, maxIdleMs, keepAlive, signal) {
+        let stepsSettled = 0;
+        try {
+            while (true) {
+                signal.throwIfAborted();
+                const observed = this.generation;
+                const state = await this.snapshot();
+                signal.throwIfAborted();
+                if (state.paused)
+                    return { status: 'paused', stepsSettled, nextWakeAt: null };
+                if (state.pursuits.some((p) => p.state.phase === 'running'))
+                    return { status: 'unresolved', stepsSettled, nextWakeAt: null };
+                const waiting = state.pursuits.filter((p) => p.state.phase === 'waiting' && p.state.wakeAt !== null);
+                const now = Date.now();
+                // Fair, deterministic baseline; this is not model-authored initiative.
+                let due = waiting
+                    .filter((p) => (p.state.wakeAt ?? 0) <= now)
+                    .sort((a, b) => a.state.stepsAdmitted - b.state.stepsAdmitted ||
+                    (a.state.wakeAt ?? 0) - (b.state.wakeAt ?? 0) ||
+                    a.id.localeCompare(b.id))[0];
+                let selection;
+                if (due && this.options.select) {
+                    selection = this.options.select(state, now);
+                    signal.throwIfAborted();
+                    if (selection.agendaRevision !== state.revision)
+                        throw new Error('Resident selector returned a stale agenda revision.');
+                    if (selection.pursuitId === null)
+                        due = undefined;
+                    else {
+                        const selectedId = selection.pursuitId;
+                        due = waiting.find((p) => p.id === selectedId && (p.state.wakeAt ?? 0) <= now);
+                        if (!due)
+                            throw new Error('Resident selector chose an ineligible pursuit.');
+                    }
+                }
+                if (due) {
+                    const selected = due;
+                    const context = Object.freeze({
+                        agendaRevision: state.revision,
+                        ...(this.options.learning && state.learning
+                            ? { learning: freezeResidentLearning(state.learning) }
+                            : {}),
+                    });
+                    const execution = this.options.select || this.options.learning
+                        ? this.agenda.executionAt?.(selected.id, state)
+                        : this.agenda.execution(selected.id);
+                    if (!execution)
+                        throw new Error('Resident executionAt support was removed.');
+                    const observe = this.options.observe;
+                    const prepareMessage = this.options.prepareMessage;
+                    const observedExecution = observe || prepareMessage
+                        ? {
+                            read: () => execution.read(),
+                            claim: (...args) => execution.claim(...args),
+                            settle: async (current, decision, at) => {
+                                const disposition = Object.freeze(residentDecisionSchema.parse(decision));
+                                const observed = await observe?.({ ...selected, state: current }, disposition, signal);
+                                signal.throwIfAborted();
+                                const observation = observe
+                                    ? Object.freeze(residentObservationSchema.parse(observed))
+                                    : undefined;
+                                const prepared = await prepareMessage?.({ ...selected, state: current }, disposition, signal);
+                                signal.throwIfAborted();
+                                const message = prepareMessage && prepared !== null
+                                    ? Object.freeze(residentMessageInputSchema.parse(prepared))
+                                    : null;
+                                if (message !== null) {
+                                    if (!this.agenda.settleWithMessage)
+                                        throw new Error('Resident settleWithMessage support was removed.');
+                                    return this.agenda.settleWithMessage(selected.id, current, disposition, message, at, observation);
+                                }
+                                if (observation) {
+                                    if (!this.agenda.settleObserved)
+                                        throw new Error('Resident settleObserved support was removed.');
+                                    return this.agenda.settleObserved(selected.id, current, disposition, observation, at);
+                                }
+                                return execution.settle(current, disposition, at);
+                            },
+                        }
+                        : execution;
+                    const result = await stepResident(observedExecution, (current, abort) => this.step({ ...selected, state: current }, abort, context), signal);
+                    if (result.status === 'idle')
+                        return {
+                            status: result.reason === 'unresolved' ? 'unresolved' : 'contended',
+                            stepsSettled,
+                            nextWakeAt: null,
+                        };
+                    stepsSettled++;
+                    if (stepsSettled >= maxSteps)
+                        return { status: 'limit', stepsSettled, nextWakeAt: null };
+                    continue;
+                }
+                const scheduled = selection?.pursuitId === null
+                    ? waiting.filter((p) => (p.state.wakeAt ?? 0) > now)
+                    : waiting;
+                const nextWakeAt = scheduled.length === 0 ? null : Math.min(...scheduled.map((p) => p.state.wakeAt ?? now));
+                if (observed !== this.generation)
+                    continue;
+                if (!keepAlive && (nextWakeAt === null || nextWakeAt - now > maxIdleMs))
+                    return { status: 'idle', stepsSettled, nextWakeAt, ...(selection ? { selection } : {}) };
+                const delay = nextWakeAt === null
+                    ? maxIdleMs
+                    : keepAlive
+                        ? Math.min(maxIdleMs, nextWakeAt - now)
+                        : nextWakeAt - now;
+                const idle = new AbortController();
+                this.idle = idle;
+                try {
+                    await sleep(Math.max(1, delay), undefined, {
+                        signal: AbortSignal.any([signal, idle.signal]),
+                    });
+                }
+                catch (error) {
+                    if (!idle.signal.aborted || signal.aborted)
+                        throw error;
+                }
+                finally {
+                    if (this.idle === idle)
+                        this.idle = undefined;
+                }
+            }
+        }
+        catch (error) {
+            if (!signal.aborted)
+                throw error;
+            return { status: 'cancelled', stepsSettled, nextWakeAt: null };
+        }
+    }
+}
+//# sourceMappingURL=host.js.map

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

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