@cleocode/core 2026.3.42 → 2026.3.44

package/dist/sessions/session-cleanup.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Remove orphaned sessions and clean up stale data.
+ *
+ * @task T4782
+ * @task T2304
+ * @epic T4654
+ */
+/**
+ * Remove orphaned sessions, auto-end stale active sessions, and clean up stale data.
+ *
+ * Stale active sessions (no activity beyond the configured threshold) are
+ * transitioned to 'ended' with an auto-end note. The threshold is read from
+ * `retention.autoEndActiveAfterDays` in the project config (default: 7 days).
+ *
+ * @task T2304
+ */
+export declare function cleanupSessions(projectRoot: string): Promise<{
+    removed: string[];
+    autoEnded: string[];
+    cleaned: boolean;
+}>;
+//# sourceMappingURL=session-cleanup.d.ts.map

package/dist/sessions/session-cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-cleanup.d.ts","sourceRoot":"","sources":["../../src/sessions/session-cleanup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CA6CvE"}

package/dist/sessions/session-drift.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Compute context drift score for a session.
+ *
+ * @task T4782
+ * @epic T4654
+ */
+export interface ContextDriftResult {
+    score: number;
+    factors: string[];
+    completedInScope: number;
+    totalInScope: number;
+    outOfScope: number;
+}
+/**
+ * Compute context drift score for the current session.
+ * Compares session progress against original scope by counting
+ * completed vs total tasks in scope, and detecting out-of-scope work.
+ */
+export declare function getContextDrift(projectRoot: string, params?: {
+    sessionId?: string;
+}): Promise<ContextDriftResult>;
+//# sourceMappingURL=session-drift.d.ts.map

package/dist/sessions/session-drift.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-drift.d.ts","sourceRoot":"","sources":["../../src/sessions/session-drift.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAqBD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CA+G7B"}

package/dist/sessions/session-enforcement.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Session enforcement - require active sessions for write operations.
+ *
+ * Part of the Epic-Bound Session architecture. Enforces that write operations
+ * (add, update, complete) require an active session.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+/** Enforcement modes. */
+export type EnforcementMode = 'strict' | 'warn' | 'none';
+/** Get the current enforcement mode. */
+export declare function getEnforcementMode(cwd?: string): EnforcementMode;
+/** Check if session enforcement is enabled. */
+export declare function isSessionEnforcementEnabled(cwd?: string): boolean;
+/** Session info for enforcement checks. */
+export interface ActiveSessionInfo {
+    id: string;
+    name: string;
+    scope: {
+        type: string;
+        epicId?: string;
+    };
+}
+/** Get active session info. Returns null if no active session. */
+export declare function getActiveSessionInfo(cwd?: string): Promise<ActiveSessionInfo | null>;
+/** Enforcement result. */
+export interface EnforcementResult {
+    allowed: boolean;
+    mode: EnforcementMode;
+    session: ActiveSessionInfo | null;
+    warning?: string;
+}
+/**
+ * Require an active session for write operations.
+ * In strict mode, throws if no session is active.
+ * In warn mode, returns a warning but allows the operation.
+ * In none mode, always allows.
+ */
+export declare function requireActiveSession(operation: string, cwd?: string): Promise<EnforcementResult>;
+/**
+ * Validate that a task is within the current session's scope.
+ * Only enforced when a session is active.
+ */
+export declare function validateTaskInScope(taskId: string, taskEpicId?: string, cwd?: string): Promise<{
+    inScope: boolean;
+    warning?: string;
+}>;
+//# sourceMappingURL=session-enforcement.d.ts.map

package/dist/sessions/session-enforcement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-enforcement.d.ts","sourceRoot":"","sources":["../../src/sessions/session-enforcement.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA2BH,yBAAyB;AACzB,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzD,wCAAwC;AACxC,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,eAAe,CAShE;AAED,+CAA+C;AAC/C,wBAAgB,2BAA2B,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C;AAED,kEAAkE;AAClE,wBAAsB,oBAAoB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAS1F;AAED,0BAA0B;AAC1B,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,iBAAiB,CAAC,CAsC5B;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,EACnB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAwCjD"}

