@methodts/runtime 0.1.0

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

@@ -0,0 +1,132 @@
+/**
+ * SessionStore + Checkpoint type definitions — PRD-061 / S4 §4.3.
+ *
+ * Owner: @methodts/runtime
+ * Frozen: 2026-04-14 (FCD surface `fcd-surface-session-store`)
+ *
+ * These types flow across the port interface and are serialized to every
+ * backing store. They MUST remain backend-neutral: no Mongo / BSON / file
+ * handle types are permitted to appear in these signatures (gate
+ * G-SESSIONSTORE-PORT-PURITY).
+ */
+export type SessionStatus = 'initializing' | 'running' | 'idle' | 'paused' | 'suspended' | 'completed' | 'failed' | 'dead';
+/** Opaque reference to the pact that produced this session. */
+export interface PactRef {
+    readonly id: string;
+    readonly version: string;
+    /** Hash of the resolved pact document — detects drift on resume. */
+    readonly fingerprint: string;
+}
+/**
+ * The canonical session-state envelope persisted by every SessionStore.
+ *
+ * Envelope version is frozen at 1 in v1 of the surface. Unknown schema
+ * versions MUST be rejected with `SCHEMA_INCOMPATIBLE` — silent coercion is
+ * explicitly forbidden.
+ */
+export interface SessionSnapshot {
+    readonly schemaVersion: 1;
+    readonly sessionId: string;
+    /** Stable scope id — appId in Cortex, workdir path in bridge. */
+    readonly scopeId: string;
+    readonly pactRef: PactRef;
+    readonly status: SessionStatus;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    /** Sequence of the latest appended checkpoint, or null if none. */
+    readonly latestCheckpointSequence: number | null;
+    readonly nickname?: string;
+    readonly parentSessionId?: string;
+    readonly depth: number;
+    /** Free-form per-adapter metadata — opaque to consumers. */
+    readonly metadata?: Record<string, unknown>;
+}
+/** Cursor into the bus event stream. */
+export interface EventCursor {
+    readonly sequence: number;
+    readonly id: string;
+}
+/**
+ * Opaque blob from the agent's perspective. The adapter stores it; the
+ * runtime parses it. Large blobs (>16KB recommended threshold) should be
+ * written to an external blob ref.
+ */
+export type AgentStateBlob = {
+    readonly kind: 'inline';
+    readonly data: Record<string, unknown>;
+} | {
+    readonly kind: 'blob-ref';
+    readonly ref: string;
+    readonly sizeBytes: number;
+};
+/** Durable reservation handle for an active LLM budget. */
+export interface BudgetReservation {
+    readonly handle: string;
+    readonly expiresAt: string;
+    readonly amount: {
+        readonly usd: number;
+        readonly tokens: number;
+    };
+    /** Issuer tag — 'ctx.llm' | 'bridge/cost-governor' | ... */
+    readonly issuer: string;
+}
+/** Advisory hint for what the runtime should do on resume. */
+export type NextAction = {
+    readonly kind: 'await-prompt';
+} | {
+    readonly kind: 'continue-turn';
+    readonly pendingToolCalls?: readonly string[];
+} | {
+    readonly kind: 'await-human-approval';
+    readonly gateId: string;
+} | {
+    readonly kind: 'await-schedule';
+    readonly wakeAt: string;
+} | {
+    readonly kind: 'terminal';
+    readonly status: SessionStatus;
+};
+/** One durable checkpoint. Append-only, monotonic per session. */
+export interface Checkpoint {
+    readonly schemaVersion: 1;
+    readonly sequence: number;
+    readonly sessionId: string;
+    readonly createdAt: string;
+    readonly eventCursor: EventCursor;
+    readonly agentState: AgentStateBlob;
+    readonly pendingBudget: BudgetReservation | null;
+    readonly nextAction: NextAction;
+    readonly note?: string;
+}
+/** Lightweight checkpoint projection for listing. */
+export interface CheckpointMeta {
+    readonly sequence: number;
+    readonly createdAt: string;
+    readonly note?: string;
+    readonly nextAction: NextAction;
+}
+/** Options accepted by `SessionStore.resume`. */
+export interface ResumeOptions {
+    /** Requested lease TTL in ms. Store may clamp. Default 30_000. */
+    readonly leaseTtlMs?: number;
+    /** If true, require the pact fingerprint to match. Default true. */
+    readonly requireFingerprint?: boolean;
+    /** Optional fingerprint to match against `snapshot.pactRef.fingerprint`. */
+    readonly expectedFingerprint?: string;
+}
+/** Result of a successful `resume()` call. */
+export interface ResumeContext {
+    readonly snapshot: SessionSnapshot;
+    readonly checkpoint: Checkpoint | null;
+    readonly fencingToken: string;
+    readonly leaseExpiresAt: string;
+    /**
+     * Populated only if the adapter was wired with an EventReader.
+     * Callers without a reader should coordinate replay themselves.
+     */
+    readonly replayHint?: {
+        readonly fromSequence: number;
+        readonly fromEventId: string;
+    };
+}
+//# sourceMappingURL=session-store-types.d.ts.map

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

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

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

