maestro-flow 0.1.4 → 0.2.0

package/dist/src/tools/write-file.js

@@ -0,0 +1,165 @@
+/**
+ * Write File Tool - Create or overwrite files
+ *
+ * Features:
+ * - Create new files or overwrite existing
+ * - Auto-create parent directories
+ * - Support for text content with proper encoding
+ * - Optional backup before overwrite
+ */
+import { z } from 'zod';
+import { writeFileSync, readFileSync, existsSync, mkdirSync, statSync } from 'fs';
+import { resolve, dirname, basename } from 'path';
+import { validatePath } from '../utils/path-validator.js';
+const ParamsSchema = z.object({
+    path: z.string().min(1, 'Path is required'),
+    content: z.string(),
+    createDirectories: z.boolean().default(true),
+    backup: z.boolean().default(false),
+    encoding: z.enum(['utf8', 'utf-8', 'ascii', 'latin1', 'binary', 'hex', 'base64']).default('utf8'),
+});
+function ensureDir(filePath) {
+    const dir = dirname(filePath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+function createBackup(filePath) {
+    if (!existsSync(filePath)) {
+        return null;
+    }
+    const dir = dirname(filePath);
+    const name = basename(filePath);
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const backupPath = resolve(dir, `.${name}.${timestamp}.bak`);
+    try {
+        const content = readFileSync(filePath);
+        writeFileSync(backupPath, content);
+        return backupPath;
+    }
+    catch (error) {
+        throw new Error(`Failed to create backup: ${error.message}`);
+    }
+}
+function verifyFileWrite(filePath, expectedBytes, encoding) {
+    if (!existsSync(filePath)) {
+        return `File verification failed: file does not exist at ${filePath}`;
+    }
+    try {
+        const stats = statSync(filePath);
+        if (stats.size !== expectedBytes) {
+            return `File verification failed: size mismatch (expected ${expectedBytes}B, actual ${stats.size}B)`;
+        }
+        const readContent = readFileSync(filePath, { encoding });
+        const actualBytes = Buffer.byteLength(readContent, encoding);
+        if (actualBytes !== expectedBytes) {
+            return `File verification failed: content size mismatch after read (expected ${expectedBytes}B, read ${actualBytes}B)`;
+        }
+        return null;
+    }
+    catch (error) {
+        return `File verification failed: ${error.message}`;
+    }
+}
+export const schema = {
+    name: 'write_file',
+    description: `Write content to file. Auto-creates parent directories.
+
+Required: path (string), content (string)
+Options: backup=true, createDirectories=false, encoding="utf8"`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            path: {
+                type: 'string',
+                description: 'Path to the file to create or overwrite',
+            },
+            content: {
+                type: 'string',
+                description: 'Content to write to the file',
+            },
+            createDirectories: {
+                type: 'boolean',
+                description: 'Create parent directories if they do not exist (default: true)',
+                default: true,
+            },
+            backup: {
+                type: 'boolean',
+                description: 'Create backup of existing file before overwriting (default: false)',
+                default: false,
+            },
+            encoding: {
+                type: 'string',
+                description: 'File encoding (default: utf8)',
+                default: 'utf8',
+                enum: ['utf8', 'utf-8', 'ascii', 'latin1', 'binary', 'hex', 'base64'],
+            },
+        },
+        required: ['path', 'content'],
+    },
+};
+export async function handler(params) {
+    const parsed = ParamsSchema.safeParse(params);
+    if (!parsed.success) {
+        return { success: false, error: `Invalid params: ${parsed.error.message}` };
+    }
+    const { path: filePath, content, createDirectories, backup, encoding, } = parsed.data;
+    const resolvedPath = await validatePath(filePath);
+    const fileExists = existsSync(resolvedPath);
+    if (createDirectories) {
+        ensureDir(resolvedPath);
+    }
+    else if (!existsSync(dirname(resolvedPath))) {
+        return {
+            success: false,
+            error: `Parent directory does not exist: ${dirname(resolvedPath)}`,
+        };
+    }
+    let backupPath = null;
+    if (backup && fileExists) {
+        try {
+            backupPath = createBackup(resolvedPath);
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error.message,
+            };
+        }
+    }
+    try {
+        writeFileSync(resolvedPath, content, { encoding });
+        const bytes = Buffer.byteLength(content, encoding);
+        const verificationError = verifyFileWrite(resolvedPath, bytes, encoding);
+        if (verificationError) {
+            return {
+                success: false,
+                error: verificationError,
+            };
+        }
+        let message;
+        if (fileExists) {
+            message = backupPath
+                ? `Overwrote (${bytes}B, backup: ${basename(backupPath)}) - verified`
+                : `Overwrote (${bytes}B) - verified`;
+        }
+        else {
+            message = `Created (${bytes}B) - verified`;
+        }
+        return {
+            success: true,
+            result: {
+                path: resolvedPath,
+                bytes,
+                message,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: `Failed to write file: ${error.message}`,
+        };
+    }
+}
+//# sourceMappingURL=write-file.js.map

