llmz 0.0.6 → 0.0.7

package/README.md

@@ -4,10 +4,6 @@
 
 ## Getting Started
 
-```
-npm install llmz
-```
-
 ## LLMz vs Tool Calling
 
 ## LLMz vs MCP

package/package.json

@@ -2,7 +2,7 @@
   "name": "llmz",
   "type": "module",
   "description": "LLMz – An LLM-native Typescript VM built on top of Zui",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
@@ -13,6 +13,7 @@
   "scripts": {
     "generate": "pnpm build:markdown",
     "build": "tsup && pnpm tsc --emitDeclarationOnly",
+    "check:type": "tsc --noEmit",
     "watch": "tsup --watch",
     "test": "vitest run --config vitest.config.ts",
     "test:update": "vitest -u run --config vitest.config.ts",
@@ -49,6 +50,7 @@
     "@types/babel__standalone": "^7.1.9",
     "@types/babel__traverse": "^7.20.6",
     "@types/bytes": "^3.1.5",
+    "@types/json-schema": "^7.0.12",
     "@types/lodash-es": "^4.17.12",
     "@types/ms": "^0.7.34",
     "@types/node": "^18.19.67",
@@ -63,9 +65,9 @@
     "tsx": "^4.19.2"
   },
   "peerDependencies": {
-    "@botpress/cognitive": "0.1.23",
+    "@botpress/cognitive": "0.1.25",
     "@bpinternal/thicktoken": "^1.0.5",
-    "@bpinternal/zui": "^0.22.5"
+    "@bpinternal/zui": "^1.0.0"
   },
   "dependenciesMeta": {
     "@bpinternal/zui": {

package/dist/chat.d.ts

@@ -1,17 +0,0 @@
-import { Component, RenderedComponent } from './component.js';
-import { Context } from './context.js';
-import { ValueOrGetter } from './getter.js';
-import { ExecutionResult } from './result.js';
-import { TranscriptArray, TranscriptMessage } from './transcript.js';
-export type MessageHandler = (input: RenderedComponent) => Promise<void> | void;
-export declare class Chat {
-    readonly handler: MessageHandler;
-    readonly transcript: ValueOrGetter<TranscriptArray, Context>;
-    readonly components: ValueOrGetter<Component[], Context>;
-    constructor(props: {
-        handler: MessageHandler;
-        components: ValueOrGetter<Component[], Context>;
-        transcript?: ValueOrGetter<TranscriptMessage[], Context>;
-    });
-    onExecutionDone(_result: ExecutionResult): void;
-}

package/dist/chunk-4I7UPBLN.cjs

@@ -1,104 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } var _class;
-
-
-var _chunkP7J2WCBBcjs = require('./chunk-P7J2WCBB.cjs');
-
-
-var _chunkUQOBUJIQcjs = require('./chunk-UQOBUJIQ.cjs');
-
-// src/exit.ts
-var _zui = require('@bpinternal/zui');
-var Exit = (_class = class _Exit {
-  
-  __init() {this.aliases = []}
-  
-  
-  
-  get zSchema() {
-    return this.schema ? _zui.z.fromJsonSchema(this.schema) : void 0;
-  }
-  rename(name) {
-    const before = this.name;
-    if (!_chunkP7J2WCBBcjs.isValidIdentifier.call(void 0, name)) {
-      throw new Error(
-        `Invalid name for exit ${name}. An exit name must start with a letter and contain only letters, numbers, and underscores. It must be 1-50 characters long.`
-      );
-    }
-    this.name = name;
-    this.aliases = _chunkUQOBUJIQcjs.uniq_default.call(void 0, [name, ...this.aliases.map((alias) => alias === before ? name : alias)]);
-    return this;
-  }
-  clone() {
-    return new _Exit({
-      name: this.name,
-      aliases: [...this.aliases],
-      description: this.description,
-      metadata: JSON.parse(JSON.stringify(this.metadata)),
-      schema: this.zSchema
-    });
-  }
-  is(exit) {
-    return this.name === exit.name;
-  }
-  match(result) {
-    return result.exit instanceof _Exit && this.name === result.exit.name;
-  }
-  constructor(props) {;_class.prototype.__init.call(this);
-    if (!_chunkP7J2WCBBcjs.isValidIdentifier.call(void 0, props.name)) {
-      throw new Error(
-        `Invalid name for exit ${props.name}. A exit name must start with a letter and contain only letters, numbers, and underscores. It must be 1-50 characters long.`
-      );
-    }
-    if (typeof props.description !== "string" || props.description.trim().length === 0) {
-      throw new Error(
-        `Invalid description for exit ${props.name}. Expected a non-empty string, but got type "${typeof props.description}"`
-      );
-    }
-    if (props.metadata !== void 0 && typeof props.metadata !== "object") {
-      throw new Error(
-        `Invalid metadata for exit ${props.name}. Expected an object, but got type "${typeof props.metadata}"`
-      );
-    }
-    if (props.aliases !== void 0 && !Array.isArray(props.aliases)) {
-      throw new Error(
-        `Invalid aliases for exit ${props.name}. Expected an array, but got type "${typeof props.aliases}"`
-      );
-    }
-    if (props.aliases && props.aliases.some((alias) => !_chunkP7J2WCBBcjs.isValidIdentifier.call(void 0, alias))) {
-      throw new Error(`Invalid aliases for exit ${props.name}. Expected an array of valid identifiers.`);
-    }
-    if (typeof props.schema !== "undefined") {
-      if (props.schema && "toJsonSchema" in props.schema && typeof props.schema.toJsonSchema === "function") {
-        this.schema = props.schema.toJsonSchema();
-      } else if (_chunkP7J2WCBBcjs.isJsonSchema.call(void 0, props.schema)) {
-        this.schema = props.schema;
-      } else {
-        throw new Error(
-          `Invalid input schema for exit ${props.name}. Expected a ZodType or JSONSchema, but got type "${typeof props.schema}"`
-        );
-      }
-    }
-    this.name = props.name;
-    this.aliases = _chunkUQOBUJIQcjs.uniq_default.call(void 0, [props.name, ..._nullishCoalesce(props.aliases, () => ( []))]);
-    this.description = props.description;
-    this.metadata = _nullishCoalesce(props.metadata, () => ( {}));
-  }
-  static __initStatic() {this.withUniqueNames = (exits) => {
-    const names = /* @__PURE__ */ new Set();
-    return exits.map((exit) => {
-      if (exits.filter((t) => t.name === exit.name).length === 1) {
-        return exit;
-      }
-      let counter = 1;
-      let exitName = exit.name + counter;
-      while (names.has(exitName)) {
-        exitName = `${exit.name}${++counter}`;
-      }
-      return exit.rename(exitName);
-    });
-  }}
-}, _class.__initStatic(), _class);
-
-
-
-exports.Exit = Exit;

package/dist/chunk-4QTK5ALH.cjs

@@ -1,211 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } var _class;
-
-var _chunkHYVKY3W6cjs = require('./chunk-HYVKY3W6.cjs');
-
-
-
-
-var _chunkP7J2WCBBcjs = require('./chunk-P7J2WCBB.cjs');
-
-
-
-var _chunkUQOBUJIQcjs = require('./chunk-UQOBUJIQ.cjs');
-
-// src/tool.ts
-var _zui = require('@bpinternal/zui');
-var Tool = (_class = class _Tool {
-  
-  
-  __init() {this.aliases = []}
-  
-  
-  
-  
-  
-  __init2() {this.MAX_RETRIES = 1e3}
-  setStaticInputValues(values) {
-    if (values === null || values === void 0) {
-      this._staticInputValues = void 0;
-      return this;
-    }
-    const input = this.input ? _zui.z.fromJsonSchema(this.input) : _zui.z.any();
-    if (input instanceof _zui.z.ZodObject && typeof values !== "object") {
-      throw new Error(
-        `Invalid static input values for tool ${this.name}. Expected an object, but got type "${typeof values}"`
-      );
-    }
-    if (input instanceof _zui.z.ZodArray && !Array.isArray(values)) {
-      throw new Error(
-        `Invalid static input values for tool ${this.name}. Expected an array, but got type "${typeof values}"`
-      );
-    }
-    this._staticInputValues = values;
-    return this;
-  }
-  get zInput() {
-    let input = this.input ? _zui.z.fromJsonSchema(this.input) : _zui.z.any();
-    if (!_chunkUQOBUJIQcjs.isEmpty_default.call(void 0, this._staticInputValues)) {
-      const inputExtensions = _chunkP7J2WCBBcjs.convertObjectToZuiLiterals.call(void 0, this._staticInputValues);
-      if (input instanceof _zui.z.ZodObject) {
-        input = input.extend(inputExtensions);
-      } else if (input instanceof _zui.z.ZodArray) {
-        input = _zui.z.array(input.element.extend(inputExtensions));
-      } else {
-        input = inputExtensions;
-      }
-    }
-    return input;
-  }
-  get zOutput() {
-    return this.output ? _zui.z.fromJsonSchema(this.output) : _zui.z.void();
-  }
-  rename(name) {
-    const before = this.name;
-    if (!_chunkP7J2WCBBcjs.isValidIdentifier.call(void 0, name)) {
-      throw new Error(
-        `Invalid name for tool ${name}. A tool name must start with a letter and contain only letters, numbers, and underscores. It must be 1-50 characters long.`
-      );
-    }
-    this.name = name;
-    this.aliases = _chunkUQOBUJIQcjs.uniq_default.call(void 0, [name, ...this.aliases.map((alias) => alias === before ? name : alias)]);
-    return this;
-  }
-  clone(props = {}) {
-    var _a, _b;
-    try {
-      const zInput = this.input ? _zui.z.fromJsonSchema(this.input) : void 0;
-      const zOutput = this.output ? _zui.z.fromJsonSchema(this.output) : void 0;
-      return new _Tool({
-        name: _nullishCoalesce(props.name, () => ( this.name)),
-        aliases: _nullishCoalesce(props.aliases, () => ( [...this.aliases])),
-        description: _nullishCoalesce(props.description, () => ( this.description)),
-        metadata: JSON.parse(JSON.stringify(_nullishCoalesce(props.metadata, () => ( this.metadata)))),
-        input: typeof props.input === "function" ? (_a = props.input) == null ? void 0 : _a.call(props, zInput) : props.input instanceof _zui.ZodType ? props.input : zInput,
-        output: typeof props.output === "function" ? (_b = props.output) == null ? void 0 : _b.call(props, zOutput) : props.output instanceof _zui.ZodType ? props.output : zOutput,
-        handler: _nullishCoalesce(props.handler, () => ( this._handler)),
-        retry: _nullishCoalesce(props.retry, () => ( this.retry))
-      }).setStaticInputValues(_nullishCoalesce(props.staticInputValues, () => ( this._staticInputValues)));
-    } catch (e) {
-      throw new Error(`Failed to clone tool "${this.name}": ${e}`);
-    }
-  }
-  
-  constructor(props) {;_class.prototype.__init.call(this);_class.prototype.__init2.call(this);
-    if (!_chunkP7J2WCBBcjs.isValidIdentifier.call(void 0, props.name)) {
-      throw new Error(
-        `Invalid name for tool ${props.name}. A tool name must start with a letter and contain only letters, numbers, and underscores. It must be 1-50 characters long.`
-      );
-    }
-    if (props.description !== void 0 && typeof props.description !== "string") {
-      throw new Error(
-        `Invalid description for tool ${props.name}. Expected a string, but got type "${typeof props.description}"`
-      );
-    }
-    if (props.metadata !== void 0 && typeof props.metadata !== "object") {
-      throw new Error(
-        `Invalid metadata for tool ${props.name}. Expected an object, but got type "${typeof props.metadata}"`
-      );
-    }
-    if (typeof props.handler !== "function") {
-      throw new Error(
-        `Invalid handler for tool ${props.name}. Expected a function, but got type "${typeof props.handler}"`
-      );
-    }
-    if (props.aliases !== void 0 && !Array.isArray(props.aliases)) {
-      throw new Error(
-        `Invalid aliases for tool ${props.name}. Expected an array, but got type "${typeof props.aliases}"`
-      );
-    }
-    if (props.aliases && props.aliases.some((alias) => !_chunkP7J2WCBBcjs.isValidIdentifier.call(void 0, alias))) {
-      throw new Error(`Invalid aliases for tool ${props.name}. Expected an array of valid identifiers.`);
-    }
-    if (typeof props.input !== "undefined") {
-      if (props.input && "toJsonSchema" in props.input && typeof props.input.toJsonSchema === "function") {
-        this.input = props.input.toJsonSchema();
-      } else if (_chunkP7J2WCBBcjs.isJsonSchema.call(void 0, props.input)) {
-        this.input = props.input;
-      } else {
-        throw new Error(
-          `Invalid input schema for tool ${props.name}. Expected a ZodType or JSONSchema, but got type "${typeof props.input}"`
-        );
-      }
-    }
-    if (typeof props.output !== "undefined") {
-      if (props.output && "toJsonSchema" in props.output && typeof props.output.toJsonSchema === "function") {
-        this.output = props.output.toJsonSchema();
-      } else if (_chunkP7J2WCBBcjs.isJsonSchema.call(void 0, props.output)) {
-        this.output = props.output;
-      } else {
-        throw new Error(
-          `Invalid output schema for tool ${props.name}. Expected a ZodType or JSONSchema, but got type "${typeof props.output}"`
-        );
-      }
-    }
-    this.name = props.name;
-    this.aliases = _chunkUQOBUJIQcjs.uniq_default.call(void 0, [props.name, ..._nullishCoalesce(props.aliases, () => ( []))]);
-    this.description = props.description;
-    this.metadata = _nullishCoalesce(props.metadata, () => ( {}));
-    this._handler = props.handler;
-    this.setStaticInputValues(props.staticInputValues);
-    this.retry = props.retry;
-  }
-  async execute(input, ctx) {
-    var _a;
-    const pInput = this.zInput.safeParse(input);
-    if (!pInput.success) {
-      throw new Error(`Tool "${this.name}" received invalid input: ${pInput.error.message}`);
-    }
-    let attempt = 0;
-    while (attempt < this.MAX_RETRIES) {
-      try {
-        const result = await this._handler(pInput.data, ctx);
-        const pOutput = this.zOutput.safeParse(result);
-        return pOutput.success ? pOutput.data : result;
-      } catch (err) {
-        const shouldRetry = await ((_a = this.retry) == null ? void 0 : _a.call(this, {
-          input: pInput.data,
-          attempt: ++attempt,
-          error: err
-        }));
-        if (!shouldRetry) {
-          throw err;
-        }
-      }
-    }
-    throw new Error(
-      `Tool "${this.name}" failed after ${this.MAX_RETRIES} attempts. Last error: ${JSON.stringify(input)}`
-    );
-  }
-  async getTypings() {
-    let input = this.input ? _zui.z.fromJsonSchema(this.input) : void 0;
-    const output = this.output ? _zui.z.fromJsonSchema(this.output) : _zui.z.void();
-    if ((input == null ? void 0 : input.naked()) instanceof _zui.ZodObject && typeof this._staticInputValues === "object" && !_chunkUQOBUJIQcjs.isEmpty_default.call(void 0, this._staticInputValues)) {
-      const inputExtensions = _chunkP7J2WCBBcjs.convertObjectToZuiLiterals.call(void 0, this._staticInputValues);
-      input = input.extend(inputExtensions);
-    } else if (this._staticInputValues !== void 0) {
-      input = _chunkP7J2WCBBcjs.convertObjectToZuiLiterals.call(void 0, this._staticInputValues);
-    }
-    const fnType = _zui.z.function(input, _zui.z.promise(output)).title(this.name).describe(_nullishCoalesce(this.description, () => ( "")));
-    return _chunkHYVKY3W6cjs.getTypings.call(void 0, fnType, {
-      declaration: true
-    });
-  }
-  static __initStatic() {this.withUniqueNames = (tools) => {
-    const names = /* @__PURE__ */ new Set();
-    return tools.map((tool) => {
-      if (tools.filter((t) => t.name === tool.name).length === 1) {
-        return tool;
-      }
-      let counter = 1;
-      let toolName = tool.name + counter;
-      while (names.has(toolName)) {
-        toolName = `${tool.name}${++counter}`;
-      }
-      return tool.rename(toolName);
-    });
-  }}
-}, _class.__initStatic(), _class);
-
-
-
-exports.Tool = Tool;

