@elevasis/core 0.30.0 → 0.32.0

package/src/execution/engine/tools/integration/types/clickup.ts

@@ -0,0 +1,57 @@
+/**
+ * Shared ClickUp param/result types (browser-safe)
+ *
+ * These types define the public interface for ClickUp operations -- used by both
+ * the server-side adapter and the SDK typed wrappers. They contain zero Node.js
+ * dependencies and are safe to import in any environment.
+ *
+ * Server-internal types (credentials, retry logic) remain in
+ * server/adapters/clickup/clickup-adapter.ts
+ */
+
+// ============================================================================
+// Verify
+// ============================================================================
+
+/**
+ * Verify ClickUp credentials parameters
+ */
+export interface ClickUpVerifyParams {
+  /** No params required -- verification is credential-only */
+  _?: never
+}
+
+/**
+ * Verify ClickUp credentials result
+ */
+export interface ClickUpVerifyResult {
+  ok: true
+  provider: 'clickup'
+  teamCount: number
+  teams: Array<{
+    id: string
+    name: string
+  }>
+}
+
+// ============================================================================
+// Create Task
+// ============================================================================
+
+/**
+ * Create ClickUp task parameters
+ */
+export interface ClickUpCreateTaskParams {
+  listId: string
+  name: string
+  markdownContent: string
+}
+
+/**
+ * Create ClickUp task result
+ */
+export interface ClickUpCreateTaskResult {
+  id: string
+  url?: string
+  name: string
+}

package/src/execution/engine/tools/integration/types/index.ts

@@ -1,19 +1,20 @@
-/**
- * Integration types barrel - browser-safe exports
- *
- * Shared param/result types for integration adapters, used by both
- * server-side implementations and SDK typed wrappers.
- */
-
-export * from './attio'
-export * from './apify'
-export * from './dropbox'
-export * from './gmail'
-export * from './google-sheets'
-export * from './instantly'
-export * from './resend'
-export * from './signature-api'
-export * from './stripe'
-export * from './anymailfinder'
-export * from './tomba'
-export * from './millionverifier'
+/**
+ * Integration types barrel - browser-safe exports
+ *
+ * Shared param/result types for integration adapters, used by both
+ * server-side implementations and SDK typed wrappers.
+ */
+
+export * from './attio'
+export * from './apify'
+export * from './dropbox'
+export * from './gmail'
+export * from './google-sheets'
+export * from './instantly'
+export * from './resend'
+export * from './signature-api'
+export * from './stripe'
+export * from './anymailfinder'
+export * from './tomba'
+export * from './millionverifier'
+export * from './clickup'

package/src/execution/engine/tools/tool-maps.ts

@@ -133,6 +133,13 @@ import type {
   MillionVerifierCheckCreditsResult
 } from './integration/types/millionverifier'
 
