sylas-edge-worker 0.2.21

package/dist/GlobalSessionRegistry.js

@@ -0,0 +1,254 @@
+/**
+ * GlobalSessionRegistry - Centralized session storage across all repositories
+ *
+ * This is Phase 1 of the CYPACK-724 architectural refactor.
+ * Replaces per-repository session storage in AgentSessionManager with a global registry
+ * that enables cross-repository session lookups (e.g., parent orchestrator in Repo A
+ * creating child issues in Repo B).
+ */
+import { EventEmitter } from "node:events";
+/**
+ * GlobalSessionRegistry centralizes all session storage across repositories.
+ *
+ * Responsibilities:
+ * - Store ALL SylasAgentSession objects (all repos)
+ * - Store ALL SylasAgentSessionEntry arrays (all repos)
+ * - Maintain parent-child session relationships
+ * - Emit lifecycle events for session changes
+ * - Support serialization/deserialization for persistence
+ * - Provide cleanup for old sessions
+ */
+export class GlobalSessionRegistry extends EventEmitter {
+    /**
+     * All sessions keyed by session id
+     */
+    sessions = new Map();
+    /**
+     * All entries keyed by session id
+     */
+    entries = new Map();
+    /**
+     * Child session ID → parent session ID mapping
+     * Enables orchestrator workflows where parent (Repo A) creates child (Repo B)
+     */
+    childToParentMap = new Map();
+    /**
+     * Create a new session in the registry
+     * @param session The session to create
+     * @throws Error if session with same ID already exists
+     */
+    createSession(session) {
+        if (this.sessions.has(session.id)) {
+            throw new Error(`Session with ID ${session.id} already exists`);
+        }
+        this.sessions.set(session.id, session);
+        this.entries.set(session.id, []);
+        this.emit("sessionCreated", session);
+    }
+    /**
+     * Get a session by ID
+     * @param sessionId The session id
+     * @returns The session or undefined if not found
+     */
+    getSession(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    /**
+     * Update a session with partial data
+     * @param sessionId The session id
+     * @param updates Partial session data to merge
+     * @throws Error if session doesn't exist
+     */
+    updateSession(sessionId, updates) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            throw new Error(`Session with ID ${sessionId} not found`);
+        }
+        const oldStatus = session.status;
+        const updatedSession = { ...session, ...updates, updatedAt: Date.now() };
+        this.sessions.set(sessionId, updatedSession);
+        this.emit("sessionUpdated", sessionId, updatedSession, updates);
+        // Emit completion event if status changed to complete/error
+        if (oldStatus !== updatedSession.status &&
+            (updatedSession.status === "complete" ||
+                updatedSession.status === "error")) {
+            this.emit("sessionCompleted", sessionId, updatedSession);
+        }
+    }
+    /**
+     * Delete a session and its entries
+     * @param sessionId The session id
+     */
+    deleteSession(sessionId) {
+        this.sessions.delete(sessionId);
+        this.entries.delete(sessionId);
+        // Clean up any parent-child mappings
+        this.childToParentMap.delete(sessionId);
+        const childMappings = Array.from(this.childToParentMap.entries());
+        for (const [childId, parentId] of childMappings) {
+            if (parentId === sessionId) {
+                this.childToParentMap.delete(childId);
+            }
+        }
+    }
+    /**
+     * Get all sessions
+     * @returns Array of all sessions
+     */
+    getAllSessions() {
+        return Array.from(this.sessions.values());
+    }
+    /**
+     * Add an entry to a session's conversation history
+     * @param sessionId The session id
+     * @param entry The entry to add
+     * @throws Error if session doesn't exist
+     */
+    addEntry(sessionId, entry) {
+        if (!this.sessions.has(sessionId)) {
+            throw new Error(`Session with ID ${sessionId} not found`);
+        }
+        const sessionEntries = this.entries.get(sessionId) || [];
+        sessionEntries.push(entry);
+        this.entries.set(sessionId, sessionEntries);
+        // Update session's updatedAt timestamp
+        const session = this.sessions.get(sessionId);
+        if (session) {
+            session.updatedAt = Date.now();
+        }
+    }
+    /**
+     * Get all entries for a session
+     * @param sessionId The session id
+     * @returns Array of entries (empty if session has no entries or doesn't exist)
+     */
+    getEntries(sessionId) {
+        return this.entries.get(sessionId) || [];
+    }
+    /**
+     * Update an entry in a session's conversation history
+     * @param sessionId The session id
+     * @param entryIndex The index of the entry to update (0-based)
+     * @param updates Partial entry data to merge
+     * @throws Error if session doesn't exist or index out of bounds
+     */
+    updateEntry(sessionId, entryIndex, updates) {
+        const sessionEntries = this.entries.get(sessionId);
+        if (!sessionEntries) {
+            throw new Error(`Session with ID ${sessionId} not found`);
+        }
+        if (entryIndex < 0 || entryIndex >= sessionEntries.length) {
+            throw new Error(`Entry index ${entryIndex} out of bounds for session ${sessionId} (length: ${sessionEntries.length})`);
+        }
+        const existingEntry = sessionEntries[entryIndex]; // Safe: bounds checked above
+        const updatedEntry = {
+            ...existingEntry,
+            ...updates,
+            // Ensure required fields are never undefined
+            type: updates.type ?? existingEntry.type,
+            content: updates.content ?? existingEntry.content,
+        };
+        sessionEntries[entryIndex] = updatedEntry;
+        // Update session's updatedAt timestamp
+        const session = this.sessions.get(sessionId);
+        if (session) {
+            session.updatedAt = Date.now();
+        }
+    }
+    /**
+     * Set parent session for a child session (orchestrator workflow)
+     * @param childSessionId The child's session id
+     * @param parentSessionId The parent's session id
+     */
+    setParentSession(childSessionId, parentSessionId) {
+        this.childToParentMap.set(childSessionId, parentSessionId);
+    }
+    /**
+     * Get parent session ID for a child session
+     * @param childSessionId The child's session id
+     * @returns The parent session ID or undefined if not found
+     */
+    getParentSessionId(childSessionId) {
+        return this.childToParentMap.get(childSessionId);
+    }
+    /**
+     * Get all child session IDs for a parent session
+     * @param parentSessionId The parent's session id
+     * @returns Array of child session IDs
+     */
+    getChildSessionIds(parentSessionId) {
+        const childIds = [];
+        const childMappings = Array.from(this.childToParentMap.entries());
+        for (const [childId, parentId] of childMappings) {
+            if (parentId === parentSessionId) {
+                childIds.push(childId);
+            }
+        }
+        return childIds;
+    }
+    /**
+     * Serialize the registry state for persistence
+     * Excludes non-serializable data like agentRunner instances
+     * @returns Serialized state
+     */
+    serializeState() {
+        const serializedSessions = {};
+        const sessionEntries = Array.from(this.sessions.entries());
+        for (const [sessionId, session] of sessionEntries) {
+            // Exclude non-serializable agentRunner
+            const { agentRunner: _agentRunner, ...serializableSession } = session;
+            serializedSessions[sessionId] = serializableSession;
+        }
+        const serializedEntries = Object.fromEntries(Array.from(this.entries.entries()));
+        const serializedChildToParent = Object.fromEntries(Array.from(this.childToParentMap.entries()));
+        return {
+            version: "3.0",
+            sessions: serializedSessions,
+            entries: serializedEntries,
+            childToParentMap: serializedChildToParent,
+        };
+    }
+    /**
+     * Restore the registry state from serialized data
+     * Clears existing state before restoring
+     * @param state Serialized state to restore
+     */
+    restoreState(state) {
+        // Clear existing state
+        this.sessions.clear();
+        this.entries.clear();
+        this.childToParentMap.clear();
+        // Restore sessions
+        for (const [sessionId, session] of Object.entries(state.sessions)) {
+            this.sessions.set(sessionId, session);
+        }
+        // Restore entries
+        for (const [sessionId, entries] of Object.entries(state.entries)) {
+            this.entries.set(sessionId, entries);
+        }
+        // Restore parent-child mapping
+        for (const [childId, parentId] of Object.entries(state.childToParentMap)) {
+            this.childToParentMap.set(childId, parentId);
+        }
+    }
+    /**
+     * Clean up old sessions based on age
+     * Removes sessions where updatedAt is older than maxAgeMs
+     * @param maxAgeMs Maximum age in milliseconds (sessions older than this are removed)
+     * @returns Number of sessions removed
+     */
+    cleanup(maxAgeMs) {
+        const now = Date.now();
+        const cutoffTime = now - maxAgeMs;
+        let removedCount = 0;
+        const sessionEntries = Array.from(this.sessions.entries());
+        for (const [sessionId, session] of sessionEntries) {
+            if (session.updatedAt < cutoffTime) {
+                this.deleteSession(sessionId);
+                removedCount++;
+            }
+        }
+        return removedCount;
+    }
+}
+//# sourceMappingURL=GlobalSessionRegistry.js.map

