feat: query param validation block label, name, and search

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 120
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/letta-ai%2Fletta-sdk-afdf4ae7c1cb0b39ce5335cba48c323f3c2a9bbc7b45fece5e34808b653d719a.yml
-openapi_spec_hash: 09eed5aba1df735c4ef61f9a2aa893be
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/letta-ai%2Fletta-sdk-425729f06b756964361130ca46d9dec782de4ea1c06a1691d6be19965667ff9e.yml
+openapi_spec_hash: 9fe0eda067aeafb8645187fefbe315b3
 config_hash: 87d5500eb085219e03a7ac7cddc146fc

src/resources/blocks/blocks.ts

@@ -394,8 +394,8 @@ export interface BlockListParams extends ArrayPageParams {
   connected_to_agents_count_lt?: number | null;
 
   /**
-   * Search blocks by description. If provided, returns blocks that match this
-   * description. This is a full-text search on block descriptions.
+   * Search blocks by description. If provided, returns blocks whose description
+   * matches the search query. This is a full-text search on block descriptions.
    */
   description_search?: string | null;
 
@@ -405,23 +405,23 @@ export interface BlockListParams extends ArrayPageParams {
   identifier_keys?: Array<string> | null;
 
   /**
-   * Search agents by identifier id
+   * The ID of the identity in the format 'identity-<uuid4>'
    */
   identity_id?: string | null;
 
   /**
-   * Labels to include (e.g. human, persona)
+   * Label to include (alphanumeric, hyphens, underscores only)
    */
   label?: string | null;
 
   /**
-   * Search blocks by label. If provided, returns blocks that match this label. This
-   * is a full-text search on labels.
+   * Search blocks by label. If provided, returns blocks whose label matches the
+   * search query. This is a full-text search on block labels.
    */
   label_search?: string | null;
 
   /**
-   * Name of the block
+   * Name filter (alphanumeric, spaces, hyphens, underscores)
    */
   name?: string | null;
 
@@ -436,7 +436,8 @@ export interface BlockListParams extends ArrayPageParams {
   templates_only?: boolean;
 
   /**
-   * Search blocks by value. If provided, returns blocks that match this value.
+   * Search blocks by value. If provided, returns blocks whose value matches the
+   * search query. This is a full-text search on block values.
    */
   value_search?: string | null;
 }

tests/api-resources/blocks/blocks.test.ts

@@ -88,18 +88,18 @@ describe('resource blocks', () => {
           connected_to_agents_count_eq: [0, 0],
           connected_to_agents_count_gt: 0,
           connected_to_agents_count_lt: 0,
-          description_search: 'description_search',
+          description_search: 'x',
           identifier_keys: ['string', 'string'],
-          identity_id: 'identity_id',
-          label: 'label',
-          label_search: 'label_search',
+          identity_id: 'identity-123e4567-e89b-42d3-8456-426614174000',
+          label: 'human',
+          label_search: 'human',
           limit: 0,
-          name: 'name',
+          name: 'My Agent',
           order: 'asc',
           order_by: 'created_at',
           project_id: 'project_id',
           templates_only: true,
-          value_search: 'value_search',
+          value_search: 'x',
         },
         { path: '/_stainless_unknown_path' },
       ),