@a5c-ai/agent-platform 5.0.1-staging.b436b3b3e611

package/dist/session/parse.js

@@ -0,0 +1,170 @@
+"use strict";
+/**
+ * Session state file parsing utilities.
+ * Parses markdown files with YAML frontmatter for session state.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_SESSION_STATE = void 0;
+exports.parseYamlFrontmatter = parseYamlFrontmatter;
+exports.parseSessionState = parseSessionState;
+exports.readSessionFile = readSessionFile;
+exports.sessionFileExists = sessionFileExists;
+exports.validateSessionState = validateSessionState;
+exports.getSessionFilePath = getSessionFilePath;
+const node_fs_1 = require("node:fs");
+const types_1 = require("./types");
+/**
+ * Default session state values.
+ */
+exports.DEFAULT_SESSION_STATE = {
+    active: false,
+    iteration: 1,
+    maxIterations: 65_000,
+    runId: '',
+    runIds: [],
+    startedAt: '',
+    lastIterationAt: '',
+    iterationTimes: [],
+};
+/**
+ * Parse YAML frontmatter from a string.
+ * Expects format:
+ * ```
+ * ---
+ * key: value
+ * ---
+ * content
+ * ```
+ */
+function parseYamlFrontmatter(content) {
+    const lines = content.split('\n');
+    const frontmatter = {};
+    let inFrontmatter = false;
+    let frontmatterEnd = -1;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].trim();
+        if (line === '---') {
+            if (!inFrontmatter) {
+                inFrontmatter = true;
+                continue;
+            }
+            else {
+                frontmatterEnd = i;
+                break;
+            }
+        }
+        if (inFrontmatter && line) {
+            const colonIndex = line.indexOf(':');
+            if (colonIndex > 0) {
+                const key = line.slice(0, colonIndex).trim();
+                let value = line.slice(colonIndex + 1).trim();
+                // Remove surrounding quotes if present
+                if ((value.startsWith('"') && value.endsWith('"')) ||
+                    (value.startsWith("'") && value.endsWith("'"))) {
+                    value = value.slice(1, -1);
+                }
+                frontmatter[key] = value;
+            }
+        }
+    }
+    const body = frontmatterEnd >= 0
+        ? lines.slice(frontmatterEnd + 1).join('\n').trim()
+        : content;
+    return { frontmatter, body };
+}
+/**
+ * Parse session state from YAML frontmatter values.
+ */
+function parseSessionState(frontmatter) {
+    const parseNumber = (value, defaultValue) => {
+        if (!value)
+            return defaultValue;
+        const parsed = parseInt(value, 10);
+        return Number.isFinite(parsed) ? parsed : defaultValue;
+    };
+    const parseBoolean = (value, defaultValue) => {
+        if (!value)
+            return defaultValue;
+        return value.toLowerCase() === 'true';
+    };
+    const parseNumberArray = (value) => {
+        if (!value || value.trim() === '')
+            return [];
+        return value
+            .split(',')
+            .map(s => parseInt(s.trim(), 10))
+            .filter(n => Number.isFinite(n) && n > 0);
+    };
+    const parseStringArray = (value) => {
+        if (!value || value.trim() === '')
+            return [];
+        return value.split(',').map(s => s.trim()).filter(s => s.length > 0);
+    };
+    const metadata = Object.fromEntries(Object.entries(frontmatter)
+        .filter(([key]) => key.startsWith('metadata_'))
+        .map(([key, value]) => [key.slice('metadata_'.length), value]));
+    return {
+        active: parseBoolean(frontmatter.active, exports.DEFAULT_SESSION_STATE.active),
+        iteration: parseNumber(frontmatter.iteration, exports.DEFAULT_SESSION_STATE.iteration),
+        maxIterations: parseNumber(frontmatter.max_iterations, exports.DEFAULT_SESSION_STATE.maxIterations),
+        runId: frontmatter.run_id ?? exports.DEFAULT_SESSION_STATE.runId,
+        runIds: parseStringArray(frontmatter.run_ids),
+        startedAt: frontmatter.started_at ?? exports.DEFAULT_SESSION_STATE.startedAt,
+        lastIterationAt: frontmatter.last_iteration_at ?? exports.DEFAULT_SESSION_STATE.lastIterationAt,
+        iterationTimes: parseNumberArray(frontmatter.iteration_times),
+        metadata: Object.keys(metadata).length > 0 ? metadata : undefined,
+    };
+}
+/**
+ * Read and parse a session state file.
+ */
+async function readSessionFile(filePath) {
+    let content;
+    try {
+        content = await node_fs_1.promises.readFile(filePath, 'utf8');
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === 'ENOENT') {
+            throw new types_1.SessionError(`Session state file not found: ${filePath}`, types_1.SessionErrorCode.SESSION_NOT_FOUND, { filePath });
+        }
+        throw new types_1.SessionError(`Failed to read session state file: ${err.message}`, types_1.SessionErrorCode.FS_ERROR, { filePath, originalError: err.message });
+    }
+    const { frontmatter, body } = parseYamlFrontmatter(content);
+    const state = parseSessionState(frontmatter);
+    return {
+        state,
+        prompt: body,
+        filePath,
+    };
+}
+/**
+ * Check if a session state file exists.
+ */
+async function sessionFileExists(filePath) {
+    try {
+        await node_fs_1.promises.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Validate session state values.
+ * Throws SessionError if validation fails.
+ */
+function validateSessionState(state) {
+    if (typeof state.iteration !== 'number' || !Number.isFinite(state.iteration) || state.iteration < 0) {
+        throw new types_1.SessionError(`Invalid iteration value: ${state.iteration}`, types_1.SessionErrorCode.INVALID_STATE_VALUE, { field: 'iteration', value: state.iteration });
+    }
+    if (typeof state.maxIterations !== 'number' || !Number.isFinite(state.maxIterations) || state.maxIterations < 0) {
+        throw new types_1.SessionError(`Invalid maxIterations value: ${state.maxIterations}`, types_1.SessionErrorCode.INVALID_STATE_VALUE, { field: 'maxIterations', value: state.maxIterations });
+    }
+}
+/**
+ * Get the state file path for a session.
+ */
+function getSessionFilePath(stateDir, sessionId) {
+    return `${stateDir}/${sessionId}.md`;
+}

package/dist/session/persistence.d.ts

@@ -0,0 +1,46 @@
+/**
+ * GAP-STATE-003: Session State Persistence.
+ *
+ * Stores rich persistent state: findings, file modifications, breakpoint patterns,
+ * and user preferences. Follows the same atomic temp-file + rename pattern
+ * as context.ts and history.ts.
+ */
+export interface SessionFinding {
+    content: string;
+    category: "architecture" | "bug" | "pattern" | "dependency" | "other";
+    runId?: string;
+    timestamp: string;
+}
+export interface SessionFileModification {
+    filePath: string;
+    action: "create" | "modify" | "delete";
+    runId?: string;
+    timestamp: string;
+}
+export interface SessionBreakpointPattern {
+    breakpointId: string;
+    approvedCount: number;
+    rejectedCount: number;
+    lastAction: "approved" | "rejected";
+    lastInteractionAt: string;
+}
+export interface SessionPersistentState {
+    schemaVersion: string;
+    findings: SessionFinding[];
+    preferences: Record<string, string>;
+    fileModifications: SessionFileModification[];
+    breakpointPatterns: SessionBreakpointPattern[];
+}
+export declare const SESSION_PERSISTENT_SCHEMA_VERSION = "2026.01.session-persistent-v1";
+export declare function getSessionPersistentStatePath(stateDir: string, sessionId: string): string;
+export declare function getSessionPersistentState(stateDir: string, sessionId: string): Promise<SessionPersistentState>;
+export declare function addFinding(stateDir: string, sessionId: string, finding: Omit<SessionFinding, "timestamp">): Promise<void>;
+export declare function setPreference(stateDir: string, sessionId: string, key: string, value: string): Promise<void>;
+export declare function recordFileModification(stateDir: string, sessionId: string, mod: Omit<SessionFileModification, "timestamp">): Promise<void>;
+export declare function recordBreakpointInteraction(stateDir: string, sessionId: string, breakpointId: string, action: "approved" | "rejected"): Promise<void>;
+/**
+ * Render persistent state into a markdown section for resume prompt injection.
+ * Returns empty string when no meaningful data exists.
+ */
+export declare function buildResumeContext(stateDir: string, sessionId: string): Promise<string>;
+//# sourceMappingURL=persistence.d.ts.map

package/dist/session/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../src/session/persistence.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,cAAc,GAAG,KAAK,GAAG,SAAS,GAAG,YAAY,GAAG,OAAO,CAAC;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,UAAU,GAAG,UAAU,CAAC;IACpC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,iBAAiB,EAAE,uBAAuB,EAAE,CAAC;IAC7C,kBAAkB,EAAE,wBAAwB,EAAE,CAAC;CAChD;AAED,eAAO,MAAM,iCAAiC,kCAAkC,CAAC;AAuDjF,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzF;AAED,wBAAsB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAEpH;AAED,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,GACzC,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,IAAI,CAAC,uBAAuB,EAAE,WAAW,CAAC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,UAAU,GAAG,UAAU,GAC9B,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA+B7F"}

package/dist/session/persistence.js

@@ -0,0 +1,180 @@
+"use strict";
+/**
+ * GAP-STATE-003: Session State Persistence.
+ *
+ * Stores rich persistent state: findings, file modifications, breakpoint patterns,
+ * and user preferences. Follows the same atomic temp-file + rename pattern
+ * as context.ts and history.ts.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SESSION_PERSISTENT_SCHEMA_VERSION = void 0;
+exports.getSessionPersistentStatePath = getSessionPersistentStatePath;
+exports.getSessionPersistentState = getSessionPersistentState;
+exports.addFinding = addFinding;
+exports.setPreference = setPreference;
+exports.recordFileModification = recordFileModification;
+exports.recordBreakpointInteraction = recordBreakpointInteraction;
+exports.buildResumeContext = buildResumeContext;
+const node_fs_1 = require("node:fs");
+const path = __importStar(require("node:path"));
+exports.SESSION_PERSISTENT_SCHEMA_VERSION = "2026.01.session-persistent-v1";
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function emptyPersistentState() {
+    return {
+        schemaVersion: exports.SESSION_PERSISTENT_SCHEMA_VERSION,
+        findings: [],
+        preferences: {},
+        fileModifications: [],
+        breakpointPatterns: [],
+    };
+}
+function nowTimestamp() {
+    return new Date().toISOString();
+}
+async function readRaw(filePath) {
+    let raw;
+    try {
+        raw = await node_fs_1.promises.readFile(filePath, "utf8");
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === "ENOENT")
+            return emptyPersistentState();
+        return emptyPersistentState();
+    }
+    try {
+        const data = JSON.parse(raw);
+        return {
+            schemaVersion: typeof data.schemaVersion === "string" ? data.schemaVersion : exports.SESSION_PERSISTENT_SCHEMA_VERSION,
+            findings: Array.isArray(data.findings) ? data.findings : [],
+            preferences: data.preferences && typeof data.preferences === "object" ? data.preferences : {},
+            fileModifications: Array.isArray(data.fileModifications) ? data.fileModifications : [],
+            breakpointPatterns: Array.isArray(data.breakpointPatterns) ? data.breakpointPatterns : [],
+        };
+    }
+    catch {
+        return emptyPersistentState();
+    }
+}
+async function writeRaw(filePath, data) {
+    const dir = path.dirname(filePath);
+    const tempPath = `${filePath}.tmp.${process.pid}`;
+    await node_fs_1.promises.mkdir(dir, { recursive: true });
+    await node_fs_1.promises.writeFile(tempPath, JSON.stringify(data, null, 2), "utf8");
+    await node_fs_1.promises.rename(tempPath, filePath);
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+function getSessionPersistentStatePath(stateDir, sessionId) {
+    return path.join(stateDir, `${sessionId}.persistent.json`);
+}
+async function getSessionPersistentState(stateDir, sessionId) {
+    return readRaw(getSessionPersistentStatePath(stateDir, sessionId));
+}
+async function addFinding(stateDir, sessionId, finding) {
+    const filePath = getSessionPersistentStatePath(stateDir, sessionId);
+    const data = await readRaw(filePath);
+    data.findings.push({ ...finding, timestamp: nowTimestamp() });
+    await writeRaw(filePath, data);
+}
+async function setPreference(stateDir, sessionId, key, value) {
+    const filePath = getSessionPersistentStatePath(stateDir, sessionId);
+    const data = await readRaw(filePath);
+    data.preferences[key] = value;
+    await writeRaw(filePath, data);
+}
+async function recordFileModification(stateDir, sessionId, mod) {
+    const filePath = getSessionPersistentStatePath(stateDir, sessionId);
+    const data = await readRaw(filePath);
+    data.fileModifications.push({ ...mod, timestamp: nowTimestamp() });
+    await writeRaw(filePath, data);
+}
+async function recordBreakpointInteraction(stateDir, sessionId, breakpointId, action) {
+    const filePath = getSessionPersistentStatePath(stateDir, sessionId);
+    const data = await readRaw(filePath);
+    const now = nowTimestamp();
+    const existing = data.breakpointPatterns.find((p) => p.breakpointId === breakpointId);
+    if (existing) {
+        if (action === "approved")
+            existing.approvedCount++;
+        else
+            existing.rejectedCount++;
+        existing.lastAction = action;
+        existing.lastInteractionAt = now;
+    }
+    else {
+        data.breakpointPatterns.push({
+            breakpointId,
+            approvedCount: action === "approved" ? 1 : 0,
+            rejectedCount: action === "rejected" ? 1 : 0,
+            lastAction: action,
+            lastInteractionAt: now,
+        });
+    }
+    await writeRaw(filePath, data);
+}
+/**
+ * Render persistent state into a markdown section for resume prompt injection.
+ * Returns empty string when no meaningful data exists.
+ */
+async function buildResumeContext(stateDir, sessionId) {
+    const state = await getSessionPersistentState(stateDir, sessionId);
+    const sections = [];
+    if (state.findings.length > 0) {
+        const lines = state.findings.map((f) => `- [${f.category}] ${f.content}`);
+        sections.push(`### Findings\n${lines.join("\n")}`);
+    }
+    const prefKeys = Object.keys(state.preferences);
+    if (prefKeys.length > 0) {
+        const lines = prefKeys.map((k) => `- **${k}**: ${state.preferences[k]}`);
+        sections.push(`### Preferences\n${lines.join("\n")}`);
+    }
+    if (state.fileModifications.length > 0) {
+        const recent = state.fileModifications.slice(-10);
+        const lines = recent.map((m) => `- ${m.action} \`${m.filePath}\``);
+        sections.push(`### Recent File Changes\n${lines.join("\n")}`);
+    }
+    if (state.breakpointPatterns.length > 0) {
+        const lines = state.breakpointPatterns.map((p) => `- \`${p.breakpointId}\`: ${p.approvedCount} approved, ${p.rejectedCount} rejected (last: ${p.lastAction})`);
+        sections.push(`### Breakpoint Patterns\n${lines.join("\n")}`);
+    }
+    if (sections.length === 0)
+        return "";
+    return `## Session Context\n\n${sections.join("\n\n")}`;
+}

package/dist/session/types.d.ts

@@ -0,0 +1,267 @@
+/**
+ * Session state management types for babysitter orchestration.
+ * These types represent the state stored in markdown files with YAML frontmatter.
+ */
+/**
+ * Session state stored in the state file's YAML frontmatter.
+ */
+export interface SessionState {
+    /** Whether the session is currently active */
+    active: boolean;
+    /** Current iteration number (1-based) */
+    iteration: number;
+    /** Maximum allowed iterations (0 = unlimited) */
+    maxIterations: number;
+    /** The single currently-active run bound to this session (empty string if unbound) */
+    runId: string;
+    /** Historical audit trail of all run IDs ever bound to this session, chronological (GAP-SESSION-001) */
+    runIds: string[];
+    /** ISO timestamp when session started */
+    startedAt: string;
+    /** ISO timestamp of last iteration */
+    lastIterationAt: string;
+    /** Array of recent iteration durations in seconds (last 3) */
+    iterationTimes: number[];
+    /** Optional key-value metadata (e.g. external correlation IDs) */
+    metadata?: Record<string, string>;
+}
+/**
+ * Accumulated context shared across runs within a session (GAP-SESSION-001).
+ * Persisted as a JSON file alongside the session state file.
+ */
+export interface SessionWorktreeContext {
+    /** Workspace or worktree path bound to the session. */
+    workspacePath: string;
+    /** More specific current path within the workspace, when known. */
+    currentPath?: string;
+    /** Materialization mode when the binding is known. */
+    mode?: "worktree" | "symlink";
+    /** Repo alias within a multi-repo workspace, when known. */
+    repoAlias?: string;
+    /** Branch bound to the worktree, when known. */
+    branch?: string | null;
+}
+export interface SessionContext {
+    /** Accumulated notes from across runs */
+    notes: string[];
+    /** Shared knowledge key-value pairs accumulated across runs */
+    sharedKnowledge: Record<string, string>;
+    /** Bound workspace/worktree metadata carried across runs when available. */
+    worktree?: SessionWorktreeContext;
+}
+/** A recorded decision made during a session. */
+export interface SessionDecision {
+    /** ISO timestamp when the decision was recorded */
+    timestamp: string;
+    /** What was decided */
+    description: string;
+    /** Why it was decided */
+    rationale?: string;
+    /** Run in which this decision was made */
+    runId?: string;
+}
+/** Summary of a completed run within a session. */
+export interface SessionRunSummary {
+    /** Run identifier */
+    runId: string;
+    /** Process that was executed */
+    processId: string;
+    /** Terminal status */
+    status: string;
+    /** ISO timestamp when the run started */
+    startedAt: string;
+    /** ISO timestamp when the run finished */
+    completedAt?: string;
+    /** Human-readable outcome */
+    outcome?: string;
+    /** Quality score (0-100) if available */
+    score?: number;
+}
+/** Point-in-time snapshot of session context. */
+export interface SessionContextSnapshot {
+    /** ISO timestamp when the snapshot was taken */
+    timestamp: string;
+    /** Run during which this snapshot was taken */
+    runId?: string;
+    /** Arbitrary context data */
+    snapshot: Record<string, unknown>;
+}
+/**
+ * Rich session history: extends SessionContext with accumulated
+ * decisions, run summaries, and context snapshots (GAP-SESSION-002).
+ */
+export interface SessionHistory extends SessionContext {
+    /** Accumulated decisions made during this session */
+    decisions: SessionDecision[];
+    /** Summaries of all runs that have executed in this session */
+    runSummaries: SessionRunSummary[];
+    /** Point-in-time context snapshots */
+    contextSnapshots: SessionContextSnapshot[];
+}
+/**
+ * Complete session file content including state and prompt.
+ */
+export interface SessionFile {
+    /** Parsed YAML frontmatter state */
+    state: SessionState;
+    /** Prompt content (everything after the YAML frontmatter) */
+    prompt: string;
+    /** Path to the state file */
+    filePath: string;
+}
+/**
+ * Options for initializing a new session.
+ */
+export interface SessionInitOptions {
+    /** Claude session ID */
+    sessionId: string;
+    /** Maximum iterations (default: 65000) */
+    maxIterations?: number;
+    /** Optional run ID if already known */
+    runId?: string;
+    /** Directory to store state files */
+    stateDir: string;
+    /** Initial prompt text */
+    prompt: string;
+}
+/**
+ * Options for associating a session with a run.
+ */
+export interface SessionAssociateOptions {
+    /** Claude session ID */
+    sessionId: string;
+    /** Run ID to associate */
+    runId: string;
+    /** Directory containing state files */
+    stateDir: string;
+}
+/**
+ * Options for resuming an existing session.
+ */
+export interface SessionResumeOptions {
+    /** Claude session ID */
+    sessionId: string;
+    /** Run ID to resume */
+    runId: string;
+    /** Maximum iterations (default: 65000) */
+    maxIterations?: number;
+    /** Directory to store state files */
+    stateDir: string;
+    /** Runs directory (default: ~/.a5c/runs, or <repo>/.a5c/runs when BABYSITTER_RUNS_SCOPE=repo) */
+    runsDir?: string;
+}
+/**
+ * Options for reading session state.
+ */
+export interface SessionStateOptions {
+    /** Claude session ID */
+    sessionId: string;
+    /** Directory containing state files */
+    stateDir: string;
+}
+/**
+ * Options for updating session state.
+ */
+export interface SessionUpdateOptions {
+    /** Claude session ID */
+    sessionId: string;
+    /** Directory containing state files */
+    stateDir: string;
+    /** New iteration number */
+    iteration?: number;
+    /** New last iteration timestamp */
+    lastIterationAt?: string;
+    /** New iteration times array */
+    iterationTimes?: number[];
+}
+/**
+ * Result of session:init command.
+ */
+export interface SessionInitResult {
+    /** Path to created state file */
+    stateFile: string;
+    /** Initial iteration number */
+    iteration: number;
+    /** Maximum iterations */
+    maxIterations: number;
+    /** Run ID (may be empty) */
+    runId: string;
+}
+/**
+ * Result of session:associate command.
+ */
+export interface SessionAssociateResult {
+    /** Path to updated state file */
+    stateFile: string;
+    /** Associated run ID */
+    runId: string;
+}
+/**
+ * Result of session:resume command.
+ */
+export interface SessionResumeResult {
+    /** Path to created state file */
+    stateFile: string;
+    /** Run ID being resumed */
+    runId: string;
+    /** Current run state */
+    runState: string;
+    /** Process ID from run metadata */
+    processId: string;
+}
+/**
+ * Result of session:state command.
+ */
+export interface SessionStateResult {
+    /** Whether state file exists */
+    found: boolean;
+    /** Session state (if found) */
+    state?: SessionState;
+    /** Prompt content (if found) */
+    prompt?: string;
+    /** Path to state file */
+    stateFile: string;
+}
+/**
+ * Result of session:update command.
+ */
+export interface SessionUpdateResult {
+    /** Whether update was successful */
+    success: boolean;
+    /** Updated state */
+    state?: SessionState;
+    /** Path to state file */
+    stateFile: string;
+}
+/**
+ * Error thrown when session operations fail.
+ */
+export declare class SessionError extends Error {
+    readonly code: SessionErrorCode;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(message: string, code: SessionErrorCode, details?: Record<string, unknown> | undefined);
+}
+/**
+ * Session error codes.
+ */
+export declare enum SessionErrorCode {
+    /** Session ID not provided */
+    MISSING_SESSION_ID = "MISSING_SESSION_ID",
+    /** State file already exists */
+    SESSION_EXISTS = "SESSION_EXISTS",
+    /** State file not found */
+    SESSION_NOT_FOUND = "SESSION_NOT_FOUND",
+    /** Run already associated */
+    RUN_ALREADY_ASSOCIATED = "RUN_ALREADY_ASSOCIATED",
+    /** Run not found */
+    RUN_NOT_FOUND = "RUN_NOT_FOUND",
+    /** Run already completed */
+    RUN_COMPLETED = "RUN_COMPLETED",
+    /** State file corrupted */
+    CORRUPTED_STATE = "CORRUPTED_STATE",
+    /** Invalid state value */
+    INVALID_STATE_VALUE = "INVALID_STATE_VALUE",
+    /** File system error */
+    FS_ERROR = "FS_ERROR"
+}
+//# sourceMappingURL=types.d.ts.map

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

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