terse-types 0.0.3 → 0.0.5

package/dist/Triggers.js

@@ -0,0 +1,436 @@
+import { z } from "zod";
+import { GitHubEventType, WorkOSEventType, gitHubEventTypeSchema, gmailEventTypeSchema, linearEventTypeSchema, slackEventTypeSchema, workOSEventTypeSchema } from "./Configs.js";
+import { IntegrationType, integrationTypeEnum } from "./Integrations.js";
+import { SlackChannelType } from "./SlackTypes.js";
+import { debugTrigger as debugTriggerWithPresenter, formatTriggerForAgent as formatTriggerForAgentWithPresenter } from "./TriggerPresenters.js";
+const providerTriggerTypeSchema = z.union([slackEventTypeSchema, gitHubEventTypeSchema, linearEventTypeSchema, gmailEventTypeSchema, workOSEventTypeSchema]);
+const TriggerHeaderSchema = z.object({
+    integrationType: integrationTypeEnum,
+    eventType: providerTriggerTypeSchema
+});
+const slackTriggerBaseSchema = TriggerHeaderSchema.extend({
+    integrationType: z.literal(IntegrationType.SLACK),
+    eventType: slackEventTypeSchema,
+    channelId: z.string(),
+    channelName: z.string().nullable(),
+    userId: z.string(),
+    userName: z.string().nullable(),
+    text: z.string(),
+    timestamp: z.string(),
+    // Keep both names during migration; `threadTs` is the target shared field.
+    threadTs: z.string().nullable().optional(),
+    threadTimestamp: z.string().nullable(),
+    teamId: z.string(),
+    permalink: z.string().nullable(),
+    channelType: z.enum(SlackChannelType).nullable(),
+    blocks: z.array(z.unknown()).nullable(),
+    attachments: z.array(z.unknown()).nullable(),
+    files: z.array(z.unknown()).nullable()
+});
+export const slackMessageTriggerSchema = slackTriggerBaseSchema.extend({
+    eventType: z.literal("message")
+});
+export const slackAppMentionTriggerSchema = slackTriggerBaseSchema.extend({
+    eventType: z.literal("app_mention")
+});
+export const slackReactionAddedTriggerSchema = slackTriggerBaseSchema.extend({
+    eventType: z.literal("reaction_added"),
+    reaction: z.string(),
+    itemType: z.string().nullable(),
+    itemUserId: z.string().nullable(),
+    itemChannelId: z.string().nullable(),
+    itemTimestamp: z.string().nullable()
+});
+export const slackTriggerSchema = z.discriminatedUnion("eventType", [slackMessageTriggerSchema, slackAppMentionTriggerSchema, slackReactionAddedTriggerSchema]);
+// Github Event Data
+export const fileDiffSchema = z.object({
+    filename: z.string(),
+    diff: z.string()
+});
+export const commitSchema = z.object({
+    sha: z.string(),
+    // Keep both names during migration; `message` is the target shared field.
+    message: z.string().optional(),
+    name: z.string(),
+    fileDiffs: z.array(fileDiffSchema)
+});
+export const pullRequestUserSchema = z.object({
+    login: z.string(),
+    email: z.string().optional()
+});
+export const pullRequestRefSchema = z.object({
+    ref: z.string(),
+    sha: z.string()
+});
+export const pullRequestSchema = z.object({
+    id: z.string(),
+    number: z.number(),
+    title: z.string(),
+    body: z.string().optional(),
+    state: z.enum(["open", "closed"]),
+    merged: z.boolean(),
+    head: pullRequestRefSchema,
+    base: pullRequestRefSchema,
+    // Keep both names during migration; `author` is the target shared field.
+    user: pullRequestUserSchema,
+    author: pullRequestUserSchema.optional(),
+    url: z.string().optional()
+});
+export const githubRepositorySchema = z.object({
+    id: z.number(),
+    name: z.string(),
+    owner: z.string(),
+    defaultBranch: z.string()
+});
+export const senderSchema = z.object({
+    login: z.string(),
+    email: z.string().optional()
+});
+const GithubTriggerBaseSchema = z.object({
+    integrationType: z.literal(IntegrationType.GITHUB),
+    username: z.string(),
+    installationId: z.number(),
+    repositoryName: z.string(),
+    repository: githubRepositorySchema,
+    sender: senderSchema
+});
+export const GithubPushTriggerSchema = GithubTriggerBaseSchema.extend({
+    eventType: z.literal(GitHubEventType.PUSH),
+    branch: z.string(),
+    commits: z.array(commitSchema),
+    pullRequest: z.undefined().optional()
+});
+const GithubPRTriggerBaseSchema = GithubTriggerBaseSchema.extend({
+    pullRequest: pullRequestSchema,
+    branch: z.string().optional(),
+    commits: z.array(commitSchema)
+});
+export const GithubPROpenedTriggerSchema = GithubPRTriggerBaseSchema.extend({
+    eventType: z.literal(GitHubEventType.PR_OPENED)
+});
+export const GithubPRSynchronizedTriggerSchema = GithubPRTriggerBaseSchema.extend({
+    eventType: z.literal(GitHubEventType.PR_SYNCHRONIZE)
+});
+export const GithubPRClosedTriggerSchema = GithubPRTriggerBaseSchema.extend({
+    eventType: z.literal(GitHubEventType.PR_CLOSED)
+});
+export const GithubPRMergedTriggerSchema = GithubPRTriggerBaseSchema.extend({
+    eventType: z.literal(GitHubEventType.PR_MERGED)
+});
+export const GithubPRTriggerSchema = z.discriminatedUnion("eventType", [GithubPROpenedTriggerSchema, GithubPRSynchronizedTriggerSchema, GithubPRClosedTriggerSchema, GithubPRMergedTriggerSchema]);
+export const GithubTriggerSchema = z.discriminatedUnion("eventType", [
+    GithubPushTriggerSchema,
+    GithubPROpenedTriggerSchema,
+    GithubPRSynchronizedTriggerSchema,
+    GithubPRClosedTriggerSchema,
+    GithubPRMergedTriggerSchema
+]);
+export const GmailParsedAttachmentSchema = z.object({
+    attachmentId: z.string(),
+    filename: z.string(),
+    mimeType: z.string(),
+    contentId: z.string().optional(),
+    isInline: z.boolean()
+});
+const gmailMessagePayloadSchema = z.object({
+    id: z.string(),
+    threadId: z.string(),
+    subject: z.string(),
+    from: z.string(),
+    to: z.string(),
+    date: z.string(),
+    internalDate: z.string(),
+    messageId: z.string(),
+    body: z.string(),
+    snippet: z.string(),
+    labelIds: z.array(z.string()),
+    attachments: z.array(GmailParsedAttachmentSchema).optional()
+});
+export const LinearWebhookActionSchema = z.enum(["create", "update", "remove"]);
+export const LinearWebhookTypeSchema = z.union([z.literal("Issue"), z.literal("Comment"), z.literal("Project"), z.string()]);
+export const LinearWebhookActorSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    email: z.string(),
+    url: z.string(),
+    type: z.string()
+});
+export const LinearWebhookStateSchema = z.object({
+    id: z.string(),
+    color: z.string(),
+    name: z.string(),
+    type: z.string()
+});
+export const LinearWebhookTeamSchema = z.object({
+    id: z.string(),
+    key: z.string(),
+    name: z.string()
+});
+export const LinearWebhookAssigneeSchema = z.object({
+    id: z.string(),
+    name: z.string()
+});
+export const LinearWebhookDataSchema = z.object({
+    id: z.string(),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+    number: z.number(),
+    title: z.string(),
+    priority: z.number(),
+    sortOrder: z.number(),
+    prioritySortOrder: z.number(),
+    slaType: z.string(),
+    addedToTeamAt: z.string(),
+    trashed: z.boolean(),
+    labelIds: z.array(z.string()),
+    teamId: z.string(),
+    previousIdentifiers: z.array(z.string()),
+    stateId: z.string(),
+    reactionData: z.array(z.any()),
+    priorityLabel: z.string(),
+    botActor: z.string().optional(),
+    identifier: z.string(),
+    url: z.string(),
+    subscriberIds: z.array(z.string()),
+    state: LinearWebhookStateSchema,
+    team: LinearWebhookTeamSchema,
+    labels: z.array(z.any()),
+    description: z.string().optional(),
+    descriptionData: z.string().optional(),
+    assignee: LinearWebhookAssigneeSchema.optional(),
+    /** Present on many issue webhooks; used for trigger scoping */
+    projectId: z.string().optional()
+});
+export const LinearWebhookCommentDataSchema = z
+    .object({
+    id: z.string(),
+    body: z.string().optional(),
+    issueId: z.string().optional()
+})
+    .passthrough();
+export const linearWebhookPayloadSchema = z.object({
+    action: LinearWebhookActionSchema,
+    actor: LinearWebhookActorSchema,
+    createdAt: z.string(),
+    data: LinearWebhookDataSchema,
+    type: LinearWebhookTypeSchema,
+    url: z.string().optional(),
+    organizationId: z.string(),
+    webhookTimestamp: z.number(),
+    webhookId: z.string()
+});
+export const WorkOSWebhookDataSchema = z.record(z.string(), z.any());
+export const workOSWebhookPayloadSchema = z.object({
+    id: z.string(),
+    event: z.string(),
+    data: WorkOSWebhookDataSchema,
+    created_at: z.string()
+});
+// MARK: Canonical Trigger Events
+export const webhookTriggerTypeSchema = z.literal("webhook");
+export const cronTriggerTypeSchema = z.literal("cron");
+export const manualSampleTriggerTypeSchema = z.literal("manual_sample");
+export const TriggerTypeSchema = z.union([
+    slackEventTypeSchema,
+    gitHubEventTypeSchema,
+    linearEventTypeSchema,
+    gmailEventTypeSchema,
+    workOSEventTypeSchema,
+    webhookTriggerTypeSchema,
+    cronTriggerTypeSchema,
+    manualSampleTriggerTypeSchema
+]);
+export const baseTriggerSchema = z.object({
+    integrationType: integrationTypeEnum,
+    eventType: TriggerTypeSchema
+});
+export const gmailTriggerSchema = baseTriggerSchema
+    .extend({
+    integrationType: z.literal(IntegrationType.GMAIL),
+    eventType: gmailEventTypeSchema
+})
+    .merge(gmailMessagePayloadSchema);
+const linearTriggerBaseSchema = z.object({
+    integrationType: z.literal(IntegrationType.LINEAR),
+    action: LinearWebhookActionSchema,
+    actor: LinearWebhookActorSchema,
+    createdAt: z.string(),
+    url: z.string().optional(),
+    organizationId: z.string(),
+    webhookTimestamp: z.number(),
+    webhookId: z.string()
+});
+export const linearIssueCreatedTriggerSchema = linearTriggerBaseSchema.extend({
+    eventType: z.literal("issue.created"),
+    action: z.literal("create"),
+    type: z.literal("Issue"),
+    data: LinearWebhookDataSchema
+});
+export const linearIssueUpdatedTriggerSchema = linearTriggerBaseSchema.extend({
+    eventType: z.literal("issue.updated"),
+    action: z.literal("update"),
+    type: z.literal("Issue"),
+    data: LinearWebhookDataSchema
+});
+export const linearCommentCreatedTriggerSchema = linearTriggerBaseSchema.extend({
+    eventType: z.literal("comment.created"),
+    action: z.literal("create"),
+    type: z.literal("Comment"),
+    data: LinearWebhookCommentDataSchema
+});
+export const linearTriggerSchema = z.discriminatedUnion("eventType", [linearIssueCreatedTriggerSchema, linearIssueUpdatedTriggerSchema, linearCommentCreatedTriggerSchema]);
+export const workOSTriggerUserSchema = z.object({
+    id: z.string(),
+    email: z.string(),
+    firstName: z.string().optional(),
+    lastName: z.string().optional(),
+    emailVerified: z.boolean(),
+    profilePictureUrl: z.string().optional()
+});
+export const workOSTriggerMembershipSchema = z.object({
+    id: z.string(),
+    userId: z.string(),
+    organizationId: z.string(),
+    role: z.object({
+        slug: z.string()
+    }),
+    status: z.string()
+});
+export const workOSTriggerInvitationSchema = z.object({
+    id: z.string(),
+    email: z.string(),
+    organizationId: z.string(),
+    inviterEmail: z.string().optional(),
+    state: z.string(),
+    acceptedAt: z.string().optional()
+});
+export const workOSTriggerOrganizationSchema = z.object({
+    id: z.string(),
+    name: z.string()
+});
+const workOSTriggerBaseSchema = baseTriggerSchema.extend({
+    integrationType: z.literal(IntegrationType.WORKOS),
+    eventType: workOSEventTypeSchema,
+    eventId: z.string(),
+    createdAt: z.string()
+});
+export const workOSUserCreatedTriggerSchema = workOSTriggerBaseSchema.extend({
+    eventType: z.literal(WorkOSEventType.USER_CREATED),
+    user: workOSTriggerUserSchema
+});
+export const workOSUserUpdatedTriggerSchema = workOSTriggerBaseSchema.extend({
+    eventType: z.literal(WorkOSEventType.USER_UPDATED),
+    user: workOSTriggerUserSchema
+});
+export const workOSUserDeletedTriggerSchema = workOSTriggerBaseSchema.extend({
+    eventType: z.literal(WorkOSEventType.USER_DELETED),
+    user: workOSTriggerUserSchema
+});
+export const workOSUserTriggerSchema = z.discriminatedUnion("eventType", [workOSUserCreatedTriggerSchema, workOSUserUpdatedTriggerSchema, workOSUserDeletedTriggerSchema]);
+export const workOSOrganizationMembershipCreatedTriggerSchema = workOSTriggerBaseSchema.extend({
+    eventType: z.literal(WorkOSEventType.ORGANIZATION_MEMBERSHIP_CREATED),
+    membership: workOSTriggerMembershipSchema
+});
+export const workOSOrganizationMembershipUpdatedTriggerSchema = workOSTriggerBaseSchema.extend({
+    eventType: z.literal(WorkOSEventType.ORGANIZATION_MEMBERSHIP_UPDATED),
+    membership: workOSTriggerMembershipSchema
+});
+export const workOSOrganizationMembershipDeletedTriggerSchema = workOSTriggerBaseSchema.extend({
+    eventType: z.literal(WorkOSEventType.ORGANIZATION_MEMBERSHIP_DELETED),
+    membership: workOSTriggerMembershipSchema
+});
+export const workOSMembershipTriggerSchema = z.discriminatedUnion("eventType", [
+    workOSOrganizationMembershipCreatedTriggerSchema,
+    workOSOrganizationMembershipUpdatedTriggerSchema,
+    workOSOrganizationMembershipDeletedTriggerSchema
+]);
+export const workOSInvitationCreatedTriggerSchema = workOSTriggerBaseSchema.extend({
+    eventType: z.literal(WorkOSEventType.INVITATION_CREATED),
+    invitation: workOSTriggerInvitationSchema,
+    user: workOSTriggerUserSchema.optional()
+});
+export const workOSInvitationAcceptedTriggerSchema = workOSTriggerBaseSchema.extend({
+    eventType: z.literal(WorkOSEventType.INVITATION_ACCEPTED),
+    invitation: workOSTriggerInvitationSchema,
+    user: workOSTriggerUserSchema.optional()
+});
+export const workOSInvitationResentTriggerSchema = workOSTriggerBaseSchema.extend({
+    eventType: z.literal(WorkOSEventType.INVITATION_RESENT),
+    invitation: workOSTriggerInvitationSchema,
+    user: workOSTriggerUserSchema.optional()
+});
+export const workOSInvitationRevokedTriggerSchema = workOSTriggerBaseSchema.extend({
+    eventType: z.literal(WorkOSEventType.INVITATION_REVOKED),
+    invitation: workOSTriggerInvitationSchema,
+    user: workOSTriggerUserSchema.optional()
+});
+export const workOSInvitationTriggerSchema = z.discriminatedUnion("eventType", [
+    workOSInvitationCreatedTriggerSchema,
+    workOSInvitationAcceptedTriggerSchema,
+    workOSInvitationResentTriggerSchema,
+    workOSInvitationRevokedTriggerSchema
+]);
+export const workOSOrganizationTriggerSchema = workOSTriggerBaseSchema.extend({
+    eventType: z.literal(WorkOSEventType.ORGANIZATION_CREATED),
+    organization: workOSTriggerOrganizationSchema
+});
+export const workOSTriggerSchema = z.discriminatedUnion("eventType", [
+    workOSUserCreatedTriggerSchema,
+    workOSUserUpdatedTriggerSchema,
+    workOSUserDeletedTriggerSchema,
+    workOSOrganizationMembershipCreatedTriggerSchema,
+    workOSOrganizationMembershipUpdatedTriggerSchema,
+    workOSOrganizationMembershipDeletedTriggerSchema,
+    workOSInvitationCreatedTriggerSchema,
+    workOSInvitationAcceptedTriggerSchema,
+    workOSInvitationResentTriggerSchema,
+    workOSInvitationRevokedTriggerSchema,
+    workOSOrganizationTriggerSchema
+]);
+export const webhookTriggerSchema = baseTriggerSchema.extend({
+    integrationType: z.literal(IntegrationType.WEBHOOK),
+    eventType: webhookTriggerTypeSchema,
+    body: z.record(z.string(), z.unknown()),
+    headers: z.record(z.string(), z.string()),
+    method: z.string()
+});
+export const cronTriggerSchema = baseTriggerSchema.extend({
+    integrationType: z.literal(IntegrationType.CRON_JOB),
+    eventType: cronTriggerTypeSchema,
+    inputId: z.string(),
+    isManualTrigger: z.boolean().optional(),
+    manualContext: z.string().optional()
+});
+export const manualSampleTriggerSchema = baseTriggerSchema.extend({
+    eventType: manualSampleTriggerTypeSchema
+});
+export const TriggerSchema = z.union([
+    slackTriggerSchema,
+    GithubTriggerSchema,
+    gmailTriggerSchema,
+    linearTriggerSchema,
+    workOSTriggerSchema,
+    webhookTriggerSchema,
+    cronTriggerSchema,
+    manualSampleTriggerSchema
+]);
+export function createManualTrigger(params = {}) {
+    return TriggerSchema.parse({
+        integrationType: params.integrationType ?? IntegrationType.TERSE,
+        eventType: "manual_sample"
+    });
+}
+export function formatTriggerForAgent(event) {
+    return formatTriggerForAgentWithPresenter(event);
+}
+export function debugTrigger(event) {
+    return debugTriggerWithPresenter(event);
+}
+export const TriggerArraySchema = z.array(TriggerSchema);
+export const serializedEventSchema = z.object({
+    integrationType: integrationTypeEnum,
+    eventType: TriggerTypeSchema,
+    formattedContent: z.string(),
+    debugLog: z.string(),
+    data: TriggerSchema
+});

