@elevasis/sdk 1.2.0 → 1.4.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 (35) hide show
  1. package/dist/cli.cjs +16 -5
  2. package/dist/index.d.ts +476 -49
  3. package/dist/types/worker/adapters/index.d.ts +1 -0
  4. package/dist/types/worker/adapters/lead.d.ts +1 -1
  5. package/dist/types/worker/adapters/list.d.ts +9 -0
  6. package/dist/worker/index.js +20 -3
  7. package/package.json +7 -5
  8. package/reference/_navigation.md +64 -39
  9. package/reference/_reference-manifest.json +509 -0
  10. package/reference/cli.mdx +75 -3
  11. package/reference/deployment/index.mdx +2 -1
  12. package/reference/deployment/provided-features.mdx +259 -0
  13. package/reference/deployment/ui-execution.mdx +251 -0
  14. package/reference/index.mdx +5 -3
  15. package/reference/packages/core/src/README.md +34 -0
  16. package/reference/packages/core/src/organization-model/README.md +79 -0
  17. package/reference/packages/ui/src/api/README.md +18 -0
  18. package/reference/packages/ui/src/auth/README.md +18 -0
  19. package/reference/packages/ui/src/components/README.md +24 -0
  20. package/reference/packages/ui/src/execution/README.md +16 -0
  21. package/reference/packages/ui/src/features/README.md +28 -0
  22. package/reference/packages/ui/src/graph/README.md +16 -0
  23. package/reference/packages/ui/src/hooks/README.md +24 -0
  24. package/reference/packages/ui/src/initialization/README.md +19 -0
  25. package/reference/packages/ui/src/organization/README.md +18 -0
  26. package/reference/packages/ui/src/profile/README.md +19 -0
  27. package/reference/packages/ui/src/provider/README.md +31 -0
  28. package/reference/packages/ui/src/router/README.md +18 -0
  29. package/reference/packages/ui/src/sse/README.md +13 -0
  30. package/reference/packages/ui/src/theme/README.md +23 -0
  31. package/reference/packages/ui/src/types/README.md +16 -0
  32. package/reference/packages/ui/src/utils/README.md +18 -0
  33. package/reference/packages/ui/src/zustand/README.md +18 -0
  34. package/reference/platform-tools/adapters-platform.mdx +93 -36
  35. package/reference/resources/patterns.mdx +48 -0
@@ -23,6 +23,7 @@ export { llm } from './llm.js';
23
23
  export { storage } from './storage.js';
24
24
  export { notifications, type NotificationInput } from './notification.js';
25
25
  export { acqDb } from './lead.js';
26
+ export { list } from './list.js';
26
27
  export { pdf } from './pdf.js';
27
28
  export { approval } from './approval.js';
28
29
  export { execution } from './execution.js';
@@ -4,7 +4,7 @@
4
4
  * Typed wrapper over platform.call() for acquisition lead management.
5
5
  * Singleton export -- no credential needed (platform tool).
6
6
  *
7
- * 41 methods covering lists, companies, contacts, deals, deal-sync, enrichment, and social monitoring operations.
7
+ * 49 methods covering lists, companies, contacts, deals, deal-sync, deal notes, deal tasks, enrichment, and social monitoring operations.
8
8
  * organizationId is injected server-side by the dispatcher -- never sent from the SDK.
9
9
  */
10
10
  import { type TypedAdapter } from './create-adapter.js';
