@elevasis/sdk 1.56.0 → 1.57.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (40) hide show
  1. package/dist/{chunk-72ZGICTR.js → chunk-3XEHBMWM.js} +1 -1
  2. package/dist/{chunk-R3J6BEPO.js → chunk-HDMMMDIR.js} +225 -67
  3. package/dist/cli.cjs +209 -109
  4. package/dist/index.d.ts +82 -20
  5. package/dist/index.js +1 -1
  6. package/dist/test-utils/index.js +2 -2
  7. package/dist/worker/index.js +2 -2
  8. package/package.json +2 -2
  9. package/reference/_navigation.md +1 -1
  10. package/reference/index.mdx +1 -1
  11. package/reference/rules/agent-start-here.md +1 -1
  12. package/reference/rules/organization-model.md +3 -2
  13. package/reference/scaffold/recipes/customize-crm-actions.md +231 -223
  14. package/reference/scaffold/recipes/extend-crm.md +4 -2
  15. package/reference/scaffold/recipes/extend-lead-gen.md +2 -2
  16. package/reference/scaffold/recipes/index.md +2 -2
  17. package/reference/scaffold/reference/contracts.md +40 -12
  18. package/reference/scaffold/reference/system-interface-capabilities.md +4 -4
  19. package/reference/sdk/cli-management.mdx +0 -4
  20. package/reference/sdk/cli.mdx +0 -4
  21. package/reference/sdk/concepts.mdx +0 -4
  22. package/reference/sdk/deployment/command-center.mdx +0 -4
  23. package/reference/sdk/framework/agent.mdx +0 -4
  24. package/reference/sdk/framework/index.mdx +0 -4
  25. package/reference/sdk/framework/project-structure.mdx +0 -4
  26. package/reference/sdk/getting-started.mdx +0 -4
  27. package/reference/sdk/index.mdx +4 -8
  28. package/reference/sdk/platform-tools/index.mdx +0 -4
  29. package/reference/sdk/resources/index.mdx +0 -4
  30. package/reference/sdk/resources/patterns.mdx +0 -4
  31. package/reference/sdk/runtime.mdx +0 -4
  32. package/reference/sdk/templates/data-enrichment.mdx +0 -4
  33. package/reference/sdk/templates/email-sender.mdx +0 -4
  34. package/reference/sdk/templates/index.mdx +0 -4
  35. package/reference/sdk/templates/lead-scorer.mdx +0 -4
  36. package/reference/sdk/templates/pdf-generator.mdx +0 -4
  37. package/reference/sdk/templates/recurring-job.mdx +0 -4
  38. package/reference/sdk/templates/text-classifier.mdx +0 -4
  39. package/reference/sdk/templates/web-scraper.mdx +0 -4
  40. package/reference/sdk/troubleshooting.mdx +0 -4
package/dist/index.js CHANGED
@@ -1,2 +1,2 @@
1
- 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, defineSingleStepWorkflow, defineTopology, defineTopologyRelationship, defineWorkflowConfig, deriveActions, diagnosticOutput, integrationInput, isBuiltInReadinessProfile, isZodType, lookupReadinessProfile, parseTopologyNodeRef, registerReadinessProfile, resolveContractRef, runDiagnostic, splitName, topologyRef, topologyRelationship, validateDeclaredSystemInterfaceReadiness, validateResourceGovernance } from './chunk-R3J6BEPO.js';
1
+ export { ActivityEventSchema, BuildPlanSnapshotStepSchema, ProspectingBuildTemplateSchema as BuildTemplateSchema, ContractRefResolutionError, CrmStageKeySchema, CrmStateKeySchema, EmailSchema, ExecutionError, ListBuilderStageKeySchema, ProcessingStageStatusSchema, RegistryValidationError, ResourceRegistry, StepType, ToolingError, bindResourceDescriptor, compileBusinessOntologyValidationIndex, compileCrmActionCatalog, compileCrmApiOntologyValidationIndex, concurrentPool, createLeadGenStageValidators, defineContract, defineResource, defineResourceOntology, defineResources, defineSingleStepWorkflow, defineTopology, defineTopologyRelationship, defineWorkflowConfig, deriveCompiledCrmActions, diagnosticOutput, integrationInput, isBuiltInReadinessProfile, isCompiledCrmActionAvailable, isZodType, lookupReadinessProfile, parseTopologyNodeRef, registerReadinessProfile, resolveContractRef, runDiagnostic, splitName, topologyRef, topologyRelationship, validateDeclaredSystemInterfaceReadiness, validateResourceGovernance } from './chunk-HDMMMDIR.js';
2
2
  export { projectDeploymentSpec, projectTopologyRelationships, toSdkResourceDescriptor, withPlatformAgentResourceDescriptor, withPlatformAgentResourceDescriptors, withPlatformIntegrationResourceDescriptor, withPlatformIntegrationResourceDescriptors, withPlatformResourceDescriptor, withPlatformResourceDescriptors } from './chunk-QF2RNYYX.js';
