@mcpmake/core 0.2.0

package/dist/types/index.d.ts

@@ -0,0 +1,140 @@
+export type HttpMethod = 'get' | 'post' | 'put' | 'patch' | 'delete' | 'head' | 'options';
+export interface ParameterDescriptor {
+    name: string;
+    in: 'path' | 'query' | 'header' | 'cookie';
+    required: boolean;
+    description?: string;
+    schema: JsonSchema;
+}
+export interface RequestBodyDescriptor {
+    required: boolean;
+    description?: string;
+    contentType: string;
+    schema: JsonSchema;
+}
+export interface ResponseDescriptor {
+    statusCode: string;
+    description?: string;
+    contentType?: string;
+    schema?: JsonSchema;
+}
+export interface SecurityRequirement {
+    schemeName: string;
+    scopes: string[];
+}
+export interface McpExtensions {
+    name?: string;
+    description?: string;
+    emit?: 'tool' | 'resource' | 'prompt' | 'skip';
+    scope?: 'read' | 'write' | 'destructive';
+    /** Deprecation message surfaced in tool description */
+    deprecationMessage?: string;
+    /** Replacement tool name for deprecated operations */
+    deprecationReplacement?: string;
+    /** JQ filter expression to trim API responses before returning to agent */
+    jqFilter?: string;
+    /** Allow unknown enum values for forward compatibility */
+    unknownValues?: 'allow' | 'reject';
+}
+export interface OperationDescriptor {
+    operationId: string;
+    method: HttpMethod;
+    path: string;
+    summary?: string;
+    description?: string;
+    tags: string[];
+    parameters: ParameterDescriptor[];
+    requestBody?: RequestBodyDescriptor;
+    responses: ResponseDescriptor[];
+    security: SecurityRequirement[];
+    deprecated: boolean;
+    mcpExtensions?: McpExtensions;
+}
+export interface ToolAnnotations {
+    readOnlyHint?: boolean;
+    destructiveHint?: boolean;
+    idempotentHint?: boolean;
+}
+export interface ToolDefinition {
+    name: string;
+    title: string;
+    description: string;
+    inputSchemaCode: string;
+    outputSchemaCode?: string;
+    operationId: string;
+    method: HttpMethod;
+    pathTemplate: string;
+    pathParams: string[];
+    queryParams: string[];
+    headerParams: string[];
+    hasRequestBody: boolean;
+    requestBodyContentType: string;
+    fileName: string;
+    functionName: string;
+    buildUrlBody: string;
+    annotations?: ToolAnnotations;
+    isAsync?: boolean;
+    isDestructive?: boolean;
+    /** JQ filter to apply to API response before returning to agent */
+    jqFilter?: string;
+}
+export type AuthType = 'apiKey' | 'http-bearer' | 'http-basic' | 'oauth2';
+export interface AuthScheme {
+    type: AuthType;
+    envVarName: string;
+    headerName?: string;
+    in?: 'header' | 'query' | 'cookie';
+    description?: string;
+}
+export interface EnvVarDescriptor {
+    name: string;
+    description: string;
+    required: boolean;
+    example?: string;
+}
+export type TransportMode = 'stdio' | 'http';
+/**
+ * Deployment target for the generated TypeScript server.
+ * `node` (default) emits a Node.js server (stdio or node:http); `cloudflare`
+ * emits a stateless Cloudflare Workers Fetch handler.
+ */
+export type EmitTarget = 'node' | 'cloudflare';
+export interface ResourceDefinition {
+    name: string;
+    uri: string;
+    path: string;
+    description: string;
+    isTemplate?: boolean;
+    templateParams?: string[];
+    urlBody?: string;
+}
+export interface PromptDefinition {
+    name: string;
+    description: string;
+    template: string;
+}
+export interface ProjectManifest {
+    serverName: string;
+    serverVersion: string;
+    baseUrl: string;
+    transport: TransportMode;
+    tools: ToolDefinition[];
+    resources?: ResourceDefinition[];
+    prompts?: PromptDefinition[];
+    authSchemes: AuthScheme[];
+    envVars: EnvVarDescriptor[];
+    dynamicDiscovery?: boolean;
+    staticToolCount?: number;
+    /** Deployment target (default `node`). `cloudflare` emits a Workers project. */
+    target?: EmitTarget;
+    /**
+     * Named base URLs to pre-seed into the generated `.env.example` as
+     * `MCP_ENVIRONMENTS` (a JSON name→URL map). Used by the Stainless importer to
+     * carry over a config's `environments`. Optional — omitted from normal output.
+     */
+    environments?: Record<string, string>;
+    /** The environment selected by default (`API_ENVIRONMENT`). */
+    defaultEnvironment?: string;
+}
+export type JsonSchema = Record<string, unknown>;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/dist/types/site.d.ts

