@tuongaz/seeflow 0.1.82 → 0.1.83

package/src/mcp.ts

@@ -29,7 +29,13 @@ import {
   flowBulkNonEmpty,
 } from './operations.ts';
 import type { Registry } from './registry.ts';
-import { getSchemaCategory, listSchemaCategories, schemaCategoryNames } from './schema-catalog.ts';
+import {
+  getCategorySubschema,
+  getSchemaCategory,
+  listCategorySubnames,
+  listSchemaCategories,
+  schemaCategoryNames,
+} from './schema-catalog.ts';
 import { ID_TYPES, MAX_ID_COUNT, generateIds, isIdType } from './short-id.ts';
 import type { FlowWatcher } from './watcher.ts';
 
@@ -280,13 +286,18 @@ const buildTools = (ops: Operations, ctx: ToolContext): McpTool[] => [
     name: 'seeflow_schema',
     description:
       'Get the SeeFlow flow.json / spec.json schemas. Call with no args for a ' +
-      "category index; call with `name` for one category's full JSON Schemas. " +
-      'Use this to learn what a node, connector, action, component spec, or ' +
-      'flow envelope looks like before authoring writes. Categories: `flow`, ' +
-      '`node` (13 flat variants — rectangle/ellipse/sticky/text/database/server/' +
-      'user/queue/cloud/image/html/icon/component), `connector`, `action` ' +
-      '(playAction/statusAction/resetAction/statusReport/componentAction), ' +
-      "`componentSpec` (sidecar shape for type:'component' nodes), `style`.",
+      "category index; call with `name` for one category's full JSON Schemas; " +
+      'call with `name` + `subname` for just one named schema within that ' +
+      "category (e.g. name='node', subname='component' → just the component " +
+      "node variant; name='node', subname='rectangle' → just the rectangle " +
+      "node variant; name='action', subname='playAction' → just the playAction " +
+      'shape). Use this to learn what a node, connector, action, component ' +
+      'spec, or flow envelope looks like before authoring writes. Categories: ' +
+      '`flow`, `node` (13 flat variants — rectangle/ellipse/sticky/text/' +
+      'database/server/user/queue/cloud/image/html/icon/component), ' +
+      '`connector`, `action` (playAction/statusAction/resetAction/statusReport/' +
+      "componentAction), `componentSpec` (sidecar shape for type:'component' " +
+      'nodes), `style`.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -294,20 +305,58 @@ const buildTools = (ops: Operations, ctx: ToolContext): McpTool[] => [
           type: 'string',
           description: 'Optional category name. Omit for the index.',
         },