@@ -0,0 +1,14 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * SessionStore + Checkpoint type definitions — PRD-061 / S4 §4.3.
+ *
+ * Owner: @methodts/runtime
+ * Frozen: 2026-04-14 (FCD surface `fcd-surface-session-store`)
+ *
+ * These types flow across the port interface and are serialized to every
+ * backing store. They MUST remain backend-neutral: no Mongo / BSON / file
+ * handle types are permitted to appear in these signatures (gate
+ * G-SESSIONSTORE-PORT-PURITY).
+ */
+export {};
+//# sourceMappingURL=session-store-types.js.map

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

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

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

@@ -0,0 +1,69 @@
+/**
+ * SessionStore — persistence port for agent sessions and checkpoints.
+ *
+ * Owner: @methodts/runtime
+ * Consumers: @methodts/pacta (ResumableMode), @methodts/methodts (strategy executor),
+ *            @methodts/bridge (sessions + strategies domains), @methodts/agent-runtime
+ * Producers: FsSessionStore (bridge JSONL+FS), CortexSessionStore (ctx.storage)
+ * Direction: runtime ↔ adapter (CRUD + lease)
+ * Co-designed: 2026-04-14 (FCD surface session `fcd-surface-session-store`)
+ * PRD: .method/sessions/fcd-design-prd-061-session-store/prd.md
+ *
+ * Contract invariants:
+ *   I-1  load(sessionId) is idempotent; it never mutates state.
+ *   I-2  resume(sessionId, workerId) acquires a lease; concurrent callers receive
+ *        FENCED from that point until the lease expires or is released.
+ *   I-3  appendCheckpoint rejects stale fencing tokens with FENCED.
+ *   I-4  Checkpoints for a given session are totally ordered by `sequence`.
+ *   I-5  The store never blocks emit of bus events — CheckpointSink is async.
+ *   I-6  Implementations must not leak backend-specific types through this port.
+ */
+import type { Checkpoint, CheckpointMeta, ResumeContext, ResumeOptions, SessionSnapshot, SessionStatus } from './session-store-types.js';
+export interface SessionStore {
+    /** Create a new session record. Throws DUPLICATE if sessionId exists. */
+    create(snapshot: SessionSnapshot): Promise<void>;
+    /** Load the latest snapshot or null. Pure read; no lease. */
+    load(sessionId: string): Promise<SessionSnapshot | null>;
+    /**
+     * Resume a session. Atomically:
+     *   (1) loads the latest snapshot + latest checkpoint,
+     *   (2) acquires a lease owned by `workerId`,
+     *   (3) returns a ResumeContext carrying a fencingToken.
+     *
+     * If a live lease is held by a different worker: `SessionStoreError{ FENCED }`.
+     * If the caller's lease is still valid (same workerId), the existing token is
+     * returned (idempotent re-fetch — invariant for G-RESUME-IDEMPOTENT).
+     */
+    resume(sessionId: string, workerId: string, opts?: ResumeOptions): Promise<ResumeContext>;
+    /** Release a lease early. Idempotent. */
+    releaseLease(sessionId: string, fencingToken: string): Promise<void>;
+    /**
+     * Renew a lease before it expires. Throws FENCED if stolen.
+     * Returns the new expiry timestamp.
+     */
+    renewLease(sessionId: string, fencingToken: string, ttlMs?: number): Promise<string>;
+    /**
+     * Append a new checkpoint. Must carry a valid fencingToken from an
+     * active lease held by this worker. Rejects stale tokens with FENCED.
+     * Updates the snapshot's `latestCheckpointSequence` atomically.
+     */
+    appendCheckpoint(sessionId: string, checkpoint: Checkpoint, fencingToken: string): Promise<void>;
+    /** Load a specific checkpoint or null. */
+    loadCheckpoint(sessionId: string, sequence: number): Promise<Checkpoint | null>;
+    /** Load the latest checkpoint or null. */
+    loadLatestCheckpoint(sessionId: string): Promise<Checkpoint | null>;
+    /**
+     * List checkpoints for a session (most-recent first).
+     * Bounded by `limit`; default 10.
+     */
+    listCheckpoints(sessionId: string, limit?: number): Promise<CheckpointMeta[]>;
+    /**
+     * Mark a session terminal. Sets status, persists the final snapshot,
+     * releases any held lease. Checkpoint ring is retained per the store's
+     * retention policy.
+     */
+    finalize(sessionId: string, status: SessionStatus, reason?: string): Promise<void>;
+    /** Remove a session and all its checkpoints. Irreversible. */
+    destroy(sessionId: string): Promise<void>;
+}
+//# sourceMappingURL=session-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../src/ports/session-store.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACb,eAAe,EACf,aAAa,EACd,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,YAAY;IAG3B,yEAAyE;IACzE,MAAM,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD,6DAA6D;IAC7D,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAEzD;;;;;;;;;OASG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAE1F,yCAAyC;IACzC,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErE;;;OAGG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAIrF;;;;OAIG;IACH,gBAAgB,CACd,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB,0CAA0C;IAC1C,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAEhF,0CAA0C;IAC1C,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAEpE;;;OAGG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAI9E;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnF,8DAA8D;IAC9D,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C"}

