@socialseal/mcp-server 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,35 @@
+import type { SocialSealConfig, StatusKind, WorkspaceSelection } from "./types.js";
+type FetchLike = typeof fetch;
+export interface SocialSealClientOptions {
+    config: SocialSealConfig;
+    fetchImpl?: FetchLike;
+}
+export declare class SocialSealClient {
+    private readonly config;
+    private readonly fetchImpl;
+    constructor(options: SocialSealClientOptions);
+    getCurrentWorkspace(explicitWorkspaceId?: string | null): WorkspaceSelection;
+    requireWorkspace(explicitWorkspaceId?: string | null): WorkspaceSelection & {
+        workspaceId: string;
+    };
+    listWorkspaces(): Promise<unknown>;
+    callTool(toolName: string, body: Record<string, unknown>, options?: {
+        workspaceId?: string | null;
+        async?: boolean;
+    }): Promise<unknown>;
+    getStatus(options: {
+        id: string | number;
+        kind: StatusKind;
+        workspaceId?: string | null;
+        includeResults?: boolean;
+        resultsLimit?: number;
+    }): Promise<unknown>;
+    exportTrackingData(body: Record<string, unknown>, workspaceId?: string | null): Promise<unknown>;
+    exportReport(body: Record<string, unknown>, workspaceId?: string | null): Promise<unknown>;
+    private readAgentToolJobStatus;
+    private readSearchJourneyRunStatus;
+    private readGoogleAiRunStatus;
+    private request;
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAanF,KAAK,SAAS,GAAG,OAAO,KAAK,CAAC;AAE9B,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAeD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAE1B,OAAO,EAAE,uBAAuB;IAK5C,mBAAmB,CAAC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,kBAAkB;IAW5E,gBAAgB,CAAC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,kBAAkB,GAAG;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE;IAW7F,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAQlC,QAAQ,CACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,GAC7D,OAAO,CAAC,OAAO,CAAC;IAyBb,SAAS,CAAC,OAAO,EAAE;QACvB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QACpB,IAAI,EAAE,UAAU,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,OAAO,CAAC;IA2Dd,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAIhG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;YAIlF,sBAAsB;YAItB,0BAA0B;YAQ1B,qBAAqB;YA4BrB,OAAO;CAqCtB"}

package/dist/client.js

@@ -0,0 +1,336 @@
+import { requireApiKey } from "./config.js";
+import { SocialSealMcpError } from "./errors.js";
+import { getToolEntry } from "./registry.js";
+const CLI_KEY_HEADER = "X-CLI-Key";
+const WORKSPACE_HEADER = "X-Workspace-Id";
+const DEFAULT_STATUS_RESULTS_LIMIT = 10;
+const MAX_REQUEST_BODY_BYTES = 200_000;
+const MAX_REQUEST_BODY_DEPTH = 20;
+const MAX_REQUEST_BODY_ITEMS = 5_000;
+const MAX_UPSTREAM_RESPONSE_BYTES = 1_000_000;
+const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+const WORKSPACE_KEY_PATTERN = /^(workspaceId|workspace_id)$/;
+export class SocialSealClient {
+    config;
+    fetchImpl;
+    constructor(options) {
+        this.config = options.config;
+        this.fetchImpl = options.fetchImpl ?? fetch;
+    }
+    getCurrentWorkspace(explicitWorkspaceId) {
+        const normalizedExplicit = normalizeOptionalString(explicitWorkspaceId);
+        if (normalizedExplicit) {
+            return { workspaceId: normalizedExplicit, source: "explicit" };
+        }
+        return {
+            workspaceId: this.config.workspaceId,
+            source: this.config.workspaceSource,
+        };
+    }
+    requireWorkspace(explicitWorkspaceId) {
+        const selection = this.getCurrentWorkspace(explicitWorkspaceId);
+        if (!selection.workspaceId) {
+            throw new SocialSealMcpError("This SocialSeal tool requires a workspace. Set SOCIALSEAL_WORKSPACE_ID or pass workspaceId.", { code: "WORKSPACE_REQUIRED" });
+        }
+        return { ...selection, workspaceId: selection.workspaceId };
+    }
+    async listWorkspaces() {
+        const payload = await this.request("/cli/workspaces", {
+            method: "GET",
+            label: "Workspace discovery",
+        });
+        return unwrapData(payload);
+    }
+    async callTool(toolName, body, options = {}) {
+        const entry = getToolEntry(toolName);
+        if (!entry) {
+            throw new SocialSealMcpError(`Unsupported SocialSeal tool: ${toolName}`, {
+                code: "UNSUPPORTED_TOOL",
+            });
+        }
+        const workspace = entry.workspaceScoped ? this.requireWorkspace(options.workspaceId) : this.getCurrentWorkspace(options.workspaceId);
+        const scopedBody = entry.workspaceScoped
+            ? enforceWorkspaceBody(body, workspace.workspaceId)
+            : body;
+        const payload = options.async === true && toolName === "search-journey-run"
+            ? { ...scopedBody, executionMode: "async" }
+            : scopedBody;
+        return this.request(`/cli/tools/${encodeURIComponent(toolName)}`, {
+            method: "POST",
+            body: payload,
+            workspaceId: workspace.workspaceId,
+            label: `SocialSeal tool ${toolName}`,
+        });
+    }
+    async getStatus(options) {
+        const identifier = parseStatusIdentifier(options.id);
+        const kind = options.kind;
+        const includeResults = options.includeResults === true;
+        const resultsLimit = normalizeResultsLimit(options.resultsLimit);
+        if (kind === "google_ai_run" || (kind === "auto" && identifier.numericId != null)) {
+            if (identifier.numericId == null) {
+                throw new SocialSealMcpError("google_ai_run status expects a numeric run id.", {
+                    code: "INVALID_STATUS_ID",
+                });
+            }
+            return this.readGoogleAiRunStatus(identifier.numericId, includeResults, resultsLimit);
+        }
+        if (kind === "agent_job") {
+            if (!identifier.uuidId) {
+                throw new SocialSealMcpError("agent_job status expects a UUID job id.", {
+                    code: "INVALID_STATUS_ID",
+                });
+            }
+            return this.readAgentToolJobStatus(identifier.uuidId);
+        }
+        if (kind === "journey_run") {
+            if (!identifier.uuidId) {
+                throw new SocialSealMcpError("journey_run status expects a UUID run id.", {
+                    code: "INVALID_STATUS_ID",
+                });
+            }
+            const workspace = this.requireWorkspace(options.workspaceId);
+            return this.readSearchJourneyRunStatus(identifier.uuidId, workspace.workspaceId);
+        }
+        if (!identifier.uuidId) {
+            throw new SocialSealMcpError("auto status expects a numeric id or UUID.", {
+                code: "INVALID_STATUS_ID",
+            });
+        }
+        try {
+            return await this.readAgentToolJobStatus(identifier.uuidId);
+        }
+        catch (error) {
+            if (!(error instanceof SocialSealMcpError) || error.status !== 404) {
+                throw error;
+            }
+        }
+        const workspace = this.getCurrentWorkspace(options.workspaceId);
+        if (workspace.workspaceId) {
+            return this.readSearchJourneyRunStatus(identifier.uuidId, workspace.workspaceId);
+        }
+        throw new SocialSealMcpError(`No matching status record found for ${identifier.rawId}.`, {
+            code: "STATUS_NOT_FOUND",
+            status: 404,
+        });
+    }
+    async exportTrackingData(body, workspaceId) {
+        return this.callTool("export_tracking_data", body, { workspaceId });
+    }
+    async exportReport(body, workspaceId) {
+        return this.callTool("export-report", body, { workspaceId });
+    }
+    async readAgentToolJobStatus(jobId) {
+        return this.callTool("agent-tool-jobs", { action: "status", jobId });
+    }
+    async readSearchJourneyRunStatus(runId, workspaceId) {
+        return this.callTool("search-journey-run", { action: "status", workspaceId, runId }, { workspaceId });
+    }
+    async readGoogleAiRunStatus(runId, includeResults, resultsLimit) {
+        const runsPayload = await this.callTool("get-google-ai-search-runs", {
+            runId,
+            limit: 1,
+            offset: 0,
+        });
+        if (!includeResults) {
+            return runsPayload;
+        }
+        const resultsPayload = await this.callTool("get-google-ai-search-results", {
+            runId,
+            includeCitations: true,
+            limit: resultsLimit,
+            offset: 0,
+        });
+        return {
+            run: runsPayload,
+            results: resultsPayload,
+        };
+    }
+    async request(path, options) {
+        const apiKey = requireApiKey(this.config);
+        const method = (options.method ?? "POST").toUpperCase();
+        const hasBody = method !== "GET" && method !== "HEAD" && options.body !== undefined;
+        const url = new URL(path, `${this.config.apiBase.replace(/\/$/, "")}/`);
+        const headers = new Headers({
+            Accept: "application/json, text/csv, text/plain",
+            [CLI_KEY_HEADER]: apiKey,
+        });
+        if (options.workspaceId)
+            headers.set(WORKSPACE_HEADER, options.workspaceId);
+        if (hasBody)
+            headers.set("Content-Type", "application/json");
+        const serializedBody = hasBody
+            ? serializeRequestBodyLimited(options.body, options.label)
+            : undefined;
+        let response;
+        try {
+            response = await this.fetchImpl(url, {
+                method,
+                headers,
+                body: serializedBody,
+                signal: AbortSignal.timeout(this.config.timeoutMs),
+            });
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === "TimeoutError") {
+                throw new SocialSealMcpError(`${options.label} timed out.`, { code: "TIMEOUT" });
+            }
+            throw error;
+        }
+        if (!response.ok) {
+            throw await buildHttpError(response, options.label);
+        }
+        return readResponseBody(response, options.label);
+    }
+}
+function normalizeOptionalString(value) {
+    if (typeof value !== "string")
+        return null;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+function unwrapData(payload) {
+    if (payload && typeof payload === "object" && "data" in payload) {
+        return payload.data;
+    }
+    return payload;
+}
+function parseStatusIdentifier(id) {
+    const rawId = String(id).trim();
+    const parsedNumericId = /^\d+$/.test(rawId) ? Number(rawId) : null;
+    if (parsedNumericId != null && !Number.isSafeInteger(parsedNumericId)) {
+        throw new SocialSealMcpError("Status id must be a safe integer or UUID.", {
+            code: "INVALID_STATUS_ID",
+        });
+    }
+    return {
+        rawId,
+        numericId: parsedNumericId,
+        uuidId: UUID_PATTERN.test(rawId) ? rawId : null,
+    };
+}
+function normalizeResultsLimit(value) {
+    if (value == null)
+        return DEFAULT_STATUS_RESULTS_LIMIT;
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+        throw new SocialSealMcpError("resultsLimit must be a positive integer.", {
+            code: "INVALID_RESULTS_LIMIT",
+        });
+    }
+    return Math.min(parsed, 50);
+}
+async function readResponseBody(response, label) {
+    const contentType = response.headers.get("content-type") ?? "";
+    const raw = await readResponseTextLimited(response, label);
+    if (!raw)
+        return null;
+    if (contentType.includes("application/json")) {
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            throw new SocialSealMcpError(`${label} returned malformed JSON.`, {
+                code: "MALFORMED_RESPONSE",
+            });
+        }
+    }
+    return raw;
+}
+async function buildHttpError(response, label) {
+    const details = await readResponseBody(response, label).catch(() => null);
+    return new SocialSealMcpError(`${label} failed.`, {
+        code: "HTTP_ERROR",
+        status: response.status,
+        details,
+    });
+}
+async function readResponseTextLimited(response, label) {
+    const contentLength = response.headers.get("content-length");
+    if (contentLength && Number(contentLength) > MAX_UPSTREAM_RESPONSE_BYTES) {
+        throw new SocialSealMcpError(`${label} response is too large for MCP output.`, {
+            code: "UPSTREAM_RESPONSE_TOO_LARGE",
+        });
+    }
+    if (!response.body)
+        return response.text();
+    const reader = response.body.getReader();
+    const chunks = [];
+    let receivedBytes = 0;
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        receivedBytes += value.byteLength;
+        if (receivedBytes > MAX_UPSTREAM_RESPONSE_BYTES) {
+            await reader.cancel();
+            throw new SocialSealMcpError(`${label} response is too large for MCP output.`, {
+                code: "UPSTREAM_RESPONSE_TOO_LARGE",
+            });
+        }
+        chunks.push(value);
+    }
+    return new TextDecoder().decode(concatChunks(chunks, receivedBytes));
+}
+function concatChunks(chunks, totalLength) {
+    const combined = new Uint8Array(totalLength);
+    let offset = 0;
+    for (const chunk of chunks) {
+        combined.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return combined;
+}
+function serializeRequestBodyLimited(value, label) {
+    assertRequestBodyBudget(value, label);
+    const serialized = JSON.stringify(value);
+    if (serialized.length > MAX_REQUEST_BODY_BYTES) {
+        throw new SocialSealMcpError(`${label} request body is too large.`, {
+            code: "REQUEST_BODY_TOO_LARGE",
+        });
+    }
+    return serialized;
+}
+function assertRequestBodyBudget(value, label, depth = 0, state = { items: 0 }) {
+    if (depth > MAX_REQUEST_BODY_DEPTH) {
+        throw new SocialSealMcpError(`${label} request body is too deeply nested.`, {
+            code: "REQUEST_BODY_TOO_DEEP",
+        });
+    }
+    if (!value || typeof value !== "object")
+        return;
+    const entries = Array.isArray(value) ? value : Object.values(value);
+    state.items += entries.length;
+    if (state.items > MAX_REQUEST_BODY_ITEMS) {
+        throw new SocialSealMcpError(`${label} request body has too many fields/items.`, {
+            code: "REQUEST_BODY_TOO_LARGE",
+        });
+    }
+    for (const entry of entries) {
+        assertRequestBodyBudget(entry, label, depth + 1, state);
+    }
+}
+function enforceWorkspaceBody(body, workspaceId) {
+    if (!workspaceId)
+        return body;
+    assertNoConflictingWorkspace(body, workspaceId, "body");
+    return "workspaceId" in body ? body : { ...body, workspaceId };
+}
+function assertNoConflictingWorkspace(value, workspaceId, path) {
+    if (!value || typeof value !== "object")
+        return;
+    if (Array.isArray(value)) {
+        value.forEach((entry, index) => assertNoConflictingWorkspace(entry, workspaceId, `${path}[${index}]`));
+        return;
+    }
+    for (const [key, entry] of Object.entries(value)) {
+        if (WORKSPACE_KEY_PATTERN.test(key)) {
+            const entryWorkspaceId = normalizeOptionalString(entry);
+            if (entryWorkspaceId && entryWorkspaceId !== workspaceId) {
+                throw new SocialSealMcpError(`Workspace mismatch at ${path}.${key}; use the resolved workspace ${workspaceId}.`, { code: "WORKSPACE_MISMATCH" });
+            }
+        }
+        assertNoConflictingWorkspace(entry, workspaceId, `${path}.${key}`);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,11 @@
+import type { SocialSealConfig } from "./types.js";
+export declare const DEFAULT_CONFIG_PATH: string;
+interface ConfigResolverOptions {
+    env?: NodeJS.ProcessEnv;
+    readFile?: (filePath: string) => string;
+    homeDir?: string;
+}
+export declare function resolveConfig(options?: ConfigResolverOptions): SocialSealConfig;
+export declare function requireApiKey(config: SocialSealConfig): string;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAc,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAM/D,eAAO,MAAM,mBAAmB,QAK/B,CAAC;AAEF,UAAU,qBAAqB;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA8CD,wBAAgB,aAAa,CAAC,OAAO,GAAE,qBAA0B,GAAG,gBAAgB,CAuBnF;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAQ9D"}

package/dist/config.js

@@ -0,0 +1,78 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { SocialSealMcpError } from "./errors.js";
+const DEFAULT_API_BASE = "https://api.socialseal.co";
+const DEFAULT_TIMEOUT_MS = 15_000;
+const MAX_TIMEOUT_MS = 15_000;
+export const DEFAULT_CONFIG_PATH = path.join(os.homedir(), ".config", "socialseal", "config.json");
+function trimString(value) {
+    if (typeof value !== "string")
+        return null;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+function parseTimeoutMs(value, fallback) {
+    const raw = typeof value === "number" ? value : trimString(value);
+    if (raw == null || raw === "")
+        return fallback;
+    const parsed = Number(raw);
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+        throw new SocialSealMcpError("Invalid SocialSeal timeout value.", {
+            code: "INVALID_TIMEOUT",
+        });
+    }
+    return Math.min(parsed, MAX_TIMEOUT_MS);
+}
+function readConfigFile(configPath, readFile) {
+    try {
+        const raw = readFile(configPath);
+        if (!raw.trim())
+            return {};
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+            throw new SocialSealMcpError("SocialSeal config file must contain a JSON object.", {
+                code: "INVALID_CONFIG",
+            });
+        }
+        return parsed;
+    }
+    catch (error) {
+        if (error instanceof SocialSealMcpError)
+            throw error;
+        if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") {
+            return {};
+        }
+        if (error instanceof SyntaxError) {
+            throw new SocialSealMcpError("SocialSeal config file contains invalid JSON.", {
+                code: "INVALID_CONFIG_JSON",
+            });
+        }
+        throw error;
+    }
+}
+export function resolveConfig(options = {}) {
+    const env = options.env ?? process.env;
+    const readFile = options.readFile ?? ((filePath) => fs.readFileSync(filePath, "utf8"));
+    const configPath = trimString(env.SOCIALSEAL_CONFIG) ??
+        path.join(options.homeDir ?? os.homedir(), ".config", "socialseal", "config.json");
+    const fileConfig = readConfigFile(configPath, readFile);
+    const envWorkspaceId = trimString(env.SOCIALSEAL_WORKSPACE_ID);
+    const configWorkspaceId = trimString(fileConfig.workspaceId);
+    const workspaceId = envWorkspaceId ?? configWorkspaceId;
+    return {
+        apiBase: trimString(env.SOCIALSEAL_API_BASE) ?? trimString(fileConfig.apiBase) ?? DEFAULT_API_BASE,
+        apiKey: trimString(env.SOCIALSEAL_API_KEY) ?? trimString(fileConfig.apiKey),
+        workspaceId,
+        timeoutMs: parseTimeoutMs(env.SOCIALSEAL_TIMEOUT_MS ?? fileConfig.timeoutMs, DEFAULT_TIMEOUT_MS),
+        configPath,
+        workspaceSource: envWorkspaceId ? "env" : configWorkspaceId ? "config" : "none",
+    };
+}
+export function requireApiKey(config) {
+    if (!config.apiKey) {
+        throw new SocialSealMcpError("Missing SocialSeal API key. Set SOCIALSEAL_API_KEY or apiKey in the SocialSeal config file.", { code: "MISSING_API_KEY" });
+    }
+    return config.apiKey;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,13 @@
+export declare class SocialSealMcpError extends Error {
+    readonly code: string;
+    readonly status?: number;
+    readonly details?: unknown;
+    constructor(message: string, options: {
+        code: string;
+        status?: number;
+        details?: unknown;
+    });
+}
+export declare function redactSecrets(value: unknown): unknown;
+export declare function formatError(error: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;gBAGzB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE;CAQhE;AAID,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAarD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CASlD"}

package/dist/errors.js

@@ -0,0 +1,37 @@
+export class SocialSealMcpError extends Error {
+    code;
+    status;
+    details;
+    constructor(message, options) {
+        super(message);
+        this.name = "SocialSealMcpError";
+        this.code = options.code;
+        this.status = options.status;
+        this.details = redactSecrets(options.details);
+    }
+}
+const SECRET_KEY_PATTERN = /(?:api[_-]?key|cli[_-]?key|authorization|token|secret|password)/i;
+export function redactSecrets(value) {
+    if (Array.isArray(value)) {
+        return value.map((entry) => redactSecrets(entry));
+    }
+    if (!value || typeof value !== "object") {
+        return value;
+    }
+    const redacted = {};
+    for (const [key, entry] of Object.entries(value)) {
+        redacted[key] = SECRET_KEY_PATTERN.test(key) ? "[redacted]" : redactSecrets(entry);
+    }
+    return redacted;
+}
+export function formatError(error) {
+    if (error instanceof SocialSealMcpError) {
+        const suffix = error.status ? ` (HTTP ${error.status})` : "";
+        return `${error.message}${suffix} [${error.code}]`;
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return "Unknown SocialSeal MCP error.";
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,CAAS;IACb,MAAM,CAAU;IAChB,OAAO,CAAW;IAE3B,YACE,OAAe,EACf,OAA6D;QAE7D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;CACF;AAED,MAAM,kBAAkB,GAAG,kEAAkE,CAAC;AAE9F,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,QAAQ,CAAC,GAAG,CAAC,GAAG,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,OAAO,GAAG,KAAK,CAAC,OAAO,GAAG,MAAM,KAAK,KAAK,CAAC,IAAI,GAAG,CAAC;IACrD,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,OAAO,+BAA+B,CAAC;AACzC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createSocialSealMcpServer } from "./server.js";
+async function main() {
+    const server = createSocialSealMcpServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : "Unknown SocialSeal MCP startup error.";
+    process.stderr.write(`[socialseal-mcp] ${message}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAExD,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,yBAAyB,EAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,uCAAuC,CAAC;IACjG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,OAAO,IAAI,CAAC,CAAC;IACtD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,24 @@
+import type { JsonValue } from "./types.js";
+export interface ToolRegistryEntry {
+    name: string;
+    category: string;
+    description: string;
+    workspaceScoped: boolean;
+    notes?: string;
+}
+export interface ToolSchemaHint {
+    summary: string;
+    operations: Array<{
+        action: string;
+        required: string[];
+        optional: string[];
+        example: JsonValue;
+    }>;
+    cliExamples: string[];
+}
+export declare const TOOL_REGISTRY: ToolRegistryEntry[];
+export declare const TOOL_SCHEMA_HINTS: Record<string, ToolSchemaHint>;
+export declare function getToolEntry(toolName: string): ToolRegistryEntry | null;
+export declare function listTools(category?: string): ToolRegistryEntry[];
+export declare function getToolSchema(toolName: string): ToolSchemaHint | null;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,KAAK,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,OAAO,EAAE,SAAS,CAAC;KACpB,CAAC,CAAC;IACH,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,eAAO,MAAM,aAAa,EAAE,iBAAiB,EAqG5C,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CA6F5D,CAAC;AAIF,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAEvE;AAED,wBAAgB,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAIhE;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAErE"}