+import type {
+  ClickUpVerifyParams,
+  ClickUpVerifyResult,
+  ClickUpCreateTaskParams,
+  ClickUpCreateTaskResult
+} from './integration/types/clickup'
+
 import type {
   FindCompanyEmailParams,
   FindCompanyEmailResult,
@@ -571,6 +578,15 @@ export type MillionVerifierToolMap = {
   checkCredits: { params: MillionVerifierCheckCreditsParams; result: MillionVerifierCheckCreditsResult }
 }
 
+// ---------------------------------------------------------------------------
+// ClickUp (integration adapter, 2 methods)
+// ---------------------------------------------------------------------------
+
+export type ClickUpToolMap = {
+  verify: { params: ClickUpVerifyParams; result: ClickUpVerifyResult }
+  createTask: { params: ClickUpCreateTaskParams; result: ClickUpCreateTaskResult }
+}
+
 // ---------------------------------------------------------------------------
 // Lead (platform tool, 56 methods)
 // ---------------------------------------------------------------------------

package/src/organization-model/__tests__/domains/entities.test.ts

@@ -1,56 +1,35 @@
-import { describe, expect, it } from 'vitest'
-import {
-  DEFAULT_ORGANIZATION_MODEL_ENTITIES,
-  EntitiesDomainSchema,
-  EntityLinkSchema,
-  EntitySchema
-} from '../../domains/entities'
-
-describe('entities domain', () => {
-  it('defaults the initial entity catalog with ordered entries', () => {
-    const domain = EntitiesDomainSchema.parse(DEFAULT_ORGANIZATION_MODEL_ENTITIES)
-
-    expect(Object.keys(domain)).toEqual([
-      'crm.deal',
-      'crm.contact',
-      'leadgen.list',
-      'leadgen.company',
-      'leadgen.contact',
-      'delivery.project',
-      'delivery.milestone',
-      'delivery.task'
-    ])
-    expect(Object.values(domain).map((entity) => entity.order)).toEqual([10, 20, 30, 40, 50, 60, 70, 80])
-    expect(domain['crm.deal']).toMatchObject({
-      id: 'crm.deal',
-      label: 'Deal',
-      ownedBySystemId: 'sales.crm'
-    })
-  })
-
-  it('enforces map key equals entity id', () => {
-    expect(() =>
-      EntitiesDomainSchema.parse({
-        'crm.deal': {
-          id: 'crm.contact',
-          order: 10,
-          label: 'Deal',
-          ownedBySystemId: 'sales.crm'
-        }
-      })
-    ).toThrow(/Each entity entry id must match its map key/)
-  })
-
-  it('accepts declared entity links', () => {
-    expect(() => EntityLinkSchema.parse({ toEntity: 'crm.contact', kind: 'has-many' })).not.toThrow()
-    expect(() =>
-      EntitySchema.parse({
-        id: 'crm.deal',
-        order: 10,
-        label: 'Deal',
-        ownedBySystemId: 'sales.crm',
-        links: [{ toEntity: 'crm.contact', kind: 'belongs-to', via: 'contact_id', label: 'contact' }]
-      })
-    ).not.toThrow()
-  })
-})
+import { describe, expect, it } from 'vitest'
+import { EntitiesDomainSchema, EntityLinkSchema, EntitySchema } from '../../domains/entities'
+
+describe('entities domain', () => {
+  it('defaults to an empty entity catalog (tenant catalogs live in @repo/elevasis-core)', () => {
+    expect(EntitiesDomainSchema.parse(undefined)).toEqual({})
+    expect(EntitiesDomainSchema.parse({})).toEqual({})
+  })
+
+  it('enforces map key equals entity id', () => {
+    expect(() =>
+      EntitiesDomainSchema.parse({
+        'crm.deal': {
+          id: 'crm.contact',
+          order: 10,
+          label: 'Deal',
+          ownedBySystemId: 'sales.crm'
+        }
+      })
+    ).toThrow(/Each entity entry id must match its map key/)
+  })
+
+  it('accepts declared entity links', () => {
+    expect(() => EntityLinkSchema.parse({ toEntity: 'crm.contact', kind: 'has-many' })).not.toThrow()
+    expect(() =>
+      EntitySchema.parse({
+        id: 'crm.deal',
+        order: 10,
+        label: 'Deal',
+        ownedBySystemId: 'sales.crm',
+        links: [{ toEntity: 'crm.contact', kind: 'belongs-to', via: 'contact_id', label: 'contact' }]
+      })
+    ).not.toThrow()
+  })
+})

package/src/organization-model/__tests__/domains/passthrough-extensibility.test.ts

@@ -0,0 +1,199 @@
+import { describe, expect, it } from 'vitest'
+import { IdentityDomainSchema } from '../../domains/identity'
+import { resolveOrganizationModel } from '../../resolve'
+
+/**
+ * Profile-singleton domains (`branding`, `identity`) use `.passthrough()` so that
+ * tenant-authored direct properties survive `resolveOrganizationModel` instead of
+ * being silently stripped by Zod's default `.strip()`. These tests lock that
+ * behavior in and verify the broadened typed branding fields round-trip.
+ */
+describe('profile-singleton passthrough extensibility', () => {
+  it('keeps an unknown direct property on branding through resolve', () => {
+    const model = resolveOrganizationModel({
+      branding: {
+        organizationName: 'Acme',
+        productName: 'AcmeOS',
+        shortName: 'Acme',
+        // Unknown tenant-authored direct property — must survive passthrough.
+        brandVibe: 'warm'
+      } as never
+    })
+
+    expect((model.branding as Record<string, unknown>).brandVibe).toBe('warm')
+    // Known fields still resolve normally.
+    expect(model.branding.organizationName).toBe('Acme')
+  })
+
+  it('keeps an unknown direct property on identity through resolve', () => {
+    const model = resolveOrganizationModel({
+      identity: {
+        // Unknown tenant-authored direct property — must survive passthrough.
+        founderNote: 'bootstrapped'
+      } as never
+    })
+
+    expect((model.identity as Record<string, unknown>).founderNote).toBe('bootstrapped')
+    // Known identity fields still resolve from defaults.
+    expect(model.identity.timeZone).toBe('UTC')
+  })
+
+  it('parses and round-trips the broadened typed branding fields', () => {
+    const model = resolveOrganizationModel({
+      branding: {
+        organizationName: 'Acme',
+        productName: 'AcmeOS',
+        shortName: 'Acme',
+        voice: 'Direct and human — no jargon',
+        tagline: 'Automation that works while you sleep',
+        values: ['Transparency', 'Craftsmanship', 'Velocity'],
+        themePresetId: 'midnight'
+      }
+    })
+
+    expect(model.branding.voice).toBe('Direct and human — no jargon')
+    expect(model.branding.tagline).toBe('Automation that works while you sleep')
+    expect(model.branding.values).toEqual(['Transparency', 'Craftsmanship', 'Velocity'])
+    expect(model.branding.themePresetId).toBe('midnight')
+  })
+
+  it('leaves the broadened branding fields undefined when not authored', () => {
+    const model = resolveOrganizationModel()
+
+    expect(model.branding.voice).toBeUndefined()
+    expect(model.branding.tagline).toBeUndefined()
+    expect(model.branding.values).toBeUndefined()
+    expect(model.branding.themePresetId).toBeUndefined()
+  })
+})
+
+/**
+ * Names → identity: the four display-name fields (organizationName, productName,
+ * shortName, description) are now the recommended placement on `identity`. They are
+ * optional so that legacy tenants can continue to rely on `branding.*` fallbacks
+ * without breaking. These tests lock the contract: fields round-trip, are truly
+ * optional (no default), and branding fields still validate unchanged.
+ */
+describe('identity display-name fields — recommended placement (Step 5)', () => {
+  it('accepts all four name fields on identity and round-trips them through resolveOrganizationModel', () => {
+    const model = resolveOrganizationModel({
+      identity: {
+        organizationName: 'Acme Corp',
+        productName: 'AcmeOS',
+        shortName: 'Acme',
+        description: 'AI orchestration for modern teams.'
+      }
+    })
+
+    expect(model.identity.organizationName).toBe('Acme Corp')
+    expect(model.identity.productName).toBe('AcmeOS')
+    expect(model.identity.shortName).toBe('Acme')
+    expect(model.identity.description).toBe('AI orchestration for modern teams.')
+  })
+
+  it('identity name fields are optional — a model with none set still resolves, and resolved values are undefined', () => {
+    const model = resolveOrganizationModel()
+
+    expect(model.identity.organizationName).toBeUndefined()
+    expect(model.identity.productName).toBeUndefined()
+    expect(model.identity.shortName).toBeUndefined()
+    expect(model.identity.description).toBeUndefined()
+  })
+
+  it('identity name fields parse as undefined through IdentityDomainSchema directly (no defaults injected)', () => {
+    const result = IdentityDomainSchema.safeParse({})
+    expect(result.success).toBe(true)
+    if (result.success) {
+      expect(result.data.organizationName).toBeUndefined()
+      expect(result.data.productName).toBeUndefined()
+      expect(result.data.shortName).toBeUndefined()
+      expect(result.data.description).toBeUndefined()
+    }
+  })
+
+  it('identity.shortName rejects values exceeding 40 characters', () => {
+    expect(() =>
+      resolveOrganizationModel({
+        identity: { shortName: 'a'.repeat(41) } as never
+      })
+    ).toThrow()
+  })
+
+  it('identity.organizationName rejects empty string (LabelSchema min 1)', () => {
+    expect(() =>
+      resolveOrganizationModel({
+        identity: { organizationName: '' } as never
+      })
+    ).toThrow()
+  })
+
+  it('identity.description rejects empty string (DescriptionSchema min 1)', () => {
+    expect(() =>
+      resolveOrganizationModel({
+        identity: { description: '' } as never
+      })
+    ).toThrow()
+  })
+
+  it('identity name fields trim whitespace', () => {
+    const model = resolveOrganizationModel({
+      identity: {
+        organizationName: '  Acme Corp  ',
+        shortName: '  Acme  '
+      } as never
+    })
+
+    expect(model.identity.organizationName).toBe('Acme Corp')
+    expect(model.identity.shortName).toBe('Acme')
+  })
+
+  it('branding still validates with its name fields — @deprecated tags change nothing at runtime', () => {
+    const model = resolveOrganizationModel({
+      branding: {
+        organizationName: 'Legacy Org',
+        productName: 'LegacyOS',
+        shortName: 'LGO',
+        description: 'Legacy description for back-compat.'
+      }
+    })
+
+    expect(model.branding.organizationName).toBe('Legacy Org')
+    expect(model.branding.productName).toBe('LegacyOS')
+    expect(model.branding.shortName).toBe('LGO')
+    expect(model.branding.description).toBe('Legacy description for back-compat.')
+  })
+})
+
+/**
+ * The broadened branding fields are *typed*, not passthrough — their constraints
+ * are part of the published contract. These tests lock those bounds so a future
+ * edit can't silently widen/drop them, and confirm `.passthrough()` does NOT
+ * bypass validation for known fields (only unknown ones are let through).
+ */
+describe('broadened branding typed-field validation', () => {
+  it('rejects a voice longer than 280 characters', () => {
+    expect(() => resolveOrganizationModel({ branding: { voice: 'a'.repeat(281) } as never })).toThrow()
+  })
+
+  it('rejects a tagline longer than 200 characters', () => {
+    expect(() => resolveOrganizationModel({ branding: { tagline: 'a'.repeat(201) } as never })).toThrow()
+  })
+
+  it('rejects an empty-string entry in values (each entry must be non-empty)', () => {
+    expect(() => resolveOrganizationModel({ branding: { values: ['Valid', ''] } as never })).toThrow()
+  })
+
+  it('rejects a themePresetId outside the 1–64 character bounds', () => {
+    expect(() => resolveOrganizationModel({ branding: { themePresetId: '' } as never })).toThrow()
+    expect(() => resolveOrganizationModel({ branding: { themePresetId: 'a'.repeat(65) } as never })).toThrow()
+  })
+
+  it('trims whitespace on string fields', () => {
+    const model = resolveOrganizationModel({
+      branding: { voice: '  trimmed voice  ', tagline: '  trimmed tagline  ' } as never
+    })
+
+    expect(model.branding.voice).toBe('trimmed voice')
+    expect(model.branding.tagline).toBe('trimmed tagline')
+  })
+})

package/src/organization-model/domains/branding.ts

@@ -1,19 +1,61 @@
-import { z } from 'zod'
-import { DescriptionSchema, LabelSchema } from './shared'
-
-export const OrganizationModelBrandingSchema = z.object({
-  organizationName: LabelSchema,
-  productName: LabelSchema,
-  shortName: z.string().trim().min(1).max(40),
-  description: DescriptionSchema.optional(),
-  logos: z
-    .object({
-      light: z.string().trim().min(1).max(2048).optional(),
-      dark: z.string().trim().min(1).max(2048).optional()
-    })
-    .default({})
-})
-
+import { z } from 'zod'
+import { DescriptionSchema, LabelSchema } from './shared'
+
+export const OrganizationModelBrandingSchema = z
+  .object({
+    /**
+     * @deprecated Prefer `identity.organizationName`; branding retains it for back-compat.
+     * Legacy tenants that have not set `identity.organizationName` fall back to this field.
+     */
+    organizationName: LabelSchema,
+    /**
+     * @deprecated Prefer `identity.productName`; branding retains it for back-compat.
+     * Legacy tenants that have not set `identity.productName` fall back to this field.
+     */
+    productName: LabelSchema,
+    /**
+     * @deprecated Prefer `identity.shortName`; branding retains it for back-compat.
+     * Legacy tenants that have not set `identity.shortName` fall back to this field.
+     */
+    shortName: z.string().trim().min(1).max(40),
+    /**
+     * @deprecated Prefer `identity.description`; branding retains it for back-compat.
+     * Legacy tenants that have not set `identity.description` fall back to this field.
+     */
+    description: DescriptionSchema.optional(),
+    logos: z
+      .object({
+        light: z.string().trim().min(1).max(2048).optional(),
+        dark: z.string().trim().min(1).max(2048).optional()
+      })
+      .default({}),
+    /**
+     * Brand voice — how the organization communicates. Plain-language description
+     * of tone, register, and personality (e.g. "Direct and human — no jargon").
+     * Max 280 characters.
+     */
+    voice: z.string().trim().max(280).optional(),
+    /**
+     * Brand tagline or positioning statement — the memorable one-liner that
+     * captures the brand's promise or differentiator. Max 200 characters.
+     */
+    tagline: z.string().trim().max(200).optional(),
+    /**
+     * Core brand values — an ordered list of principles the organization stands
+     * for (e.g. ["Transparency", "Craftsmanship", "Velocity"]). Each entry must
+     * be a non-empty trimmed string.
+     */
+    values: z.array(z.string().trim().min(1)).optional(),
+    /**
+     * ID of the active UI theme preset from the UI theme-presets registry.
+     * The UI layer resolves this to colors and typography via `usePresetsContext()`.
+     * Free-form string — validation and fallback state are handled at the UI layer.
+     * Min 1, max 64 characters.
+     */
+    themePresetId: z.string().trim().min(1).max(64).optional()
+  })
+  .passthrough()
+
 export const DEFAULT_ORGANIZATION_MODEL_BRANDING: z.infer<typeof OrganizationModelBrandingSchema> = {
   organizationName: 'Default Organization',
   productName: 'Organization OS',

package/src/organization-model/domains/entities.ts

@@ -35,109 +35,6 @@ export const EntitiesDomainSchema = z
   })
   .default({})
 
