nawabari 0.8.0 → 0.9.2

package/dist/state/index.d.ts

@@ -0,0 +1,5 @@
+/** Internal state modules. No state runtime internals are package exports. */
+export { coordinateSessionLifecycle, executeSessionLifecycleActor, SESSION_ACTOR_EVENT_TYPES, SESSION_ACTOR_SCHEMA_VERSION, } from "./session/index.js";
+export type { SessionActorAdapter, SessionActorDecision, SessionActorOperation, SessionActorPhase, SessionActorReconciliation, SessionActorReconciliationOutcome, SessionActorRequest, SessionActorResult, } from "./session/index.js";
+export { SESSION_MACHINE_EVENT_TYPES, SESSION_STATE_MODULE_SCHEMA_VERSION } from "./session/index.js";
+export type { PersistedSessionState, SessionEvidenceInput, SessionGarbageCollectionEvidence, SessionIntegrationEvidence, SessionMachineContext, SessionMachineEvent, SessionMachineInput, SessionObservationBlocker, SessionObservationCloseReadiness, SessionObservationInput, SessionObservationPhase, SessionOperationalState, SessionPersistedStateInput, } from "./session/index.js";

package/dist/state/index.js

@@ -0,0 +1,4 @@
+/** Internal state modules. No state runtime internals are package exports. */
+export { coordinateSessionLifecycle, executeSessionLifecycleActor, SESSION_ACTOR_EVENT_TYPES, SESSION_ACTOR_SCHEMA_VERSION, } from "./session/index.js";
+export { SESSION_MACHINE_EVENT_TYPES, SESSION_STATE_MODULE_SCHEMA_VERSION } from "./session/index.js";
+//# sourceMappingURL=index.js.map

package/dist/state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,EAC5B,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,oBAAoB,CAAC;AAW5B,OAAO,EAAE,2BAA2B,EAAE,mCAAmC,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/state/session/actors.d.ts

@@ -0,0 +1,71 @@
+import type { SessionLifecycleOperation, SessionLifecycleState } from "../../session-lifecycle-classification.js";
+import type { SessionMachineInput } from "./types.js";
+/**
+ * Internal protocol used by the production Session actor.  The protocol is
+ * deliberately capability-shaped; CLI command names and physical authorities
+ * do not belong in this module.
+ */
+export declare const SESSION_ACTOR_EVENT_TYPES: readonly ["SESSION.REQUESTED", "SESSION.OBSERVED", "SESSION.TRANSITION.EVALUATED", "SESSION.EFFECT.COMPLETED", "SESSION.EFFECT.FAILED", "SESSION.REOBSERVED", "SESSION.REOBSERVATION.FAILED", "SESSION.RECONCILED", "SESSION.FINALIZED"];
+export declare const SESSION_ACTOR_SCHEMA_VERSION: 1;
+export type SessionActorOperation = Extract<SessionLifecycleOperation, "close" | "discard" | "reconcile" | "gc">;
+export type SessionActorPhase = "completed" | "rejected" | "retryable" | "unresolved";
+export type SessionActorReconciliationOutcome = "completed" | "retryable" | "unresolved";
+/** Bounded, identity-neutral recovery evidence supplied by an existing adapter. */
+export interface SessionActorReconciliation {
+    readonly outcome: SessionActorReconciliationOutcome;
+    readonly retrySafe: boolean;
+    readonly reason?: string;
+}
+/**
+ * A transition decision returned by the canonical lifecycle machine.  Retry
+ * decisions use the machine's cleanup-retry event while retaining the same
+ * public operational state vocabulary.
+ */
+export interface SessionActorDecision {
+    readonly operation: SessionActorOperation;
+    readonly eventType: string;
+    readonly allowed: boolean;
+    readonly target: SessionLifecycleState | null;
+    readonly requiresExplicitIntent: boolean;
+    readonly authority: "session-registry" | "reconciliation" | "gc" | "caller";
+    readonly reason: string;
+    readonly mode: "request" | "retry";
+}
+export interface SessionActorAdapter<TResult> {
+    /** Observe an authoritative input before and after the bounded effect. */
+    readonly observe: (stage: "before" | "after") => SessionMachineInput;
+    /**
+     * Positive identity-bound authority for retrying a partial cleanup.  A
+     * retry must never be inferred from an operational state alone.
+     */
+    readonly retryAuthorized?: (input: SessionMachineInput) => boolean;
+    /** Execute exactly one bounded effect through the existing authority. */
+    readonly effect: (decision: SessionActorDecision) => TResult;
+    /** Reconcile an effect failure using the existing authoritative observer. */
+    readonly reconcile?: (error: unknown, after: SessionMachineInput | undefined, decision: SessionActorDecision) => SessionActorReconciliation;
+}
+export interface SessionActorRequest<TResult> {
+    readonly operation: SessionActorOperation;
+    /** A retry is only valid after the adapter has positively re-observed ownership. */
+    readonly retry?: boolean;
+    readonly adapter: SessionActorAdapter<TResult>;
+}
+export interface SessionActorResult<TResult> {
+    readonly schemaVersion: typeof SESSION_ACTOR_SCHEMA_VERSION;
+    readonly operation: SessionActorOperation;
+    readonly phase: SessionActorPhase;
+    readonly decision: SessionActorDecision;
+    readonly before: SessionMachineInput;
+    readonly after?: SessionMachineInput;
+    readonly value?: TResult;
+    readonly error?: unknown;
+    readonly reconciliation?: SessionActorReconciliation;
+}
+/**
+ * Execute one lifecycle request through the Session actor protocol.  The
+ * caller supplies all observations and effects through an adapter, keeping
+ * Git/filesystem/registry authorities outside this state module.
+ */
+export declare function executeSessionLifecycleActor<TResult>(request: SessionActorRequest<TResult>): SessionActorResult<TResult>;
+/** Alias used by callers that describe the actor as a coordinator. */
+export declare const coordinateSessionLifecycle: typeof executeSessionLifecycleActor;

