mcp-codex-subagent 1.0.0 → 2.0.5

package/dist/utils/brief-validator.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Validates spawn tool prompts and context file requirements.
+ * Ported from mcp-supersubagents/src/utils/brief-validator.ts
+ */
+export interface ContextFile {
+    path: string;
+    description?: string;
+}
+export interface BriefValidationError {
+    code: string;
+    message: string;
+    detail?: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: BriefValidationError[];
+}
+interface RoleValidationRules {
+    roleName: string;
+    minPromptLength: number;
+    requireContextFiles: boolean;
+    minContextFiles: number;
+    requireMdExtension: boolean;
+    maxFileSizeBytes: number;
+    maxTotalSizeBytes: number;
+    briefTemplate: string;
+    workflowHint: string;
+}
+export declare const VALIDATION_RULES: Record<string, RoleValidationRules>;
+export declare function validateBrief(role: string, prompt: string, contextFiles?: ContextFile[]): Promise<ValidationResult>;
+export declare function formatBriefValidationError(role: string, errors: BriefValidationError[]): string;
+export declare function assemblePromptWithContext(prompt: string, contextFiles?: ContextFile[]): Promise<string>;
+export {};
+//# sourceMappingURL=brief-validator.d.ts.map

package/dist/utils/brief-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brief-validator.d.ts","sourceRoot":"","sources":["../../src/utils/brief-validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAChC;AAED,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AA6FD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAKhE,CAAC;AAIF,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,WAAW,EAAE,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CAsG3B;AAID,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,CA4B/F;AAID,wBAAsB,yBAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA2B7G"}

package/dist/utils/brief-validator.js

