@skillrecordings/cli 0.1.0 → 0.2.0

package/dist/chunk-MG37YDAK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../node_modules/.bun/@upstash+vector@1.2.2/node_modules/@upstash/vector/dist/nodejs.mjs","../../../node_modules/.bun/@upstash+vector@1.2.2/node_modules/@upstash/vector/dist/chunk-MQ3XJEJ2.mjs"],"sourcesContent":["import {\n  FusionAlgorithm,\n  HttpClient,\n  Index,\n  QueryMode,\n  VERSION,\n  WeightingStrategy\n} from \"./chunk-MQ3XJEJ2.mjs\";\n\n// src/utils/get-runtime.ts\nfunction getRuntime() {\n  if (typeof process === \"object\" && typeof process.versions == \"object\" && process.versions.bun)\n    return `bun@${process.versions.bun}`;\n  return typeof EdgeRuntime === \"string\" ? \"edge-light\" : `node@${process.version}`;\n}\n\n// src/platforms/nodejs.ts\nvar Index2 = class _Index extends Index {\n  constructor(configOrRequester) {\n    if (configOrRequester !== void 0 && \"request\" in configOrRequester) {\n      super(configOrRequester);\n      return;\n    }\n    const token = configOrRequester?.token ?? process.env.NEXT_PUBLIC_UPSTASH_VECTOR_REST_TOKEN ?? process.env.UPSTASH_VECTOR_REST_TOKEN;\n    const url = configOrRequester?.url ?? process.env.NEXT_PUBLIC_UPSTASH_VECTOR_REST_URL ?? process.env.UPSTASH_VECTOR_REST_URL;\n    if (!token) {\n      throw new Error(\"UPSTASH_VECTOR_REST_TOKEN is missing!\");\n    }\n    if (!url) {\n      throw new Error(\"UPSTASH_VECTOR_REST_URL is missing!\");\n    }\n    if (url.startsWith(\" \") || url.endsWith(\" \") || /\\r|\\n/.test(url)) {\n      console.warn(\"The vector url contains whitespace or newline, which can cause errors!\");\n    }\n    if (token.startsWith(\" \") || token.endsWith(\" \") || /\\r|\\n/.test(token)) {\n      console.warn(\"The vector token contains whitespace or newline, which can cause errors!\");\n    }\n    const enableTelemetry = process.env.UPSTASH_DISABLE_TELEMETRY ? false : configOrRequester?.enableTelemetry ?? true;\n    const telemetryHeaders = enableTelemetry ? {\n      \"Upstash-Telemetry-Sdk\": `upstash-vector-js@${VERSION}`,\n      \"Upstash-Telemetry-Platform\": process.env.VERCEL ? \"vercel\" : process.env.AWS_REGION ? \"aws\" : \"unknown\",\n      \"Upstash-Telemetry-Runtime\": getRuntime()\n    } : {};\n    const client = new HttpClient({\n      baseUrl: url,\n      retry: configOrRequester?.retry,\n      headers: { authorization: `Bearer ${token}`, ...telemetryHeaders },\n      cache: configOrRequester?.cache === false ? void 0 : configOrRequester?.cache || \"no-store\",\n      signal: configOrRequester?.signal\n    });\n    super(client);\n  }\n  /**\n   * Create a new Upstash Vector instance from environment variables.\n   *\n   * Use this to automatically load connection secrets from your environment\n   * variables. For instance when using the Vercel integration.\n   *\n   * When used on the Cloudflare Workers, you can just pass the \"env\" context provided by Cloudflare.\n   * Else, this tries to load `UPSTASH_VECTOR_REST_URL` and `UPSTASH_VECTOR_REST_TOKEN` from\n   * your environment using `process.env`.\n   */\n  static fromEnv(env, config) {\n    const url = env?.UPSTASH_VECTOR_REST_URL || process?.env.UPSTASH_VECTOR_REST_URL;\n    const token = env?.UPSTASH_VECTOR_REST_TOKEN || process?.env.UPSTASH_VECTOR_REST_TOKEN;\n    if (!url) {\n      throw new Error(\"Unable to find environment variable: `UPSTASH_VECTOR_REST_URL`\");\n    }\n    if (!token) {\n      throw new Error(\"Unable to find environment variable: `UPSTASH_VECTOR_REST_TOKEN`\");\n    }\n    return new _Index({ ...config, url, token });\n  }\n};\nexport {\n  FusionAlgorithm,\n  Index2 as Index,\n  QueryMode,\n  WeightingStrategy\n};\n","// src/error/index.ts\nvar UpstashError = class extends Error {\n  constructor(message) {\n    super(message);\n    this.name = \"UpstashError\";\n  }\n};\n\n// src/http/index.ts\nvar HttpClient = class {\n  baseUrl;\n  headers;\n  options;\n  retry;\n  constructor(config) {\n    this.options = {\n      cache: config.cache,\n      signal: config.signal\n    };\n    this.baseUrl = config.baseUrl.replace(/\\/$/, \"\");\n    this.headers = {\n      \"Content-Type\": \"application/json\",\n      ...config.headers\n    };\n    this.retry = typeof config?.retry === \"boolean\" && config?.retry === false ? {\n      attempts: 1,\n      backoff: () => 0\n    } : {\n      attempts: config?.retry?.retries ?? 5,\n      backoff: config?.retry?.backoff ?? ((retryCount) => Math.exp(retryCount) * 50)\n    };\n  }\n  async request(req) {\n    const signal = this.options.signal;\n    const isSignalFunction = typeof signal === \"function\";\n    const requestOptions = {\n      cache: this.options.cache,\n      method: \"POST\",\n      headers: this.headers,\n      body: JSON.stringify(req.body),\n      keepalive: true,\n      signal: isSignalFunction ? signal() : signal\n    };\n    let res = null;\n    let error = null;\n    for (let i = 0; i <= this.retry.attempts; i++) {\n      try {\n        res = await fetch([this.baseUrl, ...req.path ?? []].join(\"/\"), requestOptions);\n        break;\n      } catch (error_) {\n        if (requestOptions.signal?.aborted && isSignalFunction) {\n          throw error_;\n        } else if (requestOptions.signal?.aborted) {\n          const myBlob = new Blob([\n            JSON.stringify({ result: requestOptions.signal.reason ?? \"Aborted\" })\n          ]);\n          const myOptions = {\n            status: 200,\n            statusText: requestOptions.signal.reason ?? \"Aborted\"\n          };\n          res = new Response(myBlob, myOptions);\n          break;\n        }\n        error = error_;\n        if (i < this.retry.attempts) {\n          await new Promise((r) => setTimeout(r, this.retry.backoff(i)));\n        }\n      }\n    }\n    if (!res) {\n      throw error ?? new Error(\"Exhausted all retries\");\n    }\n    const body = await res.json();\n    if (!res.ok) {\n      throw new UpstashError(`${body.error}`);\n    }\n    return { result: body.result, error: body.error };\n  }\n};\n\n// src/commands/client/query/types.ts\nvar WeightingStrategy = /* @__PURE__ */ ((WeightingStrategy2) => {\n  WeightingStrategy2[\"IDF\"] = \"IDF\";\n  return WeightingStrategy2;\n})(WeightingStrategy || {});\nvar FusionAlgorithm = /* @__PURE__ */ ((FusionAlgorithm2) => {\n  FusionAlgorithm2[\"RRF\"] = \"RRF\";\n  FusionAlgorithm2[\"DBSF\"] = \"DBSF\";\n  return FusionAlgorithm2;\n})(FusionAlgorithm || {});\nvar QueryMode = /* @__PURE__ */ ((QueryMode2) => {\n  QueryMode2[\"HYBRID\"] = \"HYBRID\";\n  QueryMode2[\"DENSE\"] = \"DENSE\";\n  QueryMode2[\"SPARSE\"] = \"SPARSE\";\n  return QueryMode2;\n})(QueryMode || {});\n\n// src/commands/command.ts\nvar Command = class {\n  payload;\n  endpoint;\n  constructor(command, endpoint) {\n    this.payload = command;\n    this.endpoint = endpoint;\n  }\n  /**\n   * Execute the command using a client.\n   */\n  async exec(client) {\n    const { result, error } = await client.request({\n      body: this.payload,\n      path: [this.endpoint]\n    });\n    if (error) {\n      throw new UpstashError(error);\n    }\n    if (result === void 0) {\n      throw new TypeError(\"Request did not return a result\");\n    }\n    return result;\n  }\n};\n\n// src/commands/client/query/query-many/index.ts\nvar QueryManyCommand = class extends Command {\n  constructor(payload, options) {\n    let endpoint = \"query\";\n    const hasData = payload.some((p) => p.data);\n    endpoint = hasData ? \"query-data\" : \"query\";\n    if (options?.namespace) {\n      endpoint = `${endpoint}/${options.namespace}`;\n    }\n    super(payload, endpoint);\n  }\n};\n\n// src/commands/client/query/query-single/index.ts\nvar QueryCommand = class extends Command {\n  constructor(payload, options) {\n    let endpoint = \"query\";\n    if (\"data\" in payload) {\n      endpoint = \"query-data\";\n    } else if (!payload.vector && !payload.sparseVector) {\n      throw new UpstashError(\"Either data, vector or sparseVector should be provided.\");\n    }\n    if (options?.namespace) {\n      endpoint = `${endpoint}/${options.namespace}`;\n    }\n    super(payload, endpoint);\n  }\n};\n\n// src/commands/client/delete/index.ts\nvar DeleteCommand = class extends Command {\n  constructor(payload, options) {\n    let endpoint = \"delete\";\n    if (options?.namespace) {\n      endpoint = `${endpoint}/${options.namespace}`;\n    }\n    if (typeof payload === \"string\" || typeof payload === \"number\") {\n      super(\n        {\n          ids: [payload]\n        },\n        endpoint\n      );\n    } else if (Array.isArray(payload)) {\n      super(\n        {\n          ids: payload\n        },\n        endpoint\n      );\n    } else if (typeof payload === \"object\") {\n      super(payload, endpoint);\n    }\n  }\n};\n\n// src/commands/client/upsert/index.ts\nvar UpsertCommand = class extends Command {\n  constructor(payload, opts) {\n    let endpoint = \"upsert\";\n    if (Array.isArray(payload)) {\n      const isUpsert = payload.some((p) => isVectorPayload(p));\n      endpoint = isUpsert ? \"upsert\" : \"upsert-data\";\n    } else {\n      endpoint = isVectorPayload(payload) ? \"upsert\" : \"upsert-data\";\n    }\n    if (opts?.namespace) {\n      endpoint = `${endpoint}/${opts.namespace}`;\n    }\n    super(payload, endpoint);\n  }\n};\nvar isVectorPayload = (payload) => {\n  return \"vector\" in payload || \"sparseVector\" in payload;\n};\n\n// src/commands/client/fetch/index.ts\nvar FetchCommand = class extends Command {\n  constructor([payload, opts]) {\n    let endpoint = \"fetch\";\n    if (opts?.namespace) {\n      endpoint = `${endpoint}/${opts.namespace}`;\n      delete opts.namespace;\n    }\n    if (Array.isArray(payload)) {\n      super({ ids: payload, ...opts }, endpoint);\n    } else if (typeof payload === \"object\") {\n      super({ ...payload, ...opts }, endpoint);\n    } else {\n      throw new Error(\"Invalid payload\");\n    }\n  }\n};\n\n// src/commands/client/range/index.ts\nvar RangeCommand = class extends Command {\n  constructor(payload, options) {\n    let endpoint = \"range\";\n    if (options?.namespace) {\n      endpoint = `${endpoint}/${options.namespace}`;\n    }\n    super(payload, endpoint);\n  }\n};\n\n// src/commands/client/reset/index.ts\nvar ResetCommand = class extends Command {\n  constructor(options) {\n    let endpoint = \"reset\";\n    if (options?.namespace) {\n      endpoint = `${endpoint}/${options.namespace}`;\n    } else if (options?.all) {\n      endpoint = `${endpoint}?all`;\n    }\n    super([], endpoint);\n  }\n};\n\n// src/commands/client/info/index.ts\nvar InfoCommand = class extends Command {\n  constructor() {\n    const endpoint = \"info\";\n    super([], endpoint);\n  }\n};\n\n// src/commands/client/resumable-query/resume.ts\nvar ResumeQueryCommand = class extends Command {\n  constructor(payload) {\n    super(payload, \"resumable-query-next\");\n  }\n};\n\n// src/commands/client/resumable-query/start.ts\nvar StartResumableQueryCommand = class extends Command {\n  constructor(payload, namespace) {\n    let endpoint = \"resumable-query\";\n    if (\"data\" in payload) {\n      endpoint = \"resumable-query-data\";\n    }\n    if (namespace) {\n      endpoint = `${endpoint}/${namespace}`;\n    }\n    super(payload, endpoint);\n  }\n};\n\n// src/commands/client/resumable-query/stop.ts\nvar StopResumableQueryCommand = class extends Command {\n  constructor(payload) {\n    super(payload, \"resumable-query-end\");\n  }\n};\n\n// src/commands/client/resumable-query/index.ts\nvar ResumableQuery = class {\n  uuid;\n  start;\n  fetchNext;\n  stop;\n  constructor(payload, client, namespace) {\n    this.start = async () => {\n      const result = await new StartResumableQueryCommand(payload, namespace).exec(\n        client\n      );\n      this.uuid = result.uuid;\n      return result;\n    };\n    this.fetchNext = (additionalK) => {\n      if (!this.uuid) {\n        throw new Error(\n          \"The resumable query has already been stopped. Please start another resumable query.\"\n        );\n      }\n      return new ResumeQueryCommand({ uuid: this.uuid, additionalK }).exec(client);\n    };\n    this.stop = async () => {\n      if (!this.uuid) {\n        throw new Error(\"Resumable query has not been started. Call start() first.\");\n      }\n      const result = await new StopResumableQueryCommand({ uuid: this.uuid }).exec(client);\n      this.uuid = \"\";\n      return result;\n    };\n  }\n};\n\n// src/commands/client/namespace/index.ts\nvar Namespace = class {\n  client;\n  namespace;\n  /**\n   * Create a new index namespace client\n   *\n   * @example\n   * ```typescript\n   * const index = new Index({\n   *  url: \"<UPSTASH_VECTOR_REST_URL>\",\n   *  token: \"<UPSTASH_VECTOR_REST_TOKEN>\",\n   * });\n   *\n   * const namespace = index.namespace(\"ns\");\n   * ```\n   */\n  constructor(client, namespace) {\n    this.client = client;\n    this.namespace = namespace;\n  }\n  /**\n   * Upserts (Updates and Inserts) specific items into the index namespace.\n   * It's used for adding new items to the index namespace or updating existing ones.\n   *\n   * @example\n   * ```js\n   * const upsertArgs = {\n   *   id: '123',\n   *   vector: [0.42, 0.87, ...],\n   *   metadata: { property1: 'value1', property2: 'value2' }\n   * };\n   * const upsertResult = await index.namespace(\"ns\").upsert(upsertArgs);\n   * console.log(upsertResult); // Outputs the result of the upsert operation\n   * ```\n   *\n   * @param {CommandArgs<typeof UpsertCommand>} args - The arguments for the upsert command.\n   * @param {number|string} args.id - The unique identifier for the item being upserted.\n   * @param {number[]} args.vector - The feature vector associated with the item.\n   * @param {Dict} [args.metadata] - Optional metadata to be associated with the item.\n   *\n   * @returns {string} A promise that resolves with the result of the upsert operation after the command is executed.\n   */\n  upsert = (args) => new UpsertCommand(args, { namespace: this.namespace }).exec(this.client);\n  /*\n   * Updates specific items in the index.\n   * It's used for updating existing items in the index.\n   *\n   * @example\n   * ```js\n   * const updateArgs = {\n   *   id: '123',\n   *   metadata: { updatedProperty: 'value1' }\n   * };\n   * const updateResult = await index.update(updateArgs);\n   * console.log(updateResult); // Outputs the result of the update operation\n   * ```\n   *\n   * @param {CommandArgs<typeof UpdateCommand>} args - The arguments for the update command.\n   * @param {number|string} args.id - The unique identifier for the item being updated.\n   * @param {number[]} args.vector - The feature vector associated with the item.\n   * @param {Record<string, unknown>} [args.metadata] - Optional metadata to be associated with the item.\n   *\n   * @returns {Promise<{updated: number}>} A promise that returns the number of items successfully updated.\n   */\n  update = (args) => new UpdateCommand(args, { namespace: this.namespace }).exec(this.client);\n  /**\n   * Fetches specific items from the index by their IDs or by an id prefix.\n   *\n   * Note: While using id prefix, the paginated `range` command is recommended to prevent timeouts on large result sets.\n   *\n   * @example\n   * ```js\n   * // Using ids\n   * await index.namespace(\"ns\").fetch([\"test-1\", \"test-2\"], { includeMetadata: true });\n   *\n   * // Using id prefix\n   * await index.namespace(\"ns\").fetch({ prefix: \"test-\" });\n   * ```\n   *\n   * @param {...CommandArgs<typeof FetchCommand>} args - The arguments for the fetch command.\n   * @param {FetchPayload} args[0] - An array of IDs or the id prefix of the items to be fetched.\n   * @param {FetchCommandOptions} args[1] - Options for the fetch operation.\n   * @param {boolean} [args[1].includeMetadata=false] - Optionally include metadata of the fetched items.\n   * @param {boolean} [args[1].includeVectors=false] - Optionally include feature vectors of the fetched items.\n   * @param {string} [args[1].namespace = \"\"] - The namespace of the index to fetch items from.\n   *\n   * @returns {Promise<FetchReturnResponse<TMetadata>[]>} A promise that resolves with an array of fetched items or null if not found, after the command is executed.\n   */\n  fetch = (...args) => {\n    if (args[1]) {\n      args[1].namespace = this.namespace;\n    } else {\n      args[1] = { namespace: this.namespace };\n    }\n    return new FetchCommand(args).exec(this.client);\n  };\n  /**\n   * Queries an index namespace with specified parameters.\n   * This method creates and executes a query command on an index based on the provided arguments.\n   *\n   * @example\n   * ```js\n   * await index.namespace(\"ns\").query({\n   *  topK: 3,\n   *  vector: [ 0.22, 0.66 ],\n   *  filter: \"age >= 23 and (type = \\'turtle\\' OR type = \\'cat\\')\"\n   * });\n   * ```\n   *\n   * @param {Object} args - The arguments for the query command.\n   * @param {number[]} args.vector - An array of numbers representing the feature vector for the query.\n   *                                This vector is utilized to find the most relevant items in the index.\n   * @param {number} args.topK - The desired number of top results to be returned, based on relevance or similarity to the query vector.\n   * @param {string} [args.filter] - An optional filter string to be used in the query. The filter string is used to narrow down the query results.\n   * @param {boolean} [args.includeVectors=false] - When set to true, includes the feature vectors of the returned items in the response.\n   * @param {boolean} [args.includeMetadata=false] - When set to true, includes additional metadata of the returned items in the response.\n   *\n   * @returns A promise that resolves with an array of query result objects when the request to query the index is completed.\n   */\n  query = (args) => new QueryCommand(args, { namespace: this.namespace }).exec(this.client);\n  /**\n   * Initializes a resumable query operation on the vector database.\n   * This method allows for querying large result sets in multiple chunks or implementing pagination.\n   *\n   * @template TMetadata\n   * @param {ResumableQueryPayload} args - The arguments for the resumable query.\n   * @param {number} args.maxIdle - The maximum idle time in seconds before the query session expires.\n   * @param {number} args.topK - The number of top results to return in each fetch operation.\n   * @param {number[]} args.vector - The query vector used for similarity search.\n   * @param {boolean} [args.includeMetadata] - Whether to include metadata in the query results.\n   * @param {boolean} [args.includeVectors] - Whether to include vectors in the query results.\n   * @param {Object} [options] - Additional options for the query.\n   * @returns {Promise<ResumableQuery<TMetadata>>} A promise that resolves to a ResumableQuery object.\n   * @example\n   * const { result, fetchNext, stop } = await index.namespace(\"ns\").resumableQuery({\n   *   maxIdle: 3600,\n   *   topK: 50,\n   *   vector: [0.1, 0.2, 0.3, ...],\n   *   includeMetadata: true,\n   *   includeVectors: true\n   * }, { namespace: 'my-namespace' });\n   *\n   * const firstBatch = await fetchNext(10);\n   * const secondBatch = await fetchNext(10);\n   * await stop(); // End the query session\n   */\n  resumableQuery = async (args) => {\n    const resumableQuery = new ResumableQuery(args, this.client, this.namespace);\n    const initialQuery = await resumableQuery.start();\n    const { fetchNext, stop } = resumableQuery;\n    return { fetchNext, stop, result: initialQuery.scores };\n  };\n  /**\n     * Deletes items from the index namespace by id, by id prefix, or by filter.\n     *\n     * @example\n     * ```js\n     * // Delete by id\n     * await index.namespace(\"ns\").delete(\"test-id\");\n  \n     * // Delete by ids\n     * await index.namespace(\"ns\").delete([\"test-id1\", \"test-id2\"]);\n  \n     * // Delete by id prefix\n     * await index.namespace(\"ns\").delete({ prefix: \"test-\" });\n  \n     * // Delete by filter\n     * await index.namespace(\"ns\").delete({ filter: \"age >= 23\" });\n     * ```\n     *\n     * @param args - A single id, an array of ids, a prefix, or a filter to delete items from the index.\n     * @returns Number of deleted vectors in the format `{ deleted: number }`.If no vectors are deleted, returns `{ deleted: 0 }`.\n     */\n  delete = (args) => new DeleteCommand(args, { namespace: this.namespace }).exec(this.client);\n  /**\n   * Retrieves a paginated range of items from the index. Optionally filter results by an id prefix.\n   * Returns items in batches with a cursor for pagination.\n   *\n   * @example\n   * ```js\n   * const args = {\n   *   limit: 10,\n   *   includeVectors: true,\n   *   includeMetadata: false\n   * };\n   * await index.namespace(\"ns\").range(args);\n   *\n   * // Use the cursor to get the next page of results\n   * const nextPage = await index.namespace(\"ns\").range({\n   *   // You have to pass the arguments from the first call\n   *   ...args,\n   *   cursor: rangeResult.nextCursor,\n   * });\n   * ```\n   *\n   * @param {CommandArgs<typeof RangeCommand>} args - The arguments for the range command.\n   * @param {string} [args.prefix] - The prefix of the items to be fetched.\n   * @param {number|string} args.cursor - The starting point (cursor) for the range query.\n   * @param {number} args.limit - The maximum number of items to return in this range.\n   * @param {boolean} [args.includeVectors=false] - Optionally include the feature vectors of the items in the response.\n   * @param {boolean} [args.includeMetadata=false] - Optionally include additional metadata of the items in the response.\n   *\n   * @returns {Promise<RangeReturnResponse<TMetadata>>} A promise that resolves with the response containing the next cursor and an array of vectors, after the command is executed.\n   */\n  range = (args) => new RangeCommand(args, { namespace: this.namespace }).exec(this.client);\n  /**\n   * It's used for wiping all the vectors in a index namespace.\n   *\n   * @example\n   * ```js\n   * await index.namespace(\"ns\").reset();\n   * console.log('Index namespace has been reset');\n   * ```\n   *\n   * @returns {Promise<string>} A promise that resolves with the result of the reset operation after the command is executed.\n   */\n  reset = () => new ResetCommand({ namespace: this.namespace }).exec(this.client);\n};\n\n// src/commands/client/update/index.ts\nvar UpdateCommand = class extends Command {\n  constructor(payload, opts) {\n    let endpoint = \"update\";\n    if (opts?.namespace) {\n      endpoint = `${endpoint}/${opts.namespace}`;\n    }\n    super(payload, endpoint);\n  }\n};\n\n// src/commands/management/namespaces/list/index.ts\nvar ListNamespacesCommand = class extends Command {\n  constructor() {\n    const endpoint = \"list-namespaces\";\n    super([], endpoint);\n  }\n};\n\n// src/commands/management/namespaces/delete/index.ts\nvar DeleteNamespaceCommand = class extends Command {\n  constructor(namespace) {\n    const endpoint = `delete-namespace/${namespace}`;\n    super([], endpoint);\n  }\n};\n\n// src/vector.ts\nvar Index = class {\n  client;\n  /**\n   * Create a new vector db client\n   *\n   * @example\n   * ```typescript\n   * const index = new Index({\n   *  url: \"<UPSTASH_VECTOR_REST_URL>\",\n   *  token: \"<UPSTASH_VECTOR_REST_TOKEN>\",\n   * });\n   * ```\n   */\n  constructor(client) {\n    this.client = client;\n  }\n  namespace = (namespace) => new Namespace(this.client, namespace);\n  /**\n     * Deletes items from the index by id, by id prefix, or by filter.\n     *\n     * @example\n     * ```js\n     * // Delete by id\n     * await index.delete(\"test-id\");\n  \n     * // Delete by ids\n     * await index.delete([\"test-id1\", \"test-id2\"]);\n  \n     * // Delete by id prefix\n     * await index.delete({ prefix: \"test-\" });\n  \n     * // Delete by filter\n     * await index.delete({ filter: \"age >= 23\" });\n     * ```\n     *\n     * @param args - A single id, an array of ids, a prefix, or a filter to delete items from the index.\n     * @returns Number of deleted vectors in the format `{ deleted: number }`.If no vectors are deleted, returns `{ deleted: 0 }`.\n     */\n  delete = (args, options) => new DeleteCommand(args, options).exec(this.client);\n  /**\n   * Queries an index with specified parameters.\n   * This method creates and executes a query command on an index based on the provided arguments.\n   *\n   * @example\n   * ```js\n   * await index.query({\n   *  topK: 3,\n   *  vector: [ 0.22, 0.66 ],\n   *  filter: \"age >= 23 and (type = \\'turtle\\' OR type = \\'cat\\')\"\n   * });\n   * ```\n   *\n   * @param {Object} args - The arguments for the query command.\n   * @param {number[]} args.vector - An array of numbers representing the feature vector for the query.\n   *                                This vector is utilized to find the most relevant items in the index.\n   * @param {number} args.topK - The desired number of top results to be returned, based on relevance or similarity to the query vector.\n   * @param {string} [args.filter] - An optional filter string to be used in the query. The filter string is used to narrow down the query results.\n   * @param {boolean} [args.includeVectors=false] - When set to true, includes the feature vectors of the returned items in the response.\n   * @param {boolean} [args.includeMetadata=false] - When set to true, includes additional metadata of the returned items in the response.\n   * @param {boolean} [args.includeData=false] - When set to true, includes data - string - of the returned items in the response.\n   *\n   *  A promise that resolves with an array of query result objects when the request to query the index is completed.\n   */\n  query = (args, options) => new QueryCommand(args, options).exec(this.client);\n  /**\n   * Queries an index with specified parameters.\n   * This method creates and executes a query command on an index based on the provided arguments.\n   *\n   * @example\n   * ```js\n   * await index.queryMany([\n   * {\n   *     topK: 3,\n   *     vector: [0.22, 0.66],\n   *     filter: \"age >= 23 and (type = 'turtle' OR type = 'cat')\",\n   * },\n   * {\n   *     topK: 3,\n   *     vector: [0.45, 0.52],\n   *     filter: \"age >= 27 and (type = 'rabbit' OR type = 'dog')\",\n   * },\n   * ]);\n   *\n   * ```\n   *\n   * @param {Object} args - The arguments for the query command.\n   * @param {number[]} args.vector - An array of numbers representing the feature vector for the query.\n   *                                This vector is utilized to find the most relevant items in the index.\n   * @param {number} args.topK - The desired number of top results to be returned, based on relevance or similarity to the query vector.\n   * @param {string} [args.filter] - An optional filter string to be used in the query. The filter string is used to narrow down the query results.\n   * @param {boolean} [args.includeVectors=false] - When set to true, includes the feature vectors of the returned items in the response.\n   * @param {boolean} [args.includeMetadata=false] - When set to true, includes additional metadata of the returned items in the response.\n   * @param {boolean} [args.includeData=false] - When set to true, includes data - string - of the returned items in the response.\n   *\n   *  A promise that resolves with an array of arrays of query result objects,\n   *  where each inner array represents a group of results matching a specific query condition.\n   */\n  queryMany = (args, options) => new QueryManyCommand(args, options).exec(this.client);\n  /**\n   * Initializes a resumable query operation on the vector database.\n   * This method allows for querying large result sets in multiple chunks or implementing pagination.\n   *\n   * @template TMetadata\n   * @param {ResumableQueryPayload} args - The arguments for the resumable query.\n   * @param {number} args.maxIdle - The maximum idle time in seconds before the query session expires.\n   * @param {number} args.topK - The number of top results to return in each fetch operation.\n   * @param {number[]} args.vector - The query vector used for similarity search.\n   * @param {boolean} [args.includeMetadata] - Whether to include metadata in the query results.\n   * @param {boolean} [args.includeVectors] - Whether to include vectors in the query results.\n   * @param {Object} [options] - Additional options for the query.\n   * @param {string} [options.namespace] - The namespace to query within.\n   * @returns {Promise<ResumableQuery<TMetadata>>} A promise that resolves to a ResumableQuery object.\n   * @example\n   * const { result, fetchNext, stop } = await index.resumableQuery({\n   *   maxIdle: 3600,\n   *   topK: 50,\n   *   vector: [0.1, 0.2, 0.3, ...],\n   *   includeMetadata: true,\n   *   includeVectors: true\n   * }, { namespace: 'my-namespace' });\n   *\n   * const firstBatch = await fetchNext(10);\n   * const secondBatch = await fetchNext(10);\n   * await stop(); // End the query session\n   */\n  resumableQuery = async (args, options) => {\n    const resumableQuery = new ResumableQuery(args, this.client, options?.namespace);\n    const initialQuery = await resumableQuery.start();\n    const { fetchNext, stop } = resumableQuery;\n    return { fetchNext, stop, result: initialQuery.scores };\n  };\n  /**\n   * Upserts (Updates and Inserts) specific items into the index.\n   * It's used for adding new items to the index or updating existing ones.\n   *\n   * @example\n   * ```js\n   * const upsertArgs = {\n   *   id: '123',\n   *   vector: [0.42, 0.87, ...],\n   *   metadata: { property1: 'value1', property2: 'value2' }\n   * };\n   * const upsertResult = await index.upsert(upsertArgs);\n   * console.log(upsertResult); // Outputs the result of the upsert operation\n   * ```\n   *\n   * @param {CommandArgs<typeof UpsertCommand>} args - The arguments for the upsert command.\n   * @param {number|string} args.id - The unique identifier for the item being upserted.\n   * @param {number[]} args.vector - The feature vector associated with the item.\n   * @param {Record<string, unknown>} [args.metadata] - Optional metadata to be associated with the item.\n   *\n   * @returns {string} A promise that resolves with the result of the upsert operation after the command is executed.\n   */\n  upsert = (args, options) => new UpsertCommand(args, options).exec(this.client);\n  /*\n   * Updates specific items in the index.\n   * It's used for updating existing items in the index.\n   *\n   * @example\n   * ```js\n   * const updateArgs = {\n   *   id: '123',\n   *   vector: [0.42, 0.87, ...],\n   *   metadata: { property1: 'value1', property2: 'value2' }\n   * };\n   * const updateResult = await index.update(updateArgs);\n   * console.log(updateResult); // Outputs the result of the update operation\n   * ```\n   *\n   * @param {CommandArgs<typeof UpdateCommand>} args - The arguments for the update command.\n   * @param {number|string} args.id - The unique identifier for the item being updated.\n   * @param {number[]} args.vector - The feature vector associated with the item.\n   * @param {Record<string, unknown>} [args.metadata] - Optional metadata to be associated with the item.\n   * @param {string} [args.namespace] - The namespace to update the item in.\n   *\n   * @returns {Promise<{updated: number}>} A promise that returns the number of items successfully updated.\n   */\n  update = (args, options) => new UpdateCommand(args, options).exec(this.client);\n  /**\n   * Fetches specific items from the index by their IDs or by an id prefix.\n   *\n   * Note: While using id prefix, the paginated `range` command is recommended to prevent timeouts on large result sets.\n   *\n   * @example\n   * ```js\n   * // Using ids\n   * await index.fetch([\"test-1\", \"test-2\"], { includeMetadata: true });\n   *\n   * // Using id prefix\n   * await index.fetch({ prefix: \"test-\" });\n   * ```\n   *\n   * @param {...CommandArgs<typeof FetchCommand>} args - The arguments for the fetch command.\n   * @param {FetchPayload} args[0] - An array of IDs or the id prefix of the items to be fetched.\n   * @param {FetchCommandOptions} args[1] - Options for the fetch operation.\n   * @param {boolean} [args[1].includeMetadata=false] - Optionally include metadata of the fetched items.\n   * @param {boolean} [args[1].includeVectors=false] - Optionally include feature vectors of the fetched items.\n   * @param {string} [args[1].namespace = \"\"] - The namespace of the index to fetch items from.\n   *\n   * @returns {Promise<FetchReturnResponse<TMetadata>[]>} A promise that resolves with an array of fetched items or null if not found, after the command is executed.\n   */\n  fetch = (...args) => new FetchCommand(args).exec(this.client);\n  /**\n   * It's used for wiping the index.\n   *\n   * By default, resets the default namespace:\n   *\n   * @example\n   * ```js\n   * await index.reset();\n   * console.log('Default namespace has been reset');\n   * ```\n   *\n   * To reset a namespace, call reset like:\n   *\n   * @example\n   * ```js\n   * await index.reset({ namespace: \"ns\" });\n   * console.log('Namespace ns has been reset');\n   * ```\n   *\n   * If you want to reset all namespaces, call reset like:\n   *\n   * @example\n   * ```js\n   * await index.reset({ all: true });\n   * console.log('All namespaces have been reset');\n   * ```\n   *\n   * @returns {Promise<string>} A promise that resolves with the result of the reset operation after the command is executed.\n   */\n  reset = (options) => new ResetCommand(options).exec(this.client);\n  /**\n   * Retrieves a paginated range of items from the index. Optionally filter results by an id prefix.\n   * Returns items in batches with a cursor for pagination.\n   *\n   * @example\n   * ```js\n   * const args = {\n   *   limit: 10,\n   *   includeVectors: true,\n   *   includeMetadata: false\n   * };\n   * await index.range(args);\n   *\n   * // Use the cursor to get the next page of results\n   * const nextPage = await index.range({\n   *   // You have to pass the arguments from the first call\n   *   ...args,\n   *   cursor: rangeResult.nextCursor,\n   * });\n   * ```\n   *\n   * @param {CommandArgs<typeof RangeCommand>} args - The arguments for the range command.\n   * @param {string} [args.prefix] - The prefix of the items to be fetched.\n   * @param {number|string} args.cursor - The starting point (cursor) for the range query.\n   * @param {number} args.limit - The maximum number of items to return in this range.\n   * @param {boolean} [args.includeVectors=false] - Optionally include the feature vectors of the items in the response.\n   * @param {boolean} [args.includeMetadata=false] - Optionally include additional metadata of the items in the response.\n   *\n   * @returns {Promise<RangeReturnResponse<TMetadata>>} A promise that resolves with the response containing the next cursor and an array of vectors, after the command is executed.\n   */\n  range = (args, options) => new RangeCommand(args, options).exec(this.client);\n  /**\n   * Retrieves info from the index.\n   *\n   * @example\n   * ```js\n   * const infoResults = await index.info();\n   * console.log(infoResults); // Outputs the result of the info operation\n   * ```\n   *\n   * @returns {Promise<InfoResult>} A promise that resolves with the response containing the vectorCount, pendingVectorCount, indexSize, dimension count and similarity algorithm after the command is executed.\n   */\n  info = () => new InfoCommand().exec(this.client);\n  /**\n   * List all namespaces in the vector database.\n   *\n   * @example\n   * ```js\n   * const namespaces = await index.listNamespaces();\n   * console.log(namespaces); // Outputs the list of namespaces\n   * ```\n   *\n   * @returns {Promise<string[]>} A promise that resolves with an array of namespaces after the command is executed.\n   */\n  listNamespaces = () => new ListNamespacesCommand().exec(this.client);\n  /**\n   * Deletes a namespace from the vector database.\n   *\n   * @example\n   * ```js\n   * await index.deleteNamespace('namespace');\n   * console.log('Namespace has been deleted');\n   * ```\n   *\n   * @param {string} namespace - The name of the namespace to be deleted.\n   * @returns {Promise<string>} A promise that resolves with the result of the delete operation after the command is executed.\n   */\n  deleteNamespace = (namespace) => new DeleteNamespaceCommand(namespace).exec(this.client);\n};\n\n// version.ts\nvar VERSION = \"v1.2.2\";\n\nexport {\n  HttpClient,\n  WeightingStrategy,\n  FusionAlgorithm,\n  QueryMode,\n  Index,\n  VERSION\n};\n"],"mappings":"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","names":[]}

