@locusai/sdk 0.8.1 → 0.9.0

package/dist/worktree/worktree-config.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Worktree configuration types and constants.
+ * Defines the directory layout, branch naming, and cleanup policies
+ * for agent worktrees used in parallel task execution.
+ */
+/** Root directory for all agent worktrees, relative to project root */
+export declare const WORKTREE_ROOT_DIR = ".locus-worktrees";
+/** Branch prefix for agent worktrees */
+export declare const WORKTREE_BRANCH_PREFIX = "agent";
+/** Cleanup policy for completed worktrees */
+export type WorktreeCleanupPolicy = "auto" | "retain-on-failure" | "manual";
+/** Configuration for worktree management */
+export interface WorktreeConfig {
+    /** Root directory for worktrees (default: `.locus-worktrees/`) */
+    rootDir: string;
+    /** Branch naming prefix (default: `agent`) */
+    branchPrefix: string;
+    /** Cleanup policy (default: `retain-on-failure`) */
+    cleanupPolicy: WorktreeCleanupPolicy;
+    /** Base branch to create worktrees from (default: current HEAD) */
+    baseBranch?: string;
+}
+/** Metadata for a single worktree */
+export interface WorktreeInfo {
+    /** Absolute path to the worktree directory */
+    path: string;
+    /** Branch name checked out in this worktree */
+    branch: string;
+    /** HEAD commit hash */
+    head: string;
+    /** Whether this is the main worktree */
+    isMain: boolean;
+    /** Whether the worktree directory is missing (prunable) */
+    isPrunable: boolean;
+}
+/** Options for creating a worktree */
+export interface CreateWorktreeOptions {
+    /** Task ID associated with this worktree */
+    taskId: string;
+    /** Task slug for branch naming */
+    taskSlug: string;
+    /** Agent ID that will use this worktree */
+    agentId: string;
+    /** Base branch to create from (defaults to config.baseBranch or current HEAD) */
+    baseBranch?: string;
+}
+/** Result of creating a worktree */
+export interface CreateWorktreeResult {
+    /** Absolute path to the created worktree */
+    worktreePath: string;
+    /** Branch name created */
+    branch: string;
+    /** Base branch used to create the task branch */
+    baseBranch: string;
+}
+/** Default worktree configuration */
+export declare const DEFAULT_WORKTREE_CONFIG: WorktreeConfig;
+//# sourceMappingURL=worktree-config.d.ts.map

package/dist/worktree/worktree-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-config.d.ts","sourceRoot":"","sources":["../../src/worktree/worktree-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,uEAAuE;AACvE,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AAEpD,wCAAwC;AACxC,eAAO,MAAM,sBAAsB,UAAU,CAAC;AAE9C,6CAA6C;AAC7C,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,mBAAmB,GAAG,QAAQ,CAAC;AAE5E,4CAA4C;AAC5C,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,YAAY,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,aAAa,EAAE,qBAAqB,CAAC;IACrC,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qCAAqC;AACrC,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,MAAM,EAAE,OAAO,CAAC;IAChB,2DAA2D;IAC3D,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,sCAAsC;AACtC,MAAM,WAAW,qBAAqB;IACpC,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,oCAAoC;AACpC,MAAM,WAAW,oBAAoB;IACnC,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qCAAqC;AACrC,eAAO,MAAM,uBAAuB,EAAE,cAIrC,CAAC"}

package/dist/worktree/worktree-manager.d.ts

@@ -0,0 +1,96 @@
+import type { LogFn } from "../ai/factory.js";
+import { type CreateWorktreeOptions, type CreateWorktreeResult, type WorktreeConfig, type WorktreeInfo } from "./worktree-config.js";
+/**
+ * Manages git worktrees for parallel agent execution.
+ * Each agent gets an isolated worktree with a dedicated branch,
+ * allowing multiple agents to work on different tasks without conflicts.
+ */
+export declare class WorktreeManager {
+    private config;
+    private projectPath;
+    private log;
+    constructor(projectPath: string, config?: Partial<WorktreeConfig>, log?: LogFn);
+    /**
+     * Get the absolute path to the worktree root directory.
+     */
+    private get rootPath();
+    /**
+     * Build the branch name for a task.
+     * Format: `agent/<taskId>-<slug>`
+     */
+    buildBranchName(taskId: string, taskSlug: string): string;
+    /**
+     * Create a new worktree for an agent task.
+     * Creates the branch and worktree directory.
+     */
+    create(options: CreateWorktreeOptions): CreateWorktreeResult;
+    /**
+     * List all worktrees with metadata.
+     * Returns both the main worktree and agent worktrees.
+     */
+    list(): WorktreeInfo[];
+    /**
+     * List only agent worktrees (excludes the main worktree).
+     */
+    listAgentWorktrees(): WorktreeInfo[];
+    /**
+     * Remove a specific worktree by path and optionally delete its branch.
+     */
+    remove(worktreePath: string, deleteBranch?: boolean): void;
+    /**
+     * Prune stale worktree references (directories that no longer exist).
+     */
+    prune(): number;
+    /**
+     * Remove all agent worktrees and their branches.
+     * Does not touch the main worktree.
+     */
+    removeAll(): number;
+    /**
+     * Check if a worktree has uncommitted changes.
+     */
+    hasChanges(worktreePath: string): boolean;
+    /**
+     * Stage all changes and commit in a worktree.
+     * Returns the commit hash, or null if there were no changes to commit.
+     */
+    commitChanges(worktreePath: string, message: string): string | null;
+    /**
+     * Push a worktree's branch to a remote.
+     * Returns the branch name on success, or throws on failure.
+     */
+    pushBranch(worktreePath: string, remote?: string): string;
+    /**
+     * Get the current branch checked out in a worktree.
+     */
+    getBranch(worktreePath: string): string;
+    /**
+     * Check if a worktree exists for a given task ID.
+     */
+    hasWorktreeForTask(taskId: string): boolean;
+    /**
+     * Check if a branch exists locally.
+     */
+    private branchExists;
+    /**
+     * Get the current branch of the main repository.
+     */
+    private getCurrentBranch;
+    /**
+     * Check if a worktree path is managed by Locus.
+     */
+    private isManagedWorktreePath;
+    private ensureDirectory;
+    private isMissingDirectoryError;
+    private cleanupFailedWorktree;
+    private isNonFastForwardPushError;
+    /**
+     * Execute a git command (string form) and return stdout.
+     */
+    private git;
+    /**
+     * Execute a git command with array args (safe from shell injection).
+     */
+    private gitExec;
+}
+//# sourceMappingURL=worktree-manager.d.ts.map