package/dist/state/session/actors.js

@@ -0,0 +1,259 @@
+import { assign, createActor, setup } from "xstate";
+import { projectSessionLifecycleMachine, sessionLifecycleMachine, } from "./machine.js";
+import { classifyObservationBlockers } from "./guards.js";
+/**
+ * Internal protocol used by the production Session actor.  The protocol is
+ * deliberately capability-shaped; CLI command names and physical authorities
+ * do not belong in this module.
+ */
+export const SESSION_ACTOR_EVENT_TYPES = Object.freeze([
+    "SESSION.REQUESTED",
+    "SESSION.OBSERVED",
+    "SESSION.TRANSITION.EVALUATED",
+    "SESSION.EFFECT.COMPLETED",
+    "SESSION.EFFECT.FAILED",
+    "SESSION.REOBSERVED",
+    "SESSION.REOBSERVATION.FAILED",
+    "SESSION.RECONCILED",
+    "SESSION.FINALIZED",
+]);
+export const SESSION_ACTOR_SCHEMA_VERSION = 1;
+const actorSetup = setup({
+    types: {
+        context: {},
+        events: {},
+        input: {},
+    },
+    actions: {
+        rememberObservation: assign({
+            before: ({ event }) => (event.type === "SESSION.OBSERVED" ? event.observation : undefined),
+        }),
+        rememberAfterObservation: assign({
+            after: ({ event }) => (event.type === "SESSION.REOBSERVED" ? event.observation : undefined),
+        }),
+        rememberDecision: assign({
+            decision: ({ event }) => (event.type === "SESSION.TRANSITION.EVALUATED" ? event.decision : undefined),
+        }),
+        rememberValue: assign({
+            value: ({ event }) => (event.type === "SESSION.EFFECT.COMPLETED" ? event.value : undefined),
+        }),
+        rememberError: assign({
+            error: ({ event }) => event.type === "SESSION.EFFECT.FAILED" || event.type === "SESSION.REOBSERVATION.FAILED"
+                ? event.error
+                : undefined,
+        }),
+        rememberReconciliation: assign({
+            reconciliation: ({ event }) => (event.type === "SESSION.RECONCILED" ? event.reconciliation : undefined),
+        }),
+    },
+    guards: {
+        decisionAllowed: ({ event }) => event.type === "SESSION.TRANSITION.EVALUATED" && event.decision.allowed,
+        reconciliationCompleted: ({ event }) => event.type === "SESSION.RECONCILED" && event.reconciliation.outcome === "completed",
+        reconciliationRetryable: ({ event }) => event.type === "SESSION.RECONCILED" && event.reconciliation.outcome === "retryable",
+    },
+});
+/**
+ * Protocol state machine for one lifecycle operation.  It owns sequencing and
+ * retry/reconciliation semantics only; it has no mutation or observation
+ * capability of its own.
+ */
+const sessionActorMachine = actorSetup.createMachine({
+    id: "session-actor",
+    initial: "idle",
+    context: ({ input }) => ({ operation: input.operation, retry: input.retry }),
+    states: {
+        idle: {
+            on: { "SESSION.REQUESTED": "observing" },
+        },
+        observing: {
+            on: {
+                "SESSION.OBSERVED": { target: "evaluating", actions: "rememberObservation" },
+            },
+        },
+        evaluating: {
+            on: {
+                "SESSION.TRANSITION.EVALUATED": [
+                    { target: "executing", guard: "decisionAllowed", actions: "rememberDecision" },
+                    { target: "rejected", actions: "rememberDecision" },
+                ],
+            },
+        },
+        executing: {
+            on: {
+                "SESSION.EFFECT.COMPLETED": { target: "reobserving", actions: "rememberValue" },
+                "SESSION.EFFECT.FAILED": { target: "reconciling", actions: "rememberError" },
+            },
+        },
+        reobserving: {
+            on: {
+                "SESSION.REOBSERVED": { target: "finalizing", actions: "rememberAfterObservation" },
+                "SESSION.REOBSERVATION.FAILED": { target: "reconciling", actions: "rememberError" },
+            },
+        },
+        reconciling: {
+            on: {
+                "SESSION.RECONCILED": [
+                    { target: "completed", guard: "reconciliationCompleted", actions: "rememberReconciliation" },
+                    { target: "retryable", guard: "reconciliationRetryable", actions: "rememberReconciliation" },
+                    { target: "unresolved", actions: "rememberReconciliation" },
+                ],
+            },
+        },
+        finalizing: {
+            on: { "SESSION.FINALIZED": "completed" },
+        },
+        completed: {},
+        rejected: {},
+        retryable: {},
+        unresolved: {},
+    },
+});
+function stateValue(value) {
+    if (typeof value !== "string")
+        throw new Error(`Session actor exposed an invalid state: ${String(value)}`);
+    return value;
+}
+function operationalState(input) {
+    const projection = projectSessionLifecycleMachine(input);
+    return projection.state;
+}
+function retryDecision(input, operation, retryAuthorized) {
+    const actor = createActor(sessionLifecycleMachine, { input }).start();
+    const event = { type: "SESSION.CLEANUP.RETRY" };
+    const blockers = input.observation.blockers ?? [];
+    const unambiguous = input.observation.closeReadiness !== "ambiguous" &&
+        classifyObservationBlockers(blockers) !== "ambiguous" &&
+        !blockers.some((blocker) => blocker.classification === "stale");
+    const allowed = actor.getSnapshot().can(event) && retryAuthorized && unambiguous;
+    const state = operationalState(input);
+    actor.stop();
+    return {
+        operation,
+        eventType: event.type,
+        allowed,
+        target: allowed ? state : null,
+        requiresExplicitIntent: operation === "discard",
+        authority: "reconciliation",
+        reason: allowed ? "cleanup-retry" : "physical-reconciliation-required",
+        mode: "retry",
+    };
+}
+function requestDecision(input, operation) {
+    const transition = projectSessionLifecycleMachine(input).transitions[operation];
+    return { ...transition, operation, mode: "request" };
+}
+function decisionFor(input, operation, retry, retryAuthorized) {
+    return retry ? retryDecision(input, operation, retryAuthorized) : requestDecision(input, operation);
+}
+function reconciliationFor(request, error, after, decision) {
+    return (request.adapter.reconcile?.(error, after, decision) ?? {
+        outcome: "unresolved",
+        retrySafe: false,
+        reason: "reconciliation-unavailable",
+    });
+}
+/**
+ * Execute one lifecycle request through the Session actor protocol.  The
+ * caller supplies all observations and effects through an adapter, keeping
+ * Git/filesystem/registry authorities outside this state module.
+ */
+export function executeSessionLifecycleActor(request) {
+    const actor = createActor(sessionActorMachine, {
+        input: { operation: request.operation, retry: request.retry === true },
+    }).start();
+    actor.send({ type: "SESSION.REQUESTED" });
+    const before = request.adapter.observe("before");
+    actor.send({ type: "SESSION.OBSERVED", observation: before });
+    const decision = decisionFor(before, request.operation, request.retry === true, request.retry !== true || request.adapter.retryAuthorized?.(before) === true);
+    actor.send({ type: "SESSION.TRANSITION.EVALUATED", decision });
+    if (!decision.allowed) {
+        const snapshot = actor.getSnapshot();
+        actor.stop();
+        if (stateValue(snapshot.value) !== "rejected") {
+            throw new Error("Session actor failed to reject a forbidden lifecycle transition");
+        }
+        return Object.freeze({
+            schemaVersion: SESSION_ACTOR_SCHEMA_VERSION,
+            operation: request.operation,
+            phase: "rejected",
+            decision,
+            before,
+        });
+    }
+    let value;
+    try {
+        value = request.adapter.effect(decision);
+        actor.send({ type: "SESSION.EFFECT.COMPLETED", value });
+    }
+    catch (error) {
+        actor.send({ type: "SESSION.EFFECT.FAILED", error });
+        let after;
+        try {
+            after = request.adapter.observe("after");
+        }
+        catch {
+            after = undefined;
+        }
+        const reconciliation = reconciliationFor(request, error, after, decision);
+        actor.send({ type: "SESSION.RECONCILED", reconciliation });
+        const snapshot = actor.getSnapshot();
+        const phase = stateValue(snapshot.value);
+        actor.stop();
+        if (phase !== "completed" && phase !== "retryable" && phase !== "unresolved") {
+            throw new Error("Session actor failed to classify an effect failure");
+        }
+        return Object.freeze({
+            schemaVersion: SESSION_ACTOR_SCHEMA_VERSION,
+            operation: request.operation,
+            phase,
+            decision,
+            before,
+            ...(after === undefined ? {} : { after }),
+            error,
+            reconciliation,
+        });
+    }
+    let after;
+    try {
+        after = request.adapter.observe("after");
+        actor.send({ type: "SESSION.REOBSERVED", observation: after });
+        actor.send({ type: "SESSION.FINALIZED" });
+    }
+    catch (error) {
+        actor.send({ type: "SESSION.REOBSERVATION.FAILED", error });
+        const reconciliation = reconciliationFor(request, error, undefined, decision);
+        actor.send({ type: "SESSION.RECONCILED", reconciliation });
+        const snapshot = actor.getSnapshot();
+        const phase = stateValue(snapshot.value);
+        actor.stop();
+        if (phase !== "completed" && phase !== "retryable" && phase !== "unresolved") {
+            throw new Error("Session actor failed to classify a re-observation failure");
+        }
+        return Object.freeze({
+            schemaVersion: SESSION_ACTOR_SCHEMA_VERSION,
+            operation: request.operation,
+            phase,
+            decision,
+            before,
+            error,
+            reconciliation,
+        });
+    }
+    const snapshot = actor.getSnapshot();
+    actor.stop();
+    if (stateValue(snapshot.value) !== "completed") {
+        throw new Error("Session actor failed to finalize a completed lifecycle transition");
+    }
+    return Object.freeze({
+        schemaVersion: SESSION_ACTOR_SCHEMA_VERSION,
+        operation: request.operation,
+        phase: "completed",
+        decision,
+        before,
+        after,
+        value,
+    });
+}
+/** Alias used by callers that describe the actor as a coordinator. */
+export const coordinateSessionLifecycle = executeSessionLifecycleActor;
+//# sourceMappingURL=actors.js.map