package/dist/chunk-MLNDSBZ4.js

@@ -0,0 +1,482 @@
+import {
+  Index2
+} from "./chunk-MG37YDAK.js";
+import {
+  init_esm_shims
+} from "./chunk-WFANXVQG.js";
+
+// ../memory/src/decay.ts
+init_esm_shims();
+var DECAY_HALF_LIFE_DAYS = 30;
+function calculateDecay(createdAt, lastValidatedAt) {
+  const referenceDate = lastValidatedAt || createdAt;
+  const ageDays = (Date.now() - referenceDate.getTime()) / (24 * 60 * 60 * 1e3);
+  return Math.pow(0.5, ageDays / DECAY_HALF_LIFE_DAYS);
+}
+function calculateConfidence(memory) {
+  const decay = calculateDecay(
+    new Date(memory.metadata.created_at),
+    memory.metadata.last_validated_at ? new Date(memory.metadata.last_validated_at) : void 0
+  );
+  const votes = memory.metadata.votes;
+  const totalVotes = votes.upvotes + votes.downvotes;
+  const voteScore = totalVotes > 0 ? (votes.upvotes - votes.downvotes) / totalVotes : 0;
+  const citationScore = votes.citations > 0 ? votes.success_rate : 0.5;
+  const reputationWeight = Math.min(totalVotes + votes.citations, 10) / 10;
+  const reputation = (voteScore * 0.3 + citationScore * 0.7) * reputationWeight + (1 - reputationWeight) * 0.5;
+  return decay * reputation;
+}
+
+// ../memory/src/client.ts
+init_esm_shims();
+var _index = null;
+function getVectorIndex() {
+  if (!_index) {
+    const url = process.env.UPSTASH_VECTOR_REST_URL;
+    const token = process.env.UPSTASH_VECTOR_REST_TOKEN;
+    if (!url) {
+      throw new Error(
+        "UPSTASH_VECTOR_REST_URL environment variable is required"
+      );
+    }
+    if (!token) {
+      throw new Error(
+        "UPSTASH_VECTOR_REST_TOKEN environment variable is required"
+      );
+    }
+    _index = new Index2({
+      url,
+      token
+    });
+  }
+  return _index;
+}
+async function upsertMemory(memory) {
+  const index = getVectorIndex();
+  return index.upsert(
+    {
+      id: memory.id,
+      data: memory.content,
+      // Upstash generates embedding from data string
+      metadata: memory.metadata
+    },
+    { namespace: memory.metadata.collection }
+  );
+}
+async function queryMemories(options) {
+  const index = getVectorIndex();
+  const { query, collection, topK = 10, filter } = options;
+  const results = await index.query(
+    {
+      data: query,
+      // Upstash generates embedding from query string
+      topK,
+      includeMetadata: true,
+      ...filter && { filter }
+    },
+    { namespace: collection }
+  );
+  return results.map((result) => ({
+    id: String(result.id),
+    score: result.score,
+    metadata: result.metadata
+  }));
+}
+async function deleteMemory(id, collection) {
+  const index = getVectorIndex();
+  await index.delete(id, { namespace: collection });
+}
+async function fetchMemory(id, collection) {
+  const index = getVectorIndex();
+  const results = await index.fetch([id], {
+    namespace: collection,
+    includeMetadata: true,
+    includeData: true
+  });
+  if (results.length === 0) {
+    return null;
+  }
+  const result = results[0];
+  if (!result) {
+    return null;
+  }
+  return {
+    id: String(result.id),
+    content: String(result.data),
+    metadata: result.metadata
+  };
+}
+
+// ../memory/src/memory.ts
+init_esm_shims();
+import { randomUUID } from "crypto";
+var MemoryService = {
+  /**
+   * Store a new memory with embedding generation
+   *
+   * @param content - The memory content to store
+   * @param metadata - Memory metadata (collection and source required)
+   * @returns The created memory with generated ID and timestamps
+   */
+  async store(content, metadata) {
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const memory = {
+      id: randomUUID(),
+      content,
+      metadata: {
+        collection: metadata.collection,
+        source: metadata.source,
+        app_slug: metadata.app_slug,
+        tags: metadata.tags ?? [],
+        confidence: metadata.confidence ?? 1,
+        created_at: metadata.created_at ?? now,
+        last_validated_at: metadata.last_validated_at,
+        votes: metadata.votes ?? {
+          upvotes: 0,
+          downvotes: 0,
+          citations: 0,
+          success_rate: 0
+        }
+      }
+    };
+    await upsertMemory(memory);
+    return memory;
+  },
+  /**
+   * Find memories by semantic similarity
+   *
+   * Queries the vector index, fetches full memory data, calculates
+   * confidence with time decay, filters by threshold, and sorts by final score.
+   *
+   * @param query - Search query text
+   * @param options - Search options including filters and limits
+   * @returns Array of search results with decay-adjusted scores
+   */
+  async find(query, options) {
+    const {
+      collection,
+      limit = 10,
+      threshold = 0.5,
+      app_slug,
+      tags,
+      include_stale = false
+    } = options;
+    let filter;
+    if (app_slug || tags) {
+      const filters = [];
+      if (app_slug) {
+        filters.push(`app_slug = "${app_slug}"`);
+      }
+      if (tags && tags.length > 0) {
+        tags.forEach((tag) => {
+          filters.push(`tags[*] = "${tag}"`);
+        });
+      }
+      filter = filters.join(" AND ");
+    }
+    const queryResults = await queryMemories({
+      query,
+      collection,
+      topK: limit * 2,
+      // Over-fetch to account for filtering
+      filter
+    });
+    const results = [];
+    for (const result of queryResults) {
+      const memory = await fetchMemory(result.id, collection);
+      if (!memory) continue;
+      const confidence = calculateConfidence(memory);
+      if (!include_stale && confidence < 0.25) continue;
+      const createdAt = new Date(memory.metadata.created_at);
+      const lastValidatedAt = memory.metadata.last_validated_at ? new Date(memory.metadata.last_validated_at) : void 0;
+      const referenceDate = lastValidatedAt || createdAt;
+      const ageDays = (Date.now() - referenceDate.getTime()) / (24 * 60 * 60 * 1e3);
+      const decayFactor = Math.pow(0.5, ageDays / 30);
+      const finalScore = result.score * confidence;
+      if (finalScore < threshold) continue;
+      results.push({
+        memory,
+        score: finalScore,
+        raw_score: result.score,
+        age_days: ageDays,
+        decay_factor: decayFactor
+      });
+    }
+    results.sort((a, b) => b.score - a.score);
+    return results.slice(0, limit);
+  },
+  /**
+   * Get a specific memory by ID
+   *
+   * @param id - Memory ID
+   * @param collection - Collection the memory belongs to
+   * @returns The memory or null if not found
+   */
+  async get(id, collection) {
+    return fetchMemory(id, collection);
+  },
+  /**
+   * Delete a memory
+   *
+   * @param id - Memory ID to delete
+   * @param collection - Collection the memory belongs to
+   */
+  async delete(id, collection) {
+    await deleteMemory(id, collection);
+  },
+  /**
+   * Validate a memory (resets decay clock)
+   *
+   * Updates the last_validated_at timestamp to the current time,
+   * which resets the time-based decay calculation.
+   *
+   * @param id - Memory ID to validate
+   * @param collection - Collection the memory belongs to
+   * @throws {Error} If memory not found
+   */
+  async validate(id, collection) {
+    const memory = await fetchMemory(id, collection);
+    if (!memory) {
+      throw new Error("Memory not found");
+    }
+    memory.metadata.last_validated_at = (/* @__PURE__ */ new Date()).toISOString();
+    await upsertMemory(memory);
+  }
+};
+
+// ../memory/src/voting.ts
+init_esm_shims();
+var VotingService = {
+  /**
+   * Vote on a memory (upvote or downvote)
+   *
+   * @param id - Memory ID
+   * @param collection - Collection the memory belongs to
+   * @param voteType - Type of vote ('upvote' or 'downvote')
+   * @throws {Error} If memory not found
+   */
+  async vote(id, collection, voteType) {
+    const memory = await fetchMemory(id, collection);
+    if (!memory) {
+      throw new Error("Memory not found");
+    }
+    if (voteType === "upvote") {
+      memory.metadata.votes.upvotes++;
+    } else {
+      memory.metadata.votes.downvotes++;
+    }
+    await upsertMemory(memory);
+  },
+  /**
+   * Record a citation (memories were retrieved and used)
+   *
+   * @param memoryIds - Array of memory IDs
+   * @param runId - Run ID for tracking citation context
+   * @param collection - Collection the memories belong to
+   * @throws {Error} If any memory not found or memoryIds is empty
+   */
+  async cite(memoryIds, runId, collection) {
+    if (memoryIds.length === 0) {
+      throw new Error("memoryIds cannot be empty");
+    }
+    for (const id of memoryIds) {
+      const memory = await fetchMemory(id, collection);
+      if (!memory) {
+        throw new Error("Memory not found");
+      }
+      memory.metadata.votes.citations++;
+      await upsertMemory(memory);
+    }
+  },
+  /**
+   * Record outcome for citations (success or failure)
+   *
+   * Updates the success_rate based on accumulated outcomes.
+   * Formula: success_rate = success_count / total_outcomes
+   *
+   * We store outcome counts in metadata (not in schema yet, but will add).
+   * For now, we store them as custom fields in metadata.
+   *
+   * @param memoryIds - Array of memory IDs
+   * @param runId - Run ID for tracking outcome context
+   * @param outcome - Outcome type ('success' or 'failure')
+   * @param collection - Collection the memories belong to
+   * @throws {Error} If any memory not found or memoryIds is empty
+   */
+  async recordOutcome(memoryIds, runId, outcome, collection) {
+    if (memoryIds.length === 0) {
+      throw new Error("memoryIds cannot be empty");
+    }
+    for (const id of memoryIds) {
+      const memory = await fetchMemory(id, collection);
+      if (!memory) {
+        throw new Error("Memory not found");
+      }
+      const metadata = memory.metadata;
+      const outcomeTracking = metadata._outcome_tracking || {
+        success: 0,
+        failure: 0
+      };
+      if (outcome === "success") {
+        outcomeTracking.success++;
+      } else {
+        outcomeTracking.failure++;
+      }
+      const totalOutcomes = outcomeTracking.success + outcomeTracking.failure;
+      memory.metadata.votes.success_rate = totalOutcomes > 0 ? outcomeTracking.success / totalOutcomes : 0;
+      metadata._outcome_tracking = outcomeTracking;
+      await upsertMemory(memory);
+    }
+  },
+  /**
+   * Get statistics for memories
+   *
+   * @param collection - Optional collection filter (omit for all collections)
+   * @returns Stats by collection
+   */
+  async stats(collection) {
+    const index = getVectorIndex();
+    const collections = collection ? [collection] : await this._listCollections();
+    const stats = {};
+    for (const col of collections) {
+      const memories = await this._fetchAllMemories(col);
+      if (memories.length === 0) {
+        continue;
+      }
+      let totalConfidence = 0;
+      let totalUpvotes = 0;
+      let totalDownvotes = 0;
+      let totalCitations = 0;
+      let totalSuccessRate = 0;
+      for (const mem of memories) {
+        const confidence = calculateConfidence(mem);
+        totalConfidence += confidence;
+        totalUpvotes += mem.metadata.votes.upvotes;
+        totalDownvotes += mem.metadata.votes.downvotes;
+        totalCitations += mem.metadata.votes.citations;
+        totalSuccessRate += mem.metadata.votes.success_rate;
+      }
+      stats[col] = {
+        count: memories.length,
+        avg_confidence: totalConfidence / memories.length,
+        total_upvotes: totalUpvotes,
+        total_downvotes: totalDownvotes,
+        total_citations: totalCitations,
+        avg_success_rate: totalSuccessRate / memories.length
+      };
+    }
+    return stats;
+  },
+  /**
+   * Prune low-quality memories
+   *
+   * Removes memories that meet ANY of the following criteria:
+   * - Below min_confidence AND older than min_age_days
+   * - Exceeds max_downvotes (regardless of age)
+   *
+   * @param options - Pruning options
+   * @returns Result with count and IDs of deleted memories
+   */
+  async prune(options = {}) {
+    const {
+      collection,
+      min_confidence = 0.1,
+      min_age_days = 30,
+      max_downvotes
+    } = options;
+    const collections = collection ? [collection] : await this._listCollections();
+    const deletedIds = [];
+    for (const col of collections) {
+      const memories = await this._fetchAllMemories(col);
+      for (const memory of memories) {
+        let shouldDelete = false;
+        if (max_downvotes !== void 0 && memory.metadata.votes.downvotes > max_downvotes) {
+          shouldDelete = true;
+        }
+        if (!shouldDelete) {
+          const confidence = calculateConfidence(memory);
+          const createdAt = new Date(memory.metadata.created_at);
+          const lastValidatedAt = memory.metadata.last_validated_at ? new Date(memory.metadata.last_validated_at) : void 0;
+          const referenceDate = lastValidatedAt || createdAt;
+          const ageDays = (Date.now() - referenceDate.getTime()) / (24 * 60 * 60 * 1e3);
+          if (confidence < min_confidence && ageDays >= min_age_days) {
+            shouldDelete = true;
+          }
+        }
+        if (shouldDelete) {
+          await deleteMemory(memory.id, col);
+          deletedIds.push(memory.id);
+        }
+      }
+    }
+    return {
+      deleted_count: deletedIds.length,
+      deleted_ids: deletedIds
+    };
+  },
+  /**
+   * Internal: List all collections (namespaces) in the index
+   *
+   * Note: Upstash Vector doesn't provide a native way to list namespaces.
+   * This is a workaround that tries common collections and sees which ones have data.
+   *
+   * @returns Array of collection names
+   * @private
+   */
+  async _listCollections() {
+    const commonCollections = [
+      "default",
+      "agent",
+      "human",
+      "system",
+      "test",
+      "other"
+    ];
+    const collectionsWithData = [];
+    for (const col of commonCollections) {
+      const memories = await this._fetchAllMemories(col);
+      if (memories.length > 0) {
+        collectionsWithData.push(col);
+      }
+    }
+    return collectionsWithData;
+  },
+  /**
+   * Internal: Fetch all memories from a collection
+   *
+   * Uses a broad query to retrieve all memories in a namespace.
+   * This is inefficient but necessary given Upstash Vector's API limitations.
+   *
+   * @param collection - Collection to fetch from
+   * @returns Array of memories
+   * @private
+   */
+  async _fetchAllMemories(collection) {
+    const index = getVectorIndex();
+    const results = await index.query(
+      {
+        data: "",
+        // Empty query to match all
+        topK: 1e4,
+        includeMetadata: true,
+        includeData: true
+      },
+      { namespace: collection }
+    );
+    return results.map((result) => ({
+      id: String(result.id),
+      content: String(result.data),
+      metadata: result.metadata
+    }));
+  }
+};
+
+export {
+  calculateConfidence,
+  upsertMemory,
+  queryMemories,
+  fetchMemory,
+  MemoryService,
+  VotingService
+};
+//# sourceMappingURL=chunk-MLNDSBZ4.js.map

