@ascendkit/cli 0.2.6 → 0.3.0

package/dist/tools/platform.js

@@ -15,13 +15,47 @@ export function registerPlatformTools(server, client) {
             ],
         };
     });
-    server.tool("platform_list_projects", "List all projects in your organization", {}, async () => {
+    server.tool("ascendkit_set_env", "Set the active environment by public key and persist the shared .ascendkit environment context used by both MCP and CLI.", {
+        publicKey: z.string().describe("Environment public key (pk_dev_..., pk_beta_..., or pk_prod_...)"),
+    }, async (params) => {
+        try {
+            const data = await platform.mcpSetEnvironmentByPublicKey(client, params.publicKey);
+            return {
+                content: [{
+                        type: "text",
+                        text: `Active environment: ${data.environment.name} (${data.environment.tier})\n` +
+                            `Project: ${data.project.name}\n` +
+                            `Public key: ${data.environment.publicKey}\n` +
+                            `Updated env files: ${Array.isArray(data.updatedFiles) && data.updatedFiles.length > 0 ? data.updatedFiles.join(", ") : "(none)"}`,
+                    }],
+            };
+        }
+        catch (err) {
+            let message = err instanceof Error ? err.message : String(err);
+            const jsonMatch = message.match(/\{.*\}/s);
+            if (jsonMatch) {
+                try {
+                    const parsed = JSON.parse(jsonMatch[0]);
+                    if (parsed.error)
+                        message = parsed.error;
+                    else if (parsed.detail)
+                        message = parsed.detail;
+                }
+                catch { /* use raw message */ }
+            }
+            return {
+                content: [{ type: "text", text: message }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("project_list", "List all projects in your organization", {}, async () => {
         const data = await platform.mcpListProjects(client);
         return {
             content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
         };
     });
-    server.tool("platform_create_project", "Create a new project in your organization", {
+    server.tool("project_create", "Create a new project in your organization", {
         name: z.string().describe("Project name"),
         description: z.string().optional().describe("Project description"),
         enabledServices: z
@@ -54,7 +88,7 @@ export function registerPlatformTools(server, client) {
             };
         }
     });
-    server.tool("platform_list_environments", "List environments for a project", {
+    server.tool("env_list", "List environments for a project", {
         projectId: z.string().describe("Project ID (prj_ prefixed)"),
     }, async (params) => {
         const data = await platform.mcpListEnvironments(client, params.projectId);
@@ -62,7 +96,7 @@ export function registerPlatformTools(server, client) {
             content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
         };
     });
-    server.tool("platform_create_environment", "Create a new environment for a project. Returns the public key needed for SDK/CLI configuration.", {
+    server.tool("env_create", "Create a new environment for a project. Returns the public key needed for SDK/CLI configuration.", {
         projectId: z.string().describe("Project ID (prj_ prefixed)"),
         name: z
             .string()
@@ -101,7 +135,7 @@ export function registerPlatformTools(server, client) {
             };
         }
     });
-    server.tool("platform_update_environment", "Update an environment's name or description.", {
+    server.tool("env_update", "Update an environment's name or description.", {
         projectId: z.string().describe("Project ID (prj_ prefixed)"),
         environmentId: z.string().describe("Environment ID (env_ prefixed)"),
         name: z.string().optional().describe("New environment name"),
@@ -138,7 +172,7 @@ export function registerPlatformTools(server, client) {
             };
         }
     });
-    server.tool("platform_promote_environment", "Promote an environment's configuration to a higher tier (dev → beta → prod).", {
+    server.tool("env_promote", "Promote an environment's configuration to a higher tier (dev → beta → prod).", {
         environmentId: z.string().describe("Environment ID to promote"),
         targetTier: z
             .string()
@@ -172,10 +206,39 @@ export function registerPlatformTools(server, client) {
             };
         }
     });
-    server.tool("platform_update_environment_variables", "Set environment variables for a project environment. Pass the full variables dict — it replaces all existing variables.", {
-        projectId: z.string().describe("Project ID (prj_ prefixed)"),
-        envId: z.string().describe("Environment ID (env_ prefixed)"),
-        variables: z.record(z.string()).describe("Key-value map of environment variables"),
+    server.tool("keystore_list", "List keystore values for the active environment. Uses the shared .ascendkit environment context by default.", {
+        projectId: z.string().optional().describe("Optional project ID override (defaults to active environment project)"),
+        envId: z.string().optional().describe("Optional environment ID override (defaults to active environment)"),
+    }, async (params) => {
+        try {
+            const env = await platform.mcpGetEnvironment(client, params);
+            const variables = (env.variables ?? {});
+            const entries = Object.entries(variables);
+            const systemVariables = Array.isArray(env.systemVariables)
+                ? env.systemVariables
+                : [];
+            const sections = [];
+            sections.push(entries.length === 0
+                ? "Custom variables:\n(none)"
+                : `Custom variables:\n${entries.map(([key, value]) => `${key}=${value}`).join("\n")}`);
+            if (systemVariables.length > 0) {
+                sections.push(`System variables:\n${systemVariables
+                    .map((item) => `${String(item.key)} = ${String(item.valuePreview)} (${String(item.availability)})`)
+                    .join("\n")}`);
+            }
+            return {
+                content: [{ type: "text", text: sections.join("\n\n") }],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return { content: [{ type: "text", text: message }], isError: true };
+        }
+    });
+    server.tool("keystore_replace", "Replace the full keystore for the active environment. Pass the full key-value map.", {
+        projectId: z.string().optional().describe("Optional project ID override (defaults to active environment project)"),
+        envId: z.string().optional().describe("Optional environment ID override (defaults to active environment)"),
+        variables: z.record(z.string()).describe("Key-value map of keystore values"),
     }, async (params) => {
         try {
             const data = await platform.mcpUpdateEnvironmentVariables(client, params);
@@ -202,4 +265,56 @@ export function registerPlatformTools(server, client) {
             };
         }
     });
+    server.tool("keystore_set", "Set a single keystore key for the active environment.", {
+        projectId: z.string().optional().describe("Optional project ID override (defaults to active environment project)"),
+        envId: z.string().optional().describe("Optional environment ID override (defaults to active environment)"),
+        key: z.string().describe("Keystore key"),
+        value: z.string().describe("Keystore value"),
+    }, async (params) => {
+        try {
+            const env = await platform.mcpGetEnvironment(client, {
+                projectId: params.projectId,
+                envId: params.envId,
+            });
+            const variables = { ...(env.variables ?? {}), [params.key]: params.value };
+            const data = await platform.mcpUpdateEnvironmentVariables(client, {
+                projectId: params.projectId,
+                envId: params.envId,
+                variables,
+            });
+            return {
+                content: [{ type: "text", text: `Saved ${params.key}=${params.value}\n\n${JSON.stringify(data, null, 2)}` }],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return { content: [{ type: "text", text: message }], isError: true };
+        }
+    });
+    server.tool("keystore_remove", "Remove a single keystore key from the active environment.", {
+        projectId: z.string().optional().describe("Optional project ID override (defaults to active environment project)"),
+        envId: z.string().optional().describe("Optional environment ID override (defaults to active environment)"),
+        key: z.string().describe("Keystore key to remove"),
+    }, async (params) => {
+        try {
+            const env = await platform.mcpGetEnvironment(client, {
+                projectId: params.projectId,
+                envId: params.envId,
+            });
+            const variables = { ...(env.variables ?? {}) };
+            delete variables[params.key];
+            const data = await platform.mcpUpdateEnvironmentVariables(client, {
+                projectId: params.projectId,
+                envId: params.envId,
+                variables,
+            });
+            return {
+                content: [{ type: "text", text: `Removed ${params.key}\n\n${JSON.stringify(data, null, 2)}` }],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return { content: [{ type: "text", text: message }], isError: true };
+        }
+    });
 }

package/dist/tools/surveys.js

@@ -2,7 +2,7 @@ import { z } from "zod";
 import * as surveys from "../commands/surveys.js";
 import { formatDistributionResult, formatQuestionList, formatSingleQuestion, formatSurveyList, formatSurveyWithGuidance, } from "../utils/survey-format.js";
 export function registerSurveyTools(server, client) {
-    server.tool("survey_create", "Create a new survey. Use type 'nps' or 'csat' for ready-to-use presets with standard questions, or 'custom' to build from scratch with survey_add_question. Survey lifecycle: create → add questions → activate → distribute → collect → analyze.", {
+    server.tool("survey_create", "Create a new survey. Use type 'nps' or 'csat' for ready-to-use presets with standard questions, or 'custom' to build from scratch with survey_question_add. Survey lifecycle: create → add questions → activate → distribute → collect → analyze.", {
         name: z.string().describe("Survey name, e.g. 'Q1 NPS Survey'"),
         type: z
             .enum(["nps", "csat", "custom"])
@@ -22,7 +22,7 @@ export function registerSurveyTools(server, client) {
         const formatted = formatSurveyList(data);
         return { content: [{ type: "text", text: formatted }] };
     });
-    server.tool("survey_get", "Get a survey by ID with status, question count, response count, and next-step guidance.", {
+    server.tool("survey_show", "Get a survey by ID with status, question count, response count, and next-step guidance.", {
         surveyId: z.string().describe("Survey ID (srv_ prefixed)"),
     }, async (params) => {
         const data = await surveys.getSurvey(client, params.surveyId);
@@ -46,7 +46,7 @@ export function registerSurveyTools(server, client) {
         const formatted = formatSurveyWithGuidance(data);
         return { content: [{ type: "text", text: formatted }] };
     });
-    server.tool("survey_delete", "Delete a survey and all its invitations and responses", {
+    server.tool("survey_remove", "Delete a survey and all its invitations and responses", {
         surveyId: z.string().describe("Survey ID (srv_ prefixed)"),
     }, async (params) => {
         const data = await surveys.deleteSurvey(client, params.surveyId);
@@ -62,7 +62,7 @@ export function registerSurveyTools(server, client) {
         const formatted = formatDistributionResult(data);
         return { content: [{ type: "text", text: formatted }] };
     });
-    server.tool("survey_list_invitations", "List all invitations for a survey with their status (sent/opened/submitted)", {
+    server.tool("survey_invitation_list", "List all invitations for a survey with their status (sent/opened/submitted)", {
         surveyId: z.string().describe("Survey ID (srv_ prefixed)"),
     }, async (params) => {
         const data = await surveys.listInvitations(client, params.surveyId);
@@ -75,14 +75,14 @@ export function registerSurveyTools(server, client) {
         return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
     });
     // --- Question-level management tools ---
-    server.tool("survey_list_questions", "List all questions in a survey in human-readable format. Shows question number, type, title, required status, choices, and any conditional logic.", {
+    server.tool("survey_question_list", "List all questions in a survey in human-readable format. Shows question number, type, title, required status, choices, and any conditional logic.", {
         surveyId: z.string().describe("Survey ID (srv_ prefixed)"),
     }, async (params) => {
         const data = await surveys.listQuestions(client, params.surveyId);
         const formatted = formatQuestionList(data);
         return { content: [{ type: "text", text: formatted }] };
     });
-    server.tool("survey_add_question", "Add a question to a survey. Supported types: text (short text), comment (long text/multi-line), radiogroup (single choice), checkbox (multiple choice), rating (scale — use rateMin:0 rateMax:10 for NPS), boolean (yes/no), dropdown, ranking. For date input, use type 'text' with inputType 'date'. Question name is auto-generated from title if not provided.", {
+    server.tool("survey_question_add", "Add a question to a survey. Supported types: text (short text), comment (long text/multi-line), radiogroup (single choice), checkbox (multiple choice), rating (scale — use rateMin:0 rateMax:10 for NPS), boolean (yes/no), dropdown, ranking. For date input, use type 'text' with inputType 'date'. Question name is auto-generated from title if not provided.", {
         surveyId: z.string().describe("Survey ID (srv_ prefixed)"),
         type: z
             .enum([
@@ -147,7 +147,7 @@ export function registerSurveyTools(server, client) {
         const formatted = formatSingleQuestion(data, "Added");
         return { content: [{ type: "text", text: formatted }] };
     });
-    server.tool("survey_edit_question", "Edit an existing question in a survey by its name. Only provided fields are updated; others remain unchanged. Pass empty string for visibleIf/requiredIf to clear conditional logic.", {
+    server.tool("survey_question_update", "Edit an existing question in a survey by its name. Only provided fields are updated; others remain unchanged. Pass empty string for visibleIf/requiredIf to clear conditional logic.", {
         surveyId: z.string().describe("Survey ID (srv_ prefixed)"),
         questionName: z.string().describe("Name of the question to edit"),
         title: z.string().optional().describe("New question text"),
@@ -181,7 +181,7 @@ export function registerSurveyTools(server, client) {
         const formatted = formatSingleQuestion(data, "Updated");
         return { content: [{ type: "text", text: formatted }] };
     });
-    server.tool("survey_remove_question", "Remove a question from a survey by its name. This is permanent — the question and its configuration are deleted from the survey definition.", {
+    server.tool("survey_question_remove", "Remove a question from a survey by its name. This is permanent — the question and its configuration are deleted from the survey definition.", {
         surveyId: z.string().describe("Survey ID (srv_ prefixed)"),
         questionName: z.string().describe("Name of the question to remove"),
     }, async (params) => {
@@ -195,7 +195,7 @@ export function registerSurveyTools(server, client) {
             ],
         };
     });
-    server.tool("survey_reorder_questions", "Reorder questions in a survey by providing all question names in the desired order. All existing question names must be included.", {
+    server.tool("survey_question_reorder", "Reorder questions in a survey by providing all question names in the desired order. All existing question names must be included.", {
         surveyId: z.string().describe("Survey ID (srv_ prefixed)"),
         order: z
             .array(z.string())

package/dist/utils/journey-format.d.ts

@@ -13,6 +13,11 @@ interface JourneyData {
     nodes: Record<string, {
         action?: {
             type?: string;
+            templateSlug?: string;
+            surveySlug?: string;
+            tagName?: string;
+            stageName?: string;
+            fromIdentityEmail?: string;
         };
         terminal?: boolean;
     }>;
@@ -83,6 +88,7 @@ interface NodeListItem {
         surveySlug?: string;
         tagName?: string;
         stageName?: string;
+        fromIdentityEmail?: string;
     };
     terminal: boolean;
     isEntryNode: boolean;

package/dist/utils/journey-format.js

@@ -32,7 +32,7 @@ export function formatJourneyWithGuidance(journey) {
     lines.push("");
     lines.push("Nodes:");
     for (const [name, node] of Object.entries(journey.nodes || {})) {
-        const action = node.action?.type || "none";
+        const action = formatActionLabel(node.action || {});
         const terminal = node.terminal ? " (terminal)" : "";
         const isEntry = name === journey.entryNode ? " [entry]" : "";
         lines.push(`  ${name}: ${action}${terminal}${isEntry}`);
@@ -70,7 +70,7 @@ export function formatJourneyWithGuidance(journey) {
         hints.push("Journey is active and enrolling users. Use journey_analytics to see user flow.");
     }
     else if (journey.status === "paused") {
-        hints.push("Journey is paused. Actions are queued. Use journey_activate to resume.");
+        hints.push("Journey is paused. Actions are queued. Use journey_resume to continue delivery.");
     }
     else if (journey.status === "archived") {
         hints.push("Journey is archived. No further enrollment or transitions.");
@@ -113,6 +113,8 @@ function formatActionLabel(action) {
     const type = action?.type || "none";
     if (type === "send_email") {
         const parts = [`send_email (${action.templateSlug || "?"})`];
+        if (action.fromIdentityEmail)
+            parts.push(`from: ${action.fromIdentityEmail}`);
         if (action.surveySlug)
             parts.push(`+ survey: ${action.surveySlug}`);
         return parts.join(" ");
@@ -131,7 +133,7 @@ function formatTriggerLabel(trigger) {
 export function formatNodeList(data) {
     const nodes = data.nodes || [];
     if (nodes.length === 0) {
-        return "No nodes. Use journey_add_node to add the first node.";
+        return "No nodes. Use journey_node_add to add the first node.";
     }
     const lines = [`${nodes.length} node(s):\n`];
     for (const n of nodes) {
@@ -150,7 +152,7 @@ export function formatSingleNode(data, action, nodeName) {
 export function formatTransitionList(data) {
     const transitions = data.transitions || [];
     if (transitions.length === 0) {
-        return "No transitions. Use journey_add_transition to connect nodes.";
+        return "No transitions. Use journey_transition_add to connect nodes.";
     }
     const lines = [`${transitions.length} transition(s):\n`];
     for (const t of transitions) {

package/dist/utils/survey-format.js

@@ -84,11 +84,11 @@ export function formatSurveyWithGuidance(survey) {
     // Next steps based on current state
     const hints = [];
     if (questionCount === 0) {
-        hints.push("This survey has no questions yet. Use survey_add_question to add questions, or survey_list_questions to see supported question types.");
+        hints.push("This survey has no questions yet. Use survey_question_add to add questions, or survey_question_list to see supported question types.");
     }
     else if (survey.status === "draft") {
         hints.push(`Survey has ${questionCount} question(s) and is in draft. Use survey_update with status 'active' to activate it for distribution.`);
-        hints.push("Use survey_list_questions to review the questions before activating.");
+        hints.push("Use survey_question_list to review the questions before activating.");
     }
     else if (survey.status === "active" && responseCount === 0) {
         hints.push("Survey is active and ready to distribute. Use survey_distribute with a list of user IDs to create personalized tracking links.");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ascendkit/cli",
-  "version": "0.2.6",
+  "version": "0.3.0",
   "description": "AscendKit CLI and MCP server",
   "author": "ascendkit.dev",
   "license": "MIT",
@@ -33,11 +33,11 @@
     "start": "node dist/cli.js"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "zod": "^3.23.0"
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "zod": "^3.25.76"
   },
   "devDependencies": {
-    "typescript": "^5.7.0",
-    "@types/node": "^22.0.0"
+    "@types/node": "^25.5.0",
+    "typescript": "^5.7.0"
   }
 }