@synergenius/flow-weaver 0.22.0 → 0.22.3

package/dist/doc-metadata/extractors/core-metadata.js

@@ -0,0 +1,61 @@
+/**
+ * Core metadata extractor.
+ *
+ * Provides runtime-accessible arrays and objects for data types, strategies,
+ * reserved names, templates, and package exports — derived from the actual
+ * source constants so documentation stays in sync automatically.
+ */
+import { RESERVED_NODE_NAMES, RESERVED_PORT_NAMES, SCOPED_PORT_NAMES, EXECUTION_STRATEGIES, BRANCHING_STRATEGIES, VALID_NODE_COLORS, } from '../../constants.js';
+import { workflowTemplates, nodeTemplates, } from '../../cli/templates/index.js';
+// ── Data Types ──────────────────────────────────────────────────────────
+/** All supported port data types (runtime array, mirrors TDataType union). */
+export const DATA_TYPES = [
+    'STRING',
+    'NUMBER',
+    'BOOLEAN',
+    'OBJECT',
+    'ARRAY',
+    'FUNCTION',
+    'STEP',
+    'ANY',
+];
+/** All supported merge strategies (runtime array, mirrors TMergeStrategy union). */
+export const MERGE_STRATEGIES = ['FIRST', 'LAST', 'COLLECT', 'MERGE', 'CONCAT'];
+/** All supported branching strategies (runtime array, mirrors TBranchingStrategy union). */
+export const BRANCHING_STRATEGY_VALUES = ['value-based', 'exception-based', 'none'];
+/** All supported execution strategies (runtime array, mirrors TExecuteWhen union). */
+export const EXECUTION_STRATEGY_VALUES = ['CONJUNCTION', 'DISJUNCTION', 'CUSTOM'];
+// ── Reserved Names ──────────────────────────────────────────────────────
+export { RESERVED_NODE_NAMES, RESERVED_PORT_NAMES, SCOPED_PORT_NAMES };
+export { EXECUTION_STRATEGIES, BRANCHING_STRATEGIES, VALID_NODE_COLORS };
+/** All registered workflow templates (id, name, description, category). */
+export const WORKFLOW_TEMPLATES = workflowTemplates.map(({ id, name, description, category }) => ({ id, name, description, category }));
+/** All registered node templates (id, name, description, category). */
+export const NODE_TEMPLATES = nodeTemplates.map(({ id, name, description, category }) => ({ id, name, description, category }));
+// ── Package Exports ─────────────────────────────────────────────────────
+/** All named export subpaths from @synergenius/flow-weaver/package.json. */
+export const PACKAGE_EXPORTS = [
+    { subpath: '.', description: 'Core library (parser, validator, compiler)' },
+    { subpath: './runtime', description: 'Workflow runtime executor' },
+    { subpath: './built-in-nodes', description: 'Standard node type library' },
+    { subpath: './diagram', description: 'Diagram rendering (SVG/Mermaid)' },
+    { subpath: './describe', description: 'Workflow description formatter' },
+    { subpath: './doc-metadata', description: 'Documentation metadata extractors' },
+    { subpath: './docs', description: 'Documentation generation utilities' },
+    { subpath: './ast', description: 'AST type definitions and builders' },
+    { subpath: './api', description: 'Public API (parseWorkflow, validateWorkflow, etc.)' },
+    { subpath: './diff', description: 'Workflow semantic diff engine' },
+    { subpath: './editor', description: 'Editor completions and diagnostics' },
+    { subpath: './browser', description: 'Browser-compatible JSDoc port sync' },
+    { subpath: './generated-branding', description: 'Generated branding configuration' },
+    { subpath: './npm-packages', description: 'NPM package metadata' },
+    { subpath: './deployment', description: 'Deployment target configurations' },
+    { subpath: './marketplace', description: 'Extension/pack marketplace APIs' },
+    { subpath: './testing', description: 'Testing utilities' },
+    { subpath: './generator', description: 'Code generation' },
+    { subpath: './constants', description: 'Constants and reserved names' },
+    { subpath: './cli', description: 'CLI command definitions' },
+    { subpath: './executor', description: 'MCP workflow executor' },
+    { subpath: './context', description: 'LLM context generation' },
+];
+//# sourceMappingURL=core-metadata.js.map

package/dist/doc-metadata/index.d.ts

@@ -7,4 +7,6 @@ export type { TValidationCodeDoc } from './extractors/error-codes.js';
 export { extractGrammarEBNF, extractTerminals } from './extractors/grammar-rules.js';
 export type { TGrammarGroupDoc, TTerminalDoc } from './extractors/grammar-rules.js';
 export type { TMcpToolDoc, TMcpToolParam, TPluginApiFieldDoc, TCliCommandDoc, TCliOptionDoc } from './types.js';
