@elevasis/sdk 1.52.1 → 1.53.0

package/dist/{chunk-XC57JNMA.js → chunk-B2KAVPNB.js}

@@ -1,4 +1,4 @@
-import { __require } from './chunk-VYWGWJRW.js';
+import { __require } from './chunk-HB7DC5LT.js';
 import { z, ZodError } from 'zod';
 
 // src/define-contract.ts
@@ -7787,6 +7787,9 @@ function getLeadGenCrmHandoffResourceIds(model) {
     (resource) => resource.systemPath === LEAD_GEN_CRM_HANDOFF_INTERFACE.systemPath && resource.ontology?.usesCatalogs?.includes(CRM_PIPELINE_CATALOG_ONTOLOGY_ID) === true
   ).map((resource) => resource.id);
 }
+function isLeadGenCrmHandoffAdopted(model) {
+  return getSystem(model, LEAD_GEN_API_INTERFACE.systemPath)?.apiInterface !== void 0 && getSystem(model, CRM_API_INTERFACE.systemPath)?.apiInterface !== void 0;
+}
 function mergeLeadGenDerivedCatalogs(model) {
   const baseCatalogTypes = model.ontology?.catalogTypes ?? {};
   const derivedCatalogTypes = {};
@@ -7835,11 +7838,14 @@ registerBuiltInReadinessProfile(LEAD_GEN_CRM_HANDOFF_INTERFACE.readinessProfile,
 registerReadinessInterfaceMarker(
   LEAD_GEN_CRM_HANDOFF_INTERFACE.systemPath,
   LEAD_GEN_CRM_HANDOFF_INTERFACE.interfaceKey,
-  (model) => ({
-    lifecycle: "active",
-    readinessProfile: LEAD_GEN_CRM_HANDOFF_INTERFACE.readinessProfile,
-    resourceIds: getLeadGenCrmHandoffResourceIds(model)
-  })
+  (model) => {
+    if (!isLeadGenCrmHandoffAdopted(model)) return void 0;
+    return {
+      lifecycle: "active",
+      readinessProfile: LEAD_GEN_CRM_HANDOFF_INTERFACE.readinessProfile,
+      resourceIds: getLeadGenCrmHandoffResourceIds(model)
+    };
+  }
 );
 function findLeadGenTemplateStepCatalog(index) {
   return Object.values(index.ontology.catalogTypes).find(

package/dist/{chunk-T6DTAP2U.js → chunk-FUOIYRIZ.js}

@@ -1,4 +1,4 @@
-import { ProcessingStageStatusSchema, ListBuilderStageKeySchema, zodToJsonSchema, LLMResponseParseError, errorToString, getErrorDetails, ExecutionError2, validateEntryPoint, validateTerminalSteps, validateStepReferences, WorkflowTimeoutError, WorkflowStalledError, WorkflowCancellationError, logWorkflowStart, detectCycle, WorkflowStepError, logStepStart, validateTerminalOutput, logStepSuccess, determineNextStep, logStepFailure, logExecutionPath, logWorkflowSuccess, logWorkflowFailure, estimateTokens, truncationCharBudget, buildIterationResponseSchema } from './chunk-XC57JNMA.js';
+import { ProcessingStageStatusSchema, ListBuilderStageKeySchema, zodToJsonSchema, LLMResponseParseError, errorToString, getErrorDetails, ExecutionError2, validateEntryPoint, validateTerminalSteps, validateStepReferences, WorkflowTimeoutError, WorkflowStalledError, WorkflowCancellationError, logWorkflowStart, detectCycle, WorkflowStepError, logStepStart, validateTerminalOutput, logStepSuccess, determineNextStep, logStepFailure, logExecutionPath, logWorkflowSuccess, logWorkflowFailure, estimateTokens, truncationCharBudget, buildIterationResponseSchema } from './chunk-B2KAVPNB.js';
 import { workerData, parentPort } from 'worker_threads';
 import { z, ZodError } from 'zod';
 import { createHmac } from 'crypto';

package/dist/{chunk-VYWGWJRW.js → chunk-HB7DC5LT.js}

@@ -14,6 +14,22 @@ function toSdkResourceDescriptor(resource, getResourceOntologyBinding) {
     systemId: resource.systemPath
   };
 }
+function projectDisplayIdentity(resourceId, local, descriptor) {
+  if (descriptor.title !== void 0 && descriptor.title !== local.name) {
+    console.warn(
+      `[deployment-spec] "${resourceId}" name disagrees with its OM descriptor \u2014 using the OM title. config.name: "${local.name}", OM title: "${descriptor.title}"`
+    );
+  }
+  if (descriptor.description !== void 0 && descriptor.description !== local.description) {
+    console.warn(
+      `[deployment-spec] "${resourceId}" description disagrees with its OM descriptor \u2014 using the OM description.`
+    );
+  }
+  return {
+    name: descriptor.title ?? local.name,
+    description: descriptor.description ?? local.description
+  };
+}
 function withPlatformResourceDescriptor(workflow, getWorkflowResourceDescriptor, getResourceOntologyBinding) {
   const resource = getWorkflowResourceDescriptor(workflow.config.resourceId);
   const sdkResource = toSdkResourceDescriptor(resource, getResourceOntologyBinding);
@@ -21,6 +37,7 @@ function withPlatformResourceDescriptor(workflow, getWorkflowResourceDescriptor,
     ...workflow,
     config: {
       ...workflow.config,
+      ...projectDisplayIdentity(sdkResource.id, workflow.config, sdkResource),
       resource: sdkResource,
       resourceId: sdkResource.id,
       type: sdkResource.kind
@@ -39,6 +56,7 @@ function withPlatformAgentResourceDescriptor(agent, getAgentResourceDescriptor,
     ...agent,
     config: {
       ...agent.config,
+      ...projectDisplayIdentity(sdkResource.id, agent.config, sdkResource),
       resource: sdkResource,
       resourceId: sdkResource.id,
       type: sdkResource.kind

package/dist/cli.cjs

@@ -46947,10 +46947,64 @@ var init_sse = __esm({
   }
 });
 
+// ../core/src/platform/api/describe-error.ts
+function parseAPIErrorEnvelope(body) {
+  try {
+    const parsed = JSON.parse(body);
+    if (parsed && typeof parsed === "object" && typeof parsed.error === "string") {
+      return parsed;
+    }
+  } catch {
+  }
+  return null;
+}
+function describeAPIError(status, envelope, options = {}) {
+  const trailer = [];
+  if (options.endpoint) trailer.push(`  Endpoint: ${options.endpoint}`);
+  if (envelope.requestId) trailer.push(`  Request ID: ${envelope.requestId}`);
+  if (envelope.fields) {
+    for (const [field2, messages] of Object.entries(envelope.fields)) {
+      trailer.push(`  ${field2}: ${messages.join("; ")}`);
+    }
+  }
+  const suffix = trailer.length > 0 ? `
+${trailer.join("\n")}` : "";
+  if (status === 403) {
+    return `403 Access denied: ${envelope.error}
+  The API refused this deliberately -- the request reached the handler and was rejected,
+  so nothing was written. Usual causes, in order of likelihood:
+    - the role on this organization membership lacks the required permission
+    - a row-level security policy refused the row
+    - the credential is scoped to a different organization than the one addressed` + suffix;
+  }
+  if (status === 401) {
+    return `401 Unauthorized: ${envelope.error}
+  The credential was missing, malformed, or not accepted. This is authentication,
+  not permission -- a valid credential that lacks access returns 403 instead.` + suffix;
+  }
+  if (status === 404) {
+    return `404 Not found: ${envelope.error}
+  Check the identifier. Deployed resources carry a suffix (e.g. '-workflow'), and a
+  resource in another organization reads as absent rather than forbidden.` + suffix;
+  }
+  if (status === 429) {
+    const retry = envelope.retryAfter ? ` Retry in ${envelope.retryAfter}s.` : "";
+    return `429 Rate limited: ${envelope.error}${retry}${suffix}`;
+  }
+  const label = envelope.code ? `${status} ${envelope.code}` : String(status);
+  return `API request failed (${label}): ${envelope.error}${suffix}`;
+}
+var init_describe_error = __esm({
+  "../core/src/platform/api/describe-error.ts"() {
+    "use strict";
+  }
+});
+
 // ../core/src/platform/api/index.ts
 var init_api2 = __esm({
   "../core/src/platform/api/index.ts"() {
     "use strict";
+    init_describe_error();
   }
 });
 
@@ -48452,6 +48506,9 @@ function getLeadGenCrmHandoffResourceIds(model) {
     (resource) => resource.systemPath === LEAD_GEN_CRM_HANDOFF_INTERFACE.systemPath && resource.ontology?.usesCatalogs?.includes(CRM_PIPELINE_CATALOG_ONTOLOGY_ID) === true
   ).map((resource) => resource.id);
 }
+function isLeadGenCrmHandoffAdopted(model) {
+  return getSystem(model, LEAD_GEN_API_INTERFACE.systemPath)?.apiInterface !== void 0 && getSystem(model, CRM_API_INTERFACE.systemPath)?.apiInterface !== void 0;
+}
 function mergeLeadGenDerivedCatalogs(model) {
   const baseCatalogTypes = model.ontology?.catalogTypes ?? {};
   const derivedCatalogTypes = {};
@@ -48482,6 +48539,7 @@ var init_ontology_validation = __esm({
     init_ontology();
     init_systems();
     init_migration_helpers();
+    init_helpers();
     init_engine();
     LEAD_GEN_API_INTERFACE = SYSTEM_INTERFACE_PROFILES[0];
     CRM_API_INTERFACE = SYSTEM_INTERFACE_PROFILES[1];
@@ -48563,11 +48621,14 @@ var init_ontology_validation = __esm({
     registerReadinessInterfaceMarker(
       LEAD_GEN_CRM_HANDOFF_INTERFACE.systemPath,
       LEAD_GEN_CRM_HANDOFF_INTERFACE.interfaceKey,
-      (model) => ({
-        lifecycle: "active",
-        readinessProfile: LEAD_GEN_CRM_HANDOFF_INTERFACE.readinessProfile,
-        resourceIds: getLeadGenCrmHandoffResourceIds(model)
-      })
+      (model) => {
+        if (!isLeadGenCrmHandoffAdopted(model)) return void 0;
+        return {
+          lifecycle: "active",
+          readinessProfile: LEAD_GEN_CRM_HANDOFF_INTERFACE.readinessProfile,
+          resourceIds: getLeadGenCrmHandoffResourceIds(model)
+        };
+      }
     );
   }
 });
@@ -49273,7 +49334,12 @@ async function request(method, endpoint, apiUrl, body) {
     if (GATEWAY_STATUSES.has(response.status)) {
       throw new Error(describeGatewayFailure(response.status, endpoint, elapsedMs));
     }
-    throw new Error(`API request failed (${response.status}): ${errorText}`);
+    const envelope = parseAPIErrorEnvelope(errorText);
+    if (envelope) {
+      throw new Error(describeAPIError(response.status, envelope, { endpoint }));
+    }
+    throw new Error(`API request failed (${response.status}): ${errorText}
+  Endpoint: ${endpoint}`);
   }
   if (response.status === 204) {
     return {};
@@ -49296,6 +49362,7 @@ var DEFAULT_TIMEOUT_MS, GATEWAY_STATUSES;
 var init_api_client = __esm({
   "src/cli/api-client.ts"() {
     "use strict";
+    init_src();
     init_config2();
     init_readiness_failure();
     DEFAULT_TIMEOUT_MS = 2 * 60 * 60 * 1e3;
@@ -49308,7 +49375,7 @@ function wrapAction(commandName, fn) {
   return async (...args) => {
     try {
       await fn(...args);
-      process.exitCode = 0;
+      process.exitCode ??= 0;
     } catch (error46) {
       const errorMessage = error46 instanceof Error ? error46.message : String(error46);
       console.error(source_default.red("\nError:"), errorMessage);
@@ -49330,7 +49397,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@elevasis/sdk",
-      version: "1.52.1",
+      version: "1.53.0",
       description: "SDK for building Elevasis organization resources",
       type: "module",
       bin: {
@@ -58735,6 +58802,13 @@ function mergeOmDoctorDiagnostics(report, extra, options = {}) {
   const summary = summarize(merged);
   return { ...report, ok: summary.error === 0, summary, diagnostics: merged };
 }
+function requireDeployedUnavailableDiagnostic(unavailableReason) {
+  return {
+    severity: "error",
+    code: "deployed-readiness-unavailable",
+    message: `--require-deployed was set but the deployed-snapshot readiness check did not run: ${unavailableReason}`
+  };
+}
 function formatDiagnostic(diagnostic) {
   const target = diagnostic.targetId ? ` (${diagnostic.targetId})` : "";
   const source = diagnostic.source ? ` [${diagnostic.source}]` : "";
@@ -58769,9 +58843,15 @@ function formatOmDoctorReport(report) {
 // src/cli/commands/om/doctor.ts
 function registerOmDoctorCommand(program3) {
   program3.command("om:doctor").description(
-    "Reduced model doctor \u2014 runs 3 of the platform's 5 checks, plus deployed readiness\n  Checks: ontology references, knowledge links, rename-orphan hints\n  NOT run (monorepo-only): UI-manifest consistency, contract-ref resolution\n  Readiness is read from the deployed snapshot; it reports NOT RUN when offline\n  Example: elevasis-sdk om:doctor\n  Example: elevasis-sdk om:doctor --scope sales.crm\n  Example: elevasis-sdk om:doctor --skip-deployed\n  Example: elevasis-sdk om:doctor --json"
-  ).option("--json", "Output as grouped JSON envelope").option("--scope <systemPath>", "Limit diagnostics to a system path and descendants").option("--skip-deployed", "Structural checks only \u2014 do not ask the API about readiness").option("--prod", "Target production (overrides NODE_ENV=development)").option("--api-url <url>", "API URL").action(
+    "Reduced model doctor \u2014 runs 3 of the platform's 5 checks, plus deployed readiness\n  Checks: ontology references, knowledge links, rename-orphan hints\n  NOT run (monorepo-only): UI-manifest consistency, contract-ref resolution\n  Readiness is read from the deployed snapshot; it reports NOT RUN when offline\n  Example: elevasis-sdk om:doctor\n  Example: elevasis-sdk om:doctor --scope sales.crm\n  Example: elevasis-sdk om:doctor --skip-deployed\n  Example: elevasis-sdk om:doctor --require-deployed\n  Example: elevasis-sdk om:doctor --json"
+  ).option("--json", "Output as grouped JSON envelope").option("--scope <systemPath>", "Limit diagnostics to a system path and descendants").option("--skip-deployed", "Structural checks only \u2014 do not ask the API about readiness").option(
+    "--require-deployed",
+    "Fail (non-zero exit) if the deployed-snapshot readiness check is unavailable \u2014 API unreachable or no platform key \u2014 instead of the default degraded pass. Opt-in: default behavior is unchanged, and this is rejected together with --skip-deployed."
+  ).option("--prod", "Target production (overrides NODE_ENV=development)").option("--api-url <url>", "API URL").action(
     wrapAction("om:doctor", async (options) => {
+      if (options.requireDeployed && options.skipDeployed) {
+        throw new Error("--require-deployed and --skip-deployed are mutually exclusive");
+      }
       let report;
       try {
         const projectRoot = getProjectRoot();
@@ -58786,6 +58866,13 @@ function registerOmDoctorCommand(program3) {
           });
           if (readiness.unavailableReason !== void 0) {
             report.sources.readinessUnavailableReason = readiness.unavailableReason;
+            if (options.requireDeployed) {
+              report = mergeOmDoctorDiagnostics(
+                report,
+                [requireDeployedUnavailableDiagnostic(readiness.unavailableReason)],
+                { scope: options.scope }
+              );
+            }
           } else {
             report.sources.readiness = {
               activeDeploymentId: readiness.activeDeploymentId,

package/dist/index.js

@@ -1,2 +1,2 @@
-export { ActivityEventSchema, BuildPlanSnapshotStepSchema, ProspectingBuildTemplateSchema as BuildTemplateSchema, ContractRefResolutionError, CrmStageKeySchema, CrmStateKeySchema, EmailSchema, ExecutionError, ListBuilderStageKeySchema, ProcessingStageStatusSchema, RegistryValidationError, ResourceRegistry, StepType, ToolingError, bindResourceDescriptor, compileBusinessOntologyValidationIndex, concurrentPool, createLeadGenStageValidators, defineContract, defineResource, defineResourceOntology, defineResources, defineStep, defineTopology, defineTopologyRelationship, defineWorkflow, defineWorkflowConfig, deriveActions, diagnosticOutput, integrationInput, isBuiltInReadinessProfile, isZodType, lookupReadinessProfile, parseTopologyNodeRef, registerReadinessProfile, resolveContractRef, runDiagnostic, splitName, topologyRef, topologyRelationship, validateDeclaredSystemInterfaceReadiness, validateResourceGovernance } from './chunk-XC57JNMA.js';
-export { projectDeploymentSpec, projectTopologyRelationships, toSdkResourceDescriptor, withPlatformAgentResourceDescriptor, withPlatformAgentResourceDescriptors, withPlatformIntegrationResourceDescriptor, withPlatformIntegrationResourceDescriptors, withPlatformResourceDescriptor, withPlatformResourceDescriptors } from './chunk-VYWGWJRW.js';
+export { ActivityEventSchema, BuildPlanSnapshotStepSchema, ProspectingBuildTemplateSchema as BuildTemplateSchema, ContractRefResolutionError, CrmStageKeySchema, CrmStateKeySchema, EmailSchema, ExecutionError, ListBuilderStageKeySchema, ProcessingStageStatusSchema, RegistryValidationError, ResourceRegistry, StepType, ToolingError, bindResourceDescriptor, compileBusinessOntologyValidationIndex, concurrentPool, createLeadGenStageValidators, defineContract, defineResource, defineResourceOntology, defineResources, defineStep, defineTopology, defineTopologyRelationship, defineWorkflow, defineWorkflowConfig, deriveActions, diagnosticOutput, integrationInput, isBuiltInReadinessProfile, isZodType, lookupReadinessProfile, parseTopologyNodeRef, registerReadinessProfile, resolveContractRef, runDiagnostic, splitName, topologyRef, topologyRelationship, validateDeclaredSystemInterfaceReadiness, validateResourceGovernance } from './chunk-B2KAVPNB.js';
+export { projectDeploymentSpec, projectTopologyRelationships, toSdkResourceDescriptor, withPlatformAgentResourceDescriptor, withPlatformAgentResourceDescriptors, withPlatformIntegrationResourceDescriptor, withPlatformIntegrationResourceDescriptors, withPlatformResourceDescriptor, withPlatformResourceDescriptors } from './chunk-HB7DC5LT.js';

package/dist/node/index.js

@@ -1,4 +1,4 @@
-export { projectDeploymentSpec, projectTopologyRelationships, toSdkResourceDescriptor, withPlatformAgentResourceDescriptor, withPlatformAgentResourceDescriptors, withPlatformIntegrationResourceDescriptor, withPlatformIntegrationResourceDescriptors, withPlatformResourceDescriptor, withPlatformResourceDescriptors } from '../chunk-VYWGWJRW.js';
+export { projectDeploymentSpec, projectTopologyRelationships, toSdkResourceDescriptor, withPlatformAgentResourceDescriptor, withPlatformAgentResourceDescriptors, withPlatformIntegrationResourceDescriptor, withPlatformIntegrationResourceDescriptors, withPlatformResourceDescriptor, withPlatformResourceDescriptors } from '../chunk-HB7DC5LT.js';
 import { readFileSync, mkdirSync, writeFileSync, readdirSync } from 'fs';
 import { relative, dirname, resolve, join, extname } from 'path';
 import { compile } from '@mdx-js/mdx';

package/dist/test-utils/index.js

@@ -1,6 +1,6 @@
-import { executeWorkflow } from '../chunk-T6DTAP2U.js';
-import { validateDeploymentSpec, validateRelationships } from '../chunk-XC57JNMA.js';
-import '../chunk-VYWGWJRW.js';
+import { executeWorkflow } from '../chunk-FUOIYRIZ.js';
+import { validateDeploymentSpec, validateRelationships } from '../chunk-B2KAVPNB.js';
+import '../chunk-HB7DC5LT.js';
 import { vi } from 'vitest';
 
 // src/test-utils/workflow.ts

package/dist/worker/index.js

@@ -1,3 +1,3 @@
-export { ListBuilderResultSchema, ListBuilderResultsSchema, PlatformToolError, acqDb, approval, artifacts, classifyPlatformToolError, content, createAdapter, createAnymailfinderAdapter, createApifyAdapter, createAttioAdapter, createCaptionGenerationWorkflow, createCaptureInstagramMetricsWorkflow, createClickUpAdapter, createDropboxAdapter, createGmailAdapter, createGoogleSheetsAdapter, createImageAnalysisWorkflow, createInstagramAdapter, createInstantlyAdapter, createMillionVerifierAdapter, createPublishInstagramWorkflow, createResendAdapter, createSignatureApiAdapter, createStripeAdapter, createTombaAdapter, crm, email, executeWorkflow, execution, generateHmacToken, list, listBuilderWorkflow, llm, notifications, pdf, platform, projects, scheduler, startWorker, storage, toContentMetrics } from '../chunk-T6DTAP2U.js';
-import '../chunk-XC57JNMA.js';
-import '../chunk-VYWGWJRW.js';
+export { ListBuilderResultSchema, ListBuilderResultsSchema, PlatformToolError, acqDb, approval, artifacts, classifyPlatformToolError, content, createAdapter, createAnymailfinderAdapter, createApifyAdapter, createAttioAdapter, createCaptionGenerationWorkflow, createCaptureInstagramMetricsWorkflow, createClickUpAdapter, createDropboxAdapter, createGmailAdapter, createGoogleSheetsAdapter, createImageAnalysisWorkflow, createInstagramAdapter, createInstantlyAdapter, createMillionVerifierAdapter, createPublishInstagramWorkflow, createResendAdapter, createSignatureApiAdapter, createStripeAdapter, createTombaAdapter, crm, email, executeWorkflow, execution, generateHmacToken, list, listBuilderWorkflow, llm, notifications, pdf, platform, projects, scheduler, startWorker, storage, toContentMetrics } from '../chunk-FUOIYRIZ.js';
+import '../chunk-B2KAVPNB.js';
+import '../chunk-HB7DC5LT.js';

package/package.json

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

package/reference/rules/deployment.md

@@ -56,6 +56,18 @@ Deploy accepts `--major`, `--minor`, `--patch` flags to bump the deployment vers
 1. **Bundle:** esbuild compiles `operations/src/index.ts` + all dependencies into a single self-contained CJS file. No `node_modules` needed at runtime.
 2. **Metadata:** Resource definitions, OM Resources descriptor bindings, Zod schemas (converted to JSON Schema), relationships, triggers.
 
+## The OM Descriptor Owns Display Identity
+
+A resource's `name` and `description` in its `operations/src/**` config are **not** what the platform shows. At deploy time the projected spec takes `title` and `description` from that resource's OM descriptor in `core/config/organization-model.ts` and overrides the locally declared strings, because the descriptor is what Command Center's action surfaces render and a config string only ever reached the execution log.
+
+Deploy warns per resource when the two disagree:
+
+```text
+[deployment-spec] "<resource-id>" name disagrees with its OM descriptor -- using the OM title.
+```
+
+That warning does not fail the deploy. Fix it by editing the OM descriptor when the descriptor is wrong, or the config when the config is. Editing only the config and redeploying changes nothing a user sees.
+
 ## Environment
 
 - `ELEVASIS_PLATFORM_KEY` in `.env` is required for CLI auth (used for every deploy unless `NODE_ENV=development` with no `--prod`)