@generacy-ai/generacy-plugin-claude-code 0.0.0-preview-20260304013206

package/dist/session/session.js

@@ -0,0 +1,271 @@
+/**
+ * @generacy-ai/generacy-plugin-claude-code
+ *
+ * Session class implementing a finite state machine for session lifecycle.
+ */
+import { randomUUID } from 'crypto';
+import { SessionInvalidStateError, } from '../errors.js';
+import { isValidTransition, DEFAULT_INVOKE_OPTIONS, } from './types.js';
+/**
+ * Session class implementing a finite state machine.
+ * Manages session lifecycle with validated state transitions.
+ */
+export class Session {
+    data;
+    constructor(options) {
+        const now = new Date();
+        this.data = {
+            id: randomUUID(),
+            state: { status: 'created' },
+            containerConfig: options.containerConfig,
+            defaultOptions: options.defaultOptions ?? { ...DEFAULT_INVOKE_OPTIONS },
+            createdAt: now,
+            lastActiveAt: now,
+        };
+    }
+    /**
+     * Create a session with a specific ID (for testing or restoration).
+     */
+    static withId(id, options) {
+        const session = new Session(options);
+        session.data.id = id;
+        return session;
+    }
+    // ==========================================================================
+    // SessionInterface implementation (readonly properties)
+    // ==========================================================================
+    get id() {
+        return this.data.id;
+    }
+    get status() {
+        return this.data.state.status;
+    }
+    get createdAt() {
+        return this.data.createdAt;
+    }
+    get lastActiveAt() {
+        return this.data.lastActiveAt;
+    }
+    // ==========================================================================
+    // Internal state accessors
+    // ==========================================================================
+    get state() {
+        return this.data.state;
+    }
+    get containerConfig() {
+        return this.data.containerConfig;
+    }
+    get containerId() {
+        return this.data.containerId;
+    }
+    get invocationId() {
+        return this.data.invocationId;
+    }
+    get defaultOptions() {
+        return this.data.defaultOptions;
+    }
+    get pendingQuestion() {
+        return this.data.pendingQuestion;
+    }
+    // ==========================================================================
+    // State machine transitions
+    // ==========================================================================
+    /**
+     * Process an event and transition to a new state.
+     * Throws SessionInvalidStateError if the transition is invalid.
+     */
+    processEvent(event) {
+        const newState = this.computeNextState(event);
+        if (!isValidTransition(this.status, newState.status)) {
+            throw new SessionInvalidStateError(this.id, this.status, [newState.status], `process event ${event.type}`);
+        }
+        this.data.state = newState;
+        this.data.lastActiveAt = new Date();
+        // Update auxiliary data based on event
+        this.updateFromEvent(event);
+    }
+    /**
+     * Transition to running state when container starts.
+     */
+    onContainerStarted(containerId) {
+        this.processEvent({ type: 'CONTAINER_STARTED', containerId });
+    }
+    /**
+     * Transition to executing state when invocation starts.
+     */
+    onInvocationStarted(invocationId) {
+        this.processEvent({ type: 'INVOCATION_STARTED', invocationId });
+    }
+    /**
+     * Transition back to running state when invocation completes.
+     */
+    onInvocationCompleted() {
+        this.processEvent({ type: 'INVOCATION_COMPLETED' });
+    }
+    /**
+     * Transition to awaiting_input state when a question is received.
+     */
+    onQuestionReceived(question) {
+        this.processEvent({ type: 'QUESTION_RECEIVED', question });
+    }
+    /**
+     * Transition back from awaiting_input when answer is provided.
+     */
+    onAnswerProvided() {
+        this.processEvent({ type: 'ANSWER_PROVIDED' });
+    }
+    /**
+     * Transition to terminated state.
+     */
+    terminate(reason) {
+        // Allow termination from any non-terminated state
+        if (this.status === 'terminated') {
+            return; // Already terminated
+        }
+        this.data.state = { status: 'terminated', reason };
+        this.data.lastActiveAt = new Date();
+    }
+    // ==========================================================================
+    // Helper methods
+    // ==========================================================================
+    /**
+     * Update session data (partial update).
+     */
+    update(options) {
+        if (options.containerId !== undefined) {
+            this.data.containerId = options.containerId;
+        }
+        if (options.invocationId !== undefined) {
+            this.data.invocationId = options.invocationId;
+        }
+        if (options.pendingQuestion !== undefined) {
+            this.data.pendingQuestion = options.pendingQuestion ?? undefined;
+        }
+        if (options.defaultOptions !== undefined) {
+            this.data.defaultOptions = { ...this.data.defaultOptions, ...options.defaultOptions };
+        }
+        this.data.lastActiveAt = new Date();
+    }
+    /**
+     * Check if the session is in an active (non-terminated) state.
+     */
+    isActive() {
+        return this.status !== 'terminated';
+    }
+    /**
+     * Check if the session is ready to execute an invocation.
+     */
+    isReadyForInvocation() {
+        return this.status === 'running';
+    }
+    /**
+     * Check if the session is waiting for human input.
+     */
+    isAwaitingInput() {
+        return this.status === 'awaiting_input';
+    }
+    /**
+     * Check if the session has a running container.
+     */
+    hasRunningContainer() {
+        return ['running', 'executing', 'awaiting_input'].includes(this.status) &&
+            this.data.containerId !== undefined;
+    }
+    /**
+     * Get a summary of the session for external visibility.
+     */
+    getSummary() {
+        return {
+            id: this.id,
+            status: this.status,
+            isActive: this.isActive(),
+            containerId: this.containerId,
+            createdAt: this.createdAt,
+            lastActiveAt: this.lastActiveAt,
+        };
+    }
+    /**
+     * Export session data (for serialization).
+     */
+    toJSON() {
+        return { ...this.data };
+    }
+    // ==========================================================================
+    // Private methods
+    // ==========================================================================
+    /**
+     * Compute the next state based on the event.
+     */
+    computeNextState(event) {
+        switch (event.type) {
+            case 'CONTAINER_STARTED':
+                return { status: 'running', containerId: event.containerId };
+            case 'INVOCATION_STARTED':
+                if (this.status === 'running' || this.status === 'awaiting_input') {
+                    return {
+                        status: 'executing',
+                        invocationId: event.invocationId,
+                        containerId: this.getContainerIdOrThrow(),
+                    };
+                }
+                return this.data.state;
+            case 'INVOCATION_COMPLETED':
+                if (this.status === 'executing') {
+                    return { status: 'running', containerId: this.getContainerIdOrThrow() };
+                }
+                return this.data.state;
+            case 'QUESTION_RECEIVED':
+                if (this.status === 'executing' || this.status === 'running') {
+                    return {
+                        status: 'awaiting_input',
+                        question: event.question,
+                        containerId: this.getContainerIdOrThrow(),
+                    };
+                }
+                return this.data.state;
+            case 'ANSWER_PROVIDED':
+                if (this.status === 'awaiting_input') {
+                    return { status: 'running', containerId: this.getContainerIdOrThrow() };
+                }
+                return this.data.state;
+            case 'SESSION_ENDED':
+                return { status: 'terminated', reason: event.reason };
+        }
+    }
+    /**
+     * Update auxiliary data based on event.
+     */
+    updateFromEvent(event) {
+        switch (event.type) {
+            case 'CONTAINER_STARTED':
+                this.data.containerId = event.containerId;
+                break;
+            case 'INVOCATION_STARTED':
+                this.data.invocationId = event.invocationId;
+                break;
+            case 'INVOCATION_COMPLETED':
+                this.data.invocationId = undefined;
+                break;
+            case 'QUESTION_RECEIVED':
+                this.data.pendingQuestion = event.question;
+                break;
+            case 'ANSWER_PROVIDED':
+                this.data.pendingQuestion = undefined;
+                break;
+            case 'SESSION_ENDED':
+                // No auxiliary data updates needed
+                break;
+        }
+    }
+    /**
+     * Get container ID or throw if not available.
+     */
+    getContainerIdOrThrow() {
+        const containerId = this.data.containerId;
+        if (!containerId) {
+            throw new SessionInvalidStateError(this.id, this.status, ['running'], 'access container ID');
+        }
+        return containerId;
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session/session.js.map

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

package/dist/session/types.d.ts

@@ -0,0 +1,107 @@
+/**
+ * @generacy-ai/generacy-plugin-claude-code
+ *
+ * Internal types for session management.
+ */
+import type { SessionState, SessionStatus, InvokeOptions, ContainerConfig, QuestionPayload, TerminationReason } from '../types.js';
+export type { SessionState, SessionStatus, InvokeOptions, ContainerConfig, QuestionPayload, TerminationReason, };
+/**
+ * Valid state transitions for sessions.
+ * Maps from current state to valid next states.
+ */
+export declare const VALID_TRANSITIONS: Record<SessionStatus, SessionStatus[]>;
+/**
+ * Check if a state transition is valid.
+ */
+export declare function isValidTransition(from: SessionStatus, to: SessionStatus): boolean;
+/**
+ * Events that can trigger state transitions.
+ */
+export type SessionEvent = {
+    type: 'CONTAINER_STARTED';
+    containerId: string;
+} | {
+    type: 'INVOCATION_STARTED';
+    invocationId: string;
+} | {
+    type: 'INVOCATION_COMPLETED';
+} | {
+    type: 'QUESTION_RECEIVED';
+    question: QuestionPayload;
+} | {
+    type: 'ANSWER_PROVIDED';
+} | {
+    type: 'SESSION_ENDED';
+    reason: TerminationReason;
+};
+/**
+ * Internal session data stored by SessionManager.
+ */
+export interface SessionData {
+    /** Unique session identifier */
+    id: string;
+    /** Current session state */
+    state: SessionState;
+    /** Container configuration used for this session */
+    containerConfig: ContainerConfig;
+    /** Docker container ID when running */
+    containerId?: string;
+    /** Current invocation ID if executing */
+    invocationId?: string;
+    /** When the session was created */
+    createdAt: Date;
+    /** When the session was last active */
+    lastActiveAt: Date;
+    /** Default options for invocations in this session */
+    defaultOptions: InvokeOptions;
+    /** Pending question if in awaiting_input state */
+    pendingQuestion?: QuestionPayload;
+}
+/**
+ * Session creation options.
+ */
+export interface CreateSessionOptions {
+    /** Container configuration */
+    containerConfig: ContainerConfig;
+    /** Default invocation options */
+    defaultOptions?: InvokeOptions;
+}
+/**
+ * Session update options for partial updates.
+ */
+export interface UpdateSessionOptions {
+    /** Update container ID */
+    containerId?: string;
+    /** Update invocation ID */
+    invocationId?: string;
+    /** Update pending question */
+    pendingQuestion?: QuestionPayload | null;
+    /** Update default options */
+    defaultOptions?: InvokeOptions;
+}
+/**
+ * Session summary for external visibility.
+ */
+export interface SessionSummary {
+    /** Session ID */
+    id: string;
+    /** Current status */
+    status: SessionStatus;
+    /** Whether the session is active (not terminated) */
+    isActive: boolean;
+    /** Container ID if available */
+    containerId?: string;
+    /** Creation time */
+    createdAt: Date;
+    /** Last activity time */
+    lastActiveAt: Date;
+}
+/**
+ * Default session timeout in milliseconds (1 hour).
+ */
+export declare const DEFAULT_SESSION_TIMEOUT_MS = 3600000;
+/**
+ * Default invocation options.
+ */
+export declare const DEFAULT_INVOKE_OPTIONS: InvokeOptions;
+//# 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":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,YAAY,EACZ,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,iBAAiB,GAClB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,aAAa,EAAE,aAAa,EAAE,CAMpE,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,aAAa,GAAG,OAAO,CAEjF;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,sBAAsB,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,QAAQ,EAAE,eAAe,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAC3B;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IAEX,4BAA4B;IAC5B,KAAK,EAAE,YAAY,CAAC;IAEpB,oDAAoD;IACpD,eAAe,EAAE,eAAe,CAAC;IAEjC,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,mCAAmC;IACnC,SAAS,EAAE,IAAI,CAAC;IAEhB,uCAAuC;IACvC,YAAY,EAAE,IAAI,CAAC;IAEnB,sDAAsD;IACtD,cAAc,EAAE,aAAa,CAAC;IAE9B,kDAAkD;IAClD,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,8BAA8B;IAC9B,eAAe,EAAE,eAAe,CAAC;IAEjC,iCAAiC;IACjC,cAAc,CAAC,EAAE,aAAa,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,8BAA8B;IAC9B,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAEzC,6BAA6B;IAC7B,cAAc,CAAC,EAAE,aAAa,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iBAAiB;IACjB,EAAE,EAAE,MAAM,CAAC;IAEX,qBAAqB;IACrB,MAAM,EAAE,aAAa,CAAC;IAEtB,qDAAqD;IACrD,QAAQ,EAAE,OAAO,CAAC;IAElB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,oBAAoB;IACpB,SAAS,EAAE,IAAI,CAAC;IAEhB,yBAAyB;IACzB,YAAY,EAAE,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B,UAAU,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAEpC,CAAC"}

package/dist/session/types.js

@@ -0,0 +1,33 @@
+/**
+ * @generacy-ai/generacy-plugin-claude-code
+ *
+ * Internal types for session management.
+ */
+/**
+ * Valid state transitions for sessions.
+ * Maps from current state to valid next states.
+ */
+export const VALID_TRANSITIONS = {
+    created: ['running', 'terminated'],
+    running: ['executing', 'awaiting_input', 'terminated'],
+    executing: ['running', 'awaiting_input', 'terminated'],
+    awaiting_input: ['executing', 'running', 'terminated'],
+    terminated: [], // Terminal state - no transitions allowed
+};
+/**
+ * Check if a state transition is valid.
+ */
+export function isValidTransition(from, to) {
+    return VALID_TRANSITIONS[from]?.includes(to) ?? false;
+}
+/**
+ * Default session timeout in milliseconds (1 hour).
+ */
+export const DEFAULT_SESSION_TIMEOUT_MS = 3600000;
+/**
+ * Default invocation options.
+ */
+export const DEFAULT_INVOKE_OPTIONS = {
+    timeout: 300000, // 5 minutes
+};
+//# sourceMappingURL=types.js.map

package/dist/session/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/session/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqBH;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA2C;IACvE,OAAO,EAAE,CAAC,SAAS,EAAE,YAAY,CAAC;IAClC,OAAO,EAAE,CAAC,WAAW,EAAE,gBAAgB,EAAE,YAAY,CAAC;IACtD,SAAS,EAAE,CAAC,SAAS,EAAE,gBAAgB,EAAE,YAAY,CAAC;IACtD,cAAc,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,YAAY,CAAC;IACtD,UAAU,EAAE,EAAE,EAAE,0CAA0C;CAC3D,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAmB,EAAE,EAAiB;IACtE,OAAO,iBAAiB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC;AACxD,CAAC;AAgGD;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,OAAO,CAAC;AAElD;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD,OAAO,EAAE,MAAM,EAAE,YAAY;CAC9B,CAAC"}

package/dist/streaming/output-parser.d.ts

@@ -0,0 +1,91 @@
+/**
+ * @generacy-ai/generacy-plugin-claude-code
+ *
+ * Output parser for Claude Code JSON Lines format.
+ */
+import type { OutputChunk, UrgencyLevel } from '../types.js';
+import type { RawClaudeOutput } from './types.js';
+/**
+ * Parser for Claude Code JSON Lines output.
+ */
+export declare class OutputParser {
+    private state;
+    constructor();
+    /**
+     * Reset parser state.
+     */
+    reset(): void;
+    /**
+     * Parse a chunk of data (may contain multiple lines or partial lines).
+     */
+    parseChunk(data: string): OutputChunk[];
+    /**
+     * Flush any remaining buffered content.
+     */
+    flush(): OutputChunk[];
+    /**
+     * Parse a single line of JSON output.
+     */
+    parseLine(line: string): OutputChunk | null;
+    /**
+     * Parse a raw Claude output object into an OutputChunk.
+     */
+    parseRawOutput(raw: RawClaudeOutput): OutputChunk | null;
+    /**
+     * Create a stdout chunk from raw text.
+     */
+    createStdoutChunk(content: string): OutputChunk;
+    /**
+     * Create a stderr chunk from raw text.
+     */
+    createStderrChunk(content: string): OutputChunk;
+    /**
+     * Create an error chunk.
+     */
+    createErrorChunk(message: string, code?: string, isTransient?: boolean): OutputChunk;
+    /**
+     * Create a completion chunk.
+     */
+    createCompleteChunk(exitCode: number, summary?: string, filesModified?: string[]): OutputChunk;
+    /**
+     * Detect if a raw output is a question requiring human input.
+     */
+    isQuestion(raw: RawClaudeOutput): boolean;
+    /**
+     * Detect question patterns in content.
+     */
+    detectQuestionInContent(content: string): boolean;
+    /**
+     * Detect urgency level from content.
+     */
+    detectUrgency(raw: RawClaudeOutput): UrgencyLevel;
+    /**
+     * Create a question chunk.
+     */
+    private createQuestionChunk;
+    /**
+     * Extract the question text from content.
+     */
+    private extractQuestion;
+    /**
+     * Map raw type to OutputChunkType.
+     */
+    private mapType;
+    /**
+     * Build metadata for a chunk.
+     */
+    private buildMetadata;
+    /**
+     * Build data payload for a chunk.
+     */
+    private buildData;
+    /**
+     * Extract content from raw output.
+     */
+    private extractContent;
+    /**
+     * Check if a result indicates an error.
+     */
+    private isErrorResult;
+}
+//# sourceMappingURL=output-parser.d.ts.map

package/dist/streaming/output-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-parser.d.ts","sourceRoot":"","sources":["../../src/streaming/output-parser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,WAAW,EAIX,YAAY,EACb,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,YAAY,CAAC;AAOpB;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAc;;IAM3B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE;IAyBvC;;OAEG;IACH,KAAK,IAAI,WAAW,EAAE;IActB;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAU3C;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,eAAe,GAAG,WAAW,GAAG,IAAI;IAyBxD;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW;IAQ/C;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW;IAQ/C;;OAEG;IACH,gBAAgB,CACd,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,OAAO,GACpB,WAAW;IAYd;;OAEG;IACH,mBAAmB,CACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,WAAW;IAed;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO;IAmBzC;;OAEG;IACH,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAgBjD;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,eAAe,GAAG,YAAY;IAoBjD;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAuB3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAcvB;;OAEG;IACH,OAAO,CAAC,OAAO;IAIf;;OAEG;IACH,OAAO,CAAC,aAAa;IAyBrB;;OAEG;IACH,OAAO,CAAC,SAAS;IAqCjB;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;IACH,OAAO,CAAC,aAAa;CAgBtB"}