Skip to content
Sign up

flagon-io/g1t

public
0
171 linesCodeBlameRaw

Pick any line to see why it is the way it is: the commit, the pull request and issue it came from, and what the agent was thinking.

README says what is working today; the free allowance says what it covers1import type { User, Viewer } from "./identity";
2import type { RepoPath } from "./repos";
3import type { Result } from "./result";
4
5/**
6 * Events, delivered to the addresses a repository or a workspace registers.
7 * Mirrors `crates/contracts/src/webhooks.rs`.
8 */
9
10/** Every event a webhook can be sent, in the order people are shown them. */
11export const EVENT_TYPES = [
12 "git.push",
Merge branch 'worktree-agent-a8b78c62188153aa3' into claude/cool-newton-7nm8r913 "git.deleted",
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look14 "branch.renamed",
README says what is working today; the free allowance says what it covers15 "repo.created",
16 "repo.forked",
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look17 "repo.updated",
18 "repo.visibility_changed",
19 "repo.renamed",
20 "repo.transferred",
21 "repo.default_branch_changed",
22 "repo.archived",
23 "repo.unarchived",
24 "repo.deleted",
25 "repo.restored",
26 "repo.purged",
27 "repo.collaborator_added",
28 "repo.collaborator_removed",
29 "repo.collaborator_role_changed",
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar30 "team.created",
31 "team.edited",
32 "team.deleted",
33 "team.member_added",
34 "team.member_role_changed",
35 "team.member_removed",
36 "team.repo_added",
37 "team.repo_role_changed",
38 "team.repo_removed",
@g1t welcomes you when you join a workspace, and that is the one introduction any agent makes. Identity now says when a person becomes a member, workspace.member_joined, by invitation, by an invite code, or by creating the workspace, and webhooks can hear it; the agents service hears it too, and for anyone who joined, never the creator, the workspace's @g1t opens your direct message and says in its own voice who it is, what to ask it, how agents answer, and where things are, once per person per workspace and charged to @g1t like any reply, with a fixed welcome when no model can be used. The agents, workspaces, authentication and webhooks guides say so.39 "workspace.member_joined",
Merge rulesets: branch and tag rules, agent-first, enforced on push and merge40 "ruleset.created",
41 "ruleset.updated",
42 "ruleset.deleted",
README says what is working today; the free allowance says what it covers43 "issue.opened",
44 "issue.updated",
45 "issue.assigned",
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar46 "issue.labeled",
47 "issue.unlabeled",
48 "issue.milestoned",
49 "issue.demilestoned",
README says what is working today; the free allowance says what it covers50 "issue.closed",
51 "issue.reopened",
52 "comment.created",
Merge Actions: cross-repo workflows and actions, release and deployment triggers, step timeouts53 "comment.edited",
54 "comment.deleted",
README says what is working today; the free allowance says what it covers55 "pull.opened",
56 "pull.ready",
57 "pull.updated",
58 "pull.merge_requested",
59 "pull.merged",
60 "pull.closed",
Merge Actions: cross-repo workflows and actions, release and deployment triggers, step timeouts61 "pull.reopened",
62 "pull.converted_to_draft",
Events: review requests, assignments, stops and deployments are published63 "pull.assigned",
64 "pull.review_requested",
65 "pull.review_request_removed",
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar66 "pull.labeled",
67 "pull.unlabeled",
68 "pull.milestoned",
69 "pull.demilestoned",
70 "pull.base_changed",
Events: review requests, assignments, stops and deployments are published71 "pull.stalled",
72 "pull.resumed",
Merge Actions: cross-repo workflows and actions, release and deployment triggers, step timeouts73 "release.created",
74 "release.published",
75 "release.released",
76 "release.prereleased",
77 "release.edited",
78 "release.unpublished",
79 "release.deleted",
README says what is working today; the free allowance says what it covers80 "agent.asked",
81 "checks.completed",
Merge checks: statuses and check runs on every commit82 "status.created",
83 "check_run.created",
84 "check_run.completed",
85 "check_run.rerequested",
86 "check_run.requested_action",
87 "check_suite.completed",
88 "check_suite.rerequested",
README says what is working today; the free allowance says what it covers89 "review.completed",
90 "workflow.completed",
Events: review requests, assignments, stops and deployments are published91 "deployment.succeeded",
92 "deployment.failed",
Merge branch 'main' into worktree-agent-a69aeabc4b0deeb9793 "deployment.created",
94 "deployment_status.created",
README says what is working today; the free allowance says what it covers95 "queue.changed",
96 "session.appended",
Packages, with a container registry on g1t.sh; workspaces deleted whole and kept 30 days; Members for every member97 "package.published",
98 "package.version_deleted",
99 "package.deleted",
100 "package.visibility_changed",
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar101 "secret_scanning_alert.created",
102 "secret_scanning_alert.fixed",
103 "secret_scanning_alert.dismissed",
104 "secret_scanning_alert.reopened",
105 "secret_scanning.bypass_requested",
106 "secret_scanning.bypass_reviewed",
107 "code_scanning_alert.created",
108 "code_scanning_alert.fixed",
109 "code_scanning_alert.dismissed",
110 "code_scanning_alert.reopened",
111 "vulnerability_alert.created",
112 "vulnerability_alert.fixed",
113 "vulnerability_alert.dismissed",
114 "vulnerability_alert.reopened",
Merge branch 'mirroring' into artifacts-mode115 "mirror.unreachable",
116 "mirror.reachable",
117 "mirror.state_changed",
118 "mirror.moved_in",
README says what is working today; the free allowance says what it covers119] as const;
120
121export type Hook = {
122 id: string;
123 scope: "repo" | "workspace";
124 workspace: string;
125 /** For a repository's webhook: `owner/name`. */
126 repo: string | null;
127 url: string;
128 /** Event types, or `["*"]` for all. */
129 events: string[];
130 active: boolean;
131 secretHint: string;
132 createdBy: string;
133 createdAt: string;
134 lastStatus: "delivered" | "pending" | "failed" | null;
135 lastDeliveredAt: string | null;
136};
137
138export type HookDelivery = {
139 id: string;
140 hookId: string;
141 eventId: string;
142 event: string;
143 status: "pending" | "delivered" | "failed";
144 attempts: number;
145 responseStatus: number | null;
146 responseBody: string | null;
147 error: string | null;
148 durationMs: number | null;
149 /** The JSON that was sent. */
150 payload: string;
151 createdAt: string;
152 deliveredAt: string | null;
153 nextAttemptAt: string | null;
154};
155
156/** A repository's webhooks, or with `repo` left out, the workspace's own. */
157export type HookOwner = { workspace: string; repo?: RepoPath };
158
159export interface WebhooksApi {
160 list(viewer: Viewer, owner: HookOwner): Promise<Result<Hook[]>>;
161 create(
162 actor: User,
163 owner: HookOwner,
164 input: { url: string; events?: string[]; secret?: string },
165 ): Promise<Result<{ hook: Hook; secret: string | null }>>;
166 update(actor: User, owner: HookOwner, id: string, input: { url?: string; events?: string[]; active?: boolean }): Promise<Result<Hook>>;
167 delete(actor: User, owner: HookOwner, id: string): Promise<Result<boolean>>;
168 ping(actor: User, owner: HookOwner, id: string): Promise<Result<HookDelivery>>;
169 deliveries(viewer: Viewer, owner: HookOwner, id: string): Promise<Result<HookDelivery[]>>;
170 redeliver(actor: User, owner: HookOwner, deliveryId: string): Promise<Result<HookDelivery>>;
171}

This file's history is long; its oldest lines are credited to the oldest commit read.