@fractary/faber-mcp 1.1.0

package/dist/tools/workflow.js

@@ -0,0 +1,282 @@
+/**
+ * Workflow Orchestration Tools for FABER MCP Server
+ *
+ * Provides workflow control and management via MCP.
+ */
+import { FaberWorkflow } from '@fractary/faber/workflow';
+import { StateManager } from '@fractary/faber/state';
+/**
+ * Create tool error response
+ */
+function createToolError(toolName, error) {
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({ status: 'error', operation: toolName, error }, null, 2)
+            }],
+        isError: true,
+    };
+}
+/**
+ * Create workflow orchestration tools
+ *
+ * @returns Array of tool definitions
+ */
+export function createWorkflowTools() {
+    return [
+        // Tool 1: fractary_faber_workflow_run
+        {
+            name: 'fractary_faber_workflow_run',
+            description: 'Run FABER workflow (Frame → Architect → Build → Evaluate → Release) for a work item',
+            inputSchema: {
+                type: 'object',
+                required: ['work_id'],
+                properties: {
+                    work_id: {
+                        type: 'string',
+                        description: 'Work item ID to process (e.g., "123" for issue #123)',
+                    },
+                    autonomy: {
+                        type: 'string',
+                        enum: ['dry-run', 'assisted', 'guarded', 'autonomous'],
+                        description: 'Autonomy level: dry-run (report only), assisted (prompt for actions), guarded (safety checks), autonomous (full auto)',
+                        default: 'assisted',
+                    },
+                    config: {
+                        type: 'object',
+                        description: 'Optional workflow configuration overrides',
+                        properties: {
+                            phases: {
+                                type: 'object',
+                                description: 'Phase-specific configuration',
+                            },
+                            forge: {
+                                type: 'object',
+                                description: 'Forge integration settings',
+                                properties: {
+                                    enabled: { type: 'boolean' },
+                                    prefer_local: { type: 'boolean' },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+            handler: async (params) => {
+                const { work_id, autonomy, config } = params;
+                const workflow = new FaberWorkflow({ config: config });
+                try {
+                    const result = await workflow.run({
+                        workId: work_id,
+                        autonomy: (autonomy || 'assisted'),
+                        config: config,
+                    });
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                    };
+                }
+                catch (error) {
+                    return createToolError('workflow_run', error.message);
+                }
+            },
+        },
+        // Tool 2: fractary_faber_workflow_status
+        {
+            name: 'fractary_faber_workflow_status',
+            description: 'Get workflow status and progress by workflow ID or work item ID',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    workflow_id: {
+                        type: 'string',
+                        description: 'Workflow ID to check (e.g., "WF-abc123")',
+                    },
+                    work_id: {
+                        type: 'string',
+                        description: 'Work item ID to find active workflow for',
+                    },
+                },
+            },
+            handler: async (params) => {
+                const { workflow_id, work_id } = params;
+                let workflowId = workflow_id;
+                // If work_id provided, find active workflow
+                if (!workflowId && work_id) {
+                    const stateManager = new StateManager();
+                    const state = stateManager.getActiveWorkflow(work_id);
+                    if (state) {
+                        workflowId = state.workflow_id;
+                    }
+                }
+                if (!workflowId) {
+                    return createToolError('workflow_status', 'No workflow_id or work_id provided');
+                }
+                const workflow = new FaberWorkflow();
+                const status = workflow.getStatus(workflowId);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(status, null, 2) }],
+                };
+            },
+        },
+        // Tool 3: fractary_faber_workflow_resume
+        {
+            name: 'fractary_faber_workflow_resume',
+            description: 'Resume a paused workflow from where it left off',
+            inputSchema: {
+                type: 'object',
+                required: ['workflow_id'],
+                properties: {
+                    workflow_id: {
+                        type: 'string',
+                        description: 'Workflow ID to resume',
+                    },
+                },
+            },
+            handler: async (params) => {
+                const { workflow_id } = params;
+                const workflow = new FaberWorkflow();
+                try {
+                    const result = await workflow.resume(workflow_id);
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                    };
+                }
+                catch (error) {
+                    return createToolError('workflow_resume', error.message);
+                }
+            },
+        },
+        // Tool 4: fractary_faber_workflow_pause
+        {
+            name: 'fractary_faber_workflow_pause',
+            description: 'Pause a running workflow (can be resumed later)',
+            inputSchema: {
+                type: 'object',
+                required: ['workflow_id'],
+                properties: {
+                    workflow_id: {
+                        type: 'string',
+                        description: 'Workflow ID to pause',
+                    },
+                },
+            },
+            handler: async (params) => {
+                const { workflow_id } = params;
+                const workflow = new FaberWorkflow();
+                try {
+                    workflow.pause(workflow_id);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    status: 'success',
+                                    workflow_id,
+                                    message: 'Workflow paused',
+                                }, null, 2),
+                            },
+                        ],
+                    };
+                }
+                catch (error) {
+                    return createToolError('workflow_pause', error.message);
+                }
+            },
+        },
+        // Tool 5: fractary_faber_workflow_recover (Option B: Direct StateManager)
+        {
+            name: 'fractary_faber_workflow_recover',
+            description: 'Recover a failed workflow from a checkpoint or specific phase',
+            inputSchema: {
+                type: 'object',
+                required: ['workflow_id'],
+                properties: {
+                    workflow_id: {
+                        type: 'string',
+                        description: 'Workflow ID to recover',
+                    },
+                    checkpoint_id: {
+                        type: 'string',
+                        description: 'Optional checkpoint ID to recover from',
+                    },
+                    from_phase: {
+                        type: 'string',
+                        enum: ['frame', 'architect', 'build', 'evaluate', 'release'],
+                        description: 'Optional phase to restart from',
+                    },
+                    skip_phases: {
+                        type: 'array',
+                        items: {
+                            type: 'string',
+                            enum: ['frame', 'architect', 'build', 'evaluate', 'release'],
+                        },
+                        description: 'Phases to skip during recovery',
+                    },
+                },
+            },
+            handler: async (params) => {
+                const { workflow_id, checkpoint_id, from_phase, skip_phases } = params;
+                try {
+                    // Option B: Use StateManager directly (fallback until SDK method added)
+                    const stateManager = new StateManager();
+                    const recoveredState = stateManager.recoverWorkflow(workflow_id, {
+                        checkpointId: checkpoint_id,
+                        fromPhase: from_phase,
+                        skipPhases: skip_phases,
+                    });
+                    // Re-run workflow with recovered state
+                    const workflow = new FaberWorkflow();
+                    const result = await workflow.run({
+                        workId: recoveredState.work_id,
+                        autonomy: 'assisted',
+                    });
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                    };
+                }
+                catch (error) {
+                    return createToolError('workflow_recover', error.message);
+                }
+            },
+        },
+        // Tool 6: fractary_faber_workflow_cleanup (Option B: Direct StateManager)
+        {
+            name: 'fractary_faber_workflow_cleanup',
+            description: 'Clean up old completed/failed workflow state files',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    max_age_days: {
+                        type: 'number',
+                        description: 'Delete workflows older than this many days',
+                        default: 30,
+                        minimum: 1,
+                    },
+                },
+            },
+            handler: async (params) => {
+                const { max_age_days } = params;
+                try {
+                    // Option B: Use StateManager directly (fallback until SDK method added)
+                    const stateManager = new StateManager();
+                    const result = stateManager.cleanup(max_age_days || 30);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    status: 'success',
+                                    ...result,
+                                }, null, 2),
+                            },
+                        ],
+                    };
+                }
+                catch (error) {
+                    return createToolError('workflow_cleanup', error.message);
+                }
+            },
+        },
+    ];
+}
+//# sourceMappingURL=workflow.js.map

