@crewx/sdk 0.8.0-rc.58

package/dist/utils.js

@@ -0,0 +1,20 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./utils/error-utils"), exports);
+__exportStar(require("./utils/string-utils"), exports);
+__exportStar(require("./utils/math-utils"), exports);
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,uDAAqC;AACrC,qDAAmC"}

package/package.json

@@ -0,0 +1,134 @@
+{
+  "name": "@crewx/sdk",
+  "version": "0.8.0-rc.58",
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "description": "SowonAI CrewX SDK",
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "schema",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run --config ./vitest.config.ts",
+    "test:watch": "vitest --config ./vitest.config.ts",
+    "test:ui": "vitest --ui --config ./vitest.config.ts",
+    "test:unit": "vitest run --config ./vitest.config.ts tests/unit/**/*.test.ts",
+    "test:integration": "vitest run --config ./vitest.config.ts tests/integration/**/*.test.ts --passWithNoTests",
+    "test:coverage": "vitest run --config ./vitest.config.ts --coverage",
+    "lint": "echo \"SDK lint pending\" && exit 0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    },
+    "./internal": {
+      "types": "./dist/internal/index.d.ts",
+      "import": "./dist/internal/index.js",
+      "require": "./dist/internal/index.js"
+    },
+    "./tools": {
+      "types": "./dist/tools/index.d.ts",
+      "import": "./dist/tools/index.js",
+      "require": "./dist/tools/index.js"
+    },
+    "./api": {
+      "types": "./dist/api/index.d.ts",
+      "import": "./dist/api/index.js",
+      "require": "./dist/api/index.js"
+    },
+    "./core/env-defaults": {
+      "types": "./dist/core/env-defaults.d.ts",
+      "import": "./dist/core/env-defaults.js",
+      "require": "./dist/core/env-defaults.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "tools": [
+        "./dist/tools/index.d.ts"
+      ],
+      "internal": [
+        "./dist/internal/index.d.ts"
+      ],
+      "api": [
+        "./dist/api/index.d.ts"
+      ],
+      "core/env-defaults": [
+        "./dist/core/env-defaults.d.ts"
+      ]
+    }
+  },
+  "dependencies": {
+    "glob": "^11.0.0",
+    "handlebars": "^4.7.8",
+    "js-yaml": "^4.1.0",
+    "remark-parse": "^11.0.0",
+    "remark-stringify": "^11.0.0",
+    "unified": "^11.0.5",
+    "unist-util-visit": "^5.0.0",
+    "zod": "^3.24.1"
+  },
+  "peerDependencies": {
+    "@ai-sdk/anthropic": "^1.0.8",
+    "@ai-sdk/google": "^1.0.10",
+    "@ai-sdk/openai": "^1.0.11",
+    "@ai-sdk/openai-compatible": "^1.0.0",
+    "@mastra/core": "^0.24.0",
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/core": "^11.0.0",
+    "@openrouter/ai-sdk-provider": "^1.2.2",
+    "ai": "^5.0.92",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.0"
+  },
+  "peerDependenciesMeta": {
+    "@ai-sdk/anthropic": {
+      "optional": true
+    },
+    "@ai-sdk/google": {
+      "optional": true
+    },
+    "@ai-sdk/openai": {
+      "optional": true
+    },
+    "@ai-sdk/openai-compatible": {
+      "optional": true
+    },
+    "@mastra/core": {
+      "optional": true
+    },
+    "@openrouter/ai-sdk-provider": {
+      "optional": true
+    },
+    "ai": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@ai-sdk/anthropic": "^1.0.8",
+    "@ai-sdk/google": "^1.0.10",
+    "@ai-sdk/openai": "^1.0.11",
+    "@ai-sdk/openai-compatible": "^1.0.0",
+    "@mastra/core": "^0.24.0",
+    "@openrouter/ai-sdk-provider": "^1.2.2",
+    "@types/js-yaml": "^4.0.9",
+    "ai": "^5.0.92",
+    "dotenv": "^17.2.3",
+    "typescript": "^5.0.0"
+  }
+}

