@llamaindex/llama-cloud 0.14.1

package/src/internal/utils/values.ts

@@ -0,0 +1,105 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { LlamaCloudError } from '../../core/error';
+
+// https://url.spec.whatwg.org/#url-scheme-string
+const startsWithSchemeRegexp = /^[a-z][a-z0-9+.-]*:/i;
+
+export const isAbsoluteURL = (url: string): boolean => {
+  return startsWithSchemeRegexp.test(url);
+};
+
+export let isArray = (val: unknown): val is unknown[] => ((isArray = Array.isArray), isArray(val));
+export let isReadonlyArray = isArray as (val: unknown) => val is readonly unknown[];
+
+/** Returns an object if the given value isn't an object, otherwise returns as-is */
+export function maybeObj(x: unknown): object {
+  if (typeof x !== 'object') {
+    return {};
+  }
+
+  return x ?? {};
+}
+
+// https://stackoverflow.com/a/34491287
+export function isEmptyObj(obj: Object | null | undefined): boolean {
+  if (!obj) return true;
+  for (const _k in obj) return false;
+  return true;
+}
+
+// https://eslint.org/docs/latest/rules/no-prototype-builtins
+export function hasOwn<T extends object = object>(obj: T, key: PropertyKey): key is keyof T {
+  return Object.prototype.hasOwnProperty.call(obj, key);
+}
+
+export function isObj(obj: unknown): obj is Record<string, unknown> {
+  return obj != null && typeof obj === 'object' && !Array.isArray(obj);
+}
+
+export const ensurePresent = <T>(value: T | null | undefined): T => {
+  if (value == null) {
+    throw new LlamaCloudError(`Expected a value to be given but received ${value} instead.`);
+  }
+
+  return value;
+};
+
+export const validatePositiveInteger = (name: string, n: unknown): number => {
+  if (typeof n !== 'number' || !Number.isInteger(n)) {
+    throw new LlamaCloudError(`${name} must be an integer`);
+  }
+  if (n < 0) {
+    throw new LlamaCloudError(`${name} must be a positive integer`);
+  }
+  return n;
+};
+
+export const coerceInteger = (value: unknown): number => {
+  if (typeof value === 'number') return Math.round(value);
+  if (typeof value === 'string') return parseInt(value, 10);
+
+  throw new LlamaCloudError(`Could not coerce ${value} (type: ${typeof value}) into a number`);
+};
+
+export const coerceFloat = (value: unknown): number => {
+  if (typeof value === 'number') return value;
+  if (typeof value === 'string') return parseFloat(value);
+
+  throw new LlamaCloudError(`Could not coerce ${value} (type: ${typeof value}) into a number`);
+};
+
+export const coerceBoolean = (value: unknown): boolean => {
+  if (typeof value === 'boolean') return value;
+  if (typeof value === 'string') return value === 'true';
+  return Boolean(value);
+};
+
+export const maybeCoerceInteger = (value: unknown): number | undefined => {
+  if (value == null) {
+    return undefined;
+  }
+  return coerceInteger(value);
+};
+
+export const maybeCoerceFloat = (value: unknown): number | undefined => {
+  if (value == null) {
+    return undefined;
+  }
+  return coerceFloat(value);
+};
+
+export const maybeCoerceBoolean = (value: unknown): boolean | undefined => {
+  if (value == null) {
+    return undefined;
+  }
+  return coerceBoolean(value);
+};
+
+export const safeJSON = (text: string) => {
+  try {
+    return JSON.parse(text);
+  } catch (err) {
+    return undefined;
+  }
+};

package/src/internal/utils.ts

@@ -0,0 +1,8 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './utils/values';
+export * from './utils/base64';
+export * from './utils/env';
+export * from './utils/log';
+export * from './utils/uuid';
+export * from './utils/sleep';

package/src/lib/.keep

@@ -0,0 +1,4 @@
+File generated from our OpenAPI spec by Stainless.
+
+This directory can be used to store custom files to expand the SDK.
+It is ignored by Stainless code generation and its content (other than this keep file) won't be touched.

package/src/pagination.ts

