aura-code 0.3.0

package/dist/viz/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/viz/index.ts"],"names":[],"mappings":"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"}

package/dist/workflows/engine.d.ts

@@ -0,0 +1,46 @@
+import type { WorkflowStep, WorkflowState, StepResult } from './types.js';
+/** Returns ~/.aura/workflows (or $AURA_WORKFLOW_DIR if set). */
+export declare function workflowsDir(): string;
+/** Callback the engine invokes to run a single step's task. */
+export type RunStepFn = (task: string, stepIndex: number, previousResults: StepResult[]) => Promise<StepResult>;
+/**
+ * Creates a new workflow definition and its initial state.
+ * Persists the state to ~/.aura/workflows/<id>.json.
+ * Returns the workflow state.
+ */
+export declare function createWorkflow(opts: {
+    name: string;
+    description?: string;
+    steps: WorkflowStep[];
+}): Promise<WorkflowState>;
+/** Persists the current workflow state to disk. */
+export declare function saveWorkflowState(state: WorkflowState): Promise<void>;
+/** Loads a workflow state from disk by ID. Returns null if not found. */
+export declare function loadWorkflowState(id: string): Promise<WorkflowState | null>;
+/**
+ * Lists all persisted workflows.
+ * Returns an array of workflow states sorted by creation time (newest first).
+ */
+export declare function listWorkflows(): Promise<WorkflowState[]>;
+/**
+ * Executes a workflow from the beginning.
+ * Runs steps sequentially, persisting state after each step completes.
+ * Stops if a step fails.
+ *
+ * @param state   — the workflow state to execute (from createWorkflow)
+ * @param runStep — callback that executes a single step's task
+ * @returns the final workflow state
+ */
+export declare function runWorkflow(state: WorkflowState, runStep: RunStepFn): Promise<WorkflowState>;
+/**
+ * Resumes a workflow from disk.
+ * Finds the first non-done step and runs from there.
+ * Steps with status 'done' are skipped (their results are passed to runStep).
+ *
+ * @param id      — the workflow ID to resume
+ * @param runStep — callback that executes a single step's task
+ * @returns the final workflow state, or null if the workflow was not found
+ */
+export declare function resumeWorkflow(id: string, runStep: RunStepFn): Promise<WorkflowState | null>;
+/** Deletes a persisted workflow state file. Returns true if deleted. */
+export declare function deleteWorkflow(id: string): Promise<boolean>;

package/dist/workflows/engine.js

