feat(api): manual updates

Author: stainless-app[bot]

.gitignore

@@ -7,4 +7,5 @@ dist
 dist-deno
 /*.tgz
 .idea/
+.eslintcache
 

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 14
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/zeroentropy%2Fzeroentropy-bd2f55f423e09b74f83cbad6034fb76f7052363308d02533a908b49543cff459.yml
-openapi_spec_hash: 6d7566ebda7fecac4069744949d547e0
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/zeroentropy%2Fzeroentropy-c95681b13dc56e64126746c6e546b564c7f802ae567fc9ccc1aeb8eddd40bb1e.yml
+openapi_spec_hash: 2ac723122fe938e384f11b5cf19e85ec
 config_hash: e07cdee04c971e1db74e91a5a4cd981c

scripts/bootstrap

@@ -4,10 +4,18 @@ set -e
 
 cd "$(dirname "$0")/.."
 
-if [ -f "Brewfile" ] && [ "$(uname -s)" = "Darwin" ] && [ "$SKIP_BREW" != "1" ]; then
+if [ -f "Brewfile" ] && [ "$(uname -s)" = "Darwin" ] && [ "$SKIP_BREW" != "1" ] && [ -t 0 ]; then
   brew bundle check >/dev/null 2>&1 || {
-    echo "==> Installing Homebrew dependencies…"
-    brew bundle
+    echo -n "==> Install Homebrew dependencies? (y/N): "
+    read -r response
+    case "$response" in
+      [yY][eE][sS]|[yY])
+        brew bundle
+        ;;
+      *)
+        ;;
+    esac
+    echo
   }
 fi
 

scripts/fast-format

@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+echo "Script started with $# arguments"
+echo "Arguments: $*"
+echo "Script location: $(dirname "$0")"
+
+cd "$(dirname "$0")/.."
+echo "Changed to directory: $(pwd)"
+
+if [ $# -eq 0 ]; then
+    echo "Usage: $0 <file-with-paths> [additional-formatter-args...]"
+    echo "The file should contain one file path per line"
+    exit 1
+fi
+
+FILE_LIST="$1"
+
+echo "Looking for file: $FILE_LIST"
+
+if [ ! -f "$FILE_LIST" ]; then
+    echo "Error: File '$FILE_LIST' not found"
+    exit 1
+fi
+
+echo "==> Running eslint --fix"
+ESLINT_FILES="$(grep '\.ts$' "$FILE_LIST" || true)"
+if ! [ -z "$ESLINT_FILES" ]; then
+   echo "$ESLINT_FILES" | ESLINT_USE_FLAT_CONFIG="false" xargs ./node_modules/.bin/eslint --cache --fix
+fi
+
+echo "==> Running prettier --write"
+# format things eslint didn't
+PRETTIER_FILES="$(grep '\.\(js\|json\)$' "$FILE_LIST" || true)"
+if ! [ -z "$PRETTIER_FILES" ]; then
+   echo "$PRETTIER_FILES" | xargs ./node_modules/.bin/prettier \
+      --write --cache --cache-strategy metadata --no-error-on-unmatched-pattern \
+      '!**/dist' '!**/*.ts' '!**/*.mts' '!**/*.cts' '!**/*.js' '!**/*.mjs' '!**/*.cjs'
+fi

scripts/utils/upload-artifact.sh

@@ -12,9 +12,11 @@ if [[ "$SIGNED_URL" == "null" ]]; then
   exit 1
 fi
 
-UPLOAD_RESPONSE=$(tar "${BASE_PATH:+-C$BASE_PATH}" -cz "${ARTIFACT_PATH:-dist}" | curl -v -X PUT \
+TARBALL=$(cd dist && npm pack --silent)
+
+UPLOAD_RESPONSE=$(curl -v -X PUT \
   -H "Content-Type: application/gzip" \
-  --data-binary @- "$SIGNED_URL" 2>&1)
+  --data-binary "@dist/$TARBALL" "$SIGNED_URL" 2>&1)
 
 if echo "$UPLOAD_RESPONSE" | grep -q "HTTP/[0-9.]* 200"; then
   echo -e "\033[32mUploaded build to Stainless storage.\033[0m"

src/core.ts