package/schema/api-provider-config.json

@@ -0,0 +1,138 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://crewx.ai/schemas/api-provider-config.json",
+  "title": "CrewX API Provider Configuration",
+  "description": "API provider configuration for CrewX agents (OpenAI, Anthropic, Google, Bedrock, LiteLLM, Ollama, SowonAI)",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["provider", "model"],
+  "properties": {
+    "provider": {
+      "type": "string",
+      "enum": [
+        "api/openai",
+        "api/anthropic",
+        "api/google",
+        "api/bedrock",
+        "api/litellm",
+        "api/ollama",
+        "api/sowonai"
+      ],
+      "description": "API provider identifier"
+    },
+    "url": {
+      "type": "string",
+      "format": "uri",
+      "description": "API base URL (e.g., https://api.openai.com/v1, http://localhost:4000)"
+    },
+    "apiKey": {
+      "type": "string",
+      "description": "API key (optional, can use environment variables via {{env.VAR}} template)"
+    },
+    "model": {
+      "type": "string",
+      "description": "Model identifier understood by the provider (e.g., gpt-4o, claude-3-5-sonnet-20241022)"
+    },
+    "temperature": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 2,
+      "default": 0.7,
+      "description": "Sampling temperature applied to API calls"
+    },
+    "maxTokens": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Maximum completion tokens"
+    },
+    "options": {
+      "type": "object",
+      "description": "Mode-specific permissions. Define tools/MCP servers per execution mode (query/execute).",
+      "properties": {
+        "query": {
+          "$ref": "#/$defs/providerModeOptions"
+        },
+        "execute": {
+          "$ref": "#/$defs/providerModeOptions"
+        }
+      },
+      "additionalProperties": {
+        "$ref": "#/$defs/providerModeOptions"
+      }
+    },
+    "tools": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "uniqueItems": true,
+      "description": "Legacy root-level tool list (SowonFlow style). Prefer options.<mode>.tools instead."
+    },
+    "mcp": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "uniqueItems": true,
+      "description": "Legacy root-level MCP reference list. Prefer options.<mode>.mcp instead."
+    },
+    "mcp_servers": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "uniqueItems": true,
+      "description": "Legacy alias for MCP references (mirrors SowonFlow snake_case). Prefer options.<mode>.mcp instead."
+    }
+  },
+  "$defs": {
+    "providerModeOptions": {
+      "type": "object",
+      "description": "Mode-specific permissions for tools and MCP servers",
+      "additionalProperties": false,
+      "properties": {
+        "tools": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "uniqueItems": true,
+          "description": "Tool names enabled in this mode"
+        },
+        "mcp": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "uniqueItems": true,
+          "description": "MCP server references enabled in this mode"
+        }
+      }
+    },
+    "mcpServerConfig": {
+      "type": "object",
+      "description": "Model Context Protocol server process definition",
+      "required": ["command", "args"],
+      "properties": {
+        "command": {
+          "type": "string",
+          "description": "Executable to launch the MCP server (e.g., npx, node)"
+        },
+        "args": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Arguments passed to the command"
+        },
+        "env": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Environment variables injected when spawning the server (supports {{env.VAR}} template)"
+        }
+      }
+    }
+  }
+}

package/schema/crewx-config.json

