@forwardreach/saas-mcp 0.1.0

package/dist/react/McpToolReference.d.ts

@@ -0,0 +1,17 @@
+import type { McpPromptDescriptor, McpResourceDescriptor, McpScopeDefinition, McpScopeValue, McpToolDescriptor } from "../core/types.js";
+/** Props for the full tools & capabilities reference. */
+export interface McpToolReferenceProps<S extends McpScopeValue = McpScopeValue> {
+    /** Product-supported MCP scopes with descriptions. */
+    scopes: McpScopeDefinition<S>[];
+    /** Product-owned MCP tool descriptors; grouped by read/write, with anything else under "Other". */
+    tools: McpToolDescriptor<S>[];
+    /** MCP resources exposed by the product. */
+    resources?: McpResourceDescriptor<S>[];
+    /** MCP prompts exposed by the product. */
+    prompts?: McpPromptDescriptor<S>[];
+}
+/**
+ * Full reference for the MCP surface: scopes, tools grouped by read/write, and
+ * any resources and prompts. Presentational — reflects the current registry.
+ */
+export declare function McpToolReference<S extends McpScopeValue = McpScopeValue>({ scopes, tools, resources, prompts, }: McpToolReferenceProps<S>): import("react/jsx-runtime").JSX.Element;

package/dist/react/McpToolReference.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { SettingsSection } from "@forwardreach/saas-ui";
+/**
+ * Full reference for the MCP surface: scopes, tools grouped by read/write, and
+ * any resources and prompts. Presentational — reflects the current registry.
+ */
+export function McpToolReference({ scopes, tools, resources = [], prompts = [], }) {
+    // Every tool must land in exactly one group so nothing is silently dropped:
+    // tools without a read/write activity kind (e.g. `management` or unset) fall
+    // into "Other", which only renders when it has members.
+    const otherTools = tools.filter((tool) => tool.activityKind !== "read" && tool.activityKind !== "write");
+    const toolGroups = [
+        { label: "Read", group: tools.filter((tool) => tool.activityKind === "read") },
+        { label: "Write", group: tools.filter((tool) => tool.activityKind === "write") },
+        ...(otherTools.length > 0 ? [{ label: "Other", group: otherTools }] : []),
+    ];
+    return (_jsxs("div", { className: "space-y-5", children: [_jsx(SettingsSection, { description: "Permissions an AI client requests and you approve during connection.", title: "Scopes", children: _jsx("div", { className: "space-y-2", children: scopes.map((scope) => (_jsxs("div", { className: "rounded-[var(--ssui-radius)] border border-[color:var(--ssui-border)] p-3", children: [_jsx("div", { className: "text-sm font-medium", children: scope.title }), _jsx("div", { className: "mt-1 text-xs text-[color:var(--ssui-text-muted)]", children: scope.description }), _jsx("div", { className: "mt-2 font-mono text-xs text-[color:var(--ssui-text-subtle)]", children: scope.scope })] }, scope.scope))) }) }), _jsx(SettingsSection, { description: "Every tool an AI client can call, grouped by read and write behavior (other tools listed under Other).", title: "Tools", children: _jsx("div", { className: "grid gap-2", children: toolGroups.map(({ label, group }) => (_jsxs("div", { className: "rounded-[var(--ssui-radius)] border border-[color:var(--ssui-border)]", children: [_jsx("div", { className: "border-b border-[color:var(--ssui-border)] px-3 py-2 text-xs font-medium uppercase text-[color:var(--ssui-text-muted)]", children: label }), _jsx("div", { className: "divide-y divide-[color:var(--ssui-border)]", children: group.length === 0 ? (_jsxs("div", { className: "px-3 py-2 text-xs text-[color:var(--ssui-text-muted)]", children: ["No ", label.toLowerCase(), " tools."] })) : (group.map((tool) => (_jsxs("div", { className: "px-3 py-2", children: [_jsx("div", { className: "text-sm font-medium", children: tool.title }), _jsx("div", { className: "mt-1 text-xs text-[color:var(--ssui-text-muted)]", children: tool.description }), _jsx("div", { className: "mt-1 font-mono text-xs text-[color:var(--ssui-text-subtle)]", children: tool.name })] }, tool.name)))) })] }, label))) }) }), (resources.length > 0 || prompts.length > 0) && (_jsxs("div", { className: "grid gap-5 md:grid-cols-2", children: [resources.length > 0 && (_jsx(SettingsSection, { description: "Cacheable context an AI client can read.", title: "Resources", children: _jsx("div", { className: "divide-y divide-[color:var(--ssui-border)] rounded-[var(--ssui-radius)] border border-[color:var(--ssui-border)]", children: resources.map((resource) => (_jsxs("div", { className: "px-3 py-2", children: [_jsx("div", { className: "text-sm font-medium", children: resource.title }), _jsx("div", { className: "mt-1 text-xs text-[color:var(--ssui-text-muted)]", children: resource.description }), _jsx("div", { className: "mt-1 font-mono text-xs text-[color:var(--ssui-text-subtle)]", children: resource.uri })] }, resource.uri))) }) })), prompts.length > 0 && (_jsx(SettingsSection, { description: "Guided workflows an AI client can invoke.", title: "Prompts", children: _jsx("div", { className: "divide-y divide-[color:var(--ssui-border)] rounded-[var(--ssui-radius)] border border-[color:var(--ssui-border)]", children: prompts.map((prompt) => (_jsxs("div", { className: "px-3 py-2", children: [_jsx("div", { className: "text-sm font-medium", children: prompt.title }), _jsx("div", { className: "mt-1 text-xs text-[color:var(--ssui-text-muted)]", children: prompt.description }), _jsx("div", { className: "mt-1 font-mono text-xs text-[color:var(--ssui-text-subtle)]", children: prompt.name })] }, prompt.name))) }) }))] }))] }));
+}

