@tuongaz/seeflow 0.1.84 → 0.1.87

package/src/mcp.ts

@@ -293,9 +293,9 @@ const buildTools = (ops: Operations, ctx: ToolContext): McpTool[] => [
       "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/' +
+      '`flow`, `node` (15 flat variants — rectangle/ellipse/sticky/text/' +
+      'database/server/user/queue/cloud/diamond/hexagon/image/html/icon/component), ' +
+      '`connector`, `action` (playAction/statusAction/statusReport/' +
       "componentAction), `componentSpec` (sidecar shape for type:'component' " +
       'nodes), `style`.',
     inputSchema: {
@@ -310,8 +310,8 @@ const buildTools = (ops: Operations, ctx: ToolContext): McpTool[] => [
           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, " +
+            'user, queue, cloud, diamond, hexagon, image, html, icon, component. For ' +
+            "name='action': playAction, statusAction, statusReport, " +
             "componentAction. For name='componentSpec': componentSpec, " +
             'componentSpecElement.',
         },
@@ -763,7 +763,7 @@ const buildTools = (ops: Operations, ctx: ToolContext): McpTool[] => [
   {
     name: 'seeflow_patch_node',
     description:
-      "Update fields on an existing node (position, name, description, detail, icon, colors, border, font, dimensions, autoSize, plus type:'icon'-only color/strokeWidth/alt and capabilities playAction/statusAction/stateSource). `type` can flip a node between any of the 12 visual variants (rectangle/ellipse/sticky/text/database/server/user/queue/cloud/image/html/icon); the post-merge schema reparse gates required fields on the new type (image.data.path, icon.data.icon). Setting detail (every node) or html (type:'html') writes the content to <project>/nodes/<id>/{detail.md|view.html}; the file:// ref on the node persists. Empty-string detail empties the file but keeps the ref.",
+      "Update fields on an existing node (position, name, description, detail, icon, colors, border, font, dimensions, autoSize, plus type:'icon'-only color/strokeWidth/alt and capabilities playAction/statusAction/stateSource). `type` can flip a node between any of the 14 visual variants (rectangle/ellipse/sticky/text/database/server/user/queue/cloud/diamond/hexagon/image/html/icon); the post-merge schema reparse gates required fields on the new type (image.data.path, icon.data.icon). Setting detail (every node) or html (type:'html') writes the content to <project>/nodes/<id>/{detail.md|view.html}; the file:// ref on the node persists. Empty-string detail empties the file but keeps the ref.",
     inputSchema: inputSchemaFromZod(PatchNodeInputSchema),
     handler: async (args) => {
       const parsed = PatchNodeInputSchema.safeParse(args);

package/src/merge.ts

@@ -32,7 +32,6 @@ export function mergeFlowAndStyle(flow: Flow, style: Style): ResolvedFlow {
     version: flow.version,
     name: flow.name,
     ...(flow.description !== undefined ? { description: flow.description } : {}),
-    ...(flow.resetAction ? { resetAction: flow.resetAction } : {}),
     nodes: mergedNodes,
     connectors: mergedConnectors,
   } as ResolvedFlow;
@@ -114,7 +113,6 @@ export function splitFlow(resolved: {
   version: number;
   name: string;
   description?: string;
-  resetAction?: unknown;
   nodes: Array<Record<string, unknown>>;
   connectors: Array<Record<string, unknown>>;
 }): { flow: Record<string, unknown>; style: Record<string, unknown> } {
@@ -187,7 +185,6 @@ export function splitFlow(resolved: {
     connectors: flowConnectors,
   };
   if (resolved.description !== undefined) flow.description = resolved.description;
-  if (resolved.resetAction !== undefined) flow.resetAction = resolved.resetAction;
 
   const style: Record<string, unknown> = {};
   if (Object.keys(styleNodes).length > 0) style.nodes = styleNodes;

package/src/operations.ts

@@ -212,6 +212,8 @@ const SEMANTIC_KEYS_BY_TYPE: Record<z.infer<typeof NodeTypeSchema>, ReadonlySet<
   user: GEOMETRIC_SEMANTIC_KEYS,
   queue: GEOMETRIC_SEMANTIC_KEYS,
   cloud: GEOMETRIC_SEMANTIC_KEYS,
+  diamond: GEOMETRIC_SEMANTIC_KEYS,
+  hexagon: GEOMETRIC_SEMANTIC_KEYS,
   image: new Set([
     'name',
     'description',
@@ -762,7 +764,6 @@ function readRawFlowAndStyle(flowPath: string): ReadRawResult {
 type MutateMergedFlowMutator<E> = (flow: {
   version: number;
   name: string;
-  resetAction?: unknown;
   nodes: Array<Record<string, unknown>>;
   connectors: Array<Record<string, unknown>>;
 }) => { kind: 'ok' } | E;
@@ -808,7 +809,6 @@ export async function mutateMergedFlow<E extends { kind: string }>(
   const merged = inlinedFlow as unknown as {
     version: number;
     name: string;
-    resetAction?: unknown;
     nodes: Array<Record<string, unknown>>;
     connectors: Array<Record<string, unknown>>;
   };

package/src/proxy.ts

@@ -16,7 +16,7 @@ import { realpathSync } from 'node:fs';
 import { join, resolve, sep } from 'node:path';
 import type { EventBus } from './events.ts';
 import { type ProcessSpawner, type SpawnHandle, defaultProcessSpawner } from './process-spawner.ts';
-import type { PlayAction, ResetAction } from './schema.ts';
+import type { PlayAction } from './schema.ts';
 import { shortId } from './short-id.ts';
 
 export interface PlayResult {
@@ -73,31 +73,6 @@ function resolveScript(cwd: string, nodeId: string, scriptPath: string): Resolve
   return { ok: true, absPath: realTarget };
 }
 
-// Legacy anchor for resetAction (kept until resetAction gets its own design
-// round). Same realpath escape check as resolveScript, but rooted at the
-// project root rather than a per-node folder.
-function resolveResetScript(cwd: string, scriptPath: string): Resolved {
-  const projectRoot = cwd;
-  let realRoot: string;
-  try {
-    realRoot = realpathSync(projectRoot);
-  } catch {
-    return { ok: false };
-  }
-  const target = resolve(projectRoot, scriptPath);
-  let realTarget: string;
-  try {
-    realTarget = realpathSync(target);
-  } catch {
-    return { ok: false };
-  }
-  const rootWithSep = realRoot.endsWith(sep) ? realRoot : realRoot + sep;
-  if (realTarget !== realRoot && !realTarget.startsWith(rootWithSep)) {
-    return { ok: false };
-  }
-  return { ok: true, absPath: realTarget };
-}
-
 // Copy `process.env` into a string-only record, then layer the per-run extras.
 // Bun.spawn's env contract is `Record<string, string>` so the undefineds that
 // `process.env` advertises in its type must be filtered out first.
@@ -130,54 +105,6 @@ async function writeStdinPayload(handle: SpawnHandle, input: unknown): Promise<v
   }
 }
 
-// Live play-script handles indexed by flowId. Populated by runPlay() on spawn;
-// entries are removed when each handle's `exited` promise resolves (success
-// AND error paths). `stopAllPlays(flowId)` consults this map to terminate
-// every in-flight play for a demo on /reset.
-const livePlayHandles = new Map<string, Set<SpawnHandle>>();
-
-function registerLiveHandle(flowId: string, handle: SpawnHandle): void {
-  let set = livePlayHandles.get(flowId);
-  if (!set) {
-    set = new Set();
-    livePlayHandles.set(flowId, set);
-  }
-  set.add(handle);
-  handle.exited.finally(() => {
-    const current = livePlayHandles.get(flowId);
-    if (!current) return;
-    current.delete(handle);
-    if (current.size === 0) livePlayHandles.delete(flowId);
-  });
-}
-
-async function killWithGrace(handle: SpawnHandle): Promise<void> {
-  handle.kill('SIGTERM');
-  let graceTimer: ReturnType<typeof setTimeout> | undefined;
-  const gracePromise = new Promise<'grace'>((res) => {
-    graceTimer = setTimeout(() => res('grace'), SIGKILL_GRACE_MS);
-  });
-  const winner = await Promise.race([handle.exited.then(() => 'exited' as const), gracePromise]);
-  if (graceTimer) clearTimeout(graceTimer);
-  if (winner === 'grace') {
-    handle.kill('SIGKILL');
-    await handle.exited;
-  }
-}
-
-// Kill every live play-script for `flowId` (SIGTERM → 2s grace → SIGKILL in
-// parallel) and wait for each to exit. Idempotent on an unknown flowId. The
-// map is keyed by flowId so a stop on demo A never touches demo B.
-export async function stopAllPlays(flowId: string): Promise<void> {
-  const set = livePlayHandles.get(flowId);
-  if (!set || set.size === 0) return;
-  const handles = [...set];
-  // Clear eagerly so a parallel runPlay can't double-count an entry we're
-  // about to await on. The exited.finally() will no-op the second delete.
-  livePlayHandles.delete(flowId);
-  await Promise.all(handles.map((h) => killWithGrace(h)));
-}
-
 export async function runPlay(options: RunPlayOptions): Promise<PlayResult> {
   const { events, flowId, nodeId, cwd, action } = options;
   const spawner = options.spawner ?? defaultProcessSpawner;
@@ -229,8 +156,6 @@ export async function runPlay(options: RunPlayOptions): Promise<PlayResult> {
     return { runId, error: message };
   }
 
-  registerLiveHandle(flowId, handle);
-
   // Drain stdout AND stderr CONCURRENTLY with the process running so OS pipe
   // buffers (~64 KB) don't fill up and deadlock the child.
   const stdoutPromise = new Response(handle.stdout).text();
@@ -303,120 +228,3 @@ export async function runPlay(options: RunPlayOptions): Promise<PlayResult> {
   });
   return { runId, error: message };
 }
-
-export interface RunResetOptions {
-  events: EventBus;
-  flowId: string;
-  /** Project root (`<repoPath>`). Script resolves under `<cwd>/`. */
-  cwd: string;
-  action: ResetAction;
-  /** Injectable for tests; defaults to `defaultProcessSpawner`. */
-  spawner?: ProcessSpawner;
-}
-
-export interface ResetResult {
-  ok: boolean;
-  body?: unknown;
-  error?: string;
-}
-
-// Run the demo's one-shot `resetAction` script. Same spawn discipline as
-// runPlay (realpath-guarded scriptPath, concurrent stdout/stderr drain,
-// optional stdin payload, SIGTERM→2s→SIGKILL escalation on timeout) but the
-// lifecycle SSE event is the single `demo:reset` broadcast that mirrors the
-// returned shape. Callers (the /reset endpoint) decide what HTTP status to
-// surface; this returns `{ ok }` plus body/error so the endpoint can map.
-export async function runReset(options: RunResetOptions): Promise<ResetResult> {
-  const { events, flowId, cwd, action } = options;
-  const spawner = options.spawner ?? defaultProcessSpawner;
-
-  // resetAction is anchored at the project root — design defers per-node
-  // resetAction to a later round (decision #7).
-  const resolved = resolveResetScript(cwd, action.scriptPath);
-  if (!resolved.ok) {
-    events.broadcast({
-      type: 'demo:reset',
-      flowId,
-      payload: { ok: false, error: SCRIPT_PATH_ESCAPE },
-    });
-    return { ok: false, error: SCRIPT_PATH_ESCAPE };
-  }
-
-  const wantsStdin = action.input !== undefined;
-  const env = buildChildEnv({ SEEFLOW_DEMO_ID: flowId });
-
-  let handle: SpawnHandle;
-  try {
-    handle = spawner.spawn({
-      cmd: [action.interpreter, ...(action.args ?? []), resolved.absPath],
-      cwd,
-      env,
-      stdin: wantsStdin ? 'pipe' : 'ignore',
-    });
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    events.broadcast({
-      type: 'demo:reset',
-      flowId,
-      payload: { ok: false, error: message },
-    });
-    return { ok: false, error: message };
-  }
-
-  const stdoutPromise = new Response(handle.stdout).text();
-  const stderrPromise = new Response(handle.stderr).text();
-
-  if (wantsStdin) {
-    await writeStdinPayload(handle, action.input);
-  }
-
-  const timeoutMs = action.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-  let timer: ReturnType<typeof setTimeout> | undefined;
-  const timeoutPromise = new Promise<'timeout'>((res) => {
-    timer = setTimeout(() => res('timeout'), timeoutMs);
-  });
-  const exitPromise = handle.exited.then((code) => ({ code }) as const);
-
-  const race = await Promise.race([exitPromise, timeoutPromise]);
-  if (timer) clearTimeout(timer);
-
-  if (race === 'timeout') {
-    await killWithGrace(handle);
-    await Promise.allSettled([stdoutPromise, stderrPromise]);
-    const message = `reset script timed out after ${timeoutMs}ms`;
-    events.broadcast({
-      type: 'demo:reset',
-      flowId,
-      payload: { ok: false, error: message },
-    });
-    return { ok: false, error: message };
-  }
-
-  const code = race.code;
-  const [stdout, stderr] = await Promise.all([stdoutPromise, stderrPromise]);
-
-  if (code === 0) {
-    let body: unknown;
-    try {
-      body = JSON.parse(stdout);
-    } catch {
-      body = stdout;
-    }
-    events.broadcast({
-      type: 'demo:reset',
-      flowId,
-      payload: { ok: true, body },
-    });
-    return { ok: true, body };
-  }
-
-  const lastLine = lastNonEmptyLine(stderr);
-  const truncated = lastLine.slice(0, STDERR_TRUNCATE);
-  const message = truncated.length > 0 ? truncated : `reset script exited with code ${code}`;
-  events.broadcast({
-    type: 'demo:reset',
-    flowId,
-    payload: { ok: false, error: message },
-  });
-  return { ok: false, error: message };
-}

package/src/schema-catalog.ts

@@ -15,8 +15,10 @@ import {
   FlowComponentNodeSchema,
   FlowConnectorSchema,
   FlowDatabaseNodeSchema,
+  FlowDiamondNodeSchema,
   FlowEllipseNodeSchema,
   FlowEnvelopeSchema,
+  FlowHexagonNodeSchema,
   FlowHtmlNodeSchema,
   FlowIconNodeSchema,
   FlowImageNodeSchema,
@@ -27,7 +29,6 @@ import {
   FlowTextNodeSchema,
   FlowUserNodeSchema,
   PlayActionSchema,
-  ResetActionSchema,
   StatusActionSchema,
   StatusReportSchema,
   StyleSchema,
@@ -63,7 +64,7 @@ const CATEGORIES: SchemaCategory[] = [
   {
     name: 'action',
     description:
-      'playAction, statusAction, resetAction, statusReport, plus componentAction (the set | script discriminated union dispatched on component-node action handles).',
+      'playAction, statusAction, statusReport, plus componentAction (the set | script discriminated union dispatched on component-node action handles).',
   },
   {
     name: 'componentSpec',
@@ -89,6 +90,8 @@ const PAYLOADS: Record<string, SchemaPayload> = {
       user: toJsonSchema(FlowUserNodeSchema),
       queue: toJsonSchema(FlowQueueNodeSchema),
       cloud: toJsonSchema(FlowCloudNodeSchema),
+      diamond: toJsonSchema(FlowDiamondNodeSchema),
+      hexagon: toJsonSchema(FlowHexagonNodeSchema),
       image: toJsonSchema(FlowImageNodeSchema),
       html: toJsonSchema(FlowHtmlNodeSchema),
       icon: toJsonSchema(FlowIconNodeSchema),
@@ -112,7 +115,6 @@ const PAYLOADS: Record<string, SchemaPayload> = {
     schemas: {
       playAction: toJsonSchema(PlayActionSchema),
       statusAction: toJsonSchema(StatusActionSchema),
-      resetAction: toJsonSchema(ResetActionSchema),
       statusReport: toJsonSchema(StatusReportSchema),
       componentAction: toJsonSchema(ComponentActionSchema),
     },

package/src/schema.ts

@@ -18,6 +18,7 @@ export const ColorTokenSchema = z.enum([
   // and edges aren't useful, and `'default'` already covers "inherit".
   'none',
   'default',
+  'white',
   'slate',
   'gray',
   'red',
@@ -115,9 +116,6 @@ export const ScriptActionSchema = z.object({
 
 export const PlayActionSchema = ScriptActionSchema;
 
-// resetAction is a one-shot script with the same shape as a play script.
-export const ResetActionSchema = ScriptActionSchema;
-
 // Long-running status script. Same spawn shape as ScriptAction (interpreter +
 // args + scriptPath) but no stdin payload and a much longer max lifetime since
 // these processes tick continuously and stream StatusReports to stdout.
@@ -182,7 +180,7 @@ const NodeCapabilitiesShape = {
     ),
 };
 
-// 13 flat node types. The first 9 are geometric/illustrative and share
+// 15 flat node types. The first 11 are geometric/illustrative and share
 // GeometricNodeData. `image`, `html`, `icon`, `component` carry per-type
 // fields. The renderer picks the SVG / chrome by `type`; the schema treats
 // them (apart from the per-type fields below) as identical.
@@ -196,6 +194,8 @@ export const GEOMETRIC_NODE_TYPES = [
   'user',
   'queue',
   'cloud',
+  'diamond',
+  'hexagon',
 ] as const;
 
 export const NodeTypeSchema = z.enum([
@@ -331,6 +331,8 @@ const NodeSchema = z.discriminatedUnion('type', [
   makeResolvedGeometricSchema('user'),
   makeResolvedGeometricSchema('queue'),
   makeResolvedGeometricSchema('cloud'),
+  makeResolvedGeometricSchema('diamond'),
+  makeResolvedGeometricSchema('hexagon'),
   z.object({ ...NodeBaseShape, type: z.literal('image'), data: ResolvedImageNodeData }),
   z.object({ ...NodeBaseShape, type: z.literal('html'), data: ResolvedHtmlNodeData }),
   z.object({ ...NodeBaseShape, type: z.literal('icon'), data: ResolvedIconNodeData }),
@@ -395,10 +397,6 @@ export const ResolvedFlowSchema = z
     description: z.string().optional(),
     nodes: z.array(NodeSchema),
     connectors: z.array(ConnectorSchema),
-    // Optional one-shot script the studio runs when the user clicks Restart.
-    // The studio kills every live play + status script for the flow BEFORE
-    // invoking this script, so the script sees no stragglers.
-    resetAction: ResetActionSchema.optional(),
   })
   .superRefine((resolved, ctx) => {
     const nodeIds = new Set(resolved.nodes.map((n) => n.id));
@@ -476,7 +474,6 @@ export type EdgePinSide = z.infer<typeof EdgePinSideSchema>;
 export type PlayAction = z.infer<typeof PlayActionSchema>;
 export type StatusAction = z.infer<typeof StatusActionSchema>;
 export type StatusReport = z.infer<typeof StatusReportSchema>;
-export type ResetAction = z.infer<typeof ResetActionSchema>;
 export type StateSource = z.infer<typeof StateSourceSchema>;
 
 // =============================================================================
@@ -577,6 +574,8 @@ export const FlowServerNodeSchema = makeFlowGeometricSchema('server');
 export const FlowUserNodeSchema = makeFlowGeometricSchema('user');
 export const FlowQueueNodeSchema = makeFlowGeometricSchema('queue');
 export const FlowCloudNodeSchema = makeFlowGeometricSchema('cloud');
+export const FlowDiamondNodeSchema = makeFlowGeometricSchema('diamond');
+export const FlowHexagonNodeSchema = makeFlowGeometricSchema('hexagon');
 
 export const FlowImageNodeSchema = z
   .object({
@@ -620,6 +619,8 @@ const FlowNodeSchema = z.discriminatedUnion('type', [
   FlowUserNodeSchema,
   FlowQueueNodeSchema,
   FlowCloudNodeSchema,
+  FlowDiamondNodeSchema,
+  FlowHexagonNodeSchema,
   FlowImageNodeSchema,
   FlowHtmlNodeSchema,
   FlowIconNodeSchema,
@@ -648,7 +649,6 @@ export const FlowSchema = z
     version: z.literal(2),
     name: z.string().min(1),
     description: z.string().optional(),
-    resetAction: ResetActionSchema.optional(),
     nodes: z.array(FlowNodeSchema),
     connectors: z.array(FlowConnectorSchema),
   })
@@ -687,7 +687,6 @@ export const FlowEnvelopeSchema = z
     version: z.literal(2),
     name: z.string().min(1),
     description: z.string().optional(),
-    resetAction: ResetActionSchema.optional(),
     nodes: z.array(z.unknown().describe('See `seeflow schema node`')),
     connectors: z.array(z.unknown().describe('See `seeflow schema connector`')),
   })

package/src/server.ts

@@ -52,8 +52,7 @@ export interface CreateAppOptions {
    *  proxy.ts pick `defaultProcessSpawner`. Tests use this to drive runPlay
    *  with an in-memory fake spawner. */
   processSpawner?: ProcessSpawner;
-  /** Inject a ProxyFacade — tests use this to short-circuit runPlay /
-   *  runReset / stopAllPlays and assert call order. */
+  /** Inject a ProxyFacade — tests use this to short-circuit runPlay. */
   proxy?: ProxyFacade;
   /** Per-process token gating `Origin: null` requests (sandboxed MCP App
    *  iframe). Generated at studio boot; delivered to the iframe via

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

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

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

@@ -1 +0,0 @@
-import{s as a,a as s,c as e,C as t}from"./chunk-727SXJPM-ZXC_1s3s.js";import{a as i}from"./mermaid.core-ClLm1p66.js";import"./index-Cnz1Cpa9.js";import"./chunk-FMBD7UC4-D8IemyXd.js";import"./chunk-ND2GUHAM-aT_PIEvu.js";import"./chunk-55IACEB6-CZ6tcHFC.js";import"./chunk-2J33WTMH-CQFLt-Og.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-mwGbzVrI.js

@@ -1 +0,0 @@
-import{s as a,a as s,c as e,C as t}from"./chunk-727SXJPM-ZXC_1s3s.js";import{a as i}from"./mermaid.core-ClLm1p66.js";import"./index-Cnz1Cpa9.js";import"./chunk-FMBD7UC4-D8IemyXd.js";import"./chunk-ND2GUHAM-aT_PIEvu.js";import"./chunk-55IACEB6-CZ6tcHFC.js";import"./chunk-2J33WTMH-CQFLt-Og.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};