yaml-flow 7.0.0 → 8.0.0

package/dist/stores/localStorage.cjs

@@ -1,2 +0,0 @@
-'use strict';var i=class{prefix;constructor(t={}){if(this.prefix=t.prefix??"yamlflow",typeof localStorage>"u")throw new Error("LocalStorageStore requires localStorage (browser environment)")}runKey(t){return `${this.prefix}:run:${t}`}dataKey(t){return `${this.prefix}:data:${t}`}indexKey(){return `${this.prefix}:runs`}async saveRunState(t,e){localStorage.setItem(this.runKey(t),JSON.stringify(e));let r=await this.listRuns();r.includes(t)||(r.push(t),localStorage.setItem(this.indexKey(),JSON.stringify(r)));}async loadRunState(t){let e=localStorage.getItem(this.runKey(t));return e?JSON.parse(e):null}async deleteRunState(t){localStorage.removeItem(this.runKey(t)),localStorage.removeItem(this.dataKey(t));let r=(await this.listRuns()).filter(a=>a!==t);localStorage.setItem(this.indexKey(),JSON.stringify(r));}async setData(t,e,r){let a=await this.getAllData(t);a[e]=r,localStorage.setItem(this.dataKey(t),JSON.stringify(a));}async getData(t,e){return (await this.getAllData(t))[e]}async getAllData(t){let e=localStorage.getItem(this.dataKey(t));return e?JSON.parse(e):{}}async clearData(t){localStorage.removeItem(this.dataKey(t));}async listRuns(){let t=localStorage.getItem(this.indexKey());return t?JSON.parse(t):[]}clearAll(){let t=[];for(let e=0;e<localStorage.length;e++){let r=localStorage.key(e);r?.startsWith(this.prefix+":")&&t.push(r);}t.forEach(e=>localStorage.removeItem(e));}};exports.LocalStorageStore=i;//# sourceMappingURL=localStorage.cjs.map
-//# sourceMappingURL=localStorage.cjs.map

