@utdk/posthog 1.0.0-20260712.5-dev.e2949a6

package/docs/web_analytics_achievements.md

@@ -0,0 +1,200 @@
+# Web Analytics Achievements
+
+## Operations
+
+### `posthog.webAnalyticsAchievementsAcknowledgeCelebration`
+
+- **HTTP**: `POST /api/projects/{project_id}/web_analytics_achievements/acknowledge_celebration/`
+- **What it does**: Acknowledge an achievement celebration
+- **OpenAPI operationId**: `web_analytics_achievements_acknowledge_celebration`
+- **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: `{ acknowledged: boolean }`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type WebAnalyticsAchievementsAcknowledgeCelebrationInput = Parameters<typeof posthog.webAnalyticsAchievementsAcknowledgeCelebration> extends [infer T, ...unknown[]] ? T : undefined;
+type WebAnalyticsAchievementsAcknowledgeCelebrationOutput = Awaited<ReturnType<typeof posthog.webAnalyticsAchievementsAcknowledgeCelebration>>;
+
+const result: WebAnalyticsAchievementsAcknowledgeCelebrationOutput = await posthog.webAnalyticsAchievementsAcknowledgeCelebration();
+
+// Result shape (from schema): { acknowledged: boolean }
+```
+
+### `posthog.webAnalyticsAchievementsOverview`
+
+- **HTTP**: `GET /api/projects/{project_id}/web_analytics_achievements/overview/`
+- **What it does**: Get Web analytics achievements overview
+- **OpenAPI operationId**: `web_analytics_achievements_overview`
+- **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: `{ definitions: ({ key: string; display_name: string; description: string; scope: "user" | "team"; is_experiment_track: boolean; stages: ({ stage: number; name: string; threshold: number })[] })[]; user_progress: ({ trac...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type WebAnalyticsAchievementsOverviewInput = Parameters<typeof posthog.webAnalyticsAchievementsOverview> extends [infer T, ...unknown[]] ? T : undefined;
+type WebAnalyticsAchievementsOverviewOutput = Awaited<ReturnType<typeof posthog.webAnalyticsAchievementsOverview>>;
+
+const result: WebAnalyticsAchievementsOverviewOutput = await posthog.webAnalyticsAchievementsOverview();
+
+// Result shape (from schema): { definitions: ({ key: string; display_name: string; description: string; scope: "user" | "team"; is_experiment_track: boolean; stages: ({ stage: number; name: string; threshold: number })[] })[]; user_progress: ({ trac...
+```
+
+### `posthog.webAnalyticsAchievementsPreferences`
+
+- **HTTP**: `GET /api/projects/{project_id}/web_analytics_achievements/preferences/`
+- **What it does**: Get Web analytics achievements preferences
+- **OpenAPI operationId**: `web_analytics_achievements_preferences`
+- **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: `{ achievements_opt_out: boolean }`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type WebAnalyticsAchievementsPreferencesInput = Parameters<typeof posthog.webAnalyticsAchievementsPreferences> extends [infer T, ...unknown[]] ? T : undefined;
+type WebAnalyticsAchievementsPreferencesOutput = Awaited<ReturnType<typeof posthog.webAnalyticsAchievementsPreferences>>;
+
+const result: WebAnalyticsAchievementsPreferencesOutput = await posthog.webAnalyticsAchievementsPreferences();
+
+// Result shape (from schema): { achievements_opt_out: boolean }
+```
+
+### `posthog.webAnalyticsAchievementsUpdatePreferences`
+
+- **HTTP**: `POST /api/projects/{project_id}/web_analytics_achievements/preferences/`
+- **What it does**: Update Web analytics achievements preferences
+- **OpenAPI operationId**: `web_analytics_achievements_update_preferences`
+- **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: `{ achievements_opt_out: boolean }`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type WebAnalyticsAchievementsUpdatePreferencesInput = Parameters<typeof posthog.webAnalyticsAchievementsUpdatePreferences> extends [infer T, ...unknown[]] ? T : undefined;
+type WebAnalyticsAchievementsUpdatePreferencesOutput = Awaited<ReturnType<typeof posthog.webAnalyticsAchievementsUpdatePreferences>>;
+
+const result: WebAnalyticsAchievementsUpdatePreferencesOutput = await posthog.webAnalyticsAchievementsUpdatePreferences();
+
+// Result shape (from schema): { achievements_opt_out: boolean }
+```
+
+### `posthog.webAnalyticsAchievementsRecordInteraction`
+
+- **HTTP**: `POST /api/projects/{project_id}/web_analytics_achievements/record_interaction/`
+- **What it does**: Record a Web analytics interaction
+- **OpenAPI operationId**: `web_analytics_achievements_record_interaction`
+- **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: `{ recorded: boolean }`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type WebAnalyticsAchievementsRecordInteractionInput = Parameters<typeof posthog.webAnalyticsAchievementsRecordInteraction> extends [infer T, ...unknown[]] ? T : undefined;
+type WebAnalyticsAchievementsRecordInteractionOutput = Awaited<ReturnType<typeof posthog.webAnalyticsAchievementsRecordInteraction>>;
+
+const result: WebAnalyticsAchievementsRecordInteractionOutput = await posthog.webAnalyticsAchievementsRecordInteraction();
+
+// Result shape (from schema): { recorded: boolean }
+```
+
+### `posthog.webAnalyticsAchievementsRecordVisit`
+
+- **HTTP**: `POST /api/projects/{project_id}/web_analytics_achievements/record_visit/`
+- **What it does**: Record a Web analytics visit
+- **OpenAPI operationId**: `web_analytics_achievements_record_visit`
+- **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: `{ recorded: boolean }`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type WebAnalyticsAchievementsRecordVisitInput = Parameters<typeof posthog.webAnalyticsAchievementsRecordVisit> extends [infer T, ...unknown[]] ? T : undefined;
+type WebAnalyticsAchievementsRecordVisitOutput = Awaited<ReturnType<typeof posthog.webAnalyticsAchievementsRecordVisit>>;
+
+const result: WebAnalyticsAchievementsRecordVisitOutput = await posthog.webAnalyticsAchievementsRecordVisit();
+
+// Result shape (from schema): { recorded: boolean }
+```
+
+
+<!-- prompt-hash:
+8c3694991a4c289225f05a4e8f1e098cc74d085a088d7dffd82f00d93797b7f8
+-->

package/docs/web_experiments.md

@@ -0,0 +1,194 @@
+# Web Experiments
+
+## Operations
+
+### `posthog.webExperimentsList`
+
+- **HTTP**: `GET /api/projects/{project_id}/web_experiments/`
+- **OpenAPI operationId**: `web_experiments_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: number; name: string; created_at?: string; feature_flag_key: string; variants: unknown })[] }`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type WebExperimentsListInput = Parameters<typeof posthog.webExperimentsList> extends [infer T, ...unknown[]] ? T : undefined;
+type WebExperimentsListOutput = Awaited<ReturnType<typeof posthog.webExperimentsList>>;
+
+const result: WebExperimentsListOutput = await posthog.webExperimentsList();
+
+// Result shape (from schema): { count: number; next?: string | null; previous?: string | null; results: ({ id: number; name: string; created_at?: string; feature_flag_key: string; variants: unknown })[] }
+```
+
+### `posthog.webExperimentsCreate`
+
+- **HTTP**: `POST /api/projects/{project_id}/web_experiments/`
+- **OpenAPI operationId**: `web_experiments_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: number; name: string; created_at?: string; feature_flag_key: string; variants: unknown }`
+- OpenAPI response codes: `201`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type WebExperimentsCreateInput = Parameters<typeof posthog.webExperimentsCreate> extends [infer T, ...unknown[]] ? T : undefined;
+type WebExperimentsCreateOutput = Awaited<ReturnType<typeof posthog.webExperimentsCreate>>;
+
+const result: WebExperimentsCreateOutput = await posthog.webExperimentsCreate();
+
+// Result shape (from schema): { id: number; name: string; created_at?: string; feature_flag_key: string; variants: unknown }
+```
+
+### `posthog.webExperimentsDestroy`
+
+- **HTTP**: `DELETE /api/projects/{project_id}/web_experiments/{id}/`
+- **OpenAPI operationId**: `web_experiments_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 WebExperimentsDestroyInput = Parameters<typeof posthog.webExperimentsDestroy> extends [infer T, ...unknown[]] ? T : undefined;
+type WebExperimentsDestroyOutput = Awaited<ReturnType<typeof posthog.webExperimentsDestroy>>;
+
+const result: WebExperimentsDestroyOutput = await posthog.webExperimentsDestroy();
+
+// Result shape (from schema): unknown
+```
+
+### `posthog.webExperimentsRetrieve`
+
+- **HTTP**: `GET /api/projects/{project_id}/web_experiments/{id}/`
+- **OpenAPI operationId**: `web_experiments_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: number; name: string; created_at?: string; feature_flag_key: string; variants: unknown }`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type WebExperimentsRetrieveInput = Parameters<typeof posthog.webExperimentsRetrieve> extends [infer T, ...unknown[]] ? T : undefined;
+type WebExperimentsRetrieveOutput = Awaited<ReturnType<typeof posthog.webExperimentsRetrieve>>;
+
+const result: WebExperimentsRetrieveOutput = await posthog.webExperimentsRetrieve();
+
+// Result shape (from schema): { id: number; name: string; created_at?: string; feature_flag_key: string; variants: unknown }
+```
+
+### `posthog.webExperimentsPartialUpdate`
+
+- **HTTP**: `PATCH /api/projects/{project_id}/web_experiments/{id}/`
+- **OpenAPI operationId**: `web_experiments_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: number; name: string; created_at?: string; feature_flag_key: string; variants: unknown }`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type WebExperimentsPartialUpdateInput = Parameters<typeof posthog.webExperimentsPartialUpdate> extends [infer T, ...unknown[]] ? T : undefined;
+type WebExperimentsPartialUpdateOutput = Awaited<ReturnType<typeof posthog.webExperimentsPartialUpdate>>;
+
+const result: WebExperimentsPartialUpdateOutput = await posthog.webExperimentsPartialUpdate();
+
+// Result shape (from schema): { id: number; name: string; created_at?: string; feature_flag_key: string; variants: unknown }
+```
+
+### `posthog.webExperimentsUpdate`
+
+- **HTTP**: `PUT /api/projects/{project_id}/web_experiments/{id}/`
+- **OpenAPI operationId**: `web_experiments_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: number; name: string; created_at?: string; feature_flag_key: string; variants: unknown }`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type WebExperimentsUpdateInput = Parameters<typeof posthog.webExperimentsUpdate> extends [infer T, ...unknown[]] ? T : undefined;
+type WebExperimentsUpdateOutput = Awaited<ReturnType<typeof posthog.webExperimentsUpdate>>;
+
+const result: WebExperimentsUpdateOutput = await posthog.webExperimentsUpdate();
+
+// Result shape (from schema): { id: number; name: string; created_at?: string; feature_flag_key: string; variants: unknown }
+```
+
+
+<!-- prompt-hash:
+8c3694991a4c289225f05a4e8f1e098cc74d085a088d7dffd82f00d93797b7f8
+-->

