@locusai/sdk 0.4.5 → 0.4.9

package/dist/core/index.js

@@ -1,3 +0,0 @@
-export { DEFAULT_MODEL, getLocusPath, LOCUS_CONFIG } from "./config.js";
-export { CodebaseIndexer } from "./indexer.js";
-export { PromptBuilder } from "./prompt-builder.js";

package/dist/core/indexer.js

@@ -1,113 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { globby } from "globby";
-export class CodebaseIndexer {
-    projectPath;
-    indexPath;
-    constructor(projectPath) {
-        this.projectPath = projectPath;
-        this.indexPath = join(projectPath, ".locus", "codebase-index.json");
-    }
-    /**
-     * Generates a codebase index by providing the entire file tree to an AI summarizer.
-     * This is much more efficient than per-file indexing for large projects.
-     */
-    async index(onProgress, treeSummarizer) {
-        if (!treeSummarizer) {
-            throw new Error("A treeSummarizer is required for this indexing method.");
-        }
-        if (onProgress)
-            onProgress("Generating file tree...");
-        // 1. Get a comprehensive but clean file tree
-        const gitmodulesPath = join(this.projectPath, ".gitmodules");
-        const submoduleIgnores = [];
-        if (existsSync(gitmodulesPath)) {
-            try {
-                const content = readFileSync(gitmodulesPath, "utf-8");
-                const lines = content.split("\n");
-                for (const line of lines) {
-                    const match = line.match(/^\s*path\s*=\s*(.*)$/);
-                    const path = match?.[1]?.trim();
-                    if (path) {
-                        submoduleIgnores.push(`${path}/**`);
-                        submoduleIgnores.push(`**/${path}/**`);
-                    }
-                }
-            }
-            catch {
-                // Fallback if .gitmodules exists but can't be read or parsed
-            }
-        }
-        const files = await globby(["**/*"], {
-            cwd: this.projectPath,
-            gitignore: true,
-            ignore: [
-                ...submoduleIgnores,
-                "**/node_modules/**",
-                "**/dist/**",
-                "**/build/**",
-                "**/target/**", // Rust build artifacts
-                "**/bin/**",
-                "**/obj/**",
-                "**/.next/**",
-                "**/.svelte-kit/**",
-                "**/.nuxt/**",
-                "**/.cache/**",
-                "**/out/**",
-                "**/__tests__/**",
-                "**/coverage/**",
-                "**/*.test.*",
-                "**/*.spec.*",
-                "**/*.d.ts",
-                "**/tsconfig.tsbuildinfo",
-                "**/.locus/*.json", // Ignore index and other system JSONs
-                "**/.locus/*.md", // Ignore system MDs
-                "**/.locus/!(artifacts)/**", // Ignore everything in .locus EXCEPT artifacts
-                "**/.git/**",
-                "**/.svn/**",
-                "**/.hg/**",
-                "**/.vscode/**",
-                "**/.idea/**",
-                "**/.DS_Store",
-                "**/bun.lock",
-                "**/package-lock.json",
-                "**/yarn.lock",
-                "**/pnpm-lock.yaml",
-                "**/Cargo.lock",
-                "**/go.sum",
-                "**/poetry.lock",
-                // Binary/Large Assets
-                "**/*.{png,jpg,jpeg,gif,svg,ico,mp4,webm,wav,mp3,woff,woff2,eot,ttf,otf,pdf,zip,tar.gz,rar}",
-            ],
-        });
-        // Format the tree for the AI
-        const treeString = files.join("\n");
-        if (onProgress)
-            onProgress("AI is analyzing codebase structure...");
-        // 2. Ask AI to generate the index based on the tree
-        const index = await treeSummarizer(treeString);
-        // 3. Post-process: Ensure symbols are extracted for core files if not provided by AI
-        // (AI is good at structure, but might miss specific exports unless it reads the files)
-        // For now, we trust the AI's structural summary and can supplement symbols later if needed.
-        index.lastIndexed = new Date().toISOString();
-        return index;
-    }
-    loadIndex() {
-        if (existsSync(this.indexPath)) {
-            try {
-                return JSON.parse(readFileSync(this.indexPath, "utf-8"));
-            }
-            catch {
-                return null;
-            }
-        }
-        return null;
-    }
-    saveIndex(index) {
-        const dir = dirname(this.indexPath);
-        if (!existsSync(dir)) {
-            mkdirSync(dir, { recursive: true });
-        }
-        writeFileSync(this.indexPath, JSON.stringify(index, null, 2));
-    }
-}

