@crewx/sdk 0.8.0-rc.73 → 0.8.0-rc.74

package/dist/types/index.js

@@ -1,23 +1,32 @@
 "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("./agent.types"), exports);
-__exportStar(require("./template.types"), exports);
-__exportStar(require("./layout.types"), exports);
-__exportStar(require("./provider.types"), exports);
-__exportStar(require("./api-provider.types"), exports);
-__exportStar(require("./task-log.types"), exports);
+exports.CrewxProjectConfigSchema = exports.AgentConfigSchema = exports.AgentInlineSchema = void 0;
+const zod_1 = require("zod");
+// ─── Agent Config ───────────────────────────────────────────────────────────
+exports.AgentInlineSchema = zod_1.z.object({
+    model: zod_1.z.string().optional(),
+    system_prompt: zod_1.z.string().optional(),
+    prompt: zod_1.z.string().optional(),
+    layout: zod_1.z.union([zod_1.z.string(), zod_1.z.object({ id: zod_1.z.string(), props: zod_1.z.record(zod_1.z.unknown()).optional() })]).optional(),
+}).catchall(zod_1.z.unknown());
+exports.AgentConfigSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    name: zod_1.z.string().optional(),
+    role: zod_1.z.string().optional(),
+    team: zod_1.z.string().optional(),
+    provider: zod_1.z.union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())]),
+    working_directory: zod_1.z.string().optional(),
+    description: zod_1.z.string().optional(),
+    tags: zod_1.z.array(zod_1.z.string()).optional(),
+    inline: exports.AgentInlineSchema.optional(),
+}).catchall(zod_1.z.unknown());
+// ─── Project Config ─────────────────────────────────────────────────────────
+exports.CrewxProjectConfigSchema = zod_1.z.object({
+    agents: zod_1.z.array(exports.AgentConfigSchema).optional(),
+    hooks: zod_1.z.array(zod_1.z.unknown()).optional(),
+    settings: zod_1.z.record(zod_1.z.unknown()).optional(),
+    skills: zod_1.z.unknown().optional(),
+    layouts: zod_1.z.record(zod_1.z.unknown()).optional(),
+    documents: zod_1.z.record(zod_1.z.unknown()).optional(),
+}).catchall(zod_1.z.unknown());
 //# sourceMappingURL=index.js.map

package/dist/types/task-log.types.d.ts

