sylas-edge-worker 0.2.21

package/dist/AgentSessionManager.d.ts

@@ -0,0 +1,280 @@
+import { EventEmitter } from "node:events";
+import type { SDKMessage, SDKResultMessage, SDKSystemMessage } from "sylas-claude-runner";
+import { type IAgentRunner, type ILogger, type IssueMinimal, type SerializedSylasAgentSession, type SerializedSylasAgentSessionEntry, type SylasAgentSession, type SylasAgentSessionEntry, type Workspace } from "sylas-core";
+import type { ProcedureAnalyzer } from "./procedures/ProcedureAnalyzer.js";
+import type { SharedApplicationServer } from "./SharedApplicationServer.js";
+import type { IActivitySink } from "./sinks/index.js";
+/**
+ * Events emitted by AgentSessionManager
+ */
+export interface AgentSessionManagerEvents {
+    subroutineComplete: (data: {
+        sessionId: string;
+        session: SylasAgentSession;
+    }) => void;
+    /**
+     * Emitted when validation fails and we need to run the validation-fixer
+     * The EdgeWorker should respond by running the fixer prompt and then re-running verifications
+     */
+    validationLoopIteration: (data: {
+        sessionId: string;
+        session: SylasAgentSession;
+        /** The fixer prompt to run (already rendered with failure context) */
+        fixerPrompt: string;
+        /** Current iteration (1-based) */
+        iteration: number;
+        /** Maximum iterations allowed */
+        maxIterations: number;
+    }) => void;
+    /**
+     * Emitted when we need to re-run the verifications subroutine
+     */
+    validationLoopRerun: (data: {
+        sessionId: string;
+        session: SylasAgentSession;
+        /** Current iteration (1-based) */
+        iteration: number;
+    }) => void;
+}
+/**
+ * Type-safe event emitter interface for AgentSessionManager
+ */
+export declare interface AgentSessionManager {
+    on<K extends keyof AgentSessionManagerEvents>(event: K, listener: AgentSessionManagerEvents[K]): this;
+    emit<K extends keyof AgentSessionManagerEvents>(event: K, ...args: Parameters<AgentSessionManagerEvents[K]>): boolean;
+}
+/**
+ * Manages Agent Sessions integration with Claude Code SDK
+ * Transforms Claude streaming messages into Agent Session format
+ * Handles session lifecycle: create → active → complete/error
+ *
+ * CURRENTLY BEING HANDLED 'per repository'
+ */
+export declare class AgentSessionManager extends EventEmitter {
+    private logger;
+    private activitySink;
+    private sessions;
+    private entries;
+    private activeTasksBySession;
+    private toolCallsByToolUseId;
+    private taskSubjectsByToolUseId;
+    private taskSubjectsById;
+    private activeStatusActivitiesBySession;
+    private stopRequestedSessions;
+    private procedureAnalyzer?;
+    private sharedApplicationServer?;
+    private getParentSessionId?;
+    private resumeParentSession?;
+    constructor(activitySink: IActivitySink, getParentSessionId?: (childSessionId: string) => string | undefined, resumeParentSession?: (parentSessionId: string, prompt: string, childSessionId: string) => Promise<void>, procedureAnalyzer?: ProcedureAnalyzer, sharedApplicationServer?: SharedApplicationServer, logger?: ILogger);
+    /**
+     * Get a session-scoped logger with context (sessionId, platform, issueIdentifier).
+     */
+    private sessionLog;
+    /**
+     * Initialize an agent session from webhook
+     * The session is already created by the platform, we just need to track it
+     *
+     * @param sessionId - Internal session ID
+     * @param issueId - Issue/PR identifier
+     * @param issueMinimal - Minimal issue data
+     * @param workspace - Workspace configuration
+     * @param platform - Source platform ("linear", "github", "slack"). Defaults to "linear".
+     *                   Only "linear" sessions will have activities streamed to Linear.
+     */
+    createLinearAgentSession(sessionId: string, issueId: string, issueMinimal: IssueMinimal, workspace: Workspace, platform?: "linear" | "github" | "slack"): SylasAgentSession;
+    /**
+     * Create an agent session for chat-style platforms (Slack, etc.) that are
+     * not tied to a specific issue or repository.
+     *
+     * Unlike {@link createLinearAgentSession}, this does NOT require issue
+     * context — the session lives in a standalone workspace with no issue
+     * tracker linkage.
+     */
+    createChatSession(sessionId: string, workspace: Workspace, platform: string): SylasAgentSession;
+    /**
+     * Update Agent Session with session ID from system initialization
+     * Automatically detects whether it's Claude or Gemini based on the runner
+     */
+    updateAgentSessionWithClaudeSessionId(sessionId: string, claudeSystemMessage: SDKSystemMessage): void;
+    /**
+     * Create a session entry from user/assistant message (without syncing to Linear)
+     */
+    private createSessionEntry;
+    /**
+     * Complete a session from Claude result message
+     */
+    completeSession(sessionId: string, resultMessage: SDKResultMessage): Promise<void>;
+    private shouldRecoverFromPreviousSubroutine;
+    private consumeStopRequest;
+    requestSessionStop(linearAgentActivitySessionId: string): void;
+    /**
+     * Handle completion using procedure routing system
+     */
+    private handleProcedureCompletion;
+    /**
+     * Handle validation loop completion for subroutines that use usesValidationLoop
+     * Returns true if the validation loop took over control flow (needs fixer or retry)
+     * Returns false if validation passed or max retries reached (continue with normal advancement)
+     */
+    private handleValidationLoopCompletion;
+    /**
+     * Update validation loop state in session metadata
+     */
+    private updateValidationLoopState;
+    /**
+     * Clear validation loop state from session metadata
+     */
+    private clearValidationLoopState;
+    /**
+     * Handle child session completion and resume parent
+     */
+    private handleChildSessionCompletion;
+    /**
+     * Handle streaming Claude messages and route to appropriate methods
+     */
+    handleClaudeMessage(sessionId: string, message: SDKMessage): Promise<void>;
+    /**
+     * Update session status and metadata
+     */
+    private updateSessionStatus;
+    /**
+     * Add result entry from result message
+     */
+    private addResultEntry;
+    /**
+     * Extract content from Claude message
+     */
+    private extractContent;
+    /**
+     * Extract tool information from Claude assistant message
+     */
+    private extractToolInfo;
+    /**
+     * Extract tool_use_id and error status from Claude user message containing tool_result
+     */
+    private extractToolResultInfo;
+    /**
+     * Extract tool result content and error status from session entry
+     */
+    private extractToolResult;
+    /**
+     * Sync session entry to external tracker (create AgentActivity)
+     */
+    private syncEntryToActivitySink;
+    /**
+     * Get session by ID
+     */
+    getSession(sessionId: string): SylasAgentSession | undefined;
+    /**
+     * Get session entries by session ID
+     */
+    getSessionEntries(sessionId: string): SylasAgentSessionEntry[];
+    /**
+     * Get all active sessions
+     */
+    getActiveSessions(): SylasAgentSession[];
+    /**
+     * Add or update agent runner for a session
+     */
+    addAgentRunner(sessionId: string, agentRunner: IAgentRunner): void;
+    /**
+     *  Get all agent runners
+     */
+    getAllAgentRunners(): IAgentRunner[];
+    /**
+     * Resolve the issue ID from a session, checking issueContext first then deprecated issueId.
+     */
+    private getSessionIssueId;
+    /**
+     * Get all agent runners for a specific issue
+     */
+    getAgentRunnersForIssue(issueId: string): IAgentRunner[];
+    /**
+     * Get sessions by issue ID
+     */
+    getSessionsByIssueId(issueId: string): SylasAgentSession[];
+    /**
+     * Get active sessions by issue ID
+     */
+    getActiveSessionsByIssueId(issueId: string): SylasAgentSession[];
+    /**
+     * Get active sessions where the issue's branch name matches the given branch.
+     * Useful for detecting when multiple sessions share the same worktree.
+     */
+    getActiveSessionsByBranchName(branchName: string): SylasAgentSession[];
+    /**
+     * Get all sessions
+     */
+    getAllSessions(): SylasAgentSession[];
+    /**
+     * Get agent runner for a specific session
+     */
+    getAgentRunner(sessionId: string): IAgentRunner | undefined;
+    /**
+     * Check if an agent runner exists for a session
+     */
+    hasAgentRunner(sessionId: string): boolean;
+    /**
+     * Post an activity to the activity sink for a session.
+     * Consolidates session lookup, externalSessionId guard, try/catch, and logging.
+     *
+     * @returns The activity ID when resolved, `null` otherwise.
+     */
+    private postActivity;
+    /**
+     * Create a thought activity
+     */
+    createThoughtActivity(sessionId: string, body: string): Promise<void>;
+    /**
+     * Create an action activity
+     */
+    createActionActivity(sessionId: string, action: string, parameter: string, result?: string): Promise<void>;
+    /**
+     * Create a response activity
+     */
+    createResponseActivity(sessionId: string, body: string): Promise<void>;
+    /**
+     * Create an error activity
+     */
+    createErrorActivity(sessionId: string, body: string): Promise<void>;
+    /**
+     * Create an elicitation activity
+     */
+    createElicitationActivity(sessionId: string, body: string): Promise<void>;
+    /**
+     * Create an approval elicitation activity with auth signal
+     */
+    createApprovalElicitation(sessionId: string, body: string, approvalUrl: string): Promise<void>;
+    /**
+     * Clear completed sessions older than specified time
+     */
+    cleanup(olderThanMs?: number): void;
+    /**
+     * Serialize Agent Session state for persistence
+     */
+    serializeState(): {
+        sessions: Record<string, SerializedSylasAgentSession>;
+        entries: Record<string, SerializedSylasAgentSessionEntry[]>;
+    };
+    /**
+     * Restore Agent Session state from serialized data
+     */
+    restoreState(serializedSessions: Record<string, SerializedSylasAgentSession>, serializedEntries: Record<string, SerializedSylasAgentSessionEntry[]>): void;
+    /**
+     * Post a thought about the model being used
+     */
+    private postModelNotificationThought;
+    /**
+     * Post an ephemeral "Analyzing your request..." thought and return the activity ID
+     */
+    postAnalyzingThought(sessionId: string): Promise<string | null>;
+    /**
+     * Post the procedure selection result as a non-ephemeral thought
+     */
+    postProcedureSelectionThought(sessionId: string, procedureName: string, classification: string): Promise<void>;
+    /**
+     * Handle status messages (compacting, etc.)
+     */
+    private handleStatusMessage;
+}
+//# sourceMappingURL=AgentSessionManager.d.ts.map

