@locusai/sdk 0.16.1 → 0.18.1

package/PACKAGE_GUIDE.md

@@ -0,0 +1,269 @@
+# Locus Package Author Guide
+
+This guide explains how to build, test, and publish a community package for
+the [Locus](https://github.com/locusai/locus) CLI.
+
+---
+
+## Naming convention
+
+All Locus packages must be published to npm with the prefix `locus-`:
+
+| Short name | npm package name  |
+|------------|-------------------|
+| `telegram` | `locus-telegram`  |
+| `slack`    | `locus-slack`     |
+| `jira`     | `locus-jira`      |
+
+Scoped packages (e.g. `@myorg/locus-telegram`) are also accepted and will be
+used as-is.
+
+---
+
+## `package.json` manifest format
+
+Every Locus package **must** include a `"locus"` field in its `package.json`.
+This field tells the Locus CLI how to display and invoke your package.
+
+```jsonc
+{
+  "name": "locus-telegram",
+  "version": "1.0.0",
+  "description": "Remote-control Locus via Telegram",
+  "bin": {
+    "locus-telegram": "./bin/locus-telegram.js"
+  },
+
+  // Required: Locus package manifest
+  "locus": {
+    "displayName": "Telegram",
+    "description": "Remote-control your Locus agent from Telegram",
+    "commands": ["telegram"],
+    "version": "1.0.0"
+  }
+}
+```
+
+| Field         | Type       | Description                                                      |
+|---------------|------------|------------------------------------------------------------------|
+| `displayName` | `string`   | Human-readable name shown in `locus packages list`.             |
+| `description` | `string`   | One-line description shown in `locus packages list`.            |
+| `commands`    | `string[]` | Sub-commands contributed. Used in `locus pkg <name>` dispatch.  |
+| `version`     | `string`   | Semver version — should mirror the npm package version.         |
+
+---
+
+## Binary entry point
+
+Your package must expose a binary. Locus discovers it via
+`~/.locus/packages/node_modules/.bin/locus-<name>` after installation.
+
+In `package.json`:
+
+```json
+"bin": {
+  "locus-telegram": "./bin/locus-telegram.js"
+}
+```
+
+The binary should be executable Node.js (shebang `#!/usr/bin/env node`).
+
+When invoked via `locus pkg telegram [args...]`, the remaining args are
+forwarded to your binary verbatim.
+
+---
+
+## Using `@locusai/sdk`
+
+Install the SDK as a dev dependency (it is a peer contract, not bundled):
+
+```sh
+npm install --save-dev @locusai/sdk
+```
+
+### Reading project config
+
+```ts
+import { readLocusConfig } from "@locusai/sdk";
+
+// Reads ~/.locus/config.json + ./.locus/config.json and merges them.
+const config = readLocusConfig();
+
+console.log(config.github.owner); // "myorg"
+console.log(config.ai.model);     // "claude-sonnet-4-6"
+```
+
+### Invoking `locus` sub-commands
+
+```ts
+import { invokeLocus, invokeLocusStream } from "@locusai/sdk";
+
+// Captured output (blocking)
+const result = await invokeLocus(["run", "42"]);
+if (result.exitCode !== 0) {
+  console.error("locus run failed:", result.stderr);
+}
+
+// Streaming (non-blocking)
+const child = invokeLocusStream(["run", "42"]);
+child.stdout?.on("data", (chunk: Buffer) => process.stdout.write(chunk));
+child.on("exit", (code) => console.log("exited with", code));
+```
+
+### Structured logger
+
+```ts
+import { createLogger } from "@locusai/sdk";
+
+const logger = createLogger("telegram");
+
+logger.info("Bot started");
+logger.warn("Rate limit approaching", { remaining: 5 });
+logger.error("Connection failed", { code: 503 });
+logger.debug("Raw update", { update_id: 12345 }); // only shown with LOCUS_DEBUG=1
+```
+
+Output uses the same prefix symbols as the Locus CLI (`●`, `⚠`, `✗`, `⋯`).
+
+---
+
+## Minimal end-to-end example
+
+Below is a complete minimal Locus package (`locus-hello`).
+
+### Directory structure
+
+```
+locus-hello/
+├── bin/
+│   └── locus-hello.js
+├── src/
+│   └── index.ts
+├── package.json
+└── tsconfig.json
+```
+
+### `package.json`
+
+```json
+{
+  "name": "locus-hello",
+  "version": "1.0.0",
+  "description": "Example Locus package",
+  "type": "module",
+  "bin": {
+    "locus-hello": "./bin/locus-hello.js"
+  },
+  "locus": {
+    "displayName": "Hello",
+    "description": "A minimal example Locus package",
+    "commands": ["hello"],
+    "version": "1.0.0"
+  },
+  "scripts": {
+    "build": "tsc"
+  },
+  "devDependencies": {
+    "@locusai/sdk": "^0.1.0",
+    "typescript": "^5.0.0"
+  }
+}
+```
+
+### `src/index.ts`
+
+```ts
+import { createLogger, readLocusConfig } from "@locusai/sdk";
+
+const logger = createLogger("hello");
+
+export async function run(): Promise<void> {
+  const config = readLocusConfig();
+  logger.info(`Hello from locus-hello! Repo: ${config.github.owner}/${config.github.repo}`);
+}
+```
+
+### `bin/locus-hello.js`
+
+```js
+#!/usr/bin/env node
+import "../dist/index.js";
+
+const { run } = await import("../dist/index.js");
+await run();
+```
+
+Make it executable:
+
+```sh
+chmod +x bin/locus-hello.js
+```
+
+---
+
+## Testing locally with `npm link`
+
+1. Build your package:
+
+   ```sh
+   npm run build
+   ```
+
+2. Link it globally:
+
+   ```sh
+   npm link
+   ```
+
+3. Install it into Locus's packages directory:
+
+   ```sh
+   locus install locus-hello
+   ```
+
+   Or, for a faster dev loop, symlink directly:
+
+   ```sh
+   mkdir -p ~/.locus/packages/node_modules
+   ln -s $(pwd) ~/.locus/packages/node_modules/locus-hello
+   mkdir -p ~/.locus/packages/node_modules/.bin
+   ln -s $(pwd)/bin/locus-hello.js ~/.locus/packages/node_modules/.bin/locus-hello
+   ```
+
+4. Run your package:
+
+   ```sh
+   locus pkg hello
+   ```
+
+---
+
+## Publishing to npm
+
+1. Make sure the `"locus"` field is present in your `package.json`.
+2. Ensure the binary listed in `"bin"` is executable.
+3. Build your package.
+4. Publish:
+
+   ```sh
+   npm publish --access public
+   ```
+
+After publishing, users can install your package with:
+
+```sh
+locus install hello     # short name (locus-hello)
+locus install locus-hello
+```
+
+---
+
+## Checklist before publishing
+
+- [ ] Package name starts with `locus-` (or is scoped)
+- [ ] `"locus"` field present in `package.json` with all required keys
+- [ ] Binary listed in `"bin"` exists and has the shebang line
+- [ ] Binary is executable (`chmod +x`)
+- [ ] Package builds cleanly with no TypeScript errors
+- [ ] Tested locally with `locus pkg <name>`
+- [ ] `README.md` explains what the package does and how to configure it

package/package.json

@@ -1,44 +1,44 @@
 {
   "name": "@locusai/sdk",
-  "version": "0.16.1",
+  "version": "0.18.1",
+  "description": "SDK for building Locus-compatible community packages",
   "type": "module",
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./src/index.ts",
-      "development": "./src/index.ts",
-      "import": "./src/index.ts",
-      "default": "./src/index.ts"
-    },
-    "./node": {
-      "types": "./src/index-node.ts",
-      "development": "./src/index-node.ts",
-      "import": "./src/index-node.ts",
-      "default": "./src/index-node.ts"
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
     }
   },
   "files": [
     "dist",
+    "PACKAGE_GUIDE.md",
     "README.md"
   ],
   "scripts": {
-    "build": "bun build ./src/index.ts ./src/index-node.ts ./src/agent/worker.ts --outdir ./dist --target node --format cjs --external axios --external events --external globby --external @locusai/shared --external zod && tsc -p tsconfig.build.json --emitDeclarationOnly",
-    "dev": "tsc --watch",
-    "lint": "biome lint .",
-    "test": "bun test",
+    "build": "bun build ./src/index.ts --outdir ./dist --target node --format esm && bun build ./src/index.ts --outfile ./dist/index.cjs --target node --format cjs && tsc -p tsconfig.build.json --emitDeclarationOnly",
     "typecheck": "tsc --noEmit",
-    "clean": "rm -rf node_modules"
-  },
-  "dependencies": {
-    "@locusai/shared": "^0.16.1",
-    "axios": "^1.13.2",
-    "events": "^3.3.0",
-    "globby": "^14.0.2",
-    "zod": "^4.3.6"
+    "lint": "biome lint .",
+    "format": "biome format --write .",
+    "clean": "rm -rf dist node_modules"
   },
