@elevasis/sdk 0.4.8 → 0.4.10

package/dist/templates.js

@@ -1,4 +1,4 @@
-// src/cli/commands/init.ts
+// package.json
 function gitignoreTemplate() {
   return `node_modules/
 .env
@@ -59,6 +59,7 @@ proactivity -- to their assessed levels.
 | Credential model | \`reference/security/credentials.mdx\` | Setting up integrations or tool access |
 | Interaction guidance | \`reference/developer/interaction-guidance.mdx\` | Unsure how to adapt for a skill combination |
 | Error history | \`.claude/memory/errors/index.md\` | Debugging errors, checking past fixes |
+| Command View model | \`reference/deployment/command-view.mdx\` | Deploying or building resources that invoke other resources |
 | SDK error reference | \`reference/troubleshooting/common-errors.mdx\` | Unknown error not in workspace memory |
 | Project resource map | \`docs/navigation.mdx\` | Understanding what's deployed |
 | Project priorities | \`docs/priorities.mdx\` | Deciding what to work on next |
@@ -70,12 +71,15 @@ 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'\`
 - \`platform\`, \`PlatformToolError\` are runtime imports from \`'@elevasis/sdk/worker'\`
 - \`.env\` is for CLI authentication only (\`ELEVASIS_API_KEY\`) -- never deployed, never in workers
-- Integration credentials are managed via the platform credential system (command center UI)
+- Integration credentials are managed via the \`creds\` skill (auto-triggers when you mention credentials) or the Command Center UI
 - Documentation goes in \`docs/\` as \`.mdx\` files
 - \`dist/\` is generated by deploy -- never commit it
 - \`resourceId\` must be lowercase with hyphens, unique per organization
@@ -109,7 +113,8 @@ For detailed per-dimension adaptation rules, read
 | Command | Purpose |
 | --- | --- |
 | \`/meta\` | Project lifecycle: init, status, update, fix, deploy, health, develop |
-| \`/docs\` | Documentation lifecycle: create, checkpoint, cleanup, resume, verify |
+| \`/docs\` | Documentation lifecycle: create, review, verify |
+| \`/work\` | Task tracking: start, save, resume, done, list |
 | \`/database\` | Database operations: init, browse, query, schema, import |
 | \`/resource\` | Scaffold a new workflow or agent |
 | \`/templates\` | Discover and apply workflow templates |
@@ -118,6 +123,14 @@ For detailed per-dimension adaptation rules, read
 | \`/help\` | Command tree and navigation map |
 | \`/profile\` | View and update developer profile |
 
+## Skills
+
+Skills auto-trigger based on conversation context. You do not need to invoke them manually.
+
+| Skill | Triggers When |
+| --- | --- |
+| \`creds\` | You mention credentials, API keys, secrets, webhook secrets, or setting up integrations |
+
 ## Maintaining Memory
 
 ### What Memory Is
@@ -162,7 +175,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
 
@@ -176,21 +189,6 @@ Populate with content based on the resource definitions in src/.
 **\`review\`:** Review all docs/ files for accuracy against the actual resource
 definitions. Flag mismatches between documented schemas and code.
 
-**\`checkpoint\`:** Save current work progress for session resume.
-Create or update \`docs/in-progress/<topic>.mdx\` with:
-- Current state and decisions made
-- Remaining work and blockers
-- Update \`docs/priorities.mdx\` with task status
-
-**\`cleanup\`:** Move completed documents from \`docs/in-progress/\` to their
-final location in \`docs/\`. Review each in-progress doc to determine if it's
-complete. Incomplete docs remain in \`docs/in-progress/\`.
-Also rebuild \`docs/navigation.mdx\` from the current project state.
-
-**\`resume\`:** Start-of-session command. Review in-progress docs, priorities,
-and recent deployment state. Present a summary: what's in progress, what's
-blocking, what's next. Offer to continue the highest-priority item.
-
 **\`verify [path]\`:** Cross-reference documentation with the codebase.
 Read the specified doc (or all docs if no path), compare claims against actual
 code (resource IDs, schema fields, platform tools used), and report
@@ -205,7 +203,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 +225,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
@@ -244,10 +242,14 @@ cannot specify schemas directly.
 - Add to \`src/index.ts\` registry
 
 **\`tool-step <name>\`:** Create a step that calls a platform tool:
-- Import \`{ platform, PlatformToolError }\` from '@elevasis/sdk/worker'
-- Use \`await platform.call({ tool, method, params, credential })\`
+- Prefer typed adapters: \`import { createAttioAdapter, scheduler, llm } from '@elevasis/sdk/worker'\`
+- Integration tools: \`const attio = createAttioAdapter('cred'); await attio.listRecords({...})\`
+- Platform singletons: \`await scheduler.createSchedule({...})\`, \`await llm.generate({...})\`
+- Fallback for tools without adapters: \`await platform.call({ tool, method, params, credential })\`
+- Import \`{ PlatformToolError }\` from '@elevasis/sdk/worker' for error handling
 - Wrap in try/catch for PlatformToolError
 - Note: 60s timeout per call, credential required for integration tools
+- See reference/platform-tools/adapters.mdx for the full adapter API
 `;
 }
 function claudeTutorialCommandTemplate() {
@@ -280,8 +282,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**
@@ -299,7 +302,10 @@ Observation focus: optional fields, types, suggesting own fields.
 **Lesson 4: Using Platform Tools**
 Explain platform tools (concepts page). Browse available tools via
 reference/platform-tools/index.mdx. Pick a tool based on user's goals.
-Build: add a platform.call() step. Explain credential setup.
+Build: add a tool step using typed adapters (preferred) or platform.call().
+Show adapter pattern: \`const attio = createAttioAdapter('cred')\`.
+Show singleton pattern: \`import { scheduler, llm } from '@elevasis/sdk/worker'\`.
+Explain credential setup. See reference/platform-tools/adapters.mdx for full API.
 Observation focus: credential model, async/await.
 
 **Lesson 5: Multi-Step Workflows**
@@ -360,11 +366,17 @@ Available Commands:
 /docs            Documentation lifecycle
   /docs            Show documentation status
   /docs create     Create new documentation page
-  /docs checkpoint Save progress for session resume
-  /docs cleanup    Move completed docs, rebuild navigation maps
-  /docs resume     Review in-progress work and priorities
+  /docs review     Review docs for accuracy
   /docs verify     Cross-reference docs with codebase for accuracy
 
+/work            Task tracking
+  /work            Show current tasks
+  /work start      Create new task
+  /work save       Save progress for session resume
+  /work resume     Resume in-progress work
+  /work done       Complete and move task
+  /work list       List all tasks with status
+
 /database        Database operations
   /database init     Connect Supabase project
   /database browse   Query and display table contents
@@ -416,7 +428,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
@@ -491,14 +503,14 @@ You are an agent development assistant for this Elevasis workspace.
 
 Agent definitions are accepted by the SDK and appear in the registry.
 Autonomous agent execution (multi-turn tool use loops) is deferred.
-LLM calls are available via \`platform.call({ tool: 'llm' })\` as a workaround.
+LLM calls are available via the \`llm\` typed adapter: \`import { llm } from '@elevasis/sdk/worker'\`, then \`await llm.generate({ messages: [...] })\`.
 
 ## Operations
 
 **\`/agent\` (no args):** Explain the current state:
 - Agent definitions are accepted by the SDK and appear in the registry
 - Autonomous agent execution (multi-turn tool use loops) is deferred
-- LLM calls are available via platform.call({ tool: 'llm' }) as a workaround
+- LLM calls are available via the \`llm\` typed adapter (\`import { llm } from '@elevasis/sdk/worker'\`)
 - Show the AgentDefinition pattern for future use
 
 **\`/agent scaffold <name>\`:** Create an agent definition with:
@@ -655,6 +667,9 @@ Detect and repair drift without a version upgrade:
 
 ### \`/meta deploy\` -- Full Deploy Pipeline
 
+0. Read \`reference/deployment/command-view.mdx\` -- understand the Command View
+   model, relationship declarations, and what deploy-time validation checks.
+   This context is essential for diagnosing validation failures in steps 1-2.
 1. Run \`elevasis check\` (validation)
 2. Type check if \`tsconfig.json\` exists
 3. Verify docs reflect current resources
@@ -666,6 +681,8 @@ Detect and repair drift without a version upgrade:
 9. If git configured and remote exists: optionally push
 
 Each step reports its result. Pipeline stops on failure with suggested fix.
+If validation fails with relationship errors, re-read \`reference/deployment/command-view.mdx\`
+for the enforcement model and common fixes.
 
 ### \`/meta health\` -- Execution Debugging
 
@@ -743,5 +760,111 @@ 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 { llm } 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 llm.generate({
+          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? }
@@ -22,4 +27,5 @@
 import type { OrganizationResources } from '../index.js';
 export { platform, PlatformToolError } from './platform.js';
 export type { PlatformCredential } from './platform.js';
+export * from './adapters/index.js';
 export declare function startWorker(org: OrganizationResources): void;