@eddacraft/kindling-adapter-opencode 0.1.0

package/dist/opencode/session.d.ts

@@ -0,0 +1,108 @@
+/**
+ * OpenCode session lifecycle management
+ *
+ * Manages the lifecycle of session capsules:
+ * - onSessionStart: Opens a new capsule
+ * - onEvent: Maps events and attaches observations
+ * - onSessionEnd: Closes the capsule
+ */
+import type { Capsule, CapsuleStore, Observation, ID } from '@eddacraft/kindling-core';
+import type { OpenCodeEvent } from './events.js';
+/**
+ * Session context tracking active session state
+ */
+export interface SessionContext {
+    sessionId: string;
+    repoId?: string;
+    activeCapsuleId: ID;
+    eventCount: number;
+}
+/**
+ * Options for starting a session
+ */
+export interface SessionStartOptions {
+    sessionId: string;
+    intent?: string;
+    repoId?: string;
+}
+/**
+ * Signals for ending a session
+ */
+export interface SessionEndSignals {
+    reason?: string;
+    summaryContent?: string;
+    summaryConfidence?: number;
+    evidenceRefs?: ID[];
+}
+/**
+ * Result of processing an event
+ */
+export interface EventProcessingResult {
+    observation?: Observation;
+    skipped?: boolean;
+    error?: string;
+}
+/**
+ * SessionManager manages OpenCode session lifecycles
+ *
+ * Provides hooks for session start, event processing, and session end.
+ * Each session gets its own capsule that collects observations.
+ */
+export declare class SessionManager {
+    private store;
+    private activeSessions;
+    constructor(store: CapsuleStore & {
+        insertObservation(observation: Observation): void;
+        attachObservationToCapsule(capsuleId: ID, observationId: ID): void;
+    });
+    /**
+     * Start a new session
+     *
+     * Opens a capsule for the session. If a session already has an open capsule,
+     * returns the existing context.
+     *
+     * @param options - Session start options
+     * @returns Session context
+     */
+    onSessionStart(options: SessionStartOptions): SessionContext;
+    /**
+     * Process an event from the session
+     *
+     * Maps the event to an observation and attaches it to the active capsule.
+     *
+     * @param event - OpenCode event to process
+     * @returns Processing result with observation or skip/error
+     */
+    onEvent(event: OpenCodeEvent): EventProcessingResult;
+    /**
+     * End a session
+     *
+     * Closes the active capsule for the session.
+     *
+     * @param sessionId - Session ID to end
+     * @param signals - Optional signals for capsule closure
+     * @returns Closed capsule
+     */
+    onSessionEnd(sessionId: string, signals?: SessionEndSignals): Capsule;
+    /**
+     * Get active session context
+     *
+     * @param sessionId - Session ID
+     * @returns Session context or undefined
+     */
+    getSession(sessionId: string): SessionContext | undefined;
+    /**
+     * Check if session is active
+     *
+     * @param sessionId - Session ID
+     * @returns True if session has an active capsule
+     */
+    isSessionActive(sessionId: string): boolean;
+    /**
+     * Get all active session IDs
+     *
+     * @returns Array of active session IDs
+     */
+    getActiveSessions(): string[];
+}
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/opencode/session.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,EAAE,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IAIvB,OAAO,CAAC,KAAK;IAHf,OAAO,CAAC,cAAc,CAA0C;gBAGtD,KAAK,EAAE,YAAY,GAAG;QAC5B,iBAAiB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;QAClD,0BAA0B,CAAC,SAAS,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,GAAG,IAAI,CAAC;KACpE;IAGH;;;;;;;;OAQG;IACH,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,cAAc;IAkD5D;;;;;;;OAOG;IACH,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,qBAAqB;IA+CpD;;;;;;;;OAQG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO;IA6CrE;;;;;OAKG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIzD;;;;;OAKG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI3C;;;;OAIG;IACH,iBAAiB,IAAI,MAAM,EAAE;CAG9B"}

package/dist/opencode/session.js