package/dist/core/prompt-builder.js

@@ -1,83 +0,0 @@
-import { existsSync, readFileSync } from "node:fs";
-import { AssigneeRole } from "@locusai/shared";
-import { getLocusPath } from "./config.js";
-export class PromptBuilder {
-    projectPath;
-    constructor(projectPath) {
-        this.projectPath = projectPath;
-    }
-    async build(task) {
-        let prompt = `# Task: ${task.title}\n\n`;
-        const roleText = this.roleToText(task.assigneeRole);
-        if (roleText) {
-            prompt += `## Role\nYou are acting as a ${roleText}.\n\n`;
-        }
-        prompt += `## Description\n${task.description || "No description provided."}\n\n`;
-        // 1. Add CLAUDE.md context
-        const contextPath = getLocusPath(this.projectPath, "contextFile");
-        if (existsSync(contextPath)) {
-            try {
-                const context = readFileSync(contextPath, "utf-8");
-                prompt += `## Project Context (from CLAUDE.md)\n${context}\n\n`;
-            }
-            catch (err) {
-                console.warn(`Warning: Could not read context file: ${err}`);
-            }
-        }
-        // 2. Add Codebase Index context
-        const indexPath = getLocusPath(this.projectPath, "indexFile");
-        if (existsSync(indexPath)) {
-            prompt += `## Codebase Overview\nThere is an index file in the .locus/codebase-index.json and if you need you can check it.\n\n`;
-        }
-        // 3. Add Documents
-        if (task.docs && task.docs.length > 0) {
-            prompt += `## Attached Documents\n`;
-            for (const doc of task.docs) {
-                prompt += `### ${doc.title}\n${doc.content || "(No content)"}\n\n`;
-            }
-        }
-        // 4. Add Checklist
-        if (task.acceptanceChecklist && task.acceptanceChecklist.length > 0) {
-            prompt += `## Acceptance Criteria\n`;
-            for (const item of task.acceptanceChecklist) {
-                prompt += `- ${item.done ? "[x]" : "[ ]"} ${item.text}\n`;
-            }
-            prompt += "\n";
-        }
-        // 5. Add Comments & Feedback
-        if (task.comments && task.comments.length > 0) {
-            const comments = task.comments.slice(0, 5);
-            prompt += `## Task History & Feedback\n`;
-            prompt += `Review the following comments for context or rejection feedback:\n\n`;
-            for (const comment of comments) {
-                const date = new Date(comment.createdAt).toLocaleString();
-                prompt += `### ${comment.author} (${date})\n${comment.text}\n\n`;
-            }
-        }
-        prompt += `## Instructions
-1. Complete this task. 
-2. **Artifact Management**: If you create any high-level documentation (PRDs, technical drafts, architecture docs), you MUST save them in \`.locus/artifacts/\`. Do NOT create them in the root directory.
-3. **Paths**: Use relative paths from the project root at all times. Do NOT use absolute local paths (e.g., /Users/...).
-4. When finished successfully, output: <promise>COMPLETE</promise>\n`;
-        return prompt;
-    }
-    roleToText(role) {
-        if (!role) {
-            return null;
-        }
-        switch (role) {
-            case AssigneeRole.BACKEND:
-                return "Backend Engineer";
-            case AssigneeRole.FRONTEND:
-                return "Frontend Engineer";
-            case AssigneeRole.PM:
-                return "Product Manager";
-            case AssigneeRole.QA:
-                return "QA Engineer";
-            case AssigneeRole.DESIGN:
-                return "Product Designer";
-            default:
-                return "engineer";
-        }
-    }
-}

