@crewx/sdk 0.8.0-rc.80 → 0.8.0-rc.83

package/dist/types/index.d.ts

@@ -719,9 +719,7 @@ export type CrewxProjectConfig = z.infer<typeof CrewxProjectConfigSchema>;
 export interface CrewxOptions {
     workspaceRoot?: string;
     platform?: Platform;
-    /** Exec policy for the template engine's {{exec}} helper. */
     execPolicy?: import('../template/types').ExecPolicy;
-    /** API provider configuration (api/* namespace). */
     api?: {
         apiKeys?: Record<string, string>;
         defaults?: {
@@ -729,14 +727,6 @@ export interface CrewxOptions {
             temperature?: number;
         };
     };
-    /**
-     * Bootstrap factory for file:// remote agents. When the caller invokes an
-     * agent whose provider is `remote/*` with `location: file://...`, the SDK
-     * uses this factory to construct the target Crewx instance (so the target
-     * inherits the same plugin/environment setup as the caller). Consumers pass
-     * their own bootstrap wrapper (e.g. createCliCrewx, createServerCrewx).
-     * If omitted, falls back to plain `Crewx.loadYaml(path)` without plugins.
-     */
     remoteFactory?: (configPath: string) => Promise<import('../facade/Crewx').Crewx>;
 }
 export interface QueryOptions {
@@ -744,25 +734,19 @@ export interface QueryOptions {
     provider?: string;
     context?: string;
     metadata?: Record<string, unknown>;
-    /** Conversation thread ID (passed through to task:start event) */
     threadId?: string;
-    /** Platform origin. Propagated to task:start event. */
     platform?: Platform;
-    /** Caller-provided conversation history (WI-CONV-002). Takes priority over auto-fetch. */
     messages?: import('../conversation/types').TemplateMessage[];
 }
 export interface QueryResult {
     ok: boolean;
     data: string;
-    /** 'complete' when the agent finished, 'requires_action' when a client tool needs execution. */
     status?: 'complete' | 'requires_action';
-    /** Pending client tool call — present when status is 'requires_action'. */
     toolCall?: {
         toolCallId: string;
         toolName: string;
         args: Record<string, unknown>;
     };
-    /** Thread ID for continuing the conversation — present when status is 'requires_action'. */
     threadId?: string;
     error?: {
         code: string;
@@ -780,11 +764,8 @@ export interface ExecuteOptions {
     provider?: string;
     context?: string;
     metadata?: Record<string, unknown>;
-    /** Conversation thread ID (passed through to task:start event) */
     threadId?: string;
-    /** Platform origin. Propagated to task:start event. */
     platform?: Platform;
-    /** Caller-provided conversation history (WI-CONV-002). Takes priority over auto-fetch. */
     messages?: import('../conversation/types').TemplateMessage[];
 }
 export interface ExecuteResult {
@@ -801,4 +782,3 @@ export interface ExecuteResult {
         durationMs: number;
     };
 }
-//# sourceMappingURL=index.d.ts.map

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

@@ -1,6 +1,3 @@
-/**
- * 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;
@@ -15,4 +12,3 @@ export interface TaskLogEntry {
     targetTaskId?: string;
     errorMessage?: string;
 }
-//# sourceMappingURL=task-log.types.d.ts.map

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

@@ -1,18 +1,2 @@
-/**
- * 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/glob-match.d.ts

@@ -1,18 +1,2 @@
-/**
- * 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/id.d.ts

@@ -1,19 +1,4 @@
-/**
- * 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/timestamp.d.ts

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

package/dist/utils/workspace.d.ts

@@ -1,6 +1,2 @@
-/**
- * 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crewx/sdk",
-  "version": "0.8.0-rc.80",
+  "version": "0.8.0-rc.83",
   "license": "UNLICENSED",
   "engines": {
     "node": ">=20.19.0"
@@ -12,39 +12,40 @@
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
-      "require": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "require": "./dist/index.js"
     },
     "./browser": {
-      "import": "./dist/index.browser.js",
-      "types": "./dist/index.browser.d.ts"
+      "types": "./dist/index.browser.d.ts",
+      "import": "./dist/index.browser.js"
     },
     "./client": {
+      "types": "./dist/client/index.d.ts",
       "import": "./dist/client/index.js",
-      "require": "./dist/client/index.js",
-      "types": "./dist/client/index.d.ts"
+      "require": "./dist/client/index.js"
     },
     "./tools/node": {
+      "types": "./dist/tools/node/index.d.ts",
       "import": "./dist/tools/node/index.js",
-      "require": "./dist/tools/node/index.js",
-      "types": "./dist/tools/node/index.d.ts"
+      "require": "./dist/tools/node/index.js"
     },
     "./hooks": {
+      "types": "./dist/hooks/index.d.ts",
       "import": "./dist/hooks/index.js",
-      "require": "./dist/hooks/index.js",
-      "types": "./dist/hooks/index.d.ts"
+      "require": "./dist/hooks/index.js"
     },
     "./testing": {
+      "types": "./dist/testing/index.d.ts",
       "import": "./dist/testing/index.js",
-      "require": "./dist/testing/index.js",
-      "types": "./dist/testing/index.d.ts"
+      "require": "./dist/testing/index.js"
     },
     "./plugins": {
+      "types": "./dist/plugins/index.d.ts",
       "import": "./dist/plugins/index.js",
-      "require": "./dist/plugins/index.js",
-      "types": "./dist/plugins/index.d.ts"
-    }
+      "require": "./dist/plugins/index.js"
+    },
+    "./package.json": "./package.json"
   },
   "browser": {
     "./dist/template/helpers/exec.js": "./dist/template/helpers/exec.browser.js",
@@ -58,12 +59,7 @@
     "dist",
     "templates",
     "src/schemas/**/*.json",
-    "README.md",
-    "!**/__tests__",
-    "!**/*.test.*",
-    "!**/*.spec.*",
-    "!**/*.js.map",
-    "!**/*.d.ts.map"
+    "README.md"
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.0",
@@ -86,13 +82,16 @@
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^22.0.0",
     "better-sqlite3": "^12.8.0",
+    "tsup": "^8.5.1",
     "typescript": "^5.4.0",
     "vitest": "^3.1.1"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "build:esm": "tsc -p tsconfig.esm.json",
-    "build:all": "npm run build && npm run build:esm",
+    "build:cjs": "npx tsup --config tsup.cjs.js",
+    "build:esm": "npx tsup --config tsup.esm.js",
+    "build:browser": "npx tsup --config tsup.browser.js",
+    "build:dts": "tsc -p tsconfig.dts.json",
+    "build": "pnpm run build:cjs && pnpm run build:esm && pnpm run build:browser && pnpm run build:dts",
     "test": "vitest run --config ./vitest.config.ts",
     "test:watch": "vitest --config ./vitest.config.ts",
     "lint": "echo 'SDK lint pending' && exit 0"

package/dist/adapter/context-builder.js

@@ -1,87 +0,0 @@
-"use strict";
-/**
- * createAdapterContext — builds an AdapterContext for an adapter instance.
- *
- * M1: respondSync uses AsyncLocalStorage to bind the current HTTP response.
- * When called inside a registerRoute handler (sync window), respondSync writes
- * to the HTTP res. When called outside the sync window, it performs graceful
- * degradation: logs a warning instead of throwing (PoC correction #3).
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getSyncWindowStore = getSyncWindowStore;
-exports.runInSyncWindow = runInSyncWindow;
-exports.createAdapterContext = createAdapterContext;
-const async_hooks_1 = require("async_hooks");
-const syncWindowStore = new async_hooks_1.AsyncLocalStorage();
-function getSyncWindowStore() {
-    return syncWindowStore;
-}
-function runInSyncWindow(window, fn) {
-    return syncWindowStore.run(window, fn);
-}
-function createAdapterContext(opts) {
-    const log = opts.log ?? opts.logger ?? {
-        debug: () => { },
-        info: () => { },
-        warn: () => { },
-        error: () => { },
-    };
-    const agentRunner = opts.agentRunner ?? {
-        run: async () => ({ output: '' }),
-    };
-    const db = opts.db ?? {
-        get: async () => undefined,
-        set: async () => { },
-        delete: async () => false,
-        list: async () => [],
-    };
-    const storage = opts.storage ?? {
-        put: async () => '',
-        get: async () => undefined,
-        delete: async () => false,
-    };
-    const audit = opts.audit ?? {
-        log: async () => { },
-    };
-    const inbound = opts.onInbound ?? (async () => ({ accepted: true }));
-    const emitEventFn = opts.onEmitEvent ?? (async () => ({ accepted: true }));
-    const updateMessage = opts.onUpdateMessage ?? (async () => { });
-    const resolveUser = opts.onResolveUser ?? (async (userId) => ({
-        userId,
-        displayName: userId,
-    }));
-    const respondSync = async (payload) => {
-        const window = syncWindowStore.getStore();
-        if (!window) {
-            log.warn('respondSync called outside sync window — graceful degradation (no-op)', {
-                textPreview: typeof payload === 'object' && 'text' in payload ? payload.text.slice(0, 80) : undefined,
-            });
-            return;
-        }
-        const text = 'text' in payload ? payload.text : '';
-        window.res.status(200).json({ text });
-    };
-    const httpRouter = opts.httpRouter ?? {
-        registerRoute: () => {
-            log.warn('httpRouter not configured — registerRoute is a no-op');
-        },
-    };
-    return {
-        instanceId: opts.instanceId,
-        config: opts.config,
-        capabilities: opts.capabilities,
-        log,
-        agentRunner,
-        db,
-        storage,
-        audit,
-        abortSignal: opts.abortSignal ?? new AbortController().signal,
-        httpRouter,
-        inbound,
-        emitEvent: emitEventFn,
-        updateMessage,
-        resolveUser,
-        respondSync,
-    };
-}
-//# sourceMappingURL=context-builder.js.map

package/dist/adapter/index.js

@@ -1,21 +0,0 @@
-"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("./types"), exports);
-__exportStar(require("./plugin-helper"), exports);
-__exportStar(require("./scoped-store"), exports);
-__exportStar(require("./context-builder"), exports);
-//# sourceMappingURL=index.js.map

package/dist/adapter/plugin-helper.js

@@ -1,45 +0,0 @@
-"use strict";
-/**
- * Plugin helpers for defining channel adapters.
- *
- * defineChannelAdapter — type-safe identity function for IChannelAdapter.
- * defineChannelAdapterPlugin — wraps an adapter as a CrewxPlugin (§3.3).
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.defineChannelAdapter = defineChannelAdapter;
-exports.defineChannelAdapterPlugin = defineChannelAdapterPlugin;
-function defineChannelAdapter(spec) {
-    return spec;
-}
-function defineChannelAdapterPlugin(spec) {
-    return {
-        name: spec.name,
-        async attach(crewx) {
-            const config = await spec.configFactory(crewx);
-            const anyCrewx = crewx;
-            const registerFn = anyCrewx['registerChannelAdapter'];
-            const instanceId = spec.instanceId ?? spec.name;
-            if (registerFn) {
-                await registerFn({
-                    adapter: spec.adapter,
-                    instanceId,
-                    config,
-                });
-            }
-            if (spec.onAttach) {
-                await spec.onAttach(crewx);
-            }
-        },
-        async detach(crewx) {
-            const anyCrewx = crewx;
-            const unregisterFn = anyCrewx['unregisterChannelAdapter'];
-            if (unregisterFn) {
-                await unregisterFn(spec.instanceId ?? spec.name);
-            }
-            if (spec.onDetach) {
-                await spec.onDetach(crewx);
-            }
-        },
-    };
-}
-//# sourceMappingURL=plugin-helper.js.map

package/dist/adapter/scoped-store.js

@@ -1,43 +0,0 @@
-"use strict";
-/**
- * ScopedAdapterStore — adapter key-value store with mandatory instanceId prefix.
- *
- * Security: Uses Map closure pattern (RT-1 defense).
- * The internal Map is captured in a function closure — no public or private
- * property on the returned AdapterStore object holds the raw Map reference.
- * Reflect / Object.getPrototypeOf / (ctx.db as any)['_rawStore'] all fail
- * because the Map only exists in the createScopedAdapterStore function scope.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createScopedAdapterStore = createScopedAdapterStore;
-function createScopedAdapterStore(instanceId) {
-    const store = new Map();
-    const prefixKey = (key) => {
-        if (key.startsWith(`${instanceId}::`))
-            return key;
-        return `${instanceId}::${key}`;
-    };
-    return {
-        async get(key) {
-            const entry = store.get(prefixKey(key));
-            return entry ? entry.value : undefined;
-        },
-        async set(key, value) {
-            store.set(prefixKey(key), { value });
-        },
-        async delete(key) {
-            return store.delete(prefixKey(key));
-        },
-        async list(prefix) {
-            const fullPrefix = prefix ? prefixKey(prefix) : `${instanceId}::`;
-            const keys = [];
-            for (const k of store.keys()) {
-                if (k.startsWith(fullPrefix)) {
-                    keys.push(k.slice(instanceId.length + 2));
-                }
-            }
-            return keys;
-        },
-    };
-}
-//# sourceMappingURL=scoped-store.js.map

package/dist/adapter/types.js

@@ -1,23 +0,0 @@
-"use strict";
-/**
- * Adapter Platform v0.4 — core types.
- * PoC corrections applied:
- *   1. AdapterError: class only (interface removed)
- *   2. kind: added 'config' for configuration errors
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AdapterError = void 0;
-class AdapterError extends Error {
-    code;
-    kind;
-    retryAfterMs;
-    constructor(code, kind, retryAfterMs) {
-        super(`AdapterError: ${code}`);
-        this.name = 'AdapterError';
-        this.code = code;
-        this.kind = kind;
-        this.retryAfterMs = retryAfterMs;
-    }
-}
-exports.AdapterError = AdapterError;
-//# sourceMappingURL=types.js.map

package/dist/agent/resolver.js

@@ -1,46 +0,0 @@
-"use strict";
-/**
- * Agent resolver: looks up an agent from a list by ref.
- * Supports both bare id ('claude') and @mention format ('@claude').
- * Falls back to built-in provider shorthands (claude, gemini, copilot, codex).
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgentNotFoundError = void 0;
-exports.resolveAgent = resolveAgent;
-class AgentNotFoundError extends Error {
-    constructor(agentRef, availableIds) {
-        const available = availableIds.length > 0
-            ? ` Available: ${availableIds.join(', ')}`
-            : '';
-        super(`Agent not found: "${agentRef}".${available}`);
-        this.name = 'AgentNotFoundError';
-    }
-}
-exports.AgentNotFoundError = AgentNotFoundError;
-/** Built-in provider shorthands that can be used without a crewx.yaml entry. */
-const BUILTIN_PROVIDERS = {
-    claude: { id: 'claude', provider: 'cli/claude' },
-    gemini: { id: 'gemini', provider: 'cli/gemini' },
-    copilot: { id: 'copilot', provider: 'cli/copilot' },
-    codex: { id: 'codex', provider: 'cli/codex' },
-};
-/**
- * Resolve an agent by reference.
- * @param agentRef - Agent reference: '@claude', 'claude', '@my_agent', etc.
- * @param agents   - List of available agent configs.
- * @returns The matching AgentConfig.
- * @throws AgentNotFoundError when no match is found.
- */
-function resolveAgent(agentRef, agents) {
-    const agentId = agentRef.startsWith('@') ? agentRef.slice(1) : agentRef;
-    // 1. Look in YAML-defined agents first
-    const agent = agents.find(a => a.id === agentId);
-    if (agent)
-        return agent;
-    // 2. Fall back to built-in provider shorthands
-    const builtin = BUILTIN_PROVIDERS[agentId];
-    if (builtin)
-        return builtin;
-    throw new AgentNotFoundError(agentRef, agents.map(a => a.id));
-}
-//# sourceMappingURL=resolver.js.map

package/dist/boxing/box-storage.interface.js

@@ -1,6 +0,0 @@
-"use strict";
-/**
- * Box storage interfaces — used by SdkBoxService and buildContext.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=box-storage.interface.js.map

package/dist/boxing/box.service.js

@@ -1,73 +0,0 @@
-"use strict";
-/**
- * SdkBoxService — manages box creation, retrieval, and listing.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SdkBoxService = void 0;
-const id_1 = require("../utils/id");
-const ID_PATTERN = /^[a-zA-Z0-9._-]+$/;
-class SdkBoxService {
-    storage;
-    constructor(storage) {
-        this.storage = storage;
-    }
-    listBoxes(threadId) {
-        this.validateId(threadId);
-        const rows = this.storage.listBoxes(threadId);
-        const boxes = rows.map((row) => this.toBoxResponse(row));
-        return { boxes, total: boxes.length };
-    }
-    getBox(threadId, boxId) {
-        this.validateId(threadId);
-        this.validateId(boxId);
-        const row = this.storage.findBox(threadId, boxId);
-        if (!row)
-            return null;
-        return this.toBoxResponse(row);
-    }
-    createBox(threadId, params) {
-        this.validateId(threadId);
-        const id = this.generateBoxId();
-        const createdAt = new Date().toISOString();
-        const row = this.storage.insertBox(threadId, {
-            id,
-            seq: params.seq,
-            firstTaskId: params.firstTaskId,
-            midTaskId: params.midTaskId,
-            lastTaskId: params.lastTaskId,
-            taskCount: params.taskCount,
-            summary: params.summary ?? null,
-            sourceTokens: params.sourceTokens,
-            summaryTokens: params.summaryTokens ?? null,
-            createdAt,
-        });
-        return this.toBoxResponse(row);
-    }
-    toBoxResponse(row) {
-        return {
-            id: row.id,
-            threadId: row.thread_id,
-            seq: row.seq,
-            firstTaskId: row.first_task_id,
-            lastTaskId: row.last_task_id,
-            taskCount: row.task_count,
-            sourceTokens: row.source_tokens,
-            summaryTokens: row.summary_tokens,
-            summary: row.summary,
-            previewFirst: this.storage.getTaskPreview(row.first_task_id, 200),
-            previewMid: this.storage.getTaskPreview(row.mid_task_id, 200),
-            previewLast: this.storage.getTaskPreview(row.last_task_id, 200),
-            createdAt: row.created_at,
-        };
-    }
-    validateId(id) {
-        if (!ID_PATTERN.test(id)) {
-            throw new Error(`Invalid ID format: ${id}`);
-        }
-    }
-    generateBoxId() {
-        return (0, id_1.generateId)('box');
-    }
-}
-exports.SdkBoxService = SdkBoxService;
-//# sourceMappingURL=box.service.js.map

package/dist/boxing/box.types.js

@@ -1,6 +0,0 @@
-"use strict";
-/**
- * Boxing domain types — Box/Thread/Context types for SDK boxing module.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=box.types.js.map