@wootsup/mcp 0.1.0-rc.1

package/dist/modules/apimapper/onboarding.d.ts

@@ -0,0 +1,51 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Connection, Flow, LibraryItem, LicenseStatus } from "./types.js";
+export type SuggestionType = "activate-template" | "publish-flow" | "reconnect-oauth";
+export interface OnboardingSuggestion {
+    type: SuggestionType;
+    label: string;
+    action: string;
+}
+export interface OnboardingSubError {
+    tool: string;
+    error: string;
+}
+export interface OnboardingReport {
+    site: {
+        wp_base: string;
+    };
+    license: Partial<LicenseStatus> & {
+        available: boolean;
+    };
+    connections: {
+        count: number;
+        items: Array<Pick<Connection, "id" | "name" | "source" | "auth_type" | "credential_id">>;
+    };
+    flows: {
+        count: number;
+        published: number;
+        draft: number;
+        items: Array<Pick<Flow, "id" | "name" | "source" | "is_compiled" | "node_count">>;
+    };
+    library: {
+        popular: Array<Pick<LibraryItem, "id" | "name" | "category">>;
+    };
+    suggestions: OnboardingSuggestion[];
+    errors: OnboardingSubError[];
+}
+/**
+ * Pure function — given aggregated state, derive a small list of
+ * suggested next actions. Empty list if nothing useful to suggest.
+ */
+export declare function deriveSuggestions(args: {
+    connections: Connection[];
+    flows: Flow[];
+    expiredOauthCredentialIds: Set<string>;
+    popular: LibraryItem[];
+}): OnboardingSuggestion[];
+/**
+ * Run the five sub-calls in parallel + assemble an OnboardingReport.
+ * Never throws. Sub-call failures land in `errors[]`.
+ */
+export declare function buildOnboardingReport(): Promise<OnboardingReport>;
+export declare function registerOnboardingTool(server: McpServer): void;

package/dist/modules/apimapper/onboarding.js

