@linkt/sdk 0.5.0 → 0.7.0

package/resources/task.js.map

@@ -1 +1 @@
-{"version":3,"file":"task.js","sourceRoot":"","sources":["../src/resources/task.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,oDAAmD;AAEnD,oDAA8C;AAE9C,MAAa,IAAK,SAAQ,sBAAW;IACnC;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,IAAsB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CAAC,MAAc,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,YAAY,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,MAAc,EAAE,IAAsB,EAAE,OAAwB;QACrE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,YAAY,MAAM,EAAE,EAAE;YAChD,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CACF,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,MAAc,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,YAAY,MAAM,EAAE,EAAE;YACnD,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,OAAO,CACL,MAAc,EACd,IAAuB,EACvB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,YAAY,MAAM,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnF,CAAC;CACF;AA9GD,oBA8GC"}
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../src/resources/task.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,oDAAmD;AAEnD,oDAA8C;AAE9C;;GAEG;AACH,MAAa,IAAK,SAAQ,sBAAW;IACnC;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,IAAsB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CAAC,MAAc,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,YAAY,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,MAAc,EAAE,IAAsB,EAAE,OAAwB;QACrE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,YAAY,MAAM,EAAE,EAAE;YAChD,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CACF,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,MAAc,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,YAAY,MAAM,EAAE,EAAE;YACnD,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,OAAO,CACL,MAAc,EACd,IAAuB,EACvB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,YAAY,MAAM,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnF,CAAC;CACF;AA9GD,oBA8GC"}

package/resources/task.mjs

@@ -2,6 +2,9 @@
 import { APIResource } from "../core/resource.mjs";
 import { buildHeaders } from "../internal/headers.mjs";
 import { path } from "../internal/utils/path.mjs";
+/**
+ * **Tasks** are reusable workflow templates that define HOW research is executed. Tasks reference Prefect flow deployments and can be configured with prompts and parameters. Create a task once, then execute it multiple times to generate runs. Each execution creates a new run that can be monitored independently.
+ */
 export class Task extends APIResource {
     /**
      * Create a new task template.

package/resources/task.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"task.mjs","sourceRoot":"","sources":["../src/resources/task.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAIf,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,IAAK,SAAQ,WAAW;IACnC;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,IAAsB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CAAC,MAAc,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,YAAY,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,MAAc,EAAE,IAAsB,EAAE,OAAwB;QACrE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,YAAY,MAAM,EAAE,EAAE;YAChD,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CACF,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,MAAc,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,YAAY,MAAM,EAAE,EAAE;YACnD,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,OAAO,CACL,MAAc,EACd,IAAuB,EACvB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,YAAY,MAAM,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnF,CAAC;CACF"}
+{"version":3,"file":"task.mjs","sourceRoot":"","sources":["../src/resources/task.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAIf,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAEf;;GAEG;AACH,MAAM,OAAO,IAAK,SAAQ,WAAW;IACnC;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,IAAsB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CAAC,MAAc,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,YAAY,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,MAAc,EAAE,IAAsB,EAAE,OAAwB;QACrE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,YAAY,MAAM,EAAE,EAAE;YAChD,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CACF,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,MAAc,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,YAAY,MAAM,EAAE,EAAE;YACnD,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,OAAO,CACL,MAAc,EACd,IAAuB,EACvB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,YAAY,MAAM,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnF,CAAC;CACF"}

package/src/client.ts

@@ -11,7 +11,7 @@ import type { APIResponseProps } from './internal/parse';
 import { getPlatformHeaders } from './internal/detect-platform';
 import * as Shims from './internal/shims';
 import * as Opts from './internal/request-options';
-import * as qs from './internal/qs';
+import { stringifyQuery } from './internal/utils/query';
 import { VERSION } from './version';
 import * as Errors from './core/error';
 import * as Uploads from './core/uploads';
@@ -61,6 +61,16 @@ import {
   RunListResponse,
   RunRetrieveResponse,
 } from './resources/run';
+import {
+  CreateScheduleRequest,
+  Schedule,
+  ScheduleCreateParams,
+  ScheduleListParams,
+  ScheduleListResponse,
+  ScheduleResponse,
+  ScheduleUpdateParams,
+  UpdateScheduleRequest,
+} from './resources/schedule';
 import { Signal, SignalListParams, SignalListResponse, SignalResponse } from './resources/signal';
 import {
   IngestPromptConfigResponse,
@@ -313,8 +323,8 @@ export class Linkt {
     return buildHeaders([{ 'x-api-key': this.apiKey }]);
   }
 
-  protected stringifyQuery(query: Record<string, unknown>): string {
-    return qs.stringify(query, { arrayFormat: 'comma' });
+  protected stringifyQuery(query: object | Record<string, unknown>): string {
+    return stringifyQuery(query);
   }
 
   private getUserAgent(): string {
@@ -351,7 +361,7 @@ export class Linkt {
     }
 
     if (typeof query === 'object' && query && !Array.isArray(query)) {
-      url.search = this.stringifyQuery(query as Record<string, unknown>);
+      url.search = this.stringifyQuery(query);
     }
 
     return url.toString();
@@ -535,7 +545,7 @@ export class Linkt {
       loggerFor(this).info(`${responseInfo} - ${retryMessage}`);
 
       const errText = await response.text().catch((err: any) => castToError(err).message);
-      const errJSON = safeJSON(errText);
+      const errJSON = safeJSON(errText) as any;
       const errMessage = errJSON ? undefined : errText;
 
       loggerFor(this).debug(
@@ -576,9 +586,10 @@ export class Linkt {
     controller: AbortController,
   ): Promise<Response> {
     const { signal, method, ...options } = init || {};
-    if (signal) signal.addEventListener('abort', () => controller.abort());
+    const abort = this._makeAbort(controller);
+    if (signal) signal.addEventListener('abort', abort, { once: true });
 
-    const timeout = setTimeout(() => controller.abort(), ms);
+    const timeout = setTimeout(abort, ms);
 
     const isReadableBody =
       ((globalThis as any).ReadableStream && options.body instanceof (globalThis as any).ReadableStream) ||
@@ -745,6 +756,12 @@ export class Linkt {
     return headers.values;
   }
 
+  private _makeAbort(controller: AbortController) {
+    // note: we can't just inline this method inside `fetchWithTimeout()` because then the closure
+    //       would capture all request options, and cause a memory leak.
+    return () => controller.abort();
+  }
+
   private buildBody({ options: { body, headers: rawHeaders } }: { options: FinalRequestOptions }): {
     bodyHeaders: HeadersLike;
     body: BodyInit | undefined;
@@ -777,6 +794,14 @@ export class Linkt {
         (Symbol.iterator in body && 'next' in body && typeof body.next === 'function'))
     ) {
       return { bodyHeaders: undefined, body: Shims.ReadableStreamFrom(body as AsyncIterable<Uint8Array>) };
+    } else if (
+      typeof body === 'object' &&
+      headers.values.get('content-type') === 'application/x-www-form-urlencoded'
+    ) {
+      return {
+        bodyHeaders: { 'content-type': 'application/x-www-form-urlencoded' },
+        body: this.stringifyQuery(body),
+      };
     } else {
       return this.#encoder({ body, headers });
     }
@@ -801,12 +826,31 @@ export class Linkt {
 
   static toFile = Uploads.toFile;
 
+  /**
+   * **Ideal Customer Profiles (ICPs)** define WHAT entities to target using business-level descriptions and filters. ICPs are the foundation of your research workflows - they specify targeting criteria like industry, company size, job titles, and other characteristics that define your ideal customers. Create ICPs first, then link Sheets to them for entity storage.
+   */
   icp: API.Icp = new API.Icp(this);
+  /**
+   * **Sheets** are collections WHERE entities (companies, people) are stored. Each sheet must reference an ICP that defines targeting criteria, and holds entities of a single type (company or person). Sheets support custom schemas, CSV export, and comprehensive entity filtering. Use sheets to organize and manage your research results.
+   */
   sheet: API.SheetResource = new API.SheetResource(this);
   entity: API.Entity = new API.Entity(this);
+  /**
+   * **Tasks** are reusable workflow templates that define HOW research is executed. Tasks reference Prefect flow deployments and can be configured with prompts and parameters. Create a task once, then execute it multiple times to generate runs. Each execution creates a new run that can be monitored independently.
+   */
   task: API.Task = new API.Task(this);
+  /**
+   * **Signals** are time-based events detected by AI agents that affect your entities. Examples include funding rounds, leadership changes, hiring events, and product launches. Signals are **read-only** - they are created automatically by research workflows and represent an immutable audit trail of what happened and when.
+   */
   signal: API.Signal = new API.Signal(this);
+  /**
+   * **Runs** represent individual workflow executions. When you execute a task, it creates a run that progresses through states: SCHEDULED -> PENDING -> RUNNING -> COMPLETED (or FAILED/CANCELED). Monitor run status, view processing queues, and cancel running workflows through these endpoints.
+   */
   run: API.Run = new API.Run(this);
+  schedule: API.Schedule = new API.Schedule(this);
+  /**
+   * **Files** are uploaded data sources for your research workflows. Upload CSV or XLSX files containing entities (companies, people) or monitoring targets. Files are processed and stored securely, then can be referenced when creating signal monitoring or ingest tasks. XLSX files are automatically converted to CSV format.
+   */
   files: API.Files = new API.Files(this);
 }
 
@@ -816,6 +860,7 @@ Linkt.Entity = Entity;
 Linkt.Task = Task;
 Linkt.Signal = Signal;
 Linkt.Run = Run;
+Linkt.Schedule = Schedule;
 Linkt.Files = Files;
 
 export declare namespace Linkt {
@@ -902,6 +947,17 @@ export declare namespace Linkt {
     type RunGetQueueParams as RunGetQueueParams,
   };
 
+  export {
+    Schedule as Schedule,
+    type CreateScheduleRequest as CreateScheduleRequest,
+    type ScheduleListResponse as ScheduleListResponse,
+    type ScheduleResponse as ScheduleResponse,
+    type UpdateScheduleRequest as UpdateScheduleRequest,
+    type ScheduleCreateParams as ScheduleCreateParams,
+    type ScheduleUpdateParams as ScheduleUpdateParams,
+    type ScheduleListParams as ScheduleListParams,
+  };
+
   export {
     Files as Files,
     type CsvProcessingStatus as CsvProcessingStatus,

package/src/internal/parse.ts

@@ -29,6 +29,12 @@ export async function defaultParseResponse<T>(client: Linkt, props: APIResponseP
     const mediaType = contentType?.split(';')[0]?.trim();
     const isJSON = mediaType?.includes('application/json') || mediaType?.endsWith('+json');
     if (isJSON) {
+      const contentLength = response.headers.get('content-length');
+      if (contentLength === '0') {
+        // if there is no content we can't do anything
+        return undefined as T;
+      }
+
       const json = await response.json();
       return json as T;
     }

package/src/internal/utils/query.ts

@@ -0,0 +1,7 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import * as qs from '../qs/stringify';
+
+export function stringifyQuery(query: object | Record<string, unknown>) {
+  return qs.stringify(query, { arrayFormat: 'comma' });
+}

package/src/internal/utils.ts

@@ -6,3 +6,4 @@ export * from './utils/env';
 export * from './utils/log';
 export * from './utils/uuid';
 export * from './utils/sleep';
+export * from './utils/query';

package/src/resources/entity.ts

@@ -40,7 +40,8 @@ export class Entity extends APIResource {
    *
    * Supports filtering by:
    *
-   * - icp_id: Entities in sheets belonging to an ICP
+   * - icp_id: Entities in sheets belonging to ICP(s). Supports multiple values for
+   *   filtering across ICPs (e.g., ?icp_id=abc&icp_id=def).
    * - sheet_id: Entities in a specific sheet
    * - entity_type: Entities of a specific type (company, person, etc.)
    * - status: Filter by workflow status (supports multiple:
@@ -131,10 +132,12 @@ export class Entity extends APIResource {
    *   ?status=new&status=contacted) Valid values: new, reviewed, passed, contacted,
    *   null
    *
-   * Args: icp_id: Filter by ICP ID (REQUIRED for format=combined) sheet_id: Filter
-   * by sheet ID entity_type: Filter by entity type (ignored for format=combined)
-   * entity_ids: Export specific entity IDs status: Filter by status values (multiple
-   * allowed) format: Export format - "separate" (default) or "combined"
+   * Args: icp_id: Filter by ICP ID(s). Supports multiple values for separate format
+   * (e.g., ?icp_id=abc&icp_id=def). Combined format only supports a single ICP.
+   * sheet_id: Filter by sheet ID entity_type: Filter by entity type (ignored for
+   * format=combined) entity_ids: Export specific entity IDs status: Filter by status
+   * values (multiple allowed) hide_duplicates: Exclude duplicate entities from
+   * export format: Export format - "separate" (default) or "combined"
    *
    * Returns: StreamingResponse with CSV content
    *
@@ -149,13 +152,16 @@ export class Entity extends APIResource {
    * Get entity counts grouped by entity_type.
    *
    * Returns the count of entities for each entity_type (company, person, etc.)
-   * across the organization. Supports optional filtering by ICP or status.
+   * across the organization. Supports optional filtering by ICP(s) or status.
    *
-   * Additional filtering:
+   * Filtering options:
    *
+   * - icp_id: Filter by ICP ID(s). Supports multiple values for counting across ICPs
+   *   (e.g., ?icp_id=abc&icp_id=def).
    * - status: Filter by workflow status (supports multiple:
    *   ?status=new&status=reviewed) Valid values: new, reviewed, passed, contacted,
    *   null
+   * - hide_duplicates: When true, excludes duplicate entities from counts
    *
    * Used by Entity Master List for accurate tab navigation counts.
    */
@@ -175,7 +181,8 @@ export class Entity extends APIResource {
    * Scope of search determined by filters:
    *
    * - sheet_id: Search within specific sheet
-   * - icp_id: Search across ICP sheets
+   * - icp_id: Search across ICP sheet(s). Supports multiple values for searching
+   *   across ICPs (e.g., ?icp_id=abc&icp_id=def).
    * - No filters: Search org-wide
    *
    * Additional filtering:
@@ -469,7 +476,7 @@ export interface EntityUpdateParams {
 
 export interface EntityListParams {
   /**
-   * Valid entity types for sheets.
+   * Filter by entity type
    */
   entity_type?: SheetAPI.EntityType | null;
 
@@ -479,9 +486,9 @@ export interface EntityListParams {
   hide_duplicates?: boolean;
 
   /**
-   * Filter by ICP ID
+   * Filter by ICP ID(s) - supports multiple
    */
-  icp_id?: string | null;
+  icp_id?: Array<string> | null;
 
   /**
    * Page number (1-based)
@@ -533,7 +540,7 @@ export interface EntityExportParams {
   entity_ids?: Array<string> | null;
 
   /**
-   * Valid entity types for sheets.
+   * Filter by entity type
    */
   entity_type?: SheetAPI.EntityType | null;
 
@@ -543,9 +550,14 @@ export interface EntityExportParams {
   format?: 'separate' | 'combined';
 
   /**
-   * Filter by ICP ID
+   * Exclude duplicate entities from export (show only primaries)
+   */
+  hide_duplicates?: boolean;
+
+  /**
+   * Filter by ICP ID(s) - supports multiple
    */
-  icp_id?: string | null;
+  icp_id?: Array<string> | null;
 
   /**
    * Filter by sheet ID
@@ -560,9 +572,14 @@ export interface EntityExportParams {
 
 export interface EntityGetCountsParams {
   /**
-   * Filter by ICP ID
+   * Exclude duplicate entities from counts (show only primaries)
+   */
+  hide_duplicates?: boolean;
+
+  /**
+   * Filter by ICP ID(s) - supports multiple
    */
-  icp_id?: string | null;
+  icp_id?: Array<string> | null;
 
   /**
    * Filter by status values (supports multiple: ?status=new&status=passed)
@@ -577,7 +594,7 @@ export interface EntitySearchParams {
   q: string;
 
   /**
-   * Valid entity types for sheets.
+   * Filter by entity type
    */
   entity_type?: SheetAPI.EntityType | null;
 
@@ -587,9 +604,9 @@ export interface EntitySearchParams {
   hide_duplicates?: boolean;
 
   /**
-   * Filter by ICP ID
+   * Filter by ICP ID(s) - supports multiple
    */
-  icp_id?: string | null;
+  icp_id?: Array<string> | null;
 
   /**
    * Page number

package/src/resources/files.ts

@@ -2,11 +2,13 @@
 
 import { APIResource } from '../core/resource';
 import { APIPromise } from '../core/api-promise';
-import { type Uploadable } from '../core/uploads';
 import { RequestOptions } from '../internal/request-options';
 import { multipartFormRequestOptions } from '../internal/uploads';
 import { path } from '../internal/utils/path';
 
+/**
+ * **Files** are uploaded data sources for your research workflows. Upload CSV or XLSX files containing entities (companies, people) or monitoring targets. Files are processed and stored securely, then can be referenced when creating signal monitoring or ingest tasks. XLSX files are automatically converted to CSV format.
+ */
 export class Files extends APIResource {
   /**
    * Get file details by ID.
@@ -204,7 +206,7 @@ export interface FileUploadParams {
   /**
    * CSV or XLSX file to upload
    */
-  file: Uploadable;
+  file: string;
 }
 
 export declare namespace Files {

package/src/resources/icp.ts

@@ -6,6 +6,9 @@ import { buildHeaders } from '../internal/headers';
 import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
 
+/**
+ * **Ideal Customer Profiles (ICPs)** define WHAT entities to target using business-level descriptions and filters. ICPs are the foundation of your research workflows - they specify targeting criteria like industry, company size, job titles, and other characteristics that define your ideal customers. Create ICPs first, then link Sheets to them for entity storage.
+ */
 export class Icp extends APIResource {
   /**
    * Create a new Ideal Customer Profile (ICP).
@@ -136,6 +139,16 @@ export interface IcpResponse {
   name: string;
 
   updated_at: string;
+
+  /**
+   * v2 entity structure (lightweight, no descriptions)
+   */
+  entity_structure?: Array<IcpResponse.EntityStructure> | null;
+
+  /**
+   * ICP schema version (1 or 2)
+   */
+  schema_version?: number;
 }
 
 export namespace IcpResponse {
@@ -176,6 +189,29 @@ export namespace IcpResponse {
      */
     desired_count?: number | null;
   }
+
+  /**
+   * Response model for v2 entity structure entry.
+   *
+   * Lightweight structure that defines entity types and their hierarchy without the
+   * business description (which lives on sheets in v2).
+   */
+  export interface EntityStructure {
+    /**
+     * Entity type (company, person, etc.)
+     */
+    entity_type: string;
+
+    /**
+     * If this is the root entity type
+     */
+    root: boolean;
+
+    /**
+     * For non-root entities, desired count per parent
+     */
+    desired_count?: number | null;
+  }
 }
 
 /**

package/src/resources/index.ts

@@ -44,6 +44,16 @@ export {
   type RunListParams,
   type RunGetQueueParams,
 } from './run';
+export {
+  Schedule,
+  type CreateScheduleRequest,
+  type ScheduleListResponse,
+  type ScheduleResponse,
+  type UpdateScheduleRequest,
+  type ScheduleCreateParams,
+  type ScheduleUpdateParams,
+  type ScheduleListParams,
+} from './schedule';
 export {
   SheetResource,
   type EntityType,

package/src/resources/run.ts

@@ -6,6 +6,9 @@ import { buildHeaders } from '../internal/headers';
 import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
 
+/**
+ * **Runs** represent individual workflow executions. When you execute a task, it creates a run that progresses through states: SCHEDULED -> PENDING -> RUNNING -> COMPLETED (or FAILED/CANCELED). Monitor run status, view processing queues, and cancel running workflows through these endpoints.
+ */
 export class Run extends APIResource {
   /**
    * Execute an agent by creating a new run.