@tinyweb_dev/tracking-mcp-server 0.3.0 → 0.4.1

package/dist/sdk-install/frameworks/node.js

@@ -0,0 +1,98 @@
+/**
+ * Install spec for plain Node.js / TypeScript runtimes.
+ *
+ * Target audience: backend services or CLIs that are NOT using Express /
+ * NestJS. The integration boils down to:
+ *  1. install the `@tinyweb_dev/tracking-nodejs` package
+ *  2. add an `.env` entry for the per-service ingest key
+ *  3. create a singleton tracker module that other modules import
+ *  4. register global error handlers
+ */
+import { API_KEY_PLACEHOLDER } from '../types.js';
+export const NODE_SPEC = {
+    framework: 'node',
+    displayName: 'Node.js (plain)',
+    summary: 'Plain Node.js / TypeScript runtime integration. Installs the core ' +
+        'Tiny Tracking SDK, registers global error handlers, and exposes a ' +
+        'singleton tracker that other modules can import.',
+    supportedVersions: 'Node.js >= 18',
+    packages: [
+        {
+            name: '@tinyweb_dev/tracking-nodejs',
+            version: '^0.1.0',
+            scope: 'dependencies',
+        },
+    ],
+    envVariables: [
+        {
+            name: 'TINY_TRACKING_API_KEY',
+            example: API_KEY_PLACEHOLDER,
+            required: true,
+            description: 'Per-service ingest key from Project → Services → <your service> ' +
+                '(prefixed `tt_svc_`). Rotate independently per runtime.',
+        },
+        {
+            name: 'NODE_ENV',
+            example: 'production',
+            required: false,
+            description: 'Reported on every captured error as the `environment` tag. ' +
+                'Useful to filter prod vs staging in the dashboard.',
+        },
+    ],
+    fileChanges: [
+        {
+            path: '.env',
+            action: 'append',
+            description: 'Add the Tiny Tracking ingest key so the SDK can find it at ' +
+                'startup. Do NOT commit `.env`; commit `.env.example` with ' +
+                'placeholder values instead. The SDK defaults to the public Tiny ' +
+                'Tracking endpoint — no extra config needed.',
+            language: 'dotenv',
+            snippet: '# Tiny Tracking\n' + `TINY_TRACKING_API_KEY=${API_KEY_PLACEHOLDER}\n`,
+        },
+        {
+            path: 'src/tracking.ts',
+            action: 'create',
+            description: 'Singleton tracker module. Import this from anywhere in the app ' +
+                'to capture errors with the same configuration; calling code does ' +
+                'not need to know about API keys or endpoints.',
+            language: 'typescript',
+            snippet: "import TinyTrackingNode, { setupGlobalErrorHandlers } from '@tinyweb_dev/tracking-nodejs';\n\n" +
+                'const apiKey = process.env.TINY_TRACKING_API_KEY;\n' +
+                'if (!apiKey) {\n' +
+                '  // Fail fast in production; in tests you may want to mock this module.\n' +
+                "  throw new Error('TINY_TRACKING_API_KEY is required');\n" +
+                '}\n\n' +
+                'export const tracker = new TinyTrackingNode({\n' +
+                '  apiKey,\n' +
+                "  environment: process.env.NODE_ENV ?? 'production',\n" +
+                '});\n\n' +
+                '// Capture uncaughtException + unhandledRejection automatically.\n' +
+                'setupGlobalErrorHandlers(tracker);\n',
+        },
+        {
+            path: 'src/index.ts',
+            action: 'modify',
+            description: 'Import the tracker module FIRST so global handlers are armed before ' +
+                'any other code runs. Manual captures use the same import.',
+            language: 'typescript',
+            snippet: '// Must be the first import so global error handlers attach before app code.\n' +
+                "import { tracker } from './tracking';\n\n" +
+                '// ... rest of your bootstrap ...\n\n' +
+                '// Example manual capture:\n' +
+                '// try { riskyOp(); } catch (err) {\n' +
+                "//   tracker.captureError(err as Error, { op: 'riskyOp' });\n" +
+                '//   throw err;\n' +
+                '// }\n',
+        },
+    ],
+    verificationCommand: "node -e \"require('./dist/tracking').tracker.captureError(new Error('tiny-tracking install smoke test')); setTimeout(() => process.exit(0), 1000);\"",
+    notes: [
+        'The tracker buffers errors and flushes every 5s by default. Call ' +
+            '`tracker.flush()` before a short-lived process exits, or use ' +
+            '`setupGlobalErrorHandlers` which flushes on shutdown.',
+        'Set `tracker.setUser({ id, email })` once you have an authenticated ' +
+            'user context — captures after that point will be attributed.',
+    ],
+};
+//# sourceMappingURL=node.js.map