+        subname: {
+          type: 'string',
+          description:
+            'Optional named schema within the category (requires `name`). For ' +
+            "name='node': rectangle, ellipse, sticky, text, database, server, " +
+            'user, queue, cloud, image, html, icon, component. For ' +
+            "name='action': playAction, statusAction, resetAction, statusReport, " +
+            "componentAction. For name='componentSpec': componentSpec, " +
+            'componentSpecElement.',
+        },
       },
       additionalProperties: false,
     },
     handler: async (args) => {
-      const name =
+      const argObj =
         args && typeof args === 'object' && !Array.isArray(args)
-          ? (args as { name?: unknown }).name
-          : undefined;
+          ? (args as { name?: unknown; subname?: unknown })
+          : {};
+      const name = argObj.name;
+      const subname = argObj.subname;
       if (name === undefined || name === null || name === '') {
+        if (subname !== undefined && subname !== null && subname !== '') {
+          return errorResult('Invalid arguments: `subname` requires `name` to be set');
+        }
         return okResult({ categories: listSchemaCategories() });
       }
       if (typeof name !== 'string') {
         return errorResult('Invalid arguments: `name` must be a string when present');
       }
+      if (subname !== undefined && subname !== null && subname !== '') {
+        if (typeof subname !== 'string') {
+          return errorResult('Invalid arguments: `subname` must be a string when present');
+        }
+        const single = getCategorySubschema(name, subname);
+        if (single) {
+          return okResult({
+            name,
+            subname,
+            schemas: single.schemas,
+            notes: single.notes,
+          });
+        }
+        const availableSubs = listCategorySubnames(name);
+        if (availableSubs === null) {
+          return errorResult(
+            `unknown schema category: ${name} (available: ${schemaCategoryNames().join(', ')})`,
+          );
+        }
+        return errorResult(
+          `unknown schema subname: ${subname} in category ${name} (available: ${availableSubs.join(', ')})`,
+        );
+      }
       const payload = getSchemaCategory(name);
       if (!payload) {
         return errorResult(

package/src/schema-catalog.ts

@@ -151,3 +151,26 @@ export function getSchemaCategory(name: string): SchemaPayload | null {
 export function schemaCategoryNames(): string[] {
   return CATEGORIES.map((c) => c.name);
 }
+
+// Drill into one named schema inside a category — e.g. ('node', 'rectangle')
+// returns just the rectangle variant. The category-level notes ride along
+// unchanged because they describe cross-variant invariants the caller still
+// needs (image path prefix, scriptPath rooting, etc.). Returns null if either
+// the category or the subname is unknown; callers use listCategorySubnames
+// to build a helpful "available" list in that case.
+export function getCategorySubschema(category: string, subname: string): SchemaPayload | null {
+  const payload = PAYLOADS[category];
+  if (!payload) return null;
+  const schema = payload.schemas[subname];
+  if (schema === undefined) return null;
+  return { schemas: { [subname]: schema }, notes: [...payload.notes] };
+}
+
+// Returns the subname keys (rectangle, ellipse, …) for a known category, or
+// null if the category itself is unknown. Used to surface "available" lists
+// on lookup failures so the error message is self-correcting.
+export function listCategorySubnames(category: string): string[] | null {
+  const payload = PAYLOADS[category];
+  if (!payload) return null;
+  return Object.keys(payload.schemas);
+}

package/dist/web/assets/channel-gvIm48Rt.js

@@ -1 +0,0 @@
-import{U as a,C as n}from"./mermaid.core-tY2raeE_.js";const t=(r,o)=>a.lang.round(n.parse(r)[o]);export{t as c};

package/dist/web/assets/classDiagram-4FO5ZUOK-eMNtcBZw.js

@@ -1 +0,0 @@
-import{s as a,a as s,c as e,C as t}from"./chunk-727SXJPM-DFEMoCvZ.js";import{a as i}from"./mermaid.core-tY2raeE_.js";import"./index-AGsIlqaG.js";import"./chunk-FMBD7UC4-LXLjZhT_.js";import"./chunk-ND2GUHAM-C8IKIBCh.js";import"./chunk-55IACEB6-D44BQXvr.js";import"./chunk-2J33WTMH-pmw8bFhw.js";import"./purify.es-CLGrRn1w.js";import"./step-CWvwoXpJ.js";var b={parser:e,get db(){return new t},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{b as diagram};

package/dist/web/assets/classDiagram-v2-Q7XG4LA2-eMNtcBZw.js

@@ -1 +0,0 @@
-import{s as a,a as s,c as e,C as t}from"./chunk-727SXJPM-DFEMoCvZ.js";import{a as i}from"./mermaid.core-tY2raeE_.js";import"./index-AGsIlqaG.js";import"./chunk-FMBD7UC4-LXLjZhT_.js";import"./chunk-ND2GUHAM-C8IKIBCh.js";import"./chunk-55IACEB6-D44BQXvr.js";import"./chunk-2J33WTMH-pmw8bFhw.js";import"./purify.es-CLGrRn1w.js";import"./step-CWvwoXpJ.js";var b={parser:e,get db(){return new t},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{b as diagram};

package/dist/web/assets/stateDiagram-v2-BHNVJYJU-CNXxJnrL.js

@@ -1 +0,0 @@
-import{b as r,a as e,s as a,S as s}from"./chunk-AQP2D5EJ-DDIMOnRk.js";import{a as i}from"./mermaid.core-tY2raeE_.js";import"./index-AGsIlqaG.js";import"./chunk-55IACEB6-D44BQXvr.js";import"./chunk-2J33WTMH-pmw8bFhw.js";import"./purify.es-CLGrRn1w.js";import"./step-CWvwoXpJ.js";var n={parser:a,get db(){return new s(2)},renderer:e,styles:r,init:i(t=>{t.state||(t.state={}),t.state.arrowMarkerAbsolute=t.arrowMarkerAbsolute},"init")};export{n as diagram};