@langchain/core 1.2.4 → 1.2.5

package/dist/document_loaders/langsmith.js.map

@@ -1 +1 @@
-{"version":3,"file":"langsmith.js","names":[],"sources":["../../src/document_loaders/langsmith.ts"],"sourcesContent":["import { KVMap } from \"langsmith/schemas\";\nimport { Client } from \"langsmith\";\nimport { Document, DocumentInterface } from \"../documents/document.js\";\nimport { AsyncCallerParams } from \"../utils/async_caller.js\";\nimport { BaseDocumentLoader } from \"./base.js\";\n\n// TODO: Replace with import from `langsmith` once exposed.\ninterface ClientConfig {\n  apiUrl?: string;\n  apiKey?: string;\n  callerOptions?: AsyncCallerParams;\n  timeout_ms?: number;\n  webUrl?: string;\n  anonymizer?: (values: KVMap) => KVMap;\n  hideInputs?: boolean | ((inputs: KVMap) => KVMap);\n  hideOutputs?: boolean | ((outputs: KVMap) => KVMap);\n  autoBatchTracing?: boolean;\n  pendingAutoBatchedRunLimit?: number;\n  fetchOptions?: RequestInit;\n}\n\nexport interface LangSmithLoaderFields {\n  datasetId?: string;\n  datasetName?: string;\n  exampleIds?: Array<string>;\n  asOf?: Date | string;\n  splits?: string[];\n  inlineS3Urls?: boolean;\n  offset?: number;\n  limit?: number;\n  metadata?: KVMap;\n  filter?: string;\n  contentKey?: string;\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  formatContent?: (content: any) => string;\n  client?: Client;\n  clientConfig?: ClientConfig;\n}\n\n/**\n * Document loader integration with LangSmith.\n *\n * ## [Constructor args](https://api.js.langchain.com/interfaces/_langchain_core.document_loaders_langsmith.LangSmithLoaderFields.html)\n *\n * <details open>\n * <summary><strong>Load</strong></summary>\n *\n * ```typescript\n * import { LangSmithLoader } from '@langchain/core/document_loaders/langsmith';\n * import { Client } from 'langsmith';\n *\n * const langSmithClient = new Client({\n *   apiKey: process.env.LANGSMITH_API_KEY,\n * })\n *\n * const loader = new LangSmithLoader({\n *   datasetId: \"9a3b36f7-b308-40a5-9b46-6613853b6330\",\n *   limit: 1,\n * });\n *\n * const docs = await loader.load();\n * ```\n *\n * ```txt\n * [\n *   {\n *     pageContent: '{\\n  \"input_key_str\": \"string\",\\n  \"input_key_bool\": true\\n}',\n *     metadata: {\n *       id: '8523d9e9-c123-4b23-9b46-21021nds289e',\n *       created_at: '2024-08-19T17:09:14.806441+00:00',\n *       modified_at: '2024-08-19T17:09:14.806441+00:00',\n *       name: '#8517 @ brace-test-dataset',\n *       dataset_id: '9a3b36f7-b308-40a5-9b46-6613853b6330',\n *       source_run_id: null,\n *       metadata: [Object],\n *       inputs: [Object],\n *       outputs: [Object]\n *     }\n *   }\n * ]\n * ```\n * </details>\n */\nexport class LangSmithLoader extends BaseDocumentLoader {\n  datasetId?: string;\n\n  datasetName?: string;\n\n  exampleIds?: Array<string>;\n\n  asOf?: Date | string;\n\n  splits?: string[];\n\n  inlineS3Urls?: boolean;\n\n  offset?: number;\n\n  limit?: number;\n\n  metadata?: KVMap;\n\n  filter?: string;\n\n  contentKey: string[];\n\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  formatContent: (content: any) => string;\n\n  client: Client;\n\n  constructor(fields: LangSmithLoaderFields) {\n    super();\n\n    if (fields.client && fields.clientConfig) {\n      throw new Error(\"client and clientConfig cannot both be provided.\");\n    }\n    this.client = fields.client ?? new Client(fields?.clientConfig);\n    this.contentKey = fields.contentKey ? fields.contentKey.split(\".\") : [];\n    this.formatContent = fields.formatContent ?? _stringify;\n    this.datasetId = fields.datasetId;\n    this.datasetName = fields.datasetName;\n    this.exampleIds = fields.exampleIds;\n    this.asOf = fields.asOf;\n    this.splits = fields.splits;\n    this.inlineS3Urls = fields.inlineS3Urls;\n    this.offset = fields.offset;\n    this.limit = fields.limit;\n    this.metadata = fields.metadata;\n    this.filter = fields.filter;\n  }\n\n  async load(): Promise<Document[]> {\n    const documents: DocumentInterface[] = [];\n    for await (const example of this.client.listExamples({\n      datasetId: this.datasetId,\n      datasetName: this.datasetName,\n      exampleIds: this.exampleIds,\n      asOf: this.asOf,\n      splits: this.splits,\n      inlineS3Urls: this.inlineS3Urls,\n      offset: this.offset,\n      limit: this.limit,\n      metadata: this.metadata,\n      filter: this.filter,\n    })) {\n      let content = example.inputs;\n      for (const key of this.contentKey) {\n        content = content[key];\n      }\n      const contentStr = this.formatContent(content);\n\n      const metadata: KVMap = example;\n      [\"created_at\", \"modified_at\"].forEach((k) => {\n        if (k in metadata) {\n          if (typeof metadata[k] === \"object\") {\n            // Dates are of type `object`, we want to convert them to strings.\n            metadata[k] = metadata[k].toString();\n          }\n        }\n      });\n\n      documents.push({\n        pageContent: contentStr,\n        metadata,\n      });\n    }\n    return documents;\n  }\n}\n\nfunction _stringify(x: string | KVMap): string {\n  if (typeof x === \"string\") {\n    return x;\n  } else {\n    try {\n      return JSON.stringify(x, null, 2);\n    } catch {\n      return String(x);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmFA,IAAa,kBAAb,cAAqC,mBAAmB;CACtD;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA;CAGA;CAEA;CAEA,YAAY,QAA+B;AACzC,SAAO;AAEP,MAAI,OAAO,UAAU,OAAO,aAC1B,OAAM,IAAI,MAAM,mDAAmD;AAErE,OAAK,SAAS,OAAO,UAAU,IAAI,OAAO,QAAQ,aAAa;AAC/D,OAAK,aAAa,OAAO,aAAa,OAAO,WAAW,MAAM,IAAI,GAAG,EAAE;AACvE,OAAK,gBAAgB,OAAO,iBAAiB;AAC7C,OAAK,YAAY,OAAO;AACxB,OAAK,cAAc,OAAO;AAC1B,OAAK,aAAa,OAAO;AACzB,OAAK,OAAO,OAAO;AACnB,OAAK,SAAS,OAAO;AACrB,OAAK,eAAe,OAAO;AAC3B,OAAK,SAAS,OAAO;AACrB,OAAK,QAAQ,OAAO;AACpB,OAAK,WAAW,OAAO;AACvB,OAAK,SAAS,OAAO;;CAGvB,MAAM,OAA4B;EAChC,MAAM,YAAiC,EAAE;AACzC,aAAW,MAAM,WAAW,KAAK,OAAO,aAAa;GACnD,WAAW,KAAK;GAChB,aAAa,KAAK;GAClB,YAAY,KAAK;GACjB,MAAM,KAAK;GACX,QAAQ,KAAK;GACb,cAAc,KAAK;GACnB,QAAQ,KAAK;GACb,OAAO,KAAK;GACZ,UAAU,KAAK;GACf,QAAQ,KAAK;GACd,CAAC,EAAE;GACF,IAAI,UAAU,QAAQ;AACtB,QAAK,MAAM,OAAO,KAAK,WACrB,WAAU,QAAQ;GAEpB,MAAM,aAAa,KAAK,cAAc,QAAQ;GAE9C,MAAM,WAAkB;AACxB,IAAC,cAAc,cAAc,CAAC,SAAS,MAAM;AAC3C,QAAI,KAAK;SACH,OAAO,SAAS,OAAO,SAEzB,UAAS,KAAK,SAAS,GAAG,UAAU;;KAGxC;AAEF,aAAU,KAAK;IACb,aAAa;IACb;IACD,CAAC;;AAEJ,SAAO;;;AAIX,SAAS,WAAW,GAA2B;AAC7C,KAAI,OAAO,MAAM,SACf,QAAO;KAEP,KAAI;AACF,SAAO,KAAK,UAAU,GAAG,MAAM,EAAE;SAC3B;AACN,SAAO,OAAO,EAAE"}
+{"version":3,"file":"langsmith.js","names":[],"sources":["../../src/document_loaders/langsmith.ts"],"sourcesContent":["import { KVMap } from \"langsmith/schemas\";\nimport { Client } from \"langsmith\";\nimport { Document, DocumentInterface } from \"../documents/document.js\";\nimport { AsyncCallerParams } from \"../utils/async_caller.js\";\nimport { BaseDocumentLoader } from \"./base.js\";\n\n// TODO: Replace with import from `langsmith` once exposed.\ninterface ClientConfig {\n  apiUrl?: string;\n  apiKey?: string;\n  callerOptions?: AsyncCallerParams;\n  timeout_ms?: number;\n  webUrl?: string;\n  anonymizer?: (values: KVMap) => KVMap;\n  hideInputs?: boolean | ((inputs: KVMap) => KVMap);\n  hideOutputs?: boolean | ((outputs: KVMap) => KVMap);\n  autoBatchTracing?: boolean;\n  pendingAutoBatchedRunLimit?: number;\n  fetchOptions?: RequestInit;\n}\n\nexport interface LangSmithLoaderFields {\n  datasetId?: string;\n  datasetName?: string;\n  exampleIds?: Array<string>;\n  asOf?: Date | string;\n  splits?: string[];\n  inlineS3Urls?: boolean;\n  offset?: number;\n  limit?: number;\n  metadata?: KVMap;\n  filter?: string;\n  contentKey?: string;\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  formatContent?: (content: any) => string;\n  client?: Client;\n  clientConfig?: ClientConfig;\n}\n\n/**\n * Document loader integration with LangSmith.\n *\n * ## [Constructor args](https://api.js.langchain.com/interfaces/_langchain_core.document_loaders_langsmith.LangSmithLoaderFields.html)\n *\n * <details open>\n * <summary><strong>Load</strong></summary>\n *\n * ```typescript\n * import { LangSmithLoader } from '@langchain/core/document_loaders/langsmith';\n * import { Client } from 'langsmith';\n *\n * const langSmithClient = new Client({\n *   apiKey: process.env.LANGSMITH_API_KEY,\n * })\n *\n * const loader = new LangSmithLoader({\n *   datasetId: \"9a3b36f7-b308-40a5-9b46-6613853b6330\",\n *   limit: 1,\n * });\n *\n * const docs = await loader.load();\n * ```\n *\n * ```txt\n * [\n *   {\n *     pageContent: '{\\n  \"input_key_str\": \"string\",\\n  \"input_key_bool\": true\\n}',\n *     metadata: {\n *       id: '8523d9e9-c123-4b23-9b46-21021nds289e',\n *       created_at: '2024-08-19T17:09:14.806441+00:00',\n *       modified_at: '2024-08-19T17:09:14.806441+00:00',\n *       name: '#8517 @ brace-test-dataset',\n *       dataset_id: '9a3b36f7-b308-40a5-9b46-6613853b6330',\n *       source_run_id: null,\n *       metadata: [Object],\n *       inputs: [Object],\n *       outputs: [Object]\n *     }\n *   }\n * ]\n * ```\n * </details>\n */\nexport class LangSmithLoader extends BaseDocumentLoader {\n  datasetId?: string;\n\n  datasetName?: string;\n\n  exampleIds?: Array<string>;\n\n  asOf?: Date | string;\n\n  splits?: string[];\n\n  inlineS3Urls?: boolean;\n\n  offset?: number;\n\n  limit?: number;\n\n  metadata?: KVMap;\n\n  filter?: string;\n\n  contentKey: string[];\n\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  formatContent: (content: any) => string;\n\n  client: Client;\n\n  constructor(fields: LangSmithLoaderFields) {\n    super();\n\n    if (fields.client && fields.clientConfig) {\n      throw new Error(\"client and clientConfig cannot both be provided.\");\n    }\n    this.client = fields.client ?? new Client(fields?.clientConfig);\n    this.contentKey = fields.contentKey ? fields.contentKey.split(\".\") : [];\n    this.formatContent = fields.formatContent ?? _stringify;\n    this.datasetId = fields.datasetId;\n    this.datasetName = fields.datasetName;\n    this.exampleIds = fields.exampleIds;\n    this.asOf = fields.asOf;\n    this.splits = fields.splits;\n    this.inlineS3Urls = fields.inlineS3Urls;\n    this.offset = fields.offset;\n    this.limit = fields.limit;\n    this.metadata = fields.metadata;\n    this.filter = fields.filter;\n  }\n\n  async load(): Promise<Document[]> {\n    const documents: DocumentInterface[] = [];\n    for await (const example of this.client.listExamples({\n      datasetId: this.datasetId,\n      datasetName: this.datasetName,\n      exampleIds: this.exampleIds,\n      asOf: this.asOf,\n      splits: this.splits,\n      inlineS3Urls: this.inlineS3Urls,\n      offset: this.offset,\n      limit: this.limit,\n      metadata: this.metadata,\n      filter: this.filter,\n    })) {\n      let content = example.inputs;\n      for (const key of this.contentKey) {\n        content = content[key];\n      }\n      const contentStr = this.formatContent(content);\n\n      const metadata: KVMap = example;\n      [\"created_at\", \"modified_at\"].forEach((k) => {\n        if (k in metadata) {\n          if (typeof metadata[k] === \"object\") {\n            // Dates are of type `object`, we want to convert them to strings.\n            metadata[k] = metadata[k].toString();\n          }\n        }\n      });\n\n      documents.push({\n        pageContent: contentStr,\n        metadata,\n      });\n    }\n    return documents;\n  }\n}\n\nfunction _stringify(x: string | KVMap): string {\n  if (typeof x === \"string\") {\n    return x;\n  } else {\n    try {\n      return JSON.stringify(x, null, 2);\n    } catch {\n      return String(x);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmFA,IAAa,kBAAb,cAAqC,mBAAmB;CACtD;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA;CAGA;CAEA;CAEA,YAAY,QAA+B;EACzC,MAAM;EAEN,IAAI,OAAO,UAAU,OAAO,cAC1B,MAAM,IAAI,MAAM,kDAAkD;EAEpE,KAAK,SAAS,OAAO,UAAU,IAAI,OAAO,QAAQ,YAAY;EAC9D,KAAK,aAAa,OAAO,aAAa,OAAO,WAAW,MAAM,GAAG,IAAI,CAAC;EACtE,KAAK,gBAAgB,OAAO,iBAAiB;EAC7C,KAAK,YAAY,OAAO;EACxB,KAAK,cAAc,OAAO;EAC1B,KAAK,aAAa,OAAO;EACzB,KAAK,OAAO,OAAO;EACnB,KAAK,SAAS,OAAO;EACrB,KAAK,eAAe,OAAO;EAC3B,KAAK,SAAS,OAAO;EACrB,KAAK,QAAQ,OAAO;EACpB,KAAK,WAAW,OAAO;EACvB,KAAK,SAAS,OAAO;CACvB;CAEA,MAAM,OAA4B;EAChC,MAAM,YAAiC,CAAC;EACxC,WAAW,MAAM,WAAW,KAAK,OAAO,aAAa;GACnD,WAAW,KAAK;GAChB,aAAa,KAAK;GAClB,YAAY,KAAK;GACjB,MAAM,KAAK;GACX,QAAQ,KAAK;GACb,cAAc,KAAK;GACnB,QAAQ,KAAK;GACb,OAAO,KAAK;GACZ,UAAU,KAAK;GACf,QAAQ,KAAK;EACf,CAAC,GAAG;GACF,IAAI,UAAU,QAAQ;GACtB,KAAK,MAAM,OAAO,KAAK,YACrB,UAAU,QAAQ;GAEpB,MAAM,aAAa,KAAK,cAAc,OAAO;GAE7C,MAAM,WAAkB;GACxB,CAAC,cAAc,aAAa,CAAC,CAAC,SAAS,MAAM;IAC3C,IAAI,KAAK,UACH;SAAA,OAAO,SAAS,OAAO,UAEzB,SAAS,KAAK,SAAS,EAAE,CAAC,SAAS;IAAA;GAGzC,CAAC;GAED,UAAU,KAAK;IACb,aAAa;IACb;GACF,CAAC;EACH;EACA,OAAO;CACT;AACF;AAEA,SAAS,WAAW,GAA2B;CAC7C,IAAI,OAAO,MAAM,UACf,OAAO;MAEP,IAAI;EACF,OAAO,KAAK,UAAU,GAAG,MAAM,CAAC;CAClC,QAAQ;EACN,OAAO,OAAO,CAAC;CACjB;AAEJ"}

package/dist/documents/document.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"document.cjs","names":[],"sources":["../../src/documents/document.ts"],"sourcesContent":["export interface DocumentInput<\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  Metadata extends Record<string, any> = Record<string, any>,\n> {\n  pageContent: string;\n\n  metadata?: Metadata;\n\n  /**\n   * An optional identifier for the document.\n   *\n   * Ideally this should be unique across the document collection and formatted\n   * as a UUID, but this will not be enforced.\n   */\n  id?: string;\n}\n\nexport interface DocumentInterface<\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  Metadata extends Record<string, any> = Record<string, any>,\n> {\n  pageContent: string;\n\n  metadata: Metadata;\n\n  /**\n   * An optional identifier for the document.\n   *\n   * Ideally this should be unique across the document collection and formatted\n   * as a UUID, but this will not be enforced.\n   */\n  id?: string;\n}\n\n/**\n * Interface for interacting with a document.\n */\nexport class Document<\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  Metadata extends Record<string, any> = Record<string, any>,\n>\n  implements DocumentInput, DocumentInterface\n{\n  pageContent: string;\n\n  metadata: Metadata;\n\n  // The ID field is optional at the moment.\n  // It will likely become required in a future major release after\n  // it has been adopted by enough vectorstore implementations.\n  /**\n   * An optional identifier for the document.\n   *\n   * Ideally this should be unique across the document collection and formatted\n   * as a UUID, but this will not be enforced.\n   */\n  id?: string;\n\n  constructor(fields: DocumentInput<Metadata>) {\n    this.pageContent =\n      fields.pageContent !== undefined ? fields.pageContent.toString() : \"\";\n    this.metadata = fields.metadata ?? ({} as Metadata);\n    this.id = fields.id;\n  }\n}\n"],"mappings":";;;;AAqCA,IAAa,WAAb,MAKA;CACE;CAEA;;;;;;;CAWA;CAEA,YAAY,QAAiC;AAC3C,OAAK,cACH,OAAO,gBAAgB,KAAA,IAAY,OAAO,YAAY,UAAU,GAAG;AACrE,OAAK,WAAW,OAAO,YAAa,EAAE;AACtC,OAAK,KAAK,OAAO"}
+{"version":3,"file":"document.cjs","names":[],"sources":["../../src/documents/document.ts"],"sourcesContent":["export interface DocumentInput<\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  Metadata extends Record<string, any> = Record<string, any>,\n> {\n  pageContent: string;\n\n  metadata?: Metadata;\n\n  /**\n   * An optional identifier for the document.\n   *\n   * Ideally this should be unique across the document collection and formatted\n   * as a UUID, but this will not be enforced.\n   */\n  id?: string;\n}\n\nexport interface DocumentInterface<\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  Metadata extends Record<string, any> = Record<string, any>,\n> {\n  pageContent: string;\n\n  metadata: Metadata;\n\n  /**\n   * An optional identifier for the document.\n   *\n   * Ideally this should be unique across the document collection and formatted\n   * as a UUID, but this will not be enforced.\n   */\n  id?: string;\n}\n\n/**\n * Interface for interacting with a document.\n */\nexport class Document<\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  Metadata extends Record<string, any> = Record<string, any>,\n>\n  implements DocumentInput, DocumentInterface\n{\n  pageContent: string;\n\n  metadata: Metadata;\n\n  // The ID field is optional at the moment.\n  // It will likely become required in a future major release after\n  // it has been adopted by enough vectorstore implementations.\n  /**\n   * An optional identifier for the document.\n   *\n   * Ideally this should be unique across the document collection and formatted\n   * as a UUID, but this will not be enforced.\n   */\n  id?: string;\n\n  constructor(fields: DocumentInput<Metadata>) {\n    this.pageContent =\n      fields.pageContent !== undefined ? fields.pageContent.toString() : \"\";\n    this.metadata = fields.metadata ?? ({} as Metadata);\n    this.id = fields.id;\n  }\n}\n"],"mappings":";;;;AAqCA,IAAa,WAAb,MAKA;CACE;CAEA;;;;;;;CAWA;CAEA,YAAY,QAAiC;EAC3C,KAAK,cACH,OAAO,gBAAgB,KAAA,IAAY,OAAO,YAAY,SAAS,IAAI;EACrE,KAAK,WAAW,OAAO,YAAa,CAAC;EACrC,KAAK,KAAK,OAAO;CACnB;AACF"}

package/dist/documents/document.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"document.d.cts","names":[],"sources":["../../src/documents/document.ts"],"mappings":";UAAiB,aAAA,kBAEE,MAAA,gBAAsB,MAAA;EAEvC,WAAA;EAEA,QAAA,GAAW,QAAA;EANiB;;;;;;EAc5B,EAAA;AAAA;AAAA,UAGe,iBAAA,kBAEE,MAAA,gBAAsB,MAAA;EAEvC,WAAA;EAEA,QAAA,EAAU,QAAA;EAjBC;;;;AAWb;;EAcE,EAAA;AAAA;;;;cAMW,QAAA,kBAEM,MAAA,gBAAsB,MAAA,0BAE5B,aAAA,EAAe,iBAAA;EAE1B,WAAA;EAEA,QAAA,EAAU,QAAA;EA1B6B;;;;;;EAqCvC,EAAA;EAEA,WAAA,CAAY,MAAA,EAAQ,aAAA,CAAc,QAAA;AAAA"}
+{"version":3,"file":"document.d.cts","names":[],"sources":["../../src/documents/document.ts"],"mappings":";UAAiB,cAEf,iBAAiB,sBAAsB;EAEvC;EAEA,WAAW;;;;;;;EAQX;;UAGe,kBAEf,iBAAiB,sBAAsB;EAEvC;EAEA,UAAU;;;;;;;EAQV;;;;;cAMW,SAEX,iBAAiB,sBAAsB,gCAE5B,eAAe;EAE1B;EAEA,UAAU;;;;;;;EAWV;EAEA,YAAY,QAAQ,cAAc"}

