@namzu/sdk 38.0.0 → 38.2.1

package/dist/manager/resident/outbox.js

@@ -0,0 +1,214 @@
+import { randomUUID } from 'node:crypto';
+import { z } from 'zod';
+import { ResidentConflictError } from './store.js';
+const time = z.number().int().nonnegative().safe().max(8_640_000_000_000_000);
+const label = z.string().trim().min(1).max(256);
+export const residentMessageInputSchema = z.object({
+    id: z.string().uuid(),
+    pursuitId: z.string().uuid(),
+    destination: label,
+    body: z
+        .string()
+        .min(1)
+        .max(8_000)
+        .refine((value) => value.trim().length > 0),
+    notBefore: time,
+});
+export const residentOutboxMessageSchema = residentMessageInputSchema
+    .extend({
+    tenantId: z.string().uuid(),
+    agentKey: z.string().min(1).max(200),
+    sourceClaimId: z.string().uuid().nullable(),
+    revision: z.number().int().positive().safe(),
+    attempts: z.number().int().nonnegative().safe(),
+    phase: z.enum(['pending', 'sending', 'acknowledged', 'cancelled']),
+    claimId: z.string().uuid().nullable(),
+    nextAttemptAt: time.nullable(),
+    receiptId: label.nullable(),
+    acknowledgedAt: time.nullable(),
+    lastReason: z.string().trim().min(1).max(1_000).nullable(),
+})
+    .superRefine((message, context) => {
+    if ((message.phase === 'sending') !== (message.claimId !== null) ||
+        (message.phase === 'pending') !== (message.nextAttemptAt !== null) ||
+        (message.phase === 'acknowledged') !== (message.receiptId !== null) ||
+        (message.phase === 'acknowledged') !== (message.acknowledgedAt !== null) ||
+        (message.nextAttemptAt !== null && message.nextAttemptAt < message.notBefore) ||
+        (message.phase !== 'pending' && message.attempts === 0))
+        context.addIssue({ code: z.ZodIssueCode.custom, message: 'Invalid outbox lifecycle.' });
+});
+export const residentDeliveryOutcomeSchema = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('acknowledged'), receiptId: label }),
+    z.object({
+        kind: z.literal('not-accepted'),
+        retryAt: time.nullable(),
+        reason: z.string().trim().min(1).max(1_000),
+    }),
+]);
+/** Internal pure enqueue used in the same revision transaction as pursuit settlement. */
+export function appendResidentMessage(state, input, sourceClaimId = null) {
+    const checked = residentMessageInputSchema.parse(input);
+    if (!state.pursuits.some((p) => p.id === checked.pursuitId))
+        throw new Error('Outbox message references an unknown pursuit.');
+    const messages = state.outbox ?? [];
+    const existing = messages.find((message) => message.id === checked.id);
+    if (existing) {
+        if (existing.pursuitId !== checked.pursuitId ||
+            existing.destination !== checked.destination ||
+            existing.body !== checked.body ||
+            existing.notBefore !== checked.notBefore ||
+            existing.sourceClaimId !== sourceClaimId)
+            throw new Error('Outbox message ID already names a different immutable intent.');
+        return messages;
+    }
+    if (messages.length >= 128)
+        throw new Error('Resident outbox capacity reached (128 intents).');
+    return [
+        ...messages,
+        Object.freeze(residentOutboxMessageSchema.parse({
+            ...checked,
+            tenantId: state.tenantId,
+            agentKey: state.agentKey,
+            sourceClaimId,
+            revision: 1,
+            attempts: 0,
+            phase: 'pending',
+            claimId: null,
+            nextAttemptAt: checked.notBefore,
+            receiptId: null,
+            acknowledgedAt: null,
+            lastReason: null,
+        })),
+    ];
+}
+/** Internal exact-message transition; agenda storage owns exclusive admission. */
+export function claimResidentOutboxMessage(message, now) {
+    time.parse(now);
+    if (message.phase !== 'pending' || message.nextAttemptAt === null || message.nextAttemptAt > now)
+        throw new ResidentConflictError();
+    return Object.freeze(residentOutboxMessageSchema.parse({
+        ...message,
+        revision: message.revision + 1,
+        attempts: message.attempts + 1,
+        phase: 'sending',
+        claimId: randomUUID(),
+        nextAttemptAt: null,
+    }));
+}
+/** Internal settlement; unknown failures deliberately have no transition. */
+export function settleResidentOutboxMessage(message, outcome, now) {
+    time.parse(now);
+    const checked = residentDeliveryOutcomeSchema.parse(outcome);
+    if (message.phase !== 'sending' || message.claimId === null)
+        throw new ResidentConflictError();
+    if (checked.kind === 'not-accepted' && checked.retryAt !== null && checked.retryAt <= now)
+        throw new TypeError('A delivery retry must be scheduled in the future.');
+    return Object.freeze(residentOutboxMessageSchema.parse({
+        ...message,
+        revision: message.revision + 1,
+        claimId: null,
+        ...(checked.kind === 'acknowledged'
+            ? { phase: 'acknowledged', receiptId: checked.receiptId, acknowledgedAt: now }
+            : {
+                phase: checked.retryAt === null ? 'cancelled' : 'pending',
+                nextAttemptAt: checked.retryAt,
+                lastReason: checked.reason,
+            }),
+    }));
+}
+function admission(gate, message, now) {
+    const result = gate(message, now);
+    if (result.allow === true)
+        return result;
+    if (result.allow !== false ||
+        typeof result.reason !== 'string' ||
+        !result.reason.trim() ||
+        result.reason.trim().length > 1_000)
+        throw new TypeError('Invalid resident delivery gate result.');
+    if (result.nextCheckAt !== null) {
+        time.parse(result.nextCheckAt);
+        if (result.nextCheckAt <= now)
+            throw new TypeError('Delivery gate must defer into the future.');
+    }
+    return result;
+}
+/**
+ * @experimental Persist one send claim before calling a host-owned transport.
+ * Throws, malformed outcomes and cancellation keep the claim unresolved. Stop
+ * old executors and inspect effects before explicit settleMessage reconciliation.
+ */
+export async function deliverResidentMessage(store, transport, options) {
+    const { signal, gate } = options;
+    const clock = options.now ?? Date.now;
+    const now = () => time.parse(clock());
+    signal.throwIfAborted();
+    const state = await store.read();
+    signal.throwIfAborted();
+    if (!state)
+        throw new Error('Create the resident agenda before delivering messages.');
+    const idle = (reason, nextCheckAt = null) => ({ status: 'idle', reason, nextCheckAt });
+    if (state.paused)
+        return idle('paused');
+    const messages = state.outbox ?? [];
+    if (messages.some((message) => message.phase === 'sending'))
+        return idle('unresolved');
+    const pending = messages.filter((message) => message.phase === 'pending');
+    if (!pending.length)
+        return idle('empty');
+    let nextCheckAt = null;
+    let gated = false;
+    const at = now();
+    for (const message of pending.sort((a, b) => (a.nextAttemptAt ?? 0) - (b.nextAttemptAt ?? 0) || a.id.localeCompare(b.id))) {
+        if (message.nextAttemptAt !== null && message.nextAttemptAt > at) {
+            nextCheckAt = Math.min(nextCheckAt ?? Number.POSITIVE_INFINITY, message.nextAttemptAt);
+            continue;
+        }
+        const permission = admission(gate, message, at);
+        signal.throwIfAborted();
+        if (!permission.allow) {
+            gated = true;
+            if (permission.nextCheckAt !== null)
+                nextCheckAt = Math.min(nextCheckAt ?? Number.POSITIVE_INFINITY, permission.nextCheckAt);
+            continue;
+        }
+        let claimed;
+        try {
+            claimed = await store.claimMessage(state, message.id, now());
+        }
+        catch (error) {
+            if (error instanceof ResidentConflictError)
+                return idle('contended');
+            throw error;
+        }
+        signal.throwIfAborted();
+        const fresh = await store.read();
+        signal.throwIfAborted();
+        const current = fresh?.outbox?.find((item) => item.id === claimed.id);
+        if (!current || current.revision !== claimed.revision || current.claimId !== claimed.claimId)
+            return idle('contended');
+        // A pause or closing window during admission must not start the transport.
+        const checkedAt = now();
+        const permissionNow = fresh?.paused
+            ? {
+                allow: false,
+                nextCheckAt: checkedAt + 1,
+                reason: 'Resident agenda paused before send.',
+            }
+            : admission(gate, claimed, checkedAt);
+        if (!permissionNow.allow) {
+            // Transport has not been entered: scheduling another check has no remote effect.
+            await store.settleMessage(claimed, {
+                kind: 'not-accepted',
+                retryAt: permissionNow.nextCheckAt ?? checkedAt + 1,
+                reason: permissionNow.reason,
+            }, checkedAt);
+            return idle(fresh?.paused ? 'paused' : 'window', permissionNow.nextCheckAt);
+        }
+        signal.throwIfAborted();
+        const outcome = await transport(claimed, signal);
+        signal.throwIfAborted();
+        return { status: 'settled', message: await store.settleMessage(claimed, outcome, now()) };
+    }
+    return idle(gated ? 'window' : 'not-due', nextCheckAt);
+}
+//# sourceMappingURL=outbox.js.map

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

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

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