@@ -0,0 +1,251 @@
+/**
+ * Validates spawn tool prompts and context file requirements.
+ * Ported from mcp-supersubagents/src/utils/brief-validator.ts
+ */
+import { access, stat, readFile, constants } from 'fs/promises';
+import { extname, isAbsolute } from 'path';
+// --- Per-role validation rules ---
+const MAX_FILE_SIZE = 200 * 1024; // 200KB per file
+const MAX_TOTAL_SIZE = 500 * 1024; // 500KB total
+const CODER_RULES = {
+    roleName: 'codex(role: "coder")',
+    minPromptLength: 1000,
+    requireContextFiles: true,
+    minContextFiles: 1,
+    requireMdExtension: true,
+    maxFileSizeBytes: MAX_FILE_SIZE,
+    maxTotalSizeBytes: MAX_TOTAL_SIZE,
+    briefTemplate: [
+        'OBJECTIVE: [What exactly to build/modify — specific deliverables, not vague goals]',
+        'FILES TO MODIFY: [ALL absolute file paths the agent needs to touch]',
+        'SUCCESS CRITERIA: [Exactly how to verify the implementation is correct]',
+        'CONSTRAINTS: [What NOT to do — boundaries, forbidden approaches, patterns to avoid]',
+        'PATTERNS TO FOLLOW: [Existing code patterns to match, utilities to reuse]',
+        'CONTEXT: [Background — why this matters, dependencies, architectural decisions]',
+    ].join('\n'),
+    workflowHint: [
+        'RECOMMENDED WORKFLOW:',
+        '1. codex(role: "researcher") → investigate unknowns',
+        '2. codex(role: "planner") → creates plan',
+        '3. codex(role: "coder") → reference plan files in context_files',
+        '4. codex(role: "tester") → verify the implementation',
+    ].join('\n'),
+};
+const PLANNER_RULES = {
+    roleName: 'codex(role: "planner")',
+    minPromptLength: 300,
+    requireContextFiles: false,
+    minContextFiles: 0,
+    requireMdExtension: false,
+    maxFileSizeBytes: MAX_FILE_SIZE,
+    maxTotalSizeBytes: MAX_TOTAL_SIZE,
+    briefTemplate: [
+        'PROBLEM STATEMENT: [What needs to be solved — the actual problem, not a solution]',
+        'CONSTRAINTS: [What\'s been ruled out, what must be preserved]',
+        'VERIFIED FACTS: [What you already know — don\'t re-investigate these]',
+        'SCOPE: [What\'s in/out of scope — be explicit]',
+        'EXPECTED OUTPUT: [What the next agent (Coder/Tester) needs from this plan]',
+    ].join('\n'),
+    workflowHint: [
+        'TIP: Use planner output as context_files when spawning codex(role: "coder") next.',
+    ].join('\n'),
+};
+const TESTER_RULES = {
+    roleName: 'codex(role: "tester")',
+    minPromptLength: 300,
+    requireContextFiles: true,
+    minContextFiles: 1,
+    requireMdExtension: false,
+    maxFileSizeBytes: MAX_FILE_SIZE,
+    maxTotalSizeBytes: MAX_TOTAL_SIZE,
+    briefTemplate: [
+        'WHAT WAS BUILT: [Feature/fix to verify — specific deliverable]',
+        'FILES CHANGED: [Where to focus testing — absolute paths]',
+        'SUCCESS CRITERIA: [What "working" means — specific, testable conditions]',
+        'TEST SUGGESTIONS: [Specific flows to test — happy path + edge cases]',
+        'EDGE CASES: [What the coder is worried about — potential failure points]',
+        'BASE URL / SETUP: [How to access the system under test]',
+    ].join('\n'),
+    workflowHint: [
+        'TIP: Reference coder output files as context_files for the tester.',
+    ].join('\n'),
+};
+const RESEARCHER_RULES = {
+    roleName: 'codex(role: "researcher")',
+    minPromptLength: 200,
+    requireContextFiles: false,
+    minContextFiles: 0,
+    requireMdExtension: false,
+    maxFileSizeBytes: MAX_FILE_SIZE,
+    maxTotalSizeBytes: MAX_TOTAL_SIZE,
+    briefTemplate: [
+        'WHAT TO RESEARCH: [Specific topic or question — not vague "research X"]',
+        'WHY IT MATTERS: [What decision this research informs]',
+        'WHAT\'S ALREADY KNOWN: [Don\'t re-research verified facts]',
+        'SPECIFIC QUESTIONS: [2-5 pointed, answerable questions]',
+        'HANDOFF TARGET: [Who reads the output — Planner? Coder? Human?]',
+    ].join('\n'),
+    workflowHint: [
+        'TIP: Reference research output when spawning codex(role: "planner") or codex(role: "coder") next.',
+    ].join('\n'),
+};
+export const VALIDATION_RULES = {
+    coder: CODER_RULES,
+    planner: PLANNER_RULES,
+    tester: TESTER_RULES,
+    researcher: RESEARCHER_RULES,
+};
+// --- Validation functions ---
+export async function validateBrief(role, prompt, contextFiles) {
+    const rules = VALIDATION_RULES[role];
+    if (!rules)
+        return { valid: true, errors: [] };
+    const errors = [];
+    // 1. Prompt length check
+    if (prompt.length < rules.minPromptLength) {
+        errors.push({
+            code: 'PROMPT_TOO_SHORT',
+            message: `PROMPT TOO SHORT: ${prompt.length} characters (MINIMUM: ${rules.minPromptLength})`,
+            detail: `Your prompt MUST include these sections:\n${rules.briefTemplate}`,
+        });
+    }
+    // 2. Context files required check
+    const files = contextFiles || [];
+    if (rules.requireContextFiles && files.length < rules.minContextFiles) {
+        errors.push({
+            code: 'MISSING_CONTEXT_FILES',
+            message: `MISSING CONTEXT FILES: ${rules.roleName} REQUIRES at least ${rules.minContextFiles} file(s)`,
+            detail: rules.requireMdExtension
+                ? 'Attach Markdown files (.md) — plan documents, specifications, or research findings.\nEach file must have an absolute path ending with .md'
+                : 'Attach relevant files — code, handoff documents, or specifications.\nEach file must have an absolute path.',
+        });
+    }
+    // 3. Validate each context file
+    let totalSize = 0;
+    for (const file of files) {
+        // Absolute path check
+        if (!isAbsolute(file.path)) {
+            errors.push({
+                code: 'RELATIVE_PATH',
+                message: `RELATIVE PATH: "${file.path}" — paths MUST be absolute (start with /)`,
+                detail: `Use the full absolute path, e.g. /Users/dev/project/${file.path}`,
+            });
+            continue;
+        }
+        // .md extension check (coder only)
+        if (rules.requireMdExtension && extname(file.path).toLowerCase() !== '.md') {
+            errors.push({
+                code: 'NOT_MARKDOWN',
+                message: `NOT A MARKDOWN FILE: "${file.path}" — ${rules.roleName} requires .md files`,
+                detail: 'Context files for the coder MUST be Markdown (.md) plan/specification documents.',
+            });
+            continue;
+        }
+        // File existence and readability check
+        try {
+            await access(file.path, constants.R_OK);
+        }
+        catch (err) {
+            const code = err?.code;
+            if (code === 'ENOENT') {
+                errors.push({
+                    code: 'FILE_NOT_FOUND',
+                    message: `FILE NOT FOUND: "${file.path}" does not exist`,
+                    detail: 'Ensure the file path is correct and the file has been created.',
+                });
+            }
+            else {
+                errors.push({
+                    code: 'FILE_NOT_READABLE',
+                    message: `FILE NOT READABLE: "${file.path}" exists but cannot be read`,
+                    detail: 'Check file permissions. The MCP server needs read access to this file.',
+                });
+            }
+            continue;
+        }
+        // Size check
+        try {
+            const fileStat = await stat(file.path);
+            if (fileStat.size > rules.maxFileSizeBytes) {
+                errors.push({
+                    code: 'FILE_TOO_LARGE',
+                    message: `FILE TOO LARGE: "${file.path}" is ${Math.round(fileStat.size / 1024)}KB (max: ${Math.round(rules.maxFileSizeBytes / 1024)}KB)`,
+                });
+                continue;
+            }
+            totalSize += fileStat.size;
+        }
+        catch (err) {
+            errors.push({
+                code: 'FILE_STAT_FAILED',
+                message: `FILE STAT FAILED: "${file.path}" — ${err instanceof Error ? err.message : 'unknown error'}`,
+                detail: 'The file exists but its metadata could not be read.',
+            });
+            continue;
+        }
+    }
+    // Total size check
+    if (totalSize > rules.maxTotalSizeBytes) {
+        errors.push({
+            code: 'TOTAL_SIZE_EXCEEDED',
+            message: `TOTAL FILE SIZE EXCEEDED: ${Math.round(totalSize / 1024)}KB (max: ${Math.round(rules.maxTotalSizeBytes / 1024)}KB)`,
+            detail: 'Reduce the number of context files or use smaller files.',
+        });
+    }
+    return { valid: errors.length === 0, errors };
+}
+// --- Error message formatting ---
+export function formatBriefValidationError(role, errors) {
+    const rules = VALIDATION_RULES[role];
+    if (!rules)
+        return errors.map(e => e.message).join('\n');
+    const parts = [
+        `❌ **VALIDATION FAILED — ${rules.roleName}**`,
+        '',
+        '**ISSUES FOUND:**',
+    ];
+    for (const err of errors) {
+        parts.push(`• **${err.message}**`);
+        if (err.detail) {
+            for (const line of err.detail.split('\n')) {
+                parts.push(`  ${line}`);
+            }
+        }
+    }
+    parts.push('');
+    parts.push('**HOW TO FIX — Follow this brief template:**');
+    parts.push('```');
+    parts.push(rules.briefTemplate);
+    parts.push('```');
+    parts.push('');
+    parts.push(rules.workflowHint);
+    return parts.join('\n');
+}
+// --- Context file content assembly ---
+export async function assemblePromptWithContext(prompt, contextFiles) {
+    if (!contextFiles || contextFiles.length === 0)
+        return prompt;
+    const sections = [prompt, '', '---', '', '## ATTACHED CONTEXT FILES', ''];
+    for (const file of contextFiles) {
+        sections.push(`### File: ${file.path}`);
+        if (file.description) {
+            sections.push(`> ${file.description}`);
+        }
+        sections.push('');
+        try {
+            const content = await readFile(file.path, 'utf-8');
+            const truncated = content.length > MAX_FILE_SIZE
+                ? content.slice(0, MAX_FILE_SIZE) + '\n\n[... TRUNCATED — file exceeds 200KB limit ...]'
+                : content;
+            sections.push('```');
+            sections.push(truncated);
+            sections.push('```');
+        }
+        catch {
+            sections.push('> Could not read file contents');
+        }
+        sections.push('');
+    }
+    return sections.join('\n');
+}
+//# sourceMappingURL=brief-validator.js.map

