@elevasis/sdk 1.0.0 → 1.0.2

package/dist/cli.cjs

@@ -40455,7 +40455,7 @@ var RegistryValidationError = class extends Error {
     this.name = "RegistryValidationError";
   }
 };
-function validateOrganizationResources(orgName, resources) {
+function validateDeploymentSpec(orgName, resources) {
   const seenIds = /* @__PURE__ */ new Set();
   resources.workflows?.forEach((workflow) => {
     const id = workflow.config.resourceId;
@@ -40587,7 +40587,8 @@ function isZodOptional(schema) {
   return schema.isOptional();
 }
 function validateRelationships(orgName, resources) {
-  if (!resources.relationships && !resources.triggers && !resources.externalResources && !resources.humanCheckpoints) return;
+  if (!resources.relationships && !resources.triggers && !resources.externalResources && !resources.humanCheckpoints)
+    return;
   const validAgentIds = new Set(resources.agents?.map((a) => a.config.resourceId) ?? []);
   const validWorkflowIds = new Set(resources.workflows?.map((w) => w.config.resourceId) ?? []);
   const validIntegrationIds = new Set(resources.integrations?.map((i) => i.resourceId) ?? []);
@@ -43100,6 +43101,7 @@ function serializeOrganization(resources) {
   const humanCheckpoints = resources.humanCheckpoints ?? [];
   const domainDefinitions = deriveDomainDefinitions(resources);
   return {
+    version: resources.version,
     resources: {
       workflows: workflowResources,
       agents: agentResources,
@@ -43258,7 +43260,7 @@ var ResourceRegistry = class {
    */
   validateRegistry() {
     for (const [orgName, resources] of Object.entries(this.registry)) {
-      validateOrganizationResources(orgName, resources);
+      validateDeploymentSpec(orgName, resources);
     }
   }
   /**
@@ -43891,7 +43893,7 @@ function wrapAction(commandName, fn) {
 // package.json
 var package_default = {
   name: "@elevasis/sdk",
-  version: "1.0.0",
+  version: "1.0.2",
   description: "SDK for building Elevasis organization resources",
   type: "module",
   bin: {
@@ -44008,6 +44010,17 @@ function extractResourceMetadata(resource, schemaWarnings) {
   }
   return meta;
 }
+function bumpVersion(current, type) {
+  const [major, minor, patch] = current.split(".").map(Number);
+  switch (type) {
+    case "major":
+      return `${major + 1}.0.0`;
+    case "minor":
+      return `${major}.${minor + 1}.0`;
+    case "patch":
+      return `${major}.${minor}.${patch + 1}`;
+  }
+}
 var IGNORED_DOC_DIRS = /* @__PURE__ */ new Set([".archive"]);
 async function scanDocumentation() {
   const docsDir = (0, import_path.resolve)("docs");
@@ -44486,218 +44499,238 @@ async function generateNavigationMap(docs) {
 function registerDeployCommand(program3) {
   program3.command("deploy").description(
     "Validate, bundle, upload, and deploy project resources\n  Example: elevasis-sdk deploy --api-url http://localhost:5170"
-  ).option("--api-url <url>", "API URL").option("--entry <path>", "Path to entry file (default: ./src/index.ts)").option("--prod", "Deploy to production (overrides NODE_ENV=development)").action(
-    wrapAction("deploy", async (options2) => {
-      const startTime = Date.now();
-      const apiUrl = resolveApiUrl(options2.apiUrl, options2.prod);
-      const env2 = resolveEnvironment(options2.prod);
-      const entryPath = options2.entry ?? "./src/index.ts";
-      const authSpinner = ora("Authenticating...").start();
-      let orgName;
-      try {
-        const me = await apiGet("/api/external/me", apiUrl);
-        orgName = me.organizationName;
-        authSpinner.succeed(
-          source_default.green("Authenticating...") + source_default.white("          done") + source_default.gray(` (${orgName})`)
-        );
-      } catch (error46) {
-        authSpinner.fail(source_default.red("Authentication failed"));
-        const errMsg = error46 instanceof Error ? error46.message : String(error46);
-        if (errMsg.includes("401") || errMsg.toLowerCase().includes("unauthorized")) {
-          const keyVar = !options2.prod && process.env.NODE_ENV === "development" && process.env.ELEVASIS_PLATFORM_KEY_DEV ? "ELEVASIS_PLATFORM_KEY_DEV" : "ELEVASIS_PLATFORM_KEY";
-          console.error(source_default.red("  Invalid API key."));
-          console.error(source_default.gray(`  Your ${keyVar} was rejected by the server.`));
-          console.error(source_default.gray("  Check your .env file and verify the key in the Elevasis dashboard."));
-        } else {
-          console.error(source_default.gray("  Check your API key and API URL."));
+  ).option("--api-url <url>", "API URL").option("--entry <path>", "Path to entry file (default: ./src/index.ts)").option("--prod", "Deploy to production (overrides NODE_ENV=development)").option("--major", "Bump major version before deploying (1.0.0 \u2192 2.0.0)").option("--minor", "Bump minor version before deploying (1.0.0 \u2192 1.1.0)").option("--patch", "Bump patch version before deploying (1.0.0 \u2192 1.0.1)").action(
+    wrapAction(
+      "deploy",
+      async (options2) => {
+        const startTime = Date.now();
+        const apiUrl = resolveApiUrl(options2.apiUrl, options2.prod);
+        const env2 = resolveEnvironment(options2.prod);
+        const entryPath = options2.entry ?? "./src/index.ts";
+        const authSpinner = ora("Authenticating...").start();
+        let orgName;
+        try {
+          const me = await apiGet("/api/external/me", apiUrl);
+          orgName = me.organizationName;
+          authSpinner.succeed(
+            source_default.green("Authenticating...") + source_default.white("          done") + source_default.gray(` (${orgName})`)
+          );
+        } catch (error46) {
+          authSpinner.fail(source_default.red("Authentication failed"));
+          const errMsg = error46 instanceof Error ? error46.message : String(error46);
+          if (errMsg.includes("401") || errMsg.toLowerCase().includes("unauthorized")) {
+            const keyVar = !options2.prod && process.env.NODE_ENV === "development" && process.env.ELEVASIS_PLATFORM_KEY_DEV ? "ELEVASIS_PLATFORM_KEY_DEV" : "ELEVASIS_PLATFORM_KEY";
+            console.error(source_default.red("  Invalid API key."));
+            console.error(source_default.gray(`  Your ${keyVar} was rejected by the server.`));
+            console.error(source_default.gray("  Check your .env file and verify the key in the Elevasis dashboard."));
+          } else {
+            console.error(source_default.gray("  Check your API key and API URL."));
+          }
+          throw error46;
         }
-        throw error46;
-      }
-      const validateSpinner = ora("Validating...").start();
-      let org;
-      let activeWorkflows = [];
-      let activeAgents = [];
-      try {
-        const entryModule = await loadTsModule(entryPath);
-        org = entryModule.default;
-        if (!org) {
-          validateSpinner.fail("Invalid entry: no default export found");
-          console.error(source_default.gray(`  Entry file: ${(0, import_path.resolve)(entryPath)}`));
-          throw new Error("Invalid entry: no default export found");
-        }
-        new ResourceRegistry({ [orgName]: org });
-        activeWorkflows = (org.workflows ?? []).filter((w) => !w.config.archived);
-        activeAgents = (org.agents ?? []).filter((a) => !a.config.archived);
-        const archivedCount = (org.workflows?.length ?? 0) + (org.agents?.length ?? 0) - activeWorkflows.length - activeAgents.length;
-        const totalCount = activeWorkflows.length + activeAgents.length;
-        validateSpinner.succeed(
-          source_default.green("Validating...") + source_default.white("              done") + source_default.gray(` (${totalCount} resource${totalCount !== 1 ? "s" : ""}, 0 errors)`)
-        );
-        if (archivedCount > 0) {
-          console.log(source_default.gray(`  Skipping ${archivedCount} archived resource${archivedCount !== 1 ? "s" : ""}`));
+        const validateSpinner = ora("Validating...").start();
+        let org;
+        let activeWorkflows = [];
+        let activeAgents = [];
+        try {
+          const entryModule = await loadTsModule(entryPath);
+          org = entryModule.default;
+          if (!org) {
+            validateSpinner.fail("Invalid entry: no default export found");
+            console.error(source_default.gray(`  Entry file: ${(0, import_path.resolve)(entryPath)}`));
+            throw new Error("Invalid entry: no default export found");
+          }
+          new ResourceRegistry({ [orgName]: org });
+          activeWorkflows = (org.workflows ?? []).filter((w) => !w.config.archived);
+          activeAgents = (org.agents ?? []).filter((a) => !a.config.archived);
+          const archivedCount = (org.workflows?.length ?? 0) + (org.agents?.length ?? 0) - activeWorkflows.length - activeAgents.length;
+          const totalCount = activeWorkflows.length + activeAgents.length;
+          validateSpinner.succeed(
+            source_default.green("Validating...") + source_default.white("              done") + source_default.gray(` (${totalCount} resource${totalCount !== 1 ? "s" : ""}, 0 errors)`)
+          );
+          if (archivedCount > 0) {
+            console.log(source_default.gray(`  Skipping ${archivedCount} archived resource${archivedCount !== 1 ? "s" : ""}`));
+          }
+          const bumpType = options2.major ? "major" : options2.minor ? "minor" : options2.patch ? "patch" : null;
+          const currentVersion = org.version;
+          if (bumpType !== null) {
+            const newVersion = bumpVersion(currentVersion, bumpType);
+            const absEntryPath = (0, import_path.resolve)(entryPath);
+            const entryContent = await (0, import_promises.readFile)(absEntryPath, "utf-8");
+            const updatedContent = entryContent.replace(
+              /version:\s*['"][\d]+\.[\d]+\.[\d]+['"]/,
+              `version: '${newVersion}'`
+            );
+            await (0, import_promises.writeFile)(absEntryPath, updatedContent, "utf-8");
+            org.version = newVersion;
+          }
+          console.log("");
+          console.log(source_default.gray(`  Org:    ${orgName}`));
+          console.log(source_default.gray(`  Target: ${apiUrl} (${env2})`));
+          console.log(
+            source_default.gray(`  Version: ${source_default.white(org.version)}${bumpType !== null ? ` (${bumpType} bump)` : ""}`)
+          );
+          console.log("");
+          for (const w of activeWorkflows) {
+            console.log(source_default.gray(`  workflow  ${source_default.white(w.config.resourceId)}  v${w.config.version}`));
+          }
+          for (const a of activeAgents) {
+            console.log(source_default.gray(`  agent     ${source_default.white(a.config.resourceId)}  v${a.config.version}`));
+          }
+          console.log("");
+        } catch (error46) {
+          if (error46 instanceof RegistryValidationError) {
+            validateSpinner.fail(source_default.red("Validation failed"));
+            console.error("");
+            console.error(source_default.red(`  ERROR  ${error46.message}`));
+            if (error46.resourceId) {
+              console.error(source_default.gray(`  Resource: ${error46.resourceId}`));
+            }
+            console.error("");
+            console.error(source_default.gray("  Deploy aborted."));
+          }
+          throw error46;
         }
-        console.log("");
-        console.log(source_default.gray(`  Org:    ${orgName}`));
-        console.log(source_default.gray(`  Target: ${apiUrl} (${env2})`));
-        console.log("");
-        for (const w of activeWorkflows) {
-          console.log(source_default.gray(`  workflow  ${source_default.white(w.config.resourceId)}  v${w.config.version}`));
+        await generateResourceMap(org);
+        await generateProjectMap(org);
+        let documentation = await scanDocumentation();
+        if (documentation) {
+          await generateNavigationMap(documentation);
+          documentation = await scanDocumentation();
+          console.log(
+            source_default.gray(
+              `  docs    ${source_default.white(String(documentation.length))} file${documentation.length !== 1 ? "s" : ""}`
+            )
+          );
         }
-        for (const a of activeAgents) {
-          console.log(source_default.gray(`  agent     ${source_default.white(a.config.resourceId)}  v${a.config.version}`));
+        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" : ""}`
+            )
+          );
         }
-        console.log("");
-      } catch (error46) {
-        if (error46 instanceof RegistryValidationError) {
-          validateSpinner.fail(source_default.red("Validation failed"));
-          console.error("");
-          console.error(source_default.red(`  ERROR  ${error46.message}`));
-          if (error46.resourceId) {
-            console.error(source_default.gray(`  Resource: ${error46.resourceId}`));
+        const schemaWarnings = [];
+        const workflows = activeWorkflows.map((w) => extractResourceMetadata(w, schemaWarnings));
+        const agents = activeAgents.map((a) => extractResourceMetadata(a, schemaWarnings));
+        if (schemaWarnings.length > 0) {
+          for (const warning of schemaWarnings) {
+            console.log(source_default.yellow(`  warn  ${warning}`));
           }
-          console.error("");
-          console.error(source_default.gray("  Deploy aborted."));
-        }
-        throw error46;
-      }
-      await generateResourceMap(org);
-      await generateProjectMap(org);
-      let documentation = await scanDocumentation();
-      if (documentation) {
-        await generateNavigationMap(documentation);
-        documentation = await scanDocumentation();
-        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 = activeWorkflows.map((w) => extractResourceMetadata(w, schemaWarnings));
-      const agents = activeAgents.map((a) => extractResourceMetadata(a, schemaWarnings));
-      if (schemaWarnings.length > 0) {
-        for (const warning of schemaWarnings) {
-          console.log(source_default.yellow(`  warn  ${warning}`));
+          console.log(source_default.gray("  Schemas will be unavailable on the platform for these resources."));
+          console.log("");
         }
-        console.log(source_default.gray("  Schemas will be unavailable on the platform for these resources."));
-        console.log("");
-      }
-      const bundleSpinner = ora("Bundling...").start();
-      const wrapperPath = (0, import_path.resolve)("__elevasis_worker.ts");
-      const bundleOutfile = (0, import_path.resolve)("dist/bundle.js");
-      try {
-        const entryImport = entryPath.replace(/\.ts$/, ".js");
-        const wrapperContent = `import org from ${JSON.stringify(entryImport)}
+        const bundleSpinner = ora("Bundling...").start();
+        const wrapperPath = (0, import_path.resolve)("__elevasis_worker.ts");
+        const bundleOutfile = (0, import_path.resolve)("dist/bundle.js");
+        try {
+          const entryImport = entryPath.replace(/\.ts$/, ".js");
+          const wrapperContent = `import org from ${JSON.stringify(entryImport)}
 import { startWorker } from '@elevasis/sdk/worker'
 startWorker(org)
 `;
-        await (0, import_promises.writeFile)(wrapperPath, wrapperContent, "utf-8");
-        await (0, import_promises.mkdir)((0, import_path.resolve)("dist"), { recursive: true });
-        const esbuild = getEsbuild();
-        await esbuild.build({
-          entryPoints: [wrapperPath],
-          bundle: true,
-          platform: "node",
-          format: "cjs",
-          outfile: bundleOutfile
-        });
-        await (0, import_promises.unlink)(wrapperPath);
-        const bundleBuffer = await (0, import_promises.readFile)(bundleOutfile);
-        const bundleSizeKB = Math.round(bundleBuffer.length / 1024);
-        bundleSpinner.succeed(
-          source_default.green("Bundling...") + source_default.white("                done") + source_default.gray(` (${bundleSizeKB} KB)`)
-        );
-      } catch (error46) {
-        try {
+          await (0, import_promises.writeFile)(wrapperPath, wrapperContent, "utf-8");
+          await (0, import_promises.mkdir)((0, import_path.resolve)("dist"), { recursive: true });
+          const esbuild = getEsbuild();
+          await esbuild.build({
+            entryPoints: [wrapperPath],
+            bundle: true,
+            platform: "node",
+            format: "cjs",
+            outfile: bundleOutfile
+          });
           await (0, import_promises.unlink)(wrapperPath);
-        } catch {
-        }
-        bundleSpinner.fail(source_default.red("Bundling failed"));
-        throw error46;
-      }
-      const uploadSpinner = ora("Uploading...").start();
-      try {
-        const bundleBuffer = await (0, import_promises.readFile)(bundleOutfile);
-        const apiKey = resolveApiKey(options2.prod);
-        if (!apiKey) {
-          uploadSpinner.fail(source_default.red("Missing API key environment variable"));
-          console.error(source_default.gray("  Set it in your .env file or shell environment:"));
-          if (!options2.prod && process.env.NODE_ENV === "development") {
-            console.error(source_default.gray("    ELEVASIS_PLATFORM_KEY_DEV=sk_...  (or ELEVASIS_PLATFORM_KEY as fallback)"));
-          } else {
-            console.error(source_default.gray("    ELEVASIS_PLATFORM_KEY=sk_..."));
+          const bundleBuffer = await (0, import_promises.readFile)(bundleOutfile);
+          const bundleSizeKB = Math.round(bundleBuffer.length / 1024);
+          bundleSpinner.succeed(
+            source_default.green("Bundling...") + source_default.white("                done") + source_default.gray(` (${bundleSizeKB} KB)`)
+          );
+        } catch (error46) {
+          try {
+            await (0, import_promises.unlink)(wrapperPath);
+          } catch {
           }
-          throw new Error("Missing API key environment variable");
+          bundleSpinner.fail(source_default.red("Bundling failed"));
+          throw error46;
         }
-        const metadata = {
-          sdkVersion: SDK_VERSION,
-          mode: env2,
-          resources: { workflows, agents },
-          ...documentation ? { documentation } : {},
-          ...org.relationships ? { relationships: org.relationships } : {}
-        };
-        const form = new FormData();
-        form.append("bundle", new Blob([bundleBuffer]), "bundle.js");
-        form.append("metadata", JSON.stringify(metadata));
-        const response = await fetch(`${apiUrl}/api/external/deploy`, {
-          method: "POST",
-          headers: { Authorization: `Bearer ${apiKey}` },
-          body: form
-        });
-        if (!response.ok) {
-          const errorText = await response.text();
-          uploadSpinner.fail(source_default.red("Upload failed"));
-          console.error(source_default.red(`  ${response.status}: ${errorText}`));
-          throw new Error(`Deploy upload failed (${response.status}): ${errorText}`);
-        }
-        const result = await response.json();
-        uploadSpinner.succeed(source_default.green("Uploading...") + source_default.white("               done"));
-        const totalResources = activeWorkflows.length + activeAgents.length;
-        const elapsed = ((Date.now() - startTime) / 1e3).toFixed(1);
-        if (result.status === "active") {
-          console.log("");
-          console.log(
-            source_default.green.bold(`  Deployed! ${totalResources} resource${totalResources !== 1 ? "s" : ""} live.`)
-          );
-          if (result.deployId) {
-            console.log(source_default.gray(`  Version:  ${result.deployId}`));
+        const uploadSpinner = ora("Uploading...").start();
+        try {
+          const bundleBuffer = await (0, import_promises.readFile)(bundleOutfile);
+          const apiKey = resolveApiKey(options2.prod);
+          if (!apiKey) {
+            uploadSpinner.fail(source_default.red("Missing API key environment variable"));
+            console.error(source_default.gray("  Set it in your .env file or shell environment:"));
+            if (!options2.prod && process.env.NODE_ENV === "development") {
+              console.error(
+                source_default.gray("    ELEVASIS_PLATFORM_KEY_DEV=sk_...  (or ELEVASIS_PLATFORM_KEY as fallback)")
+              );
+            } else {
+              console.error(source_default.gray("    ELEVASIS_PLATFORM_KEY=sk_..."));
+            }
+            throw new Error("Missing API key environment variable");
           }
-          console.log(source_default.gray(`  Duration: ${elapsed}s`));
-        } else if (result.status === "failed") {
-          console.log("");
-          console.log(source_default.red.bold("  Deploy failed."));
-          if (result.error) {
-            console.error(source_default.red(`  ${result.error}`));
+          const metadata = {
+            sdkVersion: SDK_VERSION,
+            deploymentVersion: org.version,
+            mode: env2,
+            resources: { workflows, agents },
+            ...documentation ? { documentation } : {},
+            ...org.relationships ? { relationships: org.relationships } : {}
+          };
+          const form = new FormData();
+          form.append("bundle", new Blob([bundleBuffer]), "bundle.js");
+          form.append("metadata", JSON.stringify(metadata));
+          const response = await fetch(`${apiUrl}/api/external/deploy`, {
+            method: "POST",
+            headers: { Authorization: `Bearer ${apiKey}` },
+            body: form
+          });
+          if (!response.ok) {
+            const errorText = await response.text();
+            uploadSpinner.fail(source_default.red("Upload failed"));
+            console.error(source_default.red(`  ${response.status}: ${errorText}`));
+            throw new Error(`Deploy upload failed (${response.status}): ${errorText}`);
+          }
+          const result = await response.json();
+          uploadSpinner.succeed(source_default.green("Uploading...") + source_default.white("               done"));
+          const totalResources = activeWorkflows.length + activeAgents.length;
+          const elapsed = ((Date.now() - startTime) / 1e3).toFixed(1);
+          if (result.status === "active") {
+            console.log("");
+            console.log(
+              source_default.green.bold(`  Deployed! ${totalResources} resource${totalResources !== 1 ? "s" : ""} live.`)
+            );
+            console.log(source_default.gray(`  Version:  ${source_default.white(`v${org.version}`)}`));
+            console.log(source_default.gray(`  Duration: ${elapsed}s`));
+          } else if (result.status === "failed") {
+            console.log("");
+            console.log(source_default.red.bold("  Deploy failed."));
+            if (result.error) {
+              console.error(source_default.red(`  ${result.error}`));
+            }
+            throw new Error(`Deploy failed: ${result.error ?? "unknown error"}`);
+          } else {
+            console.log("");
+            console.log(source_default.yellow(`  Deploy status: ${result.status ?? "unknown"}`));
+            if (result.deployId) {
+              console.log(source_default.gray(`  Version: ${result.deployId}`));
+            }
           }
-          throw new Error(`Deploy failed: ${result.error ?? "unknown error"}`);
-        } else {
-          console.log("");
-          console.log(source_default.yellow(`  Deploy status: ${result.status ?? "unknown"}`));
-          if (result.deployId) {
-            console.log(source_default.gray(`  Version: ${result.deployId}`));
+        } catch (error46) {
+          if (uploadSpinner.isSpinning) {
+            uploadSpinner.fail(source_default.red("Deploy failed"));
           }
+          throw error46;
         }
-      } catch (error46) {
-        if (uploadSpinner.isSpinning) {
-          uploadSpinner.fail(source_default.red("Deploy failed"));
-        }
-        throw error46;
       }
-    })
+    )
   );
 }
 
@@ -47024,7 +47057,7 @@ paths:
 - Organize by business domain: \`src/<domain>/\` (e.g., \`src/operations/\`, \`src/acquisition/\`)
 - Each domain barrel (\`src/<domain>/index.ts\`) exports \`workflows\` and \`agents\` arrays
 - Cross-domain utilities go in \`src/shared/\`; domain-specific utilities in \`src/<domain>/shared/\`
-- The default export in \`src/index.ts\` must be an \`OrganizationResources\` object
+- The default export in \`src/index.ts\` must be a \`DeploymentSpec\` object
 - \`resourceId\` must be lowercase with hyphens, unique per organization
 - \`dist/\` is generated by deploy -- never commit it
 
@@ -47483,11 +47516,11 @@ process.exit(0)
 
 // src/cli/commands/templates/core/resources.ts
 function starterTemplate() {
-  return `import type { OrganizationResources } from '@elevasis/sdk'
+  return `import type { DeploymentSpec } from '@elevasis/sdk'
 import * as operations from './operations/index.js'
 import * as example from './example/index.js'
 
-const org: OrganizationResources = {
+const org: DeploymentSpec = {
   workflows: [
     ...operations.workflows,
     ...example.workflows,

package/dist/index.d.ts

@@ -2310,6 +2310,7 @@ type Database = {
                 Row: {
                     compiled_docs: Json | null;
                     created_at: string;
+                    deployment_version: string | null;
                     documentation: Json | null;
                     error_message: string | null;
                     id: string;
@@ -2324,6 +2325,7 @@ type Database = {
                 Insert: {
                     compiled_docs?: Json | null;
                     created_at?: string;
+                    deployment_version?: string | null;
                     documentation?: Json | null;
                     error_message?: string | null;
                     id?: string;
@@ -2338,6 +2340,7 @@ type Database = {
                 Update: {
                     compiled_docs?: Json | null;
                     created_at?: string;
+                    deployment_version?: string | null;
                     documentation?: Json | null;
                     error_message?: string | null;
                     id?: string;
@@ -3475,6 +3478,8 @@ interface RemoteOrgConfig {
     toolCredentials?: Record<string, string>;
     /** SDK version used to deploy this bundle */
     sdkVersion?: string;
+    /** Deployment version (semver) of the deployed bundle */
+    deploymentVersion?: string;
 }
 /**
  * Organization-specific resource collection
@@ -3482,7 +3487,9 @@ interface RemoteOrgConfig {
  * Complete manifest of all automation resources for an organization.
  * Used by ResourceRegistry for discovery and Command View for visualization.
  */
-interface OrganizationResources {
+interface DeploymentSpec {
+    /** Deployment version (semver) */
+    version: string;
     /** Workflow definitions */
     workflows?: WorkflowDefinition[];
     /** Agent definitions */
@@ -3501,7 +3508,7 @@ interface OrganizationResources {
 /**
  * Organization Registry type
  */
-type OrganizationRegistry = Record<string, OrganizationResources>;
+type OrganizationRegistry = Record<string, DeploymentSpec>;
 declare class ResourceRegistry {
     private registry;
     /**
@@ -3568,7 +3575,7 @@ declare class ResourceRegistry {
      * @throws Error if incoming resourceId conflicts with a static resource
      * @throws Error if incoming deployment contains duplicate resourceIds
      */
-    registerOrganization(orgName: string, org: OrganizationResources, remote: RemoteOrgConfig): void;
+    registerOrganization(orgName: string, org: DeploymentSpec, remote: RemoteOrgConfig): void;
     /**
      * Patch serialized cache with pre-serialized schemas from an external manifest.
      *
@@ -3603,7 +3610,7 @@ declare class ResourceRegistry {
      * @param orgName - Organization name
      * @param org - Resource definitions with real handlers (not stubs)
      */
-    registerStaticResources(orgName: string, org: OrganizationResources): void;
+    registerStaticResources(orgName: string, org: DeploymentSpec): void;
     /**
      * Unregister runtime-registered resources for an organization
      *
@@ -7398,4 +7405,4 @@ declare class ToolingError extends ExecutionError {
 }
 
 export { ExecutionError, RegistryValidationError, ResourceRegistry, StepType, ToolingError };
-export type { AbsoluteScheduleConfig, AcqCompany, AcqContact, AcqDeal, AcqList, AddToCampaignLead, AddToCampaignParams, AddToCampaignResult, AgentConfig, AgentConstraints, AgentDefinition, AgentMemory, FindCompanyEmailParams as AnymailfinderFindCompanyEmailParams, FindCompanyEmailResult as AnymailfinderFindCompanyEmailResult, FindDecisionMakerEmailParams as AnymailfinderFindDecisionMakerEmailParams, FindDecisionMakerEmailResult as AnymailfinderFindDecisionMakerEmailResult, FindPersonEmailParams as AnymailfinderFindPersonEmailParams, FindPersonEmailResult as AnymailfinderFindPersonEmailResult, AnymailfinderToolMap, VerifyEmailParams as AnymailfinderVerifyEmailParams, VerifyEmailResult as AnymailfinderVerifyEmailResult, ApifyToolMap, ApifyWebhookConfig, AppendRowsParams, AppendRowsResult, ApprovalToolMap, AttioToolMap, BatchUpdateParams, BatchUpdateResult, BulkDeleteLeadsParams, BulkDeleteLeadsResult, BulkImportParams, BulkImportResult, CancelHitlByDealIdParams, CancelSchedulesAndHitlByEmailParams, ClearDealFieldsParams, ClearRangeParams, ClearRangeResult, CompanyFilters, ConditionalNext, ContactFilters, Contract, CreateAttributeParams, CreateAttributeResult, CreateAutoPaymentLinkParams, CreateAutoPaymentLinkResult, CreateCheckoutSessionParams, CreateCheckoutSessionResult, CreateCompanyParams, CreateContactParams, CreateEnvelopeParams, CreateEnvelopeResult, CreateFolderParams, CreateFolderResult, CreateListParams, CreateNoteParams, CreateNoteResult, CreatePaymentLinkParams, CreatePaymentLinkResult, CreateRecordParams, CreateRecordResult, CreateScheduleInput, DeleteDealParams, DeleteNoteParams, DeleteNoteResult, DeleteRecordParams, DeleteRecordResult, DeleteRowByValueParams, DeleteRowByValueResult, DomainDefinition, DownloadDocumentParams, DownloadDocumentResult, DropboxToolMap, ElevasConfig, EmailToolMap, EnvelopeDocument, EventTriggerConfig, ExecutionContext, ExecutionInterface, ExecutionMetadata, ExecutionToolMap, FilterExpression, FilterRowsParams, FilterRowsResult, FormField, FormFieldType, FormSchema, GetDailyCampaignAnalyticsParams, GetDailyCampaignAnalyticsResult, GetEmailsParams, GetEmailsResult, GetEnvelopeParams, GetEnvelopeResult, GetHeadersParams, GetHeadersResult, GetLastRowParams, GetLastRowResult, GetPaymentLinkParams, GetPaymentLinkResult, GetRecordParams, GetRecordResult, GetRowByValueParams, GetRowByValueResult, GetSpreadsheetMetadataParams, GetSpreadsheetMetadataResult, GmailSendEmailParams, GmailSendEmailResult, GmailToolMap, GoogleSheetsToolMap, HumanCheckpointDefinition, InstantlyToolMap, IntegrationDefinition, LLMAdapterFactory, LLMGenerateRequest, LLMGenerateResponse, LLMMessage, LLMModel, LeadToolMap, LinearNext, ListAttributesParams, ListAttributesResult, ListLeadsParams, ListLeadsResult, ListNotesParams, ListNotesResult, ListObjectsResult, ListPaymentLinksParams, ListPaymentLinksResult, MarkProposalReviewedParams, MarkProposalSentParams, MethodEntry, MillionVerifierToolMap, ModelConfig, NextConfig, NotificationSDKInput, NotificationToolMap, OrganizationResources, PaginatedResult, PaginationParams, PdfToolMap, QueryRecordsParams, QueryRecordsResult, ReadSheetParams, ReadSheetResult, Recipient, RecurringScheduleConfig, RelationshipDeclaration, RelativeScheduleConfig, RemoveFromSubsequenceParams, RemoveFromSubsequenceResult, ResendGetEmailParams, ResendGetEmailResult, ResendSendEmailParams, ResendSendEmailResult, ResendToolMap, ResourceDefinition, ResourceDomain, ResourceMetricsConfig, ResourceRelationships, ResourceStatus$1 as ResourceStatus, ResourceType, RunActorParams, RunActorResult, SDKLLMGenerateParams, ScheduleOriginTracking, ScheduleTarget, ScheduleTriggerConfig, SchedulerToolMap, SendReplyParams, SendReplyResult, SetContactNurtureParams, SheetInfo, SignatureApiFieldType, SignatureApiToolMap, SigningPlace, SortCriteria, StartActorParams, StartActorResult, StepHandler, StorageDeleteInput, StorageDeleteOutput, StorageDownloadInput, StorageDownloadOutput, StorageListInput, StorageListOutput, StorageSignedUrlInput, StorageSignedUrlOutput, StorageToolMap, StorageUploadInput, StorageUploadOutput, StripeToolMap, SyncDealStageParams, TaskSchedule, TaskScheduleConfig, TombaToolMap, Tool, ToolExecutionOptions, ToolMethodMap, ToolingErrorType, TriggerConfig, TriggerDefinition, UpdateAttributeParams, UpdateAttributeResult, UpdateCloseLostReasonParams, UpdateCompanyParams, UpdateContactParams, UpdateDiscoveryDataParams, UpdateFeesParams, UpdateInterestStatusParams, UpdateInterestStatusResult, UpdateListParams, 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, AddToCampaignLead, AddToCampaignParams, AddToCampaignResult, AgentConfig, AgentConstraints, AgentDefinition, AgentMemory, FindCompanyEmailParams as AnymailfinderFindCompanyEmailParams, FindCompanyEmailResult as AnymailfinderFindCompanyEmailResult, FindDecisionMakerEmailParams as AnymailfinderFindDecisionMakerEmailParams, FindDecisionMakerEmailResult as AnymailfinderFindDecisionMakerEmailResult, FindPersonEmailParams as AnymailfinderFindPersonEmailParams, FindPersonEmailResult as AnymailfinderFindPersonEmailResult, AnymailfinderToolMap, VerifyEmailParams as AnymailfinderVerifyEmailParams, VerifyEmailResult as AnymailfinderVerifyEmailResult, ApifyToolMap, ApifyWebhookConfig, AppendRowsParams, AppendRowsResult, ApprovalToolMap, AttioToolMap, BatchUpdateParams, BatchUpdateResult, BulkDeleteLeadsParams, BulkDeleteLeadsResult, BulkImportParams, BulkImportResult, CancelHitlByDealIdParams, CancelSchedulesAndHitlByEmailParams, ClearDealFieldsParams, ClearRangeParams, ClearRangeResult, CompanyFilters, ConditionalNext, ContactFilters, Contract, CreateAttributeParams, CreateAttributeResult, CreateAutoPaymentLinkParams, CreateAutoPaymentLinkResult, CreateCheckoutSessionParams, CreateCheckoutSessionResult, CreateCompanyParams, CreateContactParams, CreateEnvelopeParams, CreateEnvelopeResult, CreateFolderParams, CreateFolderResult, CreateListParams, CreateNoteParams, CreateNoteResult, CreatePaymentLinkParams, CreatePaymentLinkResult, CreateRecordParams, CreateRecordResult, CreateScheduleInput, DeleteDealParams, DeleteNoteParams, DeleteNoteResult, DeleteRecordParams, DeleteRecordResult, DeleteRowByValueParams, DeleteRowByValueResult, DeploymentSpec, DomainDefinition, DownloadDocumentParams, DownloadDocumentResult, DropboxToolMap, ElevasConfig, EmailToolMap, EnvelopeDocument, EventTriggerConfig, ExecutionContext, ExecutionInterface, ExecutionMetadata, ExecutionToolMap, FilterExpression, FilterRowsParams, FilterRowsResult, FormField, FormFieldType, FormSchema, GetDailyCampaignAnalyticsParams, GetDailyCampaignAnalyticsResult, GetEmailsParams, GetEmailsResult, GetEnvelopeParams, GetEnvelopeResult, GetHeadersParams, GetHeadersResult, GetLastRowParams, GetLastRowResult, GetPaymentLinkParams, GetPaymentLinkResult, GetRecordParams, GetRecordResult, GetRowByValueParams, GetRowByValueResult, GetSpreadsheetMetadataParams, GetSpreadsheetMetadataResult, GmailSendEmailParams, GmailSendEmailResult, GmailToolMap, GoogleSheetsToolMap, HumanCheckpointDefinition, InstantlyToolMap, IntegrationDefinition, LLMAdapterFactory, LLMGenerateRequest, LLMGenerateResponse, LLMMessage, LLMModel, LeadToolMap, LinearNext, ListAttributesParams, ListAttributesResult, ListLeadsParams, ListLeadsResult, ListNotesParams, ListNotesResult, ListObjectsResult, ListPaymentLinksParams, ListPaymentLinksResult, MarkProposalReviewedParams, MarkProposalSentParams, MethodEntry, MillionVerifierToolMap, ModelConfig, NextConfig, NotificationSDKInput, NotificationToolMap, PaginatedResult, PaginationParams, PdfToolMap, QueryRecordsParams, QueryRecordsResult, ReadSheetParams, ReadSheetResult, Recipient, RecurringScheduleConfig, RelationshipDeclaration, RelativeScheduleConfig, RemoveFromSubsequenceParams, RemoveFromSubsequenceResult, ResendGetEmailParams, ResendGetEmailResult, ResendSendEmailParams, ResendSendEmailResult, ResendToolMap, ResourceDefinition, ResourceDomain, ResourceMetricsConfig, ResourceRelationships, ResourceStatus$1 as ResourceStatus, ResourceType, RunActorParams, RunActorResult, SDKLLMGenerateParams, ScheduleOriginTracking, ScheduleTarget, ScheduleTriggerConfig, SchedulerToolMap, SendReplyParams, SendReplyResult, SetContactNurtureParams, SheetInfo, SignatureApiFieldType, SignatureApiToolMap, SigningPlace, SortCriteria, StartActorParams, StartActorResult, StepHandler, StorageDeleteInput, StorageDeleteOutput, StorageDownloadInput, StorageDownloadOutput, StorageListInput, StorageListOutput, StorageSignedUrlInput, StorageSignedUrlOutput, StorageToolMap, StorageUploadInput, StorageUploadOutput, StripeToolMap, SyncDealStageParams, TaskSchedule, TaskScheduleConfig, TombaToolMap, Tool, ToolExecutionOptions, ToolMethodMap, ToolingErrorType, TriggerConfig, TriggerDefinition, UpdateAttributeParams, UpdateAttributeResult, UpdateCloseLostReasonParams, UpdateCompanyParams, UpdateContactParams, UpdateDiscoveryDataParams, UpdateFeesParams, UpdateInterestStatusParams, UpdateInterestStatusResult, UpdateListParams, 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

@@ -426,7 +426,7 @@ var RegistryValidationError = class extends Error {
     this.name = "RegistryValidationError";
   }
 };
-function validateOrganizationResources(orgName, resources) {
+function validateDeploymentSpec(orgName, resources) {
   const seenIds = /* @__PURE__ */ new Set();
   resources.workflows?.forEach((workflow) => {
     const id = workflow.config.resourceId;
@@ -558,7 +558,8 @@ function isZodOptional(schema) {
   return schema.isOptional();
 }
 function validateRelationships(orgName, resources) {
-  if (!resources.relationships && !resources.triggers && !resources.externalResources && !resources.humanCheckpoints) return;
+  if (!resources.relationships && !resources.triggers && !resources.externalResources && !resources.humanCheckpoints)
+    return;
   const validAgentIds = new Set(resources.agents?.map((a) => a.config.resourceId) ?? []);
   const validWorkflowIds = new Set(resources.workflows?.map((w) => w.config.resourceId) ?? []);
   const validIntegrationIds = new Set(resources.integrations?.map((i) => i.resourceId) ?? []);
@@ -3027,6 +3028,7 @@ function serializeOrganization(resources) {
   const humanCheckpoints = resources.humanCheckpoints ?? [];
   const domainDefinitions = deriveDomainDefinitions(resources);
   return {
+    version: resources.version,
     resources: {
       workflows: workflowResources,
       agents: agentResources,
@@ -3185,7 +3187,7 @@ var ResourceRegistry = class {
    */
   validateRegistry() {
     for (const [orgName, resources] of Object.entries(this.registry)) {
-      validateOrganizationResources(orgName, resources);
+      validateDeploymentSpec(orgName, resources);
     }
   }
   /**

package/dist/templates.js

@@ -1657,7 +1657,7 @@ paths:
 - Organize by business domain: \`src/<domain>/\` (e.g., \`src/operations/\`, \`src/acquisition/\`)
 - Each domain barrel (\`src/<domain>/index.ts\`) exports \`workflows\` and \`agents\` arrays
 - Cross-domain utilities go in \`src/shared/\`; domain-specific utilities in \`src/<domain>/shared/\`
-- The default export in \`src/index.ts\` must be an \`OrganizationResources\` object
+- The default export in \`src/index.ts\` must be a \`DeploymentSpec\` object
 - \`resourceId\` must be lowercase with hyphens, unique per organization
 - \`dist/\` is generated by deploy -- never commit it
 

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

@@ -26,8 +26,8 @@
  *   Worker -> Parent:  { type: 'credential-request', id, name }
  *   Parent -> Worker:  { type: 'credential-result', id, provider?, credentials?, error?, code? }
  */
-import type { OrganizationResources } from '../index.js';
+import type { DeploymentSpec } 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;
+export declare function startWorker(org: DeploymentSpec): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/sdk",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "SDK for building Elevasis organization resources",
   "type": "module",
   "bin": {

package/reference/_navigation.md

@@ -48,7 +48,7 @@ All paths are relative to `node_modules/@elevasis/sdk/reference/`.
 
 | Resource | Location | Description | When to Load |
 | --- | --- | --- | --- |
-| Writing Resources | `resources/index.mdx` | Guide to creating workflows and agents using WorkflowDefinition, AgentDefinition, and OrganizationResources with the Elevasis SDK | Building or modifying a workflow |
+| Writing Resources | `resources/index.mdx` | Guide to creating workflows and agents using WorkflowDefinition, AgentDefinition, and DeploymentSpec with the Elevasis SDK | Building or modifying a workflow |
 | Common Patterns | `resources/patterns.mdx` | Common resource patterns for Elevasis SDK developers -- sequential steps, conditional branching, platform tools, error handling, and resource status management | Building or modifying a workflow |
 | SDK Types | `resources/types.mdx` | Complete type reference for @elevasis/sdk -- package exports, re-exported platform types, ElevasConfig interface, StepHandler context, and runtime values | Looking up type signatures or SDK exports |
 

package/reference/deployment/command-center.mdx

@@ -23,7 +23,7 @@ The Command Center is the browser UI for interacting with deployed resources. Af
 
 ## Command View
 
-The Command View is a visual graph of your deployed resources. Each node is a resource (workflow, agent, trigger, integration). Edges are the relationships you declared in `OrganizationResources`.
+The Command View is a visual graph of your deployed resources. Each node is a resource (workflow, agent, trigger, integration). Edges are the relationships you declared in `DeploymentSpec`.
 
 **What you can do here:**
 
@@ -54,10 +54,10 @@ Every resource you deploy becomes a node in the graph. Some nodes are executable
 
 ### Relationships
 
-Relationships are edges in the graph. Declare them in `OrganizationResources`:
+Relationships are edges in the graph. Declare them in `DeploymentSpec`:
 
 ```typescript
-const org: OrganizationResources = {
+const org: DeploymentSpec = {
   workflows: [scoreLeadWorkflow, sendProposalWorkflow],
   relationships: {
     'score-lead': {
@@ -98,7 +98,7 @@ Keep relationships in sync with your handler code. When you add an `execution.tr
 `elevasis-sdk deploy` and `elevasis-sdk check` both validate:
 
 - Duplicate resource IDs
-- Relationship targets must exist in the same `OrganizationResources`
+- Relationship targets must exist in the same `DeploymentSpec`
 - Agent model params (provider, model name, temperature bounds)
 - Workflow step chains (`next.target` must point to existing step names)
 
@@ -106,14 +106,14 @@ Keep relationships in sync with your handler code. When you add an `execution.tr
 
 ```
 ERROR  Relationship target 'send-proposal' not found in organization resources
-ERROR  Duplicate resource ID 'score-lead' in organization
+ERROR  Duplicate resource ID 'score-lead' in deployment
 ```
 
 ### Graph Serialization
 
 The platform converts your definitions into `CommandViewNode` (one per resource) and `CommandViewEdge` (one per relationship) structures. `buildEdges()` reads your `relationships` declarations and produces edges as a pure transformation -- no runtime behavior is inferred.
 
-> **SDK takeaway:** Declare relationships in `OrganizationResources` to keep the Command View accurate as your system grows. Update declarations whenever you add or remove `execution.trigger()` calls.
+> **SDK takeaway:** Declare relationships in `DeploymentSpec` to keep the Command View accurate as your system grows. Update declarations whenever you add or remove `execution.trigger()` calls.
 
 ---
 

package/reference/framework/project-structure.mdx

@@ -12,14 +12,14 @@ loadWhen: "Understanding scaffolded files or project layout"
 
 ### `src/index.ts`
 
-The registry entry point for your workspace. This file aggregates resources from domain barrel files and re-exports them as an `OrganizationResources` default export. It does not contain workflow logic itself -- its sole job is aggregation:
+The registry entry point for your workspace. This file aggregates resources from domain barrel files and re-exports them as a `DeploymentSpec` default export. It does not contain workflow logic itself -- its sole job is aggregation:
 
 ```ts
-import type { OrganizationResources } from '@elevasis/sdk'
+import type { DeploymentSpec } from '@elevasis/sdk'
 import * as operations from './operations/index.js'
 import * as example from './example/index.js'
 
-const org: OrganizationResources = {
+const org: DeploymentSpec = {
   workflows: [
     ...operations.workflows,
     ...example.workflows,
@@ -187,7 +187,7 @@ The most important file for AI-assisted development. It provides Claude Code wit
 
 - **Project orientation** -- what an Elevasis SDK project is and how it works
 - **Project structure** -- which files contain resources, documentation, and configuration
-- **SDK patterns** -- working code examples for resource definitions, Zod schemas, and the `OrganizationResources` export
+- **SDK patterns** -- working code examples for resource definitions, Zod schemas, and the `DeploymentSpec` export
 - **CLI reference** -- all commands with flags (`check`, `deploy`, `exec`, `resources`, `executions`, `execution`, `deployments`, `env list/set/remove`)
 - **Development rules** -- conventions the agent should enforce (source in `src/`, docs in `docs/`, use `@elevasis/sdk` types only)
 

package/reference/resources/index.mdx

@@ -1,12 +1,12 @@
 ---
 title: Writing Resources
-description: Guide to creating workflows and agents using WorkflowDefinition, AgentDefinition, and OrganizationResources with the Elevasis SDK
+description: Guide to creating workflows and agents using WorkflowDefinition, AgentDefinition, and DeploymentSpec with the Elevasis SDK
 loadWhen: "Building or modifying a workflow"
 ---
 
 Resources are the building blocks of your Elevasis project. A resource is a workflow or agent definition that the platform can execute on your behalf. You define them in TypeScript, export them from a single entry point, and the platform handles scheduling, retries, logging, and execution.
 
-This page covers how to structure your resources, write step handlers, and export everything through `OrganizationResources`.
+This page covers how to structure your resources, write step handlers, and export everything through `DeploymentSpec`.
 
 ## WorkflowDefinition
 
@@ -289,14 +289,14 @@ const myAgent: AgentDefinition = {
 
 ---
 
-## OrganizationResources
+## DeploymentSpec
 
-All resources must be exported through an `OrganizationResources` default export from `src/index.ts`. This is the entry point the platform reads when you deploy.
+All resources must be exported through a `DeploymentSpec` default export from `src/index.ts`. This is the entry point the platform reads when you deploy.
 
 ```typescript
-import type { OrganizationResources } from '@elevasis/sdk';
+import type { DeploymentSpec } from '@elevasis/sdk';
 
-const org: OrganizationResources = {
+const org: DeploymentSpec = {
   workflows: [echoWorkflow, pipeline],
   agents: [
     // myAgent,

package/reference/resources/patterns.mdx

@@ -330,11 +330,11 @@ export const workflows = [sendInvoice];
 export const agents = [];
 
 // src/index.ts
-import type { OrganizationResources } from '@elevasis/sdk';
+import type { DeploymentSpec } from '@elevasis/sdk';
 import * as orders from './orders/index.js';
 import * as billing from './billing/index.js';
 
-const org: OrganizationResources = {
+const org: DeploymentSpec = {
   workflows: [
     ...orders.workflows,
     ...billing.workflows,

package/reference/resources/types.mdx

@@ -45,7 +45,7 @@ All types come from the platform core. The SDK re-exports them grouped by source
 | `ResourceStatus`        | Enum: `'dev' | 'prod'`                         |
 | `ResourceDomain`        | Domain classification for a resource            |
 | `DomainDefinition`      | Structure for grouping resources by domain      |
-| `OrganizationResources` | Top-level export shape: `{ workflows, agents }` |
+| `DeploymentSpec`        | Top-level export shape: `{ workflows, agents }` |
 | `TriggerDefinition`     | Base for trigger configuration                  |
 | `IntegrationDefinition` | Integration configuration structure             |
 | `WebhookProviderType`   | Supported webhook providers                     |

package/reference/runtime.mdx

@@ -109,7 +109,7 @@ v1 versioning is intentionally simple:
 
 ### Deletion
 
-- **Via CLI:** Remove the resource from your `OrganizationResources` export and run `elevasis-sdk deploy`. Resources absent from the new bundle are automatically deregistered from the platform.
+- **Via CLI:** Remove the resource from your `DeploymentSpec` export and run `elevasis-sdk deploy`. Resources absent from the new bundle are automatically deregistered from the platform.
 - **Via AI Studio:** The delete button unregisters the resource immediately and marks the deployment stopped.
 - **In-flight executions:** Workers already running complete normally. Deletion affects only new execution attempts.
 - **Data retention:** Execution logs and history for a deleted resource are retained for 30 days, then purged.