package/dist/sessions/session-grade.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Session grading - rubric-based behavioral analysis of agent sessions.
+ *
+ * Reads audit log entries for a session and applies a 5-dimension rubric
+ * to score agent behavior:
+ *   - Session discipline (20pts)
+ *   - Discovery efficiency (20pts)
+ *   - Task hygiene (20pts)
+ *   - Error protocol (20pts)
+ *   - Progressive disclosure use (20pts)
+ *
+ * @task T4916
+ */
+export interface DimensionScore {
+    score: number;
+    max: number;
+    evidence: string[];
+}
+export interface GradeResult {
+    sessionId: string;
+    taskId?: string;
+    totalScore: number;
+    maxScore: number;
+    dimensions: {
+        sessionDiscipline: DimensionScore;
+        discoveryEfficiency: DimensionScore;
+        taskHygiene: DimensionScore;
+        errorProtocol: DimensionScore;
+        disclosureUse: DimensionScore;
+    };
+    flags: string[];
+    timestamp: string;
+    entryCount: number;
+}
+/**
+ * Grade a session by sessionId using the 5-dimension behavioral rubric.
+ */
+export declare function gradeSession(sessionId: string, cwd?: string): Promise<GradeResult>;
+/** Read past grade results from .cleo/metrics/GRADES.jsonl */
+export declare function readGrades(sessionId?: string, cwd?: string): Promise<GradeResult[]>;
+//# sourceMappingURL=session-grade.d.ts.map

package/dist/sessions/session-grade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-grade.d.ts","sourceRoot":"","sources":["../../src/sessions/session-grade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AASH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE;QACV,iBAAiB,EAAE,cAAc,CAAC;QAClC,mBAAmB,EAAE,cAAc,CAAC;QACpC,WAAW,EAAE,cAAc,CAAC;QAC5B,aAAa,EAAE,cAAc,CAAC;QAC9B,aAAa,EAAE,cAAc,CAAC;KAC/B,CAAC;IACF,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAwMxF;AAuED,8DAA8D;AAC9D,wBAAsB,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAczF"}

package/dist/sessions/session-history.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Session history with focus changes and completed tasks.
+ *
+ * @task T4782
+ * @epic T4654
+ */
+export interface SessionHistoryEntry {
+    id: string;
+    name?: string;
+    status: string;
+    startedAt: string;
+    endedAt?: string | null;
+    tasksCompleted: number;
+    focusChanges: number;
+    focusHistory: Array<{
+        taskId: string;
+        timestamp: string;
+    }>;
+}
+export interface SessionHistoryParams {
+    sessionId?: string;
+    limit?: number;
+}
+/**
+ * List session history with focus changes and completed tasks.
+ * If sessionId is provided, returns history for that specific session.
+ * Otherwise, returns history across all sessions.
+ */
+export declare function getSessionHistory(projectRoot: string, params?: SessionHistoryParams): Promise<{
+    sessions: SessionHistoryEntry[];
+}>;
+//# sourceMappingURL=session-history.d.ts.map

package/dist/sessions/session-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-history.d.ts","sourceRoot":"","sources":["../../src/sessions/session-history.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC;IAAE,QAAQ,EAAE,mBAAmB,EAAE,CAAA;CAAE,CAAC,CAqC9C"}

package/dist/sessions/session-id.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Canonical session ID generation and validation.
+ *
+ * Canonical format: ses_{YYYYMMDDHHmmss}_{6hex}
+ *   - Human-readable, sortable by timestamp
+ *   - 6 hex bytes of randomness avoids collisions
+ *
+ * Legacy formats remain valid for backward compat:
+ *   - session-{epoch}-{hex}         (v1: from core/sessions/index.ts)
+ *   - session_{YYYYMMDD}_{HHmmss}_{hex} (v2: from dispatch/engines/session-engine.ts)
+ *
+ * @epic T4959
+ */
+/**
+ * Generate a canonical session ID.
+ *
+ * Format: ses_{YYYYMMDDHHmmss}_{6hex}
+ * Example: ses_20260227171900_a1b2c3
+ */
+export declare function generateSessionId(): string;
+/**
+ * Check if a string is a valid session ID (any format).
+ */
+export declare function isValidSessionId(id: string): boolean;
+/**
+ * Check if a session ID uses the canonical format.
+ */
+export declare function isCanonicalSessionId(id: string): boolean;
+/**
+ * Extract an approximate timestamp from any valid session ID format.
+ * Returns null if the ID format is not recognized.
+ */
+export declare function extractSessionTimestamp(id: string): Date | null;
+//# sourceMappingURL=session-id.d.ts.map