package/dist/sdk-install/frameworks/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../../src/sdk-install/frameworks/node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,mBAAmB,EAA6B,MAAM,aAAa,CAAC;AAE7E,MAAM,CAAC,MAAM,SAAS,GAAyB;IAC7C,SAAS,EAAE,MAAM;IACjB,WAAW,EAAE,iBAAiB;IAC9B,OAAO,EACL,oEAAoE;QACpE,oEAAoE;QACpE,kDAAkD;IACpD,iBAAiB,EAAE,eAAe;IAClC,QAAQ,EAAE;QACR;YACE,IAAI,EAAE,8BAA8B;YACpC,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,cAAc;SACtB;KACF;IACD,YAAY,EAAE;QACZ;YACE,IAAI,EAAE,uBAAuB;YAC7B,OAAO,EAAE,mBAAmB;YAC5B,QAAQ,EAAE,IAAI;YACd,WAAW,EACT,kEAAkE;gBAClE,yDAAyD;SAC5D;QACD;YACE,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,YAAY;YACrB,QAAQ,EAAE,KAAK;YACf,WAAW,EACT,6DAA6D;gBAC7D,oDAAoD;SACvD;KACF;IACD,WAAW,EAAE;QACX;YACE,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,QAAQ;YAChB,WAAW,EACT,6DAA6D;gBAC7D,4DAA4D;gBAC5D,kEAAkE;gBAClE,6CAA6C;YAC/C,QAAQ,EAAE,QAAQ;YAClB,OAAO,EAAE,mBAAmB,GAAG,yBAAyB,mBAAmB,IAAI;SAChF;QACD;YACE,IAAI,EAAE,iBAAiB;YACvB,MAAM,EAAE,QAAQ;YAChB,WAAW,EACT,iEAAiE;gBACjE,mEAAmE;gBACnE,+CAA+C;YACjD,QAAQ,EAAE,YAAY;YACtB,OAAO,EACL,gGAAgG;gBAChG,qDAAqD;gBACrD,kBAAkB;gBAClB,4EAA4E;gBAC5E,2DAA2D;gBAC3D,OAAO;gBACP,iDAAiD;gBACjD,aAAa;gBACb,wDAAwD;gBACxD,SAAS;gBACT,oEAAoE;gBACpE,sCAAsC;SACzC;QACD;YACE,IAAI,EAAE,cAAc;YACpB,MAAM,EAAE,QAAQ;YAChB,WAAW,EACT,sEAAsE;gBACtE,2DAA2D;YAC7D,QAAQ,EAAE,YAAY;YACtB,OAAO,EACL,gFAAgF;gBAChF,2CAA2C;gBAC3C,uCAAuC;gBACvC,8BAA8B;gBAC9B,uCAAuC;gBACvC,+DAA+D;gBAC/D,mBAAmB;gBACnB,QAAQ;SACX;KACF;IACD,mBAAmB,EACjB,sJAAsJ;IACxJ,KAAK,EAAE;QACL,mEAAmE;YACjE,+DAA+D;YAC/D,uDAAuD;QACzD,sEAAsE;YACpE,8DAA8D;KACjE;CACF,CAAC"}

package/dist/sdk-install/frameworks/react.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Install spec for React (Vite / Next.js / CRA) applications.
+ *
+ * Wraps the app with `TinyTrackingProvider` + `ErrorBoundary` so any error
+ * thrown during render / lifecycle is captured with the React component
+ * stack attached. Async errors must still be captured manually via the
+ * provided hook helper.
+ */
+import { type FrameworkInstallSpec } from '../types.js';
+export declare const REACT_SPEC: FrameworkInstallSpec;
+//# sourceMappingURL=react.d.ts.map

package/dist/sdk-install/frameworks/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../../src/sdk-install/frameworks/react.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAuB,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAE7E,eAAO,MAAM,UAAU,EAAE,oBA+FxB,CAAC"}

package/dist/sdk-install/frameworks/react.js