package/dist/ports/session-store.js

@@ -0,0 +1,23 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * SessionStore — persistence port for agent sessions and checkpoints.
+ *
+ * Owner: @methodts/runtime
+ * Consumers: @methodts/pacta (ResumableMode), @methodts/methodts (strategy executor),
+ *            @methodts/bridge (sessions + strategies domains), @methodts/agent-runtime
+ * Producers: FsSessionStore (bridge JSONL+FS), CortexSessionStore (ctx.storage)
+ * Direction: runtime ↔ adapter (CRUD + lease)
+ * Co-designed: 2026-04-14 (FCD surface session `fcd-surface-session-store`)
+ * PRD: .method/sessions/fcd-design-prd-061-session-store/prd.md
+ *
+ * Contract invariants:
+ *   I-1  load(sessionId) is idempotent; it never mutates state.
+ *   I-2  resume(sessionId, workerId) acquires a lease; concurrent callers receive
+ *        FENCED from that point until the lease expires or is released.
+ *   I-3  appendCheckpoint rejects stale fencing tokens with FENCED.
+ *   I-4  Checkpoints for a given session are totally ordered by `sequence`.
+ *   I-5  The store never blocks emit of bus events — CheckpointSink is async.
+ *   I-6  Implementations must not leak backend-specific types through this port.
+ */
+export {};
+//# sourceMappingURL=session-store.js.map

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

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

package/dist/ports/yaml-loader.d.ts

@@ -0,0 +1,15 @@
+/**
+ * YamlLoader — Port interface for YAML parse/dump.
+ *
+ * PRD-057 / S2 §5.3: Only the interface lives in runtime. The js-yaml
+ * adapter (`JsYamlLoader`) stays in bridge.
+ *
+ * Note: Runtime itself may still depend on js-yaml as a utility (parser is
+ * transport-free) — what stays in bridge is the **adapter** that implements
+ * this port surface.
+ */
+export interface YamlLoader {
+    load(content: string): unknown;
+    dump(value: unknown): string;
+}
+//# sourceMappingURL=yaml-loader.d.ts.map