+export { DATA_TYPES, MERGE_STRATEGIES, BRANCHING_STRATEGY_VALUES, EXECUTION_STRATEGY_VALUES, RESERVED_NODE_NAMES, RESERVED_PORT_NAMES, SCOPED_PORT_NAMES, EXECUTION_STRATEGIES, BRANCHING_STRATEGIES, VALID_NODE_COLORS, WORKFLOW_TEMPLATES, NODE_TEMPLATES, PACKAGE_EXPORTS, } from './extractors/core-metadata.js';
+export type { TemplateSummary } from './extractors/core-metadata.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/doc-metadata/index.js

@@ -4,4 +4,6 @@ export { PLUGIN_DEFINITION_FIELDS, PLUGIN_CAPABILITIES, PLUGIN_COMPONENT_CONFIG_
 export { ALL_ANNOTATIONS, PORT_MODIFIERS, NODE_MODIFIERS, } from './extractors/annotations.js';
 export { VALIDATION_CODES } from './extractors/error-codes.js';
 export { extractGrammarEBNF, extractTerminals } from './extractors/grammar-rules.js';
+// Core metadata — data types, strategies, reserved names, templates, package exports
+export { DATA_TYPES, MERGE_STRATEGIES, BRANCHING_STRATEGY_VALUES, EXECUTION_STRATEGY_VALUES, RESERVED_NODE_NAMES, RESERVED_PORT_NAMES, SCOPED_PORT_NAMES, EXECUTION_STRATEGIES, BRANCHING_STRATEGIES, VALID_NODE_COLORS, WORKFLOW_TEMPLATES, NODE_TEMPLATES, PACKAGE_EXPORTS, } from './extractors/core-metadata.js';
 //# sourceMappingURL=index.js.map

package/dist/generated-version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.22.0";
+export declare const VERSION = "0.22.3";
 //# sourceMappingURL=generated-version.d.ts.map

package/dist/generated-version.js

@@ -1,3 +1,3 @@
 // Auto-generated by scripts/generate-version.ts — do not edit manually
-export const VERSION = '0.22.0';
+export const VERSION = '0.22.3';
 //# sourceMappingURL=generated-version.js.map

package/dist/generator/unified.js

@@ -816,6 +816,10 @@ isAsync = false) {
         const safeId = toValidIdentifier(instanceId);
         // Add execution index for this skipped node so the event has a valid reference
         lines.push(`${indent}const ${safeId}Idx = ${ctxVar}.addExecution('${instanceId}');`);
+        // Set STEP port variables so downstream nodes reading onSuccess/onFailure
+        // from this cancelled node don't crash with "Variable not found".
+        lines.push(`${indent}${awaitPrefix}${ctxVar}.setVariable({ id: '${instanceId}', portName: 'onSuccess', executionIndex: ${safeId}Idx, nodeTypeName: '${instance.nodeType}' }, false);`);
+        lines.push(`${indent}${awaitPrefix}${ctxVar}.setVariable({ id: '${instanceId}', portName: 'onFailure', executionIndex: ${safeId}Idx, nodeTypeName: '${instance.nodeType}' }, false);`);
         lines.push(`${indent}${awaitPrefix}${ctxVar}.sendStatusChangedEvent({`);
         lines.push(`${indent}  nodeTypeName: '${instance.nodeType}',`);
         lines.push(`${indent}  id: '${instanceId}',`);

package/dist/runtime/debug-controller.d.ts

@@ -37,6 +37,15 @@ export type DebugResumeAction = {
 } | {
     type: 'abort';
 };
+/**
+ * Minimal interface for the debug controller as referenced by generated code.
+ * The full DebugController class implements this, but generated code only
+ * needs beforeNode/afterNode — so this type is what gets imported.
+ */
+export type TDebugController = {
+    beforeNode(nodeId: string, ctx: GeneratedExecutionContext): Promise<boolean> | boolean;
+    afterNode(nodeId: string, ctx: GeneratedExecutionContext): Promise<void> | void;
+};
 export interface DebugControllerConfig {
     /** Enable step-through debugging (pauses before first node) */
     debug?: boolean;

package/dist/runtime/index.d.ts

@@ -1,7 +1,7 @@
 export { GeneratedExecutionContext } from "./ExecutionContext.js";
 export { CancellationError } from "./CancellationError.js";
 export { DebugController } from "./debug-controller.js";
-export type { DebugMode, DebugPauseState, DebugResumeAction, DebugControllerConfig } from "./debug-controller.js";
+export type { TDebugController, DebugMode, DebugPauseState, DebugResumeAction, DebugControllerConfig } from "./debug-controller.js";
 export { CheckpointWriter, loadCheckpoint, findLatestCheckpoint } from "./checkpoint.js";
 export type { CheckpointData } from "./checkpoint.js";
 export * from "./events.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synergenius/flow-weaver",
-  "version": "0.22.0",
+  "version": "0.22.3",
   "description": "Deterministic workflow compiler for AI agents. Compiles to standalone TypeScript, no runtime dependencies.",
   "private": false,
   "type": "module",