@elevasis/sdk 0.5.11 → 0.5.12

package/dist/worker/index.js

@@ -4997,15 +4997,20 @@ function resolveNext(next, data) {
   }
   return next.default;
 }
+function serializeNext(next) {
+  if (next === null) return null;
+  if (next.type === "linear") return { type: "linear", target: next.target };
+  return { type: "conditional", routes: next.routes.map((r) => ({ target: r.target })), default: next.default };
+}
 async function executeWorkflow(workflow, input, context) {
   const logs = [];
-  const postLog = (level, message) => {
+  const postLog = (level, message, logContext) => {
     const timestamp = (/* @__PURE__ */ new Date()).toISOString();
-    const entry = { level, message, timestamp };
+    const entry = { level, message, timestamp, context: logContext };
     logs.push(entry);
     parentPort.postMessage({
       type: "log",
-      entry: { level, message, timestamp, executionId: context.executionId }
+      entry: { level, message, timestamp, executionId: context.executionId, context: logContext }
     });
   };
   const origLog = console.log;
@@ -5026,26 +5031,71 @@ async function executeWorkflow(workflow, input, context) {
       if (!step) {
         throw new Error(`Step '${stepId}' not found in workflow '${workflow.config.resourceId}'`);
       }
+      const stepStartTime = Date.now();
       const stepInput = step.inputSchema.parse(currentData);
-      const rawOutput = await step.handler(stepInput, {
-        executionId: context.executionId,
-        organizationId: context.organizationId,
-        organizationName: context.organizationName,
-        resourceId: workflow.config.resourceId,
-        sessionId: context.sessionId,
-        sessionTurnNumber: context.sessionTurnNumber,
-        parentExecutionId: context.parentExecutionId,
-        executionDepth: context.executionDepth,
-        store: /* @__PURE__ */ new Map(),
-        logger: {
-          debug: (msg) => console.log(`[debug] ${msg}`),
-          info: (msg) => console.log(`[info] ${msg}`),
-          warn: (msg) => console.warn(`[warn] ${msg}`),
-          error: (msg) => console.error(`[error] ${msg}`)
-        }
+      postLog("info", `Step '${step.name}' started`, {
+        type: "workflow",
+        contextType: "step-started",
+        stepId: step.id,
+        stepStatus: "started",
+        input: stepInput,
+        startTime: stepStartTime
       });
-      currentData = step.outputSchema.parse(rawOutput);
-      stepId = resolveNext(step.next, currentData);
+      try {
+        const rawOutput = await step.handler(stepInput, {
+          executionId: context.executionId,
+          organizationId: context.organizationId,
+          organizationName: context.organizationName,
+          resourceId: workflow.config.resourceId,
+          sessionId: context.sessionId,
+          sessionTurnNumber: context.sessionTurnNumber,
+          parentExecutionId: context.parentExecutionId,
+          executionDepth: context.executionDepth,
+          store: /* @__PURE__ */ new Map(),
+          logger: {
+            debug: (msg) => console.log(`[debug] ${msg}`),
+            info: (msg) => console.log(`[info] ${msg}`),
+            warn: (msg) => console.warn(`[warn] ${msg}`),
+            error: (msg) => console.error(`[error] ${msg}`)
+          }
+        });
+        currentData = step.outputSchema.parse(rawOutput);
+        const stepEndTime = Date.now();
+        const nextStepId = resolveNext(step.next, currentData);
+        postLog("info", `Step '${step.name}' completed (${stepEndTime - stepStartTime}ms)`, {
+          type: "workflow",
+          contextType: "step-completed",
+          stepId: step.id,
+          stepStatus: "completed",
+          output: currentData,
+          duration: stepEndTime - stepStartTime,
+          isTerminal: nextStepId === null,
+          startTime: stepStartTime,
+          endTime: stepEndTime
+        });
+        if (step.next?.type === "conditional" && nextStepId !== null) {
+          postLog("info", `Routing from '${step.name}' to '${nextStepId}'`, {
+            type: "workflow",
+            contextType: "conditional-route",
+            stepId: step.id,
+            target: nextStepId
+          });
+        }
+        stepId = nextStepId;
+      } catch (err) {
+        const stepEndTime = Date.now();
+        postLog("error", `Step '${step.name}' failed: ${String(err)}`, {
+          type: "workflow",
+          contextType: "step-failed",
+          stepId: step.id,
+          stepStatus: "failed",
+          error: String(err),
+          duration: stepEndTime - stepStartTime,
+          startTime: stepStartTime,
+          endTime: stepEndTime
+        });
+        throw err;
+      }
     }
     if (workflow.contract.outputSchema) {
       currentData = workflow.contract.outputSchema.parse(currentData);
@@ -5122,7 +5172,14 @@ function startWorker(org) {
           status: w.config.status,
           description: w.config.description,
           version: w.config.version,
-          domains: w.config.domains
+          domains: w.config.domains,
+          steps: Object.values(w.steps).map((step) => ({
+            id: step.id,
+            name: step.name,
+            description: step.description,
+            next: serializeNext(step.next)
+          })),
+          entryPoint: w.entryPoint
         })),
         agents: (org.agents ?? []).map((a) => ({
           resourceId: a.config.resourceId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/sdk",
-  "version": "0.5.11",
+  "version": "0.5.12",
   "description": "SDK for building Elevasis organization resources",
   "type": "module",
   "bin": {

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/getting-started/index.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.