maestro-flow 0.1.4 → 0.2.1

package/dashboard/dist-server/src/shared/ws-protocol.d.ts

@@ -0,0 +1,161 @@
+import type { AgentConfig, AgentProcess, AgentType, NormalizedEntry, ApprovalRequest, AgentStatusPayload, AgentStoppedPayload } from './agent-types.js';
+import type { CommanderConfig } from './commander-types.js';
+import type { SupervisorConfig } from './execution-types.js';
+import type { ExpansionDepth } from './requirement-types.js';
+/** All WebSocket event type discriminators */
+export type WsEventType = 'agent:spawned' | 'agent:entry' | 'agent:approval' | 'agent:status' | 'agent:stopped' | 'agent:turnCompleted' | 'agent:thought' | 'agent:streaming' | 'execution:started' | 'execution:completed' | 'execution:failed' | 'execution:scheduler_status' | 'supervisor:status' | 'supervisor:learning_update' | 'supervisor:schedule_triggered' | 'supervisor:schedule_update' | 'supervisor:extension_loaded' | 'supervisor:extension_error' | 'commander:status' | 'commander:tick' | 'commander:decision' | 'commander:config' | 'commander:assess_metrics' | 'commander:error' | 'coordinate:status' | 'coordinate:analyze_metrics' | 'coordinate:step' | 'coordinate:analysis' | 'coordinate:clarification_needed' | 'coordinate:error' | 'requirement:expanded' | 'requirement:refined' | 'requirement:committed' | 'requirement:progress' | 'board:full' | 'phase:updated' | 'task:updated' | 'scratch:updated' | 'project:updated' | 'watcher:error' | 'workspace:switched' | 'heartbeat' | 'connected' | 'wiki:invalidated' | 'collab:members_updated' | 'collab:activity';
+/** Envelope for all server-to-client WebSocket messages */
+export interface WsServerMessage<T = unknown> {
+    type: WsEventType;
+    data: T;
+    timestamp: string;
+}
+export type WsAgentSpawnedMessage = WsServerMessage<AgentProcess>;
+export type WsAgentEntryMessage = WsServerMessage<NormalizedEntry>;
+export type WsAgentApprovalMessage = WsServerMessage<ApprovalRequest>;
+export type WsAgentStatusMessage = WsServerMessage<AgentStatusPayload>;
+export type WsAgentStoppedMessage = WsServerMessage<AgentStoppedPayload>;
+/** Discriminated union of all client-to-server WS actions */
+export type WsClientMessage = WsClientSpawnMessage | WsClientStopMessage | WsClientMessageMessage | WsClientDelegateMessage | WsClientApproveMessage | WsClientCliBridgeSpawnMessage | WsClientCliBridgeEntryMessage | WsClientCliBridgeStoppedMessage | WsClientExecuteIssueMessage | WsClientExecuteBatchMessage | WsClientAnalyzeIssueMessage | WsClientPlanIssueMessage | WsClientSupervisorToggleMessage | WsClientCommanderStartMessage | WsClientCommanderStopMessage | WsClientCommanderPauseMessage | WsClientCommanderConfigMessage | WsClientWaveExecuteMessage | WsClientCoordinateStartMessage | WsClientCoordinateStopMessage | WsClientCoordinateResumeMessage | WsClientCoordinateClarifyMessage | WsClientIssuePipelineMessage | WsClientRequirementExpandMessage | WsClientRequirementRefineMessage | WsClientRequirementCommitMessage;
+export interface WsClientSpawnMessage {
+    action: 'spawn';
+    config: AgentConfig;
+}
+export interface WsClientStopMessage {
+    action: 'stop';
+    processId: string;
+}
+export interface WsClientMessageMessage {
+    action: 'message';
+    processId: string;
+    content: string;
+}
+export interface WsClientDelegateMessage {
+    action: 'delegate:message';
+    processId?: string;
+    execId?: string;
+    content: string;
+    delivery: 'inject' | 'after_complete';
+}
+export interface WsClientApproveMessage {
+    action: 'approve';
+    processId: string;
+    requestId: string;
+    allow: boolean;
+}
+export interface WsClientCliBridgeSpawnMessage {
+    action: 'cli:spawned';
+    process: AgentProcess;
+}
+export interface WsClientCliBridgeEntryMessage {
+    action: 'cli:entry';
+    entry: NormalizedEntry;
+}
+export interface WsClientCliBridgeStoppedMessage {
+    action: 'cli:stopped';
+    processId: string;
+}
+export interface WsClientExecuteIssueMessage {
+    action: 'execute:issue';
+    issueId: string;
+    executor?: AgentType;
+}
+export interface WsClientExecuteBatchMessage {
+    action: 'execute:batch';
+    issueIds: string[];
+    executor?: AgentType;
+    maxConcurrency?: number;
+}
+export interface WsClientAnalyzeIssueMessage {
+    action: 'issue:analyze';
+    issueId: string;
+    tool?: string;
+    depth?: string;
+}
+export interface WsClientPlanIssueMessage {
+    action: 'issue:plan';
+    issueId: string;
+    tool?: string;
+}
+export interface WsClientIssuePipelineMessage {
+    action: 'issue:pipeline';
+    issueId: string;
+    tool?: string;
+}
+export interface WsClientSupervisorToggleMessage {
+    action: 'supervisor:toggle';
+    enabled: boolean;
+    config?: Partial<SupervisorConfig>;
+}
+export interface WsClientCommanderStartMessage {
+    action: 'commander:start';
+}
+export interface WsClientCommanderStopMessage {
+    action: 'commander:stop';
+}
+export interface WsClientCommanderPauseMessage {
+    action: 'commander:pause';
+}
+export interface WsClientCommanderConfigMessage {
+    action: 'commander:config';
+    config: Partial<CommanderConfig>;
+}
+export interface WsClientWaveExecuteMessage {
+    action: 'execute:wave';
+    issueId: string;
+}
+export interface WsClientCoordinateStartMessage {
+    action: 'coordinate:start';
+    intent: string;
+    tool?: string;
+    autoMode?: boolean;
+}
+export interface WsClientCoordinateStopMessage {
+    action: 'coordinate:stop';
+}
+export interface WsClientCoordinateResumeMessage {
+    action: 'coordinate:resume';
+    sessionId?: string;
+}
+export interface WsClientCoordinateClarifyMessage {
+    action: 'coordinate:clarify';
+    sessionId: string;
+    response: string;
+}
+export interface WsClientRequirementExpandMessage {
+    action: 'requirement:expand';
+    text: string;
+    depth?: ExpansionDepth;
+    method?: 'sdk' | 'cli';
+}
+export interface WsClientRequirementRefineMessage {
+    action: 'requirement:refine';
+    requirementId: string;
+    feedback: string;
+}
+export interface WsClientRequirementCommitMessage {
+    action: 'requirement:commit';
+    requirementId: string;
+    mode: 'issues' | 'coordinate';
+}
+export interface ExecutionStartedPayload {
+    issueId: string;
+    processId: string;
+    executor: AgentType;
+    /** Optional: updated issue for incremental client-side update */
+    issue?: import('./issue-types.js').Issue;
+}
+export interface ExecutionCompletedPayload {
+    issueId: string;
+    processId: string;
+    /** Optional: updated issue for incremental client-side update */
+    issue?: import('./issue-types.js').Issue;
+}
+export interface ExecutionFailedPayload {
+    issueId: string;
+    processId: string;
+    error: string;
+    /** Optional: updated issue for incremental client-side update */
+    issue?: import('./issue-types.js').Issue;
+}
+export declare const WS_ENDPOINT = "/ws";

package/dashboard/dist-server/src/shared/ws-protocol.js

@@ -0,0 +1,8 @@
+// ---------------------------------------------------------------------------
+// WebSocket protocol types — server/client message contracts
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// WS endpoint
+// ---------------------------------------------------------------------------
+export const WS_ENDPOINT = '/ws';
+//# sourceMappingURL=ws-protocol.js.map

package/dashboard/dist-server/src/shared/ws-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-protocol.js","sourceRoot":"","sources":["../../../src/shared/ws-protocol.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,6DAA6D;AAC7D,8EAA8E;AA4T9E,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAC"}

package/dashboard/dist-server/src/types/index.d.ts

@@ -0,0 +1,74 @@
+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[];
+}

package/dashboard/dist-server/src/types/index.js

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

package/dashboard/dist-server/src/types/index.js.map

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

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/dashboard/package.json

@@ -34,7 +34,7 @@
     "react-dom": "^19.0.0",
     "react-markdown": "^9.0.0",
     "react-router-dom": "^6.30.3",
-    "react-virtuoso": "^4.18.3",
+    "react-virtuoso": "^4.18.4",
     "remark-gfm": "^4.0.0",
     "tailwind-merge": "^3.5.0",
     "ws": "^8.19.0",

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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"}