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

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

@@ -0,0 +1,83 @@
+/**
+ * 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

@@ -0,0 +1,124 @@
+/**
+ * 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

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

package/dist/esm/tools/delegate.js

@@ -0,0 +1,57 @@
+/**
+ * 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

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