@elevasis/sdk 0.5.5 → 0.5.7

package/dist/cli.cjs

@@ -43706,13 +43706,19 @@ function resolveEnvironment(prod) {
   if (prod) return "production";
   return process.env.NODE_ENV === "development" ? "development" : "production";
 }
+function resolveApiKey(prod) {
+  if (!prod && process.env.NODE_ENV === "development") {
+    return process.env.ELEVASIS_PLATFORM_KEY_DEV ?? process.env.ELEVASIS_PLATFORM_KEY ?? "";
+  }
+  return process.env.ELEVASIS_PLATFORM_KEY ?? "";
+}
 
 // src/cli/api-client.ts
 function getApiKey() {
-  const key = process.env.ELEVASIS_API_KEY;
+  const key = process.env.ELEVASIS_PLATFORM_KEY;
   if (!key) {
     throw new Error(
-      "ELEVASIS_API_KEY environment variable is required.\nSet it in your .env file: ELEVASIS_API_KEY=sk_..."
+      "ELEVASIS_PLATFORM_KEY environment variable is required.\nSet it in your .env file: ELEVASIS_PLATFORM_KEY=sk_..."
     );
   }
   return key;
@@ -43724,7 +43730,7 @@ async function apiGet(endpoint, apiUrl = resolveApiUrl()) {
   if (!response.ok) {
     const errorText = await response.text();
     if (response.status === 401) {
-      throw new Error(`401 Unauthorized: Invalid or missing ELEVASIS_API_KEY. Check your .env file.`);
+      throw new Error(`401 Unauthorized: Invalid or missing ELEVASIS_PLATFORM_KEY. Check your .env file.`);
     }
     throw new Error(`API request failed (${response.status}): ${errorText}`);
   }
@@ -43787,7 +43793,7 @@ async function apiDelete(endpoint, apiUrl = resolveApiUrl()) {
 // package.json
 var package_default = {
   name: "@elevasis/sdk",
-  version: "0.5.5",
+  version: "0.5.7",
   description: "SDK for building Elevasis organization resources",
   "comment:bin": "IMPORTANT: This package shares the 'elevasis' binary name with @repo/cli. They never conflict because @elevasis/sdk must NEVER be added as a dependency of any workspace package (apps/*, packages/*, organizations/*). Workspace projects use @repo/cli for the 'elevasis' binary. External developers (outside the workspace) get this SDK's binary via npm install.",
   type: "module",
@@ -44287,7 +44293,7 @@ async function generateProjectMap(org) {
   let nodeEnv = "not set";
   try {
     const envContent = await (0, import_promises.readFile)((0, import_path.resolve)(".env"), "utf-8");
-    const apiKeyMatch = envContent.match(/^ELEVASIS_API_KEY=(.+)$/m);
+    const apiKeyMatch = envContent.match(/^ELEVASIS_PLATFORM_KEY=(.+)$/m);
     if (apiKeyMatch && apiKeyMatch[1].trim()) apiKeySet = "yes";
     const nodeEnvMatch = envContent.match(/^NODE_ENV=(.+)$/m);
     if (nodeEnvMatch && nodeEnvMatch[1].trim()) nodeEnv = nodeEnvMatch[1].trim();
@@ -44323,11 +44329,12 @@ function registerDeployCommand(program3) {
       authSpinner.fail(source_default.red("Authentication failed"));
       const errMsg = error46 instanceof Error ? error46.message : String(error46);
       if (errMsg.includes("401") || errMsg.toLowerCase().includes("unauthorized")) {
+        const keyVar = !options2.prod && process.env.NODE_ENV === "development" && process.env.ELEVASIS_PLATFORM_KEY_DEV ? "ELEVASIS_PLATFORM_KEY_DEV" : "ELEVASIS_PLATFORM_KEY";
         console.error(source_default.red("  Invalid API key."));
-        console.error(source_default.gray("  Your ELEVASIS_API_KEY was rejected by the server."));
+        console.error(source_default.gray(`  Your ${keyVar} was rejected by the server.`));
         console.error(source_default.gray("  Check your .env file and verify the key in the Elevasis dashboard."));
       } else {
-        console.error(source_default.gray("  Check your ELEVASIS_API_KEY and API URL."));
+        console.error(source_default.gray("  Check your API key and API URL."));
       }
       throw error46;
     }
@@ -44462,7 +44469,7 @@ startWorker(org)
         entryPoints: [wrapperPath],
         bundle: true,
         platform: "node",
-        format: "esm",
+        format: "cjs",
         outfile: bundleOutfile
       });
       await (0, import_promises.unlink)(wrapperPath);
@@ -44482,12 +44489,16 @@ startWorker(org)
     const uploadSpinner = ora("Uploading...").start();
     try {
       const bundleBuffer = await (0, import_promises.readFile)(bundleOutfile);
-      const apiKey = process.env.ELEVASIS_API_KEY;
+      const apiKey = resolveApiKey(options2.prod);
       if (!apiKey) {
-        uploadSpinner.fail(source_default.red("Missing ELEVASIS_API_KEY environment variable"));
+        uploadSpinner.fail(source_default.red("Missing API key environment variable"));
         console.error(source_default.gray("  Set it in your .env file or shell environment:"));
-        console.error(source_default.gray("    ELEVASIS_API_KEY=sk_..."));
-        throw new Error("Missing ELEVASIS_API_KEY environment variable");
+        if (!options2.prod && process.env.NODE_ENV === "development") {
+          console.error(source_default.gray("    ELEVASIS_PLATFORM_KEY_DEV=sk_...  (or ELEVASIS_PLATFORM_KEY as fallback)"));
+        } else {
+          console.error(source_default.gray("    ELEVASIS_PLATFORM_KEY=sk_..."));
+        }
+        throw new Error("Missing API key environment variable");
       }
       const metadata = {
         sdkVersion: SDK_VERSION,
@@ -45128,11 +45139,11 @@ function tsconfigTemplate() {
   }, null, 2) + "\n";
 }
 function envTemplate() {
-  return `ELEVASIS_API_KEY=
+  return `ELEVASIS_PLATFORM_KEY=
 `;
 }
 function envExampleTemplate() {
-  return `ELEVASIS_API_KEY=sk_your_key_here
+  return `ELEVASIS_PLATFORM_KEY=sk_your_key_here
 `;
 }
 function npmrcTemplate() {
@@ -45174,7 +45185,7 @@ pnpm install
 Copy \`.env.example\` to \`.env\` and add your API key:
 
 \`\`\`
-ELEVASIS_API_KEY=sk_...
+ELEVASIS_PLATFORM_KEY=sk_...
 \`\`\`
 
 ## Development
@@ -45426,7 +45437,7 @@ proactivity -- to their assessed levels.
 | Workspace concepts | \`reference/concepts/index.mdx\` | User asks "what is...?" or needs conceptual grounding |
 | SDK patterns and examples | \`reference/resources/patterns.mdx\` | Building or modifying a workflow |
 | Platform tool catalog | \`reference/platform-tools/index.mdx\` | Connecting to external services |
-| CLI reference | \`reference/cli/index.mdx\` | Running CLI operations |
+| CLI reference | \`reference/cli/index.mdx\` | Running execution/platform operations |
 | Credential model | \`reference/security/credentials.mdx\` | Setting up integrations or tool access |
 | Interaction guidance | \`reference/developer/interaction-guidance.mdx\` | Unsure how to adapt for a skill combination |
 | Error history | \`.claude/memory/errors/index.md\` | Debugging errors, checking past fixes |
@@ -45442,6 +45453,19 @@ proactivity -- to their assessed levels.
 
 All \`reference/\` paths resolve to \`node_modules/@elevasis/sdk/reference/\`.
 
+## Elevasis CLI
+
+**MANDATORY:** Use the \`elevasis\` CLI for all execution/platform operations -- never \`npx\`, \`curl\`, or any other tool.
+
+- \`elevasis exec <resource-id> --input '{...}'\` -- run a resource synchronously
+- \`elevasis exec <resource-id> --input '{...}' --async\` -- run async, returns execution ID
+- \`elevasis execution <resource-id> <execution-id>\` -- inspect execution detail
+- \`elevasis check\` -- validate resource definitions without deploying
+- \`elevasis deploy\` -- deploy to the platform
+
+Organization is derived from your API key -- no org prefix needed in the resource ID.
+For full CLI reference: \`reference/cli/index.mdx\`
+
 ## Rules
 
 SDK patterns (imports, source structure, platform tools) are auto-loaded from
@@ -46091,14 +46115,14 @@ by the \`<!-- initialized: false -->\` flag in CLAUDE.md, or run manually.
    Run \`pnpm install\`. Wait for completion. Report any errors.
 
 2. **Setup environment**
-   Read \`.env\`. It should contain only a single line: \`ELEVASIS_API_KEY=\`.
-   If \`ELEVASIS_API_KEY\` is empty or missing, ask the user: "What is your
+   Read \`.env\`. It should contain only a single line: \`ELEVASIS_PLATFORM_KEY=\`.
+   If \`ELEVASIS_PLATFORM_KEY\` is empty or missing, ask the user: "What is your
    Elevasis API key?" When the user provides it, write \`.env\` with exactly:
    \`\`\`
-   ELEVASIS_API_KEY=<value they provided>
+   ELEVASIS_PLATFORM_KEY=<value they provided>
    \`\`\`
    No other keys (no \`NODE_ENV\`, no extras). The \`.env\` file must contain
-   only \`ELEVASIS_API_KEY\`.
+   only \`ELEVASIS_PLATFORM_KEY\`.
    Validate the key works: run \`elevasis resources\` (should return an empty
    list, not an auth error). If auth fails, tell the user their key appears
    invalid and ask them to check it in the Elevasis dashboard.
@@ -46586,7 +46610,7 @@ organization. They are used by workflows and agents at runtime via \`platform.ge
 or the \`credential:\` field on tool steps.
 
 The SDK CLI (\`elevasis-sdk creds\`) manages credentials via API key authentication.
-Your \`ELEVASIS_API_KEY\` in \`.env\` determines the organization.
+Your \`ELEVASIS_PLATFORM_KEY\` in \`.env\` determines the organization.
 
 ## Credential Types
 
@@ -46686,7 +46710,7 @@ description: Elevasis SDK patterns -- imports, source structure, runtime, and pl
 
 ## Runtime
 
-- \`.env\` contains only \`ELEVASIS_API_KEY\` for CLI auth -- never deployed, never in worker memory
+- \`.env\` contains only \`ELEVASIS_PLATFORM_KEY\` for CLI auth -- never deployed, never in worker memory
 - Integration credentials are managed via the \`creds\` skill or Command Center UI
 
 ## Platform Tools

package/dist/index.d.ts

@@ -6320,7 +6320,7 @@ type ResourceStatus = 'dev' | 'prod';
 /**
  * Project configuration for an external developer project.
  * Defined in elevasis.config.ts at the project root.
- * Organization is derived from the ELEVASIS_API_KEY -- not configured here.
+ * Organization is derived from the ELEVASIS_PLATFORM_KEY -- not configured here.
  */
 interface ElevasConfig {
     /** Managed by `elevasis init` and `elevasis update`. Do not set manually. */

package/dist/templates.js

@@ -228,7 +228,7 @@ proactivity -- to their assessed levels.
 | Workspace concepts | \`reference/concepts/index.mdx\` | User asks "what is...?" or needs conceptual grounding |
 | SDK patterns and examples | \`reference/resources/patterns.mdx\` | Building or modifying a workflow |
 | Platform tool catalog | \`reference/platform-tools/index.mdx\` | Connecting to external services |
-| CLI reference | \`reference/cli/index.mdx\` | Running CLI operations |
+| CLI reference | \`reference/cli/index.mdx\` | Running execution/platform operations |
 | Credential model | \`reference/security/credentials.mdx\` | Setting up integrations or tool access |
 | Interaction guidance | \`reference/developer/interaction-guidance.mdx\` | Unsure how to adapt for a skill combination |
 | Error history | \`.claude/memory/errors/index.md\` | Debugging errors, checking past fixes |
@@ -244,6 +244,19 @@ proactivity -- to their assessed levels.
 
 All \`reference/\` paths resolve to \`node_modules/@elevasis/sdk/reference/\`.
 
+## Elevasis CLI
+
+**MANDATORY:** Use the \`elevasis\` CLI for all execution/platform operations -- never \`npx\`, \`curl\`, or any other tool.
+
+- \`elevasis exec <resource-id> --input '{...}'\` -- run a resource synchronously
+- \`elevasis exec <resource-id> --input '{...}' --async\` -- run async, returns execution ID
+- \`elevasis execution <resource-id> <execution-id>\` -- inspect execution detail
+- \`elevasis check\` -- validate resource definitions without deploying
+- \`elevasis deploy\` -- deploy to the platform
+
+Organization is derived from your API key -- no org prefix needed in the resource ID.
+For full CLI reference: \`reference/cli/index.mdx\`
+
 ## Rules
 
 SDK patterns (imports, source structure, platform tools) are auto-loaded from
@@ -893,14 +906,14 @@ by the \`<!-- initialized: false -->\` flag in CLAUDE.md, or run manually.
    Run \`pnpm install\`. Wait for completion. Report any errors.
 
 2. **Setup environment**
-   Read \`.env\`. It should contain only a single line: \`ELEVASIS_API_KEY=\`.
-   If \`ELEVASIS_API_KEY\` is empty or missing, ask the user: "What is your
+   Read \`.env\`. It should contain only a single line: \`ELEVASIS_PLATFORM_KEY=\`.
+   If \`ELEVASIS_PLATFORM_KEY\` is empty or missing, ask the user: "What is your
    Elevasis API key?" When the user provides it, write \`.env\` with exactly:
    \`\`\`
-   ELEVASIS_API_KEY=<value they provided>
+   ELEVASIS_PLATFORM_KEY=<value they provided>
    \`\`\`
    No other keys (no \`NODE_ENV\`, no extras). The \`.env\` file must contain
-   only \`ELEVASIS_API_KEY\`.
+   only \`ELEVASIS_PLATFORM_KEY\`.
    Validate the key works: run \`elevasis resources\` (should return an empty
    list, not an auth error). If auth fails, tell the user their key appears
    invalid and ask them to check it in the Elevasis dashboard.
@@ -1388,7 +1401,7 @@ organization. They are used by workflows and agents at runtime via \`platform.ge
 or the \`credential:\` field on tool steps.
 
 The SDK CLI (\`elevasis-sdk creds\`) manages credentials via API key authentication.
-Your \`ELEVASIS_API_KEY\` in \`.env\` determines the organization.
+Your \`ELEVASIS_PLATFORM_KEY\` in \`.env\` determines the organization.
 
 ## Credential Types
 
@@ -1488,7 +1501,7 @@ description: Elevasis SDK patterns -- imports, source structure, runtime, and pl
 
 ## Runtime
 
-- \`.env\` contains only \`ELEVASIS_API_KEY\` for CLI auth -- never deployed, never in worker memory
+- \`.env\` contains only \`ELEVASIS_PLATFORM_KEY\` for CLI auth -- never deployed, never in worker memory
 - Integration credentials are managed via the \`creds\` skill or Command Center UI
 
 ## Platform Tools

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/sdk",
-  "version": "0.5.5",
+  "version": "0.5.7",
   "description": "SDK for building Elevasis organization resources",
   "comment:bin": "IMPORTANT: This package shares the 'elevasis' binary name with @repo/cli. They never conflict because @elevasis/sdk must NEVER be added as a dependency of any workspace package (apps/*, packages/*, organizations/*). Workspace projects use @repo/cli for the 'elevasis' binary. External developers (outside the workspace) get this SDK's binary via npm install.",
   "type": "module",