package/dist/events.js

@@ -1,15 +0,0 @@
-import { EventEmitter } from "events";
-export var LocusEvent;
-(function (LocusEvent) {
-    LocusEvent["TOKEN_EXPIRED"] = "TOKEN_EXPIRED";
-    LocusEvent["AUTH_ERROR"] = "AUTH_ERROR";
-    LocusEvent["REQUEST_ERROR"] = "REQUEST_ERROR";
-})(LocusEvent || (LocusEvent = {}));
-export class LocusEmitter extends EventEmitter {
-    on(event, listener) {
-        return super.on(event, listener);
-    }
-    emit(event, ...args) {
-        return super.emit(event, ...args);
-    }
-}

package/dist/modules/auth.js

@@ -1,23 +0,0 @@
-import { BaseModule } from "./base.js";
-export class AuthModule extends BaseModule {
-    async getMe() {
-        const { data } = await this.api.get("/auth/me");
-        return data;
-    }
-    async requestRegisterOtp(email) {
-        const { data } = await this.api.post("/auth/register-otp", { email });
-        return data;
-    }
-    async requestLoginOtp(email) {
-        const { data } = await this.api.post("/auth/login-otp", { email });
-        return data;
-    }
-    async verifyLogin(body) {
-        const { data } = await this.api.post("/auth/verify-login", body);
-        return data;
-    }
-    async completeRegistration(body) {
-        const { data } = await this.api.post("/auth/complete-registration", body);
-        return data;
-    }
-}

package/dist/modules/base.js

@@ -1,8 +0,0 @@
-export class BaseModule {
-    api;
-    emitter;
-    constructor(api, emitter) {
-        this.api = api;
-        this.emitter = emitter;
-    }
-}

package/dist/modules/ci.js

@@ -1,7 +0,0 @@
-import { BaseModule } from "./base.js";
-export class CiModule extends BaseModule {
-    async report(body) {
-        const { data } = await this.api.post("/ci/report", body);
-        return data;
-    }
-}

package/dist/modules/docs.js

@@ -1,38 +0,0 @@
-import { BaseModule } from "./base.js";
-export class DocsModule extends BaseModule {
-    async create(workspaceId, body) {
-        const { data } = await this.api.post(`/workspaces/${workspaceId}/docs`, body);
-        return data.doc;
-    }
-    async list(workspaceId) {
-        const { data } = await this.api.get(`/workspaces/${workspaceId}/docs`);
-        return data.docs;
-    }
-    async getById(id, workspaceId) {
-        const { data } = await this.api.get(`/workspaces/${workspaceId}/docs/${id}`);
-        return data.doc;
-    }
-    async update(id, workspaceId, body) {
-        const { data } = await this.api.put(`/workspaces/${workspaceId}/docs/${id}`, body);
-        return data.doc;
-    }
-    async delete(id, workspaceId) {
-        await this.api.delete(`/workspaces/${workspaceId}/docs/${id}`);
-    }
-    // Group Management
-    async listGroups(workspaceId) {
-        const { data } = await this.api.get(`/workspaces/${workspaceId}/doc-groups`);
-        return data.groups;
-    }
-    async createGroup(workspaceId, body) {
-        const { data } = await this.api.post(`/workspaces/${workspaceId}/doc-groups`, body);
-        return data.group;
-    }
-    async updateGroup(id, workspaceId, body) {
-        const { data } = await this.api.patch(`/workspaces/${workspaceId}/doc-groups/${id}`, body);
-        return data.group;
-    }
-    async deleteGroup(id, workspaceId) {
-        await this.api.delete(`/workspaces/${workspaceId}/doc-groups/${id}`);
-    }
-}

package/dist/modules/invitations.js

