@opentabs-dev/mcp-server 0.0.64 → 0.0.66

package/dist/mcp-prompts.js

@@ -5,13 +5,34 @@
  * Unlike instructions (sent on every session), prompts are pull-based — clients
  * fetch them on demand via `prompts/get` when the user invokes them.
  *
+ * Each prompt resolver returns messages that combine:
+ *   1. A user-role text message with the workflow/task instructions
+ *   2. Embedded resource content blocks for relevant guides and references
+ *
+ * Embedding resources directly into prompt messages ensures that MCP clients
+ * automatically receive the full context they need — they do not need to
+ * separately fetch resources via resources/read. This is the MCP-native
+ * mechanism for composing prompts with reference material.
+ *
  * Current prompts:
  *   - `build_plugin`: Full workflow for building a new OpenTabs plugin
+ *   - `troubleshoot`: Guided debugging workflow for diagnosing platform issues
+ *   - `setup_plugin`: Step-by-step workflow for installing and configuring a plugin
+ *   - `plugin_icon`: Add or update an SVG icon for a plugin
+ *   - `audit_ai_docs`: Audit and improve AI-facing documentation (instructions, resources, prompts)
  */
+import { getStaticResourceContent } from './mcp-resources.js';
+import { auditAiDocsPromptText } from './prompts/audit-ai-docs.js';
+import { buildPluginPromptText } from './prompts/build-plugin.js';
+import { contributeLearningsPromptText } from './prompts/contribute-learnings.js';
+import { pluginIconPromptText } from './prompts/plugin-icon.js';
+import { setupPluginPromptText } from './prompts/setup-plugin.js';
+import { troubleshootPromptText } from './prompts/troubleshoot.js';
 /** All registered prompts */
 export const PROMPTS = [
     {
         name: 'build_plugin',
+        title: 'Build a Plugin',
         description: 'Step-by-step workflow for building a new OpenTabs plugin for a web application. ' +
             'Covers site analysis, auth discovery, API mapping, scaffolding, implementation, and testing. ' +
             'Use this when you want to create a plugin that gives AI agents access to a web app.',
@@ -28,9 +49,100 @@ export const PROMPTS = [
             },
         ],
     },
+    {
+        name: 'troubleshoot',
+        title: 'Troubleshoot Issues',
+        description: 'Guided debugging workflow for diagnosing OpenTabs platform issues. ' +
+            'Walks through extension connectivity, plugin state, tab readiness, permissions, ' +
+            'and common error scenarios with specific tool calls at each step. ' +
+            'Use this when tools fail, the extension is disconnected, or the platform misbehaves.',
+        arguments: [
+            {
+                name: 'error',
+                description: 'The error message or symptom to diagnose (e.g., "Extension not connected", "Tab closed"). ' +
+                    'If omitted, runs a general health check workflow.',
+                required: false,
+            },
+        ],
+    },
+    {
+        name: 'setup_plugin',
+        title: 'Set Up a Plugin',
+        description: 'Step-by-step workflow for installing, configuring, reviewing, and testing an existing ' +
+            'OpenTabs plugin from npm. Covers search, install, review flow, permission configuration, ' +
+            'and verification. Use this when you want to add a plugin to the platform.',
+        arguments: [
+            {
+                name: 'name',
+                description: 'Plugin name or npm package name (e.g., "slack" or "@opentabs-dev/opentabs-plugin-slack")',
+                required: true,
+            },
+        ],
+    },
+    {
+        name: 'plugin_icon',
+        title: 'Add Plugin Icon',
+        description: 'Step-by-step workflow for adding or updating an SVG icon for an OpenTabs plugin. ' +
+            'Covers obtaining the brand SVG, preparing it (square viewBox, size constraints), ' +
+            'placing it, building, and verifying in the side panel.',
+        arguments: [
+            {
+                name: 'plugin',
+                description: 'Plugin name (e.g., "slack", "discord"). Used to locate the plugin directory.',
+                required: true,
+            },
+        ],
+    },
+    {
+        name: 'audit_ai_docs',
+        title: 'Audit AI Documentation',
+        description: 'Audit and improve AI-facing documentation served by the MCP server. ' +
+            'Verifies accuracy of instructions, resources, and prompts against the actual codebase. ' +
+            'Identifies gaps, stale content, and drift. Use this to keep AI docs up to date.',
+        arguments: [],
+    },
+    {
+        name: 'contribute_learnings',
+        title: 'Contribute Learnings',
+        description: 'Write new patterns, gotchas, and techniques back into MCP server source code after completing any task. ' +
+            'Edits to these source files compile into the resources and prompts served to every future AI session, ' +
+            'creating a self-improving loop. Invoke this after plugin development, troubleshooting, or any task that surfaced new knowledge.',
+        arguments: [
+            {
+                name: 'task',
+                description: 'Brief description of the task you completed (e.g., "built a plugin for Linear", "fixed CORS issue with Notion API"). ' +
+                    'If omitted, reviews the entire session for learnings.',
+                required: false,
+            },
+        ],
+    },
 ];
 /** Prompt name → definition for O(1) lookup */
 const PROMPT_MAP = new Map(PROMPTS.map(p => [p.name, p]));