package/dist/utils/brief-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brief-validator.js","sourceRoot":"","sources":["../../src/utils/brief-validator.ts"],"names":[],"mappings":"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"}

package/dist/utils/format.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Shared formatting helpers for converting MCP tool responses to markdown.
+ * Ported from mcp-supersubagents/src/utils/format.ts
+ */
+/** Wraps a markdown string in the MCP response shape. */
+export declare function mcpText(markdown: string): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+};
+/** Display status in human-readable form: "rate_limited" -> "rate limited" */
+export declare function displayStatus(status: string): string;
+/** Standard error block with optional actionable hint. */
+export declare function formatError(error: string, hint?: string): string;
+/** MCP-compliant validation error response with isError: true. */
+export declare function mcpValidationError(markdown: string): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError: true;
+};
+/** MCP-compliant error response with optional actionable hint. */
+export declare function mcpError(error: string, hint?: string): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError: true;
+};
+/** Render a markdown table from headers and rows. */
+export declare function formatTable(headers: string[], rows: string[][]): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,yDAAyD;AACzD,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAE5F;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,0DAA0D;AAC1D,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAIhE;AAED,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,CAEtH;AAED,kEAAkE;AAClE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,CAGxH;AAOD,qDAAqD;AACrD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAKvE"}

package/dist/utils/format.js

