llmz 0.0.2 → 0.0.5

package/dist/index.js

@@ -1,34 +1,43 @@
 import {
-  Snapshot
-} from "./chunk-UG2GCPHF.js";
+  ListenExit,
+  Snapshot,
+  ThinkExit,
+  getValue
+} from "./chunk-3U57H7GT.js";
+import "./chunk-WLUVY5QU.js";
 import {
   Tool
-} from "./chunk-DILHJIMP.js";
+} from "./chunk-QBXIE6EY.js";
 import {
   formatTypings,
   getTypings
-} from "./chunk-ZSRC3TN4.js";
+} from "./chunk-UNMKB2DA.js";
 import {
   CodeFormattingError,
   SnapshotSignal,
   ThinkSignal
-} from "./chunk-RJHDQL4C.js";
+} from "./chunk-JKVVQN2P.js";
+import "./chunk-JQBT7UWN.js";
 import {
   Exit
-} from "./chunk-6QDFMQHA.js";
-import "./chunk-Q4DEJGXD.js";
-import "./chunk-MSTBEKOQ.js";
-import "./chunk-3T465BEW.js";
+} from "./chunk-S6FOL2HY.js";
+import {
+  Component,
+  assertValidComponent,
+  isAnyComponent,
+  isComponent
+} from "./chunk-HP7RKM25.js";
+import "./chunk-ORQP26SZ.js";
+import "./chunk-QT4QF3YA.js";
 import {
   escapeString,
   getMultilineComment,
   isValidIdentifier
-} from "./chunk-DFZ6GX5C.js";
+} from "./chunk-5TRUJES5.js";
 import {
   cloneDeep_default,
   upperFirst_default
-} from "./chunk-7S3UY52U.js";
-import "./chunk-YSQDPG26.js";
+} from "./chunk-7WRN4E42.js";
 
 // src/objects.ts
 import { z } from "@bpinternal/zui";
@@ -497,8 +506,143 @@ function embedPropertyValue(property) {
   return "unknown";
 }
 
