maestro-flow 0.1.4 → 0.2.0

package/dashboard/dist-server/src/hooks/constants.d.ts

@@ -0,0 +1,39 @@
+/** Remaining context % at which WARNING is emitted */
+export declare const WARNING_THRESHOLD = 35;
+/** Remaining context % at which CRITICAL is emitted */
+export declare const CRITICAL_THRESHOLD = 25;
+/** Ignore bridge metrics older than this (seconds) */
+export declare const STALE_SECONDS = 60;
+/** Minimum tool uses between repeated warnings */
+export declare const DEBOUNCE_CALLS = 5;
+/** Claude Code reserves ~16.5% for autocompact buffer */
+export declare const AUTO_COMPACT_BUFFER_PCT = 16.5;
+/** Bridge file prefix in os.tmpdir() */
+export declare const BRIDGE_PREFIX = "maestro-ctx-";
+/** Delegate notification file prefix in os.tmpdir() */
+export declare const NOTIFY_PREFIX = "maestro-notify-";
+/** Max ms to wait for stdin before exiting (Windows pipe safety) */
+export declare const STDIN_TIMEOUT_MS = 3000;
+/**
+ * ASCII faces by severity level.
+ *
+ *   ^_^  — plenty of context (used < 50%)
+ *   -_-  — getting used      (used 50–65%)
+ *   O_O  — running low       (used 65–80%)
+ *   X_X  — critical          (used >= 80%)
+ */
+export declare const FACES: {
+    readonly happy: "^_^";
+    readonly neutral: "-_-";
+    readonly alert: "O_O";
+    readonly critical: "X_X";
+};
+export type FaceLevel = keyof typeof FACES;
+/** Map used% to face level */
+export declare function getFaceLevel(usedPct: number): FaceLevel;
+/** ANSI color codes by face level */
+export declare const FACE_COLORS: Record<FaceLevel, string>;
+export declare const ANSI_RESET = "\u001B[0m";
+export declare const ANSI_DIM = "\u001B[2m";
+export declare const ANSI_BOLD = "\u001B[1m";
+export declare const ANSI_CYAN = "\u001B[36m";

package/dashboard/dist-server/src/hooks/constants.js

@@ -0,0 +1,53 @@
+// Shared constants for maestro hooks
+/** Remaining context % at which WARNING is emitted */
+export const WARNING_THRESHOLD = 35;
+/** Remaining context % at which CRITICAL is emitted */
+export const CRITICAL_THRESHOLD = 25;
+/** Ignore bridge metrics older than this (seconds) */
+export const STALE_SECONDS = 60;
+/** Minimum tool uses between repeated warnings */
+export const DEBOUNCE_CALLS = 5;
+/** Claude Code reserves ~16.5% for autocompact buffer */
+export const AUTO_COMPACT_BUFFER_PCT = 16.5;
+/** Bridge file prefix in os.tmpdir() */
+export const BRIDGE_PREFIX = 'maestro-ctx-';
+/** Delegate notification file prefix in os.tmpdir() */
+export const NOTIFY_PREFIX = 'maestro-notify-';
+/** Max ms to wait for stdin before exiting (Windows pipe safety) */
+export const STDIN_TIMEOUT_MS = 3000;
+/**
+ * ASCII faces by severity level.
+ *
+ *   ^_^  — plenty of context (used < 50%)
+ *   -_-  — getting used      (used 50–65%)
+ *   O_O  — running low       (used 65–80%)
+ *   X_X  — critical          (used >= 80%)
+ */
+export const FACES = {
+    happy: '^_^',
+    neutral: '-_-',
+    alert: 'O_O',
+    critical: 'X_X',
+};
+/** Map used% to face level */
+export function getFaceLevel(usedPct) {
+    if (usedPct < 50)
+        return 'happy';
+    if (usedPct < 65)
+        return 'neutral';
+    if (usedPct < 80)
+        return 'alert';
+    return 'critical';
+}
+/** ANSI color codes by face level */
+export const FACE_COLORS = {
+    happy: '\x1b[32m', // green
+    neutral: '\x1b[33m', // yellow
+    alert: '\x1b[38;5;208m', // orange
+    critical: '\x1b[5;31m', // blinking red
+};
+export const ANSI_RESET = '\x1b[0m';
+export const ANSI_DIM = '\x1b[2m';
+export const ANSI_BOLD = '\x1b[1m';
+export const ANSI_CYAN = '\x1b[36m';
+//# sourceMappingURL=constants.js.map

package/dashboard/dist-server/src/hooks/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/hooks/constants.ts"],"names":[],"mappings":"AAAA,qCAAqC;AAErC,sDAAsD;AACtD,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAEpC,uDAAuD;AACvD,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAErC,sDAAsD;AACtD,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAEhC,kDAAkD;AAClD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAEhC,yDAAyD;AACzD,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAE5C,wCAAwC;AACxC,MAAM,CAAC,MAAM,aAAa,GAAG,cAAc,CAAC;AAE5C,uDAAuD;AACvD,MAAM,CAAC,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAE/C,oEAAoE;AACpE,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAErC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,KAAK,EAAK,KAAK;IACf,OAAO,EAAG,KAAK;IACf,KAAK,EAAK,KAAK;IACf,QAAQ,EAAE,KAAK;CACP,CAAC;AAIX,8BAA8B;AAC9B,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,OAAO,CAAC;IACjC,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,SAAS,CAAC;IACnC,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,OAAO,CAAC;IACjC,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,qCAAqC;AACrC,MAAM,CAAC,MAAM,WAAW,GAA8B;IACpD,KAAK,EAAK,UAAU,EAAQ,QAAQ;IACpC,OAAO,EAAG,UAAU,EAAQ,SAAS;IACrC,KAAK,EAAK,gBAAgB,EAAE,SAAS;IACrC,QAAQ,EAAE,YAAY,EAAM,eAAe;CAC5C,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC;AACpC,MAAM,CAAC,MAAM,QAAQ,GAAG,SAAS,CAAC;AAClC,MAAM,CAAC,MAAM,SAAS,GAAG,SAAS,CAAC;AACnC,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,CAAC"}

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