package/dist/AgentSessionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentSessionManager.d.ts","sourceRoot":"","sources":["../src/AgentSessionManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAIX,UAAU,EACV,gBAAgB,EAEhB,gBAAgB,EAEhB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAIN,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,2BAA2B,EAChC,KAAK,gCAAgC,EACrC,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,SAAS,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,KAAK,EAGX,aAAa,EACb,MAAM,kBAAkB,CAAC;AAO1B;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACzC,kBAAkB,EAAE,CAAC,IAAI,EAAE;QAC1B,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,iBAAiB,CAAC;KAC3B,KAAK,IAAI,CAAC;IACX;;;OAGG;IACH,uBAAuB,EAAE,CAAC,IAAI,EAAE;QAC/B,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,iBAAiB,CAAC;QAC3B,sEAAsE;QACtE,WAAW,EAAE,MAAM,CAAC;QACpB,kCAAkC;QAClC,SAAS,EAAE,MAAM,CAAC;QAClB,iCAAiC;QACjC,aAAa,EAAE,MAAM,CAAC;KACtB,KAAK,IAAI,CAAC;IACX;;OAEG;IACH,mBAAmB,EAAE,CAAC,IAAI,EAAE;QAC3B,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,iBAAiB,CAAC;QAC3B,kCAAkC;QAClC,SAAS,EAAE,MAAM,CAAC;KAClB,KAAK,IAAI,CAAC;CACX;AAED;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,mBAAmB;IAC3C,EAAE,CAAC,CAAC,SAAS,MAAM,yBAAyB,EAC3C,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,yBAAyB,CAAC,CAAC,CAAC,GACpC,IAAI,CAAC;IACR,IAAI,CAAC,CAAC,SAAS,MAAM,yBAAyB,EAC7C,KAAK,EAAE,CAAC,EACR,GAAG,IAAI,EAAE,UAAU,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,GAC/C,OAAO,CAAC;CACX;AAED;;;;;;GAMG;AACH,qBAAa,mBAAoB,SAAQ,YAAY;IACpD,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,QAAQ,CAA6C;IAC7D,OAAO,CAAC,OAAO,CAAoD;IACnE,OAAO,CAAC,oBAAoB,CAAkC;IAC9D,OAAO,CAAC,oBAAoB,CACjB;IACX,OAAO,CAAC,uBAAuB,CAAkC;IACjE,OAAO,CAAC,gBAAgB,CAAkC;IAC1D,OAAO,CAAC,+BAA+B,CAAkC;IACzE,OAAO,CAAC,qBAAqB,CAA0B;IACvD,OAAO,CAAC,iBAAiB,CAAC,CAAoB;IAC9C,OAAO,CAAC,uBAAuB,CAAC,CAA0B;IAC1D,OAAO,CAAC,kBAAkB,CAAC,CAAiD;IAC5E,OAAO,CAAC,mBAAmB,CAAC,CAIT;gBAGlB,YAAY,EAAE,aAAa,EAC3B,kBAAkB,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,EACnE,mBAAmB,CAAC,EAAE,CACrB,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,KAClB,OAAO,CAAC,IAAI,CAAC,EAClB,iBAAiB,CAAC,EAAE,iBAAiB,EACrC,uBAAuB,CAAC,EAAE,uBAAuB,EACjD,MAAM,CAAC,EAAE,OAAO;IAWjB;;OAEG;IACH,OAAO,CAAC,UAAU;IASlB;;;;;;;;;;OAUG;IACH,wBAAwB,CACvB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,SAAS,EACpB,QAAQ,GAAE,QAAQ,GAAG,QAAQ,GAAG,OAAkB,GAChD,iBAAiB;IAkCpB;;;;;;;OAOG;IACH,iBAAiB,CAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,MAAM,GACd,iBAAiB;IAoBpB;;;OAGG;IACH,qCAAqC,CACpC,SAAS,EAAE,MAAM,EACjB,mBAAmB,EAAE,gBAAgB,GACnC,IAAI;IA4CP;;OAEG;YACW,kBAAkB;IAmEhC;;OAEG;IACG,eAAe,CACpB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,gBAAgB,GAC7B,OAAO,CAAC,IAAI,CAAC;IAiFhB,OAAO,CAAC,mCAAmC;IA0B3C,OAAO,CAAC,kBAAkB;IAS1B,kBAAkB,CAAC,4BAA4B,EAAE,MAAM,GAAG,IAAI;IAI9D;;OAEG;YACW,yBAAyB;IAgLvC;;;;OAIG;YACW,8BAA8B;IAgI5C;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAajC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAMhC;;OAEG;YACW,4BAA4B;IAuC1C;;OAEG;IACG,mBAAmB,CACxB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,UAAU,GACjB,OAAO,CAAC,IAAI,CAAC;IAyDhB;;OAEG;YACW,mBAAmB;IAkBjC;;OAEG;YACW,cAAc;IAsD5B;;OAEG;IACH,OAAO,CAAC,cAAc;IA8CtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAyBvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAmB7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;YACW,uBAAuB;IAmcrC;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAI5D;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,sBAAsB,EAAE;IAI9D;;OAEG;IACH,iBAAiB,IAAI,iBAAiB,EAAE;IAMxC;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,GAAG,IAAI;IAalE;;OAEG;IACH,kBAAkB,IAAI,YAAY,EAAE;IAMpC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE;IAOxD;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAM1D;;OAEG;IACH,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAQhE;;;OAGG;IACH,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAQtE;;OAEG;IACH,cAAc,IAAI,iBAAiB,EAAE;IAIrC;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAK3D;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAK1C;;;;;OAKG;YACW,YAAY;IAkD1B;;OAEG;IACG,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3E;;OAEG;IACG,oBAAoB,CACzB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAQhB;;OAEG;IACG,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5E;;OAEG;IACG,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzE;;OAEG;IACG,yBAAyB,CAC9B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC;IAQhB;;OAEG;IACG,yBAAyB,CAC9B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAYhB;;OAEG;IACH,OAAO,CAAC,WAAW,GAAE,MAA4B,GAAG,IAAI;IAgBxD;;OAEG;IACH,cAAc,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;QACtD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,gCAAgC,EAAE,CAAC,CAAC;KAC5D;IAqBD;;OAEG;IACH,YAAY,CACX,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,EAC/D,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,gCAAgC,EAAE,CAAC,GACnE,IAAI;IA4BP;;OAEG;YACW,4BAA4B;IAW1C;;OAEG;IACG,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAWrE;;OAEG;IACG,6BAA6B,CAClC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC;IAchB;;OAEG;YACW,mBAAmB;CA0CjC"}