package/dist/documents/document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document.d.ts","names":[],"sources":["../../src/documents/document.ts"],"mappings":";UAAiB,aAAA,kBAEE,MAAA,gBAAsB,MAAA;EAEvC,WAAA;EAEA,QAAA,GAAW,QAAA;EANiB;;;;;;EAc5B,EAAA;AAAA;AAAA,UAGe,iBAAA,kBAEE,MAAA,gBAAsB,MAAA;EAEvC,WAAA;EAEA,QAAA,EAAU,QAAA;EAjBC;;;;AAWb;;EAcE,EAAA;AAAA;;;;cAMW,QAAA,kBAEM,MAAA,gBAAsB,MAAA,0BAE5B,aAAA,EAAe,iBAAA;EAE1B,WAAA;EAEA,QAAA,EAAU,QAAA;EA1B6B;;;;;;EAqCvC,EAAA;EAEA,WAAA,CAAY,MAAA,EAAQ,aAAA,CAAc,QAAA;AAAA"}
+{"version":3,"file":"document.d.ts","names":[],"sources":["../../src/documents/document.ts"],"mappings":";UAAiB,cAEf,iBAAiB,sBAAsB;EAEvC;EAEA,WAAW;;;;;;;EAQX;;UAGe,kBAEf,iBAAiB,sBAAsB;EAEvC;EAEA,UAAU;;;;;;;EAQV;;;;;cAMW,SAEX,iBAAiB,sBAAsB,gCAE5B,eAAe;EAE1B;EAEA,UAAU;;;;;;;EAWV;EAEA,YAAY,QAAQ,cAAc"}

package/dist/documents/document.js.map

@@ -1 +1 @@
-{"version":3,"file":"document.js","names":[],"sources":["../../src/documents/document.ts"],"sourcesContent":["export interface DocumentInput<\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  Metadata extends Record<string, any> = Record<string, any>,\n> {\n  pageContent: string;\n\n  metadata?: Metadata;\n\n  /**\n   * An optional identifier for the document.\n   *\n   * Ideally this should be unique across the document collection and formatted\n   * as a UUID, but this will not be enforced.\n   */\n  id?: string;\n}\n\nexport interface DocumentInterface<\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  Metadata extends Record<string, any> = Record<string, any>,\n> {\n  pageContent: string;\n\n  metadata: Metadata;\n\n  /**\n   * An optional identifier for the document.\n   *\n   * Ideally this should be unique across the document collection and formatted\n   * as a UUID, but this will not be enforced.\n   */\n  id?: string;\n}\n\n/**\n * Interface for interacting with a document.\n */\nexport class Document<\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  Metadata extends Record<string, any> = Record<string, any>,\n>\n  implements DocumentInput, DocumentInterface\n{\n  pageContent: string;\n\n  metadata: Metadata;\n\n  // The ID field is optional at the moment.\n  // It will likely become required in a future major release after\n  // it has been adopted by enough vectorstore implementations.\n  /**\n   * An optional identifier for the document.\n   *\n   * Ideally this should be unique across the document collection and formatted\n   * as a UUID, but this will not be enforced.\n   */\n  id?: string;\n\n  constructor(fields: DocumentInput<Metadata>) {\n    this.pageContent =\n      fields.pageContent !== undefined ? fields.pageContent.toString() : \"\";\n    this.metadata = fields.metadata ?? ({} as Metadata);\n    this.id = fields.id;\n  }\n}\n"],"mappings":";;;;AAqCA,IAAa,WAAb,MAKA;CACE;CAEA;;;;;;;CAWA;CAEA,YAAY,QAAiC;AAC3C,OAAK,cACH,OAAO,gBAAgB,KAAA,IAAY,OAAO,YAAY,UAAU,GAAG;AACrE,OAAK,WAAW,OAAO,YAAa,EAAE;AACtC,OAAK,KAAK,OAAO"}
+{"version":3,"file":"document.js","names":[],"sources":["../../src/documents/document.ts"],"sourcesContent":["export interface DocumentInput<\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  Metadata extends Record<string, any> = Record<string, any>,\n> {\n  pageContent: string;\n\n  metadata?: Metadata;\n\n  /**\n   * An optional identifier for the document.\n   *\n   * Ideally this should be unique across the document collection and formatted\n   * as a UUID, but this will not be enforced.\n   */\n  id?: string;\n}\n\nexport interface DocumentInterface<\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  Metadata extends Record<string, any> = Record<string, any>,\n> {\n  pageContent: string;\n\n  metadata: Metadata;\n\n  /**\n   * An optional identifier for the document.\n   *\n   * Ideally this should be unique across the document collection and formatted\n   * as a UUID, but this will not be enforced.\n   */\n  id?: string;\n}\n\n/**\n * Interface for interacting with a document.\n */\nexport class Document<\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  Metadata extends Record<string, any> = Record<string, any>,\n>\n  implements DocumentInput, DocumentInterface\n{\n  pageContent: string;\n\n  metadata: Metadata;\n\n  // The ID field is optional at the moment.\n  // It will likely become required in a future major release after\n  // it has been adopted by enough vectorstore implementations.\n  /**\n   * An optional identifier for the document.\n   *\n   * Ideally this should be unique across the document collection and formatted\n   * as a UUID, but this will not be enforced.\n   */\n  id?: string;\n\n  constructor(fields: DocumentInput<Metadata>) {\n    this.pageContent =\n      fields.pageContent !== undefined ? fields.pageContent.toString() : \"\";\n    this.metadata = fields.metadata ?? ({} as Metadata);\n    this.id = fields.id;\n  }\n}\n"],"mappings":";;;;AAqCA,IAAa,WAAb,MAKA;CACE;CAEA;;;;;;;CAWA;CAEA,YAAY,QAAiC;EAC3C,KAAK,cACH,OAAO,gBAAgB,KAAA,IAAY,OAAO,YAAY,SAAS,IAAI;EACrE,KAAK,WAAW,OAAO,YAAa,CAAC;EACrC,KAAK,KAAK,OAAO;CACnB;AACF"}

package/dist/documents/transformers.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"transformers.cjs","names":["Runnable"],"sources":["../../src/documents/transformers.ts"],"sourcesContent":["import { Runnable } from \"../runnables/base.js\";\nimport type { BaseCallbackConfig } from \"../callbacks/manager.js\";\nimport type { DocumentInterface } from \"./document.js\";\n\n/**\n * Abstract base class for document transformation systems.\n *\n * A document transformation system takes an array of Documents and returns an\n * array of transformed Documents. These arrays do not necessarily have to have\n * the same length.\n *\n * One example of this is a text splitter that splits a large document into\n * many smaller documents.\n */\nexport abstract class BaseDocumentTransformer<\n  RunInput extends DocumentInterface[] = DocumentInterface[],\n  RunOutput extends DocumentInterface[] = DocumentInterface[],\n> extends Runnable<RunInput, RunOutput> {\n  lc_namespace = [\"langchain_core\", \"documents\", \"transformers\"];\n\n  /**\n   * Transform a list of documents.\n   * @param documents A sequence of documents to be transformed.\n   * @returns A list of transformed documents.\n   */\n  abstract transformDocuments(documents: RunInput): Promise<RunOutput>;\n\n  /**\n   * Method to invoke the document transformation. This method calls the\n   * transformDocuments method with the provided input.\n   * @param input The input documents to be transformed.\n   * @param _options Optional configuration object to customize the behavior of callbacks.\n   * @returns A Promise that resolves to the transformed documents.\n   */\n  invoke(input: RunInput, _options?: BaseCallbackConfig): Promise<RunOutput> {\n    return this.transformDocuments(input);\n  }\n}\n\n/**\n * Class for document transformers that return exactly one transformed document\n * for each input document.\n */\nexport abstract class MappingDocumentTransformer extends BaseDocumentTransformer {\n  async transformDocuments(\n    documents: DocumentInterface[]\n  ): Promise<DocumentInterface[]> {\n    const newDocuments = [];\n    for (const document of documents) {\n      const transformedDocument = await this._transformDocument(document);\n      newDocuments.push(transformedDocument);\n    }\n    return newDocuments;\n  }\n\n  abstract _transformDocument(\n    document: DocumentInterface\n  ): Promise<DocumentInterface>;\n}\n"],"mappings":";;;;;;;;;;;;AAcA,IAAsB,0BAAtB,cAGUA,aAAAA,SAA8B;CACtC,eAAe;EAAC;EAAkB;EAAa;EAAe;;;;;;;;CAgB9D,OAAO,OAAiB,UAAmD;AACzE,SAAO,KAAK,mBAAmB,MAAM;;;;;;;AAQzC,IAAsB,6BAAtB,cAAyD,wBAAwB;CAC/E,MAAM,mBACJ,WAC8B;EAC9B,MAAM,eAAe,EAAE;AACvB,OAAK,MAAM,YAAY,WAAW;GAChC,MAAM,sBAAsB,MAAM,KAAK,mBAAmB,SAAS;AACnE,gBAAa,KAAK,oBAAoB;;AAExC,SAAO"}
+{"version":3,"file":"transformers.cjs","names":["Runnable"],"sources":["../../src/documents/transformers.ts"],"sourcesContent":["import { Runnable } from \"../runnables/base.js\";\nimport type { BaseCallbackConfig } from \"../callbacks/manager.js\";\nimport type { DocumentInterface } from \"./document.js\";\n\n/**\n * Abstract base class for document transformation systems.\n *\n * A document transformation system takes an array of Documents and returns an\n * array of transformed Documents. These arrays do not necessarily have to have\n * the same length.\n *\n * One example of this is a text splitter that splits a large document into\n * many smaller documents.\n */\nexport abstract class BaseDocumentTransformer<\n  RunInput extends DocumentInterface[] = DocumentInterface[],\n  RunOutput extends DocumentInterface[] = DocumentInterface[],\n> extends Runnable<RunInput, RunOutput> {\n  lc_namespace = [\"langchain_core\", \"documents\", \"transformers\"];\n\n  /**\n   * Transform a list of documents.\n   * @param documents A sequence of documents to be transformed.\n   * @returns A list of transformed documents.\n   */\n  abstract transformDocuments(documents: RunInput): Promise<RunOutput>;\n\n  /**\n   * Method to invoke the document transformation. This method calls the\n   * transformDocuments method with the provided input.\n   * @param input The input documents to be transformed.\n   * @param _options Optional configuration object to customize the behavior of callbacks.\n   * @returns A Promise that resolves to the transformed documents.\n   */\n  invoke(input: RunInput, _options?: BaseCallbackConfig): Promise<RunOutput> {\n    return this.transformDocuments(input);\n  }\n}\n\n/**\n * Class for document transformers that return exactly one transformed document\n * for each input document.\n */\nexport abstract class MappingDocumentTransformer extends BaseDocumentTransformer {\n  async transformDocuments(\n    documents: DocumentInterface[]\n  ): Promise<DocumentInterface[]> {\n    const newDocuments = [];\n    for (const document of documents) {\n      const transformedDocument = await this._transformDocument(document);\n      newDocuments.push(transformedDocument);\n    }\n    return newDocuments;\n  }\n\n  abstract _transformDocument(\n    document: DocumentInterface\n  ): Promise<DocumentInterface>;\n}\n"],"mappings":";;;;;;;;;;;;AAcA,IAAsB,0BAAtB,cAGUA,aAAAA,SAA8B;CACtC,eAAe;EAAC;EAAkB;EAAa;CAAc;;;;;;;;CAgB7D,OAAO,OAAiB,UAAmD;EACzE,OAAO,KAAK,mBAAmB,KAAK;CACtC;AACF;;;;;AAMA,IAAsB,6BAAtB,cAAyD,wBAAwB;CAC/E,MAAM,mBACJ,WAC8B;EAC9B,MAAM,eAAe,CAAC;EACtB,KAAK,MAAM,YAAY,WAAW;GAChC,MAAM,sBAAsB,MAAM,KAAK,mBAAmB,QAAQ;GAClE,aAAa,KAAK,mBAAmB;EACvC;EACA,OAAO;CACT;AAKF"}

package/dist/documents/transformers.d.cts

@@ -1,7 +1,6 @@
 import { DocumentInterface } from "./document.cjs";
 import { BaseCallbackConfig } from "../callbacks/manager.cjs";
 import { Runnable } from "../runnables/base.cjs";
-
 //#region src/documents/transformers.d.ts
 /**
  * Abstract base class for document transformation systems.

package/dist/documents/transformers.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"transformers.d.cts","names":[],"sources":["../../src/documents/transformers.ts"],"mappings":";;;;;;;AAcA;;;;;;;;uBAAsB,uBAAA,kBACH,iBAAA,KAAsB,iBAAA,sBACrB,iBAAA,KAAsB,iBAAA,YAChC,QAAA,CAAS,QAAA,EAAU,SAAA;EAC3B,YAAA;EAO0D;;;;;EAAA,SAAjD,kBAAA,CAAmB,SAAA,EAAW,QAAA,GAAW,OAAA,CAAQ,SAAA;EARlD;;;;;;;EAiBR,MAAA,CAAO,KAAA,EAAO,QAAA,EAAU,QAAA,GAAW,kBAAA,GAAqB,OAAA,CAAQ,SAAA;AAAA;;;;;uBAS5C,0BAAA,SAAmC,uBAAA;EACjD,kBAAA,CACJ,SAAA,EAAW,iBAAA,KACV,OAAA,CAAQ,iBAAA;EAAA,SASF,kBAAA,CACP,QAAA,EAAU,iBAAA,GACT,OAAA,CAAQ,iBAAA;AAAA"}
+{"version":3,"file":"transformers.d.cts","names":[],"sources":["../../src/documents/transformers.ts"],"mappings":";;;;;;;;;;;;;;uBAcsB,wBACpB,iBAAiB,sBAAsB,qBACvC,kBAAkB,sBAAsB,6BAChC,SAAS,UAAU;EAC3B;;;;;;WAOS,mBAAmB,WAAW,WAAW,QAAQ;;;;;;;;EAS1D,OAAO,OAAO,UAAU,WAAW,qBAAqB,QAAQ;;;;;;uBAS5C,mCAAmC;EACjD,mBACJ,WAAW,sBACV,QAAQ;WASF,mBACP,UAAU,oBACT,QAAQ"}

package/dist/documents/transformers.d.ts

@@ -1,7 +1,6 @@
 import { DocumentInterface } from "./document.js";
 import { BaseCallbackConfig } from "../callbacks/manager.js";
 import { Runnable } from "../runnables/base.js";
-
 //#region src/documents/transformers.d.ts
 /**
  * Abstract base class for document transformation systems.

package/dist/documents/transformers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transformers.d.ts","names":[],"sources":["../../src/documents/transformers.ts"],"mappings":";;;;;;;AAcA;;;;;;;;uBAAsB,uBAAA,kBACH,iBAAA,KAAsB,iBAAA,sBACrB,iBAAA,KAAsB,iBAAA,YAChC,QAAA,CAAS,QAAA,EAAU,SAAA;EAC3B,YAAA;EAO0D;;;;;EAAA,SAAjD,kBAAA,CAAmB,SAAA,EAAW,QAAA,GAAW,OAAA,CAAQ,SAAA;EARlD;;;;;;;EAiBR,MAAA,CAAO,KAAA,EAAO,QAAA,EAAU,QAAA,GAAW,kBAAA,GAAqB,OAAA,CAAQ,SAAA;AAAA;;;;;uBAS5C,0BAAA,SAAmC,uBAAA;EACjD,kBAAA,CACJ,SAAA,EAAW,iBAAA,KACV,OAAA,CAAQ,iBAAA;EAAA,SASF,kBAAA,CACP,QAAA,EAAU,iBAAA,GACT,OAAA,CAAQ,iBAAA;AAAA"}
+{"version":3,"file":"transformers.d.ts","names":[],"sources":["../../src/documents/transformers.ts"],"mappings":";;;;;;;;;;;;;;uBAcsB,wBACpB,iBAAiB,sBAAsB,qBACvC,kBAAkB,sBAAsB,6BAChC,SAAS,UAAU;EAC3B;;;;;;WAOS,mBAAmB,WAAW,WAAW,QAAQ;;;;;;;;EAS1D,OAAO,OAAO,UAAU,WAAW,qBAAqB,QAAQ;;;;;;uBAS5C,mCAAmC;EACjD,mBACJ,WAAW,sBACV,QAAQ;WASF,mBACP,UAAU,oBACT,QAAQ"}

package/dist/documents/transformers.js.map

@@ -1 +1 @@
-{"version":3,"file":"transformers.js","names":[],"sources":["../../src/documents/transformers.ts"],"sourcesContent":["import { Runnable } from \"../runnables/base.js\";\nimport type { BaseCallbackConfig } from \"../callbacks/manager.js\";\nimport type { DocumentInterface } from \"./document.js\";\n\n/**\n * Abstract base class for document transformation systems.\n *\n * A document transformation system takes an array of Documents and returns an\n * array of transformed Documents. These arrays do not necessarily have to have\n * the same length.\n *\n * One example of this is a text splitter that splits a large document into\n * many smaller documents.\n */\nexport abstract class BaseDocumentTransformer<\n  RunInput extends DocumentInterface[] = DocumentInterface[],\n  RunOutput extends DocumentInterface[] = DocumentInterface[],\n> extends Runnable<RunInput, RunOutput> {\n  lc_namespace = [\"langchain_core\", \"documents\", \"transformers\"];\n\n  /**\n   * Transform a list of documents.\n   * @param documents A sequence of documents to be transformed.\n   * @returns A list of transformed documents.\n   */\n  abstract transformDocuments(documents: RunInput): Promise<RunOutput>;\n\n  /**\n   * Method to invoke the document transformation. This method calls the\n   * transformDocuments method with the provided input.\n   * @param input The input documents to be transformed.\n   * @param _options Optional configuration object to customize the behavior of callbacks.\n   * @returns A Promise that resolves to the transformed documents.\n   */\n  invoke(input: RunInput, _options?: BaseCallbackConfig): Promise<RunOutput> {\n    return this.transformDocuments(input);\n  }\n}\n\n/**\n * Class for document transformers that return exactly one transformed document\n * for each input document.\n */\nexport abstract class MappingDocumentTransformer extends BaseDocumentTransformer {\n  async transformDocuments(\n    documents: DocumentInterface[]\n  ): Promise<DocumentInterface[]> {\n    const newDocuments = [];\n    for (const document of documents) {\n      const transformedDocument = await this._transformDocument(document);\n      newDocuments.push(transformedDocument);\n    }\n    return newDocuments;\n  }\n\n  abstract _transformDocument(\n    document: DocumentInterface\n  ): Promise<DocumentInterface>;\n}\n"],"mappings":";;;;;;;;;;;;AAcA,IAAsB,0BAAtB,cAGU,SAA8B;CACtC,eAAe;EAAC;EAAkB;EAAa;EAAe;;;;;;;;CAgB9D,OAAO,OAAiB,UAAmD;AACzE,SAAO,KAAK,mBAAmB,MAAM;;;;;;;AAQzC,IAAsB,6BAAtB,cAAyD,wBAAwB;CAC/E,MAAM,mBACJ,WAC8B;EAC9B,MAAM,eAAe,EAAE;AACvB,OAAK,MAAM,YAAY,WAAW;GAChC,MAAM,sBAAsB,MAAM,KAAK,mBAAmB,SAAS;AACnE,gBAAa,KAAK,oBAAoB;;AAExC,SAAO"}
+{"version":3,"file":"transformers.js","names":[],"sources":["../../src/documents/transformers.ts"],"sourcesContent":["import { Runnable } from \"../runnables/base.js\";\nimport type { BaseCallbackConfig } from \"../callbacks/manager.js\";\nimport type { DocumentInterface } from \"./document.js\";\n\n/**\n * Abstract base class for document transformation systems.\n *\n * A document transformation system takes an array of Documents and returns an\n * array of transformed Documents. These arrays do not necessarily have to have\n * the same length.\n *\n * One example of this is a text splitter that splits a large document into\n * many smaller documents.\n */\nexport abstract class BaseDocumentTransformer<\n  RunInput extends DocumentInterface[] = DocumentInterface[],\n  RunOutput extends DocumentInterface[] = DocumentInterface[],\n> extends Runnable<RunInput, RunOutput> {\n  lc_namespace = [\"langchain_core\", \"documents\", \"transformers\"];\n\n  /**\n   * Transform a list of documents.\n   * @param documents A sequence of documents to be transformed.\n   * @returns A list of transformed documents.\n   */\n  abstract transformDocuments(documents: RunInput): Promise<RunOutput>;\n\n  /**\n   * Method to invoke the document transformation. This method calls the\n   * transformDocuments method with the provided input.\n   * @param input The input documents to be transformed.\n   * @param _options Optional configuration object to customize the behavior of callbacks.\n   * @returns A Promise that resolves to the transformed documents.\n   */\n  invoke(input: RunInput, _options?: BaseCallbackConfig): Promise<RunOutput> {\n    return this.transformDocuments(input);\n  }\n}\n\n/**\n * Class for document transformers that return exactly one transformed document\n * for each input document.\n */\nexport abstract class MappingDocumentTransformer extends BaseDocumentTransformer {\n  async transformDocuments(\n    documents: DocumentInterface[]\n  ): Promise<DocumentInterface[]> {\n    const newDocuments = [];\n    for (const document of documents) {\n      const transformedDocument = await this._transformDocument(document);\n      newDocuments.push(transformedDocument);\n    }\n    return newDocuments;\n  }\n\n  abstract _transformDocument(\n    document: DocumentInterface\n  ): Promise<DocumentInterface>;\n}\n"],"mappings":";;;;;;;;;;;;AAcA,IAAsB,0BAAtB,cAGU,SAA8B;CACtC,eAAe;EAAC;EAAkB;EAAa;CAAc;;;;;;;;CAgB7D,OAAO,OAAiB,UAAmD;EACzE,OAAO,KAAK,mBAAmB,KAAK;CACtC;AACF;;;;;AAMA,IAAsB,6BAAtB,cAAyD,wBAAwB;CAC/E,MAAM,mBACJ,WAC8B;EAC9B,MAAM,eAAe,CAAC;EACtB,KAAK,MAAM,YAAY,WAAW;GAChC,MAAM,sBAAsB,MAAM,KAAK,mBAAmB,QAAQ;GAClE,aAAa,KAAK,mBAAmB;EACvC;EACA,OAAO;CACT;AAKF"}

