@whitewall/blip-sdk 0.0.191 → 0.0.193

package/dist/types/utils/builder.d.ts

@@ -1,16 +1,24 @@
-import type { Action, ContentActionItem, State } from '../types/flow.ts';
-export type MinifiedAction = {
+/**
+ * Lossy, read-only projection of a builder flow, meant for presenting a state to
+ * a human or an LLM. It renames the `$`-prefixed keys to readable ones, drops
+ * layout metadata and denormalizes state names, so it cannot be pushed back to
+ * the builder. For the round-trippable format, see `./minifier.ts`.
+ *
+ * Typed over `MinifiedState`, which a full `State` satisfies, so both a pulled
+ * flow and a minified one digest without casts.
+ */
+import { type Condition } from '../types/flow.ts';
+import type { MinifiedAction, MinifiedState } from './minifier.ts';
+/** A `Condition` with the builder's nullish bookkeeping dropped. */
+export type ConditionDigest = Omit<Condition, 'variable'> & {
+    variable?: string;
+};
+export type ActionDigest = {
     type: string;
     settings: Record<string, unknown>;
-    conditions?: Array<{
-        source: string;
-        variable?: string;
-        comparison: string;
-        operator?: string;
-        values: Array<string>;
-    }>;
+    conditions?: Array<ConditionDigest>;
 };
-export type MinifiedInput = {
+export type InputDigest = {
     bypass: boolean;
     variable?: string;
     validation?: {
@@ -20,35 +28,30 @@ export type MinifiedInput = {
         error: string;
     };
     expiration?: string;
-    conditions?: MinifiedAction['conditions'];
+    conditions?: Array<ConditionDigest>;
 };
-export type MinifiedOutput = {
+export type OutputDigest = {
     stateId: string;
     stateName?: string;
     typeOfStateId?: string;
-    conditions?: MinifiedAction['conditions'];
+    conditions?: Array<ConditionDigest>;
 };
-export type MinifiedState = {
+export type StateDigest = {
     id: string;
     name: string;
     root?: boolean;
-    enteringActions?: Array<MinifiedAction>;
+    enteringActions?: Array<ActionDigest>;
     contentActions?: Array<{
-        action?: MinifiedAction;
-        input?: MinifiedInput;
+        action?: ActionDigest;
+        input?: InputDigest;
     }>;
-    leavingActions?: Array<MinifiedAction>;
-    outputs?: Array<MinifiedOutput>;
-    defaultOutput: {
-        stateId: string;
-        stateName?: string;
-        typeOfStateId?: string;
-    };
-    afterStateChangedActions?: Array<MinifiedAction>;
-    localActions?: Array<MinifiedAction>;
+    leavingActions?: Array<ActionDigest>;
+    outputs?: Array<OutputDigest>;
+    defaultOutput: OutputDigest;
+    afterStateChangedActions?: Array<ActionDigest>;
+    localActions?: Array<ActionDigest>;
 };
-export declare function minifyAction(action: Action): MinifiedAction;
-export declare function isChatStateSendMessage(item: ContentActionItem): boolean;
-export declare function resolveStateName(stateId: string, flow: Record<string, State>): string | undefined;
-export declare function minifyState(stateId: string, state: State, flow: Record<string, State>): MinifiedState;
+export declare function digestAction(action: MinifiedAction): ActionDigest;
+export declare function resolveStateName(stateId: string, flow: Record<string, MinifiedState>): string | undefined;
+export declare function digestState(stateId: string, state: MinifiedState, flow: Record<string, MinifiedState>): StateDigest;
 //# sourceMappingURL=builder.d.ts.map

package/dist/types/utils/builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../src/utils/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAExE,MAAM,MAAM,cAAc,GAAG;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,UAAU,CAAC,EAAE,KAAK,CAAC;QACf,MAAM,EAAE,MAAM,CAAA;QACd,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,UAAU,EAAE,MAAM,CAAA;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;KACxB,CAAC,CAAA;CACL,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IACxB,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,cAAc,CAAC,YAAY,CAAC,CAAA;CAC5C,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,UAAU,CAAC,EAAE,cAAc,CAAC,YAAY,CAAC,CAAA;CAC5C,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,eAAe,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,CAAA;IACvC,cAAc,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,CAAC,EAAE,cAAc,CAAC;QAAC,KAAK,CAAC,EAAE,aAAa,CAAA;KAAE,CAAC,CAAA;IAC1E,cAAc,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,CAAA;IACtC,OAAO,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,CAAA;IAC/B,aAAa,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9E,wBAAwB,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,CAAA;IAChD,YAAY,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,CAAA;CACvC,CAAA;AA4BD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAQ3D;AAoBD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAEvE;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,MAAM,GAAG,SAAS,CAGjG;AAkBD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,aAAa,CA2CrG"}
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../src/utils/builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,KAAK,SAAS,EAA+C,MAAM,kBAAkB,CAAA;AAC9F,OAAO,KAAK,EAAE,cAAc,EAAiB,aAAa,EAAE,MAAM,eAAe,CAAA;AAEjF,oEAAoE;AACpE,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjF,MAAM,MAAM,YAAY,GAAG;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,UAAU,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC,CAAA;CACtC,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACtB,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC,CAAA;CACtC,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,UAAU,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC,CAAA;CACtC,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,eAAe,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,CAAA;IACrC,cAAc,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,CAAC,EAAE,YAAY,CAAC;QAAC,KAAK,CAAC,EAAE,WAAW,CAAA;KAAE,CAAC,CAAA;IACtE,cAAc,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,CAAA;IACpC,OAAO,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,CAAA;IAC7B,aAAa,EAAE,YAAY,CAAA;IAC3B,wBAAwB,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,CAAA;IAC9C,YAAY,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,CAAA;CACrC,CAAA;AAoBD,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,YAAY,CAQjE;AAoBD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,MAAM,GAAG,SAAS,CAGzG;AAiBD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,WAAW,CAqCnH"}

package/dist/types/utils/flow-rules.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Everything the Builder runtime refuses to run, checked against a minified flow.
+ *
+ * A port of the runtime's own validation — `Models/Flow.cs::Validate`,
+ * `Models/Condition.cs::Validate`, `Models/Input.cs::Validate` and the media type
+ * each action deserializes. All of them throw at load or mid-turn, and the runtime
+ * validates the whole flow on every message, so one of these takes the bot down
+ * for every user rather than breaking one branch.
+ *
+ * The line is deliberate: this file only holds what makes the runtime throw. A
+ * flow that is merely suspect — a quick reply nothing matches, a variable nobody
+ * writes — parses fine here, because that is a linter's job and a schema can only
+ * say "invalid" where a linter can say "warning".
+ *
+ * It is one pass over the whole flow, wired into `minifiedFlowSchema` alone. Zod
+ * skips a `.check()` on a value that already has issues, so a check per action and
+ * a check per state would report the innermost problem and hide the rest.
+ */
+import type { MinifiedState } from './minifier.ts';
+/** Every rule this file can report. */
+export type FlowRule = 'missing-root-state' | 'root-must-wait' | 'dangling-output' | 'input-less-loop' | 'transition-loop' | 'shadowed-output' | 'invalid-condition' | 'invalid-input-validation' | 'invalid-regex' | 'invalid-variable-name' | 'unreadable-variable' | 'malformed-placeholder' | 'missing-media-type' | 'content-type-mismatch' | 'duplicate-title';
+/** Reports a failure, tagged with the rule so a caller can group or suppress. */
+export type ReportRule = (rule: FlowRule, path: Array<string | number>, message: string) => void;
+/**
+ * The rule a zod issue came from, if it came from one of these checks.
+ *
+ * The id travels in the issue's `params`, which zod types as `Record<string, any>`,
+ * so reading it through here is what keeps `FlowRule` meaning anything on the way
+ * out — a caller that reaches into `params` itself gets `any` back.
+ */
+export declare function flowRuleOf(issue: {
+    code: string;
+    params?: Record<string, unknown>;
+}): FlowRule | undefined;
+export declare const VARIABLE_NAME: RegExp;
+/** `Variables/VariableSource.cs`: a name whose first segment is one of these reads a provider. */
+export declare const PROVIDER_NAMESPACES: Set<string>;
+/** `Models/Flow.cs`: an output names a state, or a `{{variable}}` resolved at runtime. */
+export declare const isVariableOutput: (stateId: string) => boolean;
+/**
+ * `Models/Flow.cs::Validate`, walked in one pass so every problem in the flow is
+ * reported at once.
+ */
+export declare function checkFlow(flow: Record<string, MinifiedState>, report: ReportRule): void;
+/**
+ * Every `{{reference}}` a state carries, deduped, with script sources masked out:
+ * a script's braces are a doc comment or a nested object literal, not a read.
+ */
+export declare function placeholderReadsOf(state: MinifiedState): Array<string>;
+//# sourceMappingURL=flow-rules.d.ts.map

package/dist/types/utils/flow-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-rules.d.ts","sourceRoot":"","sources":["../../../src/utils/flow-rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAiC,aAAa,EAAE,MAAM,eAAe,CAAA;AAEjF,uCAAuC;AACvC,MAAM,MAAM,QAAQ,GACd,oBAAoB,GACpB,gBAAgB,GAChB,iBAAiB,GACjB,iBAAiB,GACjB,iBAAiB,GACjB,iBAAiB,GACjB,mBAAmB,GACnB,0BAA0B,GAC1B,eAAe,GACf,uBAAuB,GACvB,qBAAqB,GACrB,uBAAuB,GACvB,oBAAoB,GACpB,uBAAuB,GACvB,iBAAiB,CAAA;AAEvB,iFAAiF;AACjF,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;AAEhG;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,QAAQ,GAAG,SAAS,CAI1G;AAWD,eAAO,MAAM,aAAa,QAAwC,CAAA;AAUlE,kGAAkG;AAClG,eAAO,MAAM,mBAAmB,aAgB9B,CAAA;AAEF,0FAA0F;AAC1F,eAAO,MAAM,gBAAgB,GAAI,SAAS,MAAM,YAAuD,CAAA;AAEvG;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAkCvF;AAqPD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,CAQtE"}