+/**
+ * Build an embedded resource content block from a resource URI.
+ * Returns null if the resource content is not available (dynamic or unknown).
+ */
+const embedResource = (uri, mimeType) => {
+    const text = getStaticResourceContent(uri);
+    if (!text)
+        return null;
+    return { type: 'resource', resource: { uri, mimeType, text } };
+};
+/**
+ * Build prompt messages: a primary text message followed by embedded resources.
+ * Resources that fail to resolve (dynamic resources, unknown URIs) are silently skipped.
+ */
+const buildMessages = (text, resourceUris) => {
+    const messages = [{ role: 'user', content: { type: 'text', text } }];
+    for (const { uri, mimeType } of resourceUris) {
+        const embedded = embedResource(uri, mimeType);
+        if (embedded) {
+            messages.push({ role: 'user', content: embedded });
+        }
+    }
+    return messages;
+};
 /**
  * Resolve a prompt by name with the given arguments.
  * Returns null if the prompt name is not recognized.
@@ -39,10 +151,22 @@ export const resolvePrompt = (name, args) => {
     const def = PROMPT_MAP.get(name);
     if (!def)
         return null;
-    if (name === 'build_plugin') {
-        return resolveBuildPlugin(args);
+    switch (name) {
+        case 'build_plugin':
+            return resolveBuildPlugin(args);
+        case 'troubleshoot':
+            return resolveTroubleshoot(args);
+        case 'setup_plugin':
+            return resolveSetupPlugin(args);
+        case 'plugin_icon':
+            return resolvePluginIcon(args);
+        case 'audit_ai_docs':
+            return resolveAuditAiDocs();
+        case 'contribute_learnings':
+            return resolveContributeLearnings(args);
+        default:
+            return null;
     }
-    return null;
 };
 // ---------------------------------------------------------------------------
 // build_plugin prompt
@@ -52,361 +176,73 @@ const resolveBuildPlugin = (args) => {
     const name = args.name ?? '';
     return {
         description: `Build an OpenTabs plugin for ${url}`,
-        messages: [
-            {
-                role: 'user',
-                content: {
-                    type: 'text',
-                    text: buildPluginPromptText(url, name),
-                },
-            },
-        ],
+        messages: buildMessages(buildPluginPromptText(url, name), [
+            { uri: 'opentabs://guide/plugin-development', mimeType: 'text/markdown' },
+            { uri: 'opentabs://reference/sdk-api', mimeType: 'text/markdown' },
+        ]),
     };
 };
-const buildPluginPromptText = (url, name) => {
-    const nameClause = name ? `The plugin name should be \`${name}\`.` : '';
-    return `Build a production-ready OpenTabs plugin for ${url}. ${nameClause}
-
-Follow the complete workflow below. Each phase builds on the previous one — do not skip phases.
-
----
-
-## Prerequisites
-
-- The user has the target web app open in a browser tab at ${url}
-- The MCP server is running (you are connected to it)
-- You have access to the filesystem for creating plugin source files
-
-### Browser Tool Permissions
-
-Plugin development requires heavy use of browser tools (\`browser_execute_script\`, \`browser_navigate_tab\`, \`browser_get_tab_content\`, etc.). By default, tools have permission \`'off'\` (disabled) or \`'ask'\` (requires human approval).
-
-Ask the user if they want to enable \`skipPermissions\` to bypass approval prompts during development. Set the env var: \`OPENTABS_DANGEROUSLY_SKIP_PERMISSIONS=1\`. Warn them this bypasses human approval and should only be used during active plugin development.
-
----
-
-## Phase 1: Research the Codebase
-
-Before writing any code, study the existing plugin infrastructure using the filesystem:
-
-1. **Study the Plugin SDK** — read \`platform/plugin-sdk/CLAUDE.md\` and key source files (\`src/index.ts\`, \`src/plugin.ts\`, \`src/tool.ts\`). Understand:
-   - \`OpenTabsPlugin\` abstract base class (name, displayName, description, urlPatterns, tools, isReady)
-   - \`defineTool({ name, displayName, description, icon, input, output, handle })\` factory
-   - \`ToolError\` static factories: \`.auth()\`, \`.notFound()\`, \`.rateLimited()\`, \`.timeout()\`, \`.validation()\`, \`.internal()\`
-   - SDK utilities: \`fetchJSON\`, \`postJSON\`, \`getLocalStorage\`, \`waitForSelector\`, \`retry\`, \`sleep\`, \`log\`
-   - All plugin code runs in the **browser page context** (not server-side)
-
-2. **Study an existing plugin** (e.g., \`plugins/slack/\`) as the canonical reference:
-   - \`src/index.ts\` — plugin class, imports all tools
-   - \`src/slack-api.ts\` — API wrapper with auth extraction + error classification
-   - \`src/tools/\` — one file per tool, shared schemas
-   - \`package.json\` — the opentabs field, dependency versions, scripts
-
-3. **Study \`plugins/CLAUDE.md\`** — plugin isolation rules and conventions
-
----
-
-## Phase 2: Explore the Target Web App
-
-This is the most critical phase. Use browser tools to understand how the web app works.
-
-### Step 1: Find the Tab
-
-\`\`\`
-plugin_list_tabs  or  browser_list_tabs  →  find the tab for ${url}
-\`\`\`
-
-### Step 2: Analyze the Site
-
-\`\`\`
-plugin_analyze_site(url: "${url}")
-\`\`\`
-
-This gives you a comprehensive report: auth methods, API endpoints, framework detection, storage keys, and concrete tool suggestions.
-
-### Step 3: Enable Network Capture and Explore
-
-\`\`\`
-browser_enable_network_capture(tabId, urlFilter: "/api")
-\`\`\`
-
-Navigate around in the app to trigger API calls, then read them:
-
-\`\`\`
-browser_get_network_requests(tabId)
-\`\`\`
-
-Study the captured traffic to understand:
-- API base URL
-- Whether the API is same-origin or cross-origin (critical for CORS)
-- Request format (JSON body vs form-encoded)
-- Required headers (content-type, custom headers)
-- Response shapes for each endpoint
-- Error response format
-
-### Step 4: Check CORS Policy (for Cross-Origin APIs)
-
-If the API is on a different subdomain, verify CORS behavior:
-
-\`\`\`bash
-curl -sI -X OPTIONS https://api.example.com/endpoint \\
-  -H "Origin: ${url}" \\
-  -H "Access-Control-Request-Method: GET" \\
-  -H "Access-Control-Request-Headers: Authorization,Content-Type" \\
-  | grep -i "access-control"
-\`\`\`
-
-### Step 5: Discover Auth Token
-
-**First, always check cookies with \`browser_get_cookies\`** to understand the auth model. Then probe the page:
-
-- **localStorage**: Direct access or iframe fallback if the app deletes \`window.localStorage\`
-- **Page globals**: \`window.__APP_STATE__\`, \`window.boot_data\`, \`window.__NEXT_DATA__\`
-- **Webpack module stores**: For React/webpack SPAs
-- **Cookies**: \`document.cookie\` for non-HttpOnly tokens
-- **Script tags**: Inline \`<script>\` tags with embedded config
-
-### Step 6: Test the API
-
-Once you have the token, make a test API call with \`browser_execute_script\`:
-
-\`\`\`javascript
-const resp = await fetch('https://example.com/api/v2/me', {
-  headers: { Authorization: 'Bearer ' + token },
-  credentials: 'include',
-});
-const data = await resp.json();
-return data;
-\`\`\`
-
-### Step 7: Map the API Surface
-
-Discover the key endpoints: user/profile, list resources, get single resource, create/update/delete, search, messaging, reactions.
-
----
-
-## Phase 3: Scaffold the Plugin
-
-\`\`\`bash
-cd plugins/
-opentabs plugin create <name> --domain <domain> --display <DisplayName> --description "OpenTabs plugin for <DisplayName>"
-\`\`\`
-
-After scaffolding, compare \`package.json\` with an existing plugin (e.g., \`plugins/slack/package.json\`) and align:
-- Package name: \`@opentabs-dev/opentabs-plugin-<name>\` for official plugins
-- Version: Match the current platform version
-- Add: \`publishConfig\`, \`check\` script
-- Dependency versions: Match \`@opentabs-dev/plugin-sdk\` and \`@opentabs-dev/plugin-tools\` versions
-
----
-
-## Phase 4: Implement
-
-### File Structure
-
-\`\`\`
-src/
-  index.ts              # Plugin class — imports all tools, implements isReady()
-  <name>-api.ts         # API wrapper — auth extraction + error classification
-  tools/
-    schemas.ts          # Shared Zod schemas + defensive mappers
-    send-message.ts     # One file per tool
-    ...
-\`\`\`
-
-### API Wrapper Pattern (\`<name>-api.ts\`)
-
-The API wrapper handles auth extraction, request construction, and error classification:
-
-\`\`\`typescript
-import { ToolError } from '@opentabs-dev/plugin-sdk';
-
-interface AppAuth {
-  token: string;
-}
-
-const getAuth = (): AppAuth | null => {
-  // Check globalThis persistence first (survives adapter re-injection)
-  // Then try localStorage, page globals, cookies
-  // Return null if not authenticated
+// ---------------------------------------------------------------------------
+// troubleshoot prompt
+// ---------------------------------------------------------------------------
+const resolveTroubleshoot = (args) => {
+    const error = args.error ?? '';
+    return {
+        description: error ? `Troubleshoot OpenTabs issue: ${error}` : 'Run a general OpenTabs health check',
+        messages: buildMessages(troubleshootPromptText(error), [
+            { uri: 'opentabs://guide/troubleshooting', mimeType: 'text/markdown' },
+        ]),
+    };
 };
-
-export const isAuthenticated = (): boolean => getAuth() !== null;
-
-export const waitForAuth = (): Promise<boolean> =>
-  new Promise((resolve) => {
-    let elapsed = 0;
-    const interval = 500;
-    const maxWait = 5000;
-    const timer = setInterval(() => {
-      elapsed += interval;
-      if (isAuthenticated()) { clearInterval(timer); resolve(true); return; }
-      if (elapsed >= maxWait) { clearInterval(timer); resolve(false); }
-    }, interval);
-  });
-
-export const api = async <T extends Record<string, unknown>>(
-  endpoint: string,
-  options: { method?: string; body?: Record<string, unknown>; query?: Record<string, string | number | boolean | undefined> } = {},
-): Promise<T> => {
-  const auth = getAuth();
-  if (!auth) throw ToolError.auth('Not authenticated — please log in.');
-
-  let url = \\\`https://example.com/api\\\${endpoint}\\\`;
-  if (options.query) {
-    const params = new URLSearchParams();
-    for (const [key, value] of Object.entries(options.query)) {
-      if (value !== undefined) params.append(key, String(value));
-    }
-    const qs = params.toString();
-    if (qs) url += \\\`?\\\${qs}\\\`;
-  }
-
-  const headers: Record<string, string> = { Authorization: \\\`Bearer \\\${auth.token}\\\` };
-  let fetchBody: string | undefined;
-  if (options.body) {
-    headers['Content-Type'] = 'application/json';
-    fetchBody = JSON.stringify(options.body);
-  }
-
-  let response: Response;
-  try {
-    response = await fetch(url, {
-      method: options.method ?? 'GET', headers, body: fetchBody,
-      credentials: 'include', signal: AbortSignal.timeout(30_000),
-    });
-  } catch (err: unknown) {
-    if (err instanceof DOMException && err.name === 'TimeoutError')
-      throw ToolError.timeout(\\\`API request timed out: \\\${endpoint}\\\`);
-    throw new ToolError(
-      \\\`Network error: \\\${err instanceof Error ? err.message : String(err)}\\\`,
-      'network_error', { category: 'internal', retryable: true },
-    );
-  }
-
-  if (!response.ok) {
-    const errorBody = (await response.text().catch(() => '')).substring(0, 512);
-    if (response.status === 429) throw ToolError.rateLimited(\\\`Rate limited: \\\${endpoint}\\\`);
-    if (response.status === 401 || response.status === 403)
-      throw ToolError.auth(\\\`Auth error (\\\${response.status}): \\\${errorBody}\\\`);
-    if (response.status === 404) throw ToolError.notFound(\\\`Not found: \\\${endpoint}\\\`);
-    throw ToolError.internal(\\\`API error (\\\${response.status}): \\\${endpoint} — \\\${errorBody}\\\`);
-  }
-
-  if (response.status === 204) return {} as T;
-  return (await response.json()) as T;
+// ---------------------------------------------------------------------------
+// setup_plugin prompt
+// ---------------------------------------------------------------------------
+const resolveSetupPlugin = (args) => {
+    const name = args.name ?? 'my-plugin';
+    return {
+        description: `Set up the ${name} OpenTabs plugin`,
+        messages: buildMessages(setupPluginPromptText(name), [
+            { uri: 'opentabs://guide/quick-start', mimeType: 'text/markdown' },
+        ]),
+    };
+};
+// ---------------------------------------------------------------------------
+// plugin_icon prompt
+// ---------------------------------------------------------------------------
+const resolvePluginIcon = (args) => {
+    const plugin = args.plugin ?? 'my-plugin';
+    return {
+        description: `Add or update icon for the ${plugin} plugin`,
+        messages: buildMessages(pluginIconPromptText(plugin), []),
+    };
 };
-\`\`\`
-
-### Tool Pattern (one file per tool)
-
-\`\`\`typescript
-import { defineTool } from '@opentabs-dev/plugin-sdk';
-import { z } from 'zod';
-import { api } from '../<name>-api.js';
-
-export const sendMessage = defineTool({
-  name: 'send_message',
-  displayName: 'Send Message',
-  description: 'Send a message to a channel. Supports markdown formatting.',
-  summary: 'Send a message to a channel',
-  icon: 'send',
-  input: z.object({
-    channel: z.string().describe('Channel ID to send the message to'),
-    content: z.string().describe('Message text content'),
-  }),
-  output: z.object({
-    id: z.string().describe('Message ID'),
-  }),
-  handle: async (params) => {
-    const data = await api<Record<string, unknown>>(
-      '/channels/' + params.channel + '/messages',
-      { method: 'POST', body: { content: params.content } },
-    );
-    return { id: (data.id as string) ?? '' };
-  },
+// ---------------------------------------------------------------------------
+// audit_ai_docs prompt
+// ---------------------------------------------------------------------------
+const resolveAuditAiDocs = () => ({
+    description: 'Audit and improve AI-facing documentation',
+    messages: buildMessages(auditAiDocsPromptText(), [
+        { uri: 'opentabs://guide/quick-start', mimeType: 'text/markdown' },
+        { uri: 'opentabs://guide/plugin-development', mimeType: 'text/markdown' },
+        { uri: 'opentabs://guide/troubleshooting', mimeType: 'text/markdown' },
+        { uri: 'opentabs://guide/self-improvement', mimeType: 'text/markdown' },
+        { uri: 'opentabs://reference/sdk-api', mimeType: 'text/markdown' },
+        { uri: 'opentabs://reference/cli', mimeType: 'text/markdown' },
+        { uri: 'opentabs://reference/browser-tools', mimeType: 'text/markdown' },
+    ]),
 });
-\`\`\`
-
-### Plugin Class Pattern (\`index.ts\`)
-
-\`\`\`typescript
-import { OpenTabsPlugin } from '@opentabs-dev/plugin-sdk';
-import type { ToolDefinition } from '@opentabs-dev/plugin-sdk';
-import { isAuthenticated, waitForAuth } from './<name>-api.js';
-import { sendMessage } from './tools/send-message.js';
-
-class MyPlugin extends OpenTabsPlugin {
-  readonly name = '<name>';
-  readonly description = 'OpenTabs plugin for <DisplayName>';
-  override readonly displayName = '<DisplayName>';
-  readonly urlPatterns = ['*://*.example.com/*'];
-  readonly tools: ToolDefinition[] = [sendMessage];
-
-  async isReady(): Promise<boolean> {
-    if (isAuthenticated()) return true;
-    return waitForAuth();
-  }
-}
-
-export default new MyPlugin();
-\`\`\`
-
----
-
-## Phase 5: Build and Test
-
-### Build
-
-\`\`\`bash
-cd plugins/<name>
-npm install
-npm run build
-\`\`\`
-
-### Verify Plugin Loaded
-
-\`\`\`
-plugin_list_tabs(plugin: "<name>")
-\`\`\`
-
-Must show \`state: "ready"\` for the matching tab.
-
-### Test Each Tool
-
-Systematically test read-only tools first (list, get, search), then write tools (send, create, delete). Test error cases: invalid IDs, missing permissions.
-
-### Full Check Suite
-
-\`\`\`bash
-npm run check  # build + type-check + lint + format:check
-\`\`\`
-
----
-
-## Key Conventions
-
-- **One file per tool** in \`src/tools/\`
-- **Every Zod field gets \`.describe()\`** — this is what AI agents see in the tool schema
-- **\`description\` is for AI clients** — detailed, informative. \`summary\` is for humans — short, under 80 chars
-- **Defensive mapping** with fallback defaults (\`data.field ?? ''\`) — never trust API shapes
-- **Error classification is critical** — use \`ToolError\` factories, never throw raw errors
-- **\`credentials: 'include'\`** on all fetch calls
-- **30-second timeout** via \`AbortSignal.timeout(30_000)\`
-- **\`.js\` extension** on all imports (ESM requirement)
-- **No \`.transform()\`/\`.pipe()\`/\`.preprocess()\`** in Zod schemas (breaks JSON Schema serialization)
-
----
-
-## Common Gotchas
-
-1. **All plugin code runs in the browser** — no Node.js APIs
-2. **SPAs hydrate asynchronously** — \`isReady()\` must poll (500ms interval, 5s max)
-3. **Some apps delete browser APIs** — use iframe fallback for \`localStorage\`
-4. **Tokens must persist on \`globalThis.__openTabs.tokenCache.<pluginName>\`** — module-level variables reset on extension reload
-5. **HttpOnly cookies are invisible to plugin code** — use \`credentials: 'include'\` for the browser to send them automatically, detect auth status from DOM signals
-6. **Parse error response bodies before classifying by HTTP status** — many apps reuse 403 for both auth and permission errors
-7. **Cross-origin API + cookies: check CORS before choosing fetch strategy**
-8. **Always run \`npm run format\` after writing code** — Biome config uses single quotes`;
+// ---------------------------------------------------------------------------
+// contribute_learnings prompt
+// ---------------------------------------------------------------------------
+const resolveContributeLearnings = (args) => {
+    const task = args.task ?? '';
+    return {
+        description: task ? `Contribute learnings from: ${task}` : 'Contribute learnings from recent session',
+        messages: buildMessages(contributeLearningsPromptText(task), [
+            { uri: 'opentabs://guide/self-improvement', mimeType: 'text/markdown' },
+            { uri: 'opentabs://guide/plugin-development', mimeType: 'text/markdown' },
+            { uri: 'opentabs://guide/troubleshooting', mimeType: 'text/markdown' },
+        ]),
+    };
 };
 //# sourceMappingURL=mcp-prompts.js.map

package/dist/mcp-prompts.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-prompts.js","sourceRoot":"","sources":["../src/mcp-prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA4BH,6BAA6B;AAC7B,MAAM,CAAC,MAAM,OAAO,GAAuB;IACzC;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,kFAAkF;YAClF,+FAA+F;YAC/F,qFAAqF;QACvF,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,KAAK;gBACX,WAAW,EAAE,qEAAqE;gBAClF,QAAQ,EAAE,IAAI;aACf;YACD;gBACE,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,8EAA8E;gBAC3F,QAAQ,EAAE,KAAK;aAChB;SACF;KACF;CACF,CAAC;AAEF,+CAA+C;AAC/C,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAE1D;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,IAA4B,EAAuB,EAAE;IAC/F,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAEtB,IAAI,IAAI,KAAK,cAAc,EAAE,CAAC;QAC5B,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,MAAM,kBAAkB,GAAG,CAAC,IAA4B,EAAgB,EAAE;IACxE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,qBAAqB,CAAC;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;IAE7B,OAAO;QACL,WAAW,EAAE,gCAAgC,GAAG,EAAE;QAClD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,qBAAqB,CAAC,GAAG,EAAE,IAAI,CAAC;iBACvC;aACF;SACF;KACF,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAAC,GAAW,EAAE,IAAY,EAAU,EAAE;IAClE,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,+BAA+B,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAExE,OAAO,gDAAgD,GAAG,KAAK,UAAU;;;;;;;;6DAQd,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+DAwCD,GAAG;;;;;;4BAMtC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBA+Bf,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0FAiQuE,CAAC;AAC3F,CAAC,CAAC"}
+{"version":3,"file":"mcp-prompts.js","sourceRoot":"","sources":["../src/mcp-prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,6BAA6B,EAAE,MAAM,mCAAmC,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAgDnE,6BAA6B;AAC7B,MAAM,CAAC,MAAM,OAAO,GAAuB;IACzC;QACE,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,gBAAgB;QACvB,WAAW,EACT,kFAAkF;YAClF,+FAA+F;YAC/F,qFAAqF;QACvF,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,KAAK;gBACX,WAAW,EAAE,qEAAqE;gBAClF,QAAQ,EAAE,IAAI;aACf;YACD;gBACE,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,8EAA8E;gBAC3F,QAAQ,EAAE,KAAK;aAChB;SACF;KACF;IACD;QACE,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,qEAAqE;YACrE,kFAAkF;YAClF,oEAAoE;YACpE,sFAAsF;QACxF,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,OAAO;gBACb,WAAW,EACT,4FAA4F;oBAC5F,mDAAmD;gBACrD,QAAQ,EAAE,KAAK;aAChB;SACF;KACF;IACD;QACE,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,wFAAwF;YACxF,2FAA2F;YAC3F,2EAA2E;QAC7E,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,0FAA0F;gBACvG,QAAQ,EAAE,IAAI;aACf;SACF;KACF;IACD;QACE,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,mFAAmF;YACnF,mFAAmF;YACnF,wDAAwD;QAC1D,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8EAA8E;gBAC3F,QAAQ,EAAE,IAAI;aACf;SACF;KACF;IACD;QACE,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EACT,sEAAsE;YACtE,yFAAyF;YACzF,iFAAiF;QACnF,SAAS,EAAE,EAAE;KACd;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,0GAA0G;YAC1G,wGAAwG;YACxG,iIAAiI;QACnI,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,MAAM;gBACZ,WAAW,EACT,uHAAuH;oBACvH,uDAAuD;gBACzD,QAAQ,EAAE,KAAK;aAChB;SACF;KACF;CACF,CAAC;AAEF,+CAA+C;AAC/C,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAE1D;;;GAGG;AACH,MAAM,aAAa,GAAG,CAAC,GAAW,EAAE,QAAgB,EAAkC,EAAE;IACtF,MAAM,IAAI,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC;AACjE,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,YAAsD,EAAmB,EAAE;IAC9G,MAAM,QAAQ,GAAoB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IAEtF,KAAK,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,YAAY,EAAE,CAAC;QAC7C,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC9C,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,IAA4B,EAAuB,EAAE;IAC/F,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAEtB,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,cAAc;YACjB,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAClC,KAAK,cAAc;YACjB,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACnC,KAAK,cAAc;YACjB,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAClC,KAAK,aAAa;YAChB,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACjC,KAAK,eAAe;YAClB,OAAO,kBAAkB,EAAE,CAAC;QAC9B,KAAK,sBAAsB;YACzB,OAAO,0BAA0B,CAAC,IAAI,CAAC,CAAC;QAC1C;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC,CAAC;AAEF,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,MAAM,kBAAkB,GAAG,CAAC,IAA4B,EAAgB,EAAE;IACxE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,qBAAqB,CAAC;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;IAE7B,OAAO;QACL,WAAW,EAAE,gCAAgC,GAAG,EAAE;QAClD,QAAQ,EAAE,aAAa,CAAC,qBAAqB,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE;YACxD,EAAE,GAAG,EAAE,qCAAqC,EAAE,QAAQ,EAAE,eAAe,EAAE;YACzE,EAAE,GAAG,EAAE,8BAA8B,EAAE,QAAQ,EAAE,eAAe,EAAE;SACnE,CAAC;KACH,CAAC;AACJ,CAAC,CAAC;AAEF,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,MAAM,mBAAmB,GAAG,CAAC,IAA4B,EAAgB,EAAE;IACzE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAE/B,OAAO;QACL,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,gCAAgC,KAAK,EAAE,CAAC,CAAC,CAAC,qCAAqC;QACpG,QAAQ,EAAE,aAAa,CAAC,sBAAsB,CAAC,KAAK,CAAC,EAAE;YACrD,EAAE,GAAG,EAAE,kCAAkC,EAAE,QAAQ,EAAE,eAAe,EAAE;SACvE,CAAC;KACH,CAAC;AACJ,CAAC,CAAC;AAEF,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,MAAM,kBAAkB,GAAG,CAAC,IAA4B,EAAgB,EAAE;IACxE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,WAAW,CAAC;IAEtC,OAAO;QACL,WAAW,EAAE,cAAc,IAAI,kBAAkB;QACjD,QAAQ,EAAE,aAAa,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE;YACnD,EAAE,GAAG,EAAE,8BAA8B,EAAE,QAAQ,EAAE,eAAe,EAAE;SACnE,CAAC;KACH,CAAC;AACJ,CAAC,CAAC;AAEF,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E,MAAM,iBAAiB,GAAG,CAAC,IAA4B,EAAgB,EAAE;IACvE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,WAAW,CAAC;IAE1C,OAAO;QACL,WAAW,EAAE,8BAA8B,MAAM,SAAS;QAC1D,QAAQ,EAAE,aAAa,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;KAC1D,CAAC;AACJ,CAAC,CAAC;AAEF,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E,MAAM,kBAAkB,GAAG,GAAiB,EAAE,CAAC,CAAC;IAC9C,WAAW,EAAE,2CAA2C;IACxD,QAAQ,EAAE,aAAa,CAAC,qBAAqB,EAAE,EAAE;QAC/C,EAAE,GAAG,EAAE,8BAA8B,EAAE,QAAQ,EAAE,eAAe,EAAE;QAClE,EAAE,GAAG,EAAE,qCAAqC,EAAE,QAAQ,EAAE,eAAe,EAAE;QACzE,EAAE,GAAG,EAAE,kCAAkC,EAAE,QAAQ,EAAE,eAAe,EAAE;QACtE,EAAE,GAAG,EAAE,mCAAmC,EAAE,QAAQ,EAAE,eAAe,EAAE;QACvE,EAAE,GAAG,EAAE,8BAA8B,EAAE,QAAQ,EAAE,eAAe,EAAE;QAClE,EAAE,GAAG,EAAE,0BAA0B,EAAE,QAAQ,EAAE,eAAe,EAAE;QAC9D,EAAE,GAAG,EAAE,oCAAoC,EAAE,QAAQ,EAAE,eAAe,EAAE;KACzE,CAAC;CACH,CAAC,CAAC;AAEH,8EAA8E;AAC9E,8BAA8B;AAC9B,8EAA8E;AAE9E,MAAM,0BAA0B,GAAG,CAAC,IAA4B,EAAgB,EAAE;IAChF,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;IAE7B,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,8BAA8B,IAAI,EAAE,CAAC,CAAC,CAAC,0CAA0C;QACrG,QAAQ,EAAE,aAAa,CAAC,6BAA6B,CAAC,IAAI,CAAC,EAAE;YAC3D,EAAE,GAAG,EAAE,mCAAmC,EAAE,QAAQ,EAAE,eAAe,EAAE;YACvE,EAAE,GAAG,EAAE,qCAAqC,EAAE,QAAQ,EAAE,eAAe,EAAE;YACzE,EAAE,GAAG,EAAE,kCAAkC,EAAE,QAAQ,EAAE,eAAe,EAAE;SACvE,CAAC;KACH,CAAC;AACJ,CAAC,CAAC"}

package/dist/mcp-resources.d.ts

@@ -0,0 +1,53 @@
+/**
+ * MCP resource definitions for the OpenTabs server.
+ *
+ * Resources are static or dynamic documents that AI clients can fetch on demand
+ * via `resources/read`. Unlike instructions (sent on every session), resources
+ * are pull-based — clients discover them via `resources/list` and fetch content
+ * when they need deeper context.
+ *
+ * Static resources return pre-built markdown content (guides, references).
+ * The `opentabs://status` resource is dynamic — built from ServerState at read time.
+ *
+ * Resources include MCP annotations (audience, priority) that help AI clients
+ * decide which resources to auto-include and which to present to users:
+ *   - audience: ['assistant'] — content intended for the AI model
+ *   - audience: ['user', 'assistant'] — content useful for both parties
+ *   - priority: 0.0–1.0 — importance hint (1.0 = effectively required)
+ */
+import type { ServerState } from './state.js';
+/** MCP resource annotations per the 2025-06-18 spec */
+interface ResourceAnnotations {
+    audience?: Array<'user' | 'assistant'>;
+    priority?: number;
+}
+/** A resource definition for MCP resources/list */
+export interface ResourceDefinition {
+    uri: string;
+    name: string;
+    title?: string;
+    description: string;
+    mimeType: string;
+    annotations?: ResourceAnnotations;
+}
+/** A resolved resource for MCP resources/read */
+export interface ResolvedResource {
+    uri: string;
+    mimeType: string;
+    text: string;
+}
+/** Return all resource definitions for resources/list, including annotations. */
+export declare const getAllResources: (_state: ServerState) => ResourceDefinition[];
+/**
+ * Resolve a resource by URI, returning its content.
+ * Returns null if the URI is not recognized.
+ */
+export declare const resolveResource: (state: ServerState, uri: string) => ResolvedResource | null;
+/**
+ * Get the text content of a static resource by URI (without needing ServerState).
+ * Returns null for dynamic or unknown resources. Used by prompt resolvers to
+ * embed resource content directly into prompt messages.
+ */
+export declare const getStaticResourceContent: (uri: string) => string | null;
+export {};
+//# sourceMappingURL=mcp-resources.d.ts.map

package/dist/mcp-resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-resources.d.ts","sourceRoot":"","sources":["../src/mcp-resources.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAUH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,uDAAuD;AACvD,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,mDAAmD;AACnD,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,mBAAmB,CAAC;CACnC;AAED,iDAAiD;AACjD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAsFD,iFAAiF;AACjF,eAAO,MAAM,eAAe,GAAI,QAAQ,WAAW,KAAG,kBAAkB,EAQnE,CAAC;AAEN;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,WAAW,EAAE,KAAK,MAAM,KAAG,gBAAgB,GAAG,IAepF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,IAAoC,CAAC"}