@@ -1,22 +0,0 @@
-import { BaseModule } from "./base.js";
-export class InvitationsModule extends BaseModule {
-    async create(orgId, body) {
-        const { data } = await this.api.post(`/org/${orgId}/invitations`, body);
-        return data.invitation;
-    }
-    async list(orgId) {
-        const { data } = await this.api.get(`/org/${orgId}/invitations`);
-        return data.invitations;
-    }
-    async verify(token) {
-        const { data } = await this.api.get(`/invitations/verify/${token}`);
-        return data;
-    }
-    async accept(body) {
-        const { data } = await this.api.post("/invitations/accept", body);
-        return data;
-    }
-    async revoke(orgId, id) {
-        await this.api.delete(`/org/${orgId}/invitations/${id}`);
-    }
-}

package/dist/modules/organizations.js

@@ -1,39 +0,0 @@
-import { BaseModule } from "./base.js";
-export class OrganizationsModule extends BaseModule {
-    async list() {
-        const { data } = await this.api.get("/organizations");
-        return data.organizations;
-    }
-    async getById(id) {
-        const { data } = await this.api.get(`/organizations/${id}`);
-        return data.organization;
-    }
-    async listMembers(id) {
-        const { data } = await this.api.get(`/organizations/${id}/members`);
-        return data.members;
-    }
-    async addMember(id, body) {
-        const { data } = await this.api.post(`/organizations/${id}/members`, body);
-        return data.membership;
-    }
-    async removeMember(orgId, userId) {
-        await this.api.delete(`/organizations/${orgId}/members/${userId}`);
-    }
-    async delete(orgId) {
-        await this.api.delete(`/organizations/${orgId}`);
-    }
-    // ============================================================================
-    // API Key Management
-    // ============================================================================
-    async listApiKeys(orgId) {
-        const { data } = await this.api.get(`/organizations/${orgId}/api-keys`);
-        return data.apiKeys;
-    }
-    async createApiKey(orgId, name) {
-        const { data } = await this.api.post(`/organizations/${orgId}/api-keys`, { name });
-        return data.apiKey;
-    }
-    async deleteApiKey(orgId, keyId) {
-        await this.api.delete(`/organizations/${orgId}/api-keys/${keyId}`);
-    }
-}

package/dist/modules/sprints.js

@@ -1,34 +0,0 @@
-import { BaseModule } from "./base.js";
-export class SprintsModule extends BaseModule {
-    async list(workspaceId) {
-        const { data } = await this.api.get(`/workspaces/${workspaceId}/sprints`);
-        return data.sprints;
-    }
-    async getActive(workspaceId) {
-        const { data } = await this.api.get(`/workspaces/${workspaceId}/sprints/active`);
-        return data.sprint;
-    }
-    async getById(id, workspaceId) {
-        const { data } = await this.api.get(`/workspaces/${workspaceId}/sprints/${id}`);
-        return data.sprint;
-    }
-    async create(workspaceId, body) {
-        const { data } = await this.api.post(`/workspaces/${workspaceId}/sprints`, body);
-        return data.sprint;
-    }
-    async update(id, workspaceId, body) {
-        const { data } = await this.api.patch(`/workspaces/${workspaceId}/sprints/${id}`, body);
-        return data.sprint;
-    }
-    async delete(id, workspaceId) {
-        await this.api.delete(`/workspaces/${workspaceId}/sprints/${id}`);
-    }
-    async start(id, workspaceId) {
-        const { data } = await this.api.post(`/workspaces/${workspaceId}/sprints/${id}/start`);
-        return data.sprint;
-    }
-    async complete(id, workspaceId) {
-        const { data } = await this.api.post(`/workspaces/${workspaceId}/sprints/${id}/complete`);
-        return data.sprint;
-    }
-}

package/dist/modules/tasks.js