-  "devDependencies": {
-    "typescript": "^5.8.3",
-    "@types/node": "^22.10.7"
+  "keywords": [
+    "locus",
+    "sdk",
+    "package",
+    "plugin",
+    "community"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
   }
 }

package/dist/agent/codebase-indexer-service.d.ts

@@ -1,17 +0,0 @@
-import { LogFn } from "../ai/factory.js";
-import type { AiRunner } from "../ai/runner.js";
-export interface CodebaseIndexerServiceDeps {
-    aiRunner: AiRunner;
-    projectPath: string;
-    log: LogFn;
-}
-/**
- * Handles codebase indexing with AI analysis
- */
-export declare class CodebaseIndexerService {
-    private deps;
-    private indexer;
-    constructor(deps: CodebaseIndexerServiceDeps);
-    reindex(force?: boolean): Promise<void>;
-}
-//# sourceMappingURL=codebase-indexer-service.d.ts.map

package/dist/agent/codebase-indexer-service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"codebase-indexer-service.d.ts","sourceRoot":"","sources":["../../src/agent/codebase-indexer-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAIhD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,KAAK,CAAC;CACZ;AAED;;GAEG;AACH,qBAAa,sBAAsB;IAGrB,OAAO,CAAC,IAAI;IAFxB,OAAO,CAAC,OAAO,CAAkB;gBAEb,IAAI,EAAE,0BAA0B;IAI9C,OAAO,CAAC,KAAK,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAmD5C"}

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