package/dist/sessions/session-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-id.d.ts","sourceRoot":"","sources":["../../src/sessions/session-id.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAK1C;AAWD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAsB/D"}

package/dist/sessions/session-memory-bridge.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Memory-session bridge — records session summaries as brain observations.
+ *
+ * Hooks into the session end flow to persist a summary of the session's
+ * work (tasks completed, scope, duration) into brain.db as an observation.
+ * This is best-effort: failures do not affect the session end operation.
+ *
+ * @task T5392
+ * @epic T5149
+ */
+/** Session data needed to create a memory bridge observation. */
+export interface SessionBridgeData {
+    sessionId: string;
+    scope: string;
+    tasksCompleted: string[];
+    duration: number;
+}
+/**
+ * Bridge session end data to brain.db as an observation.
+ *
+ * Builds a summary text from the session metadata and saves it
+ * as a 'change' observation with source_type 'agent'.
+ *
+ * @param projectRoot - Project root directory for brain.db resolution
+ * @param sessionData - Session metadata to record
+ */
+export declare function bridgeSessionToMemory(projectRoot: string, sessionData: SessionBridgeData): Promise<void>;
+//# sourceMappingURL=session-memory-bridge.d.ts.map

package/dist/sessions/session-memory-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-memory-bridge.d.ts","sourceRoot":"","sources":["../../src/sessions/session-memory-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,iBAAiB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAmCf"}

package/dist/sessions/session-show.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Show a specific session by ID.
+ *
+ * @task T4782
+ * @epic T4654
+ */
+import type { Session } from '@cleocode/contracts';
+/**
+ * Show a specific session.
+ * Looks in active sessions first, then session history.
+ * Throws CleoError if not found.
+ */
+export declare function showSession(projectRoot: string, sessionId: string): Promise<Session>;
+//# sourceMappingURL=session-show.d.ts.map

package/dist/sessions/session-show.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-show.d.ts","sourceRoot":"","sources":["../../src/sessions/session-show.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAKnD;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAU1F"}

package/dist/sessions/session-stats.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Compute session statistics.
+ *
+ * @task T4782
+ * @epic T4654
+ */
+export interface SessionStatsResult {
+    totalSessions: number;
+    activeSessions: number;
+    suspendedSessions: number;
+    endedSessions: number;
+    archivedSessions: number;
+    totalTasksCompleted: number;
+    totalFocusChanges: number;
+    averageResumeCount: number;
+    session?: {
+        id: string;
+        status: string;
+        tasksCompleted: number;
+        focusChanges: number;
+        resumeCount: number;
+        durationMinutes: number;
+    };
+}
+/**
+ * Compute session statistics, optionally for a specific session.
+ * Throws CleoError if a specific session is requested but not found.
+ */
+export declare function getSessionStats(projectRoot: string, sessionId?: string): Promise<SessionStatsResult>;
+//# sourceMappingURL=session-stats.d.ts.map

package/dist/sessions/session-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-stats.d.ts","sourceRoot":"","sources":["../../src/sessions/session-stats.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE;QACR,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,CAAC,CAqE7B"}

package/dist/sessions/session-suspend.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Suspend an active session.
+ *
+ * @task T4782
+ * @epic T4654
+ */
+import type { Session } from '@cleocode/contracts';
+/**
+ * Suspend an active session.
+ * Sets status to 'suspended' and records the reason.
+ * Throws if session not found or not active.
+ */
+export declare function suspendSession(projectRoot: string, sessionId: string, reason?: string): Promise<Session>;
+//# sourceMappingURL=session-suspend.d.ts.map

package/dist/sessions/session-suspend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-suspend.d.ts","sourceRoot":"","sources":["../../src/sessions/session-suspend.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAKnD;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAmClB"}

