@methodts/runtime 0.1.0

package/dist/ports/methodology-source.d.ts

@@ -0,0 +1,95 @@
+/**
+ * MethodologySource — Port interface for methodology data access.
+ *
+ * WS-1: Replaces the dual-source architecture (core YAML loader + methodts stdlib)
+ * with a single port interface. All consumers (bridge, MCP) access methodology
+ * data exclusively through this port.
+ *
+ * First implementation: StdlibSource (wraps @methodts/methodts stdlib catalog) —
+ * stays in bridge per PRD-057 / S2 §5.3.
+ * Test implementation: InMemorySource (proves port substitutability).
+ *
+ * PRD-064 / S7 (2026-04-14): port is **extended additively** with four
+ * optional lifecycle methods (`init`, `reload`, `onChange`, `close`) and a
+ * `MethodologyChange` notification payload. Core synchronous reads
+ * (`list`, `getMethod`, `getMethodology`) are preserved verbatim — they are
+ * the runtime hot path. Cortex-backed implementations (`CortexMethodologySource`
+ * in `@methodts/agent-runtime`) hydrate their in-memory cache in `init()` and
+ * notify invalidation listeners through `onChange()`. Stdlib/in-memory
+ * sources no-op the optional methods.
+ *
+ * Design: DR-15 compliant — domain code accepts port via constructor injection.
+ * The composition root (server-entry.ts) wires the concrete provider.
+ */
+import type { CatalogMethodologyEntry } from '@methodts/methodts/stdlib';
+import type { Method } from '@methodts/methodts';
+import type { Methodology } from '@methodts/methodts';
+/**
+ * Port interface for methodology data access.
+ *
+ * Core reads (list/getMethod/getMethodology) are SYNCHRONOUS — the hot path
+ * on every runtime tick. Implementations MUST maintain an in-memory cache;
+ * network I/O happens only in init/reload.
+ *
+ * Owner:     @methodts/runtime
+ * Consumers: @methodts/bridge (via StdlibSource), @methodts/agent-runtime
+ *            (via CortexMethodologySource), tests (via InMemorySource)
+ * Co-designed: 2026-04-14 (S7)
+ */
+export interface MethodologySource {
+    /** List all available methodologies and their methods (catalog data). */
+    list(): CatalogMethodologyEntry[];
+    /** Lookup a typed Method by methodology ID and method ID. */
+    getMethod(methodologyId: string, methodId: string): Method<any> | undefined;
+    /** Lookup a typed Methodology by ID. */
+    getMethodology(methodologyId: string): Methodology<any> | undefined;
+    /**
+     * Hydrate the in-memory cache. Called once by the composition root
+     * before the runtime serves requests.
+     *   Stdlib: no-op.
+     *   Cortex: reads ctx.storage, resolves stdlib inheritance, validates.
+     */
+    init?(): Promise<void>;
+    /**
+     * Force a full or targeted cache rebuild. Called by the admin write
+     * path on upsert, or by the ctx.events handler when a methodology is
+     * mutated on another replica. If `methodologyId` is omitted, rebuild
+     * the whole cache.
+     */
+    reload?(methodologyId?: string): Promise<void>;
+    /**
+     * Subscribe to in-process invalidation events. Runtime consumers that
+     * cache derived state (e.g. MethodologySessionStore) listen to this to
+     * drop stale routing decisions. Returns an unsubscribe function.
+     * StdlibSource / InMemorySource never emit by default.
+     */
+    onChange?(listener: (change: MethodologyChange) => void): () => void;
+    /** Release long-lived resources (DB connections, event subscriptions). */
+    close?(): Promise<void>;
+}
+/**
+ * Payload delivered to `onChange` listeners. One union per lifecycle event
+ * observable from the source:
+ *
+ *   - `added`   : a new methodology appeared in the catalog
+ *   - `updated` : an existing methodology advanced to a new version
+ *   - `removed` : a methodology was withdrawn from the catalog
+ *   - `reloaded`: the entire cache was rebuilt (policy change, bulk edit)
+ */
+export type MethodologyChange = {
+    kind: 'added';
+    methodologyId: string;
+    version: string;
+} | {
+    kind: 'updated';
+    methodologyId: string;
+    version: string;
+    previousVersion: string;
+} | {
+    kind: 'removed';
+    methodologyId: string;
+} | {
+    kind: 'reloaded';
+    reason: 'full' | 'bulk-admin-edit';
+};
+//# sourceMappingURL=methodology-source.d.ts.map