package/dist/state/session/actors.js.map

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

package/dist/state/session/guards.d.ts

@@ -0,0 +1,25 @@
+import type { SessionLifecycleBlocker } from "../../session-lifecycle-classification.js";
+import type { SessionMachineContext } from "./types.js";
+export type SessionLifecycleBlockerKind = "none" | "recoverable" | "ambiguous";
+/**
+ * Classify already-observed blocker evidence for the lifecycle machine.
+ * This is domain projection input to the guards; it never observes an
+ * external authority and must remain deterministic for the same observation.
+ */
+export declare function classifyObservationBlockers(blockers: readonly SessionLifecycleBlocker[]): SessionLifecycleBlockerKind;
+/** True when the observed facts are insufficient or contradictory. */
+export declare function isObservationStaleInconsistent(context: SessionMachineContext): boolean;
+/** Explicit discard intent is observation data, never an age-derived guess. */
+export declare function hasExplicitDiscardIntent(context: SessionMachineContext): boolean;
+export declare function isObservationDiscarded(context: SessionMachineContext): boolean;
+export declare function isObservationClosed(context: SessionMachineContext): boolean;
+export declare function isObservationBlockedRecoverable(context: SessionMachineContext): boolean;
+export declare function isObservationCloseReady(context: SessionMachineContext): boolean;
+/** GC authority matches the classifier: strictly observation.gcAuthorized === true. */
+export declare function hasGcAuthorization(context: SessionMachineContext): boolean;
+/**
+ * Match destructiveCleanupEligible for the close-ready state. Age suspicion
+ * alone never grants destructive cleanup, including when a healthy session is
+ * old and a caller supplied an otherwise positive GC authorization.
+ */
+export declare function isDestructiveGcAllowed(context: SessionMachineContext): boolean;

