@agentrysh/mcp 0.0.10 → 0.0.13

package/dist/tools.js

@@ -57,6 +57,70 @@ 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. " +
@@ -122,16 +186,420 @@ export const TOOL_DESCRIPTORS = [
     {
         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 viewing recordings. " +
+            "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." +
             "" +
-            "agentry's MCP can't currently retrieve recording bytes programmatically — the master " +
-            "Personal API Key needs `session_recording:read` scope expanded. As an interim, this " +
-            "tool returns `web_ui_url` — paste into a browser to view recordings. Coming: " +
-            "agentry_get_session_replays(case_id) returning playable URLs once scope is widened.",
+            "  - 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 rrweb snapshots), " +
+            "call agentry_get_replay_snapshots.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string" },
+                replay_id: { type: "string" },
+            },
+            required: ["replay_id"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentry_get_replay_snapshots",
+        description: "Fetch the rrweb-format DOM snapshots for one recording. Each snapshot has type " +
+            "(Meta / FullSnapshot / IncrementalSnapshot — values 4 / 2 / 3) and timestamp. " +
+            "For agent inspection: filter type=3 events for user actions (clicks, scrolls, " +
+            "inputs). Useful for reconstructing exactly what the user did before an error.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string" },
+                replay_id: { type: "string" },
+                source: {
+                    type: "string",
+                    enum: ["realtime", "blob"],
+                    description: "PostHog snapshot source. 'realtime' for live, 'blob' for archived.",
+                },
+            },
+            required: ["replay_id"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentry_evaluate_feature_flag",
+        description: "Evaluate feature flags for one user (distinct_id). Two shapes:" +
+            "" +
+            "  - Pass `key` to get a single flag's value (boolean / variant string / null if " +
+            "    not active for this user)." +
+            "  - Omit `key` to get a map of all currently-active flags for the user." +
+            "" +
+            "Use this when investigating a bug — 'is this user in the new checkout flow?' is " +
+            "one call away. Pass `person_properties` to override the stored properties for " +
+            "what-if evaluation.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string" },
+                distinct_id: { type: "string", description: "Stable per-user id, same as case.affected_users[].distinct_id." },
+                key: { type: "string", description: "Flag key. Omit to get all flags." },
+                person_properties: { type: "object", description: "Override stored properties for what-if." },
+                groups: { type: "object", description: "Group analytics overrides if your flag targets groups." },
+            },
+            required: ["distinct_id"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentry_get_distinct_id_summary",
+        description: "One-call user dossier. Returns: PostHog person properties, total event count, " +
+            "first/last seen, last 20 events, recent session recordings (if replay is on), and " +
+            "a deep-link URL into PostHog's persons UI. Use this when investigating a case — " +
+            "the affected_users[].distinct_id from agentry_get_case lets you build the full " +
+            "picture without 3+ separate HogQL calls.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string" },
+                distinct_id: { type: "string" },
+            },
+            required: ["distinct_id"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentry_survey_responses",
+        description: "Roll-up of survey responses. Returns: the survey definition (questions + choice " +
+            "labels), a response_distribution (counts per choice), the last 50 free-text " +
+            "responses with timestamps, and a web UI deep-link. Saves the agent from composing " +
+            "HogQL with $survey_response property unpacking.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string" },
+                survey_id: { type: "string" },
+            },
+            required: ["survey_id"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentry_create_ab_test",
+        description: "Composite tool: creates a multivariate feature flag AND returns the bound " +
+            "conversion-rate HogQL query an agent can run later via agentry_analytics_query. " +
+            "" +
+            "Pass `name`, `success_event` (e.g. 'checkout_completed'), and `variants` (array of " +
+            "{key} — auto-split rollout if rollout_percentage not given; must sum to 100 if " +
+            "any are explicit). Optional flag_key (default: slugified name)." +
+            "" +
+            "Returns: flag_id, conversion_query string, web_ui_url. Recommended: ≥1000 users " +
+            "per variant before drawing conclusions.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string" },
+                name: { type: "string" },
+                flag_key: { type: "string", description: "Override the slugified name." },
+                success_event: { type: "string", description: "The event whose conversion you're measuring." },
+                variants: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            key: { type: "string" },
+                            name: { type: "string" },
+                            rollout_percentage: { type: "number" },
+                        },
+                    },
+                    description: "Min 2 variants. Auto-split if rollout_percentage omitted.",
+                },
+            },
+            required: ["name", "success_event", "variants"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentry_recent_changes",
+        description: "Read the agent-mutation audit log. Returns every flag/cohort/survey/publication/" +
+            "session-replay mutation the agent (or anyone with your `agk_` key) has made in the " +
+            "last N hours." +
+            "" +
+            "Default window is 24 hours. Pass `hours` to widen — 48, 72, 168 (week), max 720 (30d)." +
+            "Pass `action_prefix` (e.g. 'feature_flag.' / 'cohort.' / 'survey.' / 'publication.' / " +
+            "'session_replay.') or `resource_type` to filter. Use this as a periodic " +
+            "'what-did-the-agent-do' check when leaving agents to run unattended.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                hours: { type: "number", description: "Lookback window. 1..720. Default 24." },
+                action_prefix: {
+                    type: "string",
+                    description: "Filter by action prefix (e.g. 'feature_flag.' matches both create + delete).",
+                },
+                resource_type: {
+                    type: "string",
+                    enum: ["feature_flag", "cohort", "survey", "publication", "session_replay", "ab_test"],
+                },
+                project_id: { type: "string", description: "Restrict to one project." },
+                limit: { type: "number", description: "Max rows (default 200, max 500)." },
             },
             additionalProperties: false,
         },