package/dist/worktree/worktree-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-manager.d.ts","sourceRoot":"","sources":["../../src/worktree/worktree-manager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAEzB,KAAK,cAAc,EACnB,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAE9B;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,GAAG,CAAQ;gBAGjB,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,EAChC,GAAG,CAAC,EAAE,KAAK;IAOb;;OAEG;IACH,OAAO,KAAK,QAAQ,GAEnB;IAED;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAUzD;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,qBAAqB,GAAG,oBAAoB;IAmF5D;;;OAGG;IACH,IAAI,IAAI,YAAY,EAAE;IA+CtB;;OAEG;IACH,kBAAkB,IAAI,YAAY,EAAE;IAIpC;;OAEG;IACH,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,UAAO,GAAG,IAAI;IAsCvD;;OAEG;IACH,KAAK,IAAI,MAAM;IAmBf;;;OAGG;IACH,SAAS,IAAI,MAAM;IAyBnB;;OAEG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAKzC;;;OAGG;IACH,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAcnE;;;OAGG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,SAAW,GAAG,MAAM;IAqC3D;;OAEG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAIvC;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAM3C;;OAEG;IACH,OAAO,CAAC,YAAY;IAYpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAO7B,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,uBAAuB;IAQ/B,OAAO,CAAC,qBAAqB;IA0B7B,OAAO,CAAC,yBAAyB;IASjC;;OAEG;IACH,OAAO,CAAC,GAAG;IAQX;;OAEG;IACH,OAAO,CAAC,OAAO;CAOhB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@locusai/sdk",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
@@ -30,7 +30,7 @@
     "clean": "rm -rf node_modules"
   },
   "dependencies": {
-    "@locusai/shared": "^0.8.1",
+    "@locusai/shared": "^0.9.0",
     "axios": "^1.13.2",
     "events": "^3.3.0",
     "globby": "^14.0.2"

package/dist/modules/ai.d.ts

@@ -1,55 +0,0 @@
-import { ChatRequest, ChatResponse, ShareChatRequest } from "@locusai/shared";
-import { BaseModule } from "./base.js";
-export declare class AIModule extends BaseModule {
-    /**
-     * Send a message to the Locus AI Agent and get a response.
-     */
-    chat(workspaceId: string, body: ChatRequest): Promise<ChatResponse>;
-    /**
-     * Detect intent of the message.
-     */
-    detectIntent(workspaceId: string, body: ChatRequest): Promise<{
-        intent: string;
-        executionId: string;
-        sessionId: string;
-    }>;
-    /**
-     * Execute a pending intent.
-     */
-    executeIntent(workspaceId: string, body: {
-        sessionId: string;
-        executionId: string;
-    }): Promise<ChatResponse>;
-    /**
-     * List all chat sessions for the current user in a workspace.
-     */
-    listSessions(workspaceId: string): Promise<{
-        sessions: {
-            id: string;
-            title: string;
-            updatedAt: string;
-        }[];
-    }>;
-    /**
-     * Get an existing chat session with its history.
-     */
-    getSession(workspaceId: string, sessionId: string): Promise<ChatResponse>;
-    /**
-     * Get a streaming chat response.
-     * Note: This is a placeholder for actual SSE implementation in the SDK.
-     */
-    getChatStreamUrl(workspaceId: string, sessionId: string): string;
-    /**
-     * Delete a chat session.
-     */
-    deleteSession(workspaceId: string, sessionId: string): Promise<void>;
-    /**
-     * Toggle chat session sharing.
-     */
-    shareSession(workspaceId: string, sessionId: string, body: ShareChatRequest): Promise<void>;
-    /**
-     * Get a shared chat session (public).
-     */
-    getSharedSession(sessionId: string): Promise<ChatResponse>;
-}
-//# sourceMappingURL=ai.d.ts.map

package/dist/modules/ai.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/modules/ai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,qBAAa,QAAS,SAAQ,UAAU;IACtC;;OAEG;IACG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IASzE;;OAEG;IACG,YAAY,CAChB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAStE;;OAEG;IACG,aAAa,CACjB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAC/C,OAAO,CAAC,YAAY,CAAC;IASxB;;OAEG;IACG,YAAY,CAChB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;QAAE,QAAQ,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,CAAC;IAO5E;;OAEG;IACG,UAAU,CACd,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,CAAC;IAOxB;;;OAGG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAGhE;;OAEG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1E;;OAEG;IACG,YAAY,CAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,IAAI,CAAC;IAIhB;;OAEG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAMjE"}