mika-agent-assist/supabase/functions/_shared/railway.ts
gpt-engineer-app[bot] db38398c21 Changes
Co-authored-by: domfelipe <53182096+domfelipe@users.noreply.github.com>
2026-04-23 20:57:43 +00:00

274 lines
8.7 KiB
TypeScript

// Helper para chamar a Railway GraphQL API (Public API).
// Docs: https://docs.railway.com/reference/public-api
const RAILWAY_GRAPHQL = "https://backboard.railway.app/graphql/v2";
/**
* Start command padrão dos containers Hermes.
* - Verifica HERMES_SUSPENDED no início: se true, dorme infinitamente (agente "pausado")
* - Aplica HERMES_SOUL_OVERRIDE em /opt/data/SOUL.md se presente
* - Inicia o gateway Hermes
*
* IMPORTANTE: este comando deve ser idêntico ao configurado nos serviços Railway
* existentes. Para serviços antigos, atualize manualmente via UI/Agent do Railway.
*/
export const HERMES_START_COMMAND =
`/bin/bash -c 'if [ "$HERMES_SUSPENDED" = "true" ]; then echo "Agent suspended" && sleep infinity; fi && if [ -n "$HERMES_SOUL_OVERRIDE" ]; then echo "$HERMES_SOUL_OVERRIDE" > /opt/data/SOUL.md; fi && /opt/hermes/docker/entrypoint.sh gateway run'`;
export interface RailwayError {
message: string;
path?: string[];
extensions?: Record<string, unknown>;
}
export async function railwayQuery<T>(
query: string,
variables: Record<string, unknown>,
token: string,
): Promise<{ data?: T; errors?: RailwayError[] }> {
const res = await fetch(RAILWAY_GRAPHQL, {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: `Bearer ${token}`,
},
body: JSON.stringify({ query, variables }),
});
if (!res.ok) {
const text = await res.text();
console.error(`Railway HTTP ${res.status} for query:`, query.trim().split("\n")[1]?.trim(), "vars:", JSON.stringify(variables), "body:", text);
throw new Error(`Railway HTTP ${res.status}: ${text}`);
}
const json = await res.json();
if (json.errors?.length) {
console.error("Railway GraphQL errors:", JSON.stringify(json.errors), "for vars:", JSON.stringify(variables));
}
return json;
}
export async function createRailwayService(opts: {
token: string;
projectId: string;
name: string;
}): Promise<string> {
const mutation = `
mutation ServiceCreate($input: ServiceCreateInput!) {
serviceCreate(input: $input) { id name }
}
`;
const res = await railwayQuery<{ serviceCreate: { id: string; name: string } }>(
mutation,
{ input: { projectId: opts.projectId, name: opts.name } },
opts.token,
);
if (res.errors?.length) {
throw new Error(`serviceCreate failed: ${JSON.stringify(res.errors)}`);
}
if (!res.data?.serviceCreate?.id) {
throw new Error("serviceCreate returned no id");
}
return res.data.serviceCreate.id;
}
export async function configureRailwayService(opts: {
token: string;
serviceId: string;
environmentId: string;
image: string;
variables: Record<string, string>;
startCommand?: string;
}): Promise<void> {
// O Railway expõe variáveis via variableUpsert (uma por vez) e fonte/imagem via serviceInstanceUpdate.
// Setamos a imagem (e startCommand opcional) primeiro.
const updateSource = `
mutation ServiceInstanceUpdate($serviceId: String!, $environmentId: String!, $input: ServiceInstanceUpdateInput!) {
serviceInstanceUpdate(serviceId: $serviceId, environmentId: $environmentId, input: $input)
}
`;
const sourceInput: Record<string, unknown> = { source: { image: opts.image } };
if (opts.startCommand) {
sourceInput.startCommand = opts.startCommand;
}
const sourceRes = await railwayQuery(
updateSource,
{
serviceId: opts.serviceId,
environmentId: opts.environmentId,
input: sourceInput,
},
opts.token,
);
if (sourceRes.errors?.length) {
throw new Error(`serviceInstanceUpdate (source) failed: ${JSON.stringify(sourceRes.errors)}`);
}
// Agora as variáveis. Railway recomenda variableUpsert por chave.
for (const [name, value] of Object.entries(opts.variables)) {
await upsertRailwayVariable({
token: opts.token,
serviceId: opts.serviceId,
environmentId: opts.environmentId,
name,
value,
});
}
}
export async function deployRailwayService(opts: {
token: string;
serviceId: string;
environmentId: string;
}): Promise<void> {
const mutation = `
mutation ServiceInstanceRedeploy($serviceId: String!, $environmentId: String!) {
serviceInstanceRedeploy(serviceId: $serviceId, environmentId: $environmentId)
}
`;
const res = await railwayQuery(
mutation,
{ serviceId: opts.serviceId, environmentId: opts.environmentId },
opts.token,
);
if (res.errors?.length) {
throw new Error(`serviceInstanceRedeploy failed: ${JSON.stringify(res.errors)}`);
}
}
/**
* Upsert de várias variáveis de uma vez no serviço Railway.
* Mais eficiente que múltiplos variableUpsert sequenciais.
*/
export async function upsertRailwayVariableCollection(opts: {
token: string;
serviceId: string;
environmentId: string;
projectId: string;
variables: Record<string, string>;
replace?: boolean;
}): Promise<void> {
const mutation = `
mutation VariableCollectionUpsert($input: VariableCollectionUpsertInput!) {
variableCollectionUpsert(input: $input)
}
`;
const input = {
projectId: opts.projectId,
environmentId: opts.environmentId,
serviceId: opts.serviceId,
variables: opts.variables,
replace: opts.replace ?? false,
};
const res = await railwayQuery(mutation, { input }, opts.token);
if (res.errors?.length) {
throw new Error(`variableCollectionUpsert failed: ${JSON.stringify(res.errors)}`);
}
}
/**
* Upsert de uma única variável de ambiente no serviço Railway.
* Para "remover" o efeito de uma variável boolean, passe value="" (string vazia).
*/
export async function upsertRailwayVariable(opts: {
token: string;
serviceId: string;
environmentId: string;
projectId?: string;
name: string;
value: string;
}): Promise<void> {
const mutation = `
mutation VariableUpsert($input: VariableUpsertInput!) {
variableUpsert(input: $input)
}
`;
const input: Record<string, unknown> = {
environmentId: opts.environmentId,
serviceId: opts.serviceId,
name: opts.name,
value: opts.value,
};
if (opts.projectId) input.projectId = opts.projectId;
const res = await railwayQuery(mutation, { input }, opts.token);
if (res.errors?.length) {
throw new Error(`variableUpsert(${opts.name}) failed: ${JSON.stringify(res.errors)}`);
}
}
/**
* Suspende ou retoma um serviço Hermes via flag HERMES_SUSPENDED + redeploy.
* Railway não suporta stop sem redeploy — a abordagem oficial é controlar
* via env var consumida pelo start command (ver HERMES_START_COMMAND).
*
* suspend=true → seta HERMES_SUSPENDED=true e redeploy (container fica em sleep infinity)
* suspend=false → seta HERMES_SUSPENDED="" e redeploy (container sobe normalmente)
*/
export async function setHermesSuspended(opts: {
token: string;
serviceId: string;
environmentId: string;
projectId?: string;
suspend: boolean;
}): Promise<void> {
await upsertRailwayVariable({
token: opts.token,
serviceId: opts.serviceId,
environmentId: opts.environmentId,
projectId: opts.projectId,
name: "HERMES_SUSPENDED",
value: opts.suspend ? "true" : "",
});
await deployRailwayService({
token: opts.token,
serviceId: opts.serviceId,
environmentId: opts.environmentId,
});
}
/** Busca env+project IDs do primeiro deployment de um serviço. Útil quando vps_pool_id está null. */
export async function getServiceContext(opts: {
token: string;
serviceId: string;
}): Promise<{ environmentId: string | null; projectId: string | null }> {
const query = `
query Service($id: String!) {
service(id: $id) {
projectId
deployments(first: 1) {
edges { node { environmentId } }
}
}
}
`;
const res = await railwayQuery<{
service: { projectId: string; deployments: { edges: { node: { environmentId: string } }[] } };
}>(query, { id: opts.serviceId }, opts.token);
if (res.errors?.length) {
console.error("getServiceContext errors:", JSON.stringify(res.errors));
return { environmentId: null, projectId: null };
}
return {
environmentId: res.data?.service?.deployments?.edges?.[0]?.node?.environmentId ?? null,
projectId: res.data?.service?.projectId ?? null,
};
}
/** @deprecated use getServiceContext */
export async function getServiceEnvironmentId(opts: {
token: string;
serviceId: string;
}): Promise<string | null> {
return (await getServiceContext(opts)).environmentId;
}
/** Apaga o webhook do Telegram para que o Hermes assuma via polling. */
export async function deleteTelegramWebhook(botToken: string): Promise<void> {
const url = `https://api.telegram.org/bot${botToken}/deleteWebhook?drop_pending_updates=false`;
const res = await fetch(url, { method: "POST" });
if (!res.ok) {
const text = await res.text();
throw new Error(`deleteWebhook failed: ${res.status} ${text}`);
}
}