@elevasis/sdk 0.5.11 → 0.5.13

package/reference/framework/project-structure.mdx

@@ -156,16 +156,6 @@ Local utility scripts for tasks that do not run on the platform: database seeds,
 
 Contains your `ELEVASIS_API_KEY`. This file is gitignored. Never commit it.
 
-### `.env.example`
-
-A git-safe template showing which variables are needed:
-
-```
-ELEVASIS_API_KEY=sk_your_key_here
-```
-
-Commit this file so collaborators know what to configure.
-
 ### `.npmrc`
 
 Sets `auto-install-peers = true`. The SDK uses Zod as a peer dependency, so this ensures Zod installs automatically.
@@ -269,11 +259,11 @@ A 7-lesson guided learning path adapted to the user's skill profile. Lessons cov
 
 Not all scaffolded files participate in template updates. Files fall into two categories:
 
-**SCAFFOLD_FILES total: 30**
+**SCAFFOLD_FILES total: 29**
 
-**INIT_ONLY** (15 files) -- Written once during `elevasis-sdk init`, never updated by `elevasis-sdk update`:
+**INIT_ONLY** (14 files) -- Written once during `elevasis-sdk init`, never updated by `elevasis-sdk update`:
 - `package.json`, `pnpm-workspace.yaml`, `tsconfig.json`
-- `.env`, `.env.example`, `.npmrc`
+- `.env`, `.npmrc`
 - `src/index.ts`, `src/operations/platform-status.ts`, `src/operations/index.ts`, `src/example/echo.ts`, `src/example/index.ts`, `src/shared/.gitkeep`
 - `docs/index.mdx`, `docs/in-progress/.gitkeep`
 - `.claude/rules/workspace-patterns.md`

package/reference/framework/tutorial-system.mdx

