@utdk/posthog 1.0.0-20260712.5-dev.e2949a6

package/docs/max.md

@@ -0,0 +1,772 @@
+# Max
+
+## Operations
+
+### `posthog.environmentsConversationsList`
+
+- **HTTP**: `GET /api/environments/{environment_id}/conversations/`
+- **OpenAPI operationId**: `environments_conversations_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; status: "idle" | "in_progress" | "canceling"; title: string | null; topic: "web_analytics" | "product_analytics" | "session_replay...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type EnvironmentsConversationsListInput = Parameters<typeof posthog.environmentsConversationsList> extends [infer T, ...unknown[]] ? T : undefined;
+type EnvironmentsConversationsListOutput = Awaited<ReturnType<typeof posthog.environmentsConversationsList>>;
+
+const result: EnvironmentsConversationsListOutput = await posthog.environmentsConversationsList();
+
+// Result shape (from schema): { count: number; next?: string | null; previous?: string | null; results: ({ id: string; status: "idle" | "in_progress" | "canceling"; title: string | null; topic: "web_analytics" | "product_analytics" | "session_replay...
+```
+
+### `posthog.environmentsConversationsCreate`
+
+- **HTTP**: `POST /api/environments/{environment_id}/conversations/`
+- **What it does**: Unified endpoint that handles both conversation creation and streaming.
+
+- If message is provided: Start new conversation processing
+- If no message: Stream from existing conversation
+- **OpenAPI operationId**: `environments_conversations_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: `{ content: string | null; conversation: string; contextual_tools?: { [key: string]: unknown }; ui_context?: unknown; billing_context?: unknown; trace_id: string; session_id?: string; agent_mode?: "product_analytics" | "...`
+- OpenAPI response codes: `201`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type EnvironmentsConversationsCreateInput = Parameters<typeof posthog.environmentsConversationsCreate> extends [infer T, ...unknown[]] ? T : undefined;
+type EnvironmentsConversationsCreateOutput = Awaited<ReturnType<typeof posthog.environmentsConversationsCreate>>;
+
+const result: EnvironmentsConversationsCreateOutput = await posthog.environmentsConversationsCreate();
+
+// Result shape (from schema): { content: string | null; conversation: string; contextual_tools?: { [key: string]: unknown }; ui_context?: unknown; billing_context?: unknown; trace_id: string; session_id?: string; agent_mode?: "product_analytics" | "...
+```
+
+### `posthog.environmentsConversationsDestroy`
+
+- **HTTP**: `DELETE /api/environments/{environment_id}/conversations/{conversation}/`
+- **What it does**: Delete a conversation.
+- **OpenAPI operationId**: `environments_conversations_destroy`
+- **Path params**: `conversation`
+- **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 EnvironmentsConversationsDestroyInput = Parameters<typeof posthog.environmentsConversationsDestroy> extends [infer T, ...unknown[]] ? T : undefined;
+type EnvironmentsConversationsDestroyOutput = Awaited<ReturnType<typeof posthog.environmentsConversationsDestroy>>;
+
+const result: EnvironmentsConversationsDestroyOutput = await posthog.environmentsConversationsDestroy();
+
+// Result shape (from schema): unknown
+```
+
+### `posthog.environmentsConversationsRetrieve`
+
+- **HTTP**: `GET /api/environments/{environment_id}/conversations/{conversation}/`
+- **OpenAPI operationId**: `environments_conversations_retrieve`
+- **Path params**: `conversation`
+- **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; status: "idle" | "in_progress" | "canceling"; title: string | null; topic: "web_analytics" | "product_analytics" | "session_replay" | "surveys" | "feature_flags" | "experiments" | "error_tracking" | "data_...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type EnvironmentsConversationsRetrieveInput = Parameters<typeof posthog.environmentsConversationsRetrieve> extends [infer T, ...unknown[]] ? T : undefined;
+type EnvironmentsConversationsRetrieveOutput = Awaited<ReturnType<typeof posthog.environmentsConversationsRetrieve>>;
+
+const result: EnvironmentsConversationsRetrieveOutput = await posthog.environmentsConversationsRetrieve();
+
+// Result shape (from schema): { id: string; status: "idle" | "in_progress" | "canceling"; title: string | null; topic: "web_analytics" | "product_analytics" | "session_replay" | "surveys" | "feature_flags" | "experiments" | "error_tracking" | "data_...
+```
+
+### `posthog.environmentsConversationsAppendMessageCreate`
+
+- **HTTP**: `POST /api/environments/{environment_id}/conversations/{conversation}/append_message/`
+- **What it does**: Appends a message to an existing conversation without triggering AI processing.
+This is used for client-side generated messages that need to be persisted
+(e.g., support ticket confirmation messages).
+- **OpenAPI operationId**: `environments_conversations_append_message_create`
+- **Path params**: `conversation`
+- **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: `{ content: string }`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type EnvironmentsConversationsAppendMessageCreateInput = Parameters<typeof posthog.environmentsConversationsAppendMessageCreate> extends [infer T, ...unknown[]] ? T : undefined;
+type EnvironmentsConversationsAppendMessageCreateOutput = Awaited<ReturnType<typeof posthog.environmentsConversationsAppendMessageCreate>>;
+
+const result: EnvironmentsConversationsAppendMessageCreateOutput = await posthog.environmentsConversationsAppendMessageCreate();
+
+// Result shape (from schema): { content: string }
+```
+
+### `posthog.environmentsConversationsCancelPartialUpdate`
+
+- **HTTP**: `PATCH /api/environments/{environment_id}/conversations/{conversation}/cancel/`
+- **What it does**: Cancel the conversation's in-progress LangGraph run.
+- **OpenAPI operationId**: `environments_conversations_cancel_partial_update`
+- **Path params**: `conversation`
+- **Query params**: None
+- **Response codes**: `204`, `422`
+- **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`, `422`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type EnvironmentsConversationsCancelPartialUpdateInput = Parameters<typeof posthog.environmentsConversationsCancelPartialUpdate> extends [infer T, ...unknown[]] ? T : undefined;
+type EnvironmentsConversationsCancelPartialUpdateOutput = Awaited<ReturnType<typeof posthog.environmentsConversationsCancelPartialUpdate>>;
+
+const result: EnvironmentsConversationsCancelPartialUpdateOutput = await posthog.environmentsConversationsCancelPartialUpdate();
+
+// Result shape (from schema): unknown
+```
+
+### `posthog.environmentsConversationsOpenCreate`
+
+- **HTTP**: `POST /api/environments/{environment_id}/conversations/{conversation}/open/`
+- **What it does**: Create-or-resume a sandbox conversation — the single sandbox session opener. With `content`, processes the turn (first message, in-progress follow-up, or terminal resume); without `content`, warms a sandbox that idles awaiting the first message. Returns the `(task, run)` handle the frontend opens SSE against. The conversation row is created on first use from the URL id.
+- **OpenAPI operationId**: `environments_conversations_open_create`
+- **Path params**: `conversation`
+- **Query params**: None
+- **Response codes**: `200`, `204`, `400`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ task_id: string; run_id: string; trace_id: string | null; run_status: string; just_created_run: boolean }`
+- OpenAPI response codes: `200`, `204`, `400`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type EnvironmentsConversationsOpenCreateInput = Parameters<typeof posthog.environmentsConversationsOpenCreate> extends [infer T, ...unknown[]] ? T : undefined;
+type EnvironmentsConversationsOpenCreateOutput = Awaited<ReturnType<typeof posthog.environmentsConversationsOpenCreate>>;
+
+const result: EnvironmentsConversationsOpenCreateOutput = await posthog.environmentsConversationsOpenCreate();
+
+// Result shape (from schema): { task_id: string; run_id: string; trace_id: string | null; run_status: string; just_created_run: boolean }
+```
+
+### `posthog.environmentsConversationsQueueRetrieve`
+
+- **HTTP**: `GET /api/environments/{environment_id}/conversations/{conversation}/queue/`
+- **OpenAPI operationId**: `environments_conversations_queue_retrieve`
+- **Path params**: `conversation`
+- **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; status: "idle" | "in_progress" | "canceling"; title: string | null; topic: "web_analytics" | "product_analytics" | "session_replay" | "surveys" | "feature_flags" | "experiments" | "error_tracking" | "data_...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type EnvironmentsConversationsQueueRetrieveInput = Parameters<typeof posthog.environmentsConversationsQueueRetrieve> extends [infer T, ...unknown[]] ? T : undefined;
+type EnvironmentsConversationsQueueRetrieveOutput = Awaited<ReturnType<typeof posthog.environmentsConversationsQueueRetrieve>>;
+
+const result: EnvironmentsConversationsQueueRetrieveOutput = await posthog.environmentsConversationsQueueRetrieve();
+
+// Result shape (from schema): { id: string; status: "idle" | "in_progress" | "canceling"; title: string | null; topic: "web_analytics" | "product_analytics" | "session_replay" | "surveys" | "feature_flags" | "experiments" | "error_tracking" | "data_...
+```
+
+### `posthog.environmentsConversationsQueueCreate`
+
+- **HTTP**: `POST /api/environments/{environment_id}/conversations/{conversation}/queue/`
+- **OpenAPI operationId**: `environments_conversations_queue_create`
+- **Path params**: `conversation`
+- **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; status: "idle" | "in_progress" | "canceling"; title: string | null; topic: "web_analytics" | "product_analytics" | "session_replay" | "surveys" | "feature_flags" | "experiments" | "error_tracking" | "data_...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type EnvironmentsConversationsQueueCreateInput = Parameters<typeof posthog.environmentsConversationsQueueCreate> extends [infer T, ...unknown[]] ? T : undefined;
+type EnvironmentsConversationsQueueCreateOutput = Awaited<ReturnType<typeof posthog.environmentsConversationsQueueCreate>>;
+
+const result: EnvironmentsConversationsQueueCreateOutput = await posthog.environmentsConversationsQueueCreate();
+
+// Result shape (from schema): { id: string; status: "idle" | "in_progress" | "canceling"; title: string | null; topic: "web_analytics" | "product_analytics" | "session_replay" | "surveys" | "feature_flags" | "experiments" | "error_tracking" | "data_...
+```
+
+### `posthog.environmentsConversationsQueueDestroy`
+
+- **HTTP**: `DELETE /api/environments/{environment_id}/conversations/{conversation}/queue/{queue_id}/`
+- **OpenAPI operationId**: `environments_conversations_queue_destroy`
+- **Path params**: `conversation`, `queue_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 EnvironmentsConversationsQueueDestroyInput = Parameters<typeof posthog.environmentsConversationsQueueDestroy> extends [infer T, ...unknown[]] ? T : undefined;
+type EnvironmentsConversationsQueueDestroyOutput = Awaited<ReturnType<typeof posthog.environmentsConversationsQueueDestroy>>;
+
+const result: EnvironmentsConversationsQueueDestroyOutput = await posthog.environmentsConversationsQueueDestroy();
+
+// Result shape (from schema): unknown
+```
+
+### `posthog.environmentsConversationsQueuePartialUpdate`
+
+- **HTTP**: `PATCH /api/environments/{environment_id}/conversations/{conversation}/queue/{queue_id}/`
+- **OpenAPI operationId**: `environments_conversations_queue_partial_update`
+- **Path params**: `conversation`, `queue_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; status: "idle" | "in_progress" | "canceling"; title: string | null; topic: "web_analytics" | "product_analytics" | "session_replay" | "surveys" | "feature_flags" | "experiments" | "error_tracking" | "data_...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type EnvironmentsConversationsQueuePartialUpdateInput = Parameters<typeof posthog.environmentsConversationsQueuePartialUpdate> extends [infer T, ...unknown[]] ? T : undefined;
+type EnvironmentsConversationsQueuePartialUpdateOutput = Awaited<ReturnType<typeof posthog.environmentsConversationsQueuePartialUpdate>>;
+
+const result: EnvironmentsConversationsQueuePartialUpdateOutput = await posthog.environmentsConversationsQueuePartialUpdate();
+
+// Result shape (from schema): { id: string; status: "idle" | "in_progress" | "canceling"; title: string | null; topic: "web_analytics" | "product_analytics" | "session_replay" | "surveys" | "feature_flags" | "experiments" | "error_tracking" | "data_...
+```
+
+### `posthog.environmentsConversationsQueueClearCreate`
+
+- **HTTP**: `POST /api/environments/{environment_id}/conversations/{conversation}/queue/clear/`
+- **OpenAPI operationId**: `environments_conversations_queue_clear_create`
+- **Path params**: `conversation`
+- **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; status: "idle" | "in_progress" | "canceling"; title: string | null; topic: "web_analytics" | "product_analytics" | "session_replay" | "surveys" | "feature_flags" | "experiments" | "error_tracking" | "data_...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type EnvironmentsConversationsQueueClearCreateInput = Parameters<typeof posthog.environmentsConversationsQueueClearCreate> extends [infer T, ...unknown[]] ? T : undefined;
+type EnvironmentsConversationsQueueClearCreateOutput = Awaited<ReturnType<typeof posthog.environmentsConversationsQueueClearCreate>>;
+
+const result: EnvironmentsConversationsQueueClearCreateOutput = await posthog.environmentsConversationsQueueClearCreate();
+
+// Result shape (from schema): { id: string; status: "idle" | "in_progress" | "canceling"; title: string | null; topic: "web_analytics" | "product_analytics" | "session_replay" | "surveys" | "feature_flags" | "experiments" | "error_tracking" | "data_...
+```
+
+### `posthog.conversationsList`
+
+- **HTTP**: `GET /api/projects/{project_id}/conversations/`
+- **OpenAPI operationId**: `conversations_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; status: "idle" | "in_progress" | "canceling"; title: string | null; topic: "web_analytics" | "product_analytics" | "session_replay...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type ConversationsListInput = Parameters<typeof posthog.conversationsList> extends [infer T, ...unknown[]] ? T : undefined;
+type ConversationsListOutput = Awaited<ReturnType<typeof posthog.conversationsList>>;
+
+const result: ConversationsListOutput = await posthog.conversationsList();
+
+// Result shape (from schema): { count: number; next?: string | null; previous?: string | null; results: ({ id: string; status: "idle" | "in_progress" | "canceling"; title: string | null; topic: "web_analytics" | "product_analytics" | "session_replay...
+```
+
+### `posthog.conversationsCreate`
+
+- **HTTP**: `POST /api/projects/{project_id}/conversations/`
+- **What it does**: Unified endpoint that handles both conversation creation and streaming.
+
+- If message is provided: Start new conversation processing
+- If no message: Stream from existing conversation
+- **OpenAPI operationId**: `conversations_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: `{ content: string | null; conversation: string; contextual_tools?: { [key: string]: unknown }; ui_context?: unknown; billing_context?: unknown; trace_id: string; session_id?: string; agent_mode?: "product_analytics" | "...`
+- OpenAPI response codes: `201`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type ConversationsCreateInput = Parameters<typeof posthog.conversationsCreate> extends [infer T, ...unknown[]] ? T : undefined;
+type ConversationsCreateOutput = Awaited<ReturnType<typeof posthog.conversationsCreate>>;
+
+const result: ConversationsCreateOutput = await posthog.conversationsCreate();
+
+// Result shape (from schema): { content: string | null; conversation: string; contextual_tools?: { [key: string]: unknown }; ui_context?: unknown; billing_context?: unknown; trace_id: string; session_id?: string; agent_mode?: "product_analytics" | "...
+```
+
+### `posthog.conversationsDestroy`
+
+- **HTTP**: `DELETE /api/projects/{project_id}/conversations/{conversation}/`
+- **What it does**: Delete a conversation.
+- **OpenAPI operationId**: `conversations_destroy`
+- **Path params**: `conversation`
+- **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 ConversationsDestroyInput = Parameters<typeof posthog.conversationsDestroy> extends [infer T, ...unknown[]] ? T : undefined;
+type ConversationsDestroyOutput = Awaited<ReturnType<typeof posthog.conversationsDestroy>>;
+
+const result: ConversationsDestroyOutput = await posthog.conversationsDestroy();
+
+// Result shape (from schema): unknown
+```
+
+### `posthog.conversationsRetrieve`
+
+- **HTTP**: `GET /api/projects/{project_id}/conversations/{conversation}/`
+- **OpenAPI operationId**: `conversations_retrieve`
+- **Path params**: `conversation`
+- **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; status: "idle" | "in_progress" | "canceling"; title: string | null; topic: "web_analytics" | "product_analytics" | "session_replay" | "surveys" | "feature_flags" | "experiments" | "error_tracking" | "data_...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type ConversationsRetrieveInput = Parameters<typeof posthog.conversationsRetrieve> extends [infer T, ...unknown[]] ? T : undefined;
+type ConversationsRetrieveOutput = Awaited<ReturnType<typeof posthog.conversationsRetrieve>>;
+
+const result: ConversationsRetrieveOutput = await posthog.conversationsRetrieve();
+
+// Result shape (from schema): { id: string; status: "idle" | "in_progress" | "canceling"; title: string | null; topic: "web_analytics" | "product_analytics" | "session_replay" | "surveys" | "feature_flags" | "experiments" | "error_tracking" | "data_...
+```
+
+### `posthog.conversationsAppendMessageCreate`
+
+- **HTTP**: `POST /api/projects/{project_id}/conversations/{conversation}/append_message/`
+- **What it does**: Appends a message to an existing conversation without triggering AI processing.
+This is used for client-side generated messages that need to be persisted
+(e.g., support ticket confirmation messages).
+- **OpenAPI operationId**: `conversations_append_message_create`
+- **Path params**: `conversation`
+- **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: `{ content: string }`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type ConversationsAppendMessageCreateInput = Parameters<typeof posthog.conversationsAppendMessageCreate> extends [infer T, ...unknown[]] ? T : undefined;
+type ConversationsAppendMessageCreateOutput = Awaited<ReturnType<typeof posthog.conversationsAppendMessageCreate>>;
+
+const result: ConversationsAppendMessageCreateOutput = await posthog.conversationsAppendMessageCreate();
+
+// Result shape (from schema): { content: string }
+```
+
+### `posthog.conversationsCancelPartialUpdate`
+
+- **HTTP**: `PATCH /api/projects/{project_id}/conversations/{conversation}/cancel/`
+- **What it does**: Cancel the conversation's in-progress LangGraph run.
+- **OpenAPI operationId**: `conversations_cancel_partial_update`
+- **Path params**: `conversation`
+- **Query params**: None
+- **Response codes**: `204`, `422`
+- **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`, `422`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type ConversationsCancelPartialUpdateInput = Parameters<typeof posthog.conversationsCancelPartialUpdate> extends [infer T, ...unknown[]] ? T : undefined;
+type ConversationsCancelPartialUpdateOutput = Awaited<ReturnType<typeof posthog.conversationsCancelPartialUpdate>>;
+
+const result: ConversationsCancelPartialUpdateOutput = await posthog.conversationsCancelPartialUpdate();
+
+// Result shape (from schema): unknown
+```
+
+### `posthog.conversationsOpenCreate`
+
+- **HTTP**: `POST /api/projects/{project_id}/conversations/{conversation}/open/`
+- **What it does**: Create-or-resume a sandbox conversation — the single sandbox session opener. With `content`, processes the turn (first message, in-progress follow-up, or terminal resume); without `content`, warms a sandbox that idles awaiting the first message. Returns the `(task, run)` handle the frontend opens SSE against. The conversation row is created on first use from the URL id.
+- **OpenAPI operationId**: `conversations_open_create`
+- **Path params**: `conversation`
+- **Query params**: None
+- **Response codes**: `200`, `204`, `400`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ task_id: string; run_id: string; trace_id: string | null; run_status: string; just_created_run: boolean }`
+- OpenAPI response codes: `200`, `204`, `400`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type ConversationsOpenCreateInput = Parameters<typeof posthog.conversationsOpenCreate> extends [infer T, ...unknown[]] ? T : undefined;
+type ConversationsOpenCreateOutput = Awaited<ReturnType<typeof posthog.conversationsOpenCreate>>;
+
+const result: ConversationsOpenCreateOutput = await posthog.conversationsOpenCreate();
+
+// Result shape (from schema): { task_id: string; run_id: string; trace_id: string | null; run_status: string; just_created_run: boolean }
+```
+
+### `posthog.conversationsQueueRetrieve`
+
+- **HTTP**: `GET /api/projects/{project_id}/conversations/{conversation}/queue/`
+- **OpenAPI operationId**: `conversations_queue_retrieve`
+- **Path params**: `conversation`
+- **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; status: "idle" | "in_progress" | "canceling"; title: string | null; topic: "web_analytics" | "product_analytics" | "session_replay" | "surveys" | "feature_flags" | "experiments" | "error_tracking" | "data_...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type ConversationsQueueRetrieveInput = Parameters<typeof posthog.conversationsQueueRetrieve> extends [infer T, ...unknown[]] ? T : undefined;
+type ConversationsQueueRetrieveOutput = Awaited<ReturnType<typeof posthog.conversationsQueueRetrieve>>;
+
+const result: ConversationsQueueRetrieveOutput = await posthog.conversationsQueueRetrieve();
+
+// Result shape (from schema): { id: string; status: "idle" | "in_progress" | "canceling"; title: string | null; topic: "web_analytics" | "product_analytics" | "session_replay" | "surveys" | "feature_flags" | "experiments" | "error_tracking" | "data_...
+```
+
+### `posthog.conversationsQueueCreate`
+
+- **HTTP**: `POST /api/projects/{project_id}/conversations/{conversation}/queue/`
+- **OpenAPI operationId**: `conversations_queue_create`
+- **Path params**: `conversation`
+- **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; status: "idle" | "in_progress" | "canceling"; title: string | null; topic: "web_analytics" | "product_analytics" | "session_replay" | "surveys" | "feature_flags" | "experiments" | "error_tracking" | "data_...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type ConversationsQueueCreateInput = Parameters<typeof posthog.conversationsQueueCreate> extends [infer T, ...unknown[]] ? T : undefined;
+type ConversationsQueueCreateOutput = Awaited<ReturnType<typeof posthog.conversationsQueueCreate>>;
+
+const result: ConversationsQueueCreateOutput = await posthog.conversationsQueueCreate();
+
+// Result shape (from schema): { id: string; status: "idle" | "in_progress" | "canceling"; title: string | null; topic: "web_analytics" | "product_analytics" | "session_replay" | "surveys" | "feature_flags" | "experiments" | "error_tracking" | "data_...
+```
+
+### `posthog.conversationsQueueDestroy`
+
+- **HTTP**: `DELETE /api/projects/{project_id}/conversations/{conversation}/queue/{queue_id}/`
+- **OpenAPI operationId**: `conversations_queue_destroy`
+- **Path params**: `conversation`, `queue_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 ConversationsQueueDestroyInput = Parameters<typeof posthog.conversationsQueueDestroy> extends [infer T, ...unknown[]] ? T : undefined;
+type ConversationsQueueDestroyOutput = Awaited<ReturnType<typeof posthog.conversationsQueueDestroy>>;
+
+const result: ConversationsQueueDestroyOutput = await posthog.conversationsQueueDestroy();
+
+// Result shape (from schema): unknown
+```
+
+### `posthog.conversationsQueuePartialUpdate`
+
+- **HTTP**: `PATCH /api/projects/{project_id}/conversations/{conversation}/queue/{queue_id}/`
+- **OpenAPI operationId**: `conversations_queue_partial_update`
+- **Path params**: `conversation`, `queue_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; status: "idle" | "in_progress" | "canceling"; title: string | null; topic: "web_analytics" | "product_analytics" | "session_replay" | "surveys" | "feature_flags" | "experiments" | "error_tracking" | "data_...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type ConversationsQueuePartialUpdateInput = Parameters<typeof posthog.conversationsQueuePartialUpdate> extends [infer T, ...unknown[]] ? T : undefined;
+type ConversationsQueuePartialUpdateOutput = Awaited<ReturnType<typeof posthog.conversationsQueuePartialUpdate>>;
+
+const result: ConversationsQueuePartialUpdateOutput = await posthog.conversationsQueuePartialUpdate();
+
+// Result shape (from schema): { id: string; status: "idle" | "in_progress" | "canceling"; title: string | null; topic: "web_analytics" | "product_analytics" | "session_replay" | "surveys" | "feature_flags" | "experiments" | "error_tracking" | "data_...
+```
+
+### `posthog.conversationsQueueClearCreate`
+
+- **HTTP**: `POST /api/projects/{project_id}/conversations/{conversation}/queue/clear/`
+- **OpenAPI operationId**: `conversations_queue_clear_create`
+- **Path params**: `conversation`
+- **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; status: "idle" | "in_progress" | "canceling"; title: string | null; topic: "web_analytics" | "product_analytics" | "session_replay" | "surveys" | "feature_flags" | "experiments" | "error_tracking" | "data_...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type ConversationsQueueClearCreateInput = Parameters<typeof posthog.conversationsQueueClearCreate> extends [infer T, ...unknown[]] ? T : undefined;
+type ConversationsQueueClearCreateOutput = Awaited<ReturnType<typeof posthog.conversationsQueueClearCreate>>;
+
+const result: ConversationsQueueClearCreateOutput = await posthog.conversationsQueueClearCreate();
+
+// Result shape (from schema): { id: string; status: "idle" | "in_progress" | "canceling"; title: string | null; topic: "web_analytics" | "product_analytics" | "session_replay" | "surveys" | "feature_flags" | "experiments" | "error_tracking" | "data_...
+```
+
+
+<!-- prompt-hash:
+8c3694991a4c289225f05a4e8f1e098cc74d085a088d7dffd82f00d93797b7f8
+-->