@@ -910,6 +1378,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;
@@ -980,6 +1454,22 @@ 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,
@@ -993,6 +1483,147 @@ export async function dispatchTool(name, args) {
                 });
             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_get_replay_snapshots":
+                return await handleGetReplaySnapshots({
+                    project_id: a.project_id ? String(a.project_id) : undefined,
+                    replay_id: String(a.replay_id ?? ""),
+                    source: a.source ? String(a.source) : undefined,
+                });
+            case "agentry_evaluate_feature_flag":
+                return await handleEvaluateFeatureFlag({
+                    project_id: a.project_id ? String(a.project_id) : undefined,
+                    distinct_id: String(a.distinct_id ?? ""),
+                    key: a.key ? String(a.key) : undefined,
+                    person_properties: a.person_properties && typeof a.person_properties === "object"
+                        ? a.person_properties
+                        : undefined,
+                    groups: a.groups && typeof a.groups === "object"
+                        ? a.groups
+                        : undefined,
+                });
+            case "agentry_get_distinct_id_summary":
+                return await handleGetDistinctIdSummary({
+                    project_id: a.project_id ? String(a.project_id) : undefined,
+                    distinct_id: String(a.distinct_id ?? ""),
+                });
+            case "agentry_survey_responses":
+                return await handleSurveyResponses({
+                    project_id: a.project_id ? String(a.project_id) : undefined,
+                    survey_id: String(a.survey_id ?? ""),
+                });
+            case "agentry_create_ab_test":
+                return await handleCreateAbTest({
+                    project_id: a.project_id ? String(a.project_id) : undefined,
+                    name: String(a.name ?? ""),
+                    flag_key: a.flag_key ? String(a.flag_key) : undefined,
+                    success_event: String(a.success_event ?? ""),
+                    variants: Array.isArray(a.variants)
+                        ? a.variants
+                        : [],
+                });
+            case "agentry_recent_changes":
+                return await handleRecentChanges({
+                    hours: typeof a.hours === "number" ? a.hours : undefined,
+                    action_prefix: a.action_prefix ? String(a.action_prefix) : undefined,
+                    resource_type: a.resource_type ? String(a.resource_type) : undefined,
+                    project_id: a.project_id ? String(a.project_id) : undefined,
+                    limit: typeof a.limit === "number" ? a.limit : undefined,
+                });
             case "agentry_list_projects":
                 return await handleListProjects();
             case "agentry_create_project":
@@ -1391,6 +2022,65 @@ 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);
@@ -1425,6 +2115,298 @@ async function handleSessionReplayStatus(projectId) {
     }
     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 handleGetReplaySnapshots(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.getReplaySnapshots(cfg, r.id, input.replay_id, input.source);
+}
+async function handleEvaluateFeatureFlag(input) {
+    if (!input.distinct_id) {
+        return { error: { code: "invalid_payload", message: "distinct_id is required.", next_action: "Pass the user identifier (same as case.affected_users[].distinct_id)." } };
+    }
+    const cfg = loadConfig();
+    const r = pickOrError(cfg, input.project_id);
+    if (!r.ok)
+        return r.error;
+    return await api.evaluateFeatureFlag(cfg, r.id, {
+        distinct_id: input.distinct_id,
+        key: input.key,
+        person_properties: input.person_properties,
+        groups: input.groups,
+    });
+}
+async function handleGetDistinctIdSummary(input) {
+    if (!input.distinct_id) {
+        return { error: { code: "invalid_payload", message: "distinct_id is required.", next_action: "Pass the user identifier." } };
+    }
+    const cfg = loadConfig();
+    const r = pickOrError(cfg, input.project_id);
+    if (!r.ok)
+        return r.error;
+    return await api.getDistinctIdSummary(cfg, r.id, input.distinct_id);
+}
+async function handleSurveyResponses(input) {
+    if (!input.survey_id) {
+        return { error: { code: "invalid_payload", message: "survey_id is required.", next_action: "Pass survey_id from agentry_list_surveys." } };
+    }
+    const cfg = loadConfig();
+    const r = pickOrError(cfg, input.project_id);
+    if (!r.ok)
+        return r.error;
+    return await api.getSurveyResponses(cfg, r.id, input.survey_id);
+}
+async function handleCreateAbTest(input) {
+    if (!input.name) {
+        return { error: { code: "invalid_payload", message: "name is required.", next_action: "Pass an A/B test name." } };
+    }
+    if (!input.success_event) {
+        return { error: { code: "invalid_payload", message: "success_event is required.", next_action: "Pass the conversion event name (e.g. 'checkout_completed')." } };
+    }
+    if (!Array.isArray(input.variants) || input.variants.length < 2) {
+        return { error: { code: "invalid_payload", message: "variants must be ≥2 entries.", next_action: "Pass variants: [{key:'control'},{key:'treatment'}]." } };
+    }
+    const cfg = loadConfig();
+    const r = pickOrError(cfg, input.project_id);
+    if (!r.ok)
+        return r.error;
+    return await api.createAbTest(cfg, r.id, {
+        name: input.name,
+        flag_key: input.flag_key,
+        success_event: input.success_event,
+        variants: input.variants,
+    });
+}
+async function handleRecentChanges(input) {
+    const cfg = loadConfig();
+    if (!cfg.api_key) {
+        return {
+            error: {
+                code: "no_key",
+                message: "No API key on file.",
+                next_action: "Call agentry_login.",
+            },
+        };
+    }
+    return await api.listRecentChanges(cfg, {
+        hours: input.hours,
+        actionPrefix: input.action_prefix,
+        resourceType: input.resource_type,
+        projectId: input.project_id,
+        limit: input.limit,
+    });
+}
 async function handleListProjects() {
     const cfg = loadConfig();
     if (!cfg.api_key) {