+// src/citations.ts
+var RARE_SYMBOLS = {
+  ARROW_UP: "\u2191",
+  CIRCLE_BULLET: "\u30FB",
+  STAR_BULLET_FULL: "\u2605",
+  STAR_BULLET_EMPTY: "\u2606",
+  ARROW_BULLET: "\u2192",
+  SQUARE_BULLET: "\u25A0",
+  TRIANGLE_BULLET: "\u25BA",
+  OPENING_TAG: "\u3010",
+  CLOSING_TAG: "\u3011",
+  SS: "\xA7",
+  CROSS: "\u2020"
+};
+var CitationsManager = class {
+  _citations = /* @__PURE__ */ new Map();
+  _nextId = 0;
+  /**
+   * Registers a new source and returns the created Citation.
+   * @param source An object representing the source of the citation.
+   * @returns The created Citation.
+   */
+  registerSource(source) {
+    const id = this._nextId++;
+    const tag = `${RARE_SYMBOLS.OPENING_TAG}${id}${RARE_SYMBOLS.CLOSING_TAG}`;
+    const citation = {
+      id,
+      source,
+      tag
+    };
+    this._citations.set(id, citation);
+    return citation;
+  }
+  /**
+   * Extracts citations from the provided content and cleans the content of citation tags.
+   * Non-found citations are replaced with a special "Not Found" citation.
+   * @param content The string content containing citation tags.
+   * @returns An object containing the cleaned content and an array of found citations.
+   */
+  extractCitations(content, replace) {
+    const citations = [];
+    const notFoundCitation = {
+      id: -1,
+      source: "Not Found",
+      tag: ""
+    };
+    const regex = new RegExp(`${RARE_SYMBOLS.OPENING_TAG}([\\d|\\w|\\s|,]{0,})${RARE_SYMBOLS.CLOSING_TAG}`, "ig");
+    let match;
+    const offsets = [];
+    while ((match = regex.exec(content)) !== null) {
+      const offset = match.index;
+      const length = match[0].length;
+      offsets.push({ start: offset, length });
+      const multi = (match[1] ?? "").split(/\D/g).map((s) => s.trim()).filter(Boolean).map((s) => parseInt(s, 10)).filter((s) => !isNaN(s) && s >= 0);
+      for (const citationId of multi) {
+        const citation = this._citations.get(citationId);
+        if (citation) {
+          citations.push({ ...citation, offset });
+        } else {
+          citations.push({ ...notFoundCitation, offset });
+        }
+      }
+    }
+    const entries = offsets.map((o) => ({
+      start: o.start,
+      length: o.length,
+      citations: citations.filter((x) => x.offset === o.start && x.id !== -1)
+    })).sort((a, b) => a.start - b.start);
+    let result = "";
+    let cursor = 0;
+    for (const { start, length, citations: citations2 } of entries) {
+      result += content.slice(cursor, start);
+      const replacement = citations2.map((citation) => replace ? replace(citation) : "").join("");
+      result += replacement;
+      cursor = start + length;
+    }
+    result += content.slice(cursor);
+    return { cleaned: result, citations };
+  }
+  /**
+   * Strips citation tags from the provided content.
+   * @param content The string content containing citation tags.
+   * @returns The cleaned content without citation tags.
+   */
+  static stripCitationTags(content) {
+    const regex = new RegExp(`${RARE_SYMBOLS.OPENING_TAG}([\\d|\\w|\\s|,]{0,})${RARE_SYMBOLS.CLOSING_TAG}?`, "g");
+    return content.replace(regex, "");
+  }
+  /**
+   * Removes citations from a deeply nested plain object and returns a new object with citations removed.
+   * @param obj The plain object to process.
+   * @returns A tuple containing the new object and an array of extracted citations with paths.
+   */
+  removeCitationsFromObject(obj) {
+    const result = [];
+    const processObject = (current, path) => {
+      if (typeof current === "string") {
+        const extraction = this.extractCitations(current);
+        if (extraction.citations.length > 0) {
+          result.push(...extraction.citations.map((citation) => ({ path, citation })));
+        }
+        return extraction.cleaned;
+      } else if (typeof current === "object" && current !== null) {
+        const newObject = Array.isArray(current) ? [] : {};
+        for (const key of Object.keys(current)) {
+          newObject[key] = processObject(current[key], `${path}.${key}`);
+        }
+        return newObject;
+      }
+      return current;
+    };
+    const newObj = processObject(obj, "root");
+    return [newObj, result];
+  }
+  /**
+   * Re-adds citations to the cleaned content based on their offsets.
+   * @param cleaned The cleaned string without citation tags.
+   * @param citations The array of citations with offsets.
+   * @returns The string with citation tags re-added.
+   */
+  reAddCitations(cleaned, citations) {
+    let content = cleaned;
+    citations.sort((a, b) => (a.offset ?? 0) - (b.offset ?? 0));
+    const adjustment = 0;
+    for (const citation of citations) {
+      if (citation.offset != null) {
+        const position = citation.offset + adjustment;
+        content = content.slice(0, position) + citation.tag + content.slice(position);
+      }
+    }
+    return content;
+  }
+};
+
 // src/component.default.ts
