@elevasis/core 0.1.0

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

@@ -0,0 +1,354 @@
+/**
+ * Shared Attio param/result types (browser-safe)
+ *
+ * These types define the public interface for Attio 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 (API response shapes, credentials) remain in
+ * server/adapters/attio/fetch/utils/types.ts
+ */
+
+// ============================================================================
+// Record ID
+// ============================================================================
+
+/**
+ * Record ID structure returned by Attio API
+ */
+export interface RecordId {
+  workspace_id: string
+  object_id: string
+  record_id: string
+}
+
+// ============================================================================
+// Record Operation Params & Results
+// ============================================================================
+
+/**
+ * Create record parameters
+ */
+export interface CreateRecordParams {
+  object: string // Object type: 'people', 'companies', 'deals', or custom slug
+  values: Record<string, unknown> // Attribute slug/ID -> value mapping
+}
+
+/**
+ * Create record result
+ */
+export interface CreateRecordResult {
+  recordId: string // Just the record UUID (extracted from full ID structure)
+  success: boolean
+}
+
+/**
+ * Update record parameters
+ */
+export interface UpdateRecordParams {
+  object: string
+  recordId: string
+  values: Record<string, unknown>
+}
+
+/**
+ * Update record result
+ */
+export interface UpdateRecordResult {
+  recordId: string
+  success: boolean
+}
+
+/**
+ * Filter expression (recursive type for nested filters)
+ */
+export type FilterExpression =
+  | {
+      [attribute: string]:
+        | {
+            [field: string]: {
+              [operator: string]: unknown
+            }
+          }
+        | FilterExpression
+    }
+  | {
+      $and?: FilterExpression[]
+      $or?: FilterExpression[]
+    }
+
+/**
+ * Sort criteria for query results
+ */
+export interface SortCriteria {
+  attribute: string // Attribute slug to sort by
+  direction: 'asc' | 'desc' // Sort direction
+  field?: string // Optional nested field path
+}
+
+/**
+ * Query records parameters
+ */
+export interface QueryRecordsParams {
+  object: string
+  filter?: FilterExpression
+  sorts?: SortCriteria[]
+  limit?: number // Default: 500
+  offset?: number // Default: 0
+}
+
+/**
+ * Query records result
+ */
+export interface QueryRecordsResult {
+  records: Array<{
+    id: string // Record ID (extracted from full ID structure)
+    values: Record<string, unknown> // Attribute values
+    createdAt: string // ISO timestamp
+    webUrl: string // Link to record in Attio UI
+  }>
+  hasMore: boolean // True if more records available
+}
+
+/**
+ * Get record parameters
+ */
+export interface GetRecordParams {
+  object: string
+  recordId: string
+}
+
+/**
+ * Get record result
+ */
+export interface GetRecordResult {
+  id: string
+  values: Record<string, unknown>
+  createdAt: string
+  webUrl: string
+}
+
+/**
+ * Delete record parameters
+ */
+export interface DeleteRecordParams {
+  object: string
+  recordId: string
+}
+
+/**
+ * Delete record result
+ */
+export interface DeleteRecordResult {
+  recordId: string
+  success: boolean
+}
+
+// ============================================================================
+// Schema/Object Types
+// ============================================================================
+
+/**
+ * Attio object (table) in workspace
+ */
+export interface AttioObject {
+  id: string
+  slug: string
+  singularNoun: string
+  pluralNoun: string
+  createdAt: string
+}
+
+/**
+ * Supported attribute types in Attio
+ */
+export type AttioAttributeType =
+  | 'text'
+  | 'number'
+  | 'currency'
+  | 'select'
+  | 'checkbox'
+  | 'date'
+  | 'timestamp'
+  | 'rating'
+  | 'email-address'
+  | 'phone-number'
+  | 'domain'
+  | 'location'
+  | 'record-reference'
+  | 'actor-reference'
+  | 'personal-email-address'
+  | 'interaction'
+
+/**
+ * Select option for select/multi-select attributes
+ */
+export interface SelectOption {
+  id?: string // Omit for new options
+  title: string
+  isArchived: boolean
+}
+
+/**
+ * Attribute configuration (type-specific)
+ */
+export interface AttributeConfig {
+  options?: SelectOption[]
+  targetObject?: string  // For record-reference
+  currencyCode?: string  // For currency
+  maxValue?: number      // For rating
+}
+
+/**
+ * Attio attribute (field) on an object
+ */
+export interface AttioAttribute {
+  id: string
+  slug: string
+  title: string
+  description?: string
+  type: AttioAttributeType
+  isSystemAttribute: boolean
+  isRequired: boolean
+  isUnique: boolean
+  isMultiselect: boolean
+  isArchived: boolean
+  config?: AttributeConfig
+}
+
+// ============================================================================
+// Schema Operation Parameters & Results
+// ============================================================================
+
+/**
+ * List objects parameters (no params needed)
+ */
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type
+export interface ListObjectsParams {}
+
+/**
+ * List objects result
+ */
+export interface ListObjectsResult {
+  objects: AttioObject[]
+}
+
+/**
+ * List attributes parameters
+ */
+export interface ListAttributesParams {
+  objectSlug: string
+}
+
+/**
+ * List attributes result
+ */
+export interface ListAttributesResult {
+  attributes: AttioAttribute[]
+}
+
+/**
+ * Create attribute parameters
+ */
+export interface CreateAttributeParams {
+  objectSlug: string
+  title: string
+  apiSlug: string
+  type: AttioAttributeType
+  description?: string
+  isRequired?: boolean
+  isUnique?: boolean
+  isMultiselect?: boolean
+  config?: AttributeConfig
+}
+
+/**
+ * Create attribute result
+ */
+export interface CreateAttributeResult {
+  attributeId: string
+  slug: string
+  success: boolean
+}
+
+/**
+ * Update attribute parameters
+ */
+export interface UpdateAttributeParams {
+  objectSlug: string
+  attributeSlug: string
+  title?: string
+  description?: string
+  isRequired?: boolean
+  isArchived?: boolean
+  config?: AttributeConfig
+}
+
+/**
+ * Update attribute result
+ */
+export interface UpdateAttributeResult {
+  attributeId: string
+  slug: string
+  success: boolean
+}
+
+// ============================================================================
+// Note Types
+// ============================================================================
+
+/**
+ * Note format options
+ */
+export type NoteFormat = 'plaintext' | 'markdown'
+
+/**
+ * Create note parameters
+ */
+export interface CreateNoteParams {
+  parentObject: string // Object slug: 'people', 'companies', etc.
+  parentRecordId: string // Record ID to attach note to
+  title: string // Note title (plaintext only)
+  format: NoteFormat // Content format
+  content: string // Note body
+  createdAt?: string // Optional ISO timestamp override
+}
+
+/**
+ * Create note result
+ */
+export interface CreateNoteResult {
+  noteId: string
+  success: boolean
+}
+
+/**
+ * List notes parameters
+ */
+export interface ListNotesParams {
+  parentObject: string // Object slug: 'people', 'companies', 'deals', etc.
+  parentRecordId: string // Record ID to list notes for
+}
+
+/**
+ * List notes result
+ */
+export interface ListNotesResult {
+  notes: Array<{ noteId: string; title: string; createdAt: string }>
+  success: boolean
+}
+
+/**
+ * Delete note parameters
+ */
+export interface DeleteNoteParams {
+  noteId: string
+}
+
+/**
+ * Delete note result
+ */
+export interface DeleteNoteResult {
+  noteId: string
+  success: boolean
+}

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