package/dist/embeddings.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"embeddings.cjs","names":["AsyncCaller"],"sources":["../src/embeddings.ts"],"sourcesContent":["import { AsyncCaller, AsyncCallerParams } from \"./utils/async_caller.js\";\n\n/**\n * The parameters required to initialize an instance of the Embeddings\n * class.\n */\nexport type EmbeddingsParams = AsyncCallerParams;\n\nexport interface EmbeddingsInterface<TOutput = number[]> {\n  /**\n   * An abstract method that takes an array of documents as input and\n   * returns a promise that resolves to an array of vectors for each\n   * document.\n   * @param documents An array of documents to be embedded.\n   * @returns A promise that resolves to an array of vectors for each document.\n   */\n  embedDocuments(documents: string[]): Promise<TOutput[]>;\n\n  /**\n   * An abstract method that takes a single document as input and returns a\n   * promise that resolves to a vector for the query document.\n   * @param document A single document to be embedded.\n   * @returns A promise that resolves to a vector for the query document.\n   */\n  embedQuery(document: string): Promise<TOutput>;\n}\n\n/**\n * An abstract class that provides methods for embedding documents and\n * queries using LangChain.\n */\nexport abstract class Embeddings<\n  TOutput = number[],\n> implements EmbeddingsInterface<TOutput> {\n  /**\n   * The async caller should be used by subclasses to make any async calls,\n   * which will thus benefit from the concurrency and retry logic.\n   */\n  caller: AsyncCaller;\n\n  constructor(params: EmbeddingsParams) {\n    this.caller = new AsyncCaller(params ?? {});\n  }\n\n  /**\n   * An abstract method that takes an array of documents as input and\n   * returns a promise that resolves to an array of vectors for each\n   * document.\n   * @param documents An array of documents to be embedded.\n   * @returns A promise that resolves to an array of vectors for each document.\n   */\n  abstract embedDocuments(documents: string[]): Promise<TOutput[]>;\n\n  /**\n   * An abstract method that takes a single document as input and returns a\n   * promise that resolves to a vector for the query document.\n   * @param document A single document to be embedded.\n   * @returns A promise that resolves to a vector for the query document.\n   */\n  abstract embedQuery(document: string): Promise<TOutput>;\n}\n"],"mappings":";;;;;;;;;AA+BA,IAAsB,aAAtB,MAE0C;;;;;CAKxC;CAEA,YAAY,QAA0B;AACpC,OAAK,SAAS,IAAIA,2BAAAA,YAAY,UAAU,EAAE,CAAC"}
+{"version":3,"file":"embeddings.cjs","names":["AsyncCaller"],"sources":["../src/embeddings.ts"],"sourcesContent":["import { AsyncCaller, AsyncCallerParams } from \"./utils/async_caller.js\";\n\n/**\n * The parameters required to initialize an instance of the Embeddings\n * class.\n */\nexport type EmbeddingsParams = AsyncCallerParams;\n\nexport interface EmbeddingsInterface<TOutput = number[]> {\n  /**\n   * An abstract method that takes an array of documents as input and\n   * returns a promise that resolves to an array of vectors for each\n   * document.\n   * @param documents An array of documents to be embedded.\n   * @returns A promise that resolves to an array of vectors for each document.\n   */\n  embedDocuments(documents: string[]): Promise<TOutput[]>;\n\n  /**\n   * An abstract method that takes a single document as input and returns a\n   * promise that resolves to a vector for the query document.\n   * @param document A single document to be embedded.\n   * @returns A promise that resolves to a vector for the query document.\n   */\n  embedQuery(document: string): Promise<TOutput>;\n}\n\n/**\n * An abstract class that provides methods for embedding documents and\n * queries using LangChain.\n */\nexport abstract class Embeddings<\n  TOutput = number[],\n> implements EmbeddingsInterface<TOutput> {\n  /**\n   * The async caller should be used by subclasses to make any async calls,\n   * which will thus benefit from the concurrency and retry logic.\n   */\n  caller: AsyncCaller;\n\n  constructor(params: EmbeddingsParams) {\n    this.caller = new AsyncCaller(params ?? {});\n  }\n\n  /**\n   * An abstract method that takes an array of documents as input and\n   * returns a promise that resolves to an array of vectors for each\n   * document.\n   * @param documents An array of documents to be embedded.\n   * @returns A promise that resolves to an array of vectors for each document.\n   */\n  abstract embedDocuments(documents: string[]): Promise<TOutput[]>;\n\n  /**\n   * An abstract method that takes a single document as input and returns a\n   * promise that resolves to a vector for the query document.\n   * @param document A single document to be embedded.\n   * @returns A promise that resolves to a vector for the query document.\n   */\n  abstract embedQuery(document: string): Promise<TOutput>;\n}\n"],"mappings":";;;;;;;;;AA+BA,IAAsB,aAAtB,MAE0C;;;;;CAKxC;CAEA,YAAY,QAA0B;EACpC,KAAK,SAAS,IAAIA,2BAAAA,YAAY,UAAU,CAAC,CAAC;CAC5C;AAkBF"}

package/dist/embeddings.d.cts

@@ -1,5 +1,4 @@
 import { AsyncCaller, AsyncCallerParams } from "./utils/async_caller.cjs";
-
 //#region src/embeddings.d.ts
 /**
  * The parameters required to initialize an instance of the Embeddings

package/dist/embeddings.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"embeddings.d.cts","names":[],"sources":["../src/embeddings.ts"],"mappings":";;;;;AAMA;;KAAY,gBAAA,GAAmB,iBAAA;AAAA,UAEd,mBAAA;EAF+B;AAEhD;;;;;;EAQE,cAAA,CAAe,SAAA,aAAsB,OAAA,CAAQ,OAAA;EAQR;;;;;;EAArC,UAAA,CAAW,QAAA,WAAmB,OAAA,CAAQ,OAAA;AAAA;;;;;uBAOlB,UAAA,gCAET,mBAAA,CAAoB,OAAA;EAFX;;;;EAOpB,MAAA,EAAQ,WAAA;EAER,WAAA,CAAY,MAAA,EAAQ,gBAAA;EAWkC;;;;;;;EAAA,SAA7C,cAAA,CAAe,SAAA,aAAsB,OAAA,CAAQ,OAAA;EAlB3C;;;;;;EAAA,SA0BF,UAAA,CAAW,QAAA,WAAmB,OAAA,CAAQ,OAAA;AAAA"}
+{"version":3,"file":"embeddings.d.cts","names":[],"sources":["../src/embeddings.ts"],"mappings":";;;;;;KAMY,mBAAmB;UAEd,oBAAoB;;;;;;;;EAQnC,eAAe,sBAAsB,QAAQ;;;;;;;EAQ7C,WAAW,mBAAmB,QAAQ;;;;;;uBAOlB,WACpB,+BACW,oBAAoB;;;;;EAK/B,QAAQ;EAER,YAAY,QAAQ;;;;;;;;WAWX,eAAe,sBAAsB,QAAQ;;;;;;;WAQ7C,WAAW,mBAAmB,QAAQ"}

package/dist/embeddings.d.ts

@@ -1,5 +1,4 @@
 import { AsyncCaller, AsyncCallerParams } from "./utils/async_caller.js";
-
 //#region src/embeddings.d.ts
 /**
  * The parameters required to initialize an instance of the Embeddings

package/dist/embeddings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embeddings.d.ts","names":[],"sources":["../src/embeddings.ts"],"mappings":";;;;;AAMA;;KAAY,gBAAA,GAAmB,iBAAA;AAAA,UAEd,mBAAA;EAF+B;AAEhD;;;;;;EAQE,cAAA,CAAe,SAAA,aAAsB,OAAA,CAAQ,OAAA;EAQR;;;;;;EAArC,UAAA,CAAW,QAAA,WAAmB,OAAA,CAAQ,OAAA;AAAA;;;;;uBAOlB,UAAA,gCAET,mBAAA,CAAoB,OAAA;EAFX;;;;EAOpB,MAAA,EAAQ,WAAA;EAER,WAAA,CAAY,MAAA,EAAQ,gBAAA;EAWkC;;;;;;;EAAA,SAA7C,cAAA,CAAe,SAAA,aAAsB,OAAA,CAAQ,OAAA;EAlB3C;;;;;;EAAA,SA0BF,UAAA,CAAW,QAAA,WAAmB,OAAA,CAAQ,OAAA;AAAA"}
+{"version":3,"file":"embeddings.d.ts","names":[],"sources":["../src/embeddings.ts"],"mappings":";;;;;;KAMY,mBAAmB;UAEd,oBAAoB;;;;;;;;EAQnC,eAAe,sBAAsB,QAAQ;;;;;;;EAQ7C,WAAW,mBAAmB,QAAQ;;;;;;uBAOlB,WACpB,+BACW,oBAAoB;;;;;EAK/B,QAAQ;EAER,YAAY,QAAQ;;;;;;;;WAWX,eAAe,sBAAsB,QAAQ;;;;;;;WAQ7C,WAAW,mBAAmB,QAAQ"}

package/dist/embeddings.js.map

@@ -1 +1 @@
-{"version":3,"file":"embeddings.js","names":[],"sources":["../src/embeddings.ts"],"sourcesContent":["import { AsyncCaller, AsyncCallerParams } from \"./utils/async_caller.js\";\n\n/**\n * The parameters required to initialize an instance of the Embeddings\n * class.\n */\nexport type EmbeddingsParams = AsyncCallerParams;\n\nexport interface EmbeddingsInterface<TOutput = number[]> {\n  /**\n   * An abstract method that takes an array of documents as input and\n   * returns a promise that resolves to an array of vectors for each\n   * document.\n   * @param documents An array of documents to be embedded.\n   * @returns A promise that resolves to an array of vectors for each document.\n   */\n  embedDocuments(documents: string[]): Promise<TOutput[]>;\n\n  /**\n   * An abstract method that takes a single document as input and returns a\n   * promise that resolves to a vector for the query document.\n   * @param document A single document to be embedded.\n   * @returns A promise that resolves to a vector for the query document.\n   */\n  embedQuery(document: string): Promise<TOutput>;\n}\n\n/**\n * An abstract class that provides methods for embedding documents and\n * queries using LangChain.\n */\nexport abstract class Embeddings<\n  TOutput = number[],\n> implements EmbeddingsInterface<TOutput> {\n  /**\n   * The async caller should be used by subclasses to make any async calls,\n   * which will thus benefit from the concurrency and retry logic.\n   */\n  caller: AsyncCaller;\n\n  constructor(params: EmbeddingsParams) {\n    this.caller = new AsyncCaller(params ?? {});\n  }\n\n  /**\n   * An abstract method that takes an array of documents as input and\n   * returns a promise that resolves to an array of vectors for each\n   * document.\n   * @param documents An array of documents to be embedded.\n   * @returns A promise that resolves to an array of vectors for each document.\n   */\n  abstract embedDocuments(documents: string[]): Promise<TOutput[]>;\n\n  /**\n   * An abstract method that takes a single document as input and returns a\n   * promise that resolves to a vector for the query document.\n   * @param document A single document to be embedded.\n   * @returns A promise that resolves to a vector for the query document.\n   */\n  abstract embedQuery(document: string): Promise<TOutput>;\n}\n"],"mappings":";;;;;;;;AA+BA,IAAsB,aAAtB,MAE0C;;;;;CAKxC;CAEA,YAAY,QAA0B;AACpC,OAAK,SAAS,IAAI,YAAY,UAAU,EAAE,CAAC"}
+{"version":3,"file":"embeddings.js","names":[],"sources":["../src/embeddings.ts"],"sourcesContent":["import { AsyncCaller, AsyncCallerParams } from \"./utils/async_caller.js\";\n\n/**\n * The parameters required to initialize an instance of the Embeddings\n * class.\n */\nexport type EmbeddingsParams = AsyncCallerParams;\n\nexport interface EmbeddingsInterface<TOutput = number[]> {\n  /**\n   * An abstract method that takes an array of documents as input and\n   * returns a promise that resolves to an array of vectors for each\n   * document.\n   * @param documents An array of documents to be embedded.\n   * @returns A promise that resolves to an array of vectors for each document.\n   */\n  embedDocuments(documents: string[]): Promise<TOutput[]>;\n\n  /**\n   * An abstract method that takes a single document as input and returns a\n   * promise that resolves to a vector for the query document.\n   * @param document A single document to be embedded.\n   * @returns A promise that resolves to a vector for the query document.\n   */\n  embedQuery(document: string): Promise<TOutput>;\n}\n\n/**\n * An abstract class that provides methods for embedding documents and\n * queries using LangChain.\n */\nexport abstract class Embeddings<\n  TOutput = number[],\n> implements EmbeddingsInterface<TOutput> {\n  /**\n   * The async caller should be used by subclasses to make any async calls,\n   * which will thus benefit from the concurrency and retry logic.\n   */\n  caller: AsyncCaller;\n\n  constructor(params: EmbeddingsParams) {\n    this.caller = new AsyncCaller(params ?? {});\n  }\n\n  /**\n   * An abstract method that takes an array of documents as input and\n   * returns a promise that resolves to an array of vectors for each\n   * document.\n   * @param documents An array of documents to be embedded.\n   * @returns A promise that resolves to an array of vectors for each document.\n   */\n  abstract embedDocuments(documents: string[]): Promise<TOutput[]>;\n\n  /**\n   * An abstract method that takes a single document as input and returns a\n   * promise that resolves to a vector for the query document.\n   * @param document A single document to be embedded.\n   * @returns A promise that resolves to a vector for the query document.\n   */\n  abstract embedQuery(document: string): Promise<TOutput>;\n}\n"],"mappings":";;;;;;;;AA+BA,IAAsB,aAAtB,MAE0C;;;;;CAKxC;CAEA,YAAY,QAA0B;EACpC,KAAK,SAAS,IAAI,YAAY,UAAU,CAAC,CAAC;CAC5C;AAkBF"}

