grain.social/grain-support-agent
grain's support agent: triages mentions and reports, investigates bugs, proposes fixes
0
0
// Every setting comes from the environment. Secrets are read once here and then
// removed from process.env, so the opencode server and the tools it spawns never
// inherit them: the investigation agent reads untrusted text, and anything in
// its environment is something a prompt injection could ask it to repeat.
function optional(name: string, fallback = ""): string {
return process.env[name]?.trim() || fallback;
}
function secret(name: string): string {
const value = process.env[name]?.trim() ?? "";
delete process.env[name];
return value;
}
function int(name: string, fallback: number): number {
const raw = process.env[name];
const n = raw ? Number.parseInt(raw, 10) : NaN;
return Number.isFinite(n) ? n : fallback;
}
export interface Repo {
name: string;
url: string;
branch: string;
}
function parseRepos(spec: string): Repo[] {
return spec
.split(/\s+/)
.filter(Boolean)
.map((entry) => {
const match = entry.match(/^([\w.-]+)=([^#]+)(?:#(.+))?$/);
if (!match) throw new Error(`REPOS: cannot parse "${entry}", expected name=url#branch`);
return { name: match[1], url: match[2], branch: match[3] ?? "main" };
});
}
export const config = {
port: int("PORT", 8080),
// Caddy sends this with every request it forwards, and the dashboard refuses
// any request without it. The preview runner shares a network with this
// service, and runs code an agent wrote; this keeps it off the dashboard.
dashboardKey: secret("DASHBOARD_KEY"),
// The dashboard's public address, for screenshot links in pull requests.
publicUrl: optional("PUBLIC_URL", "https://agent.grain.social"),
// The preview runner that photographs grain with a fix applied. Empty
// turns screenshots off.
previewUrl: optional("PREVIEW_URL"),
// The support tools' MCP server, for the opencode server only.
supportMcpPort: int("SUPPORT_MCP_PORT", 4097),
stateDir: optional("STATE_DIR", "./state"),
// grain-serve, for its moderation methods (social.grain.admin.*) and its
// public reads. Pages on grain.social are linked from here too.
grainUrl: optional("GRAIN_URL", "https://grain.social").replace(/\/+$/, ""),
// The account this service moderates as, by DID, signed in to its PDS with
// an app password. grain-serve admits it as an admin when GRAIN_ADMIN_DIDS
// names it. Without both, reports are neither read nor acted on.
grainModerator: {
identifier: optional("GRAIN_MOD_IDENTIFIER"),
appPassword: secret("GRAIN_MOD_APP_PASSWORD"),
},
// grain-serve's index, opened read-only, for the investigation agent's SQL
// tool and nothing else. Empty turns the tool off.
grainDbPath: optional("GRAIN_DB_PATH"),
// The repositories the investigation agent reads, as `name=url#branch`
// separated by spaces. Each is checked out side by side in one workspace and
// refreshed before every investigation.
repos: parseRepos(
optional(
"REPOS",
[
"grain=https://github.com/grainsocial/grain.git#main",
"grain-ios=https://github.com/grainsocial/grain-ios.git#main",
"grain-android=https://tangled.org/grain.social/grain-android#main",
].join(" "),
),
),
bluesky: {
identifier: optional("BSKY_IDENTIFIER", "grain.social"),
appPassword: secret("BSKY_APP_PASSWORD"),
// Resolved from the account's DID document when unset.
pds: optional("BSKY_PDS"),
pollMs: int("BSKY_POLL_MS", 60_000),
},
reportsPollMs: int("REPORTS_POLL_MS", 60_000),
clef: {
accountId: optional("CLOUDFLARE_ACCOUNT_ID"),
apiToken: secret("CLOUDFLARE_AI_TOKEN"),
model: optional("CLEF_MODEL", "clef"),
},
// The grain-support-agent GitHub App, for pushing fix branches and opening
// draft pull requests. The key is the app's PEM private key, base64-encoded.
github: {
appId: optional("GITHUB_APP_ID"),
appKey: Buffer.from(secret("GITHUB_APP_KEY"), "base64").toString("utf8"),
},
investigation: {
// OpenRouter reads OPENROUTER_API_KEY itself, so that one key stays in the
// environment the opencode server inherits. Everything else does not.
provider: optional("INVESTIGATION_PROVIDER", "openrouter"),
model: optional("INVESTIGATION_MODEL", "z-ai/glm-5.3"),
timeoutMs: int("INVESTIGATION_TIMEOUT_MS", 10 * 60_000),
// A hard ceiling on spend: investigations started per UTC day.
maxPerDay: int("INVESTIGATIONS_PER_DAY", 20),
},
};
export const hasOpenRouter = Boolean(process.env.OPENROUTER_API_KEY);