@@ -0,0 +1,99 @@
+/**
+ * Install spec for React (Vite / Next.js / CRA) applications.
+ *
+ * Wraps the app with `TinyTrackingProvider` + `ErrorBoundary` so any error
+ * thrown during render / lifecycle is captured with the React component
+ * stack attached. Async errors must still be captured manually via the
+ * provided hook helper.
+ */
+import { API_KEY_PLACEHOLDER } from '../types.js';
+export const REACT_SPEC = {
+    framework: 'react',
+    displayName: 'React',
+    summary: 'React integration via `TinyTrackingProvider` + `ErrorBoundary`. Wraps ' +
+        'the app so any error thrown during render / effect is captured with ' +
+        'the React component stack attached.',
+    supportedVersions: 'React ^18.0.0',
+    packages: [
+        {
+            name: '@tinyweb_dev/tracking-react',
+            version: '^0.1.0',
+            scope: 'dependencies',
+        },
+    ],
+    envVariables: [
+        {
+            name: 'VITE_TINY_TRACKING_API_KEY',
+            example: API_KEY_PLACEHOLDER,
+            required: true,
+            description: 'For Vite-based projects. Use `NEXT_PUBLIC_TINY_TRACKING_API_KEY` ' +
+                'for Next.js or `REACT_APP_TINY_TRACKING_API_KEY` for CRA — only the ' +
+                'prefix differs. Tiny Tracking ingest keys ARE safe to expose in ' +
+                'browser bundles (they are per-service write-only ingest keys, not PATs).',
+        },
+    ],
+    fileChanges: [
+        {
+            path: '.env',
+            action: 'append',
+            description: 'Add the public-bundle API key. Rename the prefix to match your ' + 'bundler.',
+            language: 'dotenv',
+            snippet: `VITE_TINY_TRACKING_API_KEY=${API_KEY_PLACEHOLDER}\n`,
+        },
+        {
+            path: 'src/main.tsx',
+            action: 'modify',
+            description: 'Wrap the root `<App />` element with `TinyTrackingProvider` and ' +
+                '`ErrorBoundary` so the provider context is available to every ' +
+                'descendant component via `useTinyTracking()`.',
+            language: 'tsx',
+            snippet: "import React from 'react';\n" +
+                "import ReactDOM from 'react-dom/client';\n" +
+                "import { TinyTrackingProvider, ErrorBoundary } from '@tinyweb_dev/tracking-react';\n" +
+                "import App from './App';\n\n" +
+                "ReactDOM.createRoot(document.getElementById('root')!).render(\n" +
+                '  <React.StrictMode>\n' +
+                '    <TinyTrackingProvider\n' +
+                '      options={{\n' +
+                '        apiKey: import.meta.env.VITE_TINY_TRACKING_API_KEY,\n' +
+                '        environment: import.meta.env.MODE,\n' +
+                '      }}\n' +
+                '    >\n' +
+                '      <ErrorBoundary fallback={<div>Something went wrong.</div>}>\n' +
+                '        <App />\n' +
+                '      </ErrorBoundary>\n' +
+                '    </TinyTrackingProvider>\n' +
+                '  </React.StrictMode>,\n' +
+                ');\n',
+        },
+        {
+            path: 'src/hooks/useReportError.ts',
+            action: 'create',
+            description: 'Optional helper hook for manual captures from event handlers / ' +
+                'async code (places where the ErrorBoundary cannot reach).',
+            language: 'typescript',
+            snippet: "import { useCallback } from 'react';\n" +
+                "import { useTinyTracking } from '@tinyweb_dev/tracking-react';\n\n" +
+                'export function useReportError(): (err: unknown, context?: Record<string, string>) => void {\n' +
+                '  const tracker = useTinyTracking();\n' +
+                '  return useCallback(\n' +
+                '    (err, context) => {\n' +
+                '      if (!tracker) return;\n' +
+                '      tracker.captureError(err instanceof Error ? err : new Error(String(err)), context);\n' +
+                '    },\n' +
+                '    [tracker],\n' +
+                '  );\n' +
+                '}\n',
+        },
+    ],
+    verificationCommand: 'echo "Open the app and intentionally throw inside a component: e.g. add \'throw new Error(tiny-tracking smoke)\' in App.tsx, then verify the error appears in the Tiny Tracking dashboard."',
+    notes: [
+        '`ErrorBoundary` only catches errors thrown during render / lifecycle. ' +
+            'Async errors (promises, setTimeout, event handlers) MUST be captured ' +
+            'manually with `useTinyTracking()` or the `useReportError()` helper.',
+        'For Next.js: replace `import.meta.env.VITE_` with ' +
+            '`process.env.NEXT_PUBLIC_` and place the provider in `app/layout.tsx` ' +
+            '(App Router) or `pages/_app.tsx` (Pages Router).',
+    ],
+};
+//# sourceMappingURL=react.js.map