@@ -0,0 +1,40 @@
+/**
+ * Shared formatting helpers for converting MCP tool responses to markdown.
+ * Ported from mcp-supersubagents/src/utils/format.ts
+ */
+/** Wraps a markdown string in the MCP response shape. */
+export function mcpText(markdown) {
+    return { content: [{ type: 'text', text: markdown }] };
+}
+/** Display status in human-readable form: "rate_limited" -> "rate limited" */
+export function displayStatus(status) {
+    return status.replace(/_/g, ' ');
+}
+/** Standard error block with optional actionable hint. */
+export function formatError(error, hint) {
+    const parts = [`**Error:** ${error}`];
+    if (hint)
+        parts.push('', hint);
+    return parts.join('\n');
+}
+/** MCP-compliant validation error response with isError: true. */
+export function mcpValidationError(markdown) {
+    return { content: [{ type: 'text', text: markdown }], isError: true };
+}
+/** MCP-compliant error response with optional actionable hint. */
+export function mcpError(error, hint) {
+    const text = hint ? `**Error:** ${error}\n\n${hint}` : `**Error:** ${error}`;
+    return { content: [{ type: 'text', text }], isError: true };
+}
+/** Escape pipe characters in table cell content. */
+function escapeCell(value) {
+    return value.replace(/\|/g, '\\|');
+}
+/** Render a markdown table from headers and rows. */
+export function formatTable(headers, rows) {
+    const headerRow = `| ${headers.map(escapeCell).join(' | ')} |`;
+    const separator = `|${headers.map(() => '------').join('|')}|`;
+    const dataRows = rows.map(r => `| ${r.map(escapeCell).join(' | ')} |`);
+    return [headerRow, separator, ...dataRows].join('\n');
+}
+//# sourceMappingURL=format.js.map

package/dist/utils/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,yDAAyD;AACzD,MAAM,UAAU,OAAO,CAAC,QAAgB;IACtC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;AAClE,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACnC,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,IAAa;IACtD,MAAM,KAAK,GAAG,CAAC,cAAc,KAAK,EAAE,CAAC,CAAC;IACtC,IAAI,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC/B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,IAAa,EAAE,CAAC;AAC1F,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,IAAa;IACnD,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,cAAc,KAAK,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,cAAc,KAAK,EAAE,CAAC;IAC7E,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,IAAa,EAAE,CAAC;AAChF,CAAC;AAED,oDAAoD;AACpD,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACrC,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,WAAW,CAAC,OAAiB,EAAE,IAAgB;IAC7D,MAAM,SAAS,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IAC/D,MAAM,SAAS,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvE,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxD,CAAC"}

package/dist/utils/task-id-generator.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Generates human-readable task IDs like "brave-tiger-42".
+ * Ported from mcp-supersubagents/src/utils/task-id-generator.ts
+ * Uses inline word lists to avoid external dependency.
+ */
+/**
+ * Generates human-readable task IDs like "brave-tiger-42" or "cosmic-falcon-17".
+ * Much easier to remember and communicate than UUIDs.
+ */
+export declare function generateTaskId(): string;
+/**
+ * Normalizes task ID for case-insensitive lookups.
+ */
+export declare function normalizeTaskId(taskId: string): string;
+//# sourceMappingURL=task-id-generator.d.ts.map

package/dist/utils/task-id-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-id-generator.d.ts","sourceRoot":"","sources":["../../src/utils/task-id-generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA4BH;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAKvC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/dist/utils/task-id-generator.js

