chore: import upstream snapshot with attribution

2026-07-13 13:34:48 +08:00
commit 77bb5bf71f
3762 changed files with 353249 additions and 0 deletions
@@ -0,0 +1,243 @@
+import { ActionDefinition, z } from '@botpress/sdk'
+import { baseIdentifierSchema } from './common'
+
+const recordSchema = z
+  .object({
+    id: baseIdentifierSchema.describe('The record identifier'),
+    created_at: z.string().title('Created At').describe('RFC3339 timestamp when the record was created'),
+    web_url: z.string().title('Web URL').describe('URL of the record in Attio UI'),
+    values: z
+      .record(z.any())
+      .title('Values')
+      .describe('Map of attribute slug or ID to its value (single value or array of values)'),
+  })
+  .title('Record')
+
+// Objects & Attributes
+const objectSchema = z
+  .object({
+    id: baseIdentifierSchema.optional().describe('The object identifier'),
+    api_slug: z.string().optional().title('API Slug').describe('The API slug for the object'),
+    singular_noun: z.string().optional().title('Singular Noun').describe('The singular form of the object name'),
+    plural_noun: z.string().optional().title('Plural Noun').describe('The plural form of the object name'),
+    created_at: z.string().optional().title('Created At').describe('RFC3339 timestamp when the object was created'),
+  })
+  .title('Object')
+
+const attributeSchema = z
+  .object({
+    id: baseIdentifierSchema
+      .extend({ attribute_id: z.string().optional().title('Attribute ID').describe('The attribute identifier') })
+      .optional()
+      .describe('The attribute identifier object'),
+    title: z.string().optional().title('Title').describe('The title of the attribute'),
+    description: z.string().nullable().optional().title('Description').describe('The description of the attribute'),
+    api_slug: z.string().optional().title('API Slug').describe('The API slug for the attribute'),
+    type: z.string().optional().title('Type').describe('The type of the attribute'),
+    slug: z.string().optional().title('Slug').describe('The slug for the attribute'),
+    options: z
+      .array(
+        z.object({
+          id: z.string().optional().title('ID').describe('The option identifier'),
+          label: z.string().optional().title('Label').describe('The label of the option'),
+          name: z.string().optional().title('Name').describe('The name of the option'),
+          value: z.string().optional().title('Value').describe('The value of the option'),
+          title: z.string().optional().title('Title').describe('The title of the option'),
+          slug: z.string().optional().title('Slug').describe('The slug of the option'),
+        })
+      )
+      .optional()
+      .title('Options')
+      .describe('The list of options for the attribute'),
+  })
+  .title('Attribute')
+
+const listRecords: ActionDefinition = {
+  title: 'List Records',
+  description: 'List records of an Attio object with optional filters, sorts and pagination',
+  input: {
+    schema: z.object({
+      object: z.string().min(1).title('Object').describe("Object slug or UUID, e.g. 'people'"),
+      filter: z
+        .array(
+          z.object({
+            attribute: z.string().min(1).title('Attribute').describe('The attribute to filter by'),
+            value: z.string().min(1).title('Value').describe('The value to filter for'),
+          })
+        )
+        .optional()
+        .title('Filter')
+        .describe('Filtering object. See Attio Shorthand Filtering guide'),
+      sorts: z
+        .array(
+          z.object({
+            direction: z.enum(['asc', 'desc']).title('Direction').describe('The sort direction'),
+            attribute: z.string().min(1).title('Attribute').describe('The attribute to sort by'),
+            field: z.string().min(1).title('Field').describe('The field to sort by'),
+          })
+        )
+        .optional()
+        .title('Sorting')
+        .describe('Sorting instructions. See Attio sorting guide'),
+      limit: z.number().optional().title('Limit').describe('Max number of records to return (default 500)'),
+      offset: z.number().optional().title('Offset').describe('Number of records to skip (default 0)'),
+    }),
+  },
+  output: {
+    schema: z
+      .object({
+        data: z.array(recordSchema).title('Records').describe('List of records'),
+      })
+      .title('List Records Response'),
+  },
+}
+
+const getRecord: ActionDefinition = {
+  title: 'Get Record',
+  description: 'Get a single record by object and record ID',
+  input: {
+    schema: z.object({
+      object: z.string().min(1).title('Object').describe('Object slug or UUID'),
+      id: baseIdentifierSchema
+        .extend({ record_id: z.string().min(1).title('Record ID').describe('Record UUID') })
+        .describe('The record identifier'),
+    }),
+  },
+  output: {
+    schema: z
+      .object({
+        data: z
+          .object({
+            id: baseIdentifierSchema.title('Identifier').describe('The fetched identifier'),
+            web_url: z.string().title('Web URL').describe('URL of the record in Attio UI'),
+            values: z.record(z.any()).title('Values').describe('Map of attribute slug/ID to value(s)'),
+            created_at: z.string().title('Created At').describe('RFC3339 timestamp when the record was created'),
+          })
+          .title('Data')
+          .describe('The fetched record data'),
+      })
+      .title('Get Record Response'),
+  },
+}
+
+const createRecord: ActionDefinition = {
+  title: 'Create Record',
+  description: 'Create a new record in an Attio object',
+  input: {
+    schema: z.object({
+      object: z.string().min(1).title('Object').describe('Object slug or UUID'),
+      data: z
+        .object({
+          values: z
+            .array(
+              z.object({
+                attribute: z.string().min(1).title('Attribute').describe('The attribute slug or ID'),
+                value: z.string().min(1).title('Value').describe('The value to set for the attribute'),
+              })
+            )
+            .title('Values')
+            .describe('Array of attribute slug/ID to value(s)'),
+        })
+        .title('Data')
+        .describe('The record data to create'),
+    }),
+  },
+  output: {
+    schema: z
+      .object({
+        data: recordSchema.title('Record').describe('The created record'),
+      })
+      .title('Create Record Response'),
+  },
+}
+
+const updateRecord: ActionDefinition = {
+  title: 'Update Record',
+  description: 'Update an existing record by object and record ID',
+  input: {
+    schema: z.object({
+      object: z.string().min(1).title('Object').describe('Object slug or UUID'),
+      id: baseIdentifierSchema
+        .extend({ record_id: z.string().min(1).title('Record ID').describe('Record UUID') })
+        .describe('The record identifier'),
+      data: z
+        .object({
+          values: z
+            .array(
+              z.object({
+                attribute: z.string().min(1).title('Attribute').describe('The attribute slug or ID'),
+                value: z.string().min(1).title('Value').describe('The value to set for the attribute'),
+              })
+            )
+            .title('Values')
+            .describe('Array of attribute slug/ID to value(s) to upsert'),
+        })
+        .title('Data')
+        .describe('The record data to update'),
+    }),
+  },
+  output: {
+    schema: z
+      .object({
+        data: recordSchema.title('Record').describe('The updated record'),
+      })
+      .title('Update Record Response'),
+  },
+}
+
+const listObjects: ActionDefinition = {
+  title: 'List Objects',
+  description: 'List Attio objects in the workspace',
+  input: { schema: z.object({}) },
+  output: {
+    schema: z
+      .object({
+        data: z.array(objectSchema).title('Objects').describe('List of objects'),
+      })
+      .title('List Objects Response'),
+  },
+}
+
+const getObject: ActionDefinition = {
+  title: 'Get Object',
+  description: 'Get a single Attio object by slug or ID',
+  input: {
+    schema: z.object({
+      object: z.string().min(1).title('Object').describe('Object slug or UUID'),
+    }),
+  },
+  output: {
+    schema: z
+      .object({
+        data: objectSchema.title('Object').describe('The requested object'),
+      })
+      .title('Get Object Response'),
+  },
+}
+
+const listAttributes: ActionDefinition = {
+  title: 'List Attributes',
+  description: 'List attributes for a given Attio object',
+  input: {
+    schema: z.object({
+      object: z.string().min(1).title('Object').describe('Object slug or UUID'),
+    }),
+  },
+  output: {
+    schema: z
+      .object({
+        data: z.array(attributeSchema).title('Attributes').describe('List of attributes'),
+      })
+      .title('List Attributes Response'),
+  },
+}
+
+export const actions = {
+  listRecords,
+  getRecord,
+  createRecord,
+  updateRecord,
+  listObjects,
+  getObject,
+  listAttributes,
+} as const
@@ -0,0 +1,8 @@
+import { z } from '@botpress/sdk'
+
+export const baseIdentifierSchema = z
+  .object({
+    workspace_id: z.string().title('Workspace ID').describe('The Attio workspace ID'),
+    object_id: z.string().title('Object ID').describe('The Attio object ID'),
+  })
+  .title('Record Identifier')
@@ -0,0 +1,46 @@
+import { EventDefinition, z } from '@botpress/sdk'
+import { baseIdentifierSchema } from './common'
+
+const recordEventSchema = z.object({
+  event_type: z.string().title('Event Type').describe('The type of event'),
+  id: baseIdentifierSchema
+    .extend({ record_id: z.string().title('Record ID').describe('The record identifier') })
+    .describe('The record identifier object'),
+  actor: z
+    .object({
+      type: z.string().title('Actor Type').describe('The type of actor (e.g., workspace-member)'),
+      id: z.string().title('Actor ID').describe('The actor identifier'),
+    })
+    .title('Actor')
+    .describe('The actor who triggered the event'),
+})
+
+const recordCreated: EventDefinition = {
+  title: 'Record Created',
+  description: 'A new record has been created in Attio',
+  schema: recordEventSchema.extend({
+    event_type: z.literal('record.created').title('Event Type').describe('The type of event'),
+  }),
+}
+
+const recordUpdated: EventDefinition = {
+  title: 'Record Updated',
+  description: 'A record has been updated in Attio',
+  schema: recordEventSchema.extend({
+    event_type: z.literal('record.updated').title('Event Type').describe('The type of event'),
+  }),
+}
+
+const recordDeleted: EventDefinition = {
+  title: 'Record Deleted',
+  description: 'A record has been deleted in Attio',
+  schema: recordEventSchema.extend({
+    event_type: z.literal('record.deleted').title('Event Type').describe('The type of event'),
+  }),
+}
+
+export const events = {
+  recordCreated,
+  recordUpdated,
+  recordDeleted,
+}
@@ -0,0 +1,3 @@
+export { actions } from './actions'
+export { states } from './state'
+export { events } from './events'
@@ -0,0 +1,16 @@
+import { z, StateDefinition } from '@botpress/sdk'
+
+const attioIntegrationInfo: StateDefinition = {
+  type: 'integration',
+  schema: z.object({
+    attioWebhookId: z
+      .string()
+      .nullable()
+      .title('Attio Webhook ID')
+      .describe('ID of the webhook created in Attio for this integration'),
+  }),
+}
+
+export const states = {
+  attioIntegrationInfo,
+}