@@ -0,0 +1,320 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.workflowsDir = workflowsDir;
+exports.createWorkflow = createWorkflow;
+exports.saveWorkflowState = saveWorkflowState;
+exports.loadWorkflowState = loadWorkflowState;
+exports.listWorkflows = listWorkflows;
+exports.runWorkflow = runWorkflow;
+exports.resumeWorkflow = resumeWorkflow;
+exports.deleteWorkflow = deleteWorkflow;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const crypto = __importStar(require("crypto"));
+// ─────────────────────────────────────────────────────────────────────────────
+// Constants
+// ─────────────────────────────────────────────────────────────────────────────
+const WORKFLOW_VERSION = 1;
+// ─────────────────────────────────────────────────────────────────────────────
+// Helpers
+// ─────────────────────────────────────────────────────────────────────────────
+function generateId() {
+    return crypto.randomBytes(4).toString('hex') + '-' + Date.now().toString(36);
+}
+/** Returns ~/.aura/workflows (or $AURA_WORKFLOW_DIR if set). */
+function workflowsDir() {
+    return process.env.AURA_WORKFLOW_DIR
+        ?? path.join(process.env.HOME ?? '/tmp', '.aura', 'workflows');
+}
+function workflowPath(id) {
+    return path.join(workflowsDir(), `${id}.json`);
+}
+/** Atomically write JSON to a file using a .tmp rename. */
+async function writeJson(filePath, data) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    const tmp = filePath + '.tmp';
+    await fs.promises.writeFile(tmp, JSON.stringify(data, null, 2), 'utf8');
+    await fs.promises.rename(tmp, filePath);
+}
+/** Read and parse a JSON file; returns null on any error. */
+async function readJson(filePath) {
+    if (!fs.existsSync(filePath))
+        return null;
+    try {
+        const raw = await fs.promises.readFile(filePath, 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/** Build the initial StepState array from a definition's steps. */
+function buildInitialStepStates(steps) {
+    return steps.map(s => ({
+        stepName: s.name,
+        status: 'pending',
+    }));
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// createWorkflow
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Creates a new workflow definition and its initial state.
+ * Persists the state to ~/.aura/workflows/<id>.json.
+ * Returns the workflow state.
+ */
+async function createWorkflow(opts) {
+    const id = generateId();
+    const now = Date.now();
+    const definition = {
+        id,
+        name: opts.name,
+        description: opts.description,
+        steps: opts.steps,
+        createdAt: now,
+    };
+    const state = {
+        definition,
+        status: 'pending',
+        stepStates: buildInitialStepStates(opts.steps),
+        currentStep: -1,
+    };
+    await writeJson(workflowPath(id), { version: WORKFLOW_VERSION, state });
+    return state;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// saveWorkflowState — persistence hook called after each step
+// ─────────────────────────────────────────────────────────────────────────────
+/** Persists the current workflow state to disk. */
+async function saveWorkflowState(state) {
+    await writeJson(workflowPath(state.definition.id), { version: WORKFLOW_VERSION, state });
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// loadWorkflowState
+// ─────────────────────────────────────────────────────────────────────────────
+/** Loads a workflow state from disk by ID. Returns null if not found. */
+async function loadWorkflowState(id) {
+    const raw = await readJson(workflowPath(id));
+    if (!raw || !raw.state)
+        return null;
+    return raw.state;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// listWorkflows
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Lists all persisted workflows.
+ * Returns an array of workflow states sorted by creation time (newest first).
+ */
+async function listWorkflows() {
+    const dir = workflowsDir();
+    if (!fs.existsSync(dir))
+        return [];
+    const files = fs.readdirSync(dir).filter(f => f.endsWith('.json'));
+    const workflows = [];
+    for (const file of files) {
+        const raw = await readJson(path.join(dir, file));
+        if (raw && raw.state) {
+            workflows.push(raw.state);
+        }
+    }
+    return workflows.sort((a, b) => (b.definition.createdAt) - (a.definition.createdAt));
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// runWorkflow
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Executes a workflow from the beginning.
+ * Runs steps sequentially, persisting state after each step completes.
+ * Stops if a step fails.
+ *
+ * @param state   — the workflow state to execute (from createWorkflow)
+ * @param runStep — callback that executes a single step's task
+ * @returns the final workflow state
+ */
+async function runWorkflow(state, runStep) {
+    state.status = 'running';
+    state.startedAt = Date.now();
+    state.currentStep = 0;
+    await saveWorkflowState(state);
+    const previousResults = [];
+    for (let i = 0; i < state.definition.steps.length; i++) {
+        const step = state.definition.steps[i];
+        const stepState = state.stepStates[i];
+        // Mark step as running
+        stepState.status = 'running';
+        stepState.startedAt = Date.now();
+        state.currentStep = i;
+        await saveWorkflowState(state);
+        try {
+            const result = await runStep(step.task, i, previousResults);
+            // Mark step as done
+            stepState.status = 'done';
+            stepState.result = result.summary;
+            stepState.turns = result.turns;
+            stepState.toolCallCount = result.toolCallCount;
+            stepState.tokensUsed = result.tokensUsed;
+            stepState.completedAt = Date.now();
+            state.totalTokens = (state.totalTokens ?? 0) + result.tokensUsed;
+            previousResults.push(result);
+            await saveWorkflowState(state);
+        }
+        catch (err) {
+            // Mark step as failed, pause workflow
+            stepState.status = 'failed';
+            stepState.error = err instanceof Error ? err.message : String(err);
+            stepState.completedAt = Date.now();
+            state.status = 'failed';
+            state.completedAt = Date.now();
+            state.outcome = `Workflow failed at step "${step.name}": ${stepState.error}`;
+            await saveWorkflowState(state);
+            return state;
+        }
+    }
+    // All steps completed
+    state.status = 'done';
+    state.completedAt = Date.now();
+    state.currentStep = state.definition.steps.length;
+    state.outcome = `Workflow "${state.definition.name}" completed — ${state.definition.steps.length} steps`;
+    await saveWorkflowState(state);
+    return state;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// resumeWorkflow
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Resumes a workflow from disk.
+ * Finds the first non-done step and runs from there.
+ * Steps with status 'done' are skipped (their results are passed to runStep).
+ *
+ * @param id      — the workflow ID to resume
+ * @param runStep — callback that executes a single step's task
+ * @returns the final workflow state, or null if the workflow was not found
+ */
+async function resumeWorkflow(id, runStep) {
+    const state = await loadWorkflowState(id);
+    if (!state)
+        return null;
+    // Cannot resume a completed workflow
+    if (state.status === 'done') {
+        return state;
+    }
+    state.status = 'running';
+    await saveWorkflowState(state);
+    // Reconstruct previousResults from completed steps
+    const previousResults = state.stepStates
+        .filter(ss => ss.status === 'done')
+        .map(ss => ({
+        success: true,
+        summary: ss.result ?? '',
+        turns: ss.turns ?? 0,
+        toolCallCount: ss.toolCallCount ?? 0,
+        tokensUsed: ss.tokensUsed ?? 0,
+    }));
+    // Find the first step that needs to run
+    let startIndex = state.definition.steps.findIndex((_, i) => state.stepStates[i].status !== 'done');
+    // If all steps are done (shouldn't happen since status isn't 'done'), just finish
+    if (startIndex === -1) {
+        state.status = 'done';
+        state.completedAt = Date.now();
+        state.outcome = `Workflow "${state.definition.name}" already completed`;
+        await saveWorkflowState(state);
+        return state;
+    }
+    // Reset a previously-failed step to pending so it retries
+    if (state.stepStates[startIndex].status === 'failed') {
+        state.stepStates[startIndex].status = 'pending';
+        state.stepStates[startIndex].error = undefined;
+        state.stepStates[startIndex].startedAt = undefined;
+        state.stepStates[startIndex].completedAt = undefined;
+    }
+    state.startedAt = state.startedAt ?? Date.now();
+    await saveWorkflowState(state);
+    for (let i = startIndex; i < state.definition.steps.length; i++) {
+        const step = state.definition.steps[i];
+        const stepState = state.stepStates[i];
+        // Mark step as running
+        stepState.status = 'running';
+        stepState.startedAt = Date.now();
+        state.currentStep = i;
+        await saveWorkflowState(state);
+        try {
+            const result = await runStep(step.task, i, previousResults);
+            // Mark step as done
+            stepState.status = 'done';
+            stepState.result = result.summary;
+            stepState.turns = result.turns;
+            stepState.toolCallCount = result.toolCallCount;
+            stepState.tokensUsed = result.tokensUsed;
+            stepState.completedAt = Date.now();
+            state.totalTokens = (state.totalTokens ?? 0) + result.tokensUsed;
+            previousResults.push(result);
+            await saveWorkflowState(state);
+        }
+        catch (err) {
+            // Mark step as failed, pause workflow
+            stepState.status = 'failed';
+            stepState.error = err instanceof Error ? err.message : String(err);
+            stepState.completedAt = Date.now();
+            state.status = 'failed';
+            state.completedAt = Date.now();
+            state.outcome = `Workflow failed at step "${step.name}": ${stepState.error}`;
+            await saveWorkflowState(state);
+            return state;
+        }
+    }
+    // All steps completed
+    state.status = 'done';
+    state.completedAt = Date.now();
+    state.currentStep = state.definition.steps.length;
+    state.outcome = `Workflow "${state.definition.name}" completed — ${state.definition.steps.length} steps`;
+    await saveWorkflowState(state);
+    return state;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// deleteWorkflow
+// ─────────────────────────────────────────────────────────────────────────────
+/** Deletes a persisted workflow state file. Returns true if deleted. */
+async function deleteWorkflow(id) {
+    const filePath = workflowPath(id);
+    if (!fs.existsSync(filePath))
+        return false;
+    await fs.promises.unlink(filePath);
+    return true;
+}
+//# sourceMappingURL=engine.js.map

package/dist/workflows/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/workflows/engine.ts"],"names":[],"mappings":"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"}

package/dist/workflows/types.d.ts

@@ -0,0 +1,92 @@
+/**
+ * A single named task within a workflow.
+ * Steps are executed sequentially in the order they appear in the definition.
+ */
+export interface WorkflowStep {
+    /** Human-readable name for this step (unique within the workflow). */
+    name: string;
+    /** The task prompt sent to the agent loop for this step. */
+    task: string;
+}
+/**
+ * Static definition of a workflow — the blueprint before execution.
+ */
+export interface WorkflowDefinition {
+    /** Unique identifier for this workflow (generated on creation). */
+    id: string;
+    /** Human-readable workflow name. */
+    name: string;
+    /** Optional description of what this workflow accomplishes. */
+    description?: string;
+    /** Ordered list of steps to execute sequentially. */
+    steps: WorkflowStep[];
+    /** Unix timestamp (ms) when this workflow was created. */
+    createdAt: number;
+}
+/**
+ * Lifecycle state of a single step within a running workflow.
+ */
+export type StepStatus = 'pending' | 'running' | 'done' | 'failed' | 'skipped';
+/**
+ * Runtime state of a workflow — persisted to disk after each step completes.
+ * Used for resume: the engine reads this to know which step to pick up from.
+ */
+export interface WorkflowState {
+    /** The full workflow definition (copied into state for self-contained files). */
+    definition: WorkflowDefinition;
+    /**
+     * Lifecycle state of the overall workflow.
+     * - `pending`  — created but not yet started
+     * - `running`  — at least one step is executing
+     * - `paused`   — user or system paused; can be resumed
+     * - `done`     — all steps completed successfully
+     * - `failed`   — a step failed and execution halted
+     */
+    status: 'pending' | 'running' | 'paused' | 'done' | 'failed';
+    /**
+     * Per-step status tracking, indexed in the same order as definition.steps.
+     * Each entry includes the step result (summary) and timing metadata.
+     */
+    stepStates: StepState[];
+    /** Index of the step currently running or next to run (0-based). -1 if not started. */
+    currentStep: number;
+    /** Unix timestamp (ms) when workflow execution began. */
+    startedAt?: number;
+    /** Unix timestamp (ms) when workflow reached a terminal state. */
+    completedAt?: number;
+    /** Total number of tokens consumed across all completed steps. */
+    totalTokens?: number;
+    /** Overall result summary (set when status is 'done' or 'failed'). */
+    outcome?: string;
+}
+/** Result of a single step execution (returned by the runStep callback). */
+export interface StepResult {
+    success: boolean;
+    summary: string;
+    turns: number;
+    toolCallCount: number;
+    tokensUsed: number;
+}
+/**
+ * Runtime state of a single step within a workflow.
+ */
+export interface StepState {
+    /** Name of the step (matches WorkflowStep.name). */
+    stepName: string;
+    /** Current lifecycle status of this step. */
+    status: StepStatus;
+    /** Result summary produced by the agent loop, if completed. */
+    result?: string;
+    /** Number of turns the agent loop took for this step. */
+    turns?: number;
+    /** Number of tool calls the agent loop made for this step. */
+    toolCallCount?: number;
+    /** Tokens consumed by this step. */
+    tokensUsed?: number;
+    /** Error message if status is 'failed'. */
+    error?: string;
+    /** Unix timestamp (ms) when this step started executing. */
+    startedAt?: number;
+    /** Unix timestamp (ms) when this step finished (done/failed). */
+    completedAt?: number;
+}

package/dist/workflows/types.js

@@ -0,0 +1,6 @@
+"use strict";
+// ─────────────────────────────────────────────────────────────────────────────
+// Workflow types — persistent sequential workflow engine
+// ─────────────────────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/workflows/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/workflows/types.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yDAAyD;AACzD,gFAAgF"}

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "aura-code",
+  "version": "0.3.0",
+  "description": "Aura Code — model-agnostic AI coding agent. Works with Claude, GPT, Gemini, MiMo, Ollama, and any OpenAI-compatible endpoint. MIT licensed.",
+  "bin": {
+    "aura": "dist/cli/index.js"
+  },
+  "main": "./dist/cli/index.js",
+  "homepage": "https://lean-progress-iq-site.vercel.app",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/milodule3-debug/aura-code.git"
+  },
+  "bugs": {
+    "url": "https://github.com/milodule3-debug/aura-code/issues"
+  },
+  "author": {
+    "name": "Dušan Milosavljević",
+    "email": "leanproiq@gmail.com",
+    "url": "https://lean-progress-iq-site.vercel.app"
+  },
+  "files": [
+    "dist/",
+    "LICENSE",
+    "README.md",
+    "package.json"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/cli/index.ts",
+    "start": "node dist/cli/index.js",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.32.1",
+    "@google/generative-ai": "^0.21.0",
+    "chalk": "^4.1.2",
+    "express": "^5.2.1",
+    "glob": "^10.4.5",
+    "minimist": "^1.2.8",
+    "openai": "^4.68.4",
+    "pptxgenjs": "^4.0.1",
+    "puppeteer-core": "^25.1.0",
+    "ws": "^8.21.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/minimist": "^1.2.5",
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.18.1",
+    "@vitest/coverage-v8": "^2.1.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.5.4",
+    "vitest": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "coding",
+    "cli",
+    "model-agnostic",
+    "aura",
+    "praktess",
+    "claude",
+    "gpt",
+    "gemini",
+    "ollama",
+    "developer-tools",
+    "code-generation",
+    "autonomous-agent",
+    "llm",
+    "typescript"
+  ],
+  "license": "MIT",
+  "directories": {
+    "test": "tests"
+  },
+  "type": "commonjs",
+  "types": "./dist/cli/index.d.ts"
+}