@automate.ax/integration-contracts 0.76.0 → 0.77.0

package/src/google-meet/schemas.ts

@@ -0,0 +1,274 @@
+import { z } from "zod"
+
+const RESOURCE_NAME_SCHEMA = z.string().trim().min(1)
+const TIMESTAMP_SCHEMA = z.iso.datetime({ offset: true })
+
+export const GOOGLE_MEET_SPACE_REFERENCE_SCHEMA = z.string().trim().min(1)
+export const GOOGLE_MEET_CONFERENCE_RECORD_REFERENCE_SCHEMA = z
+  .string()
+  .trim()
+  .min(1)
+export const GOOGLE_MEET_PARTICIPANT_NAME_SCHEMA = RESOURCE_NAME_SCHEMA.regex(
+  /^conferenceRecords\/[^/]+\/participants\/[^/]+$/,
+  "Expected a Google Meet participant resource name.",
+)
+export const GOOGLE_MEET_PARTICIPANT_SESSION_NAME_SCHEMA =
+  RESOURCE_NAME_SCHEMA.regex(
+    /^conferenceRecords\/[^/]+\/participants\/[^/]+\/participantSessions\/[^/]+$/,
+    "Expected a Google Meet participant session resource name.",
+  )
+export const GOOGLE_MEET_RECORDING_NAME_SCHEMA = RESOURCE_NAME_SCHEMA.regex(
+  /^conferenceRecords\/[^/]+\/recordings\/[^/]+$/,
+  "Expected a Google Meet recording resource name.",
+)
+export const GOOGLE_MEET_TRANSCRIPT_NAME_SCHEMA = RESOURCE_NAME_SCHEMA.regex(
+  /^conferenceRecords\/[^/]+\/transcripts\/[^/]+$/,
+  "Expected a Google Meet transcript resource name.",
+)
+export const GOOGLE_MEET_TRANSCRIPT_ENTRY_NAME_SCHEMA =
+  RESOURCE_NAME_SCHEMA.regex(
+    /^conferenceRecords\/[^/]+\/transcripts\/[^/]+\/entries\/[^/]+$/,
+    "Expected a Google Meet transcript entry resource name.",
+  )
+export const GOOGLE_MEET_SMART_NOTE_NAME_SCHEMA = RESOURCE_NAME_SCHEMA.regex(
+  /^conferenceRecords\/[^/]+\/smartNotes\/[^/]+$/,
+  "Expected a Google Meet smart note resource name.",
+)
+
+const RESTRICTION_SCHEMA = z.enum(["hostsOnly", "noRestriction"])
+
+export const GOOGLE_MEET_SPACE_CONFIG_SCHEMA = z.object({
+  /** Who can join without knocking. */
+  accessType: z.enum(["open", "trusted", "restricted"]).optional(),
+
+  /** Automatic artifact generation settings. */
+  artifacts: z
+    .object({
+      recording: z.boolean().optional(),
+      smartNotes: z.boolean().optional(),
+      transcription: z.boolean().optional(),
+    })
+    .optional(),
+
+  /** Whether Google generates an attendance report. */
+  attendanceReport: z.boolean().optional(),
+
+  /** Entry points allowed to join the space. */
+  entryPointAccess: z.enum(["all", "creatorAppOnly"]).optional(),
+
+  /** Whether host management is enabled. */
+  moderation: z.boolean().optional(),
+
+  /** Feature permissions applied while moderation is enabled. */
+  moderationRestrictions: z
+    .object({
+      chat: RESTRICTION_SCHEMA.optional(),
+      defaultJoinAsViewer: z.boolean().optional(),
+      present: RESTRICTION_SCHEMA.optional(),
+      reactions: RESTRICTION_SCHEMA.optional(),
+    })
+    .optional(),
+})
+
+export const GOOGLE_MEET_SPACE_SCHEMA = z.object({
+  /** Active conference record resource name, when a call is running. */
+  activeConference: RESOURCE_NAME_SCHEMA.optional(),
+
+  /** Resolved meeting-space configuration. */
+  config: GOOGLE_MEET_SPACE_CONFIG_SCHEMA.optional(),
+
+  /** SIP gateway entry points. */
+  gatewaySipAccess: z
+    .object({
+      sipAccessCode: z.string().optional(),
+      uri: z.string(),
+    })
+    .array(),
+
+  /** Typeable meeting code. */
+  meetingCode: z.string(),
+
+  /** Browser join URL. */
+  meetingUri: z.url(),
+
+  /** Stable space resource name. */
+  name: RESOURCE_NAME_SCHEMA,
+
+  /** Regional dial-in entry points. */
+  phoneAccess: z
+    .object({
+      languageCode: z.string().optional(),
+      phoneNumber: z.string(),
+      pin: z.string(),
+      regionCode: z.string().optional(),
+    })
+    .array(),
+})
+
+export const GOOGLE_MEET_CONFERENCE_RECORD_SCHEMA = z.object({
+  /** When the conference ended. Omitted while it is active. */
+  endTime: TIMESTAMP_SCHEMA.optional(),
+
+  /** When Google will delete this record. */
+  expireTime: TIMESTAMP_SCHEMA.optional(),
+
+  /** Stable conference-record resource name. */
+  name: RESOURCE_NAME_SCHEMA,
+
+  /** Space resource name where the conference occurred. */
+  space: RESOURCE_NAME_SCHEMA,
+
+  /** When the conference started. */
+  startTime: TIMESTAMP_SCHEMA,
+})
+
+export const GOOGLE_MEET_CONFERENCE_RECORD_PAGE_SCHEMA = z.object({
+  conferenceRecords: GOOGLE_MEET_CONFERENCE_RECORD_SCHEMA.array(),
+  nextPageToken: z.string().optional(),
+})
+
+export const GOOGLE_MEET_PARTICIPANT_SCHEMA = z.object({
+  /** First observed join time. */
+  earliestStartTime: TIMESTAMP_SCHEMA.optional(),
+
+  /** Last observed leave time. Omitted while the participant is active. */
+  latestEndTime: TIMESTAMP_SCHEMA.optional(),
+
+  /** Stable participant resource name. */
+  name: GOOGLE_MEET_PARTICIPANT_NAME_SCHEMA,
+
+  /** Participant identity reported by Meet. */
+  user: z.discriminatedUnion("type", [
+    z.object({ displayName: z.string(), type: z.literal("anonymous") }),
+    z.object({ displayName: z.string(), type: z.literal("phone") }),
+    z.object({
+      displayName: z.string(),
+      type: z.literal("signedIn"),
+      user: z.string().optional(),
+    }),
+  ]),
+})
+
+export const GOOGLE_MEET_PARTICIPANT_PAGE_SCHEMA = z.object({
+  nextPageToken: z.string().optional(),
+  participants: GOOGLE_MEET_PARTICIPANT_SCHEMA.array(),
+  totalSize: z.number().int().nonnegative().optional(),
+})
+
+export const GOOGLE_MEET_PARTICIPANT_SESSION_SCHEMA = z.object({
+  /** When the session ended. Omitted while it is active. */
+  endTime: TIMESTAMP_SCHEMA.optional(),
+
+  /** Stable participant-session resource name. */
+  name: GOOGLE_MEET_PARTICIPANT_SESSION_NAME_SCHEMA,
+
+  /** When the session started. */
+  startTime: TIMESTAMP_SCHEMA,
+})
+
+export const GOOGLE_MEET_PARTICIPANT_SESSION_PAGE_SCHEMA = z.object({
+  nextPageToken: z.string().optional(),
+  participantSessions: GOOGLE_MEET_PARTICIPANT_SESSION_SCHEMA.array(),
+})
+
+const ARTIFACT_STATE_SCHEMA = z.enum(["started", "ended", "fileGenerated"])
+const DOCS_DESTINATION_SCHEMA = z.object({
+  documentId: z.string().optional(),
+  exportUri: z.url().optional(),
+})
+
+export const GOOGLE_MEET_RECORDING_SCHEMA = z.object({
+  /** Google Drive destination after file generation completes. */
+  driveDestination: z
+    .object({
+      exportUri: z.url().optional(),
+      fileId: z.string().optional(),
+    })
+    .optional(),
+
+  /** When recording stopped. */
+  endTime: TIMESTAMP_SCHEMA.optional(),
+
+  /** Stable recording resource name. */
+  name: GOOGLE_MEET_RECORDING_NAME_SCHEMA,
+
+  /** When recording started. */
+  startTime: TIMESTAMP_SCHEMA.optional(),
+
+  /** Recording generation state. */
+  state: ARTIFACT_STATE_SCHEMA,
+})
+
+export const GOOGLE_MEET_RECORDING_PAGE_SCHEMA = z.object({
+  nextPageToken: z.string().optional(),
+  recordings: GOOGLE_MEET_RECORDING_SCHEMA.array(),
+})
+
+export const GOOGLE_MEET_TRANSCRIPT_SCHEMA = z.object({
+  /** Google Docs destination after file generation completes. */
+  docsDestination: DOCS_DESTINATION_SCHEMA.optional(),
+
+  /** When transcription stopped. */
+  endTime: TIMESTAMP_SCHEMA.optional(),
+
+  /** Stable transcript resource name. */
+  name: GOOGLE_MEET_TRANSCRIPT_NAME_SCHEMA,
+
+  /** When transcription started. */
+  startTime: TIMESTAMP_SCHEMA.optional(),
+
+  /** Transcript generation state. */
+  state: ARTIFACT_STATE_SCHEMA,
+})
+
+export const GOOGLE_MEET_TRANSCRIPT_PAGE_SCHEMA = z.object({
+  nextPageToken: z.string().optional(),
+  transcripts: GOOGLE_MEET_TRANSCRIPT_SCHEMA.array(),
+})
+
+export const GOOGLE_MEET_TRANSCRIPT_ENTRY_SCHEMA = z.object({
+  /** When this spoken segment ended. */
+  endTime: TIMESTAMP_SCHEMA,
+
+  /** BCP 47 language code detected for the segment. */
+  languageCode: z.string(),
+
+  /** Stable transcript-entry resource name. */
+  name: GOOGLE_MEET_TRANSCRIPT_ENTRY_NAME_SCHEMA,
+
+  /** Participant resource name for the speaker. */
+  participant: GOOGLE_MEET_PARTICIPANT_NAME_SCHEMA,
+
+  /** When this spoken segment started. */
+  startTime: TIMESTAMP_SCHEMA,
+
+  /** Transcribed speech. */
+  text: z.string(),
+})
+
+export const GOOGLE_MEET_TRANSCRIPT_ENTRY_PAGE_SCHEMA = z.object({
+  nextPageToken: z.string().optional(),
+  transcriptEntries: GOOGLE_MEET_TRANSCRIPT_ENTRY_SCHEMA.array(),
+})
+
+export const GOOGLE_MEET_SMART_NOTE_SCHEMA = z.object({
+  /** Google Docs destination after file generation completes. */
+  docsDestination: DOCS_DESTINATION_SCHEMA.optional(),
+
+  /** When smart-note capture stopped. */
+  endTime: TIMESTAMP_SCHEMA.optional(),
+
+  /** Stable smart-note resource name. */
+  name: GOOGLE_MEET_SMART_NOTE_NAME_SCHEMA,
+
+  /** When smart-note capture started. */
+  startTime: TIMESTAMP_SCHEMA.optional(),
+
+  /** Smart-note generation state. */
+  state: ARTIFACT_STATE_SCHEMA,
+})
+
+export const GOOGLE_MEET_SMART_NOTE_PAGE_SCHEMA = z.object({
+  nextPageToken: z.string().optional(),
+  smartNotes: GOOGLE_MEET_SMART_NOTE_SCHEMA.array(),
+})

