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

package/dist/esm/template/helpers/p1p2.js

@@ -1,83 +0,0 @@
-/**
- * P1/P2 Handlebars helper implementations.
- *
- * P1: truncate, length, escapeHandlebars
- * P2: formatFileSize, formatTimestamp
- *
- * Ported from packages/cli-bak/src/utils/template-processor.ts.
- * formatConversation is intentionally excluded (user confirmed).
- */
-// ── P1 Helpers ────────────────────────────────────────────────────────────────
-/**
- * Truncate text to maxLength, appending remaining char count if truncated.
- * {{truncate text 500}} or {{{truncate text 500}}}
- */
-export function truncateHelper(text, maxLength) {
-    if (!text)
-        return '';
-    if (text.length <= maxLength)
-        return text;
-    const remaining = text.length - maxLength;
-    return `${text.substring(0, maxLength)} (...+${remaining} chars)`;
-}
-/**
- * Return the length of an array or string.
- * {{length array}} / {{length string}}
- */
-export function lengthHelper(value) {
-    if (Array.isArray(value))
-        return value.length;
-    if (typeof value === 'string')
-        return value.length;
-    return 0;
-}
-/**
- * Escape Handlebars delimiters in user-provided content.
- * Prevents secondary template compilation of user content.
- * {{{escapeHandlebars text}}}
- */
-export function escapeHandlebarsHelper(text) {
-    if (typeof text !== 'string')
-        return '';
-    return text.replace(/\{\{/g, '&#123;&#123;').replace(/\}\}/g, '&#125;&#125;');
-}
-// ── P2 Helpers ────────────────────────────────────────────────────────────────
-const FILE_SIZE_UNITS = ['B', 'KB', 'MB', 'GB'];
-/**
- * Format a byte count as a human-readable file size string.
- * {{formatFileSize bytes}}
- */
-export function formatFileSizeHelper(bytes) {
-    if (bytes === 0)
-        return '0 B';
-    const i = Math.min(Math.floor(Math.log(bytes) / Math.log(1024)), FILE_SIZE_UNITS.length - 1);
-    const value = Math.round((bytes / Math.pow(1024, i)) * 100) / 100;
-    return `${value} ${FILE_SIZE_UNITS[i]}`;
-}
-/**
- * Format a Date or ISO timestamp string into a locale-aware display string.
- * Returns empty string for invalid or falsy input.
- * {{formatTimestamp timestamp}}
- */
-export function formatTimestampHelper(timestamp) {
-    if (!timestamp)
-        return '';
-    try {
-        const date = timestamp instanceof Date ? timestamp : new Date(timestamp);
-        if (isNaN(date.getTime()))
-            return '';
-        return date.toLocaleString('ko-KR', {
-            year: 'numeric',
-            month: '2-digit',
-            day: '2-digit',
-            hour: '2-digit',
-            minute: '2-digit',
-            second: '2-digit',
-            hour12: false,
-        });
-    }
-    catch {
-        return '';
-    }
-}
-//# sourceMappingURL=p1p2.js.map

package/dist/esm/template/loader/DocumentLoader.js