@@ -0,0 +1,91 @@
+import { z } from 'zod';
+import type { ResidentAgendaState } from './agenda.js';
+export declare const residentProposalSchema: z.ZodObject<{
+    id: z.ZodString;
+    parentId: z.ZodString;
+    parentRevision: z.ZodNumber;
+    domain: z.ZodEffects<z.ZodString, string, string>;
+    objective: z.ZodString;
+    reason: z.ZodString;
+    evidenceKey: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    parentId: string;
+    id: string;
+    reason: string;
+    domain: string;
+    objective: string;
+    evidenceKey: string;
+    parentRevision: number;
+}, {
+    parentId: string;
+    id: string;
+    reason: string;
+    domain: string;
+    objective: string;
+    evidenceKey: string;
+    parentRevision: number;
+}>;
+export declare const residentProposalLimitsSchema: z.ZodObject<{
+    domains: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+    maxChildrenPerParent: z.ZodNumber;
+    maxDepth: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    maxDepth: number;
+    domains: string[];
+    maxChildrenPerParent: number;
+}, {
+    maxDepth: number;
+    domains: string[];
+    maxChildrenPerParent: number;
+}>;
+/** @experimental An inert subgoal proposal; creating it grants no execution authority. */
+export interface ResidentProposal {
+    readonly id: string;
+    readonly parentId: string;
+    readonly parentRevision: number;
+    readonly domain: string;
+    readonly objective: string;
+    readonly reason: string;
+    readonly evidenceKey: string;
+}
+/** @experimental Host-approved routing domains and finite subgoal admission bounds. */
+export interface ResidentProposalLimits {
+    readonly domains: readonly string[];
+    readonly maxChildrenPerParent: number;
+    readonly maxDepth: number;
+}
+/** Persisted provenance shared with the agenda's schema validation. */
+export declare const residentProposalOriginSchema: z.ZodObject<{
+    proposalId: z.ZodString;
+    parentId: z.ZodString;
+    parentRevision: z.ZodNumber;
+    domain: z.ZodEffects<z.ZodString, string, string>;
+    reason: z.ZodString;
+    evidenceKey: z.ZodString;
+    depth: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    parentId: string;
+    reason: string;
+    depth: number;
+    domain: string;
+    evidenceKey: string;
+    parentRevision: number;
+    proposalId: string;
+}, {
+    parentId: string;
+    reason: string;
+    depth: number;
+    domain: string;
+    evidenceKey: string;
+    parentRevision: number;
+    proposalId: string;
+}>;
+/** @experimental Host-admitted ancestry and evidence for a resident subgoal. */
+export type ResidentProposalOrigin = Readonly<z.infer<typeof residentProposalOriginSchema>>;
+/**
+ * @experimental Pure validation against one agenda snapshot. The host must
+ * atomically bind this snapshot to admission. Domains are routing metadata;
+ * this does not prove an objective fits its domain or authorize any tools.
+ */
+export declare function validateResidentProposal(agenda: ResidentAgendaState, input: ResidentProposal, limits: ResidentProposalLimits): ResidentProposalOrigin;
+//# sourceMappingURL=proposal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"proposal.d.ts","sourceRoot":"","sources":["../../../src/manager/resident/proposal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAYtD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;EAQjC,CAAA;AAEF,eAAO,MAAM,4BAA4B;;;;;;;;;;;;EAIvC,CAAA;AAEF,0FAA0F;AAC1F,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC5B;AAED,uFAAuF;AACvF,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAA;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CACzB;AAED,uEAAuE;AACvE,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;EAQvC,CAAA;AAEF,gFAAgF;AAChF,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC,CAAA;AAE3F;;;;GAIG;AACH,wBAAgB,wBAAwB,CACvC,MAAM,EAAE,mBAAmB,EAC3B,KAAK,EAAE,gBAAgB,EACvB,MAAM,EAAE,sBAAsB,GAC5B,sBAAsB,CAkCxB"}

