diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 7c0785b..9a091b5 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -10,7 +10,7 @@ { "name": "synter", "source": "./", - "description": "Plan and operate advertising campaigns through Synter’s hosted MCP server over OAuth. Review performance, write ad copy, and approve campaign changes before execution." + "description": "Plan and operate advertising campaigns on 30+ ad platforms through Synter’s hosted MCP server over OAuth. Review performance, write ad copy, and approve campaign changes before execution." } ] } diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 8ca4331..d73525b 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -2,8 +2,8 @@ "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json", "name": "synter", "displayName": "Synter", - "description": "Plan and operate advertising campaigns through Synter’s hosted MCP server over OAuth. Review performance, write ad copy, and approve campaign changes before execution.", - "version": "1.2.1", + "description": "Plan and operate advertising campaigns on 30+ ad platforms through Synter’s hosted MCP server over OAuth. Review performance, write ad copy, and approve campaign changes before execution.", + "version": "1.3.0", "license": "MIT", "author": { "name": "Synter", diff --git a/.cursor-mcp.json b/.cursor-mcp.json index b865a6c..eafd066 100644 --- a/.cursor-mcp.json +++ b/.cursor-mcp.json @@ -2,7 +2,8 @@ "mcpServers": { "synter": { "type": "http", - "url": "https://mcp.synterai.com" + "url": "https://mcp.synterai.com", + "description": "Synter Advertising Platform MCP: cross-channel ad reporting and management for AI agents. Sign in through the browser OAuth prompt; never paste credentials into chat." } } } diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json index e07ddcb..0c36156 100644 --- a/.cursor-plugin/marketplace.json +++ b/.cursor-plugin/marketplace.json @@ -6,13 +6,13 @@ }, "metadata": { "description": "Synter's official plugin marketplace. The AI Agent Operator for Ads.", - "version": "1.2.1" + "version": "1.3.0" }, "plugins": [ { "name": "synter", "source": ".", - "logo": "assets/logo.png", + "logo": "assets/logo-opaque.png", "description": "Plan and operate advertising campaigns through Synter’s hosted MCP server over OAuth. Review performance, write ad copy, and approve campaign changes before execution." } ] diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json index bf7e256..95e808a 100644 --- a/.cursor-plugin/plugin.json +++ b/.cursor-plugin/plugin.json @@ -1,9 +1,9 @@ { "$schema": "https://cursor.com/schemas/cursor-plugin/plugin.json", "name": "synter", - "displayName": "Synter", - "version": "1.2.1", - "description": "Plan and operate advertising campaigns through Synter’s hosted MCP server over OAuth. Review performance, write ad copy, and approve campaign changes before execution.", + "displayName": "Synter: Google Ads, Meta, LinkedIn, Reddit, X, TikTok & Microsoft Ads", + "version": "1.3.0", + "description": "Report on and plan ad campaigns across 9 verified platforms: Google Ads, Meta (Facebook & Instagram), LinkedIn, Microsoft (Bing) Ads, Reddit, Snapchat, StackAdapt, TikTok, and X (Twitter; performance reporting on X and TikTok may require platform exports) from one browser OAuth connection. Reads cost credits; campaign changes require a paid plan and your approval, and nothing spends without it.", "author": { "name": "Synter", "email": "joel@synterai.com" @@ -11,20 +11,67 @@ "homepage": "https://synterai.com", "repository": "https://github.com/Synter-Media-AI/plugin", "license": "MIT", - "logo": "assets/logo.png", + "logo": "assets/logo-opaque.png", + "category": "integrations", "keywords": [ - "ads", - "advertising", - "campaigns", - "audiences", - "media-buying", - "creative", - "roas", + "synter", + "synter ads", + "synterai", + "google ads", "google-ads", + "adwords", + "performance max", + "pmax", + "search ads", + "meta ads", + "facebook ads", + "instagram ads", "meta-ads", + "linkedin ads", "linkedin-ads", - "mcp", - "synter" + "b2b ads", + "reddit ads", + "reddit-ads", + "x ads", + "twitter ads", + "x-ads", + "tiktok ads", + "tiktok-ads", + "microsoft ads", + "bing ads", + "microsoft advertising", + "microsoft-ads", + "snapchat ads", + "snap ads", + "stackadapt", + "programmatic", + "programmatic advertising", + "native ads", + "ppc", + "paid media", + "paid social", + "paid search", + "media buying", + "campaign management", + "ad reporting", + "ad optimization", + "roas", + "cpa", + "cross-channel advertising", + "advertising", + "marketing", + "mcp" + ], + "tags": [ + "advertising", + "marketing", + "ppc", + "paid-social", + "paid-search", + "programmatic", + "analytics", + "campaigns", + "mcp" ], "skills": "./skills/", "agents": "./agents/", diff --git a/.github/workflows/directory-tools.yml b/.github/workflows/directory-tools.yml index 460b009..cefb793 100644 --- a/.github/workflows/directory-tools.yml +++ b/.github/workflows/directory-tools.yml @@ -19,5 +19,7 @@ jobs: node-version: '20' - name: Check instruction tool references run: node scripts/check-directory-tools.js + - name: Check skill tool references against hosted tools + run: node scripts/check-skill-tools.mjs - name: Test repository validators run: node --test scripts/*.test.js diff --git a/.github/workflows/validate.yml b/.github/workflows/validate.yml index 76f2137..acea2d2 100644 --- a/.github/workflows/validate.yml +++ b/.github/workflows/validate.yml @@ -19,6 +19,9 @@ jobs: - name: Run manifest validation run: node scripts/validate-manifests.js + - name: Check skill tool references against hosted tools + run: node scripts/check-skill-tools.mjs + - name: Run strict Claude plugin validation run: | npx -y @anthropic-ai/claude-code@2.1.263 plugin validate . --strict diff --git a/.mcp.json b/.mcp.json index c3ae094..eafd066 100644 --- a/.mcp.json +++ b/.mcp.json @@ -3,7 +3,7 @@ "synter": { "type": "http", "url": "https://mcp.synterai.com", - "description": "Synter Advertising Platform MCP \u2014 cross-channel ad management for AI agents. Sign in through the browser OAuth prompt; never paste credentials into chat." + "description": "Synter Advertising Platform MCP: cross-channel ad reporting and management for AI agents. Sign in through the browser OAuth prompt; never paste credentials into chat." } } } diff --git a/CHANGELOG.md b/CHANGELOG.md index 7c7e76b..3d8348c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,14 @@ # Changelog +## [1.3.0] - Unreleased + +- Update the Cursor Marketplace manifest to 1.3.0 with a verified nine-platform description, category, and keywords. Add `assets/logo-opaque.png` for that listing and keep the canonical transparent `assets/logo.png`. +- Point the Claude directory bundle at `https://mcp.synterai.com/mcp/directory`. Claude, Cursor, and portable packages stay on `https://mcp.synterai.com`. +- Record the connector submitted 2026-09-04, plugin ID `f802a044-fa2c-4a98-8c82-26a2870ca6b3`. `https://mcp.syntermedia.ai` remains the live origin of that pending submission. +- Describe Claude listings as 30+ ad platforms, and add directory install and support copy. Directory listing copy points at the pricing page and does not state plan prices. +- Ship 42 tool names in the Claude directory bundle. `tools/directory-tools.json` stays the 34-name full-plugin instruction allowlist. +- Check skill tool names against `scripts/hosted-tools.json` in CI. + ## [1.2.1] - Unreleased - Add a portable OpenAI package targeting the existing Synter Ads MCP draft, diff --git a/CLAUDE_COMMUNITY_SUBMISSION.md b/CLAUDE_COMMUNITY_SUBMISSION.md index 7201ce2..e399be1 100644 --- a/CLAUDE_COMMUNITY_SUBMISSION.md +++ b/CLAUDE_COMMUNITY_SUBMISSION.md @@ -1,19 +1,33 @@ # Claude plugin directory submission -Prepared: 2026-09-06 +Prepared: 2026-09-06. URL and submission record updated: 2026-11-06. This is the reviewer-ready package for the public Synter plugin repository. Synter's separate remote MCP connector submission is in review; that does not -submit or publish this plugin in Anthropic's plugin directory. +submit or publish this plugin in Anthropic's plugin directory. This document +does not submit either listing. ## Current directory status -- **Connector Directory:** submitted 2026-09-05 from the Synter Team - organization; slug `synter`; status **In review** at +- **Connector Directory:** submitted 2026-09-04 from the Synter Team + organization. Plugin ID `f802a044-fa2c-4a98-8c82-26a2870ca6b3`. Slug `synter`. + Status **In review** at `https://claude.ai/admin-settings/directory/submissions/synter`. + The origin on that submission is `https://mcp.syntermedia.ai`. That host is + still live. Leave it in place for the review already underway. This + repository does not redirect it, take it down, or edit that submission. +- **New package endpoints:** Claude, Cursor, and the portable package use + `https://mcp.synterai.com`. The Claude directory bundle at + `packages/claude-directory` uses `https://mcp.synterai.com/mcp/directory` + for the curated directory profile. Those URLs are for new package files. + They are not a change to the connector already in review. On 2026-11-06 an + unauthenticated request to `https://mcp.synterai.com/mcp/directory` returned + the same `401` challenge as `https://mcp.synterai.com` and named + `https://mcp.synterai.com` as `mcp_endpoint`. Confirm that path serves the + curated tool list before anyone submits the bundle. - **Plugin Directory:** no submission ID or published listing has been - verified. This public repository remains directly installable while the - separate plugin submission is completed. + verified. This reconciliation does not submit the bundle. The public + repository remains directly installable. Anthropic documents the Connector Directory and Plugin Directory as separate, complementary catalogs. Do not treat connector review as plugin publication. @@ -25,14 +39,14 @@ complementary catalogs. Do not treat connector review as plugin publication. | Public repository | `https://github.com/Synter-Media-AI/plugin` | | Plugin name | `synter` | | Publisher | Synter | -| Website | `https://syntermedia.ai` | +| Website | `https://synterai.com` | | License | MIT | | Category | Marketing and advertising | | Short description | Operate cross-channel advertising with approval-gated Synter agents, skills, and MCP tools. | | Brand icon | `assets/logo.png` — canonical transparent 1024×1024 Synter mark | -| Support | `https://syntermedia.ai/support` | -| Privacy policy | `https://syntermedia.ai/privacy` | -| Terms | `https://syntermedia.ai/terms` | +| Support | `https://synterai.com/support` | +| Privacy policy | `https://synterai.com/privacy` | +| Terms | `https://synterai.com/terms` | Suggested long description: @@ -86,8 +100,9 @@ Direct installation is not public-directory discovery. - [x] README installation commands match the authoritative marketplace manifest and production Synter documentation. - [x] `node scripts/validate-manifests.js` passes. -- [x] `npx -y @anthropic-ai/claude-code plugin validate . --strict` prints - `✔ Validation passed` on 2026-09-06. +- [x] `npx -y @anthropic-ai/claude-code@2.1.263 plugin validate . --strict`, + `.claude-plugin/plugin.json`, and `packages/claude-directory` print + `✔ Validation passed` on 2026-11-06. - [x] Production OAuth protected-resource and authorization-server metadata return `200`; a protected tool call returns `401` with a `WWW-Authenticate` resource-metadata challenge. @@ -105,7 +120,7 @@ Direct installation is not public-directory discovery. ## Security and data-use evidence - Claude invokes a Bash session hook that prints static guidance through `cat`. Cursor declares no hook. The repository also contains a manually invoked Node SDK runner and development scripts; no compiled binaries are bundled. -- Claude uses `https://mcp.syntermedia.ai` to match the connector under review. Cursor separately uses `https://mcp.synterai.com`. Both plugin configurations use browser OAuth without static credentials or headers. +- New Claude and Cursor package files use `https://mcp.synterai.com` with browser OAuth and no static credentials or headers. The directory bundle uses `https://mcp.synterai.com/mcp/directory`. The connector submitted on 2026-09-04 remains on `https://mcp.syntermedia.ai`. That pending origin stays as submitted. - The session hook prints a static operating and approval-safety primer into session context; it does not read or transmit credentials. - Advertising writes are approval-gated. The bundled guidance does not turn a @@ -133,9 +148,9 @@ boundary before any external spend-changing action. | Requirement | Evidence | | --- | --- | | Public source and license | Public GitHub repository; MIT `LICENSE` | -| OAuth for authenticated remote MCP | OAuth metadata, DCR, PKCE, and protected-tool `401` challenge at `https://mcp.syntermedia.ai` | -| Tool directory | 34 checked-in tool names; live annotations require a fresh authenticated review | -| Privacy and support | `https://syntermedia.ai/privacy`; `https://syntermedia.ai/support` | +| OAuth for authenticated remote MCP | New packages: OAuth metadata, DCR, PKCE, and a protected-tool `401` at `https://mcp.synterai.com` (directory bundle: `https://mcp.synterai.com/mcp/directory`). Pending connector: the same class of challenge at `https://mcp.syntermedia.ai`, which stays the submitted origin. | +| Tool directory | Full-plugin instruction allowlist: 34 names in `tools/directory-tools.json`. Claude directory bundle: those 34 plus `get_workspaces`, `update_active_workspace`, `google_ads_manage_custom_goals`, `angstrom_verify_output`, `run_gaql_query`, `add_negative_keywords`, `add_keywords`, and `get_ad_readback` (42), in `config/claude-directory/directory-tools.json`. Live annotations still need a fresh authenticated review. | +| Privacy and support | `https://synterai.com/privacy`; `https://synterai.com/support` | | Narrow, visible instructions | Human-readable skills and agents in this repository; no encoded or remotely loaded behavioral instructions | | Approval boundary | Spend-changing operations require explicit approval; a model response is not approval | | Test account | Must be supplied privately by Synter in the submission form | @@ -147,10 +162,13 @@ the directory. ## Provider-side plugin action still required -The remote MCP connector is already in review. Publishing this plugin still -requires an authenticated Synter representative with the required Claude.ai -directory-management access or Console Developer/Admin/Owner role and a -private reviewer test account. Use one of: +The remote MCP connector is already in review at `https://mcp.syntermedia.ai` +(plugin ID `f802a044-fa2c-4a98-8c82-26a2870ca6b3`, submitted 2026-09-04). Do not +replace that origin while Anthropic is reviewing it. Publishing this plugin +still requires an authenticated Synter representative with the required +Claude.ai directory-management access or Console Developer/Admin/Owner role +and a private reviewer test account. This change does not perform that +submission. When an owner later submits the plugin, use one of: - `https://claude.ai/admin-settings/directory/submissions/plugins/new` - `https://platform.claude.com/plugins/submit` diff --git a/README.md b/README.md index 8242c90..be0fe79 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,7 @@ The OpenAI package includes Synter skills and the hosted OAuth MCP connection. Its generated `mcp.json` declares OAuth with dynamic client registration under `mcpServers.synter.extensions.com.openai.auth`; discovery provides the endpoints. The portal displays these settings and does not provide an advanced OAuth editor. -The existing-draft archive is `dist/synter-openai-plugin-1.2.1.zip`, for +The existing-draft archive is `dist/synter-openai-plugin-1.3.0.zip`, for **Synter Ads MCP**. Its package identity remains `app-6a90dc5bbc3c819199b4f1e44028fcbf`. Uploading creates a draft; directory approval and publication are separate steps. This archive contains no lifecycle @@ -25,14 +25,14 @@ MCP app before updating its plugin ZIP,” while its connection settings are unavailable. A valid archive does not resolve that portal state. Verify the saved MCP origin before updating: OpenAI does not allow an origin change between versions. `bash scripts/build-zip.sh --include-new-draft` also prepares -`dist/synter-openai-new-draft-plugin-1.2.1.zip` with the canonical `synter` package +`dist/synter-openai-new-draft-plugin-1.3.0.zip` with the canonical `synter` package name for a separately authorized new draft if the existing identity cannot be recovered. Building it does not upload, register, or publish anything. ### Claude Desktop and Cowork Build the archives with `bash scripts/build-zip.sh`, then use Claude Desktop's -plugin upload to select `dist/synter-claude-plugin-1.2.1.zip`. The archive contains +plugin upload to select `dist/synter-claude-plugin-1.3.0.zip`. The archive contains the `.claude-plugin` manifest, OAuth configuration, skills, agents, and static session primer. Start a new conversation after updating and complete browser OAuth when prompted. Uploading a ZIP does not enable automatic GitHub updates. You can also add @@ -60,12 +60,13 @@ Both plugin configurations use remote HTTP MCP with browser OAuth. They contain | --- | --- | --- | | Cursor | `.cursor-mcp.json`, referenced by `.cursor-plugin/plugin.json` | `https://mcp.synterai.com` | | Claude | `.mcp.json`, discovered by the Claude plugin | `https://mcp.synterai.com` | +| Claude directory bundle | `packages/claude-directory/.mcp.json` | `https://mcp.synterai.com/mcp/directory` | -The portable base `mcp.json` uses the Agent Plugins schema and `streamable-http` transport. The OpenAI build adds its documented server authentication extension; the published portable 1.0.0 schema currently rejects that extension, so validate the base against that schema and the generated vendor settings against the documented contract separately. Claude and Cursor use their own HTTP configuration files. All generated packages connect to the canonical endpoint. Existing OpenAI connections on another origin require a new plugin or support-assisted recovery, not a blind endpoint replacement. For another remote MCP client, use its browser OAuth flow with the appropriate hosted URL. If sign-in fails, reconnect through the client’s settings or contact [support](https://synterai.com/contact). +The portable base `mcp.json` uses the Agent Plugins schema and `streamable-http` transport. The OpenAI build adds its documented server authentication extension; the published portable 1.0.0 schema currently rejects that extension, so validate the base against that schema and the generated vendor settings against the documented contract separately. Claude and Cursor use their own HTTP configuration files. New Claude, Cursor, and portable packages connect to `https://mcp.synterai.com`. The directory bundle uses the curated profile at `https://mcp.synterai.com/mcp/directory`. `https://mcp.syntermedia.ai` remains the live origin of the connector submission already in review; new package files do not use it, and this repository does not redirect that host. Existing OpenAI connections on another origin require a new plugin or support-assisted recovery, not a blind endpoint replacement. For another remote MCP client, use its browser OAuth flow with the appropriate hosted URL. If sign-in fails, reconnect through the client’s settings or contact [support](https://synterai.com/contact). ## What this plugin runs -The plugin connects to the hosted Synter MCP server over OAuth. The advertising tools run on that server. Local Markdown skills, agents, and rules guide how the client uses them; the checked-in [tool directory](tools/directory-tools.json) contains the 34 supported tool names. +The plugin connects to the hosted Synter MCP server over OAuth. The advertising tools run on that server. Local Markdown skills, agents, and rules guide how the client uses them; the checked-in [tool directory](tools/directory-tools.json) is the 34-name instruction allowlist for this full plugin. The Claude directory bundle ships a separate 42-name list, [config/claude-directory/directory-tools.json](config/claude-directory/directory-tools.json): those 34 names plus `get_workspaces`, `update_active_workspace`, `google_ads_manage_custom_goals`, `angstrom_verify_output`, `run_gaql_query`, `add_negative_keywords`, `add_keywords`, and `get_ad_readback`. Claude also runs one `SessionStart` hook from [.claude-plugin/plugin.json](.claude-plugin/plugin.json). It invokes [scripts/session-context.sh](scripts/session-context.sh), a Bash script that uses `cat` to print static account-scope and approval guidance. It does not read credentials or make network requests. Cursor declares no hooks and uses [rules/synter-operator.mdc](rules/synter-operator.mdc). @@ -106,6 +107,7 @@ Text ads use `create_ad_copy`; existing assets use `list_creative_assets`. The p ```bash node scripts/validate-manifests.js node scripts/check-directory-tools.js +node scripts/check-skill-tools.mjs node --test scripts/*.test.js python3 -m unittest discover -s scripts -p 'test_*.py' -v npx -y @anthropic-ai/claude-code@2.1.263 plugin validate . --strict @@ -114,7 +116,7 @@ bash scripts/build-zip.sh The directory check scans every file under `skills/`, `commands/` (when present), `rules/`, and `agents/`, including prose, tables, and code fences. Spell out exact tool names; dynamic tool-name templates fail validation. Snake-case data fields are recognized separately, but calling them as functions still counts as a tool reference. For a tool name without underscores, use explicit `tool:name` or its MCP-qualified name. -The check runs offline in CI. To also compare the directory against live MCP `tools/list`, supply an OAuth access token through `SYNTER_MCP_TOKEN` in your environment and run the same script. It initializes an MCP session and follows paginated results. `--live` requires the token instead of silently running offline. `SYNTER_MCP_URL` optionally selects either hosted URL in the table; it defaults to the Cursor endpoint. The token is for this development check only and is never written to plugin configuration. Extra live tools do not expand the checked-in directory. +The check runs offline in CI. To also compare the directory against live MCP `tools/list`, supply an OAuth access token through `SYNTER_MCP_TOKEN` in your environment and run the same script. It initializes an MCP session and follows paginated results. `--live` requires the token instead of silently running offline. If set, `SYNTER_MCP_URL` must be an allow-listed endpoint: `https://mcp.synterai.com` (the default for new packages), `https://mcp.synterai.com/mcp/directory` (the curated directory profile), or `https://mcp.syntermedia.ai` (the live origin of the pending connector submission, for a check only). Untrusted endpoints are rejected. The token is for this development check only and is never written to plugin configuration. Extra live tools do not expand the checked-in directory. [Terms](https://synterai.com/terms) · [MIT license](LICENSE) diff --git a/SECURITY.md b/SECURITY.md index fdaddff..3ab2597 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -6,7 +6,7 @@ Email **joel@synterai.com** with the subject "Security: Synter plugin". Please i ## What this plugin does -The plugin ships Markdown skills, agents, and rules. ChatGPT, Codex, Claude, and Cursor connect to `https://mcp.synterai.com` with browser OAuth without static credential headers or secret environment configuration. +The plugin ships Markdown skills, agents, and rules. ChatGPT, Codex, Claude, and Cursor connect to `https://mcp.synterai.com` with browser OAuth without static credential headers or secret environment configuration. The Claude directory bundle uses `https://mcp.synterai.com/mcp/directory`. The connector already in review still uses `https://mcp.syntermedia.ai`, which remains live. Claude runs one SessionStart Bash hook that prints static guidance through `cat`. It does not read credentials or make network requests. Cursor declares no executable hooks. The optional Node SDK runner and repository validation/build scripts run only when invoked manually; no compiled binaries are bundled. diff --git a/assets/logo-opaque-512.png b/assets/logo-opaque-512.png new file mode 100644 index 0000000..0989bc9 Binary files /dev/null and b/assets/logo-opaque-512.png differ diff --git a/assets/logo-opaque.png b/assets/logo-opaque.png new file mode 100644 index 0000000..3d4fcac Binary files /dev/null and b/assets/logo-opaque.png differ diff --git a/config/claude-directory/README.md b/config/claude-directory/README.md index dfae0cd..13329e5 100644 --- a/config/claude-directory/README.md +++ b/config/claude-directory/README.md @@ -1,8 +1,8 @@ # Synter -Synter helps you review advertising performance, prepare campaign plans, write ad copy, and approve changes through its hosted MCP service. Start with the quickstart skill, sign in through the browser OAuth prompt, and verify the connected workspace and advertising account before using account data. +Synter executes approval-gated advertising campaigns on 30+ ad platforms. This plugin helps you review performance, prepare campaign plans, write ad copy, and approve changes through Synter's hosted MCP service. Start with the quickstart skill, sign in through the browser OAuth prompt, and verify the connected workspace and advertising account before using account data. -This directory package includes 56 Markdown skills, six agent instructions, an output style, and static [brand and safety guidance](context/brand-and-safety.md). Its only service connection is the remote HTTPS MCP server declared in `.mcp.json`. It contains no local lifecycle hooks, executable scripts, or SDK runner. Tool availability follows the bundled [tool directory](tools/directory-tools.json) and the live server schema. +This directory package includes 56 Markdown skills, six agent instructions, an output style, and static [brand and safety guidance](context/brand-and-safety.md). Its only service connection is the remote HTTPS MCP server declared in `.mcp.json` (`https://mcp.synterai.com/mcp/directory`, the curated directory profile). It contains no local lifecycle hooks, executable scripts, or SDK runner. Tool availability follows the bundled [tool directory](tools/directory-tools.json), which lists the 42-tool curated surface, and the live server schema. Read-only account lookups and reports can run directly. Before any campaign creation, activation, pause, budget adjustment, or other spend-changing action, review the proposed account, scope, and amounts and give explicit approval. After execution, check the provider readback before treating a change as complete. Use the verified advertiser's brand and original assets; do not substitute Synter's branding for another advertiser. @@ -17,4 +17,18 @@ flowchart LR Tool arguments and account results pass through Synter's hosted service and the connected advertising provider. Never paste passwords, API keys, or access tokens into chat. Sample data must be identified as sample data; missing account access or unavailable metrics must be reported plainly. Read [Synter's privacy policy](https://synterai.com/privacy) for data handling and [terms](https://synterai.com/terms) for service conditions. -For help, use the help skill or [contact Synter](https://synterai.com/contact). This folder is generated from reviewed repository sources and is intended for the Claude directory submission path `packages/claude-directory`. Directory approval and publication are separate from local package validation. The source is distributed under the included MIT license. +## Install + +In Claude Code, add Synter's marketplace and install the plugin, then complete the browser OAuth prompt: + +```text +/plugin install synter --marketplace Synter-Media-AI/plugin +``` + +## Pricing + +Current prices are on the [Synter pricing page](https://synterai.com/pricing). You need a Synter account at [synterai.com](https://synterai.com) and at least one connected advertising account. Campaign changes require your approval. + +## Support and security + +For help, use the help skill, see [Synter support](https://synterai.com/support), or email support@syntermedia.ai. Report security issues to security@synterai.com. This folder is generated from reviewed repository sources and is intended for the Claude directory submission path `packages/claude-directory`. Directory approval and publication are separate from local package validation. The source is distributed under the included MIT license. diff --git a/config/claude-directory/directory-tools.json b/config/claude-directory/directory-tools.json new file mode 100644 index 0000000..0c1e9ea --- /dev/null +++ b/config/claude-directory/directory-tools.json @@ -0,0 +1,44 @@ +[ + "get_connection_status", + "list_connected_accounts", + "verify_platform_accounts", + "list_campaigns", + "pull_google_ads_performance", + "pull_meta_ads_performance", + "pull_linkedin_ads_performance", + "pull_microsoft_ads_performance", + "pull_reddit_ads_performance", + "ga4_get_properties", + "ga4_get_report", + "ga4_get_conversions", + "get_attribution", + "get_spend_reconciliation", + "get_pixel_health", + "measure_incrementality", + "audit_account_structure", + "research_campaign_opportunity", + "forecast_campaign", + "optimize_budget", + "create_ad_copy", + "list_audiences", + "list_creative_assets", + "create_campaign_plan", + "get_campaign_plan", + "upsert_plan_entity", + "run_launch_preflight", + "approve_campaign_plan", + "execute_campaign_plan", + "get_plan_execution", + "enable_campaign", + "pause_campaign", + "update_campaign_budget", + "get_job_status", + "get_workspaces", + "update_active_workspace", + "google_ads_manage_custom_goals", + "angstrom_verify_output", + "run_gaql_query", + "add_negative_keywords", + "add_keywords", + "get_ad_readback" +] diff --git a/packages/claude-directory/.claude-plugin/plugin.json b/packages/claude-directory/.claude-plugin/plugin.json index 8004b46..3b68b87 100644 --- a/packages/claude-directory/.claude-plugin/plugin.json +++ b/packages/claude-directory/.claude-plugin/plugin.json @@ -2,8 +2,8 @@ "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json", "name": "synter", "displayName": "Synter", - "description": "Plan and operate advertising campaigns through Synter’s hosted MCP server over OAuth. Review performance, write ad copy, and approve campaign changes before execution.", - "version": "1.2.1", + "description": "Plan and operate advertising campaigns on 30+ ad platforms through Synter’s hosted MCP server over OAuth. Review performance, write ad copy, and approve campaign changes before execution.", + "version": "1.3.0", "license": "MIT", "author": { "name": "Synter", diff --git a/packages/claude-directory/.mcp.json b/packages/claude-directory/.mcp.json index c3ae094..6b8ae39 100644 --- a/packages/claude-directory/.mcp.json +++ b/packages/claude-directory/.mcp.json @@ -2,8 +2,8 @@ "mcpServers": { "synter": { "type": "http", - "url": "https://mcp.synterai.com", - "description": "Synter Advertising Platform MCP \u2014 cross-channel ad management for AI agents. Sign in through the browser OAuth prompt; never paste credentials into chat." + "url": "https://mcp.synterai.com/mcp/directory", + "description": "Synter Advertising Platform MCP: cross-channel ad reporting and management for AI agents. Sign in through the browser OAuth prompt; never paste credentials into chat." } } } diff --git a/packages/claude-directory/README.md b/packages/claude-directory/README.md index dfae0cd..13329e5 100644 --- a/packages/claude-directory/README.md +++ b/packages/claude-directory/README.md @@ -1,8 +1,8 @@ # Synter -Synter helps you review advertising performance, prepare campaign plans, write ad copy, and approve changes through its hosted MCP service. Start with the quickstart skill, sign in through the browser OAuth prompt, and verify the connected workspace and advertising account before using account data. +Synter executes approval-gated advertising campaigns on 30+ ad platforms. This plugin helps you review performance, prepare campaign plans, write ad copy, and approve changes through Synter's hosted MCP service. Start with the quickstart skill, sign in through the browser OAuth prompt, and verify the connected workspace and advertising account before using account data. -This directory package includes 56 Markdown skills, six agent instructions, an output style, and static [brand and safety guidance](context/brand-and-safety.md). Its only service connection is the remote HTTPS MCP server declared in `.mcp.json`. It contains no local lifecycle hooks, executable scripts, or SDK runner. Tool availability follows the bundled [tool directory](tools/directory-tools.json) and the live server schema. +This directory package includes 56 Markdown skills, six agent instructions, an output style, and static [brand and safety guidance](context/brand-and-safety.md). Its only service connection is the remote HTTPS MCP server declared in `.mcp.json` (`https://mcp.synterai.com/mcp/directory`, the curated directory profile). It contains no local lifecycle hooks, executable scripts, or SDK runner. Tool availability follows the bundled [tool directory](tools/directory-tools.json), which lists the 42-tool curated surface, and the live server schema. Read-only account lookups and reports can run directly. Before any campaign creation, activation, pause, budget adjustment, or other spend-changing action, review the proposed account, scope, and amounts and give explicit approval. After execution, check the provider readback before treating a change as complete. Use the verified advertiser's brand and original assets; do not substitute Synter's branding for another advertiser. @@ -17,4 +17,18 @@ flowchart LR Tool arguments and account results pass through Synter's hosted service and the connected advertising provider. Never paste passwords, API keys, or access tokens into chat. Sample data must be identified as sample data; missing account access or unavailable metrics must be reported plainly. Read [Synter's privacy policy](https://synterai.com/privacy) for data handling and [terms](https://synterai.com/terms) for service conditions. -For help, use the help skill or [contact Synter](https://synterai.com/contact). This folder is generated from reviewed repository sources and is intended for the Claude directory submission path `packages/claude-directory`. Directory approval and publication are separate from local package validation. The source is distributed under the included MIT license. +## Install + +In Claude Code, add Synter's marketplace and install the plugin, then complete the browser OAuth prompt: + +```text +/plugin install synter --marketplace Synter-Media-AI/plugin +``` + +## Pricing + +Current prices are on the [Synter pricing page](https://synterai.com/pricing). You need a Synter account at [synterai.com](https://synterai.com) and at least one connected advertising account. Campaign changes require your approval. + +## Support and security + +For help, use the help skill, see [Synter support](https://synterai.com/support), or email support@syntermedia.ai. Report security issues to security@synterai.com. This folder is generated from reviewed repository sources and is intended for the Claude directory submission path `packages/claude-directory`. Directory approval and publication are separate from local package validation. The source is distributed under the included MIT license. diff --git a/packages/claude-directory/tools/directory-tools.json b/packages/claude-directory/tools/directory-tools.json index d84d815..0c1e9ea 100644 --- a/packages/claude-directory/tools/directory-tools.json +++ b/packages/claude-directory/tools/directory-tools.json @@ -32,5 +32,13 @@ "enable_campaign", "pause_campaign", "update_campaign_budget", - "get_job_status" + "get_job_status", + "get_workspaces", + "update_active_workspace", + "google_ads_manage_custom_goals", + "angstrom_verify_output", + "run_gaql_query", + "add_negative_keywords", + "add_keywords", + "get_ad_readback" ] diff --git a/plugin.json b/plugin.json index 5f165a0..4b41708 100644 --- a/plugin.json +++ b/plugin.json @@ -1,7 +1,7 @@ { "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", "name": "synter", - "version": "1.2.1", + "version": "1.3.0", "description": "Plan and operate advertising campaigns through Synter’s hosted MCP server over OAuth. Review performance, write ad copy, and approve campaign changes before execution.", "author": { "name": "Synter", @@ -30,7 +30,7 @@ "interface": { "displayName": "Synter", "shortDescription": "Manage advertising campaigns", - "longDescription": "Connect your Synter workspace to review advertising performance, write ad copy, and prepare campaign plans. Synter uses accounts you have connected and authorized. Account changes and spending require your approval. Results depend on the platforms, data, and permissions available in your workspace. A Synter account and authorized advertising accounts are required.", + "longDescription": "Connect your Synter workspace to review advertising performance, write ad copy, and prepare campaign plans across 30+ ad platforms. Synter uses accounts you have connected and authorized. Account changes and spending require your approval. Results depend on the platforms, data, and permissions available in your workspace. A Synter account and authorized advertising accounts are required.", "developerName": "Synter", "category": "Productivity", "capabilities": [ diff --git a/scripts/build-packages.py b/scripts/build-packages.py index e835688..0711f30 100644 --- a/scripts/build-packages.py +++ b/scripts/build-packages.py @@ -15,6 +15,23 @@ # schema does not yet accept server extensions. Keep the base independent. OPENAI_AUTH = {'type': 'oauth', 'client': {'mode': 'dcr'}} +# Curated Claude directory profile. Root Claude, Cursor, and portable configs +# stay on https://mcp.synterai.com. The connector already in review remains on +# https://mcp.syntermedia.ai; this package URL does not retarget that submission. +DIRECTORY_MCP_URL = 'https://mcp.synterai.com/mcp/directory' +# Submission-packet additions to the 34-name full-plugin instruction allowlist. +# Together they are the 42-tool curated surface for mcp_directory_client. +DIRECTORY_EXTRA_TOOLS = ( + 'get_workspaces', + 'update_active_workspace', + 'google_ads_manage_custom_goals', + 'angstrom_verify_output', + 'run_gaql_query', + 'add_negative_keywords', + 'add_keywords', + 'get_ad_readback', +) + def validate_openai_mcp(value): base = json.loads((ROOT / 'mcp.json').read_text()) @@ -28,6 +45,20 @@ def encoded(value): return (json.dumps(value, indent=2, ensure_ascii=False) + '\n').encode() +def curated_directory_tools(root): + """42-tool directory surface: the full-plugin 34 plus the packet's eight.""" + base = json.loads((root / 'tools/directory-tools.json').read_text()) + curated_path = root / 'config/claude-directory/directory-tools.json' + curated = json.loads(curated_path.read_text()) + expected = list(base) + list(DIRECTORY_EXTRA_TOOLS) + if base != list(dict.fromkeys(base)) or len(base) != 34 or curated != expected: + raise ValueError( + 'Directory tool list must be the 34-name full-plugin allowlist plus ' + 'the eight submission-packet tools' + ) + return curated + + def collect(root, target): manifest = json.loads((root / '.claude-plugin/plugin.json').read_text()) version = manifest['version'] @@ -56,8 +87,12 @@ def include(relative): include('scripts/session-context.sh') elif target == 'claude-directory': manifest.pop('hooks', None) + manifest.pop('privacyPolicyUrl', None) files['.claude-plugin/plugin.json'] = encoded(manifest) - include('.mcp.json') + directory_mcp = json.loads((root / '.mcp.json').read_text()) + directory_mcp['mcpServers']['synter']['url'] = DIRECTORY_MCP_URL + files['.mcp.json'] = encoded(directory_mcp) + files['tools/directory-tools.json'] = encoded(curated_directory_tools(root)) for source, destination in [('README.md', 'README.md'), ('help.md', 'skills/help/SKILL.md')]: path = root / 'config/claude-directory' / source relative_path = path.relative_to(root) @@ -102,17 +137,25 @@ def validate_claude_directory(files): manifest = json.loads(files['.claude-plugin/plugin.json']) if 'hooks' in manifest: raise ValueError('Directory manifest must not declare hooks') + if 'privacyPolicyUrl' in manifest: + raise ValueError('Directory manifest must not declare privacyPolicyUrl; provide in listing form') if set(manifest) - {'$schema', 'name', 'displayName', 'description', 'version', 'license', 'author', 'homepage', 'repository', 'keywords'}: raise ValueError('Unreviewed directory manifest capability') servers = json.loads(files['.mcp.json']).get('mcpServers', {}) if (set(servers) != {'synter'} or set(servers['synter']) != {'type', 'url', 'description'} or servers['synter']['type'] != 'http' - or servers['synter']['url'] != 'https://mcp.synterai.com' + or servers['synter']['url'] != DIRECTORY_MCP_URL or not isinstance(servers['synter']['description'], str)): raise ValueError('Directory supports only the declared remote HTTPS MCP server') if len(files['README.md'].decode().split()) < 40: raise ValueError('Directory README must explain the product') + directory_tools = json.loads(files['tools/directory-tools.json']) + if directory_tools != curated_directory_tools(ROOT): + raise ValueError('Directory bundle must ship the 42-tool curated surface') + readme = files['README.md'].decode() + if re.search(r'\$\s?\d|\bSolo\b', readme): + raise ValueError('Directory listing must not state plan prices') def sync_claude_directory(root=ROOT, check=True): diff --git a/scripts/check-directory-tools.js b/scripts/check-directory-tools.js index b7aee51..ea9aeaf 100644 --- a/scripts/check-directory-tools.js +++ b/scripts/check-directory-tools.js @@ -15,7 +15,14 @@ const DATA_IDENTIFIERS = new Set([ ]); const ROOT = path.resolve(__dirname, '..'); const SURFACES = ['skills', 'commands', 'rules', 'agents']; -const ENDPOINTS = new Set(['https://mcp.synterai.com', 'https://mcp.syntermedia.ai']); +// New packages use mcp.synterai.com. /mcp/directory is the curated directory +// profile. mcp.syntermedia.ai stays allow-listed so a reviewer can still check +// the pending connector origin; it is not written into new package files. +const ENDPOINTS = new Set([ + 'https://mcp.synterai.com', + 'https://mcp.synterai.com/mcp/directory', + 'https://mcp.syntermedia.ai', +]); function extractReferences(source) { const refs = []; @@ -49,6 +56,30 @@ function listFiles(dir) { }); } +// Eight tools the 34-name full-plugin file omits. The directory bundle lists both. +const DIRECTORY_EXTRAS = [ + 'get_workspaces', + 'update_active_workspace', + 'google_ads_manage_custom_goals', + 'angstrom_verify_output', + 'run_gaql_query', + 'add_negative_keywords', + 'add_keywords', + 'get_ad_readback', +]; + +function assertCuratedDirectoryTools(root = ROOT) { + const curatedPath = path.join(root, 'config/claude-directory/directory-tools.json'); + if (!fs.existsSync(curatedPath)) return null; + const base = JSON.parse(fs.readFileSync(path.join(root, 'tools/directory-tools.json'), 'utf8')); + const curated = JSON.parse(fs.readFileSync(curatedPath, 'utf8')); + const expected = base.concat(DIRECTORY_EXTRAS); + if (JSON.stringify(curated) !== JSON.stringify(expected)) { + throw new Error('config/claude-directory/directory-tools.json must be the 34-tool full-plugin allowlist plus the eight submission-packet tools.'); + } + return new Set(curated); +} + function readAllowlist(root) { const names = JSON.parse(fs.readFileSync(path.join(root, 'tools/directory-tools.json'), 'utf8')); if (!Array.isArray(names) || names.length !== 34 || new Set(names).size !== 34 || @@ -75,7 +106,7 @@ function scan(root = ROOT) { async function readLiveTools({ token, url = 'https://mcp.synterai.com', fetchImpl = fetch }) { if (!token) throw new Error('Live check requires SYNTER_MCP_TOKEN (an OAuth access token).'); - if (!ENDPOINTS.has(url)) throw new Error('Live check URL must be one of the two production Synter MCP endpoints.'); + if (!ENDPOINTS.has(url)) throw new Error('Live check URL must be an allow-listed production Synter MCP endpoint.'); let session; let protocol = '2025-03-26'; let requestId = 0; @@ -149,18 +180,23 @@ async function readLiveTools({ token, url = 'https://mcp.synterai.com', fetchImp async function main() { const args = process.argv.slice(2); if (args.some(arg => arg !== '--live')) throw new Error('Usage: node scripts/check-directory-tools.js [--live]'); + const curated = assertCuratedDirectoryTools(); const result = scan(); if (result.errors.length) throw new Error(result.errors.join('\n')); + const liveUrl = process.env.SYNTER_MCP_URL; if (args.includes('--live') || process.env.SYNTER_MCP_TOKEN) { - const live = await readLiveTools({ token: process.env.SYNTER_MCP_TOKEN, url: process.env.SYNTER_MCP_URL }); - const missing = [...result.allowed].filter(name => !live.has(name)); + const expectCurated = liveUrl === 'https://mcp.synterai.com/mcp/directory'; + const allowed = expectCurated && curated ? curated : result.allowed; + const live = await readLiveTools({ token: process.env.SYNTER_MCP_TOKEN, url: liveUrl }); + const missing = [...allowed].filter(name => !live.has(name)); if (missing.length) throw new Error(`Live server is missing directory tools: ${missing.join(', ')}`); - console.log(`Live tools/list contains all ${result.allowed.size} directory tools.`); + console.log(`Live tools/list contains all ${allowed.size} directory tools.`); } - console.log(`Checked ${result.fileCount} instruction files: ${result.references.size} referenced tools, all in the ${result.allowed.size}-tool directory.`); + const curatedCount = curated ? curated.size : 0; + console.log(`Checked ${result.fileCount} instruction files: ${result.references.size} referenced tools, all in the ${result.allowed.size}-tool full-plugin allowlist. Curated directory surface: ${curatedCount} tools.`); } -module.exports = { extractReferences, scan, readLiveTools }; +module.exports = { extractReferences, scan, readLiveTools, assertCuratedDirectoryTools, DIRECTORY_EXTRAS }; if (require.main === module) main().catch(error => { // Mask the OAuth token even if a lower-level library includes it in an error. const message = process.env.SYNTER_MCP_TOKEN diff --git a/scripts/check-directory-tools.test.js b/scripts/check-directory-tools.test.js index 7ea0295..f7a62e1 100644 --- a/scripts/check-directory-tools.test.js +++ b/scripts/check-directory-tools.test.js @@ -5,7 +5,7 @@ const fs = require('node:fs'); const os = require('node:os'); const path = require('node:path'); const { spawnSync } = require('node:child_process'); -const { extractReferences, scan, readLiveTools } = require('./check-directory-tools'); +const { extractReferences, scan, readLiveTools, assertCuratedDirectoryTools, DIRECTORY_EXTRAS } = require('./check-directory-tools'); test('extracts tools from prose, tables, functions, fences, and MCP qualification', () => { const source = [ @@ -112,3 +112,12 @@ test('live check rejects malformed results and looping cursors', async () => { await assert.rejects(readLiveTools({ token: 'secret', fetchImpl }), /missing tools|repeated pagination|JSON-RPC response|duplicate tool/); } }); + +test('curated directory surface is the 34-tool allowlist plus the packet eight', () => { + const curated = assertCuratedDirectoryTools(); + assert.equal(curated.size, 42); + for (const name of DIRECTORY_EXTRAS) assert.equal(curated.has(name), true); + const base = JSON.parse(fs.readFileSync(path.join(__dirname, '../tools/directory-tools.json'), 'utf8')); + assert.equal(base.length, 34); + for (const name of base) assert.equal(curated.has(name), true); +}); diff --git a/scripts/check-skill-tools.mjs b/scripts/check-skill-tools.mjs new file mode 100755 index 0000000..91c94b6 --- /dev/null +++ b/scripts/check-skill-tools.mjs @@ -0,0 +1,140 @@ +#!/usr/bin/env node +import fs from 'node:fs'; +import path from 'node:path'; +import { fileURLToPath } from 'node:url'; + +const __dirname = path.dirname(fileURLToPath(import.meta.url)); +const ROOT = path.resolve(__dirname, '..'); + +// Data identifiers, URL parameters, cookie fields, and platform taxonomy tags +// that appear in snake_case in skills documentation but are not MCP tools. +export const DATA_IDENTIFIERS = new Set([ + 'ad_personalization', 'ad_storage', 'ad_user_data', 'analytics_storage', + 'conversion_id', 'custom_label', 'event_id', 'google_product_category', + 'identifier_exists', 'li_fat_id', 'openai_ads', 'order_id', 'paid_social', + 'product_type', 'rdt_cid', 'sale_price', 'transaction_id', 'utm_campaign', + 'utm_content', 'utm_medium', 'utm_source', 'utm_term', + '_fbc', '_fbp', '_rdt_uuid', +]); + +export function loadAllowlist(allowlistPath = path.join(ROOT, 'scripts/hosted-tools.json')) { + if (!fs.existsSync(allowlistPath)) { + throw new Error(`Allowlist file not found: ${allowlistPath}`); + } + const content = JSON.parse(fs.readFileSync(allowlistPath, 'utf8')); + if (!Array.isArray(content) || content.length === 0) { + throw new Error(`Invalid allowlist file: ${allowlistPath}`); + } + return new Set(content); +} + +export function extractToolReferences(content) { + const refs = []; + const lines = content.split(/\r?\n/); + lines.forEach((line, index) => { + const names = new Set(); + // Match explicit syntax: mcp__synter__ or tool: + for (const match of line.matchAll(/\bmcp__[a-zA-Z0-9_-]+?__([a-zA-Z0-9_-]+)|\btool:([a-zA-Z0-9_-]+)/g)) { + names.add(match[1] || match[2]); + } + // Clean explicit MCP calls, URLs, link destinations, HTML tags/comments, and file names with extensions + // to avoid false positives from snake_case paths/URLs/files. + const clean = line + .replace(/\bmcp__[a-zA-Z0-9_-]+?__[a-zA-Z0-9_-]+/g, '') + .replace(//g, '') + .replace(/<[a-zA-Z][^>]*>/g, '') + .replace(/https?:\/\/[^\s\)]+/g, '') + .replace(/\]\([^\)]*\)/g, ']') + .replace(/\b[a-zA-Z0-9_.-]+\.(?:md|json|png|jpg|jpeg|gif|svg|webp|js|mjs|ts|py|sh|yml|yaml|css|html)\b/g, ''); + + // Match snake_case identifiers (bare in prose, backticks, bullet lists, tables, etc.) + for (const match of clean.matchAll(/\b[a-z][a-z0-9]*(?:_[a-z0-9]+)+\b/g)) { + const name = match[0]; + const invoked = /^(?:\s*\(|`\()/.test(clean.slice(match.index + name.length)); + if (!DATA_IDENTIFIERS.has(name) || invoked) { + names.add(name); + } + } + // Dynamic tool templates cannot be verified against an exact-name allowlist. + if (/\b(?:[a-z]+_)*(?:<[^>]+>|\*)_[a-z_]+\b|\b[a-z]+_\*/.test(line)) { + names.add('[dynamic tool template: spell out exact tool names]'); + } + for (const name of names) { + refs.push({ name, line: index + 1 }); + } + }); + return refs; +} + +export function findSkillFiles(dir) { + if (!fs.existsSync(dir)) return []; + const entries = fs.readdirSync(dir, { withFileTypes: true }); + const files = []; + for (const entry of entries) { + const fullPath = path.join(dir, entry.name); + if (entry.isDirectory()) { + files.push(...findSkillFiles(fullPath)); + } else if (entry.isFile() && entry.name.endsWith('.md')) { + files.push(fullPath); + } + } + return files; +} + +export function checkSkillTools({ root = ROOT, allowlistPath } = {}) { + const allowed = loadAllowlist(allowlistPath); + const skillDirs = [ + path.join(root, 'skills'), + path.join(root, 'packages/claude-directory/skills'), + ].filter(d => fs.existsSync(d)); + + const skillFiles = skillDirs.flatMap(d => findSkillFiles(d)); + const helpFile = path.join(root, 'config/claude-directory/help.md'); + if (fs.existsSync(helpFile) && !skillFiles.includes(helpFile)) { + skillFiles.push(helpFile); + } + + if (skillFiles.length === 0) { + throw new Error('No skill files found to check.'); + } + + const errors = []; + let checkedRefs = 0; + + for (const file of skillFiles) { + const content = fs.readFileSync(file, 'utf8'); + const relPath = path.relative(root, file); + const refs = extractToolReferences(content); + for (const ref of refs) { + checkedRefs++; + if (!allowed.has(ref.name)) { + errors.push(`${relPath}:${ref.line}: referenced tool \`${ref.name}\` is not in scripts/hosted-tools.json`); + } + } + } + + return { errors, skillCount: skillFiles.length, checkedRefs, allowedCount: allowed.size }; +} + +export function main() { + const result = checkSkillTools(); + if (result.errors.length > 0) { + console.error(`Found ${result.errors.length} unapproved tool reference(s):`); + for (const err of result.errors) { + console.error(` ${err}`); + } + process.exitCode = 1; + return; + } + console.log(`Checked ${result.skillCount} skill files (${result.checkedRefs} tool references): all exist in scripts/hosted-tools.json (${result.allowedCount} hosted tools).`); +} + +try { + if (process.argv[1] && fs.realpathSync(process.argv[1]) === fileURLToPath(import.meta.url)) { + main(); + } +} catch { + if (process.argv[1] === fileURLToPath(import.meta.url)) { + main(); + } +} diff --git a/scripts/check-skill-tools.test.js b/scripts/check-skill-tools.test.js new file mode 100644 index 0000000..2360552 --- /dev/null +++ b/scripts/check-skill-tools.test.js @@ -0,0 +1,241 @@ +'use strict'; +const { test } = require('node:test'); +const assert = require('node:assert/strict'); +const fs = require('node:fs'); +const os = require('node:os'); +const path = require('node:path'); +const { spawnSync } = require('node:child_process'); + +test('check-skill-tools.mjs passes on current repository skills and hosted-tools.json', async () => { + const script = path.join(__dirname, 'check-skill-tools.mjs'); + const result = spawnSync(process.execPath, [script], { encoding: 'utf8' }); + assert.equal(result.status, 0, result.stderr); + assert.match(result.stdout, /Checked \d+ skill files/); + assert.match(result.stdout, /304 hosted tools/); +}); + +test('check-skill-tools.mjs fails when a skill references an unlisted tool', async () => { + const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'skill-tools-test-')); + try { + fs.mkdirSync(path.join(tmpDir, 'scripts'), { recursive: true }); + fs.mkdirSync(path.join(tmpDir, 'skills/demo'), { recursive: true }); + + // Copy allowlist + fs.copyFileSync( + path.join(__dirname, 'hosted-tools.json'), + path.join(tmpDir, 'scripts/hosted-tools.json') + ); + // Copy script + fs.copyFileSync( + path.join(__dirname, 'check-skill-tools.mjs'), + path.join(tmpDir, 'scripts/check-skill-tools.mjs') + ); + + // Write a skill with an invalid tool + fs.writeFileSync( + path.join(tmpDir, 'skills/demo/SKILL.md'), + '---\nname: demo\ndescription: demo\n---\nCall `unlisted_fake_tool` to do things.\n' + ); + + const result = spawnSync( + process.execPath, + [path.join(tmpDir, 'scripts/check-skill-tools.mjs')], + { cwd: tmpDir, encoding: 'utf8' } + ); + assert.equal(result.status, 1); + assert.match(result.stderr, /referenced tool `unlisted_fake_tool` is not in scripts\/hosted-tools\.json/); + } finally { + fs.rmSync(tmpDir, { recursive: true, force: true }); + } +}); + +test('check-skill-tools.mjs ignores data identifiers in skills', async () => { + const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'skill-tools-test-')); + try { + fs.mkdirSync(path.join(tmpDir, 'scripts'), { recursive: true }); + fs.mkdirSync(path.join(tmpDir, 'skills/demo'), { recursive: true }); + + fs.copyFileSync( + path.join(__dirname, 'hosted-tools.json'), + path.join(tmpDir, 'scripts/hosted-tools.json') + ); + fs.copyFileSync( + path.join(__dirname, 'check-skill-tools.mjs'), + path.join(tmpDir, 'scripts/check-skill-tools.mjs') + ); + + // Write a skill with allowed tool and data identifiers + fs.writeFileSync( + path.join(tmpDir, 'skills/demo/SKILL.md'), + '---\nname: demo\ndescription: demo\n---\nCheck `list_connected_accounts` with `utm_source`, `utm_medium`, and `event_id`.\n' + ); + + const result = spawnSync( + process.execPath, + [path.join(tmpDir, 'scripts/check-skill-tools.mjs')], + { cwd: tmpDir, encoding: 'utf8' } + ); + assert.equal(result.status, 0, result.stderr); + assert.match(result.stdout, /Checked 1 skill files/); + } finally { + fs.rmSync(tmpDir, { recursive: true, force: true }); + } +}); + +test('extractToolReferences detects unquoted, list, backtick, and explicit tool references', async () => { + const { extractToolReferences } = await import('./check-skill-tools.mjs'); + const content = [ + 'Call list_campaigns before pause_campaign.', + '- list_connected_accounts: verify platforms', + 'Run `pull_meta_ads_performance(days=30, level="ad-set")` for detail.', + 'Use tool:optimize_budget and mcp__synter__get_attribution.', + ].join('\n'); + const refs = extractToolReferences(content); + assert.deepEqual(refs, [ + { name: 'list_campaigns', line: 1 }, + { name: 'pause_campaign', line: 1 }, + { name: 'list_connected_accounts', line: 2 }, + { name: 'pull_meta_ads_performance', line: 3 }, + { name: 'optimize_budget', line: 4 }, + { name: 'get_attribution', line: 4 }, + ]); +}); + +test('extractToolReferences ignores data identifiers unless invoked, and avoids false positives for URLs and files', async () => { + const { extractToolReferences } = await import('./check-skill-tools.mjs'); + const content = [ + 'Use `utm_source`, `utm_medium`, and `event_id` fields.', + 'Call event_id() as a function.', + 'Visit https://synterai.com/privacy_policy and https://synterai.com/terms_of_service.', + 'See rules/brand_safety.md and assets/logo_opaque.png for guidelines.', + 'Read [campaign documentation](docs/campaign_guide.md) or [list_campaigns](docs/list_campaigns.md).', + '', + ].join('\n'); + const refs = extractToolReferences(content); + assert.deepEqual(refs, [ + { name: 'event_id', line: 2 }, + { name: 'list_campaigns', line: 5 }, + ]); +}); + +test('extractToolReferences fails closed on dynamic tool templates', async () => { + const { extractToolReferences } = await import('./check-skill-tools.mjs'); + const content = [ + 'Use `pull__ads_performance` to fetch data.', + 'Run `get_*` for all metrics.', + ].join('\n'); + const refs = extractToolReferences(content); + assert.equal(refs.length, 2); + assert.match(refs[0].name, /dynamic tool template/); + assert.match(refs[1].name, /dynamic tool template/); +}); + +test('check-skill-tools.mjs fails when a skill references an unquoted unlisted tool in prose or lists', async () => { + const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'skill-tools-unquoted-')); + try { + fs.mkdirSync(path.join(tmpDir, 'scripts'), { recursive: true }); + fs.mkdirSync(path.join(tmpDir, 'skills/demo'), { recursive: true }); + + fs.copyFileSync( + path.join(__dirname, 'hosted-tools.json'), + path.join(tmpDir, 'scripts/hosted-tools.json') + ); + fs.copyFileSync( + path.join(__dirname, 'check-skill-tools.mjs'), + path.join(tmpDir, 'scripts/check-skill-tools.mjs') + ); + + // Skill with unquoted tool in prose and list + fs.writeFileSync( + path.join(tmpDir, 'skills/demo/SKILL.md'), + '---\nname: demo\ndescription: demo\n---\nCall unlisted_prose_tool to run checks.\n- unlisted_list_tool: unlisted bullet tool\n' + ); + + const result = spawnSync( + process.execPath, + [path.join(tmpDir, 'scripts/check-skill-tools.mjs')], + { cwd: tmpDir, encoding: 'utf8' } + ); + assert.equal(result.status, 1); + assert.match(result.stderr, /referenced tool `unlisted_prose_tool` is not in scripts\/hosted-tools\.json/); + assert.match(result.stderr, /referenced tool `unlisted_list_tool` is not in scripts\/hosted-tools\.json/); + } finally { + fs.rmSync(tmpDir, { recursive: true, force: true }); + } +}); + +test('check-skill-tools.mjs scans config/claude-directory/help.md and reports unlisted tools', async () => { + const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'skill-tools-help-')); + try { + fs.mkdirSync(path.join(tmpDir, 'scripts'), { recursive: true }); + fs.mkdirSync(path.join(tmpDir, 'skills/demo'), { recursive: true }); + fs.mkdirSync(path.join(tmpDir, 'config/claude-directory'), { recursive: true }); + + fs.copyFileSync( + path.join(__dirname, 'hosted-tools.json'), + path.join(tmpDir, 'scripts/hosted-tools.json') + ); + fs.copyFileSync( + path.join(__dirname, 'check-skill-tools.mjs'), + path.join(tmpDir, 'scripts/check-skill-tools.mjs') + ); + + // Valid root skill + fs.writeFileSync( + path.join(tmpDir, 'skills/demo/SKILL.md'), + '---\nname: demo\ndescription: demo\n---\nUse `list_campaigns`.\n' + ); + // config/claude-directory/help.md with unhosted tool + fs.writeFileSync( + path.join(tmpDir, 'config/claude-directory/help.md'), + '---\nname: help\ndescription: help\n---\nCall unlisted_directory_help_tool to inspect accounts.\n' + ); + + const result = spawnSync( + process.execPath, + [path.join(tmpDir, 'scripts/check-skill-tools.mjs')], + { cwd: tmpDir, encoding: 'utf8' } + ); + assert.equal(result.status, 1); + assert.match(result.stderr, /config\/claude-directory\/help\.md:5: referenced tool `unlisted_directory_help_tool` is not in scripts\/hosted-tools\.json/); + } finally { + fs.rmSync(tmpDir, { recursive: true, force: true }); + } +}); + +test('check-skill-tools.mjs passes when config/claude-directory/help.md has valid tools and URLs', async () => { + const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'skill-tools-help-pass-')); + try { + fs.mkdirSync(path.join(tmpDir, 'scripts'), { recursive: true }); + fs.mkdirSync(path.join(tmpDir, 'skills/demo'), { recursive: true }); + fs.mkdirSync(path.join(tmpDir, 'config/claude-directory'), { recursive: true }); + + fs.copyFileSync( + path.join(__dirname, 'hosted-tools.json'), + path.join(tmpDir, 'scripts/hosted-tools.json') + ); + fs.copyFileSync( + path.join(__dirname, 'check-skill-tools.mjs'), + path.join(tmpDir, 'scripts/check-skill-tools.mjs') + ); + + fs.writeFileSync( + path.join(tmpDir, 'skills/demo/SKILL.md'), + '---\nname: demo\ndescription: demo\n---\nUse `list_campaigns`.\n' + ); + fs.writeFileSync( + path.join(tmpDir, 'config/claude-directory/help.md'), + '---\nname: help\ndescription: help\n---\nUse list_connected_accounts. See [Privacy](https://synterai.com/privacy) and rules/brand_safety.md.\n' + ); + + const result = spawnSync( + process.execPath, + [path.join(tmpDir, 'scripts/check-skill-tools.mjs')], + { cwd: tmpDir, encoding: 'utf8' } + ); + assert.equal(result.status, 0, result.stderr); + assert.match(result.stdout, /Checked 2 skill files/); + } finally { + fs.rmSync(tmpDir, { recursive: true, force: true }); + } +}); diff --git a/scripts/hosted-tools.json b/scripts/hosted-tools.json new file mode 100644 index 0000000..3a47be4 --- /dev/null +++ b/scripts/hosted-tools.json @@ -0,0 +1,306 @@ +[ + "add_keywords", + "add_negative_keywords", + "add_skill", + "angstrom_build_review", + "angstrom_verify_output", + "approve_campaign_plan", + "approve_organic_post", + "attach_audience", + "audit_account_structure", + "audit_campaign_waste", + "audit_llm_crawler_readiness", + "audit_review_site_profiles", + "benchmark_landing_page", + "build_abm_audience", + "build_lookalike_audience", + "cancel_scheduled_post", + "company_intel_get_hiring_signals", + "company_intel_get_profile", + "company_intel_get_signals", + "company_intel_get_tech_stack", + "company_intel_lookup_taxonomy", + "company_intel_search_job_posts", + "company_intel_search_people", + "company_intel_search_teams", + "configure_pixel_destination", + "create_ad_copy", + "create_autonomous_schedule", + "create_campaign_for_audience", + "create_campaign_import", + "create_campaign_plan", + "create_conversion", + "create_document", + "create_embed", + "create_google_doc", + "create_google_file", + "create_google_sheet", + "create_image", + "create_image_asset", + "create_landing_page", + "create_landing_page_variants", + "create_remotion_video", + "create_social_clip", + "create_verified_page_replica", + "create_video_ad", + "delete_audience", + "delete_document", + "design_ad_creatives", + "disable_campaign_guardrail", + "discover_llm_visibility_prompts", + "document_authoring_apply", + "document_authoring_read", + "document_authoring_render", + "draft_organic_post", + "draft_wikipedia_article", + "enable_campaign", + "enrich_contacts", + "execute", + "execute_campaign_plan", + "find_audience_signals", + "find_llm_citation_listicles", + "forecast_campaign", + "forecast_tool_cost", + "ga4_get_conversions", + "ga4_get_properties", + "ga4_get_report", + "generate_image", + "generate_jsonld_schema_markup", + "generate_ugc_ad", + "generate_video", + "generate_voice_ad", + "get_account_changelog", + "get_ad_readback", + "get_attribution", + "get_billing", + "get_billing_status", + "get_campaign_observation", + "get_campaign_plan", + "get_click_attribution", + "get_connection_status", + "get_credit_balance", + "get_daily_spend", + "get_embed", + "get_embed_code", + "get_embeds", + "get_google_file", + "get_gtm_tag", + "get_job_status", + "get_launch_gate_policy", + "get_llm_visibility_overview", + "get_organic_publishing_readiness", + "get_performance", + "get_pixel_destinations", + "get_pixel_health", + "get_plan_execution", + "get_plugin_info", + "get_spend_reconciliation", + "get_tech_intel", + "get_vendor_consumption", + "get_workspaces", + "google_ads_manage_custom_goals", + "growth_discover", + "growth_enrich", + "gtm_get_resources", + "inspect_script", + "klaviyo_create_campaign", + "klaviyo_create_event", + "klaviyo_get_campaign_metrics", + "klaviyo_get_campaigns", + "klaviyo_get_flows", + "klaviyo_get_lists", + "klaviyo_get_templates", + "klaviyo_update_list_profiles", + "linkedin_ads_create_campaign", + "linkedin_ads_create_campaign_group", + "list_ad_accounts", + "list_ad_design_records", + "list_audiences", + "list_autonomous_schedules", + "list_available_scripts", + "list_campaign_guardrails", + "list_campaigns", + "list_connected_accounts", + "list_creative_assets", + "list_embed_purchases", + "list_embed_submissions", + "list_embeds", + "list_event_deliveries", + "list_gtm_containers", + "list_gtm_tags", + "list_llm_visibility_opportunities", + "list_llm_visibility_prompts", + "list_llm_visibility_sightings", + "list_project_audiences", + "list_remotion_templates", + "list_scheduled_posts", + "list_skills", + "load_skill", + "measure_incrementality", + "meta_ads_create_ad", + "optimize_budget", + "pause_campaign", + "prepare_project_audience_sync", + "prospector_add_leads", + "prospector_assign_inboxes_to_campaign", + "prospector_clear_reply_timers", + "prospector_create_campaign", + "prospector_create_reply", + "prospector_dedupe_leads", + "prospector_edit_reply_draft", + "prospector_get_analytics_summary", + "prospector_get_bounced_leads", + "prospector_get_campaign", + "prospector_get_campaign_performance", + "prospector_get_campaigns", + "prospector_get_inbox_health", + "prospector_get_intro_paths", + "prospector_get_leads", + "prospector_get_pending_replies", + "prospector_get_pipeline_summary", + "prospector_get_reply_autosend", + "prospector_get_reply_timers", + "prospector_get_report", + "prospector_get_reports", + "prospector_get_step_performance", + "prospector_get_warm_intros", + "prospector_get_workflows", + "prospector_post_linkedin_comment", + "prospector_post_linkedin_document", + "prospector_reconcile_campaign_leads", + "prospector_regenerate_reply", + "prospector_remove_leads", + "prospector_send_outreach_email", + "prospector_set_campaign_auto_reply", + "prospector_set_reply_fail_open", + "prospector_set_workflow_state", + "prospector_skip_reply", + "prospector_suppress_leads", + "prospector_update_campaign_sequence", + "prospector_update_campaign_settings", + "prospector_update_campaign_status", + "prospector_update_lead_custom_variables", + "prospector_verify_and_push_leads", + "prospector_verify_leads", + "publish_gtm_container", + "publish_landing_page", + "publish_organic_post", + "publish_plan_document", + "publish_skill", + "publish_to_github", + "pull_amazon_ads_performance", + "pull_amazon_dsp_performance", + "pull_cm360_performance", + "pull_criteo_ads_performance", + "pull_dv360_performance", + "pull_freewheel_performance", + "pull_google_ads_performance", + "pull_instacart_ads_performance", + "pull_linkedin_ads_performance", + "pull_linkedin_company_engagement", + "pull_meta_ads_performance", + "pull_microsoft_ads_performance", + "pull_openai_ads_performance", + "pull_pinterest_ads_performance", + "pull_reddit_ads_performance", + "pull_snap_ads_performance", + "pull_spotify_ads_performance", + "pull_target_roundel_performance", + "pull_tiktok_ads_performance", + "pull_trade_desk_performance", + "pull_walmart_ads_performance", + "pull_x_ads_performance", + "read_google_drive_file", + "read_google_sheet", + "recommend_llm_visibility_strategy", + "record_ad_design_feedback", + "reddit_ads_create_ad", + "reddit_ads_create_ad_group", + "reddit_ads_create_campaign", + "reddit_ads_create_post", + "repair_account_structure", + "research_campaign_opportunity", + "run_action", + "run_gaql_query", + "run_launch_preflight", + "run_llm_visibility_scan", + "run_tool", + "schedule_organic_post", + "search_actions", + "send_slack_message", + "set_campaign_guardrail", + "set_embed_crm_destination", + "set_spend_alert", + "setup_custom_domain", + "setup_google_ads_trial_funnel", + "shopify_create_discount", + "shopify_create_web_pixel", + "shopify_create_webhook", + "shopify_get_abandoned_checkouts", + "shopify_get_collections", + "shopify_get_customer_audience", + "shopify_get_customers", + "shopify_get_discount_codes", + "shopify_get_inventory_levels", + "shopify_get_inventory_status", + "shopify_get_orders", + "shopify_get_product_feed", + "shopify_get_product_sales", + "shopify_get_products", + "shopify_get_sales_summary", + "shopify_get_shop", + "shopify_get_webhooks", + "stage_audience_artifact", + "studio_edit_landing_page", + "studio_inspect_landing_page", + "sync_audience", + "sync_wikidata_entity", + "synter_audience", + "synter_audience_cancel_export", + "synter_audience_capacity", + "synter_audience_export", + "synter_audience_export_status", + "synter_audience_query", + "synter_audience_schema", + "synter_onboarding_start", + "synter_onboarding_status", + "synter_signal_audience_export", + "synter_signal_entity_relations", + "synter_signal_entity_resolve", + "synter_signal_trait_search", + "tech_intel_company_to_url", + "tech_intel_get_account_usage", + "tech_intel_get_domain_keywords", + "tech_intel_get_domain_technologies", + "tech_intel_get_sites", + "tech_intel_get_technology_changes", + "tech_intel_get_trust_signals", + "tech_intel_product_search", + "test_creatives", + "tiktok_ads_get_ad_groups", + "tiktok_ads_get_adgroup", + "tiktok_ads_get_ads", + "tiktok_ads_get_campaign", + "tiktok_ads_get_insights", + "tiktok_ads_update_adgroup", + "update_active_workspace", + "update_autonomous_schedule", + "update_campaign_budget", + "update_embed", + "update_google_sheet", + "update_gtm_tag", + "update_gtm_tag_html", + "update_landing_page_html", + "update_landing_page_tracking", + "update_llm_visibility_project", + "update_verified_page_replica", + "upload_creative", + "upload_image", + "upload_landing_page_html", + "upload_library_image", + "upsert_plan_entity", + "validate_organic_post", + "verify_custom_domain", + "verify_pixel_ownership", + "verify_platform_accounts" +] diff --git a/scripts/test_build_packages.py b/scripts/test_build_packages.py index 08daf25..fa53777 100644 --- a/scripts/test_build_packages.py +++ b/scripts/test_build_packages.py @@ -36,6 +36,7 @@ def test_directory_source_is_reproducible_and_has_only_static_runtime(self): self.assertEqual(sum(name.endswith('/SKILL.md') for name in files), 56) self.assertEqual(sum(name.startswith('agents/') for name in files), 6) self.assertNotIn('hooks', json.loads(files['.claude-plugin/plugin.json'])) + self.assertNotIn('privacyPolicyUrl', json.loads(files['.claude-plugin/plugin.json'])) self.assertEqual(files['assets/logo.png'], (mod.ROOT / 'assets/logo.png').read_bytes()) self.assertNotIn(b'SessionStart shell hook', files['skills/help/SKILL.md']) for name in files: @@ -57,7 +58,23 @@ def test_directory_rejects_local_execution_and_unknown_files(self): changed['.claude-plugin/plugin.json'] = mod.encoded(manifest) with self.assertRaises(ValueError): mod.validate_claude_directory(changed) + changed_privacy = dict(files) + manifest_privacy = json.loads(files['.claude-plugin/plugin.json']) + manifest_privacy['privacyPolicyUrl'] = 'https://synterai.com/privacy' + changed_privacy['.claude-plugin/plugin.json'] = mod.encoded(manifest_privacy) + with self.assertRaises(ValueError): + mod.validate_claude_directory(changed_privacy) + self.assertEqual(json.loads(files['.mcp.json'])['mcpServers']['synter']['url'], mod.DIRECTORY_MCP_URL) + self.assertEqual(mod.DIRECTORY_MCP_URL, 'https://mcp.synterai.com/mcp/directory') + directory_tools = json.loads(files['tools/directory-tools.json']) + full_plugin_tools = json.loads((mod.ROOT / 'tools/directory-tools.json').read_text()) + self.assertEqual(len(full_plugin_tools), 34) + self.assertEqual(directory_tools, full_plugin_tools + list(mod.DIRECTORY_EXTRA_TOOLS)) + self.assertEqual(len(directory_tools), 42) + self.assertEqual(json.loads(mod.collect(mod.ROOT, 'claude')[1]['tools/directory-tools.json']), full_plugin_tools) + self.assertNotRegex(files['README.md'].decode(), r'\$\s?\d|\bSolo\b') for server in [{'command': 'node'}, {'type': 'http', 'url': 'https://other.example', 'description': 'test'}, + {'type': 'http', 'url': 'https://mcp.synterai.com', 'description': 'full catalog, not the directory surface'}, {'type': 'http', 'url': 'https://mcp.synterai.com', 'description': 'test', 'headers': {'x-key': 'fake'}}]: with self.subTest(server=server), self.assertRaises(ValueError): mod.validate_claude_directory({**files, '.mcp.json': mod.encoded({'mcpServers': {'synter': server}})}) @@ -99,12 +116,12 @@ def test_directory_generated_source_detects_drift_and_symlinks(self): def test_archives_match_reviewed_rsa_correction_bytes(self): expected = { - 'claude': '72fecb572222d3725acd884f4d7f49a3f5493a2c084d4a4ee201a53a960aee73', - 'claude-directory': 'e313a4ed69ef3e2e80d13c622d102e69d8e6c51cfeb8f0ba13f29b2e0340efc1', - 'openai': '5ab905019791b7f0f71033e19e18042e26ba272b7b2d958aac4ff177a7c0f665', - 'openai-new-draft': '48bbdbedbc5eb96ffacfcd18b339048139ac6f67dbca160e5fd2d13b7682cd87', + 'claude': '8f3af5857f50198fd4a3ed57cbb33381c64a1387ffe1b9e52c087db4c76ec8e9', + 'claude-directory': 'efac3bfa5b75f6e347a4e12d98a475b5ea0aae78a3c2d4ed7f653b21d2490be4', + 'openai': '624ee7d437798142d5bc89905f3cde031c2184ba58cadd2254fae9a4f5fae058', + 'openai-new-draft': '10265c56b3d4616470fb71626120b508c6c51b4bd21128532488003cf376a629', } - # Snapshot after the approved RSA/bidding correction across all hosts. + # Snapshot after the 42-tool directory surface and pricing-neutral listing copy. # Update deliberately when reviewed package contents change. for target, digest in expected.items(): _, files = mod.collect(mod.ROOT, target)