@creativeintelligence/abbie 0.1.0

package/dist/lib/events.d.ts

@@ -0,0 +1,206 @@
+/**
+ * Event types for session lifecycle.
+ */
+export type EventType = "session:start" | "session:heartbeat" | "session:checkpoint" | "session:complete" | "session:blocked" | "session:failed" | "task:start" | "task:complete" | "task:blocked" | "preview:created" | "preview:shared" | "resource:acquired" | "resource:released" | "notification:sent";
+/**
+ * Base event structure.
+ */
+export interface BaseEvent {
+    id: string;
+    type: EventType;
+    timestamp: string;
+    session_id: string;
+    agent: string;
+}
+/**
+ * Session start event.
+ */
+export interface SessionStartEvent extends BaseEvent {
+    type: "session:start";
+    data: {
+        project: string;
+        issue?: string;
+        worktree?: string;
+        config_path?: string;
+    };
+}
+/**
+ * Session heartbeat event.
+ */
+export interface SessionHeartbeatEvent extends BaseEvent {
+    type: "session:heartbeat";
+    data: {
+        status: "active" | "idle";
+        current_task?: string;
+    };
+}
+/**
+ * Session checkpoint event.
+ */
+export interface SessionCheckpointEvent extends BaseEvent {
+    type: "session:checkpoint";
+    data: {
+        progress: number;
+        summary: string;
+        files_changed?: string[];
+        commits?: string[];
+    };
+}
+/**
+ * Session complete event.
+ */
+export interface SessionCompleteEvent extends BaseEvent {
+    type: "session:complete";
+    data: {
+        summary: string;
+        artifacts: Array<{
+            type: "commit" | "pr" | "file" | "preview";
+            ref: string;
+            url?: string;
+        }>;
+        duration_ms: number;
+    };
+}
+/**
+ * Session blocked event.
+ */
+export interface SessionBlockedEvent extends BaseEvent {
+    type: "session:blocked";
+    data: {
+        reason: string;
+        blocker_type: "hil" | "error" | "dependency" | "resource";
+        context?: Record<string, unknown>;
+    };
+}
+/**
+ * Task start event.
+ */
+export interface TaskStartEvent extends BaseEvent {
+    type: "task:start";
+    data: {
+        task_id: string;
+        description: string;
+        issue?: string;
+    };
+}
+/**
+ * Task complete event.
+ */
+export interface TaskCompleteEvent extends BaseEvent {
+    type: "task:complete";
+    data: {
+        task_id: string;
+        summary: string;
+        confidence: number;
+    };
+}
+/**
+ * Preview created event.
+ */
+export interface PreviewCreatedEvent extends BaseEvent {
+    type: "preview:created";
+    data: {
+        url: string;
+        port: number;
+        subdomain: string;
+        issue?: string;
+    };
+}
+/**
+ * Resource acquired event.
+ */
+export interface ResourceAcquiredEvent extends BaseEvent {
+    type: "resource:acquired";
+    data: {
+        resource: string;
+        lease_id: string;
+        expires_at: string;
+    };
+}
+/**
+ * Resource released event.
+ */
+export interface ResourceReleasedEvent extends BaseEvent {
+    type: "resource:released";
+    data: {
+        resource: string;
+        lease_id: string;
+    };
+}
+/**
+ * Union of all event types.
+ */
+export type SessionEvent = SessionStartEvent | SessionHeartbeatEvent | SessionCheckpointEvent | SessionCompleteEvent | SessionBlockedEvent | TaskStartEvent | TaskCompleteEvent | PreviewCreatedEvent | ResourceAcquiredEvent | ResourceReleasedEvent | (BaseEvent & {
+    data?: Record<string, unknown>;
+});
+/**
+ * Event store for append-only session events.
+ */
+export declare class EventStore {
+    private basePath;
+    constructor(basePath?: string);
+    /**
+     * Get the event log path for a project.
+     */
+    private getLogPath;
+    /**
+     * Append an event to the log.
+     */
+    append(event: Omit<SessionEvent, "id" | "timestamp">): SessionEvent;
+    /**
+     * Best-effort write event to Convex store.
+     */
+    private appendToStore;
+    /**
+     * Read all events for a project.
+     */
+    readAll(project: string): SessionEvent[];
+    /**
+     * Read events for a specific session.
+     */
+    readSession(sessionId: string): SessionEvent[];
+    /**
+     * Read events of a specific type.
+     */
+    readByType(project: string, type: EventType): SessionEvent[];
+    /**
+     * Get the latest event for a session.
+     */
+    getLatest(sessionId: string): SessionEvent | undefined;
+    /**
+     * Get active sessions (started but not completed/failed).
+     */
+    getActiveSessions(project: string): string[];
+    /**
+     * Extract project from session ID (format: project-YYYYMMDD-HHMMSS-random).
+     */
+    private extractProject;
+    /**
+     * List all projects with events.
+     */
+    listProjects(): string[];
+    /**
+     * Compact old events (keep last N days).
+     */
+    compact(project: string, keepDays?: number): number;
+}
+/**
+ * Helper to create common events.
+ */
+export declare const createEvent: {
+    sessionStart: (sessionId: string, agent: string, data: SessionStartEvent["data"]) => Omit<SessionStartEvent, "id" | "timestamp">;
+    heartbeat: (sessionId: string, agent: string, data: SessionHeartbeatEvent["data"]) => Omit<SessionHeartbeatEvent, "id" | "timestamp">;
+    checkpoint: (sessionId: string, agent: string, data: SessionCheckpointEvent["data"]) => Omit<SessionCheckpointEvent, "id" | "timestamp">;
+    complete: (sessionId: string, agent: string, data: SessionCompleteEvent["data"]) => Omit<SessionCompleteEvent, "id" | "timestamp">;
+    blocked: (sessionId: string, agent: string, data: SessionBlockedEvent["data"]) => Omit<SessionBlockedEvent, "id" | "timestamp">;
+    taskStart: (sessionId: string, agent: string, data: TaskStartEvent["data"]) => Omit<TaskStartEvent, "id" | "timestamp">;
+    taskComplete: (sessionId: string, agent: string, data: TaskCompleteEvent["data"]) => Omit<TaskCompleteEvent, "id" | "timestamp">;
+    previewCreated: (sessionId: string, agent: string, data: PreviewCreatedEvent["data"]) => Omit<PreviewCreatedEvent, "id" | "timestamp">;
+    resourceAcquired: (sessionId: string, agent: string, data: ResourceAcquiredEvent["data"]) => Omit<ResourceAcquiredEvent, "id" | "timestamp">;
+    resourceReleased: (sessionId: string, agent: string, data: ResourceReleasedEvent["data"]) => Omit<ResourceReleasedEvent, "id" | "timestamp">;
+};
+/**
+ * Generate a session ID.
+ */
+export declare function generateSessionId(project: string): string;
+//# sourceMappingURL=events.d.ts.map