@@ -1088,21 +1088,21 @@ export const coerceBoolean = (value: unknown): boolean => {
 };
 
 export const maybeCoerceInteger = (value: unknown): number | undefined => {
-  if (value === undefined) {
+  if (value == null) {
     return undefined;
   }
   return coerceInteger(value);
 };
 
 export const maybeCoerceFloat = (value: unknown): number | undefined => {
-  if (value === undefined) {
+  if (value == null) {
     return undefined;
   }
   return coerceFloat(value);
 };
 
 export const maybeCoerceBoolean = (value: unknown): boolean | undefined => {
-  if (value === undefined) {
+  if (value == null) {
     return undefined;
   }
   return coerceBoolean(value);

src/resources/collections.ts

@@ -72,6 +72,15 @@ export interface CollectionAddParams {
    * exceed 1024 bytes.
    */
   collection_name: string;
+
+  /**
+   * [ADVANCED] The number of shards to use for this collection. By using K shards,
+   * your documents can index with K times more throughput. However, queries will be
+   * automatically sent to all K shards and then aggregated. For large collections,
+   * this can make queries faster. But for small collections, this will make queries
+   * slower. `num_shards` must be one of [1, 8, 16, 32, 64]. The default is 1.
+   */
+  num_shards?: number;
 }
 
 export interface CollectionGetListParams {}

src/resources/documents.ts

@@ -14,9 +14,9 @@ export class Documents extends APIResource {
    *   `index_status` of `indexed`. After this call, the document will have an
    *   `index_status` of `not_indexed`, since the document will need to reindex with
    *   the new metadata.
-   * - When updating with a non-null `index_status`, setting it to
-   *   `not_parsed or `not_indexed`requires that the document must have`index_status`of`parsing_failed`or`indexing_failed`,
-   *   respectively.
+   * - When updating with a non-null `index_status`, setting it to `not_parsed` or
+   *   `not_indexed` requires that the document must have `index_status` of
+   *   `parsing_failed` or `indexing_failed`, respectively.
    *
    * A `404 Not Found` status code will be returned, if the provided collection name
    * or document path does not exist.
@@ -373,9 +373,11 @@ export namespace DocumentAddParams {
     pages: Array<string>;
 
     /**
-     * This field must be `text-pages`
+     * This field must be `text-pages` or `text-pages-unordered`. When `unordered` is
+     * provided, it is assumed that consecutive pages aren't meant to be read one after
+     * another. For example, PDFs are ordered, and CSVs are unordered.
      */
-    type: 'text-pages';
+    type: 'text-pages' | 'text-pages-unordered';
   }
 
   export interface APIBinaryDocument {

src/resources/models.ts

@@ -10,8 +10,16 @@ export class Models extends APIResource {
    * The results will be sorted by descending order of relevance. For each document,
    * the index and the score will be returned. The index is relative to the documents
    * array that was passed in. The score is the query-document relevancy determined
-   * by the reranker model. The value will be returned in descending order to
+   * by the reranker model. The results will be returned in descending order of
    * relevance.
+   *
+   * Organizations will, by default, have a ratelimit of `2,500,000`
+   * bytes-per-minute. If this is exceeded, requests will be throttled into
+   * `latency: "slow"` mode, up to `10,000,000` bytes-per-minute. If even this is
+   * exceeded, you will get a `429` error. To request higher ratelimits, please
+   * contact [founders@zeroentropy.dev](mailto:founders@zeroentropy.dev) or message
+   * us on [Discord](https://go.zeroentropy.dev/discord) or
+   * [Slack](https://go.zeroentropy.dev/slack)!
    */
   rerank(body: ModelRerankParams, options?: Core.RequestOptions): Core.APIPromise<ModelRerankResponse> {
     return this._client.post('/models/rerank', { body, ...options });
@@ -36,8 +44,8 @@ export namespace ModelRerankResponse {
     /**
      * The relevance score between this document and the query. This number will range
      * between 0.0 and 1.0. This score is dependent on only the query and the scored
-     * document; other documents do not affect this score. This value is deterministic,
-     * but may vary slightly due to floating point error.
+     * document; other documents do not affect this score. This value is intended to be
+     * deterministic, but it may vary slightly due to floating point error.
      */
     relevance_score: number;
   }
@@ -50,19 +58,29 @@ export interface ModelRerankParams {
   documents: Array<string>;
 
   /**
-   * The query to rerank the documents by. Results will be in descending order of
-   * relevance.
+   * The model ID to use for reranking. Options are: ["zerank-2", "zerank-1",
+   * "zerank-1-small"]
+   */
+  model: string;
+
+  /**
+   * The query to rerank the documents by.
    */
   query: string;
 
   /**
-   * The model ID to use for reranking. Options are: ["zerank-1-large"]
+   * Whether the call will be inferenced "fast" or "slow". RateLimits for slow API
+   * calls are orders of magnitude higher, but you can expect >10 second latency.
+   * Fast inferences are guaranteed subsecond, but rate limits are lower. If not
+   * specified, first a "fast" call will be attempted, but if you have exceeded your
+   * fast rate limit, then a slow call will be executed. If explicitly set to "fast",
+   * then 429 will be returned if it cannot be executed fast.
    */
-  model?: string;
+  latency?: 'fast' | 'slow' | null;
 
   /**
    * If provided, then only the top `n` documents will be returned in the results
-   * array.
+   * array. Otherwise, `n` will be the length of the provided documents array.
    */
   top_n?: number | null;
 }

src/resources/queries.ts

@@ -215,8 +215,11 @@ export interface QueryTopDocumentsParams {
 
   /**
    * The natural language query to search with. This cannot exceed 4096 UTF-8 bytes.
+   * If `null`, then the sort will be undefined. The purpose of `null` is to do
+   * faster metadata filter searches without care for relevancy. Cost per query is
+   * unchanged.
    */
-  query: string;
+  query: string | null;
 
   /**
    * The query filter to apply. Please read [Metadata Filtering](/metadata-filtering)