@elevasis/sdk 0.8.7 → 0.8.9

package/dist/cli.cjs

@@ -43883,7 +43883,7 @@ function wrapAction(commandName, fn) {
 // package.json
 var package_default = {
   name: "@elevasis/sdk",
-  version: "0.8.7",
+  version: "0.8.9",
   description: "SDK for building Elevasis organization resources",
   type: "module",
   bin: {

package/dist/index.d.ts

@@ -1348,6 +1348,119 @@ type Database = {
                     }
                 ];
             };
+            acq_content: {
+                Row: {
+                    body: string | null;
+                    created_at: string;
+                    id: string;
+                    organization_id: string;
+                    pillar: string;
+                    status: string;
+                    title: string;
+                    updated_at: string;
+                };
+                Insert: {
+                    body?: string | null;
+                    created_at?: string;
+                    id?: string;
+                    organization_id: string;
+                    pillar: string;
+                    status?: string;
+                    title: string;
+                    updated_at?: string;
+                };
+                Update: {
+                    body?: string | null;
+                    created_at?: string;
+                    id?: string;
+                    organization_id?: string;
+                    pillar?: string;
+                    status?: string;
+                    title?: string;
+                    updated_at?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "acq_content_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            acq_content_distributions: {
+                Row: {
+                    adapted_body: string | null;
+                    content_id: string;
+                    created_at: string;
+                    format: string;
+                    id: string;
+                    media_urls: Json;
+                    metrics: Json;
+                    metrics_updated_at: string | null;
+                    organization_id: string;
+                    platform: string;
+                    platform_post_id: string | null;
+                    platform_url: string | null;
+                    published_at: string | null;
+                    scheduled_at: string | null;
+                    status: string;
+                    updated_at: string;
+                };
+                Insert: {
+                    adapted_body?: string | null;
+                    content_id: string;
+                    created_at?: string;
+                    format: string;
+                    id?: string;
+                    media_urls?: Json;
+                    metrics?: Json;
+                    metrics_updated_at?: string | null;
+                    organization_id: string;
+                    platform: string;
+                    platform_post_id?: string | null;
+                    platform_url?: string | null;
+                    published_at?: string | null;
+                    scheduled_at?: string | null;
+                    status?: string;
+                    updated_at?: string;
+                };
+                Update: {
+                    adapted_body?: string | null;
+                    content_id?: string;
+                    created_at?: string;
+                    format?: string;
+                    id?: string;
+                    media_urls?: Json;
+                    metrics?: Json;
+                    metrics_updated_at?: string | null;
+                    organization_id?: string;
+                    platform?: string;
+                    platform_post_id?: string | null;
+                    platform_url?: string | null;
+                    published_at?: string | null;
+                    scheduled_at?: string | null;
+                    status?: string;
+                    updated_at?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "acq_content_distributions_content_id_fkey";
+                        columns: ["content_id"];
+                        isOneToOne: false;
+                        referencedRelation: "acq_content";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "acq_content_distributions_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
             acq_deals: {
                 Row: {
                     attio_deal_id: string;
@@ -1567,6 +1680,173 @@ type Database = {
                     }
                 ];
             };
+            acq_seo_metrics: {
+                Row: {
+                    ai_citations: Json | null;
+                    avg_position: number | null;
+                    clicks: number | null;
+                    created_at: string;
+                    cta_clicks: number | null;
+                    ctr: number | null;
+                    data_point_count: number | null;
+                    faq_count: number | null;
+                    form_submissions: number | null;
+                    id: string;
+                    impressions: number | null;
+                    organization_id: string;
+                    period: string;
+                    quality_score: number | null;
+                    readability: number | null;
+                    scroll_100: number | null;
+                    scroll_25: number | null;
+                    scroll_50: number | null;
+                    scroll_75: number | null;
+                    seo_page_id: string;
+                    word_count: number | null;
+                };
+                Insert: {
+                    ai_citations?: Json | null;
+                    avg_position?: number | null;
+                    clicks?: number | null;
+                    created_at?: string;
+                    cta_clicks?: number | null;
+                    ctr?: number | null;
+                    data_point_count?: number | null;
+                    faq_count?: number | null;
+                    form_submissions?: number | null;
+                    id?: string;
+                    impressions?: number | null;
+                    organization_id: string;
+                    period: string;
+                    quality_score?: number | null;
+                    readability?: number | null;
+                    scroll_100?: number | null;
+                    scroll_25?: number | null;
+                    scroll_50?: number | null;
+                    scroll_75?: number | null;
+                    seo_page_id: string;
+                    word_count?: number | null;
+                };
+                Update: {
+                    ai_citations?: Json | null;
+                    avg_position?: number | null;
+                    clicks?: number | null;
+                    created_at?: string;
+                    cta_clicks?: number | null;
+                    ctr?: number | null;
+                    data_point_count?: number | null;
+                    faq_count?: number | null;
+                    form_submissions?: number | null;
+                    id?: string;
+                    impressions?: number | null;
+                    organization_id?: string;
+                    period?: string;
+                    quality_score?: number | null;
+                    readability?: number | null;
+                    scroll_100?: number | null;
+                    scroll_25?: number | null;
+                    scroll_50?: number | null;
+                    scroll_75?: number | null;
+                    seo_page_id?: string;
+                    word_count?: number | null;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "acq_seo_metrics_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "acq_seo_metrics_seo_page_id_fkey";
+                        columns: ["seo_page_id"];
+                        isOneToOne: false;
+                        referencedRelation: "acq_seo_pages";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            acq_seo_pages: {
+                Row: {
+                    city: string | null;
+                    content: Json | null;
+                    created_at: string;
+                    faq_items: Json | null;
+                    hero_image_url: string | null;
+                    id: string;
+                    internal_links: Json | null;
+                    local_data: Json | null;
+                    meta_description: string | null;
+                    organization_id: string;
+                    page_type: string;
+                    published_at: string | null;
+                    refreshed_at: string | null;
+                    schema_markup: Json | null;
+                    slug: string;
+                    state: string | null;
+                    status: string;
+                    title: string;
+                    updated_at: string;
+                    use_case: string | null;
+                    vertical: string;
+                };
+                Insert: {
+                    city?: string | null;
+                    content?: Json | null;
+                    created_at?: string;
+                    faq_items?: Json | null;
+                    hero_image_url?: string | null;
+                    id?: string;
+                    internal_links?: Json | null;
+                    local_data?: Json | null;
+                    meta_description?: string | null;
+                    organization_id: string;
+                    page_type: string;
+                    published_at?: string | null;
+                    refreshed_at?: string | null;
+                    schema_markup?: Json | null;
+                    slug: string;
+                    state?: string | null;
+                    status?: string;
+                    title: string;
+                    updated_at?: string;
+                    use_case?: string | null;
+                    vertical: string;
+                };
+                Update: {
+                    city?: string | null;
+                    content?: Json | null;
+                    created_at?: string;
+                    faq_items?: Json | null;
+                    hero_image_url?: string | null;
+                    id?: string;
+                    internal_links?: Json | null;
+                    local_data?: Json | null;
+                    meta_description?: string | null;
+                    organization_id?: string;
+                    page_type?: string;
+                    published_at?: string | null;
+                    refreshed_at?: string | null;
+                    schema_markup?: Json | null;
+                    slug?: string;
+                    state?: string | null;
+                    status?: string;
+                    title?: string;
+                    updated_at?: string;
+                    use_case?: string | null;
+                    vertical?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "acq_seo_pages_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
             activities: {
                 Row: {
                     activity_type: string;
@@ -2407,170 +2687,6 @@ type Database = {
                 };
                 Relationships: [];
             };
-            seo_metrics: {
-                Row: {
-                    ai_citations: Json | null;
-                    avg_position: number | null;
-                    clicks: number | null;
-                    created_at: string;
-                    cta_clicks: number | null;
-                    ctr: number | null;
-                    data_point_count: number | null;
-                    faq_count: number | null;
-                    form_submissions: number | null;
-                    id: string;
-                    impressions: number | null;
-                    organization_id: string;
-                    period: string;
-                    quality_score: number | null;
-                    readability: number | null;
-                    scroll_100: number | null;
-                    scroll_25: number | null;
-                    scroll_50: number | null;
-                    scroll_75: number | null;
-                    seo_page_id: string;
-                    word_count: number | null;
-                };
-                Insert: {
-                    ai_citations?: Json | null;
-                    avg_position?: number | null;
-                    clicks?: number | null;
-                    created_at?: string;
-                    cta_clicks?: number | null;
-                    ctr?: number | null;
-                    data_point_count?: number | null;
-                    faq_count?: number | null;
-                    form_submissions?: number | null;
-                    id?: string;
-                    impressions?: number | null;
-                    organization_id: string;
-                    period: string;
-                    quality_score?: number | null;
-                    readability?: number | null;
-                    scroll_100?: number | null;
-                    scroll_25?: number | null;
-                    scroll_50?: number | null;
-                    scroll_75?: number | null;
-                    seo_page_id: string;
-                    word_count?: number | null;
-                };
-                Update: {
-                    ai_citations?: Json | null;
-                    avg_position?: number | null;
-                    clicks?: number | null;
-                    created_at?: string;
-                    cta_clicks?: number | null;
-                    ctr?: number | null;
-                    data_point_count?: number | null;
-                    faq_count?: number | null;
-                    form_submissions?: number | null;
-                    id?: string;
-                    impressions?: number | null;
-                    organization_id?: string;
-                    period?: string;
-                    quality_score?: number | null;
-                    readability?: number | null;
-                    scroll_100?: number | null;
-                    scroll_25?: number | null;
-                    scroll_50?: number | null;
-                    scroll_75?: number | null;
-                    seo_page_id?: string;
-                    word_count?: number | null;
-                };
-                Relationships: [
-                    {
-                        foreignKeyName: "seo_metrics_organization_id_fkey";
-                        columns: ["organization_id"];
-                        isOneToOne: false;
-                        referencedRelation: "organizations";
-                        referencedColumns: ["id"];
-                    },
-                    {
-                        foreignKeyName: "seo_metrics_seo_page_id_fkey";
-                        columns: ["seo_page_id"];
-                        isOneToOne: false;
-                        referencedRelation: "seo_pages";
-                        referencedColumns: ["id"];
-                    }
-                ];
-            };
-            seo_pages: {
-                Row: {
-                    city: string | null;
-                    content: Json | null;
-                    created_at: string;
-                    faq_items: Json | null;
-                    id: string;
-                    internal_links: Json | null;
-                    local_data: Json | null;
-                    meta_description: string | null;
-                    organization_id: string;
-                    page_type: string;
-                    published_at: string | null;
-                    refreshed_at: string | null;
-                    schema_markup: Json | null;
-                    slug: string;
-                    state: string | null;
-                    status: string;
-                    title: string;
-                    updated_at: string;
-                    use_case: string | null;
-                    vertical: string;
-                };
-                Insert: {
-                    city?: string | null;
-                    content?: Json | null;
-                    created_at?: string;
-                    faq_items?: Json | null;
-                    id?: string;
-                    internal_links?: Json | null;
-                    local_data?: Json | null;
-                    meta_description?: string | null;
-                    organization_id: string;
-                    page_type: string;
-                    published_at?: string | null;
-                    refreshed_at?: string | null;
-                    schema_markup?: Json | null;
-                    slug: string;
-                    state?: string | null;
-                    status?: string;
-                    title: string;
-                    updated_at?: string;
-                    use_case?: string | null;
-                    vertical: string;
-                };
-                Update: {
-                    city?: string | null;
-                    content?: Json | null;
-                    created_at?: string;
-                    faq_items?: Json | null;
-                    id?: string;
-                    internal_links?: Json | null;
-                    local_data?: Json | null;
-                    meta_description?: string | null;
-                    organization_id?: string;
-                    page_type?: string;
-                    published_at?: string | null;
-                    refreshed_at?: string | null;
-                    schema_markup?: Json | null;
-                    slug?: string;
-                    state?: string | null;
-                    status?: string;
-                    title?: string;
-                    updated_at?: string;
-                    use_case?: string | null;
-                    vertical?: string;
-                };
-                Relationships: [
-                    {
-                        foreignKeyName: "seo_pages_organization_id_fkey";
-                        columns: ["organization_id"];
-                        isOneToOne: false;
-                        referencedRelation: "organizations";
-                        referencedColumns: ["id"];
-                    }
-                ];
-            };
             session_messages: {
                 Row: {
                     created_at: string | null;
@@ -3850,6 +3966,31 @@ interface AcqDeal {
     createdAt: Date;
     updatedAt: Date;
 }
+interface DealStageSummary {
+    stage: string;
+    count: number;
+    oldestUpdatedAt: string | null;
+    newestUpdatedAt: string | null;
+}
+interface StaleDeal {
+    id: string;
+    contactEmail: string;
+    cachedStage: string;
+    updatedAt: string;
+    daysStale: number;
+}
+interface DealPipelineAnalytics {
+    totalDeals: number;
+    stageSummary: DealStageSummary[];
+    staleDeals: StaleDeal[];
+    recentActivity: AcqDeal[];
+}
+interface DealFilters {
+    stage?: string;
+    search?: string;
+    limit?: number;
+    offset?: number;
+}
 interface AddContactsToListParams {
     organizationId: string;
     listId: string;
@@ -6267,6 +6408,16 @@ type LeadToolMap = {
         params: Omit<DeleteDealParams, 'organizationId'>;
         result: void;
     };
+    listDeals: {
+        params: DealFilters;
+        result: AcqDeal[];
+    };
+    getDealPipelineAnalytics: {
+        params: {
+            recentLimit?: number;
+        };
+        result: DealPipelineAnalytics;
+    };
     mergeEnrichmentData: {
         params: {
             id: string;

package/package.json

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

package/reference/_navigation.md

@@ -1,6 +1,6 @@
 # SDK Reference Navigation
 
-Auto-generated from reference file frontmatter. 30 files indexed.
+Auto-generated from reference file frontmatter. 31 files indexed.
 
 All paths are relative to `node_modules/@elevasis/sdk/reference/`.
 
@@ -42,6 +42,7 @@ All paths are relative to `node_modules/@elevasis/sdk/reference/`.
 | Integration Adapters | `platform-tools/adapters-integration.mdx` | Type-safe wrappers for third-party integrations -- Attio, Stripe, Notion, Google Sheets, Instantly, SignatureAPI, Resend, Dropbox, Apify, Gmail, Mailso, 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 |
 | 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) |
 | 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 |
+| Adapter Type Safety | `platform-tools/type-safety.mdx` | SDK worker adapter type safety patterns - required fields, discriminated unions, and intentionally loose types | (not specified) |
 
 ## Resources
 

package/reference/cli.mdx

@@ -547,6 +547,73 @@ elevasis-sdk env remove OPENAI_API_KEY
 
 ---
 
+## elevasis-sdk rename
+
+Rename a resource ID across all reference tables in the platform database.
+
+**Synopsis:**
+
+```
+elevasis-sdk rename <old-id> --to <new-id> [--execute] [--prod]
+```
+
+**Behavior:**
+
+- Dry-run by default -- shows all affected rows per table without modifying any data
+- Pass `--execute` to perform the rename
+- Org-scoped: only updates rows belonging to your organization
+- Updates resource references across 6 tables:
+
+| Table                | Column(s) updated |
+| -------------------- | ----------------- |
+| `executions`         | `resource_id`     |
+| `sessions`           | `resource_id`     |
+| `workflow_configs`   | `resource_id`     |
+| `workflow_schedules` | `resource_id`     |
+| `execution_events`   | `resource_id`     |
+| `session_events`     | `resource_id`     |
+
+**Flags:**
+
+| Flag                | Description                             |
+| ------------------- | --------------------------------------- |
+| `--to <new-id>`   | Required. The new resource ID           |
+| `--execute`         | Perform the rename (default is dry-run) |
+| `--prod`            | Target the production environment       |
+| `--api-url <url>` | Override the API base URL               |
+
+**Example (dry-run):**
+
+```bash
+elevasis-sdk rename ist-upload-workflow --to ist-upload-contacts-workflow
+```
+
+```
+  Dry run — no changes made.
+
+  Rows that would be updated:
+    executions          6
+    sessions            0
+    workflow_configs    0
+    workflow_schedules  0
+    execution_events    0
+    session_events      0
+
+  Total: 6 rows
+
+  Re-run with --execute to apply changes.
+```
+
+**Example (execute):**
+
+```bash
+elevasis-sdk rename ist-upload-workflow --to ist-upload-contacts-workflow --execute
+```
+
+**Implementation:** `packages/sdk/src/cli/commands/rename.ts` -- delegates to `POST /api/external/resources/rename`
+
+---
+
 ## Global Flags
 
 These flags are accepted by all commands:

package/reference/platform-tools/adapters-platform.mdx

@@ -182,6 +182,8 @@ const { category, confidence, summary } = response.output
 
 **Supported models:** See the full model table in [Platform Tools](index.mdx#llm-tool).
 
+See [Adapter Type Safety](type-safety.mdx) for required field enforcement and design rationale.
+
 ---
 
 ## PDF Adapter

package/reference/platform-tools/type-safety.mdx

@@ -0,0 +1,92 @@
+---
+title: Adapter Type Safety
+description: SDK worker adapter type safety patterns - required fields, discriminated unions, and intentionally loose types
+---
+
+SDK worker adapters enforce correctness at compile time via TypeScript, not at deploy time. Misconfigured adapters fail in the IDE before a file is even saved — no runtime surprises, no silent failures in production.
+
+The approach: tighten types where misconfiguration is a realistic foot-gun, and leave types intentionally loose where flexibility is a design requirement.
+
+---
+
+## Required Field Enforcement
+
+### LLM Adapter — `provider` and `model`
+
+`provider` and `model` are required on `SDKLLMGenerateParams` in `packages/sdk/src/worker/adapters/llm.ts`. They were previously optional because the server-side `modelConfig` fallback in `tool-dispatcher.ts` would fill them in — but that fallback is a foot-gun, not a feature. Omitting them silently selects a default model that may not be appropriate for the call site.
+
+```typescript
+// Required — both fields must be specified inline
+await llm.generate({
+  provider: 'anthropic',
+  model: 'claude-sonnet-4-5',
+  messages: [...],
+  responseSchema: {...},
+})
+```
+
+### Email Adapter — `domain` (AnyMailFinder)
+
+`domain` is required on `FindCompanyEmailParams` and `FindPersonEmailParams`. Previously all params were optional, allowing `findCompanyEmail({})` to compile but fail at runtime. The type change enforces the one field that is always necessary for email discovery.
+
+---
+
+## Discriminated Unions
+
+### Email Targeting — mutually exclusive modes
+
+`EmailToolMap.send.params` uses a discriminated union with `never` to enforce that exactly one targeting mode is provided. You cannot pass zero modes or combine multiple modes.
+
+```typescript
+type EmailTargeting =
+  | { userIds: string[]; targetRole?: never; targetAll?: never }
+  | { targetRole: string; userIds?: never; targetAll?: never }
+  | { targetAll: true; userIds?: never; targetRole?: never }
+```
+
+The `never` pattern on sibling fields causes TypeScript to error if you pass two targeting fields simultaneously. Passing none also fails because none of the union members match.
+
+---
+
+## Strict Object Types
+
+### Approval Adapter — typed context
+
+`ApprovalToolMap.create.params` uses `context: Record<string, unknown>` instead of `context: unknown`. This prevents passing primitives (strings, numbers) as context — approval tasks always expect a structured key-value object.
+
+```typescript
+// Correct
+await approval.create({
+  context: { dealId: 'deal-123', proposalUrl: 'https://...' },
+  ...
+})
+
+// TypeScript error — primitives not assignable to Record<string, unknown>
+await approval.create({ context: 'deal-123', ... })
+```
+
+---
+
+## Intentionally Loose Types
+
+Some adapters were audited and deliberately left with flexible types. Do not tighten these — the looseness is a design requirement.
+
+| Adapter | Field      | Type                        | Reason                                                                                                         |
+| ------- | ---------- | --------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| Attio   | `object`   | `string`                    | Supports custom user-defined object slugs; a union would be too restrictive for orgs with custom Attio objects |
+| Attio   | `values`   | `Record<string, unknown>` | Dynamic per-object schemas vary by org configuration                                                           |
+| PDF     | `document` | `Record<string, unknown>` | Renderer accepts flexible document structures by design; schema is enforced server-side                        |
+
+---
+
+## Known Exceptions
+
+### `website-extract-calibration.ts`
+
+`external/elevasis/src/client-acquisition/lead-gen-pipeline/02-extract/website-extract-calibration.ts` intentionally omits `provider` and `model` on its `llm.generate()` call. This is a calibration variant that injects model config via `definitionOverrides.modelConfig` at deploy time.
+
+This file requires `@ts-expect-error` above the `llm.generate()` call after each SDK publish, since the type change would otherwise cause a compile error on a legitimate use case.
+
+---
+
+**Source:** `packages/sdk/src/worker/adapters/llm.ts`, `packages/core/src/execution/engine/tools/tool-maps.ts`