@@ -1,56 +0,0 @@
-import { TaskStatus, } from "@locusai/shared";
-import { BaseModule } from "./base.js";
-export class TasksModule extends BaseModule {
-    /**
-     * List all tasks in a workspace, optionally filtered
-     */
-    async list(workspaceId, options) {
-        const { data } = await this.api.get(`/workspaces/${workspaceId}/tasks`);
-        let tasks = data.tasks;
-        // Client-side filtering (API doesn't support query params yet)
-        if (options?.sprintId) {
-            tasks = tasks.filter((t) => t.sprintId === options.sprintId);
-        }
-        if (options?.status) {
-            const statuses = Array.isArray(options.status)
-                ? options.status
-                : [options.status];
-            tasks = tasks.filter((t) => statuses.includes(t.status));
-        }
-        return tasks;
-    }
-    /**
-     * Get available tasks for an agent to work on.
-     * Returns tasks in BACKLOG or IN_PROGRESS (unassigned) status.
-     */
-    async getAvailable(workspaceId, sprintId) {
-        const tasks = await this.list(workspaceId, {
-            sprintId,
-        });
-        return tasks.filter((t) => t.status === TaskStatus.BACKLOG ||
-            (t.status === TaskStatus.IN_PROGRESS && !t.assignedTo));
-    }
-    async getById(id, workspaceId) {
-        const { data } = await this.api.get(`/workspaces/${workspaceId}/tasks/${id}`);
-        return data.task;
-    }
-    async create(workspaceId, body) {
-        const { data } = await this.api.post(`/workspaces/${workspaceId}/tasks`, body);
-        return data.task;
-    }
-    async update(id, workspaceId, body) {
-        const { data } = await this.api.patch(`/workspaces/${workspaceId}/tasks/${id}`, body);
-        return data.task;
-    }
-    async delete(id, workspaceId) {
-        await this.api.delete(`/workspaces/${workspaceId}/tasks/${id}`);
-    }
-    async getBacklog(workspaceId) {
-        const { data } = await this.api.get(`/workspaces/${workspaceId}/tasks/backlog`);
-        return data.tasks;
-    }
-    async addComment(id, workspaceId, body) {
-        const { data } = await this.api.post(`/workspaces/${workspaceId}/tasks/${id}/comment`, body);
-        return data.comment;
-    }
-}

package/dist/modules/workspaces.js

@@ -1,49 +0,0 @@
-import { BaseModule } from "./base.js";
-export class WorkspacesModule extends BaseModule {
-    async listAll() {
-        const { data } = await this.api.get("/workspaces");
-        return data.workspaces;
-    }
-    async listByOrg(orgId) {
-        const { data } = await this.api.get(`/workspaces/org/${orgId}`);
-        return data.workspaces;
-    }
-    async create(body) {
-        const { orgId, ...bodyWithoutOrgId } = body;
-        const { data } = await this.api.post(`/workspaces/org/${orgId}`, bodyWithoutOrgId);
-        return data.workspace;
-    }
-    async createWithAutoOrg(body) {
-        const { data } = await this.api.post("/workspaces", body);
-        return data.workspace;
-    }
-    async getById(id) {
-        const { data } = await this.api.get(`/workspaces/${id}`);
-        return data.workspace;
-    }
-    async update(id, body) {
-        const { data } = await this.api.put(`/workspaces/${id}`, body);
-        return data.workspace;
-    }
-    async delete(id) {
-        await this.api.delete(`/workspaces/${id}`);
-    }
-    async getStats(id) {
-        const { data } = await this.api.get(`/workspaces/${id}/stats`);
-        return data;
-    }
-    async getActivity(id, limit) {
-        const { data } = await this.api.get(`/workspaces/${id}/activity`, {
-            params: { limit },
-        });
-        return data.activity;
-    }
-    /**
-     * Dispatch a task from the workspace backlog to an agent.
-     * Atomically moves a task from BACKLOG to IN_PROGRESS and assigns it.
-     */
-    async dispatch(id, workerId, sprintId) {
-        const { data } = await this.api.post(`/workspaces/${id}/dispatch`, { workerId, sprintId });
-        return data.task;
-    }
-}