@@ -1,23 +0,0 @@
-import type { LogFn } from "../ai/factory.js";
-import type { LocusClient } from "../index.js";
-export interface DocumentFetcherDeps {
-    client: LocusClient;
-    workspaceId: string;
-    projectPath: string;
-    log: LogFn;
-}
-/**
- * Fetches documents from the platform to local storage.
- * One-way sync: server -> local only.
- * Artifacts are NOT synced to cloud (they remain local-only).
- */
-export declare class DocumentFetcher {
-    private deps;
-    constructor(deps: DocumentFetcherDeps);
-    /**
-     * Fetches documents from the server and saves them locally.
-     * Documents are organized by group name in .locus/documents/{groupName}/
-     */
-    fetch(): Promise<void>;
-}
-//# sourceMappingURL=document-fetcher.d.ts.map

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

@@ -1 +0,0 @@
-{"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/git-workflow.d.ts

@@ -1,59 +0,0 @@
-import type { Task } from "@locusai/shared";
-import type { LogFn } from "../ai/factory.js";
-import type { CommitPushResult, WorkerConfig } from "./worker-types.js";
-/**
- * Handles the git side of task execution with a single-branch workflow:
- * - Creates one branch for the entire run
- * - Commits and pushes after each task
- * - Opens a PR when all tasks are done
- * - Checks out the base branch after PR creation
- */
-export declare class GitWorkflow {
-    private config;
-    private log;
-    private projectPath;
-    private branchName;
-    private baseBranch;
-    private ghUsername;
-    constructor(config: WorkerConfig, log: LogFn);
-    /**
-     * Create a development branch for the run.
-     * Called once at the start of execution.
-     */
-    createBranch(sprintId?: string): string;
-    /**
-     * Commit changes for a completed task and push to remote.
-     */
-    commitAndPush(task: Task): CommitPushResult;
-    /**
-     * Push the current branch to remote.
-     */
-    private pushBranch;
-    /**
-     * Create a pull request for the development branch.
-     * Called once after all tasks are done.
-     */
-    createPullRequest(completedTasks: Array<{
-        title: string;
-        id: string;
-    }>, summaries: string[]): {
-        url: string | null;
-        error?: string;
-    };
-    /**
-     * Checkout the base branch after the run is complete.
-     */
-    checkoutBaseBranch(): void;
-    /**
-     * Get the current branch name.
-     */
-    getBranchName(): string | null;
-    /**
-     * Get the base branch name.
-     */
-    getBaseBranch(): string | null;
-    private getBaseCommit;
-    private buildPrBody;
-    private gitExec;
-}
-//# sourceMappingURL=git-workflow.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"git-workflow.d.ts","sourceRoot":"","sources":["../../src/agent/git-workflow.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAO9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAExE;;;;;;GAMG;AACH,qBAAa,WAAW;IAOpB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,GAAG;IAPb,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,UAAU,CAAgB;gBAGxB,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,KAAK;IASpB;;;OAGG;IACH,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM;IAmCvC;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,gBAAgB;IAkF3C;;OAEG;IACH,OAAO,CAAC,UAAU;IAuDlB;;;OAGG;IACH,iBAAiB,CACf,cAAc,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,EACpD,SAAS,EAAE,MAAM,EAAE,GAClB;QAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IA4DzC;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAc1B;;OAEG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;IAI9B;;OAEG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;IAI9B,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,WAAW;IA4BnB,OAAO,CAAC,OAAO;CAOhB"}

package/dist/agent/index.d.ts

@@ -1,9 +0,0 @@
-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 +0,0 @@
-{"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/review-service.d.ts

@@ -1,21 +0,0 @@
-import type { Sprint } from "@locusai/shared";
-import { LogFn } from "../ai/factory.js";
-import type { AiRunner } from "../ai/runner.js";
-export interface ReviewServiceDeps {
-    aiRunner: AiRunner;
-    projectPath: string;
-    log: LogFn;
-}
-/**
- * Reviews staged git changes and produces a markdown report.
- */
-export declare class ReviewService {
-    private deps;
-    constructor(deps: ReviewServiceDeps);
-    /**
-     * Stages all changes and runs an AI review on the diff.
-     * Returns a markdown review report, or null if there are no changes.
-     */
-    reviewStagedChanges(sprint: Sprint | null): Promise<string | null>;
-}
-//# sourceMappingURL=review-service.d.ts.map

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

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

@@ -1,41 +0,0 @@
-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 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

@@ -1 +0,0 @@
-{"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;AAa5D,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;IASb,OAAO,CAAC,MAAM;IAR1B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,iBAAiB,CAA+C;IACxE,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,gBAAgB,CAAK;gBAET,MAAM,EAAE,cAAc;IA4B1C,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;CAiE3B"}

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

@@ -1,26 +0,0 @@
-import type { Task } from "@locusai/shared";
-import { LogFn } from "../ai/factory.js";
-import type { AiRunner } from "../ai/runner.js";
-export interface TaskExecutorDeps {
-    aiRunner: AiRunner;
-    projectPath: string;
-    log: LogFn;
-}
-/**
- * Handles direct task execution (single-pass, no separate planning phase)
- */
-export declare class TaskExecutor {
-    private deps;
-    private promptBuilder;
-    constructor(deps: TaskExecutorDeps);
-    execute(task: Task): Promise<{
-        success: boolean;
-        summary: string;
-    }>;
-    /**
-     * Extract a concise summary from the agent's raw output.
-     * Takes the last non-empty paragraph, truncated to 500 chars.
-     */
-    private extractSummary;
-}
-//# sourceMappingURL=task-executor.d.ts.map

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

@@ -1 +0,0 @@
-{"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;IAezE;;;OAGG;IACH,OAAO,CAAC,cAAc;CAoBvB"}

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

@@ -1,6 +0,0 @@
-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

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

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

@@ -1,36 +0,0 @@
-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;
-    /** Reasoning effort level for Codex models (e.g. "low", "medium", "high") */
-    reasoningEffort?: 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;
-    noChanges?: boolean;
-}
-//# sourceMappingURL=worker-types.d.ts.map

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

@@ -1 +0,0 @@
-{"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,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;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,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB"}

package/dist/agent/worker.d.ts

@@ -1,39 +0,0 @@
-import type { WorkerConfig } from "./worker-types.js";
-export type { WorkerConfig } from "./worker-types.js";
-/**
- * Main agent worker that claims and executes tasks sequentially.
- *
- * Responsibilities:
- * - Creating a single branch for the run
- * - Claiming tasks from the API via dispatch
- * - Executing tasks using the AI runner
- * - Committing and pushing after each task
- * - Opening a PR when all tasks are done
- * - Checking out the base branch after completion
- */
-export declare class AgentWorker {
-    private config;
-    private client;
-    private aiRunner;
-    private taskExecutor;
-    private gitWorkflow;
-    private maxTasks;
-    private tasksCompleted;
-    private heartbeatInterval;
-    private currentTaskId;
-    private completedTaskList;
-    private taskSummaries;
-    constructor(config: WorkerConfig);
-    log(message: string, level?: "info" | "success" | "warn" | "error"): void;
-    private getActiveSprint;
-    private getNextTask;
-    /**
-     * Execute a single task in the current branch.
-     */
-    private executeTask;
-    private startHeartbeat;
-    private stopHeartbeat;
-    private sendHeartbeat;
-    run(): Promise<void>;
-}
-//# sourceMappingURL=worker.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/agent/worker.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAc,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGlE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;;;;;;GAUG;AACH,qBAAa,WAAW;IAgBV,OAAO,CAAC,MAAM;IAf1B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,YAAY,CAAe;IACnC,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;IAG5C,OAAO,CAAC,iBAAiB,CAA4C;IACrE,OAAO,CAAC,aAAa,CAAgB;gBAEjB,MAAM,EAAE,YAAY;IAqDxC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAgB;YAmB5D,eAAe;YAcf,WAAW;IAgDzB;;OAEG;YACW,WAAW;IAoCzB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,aAAa;IAoBf,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA4I3B"}