@@ -0,0 +1,201 @@
+// src/modules/apimapper/onboarding.ts — Phase 8.1 composite tool.
+//
+// `apimapper_onboarding` runs five read-only sub-calls in parallel via
+// `Promise.allSettled` (vs sequential try/catch). Rationale: each sub-call
+// is independent, so parallel cuts latency by ~5×, and `allSettled` gives
+// us per-call success/failure without ever throwing.
+//
+// Partial-failure tolerance: any sub-call that fails (rejected promise OR
+// `success:false` response) is recorded into `errors[]`. The remaining
+// data is still returned. The tool NEVER throws.
+//
+// Suggestion engine: pure function that derives recommended next actions
+// from the aggregated payload. Rules are simple and intentionally narrow —
+// the goal is "show the user a sensible first step", not "complete agent
+// reasoning". When in doubt, suggest nothing.
+import { formatResult, readOnly } from "@getimo/mcp-toolkit";
+import { request, WP_BASE } from "./client.js";
+async function safeRequest(tool, path) {
+    try {
+        const r = await request(path);
+        if (!r.success) {
+            return { tool, data: null, error: r.error || "request failed" };
+        }
+        return { tool, data: (r.data ?? null), error: null };
+    }
+    catch (e) {
+        return {
+            tool,
+            data: null,
+            error: e instanceof Error ? e.message : String(e),
+        };
+    }
+}
+// ── Suggestion rules ───────────────────────────────────────────────────
+/**
+ * Pure function — given aggregated state, derive a small list of
+ * suggested next actions. Empty list if nothing useful to suggest.
+ */
+export function deriveSuggestions(args) {
+    const out = [];
+    // Rule 1: 0 connections AND library has popular items → activate-template.
+    if (args.connections.length === 0 && args.popular.length > 0) {
+        const first = args.popular[0];
+        out.push({
+            type: "activate-template",
+            label: `Activate "${first.name}" from the Library to get started`,
+            action: `apimapper_library_activate id=${first.id}`,
+        });
+    }
+    // Rule 2: 1+ flows created but 0 published → publish-flow.
+    const draftFlow = args.flows.find((f) => !f.is_compiled);
+    const anyPublished = args.flows.some((f) => f.is_compiled);
+    if (draftFlow && !anyPublished) {
+        out.push({
+            type: "publish-flow",
+            label: `Publish flow "${draftFlow.name}" so YOOtheme can see it`,
+            action: `apimapper_flow_full_recompile_publish id=${draftFlow.id}`,
+        });
+    }
+    // Rule 3: any connection whose oauth credential has expired → reconnect-oauth.
+    for (const c of args.connections) {
+        if (c.credential_id && args.expiredOauthCredentialIds.has(c.credential_id)) {
+            out.push({
+                type: "reconnect-oauth",
+                label: `Reconnect "${c.name}" — OAuth credential expired`,
+                action: `apimapper_credential_link credential_id=${c.credential_id}`,
+            });
+        }
+    }
+    return out;
+}
+/**
+ * Run the five sub-calls in parallel + assemble an OnboardingReport.
+ * Never throws. Sub-call failures land in `errors[]`.
+ */
+export async function buildOnboardingReport() {
+    const [health, license, connections, flows, popular] = await Promise.allSettled([
+        safeRequest("apimapper_health", "/connections"),
+        safeRequest("apimapper_license_status", "/license"),
+        safeRequest("apimapper_connection_list", "/connections"),
+        safeRequest("apimapper_flow_list", "/flows"),
+        safeRequest("apimapper_library_popular", "/library/popular?limit=5"),
+    ]);
+    const errors = [];
+    // Helper that pulls .value from a settled promise + records any error.
+    const take = (s) => {
+        if (s.status === "rejected") {
+            // Should not happen — safeRequest swallows. Defensive.
+            errors.push({ tool: "unknown", error: String(s.reason) });
+            return null;
+        }
+        if (s.value.error) {
+            errors.push({ tool: s.value.tool, error: s.value.error });
+            return null;
+        }
+        return s.value.data;
+    };
+    void take(health); // health call is just used to populate errors[]; data unused
+    const licenseData = take(license);
+    const connData = take(connections);
+    const flowData = take(flows);
+    const popularData = take(popular);
+    const allConns = Array.isArray(connData?.connections) ? connData.connections : [];
+    const allFlows = Array.isArray(flowData?.flows) ? flowData.flows : [];
+    const popItems = Array.isArray(popularData?.items) ? popularData.items : [];
+    // ── Conditional second-stage call: credentials, only if any conn has an oauth creds.
+    const oauthCredIds = allConns
+        .filter((c) => (c.auth_type || "").startsWith("oauth2") && c.credential_id)
+        .map((c) => c.credential_id);
+    let expiredOauthCredentialIds = new Set();
+    if (oauthCredIds.length > 0) {
+        const credRes = await safeRequest("apimapper_credential_list", "/credentials");
+        if (credRes.error) {
+            errors.push({ tool: credRes.tool, error: credRes.error });
+        }
+        else {
+            const creds = Array.isArray(credRes.data?.credentials) ? credRes.data.credentials : [];
+            const now = Date.now();
+            expiredOauthCredentialIds = new Set(creds
+                .filter((c) => {
+                if (!c.oauth_token_expires_at)
+                    return false;
+                const t = Date.parse(c.oauth_token_expires_at);
+                return Number.isFinite(t) && t < now;
+            })
+                .map((c) => c.id));
+        }
+    }
+    const published = allFlows.filter((f) => f.is_compiled).length;
+    const draft = allFlows.filter((f) => !f.is_compiled).length;
+    const suggestions = deriveSuggestions({
+        connections: allConns,
+        flows: allFlows,
+        expiredOauthCredentialIds,
+        popular: popItems,
+    });
+    // License: licenseData is the raw /license response; surface known fields.
+    const licMap = (() => {
+        if (!licenseData || typeof licenseData !== "object")
+            return { available: false };
+        const o = licenseData;
+        return {
+            available: true,
+            status: typeof o.status === "string" ? o.status : undefined,
+            tier: typeof o.tier === "string" ? o.tier : undefined,
+            expires_at: typeof o.expires_at === "string" ? o.expires_at : null,
+            beta_channel: typeof o.beta_channel === "boolean" ? o.beta_channel : undefined,
+        };
+    })();
+    return {
+        site: { wp_base: WP_BASE },
+        license: licMap,
+        connections: {
+            count: allConns.length,
+            items: allConns.slice(0, 10).map((c) => ({
+                id: c.id,
+                name: c.name,
+                source: c.source,
+                auth_type: c.auth_type,
+                credential_id: c.credential_id ?? null,
+            })),
+        },
+        flows: {
+            count: allFlows.length,
+            published,
+            draft,
+            items: allFlows.slice(0, 10).map((f) => ({
+                id: f.id,
+                name: f.name,
+                source: f.source,
+                is_compiled: f.is_compiled,
+                node_count: f.node_count,
+            })),
+        },
+        library: {
+            popular: popItems.slice(0, 5).map((p) => ({
+                id: p.id,
+                name: p.name,
+                category: p.category,
+            })),
+        },
+        suggestions,
+        errors,
+    };
+}
+// ── MCP tool registration ──────────────────────────────────────────────
+export function registerOnboardingTool(server) {
+    server.registerTool("apimapper_onboarding", {
+        title: "Onboarding Report (Composite)",
+        description: "Aggregate health, license, connections, flows, and popular library items into a single " +
+            "onboarding report with suggested next actions. Run this first when meeting a new install — " +
+            "tolerates partial failures and never throws." +
+            "\n\nExample:\n  apimapper_onboarding({})",
+        inputSchema: {},
+        annotations: readOnly(),
+    }, async () => {
+        const report = await buildOnboardingReport();
+        return formatResult(report, false, { maxChars: 6000 });
+    });
+}
+//# sourceMappingURL=onboarding.js.map

