@swizzy_ai/kit 1.0.3 → 1.0.5

package/dist/core/wizard/bungee/builder.d.ts

@@ -5,17 +5,28 @@ export declare class BungeeBuilder {
     /**
      * Add a single step execution.
      */
-    readonly add: (stepId: string) => this;
+    readonly add: (stepId: string, config?: Record<string, any>) => this;
     /**
      * Add multiple executions based on count with config function.
      */
-    readonly batch: (stepId: string, count: number, configFn: (index: number) => Record<string, any>) => this;
+    readonly batch: (stepId: string, count: number, configFn: (index: number) => Record<string, any>, options?: {
+        optimistic?: boolean;
+        returnToAnchor?: boolean;
+        failWizardOnFailure?: boolean;
+    }) => this;
     /**
      * Configure execution settings.
      */
     readonly config: (options: {
         concurrency?: number;
+        optimistic?: boolean;
+        returnToAnchor?: boolean;
+        failWizardOnFailure?: boolean;
     }) => this;
+    /**
+     * Set completion callback.
+     */
+    readonly onComplete: (callback: (wizard: any) => any) => this;
     /**
      * Trigger the Jump.
      */

package/dist/core/wizard/bungee/builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../../src/core/wizard/bungee/builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAqB,MAAM,SAAS,CAAC;AAExD,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAa;gBAEd,aAAa,EAAE,MAAM;IASjC;;OAEG;IACH,SAAgB,GAAG,GAAI,QAAQ,MAAM,UAGnC;IAEF;;OAEG;IACH,SAAgB,KAAK,GACnB,QAAQ,MAAM,EACd,OAAO,MAAM,EACb,UAAU,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,UAOhD;IAEF;;OAEG;IACH,SAAgB,MAAM,GAAI,SAAS;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,UAKzD;IAEF;;OAEG;IACH,SAAgB,IAAI,QAAO;QAAE,IAAI,EAAE,aAAa,CAAC;QAAC,IAAI,EAAE,UAAU,CAAA;KAAE,CAElE;CACH"}
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../../src/core/wizard/bungee/builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAqB,MAAM,SAAS,CAAC;AAExD,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAa;gBAEd,aAAa,EAAE,MAAM;IASjC;;OAEG;IACH,SAAgB,GAAG,GAAI,QAAQ,MAAM,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,UAGjE;IAEF;;OAEG;IACH,SAAgB,KAAK,GACnB,QAAQ,MAAM,EACd,OAAO,MAAM,EACb,UAAU,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAChD,UAAU;QACR,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC;KAC/B,UAgBD;IAEF;;OAEG;IACH,SAAgB,MAAM,GAAI,SAAS;QACjC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC;KAC/B,UAcC;IAEF;;OAEG;IACH,SAAgB,UAAU,GAAI,UAAU,CAAC,MAAM,EAAE,GAAG,KAAK,GAAG,UAG1D;IAEF;;OAEG;IACH,SAAgB,IAAI,QAAO;QAAE,IAAI,EAAE,aAAa,CAAC;QAAC,IAAI,EAAE,UAAU,CAAA;KAAE,CAElE;CACH"}

package/dist/core/wizard/bungee/executor.d.ts

@@ -4,7 +4,7 @@ export declare class BungeeExecutor {
     private bungeeWorkers;
     private pendingReentry;
     constructor(wizard: any);
-    executeBungeePlan(plan: BungeePlan): Promise<void>;
+    executeBungeePlan(plan: BungeePlan): Promise<any>;
     private launchBungeeWorker;
     private createTelescopeContext;
     private executeWorkerStep;

package/dist/core/wizard/bungee/executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../../src/core/wizard/bungee/executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGrC,qBAAa,cAAc;IASb,OAAO,CAAC,MAAM;IAR1B,OAAO,CAAC,aAAa,CAKL;IAChB,OAAO,CAAC,cAAc,CAA0B;gBAE5B,MAAM,EAAE,GAAG;IAEzB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;YA6B1C,kBAAkB;IAsChC,OAAO,CAAC,sBAAsB;YAShB,iBAAiB;IAW/B,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;YAMxE,eAAe;IAOvB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;CAOxC"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../../src/core/wizard/bungee/executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGrC,qBAAa,cAAc;IASb,OAAO,CAAC,MAAM;IAR1B,OAAO,CAAC,aAAa,CAKL;IAChB,OAAO,CAAC,cAAc,CAA0B;gBAE5B,MAAM,EAAE,GAAG;IAEzB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC;YAoCzC,kBAAkB;IAqChC,OAAO,CAAC,sBAAsB;YAShB,iBAAiB;IAW/B,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;YAIxE,eAAe;IAOvB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;CAOxC"}

package/dist/core/wizard/bungee/types.d.ts

@@ -1,12 +1,17 @@
 export interface BungeeDestination {
     type: 'step';
     targetId: string;
+    config?: Record<string, any>;
 }
+import { FlowControlSignal } from '../steps/base';
 export interface BungeePlan {
     id: string;
     anchorId: string;
     destinations: BungeeDestination[];
     concurrency: number;
-    configFn?: (index: number) => Record<string, any>;
+    optimistic?: boolean;
+    returnToAnchor?: boolean;
+    failWizardOnFailure?: boolean;
+    onComplete?: (wizard: any) => FlowControlSignal;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/core/wizard/bungee/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/wizard/bungee/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACnD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/wizard/bungee/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAED,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,iBAAiB,CAAC;CACjD"}

package/dist/core/wizard/logger.d.ts

@@ -1,5 +1,6 @@
 export declare class Logger {
     private logFilePath;
+    private isFileSystemAvailable;
     constructor(id: string);
     log(messageOrFn: string | (() => string)): void;
     private appendToFile;

package/dist/core/wizard/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/core/wizard/logger.ts"],"names":[],"mappings":"AAGA,qBAAa,MAAM;IACjB,OAAO,CAAC,WAAW,CAAqB;gBAE5B,EAAE,EAAE,MAAM;IAStB,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,IAAI;IAO/C,OAAO,CAAC,YAAY;IASd,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;CAQhC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/core/wizard/logger.ts"],"names":[],"mappings":"AAGA,qBAAa,MAAM;IACjB,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,qBAAqB,CAAkB;gBAEnC,EAAE,EAAE,MAAM;IAuBtB,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,IAAI;IAY/C,OAAO,CAAC,YAAY;IASd,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;CAQhC"}

package/dist/core/wizard/steps/base.d.ts

@@ -18,7 +18,7 @@ export type FlowControlSignal = 'NEXT' | 'STOP' | 'RETRY' | 'WAIT' | string | {
     type: 'BUNGEE_JUMP';
     plan: BungeePlan;
 };
-export type Context = (workflowContext: any) => any;
+export type Context = (workflowContext: any) => any | Promise<any>;
 export type ContextType = 'xml' | 'template' | 'both';
 export interface StepConfig<T = any> {
     id: string;
@@ -30,6 +30,7 @@ export interface StepConfig<T = any> {
     beforeRun?: () => Promise<void> | void;
     afterRun?: (result: T) => Promise<void> | void;
     model: string;
+    stream?: boolean;
 }
 export declare class Step<T = any> {
     readonly id: string;
@@ -41,9 +42,10 @@ export declare class Step<T = any> {
     readonly beforeRun?: () => Promise<void> | void;
     readonly afterRun?: (result: T) => Promise<void> | void;
     readonly model: string;
+    readonly stream?: boolean;
     executionCount: number;
     constructor(config: StepConfig<T>);
     validate(data: unknown): T;
-    getContext(workflowContext: any): any;
+    getContext(workflowContext: any): Promise<any>;
 }
 //# sourceMappingURL=base.d.ts.map

package/dist/core/wizard/steps/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/core/wizard/steps/base.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/core/wizard/steps/base.ts"],"names":[],"mappings":"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"}

package/dist/core/wizard/steps/text.d.ts

@@ -8,6 +8,7 @@ export interface TextStepConfig {
     beforeRun?: () => Promise<void> | void;
     afterRun?: (result: string) => Promise<void> | void;
     model: string;
+    stream: boolean;
 }
 export declare class TextStep extends Step<string> {
     constructor(config: TextStepConfig);

package/dist/core/wizard/steps/text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../../src/core/wizard/steps/text.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAc,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAEhE,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,QAAQ,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IACvJ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACpD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,QAAS,SAAQ,IAAI,CAAC,MAAM,CAAC;gBAC5B,MAAM,EAAE,cAAc;IASlC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM;CAIhC"}
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../../src/core/wizard/steps/text.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAc,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAEhE,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,QAAQ,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IACvJ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,qBAAa,QAAS,SAAQ,IAAI,CAAC,MAAM,CAAC;gBAC5B,MAAM,EAAE,cAAc;IASlC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM;CAIhC"}

package/dist/core/wizard/wizard.d.ts

@@ -99,19 +99,24 @@ export declare class Wizard {
      * Uses streaming for regular steps to provide real-time parsing and UI updates.
      * TextStep and ComputeStep use different approaches (non-streaming).
      */
+    /**
+      * Generates data for a wizard step by calling the LLM.
+      * CLEANED VERSION: Separates formatting rules from logic to prevent hallucination.
+      */
     generateStepData(step: Step, stepContext: any): Promise<any>;
     private repairSchemaData;
     /**
-     * Creates a streaming XML parser for incremental processing of LLM responses.
+     * Creates an improved streaming XML parser for incremental processing of LLM responses.
      *
-     * This parser processes XML chunks as they arrive from the LLM, extracting
-     * fields marked with tag-category="wizard" and parsing them based on their type attributes.
+     * This parser is designed to handle partial chunks robustly and provides better error recovery.
+     * It processes XML chunks as they arrive, extracting fields marked with tag-category="wizard".
      *
-     * Key features:
-     * - Incremental parsing: processes data as it streams in
-     * - Buffer management: accumulates chunks until complete fields are available
-     * - Type-aware parsing: handles strings, numbers, booleans, arrays, objects
-     * - Real-time updates: returns partial results as fields complete
+     * Key improvements:
+     * - Better partial tag handling
+     * - More robust regex matching
+     * - Improved buffer management
+     * - Better error recovery for malformed chunks
+     * - State machine approach for parsing
      *
      * @returns An object with a push method that accepts text chunks and returns parse results
      */

package/dist/core/wizard/wizard.d.ts.map

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

package/dist/index.d.ts

@@ -90,13 +90,18 @@ declare class LLMClient {
 interface BungeeDestination {
     type: 'step';
     targetId: string;
+    config?: Record<string, any>;
 }
+
 interface BungeePlan {
     id: string;
     anchorId: string;
     destinations: BungeeDestination[];
     concurrency: number;
-    configFn?: (index: number) => Record<string, any>;
+    optimistic?: boolean;
+    returnToAnchor?: boolean;
+    failWizardOnFailure?: boolean;
+    onComplete?: (wizard: any) => FlowControlSignal;
 }
 
 declare class BungeeBuilder {
@@ -105,17 +110,28 @@ declare class BungeeBuilder {
     /**
      * Add a single step execution.
      */
-    readonly add: (stepId: string) => this;
+    readonly add: (stepId: string, config?: Record<string, any>) => this;
     /**
      * Add multiple executions based on count with config function.
      */
-    readonly batch: (stepId: string, count: number, configFn: (index: number) => Record<string, any>) => this;
+    readonly batch: (stepId: string, count: number, configFn: (index: number) => Record<string, any>, options?: {
+        optimistic?: boolean;
+        returnToAnchor?: boolean;
+        failWizardOnFailure?: boolean;
+    }) => this;
     /**
      * Configure execution settings.
      */
     readonly config: (options: {
         concurrency?: number;
+        optimistic?: boolean;
+        returnToAnchor?: boolean;
+        failWizardOnFailure?: boolean;
     }) => this;
+    /**
+     * Set completion callback.
+     */
+    readonly onComplete: (callback: (wizard: any) => any) => this;
     /**
      * Trigger the Jump.
      */
@@ -142,7 +158,7 @@ type FlowControlSignal = 'NEXT' | 'STOP' | 'RETRY' | 'WAIT' | string | {
     type: 'BUNGEE_JUMP';
     plan: BungeePlan;
 };
-type Context = (workflowContext: any) => any;
+type Context = (workflowContext: any) => any | Promise<any>;
 type ContextType = 'xml' | 'template' | 'both';
 interface StepConfig<T = any> {
     id: string;
@@ -154,6 +170,7 @@ interface StepConfig<T = any> {
     beforeRun?: () => Promise<void> | void;
     afterRun?: (result: T) => Promise<void> | void;
     model: string;
+    stream?: boolean;
 }
 declare class Step<T = any> {
     readonly id: string;
@@ -165,10 +182,11 @@ declare class Step<T = any> {
     readonly beforeRun?: () => Promise<void> | void;
     readonly afterRun?: (result: T) => Promise<void> | void;
     readonly model: string;
+    readonly stream?: boolean;
     executionCount: number;
     constructor(config: StepConfig<T>);
     validate(data: unknown): T;
-    getContext(workflowContext: any): any;
+    getContext(workflowContext: any): Promise<any>;
 }
 
 interface TextStepConfig {
@@ -180,6 +198,7 @@ interface TextStepConfig {
     beforeRun?: () => Promise<void> | void;
     afterRun?: (result: string) => Promise<void> | void;
     model: string;
+    stream: boolean;
 }
 declare class TextStep extends Step<string> {
     constructor(config: TextStepConfig);
@@ -298,19 +317,24 @@ declare class Wizard {
      * Uses streaming for regular steps to provide real-time parsing and UI updates.
      * TextStep and ComputeStep use different approaches (non-streaming).
      */
+    /**
+      * Generates data for a wizard step by calling the LLM.
+      * CLEANED VERSION: Separates formatting rules from logic to prevent hallucination.
+      */
     generateStepData(step: Step, stepContext: any): Promise<any>;
     private repairSchemaData;
     /**
-     * Creates a streaming XML parser for incremental processing of LLM responses.
+     * Creates an improved streaming XML parser for incremental processing of LLM responses.
      *
-     * This parser processes XML chunks as they arrive from the LLM, extracting
-     * fields marked with tag-category="wizard" and parsing them based on their type attributes.
+     * This parser is designed to handle partial chunks robustly and provides better error recovery.
+     * It processes XML chunks as they arrive, extracting fields marked with tag-category="wizard".
      *
-     * Key features:
-     * - Incremental parsing: processes data as it streams in
-     * - Buffer management: accumulates chunks until complete fields are available
-     * - Type-aware parsing: handles strings, numbers, booleans, arrays, objects
-     * - Real-time updates: returns partial results as fields complete
+     * Key improvements:
+     * - Better partial tag handling
+     * - More robust regex matching
+     * - Improved buffer management
+     * - Better error recovery for malformed chunks
+     * - State machine approach for parsing
      *
      * @returns An object with a push method that accepts text chunks and returns parse results
      */