flagon-io/g1t

public

Where people and agents ship software together. The open-source git platform for the whole job: issues, agents, checks and deploys to the edge.

g1t/packages/contracts/src/clients.ts

296 lines16,981 bytesCodeBlame

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.

GitHub Actions on g1t, part three: .g1t/workflows, the pages, the docs1import type { ActionsApi } from "./actions";
Agents as a team: lifecycle, merge queue, billing and a new shell2import type { BillingApi } from "./billing";
Deployments: a preview for every pull request, production on g1t.page3import type { DeploymentsApi } from "./deployments";
Projects: what a workspace builds and runs, first on every page4import type { ProjectsApi } from "./projects";
Events service in Rust, with RFC 3339 times and accurate push events5import type { EventsApi } from "./events";
API and MCP server, Rust identity service, registration, site redesign6import type { IdentityApi } from "./identity";
Integrations: your own model provider, alerts that open issues, tickets agents read7import type { IntegrationsApi } from "./integrations";
Webhooks: every event, to your own addresses, signed and retried8import type { WebhooksApi } from "./webhooks";
Rust repos service with shipping; pull requests kept in the model9import type { ReposApi } from "./repos";
Work service in Rust, with RFC 3339 timestamps10import type { WorkApi } from "./work";
API and MCP server, Rust identity service, registration, site redesign11
12/** A service binding, as far as these clients need it. */
13export type ServiceBinding = {
14 fetch(input: string, init?: RequestInit): Promise<Response>;
15};
16
17/**
18 * Calls a method on a service that speaks the JSON protocol used by the
19 * Rust services: `POST /rpc/<method>` with the arguments as the body.
20 */
21async function rpc<T>(
22 service: ServiceBinding,
23 method: string,
24 args: object,
25): Promise<T> {
26 // The hostname is ignored; a service binding always reaches its service.
27 const response = await service.fetch(`https://service/rpc/${method}`, {
28 method: "POST",
29 headers: { "content-type": "application/json" },
30 body: JSON.stringify(args),
31 });
32 if (!response.ok) {
33 throw new Error(`${method} failed with status ${response.status}`);
34 }
Agents as a team: lifecycle, merge queue, billing and a new shell35 return (await response.json()) as T;
API and MCP server, Rust identity service, registration, site redesign36}
37
38export function identityClient(service: ServiceBinding): IdentityApi {
39 const call = <T>(method: string, args: object) => rpc<T>(service, method, args);
40 return {
41 register: (username, email, password) =>
42 call("register", { username, email, password }),
43 signIn: (username, password) => call("sign_in", { username, password }),
44 signOut: (sessionToken) => call("sign_out", { sessionToken }),
Email verification, password reset, and Git for AI scale positioning45 resendVerification: (user) => call("resend_verification", { user }),
46 verifyEmail: (token) => call("verify_email", { token }),
47 requestPasswordReset: (email) => call("request_password_reset", { email }),
48 resetPassword: (token, password) =>
49 call("reset_password", { token, password }),
Device sign-in replaces registering and minting tokens over the API50 deviceStart: (clientName) => call("device_start", { clientName }),
51 deviceLookup: (userCode) => call("device_lookup", { userCode }),
52 deviceResolve: (userCode, user, approve) =>
53 call("device_resolve", { userCode, user, approve }),
54 deviceClaim: (deviceCode) => call("device_claim", { deviceCode }),
OAuth 2.1 sign-in for MCP clients and other applications55 oauthAuthorize: (user, approval) => call("oauth_authorize", { user, ...approval }),
56 oauthExchange: (code, codeVerifier, clientId, redirectUri) =>
57 call("oauth_exchange", { code, codeVerifier, clientId, redirectUri }),
58 oauthRefresh: (refreshToken, clientId) =>
59 call("oauth_refresh", { refreshToken, clientId }),
60 listOAuthGrants: (user) => call("list_oauth_grants", { user }),
61 revokeOAuthGrant: (user, id) => call("revoke_oauth_grant", { user, id }),
Workspaces own repositories62 createWorkspace: (user, slug, name) => call("create_workspace", { user, slug, name }),
63 getWorkspace: (slug) => call("get_workspace", { slug }),
64 listMembers: (slug, viewer) => call("list_members", { slug, viewer }),
65 addMember: (actor, slug, username) => call("add_member", { actor, slug, username }),
66 removeMember: (actor, slug, username) =>
67 call("remove_member", { actor, slug, username }),
Agents as a team: lifecycle, merge queue, billing and a new shell68 updateWorkspace: (actor, slug, details) =>
69 call("update_workspace", { actor, slug, ...details }),
70 listWorkspaceTokens: (slug, viewer) => call("list_workspace_tokens", { slug, viewer }),
71 createWorkspaceToken: (actor, slug, name) =>
72 call("create_workspace_token", { actor, slug, name }),
73 removeWorkspaceToken: (actor, slug, id) =>
74 call("remove_workspace_token", { actor, slug, id }),
API and MCP server, Rust identity service, registration, site redesign75 userForSession: (sessionToken) => call("user_for_session", { sessionToken }),
76 userForGitCredentials: (username, secret) =>
77 call("user_for_git_credentials", { username, secret }),
78 userForAccessToken: (token) => call("user_for_access_token", { token }),
79 userForSshKey: (fingerprint) => call("user_for_ssh_key", { fingerprint }),
80 userByUsername: (username) => call("user_by_username", { username }),
What happened across an outcome, as a feed beside its graph81 usernames: (ids) => call("usernames", { ids }),
API and MCP server, Rust identity service, registration, site redesign82 listSshKeys: (user) => call("list_ssh_keys", { user }),
83 addSshKey: (user, title, publicKey) =>
84 call("add_ssh_key", { user, title, publicKey }),
85 removeSshKey: (user, id) => call("remove_ssh_key", { user, id }),
86 listAccessTokens: (user) => call("list_access_tokens", { user }),
Account dropdown, llms.txt onboarding, hosted agent runner (not yet deployed)87 createAccessToken: (user, name, ttlSeconds) =>
88 call("create_access_token", { user, name, ttlSeconds }),
Agents as a team: lifecycle, merge queue, billing and a new shell89 createAgentToken: (onBehalfOf, scope, ttlSeconds) =>
90 call("create_agent_token", { onBehalfOf, scope, ttlSeconds }),
API and MCP server, Rust identity service, registration, site redesign91 removeAccessToken: (user, id) => call("remove_access_token", { user, id }),
92 };
93}
Rust repos service with shipping; pull requests kept in the model94
95export function reposClient(service: ServiceBinding): ReposApi {
96 const call = <T>(method: string, args: object) => rpc<T>(service, method, args);
97 return {
98 get: (path, viewer) => call("get", { path, viewer }),
99 getById: (id, viewer) => call("get_by_id", { id, viewer }),
100 list: (viewer, options = {}) => call("list", { viewer, ...options }),
101 create: (owner, input) => call("create", { owner, ...input }),
Agents as a team: lifecycle, merge queue, billing and a new shell102 update: (actor, path, changes) => call("update", { actor, path, ...changes }),
Rust repos service with shipping; pull requests kept in the model103 tree: (path, viewer, ref, treePath) =>
104 call("tree", { path, viewer, ref, treePath }),
105 blob: (path, viewer, ref, filePath) =>
106 call("blob", { path, viewer, ref, filePath }),
107 log: (path, viewer, ref, limit) => call("log", { path, viewer, ref, limit }),
Agents as a team: lifecycle, merge queue, billing and a new shell108 blame: (path, viewer, ref, filePath) => call("blame", { path, viewer, ref, filePath }),
Issues and pull requests replace intents and attempts109 forkForPull: (sourceId, pullId, actor) =>
110 call("fork_for_pull", { sourceId, pullId, actor }),
Rust repos service with shipping; pull requests kept in the model111 gitAccess: (path, viewer, service) =>
112 call("git_access", { path, viewer, service }),
Pull requests from branches113 branches: (path, viewer) => call("branches", { path, viewer }),
114 land: (sourceId, actor, branch) => call("land", { sourceId, actor, branch }),
115 compare: (repoId, viewer, base, head) => call("compare", { repoId, viewer, base, head }),
Rust repos service with shipping; pull requests kept in the model116 };
117}
Work service in Rust, with RFC 3339 timestamps118
119export function workClient(service: ServiceBinding): WorkApi {
120 const call = <T>(method: string, args: object) => rpc<T>(service, method, args);
121 return {
Issues and pull requests replace intents and attempts122 openIssue: (actor, repo, input) => call("open_issue", { actor, repo, ...input }),
123 listIssues: (repo, viewer, filter = {}) => call("list_issues", { repo, viewer, ...filter }),
124 getIssue: (repo, number, viewer) => call("get_issue", { repo, number, viewer }),
125 updateIssue: (actor, repo, number, input) =>
126 call("update_issue", { actor, repo, number, ...input }),
127 closeIssue: (actor, repo, number, reason) =>
128 call("close_issue", { actor, repo, number, reason }),
129 reopenIssue: (actor, repo, number) => call("reopen_issue", { actor, repo, number }),
130 listLabels: (repo, viewer) => call("list_labels", { repo, viewer }),
131 counts: (repo, viewer) => call("counts", { repo, viewer }),
Acceptance checks in sandboxes, line comments and review verdicts132 addComment: (actor, repo, number, comment) =>
133 call("add_comment", { actor, repo, number, ...comment }),
134 startChecks: (pullId) => call("start_checks", { pullId }),
135 reportChecks: (runId, token, report) =>
136 call("report_checks", { runId, token, ...report }),
Agents as a team: lifecycle, merge queue, billing and a new shell137 startReview: (pullId) => call("start_review", { pullId }),
138 failReview: (runId, token, error) => call("report_review", { runId, token, error }),
139 advance: (pullId) => call("advance", { pullId }),
140 stall: (pullId, reason) => call("stall", { pullId, reason }),
141 managedPulls: (repoId) => call("managed_pulls", { repoId }),
142 queue: (repo, viewer) => call("queue", { repo, viewer }),
143 queueBuild: (repoId) => call("queue_build", { repoId }),
144 failQueue: (entryId, token, error) => call("report_queue", { entryId, token, error }),
145 removeFromQueue: (actor, repo, number) => call("remove_from_queue", { actor, repo, number }),
Usage, like a hosting provider's: what agents cost, per day, task, repository and pull request146 messageAgent: (actor, repo, number, body) => call("message_agent", { actor, repo, number, body }),
Agents as a team: lifecycle, merge queue, billing and a new shell147 catchUpJob: (pullId) => call("catch_up_job", { pullId }),
Agents asked while not at work are woken to answer148 wakeForMessages: (pullId) => call("wake_for_messages", { pullId }),
Agents as a team: lifecycle, merge queue, billing and a new shell149 getSettings: (repo, viewer) => call("get_settings", { repo, viewer }),
150 updateSettings: (actor, repo, settings) =>
151 call("update_settings", { actor, repo, settings }),
Issues and pull requests replace intents and attempts152 openPull: (actor, repo, input) => call("open_pull", { actor, repo, ...input }),
153 listPulls: (repo, viewer, state) => call("list_pulls", { repo, viewer, state }),
154 getPull: (repo, number, viewer) => call("get_pull", { repo, number, viewer }),
Agents as a team: lifecycle, merge queue, billing and a new shell155 updatePull: (actor, repo, number, changes) =>
156 call("update_pull", { actor, repo, number, ...changes }),
Issues and pull requests replace intents and attempts157 readyPull: (actor, repo, number, summary) =>
158 call("ready_pull", { actor, repo, number, summary }),
159 closePull: (actor, repo, number) => call("close_pull", { actor, repo, number }),
Acceptance checks in sandboxes, line comments and review verdicts160 mergePull: (actor, repo, number, options = {}) =>
161 call("merge_pull", { actor, repo, number, ...options }),
Issues and pull requests replace intents and attempts162 listActivePulls: (viewer) => call("list_active_pulls", { viewer }),
Agents as a team: lifecycle, merge queue, billing and a new shell163 startPlan: (actor, repo, brief) => call("start_plan", { actor, repo, brief }),
164 failPlan: (planId, token, error) => call("report_plan", { planId, token, error }),
165 getPlan: (repo, viewer, id) => call("get_plan", { repo, viewer, id }),
166 listPlans: (repo, viewer) => call("list_plans", { repo, viewer }),
167 applyPlan: (actor, repo, id, options = {}) =>
168 call("apply_plan", { actor, repo, id, ...options }),
169 queueIssue: (actor, repo, number, queued) =>
170 call("queue_issue", { actor, repo, number, queued }),
171 readyIssues: (repoId) => call("ready_issues", { repoId }),
172 listAssignedIssues: (viewer) => call("list_assigned_issues", { viewer }),
Issues and pull requests replace intents and attempts173 appendSession: (actor, repo, number, entries) =>
174 call("append_session", { actor, repo, number, entries }),
175 readSession: (repo, number, viewer, afterSeq = 0) =>
176 call("read_session", { repo, number, viewer, afterSeq }),
Work service in Rust, with RFC 3339 timestamps177 };
178}
Events service in Rust, with RFC 3339 times and accurate push events179
Agents as a team: lifecycle, merge queue, billing and a new shell180export function billingClient(service: ServiceBinding): BillingApi {
181 const call = <T>(method: string, args: object) => rpc<T>(service, method, args);
182 return {
183 status: () => call("status", {}),
184 account: (workspace, viewer) => call("account", { workspace, viewer }),
185 ledger: (workspace, viewer) => call("ledger", { workspace, viewer }),
Usage, like a hosting provider's: what agents cost, per day, task, repository and pull request186 usage: (workspace, viewer, since) => call("usage", { workspace, viewer, since }),
Agents as a team: lifecycle, merge queue, billing and a new shell187 checkout: (actor, workspace, amountCents, returnUrl) =>
188 call("checkout", { actor, workspace, amountCents, returnUrl }),
189 confirm: (workspace, viewer, session) => call("confirm", { workspace, viewer, session }),
190 canStart: (workspace) => call("can_start", { workspace }),
A free allowance on g1t's models, so anyone can try its agents191 trial: (workspace, exempt) => call("trial", { workspace, exempt }),
Agents as a team: lifecycle, merge queue, billing and a new shell192 startRun: (run) => call("start_run", run),
Paid features: a workspace turns on Deployments with a monthly plan193 features: (workspace, viewer) => call("features", { workspace, viewer }),
194 subscribe: (actor, workspace, feature, returnUrl) =>
195 call("subscribe", { actor, workspace, feature, returnUrl }),
196 confirmSubscription: (workspace, viewer, session) =>
197 call("confirm_subscription", { workspace, viewer, session }),
198 cancelSubscription: (actor, workspace, feature, resume = false) =>
199 call("cancel_subscription", { actor, workspace, feature, resume }),
200 hasFeature: (workspace, feature) => call("has_feature", { workspace, feature }),
201 chargeFeature: (charge) => call("charge_feature", charge),
Every sandbox is metered by the second202 recordSandbox: (usage) => call("record_sandbox", usage),
Agents as a team: lifecycle, merge queue, billing and a new shell203 };
204}
205
Events service in Rust, with RFC 3339 times and accurate push events206export function eventsClient(service: ServiceBinding): EventsApi {
207 const call = <T>(method: string, args: object) => rpc<T>(service, method, args);
208 return {
209 publish: (events) => call("publish", { events }),
210 list: (query) => call("list", query),
211 };
212}
Integrations: your own model provider, alerts that open issues, tickets agents read213
214export function integrationsClient(service: ServiceBinding): IntegrationsApi {
215 const call = <T>(method: string, args: object) => rpc<T>(service, method, args);
216 return {
217 list: (workspace, viewer) => call("list", { workspace, viewer }),
218 connect: (actor, workspace, input) => call("connect", { actor, workspace, ...input }),
219 update: (actor, workspace, id, input) => call("update", { actor, workspace, id, ...input }),
220 disconnect: (actor, workspace, id) => call("disconnect", { actor, workspace, id }),
221 test: (actor, workspace, id) => call("test", { actor, workspace, id }),
222 deliveries: (workspace, viewer, id) => call("deliveries", { workspace, viewer, id }),
223 resolve: (workspace, viewer, reference) => call("resolve", { workspace, viewer, reference }),
224 references: (workspace, text, limit) => call("references", { workspace, text, limit }),
225 import: (actor, repo, reference, assign) => call("import", { actor, repo, reference, assign }),
226 links: (repo, number) => call("links", { repo, number }),
227 modelProvider: (workspace) => call("model_provider", { workspace }),
228 openModelSession: (run) => call("open_model_session", run),
229 modelUpstream: (token) => call("model_upstream", { token }),
Models per workspace: several providers, routed by kind of work230 routes: (workspace, viewer) => call("routes", { workspace, viewer }),
231 setRoutes: (actor, workspace, routes) => call("set_routes", { actor, workspace, routes }),
Integrations: your own model provider, alerts that open issues, tickets agents read232 };
233}
Webhooks: every event, to your own addresses, signed and retried234
235export function webhooksClient(service: ServiceBinding): WebhooksApi {
236 const call = <T>(method: string, args: object) => rpc<T>(service, method, args);
237 return {
238 list: (viewer, owner) => call("list", { viewer, ...owner }),
239 create: (actor, owner, input) => call("create", { actor, ...owner, ...input }),
240 update: (actor, owner, id, input) => call("update", { actor, ...owner, id, ...input }),
241 delete: (actor, owner, id) => call("delete", { actor, ...owner, id }),
242 ping: (actor, owner, id) => call("ping", { actor, ...owner, id }),
243 deliveries: (viewer, owner, id) => call("deliveries", { viewer, ...owner, id }),
244 redeliver: (actor, owner, deliveryId) => call("redeliver", { actor, ...owner, deliveryId }),
245 };
246}
Automations: rules in .g1t/automations that act when something happens247
GitHub Actions on g1t, part three: .g1t/workflows, the pages, the docs248export function actionsClient(service: ServiceBinding): ActionsApi {
249 const call = <T>(method: string, args: object) => rpc<T>(service, method, args);
250 return {
251 workflows: (repo, viewer) => call("workflows", { repo, viewer }),
252 runs: (repo, viewer, filter = {}) => call("runs", { repo, viewer, ...filter }),
253 run: (repo, viewer, id) => call("run", { repo, viewer, id }),
254 logs: (repo, viewer, job, after = 0) => call("logs", { repo, viewer, job, after }),
255 dispatch: (actor, repo, workflow, ref, inputs) => call("dispatch", { actor, repo, workflow, ref, inputs }),
256 cancel: (actor, repo, id) => call("cancel", { actor, repo, id }),
257 rerun: (actor, repo, id, failedOnly = false) => call("rerun", { actor, repo, id, failed_only: failedOnly }),
258 setWorkflowEnabled: (actor, repo, workflow, enabled) =>
259 call("set_workflow_enabled", { actor, repo, workflow, enabled }),
260 settings: (actor, owner, kind) => call("settings", { actor, ...owner, kind }),
Secrets and variables: one list, rows per environment, for workflows and deployments261 setSetting: (actor, owner, kind, name, value, options = {}) =>
262 call("set_setting", { actor, ...owner, kind, name, value, ...options }),
263 deleteSetting: (actor, owner, kind, name, id) => call("delete_setting", { actor, ...owner, kind, name, id }),
GitHub Actions on g1t, part three: .g1t/workflows, the pages, the docs264 };
265}
266
Deployments: a preview for every pull request, production on g1t.page267
268export function deploymentsClient(service: ServiceBinding): DeploymentsApi {
269 const call = <T>(method: string, args: object) => rpc<T>(service, method, args);
270 return {
Projects: what a workspace builds and runs, first on every page271 settings: (project, viewer) => call("settings", { project, viewer }),
272 updateSettings: (actor, project, changes) => call("update_settings", { actor, project, changes }),
273 list: (project, viewer) => call("list", { project, viewer }),
274 get: (project, id, viewer) => call("get", { project, id, viewer }),
275 redeploy: (actor, project, branch) => call("redeploy", { actor, project, branch }),
276 takeDown: (actor, project, branch) => call("take_down", { actor, project, branch }),
Project dependencies: addresses, preview stacks, Affects, and agents who know277 stack: (actor, project, branch) => call("stack", { actor, project, branch }),
Projects: what a workspace builds and runs, first on every page278 overview: (workspace, viewer) => call("overview", { workspace, viewer }),
Deployments: a preview for every pull request, production on g1t.page279 usage: (workspace, viewer) => call("usage", { workspace, viewer }),
280 };
281}
Projects: what a workspace builds and runs, first on every page282
283export function projectsClient(service: ServiceBinding): ProjectsApi {
284 const call = <T>(method: string, args: object) => rpc<T>(service, method, args);
285 return {
286 list: (workspace, viewer) => call("list", { workspace, viewer }),
287 get: (workspace, slug, viewer) => call("get", { workspace, slug, viewer }),
288 byRepo: (repoId) => call("by_repo", { repoId }),
289 create: (actor, workspace, input) => call("create", { actor, workspace, input }),
290 update: (actor, workspace, slug, changes) => call("update", { actor, workspace, slug, changes }),
Project dependencies: addresses, preview stacks, Affects, and agents who know291 dependencies: (workspace, slug, viewer) => call("dependencies", { workspace, slug, viewer }),
292 addDependency: (actor, workspace, slug, on, as) => call("add_dependency", { actor, workspace, slug, on, as }),
293 removeDependency: (actor, workspace, slug, on) => call("remove_dependency", { actor, workspace, slug, on }),
294 graph: (projectId) => call("graph", { projectId }),
Projects: what a workspace builds and runs, first on every page295 };
296}