@@ -0,0 +1,224 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://crewx.ai/schemas/crewx-config.json",
+  "title": "CrewX Configuration",
+  "description": "Complete CrewX configuration including agents, MCP servers, tools, and global variables.",
+  "type": "object",
+  "properties": {
+    "vars": {
+      "type": "object",
+      "description": "Global variables accessible in templates as {{vars.key}} and in tool execution context",
+      "additionalProperties": true
+    },
+    "mcp_servers": {
+      "type": "object",
+      "description": "Model Context Protocol server definitions",
+      "additionalProperties": {
+        "$ref": "#/$defs/mcpServerConfig"
+      }
+    },
+    "agents": {
+      "type": "array",
+      "description": "Agent definitions",
+      "items": {
+        "$ref": "#/$defs/agentConfig"
+      }
+    }
+  },
+  "$defs": {
+    "agentConfig": {
+      "type": "object",
+      "required": ["id"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique agent identifier"
+        },
+        "name": {
+          "type": "string",
+          "description": "Human-readable agent name"
+        },
+        "provider": {
+          "type": "string",
+          "description": "Provider identifier (cli/claude, api/openai, etc.)",
+          "pattern": "^(cli|api)/[a-z0-9-]+$"
+        },
+        "inline": {
+          "type": "object",
+          "description": "Inline provider configuration",
+          "properties": {
+            "model": {
+              "type": "string",
+              "description": "Model identifier"
+            },
+            "provider": {
+              "type": "string",
+              "enum": [
+                "api/openai",
+                "api/anthropic",
+                "api/google",
+                "api/bedrock",
+                "api/litellm",
+                "api/ollama",
+                "api/sowonai",
+                "cli/claude",
+                "cli/gemini",
+                "cli/copilot",
+                "cli/codex"
+              ],
+              "description": "Provider type for inline configuration"
+            },
+            "url": {
+              "type": "string",
+              "format": "uri",
+              "description": "API base URL (for API providers)"
+            },
+            "apiKey": {
+              "type": "string",
+              "description": "API key (supports {{env.VAR}} template)"
+            },
+            "temperature": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 2,
+              "default": 0.7,
+              "description": "Sampling temperature"
+            },
+            "maxTokens": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "Maximum completion tokens"
+            },
+            "prompt": {
+              "type": "string",
+              "description": "Agent system prompt (supports templates)"
+            }
+          }
+        },
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "description": "API base URL (shorthand for inline.url)"
+        },
+        "apiKey": {
+          "type": "string",
+          "description": "API key (shorthand for inline.apiKey, supports {{env.VAR}} template)"
+        },
+        "model": {
+          "type": "string",
+          "description": "Model identifier (shorthand for inline.model)"
+        },
+        "temperature": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 2,
+          "description": "Sampling temperature (shorthand for inline.temperature)"
+        },
+        "maxTokens": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Maximum completion tokens (shorthand for inline.maxTokens)"
+        },
+        "prompt": {
+          "type": "string",
+          "description": "Agent system prompt (shorthand for inline.prompt, supports templates)"
+        },
+        "tools": {
+          "oneOf": [
+            {
+              "type": "array",
+              "description": "Simple array of tool names (SowonFlow style)",
+              "items": {
+                "type": "string"
+              },
+              "uniqueItems": true
+            },
+            {
+              "type": "object",
+              "description": "Include/exclude pattern for tool activation",
+              "properties": {
+                "include": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "uniqueItems": true,
+                  "description": "Tool names to include"
+                },
+                "exclude": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "uniqueItems": true,
+                  "description": "Tool names to exclude"
+                }
+              }
+            }
+          ],
+          "description": "Tool activation configuration"
+        },
+        "mcp": {
+          "oneOf": [
+            {
+              "type": "array",
+              "description": "Simple array of MCP server names (SowonFlow style)",
+              "items": {
+                "type": "string"
+              },
+              "uniqueItems": true
+            },
+            {
+              "type": "object",
+              "description": "Include/exclude pattern for MCP server activation",
+              "properties": {
+                "include": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "uniqueItems": true,
+                  "description": "MCP server names to include"
+                },
+                "exclude": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "uniqueItems": true,
+                  "description": "MCP server names to exclude"
+                }
+              }
+            }
+          ],
+          "description": "MCP server activation configuration"
+        }
+      }
+    },
+    "mcpServerConfig": {
+      "type": "object",
+      "description": "Model Context Protocol server process definition",
+      "required": ["command", "args"],
+      "properties": {
+        "command": {
+          "type": "string",
+          "description": "Executable to launch the MCP server (e.g., npx, node)"
+        },
+        "args": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Arguments passed to the command"
+        },
+        "env": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Environment variables (supports {{env.VAR}} template)"
+        }
+      }
+    }
+  }
+}