@keystrokehq/posthog 0.0.1

package/README.md

@@ -0,0 +1,237 @@
+# @keystrokehq/posthog
+
+Official [PostHog](https://posthog.com) integration for Keystroke workflows.
+
+PostHog is the default product-analytics surface for Keystroke because a
+single vendor covers analytics, feature flags, experiments, session
+replay, and surveys — with a stable REST API and regional US/EU hosts.
+
+## Status
+
+This package ships **Pass A** of the PostHog surface:
+
+- 170+ typed operations across 14 domains.
+- 12 direct-binding polling triggers.
+- Two-client design that enforces PostHog's token scoping
+  (personal-key management vs. project-key capture/decide).
+- 100% Zod v4 input and output parsing.
+
+Pass B (tracked separately) adds:
+
+- Unsigned webhook triggers (action match, pipeline destination).
+- Experiments, early-access features, notebooks, batch-export
+  lifecycle, plugin-config CRUD.
+- Domains, SAML, hedgehog.
+
+## Overview
+
+- **Capture / identify** — event capture, batch, identify, alias, group
+  identify, set-person-properties (`/capture`, `/batch`).
+- **Decide** — server-side flag evaluation and local-evaluation payload
+  download.
+- **Feature flags** — full management CRUD, role access, remote config,
+  activity, status.
+- **Persons, cohorts, insights, dashboards, annotations** — full
+  management CRUDs + activity feeds.
+- **Session recordings** — list/read/delete, snapshots, playlists.
+- **Surveys** — CRUD, stats, activity.
+- **Events management** — read-only event query, event and property
+  definitions.
+- **Actions** — CRUD for server-side action definitions.
+- **Projects / organizations** — teams, members, invites, project
+  settings, API-key rotation.
+- **Webhook management** — configure action webhooks and pipeline
+  destinations. (Direct-binding webhook triggers follow in Pass B.)
+
+## Public Surface
+
+Use explicit subpaths — the package root intentionally exports
+nothing.
+
+- `@keystrokehq/posthog/connection`
+- `@keystrokehq/posthog/client`
+- `@keystrokehq/posthog/schemas`
+- `@keystrokehq/posthog/errors`
+- `@keystrokehq/posthog/triggers`
+- `@keystrokehq/posthog/capture`
+- `@keystrokehq/posthog/decide`
+- `@keystrokehq/posthog/feature-flags`
+- `@keystrokehq/posthog/insights`
+- `@keystrokehq/posthog/persons`
+- `@keystrokehq/posthog/cohorts`
+- `@keystrokehq/posthog/annotations`
+- `@keystrokehq/posthog/dashboards`
+- `@keystrokehq/posthog/session-recordings`
+- `@keystrokehq/posthog/surveys`
+- `@keystrokehq/posthog/events-management`
+- `@keystrokehq/posthog/actions`
+- `@keystrokehq/posthog/projects`
+- `@keystrokehq/posthog/organizations`
+- `@keystrokehq/posthog/webhook-management`
+
+## Installation
+
+```bash
+pnpm add @keystrokehq/posthog
+```
+
+## Credentials
+
+PostHog uses two distinct API keys with deliberately different
+scopes. The credential surface keeps both available so each sub-client
+uses the correct token:
+
+| Credential                  | Required | Used by                              |
+| --------------------------- | -------- | ------------------------------------ |
+| `POSTHOG_PERSONAL_API_KEY`  | Yes      | Management, read/write, admin        |
+| `POSTHOG_PROJECT_API_KEY`   | No\*     | `/capture`, `/batch`, `/decide`      |
+| `POSTHOG_HOST`              | Default `https://us.posthog.com` | All requests (used to derive ingest host) |
+| `POSTHOG_PROJECT_ID`        | No       | Default project for scoped endpoints |
+| `POSTHOG_SCOPES`            | No       | Informational (UI allow-listing)     |
+
+\* Capture and decide operations require `POSTHOG_PROJECT_API_KEY`;
+management operations do not.
+
+Regional hosts are inferred from `POSTHOG_HOST`:
+
+- `https://us.posthog.com` → ingest via `https://us.i.posthog.com`
+- `https://eu.posthog.com` → ingest via `https://eu.i.posthog.com`
+- Self-hosted URLs → ingest to the same host (no rewrite).
+
+Use `@keystrokehq/posthog/connection` to import the `posthog`
+credential set.
+
+## Operations
+
+```typescript
+import { Workflow } from '@keystrokehq/core';
+import { z } from 'zod';
+import { captureEvent } from '@keystrokehq/posthog/capture';
+import { decideFeatureFlags } from '@keystrokehq/posthog/decide';
+import { listFeatureFlags } from '@keystrokehq/posthog/feature-flags';
+
+export const featureRolloutWorkflow = new Workflow({
+  id: 'posthog-feature-rollout',
+  name: 'Track feature rollout',
+  input: z.object({
+    distinctId: z.string(),
+    event: z.string(),
+  }),
+  output: z.object({
+    flagsEvaluated: z.number(),
+  }),
+  run: async (input) => {
+    await captureEvent.run({
+      event: input.event,
+      distinctId: input.distinctId,
+    });
+
+    const decision = await decideFeatureFlags.run({
+      distinctId: input.distinctId,
+    });
+
+    await listFeatureFlags.run({ active: true });
+
+    return {
+      flagsEvaluated: Object.keys(decision.featureFlags ?? {}).length,
+    };
+  },
+});
+```
+
+## Triggers
+
+All Pass-A triggers are polling triggers (PostHog's webhook payloads
+are unsigned; webhook triggers arrive in Pass B). Import the helpers
+from `@keystrokehq/posthog/triggers`:
+
+```typescript
+import {
+  newEvent,
+  newPerson,
+  insightAlert,
+  polling,
+} from '@keystrokehq/posthog/triggers';
+```
+
+Each helper returns a `BoundTrigger` that can be dropped into a
+`Workflow`'s `triggers` array:
+
+```typescript
+import { Workflow } from '@keystrokehq/core';
+import { z } from 'zod';
+import { newEvent } from '@keystrokehq/posthog/triggers';
+
+export const onSignupWorkflow = new Workflow({
+  id: 'posthog-on-signup',
+  name: 'Fan-out on signup events',
+  triggers: [
+    newEvent({
+      event: 'user_signed_up',
+      schedule: '1m',
+      filter: (page) => page.results.length > 0,
+    }),
+  ],
+  input: z.unknown(),
+  output: z.object({ processed: z.number() }),
+  run: async (payload) => {
+    return { processed: (payload as { results: unknown[] }).results.length };
+  },
+});
+```
+
+Available polling triggers:
+
+| Helper                 | Use case                                      |
+| ---------------------- | --------------------------------------------- |
+| `newEvent`             | New analytics events matching a filter         |
+| `newSessionRecording`  | New session recordings in a project            |
+| `newPerson`            | Newly created or identified persons            |
+| `newCohortMember`      | New members of a cohort                        |
+| `insightAlert`         | Value changes on an insight                    |
+| `batchExportRun`       | Batch export run state transitions             |
+| `experimentResult`     | Experiment reaches significance                |
+| `featureFlagActivity`  | Rollout changes on a specific feature flag     |
+| `newAnnotation`        | Newly created annotations                      |
+| `pluginFailure`        | Pipeline / plugin failure metrics              |
+| `surveyResponse`       | Survey response count increases                |
+| `newSubscription`      | New insight/dashboard digest subscriptions     |
+
+A frozen `polling` namespace re-exports the same helpers for
+authoring ergonomics: `polling.newEvent(...)`.
+
+## Error handling
+
+Every client surface throws a `PosthogClientError` (discriminated
+union) on failure. The error carries the HTTP status, provider code,
+request id, and a `retryAfterMs` hint derived from `Retry-After` or
+rate-limit headers. Consumers should switch on `error.type` rather
+than pattern-matching against messages:
+
+```typescript
+import { PosthogClientError } from '@keystrokehq/posthog/errors';
+
+try {
+  await captureEvent.run({ event: 'ping', distinctId: 'u_1' });
+} catch (error) {
+  if (error instanceof PosthogClientError && error.type === 'rate_limit') {
+    await sleep(error.retryAfterMs ?? 1_000);
+  } else {
+    throw error;
+  }
+}
+```
+
+## Source of truth
+
+- API reference: <https://posthog.com/docs/api>.
+- PostHog OpenAPI: <https://app.posthog.com/api/schema/>.
+- Scope catalogue: <https://posthog.com/docs/api#personal-api-keys>.
+
+Bugs or missing endpoints? Open an issue under `plan/posthog/` in
+the Keystroke monorepo; missing endpoints that belong to Pass B live in
+that plan.
+
+## License
+
+MIT — see the repository root.

package/dist/_official/index.d.mts

@@ -0,0 +1,2 @@
+import { i as posthogOfficialIntegration, r as posthogBundle } from "../integration-CsCBBu4d.mjs";
+export { posthogBundle, posthogOfficialIntegration };

package/dist/_official/index.mjs

@@ -0,0 +1,3 @@
+import { n as posthogBundle, r as posthogOfficialIntegration } from "../integration-Doy2Dwli.mjs";
+
+export { posthogBundle, posthogOfficialIntegration };

package/dist/_runtime/index.d.mts

@@ -0,0 +1,7 @@
+import { n as posthog } from "../integration-CsCBBu4d.mjs";
+import { createOfficialOperationFactory } from "@keystrokehq/integration-authoring/official";
+
+//#region src/factory.d.ts
+declare const posthogOperation: ReturnType<typeof createOfficialOperationFactory<typeof posthog>>;
+//#endregion
+export { posthogOperation };

package/dist/_runtime/index.mjs

@@ -0,0 +1,3 @@
+import { t as posthogOperation } from "../factory-DYDvHOGb.mjs";
+
+export { posthogOperation };

package/dist/actions.d.mts

@@ -0,0 +1,244 @@
+import { z } from "zod";
+import * as _keystrokehq_core_credential_set0 from "@keystrokehq/core/credential-set";
+import * as _keystrokehq_core0 from "@keystrokehq/core";
+
+//#region src/actions.d.ts
+declare const listActions: _keystrokehq_core0.Operation<z.ZodObject<{
+  limit: z.ZodOptional<z.ZodNumber>;
+  offset: z.ZodOptional<z.ZodNumber>;
+  search: z.ZodOptional<z.ZodString>;
+  projectId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+}, z.core.$strip>, z.ZodObject<{
+  next: z.ZodNullable<z.ZodString>;
+  previous: z.ZodNullable<z.ZodString>;
+  count: z.ZodNumber;
+  results: z.ZodArray<z.ZodObject<{
+    id: z.ZodOptional<z.ZodNumber>;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    post_to_slack: z.ZodOptional<z.ZodBoolean>;
+    slack_message_format: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      event: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      url_matching: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        exact: "exact";
+        contains: "contains";
+        regex: "regex";
+      }>>>;
+      text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      href: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      selector: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      properties: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
+    }, z.core.$strip>>>;
+    created_at: z.ZodOptional<z.ZodString>;
+    created_by: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    deleted: z.ZodOptional<z.ZodBoolean>;
+    is_calculating: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strip>>;
+}, z.core.$strip>, readonly [_keystrokehq_core0.CredentialSet<"posthog", z.ZodObject<{
+  POSTHOG_PERSONAL_API_KEY: z.ZodString;
+  POSTHOG_PROJECT_API_KEY: z.ZodOptional<z.ZodString>;
+  POSTHOG_HOST: z.ZodDefault<z.ZodURL>;
+  POSTHOG_PROJECT_ID: z.ZodOptional<z.ZodString>;
+  POSTHOG_SCOPES: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, readonly _keystrokehq_core_credential_set0.CredentialConnection<z.ZodObject<{
+  POSTHOG_PERSONAL_API_KEY: z.ZodString;
+  POSTHOG_PROJECT_API_KEY: z.ZodOptional<z.ZodString>;
+  POSTHOG_HOST: z.ZodDefault<z.ZodURL>;
+  POSTHOG_PROJECT_ID: z.ZodOptional<z.ZodString>;
+  POSTHOG_SCOPES: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>>[] | undefined>], undefined>;
+declare const getAction: _keystrokehq_core0.Operation<z.ZodObject<{
+  id: z.ZodNumber;
+  projectId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+}, z.core.$strip>, z.ZodObject<{
+  id: z.ZodOptional<z.ZodNumber>;
+  name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  post_to_slack: z.ZodOptional<z.ZodBoolean>;
+  slack_message_format: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    event: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    url_matching: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+      exact: "exact";
+      contains: "contains";
+      regex: "regex";
+    }>>>;
+    text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    href: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    selector: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    properties: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
+  }, z.core.$strip>>>;
+  created_at: z.ZodOptional<z.ZodString>;
+  created_by: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+  deleted: z.ZodOptional<z.ZodBoolean>;
+  is_calculating: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, readonly [_keystrokehq_core0.CredentialSet<"posthog", z.ZodObject<{
+  POSTHOG_PERSONAL_API_KEY: z.ZodString;
+  POSTHOG_PROJECT_API_KEY: z.ZodOptional<z.ZodString>;
+  POSTHOG_HOST: z.ZodDefault<z.ZodURL>;
+  POSTHOG_PROJECT_ID: z.ZodOptional<z.ZodString>;
+  POSTHOG_SCOPES: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, readonly _keystrokehq_core_credential_set0.CredentialConnection<z.ZodObject<{
+  POSTHOG_PERSONAL_API_KEY: z.ZodString;
+  POSTHOG_PROJECT_API_KEY: z.ZodOptional<z.ZodString>;
+  POSTHOG_HOST: z.ZodDefault<z.ZodURL>;
+  POSTHOG_PROJECT_ID: z.ZodOptional<z.ZodString>;
+  POSTHOG_SCOPES: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>>[] | undefined>], undefined>;
+declare const createAction: _keystrokehq_core0.Operation<z.ZodObject<{
+  name: z.ZodString;
+  description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    event: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    url_matching: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+      exact: "exact";
+      contains: "contains";
+      regex: "regex";
+    }>>>;
+    text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    href: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    selector: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    properties: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
+  }, z.core.$strip>>>;
+  post_to_slack: z.ZodOptional<z.ZodBoolean>;
+  slack_message_format: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  deleted: z.ZodOptional<z.ZodBoolean>;
+  projectId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+}, z.core.$strip>, z.ZodObject<{
+  id: z.ZodOptional<z.ZodNumber>;
+  name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  post_to_slack: z.ZodOptional<z.ZodBoolean>;
+  slack_message_format: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    event: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    url_matching: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+      exact: "exact";
+      contains: "contains";
+      regex: "regex";
+    }>>>;
+    text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    href: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    selector: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    properties: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
+  }, z.core.$strip>>>;
+  created_at: z.ZodOptional<z.ZodString>;
+  created_by: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+  deleted: z.ZodOptional<z.ZodBoolean>;
+  is_calculating: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, readonly [_keystrokehq_core0.CredentialSet<"posthog", z.ZodObject<{
+  POSTHOG_PERSONAL_API_KEY: z.ZodString;
+  POSTHOG_PROJECT_API_KEY: z.ZodOptional<z.ZodString>;
+  POSTHOG_HOST: z.ZodDefault<z.ZodURL>;
+  POSTHOG_PROJECT_ID: z.ZodOptional<z.ZodString>;
+  POSTHOG_SCOPES: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, readonly _keystrokehq_core_credential_set0.CredentialConnection<z.ZodObject<{
+  POSTHOG_PERSONAL_API_KEY: z.ZodString;
+  POSTHOG_PROJECT_API_KEY: z.ZodOptional<z.ZodString>;
+  POSTHOG_HOST: z.ZodDefault<z.ZodURL>;
+  POSTHOG_PROJECT_ID: z.ZodOptional<z.ZodString>;
+  POSTHOG_SCOPES: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>>[] | undefined>], undefined>;
+declare const updateAction: _keystrokehq_core0.Operation<z.ZodObject<{
+  name: z.ZodOptional<z.ZodString>;
+  description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    event: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    url_matching: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+      exact: "exact";
+      contains: "contains";
+      regex: "regex";
+    }>>>;
+    text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    href: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    selector: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    properties: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
+  }, z.core.$strip>>>;
+  post_to_slack: z.ZodOptional<z.ZodBoolean>;
+  slack_message_format: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  deleted: z.ZodOptional<z.ZodBoolean>;
+  id: z.ZodNumber;
+  projectId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+}, z.core.$strip>, z.ZodObject<{
+  id: z.ZodOptional<z.ZodNumber>;
+  name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  post_to_slack: z.ZodOptional<z.ZodBoolean>;
+  slack_message_format: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    event: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    url_matching: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+      exact: "exact";
+      contains: "contains";
+      regex: "regex";
+    }>>>;
+    text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    href: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    selector: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    properties: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
+  }, z.core.$strip>>>;
+  created_at: z.ZodOptional<z.ZodString>;
+  created_by: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+  deleted: z.ZodOptional<z.ZodBoolean>;
+  is_calculating: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, readonly [_keystrokehq_core0.CredentialSet<"posthog", z.ZodObject<{
+  POSTHOG_PERSONAL_API_KEY: z.ZodString;
+  POSTHOG_PROJECT_API_KEY: z.ZodOptional<z.ZodString>;
+  POSTHOG_HOST: z.ZodDefault<z.ZodURL>;
+  POSTHOG_PROJECT_ID: z.ZodOptional<z.ZodString>;
+  POSTHOG_SCOPES: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, readonly _keystrokehq_core_credential_set0.CredentialConnection<z.ZodObject<{
+  POSTHOG_PERSONAL_API_KEY: z.ZodString;
+  POSTHOG_PROJECT_API_KEY: z.ZodOptional<z.ZodString>;
+  POSTHOG_HOST: z.ZodDefault<z.ZodURL>;
+  POSTHOG_PROJECT_ID: z.ZodOptional<z.ZodString>;
+  POSTHOG_SCOPES: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>>[] | undefined>], undefined>;
+declare const deleteAction: _keystrokehq_core0.Operation<z.ZodObject<{
+  id: z.ZodNumber;
+  projectId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+}, z.core.$strip>, z.ZodObject<{
+  id: z.ZodOptional<z.ZodNumber>;
+  name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  post_to_slack: z.ZodOptional<z.ZodBoolean>;
+  slack_message_format: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    event: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    url_matching: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+      exact: "exact";
+      contains: "contains";
+      regex: "regex";
+    }>>>;
+    text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    href: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    selector: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    properties: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
+  }, z.core.$strip>>>;
+  created_at: z.ZodOptional<z.ZodString>;
+  created_by: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+  deleted: z.ZodOptional<z.ZodBoolean>;
+  is_calculating: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, readonly [_keystrokehq_core0.CredentialSet<"posthog", z.ZodObject<{
+  POSTHOG_PERSONAL_API_KEY: z.ZodString;
+  POSTHOG_PROJECT_API_KEY: z.ZodOptional<z.ZodString>;
+  POSTHOG_HOST: z.ZodDefault<z.ZodURL>;
+  POSTHOG_PROJECT_ID: z.ZodOptional<z.ZodString>;
+  POSTHOG_SCOPES: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, readonly _keystrokehq_core_credential_set0.CredentialConnection<z.ZodObject<{
+  POSTHOG_PERSONAL_API_KEY: z.ZodString;
+  POSTHOG_PROJECT_API_KEY: z.ZodOptional<z.ZodString>;
+  POSTHOG_HOST: z.ZodDefault<z.ZodURL>;
+  POSTHOG_PROJECT_ID: z.ZodOptional<z.ZodString>;
+  POSTHOG_SCOPES: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>>[] | undefined>], undefined>;
+//#endregion
+export { createAction, deleteAction, getAction, listActions, updateAction };

package/dist/actions.mjs

@@ -0,0 +1,129 @@
+import { createPosthogManagementClient } from "./client.mjs";
+import { actionSchema, actionStepSchema, paginatedResponseSchema, projectIdInputShape } from "./schemas.mjs";
+import { t as posthogOperation } from "./factory-DYDvHOGb.mjs";
+import { z } from "zod";
+
+//#region src/actions.ts
+/**
+* posthog/actions.ts
+*
+* Action CRUD. Actions are reusable event matchers used by dashboards,
+* funnels, and Slack notifications.
+*
+* Docs: https://posthog.com/docs/api/actions
+*/
+const idInput = {
+	...projectIdInputShape,
+	id: z.number().int()
+};
+const writeShape = {
+	name: z.string().optional(),
+	description: z.string().nullable().optional(),
+	steps: z.array(actionStepSchema).optional(),
+	post_to_slack: z.boolean().optional(),
+	slack_message_format: z.string().nullable().optional(),
+	deleted: z.boolean().optional()
+};
+const listActions = posthogOperation({
+	id: "posthog_actions_list",
+	name: "PostHog List Actions",
+	description: "List actions in a project",
+	input: z.object({
+		...projectIdInputShape,
+		limit: z.number().int().min(1).max(500).optional(),
+		offset: z.number().int().min(0).optional(),
+		search: z.string().optional()
+	}),
+	output: paginatedResponseSchema(actionSchema),
+	run: async (input, credentials) => {
+		const client = createPosthogManagementClient(credentials);
+		const projectId = client.projectId(input.projectId);
+		return client.request({
+			method: "GET",
+			path: `/api/projects/${projectId}/actions/`,
+			query: {
+				limit: input.limit,
+				offset: input.offset,
+				search: input.search
+			}
+		});
+	}
+});
+const getAction = posthogOperation({
+	id: "posthog_actions_get",
+	name: "PostHog Get Action",
+	description: "Retrieve an action by id",
+	input: z.object(idInput),
+	output: actionSchema,
+	run: async (input, credentials) => {
+		const client = createPosthogManagementClient(credentials);
+		const projectId = client.projectId(input.projectId);
+		return client.request({
+			method: "GET",
+			path: `/api/projects/${projectId}/actions/${input.id}/`
+		});
+	}
+});
+const createAction = posthogOperation({
+	id: "posthog_actions_create",
+	name: "PostHog Create Action",
+	description: "Create a new action",
+	input: z.object({
+		...projectIdInputShape,
+		...writeShape,
+		name: z.string().min(1)
+	}),
+	output: actionSchema,
+	needsApproval: true,
+	run: async (input, credentials) => {
+		const client = createPosthogManagementClient(credentials);
+		const projectId = client.projectId(input.projectId);
+		const { projectId: _pid, ...body } = input;
+		return client.request({
+			method: "POST",
+			path: `/api/projects/${projectId}/actions/`,
+			body
+		});
+	}
+});
+const updateAction = posthogOperation({
+	id: "posthog_actions_update",
+	name: "PostHog Update Action",
+	description: "Partial update to an action",
+	input: z.object({
+		...idInput,
+		...writeShape
+	}),
+	output: actionSchema,
+	needsApproval: true,
+	run: async (input, credentials) => {
+		const client = createPosthogManagementClient(credentials);
+		const projectId = client.projectId(input.projectId);
+		const { projectId: _pid, id, ...body } = input;
+		return client.request({
+			method: "PATCH",
+			path: `/api/projects/${projectId}/actions/${id}/`,
+			body
+		});
+	}
+});
+const deleteAction = posthogOperation({
+	id: "posthog_actions_delete",
+	name: "PostHog Delete Action",
+	description: "Soft-delete an action",
+	input: z.object(idInput),
+	output: actionSchema,
+	needsApproval: true,
+	run: async (input, credentials) => {
+		const client = createPosthogManagementClient(credentials);
+		const projectId = client.projectId(input.projectId);
+		return client.request({
+			method: "PATCH",
+			path: `/api/projects/${projectId}/actions/${input.id}/`,
+			body: { deleted: true }
+		});
+	}
+});
+
+//#endregion
+export { createAction, deleteAction, getAction, listActions, updateAction };