package/dist/state/session/guards.js

@@ -0,0 +1,108 @@
+const AMBIGUOUS_CODES = new Set([
+    "GIT_STATE_AMBIGUOUS",
+    "PHYSICAL_OBSERVATION_UNAVAILABLE",
+    "REPOSITORY_IDENTITY_AMBIGUOUS",
+    "WORKTREE_IDENTITY_AMBIGUOUS",
+    "GIT_COMMAND_FAILED",
+    "GIT_SPAWN_FAILED",
+    "GIT_TIMEOUT",
+    "GIT_OUTPUT_LIMIT",
+    "OWNERSHIP_MISMATCH",
+    "DUPLICATE_WORKTREE_OWNERSHIP",
+    "DUPLICATE_BRANCH_OWNERSHIP",
+    "RECONCILIATION_DRIFT",
+    "STALE_REGISTRY",
+]);
+const RECOVERABLE_CODES = new Set([
+    "DIRTY_WORKTREE",
+    "NESTED_REPOSITORY",
+    "RECOVERABLE_COMMITS",
+    "RECOVERABLE_STASHES",
+    "INTEGRATION_FETCH_FAILED",
+]);
+const STALE_PHYSICAL_STATES = new Set([
+    "prunable-missing",
+    "prunable-present",
+    "registered-missing",
+    "unregistered-missing",
+    "unregistered-present",
+    "invalid",
+    "unavailable",
+]);
+const KNOWN_SESSION_STATES = new Set(["new", "active", "closing", "closed", "stale"]);
+const KNOWN_PHYSICAL_STATES = new Set(["healthy", "closed", ...STALE_PHYSICAL_STATES]);
+const KNOWN_BLOCKER_CLASSIFICATIONS = new Set(["recoverable", "ambiguous", "stale"]);
+/**
+ * Classify already-observed blocker evidence for the lifecycle machine.
+ * This is domain projection input to the guards; it never observes an
+ * external authority and must remain deterministic for the same observation.
+ */
+export function classifyObservationBlockers(blockers) {
+    if (blockers.some((blocker) => blocker.classification === "ambiguous" || AMBIGUOUS_CODES.has(blocker.code))) {
+        return "ambiguous";
+    }
+    if (blockers.some((blocker) => blocker.classification === "recoverable" || RECOVERABLE_CODES.has(blocker.code))) {
+        return "recoverable";
+    }
+    return "none";
+}
+function isStalePhysicalState(physicalState) {
+    return (physicalState === null || !KNOWN_PHYSICAL_STATES.has(physicalState) || STALE_PHYSICAL_STATES.has(physicalState));
+}
+function hasUnknownBlocker(blockers) {
+    return blockers.some((blocker) => !AMBIGUOUS_CODES.has(blocker.code) &&
+        !RECOVERABLE_CODES.has(blocker.code) &&
+        (blocker.classification === undefined || !KNOWN_BLOCKER_CLASSIFICATIONS.has(blocker.classification)));
+}
+function observation(context) {
+    return context.observation;
+}
+/** True when the observed facts are insufficient or contradictory. */
+export function isObservationStaleInconsistent(context) {
+    const current = observation(context);
+    const blockers = current.blockers ?? [];
+    const physicalState = current.physicalState ?? null;
+    const closeReadiness = current.closeReadiness ?? "not-evaluated";
+    const recoverability = classifyObservationBlockers(blockers);
+    const physicalEvidenceRequired = current.sessionState !== "closed";
+    const ambiguousReadiness = closeReadiness === "ambiguous" || (closeReadiness === "blocked" && blockers.length === 0);
+    return (!KNOWN_SESSION_STATES.has(current.sessionState) ||
+        (physicalEvidenceRequired && isStalePhysicalState(physicalState)) ||
+        hasUnknownBlocker(blockers) ||
+        blockers.some((blocker) => blocker.classification === "stale") ||
+        ambiguousReadiness ||
+        recoverability === "ambiguous");
+}
+/** Explicit discard intent is observation data, never an age-derived guess. */
+export function hasExplicitDiscardIntent(context) {
+    return context.observation.terminalOperation === "discard" || context.persisted?.terminalOperation === "discard";
+}
+export function isObservationDiscarded(context) {
+    return hasExplicitDiscardIntent(context);
+}
+export function isObservationClosed(context) {
+    return context.observation.sessionState === "closed";
+}
+export function isObservationBlockedRecoverable(context) {
+    const current = observation(context);
+    const recoverability = classifyObservationBlockers(current.blockers ?? []);
+    return recoverability === "recoverable" || current.closeReadiness === "external_evidence_required";
+}
+export function isObservationCloseReady(context) {
+    const current = observation(context);
+    return current.phase === "termination" && current.closeReadiness === "ready";
+}
+/** GC authority matches the classifier: strictly observation.gcAuthorized === true. */
+export function hasGcAuthorization(context) {
+    return context.observation.gcAuthorized === true;
+}
+/**
+ * Match destructiveCleanupEligible for the close-ready state. Age suspicion
+ * alone never grants destructive cleanup, including when a healthy session is
+ * old and a caller supplied an otherwise positive GC authorization.
+ */
+export function isDestructiveGcAllowed(context) {
+    const current = observation(context);
+    return hasGcAuthorization(context) && !(current.ageSuspicious === true && current.physicalState === "healthy");
+}
+//# sourceMappingURL=guards.js.map