@@ -0,0 +1,50 @@
+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>;

package/dashboard/dist-server/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/dashboard/dist-server/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/agents/cli-agent-runner.d.ts

@@ -1,3 +1,102 @@
+import { type DelegateBrokerApi } from '../async/index.js';
+type AgentType = 'claude-code' | 'codex' | 'codex-server' | 'gemini' | 'gemini-a2a' | 'qwen' | 'opencode';
+type AgentProcessStatus = 'spawning' | 'running' | 'paused' | 'stopping' | 'stopped' | 'error';
+interface AgentConfig {
+    type: AgentType;
+    prompt: string;
+    workDir: string;
+    env?: Record<string, string>;
+    model?: string;
+    approvalMode?: 'suggest' | 'auto';
+    interactive?: boolean;
+}
+interface AgentProcess {
+    id: string;
+    type: AgentType;
+    status: AgentProcessStatus;
+    config: AgentConfig;
+    startedAt: string;
+    pid?: number;
+}
+interface NormalizedEntryBase {
+    id: string;
+    processId: string;
+    timestamp: string;
+}
+type NormalizedEntry = (NormalizedEntryBase & {
+    type: 'user_message';
+    content: string;
+}) | (NormalizedEntryBase & {
+    type: 'assistant_message';
+    content: string;
+    partial: boolean;
+}) | (NormalizedEntryBase & {
+    type: 'thinking';
+    content: string;
+}) | (NormalizedEntryBase & {
+    type: 'tool_use';
+    name: string;
+    input: Record<string, unknown>;
+    status: string;
+    result?: string;
+}) | (NormalizedEntryBase & {
+    type: 'file_change';
+    path: string;
+    action: string;
+    diff?: string;
+}) | (NormalizedEntryBase & {
+    type: 'command_exec';
+    command: string;
+    exitCode?: number;
+    output?: string;
+}) | (NormalizedEntryBase & {
+    type: 'approval_request';
+    toolName: string;
+    toolInput: Record<string, unknown>;
+    requestId: string;
+}) | (NormalizedEntryBase & {
+    type: 'approval_response';
+    requestId: string;
+    allowed: boolean;
+}) | (NormalizedEntryBase & {
+    type: 'error';
+    message: string;
+    code?: string;
+}) | (NormalizedEntryBase & {
+    type: 'status_change';
+    status: AgentProcessStatus;
+    reason?: string;
+}) | (NormalizedEntryBase & {
+    type: 'token_usage';
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+});
+/** Minimal adapter interface matching BaseAgentAdapter's public surface */
+interface AdapterLike {
+    spawn(config: AgentConfig): Promise<AgentProcess>;
+    stop(processId: string): Promise<void>;
+    onEntry(processId: string, cb: (entry: NormalizedEntry) => void): () => void;
+    sendMessage?(processId: string, content: string): Promise<void>;
+    supportsInteractive?(): boolean;
+    endInput?(processId: string): void;
+}
+interface DashboardBridgeLike {
+    tryConnect(url: string, timeoutMs?: number): Promise<boolean>;
+    forwardSpawn(process: unknown): void;
+    forwardEntry(entry: unknown): void;
+    forwardStopped(processId: string): void;
+    close(): void;
+}
+export interface CliAgentRunnerDependencies {
+    brokerClient?: DelegateBrokerApi;
+    createAdapter?: (agentType: AgentType, backend?: 'direct' | 'terminal') => Promise<AdapterLike>;
+    createBridge?: () => DashboardBridgeLike;
+    spawnDetachedDelegate?: (options: CliRunOptions, execId: string, prompt: string) => boolean;
+    now?: () => string;
+    renderEntry?: (entry: NormalizedEntry) => void;
+}
 export interface CliRunOptions {
     prompt: string;
     tool: string;
@@ -8,13 +107,25 @@ export interface CliRunOptions {
     execId?: string;
     resume?: string;
     includeDirs?: string[];
+    sessionId?: string;
+    backend?: 'direct' | 'terminal';
 }
+export declare function generateCliExecId(tool: string): string;
 export declare class CliAgentRunner {
+    private readonly dependencies;
+    constructor(dependencies?: CliAgentRunnerDependencies);
     /** Resolve dashboard WS URL from env → config → default port 3001 */
     private static getDashboardWsUrl;
+    /**
+     * Send MCP channel notification (primary path).
+     * If maestro MCP server is running in this process, push a
+     * notifications/claude/channel message directly.
+     */
+    private static sendChannelNotification;
     /**
      * Run a CLI agent to completion and return its exit code (0 = success).
      */
     run(options: CliRunOptions): Promise<number>;
 }
+export {};
 //# sourceMappingURL=cli-agent-runner.d.ts.map

package/dist/agents/cli-agent-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-agent-runner.d.ts","sourceRoot":"","sources":["../../src/agents/cli-agent-runner.ts"],"names":[],"mappings":"AA6EA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAoKD,qBAAa,cAAc;IACzB,qEAAqE;IACrE,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAoBhC;;OAEG;IACG,GAAG,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;CA4GnD"}
+{"version":3,"file":"cli-agent-runner.d.ts","sourceRoot":"","sources":["../../src/agents/cli-agent-runner.ts"],"names":[],"mappings":"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"}