@elevasis/sdk 0.4.11 → 0.4.13

package/dist/cli.cjs

@@ -43405,6 +43405,12 @@ var ResourceRegistry = class {
     if (existingOrg) {
       existingOrg.workflows = [...existingOrg.workflows ?? [], ...org.workflows ?? []];
       existingOrg.agents = [...existingOrg.agents ?? [], ...org.agents ?? []];
+      if (org.relationships) {
+        existingOrg.relationships = {
+          ...existingOrg.relationships ?? {},
+          ...org.relationships
+        };
+      }
     } else {
       this.registry[orgName] = org;
     }
@@ -43442,6 +43448,14 @@ var ResourceRegistry = class {
     orgResources.agents = (orgResources.agents ?? []).filter(
       (a) => !remoteIds.has(a.config.resourceId)
     );
+    if (orgResources.relationships) {
+      for (const id of remoteIds) {
+        delete orgResources.relationships[id];
+      }
+      if (Object.keys(orgResources.relationships).length === 0) {
+        delete orgResources.relationships;
+      }
+    }
     const remaining = (orgResources.workflows?.length ?? 0) + (orgResources.agents?.length ?? 0) + (orgResources.triggers?.length ?? 0) + (orgResources.integrations?.length ?? 0) + (orgResources.externalResources?.length ?? 0) + (orgResources.humanCheckpoints?.length ?? 0);
     if (remaining > 0) {
       this.serializedCache.set(orgName, serializeOrganization(orgResources));
@@ -43816,7 +43830,7 @@ async function apiDelete(endpoint, apiUrl = resolveApiUrl()) {
 // package.json
 var package_default = {
   name: "@elevasis/sdk",
-  version: "0.4.11",
+  version: "0.4.12",
   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",
@@ -44046,6 +44060,16 @@ function registerDeployCommand(program3) {
     if (documentation) {
       console.log(source_default.gray(`  docs    ${source_default.white(String(documentation.length))} file${documentation.length !== 1 ? "s" : ""}`));
     }
+    const triggerCount = org.triggers?.length ?? 0;
+    const integrationCount = org.integrations?.length ?? 0;
+    const checkpointCount = org.humanCheckpoints?.length ?? 0;
+    if (triggerCount > 0) console.log(source_default.gray(`  triggers  ${source_default.white(String(triggerCount))}`));
+    if (integrationCount > 0) console.log(source_default.gray(`  integrations  ${source_default.white(String(integrationCount))}`));
+    if (checkpointCount > 0) console.log(source_default.gray(`  checkpoints  ${source_default.white(String(checkpointCount))}`));
+    const relationshipCount = org.relationships ? Object.keys(org.relationships).length : 0;
+    if (relationshipCount > 0) {
+      console.log(source_default.gray(`  rels    ${source_default.white(String(relationshipCount))} resource${relationshipCount !== 1 ? "s" : ""}`));
+    }
     const schemaWarnings = [];
     const workflows = (org.workflows ?? []).map((w) => {
       const meta = {
@@ -44148,7 +44172,8 @@ startWorker(org)
         sdkVersion: SDK_VERSION,
         mode: env2,
         resources: { workflows, agents },
-        ...documentation ? { documentation } : {}
+        ...documentation ? { documentation } : {},
+        ...org.relationships ? { relationships: org.relationships } : {}
       };
       const form = new FormData();
       form.append("bundle", new Blob([bundleBuffer]), "bundle.js");
@@ -44564,14 +44589,46 @@ var MANAGED_FILES = [
   ".claude/commands/work.md",
   ".claude/skills/creds/SKILL.md"
 ];
+var UI_INIT_FILES = [
+  "ui/package.json",
+  "ui/index.html",
+  "ui/vite.config.ts",
+  "ui/tsconfig.json",
+  "ui/src/main.tsx",
+  "ui/src/App.tsx",
+  "ui/src/AuthRedirect.tsx",
+  "ui/src/vite-env.d.ts",
+  "ui/.env",
+  "ui/.env.example"
+];
 var SCAFFOLD_FILES = [...INIT_ONLY_FILES, ...MANAGED_FILES];
+function getManagedTemplates(ctx = {}) {
+  return {
+    "elevasis.config.ts": configTemplate,
+    ".gitignore": () => gitignoreTemplate(ctx),
+    "CLAUDE.md": () => claudeMdTemplate(ctx),
+    ".claude/settings.json": claudeSettingsTemplate,
+    ".claude/commands/docs.md": claudeDocsCommandTemplate,
+    ".claude/commands/resource.md": claudeResourceCommandTemplate,
+    ".claude/commands/tutorial.md": claudeTutorialCommandTemplate,
+    ".claude/commands/help.md": claudeHelpCommandTemplate,
+    ".claude/commands/templates.md": claudeTemplatesCommandTemplate,
+    ".claude/commands/database.md": claudeDatabaseCommandTemplate,
+    ".claude/commands/agent.md": claudeAgentCommandTemplate,
+    ".claude/commands/profile.md": claudeProfileCommandTemplate,
+    ".claude/commands/meta.md": claudeMetaCommandTemplate,
+    ".claude/commands/work.md": claudeWorkCommandTemplate,
+    ".claude/skills/creds/SKILL.md": claudeCredsSkillTemplate
+  };
+}
 function registerInitCommand(program3) {
-  program3.command("init [directory]").description("Scaffold a new Elevasis workspace\n  Example: elevasis init my-workspace").option("--force", "Overwrite existing files").action(wrapAction("init", async (directory, options2) => {
+  program3.command("init [directory]").description("Scaffold a new Elevasis workspace\n  Example: elevasis init my-workspace").option("--force", "Overwrite existing files").option("--ui", "Include a Vite + React UI app in ui/").action(wrapAction("init", async (directory, options2) => {
     const targetDir = directory ? (0, import_path3.resolve)(directory) : process.cwd();
     const orgSlug = toSlug((0, import_path3.basename)(targetDir));
     if (!options2.force) {
+      const filesToCheck = options2.ui ? [...SCAFFOLD_FILES, ...UI_INIT_FILES] : SCAFFOLD_FILES;
       const conflicts = [];
-      for (const file2 of SCAFFOLD_FILES) {
+      for (const file2 of filesToCheck) {
         try {
           await (0, import_promises2.access)((0, import_path3.resolve)(targetDir, file2));
           conflicts.push(file2);
@@ -44593,6 +44650,9 @@ function registerInitCommand(program3) {
     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 });
     await (0, import_promises2.mkdir)((0, import_path3.resolve)(targetDir, ".claude/skills/creds"), { recursive: true });
+    if (options2.ui) {
+      await (0, import_promises2.mkdir)((0, import_path3.resolve)(targetDir, "ui/src"), { recursive: true });
+    }
     const files = {
       "elevasis.config.ts": configTemplate(),
       "package.json": packageJsonTemplate(orgSlug),
@@ -44601,7 +44661,7 @@ function registerInitCommand(program3) {
       ".env": envTemplate(),
       ".env.example": envExampleTemplate(),
       ".npmrc": npmrcTemplate(),
-      ".gitignore": gitignoreTemplate(),
+      ".gitignore": gitignoreTemplate({ hasUI: options2.ui }),
       "src/index.ts": starterTemplate(),
       "src/operations/platform-status.ts": platformStatusTemplate(),
       "src/operations/index.ts": operationsBarrelTemplate(),
@@ -44610,7 +44670,7 @@ function registerInitCommand(program3) {
       "src/shared/.gitkeep": "",
       "docs/index.mdx": docsIndexTemplate(orgSlug),
       "docs/in-progress/.gitkeep": "",
-      "CLAUDE.md": claudeMdTemplate(),
+      "CLAUDE.md": claudeMdTemplate({ hasUI: options2.ui }),
       ".claude/settings.json": claudeSettingsTemplate(),
       ".claude/commands/docs.md": claudeDocsCommandTemplate(),
       ".claude/commands/resource.md": claudeResourceCommandTemplate(),
@@ -44624,6 +44684,9 @@ function registerInitCommand(program3) {
       ".claude/commands/work.md": claudeWorkCommandTemplate(),
       ".claude/skills/creds/SKILL.md": claudeCredsSkillTemplate()
     };
+    if (options2.ui) {
+      Object.assign(files, getUIFiles(orgSlug));
+    }
     for (const [filePath, content] of Object.entries(files)) {
       await (0, import_promises2.writeFile)((0, import_path3.resolve)(targetDir, filePath), content, "utf-8");
     }
@@ -44637,6 +44700,13 @@ function registerInitCommand(program3) {
     console.log(source_default.gray("    # Copy .env.example to .env and add your API key"));
     console.log(source_default.gray("    elevasis check"));
     console.log(source_default.gray("    elevasis deploy"));
+    if (options2.ui) {
+      console.log("");
+      console.log(source_default.gray("  UI app:"));
+      console.log(source_default.gray("    cd ui && pnpm install"));
+      console.log(source_default.gray("    # Set VITE_WORKOS_CLIENT_ID in ui/.env"));
+      console.log(source_default.gray("    pnpm dev"));
+    }
   }));
 }
 function toSlug(name) {
@@ -44704,14 +44774,20 @@ function npmrcTemplate() {
   return `auto-install-peers = true
 `;
 }
-function gitignoreTemplate() {
-  return `node_modules/
+function gitignoreTemplate(ctx = {}) {
+  let content = `node_modules/
 .env
 dist/
 __elevasis_worker.ts
 .claude/settings.local.json
 .claude/memory/
 `;
+  if (ctx.hasUI) {
+    content += `ui/node_modules/
+ui/dist/
+`;
+  }
+  return content;
 }
 function docsIndexTemplate(organization) {
   return `---
@@ -44787,7 +44863,7 @@ elevasis exec echo --input '{"message": "hello"}'
 function claudeSettingsTemplate() {
   return JSON.stringify({ autoCompact: false }, null, 2) + "\n";
 }
-function claudeMdTemplate() {
+function claudeMdTemplate(ctx = {}) {
   return `<!-- initialized: false -->
 
 # CLAUDE.md
@@ -44840,7 +44916,8 @@ proactivity -- to their assessed levels.
 | Project resource map | \`docs/navigation.mdx\` | Understanding what's deployed |
 | Project priorities | \`docs/priorities.mdx\` | Deciding what to work on next |
 | User profile and skills | \`.claude/memory/profile/skills.md\` | Session start (mandatory) |
-| Cross-session memory | \`.claude/memory/index.md\` | Session start, recalling past context |
+| Cross-session memory | \`.claude/memory/index.md\` | Session start, recalling past context |${ctx.hasUI ? `
+| UI app source | \`ui/src/\` | Modifying the frontend, adding routes or components |` : ""}
 
 All \`reference/\` paths resolve to \`node_modules/@elevasis/sdk/reference/\`.
 
@@ -44862,7 +44939,17 @@ All \`reference/\` paths resolve to \`node_modules/@elevasis/sdk/reference/\`.
 - When an error occurs, check \`.claude/memory/errors/\` first for past fixes.
   If the error is new, check \`reference/troubleshooting/common-errors.mdx\`.
   After resolving, record the error in \`memory/errors/\` with context and fix.
-  If an error recurs 3+ times, promote it to a rule in this section.
+  If an error recurs 3+ times, promote it to a rule in this section.${ctx.hasUI ? `
+
+### UI App (\`ui/\`)
+
+- \`ui/\` is a standalone Vite + React app with its own \`package.json\` -- not part of the pnpm workspace
+- Import from \`@elevasis/sdk-ui\`, never from \`@elevasis/sdk\` or \`@repo/ui\`
+- Dev server runs on port 5100: \`cd ui && pnpm dev\`
+- Set \`VITE_WORKOS_CLIENT_ID\` in \`ui/.env\` before running
+- \`ElevasisProvider\` is pre-configured in \`ui/src/App.tsx\` (oauth mode, redirectUri \`http://localhost:5100/auth-redirect\`, apiUrl \`http://localhost:5170\`)
+- OAuth redirect is handled by the \`AuthRedirect\` component at \`/auth-redirect\` -- it uses \`useAuthContext()\` from \`@elevasis/sdk-ui/auth\` and navigates home once \`user\` is set
+- API must be running on port 5170 for the UI to work (\`pnpm --filter api dev\` from the platform monorepo)` : ""}
 
 ## Interaction Guidance
 
@@ -45801,12 +45888,166 @@ export const workflows = [echo]
 export const agents = []
 `;
 }
+function getUIFiles(orgSlug) {
+  return {
+    "ui/package.json": uiPackageJsonTemplate(orgSlug),
+    "ui/index.html": uiIndexHtmlTemplate(),
+    "ui/vite.config.ts": uiViteConfigTemplate(),
+    "ui/tsconfig.json": uiTsconfigTemplate(),
+    "ui/src/main.tsx": uiMainTsxTemplate(),
+    "ui/src/App.tsx": uiAppTsxTemplate(),
+    "ui/src/AuthRedirect.tsx": uiAuthRedirectTemplate(),
+    "ui/src/vite-env.d.ts": uiViteEnvDtsTemplate(),
+    "ui/.env": uiEnvTemplate(),
+    "ui/.env.example": uiEnvExampleTemplate()
+  };
+}
+function uiPackageJsonTemplate(orgSlug) {
+  return JSON.stringify({
+    name: `${orgSlug}-ui`,
+    private: true,
+    type: "module",
+    scripts: {
+      dev: "vite",
+      build: "tsc && vite build",
+      preview: "vite preview"
+    },
+    dependencies: {
+      "@elevasis/sdk-ui": "latest",
+      "@mantine/core": "^8.0.0",
+      "@mantine/hooks": "^8.0.0",
+      "react": "^19.0.0",
+      "react-dom": "^19.0.0",
+      "react-router-dom": "^7.0.0"
+    },
+    devDependencies: {
+      "@types/react": "^19.0.0",
+      "@types/react-dom": "^19.0.0",
+      "@vitejs/plugin-react": "^4.0.0",
+      "typescript": "^5.7.0",
+      "vite": "^6.0.0"
+    }
+  }, null, 2) + "\n";
+}
+function uiIndexHtmlTemplate() {
+  return `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Elevasis UI</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>
+`;
+}
+function uiViteConfigTemplate() {
+  return `import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+
+export default defineConfig({
+  plugins: [react()],
+  server: {
+    port: 5100,
+  },
+})
+`;
+}
+function uiTsconfigTemplate() {
+  return JSON.stringify({
+    compilerOptions: {
+      target: "ES2022",
+      lib: ["ES2022", "DOM", "DOM.Iterable"],
+      module: "ESNext",
+      moduleResolution: "bundler",
+      jsx: "react-jsx",
+      strict: true,
+      esModuleInterop: true,
+      skipLibCheck: true,
+      forceConsistentCasingInFileNames: true,
+      isolatedModules: true,
+      noEmit: true
+    },
+    include: ["src"]
+  }, null, 2) + "\n";
+}
+function uiMainTsxTemplate() {
+  return `import { StrictMode } from 'react'
+import { createRoot } from 'react-dom/client'
+import { BrowserRouter } from 'react-router-dom'
+import { App } from './App'
+
+createRoot(document.getElementById('root')!).render(
+  <StrictMode>
+    <BrowserRouter>
+      <App />
+    </BrowserRouter>
+  </StrictMode>,
+)
+`;
+}
+function uiAppTsxTemplate() {
+  return `import { Routes, Route } from 'react-router-dom'
+import { ElevasisProvider } from '@elevasis/sdk-ui'
+import { AuthRedirect } from './AuthRedirect'
+
+export function App() {
+  return (
+    <ElevasisProvider
+      mode="oauth"
+      clientId={import.meta.env.VITE_WORKOS_CLIENT_ID}
+      redirectUri="http://localhost:5100/auth-redirect"
+      apiUrl="http://localhost:5170"
+    >
+      <Routes>
+        <Route path="/" element={<h1>Home</h1>} />
+        <Route path="/auth-redirect" element={<AuthRedirect />} />
+      </Routes>
+    </ElevasisProvider>
+  )
+}
+`;
+}
+function uiAuthRedirectTemplate() {
+  return `import { useEffect } from 'react'
+import { useNavigate } from 'react-router-dom'
+import { useAuthContext } from '@elevasis/sdk-ui/auth'
+
+export function AuthRedirect() {
+  const { user } = useAuthContext()
+  const navigate = useNavigate()
+
+  useEffect(() => {
+    if (user) {
+      navigate('/', { replace: true })
+    }
+  }, [user, navigate])
+
+  return <p>Signing in...</p>
+}
+`;
+}
+function uiViteEnvDtsTemplate() {
+  return `/// <reference types="vite/client" />
+`;
+}
+function uiEnvTemplate() {
+  return `VITE_WORKOS_CLIENT_ID=
+`;
+}
+function uiEnvExampleTemplate() {
+  return `VITE_WORKOS_CLIENT_ID=your_workos_client_id
+`;
+}
 
 // src/cli/commands/update.ts
 var import_path4 = require("path");
 var import_promises3 = require("fs/promises");
 function registerUpdateCommand(program3) {
-  program3.command("update").description("Update project scaffold to latest template version").action(wrapAction("update", async () => {
+  program3.command("update").description("Update project scaffold to latest template version").option("--ui", "Add a Vite + React UI app in ui/").action(wrapAction("update", async (options2 = {}) => {
     const cwd = process.cwd();
     const configPath = (0, import_path4.resolve)(cwd, "elevasis.config.ts");
     let currentVersion = 0;
@@ -45819,32 +46060,28 @@ function registerUpdateCommand(program3) {
       }
     } catch {
     }
-    if (currentVersion >= TEMPLATE_VERSION) {
+    const upToDate = currentVersion >= TEMPLATE_VERSION;
+    if (upToDate && !options2.ui) {
       console.log(source_default.green(`  Project is up to date (template version ${TEMPLATE_VERSION})`));
       return;
     }
-    const templateMap = {
-      "elevasis.config.ts": configTemplate,
-      ".gitignore": gitignoreTemplate,
-      "CLAUDE.md": claudeMdTemplate,
-      ".claude/settings.json": claudeSettingsTemplate,
-      ".claude/commands/docs.md": claudeDocsCommandTemplate,
-      ".claude/commands/resource.md": claudeResourceCommandTemplate,
-      ".claude/commands/tutorial.md": claudeTutorialCommandTemplate,
-      ".claude/commands/help.md": claudeHelpCommandTemplate,
-      ".claude/commands/templates.md": claudeTemplatesCommandTemplate,
-      ".claude/commands/database.md": claudeDatabaseCommandTemplate,
-      ".claude/commands/agent.md": claudeAgentCommandTemplate,
-      ".claude/commands/profile.md": claudeProfileCommandTemplate,
-      ".claude/commands/meta.md": claudeMetaCommandTemplate,
-      ".claude/commands/work.md": claudeWorkCommandTemplate
-    };
+    let hasUI = !!options2.ui;
+    if (!hasUI) {
+      try {
+        await (0, import_promises3.access)((0, import_path4.resolve)(cwd, "ui"));
+        hasUI = true;
+      } catch {
+      }
+    }
+    const managedTemplates = getManagedTemplates({ hasUI });
     const added = [];
     const flagged = [];
     const appendedGitignore = [];
-    for (const file2 of MANAGED_FILES) {
+    const uiAffectedFiles = /* @__PURE__ */ new Set([".gitignore", "CLAUDE.md"]);
+    const filesToProcess = upToDate ? MANAGED_FILES.filter((f) => uiAffectedFiles.has(f)) : MANAGED_FILES;
+    for (const file2 of filesToProcess) {
       const filePath = (0, import_path4.resolve)(cwd, file2);
-      const templateFn = templateMap[file2];
+      const templateFn = managedTemplates[file2];
       if (!templateFn) continue;
       const templateContent = templateFn();
       if (file2 === ".gitignore") {
@@ -45913,8 +46150,34 @@ function registerUpdateCommand(program3) {
         }
       }
     }
+    const uiAdded = [];
+    const uiSkipped = [];
+    if (options2.ui) {
+      const orgSlug = (0, import_path4.basename)(cwd).toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/^[^a-z]+/, "").replace(/-+/g, "-").replace(/-$/, "") || "my-workspace";
+      await (0, import_promises3.mkdir)((0, import_path4.resolve)(cwd, "ui/src"), { recursive: true });
+      const uiFiles = getUIFiles(orgSlug);
+      for (const [file2, content] of Object.entries(uiFiles)) {
+        const filePath = (0, import_path4.resolve)(cwd, file2);
+        let exists = false;
+        try {
+          await (0, import_promises3.access)(filePath);
+          exists = true;
+        } catch {
+        }
+        if (!exists) {
+          await (0, import_promises3.writeFile)(filePath, content, "utf-8");
+          uiAdded.push(file2);
+        } else {
+          uiSkipped.push(file2);
+        }
+      }
+    }
     console.log("");
-    console.log(source_default.green.bold(`  Updated @elevasis/sdk template v${currentVersion} -> v${TEMPLATE_VERSION}`));
+    if (upToDate) {
+      console.log(source_default.green.bold(`  Added UI to project (template version ${TEMPLATE_VERSION})`));
+    } else {
+      console.log(source_default.green.bold(`  Updated @elevasis/sdk template v${currentVersion} -> v${TEMPLATE_VERSION}`));
+    }
     if (added.length > 0) {
       console.log("");
       console.log("  Added:");
@@ -45941,6 +46204,23 @@ function registerUpdateCommand(program3) {
       console.log(source_default.gray("  Run /meta update in Claude Code to merge flagged files."));
       console.log(source_default.gray("  Or run /meta fix to verify and repair the full framework."));
     }
+    if (uiAdded.length > 0) {
+      console.log("");
+      console.log("  UI scaffold added:");
+      for (const file2 of uiAdded) {
+        console.log(source_default.green(`    ${file2}`));
+      }
+      console.log("");
+      console.log(source_default.gray("  Next: cd ui && pnpm install"));
+      console.log(source_default.gray("  Set VITE_WORKOS_CLIENT_ID in ui/.env"));
+    }
+    if (uiSkipped.length > 0) {
+      console.log("");
+      console.log("  UI files already exist (skipped):");
+      for (const file2 of uiSkipped) {
+        console.log(source_default.gray(`    ${file2}`));
+      }
+    }
     console.log("");
   }));
 }

package/dist/index.d.ts

@@ -6355,4 +6355,4 @@ declare class ToolingError extends ExecutionError {
 }
 
 export { ExecutionError, RegistryValidationError, ResourceRegistry, StepType, ToolingError };
-export type { AbsoluteScheduleConfig, AcqCompany, AcqContact, AcqDeal, AcqList, AddChecklistItemParams, AddChecklistItemResult, AddToCampaignLead, AddToCampaignParams, AddToCampaignResult, AgentConfig, AgentConstraints, AgentDefinition, AgentMemory, ApifyToolMap, AppendBlocksParams, AppendBlocksResult, AppendRowsParams, AppendRowsResult, ApprovalToolMap, AttioToolMap, BatchUpdateParams, BatchUpdateResult, BulkImportParams, BulkImportResult, CancelHitlByDealIdParams, CancelSchedulesAndHitlByEmailParams, ClearDealFieldsParams, ClearRangeParams, ClearRangeResult, CompanyFilters, ConditionalNext, ContactFilters, Contract, CreateAttributeParams, CreateAttributeResult, CreateAutoPaymentLinkParams, CreateAutoPaymentLinkResult, CreateCardParams, CreateCardResult, CreateChecklistParams, CreateChecklistResult, CreateCheckoutSessionParams, CreateCheckoutSessionResult, CreateCompanyParams, CreateContactParams, CreateEnvelopeParams, CreateEnvelopeResult, CreateFolderParams, CreateFolderResult, CreateListParams, CreateNoteParams, CreateNoteResult, CreatePageParams, CreatePageResult, CreatePaymentLinkParams, CreatePaymentLinkResult, CreateRecordParams, CreateRecordResult, CreateScheduleInput, DeleteBlocksParams, DeleteBlocksResult, DeleteDealParams, DeleteNoteParams, DeleteNoteResult, DeletePageParams, DeletePageResult, DeleteRecordParams, DeleteRecordResult, DeleteRowByValueParams, DeleteRowByValueResult, DomainDefinition, DownloadDocumentParams, DownloadDocumentResult, DropboxToolMap, ElevasConfig, EmailToolMap, EnvelopeDocument, EventTriggerConfig, ExecutionContext, ExecutionInterface, ExecutionMetadata, ExecutionToolMap, FilterExpression, FilterRowsParams, FilterRowsResult, FormField, FormFieldType, FormSchema, GetBoardParams, GetBoardResult, GetCardChecklistsParams, GetCardChecklistsResult, GetCardsParams, GetCardsResult, GetEmailsParams, GetEmailsResult, GetEnvelopeParams, GetEnvelopeResult, GetHeadersParams, GetHeadersResult, GetLastRowParams, GetLastRowResult, GetListsParams, GetListsResult, GetPaymentLinkParams, GetPaymentLinkResult, GetRecordParams, GetRecordResult, GetRowByValueParams, GetRowByValueResult, GetSpreadsheetMetadataParams, GetSpreadsheetMetadataResult, GmailSendEmailParams, GmailSendEmailResult, GmailToolMap, GoogleSheetsToolMap, InstantlyToolMap, IntegrationDefinition, LLMAdapterFactory, LLMGenerateRequest, LLMGenerateResponse, LLMMessage, LLMModel, LeadToolMap, LinearNext, ListAllPagesResult, ListAttributesParams, ListAttributesResult, ListNotesParams, ListNotesResult, ListObjectsResult, ListPaymentLinksParams, ListPaymentLinksResult, MailsoToolMap, MailsoVerifyEmailParams, MailsoVerifyEmailResult, MarkProposalReviewedParams, MarkProposalSentParams, MethodEntry, ModelConfig, NextConfig, NotificationSDKInput, NotificationToolMap, NotionToolMap, OrganizationResources, PageWithChildren, PaginatedResult, PaginationParams$1 as PaginationParams, PdfToolMap, QueryRecordsParams, QueryRecordsResult, ReadPageParams, ReadPageResult, ReadSheetParams, ReadSheetResult, Recipient, RecurringScheduleConfig, RelativeScheduleConfig, RemoveFromSubsequenceParams, RemoveFromSubsequenceResult, ResendGetEmailParams, ResendGetEmailResult, ResendSendEmailParams, ResendSendEmailResult, ResendToolMap, ResourceDefinition, ResourceDomain, ResourceMetricsConfig, ResourceStatus, ResourceType, RunActorParams, RunActorResult, ScheduleOriginTracking, ScheduleTarget, ScheduleTriggerConfig, SchedulerToolMap, SendReplyParams, SendReplyResult, SetContactNurtureParams, SheetInfo, SignatureApiFieldType, SignatureApiToolMap, SigningPlace, SortCriteria, StepHandler, StorageDeleteInput, StorageDeleteOutput, StorageDownloadInput, StorageDownloadOutput, StorageListInput, StorageListOutput, StorageSignedUrlInput, StorageSignedUrlOutput, StorageToolMap, StorageUploadInput, StorageUploadOutput, StripeToolMap, SyncDealStageParams, TaskSchedule, TaskScheduleConfig, Tool, ToolExecutionOptions, ToolMethodMap, ToolingErrorType, TrelloCreateListParams, TrelloCreateListResult, TrelloToolMap, TriggerConfig, TriggerDefinition, UpdateAttributeParams, UpdateAttributeResult, UpdateBlocksParams, UpdateBlocksResult, UpdateCardParams, UpdateCardResult, UpdateChecklistItemParams, UpdateChecklistItemResult, UpdateCloseLostReasonParams, UpdateCompanyParams, UpdateContactParams, UpdateDiscoveryDataParams, UpdateFeesParams, UpdateInterestStatusParams, UpdateInterestStatusResult, UpdateListParams, UpdatePageTitleParams, UpdatePageTitleResult, UpdatePaymentLinkParams, UpdatePaymentLinkResult, UpdateProposalDataParams, UpdateRecordParams, UpdateRecordResult, UpdateRowByValueParams, UpdateRowByValueResult, UploadFileParams, UploadFileResult, UpsertCompanyParams, UpsertContactParams, UpsertDealParams, UpsertRowParams, UpsertRowResult, VoidEnvelopeParams, VoidEnvelopeResult, WebhookProviderType, WebhookTriggerConfig, WorkflowConfig, WorkflowDefinition, WorkflowStep, WriteSheetParams, WriteSheetResult };
+export type { AbsoluteScheduleConfig, AcqCompany, AcqContact, AcqDeal, AcqList, AddChecklistItemParams, AddChecklistItemResult, AddToCampaignLead, AddToCampaignParams, AddToCampaignResult, AgentConfig, AgentConstraints, AgentDefinition, AgentMemory, ApifyToolMap, AppendBlocksParams, AppendBlocksResult, AppendRowsParams, AppendRowsResult, ApprovalToolMap, AttioToolMap, BatchUpdateParams, BatchUpdateResult, BulkImportParams, BulkImportResult, CancelHitlByDealIdParams, CancelSchedulesAndHitlByEmailParams, ClearDealFieldsParams, ClearRangeParams, ClearRangeResult, CompanyFilters, ConditionalNext, ContactFilters, Contract, CreateAttributeParams, CreateAttributeResult, CreateAutoPaymentLinkParams, CreateAutoPaymentLinkResult, CreateCardParams, CreateCardResult, CreateChecklistParams, CreateChecklistResult, CreateCheckoutSessionParams, CreateCheckoutSessionResult, CreateCompanyParams, CreateContactParams, CreateEnvelopeParams, CreateEnvelopeResult, CreateFolderParams, CreateFolderResult, CreateListParams, CreateNoteParams, CreateNoteResult, CreatePageParams, CreatePageResult, CreatePaymentLinkParams, CreatePaymentLinkResult, CreateRecordParams, CreateRecordResult, CreateScheduleInput, DeleteBlocksParams, DeleteBlocksResult, DeleteDealParams, DeleteNoteParams, DeleteNoteResult, DeletePageParams, DeletePageResult, DeleteRecordParams, DeleteRecordResult, DeleteRowByValueParams, DeleteRowByValueResult, DomainDefinition, DownloadDocumentParams, DownloadDocumentResult, DropboxToolMap, ElevasConfig, EmailToolMap, EnvelopeDocument, EventTriggerConfig, ExecutionContext, ExecutionInterface, ExecutionMetadata, ExecutionToolMap, FilterExpression, FilterRowsParams, FilterRowsResult, FormField, FormFieldType, FormSchema, GetBoardParams, GetBoardResult, GetCardChecklistsParams, GetCardChecklistsResult, GetCardsParams, GetCardsResult, GetEmailsParams, GetEmailsResult, GetEnvelopeParams, GetEnvelopeResult, GetHeadersParams, GetHeadersResult, GetLastRowParams, GetLastRowResult, GetListsParams, GetListsResult, GetPaymentLinkParams, GetPaymentLinkResult, GetRecordParams, GetRecordResult, GetRowByValueParams, GetRowByValueResult, GetSpreadsheetMetadataParams, GetSpreadsheetMetadataResult, GmailSendEmailParams, GmailSendEmailResult, GmailToolMap, GoogleSheetsToolMap, HumanCheckpointDefinition, InstantlyToolMap, IntegrationDefinition, LLMAdapterFactory, LLMGenerateRequest, LLMGenerateResponse, LLMMessage, LLMModel, LeadToolMap, LinearNext, ListAllPagesResult, ListAttributesParams, ListAttributesResult, ListNotesParams, ListNotesResult, ListObjectsResult, ListPaymentLinksParams, ListPaymentLinksResult, MailsoToolMap, MailsoVerifyEmailParams, MailsoVerifyEmailResult, MarkProposalReviewedParams, MarkProposalSentParams, MethodEntry, ModelConfig, NextConfig, NotificationSDKInput, NotificationToolMap, NotionToolMap, OrganizationResources, PageWithChildren, PaginatedResult, PaginationParams$1 as PaginationParams, PdfToolMap, QueryRecordsParams, QueryRecordsResult, ReadPageParams, ReadPageResult, ReadSheetParams, ReadSheetResult, Recipient, RecurringScheduleConfig, RelationshipDeclaration, RelativeScheduleConfig, RemoveFromSubsequenceParams, RemoveFromSubsequenceResult, ResendGetEmailParams, ResendGetEmailResult, ResendSendEmailParams, ResendSendEmailResult, ResendToolMap, ResourceDefinition, ResourceDomain, ResourceMetricsConfig, ResourceRelationships, ResourceStatus, ResourceType, RunActorParams, RunActorResult, ScheduleOriginTracking, ScheduleTarget, ScheduleTriggerConfig, SchedulerToolMap, SendReplyParams, SendReplyResult, SetContactNurtureParams, SheetInfo, SignatureApiFieldType, SignatureApiToolMap, SigningPlace, SortCriteria, StepHandler, StorageDeleteInput, StorageDeleteOutput, StorageDownloadInput, StorageDownloadOutput, StorageListInput, StorageListOutput, StorageSignedUrlInput, StorageSignedUrlOutput, StorageToolMap, StorageUploadInput, StorageUploadOutput, StripeToolMap, SyncDealStageParams, TaskSchedule, TaskScheduleConfig, Tool, ToolExecutionOptions, ToolMethodMap, ToolingErrorType, TrelloCreateListParams, TrelloCreateListResult, TrelloToolMap, TriggerConfig, TriggerDefinition, UpdateAttributeParams, UpdateAttributeResult, UpdateBlocksParams, UpdateBlocksResult, UpdateCardParams, UpdateCardResult, UpdateChecklistItemParams, UpdateChecklistItemResult, UpdateCloseLostReasonParams, UpdateCompanyParams, UpdateContactParams, UpdateDiscoveryDataParams, UpdateFeesParams, UpdateInterestStatusParams, UpdateInterestStatusResult, UpdateListParams, UpdatePageTitleParams, UpdatePageTitleResult, UpdatePaymentLinkParams, UpdatePaymentLinkResult, UpdateProposalDataParams, UpdateRecordParams, UpdateRecordResult, UpdateRowByValueParams, UpdateRowByValueResult, UploadFileParams, UploadFileResult, UpsertCompanyParams, UpsertContactParams, UpsertDealParams, UpsertRowParams, UpsertRowResult, VoidEnvelopeParams, VoidEnvelopeResult, WebhookProviderType, WebhookTriggerConfig, WorkflowConfig, WorkflowDefinition, WorkflowStep, WriteSheetParams, WriteSheetResult };

package/dist/index.js

@@ -3337,6 +3337,12 @@ var ResourceRegistry = class {
     if (existingOrg) {
       existingOrg.workflows = [...existingOrg.workflows ?? [], ...org.workflows ?? []];
       existingOrg.agents = [...existingOrg.agents ?? [], ...org.agents ?? []];
+      if (org.relationships) {
+        existingOrg.relationships = {
+          ...existingOrg.relationships ?? {},
+          ...org.relationships
+        };
+      }
     } else {
       this.registry[orgName] = org;
     }
@@ -3374,6 +3380,14 @@ var ResourceRegistry = class {
     orgResources.agents = (orgResources.agents ?? []).filter(
       (a) => !remoteIds.has(a.config.resourceId)
     );
+    if (orgResources.relationships) {
+      for (const id of remoteIds) {
+        delete orgResources.relationships[id];
+      }
+      if (Object.keys(orgResources.relationships).length === 0) {
+        delete orgResources.relationships;
+      }
+    }
     const remaining = (orgResources.workflows?.length ?? 0) + (orgResources.agents?.length ?? 0) + (orgResources.triggers?.length ?? 0) + (orgResources.integrations?.length ?? 0) + (orgResources.externalResources?.length ?? 0) + (orgResources.humanCheckpoints?.length ?? 0);
     if (remaining > 0) {
       this.serializedCache.set(orgName, serializeOrganization(orgResources));

package/dist/templates.js

@@ -1,17 +1,23 @@
 // package.json
-function gitignoreTemplate() {
-  return `node_modules/
+function gitignoreTemplate(ctx = {}) {
+  let content = `node_modules/
 .env
 dist/
 __elevasis_worker.ts
 .claude/settings.local.json
 .claude/memory/
 `;
+  if (ctx.hasUI) {
+    content += `ui/node_modules/
+ui/dist/
+`;
+  }
+  return content;
 }
 function claudeSettingsTemplate() {
   return JSON.stringify({ autoCompact: false }, null, 2) + "\n";
 }
-function claudeMdTemplate() {
+function claudeMdTemplate(ctx = {}) {
   return `<!-- initialized: false -->
 
 # CLAUDE.md
@@ -64,7 +70,8 @@ proactivity -- to their assessed levels.
 | Project resource map | \`docs/navigation.mdx\` | Understanding what's deployed |
 | Project priorities | \`docs/priorities.mdx\` | Deciding what to work on next |
 | User profile and skills | \`.claude/memory/profile/skills.md\` | Session start (mandatory) |
-| Cross-session memory | \`.claude/memory/index.md\` | Session start, recalling past context |
+| Cross-session memory | \`.claude/memory/index.md\` | Session start, recalling past context |${ctx.hasUI ? `
+| UI app source | \`ui/src/\` | Modifying the frontend, adding routes or components |` : ""}
 
 All \`reference/\` paths resolve to \`node_modules/@elevasis/sdk/reference/\`.
 
@@ -86,7 +93,17 @@ All \`reference/\` paths resolve to \`node_modules/@elevasis/sdk/reference/\`.
 - When an error occurs, check \`.claude/memory/errors/\` first for past fixes.
   If the error is new, check \`reference/troubleshooting/common-errors.mdx\`.
   After resolving, record the error in \`memory/errors/\` with context and fix.
-  If an error recurs 3+ times, promote it to a rule in this section.
+  If an error recurs 3+ times, promote it to a rule in this section.${ctx.hasUI ? `
+
+### UI App (\`ui/\`)
+
+- \`ui/\` is a standalone Vite + React app with its own \`package.json\` -- not part of the pnpm workspace
+- Import from \`@elevasis/sdk-ui\`, never from \`@elevasis/sdk\` or \`@repo/ui\`
+- Dev server runs on port 5100: \`cd ui && pnpm dev\`
+- Set \`VITE_WORKOS_CLIENT_ID\` in \`ui/.env\` before running
+- \`ElevasisProvider\` is pre-configured in \`ui/src/App.tsx\` (oauth mode, redirectUri \`http://localhost:5100/auth-redirect\`, apiUrl \`http://localhost:5170\`)
+- OAuth redirect is handled by the \`AuthRedirect\` component at \`/auth-redirect\` -- it uses \`useAuthContext()\` from \`@elevasis/sdk-ui/auth\` and navigates home once \`user\` is set
+- API must be running on port 5170 for the UI to work (\`pnpm --filter api dev\` from the platform monorepo)` : ""}
 
 ## Interaction Guidance
 

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

@@ -6,7 +6,9 @@
  *
  * Message protocol:
  *   Parent -> Worker:  { type: 'manifest' }
- *   Worker -> Parent:  { type: 'manifest', workflows: [...], agents: [...] }
+ *   Worker -> Parent:  { type: 'manifest', workflows: [...], agents: [...],
+ *                         triggers?: [...], integrations?: [...], humanCheckpoints?: [...],
+ *                         relationships?: {...} }
  *
  *   Parent -> Worker:  { type: 'execute', resourceId, executionId, input, organizationId?, organizationName?,
  *                         sessionId?, sessionTurnNumber?, parentExecutionId?, executionDepth }

package/dist/worker/index.js

@@ -5130,7 +5130,11 @@ function startWorker(org) {
           status: a.config.status,
           description: a.config.description,
           version: a.config.version
-        }))
+        })),
+        triggers: org.triggers ?? [],
+        integrations: org.integrations ?? [],
+        humanCheckpoints: org.humanCheckpoints ?? [],
+        relationships: org.relationships ?? void 0
       });
       return;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/sdk",
-  "version": "0.4.11",
+  "version": "0.4.13",
   "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",

package/reference/framework/agent.mdx

@@ -40,7 +40,7 @@ At the start of every session the agent runs these steps silently before respond
 
 Slash commands are short Markdown instruction files in `.claude/commands/`. When you type `/command-name` in a Claude Code session, the agent reads the corresponding file and follows its instructions.
 
-All nine commands are scaffolded by `elevasis init` and committed to version control so collaborators get the same experience:
+Ten commands and one skill are scaffolded by `elevasis init` and committed to version control so collaborators get the same experience:
 
 | Command | File | Purpose |
 | --- | --- | --- |
@@ -53,6 +53,9 @@ All nine commands are scaffolded by `elevasis init` and committed to version con
 | `/tutorial` | `tutorial.md` | Progressive learning path for new developers |
 | `/help` | `help.md` | Displays the full command tree and navigation map |
 | `/profile` | `profile.md` | Views and updates the developer profile in `memory/profile/` |
+| `/work` | `work.md` | In-progress task tracking -- save, resume, list |
+
+The `/creds` skill (`.claude/skills/creds/SKILL.md`) is also scaffolded. It auto-triggers when the agent detects credential-related context and manages credential storage and retrieval.
 
 ### `/meta` Command
 
@@ -172,4 +175,4 @@ Applies when TypeScript level is `advanced` and automation level is `experienced
 
 ---
 
-**Last Updated:** 2026-02-26
+**Last Updated:** 2026-03-02

package/reference/platform-tools/adapters.mdx

@@ -853,7 +853,7 @@ Method names are compile-time checked against the type map keys -- misspelling a
 | Tool has a typed adapter (all integrations + platform tools) | Adapter |
 | Need autocomplete and type safety | Adapter |
 | New dispatcher method added server-side, no SDK update yet | `platform.call()` |
-| Tool without a typed adapter (supabase, session-memory, hitl, status, http) | `platform.call()` |
+| Tool without a typed adapter (supabase, session-memory, status, http) | `platform.call()` |
 
 `platform.call()` remains the universal escape hatch. Every adapter call compiles down to it. Both approaches work simultaneously with no conflicts.
 
@@ -925,3 +925,5 @@ Timeouts: LLM calls have a 120s timeout. All other tool calls have a 60s timeout
 ---
 
 **Last Updated:** 2026-03-02
+
+

package/reference/platform-tools/index.mdx

@@ -40,23 +40,22 @@ Both patterns return a Promise that resolves with the tool result or rejects wit
 
 ## Integration Adapters
 
-Thirteen integration adapters give you access to 70+ tool methods covering third-party APIs. Pass the `credential` field with the name of the stored credential for that service.
+Twelve integration adapters give you access to 60+ tool methods covering third-party APIs. Pass the `credential` field with the name of the stored credential for that service. Supabase is listed separately under [Database Access](#database-access) below.
 
 | Adapter | Tools | Credential Shape |
 | --- | --- | --- |
-| Attio | 11 (CRUD + schema + notes) | `{ apiKey }` |
+| Attio | 12 (CRUD + schema + notes) | `{ apiKey }` |
 | Google Sheets | 13 (read/write/filter/upsert) | OAuth2 / service account |
 | Trello | 10 (cards/lists/checklists) | `{ apiKey, token }` |
 | Notion | 8 (pages + blocks) | `{ token }` |
 | Stripe | 6 (payment links + checkout) | `{ secretKey }` |
 | Instantly | 5 (email campaigns) | `{ apiKey }` |
 | Gmail | 2 (send email) | OAuth2 / service account |
-| Resend | 3 (send/get email) | `{ apiKey }` |
-| SignatureAPI | 3 (envelopes) | `{ apiKey }` |
+| Resend | 2 (send/get email) | `{ apiKey }` |
+| SignatureAPI | 4 (envelopes) | `{ apiKey }` |
 | Dropbox | 2 (upload/folder) | `{ accessToken }` |
 | Apify | 1 (run actor) | `{ token }` |
 | Mailso | 1 (verify email) | `{ apiKey }` |
-| Supabase | 7 (insert/select/update/delete/upsert/rpc/count) | `{ url, serviceRoleKey }` |
 
 Credentials are stored in the Elevasis credentials table and injected server-side. The credential name you pass in `credential` must match the name you set when storing the credential.
 
@@ -188,7 +187,7 @@ const qualified = await platform.call({
 
 ## Documentation
 
-- [Typed Adapters](adapters.mdx) - Type-safe wrappers for all 12 integrations + 4 platform services with full autocomplete (recommended)
+- [Typed Adapters](adapters.mdx) - Type-safe wrappers for all 12 integrations + 9 platform services with full autocomplete (recommended)
 - [Integration Examples](examples.mdx) - Working code examples for email, CRM, PDF, LLM, and more
 
 ---

package/reference/troubleshooting/common-errors.mdx

@@ -63,42 +63,6 @@ This is the static SDK-level error catalog. Check `.claude/memory/errors/` first
 
 ---
 
-## Relationship Validation Errors
-
-### Relationship declared for non-existent resource
-
-**Message:** `Relationship source 'resource-id' is not a known resource in 'org-name'`
-
-**Cause:** The `relationships` map in your organization export contains a key that does not match any workflow, agent, trigger, or external resource ID.
-
-**Fix:** Check the resource ID in your `relationships` declaration. Each key must exactly match a `resourceId` defined in your workflows, agents, triggers, or external resources.
-
-### Resource triggers non-existent agent
-
-**Message:** `Relationship target 'agent-id' (agent) not found in 'org-name'`
-
-**Cause:** A relationship's `triggers.agents` array references an agent ID that does not exist.
-
-**Fix:** Verify the agent ID spelling in `triggers: \{ agents: ['agent-id'] \}`. The ID must match the `resourceId` of an agent defined in your organization.
-
-### Resource triggers non-existent workflow
-
-**Message:** `Relationship target 'workflow-id' (workflow) not found in 'org-name'`
-
-**Cause:** A relationship's `triggers.workflows` array references a workflow ID that does not exist.
-
-**Fix:** Verify the workflow ID spelling in `triggers: \{ workflows: ['workflow-id'] \}`. The ID must match the `resourceId` of a workflow defined in your organization.
-
-### Resource uses non-existent integration
-
-**Message:** `Relationship target 'integration-id' (integration) not found in 'org-name'`
-
-**Cause:** A relationship's `uses.integrations` array references an integration ID that does not exist.
-
-**Fix:** Verify the integration ID spelling in `uses: \{ integrations: ['integration-id'] \}`. The ID must match the `resourceId` of an integration defined in your organization.
-
----
-
 ## Schema Validation Errors
 
 ### Schema validation failed (input)