@elevasis/sdk 1.9.0 → 1.11.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}`),
@@ -5289,7 +5290,8 @@ function startWorker(org) {
           status: w.config.status,
           description: w.config.description,
           version: w.config.version,
-          domains: w.config.domains,
+          links: w.config.links,
+          category: w.config.category,
           contract: {
             inputSchema: safeZodToJsonSchema(w.contract?.inputSchema),
             outputSchema: safeZodToJsonSchema(w.contract?.outputSchema)
@@ -5311,7 +5313,8 @@ function startWorker(org) {
           status: a.config.status,
           description: a.config.description,
           version: a.config.version,
-          domains: a.config.domains,
+          links: a.config.links,
+          category: a.config.category,
           contract: {
             inputSchema: safeZodToJsonSchema(a.contract?.inputSchema),
             outputSchema: safeZodToJsonSchema(a.contract?.outputSchema)
@@ -5434,4 +5437,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.9.0",
+  "version": "1.11.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.9.0",
+    "@repo/core": "0.11.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

@@ -32,7 +32,7 @@ Run from project root:
 pnpm up @elevasis/ui @elevasis/core @elevasis/sdk --latest
 ```
 
-Dep bumps are already written into `_template/ui/package.json` and `_template/operations/package.json` by the release train.
+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