package/dist/ports/yaml-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-loader.d.ts","sourceRoot":"","sources":["../../src/ports/yaml-loader.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AAIH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;CAC9B"}

package/dist/ports/yaml-loader.js

@@ -0,0 +1,13 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * YamlLoader — Port interface for YAML parse/dump.
+ *
+ * PRD-057 / S2 §5.3: Only the interface lives in runtime. The js-yaml
+ * adapter (`JsYamlLoader`) stays in bridge.
+ *
+ * Note: Runtime itself may still depend on js-yaml as a utility (parser is
+ * transport-free) — what stays in bridge is the **adapter** that implements
+ * this port surface.
+ */
+export {};
+//# sourceMappingURL=yaml-loader.js.map

package/dist/ports/yaml-loader.js.map

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

package/dist/scheduling/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @methodts/runtime/scheduling — PRD-062 / S5.
+ */
+export { ScheduledPact, isScheduledPactPayload, } from './scheduled-pact.js';
+export type { ScheduleOptions, ScheduledPactPayload, ScheduleBindOptions, } from './scheduled-pact.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/scheduling/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scheduling/index.ts"],"names":[],"mappings":"AACA;;GAEG;AAEH,OAAO,EACL,aAAa,EACb,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC"}

package/dist/scheduling/index.js

@@ -0,0 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * @methodts/runtime/scheduling — PRD-062 / S5.
+ */
+export { ScheduledPact, isScheduledPactPayload, } from './scheduled-pact.js';
+//# sourceMappingURL=index.js.map

package/dist/scheduling/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scheduling/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC;;GAEG;AAEH,OAAO,EACL,aAAa,EACb,sBAAsB,GACvB,MAAM,qBAAqB,CAAC"}

package/dist/scheduling/scheduled-pact.d.ts

@@ -0,0 +1,97 @@
+/**
+ * ScheduledPact — binds a Cortex-app `schedules[]` entry to a pact factory.
+ *
+ * PRD-062 / S5 §2.3. Frozen: 2026-04-14.
+ *
+ * Two usage modes:
+ *
+ * Declarative (preferred for Wave 1):
+ *   ```
+ *   cortexApp({
+ *     schedules: [{
+ *       name: 'daily-twin-report',
+ *       cron: '0 9 * * MON-FRI',
+ *       job: 'method.pact.continue',
+ *       payload: ScheduledPact.payload('daily-twin-report', {
+ *         initialContext: { twinId: 'franco' },
+ *         budgetStrategy: 'fresh-per-continuation',
+ *         perTickBudgetUsd: 2.0,
+ *       }),
+ *     }],
+ *   });
+ *   ```
+ *
+ * Imperative:
+ *   ```
+ *   await ScheduledPact.bind(ctx.schedule, {
+ *     name: 'incident-sla-check',
+ *     cron: '* /15 * * * *',
+ *     pactKey: 'incident-sla-check',
+ *   });
+ *   ```
+ *
+ * The helper's `bind`/`unbind` static methods operate on a `ScheduleClient`
+ * port (S5 §2.3). They never import from `@cortex/infra` or
+ * `EventBridgeScheduler` — gate `G-BOUNDARY`.
+ */
+import type { BudgetCarryStrategy } from '../ports/continuation-envelope.js';
+import type { ScheduleClient } from '../ports/schedule-client.js';
+/**
+ * Options passed into `ScheduledPact.payload()`. All optional; defaults
+ * documented per field.
+ */
+export interface ScheduleOptions {
+    /** Input context passed to the pact factory on each tick. */
+    initialContext?: Record<string, unknown>;
+    /** Per-tick budget cap (USD). Overrides pact default. */
+    perTickBudgetUsd?: number;
+    /** Budget strategy for this scheduled pact. Default `fresh-per-continuation`. */
+    budgetStrategy?: BudgetCarryStrategy;
+}
+/**
+ * The JSON payload a Cortex schedule entry carries to instantiate the
+ * named pact on tick. Opaque to Cortex; parsed by the runtime handler.
+ *
+ * The `kind: 'scheduled-pact-tick'` discriminator lets the single
+ * `method.pact.continue` handler distinguish synthetic schedule starts
+ * from real continuation envelopes.
+ */
+export interface ScheduledPactPayload {
+    kind: 'scheduled-pact-tick';
+    pactKey: string;
+    initialContext: Record<string, unknown>;
+    budgetStrategy: BudgetCarryStrategy;
+    perTickBudgetUsd?: number;
+}
+export interface ScheduleBindOptions {
+    name: string;
+    cron: string;
+    pactKey: string;
+    options?: ScheduleOptions;
+}
+/**
+ * ScheduledPact — static helper. Not constructible; used as a namespace.
+ */
+export declare const ScheduledPact: {
+    /**
+     * Build the JSON payload a Cortex schedule entry must carry to instantiate
+     * the named pact on tick. Opaque to Cortex; parsed by the runtime handler.
+     */
+    readonly payload: (pactKey: string, options?: ScheduleOptions) => ScheduledPactPayload;
+    /**
+     * Register the schedule at runtime against `ctx.schedule`. Useful for
+     * pacts created/destroyed based on runtime state (e.g. user-configured
+     * schedules in the Twin UI). Returns the schedule name for later
+     * `unbind`.
+     */
+    readonly bind: (schedules: ScheduleClient, options: ScheduleBindOptions) => Promise<string>;
+    /** Unbind a previously registered schedule. Idempotent. */
+    readonly unbind: (schedules: ScheduleClient, name: string) => Promise<void>;
+};
+/**
+ * Type guard — narrows an unknown payload to `ScheduledPactPayload`.
+ * Used by the continuation handler to distinguish schedule ticks from
+ * regular continuation envelopes.
+ */
+export declare function isScheduledPactPayload(payload: unknown): payload is ScheduledPactPayload;
+//# sourceMappingURL=scheduled-pact.d.ts.map