package/dist/ports/methodology-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"methodology-source.d.ts","sourceRoot":"","sources":["../../src/ports/methodology-source.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAiB;IAEhC,yEAAyE;IACzE,IAAI,IAAI,uBAAuB,EAAE,CAAC;IAElC,6DAA6D;IAE7D,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAE5E,wCAAwC;IAExC,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAIpE;;;;;OAKG;IACH,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;;;OAKG;IACH,MAAM,CAAC,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C;;;;;OAKG;IACH,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAErE,0EAA0E;IAC1E,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;CACzB,GACD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAAA;CAAE,CAAC"}

package/dist/ports/methodology-source.js

@@ -0,0 +1,26 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * MethodologySource — Port interface for methodology data access.
+ *
+ * WS-1: Replaces the dual-source architecture (core YAML loader + methodts stdlib)
+ * with a single port interface. All consumers (bridge, MCP) access methodology
+ * data exclusively through this port.
+ *
+ * First implementation: StdlibSource (wraps @methodts/methodts stdlib catalog) —
+ * stays in bridge per PRD-057 / S2 §5.3.
+ * Test implementation: InMemorySource (proves port substitutability).
+ *
+ * PRD-064 / S7 (2026-04-14): port is **extended additively** with four
+ * optional lifecycle methods (`init`, `reload`, `onChange`, `close`) and a
+ * `MethodologyChange` notification payload. Core synchronous reads
+ * (`list`, `getMethod`, `getMethodology`) are preserved verbatim — they are
+ * the runtime hot path. Cortex-backed implementations (`CortexMethodologySource`
+ * in `@methodts/agent-runtime`) hydrate their in-memory cache in `init()` and
+ * notify invalidation listeners through `onChange()`. Stdlib/in-memory
+ * sources no-op the optional methods.
+ *
+ * Design: DR-15 compliant — domain code accepts port via constructor injection.
+ * The composition root (server-entry.ts) wires the concrete provider.
+ */
+export {};
+//# sourceMappingURL=methodology-source.js.map

package/dist/ports/methodology-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"methodology-source.js","sourceRoot":"","sources":["../../src/ports/methodology-source.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC;;;;;;;;;;;;;;;;;;;;;;GAsBG"}

package/dist/ports/native-session-discovery.d.ts

@@ -0,0 +1,20 @@
+/**
+ * NativeSessionDiscovery — Port interface for discovering live Claude CLI sessions.
+ *
+ * PRD-057 / S2 §5.3: Only the interface lives in runtime. The Node impl
+ * (`createNodeNativeSessionDiscovery`) stays in bridge because it reads the
+ * filesystem — an OS-bound operation.
+ *
+ * Used by startup recovery to reconcile persisted session state against
+ * actual running processes.
+ */
+export interface NativeSessionInfo {
+    sessionId: string;
+    pid: number;
+    projectPath: string;
+    startedAt: number;
+}
+export interface NativeSessionDiscovery {
+    listLiveSessions(): Promise<NativeSessionInfo[]>;
+}
+//# sourceMappingURL=native-session-discovery.d.ts.map

package/dist/ports/native-session-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-session-discovery.d.ts","sourceRoot":"","sources":["../../src/ports/native-session-discovery.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AAIH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;CAClD"}

package/dist/ports/native-session-discovery.js

@@ -0,0 +1,13 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * NativeSessionDiscovery — Port interface for discovering live Claude CLI sessions.
+ *
+ * PRD-057 / S2 §5.3: Only the interface lives in runtime. The Node impl
+ * (`createNodeNativeSessionDiscovery`) stays in bridge because it reads the
+ * filesystem — an OS-bound operation.
+ *
+ * Used by startup recovery to reconcile persisted session state against
+ * actual running processes.
+ */
+export {};
+//# sourceMappingURL=native-session-discovery.js.map

package/dist/ports/native-session-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-session-discovery.js","sourceRoot":"","sources":["../../src/ports/native-session-discovery.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC;;;;;;;;;GASG"}