package/dist/sdk-install/frameworks/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../../../src/sdk-install/frameworks/react.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,mBAAmB,EAA6B,MAAM,aAAa,CAAC;AAE7E,MAAM,CAAC,MAAM,UAAU,GAAyB;IAC9C,SAAS,EAAE,OAAO;IAClB,WAAW,EAAE,OAAO;IACpB,OAAO,EACL,wEAAwE;QACxE,sEAAsE;QACtE,qCAAqC;IACvC,iBAAiB,EAAE,eAAe;IAClC,QAAQ,EAAE;QACR;YACE,IAAI,EAAE,6BAA6B;YACnC,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,cAAc;SACtB;KACF;IACD,YAAY,EAAE;QACZ;YACE,IAAI,EAAE,4BAA4B;YAClC,OAAO,EAAE,mBAAmB;YAC5B,QAAQ,EAAE,IAAI;YACd,WAAW,EACT,mEAAmE;gBACnE,sEAAsE;gBACtE,kEAAkE;gBAClE,0EAA0E;SAC7E;KACF;IACD,WAAW,EAAE;QACX;YACE,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,iEAAiE,GAAG,UAAU;YAC3F,QAAQ,EAAE,QAAQ;YAClB,OAAO,EAAE,8BAA8B,mBAAmB,IAAI;SAC/D;QACD;YACE,IAAI,EAAE,cAAc;YACpB,MAAM,EAAE,QAAQ;YAChB,WAAW,EACT,kEAAkE;gBAClE,gEAAgE;gBAChE,+CAA+C;YACjD,QAAQ,EAAE,KAAK;YACf,OAAO,EACL,8BAA8B;gBAC9B,4CAA4C;gBAC5C,sFAAsF;gBACtF,8BAA8B;gBAC9B,iEAAiE;gBACjE,wBAAwB;gBACxB,6BAA6B;gBAC7B,oBAAoB;gBACpB,+DAA+D;gBAC/D,8CAA8C;gBAC9C,YAAY;gBACZ,SAAS;gBACT,qEAAqE;gBACrE,mBAAmB;gBACnB,0BAA0B;gBAC1B,+BAA+B;gBAC/B,0BAA0B;gBAC1B,MAAM;SACT;QACD;YACE,IAAI,EAAE,6BAA6B;YACnC,MAAM,EAAE,QAAQ;YAChB,WAAW,EACT,iEAAiE;gBACjE,2DAA2D;YAC7D,QAAQ,EAAE,YAAY;YACtB,OAAO,EACL,wCAAwC;gBACxC,oEAAoE;gBACpE,gGAAgG;gBAChG,wCAAwC;gBACxC,yBAAyB;gBACzB,2BAA2B;gBAC3B,+BAA+B;gBAC/B,6FAA6F;gBAC7F,UAAU;gBACV,kBAAkB;gBAClB,QAAQ;gBACR,KAAK;SACR;KACF;IACD,mBAAmB,EACjB,6LAA6L;IAC/L,KAAK,EAAE;QACL,wEAAwE;YACtE,uEAAuE;YACvE,qEAAqE;QACvE,oDAAoD;YAClD,wEAAwE;YACxE,kDAAkD;KACrD;CACF,CAAC"}

package/dist/sdk-install/frameworks/vue.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Install spec for Vue 3 / Nuxt applications.
+ *
+ * Registers `TinyTrackingPlugin` so Vue's global `app.config.errorHandler`
+ * forwards every uncaught error inside a component to Tiny Tracking
+ * automatically. Async errors must still be captured manually via the
+ * provided composable.
+ */
+import { type FrameworkInstallSpec } from '../types.js';
+export declare const VUE_SPEC: FrameworkInstallSpec;
+//# sourceMappingURL=vue.d.ts.map

package/dist/sdk-install/frameworks/vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.d.ts","sourceRoot":"","sources":["../../../src/sdk-install/frameworks/vue.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAuB,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAE7E,eAAO,MAAM,QAAQ,EAAE,oBAgFtB,CAAC"}

package/dist/sdk-install/frameworks/vue.js