@@ -1,5 +1,5 @@
1
- import { executeWorkflow } from '../chunk-72ZGICTR.js';
2
- import { validateDeploymentSpec, validateRelationships } from '../chunk-R3J6BEPO.js';
1
+ import { executeWorkflow } from '../chunk-3XEHBMWM.js';
2
+ import { validateDeploymentSpec, validateRelationships } from '../chunk-HDMMMDIR.js';
3
3
  import '../chunk-QF2RNYYX.js';
4
4
  import { vi } from 'vitest';
5
5
 
@@ -1,3 +1,3 @@
1
- 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-72ZGICTR.js';
2
- import '../chunk-R3J6BEPO.js';
1
+ 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-3XEHBMWM.js';
2
+ import '../chunk-HDMMMDIR.js';
3
3
  import '../chunk-QF2RNYYX.js';
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@elevasis/sdk",
3
- "version": "1.56.0",
3
+ "version": "1.57.0",
4
4
  "description": "SDK for building Elevasis organization resources",
5
5
  "type": "module",
6
6
  "bin": {
@@ -63,8 +63,8 @@
63
63
  "typescript": "5.9.2",
64
64
  "vitest": "^3.2.4",
65
65
  "zod": "^4.1.0",
66
- "@repo/core": "0.72.0",
67
66
  "@repo/eslint-config": "0.0.0",
67
+ "@repo/core": "0.73.0",
68
68
  "@repo/typescript-config": "0.0.0"
69
69
  },
70
70
  "license": "MIT",
@@ -194,7 +194,7 @@ Universal scaffold documentation for all SDK projects. Source locations are co-l
194
194
  | Build and Extend CRM | `scaffold/recipes/extend-crm.md` | Map the CRM platform primitives available to SDK projects: shared UI pages, sidebar composition, data hooks, action definitions, workflow adapters, System Interfaces, and org-model extension boundaries. |
195
195
  | Build and Extend Lead Gen | `scaffold/recipes/extend-lead-gen.md` | Map the lead-gen platform primitives available to SDK projects: shared UI pages, provider-injected Organization Model config, data hooks, list/member state, artifacts, workflow adapters, System Interfaces, and tenant-owned extension boundaries. |
196
196
  | Build and Extend Content | `scaffold/recipes/extend-content.md` | Map the content platform primitives available to SDK projects: pipeline and step catalogs, shared review/pipeline/distribution pages, data hooks, the content workflow adapter, and org-model extension boundaries. |
197
- | Customize CRM Actions | `scaffold/recipes/customize-crm-actions.md` | Add, hide, or replace CRM deal action buttons in a template-derived project, and override default platform action workflows with project-owned implementations. |
197
+ | Customize CRM Actions | `scaffold/recipes/customize-crm-actions.md` | Add, hide, reorder, or re-implement CRM deal action buttons by authoring them in your project's Organization Model and deploying the workflows they dispatch to. |
198
198
  | Customize Knowledge Browser | `scaffold/recipes/customize-knowledge-browser.md` | Author knowledge nodes and customize the Knowledge Browser in a template-derived project -- from zero-config authoring through sidebar composition, custom dispatchers, and direct query access. |
199
199
  | Query the Knowledge Graph | `scaffold/recipes/query-the-knowledge-graph.md` | Use the `knowledge:*` CLI subcommands on `elevasis-sdk` (external projects) and `elevasis` (monorepo) to browse, inspect, and traverse the OrganizationModel knowledge graph via six mount axes. |
200
200
  | Workflow Recipes | `scaffold/operations/workflow-recipes.md` | Anatomy of a workflow, adapter usage, and trigger patterns -- runnable email-notification example replaces the trivial echo workflow. Resolves eval score 2/5 on workflow authoring. |