package/dist/ports/projection-store.d.ts

@@ -0,0 +1,48 @@
+/**
+ * ProjectionStore — composition-root port for projection-based state persistence.
+ *
+ * Manages the lifecycle of registered projections: snapshot loading, event replay
+ * from the persistent log, live event subscription via EventBus, and in-memory
+ * state access for consumers.
+ *
+ * Lifecycle:
+ *   1. register() — called at composition root for each projection, before start()
+ *   2. start() — loads snapshots, replays events, subscribes to live stream
+ *   3. get<S>(domain) — consumers read current in-memory state
+ *
+ * @see .method/sessions/fcd-design-persistence-projections/prd.md §Surfaces S2
+ */
+import type { Projection } from './projection.js';
+export interface ProjectionStore {
+    /**
+     * Register a projection. Must be called before start().
+     * Throws if the projection's domain is already registered.
+     */
+    register<S>(projection: Projection<S>): void;
+    /**
+     * Load snapshots → replay events from snapshot cursor → subscribe to live events.
+     * Called once at composition root after EventBus is ready.
+     * Safe to call multiple times — only the first invocation has effect.
+     */
+    start(): Promise<StartResult>;
+    /**
+     * Read current in-memory state for a domain.
+     * Returns null if the domain is not registered or start() has not completed.
+     */
+    get<S>(domain: string): S | null;
+    /**
+     * Lowest cursor across all projection snapshots. Used by EventRotator as a
+     * safety guard — events at or below this sequence are safe to archive.
+     * Returns null if no projections are registered or no snapshots have been taken.
+     */
+    maxSafeCutoff(): number | null;
+}
+export interface StartResult {
+    readonly projectionsLoaded: number;
+    readonly snapshotsRestored: number;
+    readonly eventsReplayed: number;
+    /** Events that failed the reducer during replay (logged, skipped, not thrown). */
+    readonly skippedEvents: number;
+    readonly durationMs: number;
+}
+//# sourceMappingURL=projection-store.d.ts.map

package/dist/ports/projection-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-store.d.ts","sourceRoot":"","sources":["../../src/ports/projection-store.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAE7C;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IAE9B;;;OAGG;IACH,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC;IAEjC;;;;OAIG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,kFAAkF;IAClF,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B"}

package/dist/ports/projection-store.js

@@ -0,0 +1,17 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * ProjectionStore — composition-root port for projection-based state persistence.
+ *
+ * Manages the lifecycle of registered projections: snapshot loading, event replay
+ * from the persistent log, live event subscription via EventBus, and in-memory
+ * state access for consumers.
+ *
+ * Lifecycle:
+ *   1. register() — called at composition root for each projection, before start()
+ *   2. start() — loads snapshots, replays events, subscribes to live stream
+ *   3. get<S>(domain) — consumers read current in-memory state
+ *
+ * @see .method/sessions/fcd-design-persistence-projections/prd.md §Surfaces S2
+ */
+export {};
+//# sourceMappingURL=projection-store.js.map

package/dist/ports/projection-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-store.js","sourceRoot":"","sources":["../../src/ports/projection-store.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC;;;;;;;;;;;;;GAaG"}

package/dist/ports/projection.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Projection<S> — domain contract for projecting event streams into in-memory state.
+ *
+ * A projection is a pure reducer over RuntimeEvent streams. Domains implement this
+ * interface to opt into projection-based persistence: the ProjectionStore loads
+ * snapshots, replays events from the persistent log, and subscribes to live updates
+ * on behalf of the projection.
+ *
+ * @see .method/sessions/fcd-design-persistence-projections/prd.md §Surfaces S1
+ */
+import type { RuntimeEvent } from './event-bus.js';
+export interface Projection<S> {
+    /** Domain name — used as snapshot filename (e.g. 'build' → .method/projections/build.json). */
+    readonly domain: string;
+    /** Returns the empty initial state. Called when no snapshot exists. */
+    initialState(): S;
+    /**
+     * Pure reducer: apply an event to current state, return new state.
+     * Must be deterministic. Events that don't apply should return state unchanged.
+     */
+    reduce(state: S, event: RuntimeEvent): S;
+    /** Serialize state to JSON string for snapshot. Omit to disable snapshots (replay-only). */
+    serialize?(state: S): string;
+    /** Deserialize snapshot back to state. Required if `serialize` is defined. */
+    deserialize?(raw: string): S;
+    /** Snapshot every N events after the last snapshot. Default 100. */
+    readonly snapshotEveryN?: number;
+}
+//# sourceMappingURL=projection.d.ts.map