@@ -0,0 +1,285 @@
+/**
+ * Type definitions for the Website-to-MCP pipeline.
+ *
+ * These types represent DOM-based interactions (forms, buttons, links)
+ * rather than HTTP API calls. They form a parallel pipeline to the
+ * existing OperationDescriptor/ToolDefinition types in index.ts.
+ */
+import type { EnvVarDescriptor, TransportMode } from './index.js';
+export type SelectorStrategy = 'data-testid' | 'id' | 'aria-label' | 'name' | 'role' | 'css-path' | 'xpath';
+export interface SelectorSet {
+    /** Best available selector string */
+    primary: string;
+    /** Ordered fallback selectors */
+    fallbacks: string[];
+    /** Strategy used for the primary selector */
+    strategy: SelectorStrategy;
+    /** 0-1 confidence score for selector stability */
+    confidence: number;
+    /** LLM-inferred human-readable label, e.g. "Login button" */
+    humanLabel?: string;
+}
+export type FormFieldType = 'text' | 'email' | 'password' | 'number' | 'tel' | 'url' | 'search' | 'select' | 'checkbox' | 'radio' | 'textarea' | 'hidden' | 'file' | 'date' | 'datetime-local' | 'color' | 'range' | 'other';
+export interface FormFieldDescriptor {
+    /** Form field name attribute */
+    name: string;
+    /** Input type */
+    fieldType: FormFieldType;
+    /** Selector set for this field */
+    selector: SelectorSet;
+    /** Associated <label> text or aria-label */
+    label?: string;
+    /** Placeholder text */
+    placeholder?: string;
+    /** Whether the field is required */
+    required: boolean;
+    /** Options for <select>, radio groups, and datalists */
+    options?: string[];
+    /** Default or current value */
+    defaultValue?: string;
+}
+export interface FormDescriptor {
+    /** Generated stable ID for this form */
+    formId: string;
+    /** Form action URL (if present) */
+    action?: string;
+    /** Form method */
+    method: 'get' | 'post';
+    /** Selector set for the <form> element */
+    selector: SelectorSet;
+    /** Fields within the form */
+    fields: FormFieldDescriptor[];
+    /** Submit button selector */
+    submitButton?: SelectorSet;
+    /** LLM-inferred semantic name, e.g. "login_form", "search_form" */
+    semanticName?: string;
+    /** LLM-inferred description of what this form does */
+    description?: string;
+}
+export interface ButtonDescriptor {
+    /** Generated stable ID */
+    buttonId: string;
+    /** Selector set for the button element */
+    selector: SelectorSet;
+    /** Visible button text */
+    text?: string;
+    /** aria-label value */
+    ariaLabel?: string;
+    /** LLM-inferred action, e.g. "add_to_cart", "submit_order" */
+    semanticAction?: string;
+    /** LLM-inferred description */
+    description?: string;
+    /** Button type */
+    type: 'submit' | 'button' | 'link' | 'other';
+    /** href for link-style buttons */
+    href?: string;
+}
+export interface LinkDescriptor {
+    /** Generated stable ID */
+    linkId: string;
+    /** Selector set for the <a> element */
+    selector: SelectorSet;
+    /** Visible link text */
+    text?: string;
+    /** Link destination */
+    href: string;
+    /** Whether this link navigates to a new page (vs anchor/JS action) */
+    isNavigation: boolean;
+    /** LLM-inferred semantic action */
+    semanticAction?: string;
+}
+export interface PageDescriptor {
+    /** Generated stable ID */
+    pageId: string;
+    /** Canonical URL of the page */
+    url: string;
+    /** URL pattern for parameterized pages (e.g. /products/:id) */
+    urlPattern?: string;
+    /** Page title from <title> or first <h1> */
+    title?: string;
+    /** LLM-inferred semantic name, e.g. "login_page", "search_results" */
+    semanticName?: string;
+    /** LLM-inferred description */
+    description?: string;
+    /** Forms discovered on this page */
+    forms: FormDescriptor[];
+    /** Standalone buttons (not inside forms) */
+    buttons: ButtonDescriptor[];
+    /** Links discovered on this page */
+    links: LinkDescriptor[];
+    /** SHA-256 hash of the analysis screenshot */
+    screenshotHash?: string;
+    /** ISO timestamp of when this page was analyzed */
+    analyzedAt: string;
+}
+export type AuthFlowType = 'form-login' | 'oauth-redirect' | 'basic-auth' | 'cookie-session' | 'unknown';
+export interface AuthFlowDescriptor {
+    /** Detected auth mechanism */
+    type: AuthFlowType;
+    /** The page containing the login form */
+    loginPage?: PageDescriptor;
+    /** The login form descriptor */
+    loginForm?: FormDescriptor;
+    /** Selector for the username/email field */
+    usernameField?: SelectorSet;
+    /** Selector for the password field */
+    passwordField?: SelectorSet;
+    /** Selector for the submit/login button */
+    submitButton?: SelectorSet;
+    /** How to detect if the user is currently logged in */
+    sessionIndicator?: {
+        /** Element present when logged in (e.g. user avatar, logout button) */
+        selector?: SelectorSet;
+        /** Cookie name that indicates an active session */
+        cookie?: string;
+        /** URL pattern after successful login (e.g. /dashboard) */
+        urlPattern?: string;
+    };
+}
+export interface SiteDescriptor {
+    /** Unique identifier for this site analysis */
+    siteId: string;
+    /** Base URL of the site */
+    baseUrl: string;
+    /** All discovered pages */
+    pages: PageDescriptor[];
+    /** Detected authentication flow */
+    authFlow?: AuthFlowDescriptor;
+    /** ISO timestamp of the analysis */
+    analyzedAt: string;
+    /** Version number, incremented on rescan */
+    version: number;
+    /** How deep the crawler went */
+    crawlDepth: number;
+    /** Site metadata */
+    metadata: {
+        title?: string;
+        description?: string;
+        favicon?: string;
+    };
+}
+export type SiteToolType = 'page-action' | 'element-action' | 'navigation' | 'browser-lifecycle';
+export interface SiteToolDefinition {
+    /** Tool name (kebab-case, MCP-compatible) */
+    name: string;
+    /** Human-readable title */
+    title: string;
+    /** Tool description */
+    description: string;
+    /** Zod schema code for tool input parameters */
+    inputSchemaCode: string;
+    /** Output file name */
+    fileName: string;
+    /** Generated function name (camelCase) */
+    functionName: string;
+    /** What kind of site tool this is */
+    toolType: SiteToolType;
+    /** Which page this tool operates on */
+    pageId?: string;
+    /** Page URL for navigation */
+    pageUrl?: string;
+    /** Form descriptor (for form-based page-action tools) */
+    form?: FormDescriptor;
+    /** Button descriptor (for element-action tools) */
+    button?: ButtonDescriptor;
+    /** Link descriptor (for navigation tools) */
+    link?: LinkDescriptor;
+    /** All selectors this tool depends on */
+    selectors: SelectorSet[];
+    /** Whether this tool returns a screenshot alongside text */
+    returnsScreenshot: boolean;
+    /** MCP tool annotations */
+    annotations?: {
+        readOnlyHint?: boolean;
+        destructiveHint?: boolean;
+        idempotentHint?: boolean;
+    };
+}
+export interface BrowserConfig {
+    /** Run browser in headless mode */
+    headless: boolean;
+    /** Idle timeout before auto-closing browser (ms) */
+    idleTimeoutMs: number;
+    /** Browser viewport dimensions */
+    viewport: {
+        width: number;
+        height: number;
+    };
+    /** Custom user agent string */
+    userAgent?: string;
+    /** Maximum concurrent browser sessions (default: 10) */
+    maxSessions?: number;
+}
+export interface SiteProjectManifest {
+    /** Server name (kebab-case) */
+    serverName: string;
+    /** Server version */
+    serverVersion: string;
+    /** Target website base URL */
+    baseUrl: string;
+    /** MCP transport mode */
+    transport: TransportMode;
+    /** Full site descriptor (embedded in generated project) */
+    siteDescriptor: SiteDescriptor;
+    /** Generated tools */
+    tools: SiteToolDefinition[];
+    /** Environment variables the generated server needs */
+    envVars: EnvVarDescriptor[];
+    /** Playwright browser configuration */
+    browserConfig: BrowserConfig;
+}
+/**
+ * Regeneration metadata written to the generated project root as
+ * `mcpmake.site.json` so `mcpmake rescan` can rebuild the project from a
+ * freshly crawled SiteDescriptor without re-specifying the original CLI flags.
+ * The SiteDescriptor itself lives in `src/site-descriptor.json` and the tools
+ * are regenerated deterministically, so neither is duplicated here.
+ */
+export interface SiteRegenMetadata {
+    serverName: string;
+    serverVersion: string;
+    transport: TransportMode;
+    baseUrl: string;
+    envVars: EnvVarDescriptor[];
+    browserConfig: BrowserConfig;
+}
+export type ChangeType = 'added' | 'removed' | 'modified' | 'selector-broken';
+export type ElementType = 'page' | 'form' | 'button' | 'link' | 'field';
+export interface SiteChangeEntry {
+    /** What kind of change */
+    changeType: ChangeType;
+    /** What kind of element changed */
+    elementType: ElementType;
+    /** ID of the element that changed */
+    elementId: string;
+    /** Page where the change occurred */
+    pageId: string;
+    /** Human-readable description of the change */
+    description: string;
+    /** ISO timestamp */
+    timestamp: string;
+    /** Previous value (for modified/removed) */
+    oldValue?: unknown;
+    /** New value (for added/modified) */
+    newValue?: unknown;
+}
+export interface RescanResult {
+    /** Previous site descriptor version */
+    previousVersion: number;
+    /** New version number */
+    newVersion: number;
+    /** All changes detected */
+    changes: SiteChangeEntry[];
+    /** Selectors that no longer resolve */
+    brokenSelectors: Array<{
+        toolName: string;
+        selector: SelectorSet;
+        /** New selector if self-healing succeeded */
+        healedSelector?: SelectorSet;
+    }>;
+    /** Updated site descriptor */
+    newSiteDescriptor: SiteDescriptor;
+    /** ISO timestamp of the rescan */
+    timestamp: string;
+}
+//# sourceMappingURL=site.d.ts.map

