@elevasis/sdk 0.4.9 → 0.4.10

package/dist/templates.js

@@ -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 |
@@ -78,7 +79,7 @@ All \`reference/\` paths resolve to \`node_modules/@elevasis/sdk/reference/\`.
 - \`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
@@ -112,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 |
@@ -121,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
@@ -179,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
@@ -247,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() {
@@ -303,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**
@@ -364,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
@@ -495,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:
@@ -659,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
@@ -670,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
 
@@ -751,6 +764,7 @@ 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({
@@ -802,33 +816,29 @@ export const platformStatus: WorkflowDefinition = {
       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'],
+        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' },
             },
-            temperature: 0,
+            required: ['summary'],
           },
+          temperature: 0,
         })
         const summary = (result as any)?.summary ?? String(result)
         return { raw, summary }

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

@@ -27,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;

package/dist/worker/index.js

@@ -4744,6 +4744,250 @@ function createPostMessageAdapterFactory() {
   return (config) => new PostMessageLLMAdapter(config.provider, config.model);
 }
 
+// src/worker/adapters/create-adapter.ts
+function createAdapter(tool, methods, credential) {
+  const adapter = {};
+  for (const method of methods) {
+    adapter[method] = (params) => platform.call({ tool, method, params: params ?? {}, credential });
+  }
+  return adapter;
+}
+
+// src/worker/adapters/attio.ts
+var METHODS = [
+  "createRecord",
+  "updateRecord",
+  "listRecords",
+  "getRecord",
+  "deleteRecord",
+  "listObjects",
+  "listAttributes",
+  "createAttribute",
+  "updateAttribute",
+  "createNote",
+  "listNotes",
+  "deleteNote"
+];
+function createAttioAdapter(credential) {
+  return createAdapter("attio", METHODS, credential);
+}
+
+// src/worker/adapters/apify.ts
+var METHODS2 = [
+  "runActor"
+];
+function createApifyAdapter(credential) {
+  return createAdapter("apify", METHODS2, credential);
+}
+
+// src/worker/adapters/dropbox.ts
+var METHODS3 = [
+  "uploadFile",
+  "createFolder"
+];
+function createDropboxAdapter(credential) {
+  return createAdapter("dropbox", METHODS3, credential);
+}
+
+// src/worker/adapters/gmail.ts
+var METHODS4 = [
+  "sendEmail"
+];
+function createGmailAdapter(credential) {
+  return createAdapter("gmail", METHODS4, credential);
+}
+
+// src/worker/adapters/google-sheets.ts
+var METHODS5 = [
+  "readSheet",
+  "writeSheet",
+  "appendRows",
+  "clearRange",
+  "getSpreadsheetMetadata",
+  "batchUpdate",
+  "getHeaders",
+  "getLastRow",
+  "getRowByValue",
+  "updateRowByValue",
+  "upsertRow",
+  "filterRows",
+  "deleteRowByValue"
+];
+function createGoogleSheetsAdapter(credential) {
+  return createAdapter("google-sheets", METHODS5, credential);
+}
+
+// src/worker/adapters/instantly.ts
+var METHODS6 = [
+  "sendReply",
+  "removeFromSubsequence",
+  "getEmails",
+  "updateInterestStatus",
+  "addToCampaign"
+];
+function createInstantlyAdapter(credential) {
+  return createAdapter("instantly", METHODS6, credential);
+}
+
+// src/worker/adapters/mailso.ts
+var METHODS7 = [
+  "verifyEmail"
+];
+function createMailsoAdapter(credential) {
+  return createAdapter("mailso", METHODS7, credential);
+}
+
+// src/worker/adapters/notion.ts
+var METHODS8 = [
+  "listAllPages",
+  "readPage",
+  "createPage",
+  "updatePageTitle",
+  "appendBlocks",
+  "updateBlocks",
+  "deletePage",
+  "deleteBlocks"
+];
+function createNotionAdapter(credential) {
+  return createAdapter("notion", METHODS8, credential);
+}
+
+// src/worker/adapters/resend.ts
+var METHODS9 = [
+  "sendEmail",
+  "getEmail"
+];
+function createResendAdapter(credential) {
+  return createAdapter("resend", METHODS9, credential);
+}
+
+// src/worker/adapters/signature-api.ts
+var METHODS10 = [
+  "createEnvelope",
+  "voidEnvelope",
+  "downloadDocument",
+  "getEnvelope"
+];
+function createSignatureApiAdapter(credential) {
+  return createAdapter("signature-api", METHODS10, credential);
+}
+
+// src/worker/adapters/stripe.ts
+var METHODS11 = [
+  "createPaymentLink",
+  "getPaymentLink",
+  "updatePaymentLink",
+  "listPaymentLinks",
+  "createAutoPaymentLink",
+  "createCheckoutSession"
+];
+function createStripeAdapter(credential) {
+  return createAdapter("stripe", METHODS11, credential);
+}
+
+// src/worker/adapters/trello.ts
+var METHODS12 = [
+  "getBoard",
+  "getLists",
+  "getCards",
+  "createCard",
+  "updateCard",
+  "createList",
+  "createChecklist",
+  "addChecklistItem",
+  "updateChecklistItem",
+  "getCardChecklists"
+];
+function createTrelloAdapter(credential) {
+  return createAdapter("trello", METHODS12, credential);
+}
+
+// src/worker/adapters/scheduler.ts
+var scheduler = createAdapter("scheduler", [
+  "createSchedule",
+  "updateAnchor",
+  "deleteSchedule",
+  "findByIdempotencyKey",
+  "deleteScheduleByIdempotencyKey",
+  "listSchedules",
+  "getSchedule",
+  "cancelSchedule",
+  "cancelSchedulesByMetadata"
+]);
+
+// src/worker/adapters/llm.ts
+var llm = {
+  generate: (params) => platform.call({ tool: "llm", method: "generate", params })
+};
+
+// src/worker/adapters/storage.ts
+var storage = createAdapter("storage", [
+  "upload",
+  "download",
+  "createSignedUrl",
+  "delete",
+  "list"
+]);
+
+// src/worker/adapters/notification.ts
+var notifications = createAdapter("notification", ["create"]);
+
+// src/worker/adapters/lead.ts
+var lead = createAdapter("lead", [
+  // List operations
+  "listLists",
+  "createList",
+  "updateList",
+  "deleteList",
+  // Company operations
+  "createCompany",
+  "upsertCompany",
+  "updateCompany",
+  "getCompany",
+  "listCompanies",
+  "deleteCompany",
+  // Contact operations
+  "createContact",
+  "upsertContact",
+  "updateContact",
+  "getContact",
+  "getContactByEmail",
+  "listContacts",
+  "deleteContact",
+  "bulkImportContacts",
+  // Deal operations
+  "upsertDeal",
+  "getDealByEmail",
+  "getDealByEnvelopeId",
+  "updateDealEnvelopeId",
+  "getDealByAttioId",
+  // Deal-sync operations
+  "updateDiscoveryData",
+  "updateProposalData",
+  "markProposalSent",
+  "markProposalReviewed",
+  "updateCloseLostReason",
+  "updateFees",
+  "syncDealStage",
+  "setContactNurture",
+  "cancelSchedulesAndHitlByEmail",
+  "cancelHitlByDealId",
+  "clearDealFields",
+  "deleteDeal"
+]);
+
+// src/worker/adapters/pdf.ts
+var pdf = createAdapter("pdf", ["render", "renderToBuffer"]);
+
+// src/worker/adapters/approval.ts
+var approval = createAdapter("approval", ["create", "deleteByMetadata"]);
+
+// src/worker/adapters/execution.ts
+var execution = createAdapter("execution", ["trigger"]);
+
+// src/worker/adapters/email.ts
+var email = createAdapter("email", ["send"]);
+
 // src/worker/index.ts
 function resolveNext(next, data) {
   if (next === null) return null;
@@ -5014,4 +5258,4 @@ function startWorker(org) {
   });
 }
 
-export { PlatformToolError, platform, startWorker };
+export { PlatformToolError, approval, createAdapter, createApifyAdapter, createAttioAdapter, createDropboxAdapter, createGmailAdapter, createGoogleSheetsAdapter, createInstantlyAdapter, createMailsoAdapter, createNotionAdapter, createResendAdapter, createSignatureApiAdapter, createStripeAdapter, createTrelloAdapter, email, execution, lead, llm, notifications, pdf, platform, scheduler, startWorker, storage };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/sdk",
-  "version": "0.4.9",
+  "version": "0.4.10",
   "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,6 +33,11 @@
     "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"
@@ -41,6 +46,8 @@
     "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",
@@ -51,13 +58,6 @@
     "rollup-plugin-dts": "^6.3.0",
     "tsup": "^8.0.0",
     "typescript": "5.9.2",
-    "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"
+    "zod": "^4.1.0"
   }
-}
+}