@@ -0,0 +1,9 @@
1
+ /**
2
+ * List Platform Tool Adapter
3
+ *
4
+ * Focused wrapper for list-scoped workflow operations.
5
+ * Singleton export -- no credential needed (platform tool).
6
+ */
7
+ import { type TypedAdapter } from './create-adapter.js';
8
+ import type { ListToolMap } from '../../types/index.js';
9
+ export declare const list: TypedAdapter<ListToolMap>;
@@ -4981,7 +4981,9 @@ var acqDb = createAdapter("acqDb", [
4981
4981
  "getDealByEmail",
4982
4982
  "getDealByEnvelopeId",
4983
4983
  "updateDealEnvelopeId",
4984
- "getDealByAttioId",
4984
+ "getDealById",
4985
+ "getContactById",
4986
+ "getCompanyById",
4985
4987
  // Deal-sync operations
4986
4988
  "updateDiscoveryData",
4987
4989
  "updateProposalData",
@@ -4995,14 +4997,29 @@ var acqDb = createAdapter("acqDb", [
4995
4997
  "cancelHitlByDealId",
4996
4998
  "clearDealFields",
4997
4999
  "deleteDeal",
4998
- "recordReply",
4999
5000
  "recordDealActivity",
5001
+ // Deal note operations
5002
+ "createDealNote",
5003
+ "listDealNotes",
5004
+ // Deal task operations
5005
+ "createDealTask",
5006
+ "listDealTasks",
5007
+ "listDealTasksDue",
5008
+ "completeDealTask",
5000
5009
  // Enrichment data operations
5001
5010
  "mergeEnrichmentData",
5002
5011
  // Social monitoring operations
5003
5012
  "upsertSocialPosts"
5004
5013
  ]);
5005
5014
 
5015
+ // src/worker/adapters/list.ts
5016
+ var list = createAdapter("list", [
5017
+ "getConfig",
5018
+ "recordExecution",
5019
+ "updateCompanyStage",
5020
+ "updateContactStage"
5021
+ ]);
5022
+
5006
5023
  // src/worker/adapters/pdf.ts
5007
5024
  var pdf = createAdapter("pdf", ["render", "renderToBuffer"]);
5008
5025
 
@@ -5375,4 +5392,4 @@ function startWorker(org) {
5375
5392
  });
5376
5393
  }
5377
5394
 
5378
- export { PlatformToolError, acqDb, approval, createAdapter, createAnymailfinderAdapter, createApifyAdapter, createAttioAdapter, createDropboxAdapter, createGmailAdapter, createGoogleSheetsAdapter, createInstantlyAdapter, createMillionVerifierAdapter, createResendAdapter, createSignatureApiAdapter, createStripeAdapter, createTombaAdapter, email, execution, llm, notifications, pdf, platform, scheduler, startWorker, storage };
5395
+ export { PlatformToolError, acqDb, approval, createAdapter, createAnymailfinderAdapter, createApifyAdapter, createAttioAdapter, createDropboxAdapter, createGmailAdapter, createGoogleSheetsAdapter, createInstantlyAdapter, createMillionVerifierAdapter, createResendAdapter, createSignatureApiAdapter, createStripeAdapter, createTombaAdapter, email, execution, list, llm, notifications, pdf, platform, scheduler, startWorker, storage };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@elevasis/sdk",
3
- "version": "1.2.0",
3
+ "version": "1.4.0",
4
4
  "description": "SDK for building Elevasis organization resources",
5
5
  "type": "module",
6
6
  "bin": {
@@ -44,12 +44,14 @@
44
44
  "tsup": "^8.0.0",
45
45
  "typescript": "5.9.2",
46
46
  "zod": "^4.1.0",
47
- "@repo/core": "0.0.0",
47
+ "@repo/core": "0.1.0",
48
48
  "@repo/typescript-config": "0.0.0"
49
49
  },
50
50
  "scripts": {
51
- "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.core-dts.json && tsc -p tsconfig.build.json && tsup && rollup -c rollup.dts.config.mjs && esbuild src/cli/index.ts --bundle --platform=node --outfile=dist/cli.cjs --format=cjs --external:esbuild --banner:js=\"#!/usr/bin/env node\" && node scripts/copy-reference-docs.mjs && node scripts/generate-navigation.mjs",
52
- "check-types": "tsc --noEmit",
53
- "test:bundle": "pnpm build && vitest run --config vitest.bundle.config.ts"
51
+ "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.core-dts.json && tsc -p tsconfig.build.json && tsup && rollup -c rollup.dts.config.mjs && esbuild src/cli/index.ts --bundle --platform=node --outfile=dist/cli.cjs --format=cjs --external:esbuild --banner:js=\"#!/usr/bin/env node\" && node scripts/copy-reference-docs.mjs && node ../../scripts/monorepo/generate-reference-artifacts.js",
52
+ "type-check": "tsc --noEmit",
53
+ "check-types": "pnpm type-check",
54
+ "test": "pnpm build && node ../../scripts/monorepo/validate-reference-artifacts.js && vitest run --config vitest.bundle.config.ts",
55
+ "test:bundle": "pnpm test"
54
56
  }
55
57
  }
@@ -1,66 +1,91 @@
1
1
  # SDK Reference Navigation