package/dist/chunk-5TRUJES5.js

@@ -1,220 +0,0 @@
-import {
-  camelCase_default,
-  deburr_default,
-  isPlainObject_default,
-  pickBy_default,
-  startCase_default
-} from "./chunk-7WRN4E42.js";
-
-// src/utils.ts
-import { getWasmTokenizer } from "@bpinternal/thicktoken";
-import { z } from "@bpinternal/zui";
-var tokenizer = null;
-var init = async () => {
-  if (tokenizer) {
-    return;
-  }
-  while (typeof getWasmTokenizer !== "function") {
-    await new Promise((resolve) => setTimeout(resolve, 50));
-  }
-  tokenizer = await getWasmTokenizer();
-};
-var getTokenizer = () => {
-  if (!tokenizer) {
-    throw new Error("Tokenizer not initialized, make sure to call init() first and await it");
-  }
-  return tokenizer;
-};
-var Tokens = (min, max) => {
-  return z.string().superRefine((value, ctx) => {
-    const tokens = tokenizer.count(value);
-    if (value.length < min) {
-      ctx.addIssue({
-        code: "too_small",
-        minimum: min,
-        type: "string",
-        message: `Text is ${tokens} but expected at least ${min} tokens`,
-        inclusive: true
-      });
-    }
-    if (value.length > max) {
-      ctx.addIssue({
-        code: "too_big",
-        maximum: max,
-        type: "string",
-        message: `Text is ${tokens} tokens but expected at most ${max} tokens`,
-        inclusive: true
-      });
-    }
-    return value;
-  });
-};
-var Identifier = z.string().min(1).max(100).regex(
-  /^([a-zA-Z_][a-zA-Z0-9_]*)$/,
-  "Identifiers must start with a letter and can only contain letters, numbers and underscores"
-);
-function escapeString(str) {
-  if (typeof str !== "string") {
-    return "";
-  }
-  const rawStr = String.raw`${str}`;
-  const escapedStr = rawStr.replace(/\\/g, "\\\\").replace(/\n/g, "\\n").replace(/"/g, '\\"').replace(/'/g, "\\'");
-  if (escapedStr.includes("`")) {
-    return `"${escapedStr}"`;
-  } else if (escapedStr.includes("'")) {
-    return `"${escapedStr}"`;
-  } else {
-    return `'${escapedStr}'`;
-  }
-}
-var toPropertyKey = (key) => {
-  if (/^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(key)) {
-    return key;
-  }
-  return escapeString(key);
-};
-var trimEmptyLines = (lines) => {
-  var _a;
-  while (lines.length && !((_a = lines[0]) == null ? void 0 : _a.trim())) {
-    lines.shift();
-  }
-  while (lines.length && !lines[lines.length - 1].trim()) {
-    lines.pop();
-  }
-};
-var getMultilineComment = (description) => {
-  description = description == null ? void 0 : description.replace(/(\n(\s*)?){3,}/g, "\n\n");
-  const ensureLineStartsWithAsterisk = (line) => line.startsWith("* ") ? ` ${line}` : ` * ${line}`;
-  const escapeCommentEnd = (line) => line.replace(/\*\//g, "*\\/");
-  const descLines = (description ?? "").split("\n").map((line) => line.trim());
-  trimEmptyLines(descLines);
-  if (descLines.length) {
-    descLines[0] = descLines[0].replace(/^\/\*\*?/, "");
-    descLines[descLines.length - 1] = descLines[descLines.length - 1].replace(/\*\/$/, "");
-  }
-  trimEmptyLines(descLines);
-  return descLines.length === 0 ? "" : descLines.length === 1 ? `/** ${escapeCommentEnd(descLines[0])} */` : `/**
-${descLines.map(ensureLineStartsWithAsterisk).map(escapeCommentEnd).join("\n")}
- */`;
-};
-var toValidFunctionName = (str) => {
-  let name = deburr_default(str);
-  name = name.replace(/[^a-zA-Z0-9_$]/g, "");
-  if (!/^[a-zA-Z_$]/.test(name)) {
-    name = `_${name}`;
-  }
-  return camelCase_default(name);
-};
-var awaitObject = async (obj) => {
-  const newObj = { ...obj };
-  const promises = [];
-  const setProp = async (key, value) => {
-    newObj[key] = await value;
-  };
-  for (const [key, value] of Object.entries(obj)) {
-    if (value instanceof Promise) {
-      promises.push(setProp(key, value));
-    } else if (isPlainObject_default(value)) {
-      promises.push(setProp(key, await awaitObject(value)));
-    }
-  }
-  await Promise.all(promises);
-  return newObj;
-};
-var toValidObjectName = (str) => {
-  let name = deburr_default(str);
-  name = name.split(/[^a-zA-Z0-9_$]/g).map(startCase_default).join("");
-  if (!/^[a-zA-Z_$]/.test(name)) {
-    name = `_${name}`;
-  }
-  return name.replaceAll(" ", "");
-};
-var stripInvalidIdentifiers = (object) => {
-  if (typeof object !== "object") {
-    return object;
-  }
-  if (Array.isArray(object)) {
-    return object.map(stripInvalidIdentifiers);
-  }
-  return pickBy_default(object, (__, key) => Identifier.safeParse(key).success);
-};
-var convertObjectToZuiLiterals = (obj, nested = false) => {
-  if (typeof obj === "string") {
-    return z.literal(obj).catch(() => obj);
-  }
-  if (typeof obj === "number") {
-    return z.literal(obj).catch(() => obj);
-  }
-  if (typeof obj === "boolean") {
-    return z.literal(obj).catch(() => obj);
-  }
-  if (Array.isArray(obj)) {
-    if (obj.length === 0) {
-      return z.tuple([]).catch(() => obj);
-    }
-    return z.tuple([
-      // the tuple needs to have at least one element
-      convertObjectToZuiLiterals(obj[0]),
-      ...obj.slice(1).map((child) => convertObjectToZuiLiterals(child))
-    ]).catch(() => obj);
-  }
-  if (obj !== null && typeof obj === "object") {
-    const shape = {};
-    for (const key in obj) {
-      shape[key] = convertObjectToZuiLiterals(obj[key], true);
-    }
-    if (nested) {
-      return z.object(shape).catch(() => shape);
-    }
-    return shape;
-  }
-  if (obj === void 0) {
-    return z.undefined().catch(() => void 0);
-  }
-  if (obj === null) {
-    return z.null().catch(() => null);
-  }
-  throw new Error(`Unsupported object type ${typeof obj}, ${obj})`);
-};
-var isValidSchema = (schema) => {
-  try {
-    z.fromJsonSchema(schema);
-    return typeof schema.type === "string";
-  } catch {
-    return false;
-  }
-};
-function isJsonSchema(schema) {
-  return !!schema && typeof schema === "object" && ("$schema" in schema || "type" in schema || "properties" in schema);
-}
-function isValidIdentifier(name) {
-  if (typeof name !== "string") {
-    return false;
-  }
-  return /^[A-Z]{1,}[A-Z0-9_]{0,50}$/i.test(name);
-}
-function isValidMessageName(name) {
-  if (typeof name !== "string") {
-    return false;
-  }
-  return /^[A-Z]{1,50}$/i.test(name);
-}
-
-export {
-  init,
-  getTokenizer,
-  Tokens,
-  Identifier,
-  escapeString,
-  toPropertyKey,
-  getMultilineComment,
-  toValidFunctionName,
-  awaitObject,
-  toValidObjectName,
-  stripInvalidIdentifiers,
-  convertObjectToZuiLiterals,
-  isValidSchema,
-  isJsonSchema,
-  isValidIdentifier,
-  isValidMessageName
-};