// Gas City hooks for OpenCode. // Installed by gc into {workDir}/.opencode/plugins/gascity.js // // OpenCode's plugin API is ESM and hook-oriented: // - event() is side-effect-only (no prompt injection) // - experimental.chat.system.transform mutates output.system // // Gas City uses: // - session.created / session.compacted → gc prime --hook (side effects such // as session-id persistence and poller bootstrap) // - experimental.chat.system.transform → inject gc prime --hook, queued // nudges, and unread mail into the system prompt for each turn import { execFile } from "node:child_process"; import fs from "node:fs/promises"; import path from "node:path"; import { promisify } from "node:util"; const execFileAsync = promisify(execFile); const PATH_PREFIX = `${process.env.HOME}/go/bin:${process.env.HOME}/.local/bin:`; async function run(directory, ...args) { try { const { stdout } = await execFileAsync("gc", args, { cwd: directory, encoding: "utf-8", timeout: 30000, env: { ...process.env, PATH: PATH_PREFIX + (process.env.PATH || "") }, }); return stdout.trim(); } catch { return ""; } } function unwrapData(result) { if (result && typeof result === "object" && "data" in result) { return result.data; } return result; } function safeSessionID(sessionID) { return String(sessionID || "").replace(/[^A-Za-z0-9_.-]/g, "_"); } function sessionIDFromEvent(event) { return ( event?.properties?.sessionID || event?.properties?.info?.sessionID || event?.properties?.message?.info?.sessionID || "" ); } async function mirrorTranscript(directory, client, sessionID) { const exportDir = process.env.GC_OPENCODE_TRANSCRIPT_DIR || ""; const safeID = safeSessionID(sessionID); if (!exportDir || !safeID || !client?.session) { return; } try { const [infoResult, messagesResult] = await Promise.all([ client.session.get({ path: { id: sessionID } }), client.session.messages({ path: { id: sessionID } }), ]); const info = unwrapData(infoResult) || {}; const messages = unwrapData(messagesResult) || []; if (!info.directory) { info.directory = directory; } await fs.mkdir(exportDir, { recursive: true }); const dst = path.join(exportDir, `${safeID}.json`); const tmp = `${dst}.tmp`; await fs.writeFile(tmp, JSON.stringify({ info, messages }, null, 2)); await fs.rename(tmp, dst); } catch { return; } } export default async function gascityPlugin({ directory, client }) { let cachedPrime = null; async function readPrime(force = false) { if (force || cachedPrime === null) { cachedPrime = await run(directory, "prime", "--hook"); } return cachedPrime; } function prependText(existing, prefix) { return existing ? prefix + "\n\n" + existing : prefix; } async function buildPrefix() { const prime = await readPrime(); const nudges = await run(directory, "nudge", "drain", "--inject"); const mail = await run(directory, "mail", "check", "--inject"); return [prime, nudges, mail].filter(Boolean).join("\n\n"); } return { event: async ({ event }) => { switch (event.type) { case "session.created": case "session.compacted": await readPrime(true); await mirrorTranscript(directory, client, sessionIDFromEvent(event)); return; case "session.idle": case "message.updated": await mirrorTranscript(directory, client, sessionIDFromEvent(event)); return; default: return; } }, "chat.message": async (_input, output) => { const prefix = await buildPrefix(); if (prefix) { output.message.system = prependText(output.message.system, prefix); } }, "experimental.chat.system.transform": async (_input, output) => { const prefix = await buildPrefix(); if (prefix) { if (output.system[0]) { output.system[0] = prependText(output.system[0], prefix); } else { output.system.unshift(prefix); } } }, }; }