@locusai/sdk 0.8.1 → 0.9.1

package/dist/agent/__tests__/orchestrator.cleanup.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=orchestrator.cleanup.test.d.ts.map

package/dist/agent/__tests__/orchestrator.cleanup.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.cleanup.test.d.ts","sourceRoot":"","sources":["../../../src/agent/__tests__/orchestrator.cleanup.test.ts"],"names":[],"mappings":""}

package/dist/agent/__tests__/worker.no-changes.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=worker.no-changes.test.d.ts.map

package/dist/agent/__tests__/worker.no-changes.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.no-changes.test.d.ts","sourceRoot":"","sources":["../../../src/agent/__tests__/worker.no-changes.test.ts"],"names":[],"mappings":""}

package/dist/agent/document-fetcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document-fetcher.d.ts","sourceRoot":"","sources":["../../src/agent/document-fetcher.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,KAAK,CAAC;CACZ;AAED;;;;GAIG;AACH,qBAAa,eAAe;IACd,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,mBAAmB;IAE7C;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CA4D7B"}
+{"version":3,"file":"document-fetcher.d.ts","sourceRoot":"","sources":["../../src/agent/document-fetcher.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,KAAK,CAAC;CACZ;AAED;;;;GAIG;AACH,qBAAa,eAAe;IACd,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,mBAAmB;IAE7C;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CA6D7B"}

package/dist/agent/index.d.ts

@@ -1,6 +1,7 @@
 export { CodebaseIndexerService } from "./codebase-indexer-service.js";
 export { DocumentFetcher } from "./document-fetcher.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";
 //# 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,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,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"}

package/dist/agent/review-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"review-service.d.ts","sourceRoot":"","sources":["../../src/agent/review-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,KAAK,CAAC;CACZ;AAED;;GAEG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,iBAAiB;IAE3C;;;OAGG;IACG,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAkEzE"}
+{"version":3,"file":"review-service.d.ts","sourceRoot":"","sources":["../../src/agent/review-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,KAAK,CAAC;CACZ;AAED;;GAEG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,iBAAiB;IAE3C;;;OAGG;IACG,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAoEzE"}

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

@@ -0,0 +1,42 @@
+import type { AiProvider } from "../ai/runner.js";
+export interface ReviewerConfig {
+    agentId: string;
+    workspaceId: string;
+    sprintId?: string;
+    apiBase: string;
+    projectPath: string;
+    apiKey: string;
+    model?: string;
+    provider?: AiProvider;
+}
+/**
+ * Reviewer agent that discovers open Locus PRs directly from GitHub,
+ * reviews the PR diff via AI, and posts review comments.
+ * Skips PRs that already have a Locus review.
+ */
+export declare class ReviewerWorker {
+    private config;
+    private client;
+    private aiRunner;
+    private prService;
+    private knowledgeBase;
+    private heartbeatInterval;
+    private currentTaskId;
+    private maxReviews;
+    private reviewsCompleted;
+    constructor(config: ReviewerConfig);
+    log(message: string, level?: "info" | "success" | "warn" | "error"): void;
+    /**
+     * Discover the next unreviewed Locus PR from GitHub.
+     */
+    private getNextUnreviewedPr;
+    /**
+     * Review a PR using AI and post the review on GitHub.
+     */
+    private reviewPr;
+    private startHeartbeat;
+    private stopHeartbeat;
+    private sendHeartbeat;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=reviewer-worker.d.ts.map

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

@@ -0,0 +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"}

package/dist/agent/task-executor.d.ts

@@ -13,7 +13,7 @@ export declare class TaskExecutor {
     private deps;
     private promptBuilder;
     constructor(deps: TaskExecutorDeps);
-    execute(task: Task, context?: string): Promise<{
+    execute(task: Task): Promise<{
         success: boolean;
         summary: string;
     }>;

package/dist/agent/task-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-executor.d.ts","sourceRoot":"","sources":["../../src/agent/task-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGhD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,KAAK,CAAC;CACZ;AAED;;GAEG;AACH,qBAAa,YAAY;IAGX,OAAO,CAAC,IAAI;IAFxB,OAAO,CAAC,aAAa,CAAgB;gBAEjB,IAAI,EAAE,gBAAgB;IAIpC,OAAO,CACX,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAyBlD"}
+{"version":3,"file":"task-executor.d.ts","sourceRoot":"","sources":["../../src/agent/task-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGhD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,KAAK,CAAC;CACZ;AAED;;GAEG;AACH,qBAAa,YAAY;IAGX,OAAO,CAAC,IAAI;IAFxB,OAAO,CAAC,aAAa,CAAgB;gBAEjB,IAAI,EAAE,gBAAgB;IAIpC,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAkB1E"}

package/dist/agent/worker.d.ts

@@ -8,6 +8,12 @@ export interface WorkerConfig {
     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;
 }
 /**
  * Main agent worker that orchestrates task execution
@@ -17,18 +23,55 @@ export declare class AgentWorker {
     private config;
     private client;
     private aiRunner;
-    private indexerService;
-    private documentFetcher;
     private taskExecutor;
-    private reviewService;
+    private knowledgeBase;
+    private worktreeManager;
+    private prService;
     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.
+     */
+    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;
-    private runStagedChangesReview;
+    /**
+     * 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;
+    private delayAfterCleanup;
     run(): Promise<void>;
 }
 //# sourceMappingURL=worker.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/agent/worker.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,iBAAiB,CAAC;AAuB5D,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;CACvB;AAED;;;GAGG;AACH,qBAAa,WAAW;IAcV,OAAO,CAAC,MAAM;IAb1B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAW;IAG3B,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,aAAa,CAAgB;IAGrC,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,cAAc,CAAK;gBAEP,MAAM,EAAE,YAAY;IAuDxC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAgB;YAe5D,eAAe;YAcf,WAAW;YAiBX,WAAW;YA6BX,sBAAsB;IAoC9B,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA2D3B"}
+{"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;YAe5D,eAAe;YAcf,WAAW;IA+CzB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAqD1B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAuE7B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAgCzB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;YAsBb,WAAW;IAgGzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAkBtB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,aAAa;YAgBP,iBAAiB;IAYzB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAwI3B"}