package/dist/index.d.ts

@@ -11,10 +11,12 @@ export * from "./ModelEvents.js";
 export * from "./Notifications.js";
 export * from "./RunHistoryTypes.js";
 export * from "./SentNotifications.js";
+export * from "./SlackTypes.js";
 export * from "./SocketEvents.js";
 export * from "./Survey.js";
 export * from "./Tools.js";
 export { Comment, CreateTicketInput, LinearStateName, Milestone, Organization, Project, Team, Ticket, TicketState, TicketSystemType, TicketWebhookHandler, Update, UpdateTicketInput, UserContext } from "./TicketSystem.js";
 export * from "./ToolDisplayUtils.js";
+export * from "./Triggers.js";
 export * from "./ToolsTypes.js";
 export * from "./types.js";

package/dist/index.js

@@ -11,10 +11,12 @@ export * from "./ModelEvents.js";
 export * from "./Notifications.js";
 export * from "./RunHistoryTypes.js";
 export * from "./SentNotifications.js";
+export * from "./SlackTypes.js";
 export * from "./SocketEvents.js";
 export * from "./Survey.js";
 export * from "./Tools.js";
 export { LinearStateName, TicketSystemType } from "./TicketSystem.js";
 export * from "./ToolDisplayUtils.js";
+export * from "./Triggers.js";
 export * from "./ToolsTypes.js";
 export * from "./types.js";