package/dist/modules/apimapper/onboarding.js.map

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

package/dist/modules/apimapper/schema.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSchemaTools(server: McpServer): void;

package/dist/modules/apimapper/schema.js

@@ -0,0 +1,84 @@
+import { z } from "zod";
+import { formatResult, autoFormatTable, readOnly } from "@getimo/mcp-toolkit";
+import { request, hintFor } from "./client.js";
+export function registerSchemaTools(server) {
+    // ── apimapper_schema_profile ───────────────────────────────────────
+    server.registerTool("apimapper_schema_profile", {
+        title: "Profile Schema from Payload",
+        description: "Analyse a JSON payload and detect field names, types, nullability, sample values, and " +
+            "candidate items_path. Used by the Library Quick-Add to auto-configure new connections." +
+            "\n\nExample:\n  apimapper_schema_profile({ payload: { photos: [{ id: 1, src: { medium: 'https://...' } }] } })",
+        inputSchema: {
+            payload: z.unknown().describe('Any JSON value — typically a sample API response (e.g., {data:[{id:1,title:"..."}]})'),
+            items_path_hint: z
+                .string()
+                .optional()
+                .describe('Optional hint for items_path (e.g., "data", "collection")'),
+        },
+        annotations: readOnly(),
+    }, async ({ payload, items_path_hint }) => {
+        const r = await request("/schema-profile", { method: "POST", body: JSON.stringify({ payload, items_path_hint }) });
+        if (!r.success) {
+            return formatResult({
+                error: r.error,
+                status: r.status,
+                errorCode: r.errorCode,
+                context: { items_path_hint },
+                hint: hintFor(r.errorCode),
+            }, true);
+        }
+        const fields = Array.isArray(r.data?.fields) ? r.data.fields : [];
+        return formatResult({
+            items_path: r.data?.items_path,
+            field_count: fields.length,
+            fields: fields.slice(0, 100),
+            profile: r.data?.profile,
+        }, false, { maxChars: 6000 });
+    });
+    // ── apimapper_node_snapshot_list ───────────────────────────────────
+    server.registerTool("apimapper_node_snapshot_list", {
+        title: "List Node Snapshots",
+        description: "List node-level data snapshots (per-flow/per-node cached payloads used by preview hydrate path)." +
+            "\n\nExample:\n  apimapper_node_snapshot_list({ flow_id: 'flow_Z2fLg70M84' })",
+        inputSchema: {
+            flow_id: z.string().optional().describe("Filter by flow id"),
+            limit: z.number().min(1).max(500).default(50).describe("Max items (1-500)"),
+        },
+        annotations: readOnly(),
+    }, async ({ flow_id, limit }) => {
+        const params = new URLSearchParams();
+        if (flow_id)
+            params.set("flow_id", flow_id);
+        params.set("limit", String(limit));
+        const r = await request(`/node-snapshots?${params.toString()}`);
+        if (!r.success) {
+            return formatResult({
+                error: r.error,
+                status: r.status,
+                errorCode: r.errorCode,
+                context: { flow_id, limit },
+                hint: hintFor(r.errorCode),
+            }, true);
+        }
+        const items = Array.isArray(r.data?.snapshots) ? r.data.snapshots : [];
+        return autoFormatTable(items.map((s) => ({
+            id: s.id,
+            flow_id: s.flow_id || "—",
+            node_id: s.node_id || "—",
+            type: s.type || "—",
+            items: s.item_count ?? "?",
+            created_at: s.created_at || "—",
+        })), {
+            columns: [
+                { key: "id", label: "ID", width: 24 },
+                { key: "flow_id", label: "FLOW", width: 28 },
+                { key: "node_id", label: "NODE", width: 24 },
+                { key: "type", label: "TYPE", width: 10 },
+                { key: "items", label: "N", width: 5 },
+                { key: "created_at", label: "CREATED", width: 22 },
+            ],
+            header: (n) => `${n} snapshots`,
+        });
+    });
+}
+//# sourceMappingURL=schema.js.map