@@ -0,0 +1,45 @@
+/**
+ * Generates human-readable task IDs like "brave-tiger-42".
+ * Ported from mcp-supersubagents/src/utils/task-id-generator.ts
+ * Uses inline word lists to avoid external dependency.
+ */
+const ADJECTIVES = [
+    'brave', 'calm', 'clever', 'cosmic', 'daring', 'eager', 'fast', 'gentle',
+    'happy', 'keen', 'lively', 'mighty', 'noble', 'proud', 'quick', 'sharp',
+    'silent', 'smooth', 'steady', 'swift', 'bold', 'bright', 'cool', 'crisp',
+    'dark', 'deep', 'fair', 'fierce', 'free', 'grand', 'green', 'iron',
+    'jade', 'kind', 'light', 'loud', 'neat', 'pale', 'prime', 'pure',
+    'rare', 'rich', 'safe', 'slim', 'soft', 'true', 'vast', 'warm',
+    'wild', 'wise', 'young', 'zinc', 'able', 'agile', 'amber', 'azure',
+    'coral', 'gold', 'ivory', 'lunar', 'neon', 'opal', 'plum', 'ruby',
+];
+const ANIMALS = [
+    'tiger', 'falcon', 'wolf', 'eagle', 'fox', 'hawk', 'bear', 'lion',
+    'shark', 'cobra', 'lynx', 'orca', 'raven', 'viper', 'crane', 'horse',
+    'panda', 'otter', 'bison', 'whale', 'stork', 'finch', 'heron', 'ibis',
+    'koala', 'lemur', 'moose', 'newt', 'okapi', 'quail', 'robin', 'snail',
+    'trout', 'gecko', 'hound', 'jaguar', 'manta', 'owl', 'pike', 'seal',
+    'swan', 'toad', 'wren', 'yak', 'zebu', 'ant', 'bat', 'cat',
+    'deer', 'dove', 'duck', 'elk', 'frog', 'goat', 'gull', 'hare',
+    'kite', 'lark', 'mole', 'moth', 'ox', 'parrot', 'ram', 'slug',
+];
+function pick(arr) {
+    return arr[Math.floor(Math.random() * arr.length)];
+}
+/**
+ * Generates human-readable task IDs like "brave-tiger-42" or "cosmic-falcon-17".
+ * Much easier to remember and communicate than UUIDs.
+ */
+export function generateTaskId() {
+    const adj = pick(ADJECTIVES);
+    const animal = pick(ANIMALS);
+    const num = Math.floor(Math.random() * 100);
+    return `${adj}-${animal}-${num}`;
+}
+/**
+ * Normalizes task ID for case-insensitive lookups.
+ */
+export function normalizeTaskId(taskId) {
+    return taskId.toLowerCase().trim();
+}
+//# sourceMappingURL=task-id-generator.js.map

package/dist/utils/task-id-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-id-generator.js","sourceRoot":"","sources":["../../src/utils/task-id-generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,UAAU,GAAG;IACjB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ;IACxE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO;IACvE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO;IACxE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM;IAClE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAChE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9D,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO;IAClE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAClE,CAAC;AAEF,MAAM,OAAO,GAAG;IACd,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IACjE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO;IACpE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM;IACrE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO;IACrE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM;IACnE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;IAC1D,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC7D,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM;CAC9D,CAAC;AAEF,SAAS,IAAI,CAAI,GAAQ;IACvB,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;IAC5C,OAAO,GAAG,GAAG,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;AACrC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-codex-subagent",
-  "version": "1.0.0",
+  "version": "2.0.5",
   "description": "MCP server for OpenAI Codex CLI with role-based templates, specialization overlays, and context file injection",
   "main": "dist/index.js",
   "bin": {
@@ -12,19 +12,6 @@
   "directories": {
     "doc": "docs"
   },
-  "scripts": {
-    "build": "tsc && mkdir -p dist/templates/overlays && cp src/templates/*.mdx dist/templates/ && cp src/templates/overlays/*.mdx dist/templates/overlays/",
-    "start": "node dist/index.js",
-    "dev": "tsx src/index.ts",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage",
-    "lint": "eslint src/**/*.ts",
-    "lint:fix": "eslint src/**/*.ts --fix",
-    "format": "prettier --write src/**/*.ts",
-    "format:check": "prettier --check src/**/*.ts",
-    "clean": "rm -rf dist"
-  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/yigitkonur/mcp-codex-subagent.git"
@@ -66,5 +53,18 @@
     "ts-jest": "^29.4.1",
     "tsx": "^4.20.4",
     "typescript": "^5.9.2"
+  },
+  "scripts": {
+    "build": "tsc && mkdir -p dist/templates/overlays && cp src/templates/*.mdx dist/templates/ && cp src/templates/overlays/*.mdx dist/templates/overlays/",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "format": "prettier --write src/**/*.ts",
+    "format:check": "prettier --check src/**/*.ts",
+    "clean": "rm -rf dist"
   }
-}
+}