package/dist/src/tools/write-file.js.map

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

package/dist/src/types/index.d.ts

@@ -0,0 +1,75 @@
+import type { WorkflowHookRegistry } from '../hooks/workflow-hooks.js';
+export interface SpecInjectionConfig {
+    /** Override default agent-type → spec categories mapping */
+    mapping?: Record<string, {
+        categories: string[];
+        extras?: string[];
+    }>;
+    /** Files to always inject regardless of agent type */
+    always?: string[];
+    /** Max chars before truncation kicks in */
+    maxContentLength?: number;
+}
+export interface MaestroConfig {
+    version: string;
+    extensions: ExtensionConfig[];
+    mcp: McpConfig;
+    workflows: WorkflowConfig;
+    hooks?: HooksConfig;
+    specInjection?: SpecInjectionConfig;
+}
+export interface ExtensionConfig {
+    name: string;
+    enabled: boolean;
+    path: string;
+    config?: Record<string, unknown>;
+}
+export interface McpConfig {
+    port: number;
+    host: string;
+    enabledTools: string[];
+}
+export interface WorkflowConfig {
+    templatesDir: string;
+    workflowsDir: string;
+}
+export interface Tool {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    handler: (input: Record<string, unknown>) => Promise<ToolResult>;
+}
+export interface ToolResult {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+}
+export interface Extension {
+    name: string;
+    version: string;
+    tools?: Tool[];
+    activate: (ctx: ExtensionContext) => Promise<void>;
+    deactivate?: () => Promise<void>;
+}
+export interface ExtensionContext {
+    registerTool: (tool: Tool) => void;
+    config: Record<string, unknown>;
+    log: (msg: string) => void;
+}
+export interface MaestroPlugin {
+    name: string;
+    apply(registry: WorkflowHookRegistry): void;
+}
+export interface ExternalHookConfig {
+    event: string;
+    command: string;
+    timeout_ms?: number;
+}
+export interface HooksConfig {
+    toggles: Record<string, boolean>;
+    external: ExternalHookConfig[];
+    plugins: string[];
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/src/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEvE,MAAM,WAAW,mBAAmB;IAClC,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACtE,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,GAAG,EAAE,SAAS,CAAC;IACf,SAAS,EAAE,cAAc,CAAC;IAC1B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACrC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,QAAQ,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5B;AAMD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB"}

package/dist/src/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/src/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/src/types/tool-schema.d.ts

@@ -0,0 +1,37 @@
+/**
+ * CCW-style Tool Schema & Result types
+ *
+ * Used by ported CCW tools that follow the { schema, handler } export pattern.
+ * The adapter function converts CCW ToolResult → maestro ToolResult.
+ */
+export interface ToolSchema {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+export interface CcwToolResult<T = unknown> {
+    success: boolean;
+    result?: T;
+    error?: string;
+}
+export type CcwToolHandler<TParams = Record<string, unknown>, TResult = unknown> = (params: TParams) => Promise<CcwToolResult<TResult>>;
+export interface CcwToolRegistration<TParams = Record<string, unknown>> {
+    schema: ToolSchema;
+    handler: CcwToolHandler<TParams>;
+}
+export interface McpToolResult {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/**
+ * Convert CCW-style ToolResult to maestro MCP ToolResult
+ */
+export declare function ccwResultToMcp(ccwResult: CcwToolResult): McpToolResult;
+//# sourceMappingURL=tool-schema.d.ts.map

package/dist/src/types/tool-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schema.d.ts","sourceRoot":"","sources":["../../../src/types/tool-schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAGD,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,CAAC,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAGD,MAAM,MAAM,cAAc,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,IAC7E,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AAGvD,MAAM,WAAW,mBAAmB,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACpE,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;CAClC;AAGD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,aAAa,GAAG,aAAa,CAYtE"}

package/dist/src/types/tool-schema.js

@@ -0,0 +1,24 @@
+/**
+ * CCW-style Tool Schema & Result types
+ *
+ * Used by ported CCW tools that follow the { schema, handler } export pattern.
+ * The adapter function converts CCW ToolResult → maestro ToolResult.
+ */
+/**
+ * Convert CCW-style ToolResult to maestro MCP ToolResult
+ */
+export function ccwResultToMcp(ccwResult) {
+    if (ccwResult.success) {
+        const text = typeof ccwResult.result === 'string'
+            ? ccwResult.result
+            : JSON.stringify(ccwResult.result, null, 2);
+        return { content: [{ type: 'text', text }] };
+    }
+    else {
+        return {
+            content: [{ type: 'text', text: ccwResult.error || 'Unknown error' }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=tool-schema.js.map

package/dist/src/types/tool-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schema.js","sourceRoot":"","sources":["../../../src/types/tool-schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoCH;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,SAAwB;IACrD,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,OAAO,SAAS,CAAC,MAAM,KAAK,QAAQ;YAC/C,CAAC,CAAC,SAAS,CAAC,MAAM;YAClB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC9C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAC/C,CAAC;SAAM,CAAC;QACN,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,KAAK,IAAI,eAAe,EAAE,CAAC;YACrE,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/src/utils/cli-format.d.ts

@@ -0,0 +1,51 @@
+import type { EntryLike, ExecutionMeta } from '../agents/cli-history-store.js';
+export declare function deriveExecutionStatus(meta: ExecutionMeta | null): string;
+export type DelegateJobLike = {
+    status: string;
+    metadata?: Record<string, unknown> | null;
+} | null;
+export declare function deriveDelegateStatus(meta: ExecutionMeta | null, job: DelegateJobLike): string;
+export declare function padRight(str: string, len: number): string;
+/**
+ * Collapse newlines to spaces, trim, then truncate with "...".
+ * Used by CLI table output (cli show, delegate show).
+ */
+export declare function truncate(text: string, max: number): string;
+/**
+ * Truncate without newline collapsing — just cutoff with "...".
+ * Used by channel relay notifications.
+ */
+export declare function truncateRaw(value: string, max: number): string;
+/**
+ * Truncate with ellipsis indicator for history/resume context.
+ * Uses different suffix from other truncate variants.
+ */
+export declare function truncateForHistory(s: string, max: number): string;
+export declare function readExecutionEntries(store: {
+    jsonlPathFor(execId: string): string;
+}, execId: string): EntryLike[];
+/**
+ * CLI-friendly single-line summary of a broker event.
+ * Used by `delegate status` and `delegate tail` commands.
+ */
+export declare function summarizeBrokerEventCli(event: {
+    eventId: number;
+    type: string;
+    status?: string;
+    payload: Record<string, unknown>;
+    snapshot?: unknown;
+}): string;
+/**
+ * Structured summary of a broker event (object return).
+ * Used by MCP tools (delegate_status, delegate_tail).
+ */
+export declare function summarizeBrokerEventStructured(event: {
+    eventId: number;
+    sequence: number;
+    type: string;
+    createdAt: string;
+    status?: string;
+    snapshot?: unknown;
+    payload: Record<string, unknown>;
+}): Record<string, unknown>;
+//# sourceMappingURL=cli-format.d.ts.map

package/dist/src/utils/cli-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-format.d.ts","sourceRoot":"","sources":["../../../src/utils/cli-format.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAM/E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,GAAG,MAAM,CAkBxE;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC3C,GAAG,IAAI,CAAC;AAET,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,aAAa,GAAG,IAAI,EAC1B,GAAG,EAAE,eAAe,GACnB,MAAM,CASR;AAMD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAI1D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjE;AAMD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE;IAAE,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,EAC/C,MAAM,EAAE,MAAM,GACb,SAAS,EAAE,CAkBb;AAMD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,MAAM,CAWT;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAc1B"}

package/dist/src/utils/cli-format.js

@@ -0,0 +1,126 @@
+// ---------------------------------------------------------------------------
+// Shared CLI formatting and status utilities
+// Used by cli command, delegate command, tools, delegate-control, and relay.
+// ---------------------------------------------------------------------------
+import { readFileSync } from 'node:fs';
+// ---------------------------------------------------------------------------
+// Status derivation
+// ---------------------------------------------------------------------------
+export function deriveExecutionStatus(meta) {
+    if (!meta) {
+        return 'unknown';
+    }
+    if (meta.cancelledAt) {
+        return 'cancelled';
+    }
+    if (meta.exitCode === undefined && !meta.completedAt) {
+        return 'running';
+    }
+    if (meta.exitCode === 0) {
+        return 'completed';
+    }
+    return meta.exitCode === undefined ? 'unknown' : `exit:${meta.exitCode}`;
+}
+export function deriveDelegateStatus(meta, job) {
+    if ((job?.status === 'running' || job?.status === 'queued')
+        && job.metadata
+        && typeof job.metadata.cancelRequestedAt === 'string') {
+        return 'cancelling';
+    }
+    return job?.status ?? deriveExecutionStatus(meta);
+}
+// ---------------------------------------------------------------------------
+// String formatting
+// ---------------------------------------------------------------------------
+export function padRight(str, len) {
+    return str.length >= len ? str.slice(0, len) : str + ' '.repeat(len - str.length);
+}
+/**
+ * Collapse newlines to spaces, trim, then truncate with "...".
+ * Used by CLI table output (cli show, delegate show).
+ */
+export function truncate(text, max) {
+    const oneLine = text.replace(/\n/g, ' ').trim();
+    if (oneLine.length <= max)
+        return oneLine;
+    return oneLine.slice(0, max - 3) + '...';
+}
+/**
+ * Truncate without newline collapsing — just cutoff with "...".
+ * Used by channel relay notifications.
+ */
+export function truncateRaw(value, max) {
+    if (value.length <= max)
+        return value;
+    return value.slice(0, max - 3) + '...';
+}
+/**
+ * Truncate with ellipsis indicator for history/resume context.
+ * Uses different suffix from other truncate variants.
+ */
+export function truncateForHistory(s, max) {
+    return s.length <= max ? s : s.substring(0, max) + '\u2026[truncated]';
+}
+// ---------------------------------------------------------------------------
+// Execution entry reading
+// ---------------------------------------------------------------------------
+export function readExecutionEntries(store, execId) {
+    try {
+        const raw = readFileSync(store.jsonlPathFor(execId), 'utf-8');
+        return raw
+            .split('\n')
+            .map((line) => line.trim())
+            .filter(Boolean)
+            .map((line) => {
+            try {
+                return JSON.parse(line);
+            }
+            catch {
+                return null;
+            }
+        })
+            .filter((entry) => entry !== null);
+    }
+    catch {
+        return [];
+    }
+}
+// ---------------------------------------------------------------------------
+// Broker event summarization
+// ---------------------------------------------------------------------------
+/**
+ * CLI-friendly single-line summary of a broker event.
+ * Used by `delegate status` and `delegate tail` commands.
+ */
+export function summarizeBrokerEventCli(event) {
+    const payloadSummary = typeof event.payload.summary === 'string'
+        ? event.payload.summary
+        : typeof event.payload.message === 'string'
+            ? event.payload.message
+            : null;
+    const progress = event.snapshot && typeof event.snapshot === 'object' && event.snapshot !== null
+        && 'progress' in event.snapshot && typeof event.snapshot.progress === 'number'
+        ? ` progress=${event.snapshot.progress}%`
+        : '';
+    return `${event.eventId} ${event.type}${event.status ? ` (${event.status})` : ''}${progress}${payloadSummary ? ` ${payloadSummary}` : ''}`;
+}
+/**
+ * Structured summary of a broker event (object return).
+ * Used by MCP tools (delegate_status, delegate_tail).
+ */
+export function summarizeBrokerEventStructured(event) {
+    return {
+        eventId: event.eventId,
+        sequence: event.sequence,
+        type: event.type,
+        createdAt: event.createdAt,
+        status: event.status ?? null,
+        summary: typeof event.payload.summary === 'string'
+            ? event.payload.summary
+            : typeof event.payload.message === 'string'
+                ? event.payload.message
+                : null,
+        snapshot: event.snapshot ?? null,
+    };
+}
+//# sourceMappingURL=cli-format.js.map

package/dist/src/utils/cli-format.js.map

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

package/dist/src/utils/file-reader.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Shared file reading utilities
+ *
+ * Extracted from read-file.ts for reuse across read_file and read_many_files tools.
+ */
+export declare const MAX_CONTENT_LENGTH = 5000;
+export declare const MAX_FILES = 50;
+export declare const MAX_TOTAL_CONTENT = 50000;
+export declare const BINARY_EXTENSIONS: Set<string>;
+export interface FileEntry {
+    path: string;
+    size: number;
+    content?: string;
+    truncated?: boolean;
+    matches?: string[];
+    totalLines?: number;
+    lineRange?: {
+        start: number;
+        end: number;
+    };
+}
+export interface ReadContentOptions {
+    maxLength: number;
+    offset?: number;
+    limit?: number;
+}
+export interface ReadContentResult {
+    content: string;
+    truncated: boolean;
+    totalLines?: number;
+    lineRange?: {
+        start: number;
+        end: number;
+    };
+}
+export interface ReadResult {
+    files: FileEntry[];
+    totalFiles: number;
+    message: string;
+}
+/**
+ * Check if file is likely binary
+ */
+export declare function isBinaryFile(filePath: string): boolean;
+/**
+ * Convert glob pattern to regex
+ * Supports: *, ?, and brace expansion {a,b,c}
+ */
+export declare function globToRegex(pattern: string): RegExp;
+/**
+ * Check if filename matches glob pattern
+ */
+export declare function matchesPattern(filename: string, pattern: string): boolean;
+/**
+ * Recursively collect files from directory
+ */
+export declare function collectFiles(dir: string, pattern: string | undefined, maxDepth: number, currentDepth?: number): string[];
+/**
+ * Read file content with truncation and optional line-based pagination
+ */
+export declare function readFileContent(filePath: string, options: ReadContentOptions): ReadContentResult;
+/**
+ * Find regex matches in content with safety protections
+ * - Empty string pattern = "match all" (no filtering) - returns null
+ * - Dangerous patterns (zero-width matches) = "match all" for safety - returns null
+ * - Validates pattern to prevent infinite loops
+ * - Limits iterations to prevent ReDoS attacks
+ * - Deduplicates results to prevent duplicates
+ * - Reports errors instead of silent failure
+ *
+ * @returns Array of matching lines, null to match all content (empty string or dangerous pattern), empty array for no matches
+ */
+export declare function findMatches(content: string, pattern: string): string[] | null;
+//# sourceMappingURL=file-reader.d.ts.map

package/dist/src/utils/file-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-reader.d.ts","sourceRoot":"","sources":["../../../src/utils/file-reader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,eAAO,MAAM,SAAS,KAAK,CAAC;AAE5B,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAGvC,eAAO,MAAM,iBAAiB,aAQ5B,CAAC;AAEH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGtD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAsBnD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAGzE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,QAAQ,EAAE,MAAM,EAChB,YAAY,GAAE,MAAU,GACvB,MAAM,EAAE,CA2BV;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CAkDhG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAyE7E"}