2
2
 
3
- Auto-generated from reference file frontmatter. 31 files indexed.
3
+ Auto-generated from the package reference manifests.
4
4
 
5
- All paths are relative to `node_modules/@elevasis/sdk/reference/`.
5
+ Package entries indexed: 36.
6
6
 
7
- ## General
7
+ ## @elevasis/core / Core
8
8
 
9
9
  | Resource | Location | Description | When to Load |
10
10
  | --- | --- | --- | --- |
11
- | CLI Reference | `cli.mdx` | Full reference for every elevasis-sdk CLI command -- validate, deploy, execute, and inspect resources | Running CLI operations |
12
- | Concepts Reference | `concepts.mdx` | Plain-English explanations of Elevasis SDK concepts -- glossary, workflow analogies, Zod schemas, execution model, platform tools, common errors, and design decisions | User asks what is or needs conceptual grounding |
13
- | Getting Started | `getting-started.mdx` | Install the Elevasis SDK, scaffold a project, and run your first deployment | Setting up a new project or onboarding |
14
- | Elevasis SDK | `index.mdx` | Build and deploy workflows, agents, and resources with the Elevasis SDK | First session or new to the SDK |
15
- | Roadmap | `roadmap.mdx` | Planned SDK features -- error taxonomy, retry semantics, circuit breaker, metrics, alerting, and resource lifecycle extensions | Asking about future features or planned capabilities |
16
- | Execution Runtime | `runtime.mdx` | How your code runs on the Elevasis platform -- execution lifecycle, concurrency, timeouts, cancellation, error handling, observability, resource limits, and v1 limitations | Debugging execution behavior or understanding the runtime model |
17
- | Common Errors | `troubleshooting.mdx` | Static SDK-level error catalog -- CLI errors, deployment errors, schema validation, platform tool failures, and runtime errors with diagnostic steps | Debugging an unknown error not found in workspace memory |
11
+ | Core | `packages/core/src/README.md` | Published core wrapper for the curated contract surface. | (not specified) |
18
12
 
19
- ## Deployment
13
+ ## @elevasis/core / Organization Model
20
14
 
21
15
  | Resource | Location | Description | When to Load |
22
16
  | --- | --- | --- | --- |
23
- | Execution API | `deployment/api.mdx` | REST endpoints for executing resources, querying execution history, and managing deployments via the Elevasis external API | Calling the API directly or debugging API responses |
24
- | Command Center | `deployment/command-center.mdx` | Post-deployment UI reference -- what each page does, the resource graph model, relationships, validation, and how SDK concepts map to Command Center actions | User asks about the Command Center UI, post-deployment workflow, monitoring, or the resource graph |
25
- | Deploying Resources | `deployment/index.mdx` | How to deploy your Elevasis SDK resources to the platform using elevasis-sdk deploy, including configuration, validation, and environment setup | Preparing to deploy or debugging deploy failures |
17
+ | Organization Model | `packages/core/src/organization-model/README.md` | Published organization-model schema, defaults, resolver, and types. | (not specified) |
26
18
 
27
- ## Framework
19
+ ## @elevasis/sdk / Getting Started
28
20
 
29
21
  | Resource | Location | Description | When to Load |
30
22
  | --- | --- | --- | --- |
31
- | Agent System | `framework/agent.mdx` | CLAUDE.md drives all agent behavior -- project instructions, slash commands, memory-based developer profile, and three-tier adaptive guidance | Configuring agent behavior or capabilities |
32
- | Development Framework | `framework/index.mdx` | The SDK scaffolds a complete development environment for Claude Code -- project instructions, slash commands, cross-session memory, template versioning, and resource documentation | Understanding the agent framework structure |
33
- | Interaction Guidance | `framework/interaction-guidance.mdx` | Full dimensional adaptation rules per skill axis -- platform navigation, API integration, automation concepts, domain expertise -- with growth tracking protocol | Unsure how to adapt for a skill combination |
34
- | Memory System | `framework/memory.mdx` | Cross-session project knowledge stored in .claude/memory/ -- deployment state, environment, decisions, and error patterns that persist between Claude Code sessions | Working with agent memory or session state |
35
- | Project Structure | `framework/project-structure.mdx` | Each file scaffolded by elevasis-sdk init and its purpose in the development workflow | Understanding scaffolded files or project layout |
36
- | Tutorial System | `framework/tutorial-system.mdx` | Reference for the SDK tutorial system -- 21-item menu across 4 sections, skill-level adaptation rules, progress tracking format, and per-lesson module contents | (not specified) |
23
+ | SDK | `index.mdx` | Root SDK types, config, runtime errors, and registry surface. | (not specified) |
37
24
 