@@ -0,0 +1,84 @@
+/**
+ * Install spec for Vue 3 / Nuxt applications.
+ *
+ * Registers `TinyTrackingPlugin` so Vue's global `app.config.errorHandler`
+ * forwards every uncaught error inside a component to Tiny Tracking
+ * automatically. Async errors must still be captured manually via the
+ * provided composable.
+ */
+import { API_KEY_PLACEHOLDER } from '../types.js';
+export const VUE_SPEC = {
+    framework: 'vue',
+    displayName: 'Vue',
+    summary: 'Vue 3 integration via `TinyTrackingPlugin`. Installs a global ' +
+        '`errorHandler` so every uncaught error inside a component is ' +
+        'forwarded to Tiny Tracking automatically.',
+    supportedVersions: 'Vue ^3.0',
+    packages: [
+        {
+            name: '@tinyweb_dev/tracking-vue',
+            version: '^0.1.0',
+            scope: 'dependencies',
+        },
+    ],
+    envVariables: [
+        {
+            name: 'VITE_TINY_TRACKING_API_KEY',
+            example: API_KEY_PLACEHOLDER,
+            required: true,
+            description: 'Public ingest key exposed to the browser bundle. Vite-style env ' +
+                'naming — adjust the prefix for your bundler (`NUXT_PUBLIC_…` for ' +
+                'Nuxt, etc.). Ingest keys are safe to expose.',
+        },
+    ],
+    fileChanges: [
+        {
+            path: '.env',
+            action: 'append',
+            description: 'Add the public API key.',
+            language: 'dotenv',
+            snippet: `VITE_TINY_TRACKING_API_KEY=${API_KEY_PLACEHOLDER}\n`,
+        },
+        {
+            path: 'src/main.ts',
+            action: 'modify',
+            description: 'Register `TinyTrackingPlugin` with `app.use(...)` — it installs ' +
+                "`app.config.errorHandler` and provides the tracker via Vue's DI " +
+                'so descendants can call `useTinyTracking()`.',
+            language: 'typescript',
+            snippet: "import { createApp } from 'vue';\n" +
+                "import { TinyTrackingPlugin } from '@tinyweb_dev/tracking-vue';\n" +
+                "import App from './App.vue';\n\n" +
+                'const app = createApp(App);\n\n' +
+                'app.use(TinyTrackingPlugin, {\n' +
+                '  apiKey: import.meta.env.VITE_TINY_TRACKING_API_KEY,\n' +
+                '  environment: import.meta.env.MODE,\n' +
+                '});\n\n' +
+                "app.mount('#app');\n",
+        },
+        {
+            path: 'src/composables/useReportError.ts',
+            action: 'create',
+            description: 'Optional composable for manual captures from event handlers / ' +
+                "async code where Vue's `errorHandler` is not invoked.",
+            language: 'typescript',
+            snippet: "import { useTinyTracking } from '@tinyweb_dev/tracking-vue';\n\n" +
+                'export function useReportError(): (err: unknown, context?: Record<string, string>) => void {\n' +
+                '  const tracker = useTinyTracking();\n' +
+                '  return (err, context) => {\n' +
+                '    if (!tracker) return;\n' +
+                '    tracker.captureError(err instanceof Error ? err : new Error(String(err)), context);\n' +
+                '  };\n' +
+                '}\n',
+        },
+    ],
+    verificationCommand: 'echo "Trigger an error inside a component setup() or template and verify it appears in the Tiny Tracking dashboard."',
+    notes: [
+        "Vue's global `errorHandler` catches synchronous render errors and " +
+            'errors propagated from `onErrorCaptured`. Async errors (promises, ' +
+            'event handlers) need manual capture via the composable.',
+        'For Nuxt 3: register the plugin via `plugins/tiny-tracking.client.ts` ' +
+            'and gate it on `process.client` to avoid SSR token leaks.',
+    ],
+};
+//# sourceMappingURL=vue.js.map

package/dist/sdk-install/frameworks/vue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.js","sourceRoot":"","sources":["../../../src/sdk-install/frameworks/vue.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,mBAAmB,EAA6B,MAAM,aAAa,CAAC;AAE7E,MAAM,CAAC,MAAM,QAAQ,GAAyB;IAC5C,SAAS,EAAE,KAAK;IAChB,WAAW,EAAE,KAAK;IAClB,OAAO,EACL,gEAAgE;QAChE,+DAA+D;QAC/D,2CAA2C;IAC7C,iBAAiB,EAAE,UAAU;IAC7B,QAAQ,EAAE;QACR;YACE,IAAI,EAAE,2BAA2B;YACjC,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,cAAc;SACtB;KACF;IACD,YAAY,EAAE;QACZ;YACE,IAAI,EAAE,4BAA4B;YAClC,OAAO,EAAE,mBAAmB;YAC5B,QAAQ,EAAE,IAAI;YACd,WAAW,EACT,kEAAkE;gBAClE,mEAAmE;gBACnE,8CAA8C;SACjD;KACF;IACD,WAAW,EAAE;QACX;YACE,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,yBAAyB;YACtC,QAAQ,EAAE,QAAQ;YAClB,OAAO,EAAE,8BAA8B,mBAAmB,IAAI;SAC/D;QACD;YACE,IAAI,EAAE,aAAa;YACnB,MAAM,EAAE,QAAQ;YAChB,WAAW,EACT,kEAAkE;gBAClE,kEAAkE;gBAClE,8CAA8C;YAChD,QAAQ,EAAE,YAAY;YACtB,OAAO,EACL,oCAAoC;gBACpC,mEAAmE;gBACnE,kCAAkC;gBAClC,iCAAiC;gBACjC,iCAAiC;gBACjC,yDAAyD;gBACzD,wCAAwC;gBACxC,SAAS;gBACT,sBAAsB;SACzB;QACD;YACE,IAAI,EAAE,mCAAmC;YACzC,MAAM,EAAE,QAAQ;YAChB,WAAW,EACT,gEAAgE;gBAChE,uDAAuD;YACzD,QAAQ,EAAE,YAAY;YACtB,OAAO,EACL,kEAAkE;gBAClE,gGAAgG;gBAChG,wCAAwC;gBACxC,gCAAgC;gBAChC,6BAA6B;gBAC7B,2FAA2F;gBAC3F,QAAQ;gBACR,KAAK;SACR;KACF;IACD,mBAAmB,EACjB,sHAAsH;IACxH,KAAK,EAAE;QACL,oEAAoE;YAClE,oEAAoE;YACpE,yDAAyD;QAC3D,wEAAwE;YACtE,2DAA2D;KAC9D;CACF,CAAC"}

