@epilot/sdk 2.18.33 → 2.19.0

package/docs/entity.md

@@ -232,6 +232,7 @@ const { data } = await entityClient.listSchemas(...)
 - [`GraphSeed`](#graphseed)
 - [`GraphDefinition`](#graphdefinition)
 - [`GraphNode`](#graphnode)
+- [`GraphNodeFilter`](#graphnodefilter)
 - [`GraphEdge`](#graphedge)
 - [`GraphQueryResponse`](#graphqueryresponse)
 - [`EntitySearchResults`](#entitysearchresults)
@@ -491,6 +492,10 @@ const { data } = await client.getSchema({
     "widget_visibility": {
       "next_best_action": true,
       "address_map": false
+    },
+    "widget_widths": {
+      "address_map": "full_width",
+      "recent_communications": "one_third_width"
     }
   },
   "capabilities": [
@@ -649,6 +654,10 @@ const { data } = await client.putSchema(
       widget_visibility: {
         next_best_action: true,
         address_map: false
+      },
+      widget_widths: {
+        address_map: 'full_width',
+        recent_communications: 'one_third_width'
       }
     },
     capabilities: [
@@ -807,6 +816,10 @@ const { data } = await client.putSchema(
     "widget_visibility": {
       "next_best_action": true,
       "address_map": false
+    },
+    "widget_widths": {
+      "address_map": "full_width",
+      "recent_communications": "one_third_width"
     }
   },
   "capabilities": [
@@ -1257,6 +1270,10 @@ const { data } = await client.freezeSchema(
     "widget_visibility": {
       "next_best_action": true,
       "address_map": false
+    },
+    "widget_widths": {
+      "address_map": "full_width",
+      "recent_communications": "one_third_width"
     }
   },
   "capabilities": [
@@ -1429,6 +1446,10 @@ const { data } = await client.unfreezeSchema({
     "widget_visibility": {
       "next_best_action": true,
       "address_map": false
+    },
+    "widget_widths": {
+      "address_map": "full_width",
+      "recent_communications": "one_third_width"
     }
   },
   "capabilities": [
@@ -5215,6 +5236,7 @@ const { data } = await client.createSchemaCapability(
         header: true,
         requiredPermission: { /* ... */ },
         default_visible: false,
+        default_width: 'half_width',
         pricing_tier_setting: 'entity_address_maps'
       }
     ],
@@ -5350,6 +5372,7 @@ const { data } = await client.createSchemaCapability(
       "header": true,
       "requiredPermission": {},
       "default_visible": false,
+      "default_width": "half_width",
       "pricing_tier_setting": "entity_address_maps"
     }
   ],
@@ -5500,6 +5523,7 @@ const { data } = await client.getSchemaCapability({
       "header": true,
       "requiredPermission": {},
       "default_visible": false,
+      "default_width": "half_width",
       "pricing_tier_setting": "entity_address_maps"
     }
   ],
@@ -5646,6 +5670,7 @@ const { data } = await client.putSchemaCapability(
         header: true,
         requiredPermission: { /* ... */ },
         default_visible: false,
+        default_width: 'half_width',
         pricing_tier_setting: 'entity_address_maps'
       }
     ],
@@ -5781,6 +5806,7 @@ const { data } = await client.putSchemaCapability(
       "header": true,
       "requiredPermission": {},
       "default_visible": false,
+      "default_width": "half_width",
       "pricing_tier_setting": "entity_address_maps"
     }
   ],
@@ -5931,6 +5957,7 @@ const { data } = await client.deleteSchemaCapability({
       "header": true,
       "requiredPermission": {},
       "default_visible": false,
+      "default_width": "half_width",
       "pricing_tier_setting": "entity_address_maps"
     }
   ],
@@ -6468,6 +6495,7 @@ type EntitySchema = {
     }
     widget_order?: string[]
     widget_visibility?: Record<string, boolean>
+    widget_widths?: Record<string, "one_third_width" | "half_width" | "two_third_width" | "full_width">
   }
   capabilities: Array<{
     id?: string
@@ -6495,7 +6523,6 @@ type EntitySchema = {
       data_classification?: { ... }
       _purpose?: { ... }
       _manifest?: { ... }
-      constraints?: { ... }
   // ...
 }
 ```
@@ -6586,6 +6613,7 @@ type EntitySchemaItem = {
     }
     widget_order?: string[]
     widget_visibility?: Record<string, boolean>
+    widget_widths?: Record<string, "one_third_width" | "half_width" | "two_third_width" | "full_width">
   }
   capabilities: Array<{
     id?: string
@@ -6602,7 +6630,6 @@ type EntitySchemaItem = {
       required?: { ... }
       readonly?: { ... }
       deprecated?: { ... }
-      variant_overridable?: { ... }
   // ...
 }
 ```
@@ -10636,6 +10663,7 @@ type GraphQueryRequest = {
       schema: { ... }
       cardinality?: { ... }
       fields?: { ... }
+      filter?: { ... }
     }>
     edges: Array<{
       from: { ... }
@@ -10665,6 +10693,10 @@ type GraphDefinition = {
     schema: string
     cardinality?: "one" | "many"
     fields?: object
+    filter?: Array<{
+      attribute: { ... }
+      value: { ... }
+    }>
   }>
   edges: Array<{
     from: string
@@ -10681,6 +10713,21 @@ type GraphNode = {
   schema: string
   cardinality?: "one" | "many"
   fields?: object
+  filter?: Array<{
+    attribute: string
+    value: object
+  }>
+}
+```
+
+### `GraphNodeFilter`
+
+Entities are included in this node's result only if `attribute` exactly equals the literal `value`.
+
+```ts
+type GraphNodeFilter = {
+  attribute: string
+  value: object
 }
 ```
 

package/docs/integration-toolkit.md

@@ -2684,7 +2684,10 @@ const { data } = await client.getEntitySyncStatus({
       "last_synced_at": "1970-01-01T00:00:00.000Z",
       "last_changed_at": "1970-01-01T00:00:00.000Z",
       "last_operation": "create",
-      "last_event_id": "string"
+      "last_event_id": "string",
+      "readings_last_synced_at": "1970-01-01T00:00:00.000Z",
+      "readings_last_operation": "upsert",
+      "readings_last_event_id": "string"
     }
   ]
 }
@@ -7783,7 +7786,7 @@ The sc
 
 ```ts
 type DirectPayload = {
-  version: "1"
+  version: string
   operations: Array<{
     type?: "entity"
     entity_slug: string
@@ -8031,7 +8034,7 @@ type DirectSimulationRequest = {
     }>
   }
   payload: string | {
-    version: "1"
+    version: string
     operations: Array<{
       type?: { ... }
       entity_slug: { ... }
@@ -8333,26 +8336,38 @@ type EntitySyncStatusResponse = {
     integration_id: string // uuid
     entity_slug: string
     use_case_id?: string
-    last_synced_at: string // date-time
+    last_synced_at?: string // date-time
     last_changed_at?: string // date-time
-    last_operation: "create" | "patch" | "delete" | "no-op"
+    last_operation?: "create" | "patch" | "delete" | "no-op"
     last_event_id?: string
+    readings_last_synced_at?: string // date-time
+    readings_last_operation?: "upsert" | "delete"
+    readings_last_event_id?: string
   }>
 }
 ```
 
 ### `EntitySyncState`
 
+Inbound sync state of one entity for one integration. Carries two
+independent groups: the entity-level fields (`last_synced_at`, …) and,
+on meter/meter_counter entities, the readings-level fields
+(`readings_last_synced_at`, …). Either group can be present alone — a
+meter whose readings sync via the 
+
 ```ts
 type EntitySyncState = {
   entity_id: string // uuid
   integration_id: string // uuid
   entity_slug: string
   use_case_id?: string
-  last_synced_at: string // date-time
+  last_synced_at?: string // date-time
   last_changed_at?: string // date-time
-  last_operation: "create" | "patch" | "delete" | "no-op"
+  last_operation?: "create" | "patch" | "delete" | "no-op"
   last_event_id?: string
+  readings_last_synced_at?: string // date-time
+  readings_last_operation?: "upsert" | "delete"
+  readings_last_event_id?: string
 }
 ```
 

package/docs/pricing.md

@@ -2673,14 +2673,14 @@ type CreatedVariant = {
   }
   valid_from: string
   values: Record<string, unknown>
-  _created_at?: string
-  _updated_at?: string
-  _revision?: number
+  _created_at: string
+  _updated_at: string
+  _revision: number
   warnings: Array<{
     code: "VARIANT_COUNT_APPROACHING_CAP"
     message: string
-    variant_count?: number
-    cap?: number
+    variant_count: number
+    cap: number
   }>
 }
 ```
@@ -2691,8 +2691,8 @@ type CreatedVariant = {
 type VariantWriteWarning = {
   code: "VARIANT_COUNT_APPROACHING_CAP"
   message: string
-  variant_count?: number
-  cap?: number
+  variant_count: number
+  cap: number
 }
 ```
 
@@ -2726,9 +2726,9 @@ type VariantVersion = {
   }
   valid_from: string
   values: Record<string, unknown>
-  _created_at?: string
-  _updated_at?: string
-  _revision?: number
+  _created_at: string
+  _updated_at: string
+  _revision: number
 }
 ```
 
@@ -2747,9 +2747,9 @@ type WrittenVariantVersion = {
   }
   valid_from: string
   values: Record<string, unknown>
-  _created_at?: string
-  _updated_at?: string
-  _revision?: number
+  _created_at: string
+  _updated_at: string
+  _revision: number
   warnings: Array<{
     code: "ACTIVE_VERSION_REPLACED" | "SUPERSEDED_VERSION_WRITTEN"
     message: string

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/sdk",
-  "version": "2.18.33",
+  "version": "2.19.0",
   "description": "JavaScript/TypeScript SDK for epilot APIs",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -322,6 +322,16 @@
     },
     "./workflow-definition/openapi.json": "./definitions/workflow-definition.json"
   },
+  "scripts": {
+    "generate": "tsx ../../scripts/generate-sdk-v2.ts && pnpm lint:fix",
+    "build": "tsup",
+    "build:watch": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "biome check src",
+    "lint:fix": "biome check src --fix",
+    "prepublishOnly": "npm run build"
+  },
   "keywords": [
     "epilot",
     "sdk",
@@ -515,14 +525,5 @@
         "./dist/apis/workflow-definition.d.ts"
       ]
     }
-  },
-  "scripts": {
-    "generate": "tsx ../../scripts/generate-sdk-v2.ts && pnpm lint:fix",
-    "build": "tsup",
-    "build:watch": "tsup --watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "lint": "biome check src",
-    "lint:fix": "biome check src --fix"
   }
-}
+}