package/dist/modules/apimapper/schema.js.map

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

package/dist/modules/apimapper/settings.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSettingsTools(server: McpServer): void;

package/dist/modules/apimapper/settings.js

@@ -0,0 +1,157 @@
+import { z } from "zod";
+import { formatResult, autoFormatTable, readOnly, mutating, destructive, } from "@getimo/mcp-toolkit";
+import { request, hintFor } from "./client.js";
+export function registerSettingsTools(server) {
+    // ── apimapper_settings_get ─────────────────────────────────────────
+    server.registerTool("apimapper_settings_get", {
+        title: "Get Settings",
+        description: "Fetch all API Mapper plugin settings (telemetry, beta_channel, debug flags, etc.)." +
+            "\n\nExample:\n  apimapper_settings_get({})",
+        inputSchema: {},
+        annotations: readOnly(),
+    }, async () => {
+        const r = await request("/settings");
+        if (!r.success) {
+            return formatResult({ error: r.error, status: r.status, errorCode: r.errorCode, context: {}, hint: hintFor(r.errorCode) }, true);
+        }
+        return formatResult(r.data ?? {}, false, { maxChars: 4000 });
+    });
+    // ── apimapper_settings_update ──────────────────────────────────────
+    server.registerTool("apimapper_settings_update", {
+        title: "Update Settings",
+        description: "Update plugin settings. Only provided keys are changed. " +
+            'Common keys: beta_channel (bool), debug_mode (bool), telemetry_enabled (bool). ' +
+            'Use apimapper_settings_get to inspect the current full set.' +
+            "\n\nExample:\n  apimapper_settings_update({ settings: { telemetry: false, beta_channel: true } })",
+        inputSchema: {
+            patch: z.record(z.string(), z.unknown()).describe('Settings keys to update'),
+        },
+        annotations: mutating(),
+    }, async ({ patch }) => {
+        const r = await request("/settings", {
+            method: "POST",
+            body: JSON.stringify(patch),
+        });
+        if (!r.success) {
+            return formatResult({
+                error: r.error,
+                status: r.status,
+                errorCode: r.errorCode,
+                context: { keys: Object.keys(patch) },
+                hint: hintFor(r.errorCode),
+            }, true);
+        }
+        return formatResult({ updated: true, applied_keys: Object.keys(patch) }, false, { maxChars: 2000 });
+    });
+    // ── apimapper_settings_reset_demo ──────────────────────────────────
+    server.registerTool("apimapper_settings_reset_demo", {
+        title: "Reset Demo Data",
+        description: "Reset demo connections + demo flows back to factory state. Removes user-modifications " +
+            "to demo entries. Does NOT touch user-created connections/flows." +
+            "\n\nExample:\n  apimapper_settings_reset_demo({ confirm: false })",
+        inputSchema: {
+            confirm: z
+                .boolean()
+                .default(false)
+                .describe("Must be true to execute. Ask user for confirmation first."),
+        },
+        annotations: destructive(),
+    }, async ({ confirm }) => {
+        if (!confirm) {
+            return formatResult({
+                preview: true,
+                warning: "DESTRUCTIVE — All demo data resets. User customisations to demo entries are lost.",
+                target: { operation: "reset-demo" },
+                instruction: "Ask user to confirm, then call again with confirm: true.",
+            });
+        }
+        const r = await request("/settings/reset-demo", { method: "POST" });
+        if (!r.success) {
+            return formatResult({ error: r.error, status: r.status, errorCode: r.errorCode, context: {}, hint: hintFor(r.errorCode) }, true);
+        }
+        return formatResult({ reset: true, counts: r.data?.counts }, false, { maxChars: 2000 });
+    });
+    // ── apimapper_features_get ─────────────────────────────────────────
+    server.registerTool("apimapper_features_get", {
+        title: "Get License-Gated Features",
+        description: "Fetch the feature-flag matrix for the current license tier (Free/Pro/Developer)." +
+            "\n\nExample:\n  apimapper_features_get({})",
+        inputSchema: {},
+        annotations: readOnly(),
+    }, async () => {
+        const r = await request("/features");
+        if (!r.success) {
+            return formatResult({ error: r.error, status: r.status, errorCode: r.errorCode, context: {}, hint: hintFor(r.errorCode) }, true);
+        }
+        const features = r.data?.features ?? {};
+        const featureCount = Object.keys(features).length;
+        return formatResult({ tier: r.data?.tier, feature_count: featureCount, features }, false, { maxChars: 4000 });
+    });
+    // ── apimapper_platform_parity ──────────────────────────────────────
+    server.registerTool("apimapper_platform_parity", {
+        title: "Get Platform Parity Status",
+        description: "Compare feature parity between WordPress and Joomla versions of API Mapper." +
+            "\n\nExample:\n  apimapper_platform_parity({})",
+        inputSchema: {},
+        annotations: readOnly(),
+    }, async () => {
+        const r = await request("/platform-parity");
+        if (!r.success) {
+            return formatResult({ error: r.error, status: r.status, errorCode: r.errorCode, context: {}, hint: hintFor(r.errorCode) }, true);
+        }
+        const gaps = Array.isArray(r.data?.gaps) ? r.data.gaps : [];
+        return formatResult({
+            gap_count: gaps.length,
+            wordpress: r.data?.wordpress,
+            joomla: r.data?.joomla,
+            gaps,
+        }, false, { maxChars: 4000 });
+    });
+    // ── apimapper_health_warnings_list ─────────────────────────────────
+    server.registerTool("apimapper_health_warnings_list", {
+        title: "List Health Warnings",
+        description: "List active admin health-warnings (banners shown in the Admin UI)." +
+            "\n\nExample:\n  apimapper_health_warnings_list({})",
+        inputSchema: {},
+        annotations: readOnly(),
+    }, async () => {
+        const r = await request("/admin/health-warnings");
+        if (!r.success) {
+            return formatResult({ error: r.error, status: r.status, errorCode: r.errorCode, context: {}, hint: hintFor(r.errorCode) }, true);
+        }
+        const warnings = Array.isArray(r.data?.warnings) ? r.data.warnings : [];
+        return autoFormatTable(warnings.map((w) => ({
+            id: w.id,
+            severity: w.severity,
+            message: w.message,
+        })), {
+            columns: [
+                { key: "id", label: "ID", width: 24 },
+                { key: "severity", label: "SEVERITY", width: 12 },
+                { key: "message", label: "MESSAGE", width: 60 },
+            ],
+            header: (n) => `${n} active warnings`,
+            footer: "Use apimapper_health_warnings_dismiss <id> to dismiss.",
+        });
+    });
+    // ── apimapper_health_warnings_dismiss ──────────────────────────────
+    server.registerTool("apimapper_health_warnings_dismiss", {
+        title: "Dismiss Health Warning",
+        description: "Dismiss a specific health-warning banner by ID." +
+            "\n\nExample:\n  apimapper_health_warnings_dismiss({ id: 'oauth_refresh_drift' })",
+        inputSchema: {
+            id: z.string().describe("Warning ID. Use apimapper_health_warnings_list to find."),
+        },
+        annotations: mutating(),
+    }, async ({ id }) => {
+        const r = await request("/admin/health-warnings/dismiss", {
+            method: "POST",
+            body: JSON.stringify({ id }),
+        });
+        if (!r.success) {
+            return formatResult({ error: r.error, status: r.status, errorCode: r.errorCode, context: { id }, hint: hintFor(r.errorCode) }, true);
+        }
+        return formatResult({ dismissed: true, id }, false, { maxChars: 1500 });
+    });
+}
+//# sourceMappingURL=settings.js.map