package/dist/errors/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["baseNs"],"sources":["../../src/errors/index.ts"],"sourcesContent":["/* oxlint-disable @typescript-eslint/no-explicit-any */\n\nimport type { AIMessageChunk } from \"../messages/ai.js\";\nimport { ns as baseNs } from \"../utils/namespace.js\";\n\nexport type LangChainErrorCodes =\n  | \"CONTEXT_OVERFLOW\"\n  | \"INVALID_PROMPT_INPUT\"\n  | \"INVALID_TOOL_RESULTS\"\n  | \"MESSAGE_COERCION_FAILURE\"\n  | \"MODEL_AUTHENTICATION\"\n  | \"MODEL_NOT_FOUND\"\n  | \"MODEL_RATE_LIMIT\"\n  | \"OUTPUT_PARSING_FAILURE\"\n  | \"MODEL_ABORTED\";\n\n/** @deprecated Subclass LangChainError instead */\nexport function addLangChainErrorFields(\n  error: any,\n  lc_error_code: LangChainErrorCodes\n) {\n  (error as any).lc_error_code = lc_error_code;\n  error.message = `${error.message}\\n\\nTroubleshooting URL: https://docs.langchain.com/oss/javascript/langchain/errors/${lc_error_code}/\\n`;\n  return error;\n}\n\n/** The error namespace for all LangChain errors */\nexport const ns = baseNs.sub(\"error\");\n\n/**\n * Base error class for all LangChain errors.\n *\n * All LangChain error classes should extend this class (directly or\n * indirectly). Use `LangChainError.isInstance(obj)` to check if an\n * object is any LangChain error.\n *\n * @example\n * ```typescript\n * try {\n *   await model.invoke(\"hello\");\n * } catch (error) {\n *   if (LangChainError.isInstance(error)) {\n *     console.log(\"Got a LangChain error:\", error.message);\n *   }\n * }\n * ```\n */\nexport class LangChainError extends ns.brand(Error) {\n  readonly name: string = \"LangChainError\";\n\n  constructor(message?: string) {\n    super(message);\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, this.constructor);\n    }\n  }\n}\n\n/**\n * Error class representing an aborted model operation in LangChain.\n *\n * This error is thrown when a model operation (such as invocation, streaming, or batching)\n * is cancelled before it completes, commonly due to a user-initiated abort signal\n * (e.g., via an AbortController) or an upstream cancellation event.\n *\n * The ModelAbortError provides access to any partial output the model may have produced\n * before the operation was interrupted, which can be useful for resuming work, debugging,\n * or presenting incomplete results to users.\n *\n * @remarks\n * - The `partialOutput` field includes message content that was generated prior to the abort,\n *   such as a partial AIMessageChunk.\n * - This error extends the {@link LangChainError} base class with the marker `\"model-abort\"`.\n *\n * @example\n * ```typescript\n * try {\n *   await model.invoke(input, { signal: abortController.signal });\n * } catch (err) {\n *   if (ModelAbortError.isInstance(err)) {\n *     // Handle user cancellation, check err.partialOutput if needed\n *   } else {\n *     throw err;\n *   }\n * }\n * ```\n */\nexport class ModelAbortError extends ns.brand(LangChainError, \"model-abort\") {\n  readonly name = \"ModelAbortError\";\n\n  /**\n   * The partial message output that was produced before the operation was aborted.\n   * This is typically an AIMessageChunk, or could be undefined if no output was available.\n   */\n  readonly partialOutput?: AIMessageChunk;\n\n  /**\n   * Constructs a new ModelAbortError instance.\n   *\n   * @param message - A human-readable message describing the abort event.\n   * @param partialOutput - Any partial model output generated before the abort (optional).\n   */\n  constructor(message: string, partialOutput?: AIMessageChunk) {\n    super(message);\n    this.partialOutput = partialOutput;\n  }\n}\n\n/**\n * Error class representing a context window overflow in a language model operation.\n *\n * This error is thrown when the combined input to a language model (such as prompt tokens,\n * historical messages, and/or instructions) exceeds the maximum context window or token limit\n * that the model can process in a single request. Most models have defined upper limits for the number of\n * tokens or characters allowed in a context, and exceeding this limit will prevent\n * the operation from proceeding.\n *\n * The {@link ContextOverflowError} extends the {@link LangChainError} base class with\n * the marker `\"context-overflow\"`.\n *\n * @remarks\n * - Use this error to programmatically identify cases where a user request, prompt, or input\n *   sequence is too long to be handled by the target model.\n * - Model providers and framework integrations should throw this error if they detect\n *   a request cannot be processed due to its size.\n *\n * @example\n * ```typescript\n * try {\n *   await model.invoke(veryLongInput);\n * } catch (err) {\n *   if (ContextOverflowError.isInstance(err)) {\n *     // Handle overflow, e.g., prompt user to shorten input or truncate text\n *     console.warn(\"Model context overflow:\", err.message);\n *   } else {\n *     throw err;\n *   }\n * }\n * ```\n */\nexport class ContextOverflowError extends ns.brand(\n  LangChainError,\n  \"context-overflow\"\n) {\n  readonly name = \"ContextOverflowError\";\n\n  /**\n   * The underlying error that caused this {@link ContextOverflowError}, if any.\n   *\n   * This property is optionally set when wrapping a lower-level error using {@link ContextOverflowError.fromError}.\n   * It allows error handlers to access or inspect the original error that led to the context overflow.\n   */\n  cause?: Error;\n\n  constructor(message?: string) {\n    super(message ?? \"Input exceeded the model's context window.\");\n  }\n\n  /**\n   * Creates a new {@link ContextOverflowError} instance from an existing error.\n   *\n   * This static utility copies the message from the provided error and\n   * attaches the original error as the {@link ContextOverflowError.cause} property,\n   * enabling error handlers to inspect or propagate the original failure.\n   *\n   * @param obj - The original error object causing the context overflow.\n   * @returns A new {@link ContextOverflowError} instance with the original error set as its cause.\n   *\n   * @example\n   * ```typescript\n   * try {\n   *   await model.invoke(input);\n   * } catch (err) {\n   *   throw ContextOverflowError.fromError(err);\n   * }\n   * ```\n   */\n  static fromError(obj: Error): ContextOverflowError {\n    const error = new ContextOverflowError(obj.message);\n    error.cause = obj;\n    return error;\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAiBA,SAAgB,wBACd,OACA,eACA;AACC,OAAc,gBAAgB;AAC/B,OAAM,UAAU,GAAG,MAAM,QAAQ,sFAAsF,cAAc;AACrI,QAAO;;;AAIT,MAAa,KAAKA,kBAAAA,GAAO,IAAI,QAAQ;;;;;;;;;;;;;;;;;;;AAoBrC,IAAa,iBAAb,cAAoC,GAAG,MAAM,MAAM,CAAC;CAClD,OAAwB;CAExB,YAAY,SAAkB;AAC5B,QAAM,QAAQ;AACd,MAAI,MAAM,kBACR,OAAM,kBAAkB,MAAM,KAAK,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCrD,IAAa,kBAAb,cAAqC,GAAG,MAAM,gBAAgB,cAAc,CAAC;CAC3E,OAAgB;;;;;CAMhB;;;;;;;CAQA,YAAY,SAAiB,eAAgC;AAC3D,QAAM,QAAQ;AACd,OAAK,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCzB,IAAa,uBAAb,MAAa,6BAA6B,GAAG,MAC3C,gBACA,mBACD,CAAC;CACA,OAAgB;;;;;;;CAQhB;CAEA,YAAY,SAAkB;AAC5B,QAAM,WAAW,6CAA6C;;;;;;;;;;;;;;;;;;;;;CAsBhE,OAAO,UAAU,KAAkC;EACjD,MAAM,QAAQ,IAAI,qBAAqB,IAAI,QAAQ;AACnD,QAAM,QAAQ;AACd,SAAO"}
+{"version":3,"file":"index.cjs","names":["baseNs"],"sources":["../../src/errors/index.ts"],"sourcesContent":["/* oxlint-disable @typescript-eslint/no-explicit-any */\n\nimport type { AIMessageChunk } from \"../messages/ai.js\";\nimport { ns as baseNs } from \"../utils/namespace.js\";\n\nexport type LangChainErrorCodes =\n  | \"CONTEXT_OVERFLOW\"\n  | \"INVALID_PROMPT_INPUT\"\n  | \"INVALID_TOOL_RESULTS\"\n  | \"MESSAGE_COERCION_FAILURE\"\n  | \"MODEL_AUTHENTICATION\"\n  | \"MODEL_NOT_FOUND\"\n  | \"MODEL_RATE_LIMIT\"\n  | \"OUTPUT_PARSING_FAILURE\"\n  | \"MODEL_ABORTED\";\n\n/** @deprecated Subclass LangChainError instead */\nexport function addLangChainErrorFields(\n  error: any,\n  lc_error_code: LangChainErrorCodes\n) {\n  (error as any).lc_error_code = lc_error_code;\n  error.message = `${error.message}\\n\\nTroubleshooting URL: https://docs.langchain.com/oss/javascript/langchain/errors/${lc_error_code}/\\n`;\n  return error;\n}\n\n/** The error namespace for all LangChain errors */\nexport const ns = baseNs.sub(\"error\");\n\n/**\n * Base error class for all LangChain errors.\n *\n * All LangChain error classes should extend this class (directly or\n * indirectly). Use `LangChainError.isInstance(obj)` to check if an\n * object is any LangChain error.\n *\n * @example\n * ```typescript\n * try {\n *   await model.invoke(\"hello\");\n * } catch (error) {\n *   if (LangChainError.isInstance(error)) {\n *     console.log(\"Got a LangChain error:\", error.message);\n *   }\n * }\n * ```\n */\nexport class LangChainError extends ns.brand(Error) {\n  readonly name: string = \"LangChainError\";\n\n  constructor(message?: string) {\n    super(message);\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, this.constructor);\n    }\n  }\n}\n\n/**\n * Error class representing an aborted model operation in LangChain.\n *\n * This error is thrown when a model operation (such as invocation, streaming, or batching)\n * is cancelled before it completes, commonly due to a user-initiated abort signal\n * (e.g., via an AbortController) or an upstream cancellation event.\n *\n * The ModelAbortError provides access to any partial output the model may have produced\n * before the operation was interrupted, which can be useful for resuming work, debugging,\n * or presenting incomplete results to users.\n *\n * @remarks\n * - The `partialOutput` field includes message content that was generated prior to the abort,\n *   such as a partial AIMessageChunk.\n * - This error extends the {@link LangChainError} base class with the marker `\"model-abort\"`.\n *\n * @example\n * ```typescript\n * try {\n *   await model.invoke(input, { signal: abortController.signal });\n * } catch (err) {\n *   if (ModelAbortError.isInstance(err)) {\n *     // Handle user cancellation, check err.partialOutput if needed\n *   } else {\n *     throw err;\n *   }\n * }\n * ```\n */\nexport class ModelAbortError extends ns.brand(LangChainError, \"model-abort\") {\n  readonly name = \"ModelAbortError\";\n\n  /**\n   * The partial message output that was produced before the operation was aborted.\n   * This is typically an AIMessageChunk, or could be undefined if no output was available.\n   */\n  readonly partialOutput?: AIMessageChunk;\n\n  /**\n   * Constructs a new ModelAbortError instance.\n   *\n   * @param message - A human-readable message describing the abort event.\n   * @param partialOutput - Any partial model output generated before the abort (optional).\n   */\n  constructor(message: string, partialOutput?: AIMessageChunk) {\n    super(message);\n    this.partialOutput = partialOutput;\n  }\n}\n\n/**\n * Error class representing a context window overflow in a language model operation.\n *\n * This error is thrown when the combined input to a language model (such as prompt tokens,\n * historical messages, and/or instructions) exceeds the maximum context window or token limit\n * that the model can process in a single request. Most models have defined upper limits for the number of\n * tokens or characters allowed in a context, and exceeding this limit will prevent\n * the operation from proceeding.\n *\n * The {@link ContextOverflowError} extends the {@link LangChainError} base class with\n * the marker `\"context-overflow\"`.\n *\n * @remarks\n * - Use this error to programmatically identify cases where a user request, prompt, or input\n *   sequence is too long to be handled by the target model.\n * - Model providers and framework integrations should throw this error if they detect\n *   a request cannot be processed due to its size.\n *\n * @example\n * ```typescript\n * try {\n *   await model.invoke(veryLongInput);\n * } catch (err) {\n *   if (ContextOverflowError.isInstance(err)) {\n *     // Handle overflow, e.g., prompt user to shorten input or truncate text\n *     console.warn(\"Model context overflow:\", err.message);\n *   } else {\n *     throw err;\n *   }\n * }\n * ```\n */\nexport class ContextOverflowError extends ns.brand(\n  LangChainError,\n  \"context-overflow\"\n) {\n  readonly name = \"ContextOverflowError\";\n\n  /**\n   * The underlying error that caused this {@link ContextOverflowError}, if any.\n   *\n   * This property is optionally set when wrapping a lower-level error using {@link ContextOverflowError.fromError}.\n   * It allows error handlers to access or inspect the original error that led to the context overflow.\n   */\n  cause?: Error;\n\n  constructor(message?: string) {\n    super(message ?? \"Input exceeded the model's context window.\");\n  }\n\n  /**\n   * Creates a new {@link ContextOverflowError} instance from an existing error.\n   *\n   * This static utility copies the message from the provided error and\n   * attaches the original error as the {@link ContextOverflowError.cause} property,\n   * enabling error handlers to inspect or propagate the original failure.\n   *\n   * @param obj - The original error object causing the context overflow.\n   * @returns A new {@link ContextOverflowError} instance with the original error set as its cause.\n   *\n   * @example\n   * ```typescript\n   * try {\n   *   await model.invoke(input);\n   * } catch (err) {\n   *   throw ContextOverflowError.fromError(err);\n   * }\n   * ```\n   */\n  static fromError(obj: Error): ContextOverflowError {\n    const error = new ContextOverflowError(obj.message);\n    error.cause = obj;\n    return error;\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAiBA,SAAgB,wBACd,OACA,eACA;CACA,MAAe,gBAAgB;CAC/B,MAAM,UAAU,GAAG,MAAM,QAAQ,sFAAsF,cAAc;CACrI,OAAO;AACT;;AAGA,MAAa,KAAKA,kBAAAA,GAAO,IAAI,OAAO;;;;;;;;;;;;;;;;;;;AAoBpC,IAAa,iBAAb,cAAoC,GAAG,MAAM,KAAK,CAAC,CAAC;CAClD,OAAwB;CAExB,YAAY,SAAkB;EAC5B,MAAM,OAAO;EACb,IAAI,MAAM,mBACR,MAAM,kBAAkB,MAAM,KAAK,WAAW;CAElD;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,IAAa,kBAAb,cAAqC,GAAG,MAAM,gBAAgB,aAAa,CAAC,CAAC;CAC3E,OAAgB;;;;;CAMhB;;;;;;;CAQA,YAAY,SAAiB,eAAgC;EAC3D,MAAM,OAAO;EACb,KAAK,gBAAgB;CACvB;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,IAAa,uBAAb,MAAa,6BAA6B,GAAG,MAC3C,gBACA,kBACF,CAAC,CAAC;CACA,OAAgB;;;;;;;CAQhB;CAEA,YAAY,SAAkB;EAC5B,MAAM,WAAW,4CAA4C;CAC/D;;;;;;;;;;;;;;;;;;;;CAqBA,OAAO,UAAU,KAAkC;EACjD,MAAM,QAAQ,IAAI,qBAAqB,IAAI,OAAO;EAClD,MAAM,QAAQ;EACd,OAAO;CACT;AACF"}

package/dist/errors/index.d.cts

@@ -1,6 +1,5 @@
 import { AIMessageChunk } from "../messages/ai.cjs";
 import { Namespace } from "../utils/namespace.cjs";
-
 //#region src/errors/index.d.ts
 type LangChainErrorCodes = "CONTEXT_OVERFLOW" | "INVALID_PROMPT_INPUT" | "INVALID_TOOL_RESULTS" | "MESSAGE_COERCION_FAILURE" | "MODEL_AUTHENTICATION" | "MODEL_NOT_FOUND" | "MODEL_RATE_LIMIT" | "OUTPUT_PARSING_FAILURE" | "MODEL_ABORTED";
 /** @deprecated Subclass LangChainError instead */

package/dist/errors/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/errors/index.ts"],"mappings":";;;;KAKY,mBAAA;;iBAYI,uBAAA,CACd,KAAA,OACA,aAAA,EAAe,mBAAA;AAdjB;AAAA,cAsBa,EAAA,EAAwB,SAAA;AAAA,cAAC,mBAAA;;;AAVtC;;;;;;;;;AAUA;;;;;AAAsC;;;;AAVtC,cA8Ba,cAAA,SAAuB,mBAAA;EAAA,SACzB,IAAA;EAET,WAAA,CAAY,OAAA;AAAA;AAAA,cAMb,oBAAA;;;;;;;;;;;;;AATD;;;;;;;;;;AASC;;;;;;;;;cA+BY,eAAA,SAAwB,oBAAA;EAAA,SAC1B,IAAA;;;;;WAMA,aAAA,GAAgB,cAAA;;;;;;AAP3B;EAeE,WAAA,CAAY,OAAA,UAAiB,aAAA,GAAgB,cAAA;AAAA;AAAA,cAI9C,yBAAA;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;;cAkCY,oBAAA,SAA6B,yBAAA;EAAA,SAI/B,IAAA;EAJuB;;;;;;EAYhC,KAAA,GAAQ,KAAA;EAER,WAAA,CAAY,OAAA;EAd4B;;;;;;;;;;;;;;;;;;;EAAA,OAqCjC,SAAA,CAAU,GAAA,EAAK,KAAA,GAAQ,oBAAA;AAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/errors/index.ts"],"mappings":";;;KAKY;;iBAYI,wBACd,YACA,eAAe;;cAQJ,IAAA;;;;;;;;;;;;;;;;;;;;;;cAoBA,uBAAuB;WACzB;EAET,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAqCD,wBAAwB;WAC1B;;;;;WAMA,gBAAgB;;;;;;;EAQzB,YAAY,iBAAiB,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAsClC,6BAA6B;WAI/B;;;;;;;EAQT,QAAQ;EAER,YAAY;;;;;;;;;;;;;;;;;;;;SAuBL,UAAU,KAAK,QAAQ"}

package/dist/errors/index.d.ts

@@ -1,6 +1,5 @@
 import { AIMessageChunk } from "../messages/ai.js";
 import { Namespace } from "../utils/namespace.js";
-
 //#region src/errors/index.d.ts
 type LangChainErrorCodes = "CONTEXT_OVERFLOW" | "INVALID_PROMPT_INPUT" | "INVALID_TOOL_RESULTS" | "MESSAGE_COERCION_FAILURE" | "MODEL_AUTHENTICATION" | "MODEL_NOT_FOUND" | "MODEL_RATE_LIMIT" | "OUTPUT_PARSING_FAILURE" | "MODEL_ABORTED";
 /** @deprecated Subclass LangChainError instead */

package/dist/errors/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/errors/index.ts"],"mappings":";;;;KAKY,mBAAA;;iBAYI,uBAAA,CACd,KAAA,OACA,aAAA,EAAe,mBAAA;AAdjB;AAAA,cAsBa,EAAA,EAAwB,SAAA;AAAA,cAAC,mBAAA;;;AAVtC;;;;;;;;;AAUA;;;;;AAAsC;;;;AAVtC,cA8Ba,cAAA,SAAuB,mBAAA;EAAA,SACzB,IAAA;EAET,WAAA,CAAY,OAAA;AAAA;AAAA,cAMb,oBAAA;;;;;;;;;;;;;AATD;;;;;;;;;;AASC;;;;;;;;;cA+BY,eAAA,SAAwB,oBAAA;EAAA,SAC1B,IAAA;;;;;WAMA,aAAA,GAAgB,cAAA;;;;;;AAP3B;EAeE,WAAA,CAAY,OAAA,UAAiB,aAAA,GAAgB,cAAA;AAAA;AAAA,cAI9C,yBAAA;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;;cAkCY,oBAAA,SAA6B,yBAAA;EAAA,SAI/B,IAAA;EAJuB;;;;;;EAYhC,KAAA,GAAQ,KAAA;EAER,WAAA,CAAY,OAAA;EAd4B;;;;;;;;;;;;;;;;;;;EAAA,OAqCjC,SAAA,CAAU,GAAA,EAAK,KAAA,GAAQ,oBAAA;AAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/errors/index.ts"],"mappings":";;;KAKY;;iBAYI,wBACd,YACA,eAAe;;cAQJ,IAAA;;;;;;;;;;;;;;;;;;;;;;cAoBA,uBAAuB;WACzB;EAET,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAqCD,wBAAwB;WAC1B;;;;;WAMA,gBAAgB;;;;;;;EAQzB,YAAY,iBAAiB,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAsClC,6BAA6B;WAI/B;;;;;;;EAQT,QAAQ;EAER,YAAY;;;;;;;;;;;;;;;;;;;;SAuBL,UAAU,KAAK,QAAQ"}

package/dist/errors/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["baseNs"],"sources":["../../src/errors/index.ts"],"sourcesContent":["/* oxlint-disable @typescript-eslint/no-explicit-any */\n\nimport type { AIMessageChunk } from \"../messages/ai.js\";\nimport { ns as baseNs } from \"../utils/namespace.js\";\n\nexport type LangChainErrorCodes =\n  | \"CONTEXT_OVERFLOW\"\n  | \"INVALID_PROMPT_INPUT\"\n  | \"INVALID_TOOL_RESULTS\"\n  | \"MESSAGE_COERCION_FAILURE\"\n  | \"MODEL_AUTHENTICATION\"\n  | \"MODEL_NOT_FOUND\"\n  | \"MODEL_RATE_LIMIT\"\n  | \"OUTPUT_PARSING_FAILURE\"\n  | \"MODEL_ABORTED\";\n\n/** @deprecated Subclass LangChainError instead */\nexport function addLangChainErrorFields(\n  error: any,\n  lc_error_code: LangChainErrorCodes\n) {\n  (error as any).lc_error_code = lc_error_code;\n  error.message = `${error.message}\\n\\nTroubleshooting URL: https://docs.langchain.com/oss/javascript/langchain/errors/${lc_error_code}/\\n`;\n  return error;\n}\n\n/** The error namespace for all LangChain errors */\nexport const ns = baseNs.sub(\"error\");\n\n/**\n * Base error class for all LangChain errors.\n *\n * All LangChain error classes should extend this class (directly or\n * indirectly). Use `LangChainError.isInstance(obj)` to check if an\n * object is any LangChain error.\n *\n * @example\n * ```typescript\n * try {\n *   await model.invoke(\"hello\");\n * } catch (error) {\n *   if (LangChainError.isInstance(error)) {\n *     console.log(\"Got a LangChain error:\", error.message);\n *   }\n * }\n * ```\n */\nexport class LangChainError extends ns.brand(Error) {\n  readonly name: string = \"LangChainError\";\n\n  constructor(message?: string) {\n    super(message);\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, this.constructor);\n    }\n  }\n}\n\n/**\n * Error class representing an aborted model operation in LangChain.\n *\n * This error is thrown when a model operation (such as invocation, streaming, or batching)\n * is cancelled before it completes, commonly due to a user-initiated abort signal\n * (e.g., via an AbortController) or an upstream cancellation event.\n *\n * The ModelAbortError provides access to any partial output the model may have produced\n * before the operation was interrupted, which can be useful for resuming work, debugging,\n * or presenting incomplete results to users.\n *\n * @remarks\n * - The `partialOutput` field includes message content that was generated prior to the abort,\n *   such as a partial AIMessageChunk.\n * - This error extends the {@link LangChainError} base class with the marker `\"model-abort\"`.\n *\n * @example\n * ```typescript\n * try {\n *   await model.invoke(input, { signal: abortController.signal });\n * } catch (err) {\n *   if (ModelAbortError.isInstance(err)) {\n *     // Handle user cancellation, check err.partialOutput if needed\n *   } else {\n *     throw err;\n *   }\n * }\n * ```\n */\nexport class ModelAbortError extends ns.brand(LangChainError, \"model-abort\") {\n  readonly name = \"ModelAbortError\";\n\n  /**\n   * The partial message output that was produced before the operation was aborted.\n   * This is typically an AIMessageChunk, or could be undefined if no output was available.\n   */\n  readonly partialOutput?: AIMessageChunk;\n\n  /**\n   * Constructs a new ModelAbortError instance.\n   *\n   * @param message - A human-readable message describing the abort event.\n   * @param partialOutput - Any partial model output generated before the abort (optional).\n   */\n  constructor(message: string, partialOutput?: AIMessageChunk) {\n    super(message);\n    this.partialOutput = partialOutput;\n  }\n}\n\n/**\n * Error class representing a context window overflow in a language model operation.\n *\n * This error is thrown when the combined input to a language model (such as prompt tokens,\n * historical messages, and/or instructions) exceeds the maximum context window or token limit\n * that the model can process in a single request. Most models have defined upper limits for the number of\n * tokens or characters allowed in a context, and exceeding this limit will prevent\n * the operation from proceeding.\n *\n * The {@link ContextOverflowError} extends the {@link LangChainError} base class with\n * the marker `\"context-overflow\"`.\n *\n * @remarks\n * - Use this error to programmatically identify cases where a user request, prompt, or input\n *   sequence is too long to be handled by the target model.\n * - Model providers and framework integrations should throw this error if they detect\n *   a request cannot be processed due to its size.\n *\n * @example\n * ```typescript\n * try {\n *   await model.invoke(veryLongInput);\n * } catch (err) {\n *   if (ContextOverflowError.isInstance(err)) {\n *     // Handle overflow, e.g., prompt user to shorten input or truncate text\n *     console.warn(\"Model context overflow:\", err.message);\n *   } else {\n *     throw err;\n *   }\n * }\n * ```\n */\nexport class ContextOverflowError extends ns.brand(\n  LangChainError,\n  \"context-overflow\"\n) {\n  readonly name = \"ContextOverflowError\";\n\n  /**\n   * The underlying error that caused this {@link ContextOverflowError}, if any.\n   *\n   * This property is optionally set when wrapping a lower-level error using {@link ContextOverflowError.fromError}.\n   * It allows error handlers to access or inspect the original error that led to the context overflow.\n   */\n  cause?: Error;\n\n  constructor(message?: string) {\n    super(message ?? \"Input exceeded the model's context window.\");\n  }\n\n  /**\n   * Creates a new {@link ContextOverflowError} instance from an existing error.\n   *\n   * This static utility copies the message from the provided error and\n   * attaches the original error as the {@link ContextOverflowError.cause} property,\n   * enabling error handlers to inspect or propagate the original failure.\n   *\n   * @param obj - The original error object causing the context overflow.\n   * @returns A new {@link ContextOverflowError} instance with the original error set as its cause.\n   *\n   * @example\n   * ```typescript\n   * try {\n   *   await model.invoke(input);\n   * } catch (err) {\n   *   throw ContextOverflowError.fromError(err);\n   * }\n   * ```\n   */\n  static fromError(obj: Error): ContextOverflowError {\n    const error = new ContextOverflowError(obj.message);\n    error.cause = obj;\n    return error;\n  }\n}\n"],"mappings":";;;;;;;;;;;AAiBA,SAAgB,wBACd,OACA,eACA;AACC,OAAc,gBAAgB;AAC/B,OAAM,UAAU,GAAG,MAAM,QAAQ,sFAAsF,cAAc;AACrI,QAAO;;;AAIT,MAAa,KAAKA,KAAO,IAAI,QAAQ;;;;;;;;;;;;;;;;;;;AAoBrC,IAAa,iBAAb,cAAoC,GAAG,MAAM,MAAM,CAAC;CAClD,OAAwB;CAExB,YAAY,SAAkB;AAC5B,QAAM,QAAQ;AACd,MAAI,MAAM,kBACR,OAAM,kBAAkB,MAAM,KAAK,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCrD,IAAa,kBAAb,cAAqC,GAAG,MAAM,gBAAgB,cAAc,CAAC;CAC3E,OAAgB;;;;;CAMhB;;;;;;;CAQA,YAAY,SAAiB,eAAgC;AAC3D,QAAM,QAAQ;AACd,OAAK,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCzB,IAAa,uBAAb,MAAa,6BAA6B,GAAG,MAC3C,gBACA,mBACD,CAAC;CACA,OAAgB;;;;;;;CAQhB;CAEA,YAAY,SAAkB;AAC5B,QAAM,WAAW,6CAA6C;;;;;;;;;;;;;;;;;;;;;CAsBhE,OAAO,UAAU,KAAkC;EACjD,MAAM,QAAQ,IAAI,qBAAqB,IAAI,QAAQ;AACnD,QAAM,QAAQ;AACd,SAAO"}
+{"version":3,"file":"index.js","names":["baseNs"],"sources":["../../src/errors/index.ts"],"sourcesContent":["/* oxlint-disable @typescript-eslint/no-explicit-any */\n\nimport type { AIMessageChunk } from \"../messages/ai.js\";\nimport { ns as baseNs } from \"../utils/namespace.js\";\n\nexport type LangChainErrorCodes =\n  | \"CONTEXT_OVERFLOW\"\n  | \"INVALID_PROMPT_INPUT\"\n  | \"INVALID_TOOL_RESULTS\"\n  | \"MESSAGE_COERCION_FAILURE\"\n  | \"MODEL_AUTHENTICATION\"\n  | \"MODEL_NOT_FOUND\"\n  | \"MODEL_RATE_LIMIT\"\n  | \"OUTPUT_PARSING_FAILURE\"\n  | \"MODEL_ABORTED\";\n\n/** @deprecated Subclass LangChainError instead */\nexport function addLangChainErrorFields(\n  error: any,\n  lc_error_code: LangChainErrorCodes\n) {\n  (error as any).lc_error_code = lc_error_code;\n  error.message = `${error.message}\\n\\nTroubleshooting URL: https://docs.langchain.com/oss/javascript/langchain/errors/${lc_error_code}/\\n`;\n  return error;\n}\n\n/** The error namespace for all LangChain errors */\nexport const ns = baseNs.sub(\"error\");\n\n/**\n * Base error class for all LangChain errors.\n *\n * All LangChain error classes should extend this class (directly or\n * indirectly). Use `LangChainError.isInstance(obj)` to check if an\n * object is any LangChain error.\n *\n * @example\n * ```typescript\n * try {\n *   await model.invoke(\"hello\");\n * } catch (error) {\n *   if (LangChainError.isInstance(error)) {\n *     console.log(\"Got a LangChain error:\", error.message);\n *   }\n * }\n * ```\n */\nexport class LangChainError extends ns.brand(Error) {\n  readonly name: string = \"LangChainError\";\n\n  constructor(message?: string) {\n    super(message);\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, this.constructor);\n    }\n  }\n}\n\n/**\n * Error class representing an aborted model operation in LangChain.\n *\n * This error is thrown when a model operation (such as invocation, streaming, or batching)\n * is cancelled before it completes, commonly due to a user-initiated abort signal\n * (e.g., via an AbortController) or an upstream cancellation event.\n *\n * The ModelAbortError provides access to any partial output the model may have produced\n * before the operation was interrupted, which can be useful for resuming work, debugging,\n * or presenting incomplete results to users.\n *\n * @remarks\n * - The `partialOutput` field includes message content that was generated prior to the abort,\n *   such as a partial AIMessageChunk.\n * - This error extends the {@link LangChainError} base class with the marker `\"model-abort\"`.\n *\n * @example\n * ```typescript\n * try {\n *   await model.invoke(input, { signal: abortController.signal });\n * } catch (err) {\n *   if (ModelAbortError.isInstance(err)) {\n *     // Handle user cancellation, check err.partialOutput if needed\n *   } else {\n *     throw err;\n *   }\n * }\n * ```\n */\nexport class ModelAbortError extends ns.brand(LangChainError, \"model-abort\") {\n  readonly name = \"ModelAbortError\";\n\n  /**\n   * The partial message output that was produced before the operation was aborted.\n   * This is typically an AIMessageChunk, or could be undefined if no output was available.\n   */\n  readonly partialOutput?: AIMessageChunk;\n\n  /**\n   * Constructs a new ModelAbortError instance.\n   *\n   * @param message - A human-readable message describing the abort event.\n   * @param partialOutput - Any partial model output generated before the abort (optional).\n   */\n  constructor(message: string, partialOutput?: AIMessageChunk) {\n    super(message);\n    this.partialOutput = partialOutput;\n  }\n}\n\n/**\n * Error class representing a context window overflow in a language model operation.\n *\n * This error is thrown when the combined input to a language model (such as prompt tokens,\n * historical messages, and/or instructions) exceeds the maximum context window or token limit\n * that the model can process in a single request. Most models have defined upper limits for the number of\n * tokens or characters allowed in a context, and exceeding this limit will prevent\n * the operation from proceeding.\n *\n * The {@link ContextOverflowError} extends the {@link LangChainError} base class with\n * the marker `\"context-overflow\"`.\n *\n * @remarks\n * - Use this error to programmatically identify cases where a user request, prompt, or input\n *   sequence is too long to be handled by the target model.\n * - Model providers and framework integrations should throw this error if they detect\n *   a request cannot be processed due to its size.\n *\n * @example\n * ```typescript\n * try {\n *   await model.invoke(veryLongInput);\n * } catch (err) {\n *   if (ContextOverflowError.isInstance(err)) {\n *     // Handle overflow, e.g., prompt user to shorten input or truncate text\n *     console.warn(\"Model context overflow:\", err.message);\n *   } else {\n *     throw err;\n *   }\n * }\n * ```\n */\nexport class ContextOverflowError extends ns.brand(\n  LangChainError,\n  \"context-overflow\"\n) {\n  readonly name = \"ContextOverflowError\";\n\n  /**\n   * The underlying error that caused this {@link ContextOverflowError}, if any.\n   *\n   * This property is optionally set when wrapping a lower-level error using {@link ContextOverflowError.fromError}.\n   * It allows error handlers to access or inspect the original error that led to the context overflow.\n   */\n  cause?: Error;\n\n  constructor(message?: string) {\n    super(message ?? \"Input exceeded the model's context window.\");\n  }\n\n  /**\n   * Creates a new {@link ContextOverflowError} instance from an existing error.\n   *\n   * This static utility copies the message from the provided error and\n   * attaches the original error as the {@link ContextOverflowError.cause} property,\n   * enabling error handlers to inspect or propagate the original failure.\n   *\n   * @param obj - The original error object causing the context overflow.\n   * @returns A new {@link ContextOverflowError} instance with the original error set as its cause.\n   *\n   * @example\n   * ```typescript\n   * try {\n   *   await model.invoke(input);\n   * } catch (err) {\n   *   throw ContextOverflowError.fromError(err);\n   * }\n   * ```\n   */\n  static fromError(obj: Error): ContextOverflowError {\n    const error = new ContextOverflowError(obj.message);\n    error.cause = obj;\n    return error;\n  }\n}\n"],"mappings":";;;;;;;;;;;AAiBA,SAAgB,wBACd,OACA,eACA;CACA,MAAe,gBAAgB;CAC/B,MAAM,UAAU,GAAG,MAAM,QAAQ,sFAAsF,cAAc;CACrI,OAAO;AACT;;AAGA,MAAa,KAAKA,KAAO,IAAI,OAAO;;;;;;;;;;;;;;;;;;;AAoBpC,IAAa,iBAAb,cAAoC,GAAG,MAAM,KAAK,CAAC,CAAC;CAClD,OAAwB;CAExB,YAAY,SAAkB;EAC5B,MAAM,OAAO;EACb,IAAI,MAAM,mBACR,MAAM,kBAAkB,MAAM,KAAK,WAAW;CAElD;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,IAAa,kBAAb,cAAqC,GAAG,MAAM,gBAAgB,aAAa,CAAC,CAAC;CAC3E,OAAgB;;;;;CAMhB;;;;;;;CAQA,YAAY,SAAiB,eAAgC;EAC3D,MAAM,OAAO;EACb,KAAK,gBAAgB;CACvB;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,IAAa,uBAAb,MAAa,6BAA6B,GAAG,MAC3C,gBACA,kBACF,CAAC,CAAC;CACA,OAAgB;;;;;;;CAQhB;CAEA,YAAY,SAAkB;EAC5B,MAAM,WAAW,4CAA4C;CAC/D;;;;;;;;;;;;;;;;;;;;CAqBA,OAAO,UAAU,KAAkC;EACjD,MAAM,QAAQ,IAAI,qBAAqB,IAAI,OAAO;EAClD,MAAM,QAAQ;EACd,OAAO;CACT;AACF"}