package/dist/sessions/session-switch.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Switch to a different session.
+ *
+ * @task T4782
+ * @epic T4654
+ */
+import type { Session } from '@cleocode/contracts';
+/**
+ * Switch to a different session.
+ * Suspends the current active session and activates the target.
+ * Throws if session not found or archived.
+ */
+export declare function switchSession(projectRoot: string, sessionId: string): Promise<Session>;
+//# sourceMappingURL=session-switch.d.ts.map

package/dist/sessions/session-switch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-switch.d.ts","sourceRoot":"","sources":["../../src/sessions/session-switch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,qBAAqB,CAAC;AAKlE;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAiD5F"}

package/dist/sessions/session-view.d.ts

@@ -0,0 +1,41 @@
+/**
+ * SessionView — typed wrapper over Session[] with collection helpers.
+ *
+ * Provides discoverable query methods for common session lookups.
+ * Does NOT change the DataAccessor interface — consumers create views from Session[].
+ *
+ * Usage:
+ *   const sessions = await accessor.loadSessions();
+ *   const view = SessionView.from(sessions);
+ *   const active = view.findActive();
+ *
+ * @epic T4454
+ */
+import type { Session, SessionStatus } from '@cleocode/contracts';
+export declare class SessionView {
+    private readonly _sessions;
+    constructor(sessions: Session[]);
+    /** Create a SessionView from a Session array. */
+    static from(sessions: Session[]): SessionView;
+    /** All sessions in the view (readonly). */
+    get all(): readonly Session[];
+    /** Number of sessions. */
+    get length(): number;
+    /** Find the currently active session (if any). */
+    findActive(): Session | undefined;
+    /** Find a session by ID. */
+    findById(id: string): Session | undefined;
+    /** Filter sessions by one or more statuses. */
+    filterByStatus(...statuses: SessionStatus[]): Session[];
+    /** Find sessions matching a scope type and optional rootTaskId. */
+    findByScope(type: string, rootTaskId?: string): Session[];
+    /** Sort sessions by a date field. Returns a new array (does not mutate). */
+    sortByDate(field: 'startedAt' | 'endedAt', descending?: boolean): Session[];
+    /** Get the most recently started session. */
+    mostRecent(): Session | undefined;
+    /** Convert back to a plain Session array (shallow copy). */
+    toArray(): Session[];
+    /** Support for-of iteration. */
+    [Symbol.iterator](): Iterator<Session>;
+}
+//# sourceMappingURL=session-view.d.ts.map

package/dist/sessions/session-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-view.d.ts","sourceRoot":"","sources":["../../src/sessions/session-view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAElE,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAE1B,QAAQ,EAAE,OAAO,EAAE;IAI/B,iDAAiD;IACjD,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,WAAW;IAI7C,2CAA2C;IAC3C,IAAI,GAAG,IAAI,SAAS,OAAO,EAAE,CAE5B;IAED,0BAA0B;IAC1B,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,kDAAkD;IAClD,UAAU,IAAI,OAAO,GAAG,SAAS;IAIjC,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIzC,+CAA+C;IAC/C,cAAc,CAAC,GAAG,QAAQ,EAAE,aAAa,EAAE,GAAG,OAAO,EAAE;IAIvD,mEAAmE;IACnE,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE;IAQzD,4EAA4E;IAC5E,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,EAAE,UAAU,UAAO,GAAG,OAAO,EAAE;IAQxE,6CAA6C;IAC7C,UAAU,IAAI,OAAO,GAAG,SAAS;IAKjC,4DAA4D;IAC5D,OAAO,IAAI,OAAO,EAAE;IAIpB,gCAAgC;IAChC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC;CAGvC"}

package/dist/sessions/statusline-setup.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Statusline setup helper - Claude Code status line integration.
+ *
+ * Checks and configures Claude Code status line for context monitoring.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+/** Statusline integration status. */
+export type StatuslineStatus = 'configured' | 'not_configured' | 'custom_no_cleo' | 'no_settings';
+/**
+ * Check if statusline integration is configured.
+ * Returns the current integration status.
+ */
+export declare function checkStatuslineIntegration(): StatuslineStatus;
+/**
+ * Get the statusline setup command for Claude Code settings.
+ */
+export declare function getStatuslineConfig(): Record<string, unknown>;
+/**
+ * Get human-readable setup instructions.
+ */
+export declare function getSetupInstructions(): string;
+//# sourceMappingURL=statusline-setup.d.ts.map