package/docs/web_vitals.md

@@ -0,0 +1,74 @@
+# Web Vitals
+
+## Operations
+
+### `posthog.environmentsWebVitalsRetrieve`
+
+- **HTTP**: `GET /api/environments/{environment_id}/web_vitals/`
+- **What it does**: Get web vitals for a specific pathname.
+Toolbar accesses this via OAuth (handled by TeamAndOrgViewSetMixin.get_authenticators).
+- **OpenAPI operationId**: `environments_web_vitals_retrieve`
+- **Path params**: None
+- **Query params**: `pathname`
+- **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: `{ [key: string]: unknown }`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type EnvironmentsWebVitalsRetrieveInput = Parameters<typeof posthog.environmentsWebVitalsRetrieve> extends [infer T, ...unknown[]] ? T : undefined;
+type EnvironmentsWebVitalsRetrieveOutput = Awaited<ReturnType<typeof posthog.environmentsWebVitalsRetrieve>>;
+
+const result: EnvironmentsWebVitalsRetrieveOutput = await posthog.environmentsWebVitalsRetrieve();
+
+// Result shape (from schema): { [key: string]: unknown }
+```
+
+### `posthog.webVitalsRetrieve`
+
+- **HTTP**: `GET /api/projects/{project_id}/web_vitals/`
+- **What it does**: Get web vitals for a specific pathname.
+Toolbar accesses this via OAuth (handled by TeamAndOrgViewSetMixin.get_authenticators).
+- **OpenAPI operationId**: `web_vitals_retrieve`
+- **Path params**: None
+- **Query params**: `pathname`
+- **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: `{ [key: string]: unknown }`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type WebVitalsRetrieveInput = Parameters<typeof posthog.webVitalsRetrieve> extends [infer T, ...unknown[]] ? T : undefined;
+type WebVitalsRetrieveOutput = Awaited<ReturnType<typeof posthog.webVitalsRetrieve>>;
+
+const result: WebVitalsRetrieveOutput = await posthog.webVitalsRetrieve();
+
+// Result shape (from schema): { [key: string]: unknown }
+```
+
+
+<!-- prompt-hash:
+8c3694991a4c289225f05a4e8f1e098cc74d085a088d7dffd82f00d93797b7f8
+-->