package/dist/react/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./McpConsentPanel.js";
+export * from "./McpConnectorOverview.js";
+export * from "./McpConnectedClients.js";
+export * from "./McpDeveloperTokens.js";
+export * from "./McpToolReference.js";
+export * from "./McpActivity.js";

package/dist/react/index.js

@@ -0,0 +1,6 @@
+export * from "./McpConsentPanel.js";
+export * from "./McpConnectorOverview.js";
+export * from "./McpConnectedClients.js";
+export * from "./McpDeveloperTokens.js";
+export * from "./McpToolReference.js";
+export * from "./McpActivity.js";

package/dist/react/mcp-settings-shared.d.ts

@@ -0,0 +1,29 @@
+import { Check } from "lucide-react";
+import { type McpManagementClient } from "../client/management.js";
+import type { McpScopeValue } from "../core/types.js";
+/** Join truthy class fragments. */
+export declare function cx(...values: Array<string | false | null | undefined>): string;
+/** Format an ISO timestamp for settings tables, or "Never" when absent. */
+export declare function formatDate(value: string | null | undefined): string;
+/** Derive a status pill (label, classes, icon) for a token or connection. */
+export declare function statusLabel(item: {
+    revokedAt: string | null;
+    expired?: boolean;
+}): {
+    label: string;
+    className: string;
+    Icon: typeof Check;
+};
+/** Compact list of scope strings rendered as monospace pills. */
+export declare function ScopePills<S extends McpScopeValue>({ scopes }: {
+    scopes: readonly S[];
+}): import("react/jsx-runtime").JSX.Element;
+/** Pretty-printed JSON block used for audit metadata. */
+export declare function JsonBlock({ value }: {
+    value: unknown;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * Resolve the management client for a section: prefer an explicitly provided
+ * client, otherwise create one bound to the workspace's default routes.
+ */
+export declare function useMcpManagementClient<S extends McpScopeValue = McpScopeValue>(workspaceId: string, managementClient?: McpManagementClient<S>): McpManagementClient<S>;

package/dist/react/mcp-settings-shared.js

@@ -0,0 +1,37 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Check, XCircle } from "lucide-react";
+import * as React from "react";
+import { createMcpManagementClient } from "../client/management.js";
+/** Join truthy class fragments. */
+export function cx(...values) {
+    return values.filter(Boolean).join(" ");
+}
+/** Format an ISO timestamp for settings tables, or "Never" when absent. */
+export function formatDate(value) {
+    if (!value)
+        return "Never";
+    return new Intl.DateTimeFormat(undefined, { dateStyle: "medium", timeStyle: "short" }).format(new Date(value));
+}
+/** Derive a status pill (label, classes, icon) for a token or connection. */
+export function statusLabel(item) {
+    if (item.revokedAt)
+        return { label: "Revoked", className: "bg-red-100 text-red-700", Icon: XCircle };
+    if (item.expired)
+        return { label: "Expired", className: "bg-zinc-100 text-zinc-600", Icon: XCircle };
+    return { label: "Active", className: "bg-emerald-100 text-emerald-700", Icon: Check };
+}
+/** Compact list of scope strings rendered as monospace pills. */
+export function ScopePills({ scopes }) {
+    return (_jsx("div", { className: "flex flex-wrap gap-1", children: scopes.map((scope) => (_jsx("span", { className: "rounded border border-[color:var(--ssui-border)] bg-[color:var(--ssui-surface-muted)] px-1.5 py-0.5 font-mono text-xs text-[color:var(--ssui-text-muted)]", children: scope }, scope))) }));
+}
+/** Pretty-printed JSON block used for audit metadata. */
+export function JsonBlock({ value }) {
+    return (_jsx("pre", { className: "max-h-56 overflow-auto rounded-[var(--ssui-radius)] border border-[color:var(--ssui-border)] bg-[color:var(--ssui-surface-muted)] p-3 font-mono text-xs text-[color:var(--ssui-text-muted)]", children: JSON.stringify(value, null, 2) }));
+}
+/**
+ * Resolve the management client for a section: prefer an explicitly provided
+ * client, otherwise create one bound to the workspace's default routes.
+ */
+export function useMcpManagementClient(workspaceId, managementClient) {
+    return React.useMemo(() => managementClient ?? createMcpManagementClient({ workspaceId }), [managementClient, workspaceId]);
+}

package/package.json

@@ -0,0 +1,98 @@
+{
+  "name": "@forwardreach/saas-mcp",
+  "version": "0.1.0",
+  "description": "Shared MCP contracts, OAuth helpers, Hono route plumbing, management client, and React UI for ForwardReach SaaS applications.",
+  "type": "module",
+  "private": false,
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/forwardreach/saas-shared.git",
+    "directory": "packages/saas-mcp"
+  },
+  "homepage": "https://github.com/forwardreach/saas-shared/tree/main/packages/saas-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/forwardreach/saas-shared/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js"
+    },
+    "./node": {
+      "types": "./dist/node/index.d.ts",
+      "import": "./dist/node/index.js"
+    },
+    "./hono": {
+      "types": "./dist/hono/index.d.ts",
+      "import": "./dist/hono/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "peerDependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@forwardreach/saas-ui": "^0.4.0",
+    "better-auth": "^1.6.10",
+    "hono": "^4.10.3",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@modelcontextprotocol/sdk": {
+      "optional": true
+    },
+    "better-auth": {
+      "optional": true
+    },
+    "hono": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "lucide-react": "^0.468.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@testing-library/react": "^16.3.0",
+    "@types/node": "^24.9.2",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "better-auth": "^1.6.10",
+    "hono": "^4.12.29",
+    "jsdom": "^26.1.0",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4",
+    "@forwardreach/saas-ui": "0.4.0"
+  },
+  "scripts": {
+    "build": "pnpm clean && tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "clean": "rimraf dist coverage dist-pack *.tgz",
+    "pack:local": "pnpm build && mkdir -p dist-pack && pnpm pack --pack-destination dist-pack",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}