@@ -33,7 +33,7 @@ You do not need all three packages. A pure automation project needs only `@eleva
33
33
 
34
34
  ### @elevasis/sdk (v1.48.0)
35
35
 
36
- The primary developer package. Provides the TypeScript API for defining workflows and agents, the `elevasis-sdk` CLI for validation and deployment, and typed worker adapters for 27 platform and integration tools.
36
+ The primary developer package. Provides the TypeScript API for defining workflows and agents, the `elevasis-sdk` CLI for validation and deployment, and typed worker adapters for 28 platform and integration tools.
37
37
 
38
38
  **Install:** `pnpm add @elevasis/sdk`
39
39
 
@@ -103,7 +103,7 @@ Load first:
103
103
  - `operations/node_modules/@elevasis/sdk/reference/scaffold/reference/contracts.md`
104
104
  - `operations/node_modules/@elevasis/sdk/reference/scaffold/ui/feature-flags-and-gating.md`
105
105
  - Typed feature and surface ID constants exported from `@elevasis/core/organization-model` (`SALES_FEATURE_ID`, `PROSPECTING_LISTS_SURFACE_ID`, and the rest). Always use these constants instead of magic strings when overriding feature/surface IDs; the full list is enumerated in `.claude/rules/organization-os.md`.
106
- - The `extend-crm.md`, `extend-lead-gen.md`, and `customize-crm-actions.md` recipes listed under Class 1 -- CRM and lead gen are Organization OS + UI + hooks + workflow-adapter surfaces, and CRM action buttons are not `sales.actions` org-model config in v1 (use the recipe's provider/custom-button path).
106
+ - The `extend-crm.md`, `extend-lead-gen.md`, and `customize-crm-actions.md` recipes listed under Class 1 -- CRM and lead gen are Organization OS + UI + hooks + workflow-adapter surfaces, and CRM deal action buttons come from your own `sales.crm` ontology `actionTypes` records rather than any `sales.actions` field (the recipe shows the record shape and the provider wiring).
107
107
 
108
108
  Then inspect:
109
109
 
@@ -59,7 +59,7 @@ Bare `/om` runs the layered flow (identity → customers → offerings → roles
59
59
 
60
60
  Do not author Resource `actionKey` in the target contract. Runtime/UI routing that needs a single selectable action should read `resource.ontology.primaryAction`.
61
61
 
62
- Do not add `sales.actions` to the org model -- the v1 server-side override surface is intentionally deferred. Customize deal actions through `scaffold/recipes/customize-crm-actions.md` instead.
62
+ There is no `sales.actions` field -- do not add one. CRM deal actions are `actionTypes` records in the `sales.crm` System's `ontology` scope, each carrying `label`, `order`, `resourceId`, and `availableFrom`, with the ontology local id as the dispatch key. `compileCrmActionCatalog` turns them into the deal panel's buttons. See `scaffold/recipes/customize-crm-actions.md`.
63
63
 
64
64
  ## `System.apiInterface`
65
65
 
@@ -77,10 +77,11 @@ Do not confuse ontology `interface` records with `system.apiInterface`. Ontology
77
77
 
78
78
  ### Readiness contract authoring
79
79
 
80
- Three rules govern what you may write inside an `apiInterface`, all enforced at deploy preflight:
80
+ Four rules govern what you may write inside an `apiInterface`, all enforced at deploy preflight:
81
81
 
82
82
  - **`readinessProfile` must be declared explicitly. There is no positional fallback.** An omitted value resolves to `undefined` and produces a `missing-readiness-profile` diagnostic -- it does **not** fall back to `${systemPath}.${interfaceKey}`. That fallback was removed because it coupled profile identity to tree position: a System sitting at a path that happened to match a built-in profile id (say `sales.crm`) silently inherited that built-in's requirements without ever declaring one.
83
83
  - **A `readinessContract` must list at least one entry in `requiredCatalogs`.** An empty or omitted list no longer parses, so a contract that asserts nothing fails at deploy rather than passing silently.
84
+ - **Never declare a `readinessContract` beside a built-in profile** (`sales.lead-gen.api`, `sales.crm.api`, `sales.lead-gen.crm-handoff`). A platform validator already covers those, so a contract there would be ignored at runtime; deploy preflight and `om:doctor` reject it as `readiness-contract-on-built-in-profile`. Only contract-validated profiles such as `content.api` take one.
84
85
  - **`resourceIds` must scope real resources.** An empty array used to skip readiness validation entirely, which made deploy and runtime disagree -- deploy passed and the API then returned 503. If a stub marker exists, either scope it or remove the marker; absence is the designed opt-out.
85
86
 
86
87
  `profileForInterface` is removed. It had degraded to an identity function returning its third argument; read `apiInterface?.readinessProfile` directly.