@@ -0,0 +1,194 @@
+/**
+ * OpenCode session lifecycle management
+ *
+ * Manages the lifecycle of session capsules:
+ * - onSessionStart: Opens a new capsule
+ * - onEvent: Maps events and attaches observations
+ * - onSessionEnd: Closes the capsule
+ */
+import { randomUUID } from 'crypto';
+import { mapEvent } from './mapping.js';
+/**
+ * SessionManager manages OpenCode session lifecycles
+ *
+ * Provides hooks for session start, event processing, and session end.
+ * Each session gets its own capsule that collects observations.
+ */
+export class SessionManager {
+    store;
+    activeSessions = new Map();
+    constructor(store) {
+        this.store = store;
+    }
+    /**
+     * Start a new session
+     *
+     * Opens a capsule for the session. If a session already has an open capsule,
+     * returns the existing context.
+     *
+     * @param options - Session start options
+     * @returns Session context
+     */
+    onSessionStart(options) {
+        const { sessionId, intent = 'OpenCode session', repoId } = options;
+        // Check if session already has an open capsule
+        const existing = this.activeSessions.get(sessionId);
+        if (existing) {
+            return existing;
+        }
+        // Check store for existing open capsule
+        const existingCapsule = this.store.getOpenCapsuleForSession(sessionId);
+        if (existingCapsule) {
+            const context = {
+                sessionId,
+                repoId,
+                activeCapsuleId: existingCapsule.id,
+                eventCount: existingCapsule.observationIds.length,
+            };
+            this.activeSessions.set(sessionId, context);
+            return context;
+        }
+        // Create new capsule
+        const capsuleId = randomUUID();
+        const capsule = {
+            id: capsuleId,
+            type: 'session',
+            intent,
+            status: 'open',
+            openedAt: Date.now(),
+            scopeIds: {
+                sessionId,
+                ...(repoId && { repoId }),
+            },
+            observationIds: [],
+        };
+        this.store.createCapsule(capsule);
+        const context = {
+            sessionId,
+            repoId,
+            activeCapsuleId: capsuleId,
+            eventCount: 0,
+        };
+        this.activeSessions.set(sessionId, context);
+        return context;
+    }
+    /**
+     * Process an event from the session
+     *
+     * Maps the event to an observation and attaches it to the active capsule.
+     *
+     * @param event - OpenCode event to process
+     * @returns Processing result with observation or skip/error
+     */
+    onEvent(event) {
+        // Get active session context
+        const context = this.activeSessions.get(event.sessionId);
+        if (!context) {
+            return {
+                error: `No active session found for sessionId: ${event.sessionId}`,
+            };
+        }
+        // Map event to observation
+        const mapResult = mapEvent(event);
+        // Handle skip (e.g., session_start/session_end events)
+        if (mapResult.skip) {
+            return { skipped: true };
+        }
+        // Handle mapping errors
+        if (mapResult.error) {
+            return { error: mapResult.error };
+        }
+        if (!mapResult.observation) {
+            return { error: 'Mapping produced no observation' };
+        }
+        // Generate observation ID and timestamp
+        const observation = {
+            id: randomUUID(),
+            ts: event.timestamp,
+            redacted: false,
+            provenance: {},
+            ...mapResult.observation,
+        };
+        // Store observation
+        this.store.insertObservation(observation);
+        // Attach to capsule
+        this.store.attachObservationToCapsule(context.activeCapsuleId, observation.id);
+        // Update context
+        context.eventCount += 1;
+        return { observation };
+    }
+    /**
+     * End a session
+     *
+     * Closes the active capsule for the session.
+     *
+     * @param sessionId - Session ID to end
+     * @param signals - Optional signals for capsule closure
+     * @returns Closed capsule
+     */
+    onSessionEnd(sessionId, signals) {
+        const context = this.activeSessions.get(sessionId);
+        if (!context) {
+            throw new Error(`No active session found for sessionId: ${sessionId}`);
+        }
+        const closedAt = Date.now();
+        // Close capsule in store
+        this.store.closeCapsule(context.activeCapsuleId, closedAt);
+        // If summary provided, insert it
+        if (signals?.summaryContent) {
+            const summary = {
+                id: randomUUID(),
+                capsuleId: context.activeCapsuleId,
+                content: signals.summaryContent,
+                confidence: signals.summaryConfidence ?? 0.8,
+                createdAt: closedAt,
+                evidenceRefs: signals.evidenceRefs ?? [],
+            };
+            this.store.insertSummary(summary);
+        }
+        // Remove from active sessions
+        this.activeSessions.delete(sessionId);
+        // Return closed capsule
+        const capsule = {
+            id: context.activeCapsuleId,
+            type: 'session',
+            intent: 'OpenCode session',
+            status: 'closed',
+            openedAt: 0, // Will be filled from store if needed
+            closedAt,
+            scopeIds: {
+                sessionId,
+                ...(context.repoId && { repoId: context.repoId }),
+            },
+            observationIds: [],
+        };
+        return capsule;
+    }
+    /**
+     * Get active session context
+     *
+     * @param sessionId - Session ID
+     * @returns Session context or undefined
+     */
+    getSession(sessionId) {
+        return this.activeSessions.get(sessionId);
+    }
+    /**
+     * Check if session is active
+     *
+     * @param sessionId - Session ID
+     * @returns True if session has an active capsule
+     */
+    isSessionActive(sessionId) {
+        return this.activeSessions.has(sessionId);
+    }
+    /**
+     * Get all active session IDs
+     *
+     * @returns Array of active session IDs
+     */
+    getActiveSessions() {
+        return Array.from(this.activeSessions.keys());
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/opencode/session.js.map

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

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@eddacraft/kindling-adapter-opencode",
+  "version": "0.1.0",
+  "description": "OpenCode session adapter for Kindling - capture tool calls, commands, and file changes from AI coding sessions",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "kindling",
+    "opencode",
+    "adapter",
+    "session",
+    "ai",
+    "coding",
+    "tool-calls",
+    "memory"
+  ],
+  "author": "EddaCraft <hello@eddacraft.ai>",
+  "homepage": "https://github.com/EddaCraft/kindling/tree/main/packages/kindling-adapter-opencode#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/EddaCraft/kindling.git",
+    "directory": "packages/kindling-adapter-opencode"
+  },
+  "bugs": {
+    "url": "https://github.com/EddaCraft/kindling/issues"
+  },
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@eddacraft/kindling-core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.0",
+    "vitest": "^3.2.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint src",
+    "clean": "rm -rf dist"
+  }
+}