package/dist/ports/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../src/ports/projection.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,+FAA+F;IAC/F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,uEAAuE;IACvE,YAAY,IAAI,CAAC,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,YAAY,GAAG,CAAC,CAAC;IAEzC,4FAA4F;IAC5F,SAAS,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC;IAE7B,8EAA8E;IAC9E,WAAW,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC;IAE7B,oEAAoE;IACpE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC"}

package/dist/ports/projection.js

@@ -0,0 +1,13 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Projection<S> — domain contract for projecting event streams into in-memory state.
+ *
+ * A projection is a pure reducer over RuntimeEvent streams. Domains implement this
+ * interface to opt into projection-based persistence: the ProjectionStore loads
+ * snapshots, replays events from the persistent log, and subscribes to live updates
+ * on behalf of the projection.
+ *
+ * @see .method/sessions/fcd-design-persistence-projections/prd.md §Surfaces S1
+ */
+export {};
+//# sourceMappingURL=projection.js.map

package/dist/ports/projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.js","sourceRoot":"","sources":["../../src/ports/projection.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC;;;;;;;;;GASG"}

package/dist/ports/rate-governor.d.ts

@@ -0,0 +1,17 @@
+/**
+ * RuntimeRateGovernor — Extended port interface (PRD 051 S2 extension).
+ *
+ * PRD-057 / S2 §4: renamed from `BridgeRateGovernor` → `RuntimeRateGovernor`.
+ *
+ * Extends pacta's base RateGovernor with admin-facing utilization
+ * and leak-detection methods.
+ */
+import type { ProviderClass, AccountUtilization } from '@methodts/types';
+import type { RateGovernor, DispatchSlot } from '@methodts/pacta';
+export type { RateGovernor, DispatchSlot, AcquireOptions, ObserveOutcome } from '@methodts/pacta';
+export { SaturationError } from '@methodts/pacta';
+export interface RuntimeRateGovernor extends RateGovernor {
+    utilization(providerClass: ProviderClass): readonly AccountUtilization[];
+    activeSlots(): readonly DispatchSlot[];
+}
+//# sourceMappingURL=rate-governor.d.ts.map

package/dist/ports/rate-governor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-governor.d.ts","sourceRoot":"","sources":["../../src/ports/rate-governor.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAElE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAClG,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,WAAW,CAAC,aAAa,EAAE,aAAa,GAAG,SAAS,kBAAkB,EAAE,CAAC;IACzE,WAAW,IAAI,SAAS,YAAY,EAAE,CAAC;CACxC"}

package/dist/ports/rate-governor.js

@@ -0,0 +1,11 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * RuntimeRateGovernor — Extended port interface (PRD 051 S2 extension).
+ *
+ * PRD-057 / S2 §4: renamed from `BridgeRateGovernor` → `RuntimeRateGovernor`.
+ *
+ * Extends pacta's base RateGovernor with admin-facing utilization
+ * and leak-detection methods.
+ */
+export { SaturationError } from '@methodts/pacta';
+//# sourceMappingURL=rate-governor.js.map

package/dist/ports/rate-governor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-governor.js","sourceRoot":"","sources":["../../src/ports/rate-governor.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC;;;;;;;GAOG;AAMH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/ports/schedule-client.d.ts

@@ -0,0 +1,29 @@
+/**
+ * ScheduleClient — minimal slice of ctx.schedule consumed by the runtime.
+ *
+ * PRD-062 / S5 §2.3. Frozen: 2026-04-14.
+ *
+ * Cortex's EventBridge-backed scheduler is structurally compatible with
+ * this port (Cortex PRD-075). The runtime consumes it via
+ * `ScheduledPact.bind/unbind` — tenant apps that pre-declare schedules
+ * in the manifest never touch this port directly.
+ */
+export interface ScheduleClient {
+    /**
+     * Register a named schedule. On each `cron` tick, the scheduler
+     * enqueues a job of `def.job` with `def.payload`.
+     */
+    create(name: string, def: {
+        cron: string;
+        job: string;
+        payload: unknown;
+    }): Promise<void>;
+    /** Delete a named schedule. Idempotent. */
+    delete(name: string): Promise<void>;
+    /** List registered schedules. */
+    list(): Promise<Array<{
+        name: string;
+        cron: string;
+    }>>;
+}
+//# sourceMappingURL=schedule-client.d.ts.map