package/dist/state/session/guards.js.map

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

package/dist/state/session/index.d.ts

@@ -0,0 +1,6 @@
+/** Internal Session state boundary; intentionally absent from src/index.ts. */
+export { SESSION_OPERATION_EVENT_TYPES } from "./machine.js";
+export { coordinateSessionLifecycle, executeSessionLifecycleActor, SESSION_ACTOR_EVENT_TYPES, SESSION_ACTOR_SCHEMA_VERSION, } from "./actors.js";
+export type { SessionActorAdapter, SessionActorDecision, SessionActorOperation, SessionActorPhase, SessionActorReconciliation, SessionActorReconciliationOutcome, SessionActorRequest, SessionActorResult, } from "./actors.js";
+export { SESSION_MACHINE_EVENT_TYPES, SESSION_STATE_MODULE_SCHEMA_VERSION } from "./types.js";
+export type { PersistedSessionState, SessionEvidenceInput, SessionGarbageCollectionEvidence, SessionIntegrationEvidence, SessionMachineContext, SessionMachineEvent, SessionMachineInput, SessionObservationBlocker, SessionObservationCloseReadiness, SessionObservationInput, SessionObservationPhase, SessionOperationalState, SessionPersistedStateInput, } from "./types.js";

package/dist/state/session/index.js

@@ -0,0 +1,5 @@
+/** Internal Session state boundary; intentionally absent from src/index.ts. */
+export { SESSION_OPERATION_EVENT_TYPES } from "./machine.js";
+export { coordinateSessionLifecycle, executeSessionLifecycleActor, SESSION_ACTOR_EVENT_TYPES, SESSION_ACTOR_SCHEMA_VERSION, } from "./actors.js";
+export { SESSION_MACHINE_EVENT_TYPES, SESSION_STATE_MODULE_SCHEMA_VERSION } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/state/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/state/session/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,EAC5B,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AAWrB,OAAO,EAAE,2BAA2B,EAAE,mCAAmC,EAAE,MAAM,YAAY,CAAC"}