@elevasis/sdk 0.4.8 → 0.4.9

package/dist/cli.cjs

@@ -43781,8 +43781,73 @@ async function apiPost(endpoint, body, apiUrl = resolveApiUrl()) {
   return response.json();
 }
 
+// package.json
+var package_default = {
+  name: "@elevasis/sdk",
+  version: "0.4.9",
+  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",
+  bin: {
+    elevasis: "./dist/cli.cjs",
+    "elevasis-sdk": "./dist/cli.cjs"
+  },
+  exports: {
+    ".": {
+      types: "./dist/index.d.ts",
+      import: "./dist/index.js"
+    },
+    "./worker": {
+      types: "./dist/types/worker/index.d.ts",
+      import: "./dist/worker/index.js"
+    },
+    "./templates": {
+      types: "./dist/types/templates.d.ts",
+      import: "./dist/templates.js"
+    }
+  },
+  files: [
+    "dist/index.js",
+    "dist/index.d.ts",
+    "dist/worker/index.js",
+    "dist/types/worker/index.d.ts",
+    "dist/types/worker/platform.d.ts",
+    "dist/cli.cjs",
+    "dist/templates.js",
+    "dist/types/templates.d.ts",
+    "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" && node scripts/copy-reference-docs.mjs && node scripts/generate-navigation.mjs`,
+    "check-types": "tsc --noEmit",
+    "test:bundle": "pnpm build && vitest run --config vitest.bundle.config.ts"
+  },
+  dependencies: {
+    esbuild: "^0.25.0",
+    jiti: "^2.0.0"
+  },
+  peerDependencies: {
+    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",
+    dotenv: "^16.0.0",
+    "gray-matter": "^4.0.3",
+    ora: "^7.0.1",
+    rollup: "^4.59.0",
+    "rollup-plugin-dts": "^6.3.0",
+    tsup: "^8.0.0",
+    typescript: "5.9.2",
+    zod: "^4.1.0"
+  }
+};
+
 // src/cli/version.ts
-var SDK_VERSION = "0.4.8";
+var SDK_VERSION = package_default.version;
 
 // src/cli/commands/deploy.ts
 var import_meta2 = {};
@@ -44433,7 +44498,7 @@ function registerDescribeCommand(program3) {
 // src/cli/commands/init.ts
 var import_path3 = require("path");
 var import_promises2 = require("fs/promises");
-var TEMPLATE_VERSION = 4;
+var TEMPLATE_VERSION = 5;
 var INIT_ONLY_FILES = [
   "package.json",
   "pnpm-workspace.yaml",
@@ -44442,7 +44507,11 @@ var INIT_ONLY_FILES = [
   ".env.example",
   ".npmrc",
   "src/index.ts",
-  "src/workflows/echo.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"
 ];
@@ -44484,7 +44553,9 @@ function registerInitCommand(program3) {
         throw new Error("Scaffold conflict");
       }
     }
-    await (0, import_promises2.mkdir)((0, import_path3.resolve)(targetDir, "src/workflows"), { recursive: true });
+    await (0, import_promises2.mkdir)((0, import_path3.resolve)(targetDir, "src/operations"), { recursive: true });
+    await (0, import_promises2.mkdir)((0, import_path3.resolve)(targetDir, "src/example"), { recursive: true });
+    await (0, import_promises2.mkdir)((0, import_path3.resolve)(targetDir, "src/shared"), { recursive: true });
     await (0, import_promises2.mkdir)((0, import_path3.resolve)(targetDir, "docs/in-progress"), { recursive: true });
     await (0, import_promises2.mkdir)((0, import_path3.resolve)(targetDir, ".claude/commands"), { recursive: true });
     const files = {
@@ -44497,7 +44568,11 @@ function registerInitCommand(program3) {
       ".npmrc": npmrcTemplate(),
       ".gitignore": gitignoreTemplate(),
       "src/index.ts": starterTemplate(),
-      "src/workflows/echo.ts": starterWorkflowTemplate(),
+      "src/operations/platform-status.ts": platformStatusTemplate(),
+      "src/operations/index.ts": operationsBarrelTemplate(),
+      "src/example/echo.ts": starterWorkflowTemplate(),
+      "src/example/index.ts": exampleBarrelTemplate(),
+      "src/shared/.gitkeep": "",
       "docs/index.mdx": docsIndexTemplate(orgSlug),
       "docs/in-progress/.gitkeep": "",
       "CLAUDE.md": claudeMdTemplate(),
@@ -44638,17 +44713,31 @@ elevasis executions <resourceId>      # View execution history
 ## Project Structure
 
 - \`elevasis.config.ts\` -- Workspace config (optional settings)
-- \`src/index.ts\` -- Resource registry (imports and exports all workflows)
-- \`src/workflows/\` -- Workflow definitions (one per file)
+- \`src/index.ts\` -- Resource registry (aggregates from domain barrels)
+- \`src/operations/\` -- Operations domain (platform-status workflow)
+- \`src/example/\` -- Example domain (echo workflow -- replace with your own)
+- \`src/shared/\` -- Cross-domain shared types and utilities
 - \`docs/\` -- Documentation (.mdx files, deployed alongside code)
 - \`.env\` -- API key for CLI authentication
 
 ## Resources
 
-### Echo Workflow
+### Platform Status Workflow (\`src/operations/\`)
+
+A multi-step workflow that queries platform status and compiles a natural language
+summary using an LLM. Demonstrates real platform API usage with \`platform.call()\`.
 
-A simple workflow that echoes the input message back. Use it to verify your
-deployment is working:
+\`\`\`bash
+elevasis exec platform-status --input '{"timeRange": "24h"}'
+\`\`\`
+
+**Input:** \`{ "timeRange": "1h" | "24h" | "7d" }\`
+**Output:** \`{ "raw": object, "summary": string }\`
+
+### Echo Workflow (\`src/example/\`)
+
+A simple workflow that echoes the input message back. Use it as a starter pattern
+for new workflows:
 
 \`\`\`bash
 elevasis exec echo --input '{"message": "hello"}'
@@ -44720,6 +44809,9 @@ All \`reference/\` paths resolve to \`node_modules/@elevasis/sdk/reference/\`.
 ## Rules
 
 - All resource definitions must be in \`src/\` and exported via \`src/index.ts\`
+- Organize resources by business domain (e.g., src/operations/, src/acquisition/)
+- Each domain exports \`workflows\` and \`agents\` arrays via an index.ts barrel
+- src/shared/ is for cross-domain utilities; domain-specific shared code goes in <domain>/shared/
 - The default export must be an \`OrganizationResources\` object
 - Do not import from \`@repo/core\` -- use \`@elevasis/sdk\` types only
 - \`StepType\`, \`ExecutionError\`, \`ToolingError\` are runtime imports from \`'@elevasis/sdk'\`
@@ -44812,7 +44904,7 @@ You are a documentation assistant for this Elevasis workspace.
 ## Context
 
 Read the project's CLAUDE.md and all files in docs/ to understand the project.
-Read src/index.ts and src/workflows/ to understand the resource definitions.
+Read src/index.ts and the domain directories (src/operations/, src/example/, etc.) to understand the resource definitions.
 
 ## Operations
 
@@ -44855,7 +44947,7 @@ You are a resource scaffolding assistant for this Elevasis workspace.
 ## Context
 
 Read CLAUDE.md for navigation to SDK patterns (reference/resources/patterns.mdx).
-Read src/index.ts for the registry and src/workflows/ for existing resources.
+Read src/index.ts for the registry and domain directories for existing resources.
 
 Before suggesting tools, read \`.claude/memory/profile/identity.md\` if it exists
 to check the user's known integrations and suggest relevant platform tools.
@@ -44877,7 +44969,7 @@ cannot specify schemas directly.
 
 ## Operations
 
-**\`workflow <name>\`:** Create a new workflow in \`src/workflows/<name>.ts\` with:
+**\`workflow <name>\`:** Create a new workflow in the appropriate domain directory (e.g., \`src/<domain>/<name>.ts\`) with:
 - Zod input/output schemas with \`z.infer\` type aliases
 - Config object (resourceId, name, type, description, version, status)
 - Contract with schemas
@@ -44930,8 +45022,9 @@ Each lesson follows this flow:
 ## Lessons
 
 **Lesson 1: Welcome & Orientation**
-Tour project files: src/index.ts (registry), src/workflows/echo.ts (starter
-workflow), elevasis.config.ts, .env, docs/. Explain the execution model.
+Tour project files: src/index.ts (registry), src/example/echo.ts (starter
+workflow), src/operations/platform-status.ts (platform API example),
+elevasis.config.ts, .env, docs/. Explain the execution model.
 Verify: run \`elevasis resources\`. Observation focus: cloud deployment model.
 
 **Lesson 2: Your First Custom Workflow**
@@ -45066,7 +45159,7 @@ Read \`.claude/memory/profile/skills.md\` to adapt generated code to skill level
 
 **\`/templates apply <name>\`:** Generate a workflow from the template:
 1. Read the template definition from reference/templates/<name>.mdx
-2. Generate a workflow file in src/workflows/<name>.ts
+2. Generate a workflow file in the appropriate domain directory
 3. Add the import to src/index.ts registry
 4. If the template uses platform tools, prompt for credential setup
 5. If the template uses the database, check that /database init has been run
@@ -45356,10 +45449,18 @@ The agent reads current templates from the installed SDK:
 }
 function starterTemplate() {
   return `import type { OrganizationResources } from '@elevasis/sdk'
-import { echo } from './workflows/echo.js'
+import * as operations from './operations/index.js'
+import * as example from './example/index.js'
 
 const org: OrganizationResources = {
-  workflows: [echo],
+  workflows: [
+    ...operations.workflows,
+    ...example.workflows,
+  ],
+  agents: [
+    ...operations.agents,
+    ...example.agents,
+  ],
 }
 export default org
 `;
@@ -45403,6 +45504,115 @@ export const echo: WorkflowDefinition = {
 }
 `;
 }
+function platformStatusTemplate() {
+  return `import type { WorkflowDefinition } from '@elevasis/sdk'
+import { StepType } from '@elevasis/sdk'
+import { platform } from '@elevasis/sdk/worker'
+import { z } from 'zod'
+
+const input = z.object({
+  timeRange: z.enum(['1h', '24h', '7d']).default('24h').describe('Time window for status data'),
+})
+
+const statusData = z.object({
+  raw: z.unknown().describe('Raw status overview from platform'),
+})
+
+const output = z.object({
+  raw: z.unknown().describe('Raw status overview from platform'),
+  summary: z.string().describe('Natural language status summary'),
+})
+
+type Input = z.infer<typeof input>
+
+export const platformStatus: WorkflowDefinition = {
+  config: {
+    resourceId: 'platform-status',
+    name: 'Platform Status',
+    type: 'workflow',
+    description: 'Gathers cross-system platform status and compiles a natural language summary',
+    version: '1.0.0',
+    status: 'dev',
+  },
+  contract: { inputSchema: input, outputSchema: output },
+  steps: {
+    'gather-status': {
+      id: 'gather-status',
+      name: 'Gather Status',
+      description: 'Queries platform status overview (executions, pending items, schedules, credentials)',
+      handler: async (rawInput) => {
+        const { timeRange } = rawInput as Input
+        const raw = await platform.call({
+          tool: 'status',
+          method: 'overview',
+          params: { timeRange },
+        })
+        return { raw }
+      },
+      inputSchema: input,
+      outputSchema: statusData,
+      next: { type: StepType.LINEAR, target: 'compile-report' },
+    },
+    'compile-report': {
+      id: 'compile-report',
+      name: 'Compile Report',
+      description: 'Generates a natural language summary from raw status data',
+      handler: async (rawInput) => {
+        const { raw } = rawInput as z.infer<typeof statusData>
+        const result = await platform.call({
+          tool: 'llm',
+          method: 'generate',
+          params: {
+            provider: 'google',
+            model: 'gemini-3-flash-preview',
+            messages: [
+              {
+                role: 'user',
+                content: [
+                  'Summarize this platform status overview in 3-5 concise bullet points.',
+                  'Focus on: execution health, pending items needing attention, upcoming schedules, and credential coverage.',
+                  'Be specific with numbers. Flag any issues.',
+                  '',
+                  JSON.stringify(raw, null, 2),
+                ].join('\\n'),
+              },
+            ],
+            responseSchema: {
+              type: 'object',
+              properties: {
+                summary: { type: 'string', description: 'Natural language status summary with bullet points' },
+              },
+              required: ['summary'],
+            },
+            temperature: 0,
+          },
+        })
+        const summary = (result as any)?.summary ?? String(result)
+        return { raw, summary }
+      },
+      inputSchema: statusData,
+      outputSchema: output,
+      next: null,
+    },
+  },
+  entryPoint: 'gather-status',
+}
+`;
+}
+function operationsBarrelTemplate() {
+  return `import { platformStatus } from './platform-status.js'
+
+export const workflows = [platformStatus]
+export const agents = []
+`;
+}
+function exampleBarrelTemplate() {
+  return `import { echo } from './echo.js'
+
+export const workflows = [echo]
+export const agents = []
+`;
+}
 
 // src/cli/commands/update.ts
 var import_path4 = require("path");

package/dist/index.d.ts

@@ -2015,4 +2015,4 @@ declare class ToolingError extends ExecutionError {
 }
 
 export { ExecutionError, RegistryValidationError, ResourceRegistry, StepType, ToolingError };
-export type { AgentConfig, AgentConstraints, AgentDefinition, ConditionalNext, Contract, DomainDefinition, ElevasConfig, EventTriggerConfig, ExecutionContext, ExecutionInterface, ExecutionMetadata, FormField, FormFieldType, FormSchema, IntegrationDefinition, LLMAdapterFactory, LLMModel, LinearNext, ModelConfig, NextConfig, OrganizationResources, ResourceDefinition, ResourceDomain, ResourceMetricsConfig, ResourceStatus, ResourceType, ScheduleTriggerConfig, StepHandler, Tool, ToolExecutionOptions, ToolingErrorType, TriggerConfig, TriggerDefinition, WebhookProviderType, WebhookTriggerConfig, WorkflowConfig, WorkflowDefinition, WorkflowStep };
+export type { AgentConfig, AgentConstraints, AgentDefinition, AgentMemory, ConditionalNext, Contract, DomainDefinition, ElevasConfig, EventTriggerConfig, ExecutionContext, ExecutionInterface, ExecutionMetadata, FormField, FormFieldType, FormSchema, IntegrationDefinition, LLMAdapterFactory, LLMModel, LinearNext, ModelConfig, NextConfig, OrganizationResources, ResourceDefinition, ResourceDomain, ResourceMetricsConfig, ResourceStatus, ResourceType, ScheduleTriggerConfig, StepHandler, Tool, ToolExecutionOptions, ToolingErrorType, TriggerConfig, TriggerDefinition, WebhookProviderType, WebhookTriggerConfig, WorkflowConfig, WorkflowDefinition, WorkflowStep };

package/dist/templates.js

@@ -1,4 +1,4 @@
-// src/cli/commands/init.ts
+// package.json
 function gitignoreTemplate() {
   return `node_modules/
 .env
@@ -70,6 +70,9 @@ All \`reference/\` paths resolve to \`node_modules/@elevasis/sdk/reference/\`.
 ## Rules
 
 - All resource definitions must be in \`src/\` and exported via \`src/index.ts\`
+- Organize resources by business domain (e.g., src/operations/, src/acquisition/)
+- Each domain exports \`workflows\` and \`agents\` arrays via an index.ts barrel
+- src/shared/ is for cross-domain utilities; domain-specific shared code goes in <domain>/shared/
 - The default export must be an \`OrganizationResources\` object
 - Do not import from \`@repo/core\` -- use \`@elevasis/sdk\` types only
 - \`StepType\`, \`ExecutionError\`, \`ToolingError\` are runtime imports from \`'@elevasis/sdk'\`
@@ -162,7 +165,7 @@ You are a documentation assistant for this Elevasis workspace.
 ## Context
 
 Read the project's CLAUDE.md and all files in docs/ to understand the project.
-Read src/index.ts and src/workflows/ to understand the resource definitions.
+Read src/index.ts and the domain directories (src/operations/, src/example/, etc.) to understand the resource definitions.
 
 ## Operations
 
@@ -205,7 +208,7 @@ You are a resource scaffolding assistant for this Elevasis workspace.
 ## Context
 
 Read CLAUDE.md for navigation to SDK patterns (reference/resources/patterns.mdx).
-Read src/index.ts for the registry and src/workflows/ for existing resources.
+Read src/index.ts for the registry and domain directories for existing resources.
 
 Before suggesting tools, read \`.claude/memory/profile/identity.md\` if it exists
 to check the user's known integrations and suggest relevant platform tools.
@@ -227,7 +230,7 @@ cannot specify schemas directly.
 
 ## Operations
 
-**\`workflow <name>\`:** Create a new workflow in \`src/workflows/<name>.ts\` with:
+**\`workflow <name>\`:** Create a new workflow in the appropriate domain directory (e.g., \`src/<domain>/<name>.ts\`) with:
 - Zod input/output schemas with \`z.infer\` type aliases
 - Config object (resourceId, name, type, description, version, status)
 - Contract with schemas
@@ -280,8 +283,9 @@ Each lesson follows this flow:
 ## Lessons
 
 **Lesson 1: Welcome & Orientation**
-Tour project files: src/index.ts (registry), src/workflows/echo.ts (starter
-workflow), elevasis.config.ts, .env, docs/. Explain the execution model.
+Tour project files: src/index.ts (registry), src/example/echo.ts (starter
+workflow), src/operations/platform-status.ts (platform API example),
+elevasis.config.ts, .env, docs/. Explain the execution model.
 Verify: run \`elevasis resources\`. Observation focus: cloud deployment model.
 
 **Lesson 2: Your First Custom Workflow**
@@ -416,7 +420,7 @@ Read \`.claude/memory/profile/skills.md\` to adapt generated code to skill level
 
 **\`/templates apply <name>\`:** Generate a workflow from the template:
 1. Read the template definition from reference/templates/<name>.mdx
-2. Generate a workflow file in src/workflows/<name>.ts
+2. Generate a workflow file in the appropriate domain directory
 3. Add the import to src/index.ts registry
 4. If the template uses platform tools, prompt for credential setup
 5. If the template uses the database, check that /database init has been run
@@ -743,5 +747,114 @@ export const echo: WorkflowDefinition = {
 }
 `;
 }
+function platformStatusTemplate() {
+  return `import type { WorkflowDefinition } from '@elevasis/sdk'
+import { StepType } from '@elevasis/sdk'
+import { platform } from '@elevasis/sdk/worker'
+import { z } from 'zod'
+
+const input = z.object({
+  timeRange: z.enum(['1h', '24h', '7d']).default('24h').describe('Time window for status data'),
+})
+
+const statusData = z.object({
+  raw: z.unknown().describe('Raw status overview from platform'),
+})
+
+const output = z.object({
+  raw: z.unknown().describe('Raw status overview from platform'),
+  summary: z.string().describe('Natural language status summary'),
+})
+
+type Input = z.infer<typeof input>
+
+export const platformStatus: WorkflowDefinition = {
+  config: {
+    resourceId: 'platform-status',
+    name: 'Platform Status',
+    type: 'workflow',
+    description: 'Gathers cross-system platform status and compiles a natural language summary',
+    version: '1.0.0',
+    status: 'dev',
+  },
+  contract: { inputSchema: input, outputSchema: output },
+  steps: {
+    'gather-status': {
+      id: 'gather-status',
+      name: 'Gather Status',
+      description: 'Queries platform status overview (executions, pending items, schedules, credentials)',
+      handler: async (rawInput) => {
+        const { timeRange } = rawInput as Input
+        const raw = await platform.call({
+          tool: 'status',
+          method: 'overview',
+          params: { timeRange },
+        })
+        return { raw }
+      },
+      inputSchema: input,
+      outputSchema: statusData,
+      next: { type: StepType.LINEAR, target: 'compile-report' },
+    },
+    'compile-report': {
+      id: 'compile-report',
+      name: 'Compile Report',
+      description: 'Generates a natural language summary from raw status data',
+      handler: async (rawInput) => {
+        const { raw } = rawInput as z.infer<typeof statusData>
+        const result = await platform.call({
+          tool: 'llm',
+          method: 'generate',
+          params: {
+            provider: 'google',
+            model: 'gemini-3-flash-preview',
+            messages: [
+              {
+                role: 'user',
+                content: [
+                  'Summarize this platform status overview in 3-5 concise bullet points.',
+                  'Focus on: execution health, pending items needing attention, upcoming schedules, and credential coverage.',
+                  'Be specific with numbers. Flag any issues.',
+                  '',
+                  JSON.stringify(raw, null, 2),
+                ].join('\\n'),
+              },
+            ],
+            responseSchema: {
+              type: 'object',
+              properties: {
+                summary: { type: 'string', description: 'Natural language status summary with bullet points' },
+              },
+              required: ['summary'],
+            },
+            temperature: 0,
+          },
+        })
+        const summary = (result as any)?.summary ?? String(result)
+        return { raw, summary }
+      },
+      inputSchema: statusData,
+      outputSchema: output,
+      next: null,
+    },
+  },
+  entryPoint: 'gather-status',
+}
+`;
+}
+function operationsBarrelTemplate() {
+  return `import { platformStatus } from './platform-status.js'
+
+export const workflows = [platformStatus]
+export const agents = []
+`;
+}
+function exampleBarrelTemplate() {
+  return `import { echo } from './echo.js'
+
+export const workflows = [echo]
+export const agents = []
+`;
+}
 
-export { claudeAgentCommandTemplate, claudeDatabaseCommandTemplate, claudeDocsCommandTemplate, claudeHelpCommandTemplate, claudeMdTemplate, claudeMetaCommandTemplate, claudeProfileCommandTemplate, claudeResourceCommandTemplate, claudeSettingsTemplate, claudeTemplatesCommandTemplate, claudeTutorialCommandTemplate, gitignoreTemplate, starterWorkflowTemplate };
+export { claudeAgentCommandTemplate, claudeDatabaseCommandTemplate, claudeDocsCommandTemplate, claudeHelpCommandTemplate, claudeMdTemplate, claudeMetaCommandTemplate, claudeProfileCommandTemplate, claudeResourceCommandTemplate, claudeSettingsTemplate, claudeTemplatesCommandTemplate, claudeTutorialCommandTemplate, exampleBarrelTemplate, gitignoreTemplate, operationsBarrelTemplate, platformStatusTemplate, starterWorkflowTemplate };

package/dist/types/templates.d.ts

@@ -1 +1 @@
-export { claudeMdTemplate, claudeMetaCommandTemplate, claudeProfileCommandTemplate, claudeDocsCommandTemplate, claudeResourceCommandTemplate, claudeTutorialCommandTemplate, claudeHelpCommandTemplate, claudeTemplatesCommandTemplate, claudeDatabaseCommandTemplate, claudeAgentCommandTemplate, gitignoreTemplate, claudeSettingsTemplate, starterWorkflowTemplate, } from './cli/commands/init.js';
+export { claudeMdTemplate, claudeMetaCommandTemplate, claudeProfileCommandTemplate, claudeDocsCommandTemplate, claudeResourceCommandTemplate, claudeTutorialCommandTemplate, claudeHelpCommandTemplate, claudeTemplatesCommandTemplate, claudeDatabaseCommandTemplate, claudeAgentCommandTemplate, gitignoreTemplate, claudeSettingsTemplate, starterWorkflowTemplate, platformStatusTemplate, operationsBarrelTemplate, exampleBarrelTemplate, } from './cli/commands/init.js';

package/dist/types/worker/index.d.ts

@@ -8,8 +8,13 @@
  *   Parent -> Worker:  { type: 'manifest' }
  *   Worker -> Parent:  { type: 'manifest', workflows: [...], agents: [...] }
  *
- *   Parent -> Worker:  { type: 'execute', resourceId, executionId, input, organizationId?, organizationName? }
- *   Worker -> Parent:  { type: 'result', status, output?, error?, logs }
+ *   Parent -> Worker:  { type: 'execute', resourceId, executionId, input, organizationId?, organizationName?,
+ *                         sessionId?, sessionTurnNumber?, parentExecutionId?, executionDepth }
+ *   Worker -> Parent:  { type: 'result', status, output?, error?, logs, metrics: { durationMs } }
+ *
+ *   Parent -> Worker:  { type: 'abort' }                               (graceful abort before terminate)
+ *
+ *   Worker -> Parent:  { type: 'log', entry: { level, message, timestamp, executionId } }
  *
  *   Worker -> Parent:  { type: 'tool-call', id, tool, method, params, credential? }
  *   Parent -> Worker:  { type: 'tool-result', id, result?, error?, code? }

package/dist/worker/index.js

@@ -4755,11 +4755,20 @@ function resolveNext(next, data) {
 }
 async function executeWorkflow(workflow, input, context) {
   const logs = [];
+  const postLog = (level, message) => {
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    const entry = { level, message, timestamp };
+    logs.push(entry);
+    parentPort.postMessage({
+      type: "log",
+      entry: { level, message, timestamp, executionId: context.executionId }
+    });
+  };
   const origLog = console.log;
   const origWarn = console.warn;
   const origError = console.error;
   const capture = (level, orig) => (...args) => {
-    logs.push({ level, message: args.map(String).join(" ") });
+    postLog(level, args.map(String).join(" "));
     orig(...args);
   };
   console.log = capture("info", origLog);
@@ -4779,7 +4788,10 @@ async function executeWorkflow(workflow, input, context) {
         organizationId: context.organizationId,
         organizationName: context.organizationName,
         resourceId: workflow.config.resourceId,
-        executionDepth: 0,
+        sessionId: context.sessionId,
+        sessionTurnNumber: context.sessionTurnNumber,
+        parentExecutionId: context.parentExecutionId,
+        executionDepth: context.executionDepth,
         store: /* @__PURE__ */ new Map(),
         logger: {
           debug: (msg) => console.log(`[debug] ${msg}`),
@@ -4801,20 +4813,41 @@ async function executeWorkflow(workflow, input, context) {
     console.error = origError;
   }
 }
-function buildWorkerExecutionContext(executionId, organizationId, organizationName, resourceId) {
+function buildWorkerExecutionContext(params) {
+  const { executionId } = params;
+  const postLog = (level, message) => {
+    parentPort.postMessage({
+      type: "log",
+      entry: { level, message, timestamp: (/* @__PURE__ */ new Date()).toISOString(), executionId }
+    });
+  };
   return {
-    executionId,
-    organizationId,
-    organizationName,
-    resourceId,
-    executionDepth: 0,
+    executionId: params.executionId,
+    organizationId: params.organizationId,
+    organizationName: params.organizationName,
+    resourceId: params.resourceId,
+    sessionId: params.sessionId,
+    sessionTurnNumber: params.sessionTurnNumber,
+    parentExecutionId: params.parentExecutionId,
+    executionDepth: params.executionDepth,
+    signal: params.signal,
     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}`),
-      log: () => {
+      debug: (msg) => {
+        console.log(`[debug] ${msg}`);
+        postLog("info", msg);
+      },
+      info: (msg) => {
+        console.log(`[info] ${msg}`);
+        postLog("info", msg);
+      },
+      warn: (msg) => {
+        console.warn(`[warn] ${msg}`);
+        postLog("warn", msg);
+      },
+      error: (msg) => {
+        console.error(`[error] ${msg}`);
+        postLog("error", msg);
       }
     },
     onMessageEvent: async (event) => {
@@ -4829,6 +4862,7 @@ function startWorker(org) {
   const agents = new Map(
     (org.agents ?? []).map((a) => [a.config.resourceId, a])
   );
+  let localAbortController = new AbortController();
   console.log(`[SDK-WORKER] Worker started with ${workflows.size} workflow(s), ${agents.size} agent(s)`);
   parentPort.on("message", async (msg) => {
     if (msg.type === "manifest") {
@@ -4864,24 +4898,46 @@ function startWorker(org) {
       handleCredentialResult(msg);
       return;
     }
+    if (msg.type === "abort") {
+      console.log("[SDK-WORKER] Abort requested by parent");
+      localAbortController.abort();
+      return;
+    }
     if (msg.type === "execute") {
-      const { resourceId, executionId, input, organizationId, organizationName } = msg;
+      const {
+        resourceId,
+        executionId,
+        input,
+        organizationId,
+        organizationName,
+        sessionId,
+        sessionTurnNumber,
+        parentExecutionId,
+        executionDepth
+      } = msg;
       console.log(`[SDK-WORKER] Execute request: resourceId=${resourceId}, executionId=${executionId}`);
+      localAbortController = new AbortController();
       const workflow = workflows.get(resourceId);
       if (workflow) {
+        const startTime = Date.now();
         try {
           console.log(`[SDK-WORKER] Running workflow '${resourceId}' (${Object.keys(workflow.steps).length} steps)`);
-          const startTime = Date.now();
           const { output, logs } = await executeWorkflow(workflow, input, {
             executionId,
             organizationId: organizationId ?? "",
-            organizationName: organizationName ?? ""
+            organizationName: organizationName ?? "",
+            sessionId,
+            sessionTurnNumber,
+            parentExecutionId,
+            executionDepth: executionDepth ?? 0
           });
-          console.log(`[SDK-WORKER] Workflow '${resourceId}' completed (${Date.now() - startTime}ms)`);
-          parentPort.postMessage({ type: "result", status: "completed", output, logs });
+          const durationMs = Date.now() - startTime;
+          console.log(`[SDK-WORKER] Workflow '${resourceId}' completed (${durationMs}ms)`);
+          parentPort.postMessage({ type: "result", status: "completed", output, logs, metrics: { durationMs } });
         } catch (err) {
-          console.error(`[SDK-WORKER] Workflow '${resourceId}' failed: ${String(err)}`);
-          parentPort.postMessage({ type: "result", status: "failed", error: String(err), logs: [] });
+          const durationMs = Date.now() - startTime;
+          console.error(`[SDK-WORKER] Workflow '${resourceId}' failed (${durationMs}ms): ${String(err)}`);
+          parentPort.postMessage({ type: "result", status: "failed", error: String(err), logs: [], metrics: { durationMs } });
         }
         return;
       }
@@ -4891,32 +4947,54 @@ function startWorker(org) {
         const origLog = console.log;
         const origWarn = console.warn;
         const origError = console.error;
+        const postLog = (level, message) => {
+          const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+          const entry = { level, message, timestamp };
+          logs.push(entry);
+          parentPort.postMessage({
+            type: "log",
+            entry: { level, message, timestamp, executionId }
+          });
+        };
         const capture = (level, orig) => (...args) => {
-          logs.push({ level, message: args.map(String).join(" ") });
+          postLog(level, args.map(String).join(" "));
           orig(...args);
         };
         console.log = capture("info", origLog);
         console.warn = capture("warn", origWarn);
         console.error = capture("error", origError);
+        const startTime = Date.now();
         try {
           console.log(`[SDK-WORKER] Running agent '${resourceId}' (${agentDef.tools.length} tools)`);
-          const startTime = Date.now();
           const adapterFactory = createPostMessageAdapterFactory();
           const agentInstance = new Agent(agentDef, adapterFactory);
-          const context = buildWorkerExecutionContext(executionId, organizationId ?? "", organizationName ?? "", resourceId);
+          const context = buildWorkerExecutionContext({
+            executionId,
+            organizationId: organizationId ?? "",
+            organizationName: organizationName ?? "",
+            resourceId,
+            sessionId,
+            sessionTurnNumber,
+            parentExecutionId,
+            executionDepth: executionDepth ?? 0,
+            signal: localAbortController.signal
+          });
           const output = await agentInstance.execute(input, context);
-          console.log(`[SDK-WORKER] Agent '${resourceId}' completed (${Date.now() - startTime}ms)`);
-          parentPort.postMessage({ type: "result", status: "completed", output, logs });
+          const durationMs = Date.now() - startTime;
+          console.log(`[SDK-WORKER] Agent '${resourceId}' completed (${durationMs}ms)`);
+          parentPort.postMessage({ type: "result", status: "completed", output, logs, metrics: { durationMs } });
         } catch (err) {
+          const durationMs = Date.now() - startTime;
           const errorMessage = err?.message ?? String(err);
           err?.code ?? "unknown";
           const errorName = err?.name ?? err?.constructor?.name ?? "Error";
-          console.error(`[SDK-WORKER] Agent '${resourceId}' failed: [${errorName}] ${errorMessage}`);
+          console.error(`[SDK-WORKER] Agent '${resourceId}' failed (${durationMs}ms): [${errorName}] ${errorMessage}`);
           parentPort.postMessage({
             type: "result",
             status: "failed",
             error: `${errorName}: ${errorMessage}`,
-            logs
+            logs,
+            metrics: { durationMs }
           });
         } finally {
           console.log = origLog;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/sdk",
-  "version": "0.4.8",
+  "version": "0.4.9",
   "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",
@@ -33,11 +33,6 @@
     "dist/types/templates.d.ts",
     "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\" && node scripts/copy-reference-docs.mjs && node scripts/generate-navigation.mjs",
-    "check-types": "tsc --noEmit",
-    "test:bundle": "pnpm build && vitest run --config vitest.bundle.config.ts"
-  },
   "dependencies": {
     "esbuild": "^0.25.0",
     "jiti": "^2.0.0"
@@ -46,8 +41,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",
@@ -58,6 +51,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 && node scripts/generate-navigation.mjs",
+    "check-types": "tsc --noEmit",
+    "test:bundle": "pnpm build && vitest run --config vitest.bundle.config.ts"
   }
-}
+}

package/reference/framework/index.mdx

@@ -92,4 +92,4 @@ The Growth Log in `memory/profile/skills.md` keeps approximately 20 recent entri
 
 ---
 
-**Last Updated:** 2026-02-25
+**Last Updated:** 2026-02-27

package/reference/framework/project-structure.mdx

@@ -12,23 +12,39 @@ loadWhen: "Understanding scaffolded files or project layout"
 
 ### `src/index.ts`
 
-The registry entry point for your workspace. This file imports and re-exports all resources from `src/workflows/` as an `OrganizationResources` default export. It does not contain workflow logic itself -- its sole job is aggregation:
+The registry entry point for your workspace. This file aggregates resources from domain barrel files and re-exports them as an `OrganizationResources` default export. It does not contain workflow logic itself -- its sole job is aggregation:
 
 ```ts
 import type { OrganizationResources } from '@elevasis/sdk'
-import { echo } from './workflows/echo.js'
+import * as operations from './operations/index.js'
+import * as example from './example/index.js'
 
 const org: OrganizationResources = {
-  workflows: [echo],
+  workflows: [
+    ...operations.workflows,
+    ...example.workflows,
+  ],
+  agents: [
+    ...operations.agents,
+    ...example.agents,
+  ],
 }
 export default org
 ```
 
-Every resource you add is wired into this file. The `/resource workflow` command updates it automatically.
+Each domain directory exports `workflows` and `agents` arrays via an `index.ts` barrel. When you add a new domain, import it here and spread its arrays. The `/resource workflow` command updates the appropriate domain barrel automatically.
 
-### `src/workflows/echo.ts`
+### `src/operations/platform-status.ts`
 
-The starter workflow, scaffolded to demonstrate the per-file pattern: one workflow per file with its own Zod input/output schemas, config object, contract, and step handler. When you add new workflows, each one gets its own file in `src/workflows/` and is imported into `src/index.ts`.
+A multi-step workflow demonstrating real platform API usage. Calls `platform.call({ tool: 'status', method: 'overview' })` to gather platform status data, then passes it to `platform.call({ tool: 'llm', method: 'generate' })` for a natural language summary. Shows the pattern for workflows that interact with platform tools and chain steps with `StepType.LINEAR`.
+
+### `src/example/echo.ts`
+
+The starter workflow, scaffolded to demonstrate the per-file pattern: one workflow per file with its own Zod input/output schemas, config object, contract, and step handler. Replace this domain with your own when you're ready.
+
+### `src/shared/`
+
+Cross-domain shared types and utilities. This directory starts empty (`.gitkeep`). Place code here when two or more domains share the same utility -- for example, formatters, shared types, or notification helpers. Domain-specific shared code goes in `<domain>/shared/` instead.
 
 ### `elevasis.config.ts`
 
@@ -38,7 +54,7 @@ Project-level configuration. The scaffolded file includes `templateVersion`, whi
 import type { ElevasConfig } from '@elevasis/sdk'
 
 export default {
-  templateVersion: 4,
+  templateVersion: 5,
   // defaultStatus: 'dev',     // Default status for new resources ('dev' | 'production')
   // dev: { port: 5170 },      // Local API port (internal development only)
 } satisfies ElevasConfig
@@ -92,7 +108,9 @@ Only `src/` and `docs/` are scaffolded by `elevasis init`. The following directo
 
 | Directory | Created by | When |
 |-----------|-----------|------|
-| `src/workflows/` | `elevasis init` (default) | Always -- starter workflow `echo.ts` lives here |
+| `src/operations/` | `elevasis init` (default) | Always -- platform-status workflow lives here |
+| `src/example/` | `elevasis init` (default) | Always -- echo starter workflow lives here (replace with your own) |
+| `src/shared/` | `elevasis init` (default) | Always -- cross-domain shared utilities (starts empty) |
 | `docs/` | `elevasis init` (default) | Always |
 | `docs/in-progress/` | Agent (on first `/docs checkpoint`) | When you save work-in-progress across sessions |
 | `docs/navigation.mdx` | Agent (on first `/meta deploy`) | Auto-generated and updated on each deploy |
@@ -105,7 +123,7 @@ This structure keeps the initial workspace minimal and adds directories only whe
 
 ### `src/lib/`
 
-Shared TypeScript utilities, types, and helpers used by multiple workflows. The agent creates this directory when you have code shared between two or more workflow files -- for example, retry logic, formatters, or shared types. Included in the esbuild bundle alongside workflow code. Not scaffolded by default to avoid premature abstraction.
+Legacy shared code directory. In v5+ projects, use `src/shared/` for cross-domain utilities instead. The agent may still create `src/lib/` in older projects that predate the domain-based organization. Included in the esbuild bundle alongside workflow code.
 
 ### `data/`
 
@@ -250,7 +268,7 @@ Applies pre-built workflow templates to your workspace. Three operations:
 
 - **No arguments** -- List available template categories (Data Collection, Data Processing, Communication, CRM, Documents, AI, Scheduling)
 - **`<category>`** -- Show templates in a category with descriptions
-- **`apply <name>`** -- Generate a workflow from a template: writes to `src/workflows/`, wires into `src/index.ts`, prompts for credential setup if needed, and runs `elevasis check` to validate
+- **`apply <name>`** -- Generate a workflow from a template: writes to the appropriate domain directory, wires into the domain barrel, prompts for credential setup if needed, and runs `elevasis check` to validate
 
 Templates are documentation files bundled with the SDK, not rigid copy-paste code. The agent reads the template and generates a workflow adapted to your existing schemas, credentials, and naming conventions.
 
@@ -260,12 +278,13 @@ Templates are documentation files bundled with the SDK, not rigid copy-paste cod
 
 Not all scaffolded files participate in template updates. Files fall into two categories:
 
-**SCAFFOLD_FILES total: 23**
+**SCAFFOLD_FILES total: 27**
 
-**INIT_ONLY** (10 files) -- Written once during `elevasis init`, never updated by `elevasis update`:
+**INIT_ONLY** (14 files) -- Written once during `elevasis init`, never updated by `elevasis update`:
 - `package.json`, `pnpm-workspace.yaml`, `tsconfig.json`
 - `.env`, `.env.example`, `.npmrc`
-- `src/index.ts`, `src/workflows/echo.ts`, `docs/index.mdx`, `.claude/settings.json`
+- `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`
 
 **MANAGED** (13 files) -- Written during `elevasis init` and checked/updatable by `elevasis update`:
 - `elevasis.config.ts`, `.gitignore`, `CLAUDE.md`, `docs/navigation.mdx`
@@ -280,7 +299,7 @@ Run `elevasis update` after installing a new SDK version to bring managed files
 | File | When You Edit It |
 |------|-----------------|
 | `src/index.ts` | Adding or removing resources (the `/resource` command does this automatically) |
-| `src/workflows/*.ts` | Writing and modifying workflow logic |
+| `src/<domain>/*.ts` | Writing and modifying workflow logic (organized by business domain) |
 | `docs/index.mdx` | Updating project documentation |
 | `docs/navigation.mdx` | Never -- auto-generated by `/meta deploy` |
 | `docs/priorities.mdx` | When goals or priorities change |
@@ -291,4 +310,4 @@ Run `elevasis update` after installing a new SDK version to bring managed files
 
 ---
 
-**Last Updated:** 2026-02-26
+**Last Updated:** 2026-02-27

package/reference/getting-started/index.mdx

@@ -29,7 +29,7 @@ elevasis init my-project
 cd my-project
 ```
 
-The command scaffolds 23 files covering configuration, source, documentation, and Claude Code integration:
+The command scaffolds 27 files covering configuration, source, documentation, and Claude Code integration:
 
 ```
 my-project/
@@ -47,9 +47,15 @@ my-project/
 │       ├── tutorial.md             # Progressive learning
 │       └── profile.md              # View and update user profile
 ├── src/
-│   ├── index.ts                    # Registry entry point
-│   └── workflows/
-│       └── echo.ts                 # Starter workflow
+│   ├── index.ts                    # Registry entry point (aggregates domain barrels)
+│   ├── operations/
+│   │   ├── index.ts                # Domain barrel (exports workflows + agents)
+│   │   └── platform-status.ts     # Platform status workflow (real API example)
+│   ├── example/
+│   │   ├── index.ts                # Domain barrel (exports workflows + agents)
+│   │   └── echo.ts                 # Starter workflow (replace with your own)
+│   └── shared/
+│       └── .gitkeep                # Cross-domain shared utilities
 ├── docs/
 │   ├── index.mdx                   # Starter documentation page
 │   └── in-progress/
@@ -70,7 +76,7 @@ The scaffolded `elevasis.config.ts` includes a `templateVersion` field that trac
 import type { ElevasConfig } from '@elevasis/sdk'
 
 export default {
-  templateVersion: 4,
+  templateVersion: 5,
 } satisfies ElevasConfig
 ```
 
@@ -145,4 +151,4 @@ When a new SDK version is released, run `elevasis update` to bring your project'
 
 ---
 
-**Last Updated:** 2026-02-25
+**Last Updated:** 2026-02-27

package/reference/resources/patterns.mdx

@@ -309,26 +309,39 @@ Individual resources that set their own `config.status` override this default.
 
 ## Organizing Multiple Resources
 
-As your project grows, split resources into separate files and import them into `src/index.ts`:
+As your project grows, organize resources by business domain. Each domain gets its own directory with an `index.ts` barrel that exports `workflows` and `agents` arrays:
 
 ```typescript
-// src/workflows/fulfill-order.ts
+// src/orders/fulfill-order.ts
 export const fulfillOrder: WorkflowDefinition = { ... };
 
-// src/workflows/send-invoice.ts
+// src/billing/send-invoice.ts
 export const sendInvoice: WorkflowDefinition = { ... };
 
+// src/orders/index.ts
+import { fulfillOrder } from './fulfill-order.js';
+export const workflows = [fulfillOrder];
+export const agents = [];
+
+// src/billing/index.ts
+import { sendInvoice } from './send-invoice.js';
+export const workflows = [sendInvoice];
+export const agents = [];
+
 // src/index.ts
-import { fulfillOrder } from './workflows/fulfill-order';
-import { sendInvoice } from './workflows/send-invoice';
 import type { OrganizationResources } from '@elevasis/sdk';
+import * as orders from './orders/index.js';
+import * as billing from './billing/index.js';
 
 const org: OrganizationResources = {
-  workflows: {
-    'fulfill-order': fulfillOrder,
-    'send-invoice': sendInvoice,
-  },
-  agents: {},
+  workflows: [
+    ...orders.workflows,
+    ...billing.workflows,
+  ],
+  agents: [
+    ...orders.agents,
+    ...billing.agents,
+  ],
 };
 
 export default org;

package/reference/troubleshooting/common-errors.mdx

@@ -45,7 +45,7 @@ This is the static SDK-level error catalog. Check `.claude/memory/errors/` first
 
 **Cause:** Two resources in `src/` share the same `resourceId`.
 
-**Fix:** Each resource must have a unique `resourceId` within your organization. Check all files in `src/workflows/` and rename the duplicate.
+**Fix:** Each resource must have a unique `resourceId` within your organization. Check all domain directories in `src/` and rename the duplicate.
 
 ### Workflow step references non-existent next step