38
- ## Platform-tools
25
+ ## @elevasis/sdk / Runtime
39
26
 
40
27
  | Resource | Location | Description | When to Load |
41
28
  | --- | --- | --- | --- |
42
- | Integration Adapters | `platform-tools/adapters-integration.mdx` | Type-safe wrappers for third-party integrations -- Attio, Stripe, Google Sheets, Instantly, SignatureAPI, Resend, Dropbox, Apify, Gmail, and Tomba -- with full autocomplete and compile-time checking | Using typed adapters for integration tools, or needs to know what integration adapter methods are available |
43
- | Platform Adapters | `platform-tools/adapters-platform.mdx` | Type-safe singleton adapters for built-in platform services -- scheduler, storage, LLM, PDF, approval, notifications, acqDb, execution, and email -- no credentials required | Using platform service adapters (scheduler, storage, llm, pdf, approval, acqDb, notifications, execution, email) |
44
- | Platform Tools | `platform-tools/index.mdx` | Access 70+ tools across integration adapters and platform services from your SDK workflows -- typed adapters, credential security model, and working code examples | Connecting to external services |
45
- | Adapter Type Safety | `platform-tools/type-safety.mdx` | SDK worker adapter type safety patterns - required fields, discriminated unions, and intentionally loose types | (not specified) |
29
+ | Worker Runtime | `runtime.mdx` | Worker runtime entrypoint, adapters, and platform execution surface. | (not specified) |
46
30
 
47
- ## Resources
31
+ ## @elevasis/ui / Components
48
32
 
49
33
  | Resource | Location | Description | When to Load |
50
34
  | --- | --- | --- | --- |
51
- | 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 |
52
- | 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 |
53
- | 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 |
35
+ | Components | `packages/ui/src/components/README.md` | Published UI component barrel for downstream applications. | (not specified) |
36
+ | Navigation Components | `packages/ui/src/components/README.md` | Published navigation component entry for downstream applications. | (not specified) |
37
+ | Chat Components | `packages/ui/src/components/README.md` | Published chat component entry for downstream applications. | (not specified) |
38
+ | Layout | `packages/ui/src/components/README.md` | Published layout component entry for downstream applications. | (not specified) |
39
+ | Charts | `packages/ui/src/components/README.md` | Published chart component entry for downstream applications. | (not specified) |
54
40
 
55
- ## Templates
41
+ ## @elevasis/ui / Features
56
42
 
57
43
  | Resource | Location | Description | When to Load |
58
44
  | --- | --- | --- | --- |
