@locusai/sdk 0.4.0 → 0.4.1

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

@@ -1 +1 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/agent/worker.ts"],"names":[],"mappings":"AASA,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,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,qBAAa,WAAW;IAmBV,OAAO,CAAC,MAAM;IAlB1B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,eAAe,CAAyB;IAGhD,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,YAAY,CAAe;IAGnC,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,UAAU,CAAuB;gBAErB,MAAM,EAAE,YAAY;IA+DxC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAgB;YAQ5D,eAAe;YAcf,WAAW;YAiBX,WAAW;IAqBnB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA+F3B"}
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/agent/worker.ts"],"names":[],"mappings":"AAUA,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,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,qBAAa,WAAW;IAmBV,OAAO,CAAC,MAAM;IAlB1B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,eAAe,CAAyB;IAGhD,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,YAAY,CAAe;IAGnC,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,UAAU,CAAuB;gBAErB,MAAM,EAAE,YAAY;IAqExC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAgB;YAe5D,eAAe;YAcf,WAAW;YAiBX,WAAW;IAqBnB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA+F3B"}

package/dist/agent/worker.js

@@ -1,6 +1,7 @@
 import { AnthropicClient } from "../ai/anthropic-client";
 import { ClaudeRunner } from "../ai/claude-runner";
 import { LocusClient } from "../index";
+import { c } from "../utils/colors";
 import { ArtifactSyncer } from "./artifact-syncer";
 import { CodebaseIndexerService } from "./codebase-indexer-service";
 import { SprintPlanner } from "./sprint-planner";