package/dist/scheduling/scheduled-pact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-pact.d.ts","sourceRoot":"","sources":["../../src/scheduling/scheduled-pact.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,yDAAyD;IACzD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iFAAiF;IACjF,cAAc,CAAC,EAAE,mBAAmB,CAAC;CACtC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,cAAc,EAAE,mBAAmB,CAAC;IACpC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB;;;OAGG;gCACc,MAAM,YAAY,eAAe,KAAG,oBAAoB;IAazE;;;;;OAKG;+BACmB,cAAc,WAAW,mBAAmB,KAAG,OAAO,CAAC,MAAM,CAAC;IAUpF,2DAA2D;iCACnC,cAAc,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;CAG5D,CAAC;AAEX;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,oBAAoB,CAIxF"}

package/dist/scheduling/scheduled-pact.js

@@ -0,0 +1,89 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * ScheduledPact — binds a Cortex-app `schedules[]` entry to a pact factory.
+ *
+ * PRD-062 / S5 §2.3. Frozen: 2026-04-14.
+ *
+ * Two usage modes:
+ *
+ * Declarative (preferred for Wave 1):
+ *   ```
+ *   cortexApp({
+ *     schedules: [{
+ *       name: 'daily-twin-report',
+ *       cron: '0 9 * * MON-FRI',
+ *       job: 'method.pact.continue',
+ *       payload: ScheduledPact.payload('daily-twin-report', {
+ *         initialContext: { twinId: 'franco' },
+ *         budgetStrategy: 'fresh-per-continuation',
+ *         perTickBudgetUsd: 2.0,
+ *       }),
+ *     }],
+ *   });
+ *   ```
+ *
+ * Imperative:
+ *   ```
+ *   await ScheduledPact.bind(ctx.schedule, {
+ *     name: 'incident-sla-check',
+ *     cron: '* /15 * * * *',
+ *     pactKey: 'incident-sla-check',
+ *   });
+ *   ```
+ *
+ * The helper's `bind`/`unbind` static methods operate on a `ScheduleClient`
+ * port (S5 §2.3). They never import from `@cortex/infra` or
+ * `EventBridgeScheduler` — gate `G-BOUNDARY`.
+ */
+/**
+ * ScheduledPact — static helper. Not constructible; used as a namespace.
+ */
+export const ScheduledPact = {
+    /**
+     * Build the JSON payload a Cortex schedule entry must carry to instantiate
+     * the named pact on tick. Opaque to Cortex; parsed by the runtime handler.
+     */
+    payload(pactKey, options) {
+        const payload = {
+            kind: 'scheduled-pact-tick',
+            pactKey,
+            initialContext: options?.initialContext ?? {},
+            budgetStrategy: options?.budgetStrategy ?? 'fresh-per-continuation',
+        };
+        if (options?.perTickBudgetUsd !== undefined) {
+            payload.perTickBudgetUsd = options.perTickBudgetUsd;
+        }
+        return payload;
+    },
+    /**
+     * Register the schedule at runtime against `ctx.schedule`. Useful for
+     * pacts created/destroyed based on runtime state (e.g. user-configured
+     * schedules in the Twin UI). Returns the schedule name for later
+     * `unbind`.
+     */
+    async bind(schedules, options) {
+        const payload = ScheduledPact.payload(options.pactKey, options.options);
+        await schedules.create(options.name, {
+            cron: options.cron,
+            job: 'method.pact.continue',
+            payload,
+        });
+        return options.name;
+    },
+    /** Unbind a previously registered schedule. Idempotent. */
+    async unbind(schedules, name) {
+        await schedules.delete(name);
+    },
+};
+/**
+ * Type guard — narrows an unknown payload to `ScheduledPactPayload`.
+ * Used by the continuation handler to distinguish schedule ticks from
+ * regular continuation envelopes.
+ */
+export function isScheduledPactPayload(payload) {
+    if (!payload || typeof payload !== 'object')
+        return false;
+    const p = payload;
+    return p.kind === 'scheduled-pact-tick' && typeof p.pactKey === 'string';
+}
+//# sourceMappingURL=scheduled-pact.js.map