@@ -1,3 +1,6 @@
+/**
+ * Task log types — shared types for task log entries across parsers and server code.
+ */
 export type TaskLogEntryType = 'text' | 'tool_use' | 'tool_result' | 'error' | 'info' | 'agent_call';
 export interface TaskLogEntry {
     timestamp: string;
@@ -12,3 +15,4 @@ export interface TaskLogEntry {
     targetTaskId?: string;
     errorMessage?: string;
 }
+//# sourceMappingURL=task-log.types.d.ts.map

package/dist/types/task-log.types.js

@@ -1,3 +1,6 @@
 "use strict";
+/**
+ * Task log types — shared types for task log entries across parsers and server code.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=task-log.types.js.map

package/dist/utils/env-defaults.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Centralized CREWX_* environment variable defaults.
+ *
+ * Priority: process.env value > hardcoded fallback.
+ * No filesystem checks (cwd-dependent paths break in worktrees).
+ * Browser-safe: guards process.env / process.cwd() access.
+ */
+/**
+ * Resolve CREWX_CLI path.
+ * Returns process.env.CREWX_CLI if set, otherwise 'npx crewx'.
+ */
+export declare function resolveCrewxCli(): string;
+/**
+ * Resolve CREWX_WORKSPACE path.
+ * Returns process.env.CREWX_WORKSPACE if set, otherwise current working directory.
+ */
+export declare function resolveCrewxWorkspace(): string;
+//# sourceMappingURL=env-defaults.d.ts.map

package/dist/utils/env-defaults.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Centralized CREWX_* environment variable defaults.
+ *
+ * Priority: process.env value > hardcoded fallback.
+ * No filesystem checks (cwd-dependent paths break in worktrees).
+ * Browser-safe: guards process.env / process.cwd() access.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveCrewxCli = resolveCrewxCli;
+exports.resolveCrewxWorkspace = resolveCrewxWorkspace;
+const _env = typeof process !== 'undefined' ? process.env : {};
+/**
+ * Resolve CREWX_CLI path.
+ * Returns process.env.CREWX_CLI if set, otherwise 'npx crewx'.
+ */
+function resolveCrewxCli() {
+    return _env.CREWX_CLI || 'npx crewx';
+}
+/**
+ * Resolve CREWX_WORKSPACE path.
+ * Returns process.env.CREWX_WORKSPACE if set, otherwise current working directory.
+ */
+function resolveCrewxWorkspace() {
+    return _env.CREWX_WORKSPACE || (typeof process !== 'undefined' ? process.cwd() : '/');
+}
+//# sourceMappingURL=env-defaults.js.map

package/dist/utils/glob-match.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Glob pattern matching utilities.
+ * Shared by exec helper (security allow/deny) and agent ls filter.
+ *
+ * '*'  — matches any characters within a single path segment (non-'/').
+ * '**' — matches any characters including '/'.
+ */
+/**
+ * Converts a glob pattern to a RegExp.
+ * Handles path-based matching (split by '/') consistent with minimatch behavior.
+ */
+export declare function globToRegex(pattern: string): RegExp;
+/**
+ * Checks if a value matches a glob pattern.
+ * Returns false on any regex construction error.
+ */
+export declare function matchesPattern(value: string, pattern: string): boolean;
+//# sourceMappingURL=glob-match.d.ts.map

package/dist/utils/glob-match.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * Glob pattern matching utilities.
+ * Shared by exec helper (security allow/deny) and agent ls filter.
+ *
+ * '*'  — matches any characters within a single path segment (non-'/').
+ * '**' — matches any characters including '/'.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.globToRegex = globToRegex;
+exports.matchesPattern = matchesPattern;
+/**
+ * Converts a glob pattern to a RegExp.
+ * Handles path-based matching (split by '/') consistent with minimatch behavior.
+ */
+function globToRegex(pattern) {
+    const escape = (s) => s.replace(/[.+^${}()|[\]\\]/g, '\\$&');
+    const parts = pattern.split('/');
+    const regexParts = parts.map(part => {
+        if (part === '**') {
+            return '.*';
+        }
+        return part
+            .split('*')
+            .map(escape)
+            .join('[^/]*');
+    });
+    return new RegExp(`^${regexParts.join('\\/')}$`);
+}
+/**
+ * Checks if a value matches a glob pattern.
+ * Returns false on any regex construction error.
+ */
+function matchesPattern(value, pattern) {
+    try {
+        return globToRegex(pattern).test(value);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=glob-match.js.map

package/dist/{core → utils}/id.d.ts

@@ -1,4 +1,19 @@
+/**
+ * ID generation utilities.
+ * Backward-compatible with packages that import generateId from @crewx/sdk.
+ */
+/**
+ * Valid entity prefixes for generated IDs.
+ */
 export type EntityPrefix = 'tsk' | 'thd' | 'msg' | 'box' | 'prj' | 'mem' | 'spn' | 'cron' | 'wbs' | 'job' | 'tcl' | 'req' | 'ws' | 'wfr';
 export type PrefixedId<P extends EntityPrefix> = `${P}_${string}`;
+/**
+ * Generate a random prefixed ID.
+ * @example generateId('tsk') // → "tsk_V1StGXR8"
+ */
 export declare function generateId<P extends EntityPrefix>(prefix: P): PrefixedId<P>;
+/**
+ * Generate a deterministic fingerprint ID from a string input.
+ */
 export declare function generateFingerprint<P extends EntityPrefix>(prefix: P, input: string): PrefixedId<P>;
+//# sourceMappingURL=id.d.ts.map

package/dist/utils/id.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * ID generation utilities.
+ * Backward-compatible with packages that import generateId from @crewx/sdk.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateId = generateId;
+exports.generateFingerprint = generateFingerprint;
+const crypto_1 = require("crypto");
+const ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+function randomBase62(length) {
+    const bytes = (0, crypto_1.randomBytes)(length * 2);
+    let result = '';
+    for (let i = 0; i < bytes.length && result.length < length; i++) {
+        const byte = bytes[i];
+        if (byte < 248) {
+            result += ALPHABET[byte % 62];
+        }
+    }
+    // Fill remaining with fallback
+    while (result.length < length) {
+        result += ALPHABET[(0, crypto_1.randomBytes)(1)[0] % 62];
+    }
+    return result;
+}
+/**
+ * Generate a random prefixed ID.
+ * @example generateId('tsk') // → "tsk_V1StGXR8"
+ */
+function generateId(prefix) {
+    return `${prefix}_${randomBase62(8)}`;
+}
+/**
+ * Generate a deterministic fingerprint ID from a string input.
+ */
+function generateFingerprint(prefix, input) {
+    const { createHash } = require('crypto');
+    const hash = createHash('sha256').update(input).digest();
+    // XOR-fold 32 bytes into 8 bytes
+    const folded = Buffer.alloc(8);
+    for (let i = 0; i < 32; i++) {
+        folded[i % 8] ^= hash[i];
+    }
+    let result = '';
+    for (const byte of folded) {
+        result += ALPHABET[byte % 62];
+    }
+    return `${prefix}_${result}`;
+}
+//# sourceMappingURL=id.js.map

package/dist/utils/timestamp.d.ts

@@ -0,0 +1,2 @@
+export declare function formatTimestamp(date: Date): string;
+//# sourceMappingURL=timestamp.d.ts.map

package/dist/utils/timestamp.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatTimestamp = formatTimestamp;
+function formatTimestamp(date) {
+    const pad = (n) => String(n).padStart(2, '0');
+    return (`${date.getFullYear()}` +
+        `${pad(date.getMonth() + 1)}` +
+        `${pad(date.getDate())}` +
+        `T${pad(date.getHours())}` +
+        `${pad(date.getMinutes())}` +
+        `${pad(date.getSeconds())}`);
+}
+//# sourceMappingURL=timestamp.js.map

package/dist/{core → utils}/workspace.d.ts

@@ -1,2 +1,6 @@
+/**
+ * Workspace path normalization and hashing utilities.
+ */
 export declare function normalizeWorkspacePath(workspacePath: string): string;
 export declare function hashWorkspaceId(workspacePath: string): string;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/{core → utils}/workspace.js

@@ -1,4 +1,7 @@
 "use strict";
+/**
+ * Workspace path normalization and hashing utilities.
+ */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);

package/package.json

@@ -1,135 +1,100 @@
 {
   "name": "@crewx/sdk",
-  "version": "0.8.0-rc.73",
+  "version": "0.8.0-rc.74",
   "license": "UNLICENSED",
   "engines": {
     "node": ">=20.19.0"
   },
-  "description": "SowonAI CrewX SDK",
+  "description": "CrewX SDK — facade for loading crewx.yaml and querying agents",
   "type": "commonjs",
   "main": "dist/index.js",
-  "module": "dist/index.js",
+  "module": "dist/esm/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"
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
     },
-    "./internal": {
-      "types": "./dist/internal/index.d.ts",
-      "import": "./dist/internal/index.js",
-      "require": "./dist/internal/index.js"
+    "./browser": {
+      "import": "./dist/index.browser.js",
+      "types": "./dist/index.browser.d.ts"
     },
-    "./tools": {
-      "types": "./dist/tools/index.d.ts",
-      "import": "./dist/tools/index.js",
-      "require": "./dist/tools/index.js"
+    "./client": {
+      "import": "./dist/client/index.js",
+      "require": "./dist/client/index.js",
+      "types": "./dist/client/index.d.ts"
     },
-    "./api": {
-      "types": "./dist/api/index.d.ts",
-      "import": "./dist/api/index.js",
-      "require": "./dist/api/index.js"
+    "./tools/node": {
+      "import": "./dist/tools/node/index.js",
+      "require": "./dist/tools/node/index.js",
+      "types": "./dist/tools/node/index.d.ts"
     },
-    "./core/env-defaults": {
-      "types": "./dist/core/env-defaults.d.ts",
-      "import": "./dist/core/env-defaults.js",
-      "require": "./dist/core/env-defaults.js"
+    "./hooks": {
+      "import": "./dist/hooks/index.js",
+      "require": "./dist/hooks/index.js",
+      "types": "./dist/hooks/index.d.ts"
     },
-    "./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"
-      ]
+    "./testing": {
+      "import": "./dist/testing/index.js",
+      "require": "./dist/testing/index.js",
+      "types": "./dist/testing/index.d.ts"
+    },
+    "./plugins": {
+      "import": "./dist/plugins/index.js",
+      "require": "./dist/plugins/index.js",
+      "types": "./dist/plugins/index.d.ts"
     }
   },
+  "browser": {
+    "./dist/template/helpers/exec.js": "./dist/template/helpers/exec.browser.js",
+    "./dist/esm/template/helpers/exec.js": "./dist/esm/template/helpers/exec.browser.js",
+    "./dist/platform/NodeFsAdapter.js": false,
+    "./dist/esm/platform/NodeFsAdapter.js": false,
+    "./dist/layout/loader.js": false,
+    "./dist/esm/layout/loader.js": false
+  },
+  "files": [
+    "dist",
+    "templates",
+    "src/schemas/**/*.json",
+    "README.md",
+    "!**/__tests__",
+    "!**/*.test.*",
+    "!**/*.spec.*",
+    "!**/*.js.map",
+    "!**/*.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:all": "npm run build && npm run build:esm",
+    "test": "vitest run --config ./vitest.config.ts",
+    "test:watch": "vitest --config ./vitest.config.ts",
+    "lint": "echo 'SDK lint pending' && exit 0"
+  },
   "dependencies": {
-    "glob": "^11.0.0",
-    "handlebars": "^4.7.8",
+    "@modelcontextprotocol/sdk": "^1.27.0",
+    "ai": "^4.0.0",
+    "handlebars": "^4.7.9",
     "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",
-    "nanoid": "^3.3.11",
     "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"
+    "better-sqlite3": "^12.0.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": {
+    "better-sqlite3": {
       "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/better-sqlite3": "^7.6.12",
+    "@types/handlebars": "^4.0.40",
     "@types/js-yaml": "^4.0.9",
-    "ai": "^5.0.92",
-    "dotenv": "^17.2.3",
-    "typescript": "^5.0.0"
+    "@types/node": "^22.0.0",
+    "better-sqlite3": "^12.8.0",
+    "typescript": "^5.4.0",
+    "vitest": "^3.1.1"
   }
 }

package/src/schemas/hooks.schema.json

@@ -0,0 +1,59 @@
+{
+  "$id": "https://crewx.dev/schemas/hooks",
+  "type": "array",
+  "items": {
+    "type": "object",
+    "required": ["name"],
+    "properties": {
+      "name": { "type": "string" },
+      "provider": {
+        "oneOf": [
+          { "enum": ["claude", "codex", "gemini", "copilot", "opencode"] },
+          { "type": "array", "items": { "enum": ["claude", "codex", "gemini", "copilot", "opencode"] } }
+        ]
+      },
+      "team": { "oneOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }] },
+      "role": { "oneOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }] },
+      "tag": { "oneOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }] },
+      "agents": { "type": "array", "items": { "type": "string" } },
+      "event": { "enum": ["PreToolUse"] },
+      "config": { "type": "object" },
+      "deny": {
+        "type": "object",
+        "required": ["reason"],
+        "properties": {
+          "when": { "type": "array", "items": { "type": "string" } },
+          "pattern": { "type": "string" },
+          "regex": { "type": "string" },
+          "pathPattern": { "type": "string" },
+          "pathSizeMin": { "oneOf": [{ "type": "number" }, { "type": "string" }] },
+          "pathSizeMax": { "oneOf": [{ "type": "number" }, { "type": "string" }] },
+          "reason": { "type": "string" }
+        },
+        "additionalProperties": false
+      },
+      "guide": {
+        "type": "object",
+        "required": ["say"],
+        "properties": {
+          "when": { "type": "array", "items": { "type": "string" } },
+          "pattern": { "type": "string" },
+          "regex": { "type": "string" },
+          "pathPattern": { "type": "string" },
+          "pathSizeMin": { "oneOf": [{ "type": "number" }, { "type": "string" }] },
+          "pathSizeMax": { "oneOf": [{ "type": "number" }, { "type": "string" }] },
+          "whenInputRegex": { "type": "string" },
+          "say": { "type": "string" },
+          "once": { "type": "boolean" }
+        },
+        "additionalProperties": false
+      },
+      "plugin": { "type": "string" }
+    },
+    "oneOf": [
+      { "required": ["deny"] },
+      { "required": ["guide"] },
+      { "required": ["plugin"] }
+    ]
+  }
+}