@@ -0,0 +1,253 @@
+---
+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
+---
+
+**Implementation:** `packages/sdk/src/cli/commands/templates/core/claude.ts` (`claudeTutorialCommandTemplate()`)
+
+**Template Version:** 27
+
+The tutorial system is emitted to `external/<project>/.claude/commands/tutorial.md` during `elevasis-sdk init` or `elevasis-sdk update`. Users invoke it with `/tutorial` from Claude Code.
+
+---
+
+## Menu System
+
+`/tutorial` always shows the full 21-item menu table on invocation. All items are visible at once with progress indicators. No track gating -- any item is available at any time.
+
+```
+Elevasis Tutorial
+==================
+
+INTRODUCTION                                       0/4
+  1  Welcome & Orientation                         [ ]
+  2  How This Workspace Works                      [ ]
+  3  The /meta Command                             [ ]
+  4  /work and /docs                               [ ]
+
+CORE CONCEPTS                                      0/6
+  5  Your First Custom Workflow                    [ ]
+  6  Understanding Data (Schemas)                  [ ]
+  7  Using Platform Tools                          [ ]
+  8  Multi-Step Workflows                          [ ]
+  9  Decision Points                               [ ]
+ 10  Going to Production                           [ ]
+
+ADVANCED MODULES                                   0/9
+ 11  Human-in-the-Loop                             [ ]
+ 12  Task Scheduling                               [ ]
+ 13  Notification System                           [ ]
+ 14  Real-World Integrations                       [ ]
+ 15  Error Handling Mastery                        [ ]
+ 16  Advanced Workflows                            [ ]
+ 17  Resource Composition                          [ ]
+ 18  LLM Integration                               [ ]
+ 19  AI Agents                                     [ ]
+
+ADVANCED WORKSPACE                                 0/2
+ 20  Rules, Memory, and Customization              [ ]
+ 21  Template Lifecycle                            [ ]
+
+Pick a number to start.
+```
+
+**Progress indicators:** `[ ]` not started, `[>]` in progress, `[x] YYYY-MM-DD` complete.
+
+User picks a number to start or resume any item. `"status"` shows the same table.
+
+---
+
+## 4 Sections
+
+- **INTRODUCTION (1-4):** Welcome + workspace orientation (workspace framework, /meta, /work and /docs) -- taught before building
+- **CORE CONCEPTS (5-10):** Orchestration lessons (workflows, schemas, tools, multi-step, conditions, production)
+- **ADVANCED MODULES (11-19):** Hands-on feature modules (hitl, schedules, notifications, integrations, error-handling, workflows, composition, llm, agents)
+- **ADVANCED WORKSPACE (20-21):** Power-user customization (rules/memory, template lifecycle)
+
+---
+
+## Skill-Level Adaptation
+
+Assessed during `/meta init`. Two independent dimensions.
+
+### automation dimension
+
+| Level      | Context Loading                                                                                         | Delivery                                                            | Verification                                                      |
+| ---------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- | ----------------------------------------------------------------- |
+| `none`     | Glossary, Workflow overview, Platform Tools Overview only. Skip Zod, Execution Model, Design Decisions. | Agent writes all code. No code shown to user. Analogies throughout. | CLI primary. Agent runs `elevasis-sdk exec` and narrates results. |
+| `low-code` | All concept sections. Zapier/Make mapping. `adapters.mdx` on-demand.                                    | Map to Zapier/Make equivalents. Show code with explanations.        | CLI primary.                                                      |
+| `custom`   | All docs listed per-lesson and per-module.                                                              | Full technical content, code-first.                                 | CLI primary.                                                      |
+
+### platformNavigation dimension
+
+| Level         | Behavior                                                                                                               |
+| ------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| `none`        | Walk through pages step by step with exact navigation paths. Explain each page before asking user to interact with it. |
+| `oriented`    | Reference pages by name; briefly remind purpose on first mention.                                                      |
+| `comfortable` | Reference by name only; focus on advanced filtering and schedule types.                                                |
+
+**General rules (all levels):** Fast users: acknowledge, offer to skip ahead. Level change observed: note in `skills.md` Growth Log. After lesson/module: update progress file.
+
+---
+
+## Progress Logic
+
+```
+1. Read .claude/memory/tutorial-progress.md
+2. Show the full menu table with progress indicators filled in
+3. User picks a number -> start or resume that item directly
+4. After completion: mark done in progress file, show updated menu table
+5. All 21 items complete -> congratulate, suggest docs/ or /work
+```
+
+---
+
+## Introduction: Items 1-4
+
+Items 1-4 orient the user to the platform and workspace before any building.
+
+**Item 1 -- Welcome & Orientation:** Platform tour, deploy echo workflow, Command Center orientation.
+
+**Item 2 -- How This Workspace Works:** CLAUDE.md as instruction sheet, four commands, creds skill, memory system overview.
+
+**Item 3 -- The /meta Command:** Project dashboard, /meta fix, /meta deploy, /meta health.
+
+**Item 4 -- /work and /docs:** Cross-session task tracking, documentation lifecycle, /work vs /docs boundary.
+
+---
+
+## Core Path: Lessons 5-10
+
+Each lesson: (1) announce title and goal, (2) explain concept per skill level, (3) build or modify something, (4) verify it works, (5) record observations, ask "ready for next?"
+
+**Lesson 5 -- Your First Custom Workflow**
+
+- `automation: none` -- "A recipe." Agent writes all code. Agent runs `elevasis-sdk exec` and narrates result.
+- `automation: low-code or custom` -- Modify echo workflow. Walk through `config`, `contract`, `steps`, `entryPoint`. Deploy with `elevasis-sdk check` then `elevasis-sdk deploy`.
+
+**Lesson 6 -- Understanding Data (Schemas)**
+
+- `automation: none` -- "What information does your automation need?" No Zod, no code shown. Agent reads identity.md goals and writes the schema.
+- `automation: low-code` -- "Field mapping like Zapier, but with validation." Show Zod types briefly.
+- `automation: custom` -- Full Zod explanation. `z.infer`. Show how schema fields define CLI input structure.
+
+**Lesson 7 -- Using Platform Tools**
+
+- `automation: none` -- Agent makes all code edits. Credential creation guided via Command Center UI.
+- `automation: low-code or custom` -- Explain adapter pattern: `createAttioAdapter('cred')`. Show singleton pattern: `import { scheduler, llm } from '@elevasis/sdk/worker'`.
+
+**Lesson 8 -- Multi-Step Workflows**
+
+- `automation: none` -- "Step 1 passes its result to Step 2, like a relay race." Command View is PRIMARY teaching tool.
+- `automation: low-code or custom` -- Chain steps with `StepType.LINEAR`. Show relationship edges in Command View.
+
+**Lesson 9 -- Decision Points**
+
+- `automation: none` -- "If the customer is VIP, do this -- otherwise, do that." Agent runs both paths. Open Execution Logs.
+- `automation: low-code or custom` -- Conditional routing with `StepType.CONDITIONAL`. Show step trace in Execution Logs.
+
+**Lesson 10 -- Going to Production**
+
+- `automation: none` -- "Draft vs live." Create Recurring schedule in Task Scheduler.
+- `automation: low-code or custom` -- Change `status: dev` -> `production`. Cover `try/catch`, `ExecutionError`, `PlatformToolError`. CLI monitoring: `elevasis-sdk executions`.
+
+---
+
+## Module System: Items 11-19
+
+Modules are available any time -- no core path prerequisite. After completing a module the full menu table is shown again.
+
+| #   | Module           | Reference Docs                                                   | Build                                                                                                                  | Key Concepts                                                       |
+| --- | ---------------- | ---------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
+| 11  | `hitl`           | `command-center.mdx` (Command Queue)                             | Approval gate with `approval.requestApproval()`. Full lifecycle: trigger -> Command Queue -> approve/reject -> resume. | `approval` adapter, pending state, Command Queue UI                |
+| 12  | `schedules`      | `command-center.mdx` (Task Scheduler)                            | All three schedule types: Recurring, Relative, Absolute. `scheduler` adapter for in-workflow.                          | Cron syntax, schedule types, Task Scheduler UI                     |
+| 13  | `notifications`  | `adapters.mdx` (notifications, email)                            | Notification + email steps. Alerts on completion.                                                                      | `notifications` singleton, `email` singleton                       |
+| 14  | `integrations`   | `platform-tools/index.mdx` (Credential Security), `adapters.mdx` | Real adapter from `identity.md`. Full end-to-end with OAuth or API key credential.                                     | Adapter pattern, credential scoping, external call error handling  |
+| 15  | `error-handling` | `patterns.mdx` (error handling), `troubleshooting.mdx`           | Workflow demonstrating all three error types. `try/catch`, `context.logger`, recovery.                                 | `ExecutionError`, `PlatformToolError`, `ToolingError`              |
+| 16  | `workflows`      | `patterns.mdx` (store, logging, organization)                    | Refactor with `context.store`, `context.logger`, domain directories. Advanced schema patterns.                         | `context.store`, `context.logger`, schema depth                    |
+| 17  | `composition`    | `command-center.mdx` (Command View), `patterns.mdx`              | Two workflows: first triggers second with `execution.trigger()`. Declare relationship.                                 | `execution.trigger`, relationship declarations, Command View edges |
+| 18  | `llm`            | `adapters.mdx` (llm singleton)                                   | `llm.generate()` with structured output. Model selection and temperature.                                              | `llm` singleton, structured output, temperature                    |
+| 19  | `agents`         | `reference/framework/agent.mdx`                                  | Agent definition with tools. LLM tool calling. Agent vs workflow comparison.                                           | Agent definition, tool registration, execution trace               |
+
+---
+
+## Advanced Workspace: Items 20-21
+
+**Item 20 -- Rules, Memory, and Customization**
+
+- `none` -- "Sticky notes the agent reads automatically." Show `.claude/rules/workspace-patterns.md` without technical detail.
+- `low-code` -- Show `.claude/rules/` directory. Explain MANAGED (`sdk-patterns.md`) vs INIT_ONLY (`workspace-patterns.md`). Explain error promotion: 3+ recurrences -> add a rule.
+- `custom` -- Read both rules files. Walk through memory layout: `index.md`, `profile/`, `errors/`, `tutorial-progress.md`. Walk through adding a new rule.
+
+**Item 21 -- Template Lifecycle**
+
+- `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.
+
+---
+
+## Progress File Format
+
+Stored at `.claude/memory/tutorial-progress.md`.
+
+```markdown
+# Tutorial Progress
+
+Current: <free-form, e.g. "4: /work and /docs" or "M:integrations">
+Started: YYYY-MM-DD
+Last Session: YYYY-MM-DD
+
+## Completed Lessons
+
+| Item | Title | Completed | Duration |
+| --- | --- | --- | --- |
+| 1 | Welcome & Orientation | 2026-03-01 | 25 min |
+
+## Completed Modules
+
+| Module | Title | Completed | Duration |
+| --- | --- | --- | --- |
+| hitl | Human-in-the-Loop | 2026-03-03 | 40 min |
+
+## Capability Observations
+
+| Source | Observation |
+| --- | --- |
+| 1 | Navigated Command View without guidance |
+
+## Assessment Notes
+
+- Strong automation background, slow on TypeScript syntax
+```
+
+**Backward compatibility:** Missing `Completed Modules` section treated as empty. Old files with `Completed MF Lessons` map entries to items 2-4 and 20-21 by title match.
+
+---
+
+## Implementation Files
+
+| File                                                            | Role                                                                                                                                                                    |
+| --------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `packages/sdk/src/cli/commands/templates/core/claude.ts`        | `claudeTutorialCommandTemplate()` -- full tutorial prompt; `claudeMdTemplate()` -- Platform Navigation guidance; `claudeMetaCommandTemplate()` -- onboarding assessment |
+| `packages/sdk/src/cli/commands/templates/core/workspace.ts`     | `TEMPLATE_VERSION = 27`                                                                                                                                                 |
+| `packages/sdk/src/cli/commands/init.ts`                         | `TEMPLATE_CHANGELOG` -- version history (v1-v27)                                                                                                                        |
+| `apps/docs/content/docs/sdk/framework/interaction-guidance.mdx` | Skill dimensions: automation, platformNavigation                                                                                                                        |
+
+---
+
+## Template Version History (Recent)
+
+| Version | Change                                                                                                                                                       |
+| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| 27      | 4-section menu redesign: INTRODUCTION (1-4), CORE CONCEPTS (5-10), ADVANCED MODULES (11-19), ADVANCED WORKSPACE (20-21); MF1-MF3 moved to front as items 2-4 |
+| 23      | Flat 21-item menu table; module gating removed; error-handling moved to position 12                                                                          |
+| 22      | `/docs` command re-introduced; MF3 covers `/work` and `/docs` together                                                                                       |
+| 20      | `/work` comprehensive rewrite -- list-then-pick, interview-based create, intelligent placement                                                               |
+| 19      | Menu-driven entry; Meta-Framework track (MF1-MF5) with skill-adaptive variants                                                                               |
+| 18      | Skill-adaptive lesson variants; Command Center UI integrated; Platform Navigation dimension                                                                  |
+| 16      | Module system; single `/tutorial` invocation; phase tracking                                                                                                 |
+
+---
+
+**Last Updated:** 2026-03-05

package/reference/{getting-started/index.mdx → getting-started.mdx}

@@ -18,7 +18,7 @@ pnpm install
 
 `pnpm dlx` downloads the SDK temporarily to run `elevasis-sdk init`, which scaffolds your project with a working echo workflow, TypeScript config, and Claude Code integration. `pnpm install` then installs the SDK and its dependencies locally -- after that, all `elevasis-sdk` commands work directly via the scripts in `package.json` or `pnpm exec elevasis-sdk <command>`.
 
-The command scaffolds 29 files covering configuration, source, documentation, and Claude Code integration:
+The command scaffolds 28 files covering configuration, source, documentation, and Claude Code integration:
 
 ```
 my-project/