59
- | Template: Data Enrichment | `templates/data-enrichment.mdx` | LLM-powered enrichment of existing database records -- read rows, enrich each with an LLM, write results back to Supabase | Applying the data-enrichment workflow template |
60
- | Template: Email Sender | `templates/email-sender.mdx` | Transactional email via Resend with template support -- send styled emails to one or multiple recipients | Applying the email-sender workflow template |
61
- | Templates | `templates/index.mdx` | Ready-to-use workflow templates for common automation patterns -- web scraping, data enrichment, email sending, lead scoring, PDF generation, text classification, and recurring jobs | (not specified) |
62
- | Template: Lead Scorer | `templates/lead-scorer.mdx` | LLM-based lead scoring with Supabase storage -- receive a lead, score it with an LLM, store the result | Applying the lead-scorer workflow template |
63
- | Template: PDF Generator | `templates/pdf-generator.mdx` | PDF generation from structured data with platform storage upload -- render a PDF from a template and upload to platform storage | Applying the pdf-generator workflow template |
64
- | Template: Recurring Job | `templates/recurring-job.mdx` | Scheduler-triggered periodic workflow -- run a task on a schedule (daily, weekly, hourly, or custom cron) | Applying the recurring-job workflow template |
65
- | Template: Text Classifier | `templates/text-classifier.mdx` | Multi-label text classification with structured output -- classify text into predefined categories using an LLM with JSON output | Applying the text-classifier workflow template |
66
- | Template: Web Scraper | `templates/web-scraper.mdx` | Apify-based web scraper that stores results in Supabase -- fetch structured data from any website via Apify actors | Applying the web-scraper workflow template |
45
+ | Features Auth | `packages/ui/src/features/README.md` | Published auth feature surface for downstream shells. | (not specified) |
46
+ | Features CRM | `packages/ui/src/features/README.md` | Published CRM feature surface for downstream shells. | (not specified) |
47
+ | Features Dashboard | `packages/ui/src/features/README.md` | Published dashboard feature surface for downstream shells. | (not specified) |
48
+ | Features Delivery | `packages/ui/src/features/README.md` | Published delivery feature surface for downstream shells. | (not specified) |
49
+ | Features Lead Gen | `packages/ui/src/features/README.md` | Published lead generation feature surface for downstream shells. | (not specified) |
50
+ | Features Operations | `packages/ui/src/features/README.md` | Published operations feature surface for downstream shells. | (not specified) |
51
+ | Features Monitoring | `packages/ui/src/features/README.md` | Published monitoring feature surface for downstream shells. | (not specified) |
52
+ | Features SEO | `packages/ui/src/features/README.md` | Published SEO feature surface for downstream shells. | (not specified) |
53
+ | Features Settings | `packages/ui/src/features/README.md` | Published settings feature surface for downstream shells. | (not specified) |
54
+
55
+ ## @elevasis/ui / Foundation
56
+
57
+ | Resource | Location | Description | When to Load |
58
+ | --- | --- | --- | --- |
59
+ | Auth | `packages/ui/src/auth/README.md` | Published authentication surface for UI integrations. | (not specified) |
60
+ | Auth Context | `packages/ui/src/auth/README.md` | Published auth context entry for UI integrations. | (not specified) |
61
+ | SSE | `packages/ui/src/sse/README.md` | Published server-sent events helpers and connection utilities. | (not specified) |
62
+ | Initialization | `packages/ui/src/initialization/README.md` | Published app initialization provider and bootstrap helpers. | (not specified) |
63
+ | Profile | `packages/ui/src/profile/README.md` | Published user profile surface for UI applications. | (not specified) |
64
+ | Organization | `packages/ui/src/organization/README.md` | Published organization shell, store, and helper surface. | (not specified) |
65
+ | Types | `packages/ui/src/types/README.md` | Published UI types entry for downstream applications. | (not specified) |
66
+ | API | `packages/ui/src/api/README.md` | Published API client entry for downstream applications. | (not specified) |
67
+ | Utils | `packages/ui/src/utils/README.md` | Published utility entry for downstream applications. | (not specified) |
68
+ | Execution | `packages/ui/src/execution/README.md` | Published execution visualization and helper entry. | (not specified) |
69
+ | Router | `packages/ui/src/router/README.md` | Published router entry for downstream applications. | (not specified) |
70
+ | Router Context | `packages/ui/src/router/README.md` | Published router context entry for downstream applications. | (not specified) |
71
+ | Zustand | `packages/ui/src/zustand/README.md` | Published Zustand slice entry for downstream applications. | (not specified) |
72
+
73
+ ## @elevasis/ui / Hooks
74
+
75
+ | Resource | Location | Description | When to Load |
76
+ | --- | --- | --- | --- |
77
+ | Hooks | `packages/ui/src/hooks/README.md` | Headless hooks surface for executions, sessions, observability, and operations. | (not specified) |
78
+
79
+ ## @elevasis/ui / Provider
80
+
81
+ | Resource | Location | Description | When to Load |
82
+ | --- | --- | --- | --- |
83
+ | Provider | `packages/ui/src/provider/README.md` | Published provider and feature-shell contract for downstream apps. | (not specified) |
84
+ | Provider UI | `packages/ui/src/provider/README.md` | Published provider UI entry for downstream applications. | (not specified) |
85
+
86
+ ## @elevasis/ui / Visual
87
+
88
+ | Resource | Location | Description | When to Load |
89
+ | --- | --- | --- | --- |
90
+ | Theme | `packages/ui/src/theme/README.md` | Published theme entry for downstream applications. | (not specified) |
91
+ | Graph | `packages/ui/src/graph/README.md` | Published graph helper and visualization entry. | (not specified) |