package/dist/manager/resident/proposal.js

@@ -0,0 +1,75 @@
+import { z } from 'zod';
+const identifier = z.string().uuid();
+const revision = z.number().int().positive().safe();
+const domain = z
+    .string()
+    .min(1)
+    .max(120)
+    .refine((value) => value.trim().length > 0, 'A proposal domain must contain text.');
+const reason = z.string().trim().min(1).max(1_000);
+const evidenceKey = z.string().trim().min(1).max(256);
+export const residentProposalSchema = z.object({
+    id: identifier,
+    parentId: identifier,
+    parentRevision: revision,
+    domain,
+    objective: z.string().trim().min(1).max(8_000),
+    reason,
+    evidenceKey,
+});
+export const residentProposalLimitsSchema = z.object({
+    domains: z.array(domain).min(1),
+    maxChildrenPerParent: z.number().int().min(1).max(8),
+    maxDepth: z.number().int().min(1).max(4),
+});
+/** Persisted provenance shared with the agenda's schema validation. */
+export const residentProposalOriginSchema = z.object({
+    proposalId: identifier,
+    parentId: identifier,
+    parentRevision: revision,
+    domain,
+    reason,
+    evidenceKey,
+    depth: z.number().int().min(1).max(4),
+});
+/**
+ * @experimental Pure validation against one agenda snapshot. The host must
+ * atomically bind this snapshot to admission. Domains are routing metadata;
+ * this does not prove an objective fits its domain or authorize any tools.
+ */
+export function validateResidentProposal(agenda, input, limits) {
+    const proposal = residentProposalSchema.parse(input);
+    const policy = residentProposalLimitsSchema.parse(limits);
+    if (agenda.paused)
+        throw new Error('A paused agenda cannot admit resident proposals.');
+    if (agenda.pursuits.length >= 32)
+        throw new Error('Resident agenda pursuit bound reached.');
+    if (agenda.pursuits.some((pursuit) => pursuit.origin?.proposalId === proposal.id))
+        throw new Error('Resident proposal has already been admitted.');
+    const parent = agenda.pursuits.find((pursuit) => pursuit.id === proposal.parentId);
+    if (!parent)
+        throw new Error('Unknown resident proposal parent.');
+    if (parent.state.revision !== proposal.parentRevision)
+        throw new Error('Resident proposal parent revision is stale.');
+    if (parent.state.phase !== 'waiting' && parent.state.phase !== 'complete')
+        throw new Error('Resident proposal parent must be waiting or complete.');
+    if (!policy.domains.includes(proposal.domain))
+        throw new Error('Resident proposal domain is not host-approved.');
+    if (agenda.pursuits.filter((pursuit) => pursuit.origin?.parentId === parent.id).length +
+        (parent.retiredChildren ?? 0) >=
+        policy.maxChildrenPerParent)
+        throw new Error('Resident proposal parent child bound reached.');
+    const depth = (parent.origin?.depth ?? 0) + 1;
+    if (depth > policy.maxDepth)
+        throw new Error('Resident proposal depth bound reached.');
+    return Object.freeze(residentProposalOriginSchema.parse({
+        proposalId: proposal.id,
+        parentId: proposal.parentId,
+        parentRevision: proposal.parentRevision,
+        domain: proposal.domain,
+        reason: proposal.reason,
+        evidenceKey: proposal.evidenceKey,
+        depth,
+    }));
+}
+//# sourceMappingURL=proposal.js.map

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

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

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