package/dist/chunk-MLNDSBZ4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../memory/src/decay.ts","../../memory/src/client.ts","../../memory/src/memory.ts","../../memory/src/voting.ts"],"sourcesContent":["import type { Memory } from './schemas'\n\n/**\n * Half-life for memory decay in days\n */\nexport const DECAY_HALF_LIFE_DAYS = 30\n\n/**\n * Calculate exponential decay based on memory age\n *\n * Uses 30-day half-life: decay = 0.5^(age_days / 30)\n *\n * @param createdAt - When the memory was created\n * @param lastValidatedAt - Optional validation timestamp that resets the decay clock\n * @returns Decay factor between 0 and 1 (1 = brand new, 0.5 = half-life, etc.)\n */\nexport function calculateDecay(\n  createdAt: Date,\n  lastValidatedAt?: Date\n): number {\n  const referenceDate = lastValidatedAt || createdAt\n  const ageDays = (Date.now() - referenceDate.getTime()) / (24 * 60 * 60 * 1000)\n  return Math.pow(0.5, ageDays / DECAY_HALF_LIFE_DAYS)\n}\n\n/**\n * Calculate confidence score for a memory\n *\n * Combines time-based decay with reputation score from votes and citations.\n * Formula: decay * reputation\n *\n * Reputation calculation:\n * - Vote score: (upvotes - downvotes) / total_votes (30% weight)\n * - Citation score: success_rate when citations > 0, else 0.5 neutral (70% weight)\n * - Reputation weight: scales from 0 to 1 based on total interactions (capped at 10)\n *\n * @param memory - Memory record with metadata and votes\n * @returns Confidence score between 0 and 1\n */\nexport function calculateConfidence(memory: Memory): number {\n  const decay = calculateDecay(\n    new Date(memory.metadata.created_at),\n    memory.metadata.last_validated_at\n      ? new Date(memory.metadata.last_validated_at)\n      : undefined\n  )\n\n  const votes = memory.metadata.votes\n\n  // Reputation score based on outcomes\n  const totalVotes = votes.upvotes + votes.downvotes\n  const voteScore =\n    totalVotes > 0 ? (votes.upvotes - votes.downvotes) / totalVotes : 0\n\n  // Citation success matters most\n  const citationScore = votes.citations > 0 ? votes.success_rate : 0.5 // Neutral for uncited\n\n  // Combine: decay * weighted(votes, citations)\n  const reputationWeight = Math.min(totalVotes + votes.citations, 10) / 10\n  const reputation =\n    (voteScore * 0.3 + citationScore * 0.7) * reputationWeight +\n    (1 - reputationWeight) * 0.5\n\n  return decay * reputation\n}\n","import { Index } from '@upstash/vector'\nimport type { Memory, MemoryMetadata } from './schemas'\n\n/**\n * Lazy-initialized Upstash Vector index singleton.\n * Use this pattern to avoid creating connections at import time in serverless environments.\n */\nlet _index: Index | null = null\n\n/**\n * Get or create the Upstash Vector index instance.\n * Uses lazy initialization to defer connection until first use.\n *\n * @throws {Error} If UPSTASH_VECTOR_REST_URL or UPSTASH_VECTOR_REST_TOKEN env vars are missing\n */\nexport function getVectorIndex(): Index {\n  if (!_index) {\n    const url = process.env.UPSTASH_VECTOR_REST_URL\n    const token = process.env.UPSTASH_VECTOR_REST_TOKEN\n\n    if (!url) {\n      throw new Error(\n        'UPSTASH_VECTOR_REST_URL environment variable is required'\n      )\n    }\n    if (!token) {\n      throw new Error(\n        'UPSTASH_VECTOR_REST_TOKEN environment variable is required'\n      )\n    }\n\n    _index = new Index({\n      url,\n      token,\n    })\n  }\n\n  return _index\n}\n\n/**\n * Upsert a memory into the vector index.\n * Uses Upstash hosted embeddings by passing data string instead of vector.\n *\n * @param memory - The memory to upsert\n * @returns Promise resolving to the upsert result\n */\nexport async function upsertMemory(memory: Memory): Promise<unknown> {\n  const index = getVectorIndex()\n  return index.upsert(\n    {\n      id: memory.id,\n      data: memory.content, // Upstash generates embedding from data string\n      metadata: memory.metadata,\n    },\n    { namespace: memory.metadata.collection }\n  )\n}\n\n/**\n * Options for querying memories\n */\nexport interface QueryMemoriesOptions {\n  /** The search query text */\n  query: string\n  /** Collection (namespace) to search in */\n  collection: string\n  /** Number of results to return */\n  topK?: number\n  /** Metadata filter expression */\n  filter?: string\n}\n\n/**\n * Query result with memory metadata\n */\nexport interface QueryMemoryResult {\n  id: string\n  score: number\n  metadata: MemoryMetadata\n}\n\n/**\n * Query memories by semantic similarity.\n *\n * @param options - Query options including search text, collection, topK, and filters\n * @returns Promise resolving to array of query results\n */\nexport async function queryMemories(\n  options: QueryMemoriesOptions\n): Promise<QueryMemoryResult[]> {\n  const index = getVectorIndex()\n  const { query, collection, topK = 10, filter } = options\n\n  const results = await index.query(\n    {\n      data: query, // Upstash generates embedding from query string\n      topK,\n      includeMetadata: true,\n      ...(filter && { filter }),\n    },\n    { namespace: collection }\n  )\n\n  return results.map((result) => ({\n    id: String(result.id),\n    score: result.score,\n    metadata: result.metadata as MemoryMetadata,\n  }))\n}\n\n/**\n * Delete a memory by ID.\n *\n * @param id - The memory ID to delete\n * @param collection - The collection (namespace) the memory belongs to\n * @returns Promise resolving when deletion is complete\n */\nexport async function deleteMemory(\n  id: string,\n  collection: string\n): Promise<void> {\n  const index = getVectorIndex()\n  await index.delete(id, { namespace: collection })\n}\n\n/**\n * Fetch a memory by ID.\n *\n * @param id - The memory ID to fetch\n * @param collection - The collection (namespace) the memory belongs to\n * @returns Promise resolving to the memory or null if not found\n */\nexport async function fetchMemory(\n  id: string,\n  collection: string\n): Promise<Memory | null> {\n  const index = getVectorIndex()\n  const results = await index.fetch([id], {\n    namespace: collection,\n    includeMetadata: true,\n    includeData: true,\n  })\n\n  if (results.length === 0) {\n    return null\n  }\n\n  const result = results[0]\n  if (!result) {\n    return null\n  }\n\n  return {\n    id: String(result.id),\n    content: String(result.data),\n    metadata: result.metadata as MemoryMetadata,\n  }\n}\n","import { randomUUID } from 'node:crypto'\nimport {\n  type QueryMemoriesOptions,\n  deleteMemory,\n  fetchMemory,\n  queryMemories,\n  upsertMemory,\n} from './client'\nimport { calculateConfidence } from './decay'\nimport type { Memory, MemoryMetadata, SearchResult } from './schemas'\n\n/**\n * Options for searching memories\n */\nexport interface SearchOptions {\n  /** Collection (namespace) to search in */\n  collection: string\n  /** Number of results to return (default: 10) */\n  limit?: number\n  /** Minimum similarity score threshold (default: 0.5) */\n  threshold?: number\n  /** Filter by app slug */\n  app_slug?: string\n  /** Filter by tags (AND logic) */\n  tags?: string[]\n  /** Include low-confidence memories (<25%) (default: false) */\n  include_stale?: boolean\n}\n\n/**\n * Metadata for storing a new memory\n */\nexport interface StoreMetadata extends Partial<MemoryMetadata> {\n  collection: string\n  source: 'agent' | 'human' | 'system'\n}\n\n/**\n * Memory Service\n *\n * Provides high-level operations for storing and retrieving memories\n * with semantic search, decay scoring, and metadata filtering.\n */\nexport const MemoryService = {\n  /**\n   * Store a new memory with embedding generation\n   *\n   * @param content - The memory content to store\n   * @param metadata - Memory metadata (collection and source required)\n   * @returns The created memory with generated ID and timestamps\n   */\n  async store(content: string, metadata: StoreMetadata): Promise<Memory> {\n    const now = new Date().toISOString()\n\n    const memory: Memory = {\n      id: randomUUID(),\n      content,\n      metadata: {\n        collection: metadata.collection,\n        source: metadata.source,\n        app_slug: metadata.app_slug,\n        tags: metadata.tags ?? [],\n        confidence: metadata.confidence ?? 1,\n        created_at: metadata.created_at ?? now,\n        last_validated_at: metadata.last_validated_at,\n        votes: metadata.votes ?? {\n          upvotes: 0,\n          downvotes: 0,\n          citations: 0,\n          success_rate: 0,\n        },\n      },\n    }\n\n    await upsertMemory(memory)\n    return memory\n  },\n\n  /**\n   * Find memories by semantic similarity\n   *\n   * Queries the vector index, fetches full memory data, calculates\n   * confidence with time decay, filters by threshold, and sorts by final score.\n   *\n   * @param query - Search query text\n   * @param options - Search options including filters and limits\n   * @returns Array of search results with decay-adjusted scores\n   */\n  async find(query: string, options: SearchOptions): Promise<SearchResult[]> {\n    const {\n      collection,\n      limit = 10,\n      threshold = 0.5,\n      app_slug,\n      tags,\n      include_stale = false,\n    } = options\n\n    // Build metadata filter expression\n    let filter: string | undefined\n    if (app_slug || tags) {\n      const filters: string[] = []\n      if (app_slug) {\n        filters.push(`app_slug = \"${app_slug}\"`)\n      }\n      if (tags && tags.length > 0) {\n        tags.forEach((tag) => {\n          filters.push(`tags[*] = \"${tag}\"`)\n        })\n      }\n      filter = filters.join(' AND ')\n    }\n\n    // Query vector index\n    const queryResults = await queryMemories({\n      query,\n      collection,\n      topK: limit * 2, // Over-fetch to account for filtering\n      filter,\n    })\n\n    // Fetch full memories and calculate confidence scores\n    const results: SearchResult[] = []\n\n    for (const result of queryResults) {\n      const memory = await fetchMemory(result.id, collection)\n      if (!memory) continue\n\n      // Calculate confidence with time decay\n      const confidence = calculateConfidence(memory)\n\n      // Filter by confidence threshold (25% for stale)\n      if (!include_stale && confidence < 0.25) continue\n\n      // Calculate age in days\n      const createdAt = new Date(memory.metadata.created_at)\n      const lastValidatedAt = memory.metadata.last_validated_at\n        ? new Date(memory.metadata.last_validated_at)\n        : undefined\n      const referenceDate = lastValidatedAt || createdAt\n      const ageDays =\n        (Date.now() - referenceDate.getTime()) / (24 * 60 * 60 * 1000)\n\n      // Calculate decay factor (used in confidence calculation)\n      const decayFactor = Math.pow(0.5, ageDays / 30)\n\n      // Final score combines similarity with confidence\n      const finalScore = result.score * confidence\n\n      // Filter by threshold\n      if (finalScore < threshold) continue\n\n      results.push({\n        memory,\n        score: finalScore,\n        raw_score: result.score,\n        age_days: ageDays,\n        decay_factor: decayFactor,\n      })\n    }\n\n    // Sort by final score descending\n    results.sort((a, b) => b.score - a.score)\n\n    // Limit results\n    return results.slice(0, limit)\n  },\n\n  /**\n   * Get a specific memory by ID\n   *\n   * @param id - Memory ID\n   * @param collection - Collection the memory belongs to\n   * @returns The memory or null if not found\n   */\n  async get(id: string, collection: string): Promise<Memory | null> {\n    return fetchMemory(id, collection)\n  },\n\n  /**\n   * Delete a memory\n   *\n   * @param id - Memory ID to delete\n   * @param collection - Collection the memory belongs to\n   */\n  async delete(id: string, collection: string): Promise<void> {\n    await deleteMemory(id, collection)\n  },\n\n  /**\n   * Validate a memory (resets decay clock)\n   *\n   * Updates the last_validated_at timestamp to the current time,\n   * which resets the time-based decay calculation.\n   *\n   * @param id - Memory ID to validate\n   * @param collection - Collection the memory belongs to\n   * @throws {Error} If memory not found\n   */\n  async validate(id: string, collection: string): Promise<void> {\n    const memory = await fetchMemory(id, collection)\n    if (!memory) {\n      throw new Error('Memory not found')\n    }\n\n    // Update last_validated_at timestamp\n    memory.metadata.last_validated_at = new Date().toISOString()\n\n    await upsertMemory(memory)\n  },\n}\n","import {\n  deleteMemory,\n  fetchMemory,\n  getVectorIndex,\n  upsertMemory,\n} from './client'\nimport { calculateConfidence } from './decay'\nimport type { Memory } from './schemas'\n\n/**\n * Vote type for memory feedback\n */\nexport type VoteType = 'upvote' | 'downvote'\n\n/**\n * Outcome type for citation tracking\n */\nexport type OutcomeType = 'success' | 'failure'\n\n/**\n * Options for pruning memories\n */\nexport interface PruneOptions {\n  /** Collection to prune (omit for all collections) */\n  collection?: string\n  /** Minimum confidence threshold (memories below this are pruned) */\n  min_confidence?: number\n  /** Minimum age in days before pruning (default: 30) */\n  min_age_days?: number\n  /** Maximum downvotes before pruning regardless of age (default: none) */\n  max_downvotes?: number\n}\n\n/**\n * Result of pruning operation\n */\nexport interface PruneResult {\n  /** Number of memories deleted */\n  deleted_count: number\n  /** IDs of deleted memories */\n  deleted_ids: string[]\n}\n\n/**\n * Stats for a collection\n */\nexport interface CollectionStats {\n  /** Number of memories in collection */\n  count: number\n  /** Average confidence score */\n  avg_confidence: number\n  /** Total upvotes */\n  total_upvotes: number\n  /** Total downvotes */\n  total_downvotes: number\n  /** Total citations */\n  total_citations: number\n  /** Average success rate */\n  avg_success_rate: number\n}\n\n/**\n * Stats result by collection\n */\nexport type StatsResult = Record<string, CollectionStats>\n\n/**\n * Internal helper to track outcome counts\n */\ninterface OutcomeTracking {\n  success_count: number\n  failure_count: number\n}\n\n/**\n * Voting Service\n *\n * Provides operations for voting on memories, tracking citations,\n * recording outcomes, viewing stats, and pruning low-quality memories.\n */\nexport const VotingService = {\n  /**\n   * Vote on a memory (upvote or downvote)\n   *\n   * @param id - Memory ID\n   * @param collection - Collection the memory belongs to\n   * @param voteType - Type of vote ('upvote' or 'downvote')\n   * @throws {Error} If memory not found\n   */\n  async vote(\n    id: string,\n    collection: string,\n    voteType: VoteType\n  ): Promise<void> {\n    const memory = await fetchMemory(id, collection)\n    if (!memory) {\n      throw new Error('Memory not found')\n    }\n\n    // Increment the appropriate vote counter\n    if (voteType === 'upvote') {\n      memory.metadata.votes.upvotes++\n    } else {\n      memory.metadata.votes.downvotes++\n    }\n\n    await upsertMemory(memory)\n  },\n\n  /**\n   * Record a citation (memories were retrieved and used)\n   *\n   * @param memoryIds - Array of memory IDs\n   * @param runId - Run ID for tracking citation context\n   * @param collection - Collection the memories belong to\n   * @throws {Error} If any memory not found or memoryIds is empty\n   */\n  async cite(\n    memoryIds: string[],\n    runId: string,\n    collection: string\n  ): Promise<void> {\n    if (memoryIds.length === 0) {\n      throw new Error('memoryIds cannot be empty')\n    }\n\n    for (const id of memoryIds) {\n      const memory = await fetchMemory(id, collection)\n      if (!memory) {\n        throw new Error('Memory not found')\n      }\n\n      memory.metadata.votes.citations++\n      await upsertMemory(memory)\n    }\n  },\n\n  /**\n   * Record outcome for citations (success or failure)\n   *\n   * Updates the success_rate based on accumulated outcomes.\n   * Formula: success_rate = success_count / total_outcomes\n   *\n   * We store outcome counts in metadata (not in schema yet, but will add).\n   * For now, we store them as custom fields in metadata.\n   *\n   * @param memoryIds - Array of memory IDs\n   * @param runId - Run ID for tracking outcome context\n   * @param outcome - Outcome type ('success' or 'failure')\n   * @param collection - Collection the memories belong to\n   * @throws {Error} If any memory not found or memoryIds is empty\n   */\n  async recordOutcome(\n    memoryIds: string[],\n    runId: string,\n    outcome: OutcomeType,\n    collection: string\n  ): Promise<void> {\n    if (memoryIds.length === 0) {\n      throw new Error('memoryIds cannot be empty')\n    }\n\n    for (const id of memoryIds) {\n      const memory = await fetchMemory(id, collection)\n      if (!memory) {\n        throw new Error('Memory not found')\n      }\n\n      // Store outcome counts in metadata (extend the type at runtime)\n      const metadata = memory.metadata as any\n      const outcomeTracking = metadata._outcome_tracking || {\n        success: 0,\n        failure: 0,\n      }\n\n      // Update counts based on new outcome\n      if (outcome === 'success') {\n        outcomeTracking.success++\n      } else {\n        outcomeTracking.failure++\n      }\n\n      // Calculate new success rate\n      const totalOutcomes = outcomeTracking.success + outcomeTracking.failure\n      memory.metadata.votes.success_rate =\n        totalOutcomes > 0 ? outcomeTracking.success / totalOutcomes : 0\n\n      // Store updated tracking\n      metadata._outcome_tracking = outcomeTracking\n\n      await upsertMemory(memory)\n    }\n  },\n\n  /**\n   * Get statistics for memories\n   *\n   * @param collection - Optional collection filter (omit for all collections)\n   * @returns Stats by collection\n   */\n  async stats(collection?: string): Promise<StatsResult> {\n    const index = getVectorIndex()\n\n    // Upstash Vector doesn't provide a direct way to list all namespaces/collections\n    // or count all memories across collections. We'll need to implement this by\n    // scanning the index. For now, we'll implement a simplified version that\n    // requires fetching memories.\n\n    // Note: This is a simplified implementation. In production, you might want\n    // to maintain stats in a separate data store for efficiency.\n\n    const collections = collection\n      ? [collection]\n      : await this._listCollections()\n    const stats: StatsResult = {}\n\n    for (const col of collections) {\n      // Fetch all memories in this collection\n      // This is inefficient but necessary given Upstash Vector's API\n      const memories = await this._fetchAllMemories(col)\n\n      if (memories.length === 0) {\n        continue\n      }\n\n      // Calculate stats\n      let totalConfidence = 0\n      let totalUpvotes = 0\n      let totalDownvotes = 0\n      let totalCitations = 0\n      let totalSuccessRate = 0\n\n      for (const mem of memories) {\n        const confidence = calculateConfidence(mem)\n        totalConfidence += confidence\n        totalUpvotes += mem.metadata.votes.upvotes\n        totalDownvotes += mem.metadata.votes.downvotes\n        totalCitations += mem.metadata.votes.citations\n        totalSuccessRate += mem.metadata.votes.success_rate\n      }\n\n      stats[col] = {\n        count: memories.length,\n        avg_confidence: totalConfidence / memories.length,\n        total_upvotes: totalUpvotes,\n        total_downvotes: totalDownvotes,\n        total_citations: totalCitations,\n        avg_success_rate: totalSuccessRate / memories.length,\n      }\n    }\n\n    return stats\n  },\n\n  /**\n   * Prune low-quality memories\n   *\n   * Removes memories that meet ANY of the following criteria:\n   * - Below min_confidence AND older than min_age_days\n   * - Exceeds max_downvotes (regardless of age)\n   *\n   * @param options - Pruning options\n   * @returns Result with count and IDs of deleted memories\n   */\n  async prune(options: PruneOptions = {}): Promise<PruneResult> {\n    const {\n      collection,\n      min_confidence = 0.1,\n      min_age_days = 30,\n      max_downvotes,\n    } = options\n\n    const collections = collection\n      ? [collection]\n      : await this._listCollections()\n    const deletedIds: string[] = []\n\n    for (const col of collections) {\n      const memories = await this._fetchAllMemories(col)\n\n      for (const memory of memories) {\n        let shouldDelete = false\n\n        // Check downvotes threshold (regardless of age)\n        if (\n          max_downvotes !== undefined &&\n          memory.metadata.votes.downvotes > max_downvotes\n        ) {\n          shouldDelete = true\n        }\n\n        // Check confidence + age threshold\n        if (!shouldDelete) {\n          const confidence = calculateConfidence(memory)\n          const createdAt = new Date(memory.metadata.created_at)\n          const lastValidatedAt = memory.metadata.last_validated_at\n            ? new Date(memory.metadata.last_validated_at)\n            : undefined\n          const referenceDate = lastValidatedAt || createdAt\n          const ageDays =\n            (Date.now() - referenceDate.getTime()) / (24 * 60 * 60 * 1000)\n\n          if (confidence < min_confidence && ageDays >= min_age_days) {\n            shouldDelete = true\n          }\n        }\n\n        if (shouldDelete) {\n          await deleteMemory(memory.id, col)\n          deletedIds.push(memory.id)\n        }\n      }\n    }\n\n    return {\n      deleted_count: deletedIds.length,\n      deleted_ids: deletedIds,\n    }\n  },\n\n  /**\n   * Internal: List all collections (namespaces) in the index\n   *\n   * Note: Upstash Vector doesn't provide a native way to list namespaces.\n   * This is a workaround that tries common collections and sees which ones have data.\n   *\n   * @returns Array of collection names\n   * @private\n   */\n  async _listCollections(): Promise<string[]> {\n    // Try common collections and filter to ones that have data\n    const commonCollections = [\n      'default',\n      'agent',\n      'human',\n      'system',\n      'test',\n      'other',\n    ]\n    const collectionsWithData: string[] = []\n\n    for (const col of commonCollections) {\n      const memories = await this._fetchAllMemories(col)\n      if (memories.length > 0) {\n        collectionsWithData.push(col)\n      }\n    }\n\n    return collectionsWithData\n  },\n\n  /**\n   * Internal: Fetch all memories from a collection\n   *\n   * Uses a broad query to retrieve all memories in a namespace.\n   * This is inefficient but necessary given Upstash Vector's API limitations.\n   *\n   * @param collection - Collection to fetch from\n   * @returns Array of memories\n   * @private\n   */\n  async _fetchAllMemories(collection: string): Promise<Memory[]> {\n    const index = getVectorIndex()\n\n    // Query with a broad query to get all memories\n    // We use topK=10000 as a practical limit\n    const results = await index.query(\n      {\n        data: '', // Empty query to match all\n        topK: 10000,\n        includeMetadata: true,\n        includeData: true,\n      },\n      { namespace: collection }\n    )\n\n    return results.map((result) => ({\n      id: String(result.id),\n      content: String(result.data),\n      metadata: result.metadata as Memory['metadata'],\n    }))\n  },\n}\n"],"mappings":"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","names":[]}