package/dist/sdk-install/instructions.d.ts

@@ -0,0 +1,43 @@
+/**
+ * SDK installation instructions — slim registry + render helpers.
+ *
+ * Per-framework specs live in `./frameworks/<slug>.ts` and are re-exported
+ * from here so consumers (`prompts/install-sdk.ts`, `tools/sdk-install.ts`)
+ * have a single import surface.
+ *
+ * Why a registry separate from the data files? Two reasons:
+ *  1. Each spec stays under the project-wide 500-line file limit.
+ *  2. New frameworks can be added by dropping a file in `frameworks/` and
+ *     registering it in one place (the `REGISTRY` map below).
+ */
+import { SUPPORTED_FRAMEWORKS, API_KEY_PLACEHOLDER, type FrameworkInstallSpec, type FrameworkSlug } from './types.js';
+export { SUPPORTED_FRAMEWORKS, API_KEY_PLACEHOLDER, type FrameworkInstallSpec, type FrameworkSlug };
+export type { PackageDependency, EnvVariable, FileChange } from './types.js';
+/**
+ * Type guard: is `slug` a supported framework?
+ */
+export declare function isSupportedFramework(slug: string): slug is FrameworkSlug;
+/**
+ * Get the raw spec for a framework, with the API key placeholder still
+ * present in snippets. Throws if the framework is unknown.
+ */
+export declare function getInstallSpec(framework: FrameworkSlug): FrameworkInstallSpec;
+/**
+ * Return a copy of `spec` with `__API_KEY__` replaced by `apiKey` in every
+ * snippet + env example. If `apiKey` is undefined the placeholder is left
+ * intact so the consumer can substitute it later (e.g. agent renders a
+ * prompt before the user has chosen a service).
+ */
+export declare function renderInstallSpec(spec: FrameworkInstallSpec, apiKey?: string): FrameworkInstallSpec;
+/**
+ * Lightweight summary of all supported frameworks — used by the
+ * `sdk_list_supported_frameworks` tool to populate IDE pickers.
+ */
+export declare function listFrameworkSummaries(): Array<{
+    framework: FrameworkSlug;
+    displayName: string;
+    summary: string;
+    supportedVersions: string;
+    packages: string[];
+}>;
+//# sourceMappingURL=instructions.d.ts.map

package/dist/sdk-install/instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/sdk-install/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AAQpB,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,KAAK,oBAAoB,EAAE,KAAK,aAAa,EAAE,CAAC;AACpG,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAc7E;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,aAAa,CAExE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,aAAa,GAAG,oBAAoB,CAM7E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,oBAAoB,EAC1B,MAAM,CAAC,EAAE,MAAM,GACd,oBAAoB,CActB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,KAAK,CAAC;IAC9C,SAAS,EAAE,aAAa,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC,CAWD"}

package/dist/sdk-install/instructions.js

