@gracefultools/astrid-sdk 0.7.16 → 0.8.0

package/dist/executors/terminal-base.d.ts

@@ -1,207 +0,0 @@
-/**
- * Terminal Executor Base Interface
- *
- * Common interface for all terminal executors (Claude, OpenAI, Gemini).
- * Terminal mode executes tasks using local tools instead of remote APIs.
- */
-import type { Session } from '../server/session-manager.js';
-/**
- * Result from terminal execution
- */
-export interface TerminalExecutionResult {
-    exitCode: number | null;
-    stdout: string;
-    stderr: string;
-    sessionId?: string;
-    gitDiff?: string;
-    modifiedFiles?: string[];
-    prUrl?: string;
-}
-/**
- * Context for terminal task execution
- */
-export interface TerminalTaskContext {
-    comments?: Array<{
-        authorName: string;
-        content: string;
-        createdAt: string;
-    }>;
-    prUrl?: string;
-    repository?: string;
-}
-/**
- * Parsed output from terminal execution
- */
-export interface ParsedOutput {
-    summary?: string;
-    files?: string[];
-    prUrl?: string;
-    error?: string;
-}
-/**
- * Progress callback function
- */
-export type TerminalProgressCallback = (message: string) => void;
-/**
- * Comment callback function for posting updates to the task
- */
-export type TerminalCommentCallback = (content: string) => Promise<void>;
-/**
- * Options for terminal executor callbacks
- */
-export interface TerminalExecutorCallbacks {
-    onProgress?: TerminalProgressCallback;
-    onComment?: TerminalCommentCallback;
-}
-/**
- * Common interface for all terminal executors.
- *
- * Terminal executors process tasks using local tool execution:
- * - Claude: Spawns local Claude Code CLI
- * - OpenAI: Uses OpenAI API with local tool execution
- * - Gemini: Uses Gemini API with local tool execution
- */
-export interface TerminalExecutor {
-    /**
-     * Check if the executor is available (e.g., CLI installed, API key set)
-     */
-    checkAvailable(): Promise<boolean>;
-    /**
-     * Start a new session to process a task
-     *
-     * @param session - The session containing task details
-     * @param prompt - Optional custom prompt (uses default if not provided)
-     * @param context - Optional context including comments and PR info
-     * @param callbacks - Optional callbacks for progress updates and comments
-     * @returns Execution result with output, modified files, and PR URL
-     */
-    startSession(session: Session, prompt?: string, context?: TerminalTaskContext, callbacks?: TerminalExecutorCallbacks): Promise<TerminalExecutionResult>;
-    /**
-     * Resume an existing session with new input
-     *
-     * @param session - The session to resume
-     * @param input - New input from user (e.g., follow-up message)
-     * @param context - Optional updated context
-     * @param callbacks - Optional callbacks for progress updates and comments
-     * @returns Execution result
-     */
-    resumeSession(session: Session, input: string, context?: TerminalTaskContext, callbacks?: TerminalExecutorCallbacks): Promise<TerminalExecutionResult>;
-    /**
-     * Parse output to extract key information
-     *
-     * @param output - Raw output string from execution
-     * @returns Parsed output with summary, files, PR URL, and error
-     */
-    parseOutput(output: string): ParsedOutput;
-}
-/**
- * Extract PR URL from output text
- */
-export declare function extractPrUrl(output: string): string | undefined;
-/**
- * Format comment history for context
- */
-export declare function formatCommentHistory(comments?: TerminalTaskContext['comments']): string;
-/**
- * Capture current git status (untracked and modified files)
- * Call this BEFORE task execution to get baseline
- */
-export declare function captureGitBaseline(projectPath: string): Promise<Set<string>>;
-/**
- * Capture git changes in a repository
- * If baseline is provided, only returns NEW changes (not pre-existing)
- */
-export declare function captureGitChanges(projectPath: string, baseline?: Set<string>): Promise<{
-    diff: string;
-    files: string[];
-}>;
-/**
- * Build default prompt for a task
- */
-export declare function buildDefaultPrompt(session: Session, context?: TerminalTaskContext): string;
-/**
- * Types of content detected in Claude's output
- */
-export type OutputContentType = 'plan' | 'question' | 'progress' | 'error' | 'pr_created';
-/**
- * Detected content from parsing output
- */
-export interface DetectedContent {
-    type: OutputContentType;
-    content: string;
-    raw?: string;
-}
-/**
- * Parser state for accumulating output across chunks
- */
-export interface OutputParserState {
-    buffer: string;
-    lastPlanPosted: number;
-    lastProgressPosted: number;
-    lastQuestionPosted: number;
-    postedPlans: Set<string>;
-    postedQuestions: Set<string>;
-}
-/**
- * Create a new parser state
- */
-export declare function createParserState(): OutputParserState;
-/**
- * Parse a chunk of output and detect any plans, questions, or progress updates.
- * Uses the state to track what's been posted to avoid duplicates.
- *
- * @param chunk - New output chunk to parse
- * @param state - Parser state for tracking
- * @returns Array of detected content items
- */
-export declare function parseOutputChunk(chunk: string, state: OutputParserState): DetectedContent[];
-/**
- * Format detected content as a comment for posting
- */
-export declare function formatContentAsComment(content: DetectedContent, agentName?: string): string;
-/**
- * Configuration for worktree isolation
- */
-export interface WorktreeConfig {
-    /** Enable worktree isolation (default: true for safety) */
-    enabled: boolean;
-    /** Base directory for worktrees (default: /tmp/astrid-worktrees) */
-    baseDir: string;
-    /** Clean up worktrees after completion (default: true) */
-    autoCleanup: boolean;
-}
-/**
- * Get worktree configuration from environment variables
- */
-export declare function getWorktreeConfig(): WorktreeConfig;
-/**
- * Result from creating a worktree
- */
-export interface WorktreeResult {
-    /** Path to the worktree directory */
-    worktreePath: string;
-    /** Branch name created for this worktree */
-    branchName: string;
-    /** Cleanup function to remove the worktree */
-    cleanup: () => Promise<void>;
-}
-/**
- * Create an isolated git worktree for a task.
- * This allows the agent to work on changes without affecting the main working directory.
- *
- * @param projectPath - Path to the main git repository
- * @param taskId - Task ID for naming the worktree and branch
- * @param branchPrefix - Prefix for the branch name (default: 'task/')
- * @returns WorktreeResult with path and cleanup function
- */
-export declare function createWorktree(projectPath: string, taskId: string, branchPrefix?: string): Promise<WorktreeResult>;
-/**
- * Check if worktree isolation should be used
- */
-export declare function shouldUseWorktree(): boolean;
-/**
- * Push changes from worktree and create PR
- * Returns the PR URL if successful
- */
-export declare function pushWorktreeChanges(worktreePath: string, branchName: string, taskTitle: string): Promise<string | undefined>;
-//# sourceMappingURL=terminal-base.d.ts.map

