qyl-mcp-server 2.1.0 → 4.0.0

package/dist/workflow-tools.js

@@ -1,170 +0,0 @@
-import { WORKFLOW_GRAPH_RESOURCE_URI } from "./config.js";
-import { ControlWorkflowRunInputSchema, ControlWorkflowRunOutputSchema, DisplayWorkflowGraphInputSchema, DisplayWorkflowGraphOutputSchema, FetchWorkflowGraphUpdatesInputSchema, GetWorkflowGraphInputSchema, GetWorkflowGraphOutputSchema, InspectWorkflowEventsInputSchema, InspectWorkflowEventsOutputSchema, ListWorkflowRunsInputSchema, ListWorkflowRunsOutputSchema, compactOutputSchema, } from "./contract-validation.js";
-import { QYL_MCP_CONTROL_SCOPE } from "./oauth.js";
-import { READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS, toolError } from "./tools.js";
-import { fetchWorkflowGraphUpdates, getMostRecentWorkflowRun, getWorkflowGraph, inspectWorkflowEvents, listWorkflowRuns, submitWorkflowControl, } from "./workflow-data.js";
-export const CONTROL_WORKFLOW_TOOL_ANNOTATIONS = {
-    readOnlyHint: false,
-    destructiveHint: true,
-    idempotentHint: true,
-    openWorldHint: false,
-};
-function toolResult(text, output) {
-    return {
-        content: [{ type: "text", text }],
-        structuredContent: output,
-    };
-}
-function graphSummary(prefix, graph) {
-    const { statistics } = graph;
-    return (`${prefix} ${graph.run.run_id}: ${graph.total_node_count} nodes, ` +
-        `${graph.total_edge_count} edges, ${statistics.wall_time_ms.toFixed(0)} ms wall time, ` +
-        `${statistics.t_infinity_ms.toFixed(0)} ms critical path at ` +
-        `${statistics.peak_concurrency} peak concurrency.`);
-}
-export function hasWorkflowControlScope(scopes) {
-    return scopes?.includes(QYL_MCP_CONTROL_SCOPE) === true;
-}
-/** Register the generated-shape workflow inspection, display, update, and control tools. */
-export function registerWorkflowTools(server) {
-    server.registerTool("list_workflow_runs", {
-        title: "List Workflow Runs",
-        description: "List observed Codex workflow runs from qyl's durable journal. Results are " +
-            "cursor-paged and contain run metadata only; use get_workflow_graph or " +
-            "display_workflow_graph to inspect execution.",
-        inputSchema: ListWorkflowRunsInputSchema,
-        outputSchema: compactOutputSchema(ListWorkflowRunsOutputSchema),
-        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
-    }, async (input, context) => {
-        try {
-            const output = await listWorkflowRuns(input, context.mcpReq.signal);
-            return toolResult(`Found ${output.runs.length} workflow runs${output.has_more ? " (more available)" : ""}.`, output);
-        }
-        catch (error) {
-            return toolError(error);
-        }
-    });
-    server.registerTool("get_workflow_graph", {
-        title: "Get Workflow Graph",
-        description: "Read a bounded page of the deterministic workflow DAG, including typed edges, " +
-            "recorded or derived provenance, attempt-preserving nodes, and weighted timing statistics.",
-        inputSchema: GetWorkflowGraphInputSchema,
-        outputSchema: compactOutputSchema(GetWorkflowGraphOutputSchema),
-        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
-    }, async (input, context) => {
-        try {
-            const output = {
-                graph: await getWorkflowGraph(input, context.mcpReq.signal),
-                mode: "live",
-            };
-            return toolResult(graphSummary("Read workflow", output.graph), output);
-        }
-        catch (error) {
-            return toolError(error);
-        }
-    });
-    server.registerTool("display_workflow_graph", {
-        title: "Display Workflow Graph",
-        description: "Open the fullscreen qyl workflow debugger. Pass a run_id for a known live or " +
-            "historical run, or omit it to open the newest journaled run.",
-        inputSchema: DisplayWorkflowGraphInputSchema,
-        outputSchema: compactOutputSchema(DisplayWorkflowGraphOutputSchema),
-        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
-        _meta: { ui: { resourceUri: WORKFLOW_GRAPH_RESOURCE_URI } },
-    }, async (input, context) => {
-        try {
-            const runId = input.run_id
-                ?? (await getMostRecentWorkflowRun(context.mcpReq.signal)).run_id;
-            const graph = await getWorkflowGraph({
-                run_id: runId,
-                node_cursor: input.node_cursor,
-                node_limit: input.node_limit,
-                edge_cursor: input.edge_cursor,
-                edge_limit: input.edge_limit,
-            }, context.mcpReq.signal);
-            const output = {
-                graph,
-                live_controls_available: graph.run.status === "active",
-                mode: "live",
-            };
-            return toolResult(graphSummary("Displaying workflow", graph), output);
-        }
-        catch (error) {
-            return toolError(error);
-        }
-    });
-    server.registerTool("inspect_workflow_events", {
-        title: "Inspect Workflow Events",
-        description: "Read immutable workflow journal events after a collector sequence and optionally " +
-            "retrieve one protected payload by content_ref. Versioned diagnostics arrive as " +
-            "content_captured events: inspect the safe machine-readable summary in data, then " +
-            "fetch protected evidence through a listed content_ref when needed. Reads are immediate " +
-            "and bounded; graph projection and long-poll controls belong to the app-only update tool.",
-        inputSchema: InspectWorkflowEventsInputSchema,
-        outputSchema: compactOutputSchema(InspectWorkflowEventsOutputSchema),
-        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
-    }, async (input, context) => {
-        try {
-            const output = await inspectWorkflowEvents(input, context.mcpReq.signal);
-            return toolResult(`Inspected ${output.page.events.length} workflow events through sequence ` +
-                `${output.page.next_sequence}${output.content === undefined ? "" : " and fetched protected content"}.`, output);
-        }
-        catch (error) {
-            return toolError(error);
-        }
-    });
-    server.registerTool("fetch_workflow_graph_updates", {
-        title: "Fetch Workflow Graph Updates",
-        description: "Long-poll workflow journal updates, refresh a bounded graph page, or lazily " +
-            "retrieve one captured content object. The model should NOT call this tool directly.",
-        inputSchema: FetchWorkflowGraphUpdatesInputSchema,
-        // No outputSchema: this tool is `_meta.ui.visibility: ["app"]`, so its only
-        // caller is the bundled viewer, which is compiled against the generated
-        // TypeScript types and never reads the advertised schema. Publishing one
-        // anyway put the whole telemetry tree into every client's `tools/list`
-        // (18 KB of the 232 KB manifest) to describe a shape no model may call.
-        // Structured content is still returned and still typed by the generated
-        // contract at compile time, and workflow-ui.test.ts still parses these bodies
-        // against FetchWorkflowGraphUpdatesOutputSchema, so the shape stays pinned.
-        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
-        _meta: { ui: { visibility: ["app"] } },
-    }, async (input, context) => {
-        try {
-            const output = await fetchWorkflowGraphUpdates(input, context.mcpReq.signal);
-            return toolResult(`Fetched ${output.page.events.length} workflow events through sequence ` +
-                `${output.page.next_sequence}.`, output);
-        }
-        catch (error) {
-            return toolError(error);
-        }
-    });
-    server.registerTool("control_workflow_run", {
-        title: "Control Workflow Run",
-        description: "Submit an idempotent run-level steer, interrupt, or resume command. This mutates " +
-            "the active Codex thread through its outbound observer channel and requires qyl:control.",
-        inputSchema: ControlWorkflowRunInputSchema,
-        outputSchema: compactOutputSchema(ControlWorkflowRunOutputSchema),
-        annotations: CONTROL_WORKFLOW_TOOL_ANNOTATIONS,
-    }, async (input, context) => {
-        if (!hasWorkflowControlScope(context.http?.authInfo?.scopes)) {
-            return {
-                content: [{
-                        type: "text",
-                        text: `control_workflow_run requires the ${QYL_MCP_CONTROL_SCOPE} OAuth scope.`,
-                    }],
-                isError: true,
-            };
-        }
-        try {
-            const output = {
-                command: await submitWorkflowControl(input, context.mcpReq.signal),
-            };
-            return toolResult(`Workflow ${input.run_id} ${input.action} command accepted as ` +
-                `${output.command.command_id} (${output.command.status}).`, output);
-        }
-        catch (error) {
-            return toolError(error);
-        }
-    });
-}
-//# sourceMappingURL=workflow-tools.js.map

package/dist/workflow-tools.js.map

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