@elevasis/sdk 0.4.4 → 0.4.6

package/dist/cli.cjs

@@ -43808,7 +43808,7 @@ async function apiDelete(endpoint, apiUrl = resolveApiUrl()) {
 }
 
 // src/cli/version.ts
-var SDK_VERSION = "0.4.4";
+var SDK_VERSION = "0.4.6";
 
 // src/cli/commands/deploy.ts
 var import_meta2 = {};
@@ -43859,6 +43859,10 @@ async function scanDocumentation() {
   await scan(docsDir, "");
   return files.length > 0 ? files : void 0;
 }
+function escapeMdx(text) {
+  if (!text) return "";
+  return text.replace(/\|/g, "\\|").replace(/\{/g, "\\{").replace(/\}/g, "\\}");
+}
 async function generateResourceMap(org) {
   const workflows = org.workflows ?? [];
   const agents = org.agents ?? [];
@@ -43883,7 +43887,7 @@ async function generateResourceMap(org) {
       "| --- | --- | --- | --- | --- |"
     );
     for (const w of workflows) {
-      const desc = w.config.description?.replace(/\|/g, "\\|") ?? "";
+      const desc = escapeMdx(w.config.description);
       lines.push(`| \`${w.config.resourceId}\` | ${w.config.name} | ${w.config.version} | ${w.config.status} | ${desc} |`);
     }
     lines.push("");
@@ -43896,7 +43900,7 @@ async function generateResourceMap(org) {
       "| --- | --- | --- | --- | --- |"
     );
     for (const a of agents) {
-      const desc = a.config.description?.replace(/\|/g, "\\|") ?? "";
+      const desc = escapeMdx(a.config.description);
       lines.push(`| \`${a.config.resourceId}\` | ${a.config.name} | ${a.config.version} | ${a.config.status} | ${desc} |`);
     }
     lines.push("");
@@ -44472,7 +44476,8 @@ var SCAFFOLD_FILES = [
   ".claude/commands/resource.md",
   ".claude/commands/deploy.md",
   ".claude/commands/inspect.md",
-  ".claude/commands/env.md"
+  ".claude/commands/env.md",
+  ".claude/commands/sdk-docs.md"
 ];
 function registerInitCommand(program3) {
   program3.command("init [directory]").description("Scaffold a new Elevasis project\n  Example: elevasis init my-project").option("--force", "Overwrite existing files").action(wrapAction("init", async (directory, options2) => {
@@ -44516,7 +44521,8 @@ function registerInitCommand(program3) {
       ".claude/commands/resource.md": claudeResourceCommandTemplate(),
       ".claude/commands/deploy.md": claudeDeployCommandTemplate(),
       ".claude/commands/inspect.md": claudeInspectCommandTemplate(),
-      ".claude/commands/env.md": claudeEnvCommandTemplate()
+      ".claude/commands/env.md": claudeEnvCommandTemplate(),
+      ".claude/commands/sdk-docs.md": claudeSdkDocsCommandTemplate()
     };
     for (const [filePath, content] of Object.entries(files)) {
       await (0, import_promises2.writeFile)((0, import_path3.resolve)(targetDir, filePath), content, "utf-8");
@@ -44877,6 +44883,22 @@ at deploy time via \`z.toJSONSchema()\`.
 - Documentation goes in \`docs/\` as \`.mdx\` files
 - \`dist/\` is generated by deploy -- never commit it
 - \`resourceId\` must be lowercase with hyphens, unique per organization
+
+## SDK Reference Documentation
+
+Complete SDK documentation is bundled with the package at:
+
+  node_modules/@elevasis/sdk/reference/
+
+Read \`node_modules/@elevasis/sdk/reference/_index.md\` for a manifest of all
+available pages. Key references:
+
+- \`reference/platform-tools/index.mdx\` -- Complete platform.call() tool catalog
+- \`reference/resources/types.mdx\` -- All SDK types and exports
+- \`reference/runtime/limits.mdx\` -- Resource limits and quotas
+- \`reference/cli/index.mdx\` -- Full CLI command reference
+
+Use the \`/sdk-docs\` command to browse reference documentation.
 `;
 }
 function claudeDocsCommandTemplate() {
@@ -45026,6 +45048,41 @@ Read .env for local environment variables.
 5. Remind user to redeploy after syncing
 `;
 }
+function claudeSdkDocsCommandTemplate() {
+  return `# /sdk-docs command
+
+You are an SDK documentation browser for this Elevasis SDK project.
+
+## Context
+
+Reference documentation is bundled with the SDK package at:
+
+  node_modules/@elevasis/sdk/reference/
+
+Read \`node_modules/@elevasis/sdk/reference/_index.md\` for the full manifest
+of available pages with titles and descriptions.
+
+## Operations
+
+**No arguments (default):** Read and display the manifest at
+\`node_modules/@elevasis/sdk/reference/_index.md\`. Present the available
+documentation pages as a browsable list.
+
+**\`<topic>\`:** Find and read the most relevant page(s) for the given topic.
+Match against the manifest entries. Examples:
+
+- \`/sdk-docs platform-tools\` -- Read \`reference/platform-tools/index.mdx\`
+- \`/sdk-docs types\` -- Read \`reference/resources/types.mdx\`
+- \`/sdk-docs limits\` -- Read \`reference/runtime/limits.mdx\`
+- \`/sdk-docs cli\` -- Read \`reference/cli/index.mdx\`
+- \`/sdk-docs deployment\` -- Read \`reference/deployment/index.mdx\`
+
+If the topic is ambiguous, show matching pages and ask which to read.
+
+**\`all\`:** Read and summarize all reference pages. Provide a concise overview
+of the full SDK documentation.
+`;
+}
 function starterTemplate() {
   return `import type { WorkflowDefinition, OrganizationResources } from '@elevasis/sdk'
 import { z } from 'zod'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/sdk",
-  "version": "0.4.4",
+  "version": "0.4.6",
   "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",
@@ -24,13 +24,9 @@
     "dist/worker/index.js",
     "dist/types/worker/index.d.ts",
     "dist/types/worker/platform.d.ts",
-    "dist/cli.cjs"
+    "dist/cli.cjs",
+    "reference/"
   ],
-  "scripts": {
-    "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.core-dts.json && tsc -p tsconfig.build.json && tsup && rollup -c rollup.dts.config.mjs && esbuild src/cli/index.ts --bundle --platform=node --outfile=dist/cli.cjs --format=cjs --external:esbuild --external:jiti --banner:js=\"#!/usr/bin/env node\"",
-    "check-types": "tsc --noEmit",
-    "test:bundle": "pnpm build && vitest run --config vitest.bundle.config.ts"
-  },
   "dependencies": {
     "esbuild": "^0.25.0",
     "jiti": "^2.0.0"
@@ -39,8 +35,6 @@
     "zod": "^4.1.0"
   },
   "devDependencies": {
-    "@repo/core": "workspace:*",
-    "@repo/typescript-config": "workspace:*",
     "@types/node": "^22.0.0",
     "chalk": "^5.3.0",
     "commander": "^11.0.0",
@@ -51,6 +45,13 @@
     "rollup-plugin-dts": "^6.3.0",
     "tsup": "^8.0.0",
     "typescript": "5.9.2",
-    "zod": "^4.1.0"
+    "zod": "^4.1.0",
+    "@repo/core": "0.0.0",
+    "@repo/typescript-config": "0.0.0"
+  },
+  "scripts": {
+    "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.core-dts.json && tsc -p tsconfig.build.json && tsup && rollup -c rollup.dts.config.mjs && esbuild src/cli/index.ts --bundle --platform=node --outfile=dist/cli.cjs --format=cjs --external:esbuild --external:jiti --banner:js=\"#!/usr/bin/env node\" && node scripts/copy-reference-docs.mjs",
+    "check-types": "tsc --noEmit",
+    "test:bundle": "pnpm build && vitest run --config vitest.bundle.config.ts"
   }
-}
+}

package/reference/_index.md

@@ -0,0 +1,53 @@
+# SDK Reference Documentation
+
+15 pages bundled from the Elevasis documentation site.
+
+Browse these files for complete SDK reference including platform tools catalog,
+resource types, runtime limits, deployment details, and CLI commands.
+
+## Pages
+
+- **CLI Reference** -- `cli/index.mdx`
+  Full reference for every elevasis CLI command -- scaffold, validate, deploy, execute, and inspect resources
+
+- **Execution API** -- `deployment/api.mdx`
+  REST endpoints for executing resources, querying execution history, and managing deployments via the Elevasis external API
+
+- **Deploying Resources** -- `deployment/index.mdx`
+  How to deploy your Elevasis SDK resources to the platform using elevasis deploy, including configuration, validation, and environment setup
+
+- **Resource Documentation** -- `documentation/index.mdx`
+  Write and deploy MDX documentation alongside your Elevasis resources
+
+- **Getting Started** -- `getting-started/index.mdx`
+  Install the Elevasis SDK, scaffold a project, and run your first deployment
+
+- **Project Structure** -- `getting-started/project-structure.mdx`
+  Each file scaffolded by elevasis init and its purpose in the development workflow
+
+- **Elevasis SDK** -- `index.mdx`
+  Build and deploy workflows, agents, and resources with the Elevasis SDK
+
+- **Integration Examples** -- `platform-tools/examples.mdx`
+  Common platform.call() patterns for email, CRM, PDF, LLM inference, resource triggering, and storage
+
+- **Platform Tools** -- `platform-tools/index.mdx`
+  Access 70+ integration adapters and platform services from your SDK workflows via platform.call()
+
+- **Writing Resources** -- `resources/index.mdx`
+  Guide to creating workflows and agents using WorkflowDefinition, AgentDefinition, and OrganizationResources with the Elevasis SDK
+
+- **Common Patterns** -- `resources/patterns.mdx`
+  Common resource patterns for Elevasis SDK developers -- sequential steps, conditional branching, platform tools, error handling, and resource status management
+
+- **SDK Types** -- `resources/types.mdx`
+  Complete type reference for @elevasis/sdk -- package exports, re-exported platform types, ElevasConfig interface, StepHandler context, and runtime values
+
+- **Roadmap** -- `roadmap/index.mdx`
+  Planned SDK features -- error taxonomy, retry semantics, circuit breaker, metrics, alerting, and resource lifecycle extensions
+
+- **Execution Runtime** -- `runtime/index.mdx`
+  How your code runs on the Elevasis platform -- execution lifecycle, concurrency, timeouts, cancellation, error handling, and observability
+
+- **Resource Limits & Quotas** -- `runtime/limits.mdx`
+  Memory limits, execution timeouts, scale quotas, networking constraints, and v1 platform limitations for SDK resources