package/dist/types/site.d.ts.map

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

package/dist/types/site.js

@@ -0,0 +1,9 @@
+/**
+ * Type definitions for the Website-to-MCP pipeline.
+ *
+ * These types represent DOM-based interactions (forms, buttons, links)
+ * rather than HTTP API calls. They form a parallel pipeline to the
+ * existing OperationDescriptor/ToolDefinition types in index.ts.
+ */
+export {};
+//# sourceMappingURL=site.js.map

package/dist/types/site.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site.js","sourceRoot":"","sources":["../../src/types/site.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/utils/fail.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Centralized failure exit with opt-in, redacted error reporting.
+ *
+ * Why a shared helper instead of wrapping citty's `runMain`: the commands don't
+ * `throw` on user-facing failures — they call `logger.error(...)` and then
+ * `process.exit(1)` directly. `process.exit()` terminates the event loop
+ * synchronously and bypasses every `try/catch` (including citty's `runMain`
+ * handler), so a wrapper around `runMain` would never observe these exits. The
+ * only reliable place to hook reporting is the failure site itself, so each
+ * command calls `await fail(...)` where it used to log-and-exit.
+ *
+ * Telemetry is strictly opt-in (consent modes `prompt` | `auto` | `off`), never
+ * blocks or breaks the CLI (timeout + swallowed errors, mirroring
+ * `fetchPricing`), and auto-degrades to `off` in non-TTY / CI environments so it
+ * can never hang a pipeline waiting for input.
+ */
+type ConsentMode = 'prompt' | 'auto' | 'off';
+/**
+ * Apply every redaction pass. Run on both errorMessage and stack before use.
+ *
+ * Exported (as `redactText`) so the redaction contract can be unit-tested
+ * directly without invoking `fail()` (which calls `process.exit`).
+ */
+export declare function redactText(input: string): string;
+/** Inputs that decide telemetry consent, injectable so the logic is testable. */
+export interface TelemetryEnv {
+    /** The mode read from config (anything else is treated as the `prompt` default). */
+    configured?: unknown;
+    /** Whether stdout is an interactive TTY. */
+    isTTY?: boolean;
+    /** Whether we are running in CI (truthy `$CI`). */
+    ci?: boolean;
+}
+/**
+ * Pure consent resolver: given the configured mode and the environment, decide
+ * the effective {@link ConsentMode}.
+ *
+ * Auto-degrades to `'off'` whenever there is no interactive TTY or we're in CI —
+ * otherwise the CLI could hang waiting for input that will never come. Exported
+ * so this branchy decision can be unit-tested without touching real env/config.
+ */
+export declare function resolveTelemetryMode(env: TelemetryEnv): ConsentMode;
+/**
+ * Log a user-facing failure message, optionally report it (consent permitting),
+ * then exit with code 1. Never throws; always exits.
+ */
+export declare function fail(message: string, error?: unknown): Promise<never>;
+export {};
+//# sourceMappingURL=fail.d.ts.map

package/dist/utils/fail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fail.d.ts","sourceRoot":"","sources":["../../src/utils/fail.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAgCH,KAAK,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;AAkD7C;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAqCD,iFAAiF;AACjF,MAAM,WAAW,YAAY;IAC3B,oFAAoF;IACpF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mDAAmD;IACnD,EAAE,CAAC,EAAE,OAAO,CAAC;CACd;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,YAAY,GAAG,WAAW,CAWnE;AAoED;;;GAGG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAuB3E"}