package/dist/sessions/statusline-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusline-setup.d.ts","sourceRoot":"","sources":["../../src/sessions/statusline-setup.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH,qCAAqC;AACrC,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,aAAa,CAAC;AAElG;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,gBAAgB,CAwC7D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAS7D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAW7C"}

package/dist/sessions/types.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Extended session types used by the engine/dispatch layer.
+ *
+ * @task T4782
+ * @epic T4654
+ */
+import type { SessionNote, TaskWorkState } from '@cleocode/contracts';
+/**
+ * Session object (engine-compatible).
+ */
+export interface SessionRecord {
+    id: string;
+    status: 'active' | 'suspended' | 'ended' | 'archived';
+    agentId?: string;
+    name?: string;
+    scope: {
+        type: string;
+        rootTaskId: string;
+        phaseFilter?: string | null;
+        labelFilter?: string[] | null;
+        includeDescendants?: boolean;
+        maxDepth?: number | null;
+        explicitTaskIds?: string[] | null;
+        excludeTaskIds?: string[] | null;
+        computedTaskIds?: string[];
+        computedAt?: string;
+    };
+    focus: {
+        currentTask?: string | null;
+        currentPhase?: string | null;
+        previousTask?: string | null;
+        sessionNote?: string | null;
+        nextAction?: string | null;
+        blockedReason?: string | null;
+        focusHistory?: Array<{
+            taskId: string;
+            timestamp: string;
+        }>;
+    };
+    startedAt: string;
+    lastActivity: string;
+    suspendedAt?: string | null;
+    endedAt?: string | null;
+    archivedAt?: string | null;
+    resumeCount?: number;
+    /** Whether full query+mutation audit logging is enabled (behavioral grading). */
+    gradeMode?: boolean;
+    stats?: {
+        tasksCompleted: number;
+        tasksCreated: number;
+        tasksUpdated: number;
+        focusChanges: number;
+        totalActiveMinutes: number;
+        suspendCount: number;
+    };
+    /** Soft FK to predecessor session. */
+    previousSessionId?: string | null;
+    /** Soft FK to successor session. */
+    nextSessionId?: string | null;
+    /** LLM agent/conversation identifier. */
+    agentIdentifier?: string | null;
+    /** When the successor read this session's handoff/debrief. */
+    handoffConsumedAt?: string | null;
+    /** Who consumed the handoff. */
+    handoffConsumedBy?: string | null;
+    /** Rich debrief data (superset of handoffJson). */
+    debriefJson?: string | null;
+}
+/**
+ * Task work state from the task store.
+ *
+ * Extends the strict contracts {@link TaskWorkState} with required-null
+ * fields for session engine compatibility. The engine layer always expects
+ * these fields to be present (even if null), whereas the contracts type
+ * marks them as optional.
+ */
+export interface TaskWorkStateExt extends TaskWorkState {
+    currentTask: string | null;
+    currentPhase: string | null;
+    blockedUntil: string | null;
+    sessionNote: string | null;
+    sessionNotes: SessionNote[];
+    nextAction: string | null;
+    primarySession: string | null;
+}
+/**
+ * Decision record stored in decisions.jsonl.
+ */
+export interface DecisionRecord {
+    id: string;
+    sessionId: string;
+    taskId: string;
+    decision: string;
+    rationale: string;
+    alternatives: string[];
+    timestamp: string;
+}
+/**
+ * Assumption record stored in assumptions.jsonl.
+ */
+export interface AssumptionRecord {
+    id: string;
+    sessionId: string;
+    taskId: string | null;
+    assumption: string;
+    confidence: 'high' | 'medium' | 'low';
+    validatedAt: string | null;
+    timestamp: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/signaldock/claude-code-transport.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Claude Code transport — provider-specific adapter wrapping the current SendMessage pattern.
+ *
+ * This is the Phase 0 transport that maps the AgentTransport interface onto
+ * Claude Code's native Agent SDK tools (SendMessage, TaskUpdate, etc.).
+ *
+ * It serves as the default transport when SignalDock is not enabled,
+ * preserving backward compatibility with the existing orchestration model.
+ *
+ * @task T5671
+ */
+import type { AgentRegistration, AgentTransport, MessageResult } from './transport.js';
+import type { Agent, AgentClass, Conversation, ConversationVisibility, Message, PrivacyTier } from './types.js';
+/**
+ * Claude Code transport — wraps the current provider-specific messaging.
+ *
+ * Registration and deregistration are no-ops because the Claude Code Agent SDK
+ * manages agent identity internally. Message sending is logged but actual
+ * delivery happens through the SDK's SendMessage tool at the agent level.
+ */
+export declare class ClaudeCodeTransport implements AgentTransport {
+    readonly name = "claude-code";
+    private agents;
+    private conversations;
+    private messages;
+    register(name: string, agentClass: AgentClass, privacyTier: PrivacyTier): Promise<AgentRegistration>;
+    deregister(agentId: string): Promise<void>;
+    send(fromAgentId: string, toAgentId: string, content: string, conversationId?: string): Promise<MessageResult>;
+    poll(agentId: string, since?: string): Promise<Message[]>;
+    heartbeat(agentId: string): Promise<void>;
+    createConversation(participants: string[], visibility?: ConversationVisibility): Promise<Conversation>;
+    getAgent(agentId: string): Promise<Agent | null>;
+}
+//# sourceMappingURL=claude-code-transport.d.ts.map

package/dist/signaldock/claude-code-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code-transport.d.ts","sourceRoot":"","sources":["../../src/signaldock/claude-code-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACvF,OAAO,KAAK,EACV,KAAK,EACL,UAAU,EACV,YAAY,EACZ,sBAAsB,EACtB,OAAO,EACP,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,qBAAa,mBAAoB,YAAW,cAAc;IACxD,QAAQ,CAAC,IAAI,iBAAiB;IAE9B,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,aAAa,CAAmC;IACxD,OAAO,CAAC,QAAQ,CAAiB;IAE3B,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,iBAAiB,CAAC;IAWvB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,aAAa,CAAC;IAyBnB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAQzD,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzC,kBAAkB,CACtB,YAAY,EAAE,MAAM,EAAE,EACtB,UAAU,CAAC,EAAE,sBAAsB,GAClC,OAAO,CAAC,YAAY,CAAC;IAkBlB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;CAevD"}

package/dist/signaldock/factory.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Transport factory — selects the appropriate AgentTransport based on configuration.
+ *
+ * @task T5671
+ */
+import type { AgentTransport } from './transport.js';
+/** Configuration for transport selection. */
+export interface TransportFactoryConfig {
+    enabled: boolean;
+    mode: 'http' | 'native';
+    endpoint: string;
+    agentPrefix: string;
+    privacyTier: 'public' | 'discoverable' | 'private';
+}
+/**
+ * Create an AgentTransport instance based on configuration.
+ *
+ * Returns SignalDockTransport if signaldock is enabled,
+ * otherwise returns ClaudeCodeTransport as the default.
+ */
+export declare function createTransport(config?: TransportFactoryConfig): AgentTransport;
+//# sourceMappingURL=factory.d.ts.map

package/dist/signaldock/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/signaldock/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,6CAA6C;AAC7C,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,QAAQ,GAAG,cAAc,GAAG,SAAS,CAAC;CACpD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,sBAAsB,GAAG,cAAc,CAY/E"}

package/dist/signaldock/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SignalDock integration module — provider-neutral agent transport layer.
+ *
+ * @task T5671
+ */
+export { ClaudeCodeTransport } from './claude-code-transport.js';
+export type { TransportFactoryConfig } from './factory.js';
+export { createTransport } from './factory.js';
+export type { SignalDockTransportConfig } from './signaldock-transport.js';
+export { SignalDockTransport } from './signaldock-transport.js';
+export type { AgentRegistration, AgentTransport, MessageResult } from './transport.js';
+export type { Agent, AgentClass, AgentStatus, ApiResponse, ContentType, Conversation, ConversationVisibility, Message, MessageStatus, NewAgent, NewConversation, NewMessage, PrivacyTier, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/signaldock/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEvF,YAAY,EACV,KAAK,EACL,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACZ,sBAAsB,EACtB,OAAO,EACP,aAAa,EACb,QAAQ,EACR,eAAe,EACf,UAAU,EACV,WAAW,GACZ,MAAM,YAAY,CAAC"}