@agentrysh/mcp 0.0.9 → 0.0.12

package/dist/tools.js

@@ -57,6 +57,412 @@ export const TOOL_DESCRIPTORS = [
             additionalProperties: false,
         },
     },
+    {
+        name: "agentry_publish_query",
+        description: "Mint a public-fetchable URL for a specific recipe + params combination. The returned " +
+            "URL can be embedded in a PUBLIC dashboard (your marketing site, a customer-facing " +
+            "metrics page, etc.) — visitors fetch the rendered query results without an account, " +
+            "credential, or session." +
+            "" +
+            "Auth model: the URL embeds the user's `agp_…` PUBLIC key (auto-minted at login alongside " +
+            "the private `agk_…`). agp_ is read-only AND can only fetch publications you explicitly " +
+            "created. Even if the URL leaks to the entire internet, the worst case is that the SAME " +
+            "(recipe + params) query you already chose to make public can be re-fetched. No other " +
+            "data is reachable." +
+            "" +
+            "Workflow: ASK the user what to publish (which metric, which params), call this tool, " +
+            "embed the returned `public_url?key=<agp_…>` in their page. CORS is open. Revoke with " +
+            "agentry_revoke_publication.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string" },
+                recipe_id: {
+                    type: "string",
+                    description: "ID from agentry_list_recipes. Bound to this publication permanently — to change " +
+                        "the recipe, revoke + republish.",
+                },
+                params: {
+                    type: "object",
+                    description: "Recipe params (matches recipe.params schema). Bound to this publication.",
+                },
+                description: {
+                    type: "string",
+                    description: "What this dashboard widget shows — for your own future reference in " +
+                        "agentry_list_publications.",
+                },
+            },
+            required: ["recipe_id"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentry_list_publications",
+        description: "List active public-fetchable query publications for this project. Returns each one's " +
+            "public_url + last_used_at. Use this to audit what's currently exposed publicly.",
+        inputSchema: {
+            type: "object",
+            properties: { project_id: { type: "string" } },
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentry_revoke_publication",
+        description: "Revoke a public-fetchable query publication. The public_url will start returning 410 " +
+            "(Gone). Use when the dashboard widget is decommissioned or the embedded URL leaks " +
+            "somewhere unintended.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string" },
+                publication_id: { type: "string" },
+            },
+            required: ["publication_id"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentry_configure_session_replay",
+        description: "Enable / disable / customize PostHog session replay for the user's project. " +
+            "Session replay is OFF by default — agentry users opt in. Recordings eat significant " +
+            "storage, so pick a strategy that matches the customer's debugging needs:" +
+            "" +
+            "  - 'off'          — disable. No new sessions recorded." +
+            "  - 'all'          — 100% sampling. Heavy storage cost; only pick if the customer's " +
+            "                     traffic is low AND they want every session recorded." +
+            "  - 'sampled'      — random sample at sample_rate (0–1, default 0.1 = 10%). Good " +
+            "                     balance of coverage + cost for most apps." +
+            "  - 'url_scoped'   — record only sessions that hit specific URLs (e.g. /checkout/*). " +
+            "                     Pass url_triggers: [{url, matching}]. Best for funnel debugging." +
+            "  - 'errors_only'  — record nothing by default, but the customer's app calls " +
+            "                     `posthog.startSessionRecording()` from captureError (or wherever " +
+            "                     they want). Cheapest; recording starts JUST IN TIME when something " +
+            "                     breaks. After picking this, ALSO wire the call into the customer's " +
+            "                     agentry helper (drop_in_helper from agentry_install_guide)." +
+            "" +
+            "Workflow: ASK THE USER first which strategy they want and what retention. Then call this " +
+            "tool with the answer. If 'errors_only', also edit the agentry helper to call " +
+            "posthog.startSessionRecording() inside captureError. After this, recordings show up in " +
+            "PostHog's Replay tab — call agentry_session_replay_status to get the deep-link URL.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string", description: "Project id. Defaults to local default." },
+                strategy: {
+                    type: "string",
+                    enum: ["off", "all", "sampled", "url_scoped", "errors_only"],
+                },
+                sample_rate: {
+                    type: "number",
+                    description: "0–1; only used when strategy='sampled'. Default 0.1 (10%).",
+                },
+                retention_days: {
+                    type: "number",
+                    description: "How many days to retain recordings. Storage-bounded. 30 / 90 / 365.",
+                },
+                min_duration_ms: {
+                    type: "number",
+                    description: "Drop recordings shorter than this (ms). 0 = keep all. Useful for skipping bounces. " +
+                        "Default unset.",
+                },
+                url_triggers: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            url: { type: "string" },
+                            matching: { type: "string", enum: ["exact", "regex"] },
+                        },
+                        required: ["url"],
+                        additionalProperties: false,
+                    },
+                    description: "When strategy='url_scoped': pages where recording should start.",
+                },
+            },
+            required: ["strategy"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentry_session_replay_status",
+        description: "Get the current session-replay configuration for the user's project AND a deep-link " +
+            "URL into PostHog's Replay tab. For programmatic recording retrieval (returning the " +
+            "list of recordings or player URLs), call agentry_list_session_replays / " +
+            "agentry_get_session_replay — both work as of 2026-05-15 (master Personal API Key " +
+            "now has session_recording:read scope).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string" },
+            },
+            additionalProperties: false,
+        },
+    },
+    // ---------------------------------------------------------------------------
+    // PostHog per-user-team CRUD: feature flags, cohorts, surveys, session
+    // recordings retrieval. Each wraps an /api/projects/<team_id>/<resource>/
+    // endpoint on the user's per-user PostHog team. Master Personal API Key
+    // has `*` scope as of 2026-05-15 so all of these are live.
+    // ---------------------------------------------------------------------------
+    {
+        name: "agentry_list_feature_flags",
+        description: "List feature flags on the user's PostHog project. Use this to inspect what flags " +
+            "exist before creating new ones, or to find a flag's id to update/delete it. Each " +
+            "flag has: id, key, name, active, filters (rollout rules), created_at.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string" },
+                limit: { type: "number", description: "Max flags to return (default 100, max 200)." },
+            },
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentry_get_feature_flag",
+        description: "Fetch a single feature flag's full configuration (filters, variants, conditions).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string" },
+                flag_id: {
+                    type: "string",
+                    description: "Numeric id from agentry_list_feature_flags (NOT the flag's key string).",
+                },
+            },
+            required: ["flag_id"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentry_create_feature_flag",
+        description: "Create a new feature flag. Two shapes supported:" +
+            "" +
+            "  - Simple: pass {key, name?, active?, rollout_percentage?} — single-group filter at " +
+            "    the given % rollout (0-100). Default: active=true, rollout=100." +
+            "" +
+            "  - Advanced: pass {key, name?, active?, filters} — `filters` is PostHog's raw filter " +
+            "    object ({groups: [{properties: [...], rollout_percentage}], multivariate?, …}). " +
+            "    Use this for property-targeted rules, multi-variant flags, or cohort-scoped flags.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string" },
+                key: { type: "string", description: "Stable slug used in code (e.g. `new-checkout-flow`)." },
+                name: { type: "string", description: "Human label (defaults to key)." },
+                active: { type: "boolean", description: "Default true." },
+                rollout_percentage: { type: "number", description: "0–100 (simple shape)." },
+                filters: { type: "object", description: "Raw PostHog filter object (advanced shape)." },
+            },
+            required: ["key"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentry_update_feature_flag",
+        description: "Patch a feature flag. Toggle on/off via {active}, change rollout via {rollout_percentage}, " +
+            "rename via {name}, or replace targeting with {filters}.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string" },
+                flag_id: { type: "string" },
+                active: { type: "boolean" },
+                name: { type: "string" },
+                rollout_percentage: { type: "number" },
+                filters: { type: "object" },
+            },
+            required: ["flag_id"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentry_delete_feature_flag",
+        description: "Soft-delete a feature flag (sets deleted=true; recoverable in PostHog's web UI).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string" },
+                flag_id: { type: "string" },
+            },
+            required: ["flag_id"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentry_list_cohorts",
+        description: "List cohorts (dynamic user segments) on the user's PostHog project. Cohorts are " +
+            "groups of users matching a filter (e.g. 'users who did event X in last 30 days'). " +
+            "Used by feature-flag targeting and HogQL queries.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string" },
+            },
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentry_get_cohort",
+        description: "Fetch a single cohort's definition (filters, last calculation time, count).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string" },
+                cohort_id: { type: "string" },
+            },
+            required: ["cohort_id"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentry_create_cohort",
+        description: "Create a cohort. Two shapes supported:" +
+            "" +
+            "  - Simple: {name, event, days?} — users who fired `event` at least once in the last " +
+            "    N days (days defaults to 30)." +
+            "" +
+            "  - Advanced: {name, groups} — `groups` is PostHog's raw cohort-group filter array, " +
+            "    for property-targeted or multi-condition cohorts.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string" },
+                name: { type: "string" },
+                event: { type: "string", description: "Event name (simple shape)." },
+                days: { type: "number", description: "Lookback window in days (default 30, simple shape)." },
+                groups: { type: "array", description: "Raw PostHog cohort-group filters (advanced shape)." },
+            },
+            required: ["name"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentry_delete_cohort",
+        description: "Soft-delete a cohort (recoverable in PostHog's web UI).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string" },
+                cohort_id: { type: "string" },
+            },
+            required: ["cohort_id"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentry_list_surveys",
+        description: "List surveys on the user's PostHog project. A survey is a popup/banner/widget the " +
+            "customer's PostHog-JS-enabled site renders to ask users a question (NPS, CSAT, " +
+            "free-text). Responses land as `survey sent` events.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string" },
+            },
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentry_get_survey",
+        description: "Fetch a single survey's definition. To read responses, query HogQL: " +
+            "`SELECT properties FROM events WHERE event = 'survey sent' AND properties.\\$survey_id = '<id>'`.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string" },
+                survey_id: { type: "string" },
+            },
+            required: ["survey_id"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentry_create_survey",
+        description: "Create a survey. Quick shape: {name, question, question_type?} for a single-question " +
+            "popover (question_type defaults to 'open' — also 'rating', 'single_choice', " +
+            "'multiple_choice', 'link'). Advanced: pass {name, questions: [...]} for multi-question. " +
+            "" +
+            "Surveys are created in DRAFT — pass start_date (ISO) to launch immediately, or call " +
+            "PATCH /surveys/:id with {start_date} later.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string" },
+                name: { type: "string" },
+                type: {
+                    type: "string",
+                    enum: ["popover", "widget", "button", "api"],
+                    description: "Render style. Default 'popover'.",
+                },
+                question: { type: "string", description: "Single-question quick shape." },
+                question_type: {
+                    type: "string",
+                    enum: ["open", "rating", "single_choice", "multiple_choice", "link"],
+                },
+                questions: { type: "array", description: "Multi-question array (advanced shape)." },
+                description: { type: "string" },
+                linked_flag_id: { type: "number" },
+                targeting_flag_id: { type: "number" },
+                conditions: { type: "object" },
+                appearance: { type: "object" },
+                start_date: { type: "string", description: "ISO timestamp to launch immediately." },
+            },
+            required: ["name"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentry_delete_survey",
+        description: "Delete a survey (PostHog hard-deletes survey rows on DELETE).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string" },
+                survey_id: { type: "string" },
+            },
+            required: ["survey_id"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentry_list_session_replays",
+        description: "List session recordings on the user's PostHog project. Use this to find replays " +
+            "linked to a user (distinct_id) or a time range — e.g. when investigating an error, " +
+            "filter by the affected user's distinct_id to find the recording leading up to it. " +
+            "" +
+            "Note: session replay must be ENABLED first (call agentry_configure_session_replay). " +
+            "Recordings are only captured while a strategy is on.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string" },
+                distinct_id: {
+                    type: "string",
+                    description: "Filter to one user (e.g. from a case's affected_users).",
+                },
+                date_from: { type: "string", description: "ISO timestamp lower bound." },
+                date_to: { type: "string", description: "ISO timestamp upper bound." },
+                limit: { type: "number", description: "Max recordings (default 25, max 100)." },
+            },
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentry_get_session_replay",
+        description: "Fetch a single session recording's metadata + player URL. Open `player_url` in a " +
+            "browser to watch. For programmatic DOM-event inspection (the snapshot data), call " +
+            "the snapshots subresource directly via curl using the agentry-injected master key.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string" },
+                replay_id: { type: "string" },
+            },
+            required: ["replay_id"],
+            additionalProperties: false,
+        },
+    },
     {
         name: "agentry_repair_analytics",
         description: "Re-attempt PostHog provisioning for the authenticated user. Idempotent — if the user " +
@@ -831,6 +1237,12 @@ function persistKeyResponse(cfg, resp) {
     const next = {
         ...cfg,
         api_key: resp.api_key,
+        // Persist the agp_ public key too (returned by login response). Only
+        // overwrite if the new response provides one; rotation/repair paths
+        // don't necessarily return public keys.
+        ...(resp.public_api_key && !resp.public_api_key.startsWith("(redacted")
+            ? { public_api_key: resp.public_api_key }
+            : {}),
     };
     saveConfig(next);
     return next;
@@ -901,6 +1313,130 @@ export async function dispatchTool(name, args) {
                 return await handleRotateKey();
             case "agentry_repair_analytics":
                 return await handleRepairAnalytics();
+            case "agentry_publish_query":
+                return await handlePublishQuery({
+                    project_id: a.project_id ? String(a.project_id) : undefined,
+                    recipe_id: String(a.recipe_id ?? ""),
+                    params: a.params && typeof a.params === "object"
+                        ? a.params
+                        : undefined,
+                    description: a.description ? String(a.description) : undefined,
+                });
+            case "agentry_list_publications":
+                return await handleListPublications(a.project_id ? String(a.project_id) : undefined);
+            case "agentry_revoke_publication":
+                return await handleRevokePublication({
+                    project_id: a.project_id ? String(a.project_id) : undefined,
+                    publication_id: String(a.publication_id ?? ""),
+                });
+            case "agentry_configure_session_replay":
+                return await handleConfigureSessionReplay({
+                    project_id: a.project_id ? String(a.project_id) : undefined,
+                    strategy: String(a.strategy ?? ""),
+                    sample_rate: typeof a.sample_rate === "number" ? a.sample_rate : undefined,
+                    retention_days: typeof a.retention_days === "number" ? a.retention_days : undefined,
+                    min_duration_ms: typeof a.min_duration_ms === "number" ? a.min_duration_ms : undefined,
+                    url_triggers: Array.isArray(a.url_triggers)
+                        ? a.url_triggers
+                        : undefined,
+                });
+            case "agentry_session_replay_status":
+                return await handleSessionReplayStatus(a.project_id ? String(a.project_id) : undefined);
+            case "agentry_list_feature_flags":
+                return await handleListFeatureFlags({
+                    project_id: a.project_id ? String(a.project_id) : undefined,
+                    limit: typeof a.limit === "number" ? a.limit : undefined,
+                });
+            case "agentry_get_feature_flag":
+                return await handleGetFeatureFlag({
+                    project_id: a.project_id ? String(a.project_id) : undefined,
+                    flag_id: String(a.flag_id ?? ""),
+                });
+            case "agentry_create_feature_flag":
+                return await handleCreateFeatureFlag({
+                    project_id: a.project_id ? String(a.project_id) : undefined,
+                    key: String(a.key ?? ""),
+                    name: a.name ? String(a.name) : undefined,
+                    active: typeof a.active === "boolean" ? a.active : undefined,
+                    rollout_percentage: typeof a.rollout_percentage === "number" ? a.rollout_percentage : undefined,
+                    filters: a.filters && typeof a.filters === "object" ? a.filters : undefined,
+                });
+            case "agentry_update_feature_flag":
+                return await handleUpdateFeatureFlag({
+                    project_id: a.project_id ? String(a.project_id) : undefined,
+                    flag_id: String(a.flag_id ?? ""),
+                    active: typeof a.active === "boolean" ? a.active : undefined,
+                    name: a.name ? String(a.name) : undefined,
+                    rollout_percentage: typeof a.rollout_percentage === "number" ? a.rollout_percentage : undefined,
+                    filters: a.filters && typeof a.filters === "object" ? a.filters : undefined,
+                });
+            case "agentry_delete_feature_flag":
+                return await handleDeleteFeatureFlag({
+                    project_id: a.project_id ? String(a.project_id) : undefined,
+                    flag_id: String(a.flag_id ?? ""),
+                });
+            case "agentry_list_cohorts":
+                return await handleListCohorts(a.project_id ? String(a.project_id) : undefined);
+            case "agentry_get_cohort":
+                return await handleGetCohort({
+                    project_id: a.project_id ? String(a.project_id) : undefined,
+                    cohort_id: String(a.cohort_id ?? ""),
+                });
+            case "agentry_create_cohort":
+                return await handleCreateCohort({
+                    project_id: a.project_id ? String(a.project_id) : undefined,
+                    name: String(a.name ?? ""),
+                    event: a.event ? String(a.event) : undefined,
+                    days: typeof a.days === "number" ? a.days : undefined,
+                    groups: Array.isArray(a.groups) ? a.groups : undefined,
+                });
+            case "agentry_delete_cohort":
+                return await handleDeleteCohort({
+                    project_id: a.project_id ? String(a.project_id) : undefined,
+                    cohort_id: String(a.cohort_id ?? ""),
+                });
+            case "agentry_list_surveys":
+                return await handleListSurveys(a.project_id ? String(a.project_id) : undefined);
+            case "agentry_get_survey":
+                return await handleGetSurvey({
+                    project_id: a.project_id ? String(a.project_id) : undefined,
+                    survey_id: String(a.survey_id ?? ""),
+                });
+            case "agentry_create_survey":
+                return await handleCreateSurvey({
+                    project_id: a.project_id ? String(a.project_id) : undefined,
+                    name: String(a.name ?? ""),
+                    type: a.type ? String(a.type) : undefined,
+                    question: a.question ? String(a.question) : undefined,
+                    question_type: a.question_type
+                        ? String(a.question_type)
+                        : undefined,
+                    questions: Array.isArray(a.questions) ? a.questions : undefined,
+                    description: a.description ? String(a.description) : undefined,
+                    linked_flag_id: typeof a.linked_flag_id === "number" ? a.linked_flag_id : undefined,
+                    targeting_flag_id: typeof a.targeting_flag_id === "number" ? a.targeting_flag_id : undefined,
+                    conditions: a.conditions && typeof a.conditions === "object" ? a.conditions : undefined,
+                    appearance: a.appearance && typeof a.appearance === "object" ? a.appearance : undefined,
+                    start_date: a.start_date ? String(a.start_date) : undefined,
+                });
+            case "agentry_delete_survey":
+                return await handleDeleteSurvey({
+                    project_id: a.project_id ? String(a.project_id) : undefined,
+                    survey_id: String(a.survey_id ?? ""),
+                });
+            case "agentry_list_session_replays":
+                return await handleListSessionReplays({
+                    project_id: a.project_id ? String(a.project_id) : undefined,
+                    distinct_id: a.distinct_id ? String(a.distinct_id) : undefined,
+                    date_from: a.date_from ? String(a.date_from) : undefined,
+                    date_to: a.date_to ? String(a.date_to) : undefined,
+                    limit: typeof a.limit === "number" ? a.limit : undefined,
+                });
+            case "agentry_get_session_replay":
+                return await handleGetSessionReplay({
+                    project_id: a.project_id ? String(a.project_id) : undefined,
+                    replay_id: String(a.replay_id ?? ""),
+                });
             case "agentry_list_projects":
                 return await handleListProjects();
             case "agentry_create_project":
@@ -1299,6 +1835,306 @@ async function handleRepairAnalytics() {
         };
     }
 }
+async function handlePublishQuery(input) {
+    const cfg = loadConfig();
+    const picked = pickProject(cfg, input.project_id);
+    if (!picked) {
+        return {
+            error: {
+                code: "no_project",
+                message: "No project_id given and no default project set.",
+                next_action: "Pass project_id, or call agentry_create_project.",
+            },
+        };
+    }
+    const resp = await api.publishQuery(cfg, picked.id, {
+        recipe_id: input.recipe_id,
+        params: input.params,
+        description: input.description,
+    });
+    // Help the agent: fetch the user's agp_ key from the local config and
+    // append it as a query param to the public URL.
+    const agp = cfg.public_api_key ?? null;
+    const embeddableUrl = agp ? `${resp.public_url}?key=${agp}` : resp.public_url;
+    return {
+        ...resp,
+        embeddable_url: embeddableUrl,
+        next_action: agp
+            ? "Embed embeddable_url in the public dashboard. CORS is open. Revoke any time with " +
+                "agentry_revoke_publication if it's leaked or no longer needed."
+            : "Your agp_ public key isn't cached locally yet — call agentry_login to mint it. Once " +
+                "minted, paste it as ?key=<agp_…> on the public_url to embed.",
+    };
+}
+async function handleListPublications(projectId) {
+    const cfg = loadConfig();
+    const picked = pickProject(cfg, projectId);
+    if (!picked) {
+        return {
+            error: {
+                code: "no_project",
+                message: "No project_id given and no default project set.",
+                next_action: "Pass project_id.",
+            },
+        };
+    }
+    return await api.listPublications(cfg, picked.id);
+}
+async function handleRevokePublication(input) {
+    const cfg = loadConfig();
+    const picked = pickProject(cfg, input.project_id);
+    if (!picked) {
+        return {
+            error: {
+                code: "no_project",
+                message: "No project_id given and no default project set.",
+                next_action: "Pass project_id.",
+            },
+        };
+    }
+    return await api.revokePublication(cfg, picked.id, input.publication_id);
+}
+async function handleConfigureSessionReplay(input) {
+    const cfg = loadConfig();
+    const picked = pickProject(cfg, input.project_id);
+    if (!picked) {
+        return {
+            error: {
+                code: "no_project",
+                message: "No project_id given and no default project set.",
+                next_action: "Pass project_id, or call agentry_create_project.",
+            },
+        };
+    }
+    return await api.configureSessionReplay(cfg, picked.id, {
+        strategy: input.strategy,
+        sample_rate: input.sample_rate,
+        retention_days: input.retention_days,
+        min_duration_ms: input.min_duration_ms,
+        url_triggers: input.url_triggers,
+    });
+}
+async function handleSessionReplayStatus(projectId) {
+    const cfg = loadConfig();
+    const picked = pickProject(cfg, projectId);
+    if (!picked) {
+        return {
+            error: {
+                code: "no_project",
+                message: "No project_id given and no default project set.",
+                next_action: "Pass project_id, or call agentry_create_project.",
+            },
+        };
+    }
+    return await api.getSessionReplayStatus(cfg, picked.id);
+}
+// ---------------------------------------------------------------------------
+// PostHog per-user-team CRUD handlers.
+// Shared helper for the "no project" error envelope to keep handlers terse.
+// ---------------------------------------------------------------------------
+function pickOrError(cfg, projectId) {
+    const picked = pickProject(cfg, projectId);
+    if (!picked) {
+        return {
+            ok: false,
+            error: {
+                error: {
+                    code: "no_project",
+                    message: "No project_id given and no default project set.",
+                    next_action: "Pass project_id, or call agentry_create_project.",
+                },
+            },
+        };
+    }
+    return { ok: true, id: picked.id };
+}
+async function handleListFeatureFlags(input) {
+    const cfg = loadConfig();
+    const r = pickOrError(cfg, input.project_id);
+    if (!r.ok)
+        return r.error;
+    return await api.listFeatureFlags(cfg, r.id, { limit: input.limit });
+}
+async function handleGetFeatureFlag(input) {
+    if (!input.flag_id) {
+        return { error: { code: "invalid_payload", message: "flag_id is required.", next_action: "Pass flag_id (numeric, from agentry_list_feature_flags)." } };
+    }
+    const cfg = loadConfig();
+    const r = pickOrError(cfg, input.project_id);
+    if (!r.ok)
+        return r.error;
+    return await api.getFeatureFlag(cfg, r.id, input.flag_id);
+}
+async function handleCreateFeatureFlag(input) {
+    if (!input.key) {
+        return { error: { code: "invalid_payload", message: "key is required.", next_action: "Pass key (slug, e.g. 'new-checkout-flow')." } };
+    }
+    const cfg = loadConfig();
+    const r = pickOrError(cfg, input.project_id);
+    if (!r.ok)
+        return r.error;
+    return await api.createFeatureFlag(cfg, r.id, {
+        key: input.key,
+        name: input.name,
+        active: input.active,
+        rollout_percentage: input.rollout_percentage,
+        filters: input.filters,
+    });
+}
+async function handleUpdateFeatureFlag(input) {
+    if (!input.flag_id) {
+        return { error: { code: "invalid_payload", message: "flag_id is required.", next_action: "Pass flag_id (numeric)." } };
+    }
+    const cfg = loadConfig();
+    const r = pickOrError(cfg, input.project_id);
+    if (!r.ok)
+        return r.error;
+    return await api.updateFeatureFlag(cfg, r.id, input.flag_id, {
+        active: input.active,
+        name: input.name,
+        rollout_percentage: input.rollout_percentage,
+        filters: input.filters,
+    });
+}
+async function handleDeleteFeatureFlag(input) {
+    if (!input.flag_id) {
+        return { error: { code: "invalid_payload", message: "flag_id is required.", next_action: "Pass flag_id (numeric)." } };
+    }
+    const cfg = loadConfig();
+    const r = pickOrError(cfg, input.project_id);
+    if (!r.ok)
+        return r.error;
+    return await api.deleteFeatureFlag(cfg, r.id, input.flag_id);
+}
+async function handleListCohorts(projectId) {
+    const cfg = loadConfig();
+    const r = pickOrError(cfg, projectId);
+    if (!r.ok)
+        return r.error;
+    return await api.listCohorts(cfg, r.id);
+}
+async function handleGetCohort(input) {
+    if (!input.cohort_id) {
+        return { error: { code: "invalid_payload", message: "cohort_id is required.", next_action: "Pass cohort_id (numeric)." } };
+    }
+    const cfg = loadConfig();
+    const r = pickOrError(cfg, input.project_id);
+    if (!r.ok)
+        return r.error;
+    return await api.getCohort(cfg, r.id, input.cohort_id);
+}
+async function handleCreateCohort(input) {
+    if (!input.name) {
+        return { error: { code: "invalid_payload", message: "name is required.", next_action: "Pass cohort name." } };
+    }
+    if (!input.event && (!input.groups || input.groups.length === 0)) {
+        return {
+            error: {
+                code: "invalid_payload",
+                message: "Cohort body must include 'event' (simple shape) or 'groups' (advanced shape).",
+                next_action: "Pass event='signup_completed' (last N days) or pass groups: [...PostHog filter format].",
+            },
+        };
+    }
+    const cfg = loadConfig();
+    const r = pickOrError(cfg, input.project_id);
+    if (!r.ok)
+        return r.error;
+    const body = input.groups
+        ? { name: input.name, groups: input.groups }
+        : { name: input.name, event: input.event, days: input.days };
+    return await api.createCohort(cfg, r.id, body);
+}
+async function handleDeleteCohort(input) {
+    if (!input.cohort_id) {
+        return { error: { code: "invalid_payload", message: "cohort_id is required.", next_action: "Pass cohort_id (numeric)." } };
+    }
+    const cfg = loadConfig();
+    const r = pickOrError(cfg, input.project_id);
+    if (!r.ok)
+        return r.error;
+    return await api.deleteCohort(cfg, r.id, input.cohort_id);
+}
+async function handleListSurveys(projectId) {
+    const cfg = loadConfig();
+    const r = pickOrError(cfg, projectId);
+    if (!r.ok)
+        return r.error;
+    return await api.listSurveys(cfg, r.id);
+}
+async function handleGetSurvey(input) {
+    if (!input.survey_id) {
+        return { error: { code: "invalid_payload", message: "survey_id is required.", next_action: "Pass survey_id." } };
+    }
+    const cfg = loadConfig();
+    const r = pickOrError(cfg, input.project_id);
+    if (!r.ok)
+        return r.error;
+    return await api.getSurvey(cfg, r.id, input.survey_id);
+}
+async function handleCreateSurvey(input) {
+    if (!input.name) {
+        return { error: { code: "invalid_payload", message: "name is required.", next_action: "Pass survey name." } };
+    }
+    if (!input.question && (!input.questions || input.questions.length === 0)) {
+        return {
+            error: {
+                code: "invalid_payload",
+                message: "Survey must include 'question' (simple) or 'questions' (multi).",
+                next_action: "Pass question='How likely are you to recommend us?' OR questions: [{type, question}, ...]",
+            },
+        };
+    }
+    const cfg = loadConfig();
+    const r = pickOrError(cfg, input.project_id);
+    if (!r.ok)
+        return r.error;
+    return await api.createSurvey(cfg, r.id, {
+        name: input.name,
+        type: input.type,
+        question: input.question,
+        question_type: input.question_type,
+        questions: input.questions,
+        description: input.description,
+        linked_flag_id: input.linked_flag_id,
+        targeting_flag_id: input.targeting_flag_id,
+        conditions: input.conditions,
+        appearance: input.appearance,
+        start_date: input.start_date,
+    });
+}
+async function handleDeleteSurvey(input) {
+    if (!input.survey_id) {
+        return { error: { code: "invalid_payload", message: "survey_id is required.", next_action: "Pass survey_id." } };
+    }
+    const cfg = loadConfig();
+    const r = pickOrError(cfg, input.project_id);
+    if (!r.ok)
+        return r.error;
+    return await api.deleteSurvey(cfg, r.id, input.survey_id);
+}
+async function handleListSessionReplays(input) {
+    const cfg = loadConfig();
+    const r = pickOrError(cfg, input.project_id);
+    if (!r.ok)
+        return r.error;
+    return await api.listSessionReplays(cfg, r.id, {
+        distinctId: input.distinct_id,
+        dateFrom: input.date_from,
+        dateTo: input.date_to,
+        limit: input.limit,
+    });
+}
+async function handleGetSessionReplay(input) {
+    if (!input.replay_id) {
+        return { error: { code: "invalid_payload", message: "replay_id is required.", next_action: "Pass replay_id from agentry_list_session_replays." } };
+    }
+    const cfg = loadConfig();
+    const r = pickOrError(cfg, input.project_id);
+    if (!r.ok)
+        return r.error;
+    return await api.getSessionReplay(cfg, r.id, input.replay_id);
+}
 async function handleListProjects() {
     const cfg = loadConfig();
     if (!cfg.api_key) {