package/dist/GlobalSessionRegistry.js.map

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

package/dist/PromptBuilder.d.ts

@@ -0,0 +1,175 @@
+import type { Comment, EdgeWorkerConfig, GuidanceRule, IIssueTrackerService, ILogger, Issue, IssueMinimal, RepositoryConfig, WebhookAgentSession, WebhookComment } from "sylas-core";
+import type { GitService } from "./GitService.js";
+import type { SubroutineDefinition } from "./procedures/index.js";
+/**
+ * Dependencies required by the PromptBuilder
+ */
+export interface PromptBuilderDeps {
+    logger: ILogger;
+    repositories: Map<string, RepositoryConfig>;
+    issueTrackers: Map<string, IIssueTrackerService>;
+    gitService: GitService;
+    config: EdgeWorkerConfig;
+}
+/**
+ * System prompt result from label-based determination
+ */
+export interface SystemPromptResult {
+    prompt: string;
+    version?: string;
+    type?: "debugger" | "builder" | "scoper" | "orchestrator" | "graphite-orchestrator";
+}
+/**
+ * Result from building a prompt (prompt text + optional version)
+ */
+export interface PromptResult {
+    prompt: string;
+    version?: string;
+}
+/**
+ * Responsible for building various prompt types used in the EdgeWorker.
+ *
+ * Extracted from EdgeWorker to improve separation of concerns.
+ * Handles label-based prompts, mention prompts, issue context prompts,
+ * issue update prompts, subroutine prompt loading, and related utilities.
+ */
+export declare class PromptBuilder {
+    private readonly logger;
+    private readonly repositories;
+    private readonly issueTrackers;
+    private readonly gitService;
+    private readonly config;
+    constructor(deps: PromptBuilderDeps);
+    /**
+     * Determine system prompt based on issue labels and repository configuration
+     */
+    determineSystemPromptFromLabels(labels: string[], repository: RepositoryConfig): Promise<SystemPromptResult | undefined>;
+    /**
+     * Build simplified prompt for label-based workflows
+     * @param issue Full Linear issue
+     * @param repository Repository configuration
+     * @param attachmentManifest Optional attachment manifest
+     * @param guidance Optional agent guidance rules from Linear
+     * @returns Formatted prompt string
+     */
+    buildLabelBasedPrompt(issue: Issue, repository: RepositoryConfig, attachmentManifest?: string, guidance?: GuidanceRule[]): Promise<PromptResult>;
+    /**
+     * Generate routing context for orchestrator mode
+     *
+     * This provides the orchestrator with information about available repositories
+     * and how to route sub-issues to them. The context includes:
+     * - List of configured repositories in the workspace
+     * - Routing rules for each repository (labels, teams, projects)
+     * - Instructions on using description tags for explicit routing
+     *
+     * @param currentRepository The repository handling the current orchestrator issue
+     * @returns XML-formatted routing context string, or empty string if no routing info available
+     */
+    generateRoutingContext(currentRepository: RepositoryConfig): string;
+    /**
+     * Build prompt for mention-triggered sessions
+     * @param issue Full Linear issue object
+     * @param agentSession The agent session containing the mention
+     * @param attachmentManifest Optional attachment manifest to append
+     * @param guidance Optional agent guidance rules from Linear
+     * @returns The constructed prompt and optional version tag
+     */
+    buildMentionPrompt(issue: Issue, agentSession: WebhookAgentSession, attachmentManifest?: string, guidance?: GuidanceRule[]): Promise<PromptResult>;
+    /**
+     * Build a prompt for Claude using the improved XML-style template
+     * @param issue Full Linear issue
+     * @param repository Repository configuration
+     * @param newComment Optional new comment to focus on (for handleNewRootComment)
+     * @param attachmentManifest Optional attachment manifest
+     * @param guidance Optional agent guidance rules from Linear
+     * @returns Formatted prompt string
+     */
+    buildIssueContextPrompt(issue: Issue, repository: RepositoryConfig, newComment?: WebhookComment, attachmentManifest?: string, guidance?: GuidanceRule[]): Promise<PromptResult>;
+    /**
+     * Build XML-formatted prompt for issue content updates (title/description/attachments)
+     *
+     * The prompt clearly shows what fields changed by comparing old vs new values,
+     * and includes guidance for the agent to evaluate whether these changes affect
+     * its current implementation or action plan.
+     */
+    buildIssueUpdatePrompt(issueIdentifier: string, issueData: {
+        title: string;
+        description?: string | null;
+        attachments?: unknown;
+    }, updatedFrom: {
+        title?: string;
+        description?: string;
+        attachments?: unknown;
+    }): string;
+    /**
+     * Format Linear comments into a threaded structure that mirrors the Linear UI
+     * @param comments Array of Linear comments
+     * @returns Formatted string showing comment threads
+     */
+    formatCommentThreads(comments: Comment[]): Promise<string>;
+    /**
+     * Format agent guidance rules as markdown for injection into prompts
+     * @param guidance Array of guidance rules from Linear
+     * @returns Formatted markdown string with guidance, or empty string if no guidance
+     */
+    formatAgentGuidance(guidance?: GuidanceRule[]): string;
+    /**
+     * Extract version tag from template content
+     * @param templateContent The template content to parse
+     * @returns The version value if found, undefined otherwise
+     */
+    extractVersionTag(templateContent: string): string | undefined;
+    /**
+     * Load a subroutine prompt file
+     * Extracted helper to make prompt assembly more readable
+     */
+    loadSubroutinePrompt(subroutine: SubroutineDefinition, workspaceSlug?: string): Promise<string | null>;
+    /**
+     * Load shared instructions that get appended to all system prompts
+     */
+    loadSharedInstructions(): Promise<string>;
+    /**
+     * Determine the base branch for an issue, considering parent issues and blocked-by relationships
+     *
+     * Priority order:
+     * 1. If issue has graphite label AND has a "blocked by" relationship, use the blocking issue's branch
+     *    (This enables Graphite stacking where each sub-issue branches off the previous)
+     * 2. If issue has a parent, use the parent's branch
+     * 3. Fall back to repository's default base branch
+     */
+    determineBaseBranch(issue: Issue, repository: RepositoryConfig): Promise<string>;
+    /**
+     * Check if an issue has the graphite label
+     *
+     * @param issue The issue to check
+     * @param repository The repository configuration
+     * @returns True if the issue has the graphite label
+     */
+    hasGraphiteLabel(issue: Issue, repository: RepositoryConfig): Promise<boolean>;
+    /**
+     * Fetch issues that block this issue (i.e., issues this one is "blocked by")
+     * Uses the inverseRelations field with type "blocks"
+     *
+     * Linear relations work like this:
+     * - When Issue A "blocks" Issue B, a relation is created with:
+     *   - issue = A (the blocker)
+     *   - relatedIssue = B (the blocked one)
+     *   - type = "blocks"
+     *
+     * So to find "who blocks Issue B", we need inverseRelations (where B is the relatedIssue)
+     * and look for type === "blocks", then get the `issue` field (the blocker).
+     *
+     * @param issue The issue to fetch blocking issues for
+     * @returns Array of issues that block this one, or empty array if none
+     */
+    fetchBlockingIssues(issue: Issue): Promise<Issue[]>;
+    /**
+     * Convert full Linear SDK issue to CoreIssue interface for Session creation
+     */
+    convertLinearIssueToCore(issue: Issue): IssueMinimal;
+    /**
+     * Fetch issue labels for a given issue
+     */
+    fetchIssueLabels(issue: Issue): Promise<string[]>;
+}
+//# sourceMappingURL=PromptBuilder.d.ts.map

package/dist/PromptBuilder.d.ts.map

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