package/dist/modules/apimapper/settings.js.map

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

package/dist/modules/apimapper/skill-resources.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const SKILL_RESOURCE_URIS: readonly ["skill://apimapper/getting-started", "skill://apimapper/oauth", "skill://apimapper/yootheme", "skill://apimapper/joomla", "skill://apimapper/troubleshooting"];
+export type SkillResourceUri = (typeof SKILL_RESOURCE_URIS)[number];
+export declare function registerSkillResources(server: McpServer, rootDir?: string): void;

package/dist/modules/apimapper/skill-resources.js

@@ -0,0 +1,85 @@
+// src/modules/apimapper/skill-resources.ts — Phase 7.3.
+//
+// Exposes the bundled apimapper skill docs as MCP resources at stable
+// skill://apimapper/<topic> URIs. Each resource serves a markdown file from
+// packages/apimapper-mcp/skills/apimapper/ as text/markdown.
+//
+// MCP clients that support resource discovery (Claude Code, ChatGPT, Cursor)
+// can list + read these without invoking a tool, so the skill docs are
+// accessible both via tool (apimapper_get_skill, Phase 7.4) and resource.
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join, resolve } from "node:path";
+export const SKILL_RESOURCE_URIS = [
+    "skill://apimapper/getting-started",
+    "skill://apimapper/oauth",
+    "skill://apimapper/yootheme",
+    "skill://apimapper/joomla",
+    "skill://apimapper/troubleshooting",
+];
+const RESOURCES = [
+    {
+        uri: "skill://apimapper/getting-started",
+        name: "apimapper-getting-started",
+        title: "API Mapper — Getting Started",
+        description: "Quickstart, common tools, common pitfalls.",
+        fileName: "SKILL.md",
+    },
+    {
+        uri: "skill://apimapper/oauth",
+        name: "apimapper-oauth",
+        title: "API Mapper — OAuth Sources",
+        description: "Wiring OAuth-protected sources (Pexels, Google, Instagram, Notion, ...).",
+        fileName: "reference/oauth.md",
+    },
+    {
+        uri: "skill://apimapper/yootheme",
+        name: "apimapper-yootheme",
+        title: "API Mapper — YOOtheme Dynamic Content",
+        description: "Publish flows as YOOtheme sources; Save-vs-Publish; render-time responsibilities.",
+        fileName: "reference/yootheme.md",
+    },
+    {
+        uri: "skill://apimapper/joomla",
+        name: "apimapper-joomla",
+        title: "API Mapper — Joomla Notes",
+        description: "Joomla 3-tier auth, com_ajax envelope, system plugin layout.",
+        fileName: "reference/joomla.md",
+    },
+    {
+        uri: "skill://apimapper/troubleshooting",
+        name: "apimapper-troubleshooting",
+        title: "API Mapper — Troubleshooting",
+        description: "HTTP status triage, flow issues, credential states, log locations.",
+        fileName: "reference/troubleshooting.md",
+    },
+];
+function defaultSkillsRoot() {
+    // This module is at <pkg-root>/src/modules/apimapper/skill-resources.ts in
+    // dev (or its compiled twin in dist/). Package root is three dirs up.
+    const here = dirname(fileURLToPath(import.meta.url));
+    return resolve(here, "..", "..", "..");
+}
+export function registerSkillResources(server, rootDir) {
+    const baseDir = rootDir ?? defaultSkillsRoot();
+    for (const meta of RESOURCES) {
+        const filePath = join(baseDir, "skills", "apimapper", meta.fileName);
+        server.registerResource(meta.name, meta.uri, {
+            title: meta.title,
+            description: meta.description,
+            mimeType: "text/markdown",
+        }, async (uri) => {
+            const text = readFileSync(filePath, "utf8");
+            return {
+                contents: [
+                    {
+                        uri: uri.toString(),
+                        mimeType: "text/markdown",
+                        text,
+                    },
+                ],
+            };
+        });
+    }
+}
+//# sourceMappingURL=skill-resources.js.map

