@locusai/sdk 0.9.18 → 0.10.2

package/dist/agent/git-workflow.d.ts

@@ -0,0 +1,44 @@
+import type { Task } from "@locusai/shared";
+import type { LogFn } from "../ai/factory.js";
+import { TaskExecutor } from "./task-executor.js";
+import type { CommitPushResult, WorkerConfig } from "./worker-types.js";
+/**
+ * Handles the git side of task execution:
+ * - Creating per-task worktrees
+ * - Committing and pushing changes
+ * - Creating pull requests
+ * - Cleaning up worktrees
+ */
+export declare class GitWorkflow {
+    private config;
+    private log;
+    private ghUsername;
+    private worktreeManager;
+    private prService;
+    constructor(config: WorkerConfig, log: LogFn, ghUsername: string | null);
+    /**
+     * Create a per-task worktree and return an executor configured for it.
+     * Falls back to the default executor if worktrees are disabled.
+     */
+    createTaskWorktree(task: Task, defaultExecutor: TaskExecutor): {
+        worktreePath: string | null;
+        baseBranch: string | null;
+        executor: TaskExecutor;
+    };
+    /**
+     * Commit changes in a task worktree and optionally push to remote.
+     */
+    commitAndPush(worktreePath: string, task: Task, baseBranch?: string): CommitPushResult;
+    /**
+     * Create a pull request for a completed task.
+     */
+    createPullRequest(task: Task, branch: string, summary?: string, baseBranch?: string): {
+        url: string | null;
+        error?: string;
+    };
+    /**
+     * Clean up a task-specific worktree.
+     */
+    cleanupWorktree(worktreePath: string | null, keepBranch: boolean): void;
+}
+//# sourceMappingURL=git-workflow.d.ts.map

package/dist/agent/git-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-workflow.d.ts","sourceRoot":"","sources":["../../src/agent/git-workflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAK9C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAExE;;;;;;GAMG;AACH,qBAAa,WAAW;IAKpB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,UAAU;IANpB,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,SAAS,CAAmB;gBAG1B,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,KAAK,EACV,UAAU,EAAE,MAAM,GAAG,IAAI;IAWnC;;;OAGG;IACH,kBAAkB,CAChB,IAAI,EAAE,IAAI,EACV,eAAe,EAAE,YAAY,GAC5B;QACD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,QAAQ,EAAE,YAAY,CAAC;KACxB;IA+CD;;OAEG;IACH,aAAa,CACX,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,IAAI,EACV,UAAU,CAAC,EAAE,MAAM,GAClB,gBAAgB;IAqEnB;;OAEG;IACH,iBAAiB,CACf,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB;QAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IA0BzC;;OAEG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI;CAexE"}

package/dist/agent/index.d.ts

@@ -1,7 +1,9 @@
 export { CodebaseIndexerService } from "./codebase-indexer-service.js";
 export { DocumentFetcher } from "./document-fetcher.js";
+export { GitWorkflow } from "./git-workflow.js";
 export { ReviewService, type ReviewServiceDeps } from "./review-service.js";
 export { type ReviewerConfig, ReviewerWorker, } from "./reviewer-worker.js";
 export { TaskExecutor } from "./task-executor.js";
 export { AgentWorker, type WorkerConfig } from "./worker.js";