-var Button = {
+import { z as z2 } from "@bpinternal/zui";
+var Button = new Component({
   type: "leaf",
   description: "A button component that can perform actions when clicked",
   name: "Button",
@@ -520,36 +664,15 @@ var Button = {
     }
   ],
   leaf: {
-    props: [
-      {
-        name: "action",
-        type: "string",
-        default: "say",
-        description: 'The action to perform when the button is clicked. Can be "say", "url", or "postback"',
-        required: true
-      },
-      {
-        name: "label",
-        type: "string",
-        description: "The text displayed on the button",
-        required: true
-      },
-      {
-        name: "value",
-        type: "string",
-        description: 'The postback value to send when the button is clicked. Required if action is "postback"',
-        required: false
-      },
-      {
-        name: "url",
-        type: "string",
-        description: 'The URL to open when the button is clicked. Required if action is "url"',
-        required: false
-      }
-    ]
-  }
-};
-var Image = {
+    props: z2.object({
+      action: z2.enum(["say", "url", "postback"]).default("say").describe('The action to perform when the button is clicked. Can be "say", "url", or "postback"'),
+      label: z2.string().describe("The text displayed on the button"),
+      value: z2.string().optional().describe('The postback value to send when the button is clicked. Required if action is "postback"'),
+      url: z2.string().optional().describe('The URL to open when the button is clicked. Required if action is "url"')
+    })
+  }
+});
+var Image = new Component({
   type: "leaf",
   name: "Image",
   description: "Displays an image from a URL.",
@@ -564,23 +687,13 @@ var Image = {
     }
   ],
   leaf: {
-    props: [
-      {
-        name: "url",
-        type: "string",
-        description: "The URL of the image (must be valid)",
-        required: true
-      },
-      {
-        name: "alt",
-        type: "string",
-        description: "Alternative text describing the image",
-        required: false
-      }
-    ]
+    props: z2.object({
+      url: z2.string().describe("The URL of the image (must be valid)"),
+      alt: z2.string().optional().describe("Alternative text describing the image")
+    })
   }
-};
-var File = {
+});
+var File = new Component({
   type: "leaf",
   name: "File",
   description: "Sends a downloadable file to the user.",
@@ -595,23 +708,13 @@ var File = {
     }
   ],
   leaf: {
-    props: [
-      {
-        name: "url",
-        type: "string",
-        description: "The URL of the file (must be valid)",
-        required: true
-      },
-      {
-        name: "name",
-        type: "string",
-        description: "The display name of the file",
-        required: false
-      }
-    ]
+    props: z2.object({
+      url: z2.string().describe("The URL of the file (must be valid)"),
+      name: z2.string().optional().describe("The display name of the file")
+    })
   }
-};
-var Video = {
+});
+var Video = new Component({
   type: "leaf",
   name: "Video",
   description: "Embeds a video from a URL.",
@@ -626,23 +729,13 @@ var Video = {
     }
   ],
   leaf: {
-    props: [
-      {
-        name: "url",
-        type: "string",
-        description: "The URL of the video (must be valid)",
-        required: true
-      },
-      {
-        name: "title",
-        type: "string",
-        description: "Title for the video",
-        required: false
-      }
-    ]
+    props: z2.object({
+      url: z2.string().describe("The URL of the video (must be valid)"),
+      title: z2.string().optional().describe("Title for the video")
+    })
   }
-};
-var Audio = {
+});
+var Audio = new Component({
   type: "leaf",
   name: "Audio",
   description: "Plays an audio clip from a URL.",
@@ -657,23 +750,13 @@ var Audio = {
     }
   ],
   leaf: {
-    props: [
-      {
-        name: "url",
-        type: "string",
-        description: "The URL of the audio clip (must be valid)",
-        required: true
-      },
-      {
-        name: "title",
-        type: "string",
-        description: "Title for the audio clip",
-        required: false
-      }
-    ]
+    props: z2.object({
+      url: z2.string().describe("The URL of the audio clip (must be valid)"),
+      title: z2.string().optional().describe("Title for the audio clip")
+    })
   }
-};
-var Card = {
+});
+var Card = new Component({
   type: "container",
   name: "Card",
   description: "A visual card component that can include an image and buttons.",
@@ -692,33 +775,23 @@ var Card = {
     }
   ],
   container: {
-    props: [
-      {
-        name: "title",
-        type: "string",
-        description: "Title text (1\u2013250 characters)",
-        required: true
-      },
-      {
-        name: "subtitle",
-        type: "string",
-        description: "Optional subtitle for the card",
-        required: false
-      }
-    ],
+    props: z2.object({
+      title: z2.string().min(1).max(250).describe("Title text (1\u2013250 characters)"),
+      subtitle: z2.string().optional().describe("Optional subtitle for the card")
+    }),
     children: [
       {
         description: "Image (optional, max 1)",
-        component: Image
+        component: Image.definition
       },
       {
         description: "Button (optional, up to 5)",
-        component: Button
+        component: Button.definition
       }
     ]
   }
-};
-var Carousel = {
+});
+var Carousel = new Component({
   type: "container",
   name: "Carousel",
   description: "A virtual container for displaying 1 to 10 Card components as a carousel.",
@@ -742,16 +815,16 @@ var Carousel = {
     }
   ],
   container: {
-    props: [],
+    props: z2.object({}),
     children: [
       {
         description: "Card component (required, 1\u201310 allowed)",
-        component: Card
+        component: Card.definition
       }
     ]
   }
-};
-var Text = {
+});
+var Text = new Component({
   type: "default",
   name: "Message",
   aliases: ["Text", "Markdown"],
@@ -766,10 +839,10 @@ var Text = {
     }
   ],
   default: {
-    props: [],
+    props: z2.object({}),
     children: []
   }
-};
+});
 var DefaultComponents = {
   Button,
   Image,
@@ -781,31 +854,54 @@ var DefaultComponents = {
   Text
 };
 
+// src/chat.ts
+var Chat = class {
+  handler;
+  transcript;
+  components;
+  constructor(props) {
+    this.handler = props.handler;
+    this.components = props.components;
+    this.transcript = props.transcript || [];
+  }
+  onExecutionDone(_result) {
+  }
+};
+
 // src/index.ts
-var executeContext = async (props) => {
-  const { executeContext: executeContext2 } = (await import("./llmz-WY74UVE3.js")).llmz;
-  return executeContext2(props);
+var execute = async (props) => {
+  const { executeContext } = await import("./llmz-YE5N54IU.js");
+  return executeContext(props);
 };
 var init = async () => {
-  await import("./llmz-WY74UVE3.js");
-  await import("./component-R3ZAVXUC.js");
-  await import("./tool-WVIPESKN.js");
-  await import("./exit-GYMXZZ4I.js");
-  await import("./jsx-CJ2RBODH.js");
-  await import("./vm-SMMA664M.js");
-  await import("./utils-TS23YJPE.js");
-  await import("./truncator-MTONQESU.js");
-  await import("./typings-HTYLRNIC.js");
-  await import("./dual-modes-2VDEOJ5D.js");
+  await import("./llmz-YE5N54IU.js");
+  await import("./component-R2Y74VUI.js");
+  await import("./tool-LY77IWV2.js");
+  await import("./exit-OIYZLBVJ.js");
+  await import("./jsx-AEHVFB3L.js");
+  await import("./vm-ZUQOSRRM.js");
+  await import("./utils-L5GLCS3C.js");
+  await import("./truncator-WAL2GCUY.js");
+  await import("./typings-AIV2OASX.js");
+  await import("./dual-modes-ZUQKPJFH.js");
 };
 export {
+  Chat,
+  CitationsManager,
+  Component,
   DefaultComponents,
   Exit,
+  ListenExit,
   ObjectInstance,
   Snapshot,
   SnapshotSignal,
+  ThinkExit,
   ThinkSignal,
   Tool,
-  executeContext,
-  init
+  assertValidComponent,
+  execute,
+  getValue,
+  init,
+  isAnyComponent,
+  isComponent
 };

package/dist/{jsx-CJ2RBODH.js → jsx-AEHVFB3L.js}

@@ -3,9 +3,8 @@ import {
   createJsxComponent,
   isAnyJsxComponent,
   isJsxComponent
-} from "./chunk-7FIPXMZR.js";
-import "./chunk-7S3UY52U.js";
-import "./chunk-YSQDPG26.js";
+} from "./chunk-ORQP26SZ.js";
+import "./chunk-7WRN4E42.js";
 export {
   Jsx,
   createJsxComponent,

package/dist/jsx-AJAXBWFE.cjs

@@ -0,0 +1,13 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+var _chunkKMZDFWYZcjs = require('./chunk-KMZDFWYZ.cjs');
+require('./chunk-UQOBUJIQ.cjs');
+
+
+
+
+
+exports.Jsx = _chunkKMZDFWYZcjs.Jsx; exports.createJsxComponent = _chunkKMZDFWYZcjs.createJsxComponent; exports.isAnyJsxComponent = _chunkKMZDFWYZcjs.isAnyJsxComponent; exports.isJsxComponent = _chunkKMZDFWYZcjs.isJsxComponent;