package/dist/scheduling/scheduled-pact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-pact.js","sourceRoot":"","sources":["../../src/scheduling/scheduled-pact.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAyCH;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B;;;OAGG;IACH,OAAO,CAAC,OAAe,EAAE,OAAyB;QAChD,MAAM,OAAO,GAAyB;YACpC,IAAI,EAAE,qBAAqB;YAC3B,OAAO;YACP,cAAc,EAAE,OAAO,EAAE,cAAc,IAAI,EAAE;YAC7C,cAAc,EAAE,OAAO,EAAE,cAAc,IAAI,wBAAwB;SACpE,CAAC;QACF,IAAI,OAAO,EAAE,gBAAgB,KAAK,SAAS,EAAE,CAAC;YAC5C,OAAO,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;QACtD,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,SAAyB,EAAE,OAA4B;QAChE,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACxE,MAAM,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE;YACnC,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,GAAG,EAAE,sBAAsB;YAC3B,OAAO;SACR,CAAC,CAAC;QACH,OAAO,OAAO,CAAC,IAAI,CAAC;IACtB,CAAC;IAED,2DAA2D;IAC3D,KAAK,CAAC,MAAM,CAAC,SAAyB,EAAE,IAAY;QAClD,MAAM,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;CACO,CAAC;AAEX;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1D,MAAM,CAAC,GAAG,OAAgD,CAAC;IAC3D,OAAO,CAAC,CAAC,IAAI,KAAK,qBAAqB,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC;AAC3E,CAAC"}

package/dist/sessions/__tests__/cognitive-modules.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Tests for cognitive-modules.ts — BridgeReasonerActorModule and BridgeMonitorModule.
+ *
+ * PRD 042 Phase 1-4: CognitiveModule implementations extracted from the
+ * monolithic cognitive-provider.ts inline loop, plus manual composition integration.
+ *
+ * 12 test scenarios covering AC-1 through AC-7 and AC-11.
+ */
+export {};
+//# sourceMappingURL=cognitive-modules.test.d.ts.map

package/dist/sessions/__tests__/cognitive-modules.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cognitive-modules.test.d.ts","sourceRoot":"","sources":["../../../src/sessions/__tests__/cognitive-modules.test.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG"}