@@ -1,124 +0,0 @@
-/**
- * DocumentLoader — loads documents from crewx.yaml `documents:` section.
- *
- * Supports:
- *   - Inline string:       `notice: "Some text"`
- *   - Inline object:       `notice: { content: "Some text" }`
- *   - File path (relative):  `guide: { path: "docs/guide.md" }`
- *   - File path (absolute):  `guide: { path: "/abs/docs/guide.md" }`
- *
- * File I/O is delegated to IFsAdapter for testability and future WEB compat.
- */
-import { defaultFsAdapter } from '../../platform/NodeFsAdapter';
-// ── DocumentLoader ──────────────────────────────────────────────────────────
-export class DocumentLoader {
-    docs = new Map();
-    fs;
-    constructor(fsAdapter) {
-        this.fs = fsAdapter ?? defaultFsAdapter;
-    }
-    /**
-     * Load all documents from the `documents:` section of crewx.yaml.
-     *
-     * @param sources     - Record of document name → source (string, {path}, or {content})
-     * @param projectRoot - Base directory for resolving relative file paths
-     */
-    async load(sources, projectRoot) {
-        if (!sources)
-            return;
-        for (const [name, rawSource] of Object.entries(sources)) {
-            const source = rawSource;
-            if (typeof source === 'string') {
-                // Case 1: inline string
-                this.docs.set(name, { content: source });
-            }
-            else if (source && typeof source === 'object') {
-                const src = source;
-                if ('content' in src && typeof src['content'] === 'string') {
-                    // Case 2: inline object with content field
-                    this.docs.set(name, { content: src['content'] });
-                }
-                else if ('path' in src && typeof src['path'] === 'string') {
-                    // Case 3: file path
-                    await this.loadFromFile(name, src['path'], projectRoot);
-                }
-                else {
-                    console.warn(`[DocumentLoader] Skipping '${name}': unsupported format`);
-                }
-            }
-            else {
-                console.warn(`[DocumentLoader] Skipping '${name}': unsupported format`);
-            }
-        }
-    }
-    /** Get document text content by name. Returns undefined if not loaded. */
-    async getContent(name) {
-        return this.docs.get(name)?.content;
-    }
-    /**
-     * Get a simple TOC (table of contents) for a markdown document.
-     * Extracts headings (lines starting with `#`) and returns them as an indented list.
-     * Returns undefined if there are no headings.
-     */
-    async getToc(name) {
-        const doc = this.docs.get(name);
-        if (!doc)
-            return undefined;
-        const headings = [];
-        for (const line of doc.content.split('\n')) {
-            const match = /^(#{1,6})\s+(.+)$/.exec(line.trim());
-            if (match) {
-                headings.push({ depth: match[1].length, text: match[2].trim() });
-            }
-        }
-        if (headings.length === 0)
-            return undefined;
-        return headings
-            .map(({ depth, text }) => `${'  '.repeat(depth - 1)}- ${text}`)
-            .join('\n');
-    }
-    /** Get the resolved absolute file path for a file-based document. */
-    getPath(name) {
-        return this.docs.get(name)?.path;
-    }
-    /** Get all loaded document names. */
-    getNames() {
-        return Array.from(this.docs.keys());
-    }
-    /**
-     * Build a documents context object suitable for Handlebars template rendering.
-     * Returns `{ docName: { content, toc, path? }, ... }`.
-     */
-    async buildContext() {
-        const ctx = {};
-        for (const name of this.docs.keys()) {
-            const content = await this.getContent(name) ?? '';
-            const toc = await this.getToc(name);
-            const path = this.getPath(name);
-            ctx[name] = { content, toc, ...(path ? { path } : {}) };
-        }
-        return ctx;
-    }
-    // ── Private ───────────────────────────────────────────────────────────────
-    async loadFromFile(name, filePath, projectRoot) {
-        try {
-            const resolvedPath = this.resolve(filePath, projectRoot);
-            const content = await this.fs.readFile(resolvedPath);
-            this.docs.set(name, { content, path: resolvedPath });
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            console.warn(`[DocumentLoader] Failed to load '${name}' from '${filePath}': ${msg}`);
-        }
-    }
-    resolve(filePath, projectRoot) {
-        if (this.fs.isAbsolute(filePath)) {
-            return filePath;
-        }
-        if (projectRoot) {
-            return this.fs.resolvePath(projectRoot, filePath);
-        }
-        return this.fs.resolvePath(filePath);
-    }
-}
-//# sourceMappingURL=DocumentLoader.js.map

package/dist/esm/template/types.js

@@ -1,5 +0,0 @@
-/**
- * Type definitions for the CrewX template engine.
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/esm/tools/delegate.js

@@ -1,57 +0,0 @@
-/**
- * delegate_to_agent — 다른 에이전트에게 작업을 위임하는 빌트인 tool.
- *
- * PM → Dev처럼 에이전트 간 자동 위임을 가능하게 한다.
- * crewx 인스턴스를 클로저로 캡처하여 내부에서 query/execute 호출.
- */
-const MAX_DELEGATION_DEPTH = 3;
-let _delegationDepth = 0;
-export function createDelegateTool(crewx) {
-    const agentIds = Array.from(crewx.agents.keys());
-    return {
-        name: 'delegate_to_agent',
-        description: `Delegate a task to another agent. Available agents: ${agentIds.join(', ')}`,
-        parameters: {
-            type: 'object',
-            properties: {
-                agent: {
-                    type: 'string',
-                    description: `Agent ID to delegate to. One of: ${agentIds.join(', ')}`,
-                },
-                message: {
-                    type: 'string',
-                    description: 'Task description for the target agent',
-                },
-                mode: {
-                    type: 'string',
-                    description: 'Execution mode: "query" for questions, "execute" for actions. Default: query',
-                },
-            },
-            required: ['agent', 'message'],
-        },
-        execute: async (args) => {
-            if (_delegationDepth >= MAX_DELEGATION_DEPTH) {
-                return `Error: Maximum delegation depth (${MAX_DELEGATION_DEPTH}) reached. Cannot delegate further.`;
-            }
-            const targetAgent = args.agent;
-            const taskMessage = args.message;
-            const mode = args.mode ?? 'query';
-            if (!agentIds.includes(targetAgent)) {
-                return `Error: Unknown agent "${targetAgent}". Available: ${agentIds.join(', ')}`;
-            }
-            _delegationDepth++;
-            try {
-                if (mode === 'execute') {
-                    const result = await crewx.execute(targetAgent, taskMessage);
-                    return result.ok ? result.data : `Error: ${result.error?.message ?? 'Unknown error'}`;
-                }
-                const result = await crewx.query(targetAgent, taskMessage);
-                return result.ok ? result.data : `Error: ${result.error?.message ?? 'Unknown error'}`;
-            }
-            finally {
-                _delegationDepth--;
-            }
-        },
-    };
-}
-//# sourceMappingURL=delegate.js.map

package/dist/esm/tools/index.js

@@ -1,5 +0,0 @@
-/**
- * @crewx/sdk/tools — 빌트인 tool exports.
- */
-export { createDelegateTool } from './delegate';
-//# sourceMappingURL=index.js.map