@linkt/sdk 0.2.0 → 0.4.0

package/src/resources/icp.ts

@@ -51,8 +51,8 @@ export class Icp extends APIResource {
    * Delete an ICP and all related resources.
    *
    * **Cascade delete**: This permanently removes the ICP along with all associated
-   * sheets, entities, schedules, tasks, and signals. This operation cannot be
-   * undone.
+   * sheets, entities, schedules, tasks, signals, and actions. This operation cannot
+   * be undone.
    */
   delete(icpID: string, options?: RequestOptions): APIPromise<void> {
     return this._client.delete(path`/v1/icp/${icpID}`, {
@@ -74,6 +74,23 @@ export class Icp extends APIResource {
 
 /**
  * Request model for entity target configuration.
+ *
+ * Synchronized with core.schema.mongo.icp.EntityTargetConfig to ensure all fields
+ * available in the database model can be set via the API.
+ *
+ * Attributes: entity_type: The entity type to target (e.g., 'company', 'person').
+ * description: Business description of what makes a good target. root: If True,
+ * this is the root entity type of the search hierarchy. Only one entity target
+ * should be marked as root. Defaults to False for backward compatibility with
+ * existing API consumers. desired_count: For non-root entities, the desired number
+ * of entities per parent (minimum: 1). Uses `ge=1` Field constraint which
+ * generates `minimum: 1` in OpenAPI schema for SDK validation. If not specified,
+ * defaults to system minimum (typically 2). filters: Optional list of filter
+ * criteria to apply to the search.
+ *
+ * Note: The `root` and `desired_count` fields default to False and None
+ * respectively, making them optional in API requests for backward compatibility
+ * with existing integrations.
  */
 export interface EntityTargetConfig {
   /**
@@ -82,14 +99,26 @@ export interface EntityTargetConfig {
   description: string;
 
   /**
-   * Entity type to target
+   * Entity type to target (company, person, etc.)
    */
   entity_type: string;
 
+  /**
+   * For non-root entities, desired count per parent (minimum: 1). If not specified,
+   * defaults to system minimum.
+   */
+  desired_count?: number | null;
+
   /**
    * Filters to apply
    */
   filters?: Array<string>;
+
+  /**
+   * If this is the root entity type of the search. Only one entity target should be
+   * root.
+   */
+  root?: boolean;
 }
 
 /**
@@ -112,13 +141,40 @@ export interface IcpResponse {
 export namespace IcpResponse {
   /**
    * Response model for entity target configuration.
+   *
+   * Synchronized with core.schema.mongo.icp.EntityTargetConfig to return all
+   * configuration fields stored in the database to API consumers.
+   *
+   * Attributes: root: If True, this is the root entity type of the search hierarchy.
+   * entity_type: The entity type this config targets (e.g., 'company', 'person').
+   * description: Business description of what makes a good target. desired_count:
+   * For non-root entities, the desired number of entities per parent. Returns None
+   * if not explicitly set in the ICP.
+   *
+   * Note: The `desired_count` field is included in responses to enable API consumers
+   * to see the full configuration. When None, the system applies its default minimum
+   * (typically 2).
    */
   export interface EntityTarget {
+    /**
+     * Business description of targets
+     */
     description: string;
 
+    /**
+     * 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

@@ -1,5 +1,20 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+export {
+  Entity,
+  type EntityResponse,
+  type EntityListResponse,
+  type EntityBulkUpdateStatusResponse,
+  type EntityExportResponse,
+  type EntityGetCountsResponse,
+  type EntitySearchResponse,
+  type EntityUpdateParams,
+  type EntityListParams,
+  type EntityBulkUpdateStatusParams,
+  type EntityExportParams,
+  type EntityGetCountsParams,
+  type EntitySearchParams,
+} from './entity';
 export {
   Files,
   type CsvProcessingStatus,
@@ -34,25 +49,27 @@ export {
   type EntityType,
   type Sheet,
   type SheetListResponse,
-  type SheetExportCsvResponse,
-  type SheetGetEntitiesResponse,
   type SheetCreateParams,
   type SheetUpdateParams,
   type SheetListParams,
-  type SheetExportCsvParams,
-  type SheetGetEntitiesParams,
 } from './sheet/sheet';
 export { Signal, type SignalResponse, type SignalListResponse, type SignalListParams } from './signal';
 export {
   Task,
+  type IngestPromptConfigResponse,
   type IngestTaskConfig,
-  type SearchV2Config,
-  type SearchV3Config,
-  type SignalCsvConfigInput,
-  type SignalSheetConfigInput,
-  type SignalTopicConfigInput,
+  type IngestTaskConfigResponse,
+  type ProfilePromptConfig,
+  type ProfilePromptConfigResponse,
+  type SearchTaskConfig,
+  type SearchTaskConfigResponse,
+  type SignalCsvConfig,
+  type SignalCsvConfigResponse,
+  type SignalSheetConfig,
+  type SignalSheetConfigResponse,
+  type SignalTopicConfig,
+  type SignalTopicConfigResponse,
   type SignalTypeConfig,
-  type StandardPromptConfig,
   type TaskCreateResponse,
   type TaskRetrieveResponse,
   type TaskListResponse,

package/src/resources/run.ts

@@ -126,9 +126,9 @@ export type RunRetrieveResponse = { [key: string]: unknown };
  * - SheetListResponse (src/api/schema/sheet.py)
  * - ICPListResponse (src/api/schema/icp.py)
  *
- * Attributes: runs: List of AgentRun objects for the current page total: Total
- * number of runs matching the filter criteria page: Current page number (1-based)
- * page_size: Number of items per page
+ * Attributes: runs: List of AgentRun objects for the current page (metadata
+ * excluded) total: Total number of runs matching the filter criteria page: Current
+ * page number (1-based) page_size: Number of items per page
  */
 export interface RunListResponse {
   page: number;

package/src/resources/sheet/index.ts

@@ -1,12 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export {
-  Entity,
-  type EntityRetrieveResponse,
-  type EntityRetrieveParams,
-  type EntityUpdateCommentsParams,
-  type EntityUpdateStatusParams,
-} from './entity';
 export {
   Schema,
   type SchemaGetResponse,
@@ -20,11 +13,7 @@ export {
   type EntityType,
   type Sheet,
   type SheetListResponse,
-  type SheetExportCsvResponse,
-  type SheetGetEntitiesResponse,
   type SheetCreateParams,
   type SheetUpdateParams,
   type SheetListParams,
-  type SheetExportCsvParams,
-  type SheetGetEntitiesParams,
 } from './sheet';

package/src/resources/sheet/sheet.ts

@@ -1,14 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
-import * as EntityAPI from './entity';
-import {
-  Entity,
-  EntityRetrieveParams,
-  EntityRetrieveResponse,
-  EntityUpdateCommentsParams,
-  EntityUpdateStatusParams,
-} from './entity';
 import * as SchemaAPI from './schema';
 import {
   Schema,
@@ -24,7 +16,6 @@ import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
 export class SheetResource extends APIResource {
-  entity: EntityAPI.Entity = new EntityAPI.Entity(this._client);
   schema: SchemaAPI.Schema = new SchemaAPI.Schema(this._client);
 
   /**
@@ -83,34 +74,6 @@ export class SheetResource extends APIResource {
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
-
-  /**
-   * Export sheet entities as a CSV file.
-   *
-   * Exports entities with proper field formatting based on the sheet's schema. Pass
-   * specific entity_ids to export a subset, or omit to export all entities.
-   */
-  exportCsv(
-    sheetID: string,
-    query: SheetExportCsvParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<unknown> {
-    return this._client.get(path`/v1/sheet/${sheetID}/export-csv`, { query, ...options });
-  }
-
-  /**
-   * List all entities in a sheet.
-   *
-   * Supports text search across name/company fields and comprehensive filtering by
-   * status, comments, and date ranges.
-   */
-  getEntities(
-    sheetID: string,
-    query: SheetGetEntitiesParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<SheetGetEntitiesResponse> {
-    return this._client.get(path`/v1/sheet/${sheetID}/entities`, { query, ...options });
-  }
 }
 
 /**
@@ -152,28 +115,6 @@ export interface SheetListResponse {
   total: number;
 }
 
-export type SheetExportCsvResponse = unknown;
-
-/**
- * Response schema for paginated list of sheet entities.
- *
- * Uses EntityForHTTP which automatically excludes embedding data for efficient API
- * responses.
- *
- * Attributes: entities: List of EntityForHTTP objects for the current page total:
- * Total number of entities matching the filter criteria page: Current page number
- * (1-based) page_size: Number of items per page
- */
-export interface SheetGetEntitiesResponse {
-  entities: Array<{ [key: string]: unknown }>;
-
-  page: number;
-
-  page_size: number;
-
-  total: number;
-}
-
 export interface SheetCreateParams {
   description: string;
 
@@ -218,71 +159,6 @@ export interface SheetListParams {
   sort_by?: string | null;
 }
 
-export interface SheetExportCsvParams {
-  /**
-   * Optional list of entity IDs to export. If not provided, exports all entities.
-   */
-  entity_ids?: Array<string> | null;
-}
-
-export interface SheetGetEntitiesParams {
-  /**
-   * Filter entities created after this date (ISO 8601 format: 2024-01-15T10:30:00Z)
-   */
-  created_after?: string | null;
-
-  /**
-   * Filter entities created before this date (ISO 8601 format)
-   */
-  created_before?: string | null;
-
-  /**
-   * Filter entities with or without user comments
-   */
-  has_comments?: boolean | null;
-
-  /**
-   * Sort order: -1 for descending, 1 for ascending
-   */
-  order?: number | null;
-
-  /**
-   * Page number (1-based)
-   */
-  page?: number;
-
-  /**
-   * Items per page (max 100, default 50)
-   */
-  page_size?: number;
-
-  /**
-   * Search entities by name or company
-   */
-  search?: string | null;
-
-  /**
-   * Field to sort by (e.g., 'created_at', 'updated_at', 'status')
-   */
-  sort_by?: string | null;
-
-  /**
-   * Filter by entity status (true=active, false=inactive)
-   */
-  status?: boolean | null;
-
-  /**
-   * Filter entities updated after this date (ISO 8601 format)
-   */
-  updated_after?: string | null;
-
-  /**
-   * Filter entities updated before this date (ISO 8601 format)
-   */
-  updated_before?: string | null;
-}
-
-SheetResource.Entity = Entity;
 SheetResource.Schema = Schema;
 
 export declare namespace SheetResource {
@@ -290,21 +166,9 @@ export declare namespace SheetResource {
     type EntityType as EntityType,
     type Sheet as Sheet,
     type SheetListResponse as SheetListResponse,
-    type SheetExportCsvResponse as SheetExportCsvResponse,
-    type SheetGetEntitiesResponse as SheetGetEntitiesResponse,
     type SheetCreateParams as SheetCreateParams,
     type SheetUpdateParams as SheetUpdateParams,
     type SheetListParams as SheetListParams,
-    type SheetExportCsvParams as SheetExportCsvParams,
-    type SheetGetEntitiesParams as SheetGetEntitiesParams,
-  };
-
-  export {
-    Entity as Entity,
-    type EntityRetrieveResponse as EntityRetrieveResponse,
-    type EntityRetrieveParams as EntityRetrieveParams,
-    type EntityUpdateCommentsParams as EntityUpdateCommentsParams,
-    type EntityUpdateStatusParams as EntityUpdateStatusParams,
   };
 
   export {