@elevasis/sdk 1.8.3 → 1.10.0

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

@@ -26,8 +26,27 @@
  *   Worker -> Parent:  { type: 'credential-request', id, name }
  *   Parent -> Worker:  { type: 'credential-result', id, provider?, credentials?, error?, code? }
  */
-import type { DeploymentSpec } from '../index.js';
+import type { DeploymentSpec, WorkflowDefinition } from '../index.js';
 export { platform, PlatformToolError } from './platform.js';
 export type { PlatformCredential } from './platform.js';
 export * from './adapters/index.js';
+export interface LogEntry {
+    level: 'debug' | 'info' | 'warn' | 'error';
+    message: string;
+    timestamp: string;
+    context?: Record<string, unknown>;
+}
+export declare function executeWorkflow(workflow: WorkflowDefinition, input: unknown, context: {
+    executionId: string;
+    organizationId: string;
+    organizationName: string;
+    sessionId?: string;
+    sessionTurnNumber?: number;
+    parentExecutionId?: string;
+    executionDepth: number;
+    adapters?: Record<string, unknown>;
+}): Promise<{
+    output: unknown;
+    logs: LogEntry[];
+}>;
 export declare function startWorker(org: DeploymentSpec): void;

package/dist/worker/index.js

@@ -5083,7 +5083,7 @@ function captureConsole(executionId, logs) {
     const timestamp = (/* @__PURE__ */ new Date()).toISOString();
     const entry = { level, message, timestamp, context: logContext };
     logs.push(entry);
-    parentPort.postMessage({
+    parentPort?.postMessage({
       type: "log",
       entry: { level, message, timestamp, executionId, context: logContext }
     });
@@ -5177,6 +5177,7 @@ async function executeWorkflow(workflow, input, context) {
           sessionTurnNumber: context.sessionTurnNumber,
           parentExecutionId: context.parentExecutionId,
           executionDepth: context.executionDepth,
+          adapters: context.adapters,
           store: /* @__PURE__ */ new Map(),
           logger: {
             debug: (msg) => console.log(`[debug] ${msg}`),
@@ -5434,4 +5435,4 @@ function startWorker(org) {
   });
 }
 
-export { PlatformToolError, acqDb, approval, createAdapter, createAnymailfinderAdapter, createApifyAdapter, createAttioAdapter, createDropboxAdapter, createGmailAdapter, createGoogleSheetsAdapter, createInstantlyAdapter, createMillionVerifierAdapter, createResendAdapter, createSignatureApiAdapter, createStripeAdapter, createTombaAdapter, crm, email, execution, list, llm, notifications, pdf, platform, projects, scheduler, startWorker, storage };
+export { PlatformToolError, acqDb, approval, createAdapter, createAnymailfinderAdapter, createApifyAdapter, createAttioAdapter, createDropboxAdapter, createGmailAdapter, createGoogleSheetsAdapter, createInstantlyAdapter, createMillionVerifierAdapter, createResendAdapter, createSignatureApiAdapter, createStripeAdapter, createTombaAdapter, crm, email, executeWorkflow, execution, list, llm, notifications, pdf, platform, projects, scheduler, startWorker, storage };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/sdk",
-  "version": "1.8.3",
+  "version": "1.10.0",
   "description": "SDK for building Elevasis organization resources",
   "type": "module",
   "bin": {
@@ -14,6 +14,10 @@
     "./worker": {
       "types": "./dist/types/worker/index.d.ts",
       "import": "./dist/worker/index.js"
+    },
+    "./test-utils": {
+      "types": "./dist/test-utils/index.d.ts",
+      "import": "./dist/test-utils/index.js"
     }
   },
   "files": [
@@ -23,6 +27,8 @@
     "dist/types/worker/index.d.ts",
     "dist/types/worker/platform.d.ts",
     "dist/types/worker/adapters/",
+    "dist/test-utils/index.js",
+    "dist/test-utils/index.d.ts",
     "dist/cli.cjs",
     "reference/"
   ],
@@ -44,7 +50,7 @@
     "tsup": "^8.0.0",
     "typescript": "5.9.2",
     "zod": "^4.1.0",
-    "@repo/core": "0.8.3",
+    "@repo/core": "0.10.0",
     "@repo/typescript-config": "0.0.0"
   },
   "scripts": {

package/reference/_navigation.md

@@ -2,7 +2,7 @@
 
 Auto-generated from the package reference manifests.
 
-Package entries indexed: 43.
+Package entries indexed: 47.
 
 ## @elevasis/core / Core
 
@@ -40,6 +40,12 @@ Package entries indexed: 43.
 | --- | --- | --- | --- |
 | Worker Runtime | `runtime.mdx` | Worker runtime entrypoint, adapters, and platform execution surface. | (not specified) |
 
+## @elevasis/sdk / Testing
+
+| Resource | Location | Description | When to Load |
+| --- | --- | --- | --- |
+| Test Utils | `runtime.mdx` | Workflow runner, registry assertion, and typed adapter mocks for SDK consumers. | (not specified) |
+
 ## @elevasis/ui / Components
 
 | Resource | Location | Description | When to Load |
@@ -100,6 +106,14 @@ Package entries indexed: 43.
 | Provider UI | `packages/ui/src/provider/README.md` | Published provider UI entry for downstream applications. | (not specified) |
 | Elevasis Service Context | `packages/ui/src/provider/README.md` | Standalone service context and provider that supplies apiRequest, organizationId, and isReady to child components. | (not specified) |
 
+## @elevasis/ui / Testing
+
+| Resource | Location | Description | When to Load |
+| --- | --- | --- | --- |
+| Test Utils | `packages/ui/src/test-utils/README.md` | Published rendering helpers, auth mocks, MSW handlers, and test provider utilities. | (not specified) |
+| Test Utils Setup | `packages/ui/src/test-utils/README.md` | Vitest setup file for UI consumers using browser mocks and MSW. | (not specified) |
+| Test Utils Integration Setup | `packages/ui/src/test-utils/README.md` | Vitest setup file for integration tests that avoid MSW and use real network boundaries. | (not specified) |
+
 ## @elevasis/ui / Visual
 
 | Resource | Location | Description | When to Load |

package/reference/_reference-manifest.json

@@ -85,6 +85,20 @@
       "referencePath": "runtime.mdx",
       "publishedExportPath": "./dist/worker/index.js"
     },
+    {
+      "packageName": "@elevasis/sdk",
+      "packageDir": "packages/sdk",
+      "subpath": "./test-utils",
+      "kind": "subpath",
+      "title": "Test Utils",
+      "description": "Workflow runner, registry assertion, and typed adapter mocks for SDK consumers.",
+      "group": "Testing",
+      "order": 1,
+      "sourcePath": "packages/sdk/src/test-utils/index.ts",
+      "docPath": "apps/docs/content/docs/sdk/runtime.mdx",
+      "referencePath": "runtime.mdx",
+      "publishedExportPath": "./dist/test-utils/index.js"
+    },
     {
       "packageName": "@elevasis/ui",
       "packageDir": "packages/ui",
@@ -575,6 +589,48 @@
       "referencePath": "packages/ui/src/provider/README.md",
       "publishedExportPath": "./dist/provider/ElevasisServiceContext.js"
     },
+    {
+      "packageName": "@elevasis/ui",
+      "packageDir": "packages/ui",
+      "subpath": "./test-utils",
+      "kind": "subpath",
+      "title": "Test Utils",
+      "description": "Published rendering helpers, auth mocks, MSW handlers, and test provider utilities.",
+      "group": "Testing",
+      "order": 1,
+      "sourcePath": "packages/ui/src/test-utils/index.ts",
+      "docPath": "packages/ui/src/test-utils/README.md",
+      "referencePath": "packages/ui/src/test-utils/README.md",
+      "publishedExportPath": "./dist/test-utils/index.js"
+    },
+    {
+      "packageName": "@elevasis/ui",
+      "packageDir": "packages/ui",
+      "subpath": "./test-utils/setup",
+      "kind": "subpath",
+      "title": "Test Utils Setup",
+      "description": "Vitest setup file for UI consumers using browser mocks and MSW.",
+      "group": "Testing",
+      "order": 2,
+      "sourcePath": "packages/ui/src/test-utils/setup.ts",
+      "docPath": "packages/ui/src/test-utils/README.md",
+      "referencePath": "packages/ui/src/test-utils/README.md",
+      "publishedExportPath": "./dist/test-utils/setup.js"
+    },
+    {
+      "packageName": "@elevasis/ui",
+      "packageDir": "packages/ui",
+      "subpath": "./test-utils/setup-integration",
+      "kind": "subpath",
+      "title": "Test Utils Integration Setup",
+      "description": "Vitest setup file for integration tests that avoid MSW and use real network boundaries.",
+      "group": "Testing",
+      "order": 3,
+      "sourcePath": "packages/ui/src/test-utils/setup-integration.ts",
+      "docPath": "packages/ui/src/test-utils/README.md",
+      "referencePath": "packages/ui/src/test-utils/README.md",
+      "publishedExportPath": "./dist/test-utils/setup-integration.js"
+    },
     {
       "packageName": "@elevasis/ui",
       "packageDir": "packages/ui",

package/reference/claude-config/sync-notes/2026-04-24-test-utils-and-template-tests.md

@@ -0,0 +1,73 @@
+# Test Utils And Template Tests
+
+## Why this note exists
+
+This update adds meaningful package, template, and downstream test coverage while keeping ownership boundaries clear. Package-owned contracts live in package tests/test-utils; `_template` keeps scaffold smoke tests and examples; downstream projects keep custom tests for project-specific workflows and routes.
+
+The new package-level test-utils subpaths are being prepared in the monorepo packages:
+
+- `@elevasis/core/test-utils`
+- `@elevasis/ui/test-utils`
+- `@elevasis/sdk/test-utils`
+
+Until the bundled release train publishes those expanded package surfaces, `_template` keeps small local compatibility wrappers for tests that need the new helpers. Do not replace those wrappers with local `file:` dependencies.
+
+## Applies to
+
+All template-derived projects that sync from `external/_template`.
+
+Known affected projects: `nirvana-marketing`, `ZentaraHQ`.
+
+## Required actions
+
+### Step 1 -- Pull template changes via `/git-sync`
+
+Accept the new tests under sync-managed scaffold surfaces:
+
+- `ui/src/routes/__tests__/`
+- `core/types/**`
+- `core/config/**`
+- local core compatibility helpers under `core/test-utils/`
+
+Operations tests are intentionally narrower. Treat `operations/src/**` as project-owned runtime code. Only keep or add Operations tests in a downstream project when the project owns the workflow/module being tested. The template's email-notification tests are examples, not a requirement for every derived project.
+
+### Step 2 -- Run the expanded test chain
+
+From project root:
+
+```bash
+pnpm test
+```
+
+The root test script now runs `operations check` between UI and operations tests so resource-registry drift fails during ordinary test runs.
+
+### Step 3 -- Keep compatibility wrappers until the bundled release lands
+
+Do not delete any local compatibility wrapper that is still used by a project-owned custom test until the project has upgraded to package versions that publish the expanded test-utils subpaths.
+
+After the release train lands, projects can migrate local compatibility imports to:
+
+```ts
+import { renderWithProviders } from '@elevasis/ui/test-utils'
+import { makeProject } from '@elevasis/core/test-utils'
+import { runWorkflow } from '@elevasis/sdk/test-utils'
+```
+
+### Step 4 -- Adjust only for intentionally removed features
+
+If a derived project intentionally removed a feature route or workflow, skip or adjust the specific synced test case. For Operations, prefer project-owned tests that import package helpers over copied template workflow tests.
+
+## Verification
+
+- `pnpm -C ui test` passes.
+- `pnpm -C operations check` passes.
+- `pnpm -C operations test` passes.
+- `pnpm -C core test` passes.
+- `pnpm test` passes from project root.
+
+## Not handled by /git-sync
+
+- `/git-sync` does not publish or upgrade `@elevasis/*` package versions.
+- `/git-sync` does not remove compatibility wrappers after the release train.
+- `/git-sync` does not decide how a project-specific removed feature should be represented in tests.
+- `/git-sync` does not force template-only Operations example tests into downstream projects that do not own the matching workflow files.

package/reference/claude-config/sync-notes/2026-04-24-ui-consolidation-and-sdk-cli-train.md

@@ -0,0 +1,86 @@
+# UI Consolidation And SDK CLI Train
+
+## Why this note exists
+
+This release train combines three changes that affect derived projects after `pnpm up`:
+
+1. `@elevasis/ui` 2.18.x consolidates previously-duplicated template surface (hooks, components, constants, utilities, test-utils, org-model examples) into the published package. Files that lived in `_template/ui/src/lib/**`, `_template/ui/src/test-utils/**`, and `_template/scripts/use-*-ui.mjs` are deleted from the template and re-exported from `@elevasis/ui`. A `useDeleteRequest` hook and a rollup dts fix also land in this `@elevasis/ui` version.
+2. `@elevasis/sdk` hardens project-root and CWD resolution in the `elevasis-sdk` CLI. Unsupported invocation directories now fail fast with a clear error instead of silently using `process.cwd()`.
+3. `@elevasis/sdk` + `@elevasis/core` + `@elevasis/ui` close three `project:*` / `request:submit` CLI gaps: `--description` on `project:milestone:update`, `agent_learning` note-type enum alignment between `/project` skill docs and the server, and enum values surfaced in `request:submit --help`.
+
+## Applies to
+
+All template-derived projects that:
+
+- import from `@elevasis/ui` (nearly all of them),
+- run the `elevasis-sdk` CLI from any project directory (all of them),
+- invoke `project:milestone:update`, `project:note:create --type agent_learning`, or `request:submit`.
+
+Known affected projects: `nirvana-marketing`, `ZentaraHQ`.
+
+## Required actions
+
+### Step 1 -- Pull the train via `/git-sync`
+
+`/git-sync` surfaces this note and applies template-source changes (deletions of `ui/src/lib/**`, `ui/src/test-utils/**`, `scripts/use-*-ui.mjs`).
+
+### Step 2 -- Update package dependencies
+
+Run from project root:
+
+```
+pnpm up @elevasis/ui @elevasis/core @elevasis/sdk --latest
+```
+
+Dep bumps are already written into `_template/ui/package.json`, `_template/operations/package.json`, and `_template/core/package.json` by the release train (`@elevasis/core` ^0.9.0, `@elevasis/ui` ^2.19.0, `@elevasis/sdk` ^1.9.0).
+
+### Step 3 -- Replace inlined type defs with package imports
+
+Projects that copied the Phase-1 workaround carry six inlined symbols in `ui/src/lib/platform-utils.ts` that should now come from `@elevasis/ui`:
+
+- `CredentialSchema`, `CredentialField`, `OAuthProviderConfig`, `OAuthToken`, `OAuthState` -> `@elevasis/ui/types`
+- `DOMAIN_MAP` -> `@elevasis/ui/utils`
+
+Delete the inlined copies and replace with named imports from the appropriate subpaths. After the edit, `ui/src/lib/platform-utils.ts` should only contain Elevasis-specific symbols and the new imports.
+
+### Step 4 -- Re-verify `elevasis-sdk` invocations
+
+From any dir you routinely invoke the SDK CLI, run:
+
+```
+pnpm exec elevasis-sdk doctor
+```
+
+If the command fails with a "no `.elevasis` marker reachable" error, re-run from a supported directory (project root, `operations/`, or any nested path under a valid project). Previously-silent misfires now surface as hard errors; this is intentional.
+
+### Step 5 -- Audit `project:note:create --type agent_learning` call sites
+
+If any project scripts or agent prompts call `project:note:create --type agent_learning`, verify they match the server enum decision (the train either adds `agent_learning` to the enum or strips it from `/project` skill docs -- check the landed behavior in `pnpm exec elevasis-sdk project:note:create --help` and in the project's synced `/project` SKILL).
+
+### Step 6 -- Rebuild and type-check
+
+Run from project root:
+
+```
+pnpm -C ui build
+pnpm -C ui exec tsc --noEmit
+pnpm -C operations exec tsc --noEmit
+```
+
+All three must pass before the update is complete.
+
+## Verification
+
+- `pnpm up` completes cleanly.
+- `ui/src/lib/platform-utils.ts` contains no inlined `CredentialSchema | CredentialField | OAuthProviderConfig | OAuthToken | OAuthState | DOMAIN_MAP` definitions -- only imports from `@elevasis/ui`.
+- `pnpm -C ui exec tsc --noEmit` passes with no missing-module errors for `@elevasis/ui/hooks`, `@elevasis/ui/components`, `@elevasis/ui/constants`, `@elevasis/ui/utils`, `@elevasis/ui/test-utils`.
+- `pnpm exec elevasis-sdk doctor` reports project root correctly from the directories you use.
+- `pnpm exec elevasis-sdk project:milestone:update --help` lists `--description`.
+- `pnpm exec elevasis-sdk request:submit --help` shows enum values for `--type`, `--category`, `--severity`.
+
+## Not handled by /git-sync
+
+- `/git-sync` does not run `pnpm up` -- Step 2 is manual.
+- `/git-sync` does not rewrite project-owned `ui/src/lib/platform-utils.ts` -- the inlined-to-imports swap in Step 3 is manual per project.
+- `/git-sync` does not validate SDK CLI behavior from project terminals -- Step 4 verification is manual.
+- Any project-local override that hard-references the deleted `_template/ui/src/lib/**` paths must be cleaned up manually.

package/reference/deployment/index.mdx

@@ -12,16 +12,50 @@ Deploying your resources makes them live on the Elevasis platform and immediatel
 
 When you run `elevasis-sdk deploy`, the CLI performs these steps in order:
 
-1. **Authenticate** -- calls the API with your `ELEVASIS_PLATFORM_KEY` to verify credentials and resolve your organization name
-2. **Validate** -- runs your `src/index.ts` through `ResourceRegistry`, catching the same errors as the platform
-3. **Bundle** -- uses esbuild to produce a single self-contained `dist/bundle.js` file (~50-200 KB) containing your code and all dependencies
-4. **Upload** -- sends the bundle and resource metadata to the platform via `POST /api/external/deploy`
-5. **Go live** -- the platform registers your resources; they are immediately available for execution
+1. **Preflight** -- verifies a `.elevasis` marker is reachable from the current directory, that `.env` exists at the project root, and that `ELEVASIS_PLATFORM_KEY` is set. Fails before any side effect if any check fails.
+2. **Authenticate** -- calls the API with your `ELEVASIS_PLATFORM_KEY` to verify credentials and resolve your organization name
+3. **Validate** -- runs your `src/index.ts` through `ResourceRegistry`, catching the same errors as the platform
+4. **Bundle** -- uses esbuild to produce a single self-contained `dist/bundle.js` file (~50-200 KB) containing your code and all dependencies
+5. **Upload** -- sends the bundle and resource metadata to the platform via `POST /api/external/deploy`
+6. **Go live** -- the platform registers your resources; they are immediately available for execution
 
 There is no local dev server and no separate staging environment. Deployed resources run directly on the platform. Local testing uses `tsc --noEmit` and Vitest with direct handler calls.
 
 ---
 
+## Invocation CWD
+
+`elevasis-sdk` is valid from **any subdirectory inside a valid project**. Two separate anchors govern path resolution:
+
+- **Preflight / auth / env** -- anchors on the `.elevasis` project root, found by walking up from the invocation directory. If no `.elevasis` marker is reachable, the CLI exits non-zero before running the command.
+- **Build commands** (`deploy`, `check`) -- anchor on the **nearest `package.json`** (the package root). Bundle outputs land in that package's `dist/`, not the project root. The default entry point (`./src/index.ts`) also resolves from the package root.
+
+**Single-package project** (e.g. `external/acme/`): both anchors resolve to the same directory. Invoke from anywhere inside the project tree.
+
+**Multi-package workspace** (e.g. `external/elevasis/` with `operations/` as a sub-package):
+
+```bash
+# Invoke from operations/ or any subdir inside it
+pnpm -C external/elevasis/operations exec elevasis-sdk deploy
+
+# Both CWDs work identically:
+#   .elevasis root  -> external/elevasis/            (auth / .env)
+#   package root    -> external/elevasis/operations/  (bundle, dist/)
+#   bundle output   -> external/elevasis/operations/dist/bundle.js
+```
+
+Each package in a workspace produces its own `dist/bundle.js` when deployed. Run `elevasis-sdk deploy` from within each package separately.
+
+**Running outside a valid project** produces a hard failure before any network call:
+
+```
+Not inside an Elevasis project. Run from a directory under one containing `.elevasis`.
+```
+
+The only commands that bypass preflight are `--help` / `-h` / `--version` / `-V`.
+
+---
+
 ## Running a Deploy
 
 ```bash
@@ -108,7 +142,7 @@ The CLI also accepts a `--api-url` flag on every command, which takes priority o
 ELEVASIS_PLATFORM_KEY=sk_***
 ```
 
-Place `.env` in your project root. The CLI walks up directories to find it, so running from subdirectories like `operations/` works automatically. Never commit this file.
+Place `.env` in your project root (the directory containing `.elevasis`). The CLI walks up directories to find both the `.elevasis` marker and the `.env` file, so running from subdirectories like `operations/` works automatically. Never commit this file.
 
 ---
 
@@ -154,7 +188,8 @@ The bundle is stored on the platform for durability and restart recovery. If the
 - [Command Center](command-center.mdx) - Resource graph, relationships, node types, and post-deployment UI reference
 - [Provided Features](provided-features.mdx) - Shared Lead Gen, CRM, Projects, and feature-shell surfaces for downstream apps and agents
 - [Execution API](api.mdx) - REST endpoints for executing resources and managing deployments
+- [UI Execution](ui-execution.mdx) - Custom React run dialogs, forms, and hooks for triggering resource executions
 
 ---
 
-**Last Updated:** 2026-04-15
+**Last Updated:** 2026-04-23