package/dist/tools/workflow.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Type definitions for FABER Event Gateway
+ */
+export declare const EventTypes: readonly ["workflow_start", "workflow_complete", "workflow_error", "workflow_cancelled", "workflow_resumed", "workflow_rerun", "phase_start", "phase_skip", "phase_complete", "phase_error", "step_start", "step_complete", "step_error", "step_retry", "artifact_create", "artifact_modify", "commit_create", "branch_create", "pr_create", "pr_merge", "spec_generate", "spec_validate", "test_run", "docs_update", "checkpoint", "skill_invoke", "agent_invoke", "decision_point", "retry_loop_enter", "retry_loop_exit", "approval_request", "approval_granted", "approval_denied", "hook_execute"];
+export type EventType = (typeof EventTypes)[number];
+export declare const Phases: readonly ["frame", "architect", "build", "evaluate", "release"];
+export type Phase = (typeof Phases)[number];
+export declare const EventStatuses: readonly ["started", "completed", "failed", "skipped", "pending", "cancelled"];
+export type EventStatus = (typeof EventStatuses)[number];
+export declare const RunStatuses: readonly ["pending", "in_progress", "completed", "failed", "cancelled"];
+export type RunStatus = (typeof RunStatuses)[number];
+export interface Artifact {
+    type: "branch" | "commit" | "spec" | "pr" | "deployment" | "tag" | "document" | "file" | "other";
+    name: string;
+    path?: string;
+    url?: string;
+    sha?: string;
+    size_bytes?: number;
+}
+export interface EventError {
+    code: string;
+    message: string;
+    stack?: string;
+    recoverable?: boolean;
+}
+export interface FaberEvent {
+    event_id: number;
+    type: EventType;
+    timestamp: string;
+    run_id: string;
+    phase?: Phase;
+    step?: string;
+    status?: EventStatus;
+    user?: string;
+    source?: string;
+    message?: string;
+    duration_ms?: number;
+    metadata?: Record<string, unknown>;
+    artifacts?: Artifact[];
+    error?: EventError;
+}
+export interface PhaseState {
+    status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+    started_at?: string;
+    completed_at?: string;
+    steps: Array<{
+        name: string;
+        status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+        started_at?: string;
+        completed_at?: string;
+        duration_ms?: number;
+    }>;
+    retry_count?: number;
+}
+export interface RunState {
+    run_id: string;
+    work_id: string;
+    workflow_version: string;
+    status: RunStatus;
+    current_phase: Phase | null;
+    last_event_id: number;
+    started_at: string | null;
+    updated_at: string;
+    completed_at: string | null;
+    phases: {
+        frame: PhaseState;
+        architect: PhaseState;
+        build: PhaseState;
+        evaluate: PhaseState;
+        release: PhaseState;
+    };
+    artifacts: Record<string, string>;
+    errors: EventError[];
+}
+export interface RunRelationships {
+    parent_run_id: string | null;
+    rerun_of: string | null;
+    child_runs: string[];
+}
+export interface RunEnvironment {
+    hostname: string;
+    git_branch: string;
+    git_commit: string;
+    working_directory: string;
+}
+export interface RunMetadata {
+    run_id: string;
+    work_id: string;
+    target: string | null;
+    workflow_id: string;
+    autonomy: "dry-run" | "assist" | "guarded" | "autonomous";
+    source_type: "github" | "jira" | "linear" | "manual";
+    phases: Phase[];
+    created_at: string;
+    created_by: string;
+    relationships: RunRelationships;
+    environment: RunEnvironment;
+}
+export interface RunSummary {
+    run_id: string;
+    work_id: string;
+    status: RunStatus;
+    created_at: string;
+    updated_at: string;
+    completed_at: string | null;
+    current_phase: Phase | null;
+    event_count?: number;
+}
+export interface EmitEventResult {
+    status: "success" | "error";
+    operation: "emit-event";
+    event_id: number;
+    type: EventType;
+    run_id: string;
+    timestamp: string;
+    event_path: string;
+    error?: string;
+}
+export interface GetRunResult {
+    status: "success" | "error";
+    operation: "get-run";
+    run_id: string;
+    metadata: RunMetadata;
+    state: RunState;
+    event_count?: number;
+    error?: string;
+}
+export interface ListRunsResult {
+    status: "success" | "error";
+    operation: "list-runs";
+    runs: RunSummary[];
+    total: number;
+    error?: string;
+}
+export interface ConsolidateResult {
+    status: "success" | "error";
+    operation: "consolidate-events";
+    run_id: string;
+    events_consolidated: number;
+    output_path: string;
+    size_bytes: number;
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,UAAU,ykBAmCb,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpD,eAAO,MAAM,MAAM,iEAMT,CAAC;AAEX,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5C,eAAO,MAAM,aAAa,gFAOhB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,eAAO,MAAM,WAAW,yEAMd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,IAAI,GAAG,YAAY,GAAG,KAAK,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;IACjG,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;QACvE,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,SAAS,CAAC;IAClB,aAAa,EAAE,KAAK,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE;QACN,KAAK,EAAE,UAAU,CAAC;QAClB,SAAS,EAAE,UAAU,CAAC;QACtB,KAAK,EAAE,UAAU,CAAC;QAClB,QAAQ,EAAE,UAAU,CAAC;QACrB,OAAO,EAAE,UAAU,CAAC;KACrB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,CAAC;IAC1D,WAAW,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACrD,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,gBAAgB,CAAC;IAChC,WAAW,EAAE,cAAc,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,KAAK,GAAG,IAAI,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,SAAS,EAAE,YAAY,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,QAAQ,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,SAAS,EAAE,WAAW,CAAC;IACvB,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,SAAS,EAAE,oBAAoB,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/types.js

@@ -0,0 +1,62 @@
+/**
+ * Type definitions for FABER Event Gateway
+ */
+export const EventTypes = [
+    "workflow_start",
+    "workflow_complete",
+    "workflow_error",
+    "workflow_cancelled",
+    "workflow_resumed",
+    "workflow_rerun",
+    "phase_start",
+    "phase_skip",
+    "phase_complete",
+    "phase_error",
+    "step_start",
+    "step_complete",
+    "step_error",
+    "step_retry",
+    "artifact_create",
+    "artifact_modify",
+    "commit_create",
+    "branch_create",
+    "pr_create",
+    "pr_merge",
+    "spec_generate",
+    "spec_validate",
+    "test_run",
+    "docs_update",
+    "checkpoint",
+    "skill_invoke",
+    "agent_invoke",
+    "decision_point",
+    "retry_loop_enter",
+    "retry_loop_exit",
+    "approval_request",
+    "approval_granted",
+    "approval_denied",
+    "hook_execute",
+];
+export const Phases = [
+    "frame",
+    "architect",
+    "build",
+    "evaluate",
+    "release",
+];
+export const EventStatuses = [
+    "started",
+    "completed",
+    "failed",
+    "skipped",
+    "pending",
+    "cancelled",
+];
+export const RunStatuses = [
+    "pending",
+    "in_progress",
+    "completed",
+    "failed",
+    "cancelled",
+];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,gBAAgB;IAChB,mBAAmB;IACnB,gBAAgB;IAChB,oBAAoB;IACpB,kBAAkB;IAClB,gBAAgB;IAChB,aAAa;IACb,YAAY;IACZ,gBAAgB;IAChB,aAAa;IACb,YAAY;IACZ,eAAe;IACf,YAAY;IACZ,YAAY;IACZ,iBAAiB;IACjB,iBAAiB;IACjB,eAAe;IACf,eAAe;IACf,WAAW;IACX,UAAU;IACV,eAAe;IACf,eAAe;IACf,UAAU;IACV,aAAa;IACb,YAAY;IACZ,cAAc;IACd,cAAc;IACd,gBAAgB;IAChB,kBAAkB;IAClB,iBAAiB;IACjB,kBAAkB;IAClB,kBAAkB;IAClB,iBAAiB;IACjB,cAAc;CACN,CAAC;AAIX,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,OAAO;IACP,WAAW;IACX,OAAO;IACP,UAAU;IACV,SAAS;CACD,CAAC;AAIX,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,SAAS;IACT,WAAW;IACX,QAAQ;IACR,SAAS;IACT,SAAS;IACT,WAAW;CACH,CAAC;AAIX,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,SAAS;IACT,aAAa;IACb,WAAW;IACX,QAAQ;IACR,WAAW;CACH,CAAC"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@fractary/faber-mcp",
+  "version": "1.1.0",
+  "description": "MCP Server for FABER workflow orchestration - run, status, events, and run management",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "fractary-faber-mcp": "./dist/server.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "tsx src/server.ts",
+    "build": "tsc",
+    "start": "node dist/server.js",
+    "watch": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src --ext .ts",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "faber",
+    "mcp",
+    "model-context-protocol",
+    "workflow",
+    "orchestration",
+    "events",
+    "ai",
+    "development"
+  ],
+  "author": "Fractary Team",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@fractary/faber": "*",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "ajv": "^8.12.0",
+    "ajv-formats": "^2.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@typescript-eslint/eslint-plugin": "^6.19.0",
+    "@typescript-eslint/parser": "^6.19.0",
+    "eslint": "^8.56.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fractary/faber.git",
+    "directory": "mcp/server"
+  },
+  "bugs": {
+    "url": "https://github.com/fractary/faber/issues"
+  },
+  "homepage": "https://github.com/fractary/faber/tree/main/mcp/server#readme"
+}