@@ -0,0 +1,86 @@
+/**
+ * SDK installation instructions — slim registry + render helpers.
+ *
+ * Per-framework specs live in `./frameworks/<slug>.ts` and are re-exported
+ * from here so consumers (`prompts/install-sdk.ts`, `tools/sdk-install.ts`)
+ * have a single import surface.
+ *
+ * Why a registry separate from the data files? Two reasons:
+ *  1. Each spec stays under the project-wide 500-line file limit.
+ *  2. New frameworks can be added by dropping a file in `frameworks/` and
+ *     registering it in one place (the `REGISTRY` map below).
+ */
+import { SUPPORTED_FRAMEWORKS, API_KEY_PLACEHOLDER, } from './types.js';
+import { NODE_SPEC } from './frameworks/node.js';
+import { EXPRESS_SPEC } from './frameworks/express.js';
+import { NESTJS_SPEC } from './frameworks/nestjs.js';
+import { REACT_SPEC } from './frameworks/react.js';
+import { VUE_SPEC } from './frameworks/vue.js';
+/* Re-exports for backwards-compat with earlier imports. */
+export { SUPPORTED_FRAMEWORKS, API_KEY_PLACEHOLDER };
+/* ------------------------------------------------------------------ */
+/* Registry                                                            */
+/* ------------------------------------------------------------------ */
+const REGISTRY = {
+    node: NODE_SPEC,
+    express: EXPRESS_SPEC,
+    nestjs: NESTJS_SPEC,
+    react: REACT_SPEC,
+    vue: VUE_SPEC,
+};
+/**
+ * Type guard: is `slug` a supported framework?
+ */
+export function isSupportedFramework(slug) {
+    return SUPPORTED_FRAMEWORKS.includes(slug);
+}
+/**
+ * Get the raw spec for a framework, with the API key placeholder still
+ * present in snippets. Throws if the framework is unknown.
+ */
+export function getInstallSpec(framework) {
+    const spec = REGISTRY[framework];
+    if (!spec) {
+        throw new Error(`No install spec registered for framework "${framework}"`);
+    }
+    return spec;
+}
+/**
+ * Return a copy of `spec` with `__API_KEY__` replaced by `apiKey` in every
+ * snippet + env example. If `apiKey` is undefined the placeholder is left
+ * intact so the consumer can substitute it later (e.g. agent renders a
+ * prompt before the user has chosen a service).
+ */
+export function renderInstallSpec(spec, apiKey) {
+    if (!apiKey)
+        return spec;
+    const replace = (s) => s.split(API_KEY_PLACEHOLDER).join(apiKey);
+    return {
+        ...spec,
+        envVariables: spec.envVariables.map((e) => ({
+            ...e,
+            example: replace(e.example),
+        })),
+        fileChanges: spec.fileChanges.map((f) => ({
+            ...f,
+            snippet: replace(f.snippet),
+        })),
+    };
+}
+/**
+ * Lightweight summary of all supported frameworks — used by the
+ * `sdk_list_supported_frameworks` tool to populate IDE pickers.
+ */
+export function listFrameworkSummaries() {
+    return SUPPORTED_FRAMEWORKS.map((slug) => {
+        const spec = REGISTRY[slug];
+        return {
+            framework: spec.framework,
+            displayName: spec.displayName,
+            summary: spec.summary,
+            supportedVersions: spec.supportedVersions,
+            packages: spec.packages.map((p) => `${p.name}@${p.version}`),
+        };
+    });
+}
+//# sourceMappingURL=instructions.js.map