package/dist/example_selectors/base.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"base.cjs","names":["Serializable"],"sources":["../../src/example_selectors/base.ts"],"sourcesContent":["import { Serializable } from \"../load/serializable.js\";\nimport type { Example } from \"../prompts/base.js\";\n\n/**\n * Base class for example selectors.\n */\nexport abstract class BaseExampleSelector extends Serializable {\n  lc_namespace = [\"langchain_core\", \"example_selectors\", \"base\"];\n\n  /**\n   * Adds an example to the example selector.\n   * @param example The example to add to the example selector.\n   * @returns A Promise that resolves to void or a string.\n   */\n  abstract addExample(example: Example): Promise<void | string>;\n\n  /**\n   * Selects examples from the example selector given the input variables.\n   * @param input_variables The input variables to select examples with.\n   * @returns A Promise that resolves to an array of selected examples.\n   */\n  abstract selectExamples(input_variables: Example): Promise<Example[]>;\n}\n"],"mappings":";;;;;AAMA,IAAsB,sBAAtB,cAAkDA,0BAAAA,aAAa;CAC7D,eAAe;EAAC;EAAkB;EAAqB;EAAO"}
+{"version":3,"file":"base.cjs","names":["Serializable"],"sources":["../../src/example_selectors/base.ts"],"sourcesContent":["import { Serializable } from \"../load/serializable.js\";\nimport type { Example } from \"../prompts/base.js\";\n\n/**\n * Base class for example selectors.\n */\nexport abstract class BaseExampleSelector extends Serializable {\n  lc_namespace = [\"langchain_core\", \"example_selectors\", \"base\"];\n\n  /**\n   * Adds an example to the example selector.\n   * @param example The example to add to the example selector.\n   * @returns A Promise that resolves to void or a string.\n   */\n  abstract addExample(example: Example): Promise<void | string>;\n\n  /**\n   * Selects examples from the example selector given the input variables.\n   * @param input_variables The input variables to select examples with.\n   * @returns A Promise that resolves to an array of selected examples.\n   */\n  abstract selectExamples(input_variables: Example): Promise<Example[]>;\n}\n"],"mappings":";;;;;AAMA,IAAsB,sBAAtB,cAAkDA,0BAAAA,aAAa;CAC7D,eAAe;EAAC;EAAkB;EAAqB;CAAM;AAe/D"}

package/dist/example_selectors/base.d.cts

@@ -1,6 +1,5 @@
 import { Serializable } from "../load/serializable.cjs";
 import { Example } from "../prompts/base.cjs";
-
 //#region src/example_selectors/base.d.ts
 /**
  * Base class for example selectors.

package/dist/example_selectors/base.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.cts","names":[],"sources":["../../src/example_selectors/base.ts"],"mappings":";;;;;;AAMA;uBAAsB,mBAAA,SAA4B,YAAA;EAChD,YAAA;EAO6B;;;;;EAAA,SAApB,UAAA,CAAW,OAAA,EAAS,OAAA,GAAU,OAAA;EARqB;;;;;EAAA,SAenD,cAAA,CAAe,eAAA,EAAiB,OAAA,GAAU,OAAA,CAAQ,OAAA;AAAA"}
+{"version":3,"file":"base.d.cts","names":[],"sources":["../../src/example_selectors/base.ts"],"mappings":";;;;;;uBAMsB,4BAA4B;EAChD;;;;;;WAOS,WAAW,SAAS,UAAU;;;;;;WAO9B,eAAe,iBAAiB,UAAU,QAAQ"}

package/dist/example_selectors/base.d.ts

@@ -1,6 +1,5 @@
 import { Serializable } from "../load/serializable.js";
 import { Example } from "../prompts/base.js";
-
 //#region src/example_selectors/base.d.ts
 /**
  * Base class for example selectors.

package/dist/example_selectors/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","names":[],"sources":["../../src/example_selectors/base.ts"],"mappings":";;;;;;AAMA;uBAAsB,mBAAA,SAA4B,YAAA;EAChD,YAAA;EAO6B;;;;;EAAA,SAApB,UAAA,CAAW,OAAA,EAAS,OAAA,GAAU,OAAA;EARqB;;;;;EAAA,SAenD,cAAA,CAAe,eAAA,EAAiB,OAAA,GAAU,OAAA,CAAQ,OAAA;AAAA"}
+{"version":3,"file":"base.d.ts","names":[],"sources":["../../src/example_selectors/base.ts"],"mappings":";;;;;;uBAMsB,4BAA4B;EAChD;;;;;;WAOS,WAAW,SAAS,UAAU;;;;;;WAO9B,eAAe,iBAAiB,UAAU,QAAQ"}

package/dist/example_selectors/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","names":[],"sources":["../../src/example_selectors/base.ts"],"sourcesContent":["import { Serializable } from \"../load/serializable.js\";\nimport type { Example } from \"../prompts/base.js\";\n\n/**\n * Base class for example selectors.\n */\nexport abstract class BaseExampleSelector extends Serializable {\n  lc_namespace = [\"langchain_core\", \"example_selectors\", \"base\"];\n\n  /**\n   * Adds an example to the example selector.\n   * @param example The example to add to the example selector.\n   * @returns A Promise that resolves to void or a string.\n   */\n  abstract addExample(example: Example): Promise<void | string>;\n\n  /**\n   * Selects examples from the example selector given the input variables.\n   * @param input_variables The input variables to select examples with.\n   * @returns A Promise that resolves to an array of selected examples.\n   */\n  abstract selectExamples(input_variables: Example): Promise<Example[]>;\n}\n"],"mappings":";;;;;AAMA,IAAsB,sBAAtB,cAAkD,aAAa;CAC7D,eAAe;EAAC;EAAkB;EAAqB;EAAO"}
+{"version":3,"file":"base.js","names":[],"sources":["../../src/example_selectors/base.ts"],"sourcesContent":["import { Serializable } from \"../load/serializable.js\";\nimport type { Example } from \"../prompts/base.js\";\n\n/**\n * Base class for example selectors.\n */\nexport abstract class BaseExampleSelector extends Serializable {\n  lc_namespace = [\"langchain_core\", \"example_selectors\", \"base\"];\n\n  /**\n   * Adds an example to the example selector.\n   * @param example The example to add to the example selector.\n   * @returns A Promise that resolves to void or a string.\n   */\n  abstract addExample(example: Example): Promise<void | string>;\n\n  /**\n   * Selects examples from the example selector given the input variables.\n   * @param input_variables The input variables to select examples with.\n   * @returns A Promise that resolves to an array of selected examples.\n   */\n  abstract selectExamples(input_variables: Example): Promise<Example[]>;\n}\n"],"mappings":";;;;;AAMA,IAAsB,sBAAtB,cAAkD,aAAa;CAC7D,eAAe;EAAC;EAAkB;EAAqB;CAAM;AAe/D"}