package/dist/ports/schedule-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-client.d.ts","sourceRoot":"","sources":["../../src/ports/schedule-client.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,MAAM,CACJ,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,GACnD,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB,2CAA2C;IAC3C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC,iCAAiC;IACjC,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;CACxD"}

package/dist/ports/schedule-client.js

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

package/dist/ports/schedule-client.js.map

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

package/dist/ports/session-pool.d.ts

@@ -0,0 +1,162 @@
+/**
+ * SessionPool Port — Cross-domain interface for session pool access.
+ *
+ * PRD-057 / S2 §6: Session-pool port types migrated to @methodts/runtime. The
+ * full `SessionPool` interface is defined here along with the new
+ * `SessionProviderFactory` port that both @methodts/bridge (PTY factory) and
+ * @methodts/agent-runtime (Cortex factory) will implement.
+ *
+ * Design: DR-15 compliant — domains accept the port via injection.
+ * The composition root wires the real pool implementation to consumers.
+ *
+ * NOTE (C1): The `SessionPool` concrete interface still references types from
+ * the bridge's `domains/sessions/pool.ts` (`SessionChannels`,
+ * `SessionDiagnostics`, `PtySession`, etc.). Those types move to runtime in
+ * C5 (`runtime-sessions-subpath`). For C1 the bridge-side
+ * `packages/bridge/src/ports/session-pool.ts` continues to expose the full
+ * `SessionPool` interface by re-exporting from its local pool.ts.
+ */
+export interface SessionBudget {
+    max_depth: number;
+    max_agents: number;
+    agents_spawned: number;
+}
+export interface SessionChainInfo {
+    parent_session_id: string | null;
+    depth: number;
+    children: string[];
+    budget: SessionBudget;
+}
+export type SessionMode = 'print' | 'cognitive-agent';
+export type IsolationMode = 'worktree' | 'shared';
+export type WorktreeAction = 'merge' | 'keep' | 'discard';
+export interface WorktreeInfo {
+    isolation: IsolationMode;
+    worktree_path: string | null;
+    worktree_branch: string | null;
+    metals_available: boolean;
+}
+/**
+ * SSE stream event emitted during a streaming prompt.
+ *
+ * Shared across providers — print-mode, cognitive-mode, and (eventually)
+ * Cortex-backed sessions all emit the same shape.
+ */
+export interface StreamEvent {
+    type: 'text' | 'done' | 'error' | 'cycle-start' | 'cycle-action' | 'monitor' | 'affect' | 'memory' | 'reflection';
+    content?: string;
+    output?: string;
+    metadata?: Record<string, unknown> | null;
+    timed_out?: boolean;
+    error?: string;
+    cycle?: number;
+    maxCycles?: number;
+    action?: string;
+    confidence?: number;
+    tokens?: number;
+    intervention?: string;
+    restricted?: string[];
+    label?: string;
+    valence?: number;
+    arousal?: number;
+    retrieved?: number;
+    stored?: number;
+    totalCards?: number;
+    lessons?: string[];
+}
+export interface SessionStatusInfo {
+    sessionId: string;
+    nickname: string;
+    purpose: string | null;
+    status: string;
+    queueDepth: number;
+    metadata?: Record<string, unknown>;
+    promptCount: number;
+    lastActivityAt: Date;
+    workdir: string;
+    chain: SessionChainInfo;
+    worktree: WorktreeInfo;
+    stale: boolean;
+    waiting_for: string | null;
+    /** PRD 028: Session mode. */
+    mode: SessionMode;
+    /** PRD 012: Per-session diagnostic metrics (concrete shape defined in sessions subpath). */
+    diagnostics: unknown | null;
+}
+/** PRD 029: Snapshot of a session's state for recovery / restoration. */
+export interface SessionSnapshot {
+    sessionId: string;
+    nickname: string;
+    purpose?: string | null;
+    workdir: string;
+    mode: SessionMode | string;
+    depth: number;
+    parentSessionId?: string | null;
+    isolation: IsolationMode | string;
+    metadata?: Record<string, unknown>;
+    promptCount: number;
+    pid?: number;
+}
+/**
+ * Minimal handle returned by the SessionProviderFactory. Mirrors the
+ * shape of `PtySession` (defined in `@methodts/runtime/sessions`) with
+ * only the attributes the pool needs to route lifecycle calls.
+ *
+ * C5 completes the sessions subpath migration; the concrete `PtySession`
+ * interface in `@methodts/runtime/sessions/print-session.ts` is assignable
+ * to `PtySessionHandle` structurally — the pool stores the factory's
+ * result directly as a `PtySession`.
+ */
+export interface PtySessionHandle {
+    /** Unique session ID (stable across lifecycle). */
+    id: string;
+    /** OS process ID (print-mode = null; PTY-backed = number). */
+    pid: number | null;
+    /** Session status. */
+    status: string;
+    queueDepth: number;
+    promptCount: number;
+    lastActivityAt: Date;
+    readonly transcript: string;
+    onOutput(cb: (data: string) => void): () => void;
+    onExit(cb: (exitCode: number) => void): void;
+    sendPrompt(prompt: string, timeoutMs?: number, settleDelayMs?: number): Promise<{
+        output: string;
+        timedOut: boolean;
+    }>;
+    resize(cols: number, rows: number): void;
+    kill(): void;
+    interrupt(): boolean;
+}
+/**
+ * Options passed to the SessionProviderFactory when the pool needs a new
+ * session. Bridge's factory (PTY+print+cognitive) and agent-runtime's
+ * factory (Cortex-ctx.llm-backed) both receive this shape.
+ */
+export interface SessionProviderOptions {
+    sessionId: string;
+    mode: SessionMode;
+    workdir: string;
+    allowedTools?: string[];
+    allowedPaths?: string[];
+    metadata?: Record<string, unknown>;
+    /** Invoked on every stream event (text, cycle-start, monitor, etc.). */
+    onEvent: (event: StreamEvent) => void;
+    /** Optional cognitive config (only used when mode === 'cognitive-agent'). Shape defined in sessions subpath. */
+    cognitiveConfig?: Record<string, unknown>;
+    /** Optional sink for typed cognitive events (PRD 041 experiment lab). Shape defined in sessions subpath. */
+    cognitiveSink?: unknown;
+}
+/**
+ * Factory that produces the concrete session implementation for a given
+ * session mode. Injected at pool construction — bridge provides a
+ * PTY+print factory; agent-runtime provides an HTTP/ctx.llm factory.
+ *
+ * The pool handles lifecycle, queueing, diagnostics, channels, and chain
+ * bookkeeping. The factory owns ONLY the "how does a prompt actually
+ * execute" part.
+ */
+export interface SessionProviderFactory {
+    createSession(options: SessionProviderOptions): Promise<PtySessionHandle>;
+}
+//# sourceMappingURL=session-pool.d.ts.map