@@ -33,6 +34,12 @@ export class AgentWorker {
         this.client = new LocusClient({
             baseUrl: config.apiBase,
             token: config.apiKey,
+            retryOptions: {
+                maxRetries: 3,
+                initialDelay: 1000,
+                maxDelay: 5000,
+                factor: 2,
+            },
         });
         // Initialize AI clients
         this.claudeRunner = new ClaudeRunner(projectPath, config.model);
@@ -78,8 +85,14 @@ export class AgentWorker {
     }
     log(message, level = "info") {
         const timestamp = new Date().toISOString().split("T")[1]?.slice(0, 8) ?? "";
+        const colorFn = {
+            info: c.cyan,
+            success: c.green,
+            warn: c.yellow,
+            error: c.red,
+        }[level];
         const prefix = { info: "ℹ", success: "✓", warn: "⚠", error: "✗" }[level];
-        console.log(`[${timestamp}] [${this.config.agentId.slice(-8)}] ${prefix} ${message}`);
+        console.log(`${c.dim(`[${timestamp}]`)} ${c.bold(`[${this.config.agentId.slice(-8)}]`)} ${colorFn(`${prefix} ${message}`)}`);
     }
     async getActiveSprint() {
         try {

package/dist/ai/claude-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-runner.d.ts","sourceRoot":"","sources":["../../src/ai/claude-runner.ts"],"names":[],"mappings":"AAGA,qBAAa,YAAY;IAErB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,KAAK;gBADL,WAAW,EAAE,MAAM,EACnB,KAAK,GAAE,MAAsB;IAGvC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,UAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;CAuC1D"}
+{"version":3,"file":"claude-runner.d.ts","sourceRoot":"","sources":["../../src/ai/claude-runner.ts"],"names":[],"mappings":"AAGA,qBAAa,YAAY;IAErB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,KAAK;gBADL,WAAW,EAAE,MAAM,EACnB,KAAK,GAAE,MAAsB;IAGvC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,UAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;CA4C1D"}

package/dist/ai/claude-runner.js

@@ -33,8 +33,13 @@ export class ClaudeRunner {
             claude.on("close", (code) => {
                 if (code === 0)
                     resolve(output);
-                else
-                    reject(new Error(`Claude exited with code ${code}: ${errorOutput}`));
+                else {
+                    const detail = errorOutput.trim();
+                    const message = detail
+                        ? `Claude CLI error: ${detail}`
+                        : `Claude CLI exited with code ${code}. Please ensure the Claude CLI is installed and you are logged in (run 'claude' manually to check).`;
+                    reject(new Error(message));
+                }
             });
             claude.stdin.write(prompt);
             claude.stdin.end();

package/dist/events.d.ts

@@ -1,4 +1,5 @@
 import { EventEmitter } from "events";
+import { RetryOptions } from "./utils/retry";
 export declare enum LocusEvent {
     TOKEN_EXPIRED = "TOKEN_EXPIRED",
     AUTH_ERROR = "AUTH_ERROR",
@@ -8,6 +9,7 @@ export interface LocusConfig {
     baseUrl: string;
     token?: string | null;
     timeout?: number;
+    retryOptions?: RetryOptions;
 }
 export declare class LocusEmitter extends EventEmitter {
     on(event: LocusEvent.TOKEN_EXPIRED, listener: () => void): this;

package/dist/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,oBAAY,UAAU;IACpB,aAAa,kBAAkB;IAC/B,UAAU,eAAe;IACzB,aAAa,kBAAkB;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,YAAa,SAAQ,YAAY;IAC5C,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,aAAa,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAC/D,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IACxE,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,aAAa,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAQ3E,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,aAAa,GAAG,OAAO;IAC9C,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO;IACzD,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,aAAa,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO;CAI7D"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,oBAAY,UAAU;IACpB,aAAa,kBAAkB;IAC/B,UAAU,eAAe;IACzB,aAAa,kBAAkB;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,qBAAa,YAAa,SAAQ,YAAY;IAC5C,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,aAAa,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAC/D,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IACxE,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,aAAa,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAQ3E,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,aAAa,GAAG,OAAO;IAC9C,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO;IACzD,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,aAAa,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO;CAI7D"}

package/dist/index-node.d.ts

@@ -11,4 +11,5 @@ export * from "./ai";
 export * from "./core";
 export * from "./index";
 export { AgentOrchestrator, type OrchestratorConfig } from "./orchestrator";
+export { c } from "./utils/colors";
 //# sourceMappingURL=index-node.d.ts.map

package/dist/index-node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index-node.d.ts","sourceRoot":"","sources":["../src/index-node.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,cAAc,SAAS,CAAC;AAExB,cAAc,MAAM,CAAC;AAErB,cAAc,QAAQ,CAAC;AAEvB,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index-node.d.ts","sourceRoot":"","sources":["../src/index-node.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,cAAc,SAAS,CAAC;AAExB,cAAc,MAAM,CAAC;AAErB,cAAc,QAAQ,CAAC;AAEvB,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAG5E,OAAO,EAAE,CAAC,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index-node.js

@@ -16,3 +16,5 @@ export * from "./core";
 export * from "./index";
 // Node.js-only: Orchestrator
 export { AgentOrchestrator } from "./orchestrator";
+// Utilities
+export { c } from "./utils/colors";

package/dist/index.d.ts

@@ -28,6 +28,7 @@ export declare class LocusClient {
     readonly docs: DocsModule;
     readonly ci: CiModule;
     constructor(config: LocusConfig);
+    private setupRetryInterceptor;
     private setupInterceptors;
     setToken(token: string | null): void;
 }

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAc,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxD,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AAErC,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgB;IACpC,SAAgB,OAAO,EAAE,YAAY,CAAC;IAEtC,SAAgB,IAAI,EAAE,UAAU,CAAC;IACjC,SAAgB,KAAK,EAAE,WAAW,CAAC;IACnC,SAAgB,OAAO,EAAE,aAAa,CAAC;IACvC,SAAgB,UAAU,EAAE,gBAAgB,CAAC;IAC7C,SAAgB,aAAa,EAAE,mBAAmB,CAAC;IACnD,SAAgB,WAAW,EAAE,iBAAiB,CAAC;IAC/C,SAAgB,IAAI,EAAE,UAAU,CAAC;IACjC,SAAgB,EAAE,EAAE,QAAQ,CAAC;gBAEjB,MAAM,EAAE,WAAW;IAyB/B,OAAO,CAAC,iBAAiB;IAmDlB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAOrC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAc,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAIxD,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AAErC,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgB;IACpC,SAAgB,OAAO,EAAE,YAAY,CAAC;IAEtC,SAAgB,IAAI,EAAE,UAAU,CAAC;IACjC,SAAgB,KAAK,EAAE,WAAW,CAAC;IACnC,SAAgB,OAAO,EAAE,aAAa,CAAC;IACvC,SAAgB,UAAU,EAAE,gBAAgB,CAAC;IAC7C,SAAgB,aAAa,EAAE,mBAAmB,CAAC;IACnD,SAAgB,WAAW,EAAE,iBAAiB,CAAC;IAC/C,SAAgB,IAAI,EAAE,UAAU,CAAC;IACjC,SAAgB,EAAE,EAAE,QAAQ,CAAC;gBAEjB,MAAM,EAAE,WAAW;IA6B/B,OAAO,CAAC,qBAAqB;IAmC7B,OAAO,CAAC,iBAAiB;IAmDlB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAOrC"}

package/dist/index.js

@@ -49,6 +49,31 @@ export class LocusClient {
         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);
+        }
+    }
+    setupRetryInterceptor(retryOptions) {
+        this.api.interceptors.response.use(undefined, async (error) => {
+            const config = error.config;
+            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);
+        });
     }
     setupInterceptors() {
         this.api.interceptors.response.use((response) => {

package/dist/orchestrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAS,MAAM,oBAAoB,CAAC;AAGzD,OAAO,EAAE,IAAI,EAA4B,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IACpD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,gBAAgB,CAAuB;gBAEnC,MAAM,EAAE,kBAAkB;IAStC;;OAEG;YACW,eAAe;IAsB7B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB5B;;OAEG;YACW,iBAAiB;IA4C/B;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;YACW,UAAU;IA8HxB;;OAEG;YACW,UAAU;IAKxB;;OAEG;YACW,iBAAiB;IAc/B;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IA2C9D;;OAEG;IACG,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IA4BhB;;OAEG;IACG,QAAQ,CACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC;IAyBhB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B;;OAEG;YACW,OAAO;IAWrB;;OAEG;IACH,QAAQ;;;;;;IAeR,OAAO,CAAC,KAAK;CAGd"}
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAS,MAAM,oBAAoB,CAAC;AAGzD,OAAO,EAAE,IAAI,EAA4B,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAItC,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IACpD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,gBAAgB,CAAuB;gBAEnC,MAAM,EAAE,kBAAkB;IAStC;;OAEG;YACW,eAAe;IAwB7B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB5B;;OAEG;YACW,iBAAiB;IA4C/B;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;YACW,UAAU;IA8HxB;;OAEG;YACW,UAAU;IAKxB;;OAEG;YACW,iBAAiB;IAc/B;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IA2C9D;;OAEG;IACG,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IA4BhB;;OAEG;IACG,QAAQ,CACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC;IAyBhB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B;;OAEG;YACW,OAAO;IAWrB;;OAEG;IACH,QAAQ;;;;;;IAeR,OAAO,CAAC,KAAK;CAGd"}

package/dist/orchestrator.js

@@ -4,6 +4,7 @@ import { dirname, join } from "node:path";
 import { TaskPriority, TaskStatus } from "@locusai/shared";
 import { EventEmitter } from "events";
 import { LocusClient } from "./index";
+import { c } from "./utils/colors";
 export class AgentOrchestrator extends EventEmitter {
     client;
     config;
@@ -30,14 +31,14 @@ export class AgentOrchestrator extends EventEmitter {
         try {
             const sprint = await this.client.sprints.getActive(this.config.workspaceId);
             if (sprint?.id) {
-                console.log(`📋 Using active sprint: ${sprint.name}`);
+                console.log(c.info(`📋 Using active sprint: ${sprint.name}`));
                 return sprint.id;
             }
         }
         catch {
             // No active sprint found, will work with all tasks
         }
-        console.log("ℹ  No sprint specified, working with all workspace tasks");
+        console.log(c.dim("ℹ  No sprint specified, working with all workspace tasks"));
         return "";
     }
     /**
@@ -71,18 +72,18 @@ export class AgentOrchestrator extends EventEmitter {
             config: this.config,
             sprintId: this.resolvedSprintId,
         });
-        console.log("\n🤖 Locus Agent Orchestrator");
-        console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
-        console.log(`Workspace: ${this.config.workspaceId}`);
+        console.log(`\n${c.primary("🤖 Locus Agent Orchestrator")}`);
+        console.log(c.dim("----------------------------------------------"));
+        console.log(`${c.bold("Workspace:")} ${this.config.workspaceId}`);
         if (this.resolvedSprintId) {
-            console.log(`Sprint: ${this.resolvedSprintId}`);
+            console.log(`${c.bold("Sprint:")} ${this.resolvedSprintId}`);
         }
-        console.log(`API Base: ${this.config.apiBase}`);
-        console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n");
+        console.log(`${c.bold("API Base:")} ${this.config.apiBase}`);
+        console.log(c.dim("----------------------------------------------\n"));
         // Check if there are tasks to work on before spawning
         const tasks = await this.getAvailableTasks();
         if (tasks.length === 0) {
-            console.log("ℹ  No available tasks found in the backlog.");
+            console.log(c.dim("ℹ  No available tasks found in the backlog."));
             return;
         }
         // Spawn single agent
@@ -95,7 +96,7 @@ export class AgentOrchestrator extends EventEmitter {
             }
             await this.sleep(2000);
         }
-        console.log("\n✅ Orchestrator finished");
+        console.log(`\n${c.success("✅ Orchestrator finished")}`);
     }
     /**
      * Find the package root by looking for package.json
@@ -127,7 +128,7 @@ export class AgentOrchestrator extends EventEmitter {
             lastHeartbeat: new Date(),
         };
         this.agents.set(agentId, agentState);
-        console.log(`🚀 Agent started: ${agentId}\n`);
+        console.log(`${c.primary("🚀 Agent started:")} ${c.bold(agentId)}\n`);
         // Build arguments for agent worker
         // Try multiple resolution strategies
         const potentialPaths = [];

package/dist/utils/colors.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Simple ANSI color utility for terminal output
+ * Dependency-free and works in Node.js/Bun environments
+ */
+declare const colors: {
+    reset: string;
+    bold: string;
+    dim: string;
+    italic: string;
+    underline: string;
+    black: string;
+    red: string;
+    green: string;
+    yellow: string;
+    blue: string;
+    magenta: string;
+    cyan: string;
+    white: string;
+    gray: string;
+    brightRed: string;
+    brightGreen: string;
+    brightYellow: string;
+    brightBlue: string;
+    brightMagenta: string;
+    brightCyan: string;
+    brightWhite: string;
+};
+type ColorName = keyof typeof colors;
+export declare const c: {
+    text: (text: string, ...colorNames: ColorName[]) => string;
+    bold: (t: string) => string;
+    dim: (t: string) => string;
+    red: (t: string) => string;
+    green: (t: string) => string;
+    yellow: (t: string) => string;
+    blue: (t: string) => string;
+    magenta: (t: string) => string;
+    cyan: (t: string) => string;
+    gray: (t: string) => string;
+    success: (t: string) => string;
+    error: (t: string) => string;
+    warning: (t: string) => string;
+    info: (t: string) => string;
+    primary: (t: string) => string;
+    underline: (t: string) => string;
+};
+export {};
+//# sourceMappingURL=colors.d.ts.map

package/dist/utils/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/utils/colors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;CA0BX,CAAC;AAEF,KAAK,SAAS,GAAG,MAAM,OAAO,MAAM,CAAC;AAErC,eAAO,MAAM,CAAC;iBACC,MAAM,iBAAiB,SAAS,EAAE;cAMrC,MAAM;aACP,MAAM;aACN,MAAM;eACJ,MAAM;gBACL,MAAM;cACR,MAAM;iBACH,MAAM;cACT,MAAM;cACN,MAAM;iBAGH,MAAM;eACR,MAAM;iBACJ,MAAM;cACT,MAAM;iBACH,MAAM;mBACJ,MAAM;CACtB,CAAC"}

package/dist/utils/colors.js

@@ -0,0 +1,54 @@
+/**
+ * Simple ANSI color utility for terminal output
+ * Dependency-free and works in Node.js/Bun environments
+ */
+const ESC = "\u001b[";
+const RESET = `${ESC}0m`;
+const colors = {
+    reset: RESET,
+    bold: `${ESC}1m`,
+    dim: `${ESC}2m`,
+    italic: `${ESC}3m`,
+    underline: `${ESC}4m`,
+    // Foreground colors
+    black: `${ESC}30m`,
+    red: `${ESC}31m`,
+    green: `${ESC}32m`,
+    yellow: `${ESC}33m`,
+    blue: `${ESC}34m`,
+    magenta: `${ESC}35m`,
+    cyan: `${ESC}36m`,
+    white: `${ESC}37m`,
+    gray: `${ESC}90m`,
+    // Foreground bright colors
+    brightRed: `${ESC}91m`,
+    brightGreen: `${ESC}92m`,
+    brightYellow: `${ESC}93m`,
+    brightBlue: `${ESC}94m`,
+    brightMagenta: `${ESC}95m`,
+    brightCyan: `${ESC}96m`,
+    brightWhite: `${ESC}97m`,
+};
+export const c = {
+    text: (text, ...colorNames) => {
+        const codes = colorNames.map((name) => colors[name]).join("");
+        return `${codes}${text}${RESET}`;
+    },
+    // Shortcuts
+    bold: (t) => c.text(t, "bold"),
+    dim: (t) => c.text(t, "dim"),
+    red: (t) => c.text(t, "red"),
+    green: (t) => c.text(t, "green"),
+    yellow: (t) => c.text(t, "yellow"),
+    blue: (t) => c.text(t, "blue"),
+    magenta: (t) => c.text(t, "magenta"),
+    cyan: (t) => c.text(t, "cyan"),
+    gray: (t) => c.text(t, "gray"),
+    // Combinations
+    success: (t) => c.text(t, "green", "bold"),
+    error: (t) => c.text(t, "red", "bold"),
+    warning: (t) => c.text(t, "yellow", "bold"),
+    info: (t) => c.text(t, "cyan", "bold"),
+    primary: (t) => c.text(t, "blue", "bold"),
+    underline: (t) => c.text(t, "underline"),
+};

package/dist/utils/retry.d.ts

@@ -0,0 +1,13 @@
+export interface RetryOptions {
+    maxRetries?: number;
+    initialDelay?: number;
+    maxDelay?: number;
+    factor?: number;
+    retryCondition?: (error: unknown) => boolean;
+}
+export declare const DEFAULT_RETRY_OPTIONS: Required<RetryOptions>;
+/**
+ * Retries an async function with exponential backoff
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/utils/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CAC9C;AAED,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,YAAY,CAaxD,CAAC;AAEF;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,CAAC,CAAC,CAwBZ"}

package/dist/utils/retry.js

@@ -0,0 +1,37 @@
+import { isAxiosError } from "axios";
+export const DEFAULT_RETRY_OPTIONS = {
+    maxRetries: 3,
+    initialDelay: 1000,
+    maxDelay: 5000,
+    factor: 2,
+    retryCondition: (error) => {
+        // Retry on network errors or 5xx server errors
+        if (isAxiosError(error)) {
+            if (!error.response)
+                return true; // Network error
+            return error.response.status >= 500;
+        }
+        return true; // Retry on other unknown errors
+    },
+};
+/**
+ * Retries an async function with exponential backoff
+ */
+export async function withRetry(fn, options = {}) {
+    const config = { ...DEFAULT_RETRY_OPTIONS, ...options };
+    let lastError;
+    for (let attempt = 0; attempt <= config.maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt === config.maxRetries || !config.retryCondition(error)) {
+                throw error;
+            }
+            const delay = Math.min(config.initialDelay * Math.pow(config.factor, attempt), config.maxDelay);
+            await new Promise((resolve) => setTimeout(resolve, delay));
+        }
+    }
+    throw lastError;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@locusai/sdk",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
@@ -41,7 +41,7 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.71.2",
-    "@locusai/shared": "^0.4.0",
+    "@locusai/shared": "^0.4.1",
     "axios": "^1.13.2",
     "events": "^3.3.0",
     "globby": "^14.0.2"

package/src/agent/worker.ts

@@ -2,6 +2,7 @@ import type { Sprint, Task, TaskStatus } from "@locusai/shared";
 import { AnthropicClient } from "../ai/anthropic-client";
 import { ClaudeRunner } from "../ai/claude-runner";
 import { LocusClient } from "../index";
+import { c } from "../utils/colors";
 import { ArtifactSyncer } from "./artifact-syncer";
 import { CodebaseIndexerService } from "./codebase-indexer-service";
 import { SprintPlanner } from "./sprint-planner";
@@ -48,6 +49,12 @@ export class AgentWorker {
     this.client = new LocusClient({
       baseUrl: config.apiBase,
       token: config.apiKey,
+      retryOptions: {
+        maxRetries: 3,
+        initialDelay: 1000,
+        maxDelay: 5000,
+        factor: 2,
+      },
     });
 
     // Initialize AI clients
@@ -106,9 +113,16 @@ export class AgentWorker {
 
   log(message: string, level: "info" | "success" | "warn" | "error" = "info") {
     const timestamp = new Date().toISOString().split("T")[1]?.slice(0, 8) ?? "";
+    const colorFn = {
+      info: c.cyan,
+      success: c.green,
+      warn: c.yellow,
+      error: c.red,
+    }[level];
     const prefix = { info: "ℹ", success: "✓", warn: "⚠", error: "✗" }[level];
+
     console.log(
-      `[${timestamp}] [${this.config.agentId.slice(-8)}] ${prefix} ${message}`
+      `${c.dim(`[${timestamp}]`)} ${c.bold(`[${this.config.agentId.slice(-8)}]`)} ${colorFn(`${prefix} ${message}`)}`
     );
   }
 

package/src/ai/claude-runner.ts

@@ -38,8 +38,13 @@ export class ClaudeRunner {
       );
       claude.on("close", (code) => {
         if (code === 0) resolve(output);
-        else
-          reject(new Error(`Claude exited with code ${code}: ${errorOutput}`));
+        else {
+          const detail = errorOutput.trim();
+          const message = detail
+            ? `Claude CLI error: ${detail}`
+            : `Claude CLI exited with code ${code}. Please ensure the Claude CLI is installed and you are logged in (run 'claude' manually to check).`;
+          reject(new Error(message));
+        }
       });
 
       claude.stdin.write(prompt);

package/src/events.ts

@@ -1,5 +1,7 @@
 import { EventEmitter } from "events";
 
+import { RetryOptions } from "./utils/retry";
+
 export enum LocusEvent {
   TOKEN_EXPIRED = "TOKEN_EXPIRED",
   AUTH_ERROR = "AUTH_ERROR",
@@ -10,6 +12,7 @@ export interface LocusConfig {
   baseUrl: string;
   token?: string | null;
   timeout?: number;
+  retryOptions?: RetryOptions;
 }
 
 export class LocusEmitter extends EventEmitter {

package/src/index-node.ts

@@ -18,3 +18,6 @@ export * from "./index";
 
 // Node.js-only: Orchestrator
 export { AgentOrchestrator, type OrchestratorConfig } from "./orchestrator";
+
+// Utilities
+export { c } from "./utils/colors";

package/src/index.ts

@@ -1,4 +1,4 @@
-import axios, { AxiosInstance } from "axios";
+import axios, { AxiosInstance, InternalAxiosRequestConfig } from "axios";
 import { LocusConfig, LocusEmitter, LocusEvent } from "./events";
 import { AuthModule } from "./modules/auth";
 import { CiModule } from "./modules/ci";
@@ -8,6 +8,7 @@ import { OrganizationsModule } from "./modules/organizations";
 import { SprintsModule } from "./modules/sprints";
 import { TasksModule } from "./modules/tasks";
 import { WorkspacesModule } from "./modules/workspaces";
+import { RetryOptions } from "./utils/retry";
 
 // Browser-safe exports only
 export * from "./events";
@@ -56,6 +57,45 @@ export class LocusClient {
     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() {

package/src/orchestrator.ts

@@ -4,6 +4,7 @@ import { dirname, join } from "node:path";
 import { Task, TaskPriority, TaskStatus } from "@locusai/shared";
 import { EventEmitter } from "events";
 import { LocusClient } from "./index";
+import { c } from "./utils/colors";
 
 export interface AgentConfig {
   id: string;
@@ -62,14 +63,16 @@ export class AgentOrchestrator extends EventEmitter {
         this.config.workspaceId
       );
       if (sprint?.id) {
-        console.log(`📋 Using active sprint: ${sprint.name}`);
+        console.log(c.info(`📋 Using active sprint: ${sprint.name}`));
         return sprint.id;
       }
     } catch {
       // No active sprint found, will work with all tasks
     }
 
-    console.log("ℹ  No sprint specified, working with all workspace tasks");
+    console.log(
+      c.dim("ℹ  No sprint specified, working with all workspace tasks")
+    );
     return "";
   }
 
@@ -107,20 +110,20 @@ export class AgentOrchestrator extends EventEmitter {
       sprintId: this.resolvedSprintId,
     });
 
-    console.log("\n🤖 Locus Agent Orchestrator");
-    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
-    console.log(`Workspace: ${this.config.workspaceId}`);
+    console.log(`\n${c.primary("🤖 Locus Agent Orchestrator")}`);
+    console.log(c.dim("----------------------------------------------"));
+    console.log(`${c.bold("Workspace:")} ${this.config.workspaceId}`);
     if (this.resolvedSprintId) {
-      console.log(`Sprint: ${this.resolvedSprintId}`);
+      console.log(`${c.bold("Sprint:")} ${this.resolvedSprintId}`);
     }
-    console.log(`API Base: ${this.config.apiBase}`);
-    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n");
+    console.log(`${c.bold("API Base:")} ${this.config.apiBase}`);
+    console.log(c.dim("----------------------------------------------\n"));
 
     // Check if there are tasks to work on before spawning
     const tasks = await this.getAvailableTasks();
 
     if (tasks.length === 0) {
-      console.log("ℹ  No available tasks found in the backlog.");
+      console.log(c.dim("ℹ  No available tasks found in the backlog."));
       return;
     }
 
@@ -138,7 +141,7 @@ export class AgentOrchestrator extends EventEmitter {
       await this.sleep(2000);
     }
 
-    console.log("\n✅ Orchestrator finished");
+    console.log(`\n${c.success("✅ Orchestrator finished")}`);
   }
 
   /**
@@ -175,7 +178,7 @@ export class AgentOrchestrator extends EventEmitter {
 
     this.agents.set(agentId, agentState);
 
-    console.log(`🚀 Agent started: ${agentId}\n`);
+    console.log(`${c.primary("🚀 Agent started:")} ${c.bold(agentId)}\n`);
 
     // Build arguments for agent worker
     // Try multiple resolution strategies

package/src/utils/colors.ts

@@ -0,0 +1,63 @@
+/**
+ * Simple ANSI color utility for terminal output
+ * Dependency-free and works in Node.js/Bun environments
+ */
+
+const ESC = "\u001b[";
+const RESET = `${ESC}0m`;
+
+const colors = {
+  reset: RESET,
+  bold: `${ESC}1m`,
+  dim: `${ESC}2m`,
+  italic: `${ESC}3m`,
+  underline: `${ESC}4m`,
+
+  // Foreground colors
+  black: `${ESC}30m`,
+  red: `${ESC}31m`,
+  green: `${ESC}32m`,
+  yellow: `${ESC}33m`,
+  blue: `${ESC}34m`,
+  magenta: `${ESC}35m`,
+  cyan: `${ESC}36m`,
+  white: `${ESC}37m`,
+  gray: `${ESC}90m`,
+
+  // Foreground bright colors
+  brightRed: `${ESC}91m`,
+  brightGreen: `${ESC}92m`,
+  brightYellow: `${ESC}93m`,
+  brightBlue: `${ESC}94m`,
+  brightMagenta: `${ESC}95m`,
+  brightCyan: `${ESC}96m`,
+  brightWhite: `${ESC}97m`,
+};
+
+type ColorName = keyof typeof colors;
+
+export const c = {
+  text: (text: string, ...colorNames: ColorName[]) => {
+    const codes = colorNames.map((name) => colors[name]).join("");
+    return `${codes}${text}${RESET}`;
+  },
+
+  // Shortcuts
+  bold: (t: string) => c.text(t, "bold"),
+  dim: (t: string) => c.text(t, "dim"),
+  red: (t: string) => c.text(t, "red"),
+  green: (t: string) => c.text(t, "green"),
+  yellow: (t: string) => c.text(t, "yellow"),
+  blue: (t: string) => c.text(t, "blue"),
+  magenta: (t: string) => c.text(t, "magenta"),
+  cyan: (t: string) => c.text(t, "cyan"),
+  gray: (t: string) => c.text(t, "gray"),
+
+  // Combinations
+  success: (t: string) => c.text(t, "green", "bold"),
+  error: (t: string) => c.text(t, "red", "bold"),
+  warning: (t: string) => c.text(t, "yellow", "bold"),
+  info: (t: string) => c.text(t, "cyan", "bold"),
+  primary: (t: string) => c.text(t, "blue", "bold"),
+  underline: (t: string) => c.text(t, "underline"),
+};

package/src/utils/retry.ts

@@ -0,0 +1,56 @@
+import { isAxiosError } from "axios";
+
+export interface RetryOptions {
+  maxRetries?: number;
+  initialDelay?: number;
+  maxDelay?: number;
+  factor?: number;
+  retryCondition?: (error: unknown) => boolean;
+}
+
+export const DEFAULT_RETRY_OPTIONS: Required<RetryOptions> = {
+  maxRetries: 3,
+  initialDelay: 1000,
+  maxDelay: 5000,
+  factor: 2,
+  retryCondition: (error: unknown) => {
+    // Retry on network errors or 5xx server errors
+    if (isAxiosError(error)) {
+      if (!error.response) return true; // Network error
+      return error.response.status >= 500;
+    }
+    return true; // Retry on other unknown errors
+  },
+};
+
+/**
+ * Retries an async function with exponential backoff
+ */
+export async function withRetry<T>(
+  fn: () => Promise<T>,
+  options: RetryOptions = {}
+): Promise<T> {
+  const config = { ...DEFAULT_RETRY_OPTIONS, ...options };
+  let lastError: unknown;
+
+  for (let attempt = 0; attempt <= config.maxRetries; attempt++) {
+    try {
+      return await fn();
+    } catch (error: unknown) {
+      lastError = error;
+
+      if (attempt === config.maxRetries || !config.retryCondition(error)) {
+        throw error;
+      }
+
+      const delay = Math.min(
+        config.initialDelay * Math.pow(config.factor, attempt),
+        config.maxDelay
+      );
+
+      await new Promise((resolve) => setTimeout(resolve, delay));
+    }
+  }
+
+  throw lastError;
+}