package/src/linear/schemas.ts

@@ -550,6 +550,9 @@ export const LINEAR_USER_SCHEMA = LINEAR_USER_REFERENCE_SCHEMA.extend({
   /** Whether this user owns the workspace. */
   owner: z.boolean(),
 
+  /** Whether this app user can run Linear agent sessions. */
+  supportsAgentSessions: z.boolean(),
+
   /** IANA time zone configured for the user. */
   timezone: z.string().nullable(),
 
@@ -704,6 +707,83 @@ export const LINEAR_ISSUE_REFERENCE_SCHEMA = z.object({
   url: z.string(),
 })
 
+/** Lifecycle states returned for Linear agent sessions. */
+export const LINEAR_AGENT_SESSION_STATUS_SCHEMA = z.enum([
+  "pending",
+  "active",
+  "awaitingInput",
+  "complete",
+  "error",
+  "stale",
+])
+
+/** Lifecycle states returned for one Linear agent-session plan step. */
+export const LINEAR_AGENT_SESSION_PLAN_ITEM_STATUS_SCHEMA = z.enum([
+  "pending",
+  "inProgress",
+  "completed",
+  "canceled",
+])
+
+/** One step in a Linear agent session's execution plan. */
+export const LINEAR_AGENT_SESSION_PLAN_ITEM_SCHEMA = z.object({
+  /** Human-readable work planned for this step. */
+  content: z.string(),
+
+  /** Current lifecycle state of the plan step. */
+  status: LINEAR_AGENT_SESSION_PLAN_ITEM_STATUS_SCHEMA,
+})
+
+/** One coding or other agent session attached to a Linear issue. */
+export const LINEAR_AGENT_SESSION_SCHEMA = z.object({
+  /** Agent app user running the session. */
+  appUser: LINEAR_USER_REFERENCE_SCHEMA,
+
+  /** When the session was created. */
+  createdAt: LINEAR_DATE_TIME_SCHEMA,
+
+  /** When the session was dismissed, or `null` while retained. */
+  dismissedAt: LINEAR_DATE_TIME_SCHEMA.nullable(),
+
+  /** When the session finished, or `null` while unfinished. */
+  endedAt: LINEAR_DATE_TIME_SCHEMA.nullable(),
+
+  /** External resources attached to the session. */
+  externalLinks: z
+    .object({
+      label: z.string(),
+      url: z.string(),
+    })
+    .array(),
+
+  /** Stable Linear agent-session ID. */
+  id: z.string(),
+
+  /** Issue whose context started the session. */
+  issue: LINEAR_ISSUE_REFERENCE_SCHEMA.nullable(),
+
+  /** Ordered execution plan reported by the agent, or `null` before one is set. */
+  plan: LINEAR_AGENT_SESSION_PLAN_ITEM_SCHEMA.array().nullable(),
+
+  /** URL-safe Linear session identifier. */
+  slugId: z.string(),
+
+  /** When the agent began work, or `null` while pending. */
+  startedAt: LINEAR_DATE_TIME_SCHEMA.nullable(),
+
+  /** Current session lifecycle state. */
+  status: LINEAR_AGENT_SESSION_STATUS_SCHEMA,
+
+  /** Human-readable result summary, when available. */
+  summary: z.string().nullable(),
+
+  /** When the session was last updated. */
+  updatedAt: LINEAR_DATE_TIME_SCHEMA,
+
+  /** Linear page for the session, when available. */
+  url: z.string().nullable(),
+})
+
 export const LINEAR_PROJECT_STATUS_SCHEMA = z.object({
   /** Project status display color. */
   color: z.string(),
@@ -832,6 +912,9 @@ export const LINEAR_ISSUE_SCHEMA = z.object({
   /** Markdown issue description. */
   description: z.string().nullable(),
 
+  /** Agent currently delegated to work on the issue. */
+  delegate: LINEAR_USER_REFERENCE_SCHEMA.nullable(),
+
   /** Issue due date. */
   dueDate: z.iso.date().nullable(),
 

package/src/triggers.ts

@@ -5,6 +5,7 @@ import { githubTriggerContracts } from "./github"
 import { gmailTriggerContracts } from "./gmail"
 import { googleCalendarTriggerContracts } from "./google-calendar"
 import { googleFormsTriggerContracts } from "./google-forms"
+import { googleMeetTriggerContracts } from "./google-meet"
 import { linearTriggerContracts } from "./linear"
 import { outlookTriggerContracts } from "./outlook"
 import { resendTriggerContracts } from "./resend"
@@ -22,6 +23,7 @@ type IntegrationTriggerContracts = typeof airtableTriggerContracts &
   typeof gmailTriggerContracts &
   typeof googleCalendarTriggerContracts &
   typeof googleFormsTriggerContracts &
+  typeof googleMeetTriggerContracts &
   typeof linearTriggerContracts &
   typeof outlookTriggerContracts &
   typeof resendTriggerContracts &
@@ -40,6 +42,7 @@ export const triggerContracts: IntegrationTriggerContracts = {
   ...gmailTriggerContracts,
   ...googleCalendarTriggerContracts,
   ...googleFormsTriggerContracts,
+  ...googleMeetTriggerContracts,
   ...linearTriggerContracts,
   ...outlookTriggerContracts,
   ...resendTriggerContracts,