@@ -0,0 +1,64 @@
+/**
+ * Shared Dropbox param/result types (browser-safe)
+ *
+ * These types define the public interface for Dropbox 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.
+ *
+ * Uses Uint8Array instead of Buffer for browser safety.
+ *
+ * Server-internal types (credentials, error handling) remain in
+ * server/adapters/dropbox/fetch/
+ */
+
+// ============================================================================
+// Upload File
+// ============================================================================
+
+/**
+ * Upload file parameters
+ */
+export interface UploadFileParams {
+  path: string
+  contents: Uint8Array
+  mode?: 'add' | 'overwrite'
+  autorename?: boolean
+}
+
+/**
+ * Upload file result
+ */
+export interface UploadFileResult {
+  id: string
+  name: string
+  path_lower: string
+  path_display: string
+  rev: string
+  size: number
+  is_downloadable: boolean
+  content_hash?: string
+}
+
+// ============================================================================
+// Create Folder
+// ============================================================================
+
+/**
+ * Create folder parameters
+ */
+export interface CreateFolderParams {
+  path: string
+  autorename?: boolean
+}
+
+/**
+ * Create folder result
+ */
+export interface CreateFolderResult {
+  metadata: {
+    id: string
+    name: string
+    path_lower: string
+    path_display: string
+  } | null
+}

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

@@ -0,0 +1,35 @@
+/**
+ * Shared Gmail param/result types (browser-safe)
+ *
+ * These types define the public interface for Gmail 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.
+ *
+ * Prefixed with "Gmail" to avoid collision with Resend types.
+ *
+ * Server-internal types (OAuth credentials, API response shapes) remain in
+ * server/adapters/gmail/gmail-adapter.ts
+ */
+
+// ============================================================================
+// Send Email
+// ============================================================================
+
+/**
+ * Send email parameters
+ */
+export interface GmailSendEmailParams {
+  to: string
+  subject: string
+  body: string
+  cc?: string
+  from?: string
+}
+
+/**
+ * Send email result
+ */
+export interface GmailSendEmailResult {
+  messageId: string
+  threadId: string
+}