package/dist/modules/apimapper/skill-resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-resources.js","sourceRoot":"","sources":["../../../src/modules/apimapper/skill-resources.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,EAAE;AACF,sEAAsE;AACtE,4EAA4E;AAC5E,6DAA6D;AAC7D,EAAE;AACF,6EAA6E;AAC7E,uEAAuE;AACvE,0EAA0E;AAG1E,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEnD,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,mCAAmC;IACnC,yBAAyB;IACzB,4BAA4B;IAC5B,0BAA0B;IAC1B,mCAAmC;CAC3B,CAAC;AAYX,MAAM,SAAS,GAAwB;IACrC;QACE,GAAG,EAAE,mCAAmC;QACxC,IAAI,EAAE,2BAA2B;QACjC,KAAK,EAAE,8BAA8B;QACrC,WAAW,EAAE,4CAA4C;QACzD,QAAQ,EAAE,UAAU;KACrB;IACD;QACE,GAAG,EAAE,yBAAyB;QAC9B,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,4BAA4B;QACnC,WAAW,EAAE,0EAA0E;QACvF,QAAQ,EAAE,oBAAoB;KAC/B;IACD;QACE,GAAG,EAAE,4BAA4B;QACjC,IAAI,EAAE,oBAAoB;QAC1B,KAAK,EAAE,uCAAuC;QAC9C,WAAW,EAAE,mFAAmF;QAChG,QAAQ,EAAE,uBAAuB;KAClC;IACD;QACE,GAAG,EAAE,0BAA0B;QAC/B,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,2BAA2B;QAClC,WAAW,EAAE,8DAA8D;QAC3E,QAAQ,EAAE,qBAAqB;KAChC;IACD;QACE,GAAG,EAAE,mCAAmC;QACxC,IAAI,EAAE,2BAA2B;QACjC,KAAK,EAAE,8BAA8B;QACrC,WAAW,EAAE,oEAAoE;QACjF,QAAQ,EAAE,8BAA8B;KACzC;CACF,CAAC;AAEF,SAAS,iBAAiB;IACxB,2EAA2E;IAC3E,sEAAsE;IACtE,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,OAAO,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,OAAgB;IACxE,MAAM,OAAO,GAAG,OAAO,IAAI,iBAAiB,EAAE,CAAC;IAE/C,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrE,MAAM,CAAC,gBAAgB,CACrB,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,GAAG,EACR;YACE,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ,EAAE,eAAe;SAC1B,EACD,KAAK,EAAE,GAAQ,EAAE,EAAE;YACjB,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC5C,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE;wBACnB,QAAQ,EAAE,eAAe;wBACzB,IAAI;qBACL;iBACF;aACF,CAAC;QACJ,CAAC,CACF,CAAC;IACJ,CAAC;AACH,CAAC"}