@a5c-ai/genty-platform 5.1.1-staging.00ceebd28cf2

package/dist/session/sessionSharing.d.ts

@@ -0,0 +1,55 @@
+/**
+ * GAP-SESSION-005: Session Sharing.
+ *
+ * Provides utilities for preparing session trees for sharing,
+ * with optional secret redaction and multiple output formats.
+ */
+/** Minimal tree node shape for serialization. */
+export interface ShareableTreeNode {
+    id: string;
+    parentId: string | null;
+    branchId: string;
+    role: 'user' | 'assistant' | 'system' | 'tool';
+    content: string;
+    metadata?: Record<string, unknown>;
+    timestamp: string;
+    bookmark?: string;
+}
+/** Minimal session tree shape for sharing. */
+export interface ShareableSessionTree {
+    rootId: string;
+    activeBranchId: string;
+    activeNodeId: string;
+    nodes: Map<string, ShareableTreeNode>;
+    branches: Map<string, string[]>;
+}
+export type ShareFormat = 'link' | 'gist' | 'file';
+export interface ShareOptions {
+    /** Output format for the shared session. */
+    format: ShareFormat;
+    /** Whether to include the full message history. */
+    includeHistory: boolean;
+    /** Whether to redact secrets from the output. */
+    redactSecrets: boolean;
+}
+export interface ShareResult {
+    /** URL if format is 'link' or 'gist'. */
+    url?: string;
+    /** File path if format is 'file'. */
+    filePath?: string;
+    /** The format used. */
+    format: ShareFormat;
+    /** ISO timestamp when the share was created. */
+    sharedAt: string;
+    /** The prepared content (serialized). */
+    content: string;
+}
+/**
+ * Prepare a session tree for sharing by serializing and optionally redacting.
+ */
+export declare function prepareSessionForSharing(tree: ShareableSessionTree, options: ShareOptions): ShareResult;
+/**
+ * Generate a shareable HTML page from a session tree.
+ */
+export declare function generateShareableHtml(tree: ShareableSessionTree): string;
+//# sourceMappingURL=sessionSharing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessionSharing.d.ts","sourceRoot":"","sources":["../../src/session/sessionSharing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,8CAA8C;AAC9C,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACtC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACjC;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnD,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,MAAM,EAAE,WAAW,CAAC;IACpB,mDAAmD;IACnD,cAAc,EAAE,OAAO,CAAC;IACxB,iDAAiD;IACjD,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,MAAM,EAAE,WAAW,CAAC;IACpB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;CACjB;AAiBD;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,YAAY,GACpB,WAAW,CAgBb;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CA2BxE"}

package/dist/session/sessionSharing.js