package/dist/ports/session-pool.d.ts.map

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

package/dist/ports/session-pool.js

@@ -0,0 +1,21 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * SessionPool Port — Cross-domain interface for session pool access.
+ *
+ * PRD-057 / S2 §6: Session-pool port types migrated to @methodts/runtime. The
+ * full `SessionPool` interface is defined here along with the new
+ * `SessionProviderFactory` port that both @methodts/bridge (PTY factory) and
+ * @methodts/agent-runtime (Cortex factory) will implement.
+ *
+ * Design: DR-15 compliant — domains accept the port via injection.
+ * The composition root wires the real pool implementation to consumers.
+ *
+ * NOTE (C1): The `SessionPool` concrete interface still references types from
+ * the bridge's `domains/sessions/pool.ts` (`SessionChannels`,
+ * `SessionDiagnostics`, `PtySession`, etc.). Those types move to runtime in
+ * C5 (`runtime-sessions-subpath`). For C1 the bridge-side
+ * `packages/bridge/src/ports/session-pool.ts` continues to expose the full
+ * `SessionPool` interface by re-exporting from its local pool.ts.
+ */
+export {};
+//# sourceMappingURL=session-pool.js.map

package/dist/ports/session-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-pool.js","sourceRoot":"","sources":["../../src/ports/session-pool.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/ports/session-store-errors.d.ts