-const ENTITY_ENTRY_INPUTS: z.input<typeof EntitySchema>[] = [
-  {
-    id: 'crm.deal',
-    order: 10,
-    label: 'Deal',
-    description: 'A CRM opportunity or sales pipeline record.',
-    ownedBySystemId: 'sales.crm',
-    table: 'crm_deals',
-    stateCatalogId: 'crm.pipeline',
-    links: [{ toEntity: 'crm.contact', kind: 'has-many', via: 'deal_contacts', label: 'contacts' }]
-  },
-  {
-    id: 'crm.contact',
-    order: 20,
-    label: 'CRM Contact',
-    description: 'A person associated with a CRM relationship or deal.',
-    ownedBySystemId: 'sales.crm',
-    table: 'crm_contacts'
-  },
-  {
-    id: 'leadgen.list',
-    order: 30,
-    label: 'Lead List',
-    description: 'A prospecting list that groups companies and contacts for acquisition workflows.',
-    ownedBySystemId: 'sales.lead-gen',
-    table: 'acq_lists',
-    links: [
-      { toEntity: 'leadgen.company', kind: 'has-many', via: 'acq_list_companies', label: 'companies' },
-      { toEntity: 'leadgen.contact', kind: 'has-many', via: 'acq_list_members', label: 'contacts' }
-    ]
-  },
-  {
-    id: 'leadgen.company',
-    order: 40,
-    label: 'Lead Company',
-    description: 'A company record sourced, enriched, and qualified during prospecting.',
-    ownedBySystemId: 'sales.lead-gen',
-    table: 'acq_list_companies',
-    stateCatalogId: 'lead-gen.company',
-    links: [
-      { toEntity: 'leadgen.list', kind: 'belongs-to', via: 'list_id', label: 'list' },
-      { toEntity: 'leadgen.contact', kind: 'has-many', via: 'company_id', label: 'contacts' }
-    ]
-  },
-  {
-    id: 'leadgen.contact',
-    order: 50,
-    label: 'Lead Contact',
-    description: 'A prospect contact discovered or enriched during lead generation.',
-    ownedBySystemId: 'sales.lead-gen',
-    table: 'acq_list_members',
-    stateCatalogId: 'lead-gen.contact',
-    links: [
-      { toEntity: 'leadgen.list', kind: 'belongs-to', via: 'list_id', label: 'list' },
-      { toEntity: 'leadgen.company', kind: 'belongs-to', via: 'company_id', label: 'company' }
-    ]
-  },
-  {
-    id: 'delivery.project',
-    order: 60,
-    label: 'Project',
-    description: 'A client delivery project.',
-    ownedBySystemId: 'projects',
-    table: 'projects',
-    links: [
-      { toEntity: 'delivery.milestone', kind: 'has-many', via: 'project_id', label: 'milestones' },
-      { toEntity: 'delivery.task', kind: 'has-many', via: 'project_id', label: 'tasks' }
-    ]
-  },
-  {
-    id: 'delivery.milestone',
-    order: 70,
-    label: 'Milestone',
-    description: 'A delivery checkpoint within a project.',
-    ownedBySystemId: 'projects',
-    table: 'project_milestones',
-    links: [
-      { toEntity: 'delivery.project', kind: 'belongs-to', via: 'project_id', label: 'project' },
-      { toEntity: 'delivery.task', kind: 'has-many', via: 'milestone_id', label: 'tasks' }
-    ]
-  },
-  {
-    id: 'delivery.task',
-    order: 80,
-    label: 'Task',
-    description: 'A delivery task that can move through the task status catalog.',
-    ownedBySystemId: 'projects',
-    table: 'project_tasks',
-    stateCatalogId: 'delivery.task',
-    links: [
-      { toEntity: 'delivery.project', kind: 'belongs-to', via: 'project_id', label: 'project' },
-      { toEntity: 'delivery.milestone', kind: 'belongs-to', via: 'milestone_id', label: 'milestone' }
-    ]
-  }
-]
-
-export const DEFAULT_ORGANIZATION_MODEL_ENTITIES: z.infer<typeof EntitiesDomainSchema> = Object.fromEntries(
-  ENTITY_ENTRY_INPUTS.map((entity) => {
-    const parsed = EntitySchema.parse(entity)
-    return [parsed.id, parsed]
-  })
-)
-
 /** Validate and return a single entity entry. */
 export function defineEntity(entry: z.input<typeof EntitySchema>): z.infer<typeof EntitySchema> {
   return EntitySchema.parse(entry)