@@ -0,0 +1,149 @@
+import { z } from 'zod';
+import type { TenantId } from '../../types/ids/index.js';
+export declare const residentDecisionSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    kind: z.ZodLiteral<"wait">;
+    summary: z.ZodString;
+    wakeAt: z.ZodNullable<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    kind: "wait";
+    summary: string;
+    wakeAt: number | null;
+}, {
+    kind: "wait";
+    summary: string;
+    wakeAt: number | null;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"complete">;
+    summary: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "complete";
+    summary: string;
+}, {
+    kind: "complete";
+    summary: string;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"blocked">;
+    summary: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "blocked";
+    summary: string;
+}, {
+    kind: "blocked";
+    summary: string;
+}>]>;
+/** @experimental One bounded step's durable disposition; silence is not completion. */
+export type ResidentDecision = z.infer<typeof residentDecisionSchema>;
+export declare const residentStateSchema: z.ZodEffects<z.ZodObject<{
+    tenantId: z.ZodString;
+    agentKey: z.ZodString;
+    pursuitId: z.ZodOptional<z.ZodString>;
+    identity: z.ZodString;
+    objective: z.ZodString;
+    revision: z.ZodNumber;
+    stepsAdmitted: z.ZodNumber;
+    phase: z.ZodEnum<["waiting", "running", "complete", "blocked"]>;
+    wakeAt: z.ZodNullable<z.ZodNumber>;
+    reason: z.ZodString;
+    summary: z.ZodNullable<z.ZodString>;
+    claimId: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    summary: string | null;
+    identity: string;
+    reason: string;
+    revision: number;
+    tenantId: string;
+    objective: string;
+    phase: "running" | "complete" | "blocked" | "waiting";
+    wakeAt: number | null;
+    agentKey: string;
+    stepsAdmitted: number;
+    claimId: string | null;
+    pursuitId?: string | undefined;
+}, {
+    summary: string | null;
+    identity: string;
+    reason: string;
+    revision: number;
+    tenantId: string;
+    objective: string;
+    phase: "running" | "complete" | "blocked" | "waiting";
+    wakeAt: number | null;
+    agentKey: string;
+    stepsAdmitted: number;
+    claimId: string | null;
+    pursuitId?: string | undefined;
+}>, {
+    summary: string | null;
+    identity: string;
+    reason: string;
+    revision: number;
+    tenantId: string;
+    objective: string;
+    phase: "running" | "complete" | "blocked" | "waiting";
+    wakeAt: number | null;
+    agentKey: string;
+    stepsAdmitted: number;
+    claimId: string | null;
+    pursuitId?: string | undefined;
+}, {
+    summary: string | null;
+    identity: string;
+    reason: string;
+    revision: number;
+    tenantId: string;
+    objective: string;
+    phase: "running" | "complete" | "blocked" | "waiting";
+    wakeAt: number | null;
+    agentKey: string;
+    stepsAdmitted: number;
+    claimId: string | null;
+    pursuitId?: string | undefined;
+}>;
+/** @experimental Persisted identity and one pursuit, independent of a conversation. */
+export type ResidentState = Readonly<z.infer<typeof residentStateSchema>>;
+/** Bounded addressing for local resident state. Stored scope is still validated. */
+export declare function residentKeySegment(key: string): string;
+/** @experimental Minimal atomic contract needed to execute an existing pursuit. */
+export type ResidentExecutionStore = Pick<ResidentStore, 'read' | 'claim' | 'settle'>;
+/** @experimental Backends must atomically compare revisions and publish admission before work. */
+export interface ResidentStore {
+    read(): Promise<ResidentState | null>;
+    create(identity: string, objective: string): Promise<ResidentState>;
+    claim(expected: ResidentState, now: number): Promise<ResidentState>;
+    settle(expected: ResidentState, decision: ResidentDecision, now: number): Promise<ResidentState>;
+    wake(expected: ResidentState, reason: string, now: number): Promise<ResidentState>;
+}
+/** A competing owner advanced this resident's immutable revision. */
+export declare class ResidentConflictError extends Error {
+    constructor();
+}
+/**
+ * @experimental Local-filesystem state for one tenant/agent key and one pursuit.
+ * A running claim never expires automatically: a crashed step may have effects.
+ * Uses exclusive immutable revision publication, not a read/rename lock.
+ */
+export declare class DiskResidentStore implements ResidentStore {
+    private readonly records;
+    private readonly location;
+    private readonly tenantId;
+    private readonly agentKey;
+    constructor(root: string, scope: {
+        tenantId: TenantId;
+        agentKey: string;
+    });
+    private checked;
+    read(): Promise<ResidentState | null>;
+    create(identity: string, objective: string): Promise<ResidentState>;
+    private change;
+    /** Persist admission before invoking a model, tool or developer callback. */
+    claim(expected: ResidentState, now: number): Promise<ResidentState>;
+    /** Only the exact admitted revision may settle; late owners cannot overwrite recovery. */
+    settle(expected: ResidentState, decision: ResidentDecision, now: number): Promise<ResidentState>;
+    /** Host-supplied new evidence can wake a waiting pursuit; terminal work stays terminal. */
+    wake(expected: ResidentState, reason: string, now: number): Promise<ResidentState>;
+}
+/** Internal transitions shared by single-pursuit and whole-agent admission. */
+export declare function claimResidentState(state: ResidentState, now: number): ResidentState;
+export declare function settleResidentState(state: ResidentState, decision: ResidentDecision, now: number): ResidentState;
+export declare function wakeResidentState(state: ResidentState, reason: string, now: number): ResidentState;
+//# sourceMappingURL=store.d.ts.map

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

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