@locusai/sdk 0.4.6 → 0.4.10

package/src/core/prompt-builder.ts

@@ -1,91 +0,0 @@
-import { existsSync, readFileSync } from "node:fs";
-import { AssigneeRole, Task } from "@locusai/shared";
-import { getLocusPath } from "./config.js";
-
-export class PromptBuilder {
-  constructor(private projectPath: string) {}
-
-  async build(task: Task): Promise<string> {
-    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: Task["assigneeRole"]): string | null {
-    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/src/events.ts

@@ -1,35 +0,0 @@
-import { EventEmitter } from "events";
-
-import { RetryOptions } from "./utils/retry.js";
-
-export enum LocusEvent {
-  TOKEN_EXPIRED = "TOKEN_EXPIRED",
-  AUTH_ERROR = "AUTH_ERROR",
-  REQUEST_ERROR = "REQUEST_ERROR",
-}
-
-export interface LocusConfig {
-  baseUrl: string;
-  token?: string | null;
-  timeout?: number;
-  retryOptions?: RetryOptions;
-}
-
-export class LocusEmitter extends EventEmitter {
-  on(event: LocusEvent.TOKEN_EXPIRED, listener: () => void): this;
-  on(event: LocusEvent.AUTH_ERROR, listener: (error: Error) => void): this;
-  on(event: LocusEvent.REQUEST_ERROR, listener: (error: Error) => void): this;
-  on(
-    event: LocusEvent | string,
-    listener: ((...args: unknown[]) => void) | (() => void)
-  ): this {
-    return super.on(event, listener);
-  }
-
-  emit(event: LocusEvent.TOKEN_EXPIRED): boolean;
-  emit(event: LocusEvent.AUTH_ERROR, error: Error): boolean;
-  emit(event: LocusEvent.REQUEST_ERROR, error: Error): boolean;
-  emit(event: LocusEvent | string, ...args: unknown[]): boolean {
-    return super.emit(event, ...args);
-  }
-}

package/src/index-node.ts

@@ -1,23 +0,0 @@
-/**
- * Node.js-only exports
- * This is a separate entry point for Node.js/CLI only
- * It should NOT be imported by browser applications
- *
- * These modules use Node.js APIs (fs, child_process, etc.)
- * and will break in browser environments
- */
-
-// Node.js-only: Agent system
-export * from "./agent/index.js";
-// Node.js-only: AI clients
-export * from "./ai/index.js";
-// Node.js-only: Core utilities (uses fs)
-export * from "./core/index.js";
-// Re-export everything from main index (browser-safe)
-export * from "./index.js";
-
-// Node.js-only: Orchestrator
-export { AgentOrchestrator, type OrchestratorConfig } from "./orchestrator.js";
-
-// Utilities
-export { c } from "./utils/colors.js";

package/src/index.ts

@@ -1,159 +0,0 @@
-import axios, { AxiosInstance, InternalAxiosRequestConfig } from "axios";
-import { LocusConfig, LocusEmitter, LocusEvent } from "./events.js";
-import { AuthModule } from "./modules/auth.js";
-import { CiModule } from "./modules/ci.js";
-import { DocsModule } from "./modules/docs.js";
-import { InvitationsModule } from "./modules/invitations.js";
-import { OrganizationsModule } from "./modules/organizations.js";
-import { SprintsModule } from "./modules/sprints.js";
-import { TasksModule } from "./modules/tasks.js";
-import { WorkspacesModule } from "./modules/workspaces.js";
-import { RetryOptions } from "./utils/retry.js";
-
-// Browser-safe exports only
-export * from "./events.js";
-export * from "./modules/auth.js";
-export * from "./modules/ci.js";
-export * from "./modules/docs.js";
-export * from "./modules/invitations.js";
-export * from "./modules/organizations.js";
-export * from "./modules/sprints.js";
-export * from "./modules/tasks.js";
-export * from "./modules/workspaces.js";
-
-export class LocusClient {
-  private readonly api: AxiosInstance;
-  public readonly emitter: LocusEmitter;
-
-  public readonly auth: AuthModule;
-  public readonly tasks: TasksModule;
-  public readonly sprints: SprintsModule;
-  public readonly workspaces: WorkspacesModule;
-  public readonly organizations: OrganizationsModule;
-  public readonly invitations: InvitationsModule;
-  public readonly docs: DocsModule;
-  public readonly ci: CiModule;
-
-  constructor(config: LocusConfig) {
-    this.emitter = new LocusEmitter();
-
-    this.api = axios.create({
-      baseURL: config.baseUrl,
-      timeout: config.timeout || 10000,
-      headers: {
-        "Content-Type": "application/json",
-        ...(config.token ? { Authorization: `Bearer ${config.token}` } : {}),
-      },
-    });
-
-    this.setupInterceptors();
-
-    // Initialize modules
-    this.auth = new AuthModule(this.api, this.emitter);
-    this.tasks = new TasksModule(this.api, this.emitter);
-    this.sprints = new SprintsModule(this.api, this.emitter);
-    this.workspaces = new WorkspacesModule(this.api, this.emitter);
-    this.organizations = new OrganizationsModule(this.api, this.emitter);
-    this.invitations = new InvitationsModule(this.api, this.emitter);
-    this.docs = new DocsModule(this.api, this.emitter);
-    this.ci = new CiModule(this.api, this.emitter);
-
-    if (config.retryOptions) {
-      this.setupRetryInterceptor(config.retryOptions);
-    }
-  }
-
-  private setupRetryInterceptor(retryOptions: RetryOptions) {
-    this.api.interceptors.response.use(undefined, async (error) => {
-      const config = error.config as InternalAxiosRequestConfig & {
-        _retryCount?: number;
-      };
-
-      if (!config || !retryOptions) {
-        return Promise.reject(error);
-      }
-
-      config._retryCount = config._retryCount || 0;
-
-      const maxRetries = retryOptions.maxRetries ?? 3;
-      const shouldRetry =
-        config._retryCount < maxRetries &&
-        (retryOptions.retryCondition
-          ? retryOptions.retryCondition(error)
-          : !error.response || error.response.status >= 500);
-
-      if (shouldRetry) {
-        config._retryCount++;
-        const delay = Math.min(
-          (retryOptions.initialDelay ?? 1000) *
-            Math.pow(retryOptions.factor ?? 2, config._retryCount - 1),
-          retryOptions.maxDelay ?? 5000
-        );
-
-        await new Promise((resolve) => setTimeout(resolve, delay));
-        return this.api(config);
-      }
-
-      return Promise.reject(error);
-    });
-  }
-
-  private setupInterceptors() {
-    this.api.interceptors.response.use(
-      (response) => {
-        if (
-          response.data &&
-          typeof response.data === "object" &&
-          "data" in response.data
-        ) {
-          response.data = response.data.data;
-        }
-        return response;
-      },
-      (error) => {
-        const status = error.response?.status;
-
-        // Extract error message from API response format: { error: { message: "..." } }
-        let message: string;
-
-        // Try to get message from API error response
-        if (
-          error.response?.data?.error?.message &&
-          typeof error.response.data.error.message === "string"
-        ) {
-          message = error.response.data.error.message;
-        } else if (
-          error.response?.data?.message &&
-          typeof error.response.data.message === "string"
-        ) {
-          message = error.response.data.message;
-        } else if (error.message && typeof error.message === "string") {
-          message = error.message;
-        } else {
-          message = "An error occurred";
-        }
-
-        // Create a new error with a meaningful message
-        const enhancedError = new Error(message);
-        enhancedError.name = `HTTP${status || "Error"}`;
-
-        if (status === 401) {
-          this.emitter.emit(LocusEvent.TOKEN_EXPIRED);
-          this.emitter.emit(LocusEvent.AUTH_ERROR, enhancedError);
-        } else {
-          this.emitter.emit(LocusEvent.REQUEST_ERROR, enhancedError);
-        }
-
-        return Promise.reject(enhancedError);
-      }
-    );
-  }
-
-  public setToken(token: string | null) {
-    if (token) {
-      this.api.defaults.headers.common.Authorization = `Bearer ${token}`;
-    } else {
-      delete this.api.defaults.headers.common.Authorization;
-    }
-  }
-}

package/src/modules/auth.ts

@@ -1,48 +0,0 @@
-import {
-  CompleteRegistration,
-  LoginResponse,
-  User,
-  VerifyOtp,
-} from "@locusai/shared";
-import { BaseModule } from "./base.js";
-
-export class AuthModule extends BaseModule {
-  async getMe(): Promise<User> {
-    const { data } = await this.api.get<User>("/auth/me");
-    return data;
-  }
-
-  async requestRegisterOtp(email: string): Promise<{ success: boolean }> {
-    const { data } = await this.api.post<{ success: boolean }>(
-      "/auth/register-otp",
-      { email }
-    );
-    return data;
-  }
-
-  async requestLoginOtp(email: string): Promise<{ success: boolean }> {
-    const { data } = await this.api.post<{ success: boolean }>(
-      "/auth/login-otp",
-      { email }
-    );
-    return data;
-  }
-
-  async verifyLogin(body: VerifyOtp): Promise<LoginResponse> {
-    const { data } = await this.api.post<LoginResponse>(
-      "/auth/verify-login",
-      body
-    );
-    return data;
-  }
-
-  async completeRegistration(
-    body: CompleteRegistration
-  ): Promise<LoginResponse> {
-    const { data } = await this.api.post<LoginResponse>(
-      "/auth/complete-registration",
-      body
-    );
-    return data;
-  }
-}

package/src/modules/base.ts

@@ -1,9 +0,0 @@
-import { AxiosInstance } from "axios";
-import { LocusEmitter } from "../events.js";
-
-export abstract class BaseModule {
-  constructor(
-    protected readonly api: AxiosInstance,
-    protected readonly emitter: LocusEmitter
-  ) {}
-}

package/src/modules/ci.ts

@@ -1,12 +0,0 @@
-import { ReportCiResult } from "@locusai/shared";
-import { BaseModule } from "./base.js";
-
-export class CiModule extends BaseModule {
-  async report(body: ReportCiResult): Promise<{ success: boolean }> {
-    const { data } = await this.api.post<{ success: boolean }>(
-      "/ci/report",
-      body
-    );
-    return data;
-  }
-}

package/src/modules/docs.ts

@@ -1,84 +0,0 @@
-import {
-  CreateDoc,
-  CreateDocGroup,
-  Doc,
-  DocGroup,
-  DocGroupResponse,
-  DocGroupsResponse,
-  DocResponse,
-  DocsResponse,
-  UpdateDoc,
-  UpdateDocGroup,
-} from "@locusai/shared";
-import { BaseModule } from "./base.js";
-
-export class DocsModule extends BaseModule {
-  async create(workspaceId: string, body: CreateDoc): Promise<Doc> {
-    const { data } = await this.api.post<DocResponse>(
-      `/workspaces/${workspaceId}/docs`,
-      body
-    );
-    return data.doc;
-  }
-
-  async list(workspaceId: string): Promise<Doc[]> {
-    const { data } = await this.api.get<DocsResponse>(
-      `/workspaces/${workspaceId}/docs`
-    );
-    return data.docs;
-  }
-
-  async getById(id: string, workspaceId: string): Promise<Doc> {
-    const { data } = await this.api.get<DocResponse>(
-      `/workspaces/${workspaceId}/docs/${id}`
-    );
-    return data.doc;
-  }
-
-  async update(id: string, workspaceId: string, body: UpdateDoc): Promise<Doc> {
-    const { data } = await this.api.put<DocResponse>(
-      `/workspaces/${workspaceId}/docs/${id}`,
-      body
-    );
-    return data.doc;
-  }
-
-  async delete(id: string, workspaceId: string): Promise<void> {
-    await this.api.delete(`/workspaces/${workspaceId}/docs/${id}`);
-  }
-
-  // Group Management
-  async listGroups(workspaceId: string): Promise<DocGroup[]> {
-    const { data } = await this.api.get<DocGroupsResponse>(
-      `/workspaces/${workspaceId}/doc-groups`
-    );
-    return data.groups;
-  }
-
-  async createGroup(
-    workspaceId: string,
-    body: CreateDocGroup
-  ): Promise<DocGroup> {
-    const { data } = await this.api.post<DocGroupResponse>(
-      `/workspaces/${workspaceId}/doc-groups`,
-      body
-    );
-    return data.group;
-  }
-
-  async updateGroup(
-    id: string,
-    workspaceId: string,
-    body: UpdateDocGroup
-  ): Promise<DocGroup> {
-    const { data } = await this.api.patch<DocGroupResponse>(
-      `/workspaces/${workspaceId}/doc-groups/${id}`,
-      body
-    );
-    return data.group;
-  }
-
-  async deleteGroup(id: string, workspaceId: string): Promise<void> {
-    await this.api.delete(`/workspaces/${workspaceId}/doc-groups/${id}`);
-  }
-}

package/src/modules/invitations.ts

@@ -1,45 +0,0 @@
-import {
-  AcceptInvitation,
-  AcceptInvitationResponse,
-  CreateInvitation,
-  Invitation,
-  InvitationResponse,
-  InvitationsResponse,
-} from "@locusai/shared";
-import { BaseModule } from "./base.js";
-
-export class InvitationsModule extends BaseModule {
-  async create(orgId: string, body: CreateInvitation): Promise<Invitation> {
-    const { data } = await this.api.post<InvitationResponse>(
-      `/org/${orgId}/invitations`,
-      body
-    );
-    return data.invitation;
-  }
-
-  async list(orgId: string): Promise<Invitation[]> {
-    const { data } = await this.api.get<InvitationsResponse>(
-      `/org/${orgId}/invitations`
-    );
-    return data.invitations;
-  }
-
-  async verify(token: string): Promise<InvitationResponse> {
-    const { data } = await this.api.get<InvitationResponse>(
-      `/invitations/verify/${token}`
-    );
-    return data;
-  }
-
-  async accept(body: AcceptInvitation): Promise<AcceptInvitationResponse> {
-    const { data } = await this.api.post<AcceptInvitationResponse>(
-      "/invitations/accept",
-      body
-    );
-    return data;
-  }
-
-  async revoke(orgId: string, id: string): Promise<void> {
-    await this.api.delete(`/org/${orgId}/invitations/${id}`);
-  }
-}

package/src/modules/organizations.ts

@@ -1,90 +0,0 @@
-import {
-  AddMember,
-  MembershipResponse,
-  MembershipWithUser,
-  MembersResponse,
-  Organization,
-  OrganizationResponse,
-  OrganizationsResponse,
-} from "@locusai/shared";
-import { BaseModule } from "./base.js";
-
-export interface ApiKey {
-  id: string;
-  organizationId: string;
-  name: string;
-  key: string;
-  active: boolean;
-  lastUsedAt: string | null;
-  createdAt: string;
-  updatedAt: string;
-}
-
-interface ApiKeysResponse {
-  apiKeys: ApiKey[];
-}
-
-interface ApiKeyResponse {
-  apiKey: ApiKey;
-}
-
-export class OrganizationsModule extends BaseModule {
-  async list(): Promise<Organization[]> {
-    const { data } =
-      await this.api.get<OrganizationsResponse>("/organizations");
-    return data.organizations;
-  }
-
-  async getById(id: string): Promise<Organization> {
-    const { data } = await this.api.get<OrganizationResponse>(
-      `/organizations/${id}`
-    );
-    return data.organization;
-  }
-
-  async listMembers(id: string): Promise<MembershipWithUser[]> {
-    const { data } = await this.api.get<MembersResponse>(
-      `/organizations/${id}/members`
-    );
-    return data.members;
-  }
-
-  async addMember(id: string, body: AddMember): Promise<MembershipWithUser> {
-    const { data } = await this.api.post<MembershipResponse>(
-      `/organizations/${id}/members`,
-      body
-    );
-    return data.membership;
-  }
-
-  async removeMember(orgId: string, userId: string): Promise<void> {
-    await this.api.delete(`/organizations/${orgId}/members/${userId}`);
-  }
-
-  async delete(orgId: string): Promise<void> {
-    await this.api.delete(`/organizations/${orgId}`);
-  }
-
-  // ============================================================================
-  // API Key Management
-  // ============================================================================
-
-  async listApiKeys(orgId: string): Promise<ApiKey[]> {
-    const { data } = await this.api.get<ApiKeysResponse>(
-      `/organizations/${orgId}/api-keys`
-    );
-    return data.apiKeys;
-  }
-
-  async createApiKey(orgId: string, name: string): Promise<ApiKey> {
-    const { data } = await this.api.post<ApiKeyResponse>(
-      `/organizations/${orgId}/api-keys`,
-      { name }
-    );
-    return data.apiKey;
-  }
-
-  async deleteApiKey(orgId: string, keyId: string): Promise<void> {
-    await this.api.delete(`/organizations/${orgId}/api-keys/${keyId}`);
-  }
-}

package/src/modules/sprints.ts

@@ -1,69 +0,0 @@
-import {
-  CreateSprint,
-  Sprint,
-  SprintResponse,
-  SprintsResponse,
-  UpdateSprint,
-} from "@locusai/shared";
-import { BaseModule } from "./base.js";
-
-export class SprintsModule extends BaseModule {
-  async list(workspaceId: string): Promise<Sprint[]> {
-    const { data } = await this.api.get<SprintsResponse>(
-      `/workspaces/${workspaceId}/sprints`
-    );
-    return data.sprints;
-  }
-
-  async getActive(workspaceId: string): Promise<Sprint> {
-    const { data } = await this.api.get<SprintResponse>(
-      `/workspaces/${workspaceId}/sprints/active`
-    );
-    return data.sprint;
-  }
-
-  async getById(id: string, workspaceId: string): Promise<Sprint> {
-    const { data } = await this.api.get<SprintResponse>(
-      `/workspaces/${workspaceId}/sprints/${id}`
-    );
-    return data.sprint;
-  }
-
-  async create(workspaceId: string, body: CreateSprint): Promise<Sprint> {
-    const { data } = await this.api.post<SprintResponse>(
-      `/workspaces/${workspaceId}/sprints`,
-      body
-    );
-    return data.sprint;
-  }
-
-  async update(
-    id: string,
-    workspaceId: string,
-    body: UpdateSprint
-  ): Promise<Sprint> {
-    const { data } = await this.api.patch<SprintResponse>(
-      `/workspaces/${workspaceId}/sprints/${id}`,
-      body
-    );
-    return data.sprint;
-  }
-
-  async delete(id: string, workspaceId: string): Promise<void> {
-    await this.api.delete(`/workspaces/${workspaceId}/sprints/${id}`);
-  }
-
-  async start(id: string, workspaceId: string): Promise<Sprint> {
-    const { data } = await this.api.post<SprintResponse>(
-      `/workspaces/${workspaceId}/sprints/${id}/start`
-    );
-    return data.sprint;
-  }
-
-  async complete(id: string, workspaceId: string): Promise<Sprint> {
-    const { data } = await this.api.post<SprintResponse>(
-      `/workspaces/${workspaceId}/sprints/${id}/complete`
-    );
-    return data.sprint;
-  }
-}