package/dist/example_selectors/conditional.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"conditional.cjs","names":[],"sources":["../../src/example_selectors/conditional.ts"],"sourcesContent":["import type { BaseChatModel } from \"../language_models/chat_models.js\";\nimport type { BasePromptTemplate } from \"../prompts/base.js\";\nimport type { BaseLanguageModelInterface } from \"../language_models/base.js\";\nimport type { BaseLLM } from \"../language_models/llms.js\";\nimport type { PartialValues } from \"../utils/types/index.js\";\n\nexport type BaseGetPromptAsyncOptions = {\n  partialVariables?: PartialValues;\n};\n\n/**\n * Abstract class that defines the interface for selecting a prompt for a\n * given language model.\n */\nexport abstract class BasePromptSelector {\n  /**\n   * Abstract method that must be implemented by any class that extends\n   * `BasePromptSelector`. It takes a language model as an argument and\n   * returns a prompt template.\n   * @param llm The language model for which to get a prompt.\n   * @returns A prompt template.\n   */\n  abstract getPrompt(llm: BaseLanguageModelInterface): BasePromptTemplate;\n\n  /**\n   * Asynchronous version of `getPrompt` that also accepts an options object\n   * for partial variables.\n   * @param llm The language model for which to get a prompt.\n   * @param options Optional object for partial variables.\n   * @returns A Promise that resolves to a prompt template.\n   */\n  async getPromptAsync(\n    llm: BaseLanguageModelInterface,\n    options?: BaseGetPromptAsyncOptions\n  ): Promise<BasePromptTemplate> {\n    const prompt = this.getPrompt(llm);\n    return prompt.partial(options?.partialVariables ?? {});\n  }\n}\n\n/**\n * Concrete implementation of `BasePromptSelector` that selects a prompt\n * based on a set of conditions. It has a default prompt that it returns\n * if none of the conditions are met.\n */\nexport class ConditionalPromptSelector extends BasePromptSelector {\n  defaultPrompt: BasePromptTemplate;\n\n  conditionals: Array<\n    [\n      condition: (llm: BaseLanguageModelInterface) => boolean,\n      prompt: BasePromptTemplate,\n    ]\n  >;\n\n  constructor(\n    default_prompt: BasePromptTemplate,\n    conditionals: Array<\n      [\n        condition: (llm: BaseLanguageModelInterface) => boolean,\n        prompt: BasePromptTemplate,\n      ]\n    > = []\n  ) {\n    super();\n    this.defaultPrompt = default_prompt;\n    this.conditionals = conditionals;\n  }\n\n  /**\n   * Method that selects a prompt based on a set of conditions. If none of\n   * the conditions are met, it returns the default prompt.\n   * @param llm The language model for which to get a prompt.\n   * @returns A prompt template.\n   */\n  getPrompt(llm: BaseLanguageModelInterface): BasePromptTemplate {\n    for (const [condition, prompt] of this.conditionals) {\n      if (condition(llm)) {\n        return prompt;\n      }\n    }\n    return this.defaultPrompt;\n  }\n}\n\n/**\n * Type guard function that checks if a given language model is of type\n * `BaseLLM`.\n */\nexport function isLLM(llm: BaseLanguageModelInterface): llm is BaseLLM {\n  return llm._modelType() === \"base_llm\";\n}\n\n/**\n * Type guard function that checks if a given language model is of type\n * `BaseChatModel`.\n */\nexport function isChatModel(\n  llm: BaseLanguageModelInterface\n): llm is BaseChatModel {\n  return llm._modelType() === \"base_chat_model\";\n}\n"],"mappings":";;;;;AAcA,IAAsB,qBAAtB,MAAyC;;;;;;;;CAiBvC,MAAM,eACJ,KACA,SAC6B;AAE7B,SADe,KAAK,UAAU,IACjB,CAAC,QAAQ,SAAS,oBAAoB,EAAE,CAAC;;;;;;;;AAS1D,IAAa,4BAAb,cAA+C,mBAAmB;CAChE;CAEA;CAOA,YACE,gBACA,eAKI,EAAE,EACN;AACA,SAAO;AACP,OAAK,gBAAgB;AACrB,OAAK,eAAe;;;;;;;;CAStB,UAAU,KAAqD;AAC7D,OAAK,MAAM,CAAC,WAAW,WAAW,KAAK,aACrC,KAAI,UAAU,IAAI,CAChB,QAAO;AAGX,SAAO,KAAK;;;;;;;AAQhB,SAAgB,MAAM,KAAiD;AACrE,QAAO,IAAI,YAAY,KAAK;;;;;;AAO9B,SAAgB,YACd,KACsB;AACtB,QAAO,IAAI,YAAY,KAAK"}
+{"version":3,"file":"conditional.cjs","names":[],"sources":["../../src/example_selectors/conditional.ts"],"sourcesContent":["import type { BaseChatModel } from \"../language_models/chat_models.js\";\nimport type { BasePromptTemplate } from \"../prompts/base.js\";\nimport type { BaseLanguageModelInterface } from \"../language_models/base.js\";\nimport type { BaseLLM } from \"../language_models/llms.js\";\nimport type { PartialValues } from \"../utils/types/index.js\";\n\nexport type BaseGetPromptAsyncOptions = {\n  partialVariables?: PartialValues;\n};\n\n/**\n * Abstract class that defines the interface for selecting a prompt for a\n * given language model.\n */\nexport abstract class BasePromptSelector {\n  /**\n   * Abstract method that must be implemented by any class that extends\n   * `BasePromptSelector`. It takes a language model as an argument and\n   * returns a prompt template.\n   * @param llm The language model for which to get a prompt.\n   * @returns A prompt template.\n   */\n  abstract getPrompt(llm: BaseLanguageModelInterface): BasePromptTemplate;\n\n  /**\n   * Asynchronous version of `getPrompt` that also accepts an options object\n   * for partial variables.\n   * @param llm The language model for which to get a prompt.\n   * @param options Optional object for partial variables.\n   * @returns A Promise that resolves to a prompt template.\n   */\n  async getPromptAsync(\n    llm: BaseLanguageModelInterface,\n    options?: BaseGetPromptAsyncOptions\n  ): Promise<BasePromptTemplate> {\n    const prompt = this.getPrompt(llm);\n    return prompt.partial(options?.partialVariables ?? {});\n  }\n}\n\n/**\n * Concrete implementation of `BasePromptSelector` that selects a prompt\n * based on a set of conditions. It has a default prompt that it returns\n * if none of the conditions are met.\n */\nexport class ConditionalPromptSelector extends BasePromptSelector {\n  defaultPrompt: BasePromptTemplate;\n\n  conditionals: Array<\n    [\n      condition: (llm: BaseLanguageModelInterface) => boolean,\n      prompt: BasePromptTemplate,\n    ]\n  >;\n\n  constructor(\n    default_prompt: BasePromptTemplate,\n    conditionals: Array<\n      [\n        condition: (llm: BaseLanguageModelInterface) => boolean,\n        prompt: BasePromptTemplate,\n      ]\n    > = []\n  ) {\n    super();\n    this.defaultPrompt = default_prompt;\n    this.conditionals = conditionals;\n  }\n\n  /**\n   * Method that selects a prompt based on a set of conditions. If none of\n   * the conditions are met, it returns the default prompt.\n   * @param llm The language model for which to get a prompt.\n   * @returns A prompt template.\n   */\n  getPrompt(llm: BaseLanguageModelInterface): BasePromptTemplate {\n    for (const [condition, prompt] of this.conditionals) {\n      if (condition(llm)) {\n        return prompt;\n      }\n    }\n    return this.defaultPrompt;\n  }\n}\n\n/**\n * Type guard function that checks if a given language model is of type\n * `BaseLLM`.\n */\nexport function isLLM(llm: BaseLanguageModelInterface): llm is BaseLLM {\n  return llm._modelType() === \"base_llm\";\n}\n\n/**\n * Type guard function that checks if a given language model is of type\n * `BaseChatModel`.\n */\nexport function isChatModel(\n  llm: BaseLanguageModelInterface\n): llm is BaseChatModel {\n  return llm._modelType() === \"base_chat_model\";\n}\n"],"mappings":";;;;;AAcA,IAAsB,qBAAtB,MAAyC;;;;;;;;CAiBvC,MAAM,eACJ,KACA,SAC6B;EAE7B,OADe,KAAK,UAAU,GAClB,CAAC,CAAC,QAAQ,SAAS,oBAAoB,CAAC,CAAC;CACvD;AACF;;;;;;AAOA,IAAa,4BAAb,cAA+C,mBAAmB;CAChE;CAEA;CAOA,YACE,gBACA,eAKI,CAAC,GACL;EACA,MAAM;EACN,KAAK,gBAAgB;EACrB,KAAK,eAAe;CACtB;;;;;;;CAQA,UAAU,KAAqD;EAC7D,KAAK,MAAM,CAAC,WAAW,WAAW,KAAK,cACrC,IAAI,UAAU,GAAG,GACf,OAAO;EAGX,OAAO,KAAK;CACd;AACF;;;;;AAMA,SAAgB,MAAM,KAAiD;CACrE,OAAO,IAAI,WAAW,MAAM;AAC9B;;;;;AAMA,SAAgB,YACd,KACsB;CACtB,OAAO,IAAI,WAAW,MAAM;AAC9B"}

package/dist/example_selectors/conditional.d.cts

@@ -3,7 +3,6 @@ import { BaseLanguageModelInterface } from "../language_models/base.cjs";
 import { BasePromptTemplate } from "../prompts/base.cjs";
 import { BaseChatModel } from "../language_models/chat_models.cjs";
 import { BaseLLM } from "../language_models/llms.cjs";
-
 //#region src/example_selectors/conditional.d.ts
 type BaseGetPromptAsyncOptions = {
   partialVariables?: PartialValues;

package/dist/example_selectors/conditional.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"conditional.d.cts","names":[],"sources":["../../src/example_selectors/conditional.ts"],"mappings":";;;;;;;KAMY,yBAAA;EACV,gBAAA,GAAmB,aAAA;AAAA;;;;;uBAOC,kBAAA;EAAkB;;;;;;;EAAA,SAQ7B,SAAA,CAAU,GAAA,EAAK,0BAAA,GAA6B,kBAAA;EAY3C;;;;;;;EAHJ,cAAA,CACJ,GAAA,EAAK,0BAAA,EACL,OAAA,GAAU,yBAAA,GACT,OAAA,CAAQ,kBAAA;AAAA;;;;;;cAWA,yBAAA,SAAkC,kBAAA;EAC7C,aAAA,EAAe,kBAAA;EAEf,YAAA,EAAc,KAAA,EAEV,SAAA,GAAY,GAAA,EAAK,0BAAA,cACjB,MAAA,EAAQ,kBAAA;EAIZ,WAAA,CACE,cAAA,EAAgB,kBAAA,EAChB,YAAA,GAAc,KAAA,EAEV,SAAA,GAAY,GAAA,EAAK,0BAAA,cACjB,MAAA,EAAQ,kBAAA;EAAA;;;;;;EAed,SAAA,CAAU,GAAA,EAAK,0BAAA,GAA6B,kBAAA;AAAA;;;;;iBAc9B,KAAA,CAAM,GAAA,EAAK,0BAAA,GAA6B,GAAA,IAAO,OAAA;;;;;iBAQ/C,WAAA,CACd,GAAA,EAAK,0BAAA,GACJ,GAAA,IAAO,aAAA"}
+{"version":3,"file":"conditional.d.cts","names":[],"sources":["../../src/example_selectors/conditional.ts"],"mappings":";;;;;;KAMY;EACV,mBAAmB;;;;;;uBAOC;;;;;;;;WAQX,UAAU,KAAK,6BAA6B;;;;;;;;EAS/C,eACJ,KAAK,4BACL,UAAU,4BACT,QAAQ;;;;;;;cAWA,kCAAkC;EAC7C,eAAe;EAEf,cAAc,OAEV,YAAY,KAAK,wCACjB,QAAQ;EAIZ,YACE,gBAAgB,oBAChB,eAAc,OAEV,YAAY,KAAK,wCACjB,QAAQ;;;;;;;EAed,UAAU,KAAK,6BAA6B;;;;;;iBAc9B,MAAM,KAAK,6BAA6B,OAAO;;;;;iBAQ/C,YACd,KAAK,6BACJ,OAAO"}

package/dist/example_selectors/conditional.d.ts

@@ -3,7 +3,6 @@ import { BaseLanguageModelInterface } from "../language_models/base.js";
 import { BasePromptTemplate } from "../prompts/base.js";
 import { BaseChatModel } from "../language_models/chat_models.js";
 import { BaseLLM } from "../language_models/llms.js";