@@ -58,7 +58,6 @@ my-project/
 ├── tsconfig.json                   # TypeScript config (app-focused)
 ├── pnpm-workspace.yaml             # Standalone project workspace
 ├── .env                            # API key only
-├── .env.example                    # Git-safe template
 ├── .npmrc                          # auto-install-peers
 └── .gitignore                      # Excludes worker temp file, claude files
 ```
@@ -81,7 +80,7 @@ Open `.env` and set your API key:
 ELEVASIS_API_KEY=sk_your_key_here
 ```
 
-The `.env.example` file provides the same template and is safe to commit. The actual `.env` is gitignored.
+The `.env` file is gitignored -- never commit it.
 
 **Note:** Do not add `NODE_ENV` to your `.env`. The SDK treats `undefined` as production by default, which means your project connects to the hosted Elevasis API. Adding `NODE_ENV=development` is the most common setup mistake.
 
@@ -137,10 +136,10 @@ Replace `<execution-id>` with the ID returned from the executions list.
 ## Next Steps
 
 - **Open in Claude Code** -- Setup runs automatically on first session (installs deps, configures `.env`, creates your developer profile)
-- [Development Framework](../framework/index.mdx) -- How Claude Code helps you build
-- [Resources](../resources/index.mdx) -- Define workflows and agents
-- [CLI Reference](../cli/index.mdx) -- Full command reference with flags
-- [Deployment](../deployment/index.mdx) -- Deployment lifecycle and environment variables
+- [Development Framework](framework/index.mdx) -- How Claude Code helps you build
+- [Resources](resources/index.mdx) -- Define workflows and agents
+- [CLI Reference](cli.mdx) -- Full command reference with flags
+- [Deployment](deployment/index.mdx) -- Deployment lifecycle and environment variables
 
 When a new SDK version is released, run `/meta fix` in Claude Code for an interactive upgrade that includes SDK update, drift repair, and documentation verification. Alternatively, run `elevasis-sdk update` from the terminal to update managed files (CLAUDE.md, slash commands, `.gitignore`) without agent interaction. To update the SDK package itself, run `pnpm update @elevasis/sdk`.
 

