@elevasis/sdk 0.5.9 → 0.5.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/templates.js CHANGED
@@ -1,7 +1,7 @@
1
1
  // package.json
2
2
 
3
3
  // src/cli/commands/templates/core/workspace.ts
4
- var TEMPLATE_VERSION = 22;
4
+ var TEMPLATE_VERSION = 24;
5
5
  function configTemplate() {
6
6
  return `import type { ElevasConfig } from '@elevasis/sdk'
7
7
 
@@ -19,6 +19,7 @@ dist/
19
19
  __elevasis_worker.ts
20
20
  .claude/settings.local.json
21
21
  .claude/memory/
22
+ package-lock.json
22
23
  `;
23
24
  if (ctx.hasUI) {
24
25
  content += `ui/node_modules/
@@ -32,6 +33,10 @@ ui/dist/
32
33
  function claudeSettingsTemplate() {
33
34
  return JSON.stringify({
34
35
  autoCompact: false,
36
+ statusLine: {
37
+ type: "command",
38
+ command: "node .claude/scripts/statusline-command.js"
39
+ },
35
40
  hooks: {
36
41
  PreToolUse: [
37
42
  {
@@ -47,6 +52,29 @@ function claudeSettingsTemplate() {
47
52
  }
48
53
  }, null, 2) + "\n";
49
54
  }
55
+ function claudeStatuslineScriptTemplate() {
56
+ return `#!/usr/bin/env node
57
+ let input = '';
58
+ process.stdin.on('data', chunk => input += chunk);
59
+ process.stdin.on('end', () => {
60
+ const data = JSON.parse(input);
61
+ const model = data.model?.display_name || '?';
62
+ const pct = Math.floor(data.context_window?.used_percentage || 0);
63
+
64
+ const DIM = '\\x1b[90m', RESET = '\\x1b[0m';
65
+ const GREEN = '\\x1b[32m', YELLOW = '\\x1b[33m', RED = '\\x1b[31m';
66
+
67
+ const color = pct >= 90 ? RED : pct >= 70 ? YELLOW : GREEN;
68
+
69
+ const width = 20;
70
+ const filled = Math.floor(pct * width / 100);
71
+ const empty = width - filled;
72
+ const bar = '#'.repeat(filled) + '-'.repeat(empty);
73
+
74
+ console.log(\`\${DIM}[\${RESET}\${model}\${DIM}]\${RESET} \${color}\${bar}\${RESET} \${pct}%\`);
75
+ });
76
+ `;
77
+ }
50
78
  function claudeSdkBoundaryHookTemplate() {
51
79
  return String.raw`#!/usr/bin/env node
52
80
  // enforce-sdk-boundary.mjs
@@ -246,13 +274,13 @@ All \`reference/\` paths resolve to \`node_modules/@elevasis/sdk/reference/\`.
246
274
 
247
275
  ## Elevasis CLI
248
276
 
249
- **MANDATORY:** Use the \`elevasis\` CLI for all execution/platform operations -- never \`npx\`, \`curl\`, or any other tool.
277
+ **MANDATORY:** Use the \`elevasis-sdk\` CLI for all execution/platform operations -- never \`npx\`, \`curl\`, or any other tool.
250
278
 
251
- - \`elevasis exec <resource-id> --input '{...}'\` -- run a resource synchronously
252
- - \`elevasis exec <resource-id> --input '{...}' --async\` -- run async, returns execution ID
253
- - \`elevasis execution <resource-id> <execution-id>\` -- inspect execution detail
254
- - \`elevasis check\` -- validate resource definitions without deploying
255
- - \`elevasis deploy\` -- deploy to the platform
279
+ - \`elevasis-sdk exec <resource-id> --input '{...}'\` -- run a resource synchronously
280
+ - \`elevasis-sdk exec <resource-id> --input '{...}' --async\` -- run async, returns execution ID
281
+ - \`elevasis-sdk execution <resource-id> <execution-id>\` -- inspect execution detail
282
+ - \`elevasis-sdk check\` -- validate resource definitions without deploying
283
+ - \`elevasis-sdk deploy\` -- deploy to the platform
256
284
 
257
285
  Organization is derived from your API key -- no org prefix needed in the resource ID.
258
286
  For full CLI reference: \`reference/cli/index.mdx\`
@@ -463,7 +491,7 @@ When automation is none:
463
491
  Skip the file tour. Start with what Elevasis does for their business -- use analogies
464
492
  from \`reference/developer/interaction-guidance.mdx\` (recipe, assembly line, kitchen
465
493
  appliance). Explain deployment plainly: "You write the recipe here, then deploy it so
466
- it's live." Deploy the starter echo workflow (\`elevasis check\` + \`elevasis deploy\`),
494
+ it's live." Deploy the starter echo workflow (\`elevasis-sdk check\` + \`elevasis-sdk deploy\`),
467
495
  THEN tour the Command Center so the user sees populated pages, not empty ones. Tour:
468
496
  Command View (echo node), Execution Logs (result).
469
497
  Observation focus: automation value understanding, Command Center comfort.
@@ -472,7 +500,7 @@ When automation is low-code or custom:
472
500
  Tour project files: src/index.ts (registry), src/example/echo.ts (starter
473
501
  workflow), src/operations/platform-status.ts (platform API example),
474
502
  elevasis.config.ts, .env, docs/. Explain the execution model.
475
- Verify: run \`elevasis resources\`. Then open the Command Center and tour the
503
+ Verify: run \`elevasis-sdk resources\`. Then open the Command Center and tour the
476
504
  main pages: Command View (resource graph), Execution Logs.
477
505
  Point out the echo workflow node in Command View.
478
506
  Observation focus: cloud deployment model, UI navigation comfort.
@@ -482,14 +510,14 @@ Observation focus: cloud deployment model, UI navigation comfort.
482
510
  When automation is none:
483
511
  Frame the workflow as "a recipe." Use plain language: "settings" not "config",
484
512
  "what data it needs" not "contract", "instructions" not "steps", "where it starts"
485
- not "entryPoint." Agent writes all code changes. Agent runs \`elevasis exec\` to verify
513
+ not "entryPoint." Agent writes all code changes. Agent runs \`elevasis-sdk exec\` to verify
486
514
  and narrates the result in plain terms.
487
515
  Observation focus: recipe-to-result connection.
488
516
 
489
517
  When automation is low-code or custom:
490
518
  Modify the echo workflow. Walk through each part: config, contract, steps,
491
- entryPoint. Deploy: \`elevasis check\` then \`elevasis deploy\`. Test with
492
- \`elevasis exec echo --input '{"message":"hello"}'\`. Then open the Execution
519
+ entryPoint. Deploy: \`elevasis-sdk check\` then \`elevasis-sdk deploy\`. Test with
520
+ \`elevasis-sdk exec echo --input '{"message":"hello"}'\`. Then open the Execution
493
521
  Runner in the Command Center, find the echo workflow, fill out the form, and
494
522
  run it from the UI. Compare the result to the CLI output.
495
523
  Observation focus: deployment-to-execution loop, TypeScript syntax comfort.
@@ -500,20 +528,20 @@ When automation is none:
500
528
  Frame as "What information does your automation need?" Describe types in plain English:
501
529
  text, number, yes/no, a choice from a list. NO Zod, no z.string(), no z.infer(), no
502
530
  code shown. Agent reads identity.md goals and writes the workflow schema. Agent runs
503
- \`elevasis exec\` with sample input and narrates the result.
531
+ \`elevasis-sdk exec\` with sample input and narrates the result.
504
532
  Observation focus: data-to-input connection, required vs optional understanding.
505
533
 
506
534
  When automation is low-code:
507
535
  "Field mapping like Zapier, but with validation." Show Zod types briefly. Demonstrate
508
536
  how \`.describe()\` documents each field. Build schema based on identity.md goals.
509
- After deploy, run with \`elevasis exec --input '{...}'\` to verify each field.
537
+ After deploy, run with \`elevasis-sdk exec --input '{...}'\` to verify each field.
510
538
  Observation focus: schema-to-input mapping, optional fields, types.
511
539
 
512
540
  When automation is custom:
513
541
  Explain schemas in plain English (concepts page). Show common Zod types.
514
542
  Explain \`z.infer\`. Build a new workflow with real-world input schema based
515
543
  on the user's goals (read .claude/memory/profile/identity.md). After deploy,
516
- run with \`elevasis exec --input '{...}'\` to verify the schema and inspect
544
+ run with \`elevasis-sdk exec --input '{...}'\` to verify the schema and inspect
517
545
  the execution output.
518
546
  Observation focus: schema-to-input mapping, optional fields, types.
519
547
 
@@ -544,7 +572,7 @@ Observation focus: credential setup (CLI + UI), async/await.
544
572
  When automation is none:
545
573
  Frame as "Step 1 passes its result to Step 2, like a relay race." Command View is
546
574
  PRIMARY teaching tool -- show the visual graph before explaining code. Agent builds
547
- the 2-step workflow. Agent runs \`elevasis exec\` to verify and shows output flow.
575
+ the 2-step workflow. Agent runs \`elevasis-sdk exec\` to verify and shows output flow.
548
576
  User opens Command View to see the two nodes + arrow. Code is secondary.
549
577
  Observation focus: relay-race concept, visual graph comprehension.
550
578
 
@@ -560,7 +588,7 @@ Observation focus: data flow reasoning, relationship visualization.
560
588
  When automation is none:
561
589
  Frame as "If the customer is VIP, do this -- otherwise, do that." No StepType.CONDITIONAL
562
590
  jargon -- focus on the concept, not the implementation. Agent adds the condition.
563
- Agent runs \`elevasis exec\` for both paths. Open Execution Logs to see which
591
+ Agent runs \`elevasis-sdk exec\` for both paths. Open Execution Logs to see which
564
592
  path ran. Guide log navigation step-by-step.
565
593
  Observation focus: branching concept understanding, log navigation.
566
594
 
@@ -585,7 +613,7 @@ Change status from dev to production. Cover error handling: try/catch,
585
613
  ExecutionError, PlatformToolError. Create a schedule in Task Scheduler (use
586
614
  Recurring type for a cron schedule). If docs/ has pages, show Knowledge Base.
587
615
  Open Deployments page to confirm the latest version is active. Show CLI
588
- monitoring: elevasis executions, elevasis execution. Suggest next steps.
616
+ monitoring: elevasis-sdk executions, elevasis-sdk execution. Suggest next steps.
589
617
  Observation focus: readiness for independent operation (CLI + UI).
590
618
 
591
619
  ## Module Menu
@@ -673,7 +701,7 @@ Read: \`reference/framework/agent.mdx\`.
673
701
  Build: Create an agent definition with tools. Configure LLM tool calling.
674
702
  Compare agent vs workflow for a task.
675
703
  Key concepts: agent definition, tool registration, LLM tool calling, execution trace.
676
- Verify: Run agent with \`elevasis exec\`, review tool call trace in Execution Logs.
704
+ Verify: Run agent with \`elevasis-sdk exec\`, review tool call trace in Execution Logs.
677
705
 
678
706
  ## Meta-Framework Track
679
707
 
@@ -796,7 +824,7 @@ Observation focus: customization concept, owned vs managed files.
796
824
 
797
825
  When automation is low-code:
798
826
  Show the \`.claude/rules/\` directory. Explain the two types: sdk-patterns.md (MANAGED --
799
- updated by elevasis update) and workspace-patterns.md (INIT_ONLY -- yours to edit).
827
+ updated by elevasis-sdk update) and workspace-patterns.md (INIT_ONLY -- yours to edit).
800
828
  Explain path-scoping briefly: "These rules only activate when the agent is working on
801
829
  certain file types." Show an example rule with WRONG/RIGHT pattern. Explain error
802
830
  promotion: if something goes wrong 3+ times, add it here.
@@ -826,7 +854,7 @@ Next steps: point to reference docs in docs/, encourage using /work for new task
826
854
  Observation focus: update model concept, project map as navigation aid.
827
855
 
828
856
  When automation is low-code:
829
- Explain MANAGED (auto-updated by elevasis update) vs INIT_ONLY (set once, yours).
857
+ Explain MANAGED (auto-updated by elevasis-sdk update) vs INIT_ONLY (set once, yours).
830
858
  Show how /meta fix applies SDK updates with conflict handling: "If a file changed,
831
859
  it shows you both versions and lets you decide."
832
860
  Show \`docs/project-map.mdx\` and explain what it contains: resources, commands,
@@ -850,7 +878,7 @@ Observation focus: full template lifecycle, conflict resolution pattern.
850
878
 
851
879
  **automation: none**
852
880
  Use the non-technical variant for each lesson. Agent writes all code -- user
853
- never types code. Agent runs \`elevasis exec\` for verification and narrates results.
881
+ never types code. Agent runs \`elevasis-sdk exec\` for verification and narrates results.
854
882
  Avoid all jargon; use analogies. CLI is the primary verification tool.
855
883
  Always deploy before directing the user to the Command Center.
856
884
 
@@ -946,7 +974,7 @@ by the \`<!-- initialized: false -->\` flag in CLAUDE.md, or run manually.
946
974
  \`\`\`
947
975
  No other keys (no \`NODE_ENV\`, no extras). The \`.env\` file must contain
948
976
  only \`ELEVASIS_PLATFORM_KEY\`.
949
- Validate the key works: run \`elevasis resources\` (should return an empty
977
+ Validate the key works: run \`elevasis-sdk resources\` (should return an empty
950
978
  list, not an auth error). If auth fails, tell the user their key appears
951
979
  invalid and ask them to check it in the Elevasis dashboard.
952
980
 
@@ -1007,7 +1035,7 @@ by the \`<!-- initialized: false -->\` flag in CLAUDE.md, or run manually.
1007
1035
  - If git remote exists: note remote URL in memory/profile/preferences.md
1008
1036
 
1009
1037
  5. **Verify project**
1010
- Run \`elevasis check\` to confirm the starter resource is valid.
1038
+ Run \`elevasis-sdk check\` to confirm the starter resource is valid.
1011
1039
  Optionally deploy the echo workflow.
1012
1040
 
1013
1041
  6. **Report**
@@ -1036,7 +1064,7 @@ Detect and repair all drift. Optionally upgrades the SDK first.
1036
1064
 
1037
1065
  0. **SDK version check** -- Compare installed \`@elevasis/sdk\` against the latest
1038
1066
  available. If behind, offer to run \`pnpm update @elevasis/sdk\` before
1039
- continuing. If the user accepts, run it, then run \`elevasis update\` to add
1067
+ continuing. If the user accepts, run it, then run \`elevasis-sdk update\` to add
1040
1068
  any new managed files and flag conflicts. For each flagged file:
1041
1069
  - Read the current project file and the new template from \`@elevasis/sdk/templates\`
1042
1070
  - Add new sections that don't exist; preserve user customizations
@@ -1065,7 +1093,7 @@ Detect and repair all drift. Optionally upgrades the SDK first.
1065
1093
  suggest adding patterns. Surface suggestions only -- do not auto-generate.
1066
1094
  8. **Project map freshness:** Check whether \`docs/project-map.mdx\` reflects the
1067
1095
  current project state (resources, commands, rules, skills, memory files).
1068
- Compare filesystem state against the map. If stale, run \`elevasis deploy\`
1096
+ Compare filesystem state against the map. If stale, run \`elevasis-sdk deploy\`
1069
1097
  to regenerate, or patch inline for minor drift.
1070
1098
 
1071
1099
  Each step reports its result. Steps 1-8 run even if step 0 is skipped.
@@ -1075,11 +1103,11 @@ Each step reports its result. Steps 1-8 run even if step 0 is skipped.
1075
1103
  0. Read \`reference/deployment/command-view.mdx\` -- understand the Command View
1076
1104
  model, relationship declarations, and what deploy-time validation checks.
1077
1105
  This context is essential for diagnosing validation failures in steps 1-2.
1078
- 1. Run \`elevasis check\` (validation)
1106
+ 1. Run \`elevasis-sdk check\` (validation)
1079
1107
  2. Type check if \`tsconfig.json\` exists
1080
1108
  3. Verify docs reflect current resources
1081
1109
  4. If git configured: stage changes, commit with deploy message
1082
- 5. Run \`elevasis deploy\`
1110
+ 5. Run \`elevasis-sdk deploy\`
1083
1111
  6. \`docs/project-map.mdx\` is auto-regenerated by deploy (no manual bump needed)
1084
1112
  7. Verify deployment via platform
1085
1113
  8. Update \`memory/deployment-state.md\` with count, timestamp, inventory
@@ -1641,10 +1669,10 @@ description: Project map conventions -- auto-generated, do not edit, maintained
1641
1669
 
1642
1670
  # Project Map
1643
1671
 
1644
- - \`docs/project-map.mdx\` and \`docs/resource-map.mdx\` are fully auto-generated by \`elevasis deploy\`
1672
+ - \`docs/project-map.mdx\` and \`docs/resource-map.mdx\` are fully auto-generated by \`elevasis-sdk deploy\`
1645
1673
  - Do not edit either file manually -- changes are overwritten on next deploy
1646
1674
  - \`/meta fix\` step 8 checks for drift and patches the map
1647
- - If a new command, rule, skill, or memory file is added, run \`/meta fix\` or \`elevasis deploy\` to update
1675
+ - If a new command, rule, skill, or memory file is added, run \`/meta fix\` or \`elevasis-sdk deploy\` to update
1648
1676
  `;
1649
1677
  }
1650
1678
  function claudeTaskTrackingRuleTemplate() {
@@ -1846,6 +1874,7 @@ function getManagedTemplates(ctx = {}) {
1846
1874
  ".gitignore": () => gitignoreTemplate(ctx),
1847
1875
  "CLAUDE.md": () => claudeMdTemplate(ctx),
1848
1876
  ".claude/settings.json": claudeSettingsTemplate,
1877
+ ".claude/scripts/statusline-command.js": claudeStatuslineScriptTemplate,
1849
1878
  ".claude/hooks/enforce-sdk-boundary.mjs": claudeSdkBoundaryHookTemplate,
1850
1879
  ".claude/commands/tutorial.md": claudeTutorialCommandTemplate,
1851
1880
  ".claude/commands/meta.md": claudeMetaCommandTemplate,
package/package.json CHANGED
@@ -1,11 +1,9 @@
1
1
  {
2
2
  "name": "@elevasis/sdk",
3
- "version": "0.5.9",
3
+ "version": "0.5.11",
4
4
  "description": "SDK for building Elevasis organization resources",
5
- "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.",
6
5
  "type": "module",
7
6
  "bin": {
8
- "elevasis": "./dist/cli.cjs",
9
7
  "elevasis-sdk": "./dist/cli.cjs"
10
8
  },
11
9
  "exports": {
@@ -14,7 +14,7 @@ All paths are relative to `node_modules/@elevasis/sdk/reference/`.
14
14
 
15
15
  | Resource | Location | Description | When to Load |
16
16
  | --- | --- | --- | --- |
17
- | CLI Reference | `cli/index.mdx` | Full reference for every elevasis CLI command -- scaffold, validate, deploy, execute, and inspect resources | Running CLI operations |
17
+ | CLI Reference | `cli/index.mdx` | Full reference for every elevasis-sdk CLI command -- scaffold, validate, deploy, execute, and inspect resources | Running CLI operations |
18
18
 
19
19
  ## Concepts
20
20
 
@@ -29,7 +29,7 @@ All paths are relative to `node_modules/@elevasis/sdk/reference/`.
29
29
  | Execution API | `deployment/api.mdx` | REST endpoints for executing resources, querying execution history, and managing deployments via the Elevasis external API | Calling the API directly or debugging API responses |
30
30
  | Command Center UI | `deployment/command-center-ui.mdx` | Reference for the Elevasis Command Center -- what each page does, when to use it post-deployment, and how SDK concepts map to UI actions | User asks about the Command Center UI, post-deployment workflow, or monitoring deployed resources |
31
31
  | Command View | `deployment/command-view.mdx` | How the Command View graph works -- node types, relationships, what is enforced vs decorative, and what the platform needs to render your resource graph | Deploying resources or building resources that invoke other resources |
32
- | Deploying Resources | `deployment/index.mdx` | How to deploy your Elevasis SDK resources to the platform using elevasis deploy, including configuration, validation, and environment setup | Preparing to deploy or debugging deploy failures |
32
+ | Deploying Resources | `deployment/index.mdx` | How to deploy your Elevasis SDK resources to the platform using elevasis-sdk deploy, including configuration, validation, and environment setup | Preparing to deploy or debugging deploy failures |
33
33
 
34
34
  ## Developer
35
35
 
@@ -45,7 +45,7 @@ All paths are relative to `node_modules/@elevasis/sdk/reference/`.
45
45
  | Resource Documentation | `framework/documentation.mdx` | Write and deploy MDX documentation alongside your Elevasis resources | Writing or updating project documentation |
46
46
  | Development Framework | `framework/index.mdx` | The SDK scaffolds a complete development environment for Claude Code -- project instructions, slash commands, cross-session memory, and template versioning | Understanding the agent framework structure |
47
47
  | Memory System | `framework/memory.mdx` | Cross-session project knowledge stored in .claude/memory/ -- deployment state, environment, decisions, and error patterns that persist between Claude Code sessions | Working with agent memory or session state |
48
- | Project Structure | `framework/project-structure.mdx` | Each file scaffolded by elevasis init and its purpose in the development workflow | Understanding scaffolded files or project layout |
48
+ | Project Structure | `framework/project-structure.mdx` | Each file scaffolded by elevasis-sdk init and its purpose in the development workflow | Understanding scaffolded files or project layout |
49
49
 
50
50
  ## Getting-started
51
51
 
@@ -1,29 +1,29 @@
1
1
  ---
2
2
  title: CLI Reference
3
- description: Full reference for every elevasis CLI command -- scaffold, validate, deploy, execute, and inspect resources
3
+ description: Full reference for every elevasis-sdk CLI command -- scaffold, validate, deploy, execute, and inspect resources
4
4
  loadWhen: "Running CLI operations"
5
5
  ---
6
6
 
7
- The `elevasis` CLI is the primary interface for working with your Elevasis SDK project. Install it as part of `@elevasis/sdk` and use it to scaffold projects, validate resource definitions, deploy to the platform, and inspect execution history.
7
+ The `elevasis-sdk` CLI is the primary interface for working with your Elevasis SDK project. Install it as part of `@elevasis/sdk` and use it to scaffold projects, validate resource definitions, deploy to the platform, and inspect execution history.
8
8
 
9
9
  **Installation:**
10
10
 
11
11
  ```bash
12
- npm install @elevasis/sdk
12
+ pnpm add @elevasis/sdk
13
13
  ```
14
14
 
15
- After installation, the `elevasis` binary is available in your project's `node_modules/.bin/`. Most commands require `ELEVASIS_API_KEY` to be set in your environment or a `.env` file.
15
+ After installation, the `elevasis-sdk` binary is available in your project's `node_modules/.bin/`. Most commands require `ELEVASIS_API_KEY` to be set in your environment or a `.env` file.
16
16
 
17
17
  ---
18
18
 
19
- ## elevasis init
19
+ ## elevasis-sdk init
20
20
 
21
21
  Scaffold a new Elevasis SDK project in the specified directory.
22
22
 
23
23
  **Synopsis:**
24
24
 
25
25
  ```
26
- elevasis init [directory]
26
+ elevasis-sdk init [directory]
27
27
  ```
28
28
 
29
29
  **Behavior:**
@@ -42,7 +42,13 @@ elevasis init [directory]
42
42
  **Example:**
43
43
 
44
44
  ```bash
45
- elevasis init my-project
45
+ elevasis-sdk init my-project
46
+ ```
47
+
48
+ You can also run `init` without a global install using `pnpm dlx`:
49
+
50
+ ```bash
51
+ pnpm dlx @elevasis/sdk init my-project
46
52
  ```
47
53
 
48
54
  ```
@@ -52,20 +58,20 @@ elevasis init my-project
52
58
 
53
59
  Next steps:
54
60
  cd my-project
55
- npm install
56
- elevasis check
61
+ pnpm install
62
+ elevasis-sdk check
57
63
  ```
58
64
 
59
65
  ---
60
66
 
61
- ## elevasis check
67
+ ## elevasis-sdk check
62
68
 
63
69
  Validate all resource definitions in your project without deploying.
64
70
 
65
71
  **Synopsis:**
66
72
 
67
73
  ```
68
- elevasis check
74
+ elevasis-sdk check
69
75
  ```
70
76
 
71
77
  **Behavior:**
@@ -88,7 +94,7 @@ elevasis check
88
94
  **Example output (success):**
89
95
 
90
96
  ```
91
- $ elevasis check
97
+ $ elevasis-sdk check
92
98
 
93
99
  Validating... done (4 resources, 0 errors)
94
100
  ```
@@ -96,7 +102,7 @@ $ elevasis check
96
102
  **Example output (failure):**
97
103
 
98
104
  ```
99
- $ elevasis check
105
+ $ elevasis-sdk check
100
106
 
101
107
  Validating...
102
108
  ERROR Duplicate resource ID 'onboard-client' in organization 'Acme Corp'
@@ -107,20 +113,20 @@ $ elevasis check
107
113
 
108
114
  ---
109
115
 
110
- ## elevasis deploy
116
+ ## elevasis-sdk deploy
111
117
 
112
118
  Bundle your project with esbuild and deploy it to the Elevasis platform.
113
119
 
114
120
  **Synopsis:**
115
121
 
116
122
  ```
117
- elevasis deploy
123
+ elevasis-sdk deploy
118
124
  ```
119
125
 
120
126
  **Behavior:**
121
127
 
122
128
  - Authenticates with `ELEVASIS_API_KEY` and resolves your organization name
123
- - Runs the same `ResourceRegistry` validation as `elevasis check`
129
+ - Runs the same `ResourceRegistry` validation as `elevasis-sdk check`
124
130
  - Bundles your `src/index.ts` and all dependencies into a single self-contained JS file (`dist/bundle.js`, approximately 50-200 KB)
125
131
  - Uploads the bundle plus resource metadata to `POST /api/external/deploy`
126
132
  - Streams deploy status and prints the result
@@ -143,7 +149,7 @@ elevasis deploy
143
149
  **Example output (success):**
144
150
 
145
151
  ```
146
- $ elevasis deploy
152
+ $ elevasis-sdk deploy
147
153
 
148
154
  Authenticating... done (acme-corp)
149
155
  Validating... done (4 resources, 0 errors)
@@ -157,7 +163,7 @@ $ elevasis deploy
157
163
  **Example output (validation failure):**
158
164
 
159
165
  ```
160
- $ elevasis deploy
166
+ $ elevasis-sdk deploy
161
167
 
162
168
  Authenticating... done (acme-corp)
163
169
  Validating...
@@ -169,14 +175,14 @@ $ elevasis deploy
169
175
 
170
176
  ---
171
177
 
172
- ## elevasis exec
178
+ ## elevasis-sdk exec
173
179
 
174
180
  Execute a deployed resource by ID.
175
181
 
176
182
  **Synopsis:**
177
183
 
178
184
  ```
179
- elevasis exec <resource> --input '{...}'
185
+ elevasis-sdk exec <resource> --input '{...}'
180
186
  ```
181
187
 
182
188
  **Behavior:**
@@ -198,7 +204,7 @@ elevasis exec <resource> --input '{...}'
198
204
  **Example:**
199
205
 
200
206
  ```bash
201
- elevasis exec onboard-client --input '{"clientName": "Jane", "email": "jane@example.com"}'
207
+ elevasis-sdk exec onboard-client --input '{"clientName": "Jane", "email": "jane@example.com"}'
202
208
  ```
203
209
 
204
210
  ```
@@ -218,24 +224,24 @@ elevasis exec onboard-client --input '{"clientName": "Jane", "email": "jane@exam
218
224
  **Async example:**
219
225
 
220
226
  ```bash
221
- elevasis exec onboard-client --input '{"clientName": "Jane"}' --async
227
+ elevasis-sdk exec onboard-client --input '{"clientName": "Jane"}' --async
222
228
  ```
223
229
 
224
230
  ```
225
231
  Execution started: exec_550e8400
226
- Poll with: elevasis execution onboard-client exec_550e8400
232
+ Poll with: elevasis-sdk execution onboard-client exec_550e8400
227
233
  ```
228
234
 
229
235
  ---
230
236
 
231
- ## elevasis resources
237
+ ## elevasis-sdk resources
232
238
 
233
239
  List all deployed resources for your organization.
234
240
 
235
241
  **Synopsis:**
236
242
 
237
243
  ```
238
- elevasis resources
244
+ elevasis-sdk resources
239
245
  ```
240
246
 
241
247
  **Behavior:**
@@ -254,7 +260,7 @@ elevasis resources
254
260
  **Example output:**
255
261
 
256
262
  ```
257
- $ elevasis resources
263
+ $ elevasis-sdk resources
258
264
 
259
265
  onboard-client workflow Onboard Client prod
260
266
  send-report workflow Send Weekly Report prod
@@ -264,14 +270,14 @@ $ elevasis resources
264
270
 
265
271
  ---
266
272
 
267
- ## elevasis executions
273
+ ## elevasis-sdk executions
268
274
 
269
275
  View execution history for a resource.
270
276
 
271
277
  **Synopsis:**
272
278
 
273
279
  ```
274
- elevasis executions [resource]
280
+ elevasis-sdk executions [resource]
275
281
  ```
276
282
 
277
283
  **Behavior:**
@@ -292,7 +298,7 @@ elevasis executions [resource]
292
298
  **Example:**
293
299
 
294
300
  ```bash
295
- elevasis executions onboard-client --limit 5
301
+ elevasis-sdk executions onboard-client --limit 5
296
302
  ```
297
303
 
298
304
  ```
@@ -305,14 +311,14 @@ elevasis executions onboard-client --limit 5
305
311
 
306
312
  ---
307
313
 
308
- ## elevasis execution
314
+ ## elevasis-sdk execution
309
315
 
310
316
  View full detail for a single execution.
311
317
 
312
318
  **Synopsis:**
313
319
 
314
320
  ```
315
- elevasis execution <resource> <id>
321
+ elevasis-sdk execution <resource> <id>
316
322
  ```
317
323
 
318
324
  **Behavior:**
@@ -330,7 +336,7 @@ elevasis execution <resource> <id>
330
336
  **Example:**
331
337
 
332
338
  ```bash
333
- elevasis execution onboard-client exec_abc001
339
+ elevasis-sdk execution onboard-client exec_abc001
334
340
  ```
335
341
 
336
342
  ```
@@ -360,14 +366,14 @@ elevasis execution onboard-client exec_abc001
360
366
 
361
367
  ---
362
368
 
363
- ## elevasis deployments
369
+ ## elevasis-sdk deployments
364
370
 
365
371
  List all deployments for your organization.
366
372
 
367
373
  **Synopsis:**
368
374
 
369
375
  ```
370
- elevasis deployments
376
+ elevasis-sdk deployments
371
377
  ```
372
378
 
373
379
  **Behavior:**
@@ -385,7 +391,7 @@ elevasis deployments
385
391
  **Example output:**
386
392
 
387
393
  ```
388
- $ elevasis deployments
394
+ $ elevasis-sdk deployments
389
395
 
390
396
  deploy_abc123 active 2026-02-25 14:00:00 4 resources
391
397
  deploy_abc122 stopped 2026-02-24 09:30:00 3 resources
@@ -394,14 +400,14 @@ $ elevasis deployments
394
400
 
395
401
  ---
396
402
 
397
- ## elevasis describe
403
+ ## elevasis-sdk describe
398
404
 
399
405
  Show the definition of a deployed resource.
400
406
 
401
407
  **Synopsis:**
402
408
 
403
409
  ```
404
- elevasis describe <resource>
410
+ elevasis-sdk describe <resource>
405
411
  ```
406
412
 
407
413
  **Behavior:**
@@ -420,7 +426,7 @@ elevasis describe <resource>
420
426
  **Example:**
421
427
 
422
428
  ```bash
423
- elevasis describe onboard-client
429
+ elevasis-sdk describe onboard-client
424
430
  ```
425
431
 
426
432
  ```
@@ -444,16 +450,16 @@ elevasis describe onboard-client
444
450
 
445
451
  ---
446
452
 
447
- ## elevasis env
453
+ ## elevasis-sdk env
448
454
 
449
455
  Manage environment variables for your project.
450
456
 
451
457
  **Synopsis:**
452
458
 
453
459
  ```
454
- elevasis env list
455
- elevasis env set <key> <value>
456
- elevasis env remove <key>
460
+ elevasis-sdk env list
461
+ elevasis-sdk env set <key> <value>
462
+ elevasis-sdk env remove <key>
457
463
  ```
458
464
 
459
465
  **Behavior:**
@@ -471,9 +477,9 @@ elevasis env remove <key>
471
477
  **Examples:**
472
478
 
473
479
  ```bash
474
- elevasis env list
475
- elevasis env set OPENAI_API_KEY sk-proj-***
476
- elevasis env remove OPENAI_API_KEY
480
+ elevasis-sdk env list
481
+ elevasis-sdk env set OPENAI_API_KEY sk-proj-***
482
+ elevasis-sdk env remove OPENAI_API_KEY
477
483
  ```
478
484
 
479
485
  ---
@@ -23,7 +23,7 @@ This page covers core Elevasis concepts in plain English. It is the teaching voc
23
23
  | Handler | The function inside a step that does the actual work. It receives input data and returns output data. |
24
24
  | Entry Point | The first step that runs when a workflow is executed. Every workflow must have one. |
25
25
  | Resource ID | A unique lowercase name for your resource (e.g., `lead-scorer`, `send-welcome-email`). Must be unique within your organization. |
26
- | Workspace | Your Elevasis project directory. Contains resources (workflows and agents), documentation, and optionally a database connection and custom apps. Created by `elevasis init`. |
26
+ | Workspace | Your Elevasis project directory. Contains resources (workflows and agents), documentation, and optionally a database connection and custom apps. Created by `elevasis-sdk init`. |
27
27
  | Data Table | A table in your database (e.g., Supabase) that stores structured data your workflows can read and write. Defined in `data/schema.ts` as documentation for the agent. |
28
28
 
29
29
  ---
@@ -94,7 +94,7 @@ type MyInput = z.infer<typeof myInput>;
94
94
 
95
95
  ### What Happens When You Run a Workflow
96
96
 
97
- 1. A request arrives at the Elevasis platform (someone runs `elevasis exec` or a schedule triggers)
97
+ 1. A request arrives at the Elevasis platform (someone runs `elevasis-sdk exec` or a schedule triggers)
98
98
  2. The platform creates a temporary server just for this execution
99
99
  3. Your code runs on that server
100
100
  4. The result is sent back