-
 //#region src/example_selectors/conditional.d.ts
 type BaseGetPromptAsyncOptions = {
   partialVariables?: PartialValues;

package/dist/example_selectors/conditional.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conditional.d.ts","names":[],"sources":["../../src/example_selectors/conditional.ts"],"mappings":";;;;;;;KAMY,yBAAA;EACV,gBAAA,GAAmB,aAAA;AAAA;;;;;uBAOC,kBAAA;EAAkB;;;;;;;EAAA,SAQ7B,SAAA,CAAU,GAAA,EAAK,0BAAA,GAA6B,kBAAA;EAY3C;;;;;;;EAHJ,cAAA,CACJ,GAAA,EAAK,0BAAA,EACL,OAAA,GAAU,yBAAA,GACT,OAAA,CAAQ,kBAAA;AAAA;;;;;;cAWA,yBAAA,SAAkC,kBAAA;EAC7C,aAAA,EAAe,kBAAA;EAEf,YAAA,EAAc,KAAA,EAEV,SAAA,GAAY,GAAA,EAAK,0BAAA,cACjB,MAAA,EAAQ,kBAAA;EAIZ,WAAA,CACE,cAAA,EAAgB,kBAAA,EAChB,YAAA,GAAc,KAAA,EAEV,SAAA,GAAY,GAAA,EAAK,0BAAA,cACjB,MAAA,EAAQ,kBAAA;EAAA;;;;;;EAed,SAAA,CAAU,GAAA,EAAK,0BAAA,GAA6B,kBAAA;AAAA;;;;;iBAc9B,KAAA,CAAM,GAAA,EAAK,0BAAA,GAA6B,GAAA,IAAO,OAAA;;;;;iBAQ/C,WAAA,CACd,GAAA,EAAK,0BAAA,GACJ,GAAA,IAAO,aAAA"}
+{"version":3,"file":"conditional.d.ts","names":[],"sources":["../../src/example_selectors/conditional.ts"],"mappings":";;;;;;KAMY;EACV,mBAAmB;;;;;;uBAOC;;;;;;;;WAQX,UAAU,KAAK,6BAA6B;;;;;;;;EAS/C,eACJ,KAAK,4BACL,UAAU,4BACT,QAAQ;;;;;;;cAWA,kCAAkC;EAC7C,eAAe;EAEf,cAAc,OAEV,YAAY,KAAK,wCACjB,QAAQ;EAIZ,YACE,gBAAgB,oBAChB,eAAc,OAEV,YAAY,KAAK,wCACjB,QAAQ;;;;;;;EAed,UAAU,KAAK,6BAA6B;;;;;;iBAc9B,MAAM,KAAK,6BAA6B,OAAO;;;;;iBAQ/C,YACd,KAAK,6BACJ,OAAO"}

package/dist/example_selectors/conditional.js.map

@@ -1 +1 @@
-{"version":3,"file":"conditional.js","names":[],"sources":["../../src/example_selectors/conditional.ts"],"sourcesContent":["import type { BaseChatModel } from \"../language_models/chat_models.js\";\nimport type { BasePromptTemplate } from \"../prompts/base.js\";\nimport type { BaseLanguageModelInterface } from \"../language_models/base.js\";\nimport type { BaseLLM } from \"../language_models/llms.js\";\nimport type { PartialValues } from \"../utils/types/index.js\";\n\nexport type BaseGetPromptAsyncOptions = {\n  partialVariables?: PartialValues;\n};\n\n/**\n * Abstract class that defines the interface for selecting a prompt for a\n * given language model.\n */\nexport abstract class BasePromptSelector {\n  /**\n   * Abstract method that must be implemented by any class that extends\n   * `BasePromptSelector`. It takes a language model as an argument and\n   * returns a prompt template.\n   * @param llm The language model for which to get a prompt.\n   * @returns A prompt template.\n   */\n  abstract getPrompt(llm: BaseLanguageModelInterface): BasePromptTemplate;\n\n  /**\n   * Asynchronous version of `getPrompt` that also accepts an options object\n   * for partial variables.\n   * @param llm The language model for which to get a prompt.\n   * @param options Optional object for partial variables.\n   * @returns A Promise that resolves to a prompt template.\n   */\n  async getPromptAsync(\n    llm: BaseLanguageModelInterface,\n    options?: BaseGetPromptAsyncOptions\n  ): Promise<BasePromptTemplate> {\n    const prompt = this.getPrompt(llm);\n    return prompt.partial(options?.partialVariables ?? {});\n  }\n}\n\n/**\n * Concrete implementation of `BasePromptSelector` that selects a prompt\n * based on a set of conditions. It has a default prompt that it returns\n * if none of the conditions are met.\n */\nexport class ConditionalPromptSelector extends BasePromptSelector {\n  defaultPrompt: BasePromptTemplate;\n\n  conditionals: Array<\n    [\n      condition: (llm: BaseLanguageModelInterface) => boolean,\n      prompt: BasePromptTemplate,\n    ]\n  >;\n\n  constructor(\n    default_prompt: BasePromptTemplate,\n    conditionals: Array<\n      [\n        condition: (llm: BaseLanguageModelInterface) => boolean,\n        prompt: BasePromptTemplate,\n      ]\n    > = []\n  ) {\n    super();\n    this.defaultPrompt = default_prompt;\n    this.conditionals = conditionals;\n  }\n\n  /**\n   * Method that selects a prompt based on a set of conditions. If none of\n   * the conditions are met, it returns the default prompt.\n   * @param llm The language model for which to get a prompt.\n   * @returns A prompt template.\n   */\n  getPrompt(llm: BaseLanguageModelInterface): BasePromptTemplate {\n    for (const [condition, prompt] of this.conditionals) {\n      if (condition(llm)) {\n        return prompt;\n      }\n    }\n    return this.defaultPrompt;\n  }\n}\n\n/**\n * Type guard function that checks if a given language model is of type\n * `BaseLLM`.\n */\nexport function isLLM(llm: BaseLanguageModelInterface): llm is BaseLLM {\n  return llm._modelType() === \"base_llm\";\n}\n\n/**\n * Type guard function that checks if a given language model is of type\n * `BaseChatModel`.\n */\nexport function isChatModel(\n  llm: BaseLanguageModelInterface\n): llm is BaseChatModel {\n  return llm._modelType() === \"base_chat_model\";\n}\n"],"mappings":";;;;;AAcA,IAAsB,qBAAtB,MAAyC;;;;;;;;CAiBvC,MAAM,eACJ,KACA,SAC6B;AAE7B,SADe,KAAK,UAAU,IACjB,CAAC,QAAQ,SAAS,oBAAoB,EAAE,CAAC;;;;;;;;AAS1D,IAAa,4BAAb,cAA+C,mBAAmB;CAChE;CAEA;CAOA,YACE,gBACA,eAKI,EAAE,EACN;AACA,SAAO;AACP,OAAK,gBAAgB;AACrB,OAAK,eAAe;;;;;;;;CAStB,UAAU,KAAqD;AAC7D,OAAK,MAAM,CAAC,WAAW,WAAW,KAAK,aACrC,KAAI,UAAU,IAAI,CAChB,QAAO;AAGX,SAAO,KAAK;;;;;;;AAQhB,SAAgB,MAAM,KAAiD;AACrE,QAAO,IAAI,YAAY,KAAK;;;;;;AAO9B,SAAgB,YACd,KACsB;AACtB,QAAO,IAAI,YAAY,KAAK"}
+{"version":3,"file":"conditional.js","names":[],"sources":["../../src/example_selectors/conditional.ts"],"sourcesContent":["import type { BaseChatModel } from \"../language_models/chat_models.js\";\nimport type { BasePromptTemplate } from \"../prompts/base.js\";\nimport type { BaseLanguageModelInterface } from \"../language_models/base.js\";\nimport type { BaseLLM } from \"../language_models/llms.js\";\nimport type { PartialValues } from \"../utils/types/index.js\";\n\nexport type BaseGetPromptAsyncOptions = {\n  partialVariables?: PartialValues;\n};\n\n/**\n * Abstract class that defines the interface for selecting a prompt for a\n * given language model.\n */\nexport abstract class BasePromptSelector {\n  /**\n   * Abstract method that must be implemented by any class that extends\n   * `BasePromptSelector`. It takes a language model as an argument and\n   * returns a prompt template.\n   * @param llm The language model for which to get a prompt.\n   * @returns A prompt template.\n   */\n  abstract getPrompt(llm: BaseLanguageModelInterface): BasePromptTemplate;\n\n  /**\n   * Asynchronous version of `getPrompt` that also accepts an options object\n   * for partial variables.\n   * @param llm The language model for which to get a prompt.\n   * @param options Optional object for partial variables.\n   * @returns A Promise that resolves to a prompt template.\n   */\n  async getPromptAsync(\n    llm: BaseLanguageModelInterface,\n    options?: BaseGetPromptAsyncOptions\n  ): Promise<BasePromptTemplate> {\n    const prompt = this.getPrompt(llm);\n    return prompt.partial(options?.partialVariables ?? {});\n  }\n}\n\n/**\n * Concrete implementation of `BasePromptSelector` that selects a prompt\n * based on a set of conditions. It has a default prompt that it returns\n * if none of the conditions are met.\n */\nexport class ConditionalPromptSelector extends BasePromptSelector {\n  defaultPrompt: BasePromptTemplate;\n\n  conditionals: Array<\n    [\n      condition: (llm: BaseLanguageModelInterface) => boolean,\n      prompt: BasePromptTemplate,\n    ]\n  >;\n\n  constructor(\n    default_prompt: BasePromptTemplate,\n    conditionals: Array<\n      [\n        condition: (llm: BaseLanguageModelInterface) => boolean,\n        prompt: BasePromptTemplate,\n      ]\n    > = []\n  ) {\n    super();\n    this.defaultPrompt = default_prompt;\n    this.conditionals = conditionals;\n  }\n\n  /**\n   * Method that selects a prompt based on a set of conditions. If none of\n   * the conditions are met, it returns the default prompt.\n   * @param llm The language model for which to get a prompt.\n   * @returns A prompt template.\n   */\n  getPrompt(llm: BaseLanguageModelInterface): BasePromptTemplate {\n    for (const [condition, prompt] of this.conditionals) {\n      if (condition(llm)) {\n        return prompt;\n      }\n    }\n    return this.defaultPrompt;\n  }\n}\n\n/**\n * Type guard function that checks if a given language model is of type\n * `BaseLLM`.\n */\nexport function isLLM(llm: BaseLanguageModelInterface): llm is BaseLLM {\n  return llm._modelType() === \"base_llm\";\n}\n\n/**\n * Type guard function that checks if a given language model is of type\n * `BaseChatModel`.\n */\nexport function isChatModel(\n  llm: BaseLanguageModelInterface\n): llm is BaseChatModel {\n  return llm._modelType() === \"base_chat_model\";\n}\n"],"mappings":";;;;;AAcA,IAAsB,qBAAtB,MAAyC;;;;;;;;CAiBvC,MAAM,eACJ,KACA,SAC6B;EAE7B,OADe,KAAK,UAAU,GAClB,CAAC,CAAC,QAAQ,SAAS,oBAAoB,CAAC,CAAC;CACvD;AACF;;;;;;AAOA,IAAa,4BAAb,cAA+C,mBAAmB;CAChE;CAEA;CAOA,YACE,gBACA,eAKI,CAAC,GACL;EACA,MAAM;EACN,KAAK,gBAAgB;EACrB,KAAK,eAAe;CACtB;;;;;;;CAQA,UAAU,KAAqD;EAC7D,KAAK,MAAM,CAAC,WAAW,WAAW,KAAK,cACrC,IAAI,UAAU,GAAG,GACf,OAAO;EAGX,OAAO,KAAK;CACd;AACF;;;;;AAMA,SAAgB,MAAM,KAAiD;CACrE,OAAO,IAAI,WAAW,MAAM;AAC9B;;;;;AAMA,SAAgB,YACd,KACsB;CACtB,OAAO,IAAI,WAAW,MAAM;AAC9B"}

package/dist/example_selectors/length_based.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"length_based.cjs","names":["BaseExampleSelector"],"sources":["../../src/example_selectors/length_based.ts"],"sourcesContent":["import { Example } from \"../prompts/base.js\";\nimport { BaseExampleSelector } from \"./base.js\";\nimport { PromptTemplate } from \"../prompts/prompt.js\";\n\n/**\n * Calculates the length of a text based on the number of words and lines.\n */\nfunction getLengthBased(text: string): number {\n  return text.split(/\\n| /).length;\n}\n\n/**\n * Interface for the input parameters of the LengthBasedExampleSelector\n * class.\n */\nexport interface LengthBasedExampleSelectorInput {\n  examplePrompt: PromptTemplate;\n  maxLength?: number;\n  getTextLength?: (text: string) => number;\n}\n\n/**\n * A specialized example selector that selects examples based on their\n * length, ensuring that the total length of the selected examples does\n * not exceed a specified maximum length.\n * @example\n * ```typescript\n * const exampleSelector = new LengthBasedExampleSelector(\n *   [\n *     { input: \"happy\", output: \"sad\" },\n *     { input: \"tall\", output: \"short\" },\n *     { input: \"energetic\", output: \"lethargic\" },\n *     { input: \"sunny\", output: \"gloomy\" },\n *     { input: \"windy\", output: \"calm\" },\n *   ],\n *   {\n *     examplePrompt: new PromptTemplate({\n *       inputVariables: [\"input\", \"output\"],\n *       template: \"Input: {input}\\nOutput: {output}\",\n *     }),\n *     maxLength: 25,\n *   },\n * );\n * const dynamicPrompt = new FewShotPromptTemplate({\n *   exampleSelector,\n *   examplePrompt: new PromptTemplate({\n *     inputVariables: [\"input\", \"output\"],\n *     template: \"Input: {input}\\nOutput: {output}\",\n *   }),\n *   prefix: \"Give the antonym of every input\",\n *   suffix: \"Input: {adjective}\\nOutput:\",\n *   inputVariables: [\"adjective\"],\n * });\n * console.log(dynamicPrompt.format({ adjective: \"big\" }));\n * console.log(\n *   dynamicPrompt.format({\n *     adjective:\n *       \"big and huge and massive and large and gigantic and tall and much much much much much bigger than everything else\",\n *   }),\n * );\n * ```\n */\nexport class LengthBasedExampleSelector extends BaseExampleSelector {\n  protected examples: Example[] = [];\n\n  examplePrompt!: PromptTemplate;\n\n  getTextLength: (text: string) => number = getLengthBased;\n\n  maxLength = 2048;\n\n  exampleTextLengths: number[] = [];\n\n  constructor(data: LengthBasedExampleSelectorInput) {\n    super(data);\n    this.examplePrompt = data.examplePrompt;\n    this.maxLength = data.maxLength ?? 2048;\n    this.getTextLength = data.getTextLength ?? getLengthBased;\n  }\n\n  /**\n   * Adds an example to the list of examples and calculates its length.\n   * @param example The example to be added.\n   * @returns Promise that resolves when the example has been added and its length calculated.\n   */\n  async addExample(example: Example): Promise<void> {\n    this.examples.push(example);\n    const stringExample = await this.examplePrompt.format(example);\n    this.exampleTextLengths.push(this.getTextLength(stringExample));\n  }\n\n  /**\n   * Calculates the lengths of the examples.\n   * @param v Array of lengths of the examples.\n   * @param values Instance of LengthBasedExampleSelector.\n   * @returns Promise that resolves with an array of lengths of the examples.\n   */\n  async calculateExampleTextLengths(\n    v: number[],\n    values: LengthBasedExampleSelector\n  ): Promise<number[]> {\n    if (v.length > 0) {\n      return v;\n    }\n\n    const { examples, examplePrompt } = values;\n    const stringExamples = await Promise.all(\n      examples.map((eg: Example) => examplePrompt.format(eg))\n    );\n    return stringExamples.map((eg: string) => this.getTextLength(eg));\n  }\n\n  /**\n   * Selects examples until the total length of the selected examples\n   * reaches the maxLength.\n   * @param inputVariables The input variables for the examples.\n   * @returns Promise that resolves with an array of selected examples.\n   */\n  async selectExamples(inputVariables: Example): Promise<Example[]> {\n    const inputs = Object.values(inputVariables).join(\" \");\n    let remainingLength = this.maxLength - this.getTextLength(inputs);\n    let i = 0;\n    const examples: Example[] = [];\n\n    while (remainingLength > 0 && i < this.examples.length) {\n      const newLength = remainingLength - this.exampleTextLengths[i];\n      if (newLength < 0) {\n        break;\n      } else {\n        examples.push(this.examples[i]);\n        remainingLength = newLength;\n      }\n      i += 1;\n    }\n\n    return examples;\n  }\n\n  /**\n   * Creates a new instance of LengthBasedExampleSelector and adds a list of\n   * examples to it.\n   * @param examples Array of examples to be added.\n   * @param args Input parameters for the LengthBasedExampleSelector.\n   * @returns Promise that resolves with a new instance of LengthBasedExampleSelector with the examples added.\n   */\n  static async fromExamples(\n    examples: Example[],\n    args: LengthBasedExampleSelectorInput\n  ) {\n    const selector = new LengthBasedExampleSelector(args);\n    await Promise.all(examples.map((eg) => selector.addExample(eg)));\n    return selector;\n  }\n}\n"],"mappings":";;;;;AAOA,SAAS,eAAe,MAAsB;AAC5C,QAAO,KAAK,MAAM,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsD5B,IAAa,6BAAb,MAAa,mCAAmCA,aAAAA,oBAAoB;CAClE,WAAgC,EAAE;CAElC;CAEA,gBAA0C;CAE1C,YAAY;CAEZ,qBAA+B,EAAE;CAEjC,YAAY,MAAuC;AACjD,QAAM,KAAK;AACX,OAAK,gBAAgB,KAAK;AAC1B,OAAK,YAAY,KAAK,aAAa;AACnC,OAAK,gBAAgB,KAAK,iBAAiB;;;;;;;CAQ7C,MAAM,WAAW,SAAiC;AAChD,OAAK,SAAS,KAAK,QAAQ;EAC3B,MAAM,gBAAgB,MAAM,KAAK,cAAc,OAAO,QAAQ;AAC9D,OAAK,mBAAmB,KAAK,KAAK,cAAc,cAAc,CAAC;;;;;;;;CASjE,MAAM,4BACJ,GACA,QACmB;AACnB,MAAI,EAAE,SAAS,EACb,QAAO;EAGT,MAAM,EAAE,UAAU,kBAAkB;AAIpC,UAAO,MAHsB,QAAQ,IACnC,SAAS,KAAK,OAAgB,cAAc,OAAO,GAAG,CAAC,CACxD,EACqB,KAAK,OAAe,KAAK,cAAc,GAAG,CAAC;;;;;;;;CASnE,MAAM,eAAe,gBAA6C;EAChE,MAAM,SAAS,OAAO,OAAO,eAAe,CAAC,KAAK,IAAI;EACtD,IAAI,kBAAkB,KAAK,YAAY,KAAK,cAAc,OAAO;EACjE,IAAI,IAAI;EACR,MAAM,WAAsB,EAAE;AAE9B,SAAO,kBAAkB,KAAK,IAAI,KAAK,SAAS,QAAQ;GACtD,MAAM,YAAY,kBAAkB,KAAK,mBAAmB;AAC5D,OAAI,YAAY,EACd;QACK;AACL,aAAS,KAAK,KAAK,SAAS,GAAG;AAC/B,sBAAkB;;AAEpB,QAAK;;AAGP,SAAO;;;;;;;;;CAUT,aAAa,aACX,UACA,MACA;EACA,MAAM,WAAW,IAAI,2BAA2B,KAAK;AACrD,QAAM,QAAQ,IAAI,SAAS,KAAK,OAAO,SAAS,WAAW,GAAG,CAAC,CAAC;AAChE,SAAO"}
+{"version":3,"file":"length_based.cjs","names":["BaseExampleSelector"],"sources":["../../src/example_selectors/length_based.ts"],"sourcesContent":["import { Example } from \"../prompts/base.js\";\nimport { BaseExampleSelector } from \"./base.js\";\nimport { PromptTemplate } from \"../prompts/prompt.js\";\n\n/**\n * Calculates the length of a text based on the number of words and lines.\n */\nfunction getLengthBased(text: string): number {\n  return text.split(/\\n| /).length;\n}\n\n/**\n * Interface for the input parameters of the LengthBasedExampleSelector\n * class.\n */\nexport interface LengthBasedExampleSelectorInput {\n  examplePrompt: PromptTemplate;\n  maxLength?: number;\n  getTextLength?: (text: string) => number;\n}\n\n/**\n * A specialized example selector that selects examples based on their\n * length, ensuring that the total length of the selected examples does\n * not exceed a specified maximum length.\n * @example\n * ```typescript\n * const exampleSelector = new LengthBasedExampleSelector(\n *   [\n *     { input: \"happy\", output: \"sad\" },\n *     { input: \"tall\", output: \"short\" },\n *     { input: \"energetic\", output: \"lethargic\" },\n *     { input: \"sunny\", output: \"gloomy\" },\n *     { input: \"windy\", output: \"calm\" },\n *   ],\n *   {\n *     examplePrompt: new PromptTemplate({\n *       inputVariables: [\"input\", \"output\"],\n *       template: \"Input: {input}\\nOutput: {output}\",\n *     }),\n *     maxLength: 25,\n *   },\n * );\n * const dynamicPrompt = new FewShotPromptTemplate({\n *   exampleSelector,\n *   examplePrompt: new PromptTemplate({\n *     inputVariables: [\"input\", \"output\"],\n *     template: \"Input: {input}\\nOutput: {output}\",\n *   }),\n *   prefix: \"Give the antonym of every input\",\n *   suffix: \"Input: {adjective}\\nOutput:\",\n *   inputVariables: [\"adjective\"],\n * });\n * console.log(dynamicPrompt.format({ adjective: \"big\" }));\n * console.log(\n *   dynamicPrompt.format({\n *     adjective:\n *       \"big and huge and massive and large and gigantic and tall and much much much much much bigger than everything else\",\n *   }),\n * );\n * ```\n */\nexport class LengthBasedExampleSelector extends BaseExampleSelector {\n  protected examples: Example[] = [];\n\n  examplePrompt!: PromptTemplate;\n\n  getTextLength: (text: string) => number = getLengthBased;\n\n  maxLength = 2048;\n\n  exampleTextLengths: number[] = [];\n\n  constructor(data: LengthBasedExampleSelectorInput) {\n    super(data);\n    this.examplePrompt = data.examplePrompt;\n    this.maxLength = data.maxLength ?? 2048;\n    this.getTextLength = data.getTextLength ?? getLengthBased;\n  }\n\n  /**\n   * Adds an example to the list of examples and calculates its length.\n   * @param example The example to be added.\n   * @returns Promise that resolves when the example has been added and its length calculated.\n   */\n  async addExample(example: Example): Promise<void> {\n    this.examples.push(example);\n    const stringExample = await this.examplePrompt.format(example);\n    this.exampleTextLengths.push(this.getTextLength(stringExample));\n  }\n\n  /**\n   * Calculates the lengths of the examples.\n   * @param v Array of lengths of the examples.\n   * @param values Instance of LengthBasedExampleSelector.\n   * @returns Promise that resolves with an array of lengths of the examples.\n   */\n  async calculateExampleTextLengths(\n    v: number[],\n    values: LengthBasedExampleSelector\n  ): Promise<number[]> {\n    if (v.length > 0) {\n      return v;\n    }\n\n    const { examples, examplePrompt } = values;\n    const stringExamples = await Promise.all(\n      examples.map((eg: Example) => examplePrompt.format(eg))\n    );\n    return stringExamples.map((eg: string) => this.getTextLength(eg));\n  }\n\n  /**\n   * Selects examples until the total length of the selected examples\n   * reaches the maxLength.\n   * @param inputVariables The input variables for the examples.\n   * @returns Promise that resolves with an array of selected examples.\n   */\n  async selectExamples(inputVariables: Example): Promise<Example[]> {\n    const inputs = Object.values(inputVariables).join(\" \");\n    let remainingLength = this.maxLength - this.getTextLength(inputs);\n    let i = 0;\n    const examples: Example[] = [];\n\n    while (remainingLength > 0 && i < this.examples.length) {\n      const newLength = remainingLength - this.exampleTextLengths[i];\n      if (newLength < 0) {\n        break;\n      } else {\n        examples.push(this.examples[i]);\n        remainingLength = newLength;\n      }\n      i += 1;\n    }\n\n    return examples;\n  }\n\n  /**\n   * Creates a new instance of LengthBasedExampleSelector and adds a list of\n   * examples to it.\n   * @param examples Array of examples to be added.\n   * @param args Input parameters for the LengthBasedExampleSelector.\n   * @returns Promise that resolves with a new instance of LengthBasedExampleSelector with the examples added.\n   */\n  static async fromExamples(\n    examples: Example[],\n    args: LengthBasedExampleSelectorInput\n  ) {\n    const selector = new LengthBasedExampleSelector(args);\n    await Promise.all(examples.map((eg) => selector.addExample(eg)));\n    return selector;\n  }\n}\n"],"mappings":";;;;;AAOA,SAAS,eAAe,MAAsB;CAC5C,OAAO,KAAK,MAAM,MAAM,CAAC,CAAC;AAC5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqDA,IAAa,6BAAb,MAAa,mCAAmCA,aAAAA,oBAAoB;CAClE,WAAgC,CAAC;CAEjC;CAEA,gBAA0C;CAE1C,YAAY;CAEZ,qBAA+B,CAAC;CAEhC,YAAY,MAAuC;EACjD,MAAM,IAAI;EACV,KAAK,gBAAgB,KAAK;EAC1B,KAAK,YAAY,KAAK,aAAa;EACnC,KAAK,gBAAgB,KAAK,iBAAiB;CAC7C;;;;;;CAOA,MAAM,WAAW,SAAiC;EAChD,KAAK,SAAS,KAAK,OAAO;EAC1B,MAAM,gBAAgB,MAAM,KAAK,cAAc,OAAO,OAAO;EAC7D,KAAK,mBAAmB,KAAK,KAAK,cAAc,aAAa,CAAC;CAChE;;;;;;;CAQA,MAAM,4BACJ,GACA,QACmB;EACnB,IAAI,EAAE,SAAS,GACb,OAAO;EAGT,MAAM,EAAE,UAAU,kBAAkB;EAIpC,QAAO,MAHsB,QAAQ,IACnC,SAAS,KAAK,OAAgB,cAAc,OAAO,EAAE,CAAC,CACxD,EAAA,CACsB,KAAK,OAAe,KAAK,cAAc,EAAE,CAAC;CAClE;;;;;;;CAQA,MAAM,eAAe,gBAA6C;EAChE,MAAM,SAAS,OAAO,OAAO,cAAc,CAAC,CAAC,KAAK,GAAG;EACrD,IAAI,kBAAkB,KAAK,YAAY,KAAK,cAAc,MAAM;EAChE,IAAI,IAAI;EACR,MAAM,WAAsB,CAAC;EAE7B,OAAO,kBAAkB,KAAK,IAAI,KAAK,SAAS,QAAQ;GACtD,MAAM,YAAY,kBAAkB,KAAK,mBAAmB;GAC5D,IAAI,YAAY,GACd;QACK;IACL,SAAS,KAAK,KAAK,SAAS,EAAE;IAC9B,kBAAkB;GACpB;GACA,KAAK;EACP;EAEA,OAAO;CACT;;;;;;;;CASA,aAAa,aACX,UACA,MACA;EACA,MAAM,WAAW,IAAI,2BAA2B,IAAI;EACpD,MAAM,QAAQ,IAAI,SAAS,KAAK,OAAO,SAAS,WAAW,EAAE,CAAC,CAAC;EAC/D,OAAO;CACT;AACF"}

package/dist/example_selectors/length_based.d.cts

@@ -1,7 +1,6 @@
 import { Example } from "../prompts/base.cjs";
 import { BaseExampleSelector } from "./base.cjs";
 import { PromptTemplate } from "../prompts/prompt.cjs";