+export type { CommitPushResult, TaskResult } from "./worker-types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/agent/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EACL,KAAK,cAAc,EACnB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EACL,KAAK,cAAc,EACnB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAC7D,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/agent/reviewer-worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reviewer-worker.d.ts","sourceRoot":"","sources":["../../src/agent/reviewer-worker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,iBAAiB,CAAC;AAc5D,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAED;;;;GAIG;AACH,qBAAa,cAAc;IAUb,OAAO,CAAC,MAAM;IAT1B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,iBAAiB,CAA+C;IACxE,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,gBAAgB,CAAK;gBAET,MAAM,EAAE,cAAc;IA6B1C,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAgB;IAe1E;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAU3B;;OAEG;YACW,QAAQ;IAiFtB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,aAAa;IAgBf,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA8E3B"}
+{"version":3,"file":"reviewer-worker.d.ts","sourceRoot":"","sources":["../../src/agent/reviewer-worker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,iBAAiB,CAAC;AAc5D,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAED;;;;GAIG;AACH,qBAAa,cAAc;IAUb,OAAO,CAAC,MAAM;IAT1B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,iBAAiB,CAA+C;IACxE,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,gBAAgB,CAAK;gBAET,MAAM,EAAE,cAAc;IA6B1C,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAgB;IAe1E;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAU3B;;OAEG;YACW,QAAQ;IAiFtB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,aAAa;IAgBf,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAiF3B"}

package/dist/agent/worker-cli.d.ts

@@ -0,0 +1,6 @@
+import type { WorkerConfig } from "./worker-types.js";
+/**
+ * Parse CLI arguments into a WorkerConfig.
+ */
+export declare function parseWorkerArgs(argv: string[]): WorkerConfig;
+//# sourceMappingURL=worker-cli.d.ts.map

package/dist/agent/worker-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-cli.d.ts","sourceRoot":"","sources":["../../src/agent/worker-cli.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAgBtD;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,YAAY,CAoC5D"}

package/dist/agent/worker-types.d.ts

@@ -0,0 +1,44 @@
+import type { AiProvider } from "../ai/runner.js";
+export interface WorkerConfig {
+    /** Unique identifier for the agent */
+    agentId: string;
+    /** Unique identifier for the workspace */
+    workspaceId: string;
+    /** Unique identifier for the sprint */
+    sprintId?: string;
+    /** Base URL for the API */
+    apiBase: string;
+    /** Path to the project */
+    projectPath: string;
+    /** API key */
+    apiKey: string;
+    /** AI model */
+    model?: string;
+    /** AI provider */
+    provider?: AiProvider;
+    /** When running in a worktree, this is the path to the main repo for progress updates */
+    mainProjectPath?: string;
+    /** Whether to use per-task worktrees for isolation */
+    useWorktrees?: boolean;
+    /** Whether to push branches to remote after committing */
+    autoPush?: boolean;
+    /** Base branch for worktree creation and PR targeting (set by orchestrator for tier-based execution) */
+    baseBranch?: string;
+}
+export interface CommitPushResult {
+    branch: string | null;
+    pushed: boolean;
+    pushFailed: boolean;
+    pushError?: string;
+    skipReason?: string;
+    noChanges?: boolean;
+}
+export interface TaskResult {
+    success: boolean;
+    summary: string;
+    branch?: string;
+    prUrl?: string;
+    prError?: string;
+    noChanges?: boolean;
+}
+//# sourceMappingURL=worker-types.d.ts.map

package/dist/agent/worker-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-types.d.ts","sourceRoot":"","sources":["../../src/agent/worker-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc;IACd,MAAM,EAAE,MAAM,CAAC;IACf,eAAe;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,yFAAyF;IACzF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sDAAsD;IACtD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wGAAwG;IACxG,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB"}

package/dist/agent/worker.d.ts

@@ -1,23 +1,14 @@
-import type { AiProvider } from "../ai/runner.js";
-export interface WorkerConfig {
-    agentId: string;
-    workspaceId: string;
-    sprintId?: string;
-    apiBase: string;
-    projectPath: string;
-    apiKey: string;
-    model?: string;
-    provider?: AiProvider;
-    /** When running in a worktree, this is the path to the main repo for progress updates */
-    mainProjectPath?: string;
-    /** Whether to use per-task worktrees for isolation */
-    useWorktrees?: boolean;
-    /** Whether to push branches to remote after committing */
-    autoPush?: boolean;
-}
+import type { WorkerConfig } from "./worker-types.js";
+export type { WorkerConfig } from "./worker-types.js";
 /**
- * Main agent worker that orchestrates task execution
- * Delegates responsibilities to specialized services
+ * Main agent worker that claims and executes tasks.
+ *
+ * Responsibilities:
+ * - Claiming tasks from the API via dispatch
+ * - Executing tasks using the AI runner
+ * - Delegating git operations (worktree, commit, push, PR) to `GitWorkflow`
+ * - Reporting task status back to the API
+ * - Heartbeat reporting to the orchestrator
  */
 export declare class AgentWorker {
     private config;
@@ -25,49 +16,22 @@ export declare class AgentWorker {
     private aiRunner;
     private taskExecutor;
     private knowledgeBase;
-    private worktreeManager;
-    private prService;
+    private gitWorkflow;
     private maxTasks;
     private tasksCompleted;
     private heartbeatInterval;
     private currentTaskId;
     private currentWorktreePath;
     private postCleanupDelayMs;
-    /** Cached GitHub username for co-authorship in commits */
-    private ghUsername;
     constructor(config: WorkerConfig);
     log(message: string, level?: "info" | "success" | "warn" | "error"): void;
     private getActiveSprint;
     private getNextTask;
     /**
-     * Create a task-specific worktree and return an executor configured for it.
-     * Falls back to the main project path if worktrees are disabled.
-     */
-    private createTaskWorktree;
-    /**
-     * Commit changes in a task worktree and optionally push to remote.
-     * Distinguishes "no commit", "push failed", and "branch pushed" outcomes.
+     * Execute a single task: create worktree -> run AI -> commit -> push -> PR.
      */
-    private commitAndPushWorktree;
-    /**
-     * Create a pull request for a completed task.
-     * Returns the PR URL if successful, null otherwise.
-     */
-    private createPullRequest;
-    /**
-     * Clean up a task-specific worktree.
-     * Keep the branch if a commit was created so follow-up is possible.
-     */
-    private cleanupTaskWorktree;
     private executeTask;
-    /**
-     * Update progress.md in the main project after task completion
-     */
     private updateProgress;
-    /**
-     * Start sending periodic heartbeats to the API so the server
-     * knows this agent is alive and which task it's working on.
-     */
     private startHeartbeat;
     private stopHeartbeat;
     private sendHeartbeat;

package/dist/agent/worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/agent/worker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,iBAAiB,CAAC;AA4B5D,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,yFAAyF;IACzF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sDAAsD;IACtD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAWD;;;GAGG;AACH,qBAAa,WAAW;IAoBV,OAAO,CAAC,MAAM;IAnB1B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAW;IAG3B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,SAAS,CAA0B;IAG3C,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,iBAAiB,CAA+C;IACxE,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,kBAAkB,CAAS;IACnC,0DAA0D;IAC1D,OAAO,CAAC,UAAU,CAAuB;gBAErB,MAAM,EAAE,YAAY;IAqFxC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAgB;YAiB5D,eAAe;YAcf,WAAW;IA+CzB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAqD1B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IA2E7B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAgCzB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;YAsBb,WAAW;IAoGzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAoBtB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,aAAa;YAkBP,iBAAiB;IAczB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAwI3B"}
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/agent/worker.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAc,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGlE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;;;;;GASG;AACH,qBAAa,WAAW;IAeV,OAAO,CAAC,MAAM;IAd1B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,WAAW,CAAc;IAGjC,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,iBAAiB,CAA+C;IACxE,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,kBAAkB,CAAS;gBAEf,MAAM,EAAE,YAAY;IA2ExC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAgB;YAmB5D,eAAe;YAcf,WAAW;IAgDzB;;OAEG;YACW,WAAW;IA2FzB,OAAO,CAAC,cAAc;IAmBtB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,aAAa;YAgBP,iBAAiB;IAezB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAoH3B"}