@@ -0,0 +1,22 @@
+/**
+ * SessionStore error taxonomy — PRD-061 / S4 §4.4.
+ *
+ * Discriminated by `code`. The union MUST stay exhaustive so adapter
+ * implementations fail closed on unknown conditions.
+ */
+export type SessionStoreErrorCode = 'NOT_FOUND' | 'DUPLICATE' | 'FENCED' | 'LEASE_EXPIRED' | 'SCHEMA_INCOMPATIBLE' | 'FINGERPRINT_MISMATCH' | 'QUOTA_EXCEEDED' | 'BACKEND_UNAVAILABLE' | 'CORRUPT_SNAPSHOT' | 'INTERNAL';
+export interface SessionStoreErrorOptions {
+    readonly sessionId?: string;
+    readonly retryable?: boolean;
+    readonly cause?: unknown;
+}
+export declare class SessionStoreError extends Error {
+    readonly code: SessionStoreErrorCode;
+    readonly sessionId?: string;
+    readonly retryable: boolean;
+    readonly cause?: unknown;
+    constructor(code: SessionStoreErrorCode, message: string, opts?: SessionStoreErrorOptions);
+}
+/** Type guard that survives serialization across HTTP / IPC boundaries. */
+export declare function isSessionStoreError(e: unknown): e is SessionStoreError;
+//# sourceMappingURL=session-store-errors.d.ts.map

package/dist/ports/session-store-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store-errors.d.ts","sourceRoot":"","sources":["../../src/ports/session-store-errors.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,MAAM,MAAM,qBAAqB,GAC7B,WAAW,GACX,WAAW,GACX,QAAQ,GACR,eAAe,GACf,qBAAqB,GACrB,sBAAsB,GACtB,gBAAgB,GAChB,qBAAqB,GACrB,kBAAkB,GAClB,UAAU,CAAC;AAEf,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEb,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,wBAA6B;CAQ9F;AAED,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,iBAAiB,CAItE"}

package/dist/ports/session-store-errors.js

@@ -0,0 +1,29 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * SessionStore error taxonomy — PRD-061 / S4 §4.4.
+ *
+ * Discriminated by `code`. The union MUST stay exhaustive so adapter
+ * implementations fail closed on unknown conditions.
+ */
+export class SessionStoreError extends Error {
+    code;
+    sessionId;
+    retryable;
+    cause;
+    constructor(code, message, opts = {}) {
+        super(message);
+        this.name = 'SessionStoreError';
+        this.code = code;
+        this.sessionId = opts.sessionId;
+        this.retryable = opts.retryable ?? (code === 'BACKEND_UNAVAILABLE');
+        this.cause = opts.cause;
+    }
+}
+/** Type guard that survives serialization across HTTP / IPC boundaries. */
+export function isSessionStoreError(e) {
+    if (!e || typeof e !== 'object')
+        return false;
+    const candidate = e;
+    return candidate.name === 'SessionStoreError' && typeof candidate.code === 'string';
+}
+//# sourceMappingURL=session-store-errors.js.map

package/dist/ports/session-store-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store-errors.js","sourceRoot":"","sources":["../../src/ports/session-store-errors.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC;;;;;GAKG;AAoBH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,IAAI,CAAwB;IAC5B,SAAS,CAAU;IACnB,SAAS,CAAU;IACnB,KAAK,CAAW;IAEzB,YAAY,IAA2B,EAAE,OAAe,EAAE,OAAiC,EAAE;QAC3F,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,KAAK,qBAAqB,CAAC,CAAC;QACpE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1B,CAAC;CACF;AAED,2EAA2E;AAC3E,MAAM,UAAU,mBAAmB,CAAC,CAAU;IAC5C,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9C,MAAM,SAAS,GAAG,CAAuC,CAAC;IAC1D,OAAO,SAAS,CAAC,IAAI,KAAK,mBAAmB,IAAI,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ,CAAC;AACtF,CAAC"}