package/dist/stores/localStorage.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/stores/localStorage.ts"],"names":["LocalStorageStore","options","runId","state","runs","raw","filtered","id","key","value","allData","keysToRemove","i"],"mappings":"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","file":"localStorage.cjs","sourcesContent":["/**\n * yaml-flow - LocalStorage Store\n * \n * Browser localStorage-based store implementation.\n * Data persists across page reloads but is limited to ~5MB per origin.\n */\n\nimport type { StepMachineStore, StepMachineState } from '../step-machine/types.js';\n\nexport interface LocalStorageStoreOptions {\n  /** Key prefix for namespacing (default: 'yamlflow') */\n  prefix?: string;\n}\n\nexport class LocalStorageStore implements StepMachineStore {\n  private prefix: string;\n\n  constructor(options: LocalStorageStoreOptions = {}) {\n    this.prefix = options.prefix ?? 'yamlflow';\n    \n    // Ensure localStorage is available\n    if (typeof localStorage === 'undefined') {\n      throw new Error('LocalStorageStore requires localStorage (browser environment)');\n    }\n  }\n\n  private runKey(runId: string): string {\n    return `${this.prefix}:run:${runId}`;\n  }\n\n  private dataKey(runId: string): string {\n    return `${this.prefix}:data:${runId}`;\n  }\n\n  private indexKey(): string {\n    return `${this.prefix}:runs`;\n  }\n\n  async saveRunState(runId: string, state: StepMachineState): Promise<void> {\n    localStorage.setItem(this.runKey(runId), JSON.stringify(state));\n    \n    // Update run index\n    const runs = await this.listRuns();\n    if (!runs.includes(runId)) {\n      runs.push(runId);\n      localStorage.setItem(this.indexKey(), JSON.stringify(runs));\n    }\n  }\n\n  async loadRunState(runId: string): Promise<StepMachineState | null> {\n    const raw = localStorage.getItem(this.runKey(runId));\n    return raw ? JSON.parse(raw) : null;\n  }\n\n  async deleteRunState(runId: string): Promise<void> {\n    localStorage.removeItem(this.runKey(runId));\n    localStorage.removeItem(this.dataKey(runId));\n    \n    // Update run index\n    const runs = await this.listRuns();\n    const filtered = runs.filter(id => id !== runId);\n    localStorage.setItem(this.indexKey(), JSON.stringify(filtered));\n  }\n\n  async setData(runId: string, key: string, value: unknown): Promise<void> {\n    const allData = await this.getAllData(runId);\n    allData[key] = value;\n    localStorage.setItem(this.dataKey(runId), JSON.stringify(allData));\n  }\n\n  async getData(runId: string, key: string): Promise<unknown> {\n    const allData = await this.getAllData(runId);\n    return allData[key];\n  }\n\n  async getAllData(runId: string): Promise<Record<string, unknown>> {\n    const raw = localStorage.getItem(this.dataKey(runId));\n    return raw ? JSON.parse(raw) : {};\n  }\n\n  async clearData(runId: string): Promise<void> {\n    localStorage.removeItem(this.dataKey(runId));\n  }\n\n  async listRuns(): Promise<string[]> {\n    const raw = localStorage.getItem(this.indexKey());\n    return raw ? JSON.parse(raw) : [];\n  }\n\n  /**\n   * Clear all flow data from localStorage\n   */\n  clearAll(): void {\n    const keysToRemove: string[] = [];\n    \n    for (let i = 0; i < localStorage.length; i++) {\n      const key = localStorage.key(i);\n      if (key?.startsWith(this.prefix + ':')) {\n        keysToRemove.push(key);\n      }\n    }\n    \n    keysToRemove.forEach(key => localStorage.removeItem(key));\n  }\n}\n"]}

package/dist/stores/localStorage.d.cts

@@ -1,34 +0,0 @@
-import { l as StepMachineStore, k as StepMachineState } from '../types-ycun84cq.cjs';
-
-/**
- * yaml-flow - LocalStorage Store
- *
- * Browser localStorage-based store implementation.
- * Data persists across page reloads but is limited to ~5MB per origin.
- */
-
-interface LocalStorageStoreOptions {
-    /** Key prefix for namespacing (default: 'yamlflow') */
-    prefix?: string;
-}
-declare class LocalStorageStore implements StepMachineStore {
-    private prefix;
-    constructor(options?: LocalStorageStoreOptions);
-    private runKey;
-    private dataKey;
-    private indexKey;
-    saveRunState(runId: string, state: StepMachineState): Promise<void>;
-    loadRunState(runId: string): Promise<StepMachineState | null>;
-    deleteRunState(runId: string): Promise<void>;
-    setData(runId: string, key: string, value: unknown): Promise<void>;
-    getData(runId: string, key: string): Promise<unknown>;
-    getAllData(runId: string): Promise<Record<string, unknown>>;
-    clearData(runId: string): Promise<void>;
-    listRuns(): Promise<string[]>;
-    /**
-     * Clear all flow data from localStorage
-     */
-    clearAll(): void;
-}
-
-export { LocalStorageStore, type LocalStorageStoreOptions };

package/dist/stores/localStorage.d.ts

@@ -1,34 +0,0 @@
-import { l as StepMachineStore, k as StepMachineState } from '../types-ycun84cq.js';
-
-/**
- * yaml-flow - LocalStorage Store
- *
- * Browser localStorage-based store implementation.
- * Data persists across page reloads but is limited to ~5MB per origin.
- */
-
-interface LocalStorageStoreOptions {
-    /** Key prefix for namespacing (default: 'yamlflow') */
-    prefix?: string;
-}
-declare class LocalStorageStore implements StepMachineStore {
-    private prefix;
-    constructor(options?: LocalStorageStoreOptions);
-    private runKey;
-    private dataKey;
-    private indexKey;
-    saveRunState(runId: string, state: StepMachineState): Promise<void>;
-    loadRunState(runId: string): Promise<StepMachineState | null>;
-    deleteRunState(runId: string): Promise<void>;
-    setData(runId: string, key: string, value: unknown): Promise<void>;
-    getData(runId: string, key: string): Promise<unknown>;
-    getAllData(runId: string): Promise<Record<string, unknown>>;
-    clearData(runId: string): Promise<void>;
-    listRuns(): Promise<string[]>;
-    /**
-     * Clear all flow data from localStorage
-     */
-    clearAll(): void;
-}
-
-export { LocalStorageStore, type LocalStorageStoreOptions };

package/dist/stores/localStorage.js

@@ -1,2 +0,0 @@
-var i=class{prefix;constructor(t={}){if(this.prefix=t.prefix??"yamlflow",typeof localStorage>"u")throw new Error("LocalStorageStore requires localStorage (browser environment)")}runKey(t){return `${this.prefix}:run:${t}`}dataKey(t){return `${this.prefix}:data:${t}`}indexKey(){return `${this.prefix}:runs`}async saveRunState(t,e){localStorage.setItem(this.runKey(t),JSON.stringify(e));let r=await this.listRuns();r.includes(t)||(r.push(t),localStorage.setItem(this.indexKey(),JSON.stringify(r)));}async loadRunState(t){let e=localStorage.getItem(this.runKey(t));return e?JSON.parse(e):null}async deleteRunState(t){localStorage.removeItem(this.runKey(t)),localStorage.removeItem(this.dataKey(t));let r=(await this.listRuns()).filter(a=>a!==t);localStorage.setItem(this.indexKey(),JSON.stringify(r));}async setData(t,e,r){let a=await this.getAllData(t);a[e]=r,localStorage.setItem(this.dataKey(t),JSON.stringify(a));}async getData(t,e){return (await this.getAllData(t))[e]}async getAllData(t){let e=localStorage.getItem(this.dataKey(t));return e?JSON.parse(e):{}}async clearData(t){localStorage.removeItem(this.dataKey(t));}async listRuns(){let t=localStorage.getItem(this.indexKey());return t?JSON.parse(t):[]}clearAll(){let t=[];for(let e=0;e<localStorage.length;e++){let r=localStorage.key(e);r?.startsWith(this.prefix+":")&&t.push(r);}t.forEach(e=>localStorage.removeItem(e));}};export{i as LocalStorageStore};//# sourceMappingURL=localStorage.js.map
-//# sourceMappingURL=localStorage.js.map

package/dist/stores/localStorage.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/stores/localStorage.ts"],"names":["LocalStorageStore","options","runId","state","runs","raw","filtered","id","key","value","allData","keysToRemove","i"],"mappings":"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","file":"localStorage.js","sourcesContent":["/**\n * yaml-flow - LocalStorage Store\n * \n * Browser localStorage-based store implementation.\n * Data persists across page reloads but is limited to ~5MB per origin.\n */\n\nimport type { StepMachineStore, StepMachineState } from '../step-machine/types.js';\n\nexport interface LocalStorageStoreOptions {\n  /** Key prefix for namespacing (default: 'yamlflow') */\n  prefix?: string;\n}\n\nexport class LocalStorageStore implements StepMachineStore {\n  private prefix: string;\n\n  constructor(options: LocalStorageStoreOptions = {}) {\n    this.prefix = options.prefix ?? 'yamlflow';\n    \n    // Ensure localStorage is available\n    if (typeof localStorage === 'undefined') {\n      throw new Error('LocalStorageStore requires localStorage (browser environment)');\n    }\n  }\n\n  private runKey(runId: string): string {\n    return `${this.prefix}:run:${runId}`;\n  }\n\n  private dataKey(runId: string): string {\n    return `${this.prefix}:data:${runId}`;\n  }\n\n  private indexKey(): string {\n    return `${this.prefix}:runs`;\n  }\n\n  async saveRunState(runId: string, state: StepMachineState): Promise<void> {\n    localStorage.setItem(this.runKey(runId), JSON.stringify(state));\n    \n    // Update run index\n    const runs = await this.listRuns();\n    if (!runs.includes(runId)) {\n      runs.push(runId);\n      localStorage.setItem(this.indexKey(), JSON.stringify(runs));\n    }\n  }\n\n  async loadRunState(runId: string): Promise<StepMachineState | null> {\n    const raw = localStorage.getItem(this.runKey(runId));\n    return raw ? JSON.parse(raw) : null;\n  }\n\n  async deleteRunState(runId: string): Promise<void> {\n    localStorage.removeItem(this.runKey(runId));\n    localStorage.removeItem(this.dataKey(runId));\n    \n    // Update run index\n    const runs = await this.listRuns();\n    const filtered = runs.filter(id => id !== runId);\n    localStorage.setItem(this.indexKey(), JSON.stringify(filtered));\n  }\n\n  async setData(runId: string, key: string, value: unknown): Promise<void> {\n    const allData = await this.getAllData(runId);\n    allData[key] = value;\n    localStorage.setItem(this.dataKey(runId), JSON.stringify(allData));\n  }\n\n  async getData(runId: string, key: string): Promise<unknown> {\n    const allData = await this.getAllData(runId);\n    return allData[key];\n  }\n\n  async getAllData(runId: string): Promise<Record<string, unknown>> {\n    const raw = localStorage.getItem(this.dataKey(runId));\n    return raw ? JSON.parse(raw) : {};\n  }\n\n  async clearData(runId: string): Promise<void> {\n    localStorage.removeItem(this.dataKey(runId));\n  }\n\n  async listRuns(): Promise<string[]> {\n    const raw = localStorage.getItem(this.indexKey());\n    return raw ? JSON.parse(raw) : [];\n  }\n\n  /**\n   * Clear all flow data from localStorage\n   */\n  clearAll(): void {\n    const keysToRemove: string[] = [];\n    \n    for (let i = 0; i < localStorage.length; i++) {\n      const key = localStorage.key(i);\n      if (key?.startsWith(this.prefix + ':')) {\n        keysToRemove.push(key);\n      }\n    }\n    \n    keysToRemove.forEach(key => localStorage.removeItem(key));\n  }\n}\n"]}

package/dist/stores/memory.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/stores/memory.ts"],"names":["MemoryStore","runId","state","key","value","runData"],"mappings":"aASO,IAAMA,CAAAA,CAAN,KAA8C,CAC3C,IAAA,CAAsC,IAAI,GAAA,CAC1C,IAAA,CAA6C,IAAI,GAAA,CAEzD,MAAM,YAAA,CAAaC,CAAAA,CAAeC,CAAAA,CAAwC,CACxE,KAAK,IAAA,CAAK,GAAA,CAAID,CAAAA,CAAO,CAAE,GAAGC,CAAM,CAAC,EACnC,CAEA,MAAM,YAAA,CAAaD,CAAAA,CAAiD,CAClE,IAAMC,CAAAA,CAAQ,IAAA,CAAK,IAAA,CAAK,GAAA,CAAID,CAAK,CAAA,CACjC,OAAOC,CAAAA,CAAQ,CAAE,GAAGA,CAAM,CAAA,CAAI,IAChC,CAEA,MAAM,cAAA,CAAeD,CAAAA,CAA8B,CACjD,KAAK,IAAA,CAAK,MAAA,CAAOA,CAAK,CAAA,CACtB,KAAK,IAAA,CAAK,MAAA,CAAOA,CAAK,EACxB,CAEA,MAAM,OAAA,CAAQA,CAAAA,CAAeE,CAAAA,CAAaC,EAA+B,CAClE,IAAA,CAAK,IAAA,CAAK,GAAA,CAAIH,CAAK,CAAA,EACtB,IAAA,CAAK,IAAA,CAAK,GAAA,CAAIA,EAAO,EAAE,CAAA,CAEzB,IAAMI,CAAAA,CAAU,IAAA,CAAK,IAAA,CAAK,GAAA,CAAIJ,CAAK,CAAA,CACnCI,CAAAA,CAAQF,CAAG,CAAA,CAAIC,EACjB,CAEA,MAAM,OAAA,CAAQH,CAAAA,CAAeE,EAA+B,CAC1D,OAAO,IAAA,CAAK,IAAA,CAAK,GAAA,CAAIF,CAAK,CAAA,GAAIE,CAAG,CACnC,CAEA,MAAM,UAAA,CAAWF,CAAAA,CAAiD,CAChE,OAAO,CAAE,GAAI,IAAA,CAAK,KAAK,GAAA,CAAIA,CAAK,CAAA,EAAK,EAAI,CAC3C,CAEA,MAAM,UAAUA,CAAAA,CAA8B,CAC5C,IAAA,CAAK,IAAA,CAAK,OAAOA,CAAK,EACxB,CAEA,MAAM,UAA8B,CAClC,OAAO,KAAA,CAAM,IAAA,CAAK,KAAK,IAAA,CAAK,IAAA,EAAM,CACpC,CAKA,KAAA,EAAc,CACZ,IAAA,CAAK,IAAA,CAAK,OAAM,CAChB,IAAA,CAAK,IAAA,CAAK,KAAA,GACZ,CACF","file":"memory.cjs","sourcesContent":["/**\n * yaml-flow - Memory Store\n * \n * In-memory store implementation. Works in both browser and Node.js.\n * Data is lost when the process exits - use for testing or short-lived flows.\n */\n\nimport type { StepMachineStore, StepMachineState } from '../step-machine/types.js';\n\nexport class MemoryStore implements StepMachineStore {\n  private runs: Map<string, StepMachineState> = new Map();\n  private data: Map<string, Record<string, unknown>> = new Map();\n\n  async saveRunState(runId: string, state: StepMachineState): Promise<void> {\n    this.runs.set(runId, { ...state });\n  }\n\n  async loadRunState(runId: string): Promise<StepMachineState | null> {\n    const state = this.runs.get(runId);\n    return state ? { ...state } : null;\n  }\n\n  async deleteRunState(runId: string): Promise<void> {\n    this.runs.delete(runId);\n    this.data.delete(runId);\n  }\n\n  async setData(runId: string, key: string, value: unknown): Promise<void> {\n    if (!this.data.has(runId)) {\n      this.data.set(runId, {});\n    }\n    const runData = this.data.get(runId)!;\n    runData[key] = value;\n  }\n\n  async getData(runId: string, key: string): Promise<unknown> {\n    return this.data.get(runId)?.[key];\n  }\n\n  async getAllData(runId: string): Promise<Record<string, unknown>> {\n    return { ...(this.data.get(runId) ?? {}) };\n  }\n\n  async clearData(runId: string): Promise<void> {\n    this.data.delete(runId);\n  }\n\n  async listRuns(): Promise<string[]> {\n    return Array.from(this.runs.keys());\n  }\n\n  /**\n   * Clear all data (useful for testing)\n   */\n  clear(): void {\n    this.runs.clear();\n    this.data.clear();\n  }\n}\n"]}

package/dist/stores/memory.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/stores/memory.ts"],"names":["MemoryStore","runId","state","key","value","runData"],"mappings":"AASO,IAAMA,CAAAA,CAAN,KAA8C,CAC3C,IAAA,CAAsC,IAAI,GAAA,CAC1C,IAAA,CAA6C,IAAI,GAAA,CAEzD,MAAM,YAAA,CAAaC,CAAAA,CAAeC,CAAAA,CAAwC,CACxE,KAAK,IAAA,CAAK,GAAA,CAAID,CAAAA,CAAO,CAAE,GAAGC,CAAM,CAAC,EACnC,CAEA,MAAM,YAAA,CAAaD,CAAAA,CAAiD,CAClE,IAAMC,CAAAA,CAAQ,IAAA,CAAK,IAAA,CAAK,GAAA,CAAID,CAAK,CAAA,CACjC,OAAOC,CAAAA,CAAQ,CAAE,GAAGA,CAAM,CAAA,CAAI,IAChC,CAEA,MAAM,cAAA,CAAeD,CAAAA,CAA8B,CACjD,KAAK,IAAA,CAAK,MAAA,CAAOA,CAAK,CAAA,CACtB,KAAK,IAAA,CAAK,MAAA,CAAOA,CAAK,EACxB,CAEA,MAAM,OAAA,CAAQA,CAAAA,CAAeE,CAAAA,CAAaC,EAA+B,CAClE,IAAA,CAAK,IAAA,CAAK,GAAA,CAAIH,CAAK,CAAA,EACtB,IAAA,CAAK,IAAA,CAAK,GAAA,CAAIA,EAAO,EAAE,CAAA,CAEzB,IAAMI,CAAAA,CAAU,IAAA,CAAK,IAAA,CAAK,GAAA,CAAIJ,CAAK,CAAA,CACnCI,CAAAA,CAAQF,CAAG,CAAA,CAAIC,EACjB,CAEA,MAAM,OAAA,CAAQH,CAAAA,CAAeE,EAA+B,CAC1D,OAAO,IAAA,CAAK,IAAA,CAAK,GAAA,CAAIF,CAAK,CAAA,GAAIE,CAAG,CACnC,CAEA,MAAM,UAAA,CAAWF,CAAAA,CAAiD,CAChE,OAAO,CAAE,GAAI,IAAA,CAAK,KAAK,GAAA,CAAIA,CAAK,CAAA,EAAK,EAAI,CAC3C,CAEA,MAAM,UAAUA,CAAAA,CAA8B,CAC5C,IAAA,CAAK,IAAA,CAAK,OAAOA,CAAK,EACxB,CAEA,MAAM,UAA8B,CAClC,OAAO,KAAA,CAAM,IAAA,CAAK,KAAK,IAAA,CAAK,IAAA,EAAM,CACpC,CAKA,KAAA,EAAc,CACZ,IAAA,CAAK,IAAA,CAAK,OAAM,CAChB,IAAA,CAAK,IAAA,CAAK,KAAA,GACZ,CACF","file":"memory.js","sourcesContent":["/**\n * yaml-flow - Memory Store\n * \n * In-memory store implementation. Works in both browser and Node.js.\n * Data is lost when the process exits - use for testing or short-lived flows.\n */\n\nimport type { StepMachineStore, StepMachineState } from '../step-machine/types.js';\n\nexport class MemoryStore implements StepMachineStore {\n  private runs: Map<string, StepMachineState> = new Map();\n  private data: Map<string, Record<string, unknown>> = new Map();\n\n  async saveRunState(runId: string, state: StepMachineState): Promise<void> {\n    this.runs.set(runId, { ...state });\n  }\n\n  async loadRunState(runId: string): Promise<StepMachineState | null> {\n    const state = this.runs.get(runId);\n    return state ? { ...state } : null;\n  }\n\n  async deleteRunState(runId: string): Promise<void> {\n    this.runs.delete(runId);\n    this.data.delete(runId);\n  }\n\n  async setData(runId: string, key: string, value: unknown): Promise<void> {\n    if (!this.data.has(runId)) {\n      this.data.set(runId, {});\n    }\n    const runData = this.data.get(runId)!;\n    runData[key] = value;\n  }\n\n  async getData(runId: string, key: string): Promise<unknown> {\n    return this.data.get(runId)?.[key];\n  }\n\n  async getAllData(runId: string): Promise<Record<string, unknown>> {\n    return { ...(this.data.get(runId) ?? {}) };\n  }\n\n  async clearData(runId: string): Promise<void> {\n    this.data.delete(runId);\n  }\n\n  async listRuns(): Promise<string[]> {\n    return Array.from(this.runs.keys());\n  }\n\n  /**\n   * Clear all data (useful for testing)\n   */\n  clear(): void {\n    this.runs.clear();\n    this.data.clear();\n  }\n}\n"]}

package/dist/types-CHSdoAAA.d.cts

@@ -1,135 +0,0 @@
-import { G as GraphConfig, c as ExecutionState, T as TaskConfig, e as GraphEngineStore } from './types-BBhqYGhE.cjs';
-
-/**
- * Continuous Event Graph — Types
- *
- * A long-lived, evolving event-graph where both config and state
- * mutate over time. The single `LiveGraph` type bundles them.
- *
- * Events are shared with event-graph (task-started, task-completed, etc.).
- * Graph mutations (addNode, removeNode, etc.) are unique to this mode.
- */
-
-/**
- * The single evolving object for a continuous-mode graph.
- * Bundles config + state so they can't get out of sync.
- */
-interface LiveGraph {
-    /** The current graph configuration (evolves as nodes are added/removed) */
-    config: GraphConfig;
-    /** The current execution state (evolves as events arrive) */
-    state: ExecutionState;
-}
-interface ScheduleResult {
-    /** Tasks ready to dispatch now — all requires satisfied */
-    eligible: string[];
-    /** Tasks waiting on tokens that some producer will eventually provide (normal) */
-    pending: PendingTask[];
-    /** Tasks waiting on tokens that NO task can produce (caller's problem) */
-    unresolved: UnresolvedDependency[];
-    /** Tasks waiting on tokens whose producer FAILED (caller's problem) */
-    blocked: BlockedTask[];
-    /** Token conflicts: multiple tasks produce the same token */
-    conflicts: Record<string, string[]>;
-}
-interface PendingTask {
-    taskName: string;
-    /** Tokens this task needs that haven't been produced yet but have a viable producer */
-    waitingOn: string[];
-}
-interface UnresolvedDependency {
-    taskName: string;
-    /** Tokens this task needs that no task in the graph can produce */
-    missingTokens: string[];
-}
-interface BlockedTask {
-    taskName: string;
-    /** Tokens this task needs whose only producer has failed */
-    failedTokens: string[];
-    /** The tasks that failed and would have produced those tokens */
-    failedProducers: string[];
-}
-interface LiveGraphHealth {
-    /** Total number of tasks in the graph */
-    totalNodes: number;
-    /** Task counts by status */
-    running: number;
-    completed: number;
-    failed: number;
-    waiting: number;
-    notStarted: number;
-    /** Number of disabled (inactivated) nodes */
-    disabled: number;
-    /** Number of tasks with unresolvable dependencies */
-    unresolvedCount: number;
-    /** Number of tasks whose producer has failed */
-    blockedCount: number;
-    /** Tokens that no task produces (open dependencies) */
-    openDependencies: string[];
-    /** Cycles detected in the current graph (if any) */
-    cycles: string[][];
-    /** Tokens produced by multiple tasks */
-    conflictTokens: string[];
-}
-interface NodeInfo {
-    /** Node name */
-    name: string;
-    /** The task configuration */
-    config: TaskConfig;
-    /** The current runtime state */
-    state: GraphEngineStore;
-}
-interface LiveGraphSnapshot {
-    /** Schema version for forward compatibility */
-    version: number;
-    /** The graph config at snapshot time */
-    config: GraphConfig;
-    /** The execution state at snapshot time */
-    state: ExecutionState;
-    /** ISO timestamp of when the snapshot was taken */
-    snapshotAt: string;
-}
-interface UnreachableTokensResult {
-    tokens: {
-        /** The token that cannot be produced */
-        token: string;
-        /** Why it's unreachable */
-        reason: 'no-producer' | 'all-producers-failed' | 'transitive';
-        /** Tasks that could produce it (but are themselves unreachable/failed) */
-        producers: string[];
-    }[];
-}
-interface UnreachableNodesResult {
-    nodes: {
-        /** The node that can never become eligible */
-        nodeName: string;
-        /** Unreachable tokens this node requires (empty if the node itself is failed/disabled) */
-        missingTokens: string[];
-    }[];
-}
-interface UpstreamResult {
-    /** The target node being inspected */
-    nodeName: string;
-    /** All upstream nodes that transitively feed into the target */
-    nodes: {
-        nodeName: string;
-        /** Tokens this node provides that are in the dependency chain */
-        providesTokens: string[];
-    }[];
-    /** All tokens in the upstream dependency chain */
-    tokens: string[];
-}
-interface DownstreamResult {
-    /** The target node being inspected */
-    nodeName: string;
-    /** All downstream nodes that transitively depend on the target */
-    nodes: {
-        nodeName: string;
-        /** Tokens this node requires that are in the dependency chain */
-        requiresTokens: string[];
-    }[];
-    /** All tokens in the downstream dependency chain */
-    tokens: string[];
-}
-
-export type { BlockedTask as B, DownstreamResult as D, LiveGraph as L, NodeInfo as N, PendingTask as P, ScheduleResult as S, UnreachableNodesResult as U, LiveGraphHealth as a, LiveGraphSnapshot as b, UnreachableTokensResult as c, UnresolvedDependency as d, UpstreamResult as e };

package/dist/types-CoW0gQl3.d.ts

@@ -1,135 +0,0 @@
-import { G as GraphConfig, c as ExecutionState, T as TaskConfig, e as GraphEngineStore } from './types-BBhqYGhE.js';
-
-/**
- * Continuous Event Graph — Types
- *
- * A long-lived, evolving event-graph where both config and state
- * mutate over time. The single `LiveGraph` type bundles them.
- *
- * Events are shared with event-graph (task-started, task-completed, etc.).
- * Graph mutations (addNode, removeNode, etc.) are unique to this mode.
- */
-
-/**
- * The single evolving object for a continuous-mode graph.
- * Bundles config + state so they can't get out of sync.
- */
-interface LiveGraph {
-    /** The current graph configuration (evolves as nodes are added/removed) */
-    config: GraphConfig;
-    /** The current execution state (evolves as events arrive) */
-    state: ExecutionState;
-}
-interface ScheduleResult {
-    /** Tasks ready to dispatch now — all requires satisfied */
-    eligible: string[];
-    /** Tasks waiting on tokens that some producer will eventually provide (normal) */
-    pending: PendingTask[];
-    /** Tasks waiting on tokens that NO task can produce (caller's problem) */
-    unresolved: UnresolvedDependency[];
-    /** Tasks waiting on tokens whose producer FAILED (caller's problem) */
-    blocked: BlockedTask[];
-    /** Token conflicts: multiple tasks produce the same token */
-    conflicts: Record<string, string[]>;
-}
-interface PendingTask {
-    taskName: string;
-    /** Tokens this task needs that haven't been produced yet but have a viable producer */
-    waitingOn: string[];
-}
-interface UnresolvedDependency {
-    taskName: string;
-    /** Tokens this task needs that no task in the graph can produce */
-    missingTokens: string[];
-}
-interface BlockedTask {
-    taskName: string;
-    /** Tokens this task needs whose only producer has failed */
-    failedTokens: string[];
-    /** The tasks that failed and would have produced those tokens */
-    failedProducers: string[];
-}
-interface LiveGraphHealth {
-    /** Total number of tasks in the graph */
-    totalNodes: number;
-    /** Task counts by status */
-    running: number;
-    completed: number;
-    failed: number;
-    waiting: number;
-    notStarted: number;
-    /** Number of disabled (inactivated) nodes */
-    disabled: number;
-    /** Number of tasks with unresolvable dependencies */
-    unresolvedCount: number;
-    /** Number of tasks whose producer has failed */
-    blockedCount: number;
-    /** Tokens that no task produces (open dependencies) */
-    openDependencies: string[];
-    /** Cycles detected in the current graph (if any) */
-    cycles: string[][];
-    /** Tokens produced by multiple tasks */
-    conflictTokens: string[];
-}
-interface NodeInfo {
-    /** Node name */
-    name: string;
-    /** The task configuration */
-    config: TaskConfig;
-    /** The current runtime state */
-    state: GraphEngineStore;
-}
-interface LiveGraphSnapshot {
-    /** Schema version for forward compatibility */
-    version: number;
-    /** The graph config at snapshot time */
-    config: GraphConfig;
-    /** The execution state at snapshot time */
-    state: ExecutionState;
-    /** ISO timestamp of when the snapshot was taken */
-    snapshotAt: string;
-}
-interface UnreachableTokensResult {
-    tokens: {
-        /** The token that cannot be produced */
-        token: string;
-        /** Why it's unreachable */
-        reason: 'no-producer' | 'all-producers-failed' | 'transitive';
-        /** Tasks that could produce it (but are themselves unreachable/failed) */
-        producers: string[];
-    }[];
-}
-interface UnreachableNodesResult {
-    nodes: {
-        /** The node that can never become eligible */
-        nodeName: string;
-        /** Unreachable tokens this node requires (empty if the node itself is failed/disabled) */
-        missingTokens: string[];
-    }[];
-}
-interface UpstreamResult {
-    /** The target node being inspected */
-    nodeName: string;
-    /** All upstream nodes that transitively feed into the target */
-    nodes: {
-        nodeName: string;
-        /** Tokens this node provides that are in the dependency chain */
-        providesTokens: string[];
-    }[];
-    /** All tokens in the upstream dependency chain */
-    tokens: string[];
-}
-interface DownstreamResult {
-    /** The target node being inspected */
-    nodeName: string;
-    /** All downstream nodes that transitively depend on the target */
-    nodes: {
-        nodeName: string;
-        /** Tokens this node requires that are in the dependency chain */
-        requiresTokens: string[];
-    }[];
-    /** All tokens in the downstream dependency chain */
-    tokens: string[];
-}
-
-export type { BlockedTask as B, DownstreamResult as D, LiveGraph as L, NodeInfo as N, PendingTask as P, ScheduleResult as S, UnreachableNodesResult as U, LiveGraphHealth as a, LiveGraphSnapshot as b, UnreachableTokensResult as c, UnresolvedDependency as d, UpstreamResult as e };

package/examples/browser/boards/portfolio-tracker/portfolio-tracker-fetch-prices.py

@@ -1,201 +0,0 @@
-#!/usr/bin/env python3
-"""portfolio-tracker-fetch-prices.py
-
-Task executor for the portfolio board demo.
-Handles run-source-fetch requests for source_defs with kind: "mock-quotes".
-Generates random prices (2dp, 10.00-999.99) for each projected ticker.
-
-Subcommands:
-  run-source-fetch      --in-ref <::kind::value> --out-ref <::kind::value> --err-ref <::kind::value>
-  validate-source-def   --in <source.json>
-  describe-capabilities
-
-Uses the public storage adapter for all storage and callback operations.
-The executor does NOT contain transport-specific callback logic.
-"""
-
-from __future__ import annotations
-
-import argparse
-import json
-import os
-import random
-import sys
-import time
-from typing import Any
-
-# Add pycli to path so we can import the public storage adapter.
-_REPO_ROOT = os.path.normpath(os.path.join(os.path.dirname(os.path.abspath(__file__)), '..', '..', '..', '..'))
-if _REPO_ROOT not in sys.path:
-    sys.path.insert(0, _REPO_ROOT)
-
-from pycli.sub.public_storage_adapter import (  # noqa: E402
-    parse_ref,
-    serialize_ref,
-    blob_storage_for_ref,
-    report_complete,
-    report_failed,
-    KindValueRef,
-)
-
-
-def _parse_ref_str(ref: str) -> KindValueRef:
-    """Convenience: parse a CLI ref string."""
-    return parse_ref(ref)
-
-
-def validate_source_def(source_def: dict[str, Any]) -> dict[str, Any]:
-    errors: list[str] = []
-
-    if source_def.get("kind") != "mock-quotes":
-        errors.append(f"kind must be \"mock-quotes\"; got \"{source_def.get('kind')}\".")
-    if not isinstance(source_def.get("bindTo"), str) or not source_def.get("bindTo"):
-        errors.append("bindTo is required and must be a string.")
-    if not isinstance(source_def.get("outputFile"), str) or not source_def.get("outputFile"):
-        errors.append("outputFile is required and must be a string.")
-    projections = source_def.get("projections")
-    if not isinstance(projections, dict) or not isinstance(projections.get("tickers"), str):
-        errors.append("projections.tickers is required and must be a JSONata expression string.")
-
-    return {"ok": len(errors) == 0, "errors": errors}
-
-
-def cmd_validate_source_def(args: argparse.Namespace) -> int:
-    if not os.path.exists(args.input):
-        print(json.dumps({"ok": False, "errors": [f"Input file not found: {args.input}"]}))
-        return 1
-
-    try:
-        with open(args.input, "r", encoding="utf-8") as f:
-            source_def = json.load(f)
-    except Exception as e:
-        print(json.dumps({"ok": False, "errors": [f"Cannot parse source file: {e}"]}))
-        return 1
-
-    result = validate_source_def(source_def if isinstance(source_def, dict) else {})
-    print(json.dumps(result))
-    return 0 if result["ok"] else 1
-
-
-def cmd_describe_capabilities(_: argparse.Namespace) -> int:
-    capabilities = {
-        "version": "1.0",
-        "executor": "portfolio-tracker-fetch-prices",
-        "subcommands": ["run-source-fetch", "validate-source-def", "describe-capabilities"],
-        "sourceKinds": {
-            "mock-quotes": {
-                "description": "Generates random mock market prices (10.00-999.99) for each ticker in _projections.tickers.",
-                "inputSchema": {
-                    "kind": {"type": "string", "required": True, "description": "Must be \"mock-quotes\"."},
-                    "bindTo": {"type": "string", "required": True, "description": "Token name for the output binding."},
-                    "outputFile": {"type": "string", "required": True, "description": "Relative path to write prices JSON."},
-                    "projections": {
-                        "type": "object",
-                        "required": True,
-                        "properties": {
-                            "tickers": {
-                                "type": "string",
-                                "required": True,
-                                "description": "JSONata expression resolving to a string[] of ticker symbols.",
-                            }
-                        },
-                    },
-                },
-                "outputShape": "{ [ticker: string]: number }",
-            }
-        },
-    }
-    print(json.dumps(capabilities, indent=2, ensure_ascii=True))
-    return 0
-
-
-def cmd_run_source_fetch(args: argparse.Namespace) -> int:
-    in_ref = _parse_ref_str(args.in_ref)
-    out_ref = _parse_ref_str(args.out_ref)
-    err_ref = _parse_ref_str(args.err_ref)
-
-    in_storage = blob_storage_for_ref(in_ref)
-    out_storage = blob_storage_for_ref(out_ref)
-    err_storage = blob_storage_for_ref(err_ref)
-
-    raw_in = in_storage.read(in_ref.value)
-    if not raw_in:
-        print(f"[portfolio-tracker-fetch-prices] input envelope not found at: {args.in_ref}", file=sys.stderr)
-        return 1
-
-    envelope = json.loads(raw_in)
-    callback = envelope.get("callback") if isinstance(envelope, dict) else None
-
-    def safe_fail(msg: str) -> int:
-        try:
-            err_storage.write(err_ref.value, msg)
-        except Exception:
-            pass
-        if isinstance(callback, dict):
-            try:
-                report_failed(callback, msg)
-                return 0
-            except Exception as e:
-                print(f"[portfolio-tracker-fetch-prices] callback fail: {e}", file=sys.stderr)
-                return 1
-        return 1
-
-    try:
-        source_def = envelope.get("source_def") if isinstance(envelope, dict) else None
-        if not isinstance(source_def, dict):
-            source_def = envelope if isinstance(envelope, dict) else {}
-
-        if source_def.get("kind") != "mock-quotes":
-            raise ValueError(f"Unsupported source kind: expected \"mock-quotes\", got \"{source_def.get('kind')}\"")
-
-        projections = source_def.get("_projections")
-        tickers = projections.get("tickers") if isinstance(projections, dict) else None
-        if not isinstance(tickers, list):
-            raise ValueError("sourceDef._projections.tickers is missing or not an array")
-
-        time.sleep(0.2 + random.random() * 0.1)
-
-        prices: dict[str, float] = {}
-        for ticker in tickers:
-            prices[str(ticker)] = round(10 + random.random() * 989.99, 2)
-
-        out_storage.write(out_ref.value, json.dumps(prices, ensure_ascii=True))
-        print(f"[portfolio-tracker-fetch-prices] wrote prices for: {', '.join([str(t) for t in tickers])}")
-
-        if isinstance(callback, dict):
-            report_complete(callback, out_ref)
-        return 0
-    except Exception as e:
-        msg = str(e)
-        print(f"[portfolio-tracker-fetch-prices] error: {msg}", file=sys.stderr)
-        return safe_fail(msg)
-
-
-def build_parser() -> argparse.ArgumentParser:
-    parser = argparse.ArgumentParser(prog="portfolio-tracker-fetch-prices")
-    sub = parser.add_subparsers(dest="command", required=True)
-
-    run_cmd = sub.add_parser("run-source-fetch")
-    run_cmd.add_argument("--in-ref", required=True)
-    run_cmd.add_argument("--out-ref", required=True)
-    run_cmd.add_argument("--err-ref", required=True)
-    run_cmd.set_defaults(handler=cmd_run_source_fetch)
-
-    val_cmd = sub.add_parser("validate-source-def")
-    val_cmd.add_argument("--in", dest="input", required=True)
-    val_cmd.set_defaults(handler=cmd_validate_source_def)
-
-    cap_cmd = sub.add_parser("describe-capabilities")
-    cap_cmd.set_defaults(handler=cmd_describe_capabilities)
-
-    return parser
-
-
-def main(argv: list[str] | None = None) -> int:
-    parser = build_parser()
-    args = parser.parse_args(argv)
-    return args.handler(args)
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())