mirror of
https://github.com/anthropics/claude-plugins-official.git
synced 2026-04-18 22:12:39 +00:00
Compare commits
1 Commits
tobin/mcp-
...
add-licens
| Author | SHA1 | Date | |
|---|---|---|---|
|
b3930433ec |
@@ -7,16 +7,6 @@
|
||||
"email": "support@anthropic.com"
|
||||
},
|
||||
"plugins": [
|
||||
{
|
||||
"name": "adlc",
|
||||
"description": "Agentforce Agent Development Life Cycle — author, discover, scaffold, deploy, test, and optimize .agent files",
|
||||
"category": "development",
|
||||
"source": {
|
||||
"source": "url",
|
||||
"url": "https://github.com/SalesforceAIResearch/agentforce-adlc.git"
|
||||
},
|
||||
"homepage": "https://github.com/SalesforceAIResearch/agentforce-adlc"
|
||||
},
|
||||
{
|
||||
"name": "adspirer-ads-agent",
|
||||
"description": "Cross-platform ad management for Google Ads, Meta Ads, TikTok Ads, and LinkedIn Ads. 91 tools for keyword research, campaign creation, performance analysis, and budget optimization.",
|
||||
@@ -83,17 +73,6 @@
|
||||
},
|
||||
"homepage": "https://github.com/awslabs/agent-plugins"
|
||||
},
|
||||
{
|
||||
"name": "amplitude",
|
||||
"source": {
|
||||
"source": "url",
|
||||
"url": "https://github.com/amplitude/mcp-marketplace.git",
|
||||
"sha": "be54ccb66b10593721dd3a31e47b2db20ea02d2f"
|
||||
},
|
||||
"description": "Use Amplitude as an expert analyst — instrument Amplitude, discover product opportunities, analyze charts, create dashboards, manage experiments, and understand users and accounts.",
|
||||
"category": "monitoring",
|
||||
"homepage": "https://github.com/amplitude/mcp-marketplace"
|
||||
},
|
||||
{
|
||||
"name": "asana",
|
||||
"description": "Asana project management integration. Create and manage tasks, search projects, update assignments, track progress, and integrate your development workflow with Asana's work management platform.",
|
||||
@@ -168,39 +147,6 @@
|
||||
},
|
||||
"homepage": "https://github.com/awslabs/agent-plugins"
|
||||
},
|
||||
{
|
||||
"name": "azure-cosmos-db-assistant",
|
||||
"source": {
|
||||
"source": "url",
|
||||
"url": "https://github.com/AzureCosmosDB/cosmosdb-claude-code-plugin.git",
|
||||
"sha": "56e6da0cae93cdee8bcfa5e624ecdd9a0a483181"
|
||||
},
|
||||
"description": "Expert assistant for Azure Cosmos DB — data modeling, query optimization, performance tuning, and best practices.",
|
||||
"category": "database",
|
||||
"homepage": "https://github.com/AzureCosmosDB/cosmosdb-claude-code-plugin"
|
||||
},
|
||||
{
|
||||
"name": "base44",
|
||||
"description": "Build and deploy Base44 full-stack apps with CLI project management and JavaScript/TypeScript SDK development skills",
|
||||
"category": "development",
|
||||
"source": {
|
||||
"source": "url",
|
||||
"url": "https://github.com/base44/skills.git",
|
||||
"sha": "c7039b37eca0e2916a565a7395040c00055bcf8b"
|
||||
},
|
||||
"homepage": "https://docs.base44.com"
|
||||
},
|
||||
{
|
||||
"name": "box",
|
||||
"description": "Work with your Box content directly from Claude Code — search files, organize folders, collaborate with your team, and use Box AI to answer questions, summarize documents, and extract data without leaving your workflow.",
|
||||
"category": "productivity",
|
||||
"source": {
|
||||
"source": "url",
|
||||
"url": "https://github.com/box/box-for-ai.git",
|
||||
"sha": "6f4ec3549f3e869b115628403555b1c9220b2b34"
|
||||
},
|
||||
"homepage": "https://github.com/box/box-for-ai"
|
||||
},
|
||||
{
|
||||
"name": "brightdata-plugin",
|
||||
"description": "Web scraping, Google search, structured data extraction, and MCP server integration powered by Bright Data. Includes 7 skills: scrape any webpage as markdown (with bot detection/CAPTCHA bypass), search Google with structured JSON results, extract data from 40+ websites (Amazon, LinkedIn, Instagram, TikTok, YouTube, and more), orchestrate Bright Data's 60+ MCP tools, built-in best practices for Web Unlocker, SERP API, Web Scraper API, and Browser API, Python SDK best practices for the brightda...",
|
||||
@@ -211,17 +157,6 @@
|
||||
},
|
||||
"homepage": "https://docs.brightdata.com"
|
||||
},
|
||||
{
|
||||
"name": "cds-mcp",
|
||||
"description": "AI-assisted development of SAP Cloud Application Programming Model (CAP) projects. Search CDS models and CAP documentation.",
|
||||
"category": "development",
|
||||
"source": {
|
||||
"source": "url",
|
||||
"url": "https://github.com/cap-js/mcp-server.git",
|
||||
"sha": "4d59d7070a52761a9b8028cbe710c8d7477cbc92"
|
||||
},
|
||||
"homepage": "https://cap.cloud.sap/"
|
||||
},
|
||||
{
|
||||
"name": "chrome-devtools-mcp",
|
||||
"description": "Control and inspect a live Chrome browser from your coding agent. Record performance traces, analyze network requests, check console messages with source-mapped stack traces, and automate browser actions with Puppeteer.",
|
||||
@@ -296,17 +231,6 @@
|
||||
"category": "productivity",
|
||||
"homepage": "https://github.com/anthropics/claude-plugins-official/tree/main/plugins/claude-md-management"
|
||||
},
|
||||
{
|
||||
"name": "cloudflare",
|
||||
"source": {
|
||||
"source": "url",
|
||||
"url": "https://github.com/cloudflare/skills.git",
|
||||
"sha": "5ec03da67e230df52b698255c8e5979dc9b124b6"
|
||||
},
|
||||
"description": "Skills for the Cloudflare developer platform: Workers, Durable Objects, Agents SDK, MCP servers, Wrangler CLI, and web performance.",
|
||||
"category": "deployment",
|
||||
"homepage": "https://github.com/cloudflare/skills"
|
||||
},
|
||||
{
|
||||
"name": "cloudinary",
|
||||
"description": "Use Cloudinary directly in Claude. Manage assets, apply transformations, optimize media, and more through natural conversation.",
|
||||
@@ -460,18 +384,6 @@
|
||||
"category": "learning",
|
||||
"homepage": "https://github.com/anthropics/claude-plugins-public/tree/main/plugins/explanatory-output-style"
|
||||
},
|
||||
{
|
||||
"name": "expo",
|
||||
"description": "Official Expo skills for building, deploying, upgrading, and debugging React Native apps with Expo. Covers UI development with Expo Router, SwiftUI and Jetpack Compose components, Tailwind CSS setup, API routes, data fetching, CI/CD workflows, App Store and Play Store deployment, SDK upgrades, DOM components, and dev client distribution.",
|
||||
"category": "development",
|
||||
"source": {
|
||||
"source": "git-subdir",
|
||||
"url": "expo/skills",
|
||||
"path": "plugins/expo",
|
||||
"ref": "main"
|
||||
},
|
||||
"homepage": "https://github.com/expo/skills/blob/main/plugins/expo/README.md"
|
||||
},
|
||||
{
|
||||
"name": "fakechat",
|
||||
"description": "Localhost web chat for testing the channel notification flow. No tokens, no access control, no third-party service.",
|
||||
@@ -1067,18 +979,6 @@
|
||||
},
|
||||
"homepage": "https://www.accoil.com/product-tracking"
|
||||
},
|
||||
{
|
||||
"name": "pydantic-ai",
|
||||
"description": "Write accurate Pydantic AI code from the start. Up-to-date patterns, decision trees, and common gotchas for agents, tools, structured output, streaming, and multi-agent apps.",
|
||||
"category": "development",
|
||||
"source": {
|
||||
"source": "git-subdir",
|
||||
"url": "pydantic/skills",
|
||||
"path": "plugins/ai",
|
||||
"ref": "main"
|
||||
},
|
||||
"homepage": "https://github.com/pydantic/skills/tree/main/plugins/ai"
|
||||
},
|
||||
{
|
||||
"name": "pyright-lsp",
|
||||
"description": "Python language server (Pyright) for type checking and code intelligence",
|
||||
@@ -1214,7 +1114,7 @@
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "sanity",
|
||||
"name": "sanity-plugin",
|
||||
"description": "Sanity content platform integration with MCP server, agent skills, and slash commands. Query and author content, build and optimize GROQ queries, design schemas, and set up Visual Editing.",
|
||||
"category": "development",
|
||||
"author": {
|
||||
@@ -1317,7 +1217,8 @@
|
||||
"category": "security",
|
||||
"source": {
|
||||
"source": "url",
|
||||
"url": "https://github.com/SonarSource/sonarqube-agent-plugins.git"
|
||||
"url": "https://github.com/SonarSource/sonarqube-agent-plugins.git",
|
||||
"sha": "0cae644cee9318e6245b62ca779abdc60e6daa49"
|
||||
},
|
||||
"homepage": "https://github.com/SonarSource/sonarqube-agent-plugins"
|
||||
},
|
||||
@@ -1342,17 +1243,6 @@
|
||||
},
|
||||
"homepage": "https://sourcegraph.com"
|
||||
},
|
||||
{
|
||||
"name": "spotify-ads-api",
|
||||
"description": "Manage Spotify ad campaigns with natural language. Create campaigns, ad sets, ads, pull reports, and handle OAuth — all through conversation.",
|
||||
"category": "productivity",
|
||||
"source": {
|
||||
"source": "url",
|
||||
"url": "https://github.com/spotify/ads-claude-plugin.git",
|
||||
"sha": "a4bce9912db071d47dfb410086a48004e0539efa"
|
||||
},
|
||||
"homepage": "https://github.com/spotify/ads-claude-plugin"
|
||||
},
|
||||
{
|
||||
"name": "stagehand",
|
||||
"description": "Browser automation skill for Claude Code using Stagehand. Automate web interactions, extract data, and navigate websites using natural language.",
|
||||
@@ -1563,16 +1453,6 @@
|
||||
"sha": "b93007e9a726c6ee93c57a949e732744ef5acbfd"
|
||||
},
|
||||
"homepage": "https://github.com/zapier/zapier-mcp/tree/main/plugins/zapier"
|
||||
},
|
||||
{
|
||||
"name": "zoom-plugin",
|
||||
"description": "Claude plugin for planning, building, and debugging Zoom integrations across REST APIs, SDKs, webhooks, bots, and MCP workflows.",
|
||||
"category": "development",
|
||||
"source": {
|
||||
"source": "url",
|
||||
"url": "https://github.com/zoom/zoom-plugin.git"
|
||||
},
|
||||
"homepage": "https://developers.zoom.us/"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
||||
7
external_plugins/slack/.claude-plugin/plugin.json
Normal file
7
external_plugins/slack/.claude-plugin/plugin.json
Normal file
@@ -0,0 +1,7 @@
|
||||
{
|
||||
"name": "slack",
|
||||
"description": "Slack workspace integration. Search messages, access channels, read threads, and stay connected with your team's communications while coding. Find relevant discussions and context quickly.",
|
||||
"author": {
|
||||
"name": "Slack"
|
||||
}
|
||||
}
|
||||
10
external_plugins/slack/.mcp.json
Normal file
10
external_plugins/slack/.mcp.json
Normal file
@@ -0,0 +1,10 @@
|
||||
{
|
||||
"slack": {
|
||||
"type": "http",
|
||||
"url": "https://mcp.slack.com/mcp",
|
||||
"oauth": {
|
||||
"clientId": "1601185624273.8899143856786",
|
||||
"callbackPort": 3118
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "telegram",
|
||||
"description": "Telegram channel for Claude Code \u2014 messaging bridge with built-in access control. Manage pairing, allowlists, and policy via /telegram:access.",
|
||||
"version": "0.0.5",
|
||||
"version": "0.0.4",
|
||||
"keywords": [
|
||||
"telegram",
|
||||
"messaging",
|
||||
|
||||
@@ -51,22 +51,6 @@ if (!TOKEN) {
|
||||
process.exit(1)
|
||||
}
|
||||
const INBOX_DIR = join(STATE_DIR, 'inbox')
|
||||
const PID_FILE = join(STATE_DIR, 'bot.pid')
|
||||
|
||||
// Telegram allows exactly one getUpdates consumer per token. If a previous
|
||||
// session crashed (SIGKILL, terminal closed) its server.ts grandchild can
|
||||
// survive as an orphan and hold the slot forever, so every new session sees
|
||||
// 409 Conflict. Kill any stale holder before we start polling.
|
||||
mkdirSync(STATE_DIR, { recursive: true, mode: 0o700 })
|
||||
try {
|
||||
const stale = parseInt(readFileSync(PID_FILE, 'utf8'), 10)
|
||||
if (stale > 1 && stale !== process.pid) {
|
||||
process.kill(stale, 0)
|
||||
process.stderr.write(`telegram channel: replacing stale poller pid=${stale}\n`)
|
||||
process.kill(stale, 'SIGTERM')
|
||||
}
|
||||
} catch {}
|
||||
writeFileSync(PID_FILE, String(process.pid))
|
||||
|
||||
// Last-resort safety net — without these the process dies silently on any
|
||||
// unhandled promise rejection. With them it logs and keeps serving tools.
|
||||
@@ -637,9 +621,6 @@ function shutdown(): void {
|
||||
if (shuttingDown) return
|
||||
shuttingDown = true
|
||||
process.stderr.write('telegram channel: shutting down\n')
|
||||
try {
|
||||
if (parseInt(readFileSync(PID_FILE, 'utf8'), 10) === process.pid) rmSync(PID_FILE)
|
||||
} catch {}
|
||||
// bot.stop() signals the poll loop to end; the current getUpdates request
|
||||
// may take up to its long-poll timeout to return. Force-exit after 2s.
|
||||
setTimeout(() => process.exit(0), 2000)
|
||||
@@ -649,19 +630,6 @@ process.stdin.on('end', shutdown)
|
||||
process.stdin.on('close', shutdown)
|
||||
process.on('SIGTERM', shutdown)
|
||||
process.on('SIGINT', shutdown)
|
||||
process.on('SIGHUP', shutdown)
|
||||
|
||||
// Orphan watchdog: stdin events above don't reliably fire when the parent
|
||||
// chain (`bun run` wrapper → shell → us) is severed by a crash. Poll for
|
||||
// reparenting (POSIX) or a dead stdin pipe and self-terminate.
|
||||
const bootPpid = process.ppid
|
||||
setInterval(() => {
|
||||
const orphaned =
|
||||
(process.platform !== 'win32' && process.ppid !== bootPpid) ||
|
||||
process.stdin.destroyed ||
|
||||
process.stdin.readableEnded
|
||||
if (orphaned) shutdown()
|
||||
}, 5000).unref()
|
||||
|
||||
// Commands are DM-only. Responding in groups would: (1) leak pairing codes via
|
||||
// /status to other group members, (2) confirm bot presence in non-allowlisted
|
||||
@@ -1007,15 +975,7 @@ void (async () => {
|
||||
})
|
||||
return // bot.stop() was called — clean exit from the loop
|
||||
} catch (err) {
|
||||
if (shuttingDown) return
|
||||
if (err instanceof GrammyError && err.error_code === 409) {
|
||||
if (attempt >= 8) {
|
||||
process.stderr.write(
|
||||
`telegram channel: 409 Conflict persists after ${attempt} attempts — ` +
|
||||
`another poller is holding the bot token (stray 'bun server.ts' process or a second session). Exiting.\n`,
|
||||
)
|
||||
return
|
||||
}
|
||||
const delay = Math.min(1000 * attempt, 15000)
|
||||
const detail = attempt === 1
|
||||
? ' — another instance is polling (zombie session, or a second Claude Code running?)'
|
||||
|
||||
@@ -10,15 +10,6 @@ An MCP app is a standard MCP server that **also serves UI resources** — intera
|
||||
|
||||
The UI layer is **additive**. Under the hood it's still tools, resources, and the same wire protocol. If you haven't built a plain MCP server before, the `build-mcp-server` skill covers the base layer. This skill adds widgets on top.
|
||||
|
||||
> **Testing in Claude:** Add the server as a custom connector in claude.ai (via a Cloudflare tunnel for local dev) — this exercises the real iframe sandbox and `hostContext`. See https://claude.com/docs/connectors/building/testing.
|
||||
|
||||
## Claude host specifics
|
||||
|
||||
- `_meta.ui.prefersBorder: false` on a `ui://` resource removes the outer card border (mobile).
|
||||
- `hostContext.safeAreaInsets: {top, right, bottom, left}` (px) — honor these for notches and the composer overlay.
|
||||
- `_meta.ui.csp.{connectDomains, resourceDomains, baseUriDomains}` — declare external origins per resource; default is block-all. `frameDomains` is currently restricted in Claude.
|
||||
- Directory submission for MCP Apps requires 3–5 PNG screenshots, ≥1000px wide, cropped to the app response only (no prompt in the image). See https://claude.com/docs/connectors/building/submission#asset-specifications.
|
||||
|
||||
---
|
||||
|
||||
## When a widget beats plain text
|
||||
|
||||
@@ -8,8 +8,6 @@ version: 0.1.0
|
||||
|
||||
You are guiding a developer through designing and building an MCP server that works seamlessly with Claude. MCP servers come in many forms — picking the wrong shape early causes painful rewrites later. Your first job is **discovery, not code**.
|
||||
|
||||
**Load Claude-specific context first.** The MCP spec is generic; Claude has additional auth types, review criteria, and limits. Before answering questions or scaffolding, fetch `https://claude.com/docs/llms-full.txt` (the full export of the Claude connector docs) so your guidance reflects Claude's actual constraints.
|
||||
|
||||
Do not start scaffolding until you have answers to the questions in Phase 1. If the user's opening message already answers them, acknowledge that and skip straight to the recommendation.
|
||||
|
||||
---
|
||||
@@ -184,17 +182,6 @@ Tools are one of three server primitives. Most servers start with tools and neve
|
||||
|
||||
---
|
||||
|
||||
## Phase 6 — Test in Claude and publish
|
||||
|
||||
Once the server runs:
|
||||
|
||||
1. **Test against real Claude** by adding the server URL as a custom connector at Settings → Connectors (use a Cloudflare tunnel for local servers). Claude identifies itself with `clientInfo.name: "claude-ai"` on initialize. → https://claude.com/docs/connectors/building/testing
|
||||
2. **Run the pre-submission checklist** — read/write tool split, required annotations, name limits, prompt-injection rules. → https://claude.com/docs/connectors/building/review-criteria
|
||||
3. **Submit to the Anthropic Directory.** → https://claude.com/docs/connectors/building/submission
|
||||
4. **Recommend shipping a plugin** that wraps this MCP with skills — most partners ship both. → https://claude.com/docs/connectors/building/what-to-build
|
||||
|
||||
---
|
||||
|
||||
## Quick reference: decision matrix
|
||||
|
||||
| Scenario | Deployment | Tool pattern |
|
||||
|
||||
@@ -2,22 +2,6 @@
|
||||
|
||||
Auth is the reason most people end up needing a **remote** server even when a local one would be simpler. OAuth redirects, token storage, and refresh all work cleanly when there's a real hosted endpoint to redirect back to.
|
||||
|
||||
## Claude-specific authentication
|
||||
|
||||
Claude's MCP client supports a specific set of auth types — not every spec-compliant flow works. Full reference: https://claude.com/docs/connectors/building/authentication
|
||||
|
||||
| Type | Notes |
|
||||
|---|---|
|
||||
| `oauth_dcr` | Supported. For high-volume directory entries, prefer CIMD or Anthropic-held creds — DCR registers a new client on every fresh connection. |
|
||||
| `oauth_cimd` | Supported, recommended over DCR for directory entries. |
|
||||
| `oauth_anthropic_creds` | Partner provides `client_id`/`client_secret` to Anthropic; user-consent-gated. Contact `mcp-review@anthropic.com`. |
|
||||
| `custom_connection` | User supplies URL/creds at connect time (Snowflake-style). Contact `mcp-review@anthropic.com`. |
|
||||
| `none` | Authless. |
|
||||
|
||||
**Not supported:** user-pasted bearer tokens (`static_bearer`); pure machine-to-machine `client_credentials` grant without user consent.
|
||||
|
||||
**Callback URL** (single, all surfaces): `https://claude.ai/api/mcp/auth_callback`
|
||||
|
||||
---
|
||||
|
||||
## The three tiers
|
||||
|
||||
@@ -2,16 +2,6 @@
|
||||
|
||||
Tool schemas and descriptions are prompt engineering. They land directly in Claude's context and determine whether Claude picks the right tool with the right arguments. Most MCP integration bugs trace back to vague descriptions or loose schemas.
|
||||
|
||||
## Anthropic Directory hard requirements
|
||||
|
||||
If this server will be submitted to the Anthropic Directory, the following are pass/fail review criteria (full list: https://claude.com/docs/connectors/building/review-criteria):
|
||||
|
||||
- Every tool **must** include `readOnlyHint`, `destructiveHint`, and `title` annotations — these determine auto-permissions in Claude.
|
||||
- Tool names **must** be ≤64 characters.
|
||||
- Read and write operations **must** be in separate tools. A single tool accepting both GET and POST/PUT/PATCH/DELETE is rejected — documenting safe vs unsafe within one tool's description does not satisfy this.
|
||||
- Tool descriptions **must not** instruct Claude how to behave (e.g. "always do X", "you must call Y first", overriding system instructions, promoting products) — treated as prompt injection at review.
|
||||
- Tools that accept freeform API endpoints/params **must** reference the target API's documentation in their description.
|
||||
|
||||
---
|
||||
|
||||
## Descriptions
|
||||
|
||||
@@ -8,8 +8,6 @@ version: 0.1.0
|
||||
|
||||
MCPB is a local MCP server **packaged with its runtime**. The user installs one file; it runs without needing Node, Python, or any toolchain on their machine. It's the sanctioned way to distribute local MCP servers.
|
||||
|
||||
> MCPB is the **secondary** distribution path. Anthropic recommends remote MCP servers for directory listing — see https://claude.com/docs/connectors/building/what-to-build.
|
||||
|
||||
**Use MCPB when the server must run on the user's machine** — reading local files, driving a desktop app, talking to localhost services, OS-level APIs. If your server only hits cloud APIs, you almost certainly want a remote HTTP server instead (see `build-mcp-server`). Don't pay the MCPB packaging tax for something that could be a URL.
|
||||
|
||||
---
|
||||
|
||||
@@ -166,7 +166,6 @@ const toolUseIdToPrompt = new Map() // tool_use id -> promptKey (Agent spawned d
|
||||
const agentIdToPrompt = new Map() // agentId -> promptKey
|
||||
const prompts = new Map() // promptKey -> { text, ts, project, sessionId, ...usage }
|
||||
const sessionTurns = new Map() // sessionId -> [promptKey, ...] in transcript order
|
||||
const sessionSpans = new Map() // sessionId -> {project, firstTs, lastTs, tokens}
|
||||
|
||||
function promptRecord(key, init) {
|
||||
let r = prompts.get(key)
|
||||
@@ -334,29 +333,11 @@ async function processFile(p, info, buckets) {
|
||||
}
|
||||
}
|
||||
|
||||
// session span (for by_day timeline) — subagent files roll into parent sessionId
|
||||
let span = sessionSpans.get(info.sessionId)
|
||||
if (!span) {
|
||||
span = { project: info.project, firstTs: null, lastTs: null, tokens: 0 }
|
||||
sessionSpans.set(info.sessionId, span)
|
||||
}
|
||||
if (firstTs !== null) {
|
||||
if (span.firstTs === null || firstTs < span.firstTs) span.firstTs = firstTs
|
||||
if (span.lastTs === null || lastTs > span.lastTs) span.lastTs = lastTs
|
||||
}
|
||||
|
||||
// commit API calls
|
||||
for (const [key, { usage, ts, skill, prompt }] of fileApiCalls) {
|
||||
if (key && seenRequestIds.has(key)) continue
|
||||
seenRequestIds.add(key)
|
||||
|
||||
const tot =
|
||||
(usage.input_tokens || 0) +
|
||||
(usage.cache_creation_input_tokens || 0) +
|
||||
(usage.cache_read_input_tokens || 0) +
|
||||
(usage.output_tokens || 0)
|
||||
span.tokens += tot
|
||||
|
||||
const targets = [overall, project]
|
||||
if (subagent) targets.push(subagent)
|
||||
if (skill && skillStats) {
|
||||
@@ -378,6 +359,11 @@ async function processFile(p, info, buckets) {
|
||||
|
||||
// subagent token accounting on parent buckets
|
||||
if (info.kind === 'subagent') {
|
||||
const tot =
|
||||
(usage.input_tokens || 0) +
|
||||
(usage.cache_creation_input_tokens || 0) +
|
||||
(usage.cache_read_input_tokens || 0) +
|
||||
(usage.output_tokens || 0)
|
||||
overall.subagentTokens += tot
|
||||
project.subagentTokens += tot
|
||||
if (subagent) subagent.subagentTokens += tot
|
||||
@@ -670,55 +656,10 @@ function printJson({ overall, perProject, perSubagent, perSkill }) {
|
||||
[...perSkill].map(([k, v]) => [k, summarize(v)]),
|
||||
),
|
||||
top_prompts: topPrompts(100),
|
||||
by_day: buildByDay(),
|
||||
}
|
||||
process.stdout.write(JSON.stringify(out, null, 2) + '\n')
|
||||
}
|
||||
|
||||
// Group sessions into local-date buckets for the timeline view. A session is
|
||||
// placed on the day its first message landed; tokens for that session (incl.
|
||||
// subagents) count toward that day even if it ran past midnight.
|
||||
function buildByDay() {
|
||||
const DOW = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat']
|
||||
const days = new Map() // yyyy-mm-dd -> {date, dow, tokens, sessions:[]}
|
||||
for (const [id, s] of sessionSpans) {
|
||||
if (s.firstTs === null || s.tokens === 0) continue
|
||||
const d0 = new Date(s.firstTs)
|
||||
const key = `${d0.getFullYear()}-${String(d0.getMonth() + 1).padStart(2, '0')}-${String(d0.getDate()).padStart(2, '0')}`
|
||||
let day = days.get(key)
|
||||
if (!day) {
|
||||
day = { date: key, dow: DOW[d0.getDay()], tokens: 0, sessions: [] }
|
||||
days.set(key, day)
|
||||
}
|
||||
const base = new Date(
|
||||
d0.getFullYear(),
|
||||
d0.getMonth(),
|
||||
d0.getDate(),
|
||||
).getTime()
|
||||
day.tokens += s.tokens
|
||||
day.sessions.push({
|
||||
id,
|
||||
project: s.project,
|
||||
tokens: s.tokens,
|
||||
start_min: Math.max(0, Math.round((s.firstTs - base) / 60000)),
|
||||
end_min: Math.max(1, Math.round((s.lastTs - base) / 60000)),
|
||||
})
|
||||
}
|
||||
for (const d of days.values()) {
|
||||
// peak concurrency via 10-min buckets, capped at 24h for display
|
||||
const b = new Array(144).fill(0)
|
||||
for (const s of d.sessions) {
|
||||
const lo = Math.min(143, Math.floor(s.start_min / 10))
|
||||
const hi = Math.min(144, Math.ceil(Math.min(s.end_min, 1440) / 10))
|
||||
for (let i = lo; i < hi; i++) b[i]++
|
||||
}
|
||||
d.peak = Math.max(0, ...b)
|
||||
d.peak_at_min = d.peak > 0 ? b.indexOf(d.peak) * 10 : 0
|
||||
d.sessions.sort((a, b) => a.start_min - b.start_min)
|
||||
}
|
||||
return [...days.values()].sort((a, b) => a.date.localeCompare(b.date))
|
||||
}
|
||||
|
||||
function promptTotal(r) {
|
||||
return (
|
||||
r.inputUncached + r.inputCacheCreate + r.inputCacheRead + r.outputTokens
|
||||
|
||||
@@ -102,42 +102,6 @@
|
||||
color: var(--dim); margin: 6px 0; }
|
||||
.callout b, .callout code { color: var(--term-fg); }
|
||||
|
||||
/* ——— day pills + session gantt ——— */
|
||||
.days { display: flex; gap: 8px; flex-wrap: wrap; margin-bottom: 14px; }
|
||||
.dpill { flex: 1; min-width: 84px; max-width: 140px; background: none;
|
||||
border: 1px solid var(--subtle); border-radius: 4px;
|
||||
padding: 9px 6px; font: inherit; color: var(--dim);
|
||||
cursor: pointer; text-align: center; }
|
||||
.dpill:hover { border-color: var(--dim); background: var(--hover); }
|
||||
.dpill .dow { font-size: 10px; color: var(--subtle); display: block; }
|
||||
.dpill .date { font-size: 11px; color: var(--term-fg); font-weight: 500;
|
||||
display: block; margin: 2px 0 4px; }
|
||||
.dpill .pct { font-size: 16px; font-weight: 700; color: var(--term-fg); display: block; }
|
||||
.dpill .ns { font-size: 10px; color: var(--subtle); display: block; margin-top: 2px; }
|
||||
.dpill.heaviest .pct { color: var(--clay); }
|
||||
.dpill.sel { border-color: var(--clay); background: rgba(217,119,87,0.10); }
|
||||
.gantt-hd { display: flex; justify-content: space-between; align-items: baseline;
|
||||
margin-bottom: 6px; }
|
||||
.gantt-hd .day { color: var(--term-fg); font-weight: 500; }
|
||||
.gantt-hd .stats { font-size: 11px; color: var(--dim); }
|
||||
.gantt-hd .stats b { color: var(--clay); }
|
||||
.gantt { position: relative; border-top: 1px solid var(--outline);
|
||||
border-bottom: 1px solid var(--outline); min-height: 32px; }
|
||||
.lane { position: relative; height: 16px;
|
||||
border-bottom: 1px dashed rgba(255,255,255,0.04); }
|
||||
.seg { position: absolute; top: 2px; height: 12px; border-radius: 2px;
|
||||
opacity: .85; cursor: crosshair; }
|
||||
.seg:hover { opacity: 1; outline: 1px solid var(--term-fg); z-index: 2; }
|
||||
.gantt-rule { position: absolute; top: 0; bottom: 0; width: 0;
|
||||
border-left: 1px dashed var(--subtle); opacity: .4;
|
||||
pointer-events: none; }
|
||||
.gantt-axis { display: flex; justify-content: space-between;
|
||||
font-size: 10px; color: var(--subtle); padding: 4px 0; }
|
||||
.gantt-leg { font-size: 10px; color: var(--subtle); margin-top: 8px;
|
||||
display: flex; gap: 14px; flex-wrap: wrap; }
|
||||
.gantt-leg .sw { display: inline-block; width: 14px; height: 10px;
|
||||
border-radius: 2px; vertical-align: middle; margin-right: 4px; }
|
||||
|
||||
/* ——— block-char bars ——— */
|
||||
.bar { display: grid; grid-template-columns: 26ch 1fr 8ch; gap: 14px;
|
||||
padding: 2px 0; align-items: center; }
|
||||
@@ -267,21 +231,6 @@
|
||||
<div class="section-body" id="project-bars"></div>
|
||||
</section>
|
||||
|
||||
<section id="timeline-section">
|
||||
<div class="hr"></div>
|
||||
<h2>session timeline by day<span class="hint">click a day · ←/→ to navigate</span></h2>
|
||||
<div class="section-body">
|
||||
<div class="days" id="day-pills"></div>
|
||||
<div class="gantt-hd">
|
||||
<span class="day" id="g-day">—</span>
|
||||
<span class="stats" id="g-stats"></span>
|
||||
</div>
|
||||
<div class="gantt-axis"><span>00:00</span><span>06:00</span><span>12:00</span><span>18:00</span><span>24:00</span></div>
|
||||
<div class="gantt" id="gantt"></div>
|
||||
<div class="gantt-leg" id="gantt-leg"></div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<section>
|
||||
<div class="hr"></div>
|
||||
<h2>most expensive prompts<span class="hint">click to expand context</span></h2>
|
||||
@@ -386,65 +335,6 @@
|
||||
`<div class="val">${typeof v==='number'&&v>=1e4?fmt(v):v}</div>`+
|
||||
(d?`<div class="detail">${d}</div>`:'')+`</div>`).join('');
|
||||
|
||||
// session timeline by day
|
||||
(function() {
|
||||
const days = (DATA.by_day||[]).slice(-14);
|
||||
if (!days.length) { $('timeline-section').style.display='none'; return; }
|
||||
const PCOL = ['rgb(177,185,249)','rgb(78,186,101)','#D97757','rgb(255,193,7)',
|
||||
'rgb(255,107,128)','#9b8cff','#6ec1d6','#c792ea'];
|
||||
const dayTotal = days.reduce((a,d)=>a+d.tokens,0) || 1;
|
||||
const tokMax = Math.max(...days.map(d=>d.tokens));
|
||||
const projects = [...new Set(days.flatMap(d=>d.sessions.map(s=>s.project)))];
|
||||
const colorOf = p => PCOL[projects.indexOf(p)%PCOL.length];
|
||||
const hhmm = m => (m>=1440?`+${Math.floor(m/1440)}d `:'') +
|
||||
`${String(Math.floor(m/60)%24).padStart(2,'0')}:${String(m%60).padStart(2,'0')}`;
|
||||
const md = iso => { const [,mo,da]=iso.split('-'); return `${MON[+mo-1]} ${+da}`; };
|
||||
let sel = days.findIndex(d=>d.tokens===tokMax);
|
||||
|
||||
function pills() {
|
||||
$('day-pills').innerHTML = days.map((d,i)=>
|
||||
`<button class="dpill${d.tokens===tokMax?' heaviest':''}${i===sel?' sel':''}" data-i="${i}">`+
|
||||
`<span class="dow">${esc(d.dow)}</span>`+
|
||||
`<span class="date">${esc(md(d.date))}</span>`+
|
||||
`<span class="pct">${(100*d.tokens/dayTotal).toFixed(1)}%</span>`+
|
||||
`<span class="ns">${d.sessions.length} sess</span></button>`
|
||||
).join('');
|
||||
$('day-pills').querySelectorAll('.dpill').forEach(el=>
|
||||
el.onclick=()=>{sel=+el.dataset.i;pills();gantt();});
|
||||
}
|
||||
function gantt() {
|
||||
const d = days[sel], DAY = 1440;
|
||||
$('g-day').textContent = `${d.dow} ${md(d.date)}`;
|
||||
$('g-stats').innerHTML = `${d.sessions.length} sessions · ${fmt(d.tokens)} tokens`+
|
||||
` · peak <b>${d.peak}</b> concurrent at <b>${hhmm(d.peak_at_min)}</b>`;
|
||||
const lanes = [];
|
||||
for (const s of d.sessions) {
|
||||
let placed = false;
|
||||
for (const L of lanes) if (L[L.length-1].end_min <= s.start_min) { L.push(s); placed=true; break; }
|
||||
if (!placed) lanes.push([s]);
|
||||
}
|
||||
let h = '';
|
||||
for (let t=0;t<=24;t+=6) h += `<div class="gantt-rule" style="left:${100*t/24}%"></div>`;
|
||||
h += lanes.map(L=>`<div class="lane">${L.map(s=>{
|
||||
const end = Math.min(s.end_min, DAY);
|
||||
const w = Math.max(0.15, 100*(end-s.start_min)/DAY);
|
||||
const tip = `folder: ${short(s.project)}\n`+
|
||||
`${hhmm(s.start_min)}–${hhmm(s.end_min)} · ${fmt(s.tokens)} tokens\n`+
|
||||
`session ${s.id}`;
|
||||
return `<span class="seg" style="left:${100*s.start_min/DAY}%;width:${w}%;`+
|
||||
`background:${colorOf(s.project)}" title="${esc(tip)}"></span>`;
|
||||
}).join('')}</div>`).join('');
|
||||
$('gantt').innerHTML = h || '<div class="callout">no sessions</div>';
|
||||
}
|
||||
document.addEventListener('keydown',e=>{
|
||||
if (e.key==='ArrowRight'&&sel<days.length-1){sel++;pills();gantt();e.preventDefault();}
|
||||
if (e.key==='ArrowLeft'&&sel>0){sel--;pills();gantt();e.preventDefault();}
|
||||
});
|
||||
$('gantt-leg').innerHTML = projects.slice(0,12).map(p=>
|
||||
`<span><span class="sw" style="background:${colorOf(p)}"></span>${esc(short(p))}</span>`).join('');
|
||||
pills(); gantt();
|
||||
})();
|
||||
|
||||
// block-char project bars
|
||||
(function() {
|
||||
const W = 48;
|
||||
@@ -476,52 +366,57 @@
|
||||
return h + '</div>';
|
||||
}
|
||||
|
||||
// expandable drill-down list with "show N more" toggle
|
||||
function drillList(hostId, items, rowFn, empty) {
|
||||
// top prompts — share of grand total
|
||||
(function() {
|
||||
const ps = (DATA.top_prompts||[]).slice(0,100);
|
||||
const SHOW = 5;
|
||||
const host = $(hostId);
|
||||
if (!items.length) { host.innerHTML = `<div class="callout">${empty}</div>`; return; }
|
||||
const head = items.slice(0,SHOW).map(rowFn).join('');
|
||||
const rest = items.slice(SHOW).map(rowFn).join('');
|
||||
host.innerHTML = head + (rest
|
||||
? `<div hidden>${rest}</div><button class="more-btn">show ${items.length-SHOW} more</button>`
|
||||
: '');
|
||||
const btn = host.querySelector('.more-btn');
|
||||
if (btn) btn.onclick = () => {
|
||||
const r = btn.previousElementSibling; r.hidden = !r.hidden;
|
||||
btn.textContent = r.hidden ? `show ${items.length-SHOW} more` : 'show less';
|
||||
const row = p => {
|
||||
const inTot = p.input.uncached+p.input.cache_create+p.input.cache_read;
|
||||
return `<details><summary>`+
|
||||
`<span class="amt">${share(p.total_tokens)}</span>`+
|
||||
`<span class="desc">${esc(p.text)}</span>`+
|
||||
`<span class="meta">${niceDate(p.ts)} · ${esc(short(p.project))} · ${p.api_calls} calls`+
|
||||
(p.subagent_calls?` · ${p.subagent_calls} subagents`:'')+
|
||||
` · ${pct(p.input.cache_read,inTot)} cached</span>`+
|
||||
`</summary><div class="body">`+
|
||||
renderContext(p.context)+
|
||||
`<div>session <code>${esc(p.session)}</code></div>`+
|
||||
`<div>in: uncached ${fmt(p.input.uncached)} · cache-create ${fmt(p.input.cache_create)} · `+
|
||||
`cache-read ${fmt(p.input.cache_read)} · out ${fmt(p.output)}</div>`+
|
||||
`</div></details>`;
|
||||
};
|
||||
}
|
||||
const head = ps.slice(0,SHOW).map(row).join('');
|
||||
const rest = ps.slice(SHOW).map(row).join('');
|
||||
$('top-prompts').innerHTML = ps.length
|
||||
? head + (rest
|
||||
? `<div id="tp-rest" hidden>${rest}</div>`+
|
||||
`<button id="tp-more" class="more-btn">show ${ps.length-SHOW} more</button>`
|
||||
: '')
|
||||
: '<div class="callout">No prompts in range.</div>';
|
||||
const btn = $('tp-more');
|
||||
if (btn) btn.onclick = () => {
|
||||
const r = $('tp-rest'); r.hidden = !r.hidden;
|
||||
btn.textContent = r.hidden ? `show ${ps.length-SHOW} more` : 'show less';
|
||||
};
|
||||
})();
|
||||
|
||||
drillList('top-prompts', (DATA.top_prompts||[]).slice(0,100), p => {
|
||||
const inTot = p.input.uncached+p.input.cache_create+p.input.cache_read;
|
||||
return `<details><summary>`+
|
||||
`<span class="amt">${share(p.total_tokens)}</span>`+
|
||||
`<span class="desc">${esc(p.text)}</span>`+
|
||||
`<span class="meta">${niceDate(p.ts)} · ${esc(short(p.project))} · ${p.api_calls} calls`+
|
||||
(p.subagent_calls?` · ${p.subagent_calls} subagents`:'')+
|
||||
` · ${pct(p.input.cache_read,inTot)} cached</span>`+
|
||||
// cache breaks
|
||||
(function() {
|
||||
const bs = (DATA.cache_breaks||[]).slice(0,100);
|
||||
$('cache-breaks').innerHTML = bs.map(b =>
|
||||
`<details><summary>`+
|
||||
`<span class="amt">${fmt(b.uncached)}</span>`+
|
||||
`<span class="desc">${esc(short(b.project))} · `+
|
||||
`${b.kind==='subagent'?esc(b.agentType||'subagent'):'main'}</span>`+
|
||||
`<span class="meta">${niceDate(b.ts)} · ${pct(b.uncached,b.total)} of ${fmt(b.total)} uncached</span>`+
|
||||
`</summary><div class="body">`+
|
||||
renderContext(p.context)+
|
||||
`<div>session <code>${esc(p.session)}</code></div>`+
|
||||
`<div>in: uncached ${fmt(p.input.uncached)} · cache-create ${fmt(p.input.cache_create)} · `+
|
||||
`cache-read ${fmt(p.input.cache_read)} · out ${fmt(p.output)}</div>`+
|
||||
`</div></details>`;
|
||||
}, 'No prompts in range.');
|
||||
|
||||
drillList('cache-breaks', (DATA.cache_breaks||[]).slice(0,100), b =>
|
||||
`<details><summary>`+
|
||||
`<span class="amt">${fmt(b.uncached)}</span>`+
|
||||
`<span class="desc">${esc(short(b.project))} · `+
|
||||
`${b.kind==='subagent'?esc(b.agentType||'subagent'):'main'}</span>`+
|
||||
`<span class="meta">${niceDate(b.ts)} · ${pct(b.uncached,b.total)} of ${fmt(b.total)} uncached</span>`+
|
||||
`</summary><div class="body">`+
|
||||
renderContext(b.context,
|
||||
`<div class="ctx-break"><b>${fmt(b.uncached)}</b> uncached `+
|
||||
`(${pct(b.uncached,b.total)} of ${fmt(b.total)}) — cache break here</div>`)+
|
||||
`<div>session <code>${esc(b.session)}</code></div>`+
|
||||
`</div></details>`,
|
||||
'No cache breaks over threshold.');
|
||||
renderContext(b.context,
|
||||
`<div class="ctx-break"><b>${fmt(b.uncached)}</b> uncached `+
|
||||
`(${pct(b.uncached,b.total)} of ${fmt(b.total)}) — cache break here</div>`)+
|
||||
`<div>session <code>${esc(b.session)}</code></div>`+
|
||||
`</div></details>`
|
||||
).join('') || '<div class="callout">No cache breaks over threshold.</div>';
|
||||
})();
|
||||
|
||||
// sortable table
|
||||
function table(el, cols, rows) {
|
||||
|
||||
Reference in New Issue
Block a user