@@ -0,0 +1,113 @@
+"use strict";
+/**
+ * GAP-SESSION-005: Session Sharing.
+ *
+ * Provides utilities for preparing session trees for sharing,
+ * with optional secret redaction and multiple output formats.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepareSessionForSharing = prepareSessionForSharing;
+exports.generateShareableHtml = generateShareableHtml;
+// ---------------------------------------------------------------------------
+// Secret patterns
+// ---------------------------------------------------------------------------
+const SECRET_PATTERNS = [
+    /(?:api[_-]?key|token|secret|password|credential|auth)[\s:=]+["']?[\w\-./+]{8,}["']?/gi,
+    /(?:sk|pk|rk|at|rt)-[a-zA-Z0-9]{8,}/g,
+    /Bearer\s+[a-zA-Z0-9\-._~+/]+=*/g,
+    /-----BEGIN\s+(?:RSA\s+)?PRIVATE\s+KEY-----[\s\S]*?-----END/g,
+];
+// ---------------------------------------------------------------------------
+// Functions
+// ---------------------------------------------------------------------------
+/**
+ * Prepare a session tree for sharing by serializing and optionally redacting.
+ */
+function prepareSessionForSharing(tree, options) {
+    const nodes = options.includeHistory
+        ? getAllNodes(tree)
+        : getActiveNodes(tree);
+    let content = serializeNodes(nodes);
+    if (options.redactSecrets) {
+        content = redactSecrets(content);
+    }
+    return {
+        format: options.format,
+        sharedAt: new Date().toISOString(),
+        content,
+    };
+}
+/**
+ * Generate a shareable HTML page from a session tree.
+ */
+function generateShareableHtml(tree) {
+    const nodes = getAllNodes(tree);
+    const rows = nodes.map(renderNodeHtml).join('\n');
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Shared Session</title>
+  <style>
+    body { font-family: -apple-system, system-ui, sans-serif; max-width: 800px; margin: 0 auto; padding: 2rem; background: #0d1117; color: #c9d1d9; }
+    .message { margin: 1rem 0; padding: 1rem; border-radius: 8px; border-left: 3px solid; }
+    .user { border-color: #58a6ff; background: #161b22; }
+    .assistant { border-color: #3fb950; background: #161b22; }
+    .system { border-color: #8b949e; background: #0d1117; }
+    .tool { border-color: #d29922; background: #161b22; }
+    .role { font-size: 0.75rem; text-transform: uppercase; letter-spacing: 0.05em; margin-bottom: 0.5rem; opacity: 0.7; }
+    .content { white-space: pre-wrap; }
+    .timestamp { font-size: 0.7rem; opacity: 0.5; margin-top: 0.5rem; }
+  </style>
+</head>
+<body>
+  <h1>Shared Session</h1>
+${rows}
+</body>
+</html>`;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function getAllNodes(tree) {
+    return [...tree.nodes.values()].sort((a, b) => a.timestamp.localeCompare(b.timestamp));
+}
+function getActiveNodes(tree) {
+    const nodeIds = tree.branches.get(tree.activeBranchId) ?? [];
+    return nodeIds
+        .map((id) => tree.nodes.get(id))
+        .filter((n) => n !== undefined);
+}
+function serializeNodes(nodes) {
+    const serializable = nodes.map((n) => ({
+        id: n.id,
+        role: n.role,
+        content: n.content,
+        timestamp: n.timestamp,
+        bookmark: n.bookmark,
+    }));
+    return JSON.stringify(serializable, null, 2);
+}
+function redactSecrets(text) {
+    let result = text;
+    for (const pattern of SECRET_PATTERNS) {
+        result = result.replace(pattern, '[REDACTED]');
+    }
+    return result;
+}
+function escapeHtml(text) {
+    return text
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+function renderNodeHtml(node) {
+    const escaped = escapeHtml(node.content);
+    return `  <div class="message ${node.role}">
+    <div class="role">${node.role}</div>
+    <div class="content">${escaped}</div>
+    <div class="timestamp">${node.timestamp}</div>
+  </div>`;
+}

package/dist/session/sessionTemplates.d.ts

@@ -0,0 +1,57 @@
+/**
+ * GAP-SESSION-003: Session Templates.
+ *
+ * Pre-defined templates for common session types (coding, research, review,
+ * planning) with default model, extensions, and system prompt overrides.
+ */
+export interface SessionTemplateConfig {
+    /** Maximum iterations per session. */
+    maxIterations?: number;
+    /** Default cost budget in USD. */
+    maxCostUsd?: number;
+    /** Additional key-value options. */
+    [key: string]: unknown;
+}
+export interface SessionTemplate {
+    /** Unique template identifier. */
+    id: string;
+    /** Human-readable template name. */
+    name: string;
+    /** Brief description of the template. */
+    description: string;
+    /** Default model for sessions using this template. */
+    defaultModel: string;
+    /** Extensions enabled by default. */
+    extensions: string[];
+    /** Optional system prompt override text. */
+    systemPromptOverride?: string;
+    /** Template-specific configuration. */
+    config: SessionTemplateConfig;
+}
+export interface SessionOptions {
+    model?: string;
+    extensions?: string[];
+    systemPrompt?: string;
+    maxIterations?: number;
+    maxCostUsd?: number;
+    [key: string]: unknown;
+}
+export declare const BUILT_IN_TEMPLATES: ReadonlyArray<Readonly<SessionTemplate>>;
+/**
+ * Retrieve a template by ID. Returns undefined if not found.
+ */
+export declare function getTemplate(id: string): SessionTemplate | undefined;
+/**
+ * List all available template IDs and names.
+ */
+export declare function listTemplates(): Array<{
+    id: string;
+    name: string;
+    description: string;
+}>;
+/**
+ * Merge a template's defaults into session options.
+ * Explicit session options take precedence over template defaults.
+ */
+export declare function applyTemplate(template: SessionTemplate, sessionOpts: SessionOptions): SessionOptions;
+//# sourceMappingURL=sessionTemplates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessionTemplates.d.ts","sourceRoot":"","sources":["../../src/session/sessionTemplates.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,qBAAqB;IACpC,sCAAsC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,4CAA4C;IAC5C,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,uCAAuC;IACvC,MAAM,EAAE,qBAAqB,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAMD,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,QAAQ,CAAC,eAAe,CAAC,CA6C1B,CAAC;AAM/C;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEnE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAMxF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,eAAe,EACzB,WAAW,EAAE,cAAc,GAC1B,cAAc,CAQhB"}

package/dist/session/sessionTemplates.js

@@ -0,0 +1,93 @@
+"use strict";
+/**
+ * GAP-SESSION-003: Session Templates.
+ *
+ * Pre-defined templates for common session types (coding, research, review,
+ * planning) with default model, extensions, and system prompt overrides.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BUILT_IN_TEMPLATES = void 0;
+exports.getTemplate = getTemplate;
+exports.listTemplates = listTemplates;
+exports.applyTemplate = applyTemplate;
+// ---------------------------------------------------------------------------
+// Built-in templates
+// ---------------------------------------------------------------------------
+exports.BUILT_IN_TEMPLATES = Object.freeze([
+    Object.freeze({
+        id: 'default',
+        name: 'Default',
+        description: 'General-purpose session with balanced defaults.',
+        defaultModel: 'sonnet',
+        extensions: [],
+        config: { maxIterations: 0 },
+    }),
+    Object.freeze({
+        id: 'coding',
+        name: 'Coding',
+        description: 'Optimized for code generation and debugging.',
+        defaultModel: 'sonnet',
+        extensions: ['code-analysis', 'test-runner'],
+        systemPromptOverride: 'You are an expert software engineer. Focus on clean, tested code.',
+        config: { maxIterations: 50 },
+    }),
+    Object.freeze({
+        id: 'research',
+        name: 'Research',
+        description: 'Optimized for information gathering and analysis.',
+        defaultModel: 'opus',
+        extensions: ['web-search', 'summarizer'],
+        systemPromptOverride: 'You are a thorough researcher. Cite sources and verify claims.',
+        config: { maxIterations: 30 },
+    }),
+    Object.freeze({
+        id: 'review',
+        name: 'Code Review',
+        description: 'Focused on reviewing code changes and providing feedback.',
+        defaultModel: 'sonnet',
+        extensions: ['code-analysis', 'diff-viewer'],
+        systemPromptOverride: 'You are an experienced code reviewer. Be constructive and thorough.',
+        config: { maxIterations: 20 },
+    }),
+    Object.freeze({
+        id: 'planning',
+        name: 'Planning',
+        description: 'Session for project planning and architecture design.',
+        defaultModel: 'opus',
+        extensions: ['note-taking'],
+        systemPromptOverride: 'You are a technical architect. Think systematically about trade-offs.',
+        config: { maxIterations: 25 },
+    }),
+]);
+// ---------------------------------------------------------------------------
+// Functions
+// ---------------------------------------------------------------------------
+/**
+ * Retrieve a template by ID. Returns undefined if not found.
+ */
+function getTemplate(id) {
+    return exports.BUILT_IN_TEMPLATES.find((t) => t.id === id);
+}
+/**
+ * List all available template IDs and names.
+ */
+function listTemplates() {
+    return exports.BUILT_IN_TEMPLATES.map((t) => ({
+        id: t.id,
+        name: t.name,
+        description: t.description,
+    }));
+}
+/**
+ * Merge a template's defaults into session options.
+ * Explicit session options take precedence over template defaults.
+ */
+function applyTemplate(template, sessionOpts) {
+    return {
+        model: sessionOpts.model ?? template.defaultModel,
+        extensions: sessionOpts.extensions ?? [...template.extensions],
+        systemPrompt: sessionOpts.systemPrompt ?? template.systemPromptOverride,
+        maxIterations: sessionOpts.maxIterations ?? template.config.maxIterations,
+        maxCostUsd: sessionOpts.maxCostUsd ?? template.config.maxCostUsd,
+    };
+}

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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"}

package/dist/session/types.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * Session state management types for babysitter orchestration.
+ * These types represent the state stored in markdown files with YAML frontmatter.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionErrorCode = exports.SessionError = void 0;
+/**
+ * Error thrown when session operations fail.
+ */
+class SessionError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'SessionError';
+    }
+}
+exports.SessionError = SessionError;
+/**
+ * Session error codes.
+ */
+var SessionErrorCode;
+(function (SessionErrorCode) {
+    /** Session ID not provided */
+    SessionErrorCode["MISSING_SESSION_ID"] = "MISSING_SESSION_ID";
+    /** State file already exists */
+    SessionErrorCode["SESSION_EXISTS"] = "SESSION_EXISTS";
+    /** State file not found */
+    SessionErrorCode["SESSION_NOT_FOUND"] = "SESSION_NOT_FOUND";
+    /** Run already associated */
+    SessionErrorCode["RUN_ALREADY_ASSOCIATED"] = "RUN_ALREADY_ASSOCIATED";
+    /** Run not found */
+    SessionErrorCode["RUN_NOT_FOUND"] = "RUN_NOT_FOUND";
+    /** Run already completed */
+    SessionErrorCode["RUN_COMPLETED"] = "RUN_COMPLETED";
+    /** State file corrupted */
+    SessionErrorCode["CORRUPTED_STATE"] = "CORRUPTED_STATE";
+    /** Invalid state value */
+    SessionErrorCode["INVALID_STATE_VALUE"] = "INVALID_STATE_VALUE";
+    /** File system error */
+    SessionErrorCode["FS_ERROR"] = "FS_ERROR";
+})(SessionErrorCode || (exports.SessionErrorCode = SessionErrorCode = {}));