{agent.name}

\n {agent.email ?? \"-\"}\n

\n \n {meta.emoji} {meta.label.toUpperCase()}\n \n

\n {agent.status === \"active\"\n ? <>Last action {timeAgo(agent.last_action_utc)}.\n : agent.status === \"out_of_office\"\n ? <>Marked out of office. Last action {timeAgo(agent.last_action_utc)}.\n : agent.minutes_idle === null\n ? \"No activity found — treating as offline.\"\n : `No action in ${agent.minutes_idle} min (threshold 10 min).`}\n

\n Idle {agent.minutes_idle === null ? \"—\" : `${agent.minutes_idle} min`}\n {\" · \"}\n Source: {agent.source === \"audit\" ? \"audit log\" : agent.source === \"ticket\" ? \"last ticket\" : \"none\"}\n

\n \n );\n}\n\nexport function renderDashboard(report: any): string {\n if (!report.ok) {\n return \"\" +\n \"

Gorgias Agent Monitor

\" +\n `

${report.error}

${report.help ?? \"\"}

`;\n }\n\n const s = report.summary;\n const counts: Record = {\n active: s.active, offline: s.offline, out_of_office: s.out_of_office,\n };\n\n const body = renderToString(\n \n \n \n \n Gorgias Agent Monitor\n \n \n \n \n \n

Gorgias Agent Monitor

\n ✅ {counts.active} active\n 🌴 {counts.out_of_office} OOO\n 🔴 {counts.offline} offline\n

\n Threshold: no action in {report.idle_threshold_minutes}+ min = offline ·{\" \"}\n generated {timeAgo(report.generated_at_utc)} (auto-refreshes) ·{\" \"}\n view source · JSON API\n

\n {report.agents.map((a) => )}\n

\n \n ,\n );\n\n return \"\" + body;\n}\n",[137],"34f317d1-1b97-488c-bf9e-42e7a8521eee","README.md","fd9c39f6-a8c6-11f1-afef-1607ee4eb77e",14,["D",1788571177314],"# Gorgias Agent Monitor\n\nLive dashboard that flags any Gorgias agent who is **offline** or **out of office** — using Gorgias's own audit trail. An agent is considered **Active** only if they've performed an action in Gorgias within the last **10 minutes**.\n\n## Statuses\n\n| Status | Meaning |\n| --- | --- |\n| ✅ **Active** | Has taken an action in Gorgias within the last 10 minutes. |\n| 🔴 **Offline** | No action in 10+ minutes (their browser may be closed or they're idle). |\n| 🌴 **Out of Office** | Agent has explicitly marked availability/OOO (or is in the OOO override list). |\n\nActivity is read from the Gorgias **audit log** (`GET /api/events`), which records who did what and when. Agents with no attributable event fall back to their most recently updated assigned ticket.\n\n## Live URLs\n\n- Dashboard: [Try the app](url:main.ts)\n- JSON API: [url:main.ts/api](url:main.ts/api)\n- Plain-text: [url:main.ts/api?format=human](url:main.ts/api?format=human)\n\n## Setup\n\nThe dashboard needs two environment variables:\n\n1. `GORGIAS_DOMAIN` — your Gorgias subdomain (the part before `.gorgias.com`).\n2. `GORGIAS_API_KEY` — an API key created in Gorgias: **Settings → Account → REST API** (copy the \"Password (API key)\").\n\nOptional:\n\n- `OUT_OF_OFFICE_AGENTS` — comma-separated agent emails to force into **Out of Office** status (handy when Gorgias's availability flag isn't exposed via API).\n\nThe dashboard auto-refreshes every 30 seconds.\n\n## Output\n\n- **HTML dashboard** (`/`) — card per agent, color-coded, with last-action time and idle minutes.\n- **JSON** (`/api`) — machine-readable report for embedding in Slack bots, PagerDuty, or cron checks.\n\n```json\n{\n \"summary\": { \"total\": 5, \"active\": 3, \"out_of_office\": 1, \"offline\": 1 },\n \"agents\": [ { \"name\": \"...\", \"status\": \"offline\", \"minutes_idle\": 14 } ]\n}\n```\n## Slack alerts\n\nAn interval job (`slack_alert.ts`) runs every 15 minutes and posts to a Slack channel whenever a monitored agent is **offline/idle >10 min** or **out of office**. To avoid spam, it only posts when an agent's status *changes*, and sends a \"back online\" note on recovery.\n\n**Setup (one-time):**\n\n1. **Create your Slack channel** if you haven't (e.g. `#agent-monitoring`).\n2. Create a Slack **Incoming Webhook** pointed at that channel:\n - Go to → **Create New App → From Scratch** → pick your workspace.\n - **Incoming Webhooks** → toggle **On** → **Add New Webhook to Workspace** → select your channel.\n - Copy the webhook URL.\n\n3. Add these env vars to the val:\n\n- 👉 Add SLACK_WEBHOOK_URL here: https://www.val.town/x/koalaSleep/gorgias-agent-monitor/environment-variables?key=SLACK_WEBHOOK_URL\n- 👉 Add ALERT_AGENTS here: https://www.val.town/x/koalaSleep/gorgias-agent-monitor/environment-variables?key=ALERT_AGENTS\n\n`ALERT_AGENTS` is **optional** — a comma-separated list of agent emails **or** names to monitor (e.g. `ada@koala.com, sam`). Leave it empty to alert on *all* agents.\n",[145],"713e4d14-9c17-4959-ad02-15870f700bf5","lib","b8f263ab-dd2e-4511-a3d4-fed02a6d5cf4",2,["D",1788570769513],"directory",[152],"pulls","branches","forks","envVars",{"_165":131,"_167":42},"connections",{"_165":42,"_166":42},"count","unfilledCount","emptyCount",{"_18":151,"_20":152,"_114":153,"_116":-5,"_117":68,"_118":154,"_119":38,"_22":196,"_65":42,"_122":156,"_124":-5,"_126":26,"_127":-5,"_175":197,"_85":198},{"_18":187,"_20":188,"_114":189,"_116":153,"_117":68,"_118":190,"_119":38,"_22":191,"_65":192,"_122":141,"_124":193,"_126":26,"_127":-5,"_175":194,"_85":195},{"_18":144,"_20":145,"_114":146,"_116":-5,"_117":68,"_118":147,"_119":38,"_22":184,"_65":121,"_122":96,"_124":149,"_126":26,"_127":-5,"_175":185,"_85":186},{"_18":136,"_20":137,"_114":138,"_116":-5,"_117":68,"_118":139,"_119":38,"_22":181,"_65":42,"_122":141,"_124":142,"_126":26,"_127":-5,"_175":182,"_85":183},{"_18":129,"_20":130,"_114":36,"_116":-5,"_117":68,"_118":131,"_119":38,"_22":178,"_65":121,"_122":133,"_124":134,"_126":26,"_127":21,"_175":179,"_85":180},{"_18":112,"_20":113,"_114":115,"_116":-5,"_117":68,"_118":66,"_119":38,"_22":174,"_65":121,"_122":123,"_124":125,"_126":26,"_127":-5,"_175":176,"_85":177},["D",1788571310115],"children",[],[113],["D",1788570787782],[],[130],["D",1788570781562],[],[137],["D",1788571177314],[],[145],"5183103e-6460-4514-a5fc-9fa59ee8a358","gorgias.ts","e93d39ce-a8c6-11f1-afef-1607ee4eb77e",15,["D",1788571305232],8,"/**\n * Gorgias data layer.\n *\n * Uses two signals to classify each agent:\n * - ACTIVITY (online/offline): Gorgias's own definition of online is having\n * performed an action in Gorgias within the last 10 minutes. We read that\n * from the audit trail (`GET /api/events`), falling back to the agent's\n * most-recently-updated assigned ticket when an event can't be attributed.\n * - AVAILABILITY (out of office): Gorgias agents set an availability status.\n * We honor an explicit out-of-office flag on the agent record and an\n * OUT_OF_OFFICE_AGENTS env var override (comma-separated emails).\n *\n * Requires env vars:\n * GORGIAS_DOMAIN your Gorgias subdomain, e.g. \"mybrand\"\n * GORGIAS_API_KEY API key created by an admin (Settings -> REST API)\n */\n\nlet DOMAIN = Deno.env.get(\"GORGIAS_DOMAIN\")?.trim() ?? \"\";\nconst EMAIL = Deno.env.get(\"GORGIAS_EMAIL\")?.trim() ?? \"\";\nconst API_KEY = Deno.env.get(\"GORGIAS_API_KEY\")?.trim() ?? \"\";\n\n// Accept either \"koala\" or \"koala.gorgias.com\" or a full https URL.\nif (DOMAIN) {\n const m = DOMAIN.match(/https?:\\/\\/([\\w-]+)\\.gorgias\\.com/);\n if (m) {\n DOMAIN = m[1];\n } else {\n DOMAIN = DOMAIN.replace(/\\.gorgias\\.com$/, \"\").replace(/^https?:\\/\\/|\\/$/g, \"\");\n }\n}\nconst OUT_OF_OFFICE = new Set(\n (Deno.env.get(\"OUT_OF_OFFICE_AGENTS\") ?? \"\")\n .split(\",\").map((s) => s.trim().toLowerCase()).filter(Boolean),\n);\n\nexport const IDLE_THRESHOLD_MINUTES = 10;\nconst BASE = DOMAIN ? `https://${DOMAIN}.gorgias.com/api` : \"\";\n\nfunction authHeaders(): Record {\n // Gorgias REST API uses HTTP Basic auth: username = account email, password = API key.\n if (EMAIL && API_KEY) {\n const basic = btoa(`${EMAIL}:${API_KEY}`);\n return { Authorization: `Basic ${basic}` };\n }\n // Fallback: some accounts accept the API key via X-Auth-Key.\n if (API_KEY) return { \"X-Auth-Key\": API_KEY };\n return {};\n}\n\nasync function gorgias(path: string, extra?: RequestInit): Promise {\n const res = await fetch(`${BASE}${path}`, {\n ...extra,\n headers: { ...authHeaders(), ...(extra?.headers ?? {}) },\n });\n if (!res.ok) {\n throw new Error(`Gorgias ${res.status} on ${path}: ${await res.text()}`);\n }\n return res.json();\n}\n\n// Gorgias exposes people under /users (agents, managers, admins).\nasync function listAgents(): Promise {\n const users: any[] = [];\n let cursor: string | null = null;\n do {\n const page = await gorgias(`/users?cursor=${cursor ?? \"\"}&limit=100`);\n users.push(...(page?.data ?? []));\n cursor = page?.meta?.next_cursor ?? null;\n } while (cursor);\n\n // Keep only support-facing people: agents and managers, and drop disabled accounts.\n return users.filter((u) => {\n if (u.role === \"admin\" || u.role === \"shared\") return false;\n if (u.role === \"agent\" || u.role === \"manager\") return true;\n return u.enabled !== false; // fallback: keep users unless disabled\n });\n}\n\n// Newest audit events give the \"who did something when\" trail.\nasync function recentEvents(limit = 200): Promise {\n const page = await gorgias(`/events?limit=${limit}`);\n return page?.data ?? [];\n}\n\n// Pull the actor (user id) out of an event, tolerating the different shapes\n// different event types use.\nfunction eventActorId(e: any): number | null | undefined {\n const candidates = [\n e?.actor?.id, e?.actor, e?.user?.id, e?.user, e?.agent?.id,\n e?.assigned_user_id, e?.assignee_user_id, e?.admin_user_id,\n e?.created_by?.id, e?.created_by, e?.author?.id, e?.actor_id,\n e?.user_id, e?.agent_id, e?.user_account_id,\n ];\n for (const c of candidates) {\n if (typeof c === \"number\") return c;\n if (c && typeof c.id === \"number\") return c.id;\n }\n return undefined;\n}\n\nasync function lastTicketActionMs(agentId: number): Promise {\n try {\n const res = await gorgias(\n `/tickets?limit=1&assignee_user_id=${agentId}&order_by=-updated_datetime`,\n );\n const t = res?.data?.[0]?.updated_datetime;\n return t ? new Date(t).getTime() : null;\n } catch {\n return null;\n }\n}\n\nexport async function buildReport(now = new Date()) {\n if (!DOMAIN || !EMAIL || !API_KEY) {\n return {\n ok: false,\n error: \"Missing GORGIAS_DOMAIN, GORGIAS_EMAIL, or GORGIAS_API_KEY environment variable.\",\n help:\n `Set GORGIAS_DOMAIN to your subdomain (e.g. koala), GORGIAS_EMAIL to your Gorgias account email, and GORGIAS_API_KEY to your REST API key.\\n` +\n `👉 Add GORGIAS_DOMAIN here: https://www.val.town/x/koalaSleep/gorgias-agent-monitor/environment-variables?key=GORGIAS_DOMAIN\\n` +\n `👉 Add GORGIAS_EMAIL here: https://www.val.town/x/koalaSleep/gorgias-agent-monitor/environment-variables?key=GORGIAS_EMAIL\\n` +\n `👉 Add GORGIAS_API_KEY here: https://www.val.town/x/koalaSleep/gorgias-agent-monitor/environment-variables?key=GORGIAS_API_KEY`,\n };\n }\n\n const nowMs = now.getTime();\n const thresholdMs = IDLE_THRESHOLD_MINUTES * 60_000;\n\n const [agents, events] = await Promise.all([\n listAgents(),\n recentEvents().catch(() => []), // audit trail needs OAuth; fall back to tickets\n ]);\n\n const byId = new Map();\n const byEmail = new Map();\n for (const a of agents) {\n if (typeof a.id === \"number\") byId.set(a.id, a);\n if (a.email) byEmail.set((a.email as string).toLowerCase(), a);\n }\n\n // Build an activity map from the audit trail.\n const lastEventMs = new Map();\n for (const e of events) {\n const id = eventActorId(e);\n const t = e?.created_datetime ? new Date(e.created_datetime).getTime() : NaN;\n if (typeof id === \"number\" && byId.has(id) && Number.isFinite(t)) {\n const prev = lastEventMs.get(id) ?? 0;\n if (t > prev) lastEventMs.set(id, t);\n }\n }\n\n const rows = await Promise.all(\n agents.map(async (agent) => {\n const email = (agent.email ?? \"\").toLowerCase();\n let lastActionMs = lastEventMs.get(agent.id) ?? null;\n let source: \"audit\" | \"ticket\" | \"none\" = \"audit\";\n\n if (lastActionMs === null) {\n lastActionMs = await lastTicketActionMs(agent.id);\n if (lastActionMs !== null) source = \"ticket\";\n else source = \"none\";\n }\n\n const minutesIdle = lastActionMs !== null\n ? Math.max(0, Math.floor((nowMs - lastActionMs) / 60_000))\n : null;\n const online = lastActionMs !== null &&\n (nowMs - lastActionMs) <= thresholdMs;\n\n const availability = agent.available === undefined\n ? null\n : agent.available ? \"available\" : \"unavailable\";\n const oooExplicit = agent.out_of_office === true ||\n [\"out-of-office\", \"out_of_office\", \"ooo\", \"unavailable\"]\n .includes(String(agent.availability ?? \"\").toLowerCase()) ||\n OUT_OF_OFFICE.has(email);\n\n let status: \"active\" | \"offline\" | \"out_of_office\";\n if (oooExplicit) status = \"out_of_office\";\n else if (online) status = \"active\";\n else status = \"offline\";\n\n const teamNames = (agent.teams ?? [])\n .map((t) => (t && (t.name ?? t.id)) as string).filter(Boolean);\n\n return {\n id: agent.id,\n name: agent.name ?? agent.full_name ?? `Agent ${agent.id}`,\n email: agent.email ?? null,\n role: agent.role ?? null,\n active: agent.enabled ?? null,\n teams: teamNames,\n availability,\n status,\n online,\n source,\n last_action_utc: lastActionMs ? new Date(lastActionMs).toISOString() : null,\n minutes_idle: minutesIdle,\n };\n }),\n );\n\n const flagged = rows.filter((r) => r.status !== \"active\");\n\n return {\n ok: true,\n generated_at_utc: now.toISOString(),\n idle_threshold_minutes: IDLE_THRESHOLD_MINUTES,\n summary: {\n total: rows.length,\n active: rows.filter((r) => r.status === \"active\").length,\n out_of_office: rows.filter((r) => r.status === \"out_of_office\").length,\n offline: rows.filter((r) => r.status === \"offline\").length,\n },\n flagged,\n agents: rows,\n };\n}\n",[],[152,188],["D",1788570769513],[169],[152],["D",1788570602124],{"_16":17,"_83":-5},{"_16":17,"_77":78,"_79":-5,"_33":-5,"_80":81,"_82":26},{"_65":66,"_20":67,"_18":68,"_69":19,"_70":-5,"_71":-5,"_72":-5,"_73":-5,"_74":-5,"_75":21,"_76":17},"ctx",{"_58":-5,"_104":236,"_237":238,"_239":240,"_241":26,"_242":26,"_243":26,"_244":38,"_245":-5,"_246":-7,"_247":-7,"_248":42,"_249":26,"_250":26,"_251":-5,"_252":26,"_253":26,"_254":26,"_255":-5},"ENV",{"_207":208,"_209":210,"_211":67,"_212":213,"_214":215,"_216":217,"_218":219,"_220":221,"_222":223,"_224":225,"_226":227,"_228":229,"_230":231,"_232":233,"_234":235},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","fdb67791413f4386b4dbf18f354029a617f6160f","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Search