package/dist/lib/events.d.ts.map

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

package/dist/lib/events.js

@@ -0,0 +1,227 @@
+import { appendFileSync, existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync, } from "node:fs";
+import { join } from "node:path";
+/**
+ * Generate a unique event ID.
+ */
+function generateEventId() {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).slice(2, 8);
+    return `${timestamp}-${random}`;
+}
+/**
+ * Event store for append-only session events.
+ */
+export class EventStore {
+    basePath;
+    constructor(basePath = "~/.abbie/events") {
+        this.basePath = basePath.replace("~", process.env.HOME || "");
+        if (!existsSync(this.basePath)) {
+            mkdirSync(this.basePath, { recursive: true });
+        }
+    }
+    /**
+     * Get the event log path for a project.
+     */
+    getLogPath(project) {
+        const projectDir = join(this.basePath, project);
+        if (!existsSync(projectDir)) {
+            mkdirSync(projectDir, { recursive: true });
+        }
+        return join(projectDir, "events.jsonl");
+    }
+    /**
+     * Append an event to the log.
+     */
+    append(event) {
+        const fullEvent = {
+            ...event,
+            id: generateEventId(),
+            timestamp: new Date().toISOString(),
+        };
+        const project = this.extractProject(fullEvent.session_id);
+        const logPath = this.getLogPath(project);
+        appendFileSync(logPath, `${JSON.stringify(fullEvent)}\n`);
+        // Best-effort Convex write (fire-and-forget)
+        this.appendToStore(fullEvent).catch(() => { });
+        return fullEvent;
+    }
+    /**
+     * Best-effort write event to Convex store.
+     */
+    async appendToStore(event) {
+        try {
+            const { getHttpClient, api } = await import("@abbie/sdk/convex");
+            const client = getHttpClient();
+            await client.mutation(api.events.append, {
+                sessionId: event.session_id,
+                eventType: event.type,
+                payload: "data" in event ? event.data : {},
+            });
+        }
+        catch {
+            // Best-effort: local JSONL is the primary record
+        }
+    }
+    /**
+     * Read all events for a project.
+     */
+    readAll(project) {
+        const logPath = this.getLogPath(project);
+        if (!existsSync(logPath)) {
+            return [];
+        }
+        const content = readFileSync(logPath, "utf-8");
+        return content
+            .split("\n")
+            .filter(Boolean)
+            .map((line) => JSON.parse(line));
+    }
+    /**
+     * Read events for a specific session.
+     */
+    readSession(sessionId) {
+        const project = this.extractProject(sessionId);
+        const allEvents = this.readAll(project);
+        return allEvents.filter((e) => e.session_id === sessionId);
+    }
+    /**
+     * Read events of a specific type.
+     */
+    readByType(project, type) {
+        return this.readAll(project).filter((e) => e.type === type);
+    }
+    /**
+     * Get the latest event for a session.
+     */
+    getLatest(sessionId) {
+        const events = this.readSession(sessionId);
+        return events[events.length - 1];
+    }
+    /**
+     * Get active sessions (started but not completed/failed).
+     */
+    getActiveSessions(project) {
+        const events = this.readAll(project);
+        const started = new Set();
+        const ended = new Set();
+        for (const event of events) {
+            if (event.type === "session:start") {
+                started.add(event.session_id);
+            }
+            else if (event.type === "session:complete" || event.type === "session:failed") {
+                ended.add(event.session_id);
+            }
+        }
+        return [...started].filter((id) => !ended.has(id));
+    }
+    /**
+     * Extract project from session ID (format: project-YYYYMMDD-HHMMSS-random).
+     */
+    extractProject(sessionId) {
+        const parts = sessionId.split("-");
+        return parts[0];
+    }
+    /**
+     * List all projects with events.
+     */
+    listProjects() {
+        if (!existsSync(this.basePath)) {
+            return [];
+        }
+        return readdirSync(this.basePath).filter((name) => {
+            const path = join(this.basePath, name);
+            return statSync(path).isDirectory();
+        });
+    }
+    /**
+     * Compact old events (keep last N days).
+     */
+    compact(project, keepDays = 30) {
+        const cutoff = new Date();
+        cutoff.setDate(cutoff.getDate() - keepDays);
+        const cutoffStr = cutoff.toISOString();
+        const events = this.readAll(project);
+        const kept = events.filter((e) => e.timestamp >= cutoffStr);
+        const removed = events.length - kept.length;
+        if (removed > 0) {
+            const logPath = this.getLogPath(project);
+            writeFileSync(logPath, `${kept.map((e) => JSON.stringify(e)).join("\n")}\n`);
+        }
+        return removed;
+    }
+}
+/**
+ * Helper to create common events.
+ */
+export const createEvent = {
+    sessionStart: (sessionId, agent, data) => ({
+        type: "session:start",
+        session_id: sessionId,
+        agent,
+        data,
+    }),
+    heartbeat: (sessionId, agent, data) => ({
+        type: "session:heartbeat",
+        session_id: sessionId,
+        agent,
+        data,
+    }),
+    checkpoint: (sessionId, agent, data) => ({
+        type: "session:checkpoint",
+        session_id: sessionId,
+        agent,
+        data,
+    }),
+    complete: (sessionId, agent, data) => ({
+        type: "session:complete",
+        session_id: sessionId,
+        agent,
+        data,
+    }),
+    blocked: (sessionId, agent, data) => ({
+        type: "session:blocked",
+        session_id: sessionId,
+        agent,
+        data,
+    }),
+    taskStart: (sessionId, agent, data) => ({
+        type: "task:start",
+        session_id: sessionId,
+        agent,
+        data,
+    }),
+    taskComplete: (sessionId, agent, data) => ({
+        type: "task:complete",
+        session_id: sessionId,
+        agent,
+        data,
+    }),
+    previewCreated: (sessionId, agent, data) => ({
+        type: "preview:created",
+        session_id: sessionId,
+        agent,
+        data,
+    }),
+    resourceAcquired: (sessionId, agent, data) => ({
+        type: "resource:acquired",
+        session_id: sessionId,
+        agent,
+        data,
+    }),
+    resourceReleased: (sessionId, agent, data) => ({
+        type: "resource:released",
+        session_id: sessionId,
+        agent,
+        data,
+    }),
+};
+/**
+ * Generate a session ID.
+ */
+export function generateSessionId(project) {
+    const now = new Date();
+    const date = now.toISOString().slice(0, 10).replace(/-/g, "");
+    const time = now.toISOString().slice(11, 19).replace(/:/g, "");
+    const random = Math.random().toString(36).slice(2, 6);
+    return `${project}-${date}-${time}-${random}`;
+}