package/docs/wizard.md

@@ -0,0 +1,170 @@
+# Wizard
+
+## Operations
+
+### `posthog.wizardSessionsList`
+
+- **HTTP**: `GET /api/projects/{project_id}/wizard/sessions/`
+- **What it does**: List wizard sessions for the project, ordered by started_at desc. This should only be called by the PostHog Wizard. Optional filters: ?workflow_id=<id> and ?skill_id=<id>.
+- **OpenAPI operationId**: `wizard_sessions_list`
+- **Path params**: None
+- **Query params**: `limit`, `offset`, `skill_id`, `workflow_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: ({ session_id: string; team_id: number; workflow_id: string; skill_id: string; started_at: string; run_phase: "idle" | "running" | "completed" | ...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type WizardSessionsListInput = Parameters<typeof posthog.wizardSessionsList> extends [infer T, ...unknown[]] ? T : undefined;
+type WizardSessionsListOutput = Awaited<ReturnType<typeof posthog.wizardSessionsList>>;
+
+const result: WizardSessionsListOutput = await posthog.wizardSessionsList();
+
+// Result shape (from schema): { count: number; next?: string | null; previous?: string | null; results: ({ session_id: string; team_id: number; workflow_id: string; skill_id: string; started_at: string; run_phase: "idle" | "running" | "completed" | ...
+```
+
+### `posthog.wizardSessionsCreate`
+
+- **HTTP**: `POST /api/projects/{project_id}/wizard/sessions/`
+- **What it does**: Upsert a wizard session. The `session_id` key is the idempotency anchor — reposting the same `session_id` replaces the existing row. Returns 201 on create, 200 on update.
+- **OpenAPI operationId**: `wizard_sessions_create`
+- **Path params**: None
+- **Query params**: None
+- **Response codes**: `200`, `201`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ session_id: string; team_id: number; workflow_id: string; skill_id: string; started_at: string; run_phase: "idle" | "running" | "completed" | "error"; tasks: ({ id: string; title: string; status: "pending" | "in_progr...`
+- OpenAPI response codes: `200`, `201`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type WizardSessionsCreateInput = Parameters<typeof posthog.wizardSessionsCreate> extends [infer T, ...unknown[]] ? T : undefined;
+type WizardSessionsCreateOutput = Awaited<ReturnType<typeof posthog.wizardSessionsCreate>>;
+
+const result: WizardSessionsCreateOutput = await posthog.wizardSessionsCreate();
+
+// Result shape (from schema): { session_id: string; team_id: number; workflow_id: string; skill_id: string; started_at: string; run_phase: "idle" | "running" | "completed" | "error"; tasks: ({ id: string; title: string; status: "pending" | "in_progr...
+```
+
+### `posthog.wizardSessionsRetrieve`
+
+- **HTTP**: `GET /api/projects/{project_id}/wizard/sessions/{session_id}/`
+- **What it does**: Retrieve a single wizard session by its session_id.
+- **OpenAPI operationId**: `wizard_sessions_retrieve`
+- **Path params**: `session_id`
+- **Query params**: None
+- **Response codes**: `200`, `404`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ session_id: string; team_id: number; workflow_id: string; skill_id: string; started_at: string; run_phase: "idle" | "running" | "completed" | "error"; tasks: ({ id: string; title: string; status: "pending" | "in_progr...`
+- OpenAPI response codes: `200`, `404`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type WizardSessionsRetrieveInput = Parameters<typeof posthog.wizardSessionsRetrieve> extends [infer T, ...unknown[]] ? T : undefined;
+type WizardSessionsRetrieveOutput = Awaited<ReturnType<typeof posthog.wizardSessionsRetrieve>>;
+
+const result: WizardSessionsRetrieveOutput = await posthog.wizardSessionsRetrieve();
+
+// Result shape (from schema): { session_id: string; team_id: number; workflow_id: string; skill_id: string; started_at: string; run_phase: "idle" | "running" | "completed" | "error"; tasks: ({ id: string; title: string; status: "pending" | "in_progr...
+```
+
+### `posthog.wizardSessionsLatestRetrieve`
+
+- **HTTP**: `GET /api/projects/{project_id}/wizard/sessions/latest/`
+- **What it does**: Return the single most-recent wizard session for a workflow (and optional skill), or 204 if none exists. Unlike `list`, this is a point lookup the app shell uses to decide whether to open the live SSE stream — it never returns a collection, and 'no run' is a 204 rather than a 404 so clients don't conflate it with a missing endpoint.
+- **OpenAPI operationId**: `wizard_sessions_latest_retrieve`
+- **Path params**: None
+- **Query params**: `skill_id`, `workflow_id`
+- **Response codes**: `200`, `204`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ session_id: string; team_id: number; workflow_id: string; skill_id: string; started_at: string; run_phase: "idle" | "running" | "completed" | "error"; tasks: ({ id: string; title: string; status: "pending" | "in_progr...`
+- OpenAPI response codes: `200`, `204`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type WizardSessionsLatestRetrieveInput = Parameters<typeof posthog.wizardSessionsLatestRetrieve> extends [infer T, ...unknown[]] ? T : undefined;
+type WizardSessionsLatestRetrieveOutput = Awaited<ReturnType<typeof posthog.wizardSessionsLatestRetrieve>>;
+
+const result: WizardSessionsLatestRetrieveOutput = await posthog.wizardSessionsLatestRetrieve();
+
+// Result shape (from schema): { session_id: string; team_id: number; workflow_id: string; skill_id: string; started_at: string; run_phase: "idle" | "running" | "completed" | "error"; tasks: ({ id: string; title: string; status: "pending" | "in_progr...
+```
+
+### `posthog.wizardSessionsStreamRetrieve`
+
+- **HTTP**: `GET /api/projects/{project_id}/wizard/sessions/stream/`
+- **What it does**: Server-Sent Events stream of wizard session updates for a (workflow_id, skill_id) pair. On connect, the current latest session (if any) is emitted as the first event; subsequent upserts are streamed in real time. The server closes the connection after 900 seconds with an `event: end` line so the client (EventSource) can reconnect.
+
+**SDK consumers**: do not call the generated fetch wrapper for this path — it will buffer the entire infinite stream. Use the URL builder (`getWizardSessionsStreamRetrieveUrl`) with the browser's `EventSource` API instead.
+- **OpenAPI operationId**: `wizard_sessions_stream_retrieve`
+- **Path params**: None
+- **Query params**: `skill_id`, `workflow_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: `string`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type WizardSessionsStreamRetrieveInput = Parameters<typeof posthog.wizardSessionsStreamRetrieve> extends [infer T, ...unknown[]] ? T : undefined;
+type WizardSessionsStreamRetrieveOutput = Awaited<ReturnType<typeof posthog.wizardSessionsStreamRetrieve>>;
+
+const result: WizardSessionsStreamRetrieveOutput = await posthog.wizardSessionsStreamRetrieve();
+
+// Result shape (from schema): string
+```
+
+
+<!-- prompt-hash:
+8c3694991a4c289225f05a4e8f1e098cc74d085a088d7dffd82f00d93797b7f8
+-->

package/index.ts

@@ -0,0 +1,22 @@
+import type { CreateClientOptions } from "../client.js";
+import { createClient, createLazyClient } from "../client.js";
+import type { PosthogClient } from "./types/index.js";
+import { toolMetadata } from "./metadata.js";
+import openApiDocument from "./openapi.json" with { type: "json" };
+
+export * from "./types/index.js";
+
+export function createPosthogClient(
+  options: Omit<CreateClientOptions, "name" | "openApiDocument" | "toolMetadata"> = {},
+): Promise<PosthogClient> {
+  return createClient<PosthogClient>({
+    ...options,
+    name: "posthog",
+    openApiDocument,
+    toolMetadata,
+  });
+}
+
+const defaultClient = createLazyClient(() => createPosthogClient());
+
+export default defaultClient;