package/dist/sdk-install/instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/sdk-install/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EACL,oBAAoB,EACpB,mBAAmB,GAGpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,2DAA2D;AAC3D,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAiD,CAAC;AAGpG,wEAAwE;AACxE,yEAAyE;AACzE,wEAAwE;AAExE,MAAM,QAAQ,GAAgD;IAC5D,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,KAAK,EAAE,UAAU;IACjB,GAAG,EAAE,QAAQ;CACd,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAQ,oBAA0C,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACpE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,SAAwB;IACrD,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IACjC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,6CAA6C,SAAS,GAAG,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAA0B,EAC1B,MAAe;IAEf,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,OAAO,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjF,OAAO;QACL,GAAG,IAAI;QACP,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1C,GAAG,CAAC;YACJ,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;SAC5B,CAAC,CAAC;QACH,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACxC,GAAG,CAAC;YACJ,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;SAC5B,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB;IAOpC,OAAO,oBAAoB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACvC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC5B,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;SAC7D,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/sdk-install/types.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Shared types + constants for the SDK install-instructions module.
+ *
+ * Kept in a tiny standalone file so per-framework spec files can import the
+ * types without forming a cycle through the registry barrel.
+ */
+/** Supported framework / runtime slugs. Treated as enum-like string union. */
+export declare const SUPPORTED_FRAMEWORKS: readonly ["node", "express", "nestjs", "react", "vue"];
+export type FrameworkSlug = (typeof SUPPORTED_FRAMEWORKS)[number];
+/**
+ * Literal token used inside snippets where the per-service ingest API key
+ * should be substituted at render time. Kept verbose so it cannot collide
+ * with legitimate source-code tokens.
+ */
+export declare const API_KEY_PLACEHOLDER = "__API_KEY__";
+export interface PackageDependency {
+    /** npm package name, e.g. `@tinyweb_dev/tracking-nodejs`. */
+    name: string;
+    /** Semver range or tag, e.g. `^0.1.0` or `latest`. */
+    version: string;
+    /** Where to put it: `dependencies` vs `peerDependencies`. */
+    scope: 'dependencies' | 'peerDependencies';
+}
+export interface EnvVariable {
+    /** Env var name, e.g. `TINY_TRACKING_API_KEY`. */
+    name: string;
+    /** Example value (may include the API key placeholder). */
+    example: string;
+    /** Whether the SDK refuses to start without it. */
+    required: boolean;
+    /** Short human description. */
+    description: string;
+}
+export interface FileChange {
+    /**
+     * Relative path inside the target project, e.g. `src/app.module.ts` or
+     * `.env`. Always POSIX-style separators.
+     */
+    path: string;
+    /**
+     * Action hint for the agent:
+     *  - `create` — file does not exist; create with the snippet as full content
+     *  - `modify` — file exists; merge the snippet (the agent must reconcile)
+     *  - `append` — append snippet to the end of the file (typical for `.env`)
+     */
+    action: 'create' | 'modify' | 'append';
+    /** Human-readable explanation of WHY this file is touched. */
+    description: string;
+    /**
+     * Code snippet. May contain the literal token `__API_KEY__` which is
+     * substituted at render time when an apiKey is supplied.
+     */
+    snippet: string;
+    /** Optional language hint for fenced markdown rendering, e.g. `typescript`. */
+    language?: string;
+}
+export interface FrameworkInstallSpec {
+    /** Framework slug — matches `FrameworkSlug`. */
+    framework: FrameworkSlug;
+    /** Pretty name shown to humans, e.g. `NestJS`. */
+    displayName: string;
+    /** One-paragraph elevator pitch shown at the top of the instructions. */
+    summary: string;
+    /** Minimum supported runtime / framework versions (free-form). */
+    supportedVersions: string;
+    /** Packages the SDK requires the host project to install. */
+    packages: PackageDependency[];
+    /** Environment variables the SDK reads. */
+    envVariables: EnvVariable[];
+    /** Ordered list of file changes the agent should perform. */
+    fileChanges: FileChange[];
+    /**
+     * A single shell command (or short pipeline) the developer can run to
+     * verify the integration triggers an error capture. Kept intentionally
+     * minimal so the agent can suggest it verbatim.
+     */
+    verificationCommand: string;
+    /**
+     * Free-form "watch out for" notes shown at the bottom of the prompt
+     * (e.g. middleware ordering, SSR caveats).
+     */
+    notes: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/sdk-install/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sdk-install/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB,wDAAyD,CAAC;AAE3F,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,gBAAgB,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,KAAK,EAAE,cAAc,GAAG,kBAAkB,CAAC;CAC5C;AAED,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,QAAQ,EAAE,OAAO,CAAC;IAClB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvC,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,SAAS,EAAE,aAAa,CAAC;IACzB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,6DAA6D;IAC7D,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,2CAA2C;IAC3C,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,6DAA6D;IAC7D,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B;;;;OAIG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB"}

package/dist/sdk-install/types.js

@@ -0,0 +1,15 @@
+/**
+ * Shared types + constants for the SDK install-instructions module.
+ *
+ * Kept in a tiny standalone file so per-framework spec files can import the
+ * types without forming a cycle through the registry barrel.
+ */
+/** Supported framework / runtime slugs. Treated as enum-like string union. */
+export const SUPPORTED_FRAMEWORKS = ['node', 'express', 'nestjs', 'react', 'vue'];
+/**
+ * Literal token used inside snippets where the per-service ingest API key
+ * should be substituted at render time. Kept verbose so it cannot collide
+ * with legitimate source-code tokens.
+ */
+export const API_KEY_PLACEHOLDER = '__API_KEY__';
+//# sourceMappingURL=types.js.map

package/dist/sdk-install/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sdk-install/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,8EAA8E;AAC9E,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAU,CAAC;AAI3F;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC"}

package/dist/tools/_helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_helpers.d.ts","sourceRoot":"","sources":["../../src/tools/_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAMzE;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,cAAc,CAS3D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC5E,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,GAC7C,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CA8B5C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,IAAI,CAQN;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CASnG"}
+{"version":3,"file":"_helpers.d.ts","sourceRoot":"","sources":["../../src/tools/_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAMzE;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,cAAc,CAQ3D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC5E,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,GAC7C,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAwB5C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,IAAI,CAQN;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,MAAM,CASR"}

package/dist/tools/_helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"_helpers.js","sourceRoot":"","sources":["../../src/tools/_helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"_helpers.js","sourceRoot":"","sources":["../../src/tools/_helpers.ts"],"names":[],"mappings":"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"}

package/dist/tools/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/tools/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoQ1D"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/tools/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkQ1D"}

package/dist/tools/errors.js

@@ -117,7 +117,7 @@ export function registerErrorTools(server) {
     server.registerTool('error_get_occurrence_neighbors', {
         title: 'Get neighbor occurrences',
         description: 'Return latest / previous / next occurrence ids for an occurrence — used ' +
-            'to navigate through a group\'s history.',
+            "to navigate through a group's history.",
         inputSchema: {
             error_group_id: idSchema,
             occurrence_id: idSchema,