-
 //#region src/example_selectors/length_based.d.ts
 /**
  * Interface for the input parameters of the LengthBasedExampleSelector

package/dist/example_selectors/length_based.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"length_based.d.cts","names":[],"sources":["../../src/example_selectors/length_based.ts"],"mappings":";;;;;;;AAeA;;UAAiB,+BAAA;EACf,aAAA,EAAe,cAAA;EACf,SAAA;EACA,aAAA,IAAiB,IAAA;AAAA;;;;;AA4CnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAAa,0BAAA,SAAmC,mBAAA;EAAA,UACpC,QAAA,EAAU,OAAA;EAEpB,aAAA,EAAgB,cAAA;EAEhB,aAAA,GAAgB,IAAA;EAEhB,SAAA;EAEA,kBAAA;EAEA,WAAA,CAAY,IAAA,EAAM,+BAAA;EA6C6B;;;;;EAjCzC,UAAA,CAAW,OAAA,EAAS,OAAA,GAAU,OAAA;EA8DlC;;;;;;EAlDI,2BAAA,CACJ,CAAA,YACA,MAAA,EAAQ,0BAAA,GACP,OAAA;;;;;;;EAkBG,cAAA,CAAe,cAAA,EAAgB,OAAA,GAAU,OAAA,CAAQ,OAAA;;;;;;;;SA2B1C,YAAA,CACX,QAAA,EAAU,OAAA,IACV,IAAA,EAAM,+BAAA,GAA+B,OAAA,CAAA,0BAAA;AAAA"}
+{"version":3,"file":"length_based.d.cts","names":[],"sources":["../../src/example_selectors/length_based.ts"],"mappings":";;;;;;;;UAeiB;EACf,eAAe;EACf;EACA,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA4CN,mCAAmC;YACpC,UAAU;EAEpB,eAAgB;EAEhB,gBAAgB;EAEhB;EAEA;EAEA,YAAY,MAAM;;;;;;EAYZ,WAAW,SAAS,UAAU;;;;;;;EAY9B,4BACJ,aACA,QAAQ,6BACP;;;;;;;EAkBG,eAAe,gBAAgB,UAAU,QAAQ;;;;;;;;SA2B1C,aACX,UAAU,WACV,MAAM,kCAA+B,QAAA"}

package/dist/example_selectors/length_based.d.ts

@@ -1,7 +1,6 @@
 import { Example } from "../prompts/base.js";
 import { BaseExampleSelector } from "./base.js";
 import { PromptTemplate } from "../prompts/prompt.js";
-
 //#region src/example_selectors/length_based.d.ts
 /**
  * Interface for the input parameters of the LengthBasedExampleSelector

package/dist/example_selectors/length_based.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"length_based.d.ts","names":[],"sources":["../../src/example_selectors/length_based.ts"],"mappings":";;;;;;;AAeA;;UAAiB,+BAAA;EACf,aAAA,EAAe,cAAA;EACf,SAAA;EACA,aAAA,IAAiB,IAAA;AAAA;;;;;AA4CnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAAa,0BAAA,SAAmC,mBAAA;EAAA,UACpC,QAAA,EAAU,OAAA;EAEpB,aAAA,EAAgB,cAAA;EAEhB,aAAA,GAAgB,IAAA;EAEhB,SAAA;EAEA,kBAAA;EAEA,WAAA,CAAY,IAAA,EAAM,+BAAA;EA6C6B;;;;;EAjCzC,UAAA,CAAW,OAAA,EAAS,OAAA,GAAU,OAAA;EA8DlC;;;;;;EAlDI,2BAAA,CACJ,CAAA,YACA,MAAA,EAAQ,0BAAA,GACP,OAAA;;;;;;;EAkBG,cAAA,CAAe,cAAA,EAAgB,OAAA,GAAU,OAAA,CAAQ,OAAA;;;;;;;;SA2B1C,YAAA,CACX,QAAA,EAAU,OAAA,IACV,IAAA,EAAM,+BAAA,GAA+B,OAAA,CAAA,0BAAA;AAAA"}
+{"version":3,"file":"length_based.d.ts","names":[],"sources":["../../src/example_selectors/length_based.ts"],"mappings":";;;;;;;;UAeiB;EACf,eAAe;EACf;EACA,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA4CN,mCAAmC;YACpC,UAAU;EAEpB,eAAgB;EAEhB,gBAAgB;EAEhB;EAEA;EAEA,YAAY,MAAM;;;;;;EAYZ,WAAW,SAAS,UAAU;;;;;;;EAY9B,4BACJ,aACA,QAAQ,6BACP;;;;;;;EAkBG,eAAe,gBAAgB,UAAU,QAAQ;;;;;;;;SA2B1C,aACX,UAAU,WACV,MAAM,kCAA+B,QAAA"}

package/dist/example_selectors/length_based.js.map

@@ -1 +1 @@
-{"version":3,"file":"length_based.js","names":[],"sources":["../../src/example_selectors/length_based.ts"],"sourcesContent":["import { Example } from \"../prompts/base.js\";\nimport { BaseExampleSelector } from \"./base.js\";\nimport { PromptTemplate } from \"../prompts/prompt.js\";\n\n/**\n * Calculates the length of a text based on the number of words and lines.\n */\nfunction getLengthBased(text: string): number {\n  return text.split(/\\n| /).length;\n}\n\n/**\n * Interface for the input parameters of the LengthBasedExampleSelector\n * class.\n */\nexport interface LengthBasedExampleSelectorInput {\n  examplePrompt: PromptTemplate;\n  maxLength?: number;\n  getTextLength?: (text: string) => number;\n}\n\n/**\n * A specialized example selector that selects examples based on their\n * length, ensuring that the total length of the selected examples does\n * not exceed a specified maximum length.\n * @example\n * ```typescript\n * const exampleSelector = new LengthBasedExampleSelector(\n *   [\n *     { input: \"happy\", output: \"sad\" },\n *     { input: \"tall\", output: \"short\" },\n *     { input: \"energetic\", output: \"lethargic\" },\n *     { input: \"sunny\", output: \"gloomy\" },\n *     { input: \"windy\", output: \"calm\" },\n *   ],\n *   {\n *     examplePrompt: new PromptTemplate({\n *       inputVariables: [\"input\", \"output\"],\n *       template: \"Input: {input}\\nOutput: {output}\",\n *     }),\n *     maxLength: 25,\n *   },\n * );\n * const dynamicPrompt = new FewShotPromptTemplate({\n *   exampleSelector,\n *   examplePrompt: new PromptTemplate({\n *     inputVariables: [\"input\", \"output\"],\n *     template: \"Input: {input}\\nOutput: {output}\",\n *   }),\n *   prefix: \"Give the antonym of every input\",\n *   suffix: \"Input: {adjective}\\nOutput:\",\n *   inputVariables: [\"adjective\"],\n * });\n * console.log(dynamicPrompt.format({ adjective: \"big\" }));\n * console.log(\n *   dynamicPrompt.format({\n *     adjective:\n *       \"big and huge and massive and large and gigantic and tall and much much much much much bigger than everything else\",\n *   }),\n * );\n * ```\n */\nexport class LengthBasedExampleSelector extends BaseExampleSelector {\n  protected examples: Example[] = [];\n\n  examplePrompt!: PromptTemplate;\n\n  getTextLength: (text: string) => number = getLengthBased;\n\n  maxLength = 2048;\n\n  exampleTextLengths: number[] = [];\n\n  constructor(data: LengthBasedExampleSelectorInput) {\n    super(data);\n    this.examplePrompt = data.examplePrompt;\n    this.maxLength = data.maxLength ?? 2048;\n    this.getTextLength = data.getTextLength ?? getLengthBased;\n  }\n\n  /**\n   * Adds an example to the list of examples and calculates its length.\n   * @param example The example to be added.\n   * @returns Promise that resolves when the example has been added and its length calculated.\n   */\n  async addExample(example: Example): Promise<void> {\n    this.examples.push(example);\n    const stringExample = await this.examplePrompt.format(example);\n    this.exampleTextLengths.push(this.getTextLength(stringExample));\n  }\n\n  /**\n   * Calculates the lengths of the examples.\n   * @param v Array of lengths of the examples.\n   * @param values Instance of LengthBasedExampleSelector.\n   * @returns Promise that resolves with an array of lengths of the examples.\n   */\n  async calculateExampleTextLengths(\n    v: number[],\n    values: LengthBasedExampleSelector\n  ): Promise<number[]> {\n    if (v.length > 0) {\n      return v;\n    }\n\n    const { examples, examplePrompt } = values;\n    const stringExamples = await Promise.all(\n      examples.map((eg: Example) => examplePrompt.format(eg))\n    );\n    return stringExamples.map((eg: string) => this.getTextLength(eg));\n  }\n\n  /**\n   * Selects examples until the total length of the selected examples\n   * reaches the maxLength.\n   * @param inputVariables The input variables for the examples.\n   * @returns Promise that resolves with an array of selected examples.\n   */\n  async selectExamples(inputVariables: Example): Promise<Example[]> {\n    const inputs = Object.values(inputVariables).join(\" \");\n    let remainingLength = this.maxLength - this.getTextLength(inputs);\n    let i = 0;\n    const examples: Example[] = [];\n\n    while (remainingLength > 0 && i < this.examples.length) {\n      const newLength = remainingLength - this.exampleTextLengths[i];\n      if (newLength < 0) {\n        break;\n      } else {\n        examples.push(this.examples[i]);\n        remainingLength = newLength;\n      }\n      i += 1;\n    }\n\n    return examples;\n  }\n\n  /**\n   * Creates a new instance of LengthBasedExampleSelector and adds a list of\n   * examples to it.\n   * @param examples Array of examples to be added.\n   * @param args Input parameters for the LengthBasedExampleSelector.\n   * @returns Promise that resolves with a new instance of LengthBasedExampleSelector with the examples added.\n   */\n  static async fromExamples(\n    examples: Example[],\n    args: LengthBasedExampleSelectorInput\n  ) {\n    const selector = new LengthBasedExampleSelector(args);\n    await Promise.all(examples.map((eg) => selector.addExample(eg)));\n    return selector;\n  }\n}\n"],"mappings":";;;;;AAOA,SAAS,eAAe,MAAsB;AAC5C,QAAO,KAAK,MAAM,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsD5B,IAAa,6BAAb,MAAa,mCAAmC,oBAAoB;CAClE,WAAgC,EAAE;CAElC;CAEA,gBAA0C;CAE1C,YAAY;CAEZ,qBAA+B,EAAE;CAEjC,YAAY,MAAuC;AACjD,QAAM,KAAK;AACX,OAAK,gBAAgB,KAAK;AAC1B,OAAK,YAAY,KAAK,aAAa;AACnC,OAAK,gBAAgB,KAAK,iBAAiB;;;;;;;CAQ7C,MAAM,WAAW,SAAiC;AAChD,OAAK,SAAS,KAAK,QAAQ;EAC3B,MAAM,gBAAgB,MAAM,KAAK,cAAc,OAAO,QAAQ;AAC9D,OAAK,mBAAmB,KAAK,KAAK,cAAc,cAAc,CAAC;;;;;;;;CASjE,MAAM,4BACJ,GACA,QACmB;AACnB,MAAI,EAAE,SAAS,EACb,QAAO;EAGT,MAAM,EAAE,UAAU,kBAAkB;AAIpC,UAAO,MAHsB,QAAQ,IACnC,SAAS,KAAK,OAAgB,cAAc,OAAO,GAAG,CAAC,CACxD,EACqB,KAAK,OAAe,KAAK,cAAc,GAAG,CAAC;;;;;;;;CASnE,MAAM,eAAe,gBAA6C;EAChE,MAAM,SAAS,OAAO,OAAO,eAAe,CAAC,KAAK,IAAI;EACtD,IAAI,kBAAkB,KAAK,YAAY,KAAK,cAAc,OAAO;EACjE,IAAI,IAAI;EACR,MAAM,WAAsB,EAAE;AAE9B,SAAO,kBAAkB,KAAK,IAAI,KAAK,SAAS,QAAQ;GACtD,MAAM,YAAY,kBAAkB,KAAK,mBAAmB;AAC5D,OAAI,YAAY,EACd;QACK;AACL,aAAS,KAAK,KAAK,SAAS,GAAG;AAC/B,sBAAkB;;AAEpB,QAAK;;AAGP,SAAO;;;;;;;;;CAUT,aAAa,aACX,UACA,MACA;EACA,MAAM,WAAW,IAAI,2BAA2B,KAAK;AACrD,QAAM,QAAQ,IAAI,SAAS,KAAK,OAAO,SAAS,WAAW,GAAG,CAAC,CAAC;AAChE,SAAO"}
+{"version":3,"file":"length_based.js","names":[],"sources":["../../src/example_selectors/length_based.ts"],"sourcesContent":["import { Example } from \"../prompts/base.js\";\nimport { BaseExampleSelector } from \"./base.js\";\nimport { PromptTemplate } from \"../prompts/prompt.js\";\n\n/**\n * Calculates the length of a text based on the number of words and lines.\n */\nfunction getLengthBased(text: string): number {\n  return text.split(/\\n| /).length;\n}\n\n/**\n * Interface for the input parameters of the LengthBasedExampleSelector\n * class.\n */\nexport interface LengthBasedExampleSelectorInput {\n  examplePrompt: PromptTemplate;\n  maxLength?: number;\n  getTextLength?: (text: string) => number;\n}\n\n/**\n * A specialized example selector that selects examples based on their\n * length, ensuring that the total length of the selected examples does\n * not exceed a specified maximum length.\n * @example\n * ```typescript\n * const exampleSelector = new LengthBasedExampleSelector(\n *   [\n *     { input: \"happy\", output: \"sad\" },\n *     { input: \"tall\", output: \"short\" },\n *     { input: \"energetic\", output: \"lethargic\" },\n *     { input: \"sunny\", output: \"gloomy\" },\n *     { input: \"windy\", output: \"calm\" },\n *   ],\n *   {\n *     examplePrompt: new PromptTemplate({\n *       inputVariables: [\"input\", \"output\"],\n *       template: \"Input: {input}\\nOutput: {output}\",\n *     }),\n *     maxLength: 25,\n *   },\n * );\n * const dynamicPrompt = new FewShotPromptTemplate({\n *   exampleSelector,\n *   examplePrompt: new PromptTemplate({\n *     inputVariables: [\"input\", \"output\"],\n *     template: \"Input: {input}\\nOutput: {output}\",\n *   }),\n *   prefix: \"Give the antonym of every input\",\n *   suffix: \"Input: {adjective}\\nOutput:\",\n *   inputVariables: [\"adjective\"],\n * });\n * console.log(dynamicPrompt.format({ adjective: \"big\" }));\n * console.log(\n *   dynamicPrompt.format({\n *     adjective:\n *       \"big and huge and massive and large and gigantic and tall and much much much much much bigger than everything else\",\n *   }),\n * );\n * ```\n */\nexport class LengthBasedExampleSelector extends BaseExampleSelector {\n  protected examples: Example[] = [];\n\n  examplePrompt!: PromptTemplate;\n\n  getTextLength: (text: string) => number = getLengthBased;\n\n  maxLength = 2048;\n\n  exampleTextLengths: number[] = [];\n\n  constructor(data: LengthBasedExampleSelectorInput) {\n    super(data);\n    this.examplePrompt = data.examplePrompt;\n    this.maxLength = data.maxLength ?? 2048;\n    this.getTextLength = data.getTextLength ?? getLengthBased;\n  }\n\n  /**\n   * Adds an example to the list of examples and calculates its length.\n   * @param example The example to be added.\n   * @returns Promise that resolves when the example has been added and its length calculated.\n   */\n  async addExample(example: Example): Promise<void> {\n    this.examples.push(example);\n    const stringExample = await this.examplePrompt.format(example);\n    this.exampleTextLengths.push(this.getTextLength(stringExample));\n  }\n\n  /**\n   * Calculates the lengths of the examples.\n   * @param v Array of lengths of the examples.\n   * @param values Instance of LengthBasedExampleSelector.\n   * @returns Promise that resolves with an array of lengths of the examples.\n   */\n  async calculateExampleTextLengths(\n    v: number[],\n    values: LengthBasedExampleSelector\n  ): Promise<number[]> {\n    if (v.length > 0) {\n      return v;\n    }\n\n    const { examples, examplePrompt } = values;\n    const stringExamples = await Promise.all(\n      examples.map((eg: Example) => examplePrompt.format(eg))\n    );\n    return stringExamples.map((eg: string) => this.getTextLength(eg));\n  }\n\n  /**\n   * Selects examples until the total length of the selected examples\n   * reaches the maxLength.\n   * @param inputVariables The input variables for the examples.\n   * @returns Promise that resolves with an array of selected examples.\n   */\n  async selectExamples(inputVariables: Example): Promise<Example[]> {\n    const inputs = Object.values(inputVariables).join(\" \");\n    let remainingLength = this.maxLength - this.getTextLength(inputs);\n    let i = 0;\n    const examples: Example[] = [];\n\n    while (remainingLength > 0 && i < this.examples.length) {\n      const newLength = remainingLength - this.exampleTextLengths[i];\n      if (newLength < 0) {\n        break;\n      } else {\n        examples.push(this.examples[i]);\n        remainingLength = newLength;\n      }\n      i += 1;\n    }\n\n    return examples;\n  }\n\n  /**\n   * Creates a new instance of LengthBasedExampleSelector and adds a list of\n   * examples to it.\n   * @param examples Array of examples to be added.\n   * @param args Input parameters for the LengthBasedExampleSelector.\n   * @returns Promise that resolves with a new instance of LengthBasedExampleSelector with the examples added.\n   */\n  static async fromExamples(\n    examples: Example[],\n    args: LengthBasedExampleSelectorInput\n  ) {\n    const selector = new LengthBasedExampleSelector(args);\n    await Promise.all(examples.map((eg) => selector.addExample(eg)));\n    return selector;\n  }\n}\n"],"mappings":";;;;;AAOA,SAAS,eAAe,MAAsB;CAC5C,OAAO,KAAK,MAAM,MAAM,CAAC,CAAC;AAC5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqDA,IAAa,6BAAb,MAAa,mCAAmC,oBAAoB;CAClE,WAAgC,CAAC;CAEjC;CAEA,gBAA0C;CAE1C,YAAY;CAEZ,qBAA+B,CAAC;CAEhC,YAAY,MAAuC;EACjD,MAAM,IAAI;EACV,KAAK,gBAAgB,KAAK;EAC1B,KAAK,YAAY,KAAK,aAAa;EACnC,KAAK,gBAAgB,KAAK,iBAAiB;CAC7C;;;;;;CAOA,MAAM,WAAW,SAAiC;EAChD,KAAK,SAAS,KAAK,OAAO;EAC1B,MAAM,gBAAgB,MAAM,KAAK,cAAc,OAAO,OAAO;EAC7D,KAAK,mBAAmB,KAAK,KAAK,cAAc,aAAa,CAAC;CAChE;;;;;;;CAQA,MAAM,4BACJ,GACA,QACmB;EACnB,IAAI,EAAE,SAAS,GACb,OAAO;EAGT,MAAM,EAAE,UAAU,kBAAkB;EAIpC,QAAO,MAHsB,QAAQ,IACnC,SAAS,KAAK,OAAgB,cAAc,OAAO,EAAE,CAAC,CACxD,EAAA,CACsB,KAAK,OAAe,KAAK,cAAc,EAAE,CAAC;CAClE;;;;;;;CAQA,MAAM,eAAe,gBAA6C;EAChE,MAAM,SAAS,OAAO,OAAO,cAAc,CAAC,CAAC,KAAK,GAAG;EACrD,IAAI,kBAAkB,KAAK,YAAY,KAAK,cAAc,MAAM;EAChE,IAAI,IAAI;EACR,MAAM,WAAsB,CAAC;EAE7B,OAAO,kBAAkB,KAAK,IAAI,KAAK,SAAS,QAAQ;GACtD,MAAM,YAAY,kBAAkB,KAAK,mBAAmB;GAC5D,IAAI,YAAY,GACd;QACK;IACL,SAAS,KAAK,KAAK,SAAS,EAAE;IAC9B,kBAAkB;GACpB;GACA,KAAK;EACP;EAEA,OAAO;CACT;;;;;;;;CASA,aAAa,aACX,UACA,MACA;EACA,MAAM,WAAW,IAAI,2BAA2B,IAAI;EACpD,MAAM,QAAQ,IAAI,SAAS,KAAK,OAAO,SAAS,WAAW,EAAE,CAAC,CAAC;EAC/D,OAAO;CACT;AACF"}

package/dist/example_selectors/semantic_similarity.cjs

@@ -103,8 +103,9 @@ var SemanticSimilarityExampleSelector = class SemanticSimilarityExampleSelector
 			...acc,
 			[key]: example[key]
 		}), {}) : example).join(" "));
+		const vectorStore = await vectorStoreCls.fromTexts(stringExamples, examples, embeddings, options);
 		return new SemanticSimilarityExampleSelector({
-			vectorStore: await vectorStoreCls.fromTexts(stringExamples, examples, embeddings, options),
+			vectorStore,
 			k: options.k ?? 4,
 			exampleKeys: options.exampleKeys,
 			inputKeys: options.inputKeys