cloving 0.3.20 → 1.1.0

package/package.json

@@ -1,86 +1,95 @@
 {
   "name": "cloving",
-  "version": "0.3.20",
-  "packageManager": "yarn@1.22.22",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "scripts": {
-    "build": "tsc && cp package.json dist/package.json && cp src/utils/prompts/*.md dist/utils/prompts/",
-    "start": "node dist/index.js",
-    "watch": "tsc -w",
-    "check": "bash -c 'npx tsc --noEmit --skipLibCheck'",
-    "test": "bash -c jest",
-    "prepare": "husky",
-    "format": "prettier --write \"src/**/*.ts\""
-  },
-  "bin": "./dist/index.js",
-  "files": [
-    "dist",
-    "!**/test/**"
-  ],
-  "keywords": [],
-  "author": "Lucas Carlson",
+  "version": "1.1.0",
+  "description": "Local durable development workflow service",
   "license": "MIT",
-  "description": "",
-  "lint-staged": {
-    "*.ts": [
-      "yarn run check",
-      "prettier --write"
-    ]
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cloving-ai/cloving-ai.git"
+  },
+  "homepage": "https://github.com/cloving-ai/cloving-ai#readme",
+  "bugs": {
+    "url": "https://github.com/cloving-ai/cloving-ai/issues"
   },
-  "lint-prepush": {
-    "base": "main",
-    "tasks": {
-      "*.ts": [
-        "yarn run check",
-        "yarn run test",
-        "yarn run format"
-      ]
+  "type": "module",
+  "imports": {
+    "#package": "./package.json"
+  },
+  "bin": {
+    "cloving": "dist/src/cli.js"
+  },
+  "exports": {
+    "./workflows": {
+      "types": "./dist/src/workflows.d.ts",
+      "import": "./dist/src/workflows.js"
+    },
+    "./workflows/steps/load-cycle": {
+      "types": "./dist/src/steps/load-cycle.d.ts",
+      "import": "./dist/src/steps/load-cycle.js"
+    },
+    "./workflows/steps/protected-effect": {
+      "types": "./dist/src/steps/protected-effect.d.ts",
+      "import": "./dist/src/steps/protected-effect.js"
+    },
+    "./workflows/steps/decision-gate": {
+      "types": "./dist/src/steps/decision-gate.d.ts",
+      "import": "./dist/src/steps/decision-gate.js"
     }
   },
-  "dependencies": {
-    "@inquirer/prompts": "^7.3.2",
-    "axios": "^1.7.9",
-    "cli-highlight": "^2.1.11",
-    "colors": "^1.4.0",
-    "commander": "^13.1.0",
-    "copy-paste": "^1.5.3",
-    "eslint": "^9.20.1",
-    "eslint-config-prettier": "^10.0.1",
-    "eslint-config-raine": "^0.5.0",
-    "eslint-config-standard": "^17.1.0",
-    "eslint-plugin-import": "^2.31.0",
-    "eslint-plugin-jsdoc": "^50.6.3",
-    "eslint-plugin-n": "^17.15.1",
-    "eslint-plugin-promise": "^7.2.1",
-    "express": "^4.21.2",
-    "ignore": "^7.0.3",
-    "ini": "^5.0.0",
-    "isbinaryfile": "^5.0.4",
-    "nock": "^14.0.1",
-    "vite": "^6.1.1",
-    "vite-node": "^3.0.6"
+  "files": [
+    "dist/src",
+    "dist/tools",
+    "dist/workflows"
+  ],
+  "engines": {
+    "node": ">=26.9.0 <27",
+    "npm": ">=11.19.1 <12"
+  },
+  "os": [
+    "darwin",
+    "linux"
+  ],
+  "cpu": [
+    "arm64",
+    "x64"
+  ],
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json && node tools/copy-workflow-declarations.ts workflows dist/workflows",
+    "build:workflows": "node tools/compile-workflows.ts",
+    "check:setup": "tsc --project tsconfig.json --noEmit",
+    "check:quality": "node tools/check-quality.ts",
+    "check:lint": "eslint src tools quality test eslint.config.mjs --max-warnings 0",
+    "check:format": "prettier --check src tools quality test eslint.config.mjs package.json tsconfig.json tsconfig.build.json",
+    "test:quality": "node --test test/quality/*.test.ts",
+    "test:scale": "node --test --test-concurrency=1 test/authority-opening-scale.benchmark.ts",
+    "check": "node tools/quality-pending.ts",
+    "test:concurrency": "node tools/quality-pending.ts"
   },
   "devDependencies": {
-    "@types/body-parser": "^1.19.5",
-    "@types/copy-paste": "^1.1.33",
-    "@types/express": "^5.0.0",
-    "@types/ini": "^4.1.1",
-    "@types/inquirer": "^9.0.7",
-    "@types/jest": "^29.5.14",
-    "@types/node": "^22.13.4",
-    "husky": "^9.1.7",
-    "jest": "^29.7.0",
-    "lint-prepush": "^3.0.2",
-    "lint-staged": "^15.4.3",
-    "prettier": "^3.5.1",
-    "ts-jest": "^29.2.5",
-    "typescript": "^5.7.3"
+    "@eslint/js": "10.0.1",
+    "@types/istanbul-lib-coverage": "2.0.6",
+    "@types/node": "26.6.4",
+    "acorn": "8.16.0",
+    "ast-v8-to-istanbul": "1.0.5",
+    "eslint": "10.12.0",
+    "eslint-plugin-sonarjs": "4.2.2",
+    "istanbul-lib-coverage": "3.2.2",
+    "jscpd": "5.4.0",
+    "prettier": "3.9.9",
+    "typescript": "6.0.3",
+    "typescript-eslint": "8.71.1"
+  },
+  "overrides": {
+    "@workflow/core": {
+      "devalue": "5.9.4",
+      "nanoid": "5.1.16"
+    }
   },
-  "resolutions": {
-    "eslint": "8.57.0",
-    "eslint-plugin-n": "16.6.2",
-    "eslint-plugin-import": "2.29.1",
-    "eslint-plugin-promise": "6.6.0"
+  "dependencies": {
+    "@workflow/builders": "5.0.2",
+    "entities": "8.1.0",
+    "preact": "11.0.0",
+    "solid-objects": "0.17.8",
+    "workflow": "5.1.0"
   }
 }

package/dist/abstract_gpt/index.js

@@ -1,55 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const axios_1 = __importDefault(require("axios"));
-class AbstractGPT {
-    constructor() {
-        const clovingModel = process.env.CLOVING_MODEL;
-        this.apiKey = process.env.CLOVING_API_KEY || '';
-        if (!clovingModel || !this.apiKey) {
-            throw new Error("CLOVING_MODEL and CLOVING_API_KEY environment variables must be set");
-        }
-        const [provider, model] = clovingModel.split(':');
-        this.provider = provider;
-        this.model = model;
-    }
-    getEndpoint() {
-        switch (this.provider) {
-            case 'openai':
-                return `https://api.openai.com/v1/engines/${this.model}/completions`;
-            case 'claude':
-                return `https://api.anthropic.com/v1/claude/${this.model}`;
-            case 'gpt4all':
-                return `https://api.gpt4all.io/v1/models/${this.model}/completions`;
-            default:
-                throw new Error(`Unsupported provider: ${this.provider}`);
-        }
-    }
-    async generateText(request) {
-        const endpoint = this.getEndpoint();
-        const response = await axios_1.default.post(endpoint, {
-            model: this.model,
-            prompt: request.prompt,
-            max_tokens: request.maxTokens || 100,
-            temperature: request.temperature || 0.7
-        }, {
-            headers: {
-                'Authorization': `Bearer ${this.apiKey}`,
-                'Content-Type': 'application/json'
-            }
-        });
-        switch (this.provider) {
-            case 'openai':
-                return response.data.choices[0].text;
-            case 'claude':
-                return response.data.completion;
-            case 'gpt4all':
-                return response.data.text;
-            default:
-                throw new Error(`Unsupported provider: ${this.provider}`);
-        }
-    }
-}
-exports.default = AbstractGPT;

package/dist/cloving_gpt/adapters/Adapter.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cloving_gpt/adapters/azureopenai.js

@@ -1,69 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AzureOpenAIAdapter = void 0;
-class AzureOpenAIAdapter {
-    static listSupportedModels() {
-        AzureOpenAIAdapter.supportedModels.forEach((model) => {
-            console.log(model);
-        });
-    }
-    constructor(model, endpoint) {
-        this.model = model;
-        this.endpoint = endpoint;
-    }
-    getEndpoint() {
-        return this.endpoint;
-    }
-    getHeaders(apiKey) {
-        return {
-            Authorization: `Bearer ${apiKey}`,
-            'Content-Type': 'application/json',
-        };
-    }
-    getPayload(request, stream = false) {
-        return {
-            model: this.model.replace('azureopenai:', '').replace(':', '-'),
-            messages: request.messages && request.messages.length > 0
-                ? request.messages
-                : [{ role: 'user', content: request.prompt }],
-            max_tokens: request.maxTokens,
-            temperature: request.temperature || 0.2,
-            stream,
-        };
-    }
-    extractResponse(data) {
-        return data.choices[0].message.content;
-    }
-    convertStream(data) {
-        let beginningChar = 0;
-        let lastChar = 0;
-        while (lastChar < data.length) {
-            try {
-                let remainingString = data.slice(beginningChar, lastChar);
-                const firstBraceIndex = remainingString.indexOf('{');
-                if (firstBraceIndex > -1) {
-                    remainingString = remainingString.slice(firstBraceIndex);
-                }
-                const parsedObject = JSON.parse(remainingString);
-                const output = parsedObject?.choices[0]?.delta?.content || '';
-                return {
-                    output,
-                    lastChar,
-                };
-            }
-            catch (error) {
-                lastChar += 1;
-            }
-        }
-        return null;
-    }
-}
-exports.AzureOpenAIAdapter = AzureOpenAIAdapter;
-AzureOpenAIAdapter.supportedModels = [
-    'azureopenai:gpt:4o-2024-08-06',
-    'azureopenai:gpt:4o',
-    'azureopenai:gpt:4o-mini',
-    'azureopenai:gpt:4-turbo',
-    'azureopenai:gpt:3.5-turbo',
-    // Add more supported models as needed
-];

package/dist/cloving_gpt/adapters/claude.js

@@ -1,128 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ClaudeAdapter = void 0;
-/**
- * ClaudeAdapter class implements the Adapter interface for Claude AI models.
- */
-class ClaudeAdapter {
-    /**
-     * Initializes a new ClaudeAdapter instance.
-     * @param model - The Claude model identifier.
-     */
-    constructor(model) {
-        this.model = model;
-        this.anthropicVersion = '2023-06-01';
-    }
-    /**
-     * Logs all supported Claude models to the console.
-     */
-    static listSupportedModels() {
-        ClaudeAdapter.supportedModels.forEach((model) => {
-            console.log(model);
-        });
-    }
-    /**
-     * Returns the API endpoint for Claude.
-     * @returns The API endpoint URL.
-     */
-    getEndpoint() {
-        return `https://api.anthropic.com/v1/messages`;
-    }
-    /**
-     * Generates headers for API requests.
-     * @param apiKey - The API key for authentication.
-     * @returns An object containing the required headers.
-     */
-    getHeaders(apiKey) {
-        return {
-            'x-api-key': apiKey,
-            'Content-Type': 'application/json',
-            'anthropic-version': this.anthropicVersion,
-        };
-    }
-    /**
-     * Prepares the payload for API requests.
-     * @param request - The GPTRequest object containing request details.
-     * @param stream - Whether to enable streaming (default: false).
-     * @returns An object containing the prepared payload.
-     */
-    getPayload(request, stream = false) {
-        let system = 'You are a computer programmer giving advice on how to write better code.';
-        if (request.messages && request.messages.length > 0 && request.messages[0].role === 'system') {
-            system = request.messages[0].content;
-            request = { ...request, messages: request.messages.slice(1) };
-        }
-        return {
-            model: this.model.replace(':', '-'),
-            system,
-            messages: request.messages && request.messages.length > 0
-                ? request.messages
-                : [{ role: 'user', content: request.prompt }],
-            max_tokens: request.maxTokens || 4096,
-            temperature: request.temperature || 0.2,
-            stream,
-        };
-    }
-    /**
-     * Extracts the response text from the API response data.
-     * @param data - The API response data.
-     * @returns The extracted response text.
-     * @throws Error if the response structure is invalid.
-     */
-    extractResponse(data) {
-        try {
-            if (data && data.content && Array.isArray(data.content) && data.content.length > 0) {
-                return data.content.map((item) => item.text).join('\n');
-            }
-            else {
-                console.error('Unexpected response structure:', data);
-                throw new Error('Invalid response structure');
-            }
-        }
-        catch (error) {
-            console.error('Error extracting response:', error);
-            throw error;
-        }
-    }
-    /**
-     * Converts streaming data to OpenAIStreamChunk format.
-     * @param data - The streaming data string.
-     * @returns An OpenAIStreamChunk object or null if parsing fails.
-     */
-    convertStream(data) {
-        let beginningChar = 0;
-        let lastChar = 0;
-        while (lastChar < data.length) {
-            try {
-                let remainingString = data.slice(beginningChar, lastChar);
-                // Strip any leading characters until we encounter the first '{' in this block
-                const firstBraceIndex = remainingString.indexOf('{');
-                if (firstBraceIndex > -1) {
-                    remainingString = remainingString.slice(firstBraceIndex);
-                }
-                const parsedObject = JSON.parse(remainingString);
-                const output = parsedObject?.delta?.text || '';
-                return {
-                    output,
-                    lastChar,
-                };
-            }
-            catch (error) {
-                // Incrementally increase the size of the JSON string to parse
-                lastChar += 1;
-            }
-        }
-        return null;
-    }
-}
-exports.ClaudeAdapter = ClaudeAdapter;
-/**
- * Array of supported Claude model identifiers.
- */
-ClaudeAdapter.supportedModels = [
-    'claude:claude-3-5:sonnet-20240620',
-    'claude:claude-3:opus-20240229',
-    'claude:claude-3:sonnet-20240229',
-    'claude:claude-3:haiku-20240307',
-    // Add more supported models here as needed
-];

package/dist/cloving_gpt/adapters/gemini.js

@@ -1,135 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GeminiAdapter = void 0;
-/**
- * GeminiAdapter class implements the Adapter interface for Google's Gemini AI model.
- */
-class GeminiAdapter {
-    /**
-     * Creates a new GeminiAdapter instance.
-     * @param model - The Gemini model to use.
-     */
-    constructor(model) {
-        this.model = model;
-    }
-    /**
-     * Lists all supported Gemini models to the console.
-     */
-    static async listSupportedModels() {
-        GeminiAdapter.supportedModels.forEach((model) => {
-            console.log(model);
-        });
-    }
-    /**
-     * Gets the appropriate API endpoint URL based on whether streaming is required.
-     * @param stream - Whether to use streaming endpoint.
-     * @returns The API endpoint URL.
-     */
-    getEndpoint(stream = false) {
-        if (stream) {
-            return `https://generativelanguage.googleapis.com/v1beta/models/${this.model.replace(':', '-')}:streamGenerateContent`;
-        }
-        else {
-            return `https://generativelanguage.googleapis.com/v1beta/models/${this.model.replace(':', '-')}:generateContent`;
-        }
-    }
-    /**
-     * Generates headers for the API request.
-     * @param apiKey - The API key for authentication.
-     * @returns An object containing the necessary headers.
-     */
-    getHeaders(apiKey) {
-        return {
-            'Content-Type': 'application/json',
-            'x-goog-api-key': apiKey,
-        };
-    }
-    /**
-     * Prepares the payload for the API request.
-     * @param request - The GPTRequest object containing prompt and other parameters.
-     * @param stream - Whether the request is for streaming.
-     * @returns The formatted payload object.
-     */
-    getPayload(request, stream = false) {
-        return {
-            contents: [
-                {
-                    role: 'user', // or 'model' if generated from the model
-                    parts: [
-                        {
-                            text: request.prompt,
-                        },
-                    ],
-                },
-            ],
-            generationConfig: {
-                temperature: request.temperature || 0.2,
-                topK: 40,
-                topP: 0.95,
-                maxOutputTokens: 1024,
-            },
-        };
-    }
-    /**
-     * Extracts the response text from the API response data.
-     * @param data - The raw API response data.
-     * @returns The extracted response text.
-     * @throws Error if the response structure is invalid.
-     */
-    extractResponse(data) {
-        try {
-            if (data &&
-                data.candidates &&
-                data.candidates[0] &&
-                data.candidates[0].content &&
-                data.candidates[0].content.parts &&
-                data.candidates[0].content.parts[0]) {
-                return data.candidates[0].content.parts[0].text;
-            }
-            else {
-                console.error('Unexpected response structure:', data);
-                throw new Error('Invalid response structure');
-            }
-        }
-        catch (error) {
-            console.error('Error extracting response:', error);
-            throw error;
-        }
-    }
-    /**
-     * Converts a stream chunk to an OpenAIStreamChunk format.
-     * @param data - The raw stream chunk data.
-     * @returns An OpenAIStreamChunk object or null if parsing fails.
-     */
-    convertStream(data) {
-        let beginningChar = 0;
-        let lastChar = 0;
-        while (lastChar < data.length) {
-            try {
-                let remainingString = data.slice(beginningChar, lastChar);
-                // Strip any leading characters until we encounter the first '{' in this block
-                const firstBraceIndex = remainingString.indexOf('{');
-                if (firstBraceIndex > -1) {
-                    remainingString = remainingString.slice(firstBraceIndex);
-                }
-                const parsedObject = JSON.parse(remainingString);
-                const output = parsedObject?.candidates[0]?.content?.parts[0]?.text || '';
-                return {
-                    output,
-                    lastChar,
-                };
-            }
-            catch (error) {
-                // Incrementally increase the size of the JSON string to parse
-                lastChar += 1;
-            }
-        }
-        return null;
-    }
-}
-exports.GeminiAdapter = GeminiAdapter;
-GeminiAdapter.supportedModels = [
-    'gemini:gemini-1.5:pro-latest',
-    'gemini:gemini-1.5:flash-latest',
-    'gemini:gemini-1.0:pro-latest',
-];

package/dist/cloving_gpt/adapters/gpt4all.js

@@ -1,29 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GPT4AllAdapter = void 0;
-class GPT4AllAdapter {
-    constructor(model) {
-        this.model = model;
-    }
-    getEndpoint() {
-        return `https://api.gpt4all.io/v1/models/${this.model}/completions`;
-    }
-    getHeaders(apiKey) {
-        return {
-            'Authorization': `Bearer ${apiKey}`,
-            'Content-Type': 'application/json'
-        };
-    }
-    getPayload(request) {
-        return {
-            model: this.model,
-            prompt: request.prompt,
-            max_tokens: request.maxTokens,
-            temperature: request.temperature || 0.7
-        };
-    }
-    extractResponse(data) {
-        return data.text;
-    }
-}
-exports.GPT4AllAdapter = GPT4AllAdapter;

package/dist/cloving_gpt/adapters/index.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });