hcifootprint 0.2.0

package/dist/atom/types.d.ts

@@ -0,0 +1,618 @@
+/**
+ * hcifootprint — the domain atom and its supporting types.
+ *
+ * The atom (adjudicated against 8 real-world UI pattern families before any
+ * code was written — see the project's RESEARCH_STATE, hypothesis H1'):
+ *
+ *   Affordance  = binding × guard × effect × schema     (the static capability)
+ *   Transition  = cause × payload × outcome             (each occurrence)
+ *
+ * Design commitments this file encodes:
+ * - `guard` is a serializable footprintjs WhereFilter, evaluated OUTSIDE any
+ *   engine run by the pure `evaluateFilter` — it filters what is OFFERED
+ *   (footprint's decide() chooses one branch; hcifootprint's available()
+ *   exposes every passing edge and waits for the world to pick).
+ * - `effect` is a CLAIM about the app's handler, not a truth. Every settled
+ *   transition carries `effectVerified` — the honesty-marker pattern
+ *   footprintjs uses for untracked reads, applied to writes.
+ * - `cause` replaces a bare user/agent enum: system-initiated motion
+ *   (redirects, server pushes, timeouts) is recorded first-class as a
+ *   `stimulus`, never silently patched over.
+ * - Provenance is accountability for COOPERATING agents, not a security
+ *   boundary. An uncooperative driver is indistinguishable from a human at
+ *   the DOM; enforcement belongs server-side.
+ */
+import type { WhereFilter } from 'footprintjs';
+import type { FilterCondition } from 'footprintjs/advanced';
+/** Who initiated a transition. Open beyond user/agent by design. */
+export type Principal = 'user' | 'agent' | 'system' | 'unknown';
+/** What kind of world-initiated motion a stimulus transition records. */
+export type StimulusKind = 'navigation' | 'timeout' | 'push' | 'structure-swap' | 'unknown';
+/**
+ * Why a transition exists.
+ * - `fired`   — an affordance was fired through the driver (guard-checked).
+ * - `stimulus`— the world moved without an offered edge (back button, server
+ *               push, session expiry). Recorded, never silent.
+ */
+export interface Cause {
+    kind: 'fired' | 'stimulus';
+    principal: Principal;
+    /** Set when kind === 'fired'. */
+    affordanceId?: string;
+    /** Set when kind === 'stimulus'. */
+    stimulus?: StimulusKind;
+    /**
+     * True when the attribution was GUESSED by effect-signature inference (an
+     * unattributed delta matched exactly one registered affordance's declared
+     * writes) rather than observed. Honesty marker — never laundered as fact.
+     */
+    inferred?: boolean;
+}
+/**
+ * Settlement of a transition's declared effect.
+ * fire() → 'pending' when the affordance declares writes; the app reports the
+ * real state delta via updateState() which settles to 'committed'. Async and
+ * optimistic UI reject/rollback/supersede instead of lying in the record.
+ */
+export type Settlement = 'pending' | 'committed' | 'rejected' | 'rolled-back' | 'superseded';
+/** ARIA-first element locator: role + accessible name, never CSS classes. */
+export interface ElementLocator {
+    role: string;
+    name: string;
+}
+export type Actuation = 'click' | 'type' | 'select' | 'hover' | 'drag' | 'press';
+/**
+ * Activation descriptor. Generalized past "element selector" because keyboard
+ * shortcuts have no element and canvas surfaces have no ARIA — those bind via
+ * `keychord` and `programmatic` (the component publishes its own affordance).
+ */
+export type Binding = {
+    kind: 'element';
+    locator: ElementLocator;
+    actuation?: Actuation;
+} | {
+    kind: 'keychord';
+    chord: string;
+} | {
+    kind: 'programmatic';
+    provider: string;
+};
+export interface Effect {
+    /** State keys this affordance claims to change. Verified at settlement. */
+    writes?: string[];
+    /** Page this affordance claims to move to. Reconciled by sync(). */
+    navigatesTo?: string;
+}
+/** Derived when omitted: effect.navigatesTo → 'next', otherwise 'action'. */
+export type CanonicalRole = 'next' | 'prev' | 'submit' | 'cancel' | 'back' | 'open' | 'close' | 'action';
+export interface PageDef {
+    route?: string;
+    description?: string;
+}
+export interface AffordanceDef {
+    /** Page id(s) where this affordance is offered. */
+    on: string | string[];
+    /**
+     * AUTHORED planner-facing text — the only string class ever served to an
+     * LLM as instruction/description. Runtime-resolved strings (labels, user
+     * content) are data, never description (prompt-injection firewall).
+     */
+    description: string;
+    binding: Binding;
+    /**
+     * Serializable availability predicate over projected state. Omit for an
+     * always-offered affordance — `{}` is rejected at build() because
+     * footprint's evaluator deliberately never matches an empty filter.
+     */
+    guard?: WhereFilter;
+    effect?: Effect;
+    /** Payload contract: Zod, JSON Schema, or any .safeParse/.parse validator. */
+    schema?: unknown;
+    /** Marks edges that need server-side step-up/confirmation. Advisory client-side. */
+    highEffect?: boolean;
+    role?: CanonicalRole;
+}
+export interface SkillDef {
+    /** AUTHORED planner-facing text (same string class as affordance descriptions). */
+    description: string;
+    /** Affordance ids, in canonical order. v0: linear; step-DAG is roadmap. */
+    steps: string[];
+    precondition?: WhereFilter;
+}
+export interface Page extends PageDef {
+    id: string;
+}
+export interface Affordance {
+    id: string;
+    on: string[];
+    description: string;
+    /**
+     * Optional since D18: a spine tool may exist with only its description
+     * (plannable/tour-able) and gain a binding or handler at mount time.
+     * The v1 fluent builder still requires it at authoring.
+     */
+    binding?: Binding;
+    guard?: WhereFilter;
+    effect?: Effect;
+    schema?: unknown;
+    highEffect: boolean;
+    role: CanonicalRole;
+    /**
+     * Where the planner-facing description came from. Both classes are
+     * developer-AUTHORED source-code literals (the firewall holds either way);
+     * the marker keeps the origin auditable. Default 'declared'.
+     */
+    descriptionSource?: 'declared' | 'registration';
+}
+/**
+ * How much evidence backs "this node is active" for a served edge (D18).
+ * 'synced'     — the router confirmed this page (page-level tools).
+ * 'assumed'    — declared subtree of the routed page, nothing registered there.
+ * 'registered' — a live mount handle exists on the node.
+ * 'shown'      — an explicit visibility signal says it is visible.
+ * 'hidden'     — an explicit visibility signal says it is NOT visible.
+ */
+export type ActivationLevel = 'synced' | 'assumed' | 'registered' | 'shown' | 'hidden';
+export interface Skill extends SkillDef {
+    id: string;
+}
+export interface SkillGraphSpec {
+    id: string;
+    description?: string;
+    pages: Record<string, Page>;
+    affordances: Record<string, Affordance>;
+    skills: Record<string, Skill>;
+}
+export interface SessionOptions {
+    /** Starting page id. */
+    node: string;
+    /** Initial projected state (the lean snapshot guards read — not the whole app). */
+    state?: Record<string, unknown>;
+    /**
+     * Whether this session receives updateState() reports (a router/store tap).
+     * Default: true when `state` was provided, false otherwise. Without a tap,
+     * declared-writes fires settle on handler completion (or immediately when
+     * nothing executes) with effectVerified 'unobservable' — instead of staying
+     * pending forever (the D18 rung-killer fix).
+     */
+    stateTap?: boolean;
+    /** Keys stored as 'REDACTED' in the commit log while live state keeps raw values. */
+    redactedKeys?: string[];
+    /** Commit-log value encoding (footprintjs dial). Default 'delta'. */
+    commitValues?: 'full' | 'delta';
+    /** Dev-warning sink (StrictMode re-registrations, handler errors). Default console.warn. */
+    onWarn?: (message: string) => void;
+    /**
+     * Capture each handler's RETURN value onto its transition (sanitized+capped)
+     * as the "act → get data back" channel — TransitionRecord.produced. Default
+     * true. Set false to opt a session out entirely (handlers whose returns are
+     * internal and should never reach the agent).
+     */
+    captureProduced?: boolean;
+}
+export interface SessionEvents {
+    /** A new or newly-settled occurrence (a snapshot of the record). */
+    transition: TransitionRecord;
+    /** A committed state delta landed (the `state` version moved). */
+    state: {
+        version: number;
+        stateVersion: number;
+    };
+    /** The served tool-surface changed — frame open/close, or a mount/enable flip. */
+    structure: {
+        version: number;
+        structureVersion: number;
+    };
+    /** A new unmet-demand row was recorded (a deep copy). */
+    gap: GapRecord;
+}
+export type SessionEventName = keyof SessionEvents;
+/**
+ * The handle returned by registerToolGroup — the group's IDENTITY. You never
+ * name a group with a string (two components would collide and you'd have to
+ * invent unique names); registration hands you this handle and you act through
+ * it. `id` is a generated opaque token, exposed only for telemetry/warnings.
+ */
+export interface ToolGroup {
+    /** Generated identity of this registration (for telemetry/debug — not caller-supplied). */
+    readonly id: string;
+    /** The node path this group is registered on (tree API); undefined for the flat API. */
+    readonly node?: string;
+    /** Grey out / re-enable one tool in this group (a disabled button). */
+    setEnabled(toolId: string, enabled: boolean): void;
+    /** Remove this group's registrations (call on unmount). Idempotent. */
+    unregister(): void;
+}
+/** The handle returned by registerTool — a single-tool ToolGroup. */
+export interface ToolHandle {
+    readonly id: string;
+    readonly node?: string;
+    readonly toolId: string;
+    /** Grey out / re-enable this tool. */
+    setEnabled(enabled: boolean): void;
+    unregister(): void;
+}
+/**
+ * One occurrence: a row in the interaction log. SETTLED (and stimulus/sync)
+ * transitions join 1:1 to a CommitBundle by `id`; pending and
+ * rejected/rolled-back rows exist only here — that asymmetry is deliberate
+ * (a rejected effect never touched state, so it has no commit).
+ */
+export interface TransitionRecord {
+    /** runtimeStageId — the join key into the footprintjs commit log. */
+    id: string;
+    cause: Cause;
+    /** Epoch milliseconds when the transition was created. */
+    timestamp: number;
+    payload?: unknown;
+    outcome: Settlement;
+    /**
+     * Whether every DECLARED write key was present in the settled delta.
+     * 'unobservable' when the affordance declared no writes. This checks key
+     * presence only — not values, extra writes, or navigation claims.
+     */
+    effectVerified?: boolean | 'unobservable';
+    /** Guard evidence captured at fire time (why this edge was passable). */
+    evidence?: FilterCondition[];
+    fromNode: string;
+    toNode?: string;
+    /**
+     * True when toNode came from the affordance's declared navigatesTo — a
+     * CLAIM about the app, not an observation. sync() records observations.
+     */
+    toNodeClaimed?: boolean;
+    /**
+     * True on sync()-recorded hops: the cursor moved without passing any guard.
+     * Backward slices must treat the hop as inferred, not authorized.
+     */
+    unverifiedEdge?: boolean;
+    /**
+     * Guard keys that could NOT be evaluated at fire time because the session's
+     * state view never contained them (L0/L1 — no state tap for those keys).
+     * The fire proceeded — the app remains the enforcer — but the record says
+     * honestly which conditions were taken on faith (D18 rung-killer fix).
+     */
+    guardUnevaluated?: string[];
+    /**
+     * Data the fired handler RETURNED (search results, a looked-up record) —
+     * sanitized + capped. This is the "act → get data back" channel: an action
+     * that produces something the agent needs to pick from (a list of ids to
+     * open next) hands it back here. It rides the DATA channel, so untrusted
+     * content (user-generated names) is safe — it is never planner instructions.
+     * Populated once the handler resolves (await the settlement to read it).
+     */
+    produced?: unknown;
+    /** Cursor version when the transition was created. */
+    cursorVersion: number;
+}
+export interface AvailableEdge {
+    affordanceId: string;
+    description: string;
+    role: CanonicalRole;
+    /**
+     * Present only when the session has live registrations: true = a handler is
+     * mounted right now (fireable-with-execution), false = declared here but
+     * nothing registered it (plannable; firing records but nothing executes —
+     * on the current page this doubles as live binding-drift telemetry).
+     */
+    materialized?: boolean;
+    /** Per-condition guard evidence (key/op/threshold/actual) — why it is passable. */
+    evidence: FilterCondition[];
+    /**
+     * Guard keys absent from the session's state view (or holding undefined —
+     * a value guard like `ne ''` would match undefined, so an unset value is
+     * unevaluable, not passable) — the edge is served anyway, WITH this
+     * marker, instead of being silently hidden (D18 fix).
+     */
+    guardUnevaluated?: string[];
+    schema?: unknown;
+    highEffect: boolean;
+    binding?: Binding;
+    /** See Affordance.descriptionSource. */
+    descriptionSource?: 'declared' | 'registration';
+    /** Owning node path in the navigation tree (e.g. 'catalog.filter-rail'). */
+    node?: string;
+    /** Evidence level behind "this node is active" (see ActivationLevel). */
+    activation?: ActivationLevel;
+    /**
+     * 'unknown' when several exclusive-tab siblings are mounted and no
+     * visibility wire exists — a flagged union, never a guessed winner.
+     */
+    presence?: 'unknown';
+    /**
+     * False when the registration site said the control is currently DISABLED
+     * (a grey button: on screen, not clickable). Served honestly with the
+     * marker — like a human seeing it — and firing it is a typed TOOL_DISABLED
+     * rejection. Set via ToolGroup.setEnabled / the `enabled` registration field.
+     */
+    enabled?: boolean;
+    /** Live instance keys for a repeats-container tool (runtime DATA, never schema). */
+    instances?: string[];
+    /**
+     * Where `instances` came from: 'selector' = the declared existence source
+     * (complete), 'mounted-window' = only what is mounted right now (partial —
+     * stated, not silently presented as complete).
+     */
+    enumeration?: 'selector' | 'mounted-window';
+}
+export interface AvailableSlice {
+    version: number;
+    node: string;
+    edges: AvailableEdge[];
+}
+export interface AvailableSkill {
+    id: string;
+    description: string;
+    steps: string[];
+    preconditionPassed: boolean;
+    evidence: FilterCondition[];
+    /** Precondition keys absent from the state view — feasibility unknown, said so. */
+    preconditionUnevaluable?: string[];
+    /** Whether the skill's first step is available right now (on-node + guard). */
+    entryAvailable: boolean;
+}
+export interface Explanation {
+    affordanceId: string;
+    node: string;
+    offeredOnThisNode: boolean;
+    guardPassed: boolean;
+    available: boolean;
+    evidence: FilterCondition[];
+    /** Guard keys that could not be evaluated (absent from the state view, or holding undefined). */
+    guardUnevaluated?: string[];
+}
+export interface FireOptions {
+    source: Principal;
+    /**
+     * Optimistic-concurrency token from available().version. If supplied and
+     * stale, fire() rejects with STALE_CURSOR — the agent must replan on a
+     * fresh slice. Guards are ALSO re-evaluated at fire time regardless.
+     */
+    expectedVersion?: number;
+    payload?: unknown;
+    /** Instance key for a tool on a repeats container (e.g. an order-card id). */
+    instance?: string;
+    /**
+     * Invoke the registered handler (default true when one exists). The DOM
+     * sensor passes false: the browser already runs the app's own onClick, so
+     * the sensor's fire() is record-only.
+     */
+    invoke?: boolean;
+}
+export type FireResult = {
+    ok: true;
+    transition: TransitionRecord;
+    version: number;
+    settlement: 'settled' | 'awaiting-state';
+} | {
+    ok: false;
+    reason: 'UNKNOWN_AFFORDANCE';
+    available: string[];
+} | {
+    ok: false;
+    reason: 'STALE_CURSOR';
+    version: number;
+} | {
+    ok: false;
+    reason: 'NOT_ON_NODE';
+    node: string;
+} | {
+    ok: false;
+    reason: 'GUARD_FAILED';
+    evidence: FilterCondition[];
+} | {
+    ok: false;
+    reason: 'PAYLOAD_INVALID';
+    issues: string;
+}
+/** A shown blocking modal masks this tool's node. Close the modal first. */
+ | {
+    ok: false;
+    reason: 'BLOCKED_BY_OVERLAY';
+    overlay: string;
+}
+/** The tool's node carries an explicit not-visible signal (hidden tab, closed modal). */
+ | {
+    ok: false;
+    reason: 'NODE_NOT_VISIBLE';
+    node: string;
+}
+/** RETRIABLE: the node's mounts have not arrived yet (mid-navigation / deep link). */
+ | {
+    ok: false;
+    reason: 'STILL_MOUNTING';
+    node: string;
+} | {
+    ok: false;
+    reason: 'INSTANCE_REQUIRED';
+    instances: string[];
+} | {
+    ok: false;
+    reason: 'INSTANCE_UNKNOWN';
+    instances: string[];
+}
+/** RETRIABLE: the control is registered but currently greyed out (disabled). */
+ | {
+    ok: false;
+    reason: 'TOOL_DISABLED';
+    affordanceId: string;
+};
+export interface UpdateOptions {
+    /** Settle THIS pending transition (precise attribution — preferred over FIFO). */
+    transitionId?: string;
+    /**
+     * Mark the delta as world-initiated. When set, the delta is NEVER
+     * attributed to a pending fired transition — explicit attribution wins.
+     */
+    stimulus?: StimulusKind;
+    principal?: Principal;
+}
+export type UpdateResult = {
+    ok: true;
+    attributed: boolean;
+    transition: TransitionRecord;
+    version: number;
+} | {
+    ok: false;
+    reason: 'UNCLONEABLE_DELTA';
+    issues: string;
+} | {
+    ok: false;
+    reason: 'UNKNOWN_TRANSITION';
+    pending: string[];
+};
+export type SyncResult = {
+    changed: false;
+    node: string;
+    version: number;
+} | {
+    changed: true;
+    transition: TransitionRecord;
+    node: string;
+    version: number;
+    /**
+     * True when the observed node is not an authored page. The cursor
+     * follows reality anyway (available() honestly serves zero edges there)
+     * — external motion is recorded, never dropped.
+     */
+    offGraph?: boolean;
+};
+/** A fired transition still awaiting its state report. */
+export interface PendingInfo {
+    id: string;
+    affordanceId: string;
+    firedAt: number;
+}
+export type GapReason = 'no-skill-matched' | 'guard-blocked' | 'needs-backend-data'
+/** Sensor-health drift: e.g. a registration outside the router-confirmed page persisted past the grace window. */
+ | 'sensor-drift' | 'other';
+/**
+ * One row of unmet demand. Two kinds:
+ * - 'fire-rejected' — an attempted action the session refused (unknown id,
+ *   failed guard, wrong page, stale plan, bad payload). Recorded automatically.
+ * - 'reported'      — an ask no available action or skill could serve,
+ *   reported explicitly (typically by the agent's report_gap tool).
+ *
+ * Rows are deliberately TOKEN-LEAN and structured — the ask plus NAME lists,
+ * never descriptions or transcripts — so a consumer's batch triage LLM can
+ * cluster thousands of them cheaply to discover which skills/tools to build
+ * next. `request` is runtime data (user text): export it as data, never feed
+ * it to a planner as instructions.
+ *
+ * Triage notes: rows with rejectionReason 'STALE_CURSOR' are usually
+ * optimistic-concurrency retries that SUCCEEDED on replan — filter or
+ * down-weight them; they are cursor-protocol events, not missing capability.
+ * `availableActions` lists full capability at that position (not narrowed by
+ * any open skill frame). The ledger grows unbounded for the session's life —
+ * export via onGap and drain, like the transition log.
+ */
+export interface GapRecord {
+    kind: 'fire-rejected' | 'reported';
+    timestamp: number;
+    node: string;
+    version: number;
+    /** Names only — what existed at that moment (token-lean, injection-safe). */
+    availableActions: string[];
+    availableSkills: string[];
+    /** The id the caller ASKED for — kept even when unknown (that is the signal). */
+    affordanceId?: string;
+    rejectionReason?: 'UNKNOWN_AFFORDANCE' | 'STALE_CURSOR' | 'NOT_ON_NODE' | 'GUARD_FAILED' | 'PAYLOAD_INVALID' | 'BLOCKED_BY_OVERLAY' | 'NODE_NOT_VISIBLE' | 'STILL_MOUNTING' | 'INSTANCE_REQUIRED' | 'INSTANCE_UNKNOWN' | 'TOOL_DISABLED';
+    principal?: Principal;
+    evidence?: FilterCondition[];
+    /** The user's ask (runtime data; length-capped). */
+    request?: string;
+    reason?: GapReason;
+    note?: string;
+}
+export interface ReportGapOptions {
+    /** The ask that could not be served (length-capped to stay token-lean). */
+    request: string;
+    reason?: GapReason;
+    note?: string;
+    principal?: Principal;
+}
+export type StepStatus = 'done' | 'inferred-done' | 'ready' | 'blocked' | 'off-node';
+/** B depends on A when A's declared writes overlap B's guard keys — DERIVED, never authored. */
+export interface DependencyEdge {
+    affordanceId: string;
+    viaKeys: string[];
+}
+export interface SkillPlanStep {
+    affordanceId: string;
+    description: string;
+    /**
+     * 'done' = committed while the current frame was open; 'blocked' = guard
+     * fails (see blockedOn); 'ready' = fireable here and now; 'off-node' =
+     * guard passes but the step lives on another page (navigate first).
+     */
+    status: StepStatus;
+    dependsOn: DependencyEdge[];
+    onNodes: string[];
+    blockedOn?: FilterCondition[];
+    /** Guard keys absent from the state view — the step shows 'ready', taken on faith. */
+    guardUnevaluated?: string[];
+}
+/** The derived intra-skill dependency DAG with live status. */
+export interface SkillPlan {
+    skillId: string;
+    description: string;
+    steps: SkillPlanStep[];
+}
+export type FrameStatus = 'open' | 'completed' | 'cancelled' | 'demoted';
+/** One committed pass at a skill. 'demoted' = the skill's precondition broke mid-flow. */
+export interface SkillFrame {
+    skillId: string;
+    status: FrameStatus;
+    principal: Principal;
+    openedAt: number;
+    openedAtVersion: number;
+    /** Steps committed while this frame was open (observed fires). */
+    firedSteps: string[];
+    /**
+     * Steps attributed by effect-signature INFERENCE while this frame was open
+     * — guesses, kept separate from observed fires. skillPlan shows them as
+     * 'inferred-done' so an agent re-executes only as a visible choice.
+     */
+    inferredSteps: string[];
+    closedAtVersion?: number;
+}
+export type CommitSkillResult = {
+    ok: true;
+    frame: SkillFrame;
+    plan: SkillPlan;
+    version: number;
+} | {
+    ok: false;
+    reason: 'UNKNOWN_SKILL';
+    known: string[];
+} | {
+    ok: false;
+    reason: 'STALE_CURSOR';
+    version: number;
+} | {
+    ok: false;
+    reason: 'PRECONDITION_FAILED';
+    evidence: FilterCondition[];
+} | {
+    ok: false;
+    reason: 'FRAME_ALREADY_OPEN';
+    skillId: string;
+};
+export interface ContextBriefOptions {
+    /** Only include transitions created at or after this cursor version (the "since your last turn" cursor). */
+    sinceVersion?: number;
+    /** Cap on rendered transitions (default 20); older ones collapse into an omitted count. */
+    maxTransitions?: number;
+}
+/**
+ * Token-lean, prompt-ready session context. `text` is built from AUTHORED
+ * strings and structural facts only — state values and payloads never enter
+ * it (the two-string-class invariant extends to history).
+ */
+export interface ContextBrief {
+    node: string;
+    version: number;
+    frame: SkillFrame | null;
+    text: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/atom/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/atom/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAM5D,oEAAoE;AACpE,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEhE,yEAAyE;AACzE,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAAC;AAE5F;;;;;GAKG;AACH,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC;IAC3B,SAAS,EAAE,SAAS,CAAC;IACrB,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,aAAa,GAAG,YAAY,CAAC;AAM7F,6EAA6E;AAC7E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAEjF;;;;GAIG;AACH,MAAM,MAAM,OAAO,GACf;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,cAAc,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE,GACnE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAM/C,MAAM,WAAW,MAAM;IACrB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD,6EAA6E;AAC7E,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,MAAM,GACN,OAAO,GACP,QAAQ,CAAC;AAEb,MAAM,WAAW,OAAO;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,mDAAmD;IACnD,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oFAAoF;IACpF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,mFAAmF;IACnF,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,CAAC,EAAE,WAAW,CAAC;CAC5B;AAMD,MAAM,WAAW,IAAK,SAAQ,OAAO;IACnC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,aAAa,CAAC;IACpB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,UAAU,GAAG,cAAc,CAAC;CACjD;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEvF,MAAM,WAAW,KAAM,SAAQ,QAAQ;IACrC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CAC/B;AAMD,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qFAAqF;IACrF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,4FAA4F;IAC5F,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AASD,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,UAAU,EAAE,gBAAgB,CAAC;IAC7B,kEAAkE;IAClE,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,kFAAkF;IAClF,SAAS,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD,yDAAyD;IACzD,GAAG,EAAE,SAAS,CAAC;CAChB;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,aAAa,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,wFAAwF;IACxF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACnD,uEAAuE;IACvE,UAAU,IAAI,IAAI,CAAC;CACpB;AAED,qEAAqE;AACrE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACnC,UAAU,IAAI,IAAI,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;IACb,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,UAAU,CAAC;IACpB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;IAC1C,yEAAyE;IACzE,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sDAAsD;IACtD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,aAAa,CAAC;IACpB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mFAAmF;IACnF,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wCAAwC;IACxC,iBAAiB,CAAC,EAAE,UAAU,GAAG,cAAc,CAAC;IAEhD,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB;;;;OAIG;IACH,WAAW,CAAC,EAAE,UAAU,GAAG,gBAAgB,CAAC;CAC7C;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,mFAAmF;IACnF,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAC;IACnC,+EAA+E;IAC/E,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,iGAAiG;IACjG,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,SAAS,CAAC;IAClB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,SAAS,GAAG,gBAAgB,CAAA;CAAE,GACrG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,GAChE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,eAAe,EAAE,CAAA;CAAE,GAClE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAE1D,4EAA4E;GAC1E;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AAC9D,yFAAyF;GACvF;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACzD,sFAAsF;GACpF;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,GAC/D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE;AAChE,gFAAgF;GAC9E;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,eAAe,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjE,MAAM,WAAW,aAAa;IAC5B,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAChF;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEnE,MAAM,MAAM,UAAU,GAClB;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjD;IACE,OAAO,EAAE,IAAI,CAAC;IACd,UAAU,EAAE,gBAAgB,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEN,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,MAAM,MAAM,SAAS,GACjB,kBAAkB,GAClB,eAAe,GACf,oBAAoB;AACtB,kHAAkH;GAChH,cAAc,GACd,OAAO,CAAC;AAEZ;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,eAAe,GAAG,UAAU,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,EAAE,MAAM,EAAE,CAAC;IAE1B,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EACZ,oBAAoB,GACpB,cAAc,GACd,aAAa,GACb,cAAc,GACd,iBAAiB,GACjB,oBAAoB,GACpB,kBAAkB,GAClB,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,eAAe,CAAC;IACpB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAE7B,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAMD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,eAAe,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;AAErF,gGAAgG;AAChG,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;IAC9B,sFAAsF;IACtF,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,+DAA+D;AAC/D,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC;AAEzE,0FAA0F;AAC1F,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,kEAAkE;IAClE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB;;;;OAIG;IACH,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,iBAAiB,GACzB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,GACvD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAC;IAAC,QAAQ,EAAE,eAAe,EAAE,CAAA;CAAE,GACzE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAMjE,MAAM,WAAW,mBAAmB;IAClC,4GAA4G;IAC5G,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2FAA2F;IAC3F,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/atom/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/atom/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/atom/types.ts"],"names":[],"mappings":""}

package/dist/graph/builder.d.ts

@@ -0,0 +1,31 @@
+import type { AffordanceDef, PageDef, SessionOptions, SkillDef, SkillGraphSpec } from '../atom/types.js';
+import { Session } from '../traverse/session.js';
+export { SkillGraphValidationError } from './guards.js';
+export interface SkillGraph {
+    spec: SkillGraphSpec;
+    createSession(opts: SessionOptions): Session;
+    /**
+     * The sorted, deduped set of state keys every guard in this graph reads —
+     * across all affordance guards and skill preconditions, whether or not their
+     * tool is currently offered. Seed each of these in your state projector: a
+     * guard key ABSENT from projected state is NOT treated as false and hidden —
+     * it is served WITH the `guardUnevaluated` honesty marker (the edge is
+     * offered, the missing condition flagged as taken-on-faith), so an
+     * incompletely-seeded projector silently degrades honest availability into
+     * unevaluated-guess territory. A projection covering this whole set is what
+     * lets guards actually decide rather than defer.
+     */
+    requiredStateKeys(): string[];
+}
+export declare function skillGraph(id: string, opts?: {
+    description?: string;
+}): SkillGraphBuilder;
+export declare class SkillGraphBuilder {
+    #private;
+    constructor(id: string, description?: string);
+    page(id: string, def?: PageDef): this;
+    affordance(id: string, def: AffordanceDef): this;
+    skill(id: string, def: SkillDef): this;
+    build(): SkillGraph;
+}
+//# sourceMappingURL=builder.d.ts.map

package/dist/graph/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/graph/builder.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAEV,aAAa,EAGb,OAAO,EACP,cAAc,EAEd,QAAQ,EACR,cAAc,EACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC;IAC7C;;;;;;;;;;OAUG;IACH,iBAAiB,IAAI,MAAM,EAAE,CAAC;CAC/B;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,iBAAiB,CAEzF;AAED,qBAAa,iBAAiB;;gBAOhB,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;IAM5C,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,GAAE,OAAY,GAAG,IAAI;IAMzC,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI;IAkChD,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI;IAoBtC,KAAK,IAAI,UAAU;CAiFpB"}