@utdk/posthog 1.0.0-20260712.5-dev.e2949a6

package/docs/warehouse_column_annotations.md

@@ -0,0 +1,224 @@
+# Warehouse Column Annotations
+
+## Operations
+
+### `posthog.warehouseColumnAnnotationsList`
+
+- **HTTP**: `GET /api/projects/{project_id}/warehouse_column_annotations/`
+- **What it does**: Read and edit semantic descriptions of warehouse tables and columns surfaced to the AI agent.
+
+List can be filtered to one table with `?table_id=<uuid>`. Any create or update is treated as a
+user edit (`is_user_edited=True`), which protects the row from being overwritten by automatic
+enrichment. Create upserts on `(table, column_name)`; the table cannot be changed after creation.
+- **OpenAPI operationId**: `warehouse_column_annotations_list`
+- **Path params**: None
+- **Query params**: `limit`, `offset`, `table_id`
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ count: number; next?: string | null; previous?: string | null; results: ({ id: string; table: string; column_name?: string; description: string; description_source: "canonical" | "ai_generated" | "user_edited"; ai_mod...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type WarehouseColumnAnnotationsListInput = Parameters<typeof posthog.warehouseColumnAnnotationsList> extends [infer T, ...unknown[]] ? T : undefined;
+type WarehouseColumnAnnotationsListOutput = Awaited<ReturnType<typeof posthog.warehouseColumnAnnotationsList>>;
+
+const result: WarehouseColumnAnnotationsListOutput = await posthog.warehouseColumnAnnotationsList();
+
+// Result shape (from schema): { count: number; next?: string | null; previous?: string | null; results: ({ id: string; table: string; column_name?: string; description: string; description_source: "canonical" | "ai_generated" | "user_edited"; ai_mod...
+```
+
+### `posthog.warehouseColumnAnnotationsCreate`
+
+- **HTTP**: `POST /api/projects/{project_id}/warehouse_column_annotations/`
+- **What it does**: Read and edit semantic descriptions of warehouse tables and columns surfaced to the AI agent.
+
+List can be filtered to one table with `?table_id=<uuid>`. Any create or update is treated as a
+user edit (`is_user_edited=True`), which protects the row from being overwritten by automatic
+enrichment. Create upserts on `(table, column_name)`; the table cannot be changed after creation.
+- **OpenAPI operationId**: `warehouse_column_annotations_create`
+- **Path params**: None
+- **Query params**: None
+- **Response codes**: `201`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ id: string; table: string; column_name?: string; description: string; description_source: "canonical" | "ai_generated" | "user_edited"; ai_model: string; is_user_edited: boolean; created_at: string; updated_at: string...`
+- OpenAPI response codes: `201`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type WarehouseColumnAnnotationsCreateInput = Parameters<typeof posthog.warehouseColumnAnnotationsCreate> extends [infer T, ...unknown[]] ? T : undefined;
+type WarehouseColumnAnnotationsCreateOutput = Awaited<ReturnType<typeof posthog.warehouseColumnAnnotationsCreate>>;
+
+const result: WarehouseColumnAnnotationsCreateOutput = await posthog.warehouseColumnAnnotationsCreate();
+
+// Result shape (from schema): { id: string; table: string; column_name?: string; description: string; description_source: "canonical" | "ai_generated" | "user_edited"; ai_model: string; is_user_edited: boolean; created_at: string; updated_at: string...
+```
+
+### `posthog.warehouseColumnAnnotationsDestroy`
+
+- **HTTP**: `DELETE /api/projects/{project_id}/warehouse_column_annotations/{id}/`
+- **What it does**: Read and edit semantic descriptions of warehouse tables and columns surfaced to the AI agent.
+
+List can be filtered to one table with `?table_id=<uuid>`. Any create or update is treated as a
+user edit (`is_user_edited=True`), which protects the row from being overwritten by automatic
+enrichment. Create upserts on `(table, column_name)`; the table cannot be changed after creation.
+- **OpenAPI operationId**: `warehouse_column_annotations_destroy`
+- **Path params**: `id`
+- **Query params**: None
+- **Response codes**: `204`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `unknown`
+- OpenAPI response codes: `204`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type WarehouseColumnAnnotationsDestroyInput = Parameters<typeof posthog.warehouseColumnAnnotationsDestroy> extends [infer T, ...unknown[]] ? T : undefined;
+type WarehouseColumnAnnotationsDestroyOutput = Awaited<ReturnType<typeof posthog.warehouseColumnAnnotationsDestroy>>;
+
+const result: WarehouseColumnAnnotationsDestroyOutput = await posthog.warehouseColumnAnnotationsDestroy();
+
+// Result shape (from schema): unknown
+```
+
+### `posthog.warehouseColumnAnnotationsRetrieve`
+
+- **HTTP**: `GET /api/projects/{project_id}/warehouse_column_annotations/{id}/`
+- **What it does**: Read and edit semantic descriptions of warehouse tables and columns surfaced to the AI agent.
+
+List can be filtered to one table with `?table_id=<uuid>`. Any create or update is treated as a
+user edit (`is_user_edited=True`), which protects the row from being overwritten by automatic
+enrichment. Create upserts on `(table, column_name)`; the table cannot be changed after creation.
+- **OpenAPI operationId**: `warehouse_column_annotations_retrieve`
+- **Path params**: `id`
+- **Query params**: None
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ id: string; table: string; column_name?: string; description: string; description_source: "canonical" | "ai_generated" | "user_edited"; ai_model: string; is_user_edited: boolean; created_at: string; updated_at: string...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type WarehouseColumnAnnotationsRetrieveInput = Parameters<typeof posthog.warehouseColumnAnnotationsRetrieve> extends [infer T, ...unknown[]] ? T : undefined;
+type WarehouseColumnAnnotationsRetrieveOutput = Awaited<ReturnType<typeof posthog.warehouseColumnAnnotationsRetrieve>>;
+
+const result: WarehouseColumnAnnotationsRetrieveOutput = await posthog.warehouseColumnAnnotationsRetrieve();
+
+// Result shape (from schema): { id: string; table: string; column_name?: string; description: string; description_source: "canonical" | "ai_generated" | "user_edited"; ai_model: string; is_user_edited: boolean; created_at: string; updated_at: string...
+```
+
+### `posthog.warehouseColumnAnnotationsPartialUpdate`
+
+- **HTTP**: `PATCH /api/projects/{project_id}/warehouse_column_annotations/{id}/`
+- **What it does**: Read and edit semantic descriptions of warehouse tables and columns surfaced to the AI agent.
+
+List can be filtered to one table with `?table_id=<uuid>`. Any create or update is treated as a
+user edit (`is_user_edited=True`), which protects the row from being overwritten by automatic
+enrichment. Create upserts on `(table, column_name)`; the table cannot be changed after creation.
+- **OpenAPI operationId**: `warehouse_column_annotations_partial_update`
+- **Path params**: `id`
+- **Query params**: None
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ id: string; table: string; column_name?: string; description: string; description_source: "canonical" | "ai_generated" | "user_edited"; ai_model: string; is_user_edited: boolean; created_at: string; updated_at: string...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type WarehouseColumnAnnotationsPartialUpdateInput = Parameters<typeof posthog.warehouseColumnAnnotationsPartialUpdate> extends [infer T, ...unknown[]] ? T : undefined;
+type WarehouseColumnAnnotationsPartialUpdateOutput = Awaited<ReturnType<typeof posthog.warehouseColumnAnnotationsPartialUpdate>>;
+
+const result: WarehouseColumnAnnotationsPartialUpdateOutput = await posthog.warehouseColumnAnnotationsPartialUpdate();
+
+// Result shape (from schema): { id: string; table: string; column_name?: string; description: string; description_source: "canonical" | "ai_generated" | "user_edited"; ai_model: string; is_user_edited: boolean; created_at: string; updated_at: string...
+```
+
+### `posthog.warehouseColumnAnnotationsUpdate`
+
+- **HTTP**: `PUT /api/projects/{project_id}/warehouse_column_annotations/{id}/`
+- **What it does**: Read and edit semantic descriptions of warehouse tables and columns surfaced to the AI agent.
+
+List can be filtered to one table with `?table_id=<uuid>`. Any create or update is treated as a
+user edit (`is_user_edited=True`), which protects the row from being overwritten by automatic
+enrichment. Create upserts on `(table, column_name)`; the table cannot be changed after creation.
+- **OpenAPI operationId**: `warehouse_column_annotations_update`
+- **Path params**: `id`
+- **Query params**: None
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ id: string; table: string; column_name?: string; description: string; description_source: "canonical" | "ai_generated" | "user_edited"; ai_model: string; is_user_edited: boolean; created_at: string; updated_at: string...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type WarehouseColumnAnnotationsUpdateInput = Parameters<typeof posthog.warehouseColumnAnnotationsUpdate> extends [infer T, ...unknown[]] ? T : undefined;
+type WarehouseColumnAnnotationsUpdateOutput = Awaited<ReturnType<typeof posthog.warehouseColumnAnnotationsUpdate>>;
+
+const result: WarehouseColumnAnnotationsUpdateOutput = await posthog.warehouseColumnAnnotationsUpdate();
+
+// Result shape (from schema): { id: string; table: string; column_name?: string; description: string; description_source: "canonical" | "ai_generated" | "user_edited"; ai_model: string; is_user_edited: boolean; created_at: string; updated_at: string...
+```
+
+
+<!-- prompt-hash:
+8c3694991a4c289225f05a4e8f1e098cc74d085a088d7dffd82f00d93797b7f8
+-->

package/docs/warehouse_column_statistics.md

@@ -0,0 +1,80 @@
+# Warehouse Column Statistics
+
+## Operations
+
+### `posthog.warehouseColumnStatisticsList`
+
+- **HTTP**: `GET /api/projects/{project_id}/warehouse_column_statistics/`
+- **What it does**: Read per-column data statistics (null fraction, min/max, row count) for warehouse tables.
+
+Statistics are computed automatically after a sync and surfaced to the AI agent so it can write
+better queries. They are system-owned and read-only here. List can be filtered to one table with
+`?table_id=<uuid>`.
+- **OpenAPI operationId**: `warehouse_column_statistics_list`
+- **Path params**: None
+- **Query params**: `limit`, `offset`, `table_id`
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ count: number; next?: string | null; previous?: string | null; results: ({ id: string; table: string; column_name: string; column_type: string; row_count: number; null_count: number; null_fraction: number; min_value: ...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type WarehouseColumnStatisticsListInput = Parameters<typeof posthog.warehouseColumnStatisticsList> extends [infer T, ...unknown[]] ? T : undefined;
+type WarehouseColumnStatisticsListOutput = Awaited<ReturnType<typeof posthog.warehouseColumnStatisticsList>>;
+
+const result: WarehouseColumnStatisticsListOutput = await posthog.warehouseColumnStatisticsList();
+
+// Result shape (from schema): { count: number; next?: string | null; previous?: string | null; results: ({ id: string; table: string; column_name: string; column_type: string; row_count: number; null_count: number; null_fraction: number; min_value: ...
+```
+
+### `posthog.warehouseColumnStatisticsRetrieve`
+
+- **HTTP**: `GET /api/projects/{project_id}/warehouse_column_statistics/{id}/`
+- **What it does**: Read per-column data statistics (null fraction, min/max, row count) for warehouse tables.
+
+Statistics are computed automatically after a sync and surfaced to the AI agent so it can write
+better queries. They are system-owned and read-only here. List can be filtered to one table with
+`?table_id=<uuid>`.
+- **OpenAPI operationId**: `warehouse_column_statistics_retrieve`
+- **Path params**: `id`
+- **Query params**: None
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ id: string; table: string; column_name: string; column_type: string; row_count: number; null_count: number; null_fraction: number; min_value: string; max_value: string; has_min_max: boolean; computed_at: string; compu...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type WarehouseColumnStatisticsRetrieveInput = Parameters<typeof posthog.warehouseColumnStatisticsRetrieve> extends [infer T, ...unknown[]] ? T : undefined;
+type WarehouseColumnStatisticsRetrieveOutput = Awaited<ReturnType<typeof posthog.warehouseColumnStatisticsRetrieve>>;
+
+const result: WarehouseColumnStatisticsRetrieveOutput = await posthog.warehouseColumnStatisticsRetrieve();
+
+// Result shape (from schema): { id: string; table: string; column_name: string; column_type: string; row_count: number; null_count: number; null_fraction: number; min_value: string; max_value: string; has_min_max: boolean; computed_at: string; compu...
+```
+
+
+<!-- prompt-hash:
+8c3694991a4c289225f05a4e8f1e098cc74d085a088d7dffd82f00d93797b7f8
+-->

package/docs/warehouse_dag.md

@@ -0,0 +1,40 @@
+# Warehouse Dag
+
+## Operations
+
+### `posthog.warehouseDagList`
+
+- **HTTP**: `GET /api/projects/{project_id}/warehouse_dag/`
+- **What it does**: Return this team's DAG as a set of edges and nodes
+- **OpenAPI operationId**: `warehouse_dag_list`
+- **Path params**: None
+- **Query params**: None
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `unknown`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type WarehouseDagListInput = Parameters<typeof posthog.warehouseDagList> extends [infer T, ...unknown[]] ? T : undefined;
+type WarehouseDagListOutput = Awaited<ReturnType<typeof posthog.warehouseDagList>>;
+
+const result: WarehouseDagListOutput = await posthog.warehouseDagList();
+
+// Result shape (from schema): unknown
+```
+
+
+<!-- prompt-hash:
+8c3694991a4c289225f05a4e8f1e098cc74d085a088d7dffd82f00d93797b7f8
+-->

package/docs/warehouse_model_paths.md

@@ -0,0 +1,70 @@
+# Warehouse Model Paths
+
+## Operations
+
+### `posthog.warehouseModelPathsList`
+
+- **HTTP**: `GET /api/projects/{project_id}/warehouse_model_paths/`
+- **OpenAPI operationId**: `warehouse_model_paths_list`
+- **Path params**: None
+- **Query params**: `limit`, `offset`
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ count: number; next?: string | null; previous?: string | null; results: ({ id: string; path: (string)[]; team: number; table?: string | null; saved_query?: string | null; created_at: string; created_by: { id: number; ...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type WarehouseModelPathsListInput = Parameters<typeof posthog.warehouseModelPathsList> extends [infer T, ...unknown[]] ? T : undefined;
+type WarehouseModelPathsListOutput = Awaited<ReturnType<typeof posthog.warehouseModelPathsList>>;
+
+const result: WarehouseModelPathsListOutput = await posthog.warehouseModelPathsList();
+
+// Result shape (from schema): { count: number; next?: string | null; previous?: string | null; results: ({ id: string; path: (string)[]; team: number; table?: string | null; saved_query?: string | null; created_at: string; created_by: { id: number; ...
+```
+
+### `posthog.warehouseModelPathsRetrieve`
+
+- **HTTP**: `GET /api/projects/{project_id}/warehouse_model_paths/{id}/`
+- **OpenAPI operationId**: `warehouse_model_paths_retrieve`
+- **Path params**: `id`
+- **Query params**: None
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ id: string; path: (string)[]; team: number; table?: string | null; saved_query?: string | null; created_at: string; created_by: { id: number; uuid: string; distinct_id?: string | null; first_name?: string; last_name?:...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type WarehouseModelPathsRetrieveInput = Parameters<typeof posthog.warehouseModelPathsRetrieve> extends [infer T, ...unknown[]] ? T : undefined;
+type WarehouseModelPathsRetrieveOutput = Awaited<ReturnType<typeof posthog.warehouseModelPathsRetrieve>>;
+
+const result: WarehouseModelPathsRetrieveOutput = await posthog.warehouseModelPathsRetrieve();
+
+// Result shape (from schema): { id: string; path: (string)[]; team: number; table?: string | null; saved_query?: string | null; created_at: string; created_by: { id: number; uuid: string; distinct_id?: string | null; first_name?: string; last_name?:...
+```
+
+
+<!-- prompt-hash:
+8c3694991a4c289225f05a4e8f1e098cc74d085a088d7dffd82f00d93797b7f8
+-->