package/reference/index.mdx

@@ -1,114 +1,117 @@
----
-title: Elevasis SDK
-description: Build and deploy workflows, agents, and resources with the Elevasis SDK
-loadWhen: "First session or new to the SDK"
----
-
-`@elevasis/sdk` lets you build workflows, agents, and resources in TypeScript and deploy them to the Elevasis platform with a single command. The developer experience is Vercel-style: write TypeScript, validate locally, deploy -- the platform handles execution, tool access, and observability. You never manage infrastructure. Zod 4.1 is the only peer dependency.
-
-## Quick Start
-
-```bash
-pnpm dlx @elevasis/sdk init my-project
-cd my-project
-pnpm install
-elevasis-sdk deploy
-```
-
-After `pnpm dlx @elevasis/sdk init`, your project is scaffolded with a working echo workflow, config file, TypeScript setup, and a `CLAUDE.md` that gives Claude Code full awareness of the SDK. After `elevasis-sdk deploy`, your resources appear in AI Studio and are available to run immediately.
-
-Here is a minimal workflow definition:
-
-```ts
-import { WorkflowDefinition, OrganizationResources } from '@elevasis/sdk';
-import { z } from 'zod';
-
-const greetInput = z.object({ name: z.string() });
-const greetOutput = z.object({ message: z.string() });
-
-type GreetInput = z.infer<typeof greetInput>;
-type GreetOutput = z.infer<typeof greetOutput>;
-
-const greetWorkflow: WorkflowDefinition = {
-  id: 'greet',
-  name: 'Greet',
-  inputSchema: greetInput,
-  outputSchema: greetOutput,
-  steps: [
-    {
-      id: 'greet-step',
-      name: 'Build greeting',
-      handler: async (input: GreetInput): Promise<GreetOutput> => {
-        return { message: `Hello, ${input.name}!` };
-      },
-      next: null,
-    },
-  ],
-};
-
-export const resources: OrganizationResources = {
-  workflows: [greetWorkflow],
-};
-```
-
-## What You Can Build
-
-- **Workflows** -- Step-based automation with typed inputs and outputs. Steps can be linear, conditional, or branching. Each step is a plain async function. Workflows are the primary resource type and are fully supported.
-- **Agents** -- Autonomous AI resources with access to platform tools. Agents run in the worker runtime with full LLM access and platform tool support. Use `--async` when executing agents to avoid HTTP timeout limits on long-running runs.
-
-## Platform Tools
-
-Inside any workflow step, import `platform` from `@elevasis/sdk/worker` to call platform tools:
-
-```ts
-import { platform } from '@elevasis/sdk/worker';
-
-const result = await platform.call({
-  tool: 'gmail',
-  method: 'send',
-  params: { to: 'user@example.com', subject: 'Hello', body: 'World' },
-  credential: 'my-gmail-credential',
-});
-```
-
-The platform exposes 70+ tools across 13 integration adapters -- Gmail, Stripe, Google Sheets, Notion, and more. Credentials are managed server-side; API keys never cross the execution boundary. LLM calls are also available via `platform.call({ tool: 'llm', ... })` with API keys resolved from platform environment variables.
-
-See [Platform Tools](platform-tools/index.mdx) for the full catalog.
-
-## Known Limitations
-
-- **No streaming logs** -- Execution logs are returned in the response body after completion. Real-time log streaming is not available.
-- **Agent HTTP timeouts** -- Use `elevasis-sdk exec --async` for agent executions. Agents can run for minutes; the synchronous endpoint will time out for long-running runs. The `--async` flag returns an execution ID immediately and polls for the result.
-
-## Documentation
-
-### Getting Started
-
-- [Getting Started](getting-started/index.mdx) - Installation, authentication, first workflow, and project structure
-
-### Core Concepts
-
-- [Resources](resources/index.mdx) - Workflow and agent definition patterns, Zod schemas, step types, and routing
-- [Platform Tools](platform-tools/index.mdx) - Full catalog of 70+ tools, integration adapters, and credential management
-- [Security](security/credentials.mdx) - Three-layer credential model, HTTP tool patterns, and credential management
-
-### Reference
-
-- [Concepts](concepts/index.mdx) - Plain-English concept explanations, glossary, Zod guide, execution model, and common errors
-- [Templates](templates/index.mdx) - 7 workflow templates: web-scraper, data-enrichment, email-sender, lead-scorer, and more
-- [CLI Reference](cli/index.mdx) - All CLI commands: check, deploy, exec, resources, executions, env, and more
-- [Deployment](deployment/index.mdx) - Deploy pipeline, versioning, bundle upload, and registry registration
-- [Runtime](runtime/index.mdx) - Worker execution model, concurrency, timeouts, cancellation, and resource limits
-
-### Framework
-
-- [Development Framework](framework/index.mdx) - How Claude Code helps you build: project structure, agent integration, memory, and documentation
-
-### Developer Tools
-
-- [Documentation](framework/documentation.mdx) - Writing and deploying MDX documentation alongside your resources
-- [Roadmap](roadmap/index.mdx) - Planned features including agent execution, streaming logs, and SDK testing utilities
-
----
-
-**Last Updated:** 2026-02-25
+---
+title: Elevasis SDK
+description: Build and deploy workflows, agents, and resources with the Elevasis SDK
+loadWhen: "First session or new to the SDK"
+---
+
+`@elevasis/sdk` lets you build workflows, agents, and resources in TypeScript and deploy them to the Elevasis platform with a single command. The developer experience is Vercel-style: write TypeScript, validate locally, deploy -- the platform handles execution, tool access, and observability. You never manage infrastructure. Zod 4.1 is the only peer dependency.
+
+## Quick Start
+
+```bash
+pnpm dlx @elevasis/sdk init my-project
+cd my-project
+pnpm install
+elevasis-sdk deploy
+```
+
+After `pnpm dlx @elevasis/sdk init`, your project is scaffolded with a working echo workflow, config file, TypeScript setup, and a `CLAUDE.md` that gives Claude Code full awareness of the SDK. After `elevasis-sdk deploy`, your resources appear in AI Studio and are available to run immediately.
+
+Here is a minimal workflow definition:
+
+```ts
+import { WorkflowDefinition, OrganizationResources } from '@elevasis/sdk';
+import { z } from 'zod';
+
+const greetInput = z.object({ name: z.string() });
+const greetOutput = z.object({ message: z.string() });
+
+type GreetInput = z.infer<typeof greetInput>;
+type GreetOutput = z.infer<typeof greetOutput>;
+
+const greetWorkflow: WorkflowDefinition = {
+  id: 'greet',
+  name: 'Greet',
+  inputSchema: greetInput,
+  outputSchema: greetOutput,
+  steps: [
+    {
+      id: 'greet-step',
+      name: 'Build greeting',
+      handler: async (input: GreetInput): Promise<GreetOutput> => {
+        return { message: `Hello, ${input.name}!` };
+      },
+      next: null,
+    },
+  ],
+};
+
+export const resources: OrganizationResources = {
+  workflows: [greetWorkflow],
+};
+```
+
+## What You Can Build
+
+- **Workflows** -- Step-based automation with typed inputs and outputs. Steps can be linear, conditional, or branching. Each step is a plain async function. Workflows are the primary resource type and are fully supported.
+- **Agents** -- Autonomous AI resources with access to platform tools. Agents run in the worker runtime with full LLM access and platform tool support. Use `--async` when executing agents to avoid HTTP timeout limits on long-running runs.
+
+## Platform Tools
+
+Inside any workflow step, import `platform` from `@elevasis/sdk/worker` to call platform tools:
+
+```ts
+import { platform } from '@elevasis/sdk/worker';
+
+const result = await platform.call({
+  tool: 'gmail',
+  method: 'send',
+  params: { to: 'user@example.com', subject: 'Hello', body: 'World' },
+  credential: 'my-gmail-credential',
+});
+```
+
+The platform exposes 70+ tools across 13 integration adapters -- Gmail, Stripe, Google Sheets, Notion, and more. Credentials are managed server-side; API keys never cross the execution boundary. LLM calls are also available via `platform.call({ tool: 'llm', ... })` with API keys resolved from platform environment variables.
+
+See [Platform Tools](platform-tools/index.mdx) for the full catalog.
+
+## Known Limitations
+
+- **No streaming logs** -- Execution logs are returned in the response body after completion. Real-time log streaming is not available.
+- **Agent HTTP timeouts** -- Use `elevasis-sdk exec --async` for agent executions. Agents can run for minutes; the synchronous endpoint will time out for long-running runs. The `--async` flag returns an execution ID immediately and polls for the result.
+
+## Documentation
+
+### Getting Started
+
+- [Getting Started](getting-started.mdx) - Installation, authentication, first workflow, and project structure
+
+### Core Concepts
+
+- [Resources](resources/index.mdx) - Workflow and agent definition patterns, Zod schemas, step types, and routing
+- [Platform Tools](platform-tools/index.mdx) - Full catalog of 70+ tools, integration adapters, and credential management
+- [Platform Tools](platform-tools/index.mdx#credential-security) - Three-layer credential model, HTTP tool patterns, and credential management
+
+### Reference
+
+- [Concepts](concepts.mdx) - Plain-English concept explanations, glossary, Zod guide, execution model, and common errors
+- [Templates](templates/index.mdx) - 7 workflow templates: web-scraper, data-enrichment, email-sender, lead-scorer, and more
+- [CLI Reference](cli.mdx) - All CLI commands: check, deploy, exec, resources, executions, env, and more
+- [Deployment](deployment/index.mdx) - Deploy pipeline, versioning, bundle upload, and registry registration
+- [Runtime](runtime.mdx) - Worker execution model, concurrency, timeouts, cancellation, resource limits, and v1 limitations
+
+### Framework
+
+- [Development Framework](framework/index.mdx) - How Claude Code helps you build: project structure, agent integration, memory, and documentation
+- [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
+
+### More
+
+- [Documentation](framework/index.mdx#resource-documentation) - Writing and deploying MDX documentation alongside your resources
+- [Troubleshooting](troubleshooting.mdx) - Static error catalog for CLI, deployment, schema, and runtime failures
+- [Roadmap](roadmap.mdx) - Planned features including agent execution, streaming logs, and SDK testing utilities
+
+---
+
+**Last Updated:** 2026-02-25