@@ -0,0 +1,2 @@
+/** @deprecated Import from ./core/pagination instead */
+export * from './core/pagination';

package/src/resource.ts

@@ -0,0 +1,2 @@
+/** @deprecated Import from ./core/resource instead */
+export * from './core/resource';

package/src/resources/beta/agent-data.ts

@@ -0,0 +1,466 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class AgentData extends APIResource {
+  /**
+   * Update agent data by ID (overwrites).
+   */
+  update(itemID: string, params: AgentDataUpdateParams, options?: RequestOptions): APIPromise<AgentData> {
+    const { organization_id, project_id, ...body } = params;
+    return this._client.put(path`/api/v1/beta/agent-data/${itemID}`, {
+      query: { organization_id, project_id },
+      body,
+      ...options,
+    });
+  }
+
+  /**
+   * Delete agent data by ID.
+   */
+  delete(
+    itemID: string,
+    params: AgentDataDeleteParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<AgentDataDeleteResponse> {
+    const { organization_id, project_id } = params ?? {};
+    return this._client.delete(path`/api/v1/beta/agent-data/${itemID}`, {
+      query: { organization_id, project_id },
+      ...options,
+    });
+  }
+
+  /**
+   * Create new agent data.
+   */
+  agentData(params: AgentDataAgentDataParams, options?: RequestOptions): APIPromise<AgentData> {
+    const { organization_id, project_id, ...body } = params;
+    return this._client.post('/api/v1/beta/agent-data', {
+      query: { organization_id, project_id },
+      body,
+      ...options,
+    });
+  }
+
+  /**
+   * Aggregate agent data with grouping and optional counting/first item retrieval.
+   */
+  aggregate(
+    params: AgentDataAggregateParams,
+    options?: RequestOptions,
+  ): APIPromise<AgentDataAggregateResponse> {
+    const { organization_id, project_id, ...body } = params;
+    return this._client.post('/api/v1/beta/agent-data/:aggregate', {
+      query: { organization_id, project_id },
+      body,
+      ...options,
+    });
+  }
+
+  /**
+   * Bulk delete agent data by query (deployment_name, collection, optional filters).
+   */
+  deleteByQuery(
+    params: AgentDataDeleteByQueryParams,
+    options?: RequestOptions,
+  ): APIPromise<AgentDataDeleteByQueryResponse> {
+    const { organization_id, project_id, ...body } = params;
+    return this._client.post('/api/v1/beta/agent-data/:delete', {
+      query: { organization_id, project_id },
+      body,
+      ...options,
+    });
+  }
+
+  /**
+   * Get agent data by ID.
+   */
+  get(
+    itemID: string,
+    query: AgentDataGetParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<AgentData> {
+    return this._client.get(path`/api/v1/beta/agent-data/${itemID}`, { query, ...options });
+  }
+
+  /**
+   * Search agent data with filtering, sorting, and pagination.
+   */
+  search(params: AgentDataSearchParams, options?: RequestOptions): APIPromise<AgentDataSearchResponse> {
+    const { organization_id, project_id, ...body } = params;
+    return this._client.post('/api/v1/beta/agent-data/:search', {
+      query: { organization_id, project_id },
+      body,
+      ...options,
+    });
+  }
+}
+
+/**
+ * API Result for a single agent data item
+ */
+export interface AgentData {
+  data: { [key: string]: unknown };
+
+  deployment_name: string;
+
+  id?: string | null;
+
+  collection?: string;
+
+  created_at?: string | null;
+
+  project_id?: string | null;
+
+  updated_at?: string | null;
+}
+
+export type AgentDataDeleteResponse = { [key: string]: string };
+
+export interface AgentDataAggregateResponse {
+  /**
+   * The list of items.
+   */
+  items: Array<AgentDataAggregateResponse.Item>;
+
+  /**
+   * A token, which can be sent as page_token to retrieve the next page. If this
+   * field is omitted, there are no subsequent pages.
+   */
+  next_page_token?: string | null;
+
+  /**
+   * The total number of items available. This is only populated when specifically
+   * requested. The value may be an estimate and can be used for display purposes
+   * only.
+   */
+  total_size?: number | null;
+}
+
+export namespace AgentDataAggregateResponse {
+  /**
+   * API Result for a single group in the aggregate response
+   */
+  export interface Item {
+    group_key: { [key: string]: unknown };
+
+    count?: number | null;
+
+    first_item?: { [key: string]: unknown } | null;
+  }
+}
+
+/**
+ * API response for bulk delete operation
+ */
+export interface AgentDataDeleteByQueryResponse {
+  deleted_count: number;
+}
+
+export interface AgentDataSearchResponse {
+  /**
+   * The list of items.
+   */
+  items: Array<AgentData>;
+
+  /**
+   * A token, which can be sent as page_token to retrieve the next page. If this
+   * field is omitted, there are no subsequent pages.
+   */
+  next_page_token?: string | null;
+
+  /**
+   * The total number of items available. This is only populated when specifically
+   * requested. The value may be an estimate and can be used for display purposes
+   * only.
+   */
+  total_size?: number | null;
+}
+
+export interface AgentDataUpdateParams {
+  /**
+   * Body param
+   */
+  data: { [key: string]: unknown };
+
+  /**
+   * Query param
+   */
+  organization_id?: string | null;
+
+  /**
+   * Query param
+   */
+  project_id?: string | null;
+}
+
+export interface AgentDataDeleteParams {
+  organization_id?: string | null;
+
+  project_id?: string | null;
+}
+
+export interface AgentDataAgentDataParams {
+  /**
+   * Body param
+   */
+  data: { [key: string]: unknown };
+
+  /**
+   * Body param
+   */
+  deployment_name: string;
+
+  /**
+   * Query param
+   */
+  organization_id?: string | null;
+
+  /**
+   * Query param
+   */
+  project_id?: string | null;
+
+  /**
+   * Body param
+   */
+  collection?: string;
+}
+
+export interface AgentDataAggregateParams {
+  /**
+   * Body param: The agent deployment's name to aggregate data for
+   */
+  deployment_name: string;
+
+  /**
+   * Query param
+   */
+  organization_id?: string | null;
+
+  /**
+   * Query param
+   */
+  project_id?: string | null;
+
+  /**
+   * Body param: The logical agent data collection to aggregate data for
+   */
+  collection?: string;
+
+  /**
+   * Body param: Whether to count the number of items in each group
+   */
+  count?: boolean | null;
+
+  /**
+   * Body param: A filter object or expression that filters resources listed in the
+   * response.
+   */
+  filter?: { [key: string]: AgentDataAggregateParams.Filter } | null;
+
+  /**
+   * Body param: Whether to return the first item in each group (Sorted by
+   * created_at)
+   */
+  first?: boolean | null;
+
+  /**
+   * Body param: The fields to group by. If empty, the entire dataset is grouped on.
+   * e.g. if left out, can be used for simple count operations
+   */
+  group_by?: Array<string> | null;
+
+  /**
+   * Body param: The offset to start from. If not provided, the first page is
+   * returned
+   */
+  offset?: number | null;
+
+  /**
+   * Body param: A comma-separated list of fields to order by, sorted in ascending
+   * order. Use 'field_name desc' to specify descending order.
+   */
+  order_by?: string | null;
+
+  /**
+   * Body param: The maximum number of items to return. The service may return fewer
+   * than this value. If unspecified, a default page size will be used. The maximum
+   * value is typically 1000; values above this will be coerced to the maximum.
+   */
+  page_size?: number | null;
+
+  /**
+   * Body param: A page token, received from a previous list call. Provide this to
+   * retrieve the subsequent page.
+   */
+  page_token?: string | null;
+}
+
+export namespace AgentDataAggregateParams {
+  /**
+   * API request model for a filter comparison operation.
+   */
+  export interface Filter {
+    eq?: number | string | (string & {}) | null;
+
+    gt?: number | string | (string & {}) | null;
+
+    gte?: number | string | (string & {}) | null;
+
+    includes?: Array<number | string | (string & {}) | null>;
+
+    lt?: number | string | (string & {}) | null;
+
+    lte?: number | string | (string & {}) | null;
+  }
+}
+
+export interface AgentDataDeleteByQueryParams {
+  /**
+   * Body param: The agent deployment's name to delete data for
+   */
+  deployment_name: string;
+
+  /**
+   * Query param
+   */
+  organization_id?: string | null;
+
+  /**
+   * Query param
+   */
+  project_id?: string | null;
+
+  /**
+   * Body param: The logical agent data collection to delete from
+   */
+  collection?: string;
+
+  /**
+   * Body param: Optional filters to select which items to delete
+   */
+  filter?: { [key: string]: AgentDataDeleteByQueryParams.Filter } | null;
+}
+
+export namespace AgentDataDeleteByQueryParams {
+  /**
+   * API request model for a filter comparison operation.
+   */
+  export interface Filter {
+    eq?: number | string | (string & {}) | null;
+
+    gt?: number | string | (string & {}) | null;
+
+    gte?: number | string | (string & {}) | null;
+
+    includes?: Array<number | string | (string & {}) | null>;
+
+    lt?: number | string | (string & {}) | null;
+
+    lte?: number | string | (string & {}) | null;
+  }
+}
+
+export interface AgentDataGetParams {
+  organization_id?: string | null;
+
+  project_id?: string | null;
+}
+
+export interface AgentDataSearchParams {
+  /**
+   * Body param: The agent deployment's name to search within
+   */
+  deployment_name: string;
+
+  /**
+   * Query param
+   */
+  organization_id?: string | null;
+
+  /**
+   * Query param
+   */
+  project_id?: string | null;
+
+  /**
+   * Body param: The logical agent data collection to search within
+   */
+  collection?: string;
+
+  /**
+   * Body param: A filter object or expression that filters resources listed in the
+   * response.
+   */
+  filter?: { [key: string]: AgentDataSearchParams.Filter } | null;
+
+  /**
+   * Body param: Whether to include the total number of items in the response
+   */
+  include_total?: boolean;
+
+  /**
+   * Body param: The offset to start from. If not provided, the first page is
+   * returned
+   */
+  offset?: number | null;
+
+  /**
+   * Body param: A comma-separated list of fields to order by, sorted in ascending
+   * order. Use 'field_name desc' to specify descending order.
+   */
+  order_by?: string | null;
+
+  /**
+   * Body param: The maximum number of items to return. The service may return fewer
+   * than this value. If unspecified, a default page size will be used. The maximum
+   * value is typically 1000; values above this will be coerced to the maximum.
+   */
+  page_size?: number | null;
+
+  /**
+   * Body param: A page token, received from a previous list call. Provide this to
+   * retrieve the subsequent page.
+   */
+  page_token?: string | null;
+}
+
+export namespace AgentDataSearchParams {
+  /**
+   * API request model for a filter comparison operation.
+   */
+  export interface Filter {
+    eq?: number | string | (string & {}) | null;
+
+    gt?: number | string | (string & {}) | null;
+
+    gte?: number | string | (string & {}) | null;
+
+    includes?: Array<number | string | (string & {}) | null>;
+
+    lt?: number | string | (string & {}) | null;
+
+    lte?: number | string | (string & {}) | null;
+  }
+}
+
+export declare namespace AgentData {
+  export {
+    type AgentData as AgentData,
+    type AgentDataDeleteResponse as AgentDataDeleteResponse,
+    type AgentDataAggregateResponse as AgentDataAggregateResponse,
+    type AgentDataDeleteByQueryResponse as AgentDataDeleteByQueryResponse,
+    type AgentDataSearchResponse as AgentDataSearchResponse,
+    type AgentDataUpdateParams as AgentDataUpdateParams,
+    type AgentDataDeleteParams as AgentDataDeleteParams,
+    type AgentDataAgentDataParams as AgentDataAgentDataParams,
+    type AgentDataAggregateParams as AgentDataAggregateParams,
+    type AgentDataDeleteByQueryParams as AgentDataDeleteByQueryParams,
+    type AgentDataGetParams as AgentDataGetParams,
+    type AgentDataSearchParams as AgentDataSearchParams,
+  };
+}