package/dist/lib/heartbeat.d.ts

@@ -0,0 +1,106 @@
+import { EventStore } from "./events.js";
+/**
+ * Session liveness state.
+ */
+export interface SessionLiveness {
+    session_id: string;
+    agent: string;
+    project: string;
+    issue?: string;
+    worktree?: string;
+    started_at: string;
+    last_heartbeat: string;
+    status: "active" | "idle" | "stale" | "dead";
+    current_task?: string;
+    pid?: number;
+}
+/**
+ * Heartbeat configuration.
+ */
+export interface HeartbeatConfig {
+    /** Heartbeat interval in milliseconds (default: 60000 = 1 min) */
+    interval_ms: number;
+    /** Time before session is considered stale (default: 300000 = 5 min) */
+    stale_threshold_ms: number;
+    /** Time before session is considered dead (default: 900000 = 15 min) */
+    dead_threshold_ms: number;
+}
+/**
+ * Session heartbeat manager.
+ */
+export declare class HeartbeatManager {
+    private basePath;
+    private config;
+    private eventStore;
+    private intervalId?;
+    constructor(basePath?: string, config?: Partial<HeartbeatConfig>, eventStore?: EventStore);
+    /**
+     * Get the heartbeat file path for a session.
+     */
+    private getHeartbeatPath;
+    /**
+     * Register a new session.
+     */
+    register(sessionId: string, agent: string, options: {
+        project: string;
+        issue?: string;
+        worktree?: string;
+        pid?: number;
+    }): SessionLiveness;
+    /**
+     * Send a heartbeat for a session.
+     */
+    heartbeat(sessionId: string, options?: {
+        status?: "active" | "idle";
+        current_task?: string;
+    }): SessionLiveness | undefined;
+    /**
+     * Get session liveness state.
+     */
+    get(sessionId: string): SessionLiveness | undefined;
+    /**
+     * Update status based on heartbeat age.
+     */
+    private updateStatus;
+    /**
+     * Deregister a session (on clean exit).
+     */
+    deregister(sessionId: string): void;
+    /**
+     * List all sessions for a project.
+     */
+    listSessions(project: string): SessionLiveness[];
+    /**
+     * List active sessions across all projects.
+     */
+    listActiveSessions(): SessionLiveness[];
+    /**
+     * List stale/dead sessions for cleanup.
+     */
+    listStaleSessions(): SessionLiveness[];
+    /**
+     * Clean up dead sessions.
+     */
+    cleanup(): number;
+    /**
+     * Check if a session is alive.
+     */
+    isAlive(sessionId: string): boolean;
+    /**
+     * Check if a worktree is in use.
+     */
+    isWorktreeInUse(worktree: string): SessionLiveness | undefined;
+    /**
+     * Start automatic heartbeat for current session.
+     */
+    startAutoHeartbeat(sessionId: string, getCurrentTask?: () => string | undefined): void;
+    /**
+     * Stop automatic heartbeat.
+     */
+    stopAutoHeartbeat(): void;
+    /**
+     * Extract project from session ID.
+     */
+    private extractProject;
+}
+//# sourceMappingURL=heartbeat.d.ts.map

package/dist/lib/heartbeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../src/lib/heartbeat.ts"],"names":[],"mappings":"AAUA,OAAO,EAAe,UAAU,EAAE,MAAM,aAAa,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,wEAAwE;IACxE,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAQD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,UAAU,CAAC,CAAiB;gBAGlC,QAAQ,GAAE,MAA4B,EACtC,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM,EACrC,UAAU,CAAC,EAAE,UAAU;IAWzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACH,QAAQ,CACN,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,GACA,eAAe;IAkBlB;;OAEG;IACH,SAAS,CACP,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;QAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;KAClB,GACL,eAAe,GAAG,SAAS;IAwB9B;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAUnD;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAOnC;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE;IAehD;;OAEG;IACH,kBAAkB,IAAI,eAAe,EAAE;IAkBvC;;OAEG;IACH,iBAAiB,IAAI,eAAe,EAAE;IAoBtC;;OAEG;IACH,OAAO,IAAI,MAAM;IAcjB;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAMnC;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAK9D;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,GAAG,IAAI;IAyBtF;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAOzB;;OAEG;IACH,OAAO,CAAC,cAAc;CAIvB"}