@elevasis/sdk 1.0.2 → 1.2.0

package/reference/framework/project-structure.mdx

@@ -48,19 +48,18 @@ Cross-domain shared types and utilities. This directory starts empty (`.gitkeep`
 
 ### `elevasis.config.ts`
 
-Project-level configuration. The scaffolded file includes `templateVersion`, which tracks which template generation your project uses, plus commented-out options (`defaultStatus`, `dev.port`) so you can discover available settings without looking them up:
+Project-level configuration. The scaffolded file includes commented-out options (`defaultStatus`, `dev.port`) so you can discover available settings without looking them up:
 
 ```ts
 import type { ElevasConfig } from '@elevasis/sdk'
 
 export default {
-  templateVersion: 28,
   // defaultStatus: 'dev',     // Default status for new resources ('dev' | 'prod')
   // dev: { port: 5170 },      // Local API port (internal development only)
 } satisfies ElevasConfig
 ```
 
-Leave this file minimal -- the platform provides sensible defaults. Do not remove `templateVersion`; it is read by `elevasis-sdk update` to determine which template changes need to be applied to your project.
+Leave this file minimal -- the platform provides sensible defaults.
 
 ---
 

package/reference/framework/tutorial-system.mdx

@@ -3,7 +3,7 @@ title: Tutorial System
 description: Reference for the SDK tutorial system -- 21-item menu across 4 sections, skill-level adaptation rules, progress tracking format, and per-lesson module contents
 ---
 
-The tutorial system is available via the `/tutorial` slash command in Claude Code. It is scaffolded by `elevasis-sdk init` and updated by `elevasis-sdk update`.
+The tutorial system is available via the `/tutorial` slash command in Claude Code. It is included in the external template project scaffold.
 
 ---
 
@@ -179,7 +179,7 @@ Modules are available any time -- no core path prerequisite. After completing a
 
 - `none` -- "SDK releases automatically update your workspace." Explain `/meta fix` as the update command.
 - `low-code` -- Explain MANAGED vs INIT_ONLY file types. Show how `/meta fix` handles conflicts.
-- `custom` -- Full template lifecycle: init (writes all files), update (applies MANAGED changes, flags conflicts, preserves INIT_ONLY), fix (drift repair + SDK upgrade offer). Conflict resolution reads current + template from `@elevasis/sdk/templates`, merges preserving customizations.
+- `custom` -- Full template lifecycle: the external template handles initial project creation. `/meta fix` performs drift repair and SDK upgrade. Conflict resolution merges current files against the template, preserving customizations in INIT_ONLY files.
 
 ---
 

package/reference/getting-started.mdx

@@ -57,7 +57,7 @@ my-project/
 │   ├── index.mdx                   # Starter documentation page
 │   └── in-progress/
 │       └── .gitkeep                # Work-in-progress docs directory
-├── elevasis.config.ts              # Config with templateVersion and options
+├── elevasis.config.ts              # Config with workspace options
 ├── package.json                    # check-types + deploy scripts
 ├── tsconfig.json                   # TypeScript config (app-focused)
 ├── pnpm-workspace.yaml             # Standalone project workspace
@@ -66,16 +66,6 @@ my-project/
 └── .gitignore                      # Excludes worker temp file, claude files
 ```
 
-The scaffolded `elevasis.config.ts` includes a `templateVersion` field that tracks which template generation your project uses. Leave it as-is -- it is managed automatically by `elevasis-sdk update`:
-
-```ts
-import type { ElevasConfig } from '@elevasis/sdk'
-
-export default {
-  templateVersion: 27,
-} satisfies ElevasConfig
-```
-
 ### Set Up Your API Key
 
 Open `.env` and set your API key:

package/reference/index.mdx

@@ -8,6 +8,8 @@ loadWhen: "First session or new to the SDK"
 
 Workflows are step-based automations with typed inputs and outputs. Agents are autonomous AI resources with access to platform tools. Both are defined in TypeScript, exported from a single entry point, and deployed with `elevasis-sdk deploy`. Resources appear in AI Studio immediately after a successful deploy.
 
+The SDK ships with a full CLI (`elevasis-sdk`) for validation, deployment, execution, and inspection. Platform tools expose 70+ integrations across 12 adapters -- Gmail, Stripe, Google Sheets, Attio, and more -- with credentials managed server-side so API keys never cross the execution boundary.
+
 ## Quick Start
 
 ```bash
@@ -75,9 +77,22 @@ See [Platform Tools](platform-tools/index.mdx) for the full catalog.
 ### Framework
 
 - [Development Framework](framework/index.mdx) - How Claude Code helps you build: project structure, agent integration, memory, and documentation
+- [Project Structure](framework/project-structure.mdx) - Scaffolded file layout, domain barrels, src/index.ts entry point, and config files
+- [Agent Configuration](framework/agent.mdx) - Agent capabilities, tool access, model config, and Claude Code integration patterns
+- [Memory](framework/memory.mdx) - Agent memory system, session state, developer profiles, and workspace conventions
 - [Interaction Guidance](framework/interaction-guidance.mdx) - Skill dimension adaptation rules for platform navigation, API integration, and automation concepts
 - [Tutorial System](framework/tutorial-system.mdx) - 21-item tutorial menu, skill-adaptive lesson variants, progress tracking, and module contents
 
+### Resources Subpages
+
+- [SDK Types](resources/types.mdx) - Complete type reference for `@elevasis/sdk` exports, config fields, and step handler context
+- [Common Patterns](resources/patterns.mdx) - Sequential steps, conditional branching, error handling, and resource status patterns
+
+### Deployment Subpages
+
+- [Command Center](deployment/command-center.mdx) - Resource graph, relationships, node types, and post-deployment UI reference
+- [Execution API](deployment/api.mdx) - REST endpoints for executing resources and managing deployments
+
 ### More
 
 - [Troubleshooting](troubleshooting.mdx) - Static error catalog for CLI, deployment, schema, and runtime failures
@@ -85,4 +100,4 @@ See [Platform Tools](platform-tools/index.mdx) for the full catalog.
 
 ---
 
-**Last Updated:** 2026-03-19
+**Last Updated:** 2026-04-05

package/reference/platform-tools/index.mdx

@@ -40,7 +40,7 @@ Both patterns return a Promise that resolves with the tool result or rejects wit
 
 ## Integration Adapters
 
-Twelve integration adapters give you access to 58+ tool methods covering third-party APIs. Pass the credential name once at adapter creation. Supabase is listed separately under [Database Access](#database-access) below.
+Ten integration adapters give you access to 50+ tool methods covering third-party APIs. Pass the credential name once at adapter creation. Supabase is listed separately under [Database Access](#database-access) below.
 
 | Adapter       | Tools                         | Credential Shape         |
 | ------------- | ----------------------------- | ------------------------ |
@@ -54,7 +54,6 @@ Twelve integration adapters give you access to 58+ tool methods covering third-p
 | Resend        | 2 (send/get email)            | `{ apiKey }`             |
 | Dropbox       | 2 (upload/folder)             | `{ accessToken }`        |
 | Apify         | 1 (run actor)                 | `{ token }`              |
-| Mailso        | 1 (verify email)              | `{ apiKey }`             |
 
 ## Credential Security
 
@@ -209,8 +208,9 @@ const qualified = await platform.call({
 
 ## Documentation
 
-- [Integration Adapters](adapters-integration.mdx) - All 12 integration adapters with method tables and code examples
+- [Integration Adapters](adapters-integration.mdx) - All 10 integration adapters with method tables and code examples
 - [Platform Adapters](adapters-platform.mdx) - All 9 platform service adapters with method tables and code examples
+- [Adapter Type Safety](type-safety.mdx) - Required fields, discriminated unions, and intentionally loose adapter types
 
 ---
 

package/reference/platform-tools/type-safety.mdx

@@ -25,9 +25,9 @@ await llm.generate({
 })
 ```
 
-### Email Adapter — `domain` (AnyMailFinder)
+### Tomba Adapter — `domain` and `email`
 
-`domain` is required on `FindCompanyEmailParams` and `FindPersonEmailParams`. Previously all params were optional, allowing `findCompanyEmail({})` to compile but fail at runtime. The type change enforces the one field that is always necessary for email discovery.
+`domain` is required on `TombaDomainSearchParams` and `TombaEmailFinderParams`. `email` is required on `TombaEmailVerifierParams`. Previously all params were optional, allowing calls to compile but fail at runtime. The type change enforces the fields that are always necessary for email discovery and verification.
 
 ---
 

package/reference/templates/index.mdx

@@ -11,17 +11,17 @@ All templates are available for any organization. Credentials specific to each t
 
 ## Documentation
 
-### Data Collection
+### Data Collection & Processing
 
 - [Web Scraper](web-scraper.mdx) - Apify actor runs web scrape, stores structured results in Supabase table
 - [Data Enrichment](data-enrichment.mdx) - Reads Supabase records, enriches each with LLM, writes results back; supports batching
 
-### Communication
+### Communication & CRM
 
 - [Email Sender](email-sender.mdx) - Transactional email via Resend with plain text and HTML support, single or multiple recipients
 - [Lead Scorer](lead-scorer.mdx) - Multi-criteria LLM lead scoring with configurable rubric and Supabase result storage
 
-### Documents
+### Documents & AI
 
 - [PDF Generator](pdf-generator.mdx) - Renders structured data to PDF, uploads to platform storage, returns signed download URL
 - [Text Classifier](text-classifier.mdx) - Multi-label text classification via LLM structured output, configurable categories and confidence scoring

package/reference/troubleshooting.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Common Errors"
-description: "Static SDK-level error catalog -- CLI errors, deployment errors, schema validation, platform tool failures, and runtime errors with diagnostic steps"
+title: Common Errors
+description: Static SDK-level error catalog -- CLI errors, deployment errors, schema validation, platform tool failures, and runtime errors with diagnostic steps
 loadWhen: "Debugging an unknown error not found in workspace memory"
 ---
 
@@ -16,9 +16,9 @@ This is the static SDK-level error catalog. Check `.claude/memory/errors/` first
 
 **Fix:**
 
-1. Check that `.env` exists in the workspace root
+1. Check that `.env` exists in the project root (or any parent directory)
 2. Confirm it contains `ELEVASIS_PLATFORM_KEY=sk_...`
-3. Make sure you are running the CLI from the workspace directory (where `.env` is located)
+3. The CLI walks up directories to find `.env`, so running from subdirectories like `operations/` works automatically
 4. If the file exists with the right content, run `elevasis-sdk check` again
 
 ### Cannot connect to API