package/dist/executors/terminal-base.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"terminal-base.d.ts","sourceRoot":"","sources":["../../src/executors/terminal-base.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAM3D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,KAAK,CAAC;QACf,UAAU,EAAE,MAAM,CAAA;QAClB,OAAO,EAAE,MAAM,CAAA;QACf,SAAS,EAAE,MAAM,CAAA;KAClB,CAAC,CAAA;IACF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;AAEhE;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAExE;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,UAAU,CAAC,EAAE,wBAAwB,CAAA;IACrC,SAAS,CAAC,EAAE,uBAAuB,CAAA;CACpC;AAMD;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IAElC;;;;;;;;OAQG;IACH,YAAY,CACV,OAAO,EAAE,OAAO,EAChB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,mBAAmB,EAC7B,SAAS,CAAC,EAAE,yBAAyB,GACpC,OAAO,CAAC,uBAAuB,CAAC,CAAA;IAEnC;;;;;;;;OAQG;IACH,aAAa,CACX,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,mBAAmB,EAC7B,SAAS,CAAC,EAAE,yBAAyB,GACpC,OAAO,CAAC,uBAAuB,CAAC,CAAA;IAEnC;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAAA;CAC1C;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAe/D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAC,UAAU,CAAC,GAAG,MAAM,CASvF;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAsBlF;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACrB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAgD5C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,MAAM,CAyBR;AAMD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,YAAY,CAAA;AAEzF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,iBAAiB,CAAA;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,MAAM,CAAA;IACtB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,kBAAkB,EAAE,MAAM,CAAA;IAC1B,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACxB,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAC7B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,iBAAiB,CASrD;AAoCD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,iBAAiB,GACvB,eAAe,EAAE,CAqFnB;AA6BD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,eAAe,EAAE,SAAS,GAAE,MAAiB,GAAG,MAAM,CAoBrG;AAMD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,OAAO,EAAE,OAAO,CAAA;IAChB,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAA;IACf,0DAA0D;IAC1D,WAAW,EAAE,OAAO,CAAA;CACrB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAMlD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAA;IACpB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAA;IAClB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,YAAY,GAAE,MAAgB,GAC7B,OAAO,CAAC,cAAc,CAAC,CAgHzB;AA8BD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAmE7B"}