@reneturcios/ballpark 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rene Turcios
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,95 @@
-# Temporary Holding Version
+# ballpark
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A forwarding client for the published Dribba MCP remote.
+Dribba is a product studio; its remote MCP server exposes
+public studio data — its services, its case studies, a
+ballpark budget calculator, structured company facts, and
+a contact-request tool. There is no installable package
+for that remote, so ballpark gives it a local stdio MCP
+server and a small CLI: `tools/list` is answered locally
+from the verbatim live capture of the remote, and every
+`tools/call` is forwarded to the remote over streamable
+HTTP.
+
+The upstream result passes through verbatim, including
+`structuredContent` and any `isError` flag. Failures on
+the way there or back are reported as an error result
+whose text starts with `ballpark error: `.
+
+## Upstream and the override
+
+- Upstream: `https://dribba.com/mcp` (pinned).
+- Override: set `DRIBBA_MCP_URL` to point the client at a
+  different endpoint. This override is a reconstruction:
+  no override is published for the remote-only original.
+- The client handshake is `initialize` (protocol version
+  `2025-03-26`, client `ballpark` / `0.1.0`), then
+  `notifications/initialized`, then `tools/call`. When the
+  upstream issues an `Mcp-Session-Id`, it is honoured on
+  every later request. Responses may be plain JSON or an
+  SSE stream.
+- Argument validation is local: an unknown tool or
+  malformed arguments fail before anything is forwarded.
+  `submit_contact_request` is forwarded like the other
+  tools; its captured description — which asks for
+  explicit user confirmation of the exact name, email and
+  message before calling — is served verbatim, and this
+  rebuild adds no gating of its own.
+
+## Install and run
+
+```bash
+npx -y @reneturcios/ballpark mcp          # stdio MCP server
+npx -y @reneturcios/ballpark --version    # 0.1.0
+npx -y @reneturcios/ballpark list_services '{"limit":3}'
+npx -y @reneturcios/ballpark estimate_project '{"platforms":["ios","web"],"complexity":"standard"}'
+npx -y @reneturcios/ballpark list_projects '{"industry":"fintech"}'
+npx -y @reneturcios/ballpark company_facts '{"fields":["offices","distinctions"]}'
+```
+
+Each tool subcommand takes one JSON argument string and
+prints the forwarded result. Exit codes: 0 on success,
+1 on an error result, 2 on a usage or validation error.
+
+## MCP client config
+
+```json
+{
+  "mcpServers": {
+    "ballpark": {
+      "command": "npx",
+      "args": ["-y", "@reneturcios/ballpark", "mcp"]
+    }
+  }
+}
+```
+
+## Docker
+
+```bash
+docker run -i ghcr.io/cloudcorprecords/ballpark                    # stdio MCP server
+docker run --rm ghcr.io/cloudcorprecords/ballpark --version        # CLI
+```
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `list_services` | List Dribba's services with a one-line summary and URL. |
+| `estimate_project` | Ballpark budget and range for an app/product, mirroring dribba.com's public calculator. Minimum project budget is €30,000. Requires `platforms`. |
+| `list_projects` | List Dribba's case studies (slug, title, industry). |
+| `company_facts` | Structured facts about Dribba: positioning, offices, team, distinctions, clients. |
+| `submit_contact_request` | Submit a real project inquiry to Dribba on behalf of the user. This sends an email and creates a lead — ONLY call it after the user has explicitly confirmed the exact name, email and message to be sent. Dribba replies within 1h. Rate-limited per client. |
+
+## Development
+
+```bash
+npm install
+npm run build   # tsc -> dist/
+npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
+npm run dev     # run the CLI from source
+```
+
+## License
+
+MIT — Copyright (c) 2026 Rene Turcios.

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+/**
+ * ballpark CLI.
+ *
+ *   ballpark list_services '<json>'
+ *   ballpark estimate_project '<json>'
+ *   ballpark list_projects '<json>'
+ *   ballpark company_facts '<json>'
+ *   ballpark submit_contact_request '<json>'
+ *   ballpark mcp
+ *   ballpark --version
+ *
+ * Each tool subcommand takes one JSON argument string with
+ * the tool's arguments, forwards the call upstream like
+ * the MCP path, and prints the forwarded result content.
+ * Exit codes: 0 success, 1 on an isError result, 2 usage
+ * error (unknown subcommand, non-JSON argument, or
+ * arguments that fail the same validation the MCP
+ * handler applies).
+ */
+import { callTool, VERSION } from "./upstream.js";
+const TOOL_NAMES = [
+    "list_services",
+    "estimate_project",
+    "list_projects",
+    "company_facts",
+    "submit_contact_request",
+];
+function usage() {
+    console.error(`Usage:
+  ballpark <tool> '<json-args>'     one of: ${TOOL_NAMES.join(", ")}
+  ballpark mcp
+  ballpark --version`);
+    process.exit(2);
+}
+function renderContent(result) {
+    if (result.structuredContent !== undefined) {
+        return JSON.stringify(result.structuredContent);
+    }
+    const content = result.content;
+    if (Array.isArray(content)) {
+        return content
+            .map((item) => {
+            if (item !== null &&
+                typeof item === "object" &&
+                item.type === "text" &&
+                typeof item.text === "string") {
+                return item.text;
+            }
+            return JSON.stringify(item);
+        })
+            .join("\n");
+    }
+    return typeof content === "string" ? content : JSON.stringify(result);
+}
+async function main() {
+    const [cmd, ...rest] = process.argv.slice(2);
+    if (cmd === "--version" || cmd === "-v") {
+        console.log(VERSION);
+        return;
+    }
+    if (cmd === "mcp") {
+        if (rest.length !== 0)
+            usage();
+        const { startBallparkServer } = await import("./mcp.js");
+        await startBallparkServer();
+        return;
+    }
+    if (!cmd || !TOOL_NAMES.includes(cmd))
+        usage();
+    if (rest.length > 1)
+        usage();
+    let args = {};
+    if (rest.length === 1) {
+        try {
+            const parsed = JSON.parse(rest[0]);
+            if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
+                usage();
+            args = parsed;
+        }
+        catch {
+            console.error("error: argument must be a JSON object string");
+            process.exit(2);
+        }
+    }
+    const { validateToolArgs } = await import("./mcp.js");
+    try {
+        args = validateToolArgs(cmd, args);
+    }
+    catch (err) {
+        console.error(`error: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(2);
+    }
+    const result = await callTool(cmd, args);
+    if (result.isError) {
+        console.error(`error: ${renderContent(result)}`);
+        process.exit(1);
+    }
+    console.log(renderContent(result));
+}
+void main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./types.js";
+export * from "./upstream.js";

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from "./types.js";
+export * from "./upstream.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}

package/dist/mcp.d.ts

@@ -0,0 +1,39 @@
+/**
+ * ballpark MCP server. Tools: list_services,
+ * estimate_project, list_projects, company_facts,
+ * submit_contact_request.
+ *
+ * Why the low-level Server instead of McpServer: the
+ * high-level helper converts zod schemas to JSON Schema
+ * and injects keys that are not in this tool set's
+ * captured spec, which breaks exact tool-list/schema
+ * parity with the live capture. This file serves
+ * tools/list from the explicit literals below — the
+ * verbatim tool objects from the remote's live
+ * tools/list capture — and forwards every tools/call
+ * upstream.
+ *
+ * The handler validates tools/call arguments itself:
+ * an unknown tool name or malformed arguments (missing
+ * required fields, wrong types, out-of-range values,
+ * unexpected properties where the captured schema sets
+ * additionalProperties: false) raise McpError with
+ * ErrorCode.InvalidParams, and nothing is forwarded.
+ * Valid calls are forwarded and the upstream result is
+ * returned verbatim, including structuredContent and
+ * any isError flag.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { type BallparkClient } from "./upstream.js";
+import type { ToolArgs, ToolDef } from "./types.js";
+export declare const TOOL_DEFS: ToolDef[];
+export declare const TOOL_NAMES: string[];
+/**
+ * Validate tools/call arguments against the captured
+ * literal schema for `name`. Returns the argument object
+ * to forward. Throws McpError(InvalidParams) for an
+ * unknown tool or any malformed argument set.
+ */
+export declare function validateToolArgs(name: string, args: unknown): ToolArgs;
+export declare function createBallparkServer(client?: BallparkClient): Server;
+export declare function startBallparkServer(client?: BallparkClient): Promise<void>;

package/dist/mcp.js

@@ -0,0 +1,234 @@
+/**
+ * ballpark MCP server. Tools: list_services,
+ * estimate_project, list_projects, company_facts,
+ * submit_contact_request.
+ *
+ * Why the low-level Server instead of McpServer: the
+ * high-level helper converts zod schemas to JSON Schema
+ * and injects keys that are not in this tool set's
+ * captured spec, which breaks exact tool-list/schema
+ * parity with the live capture. This file serves
+ * tools/list from the explicit literals below — the
+ * verbatim tool objects from the remote's live
+ * tools/list capture — and forwards every tools/call
+ * upstream.
+ *
+ * The handler validates tools/call arguments itself:
+ * an unknown tool name or malformed arguments (missing
+ * required fields, wrong types, out-of-range values,
+ * unexpected properties where the captured schema sets
+ * additionalProperties: false) raise McpError with
+ * ErrorCode.InvalidParams, and nothing is forwarded.
+ * Valid calls are forwarded and the upstream result is
+ * returned verbatim, including structuredContent and
+ * any isError flag.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ErrorCode, ListToolsRequestSchema, McpError, } from "@modelcontextprotocol/sdk/types.js";
+import { createClient, VERSION } from "./upstream.js";
+export const TOOL_DEFS = [
+    {
+        name: "list_services",
+        description: "List Dribba's services with a one-line summary and URL.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "integer",
+                    minimum: 1,
+                    maximum: 50,
+                    description: "Maximum number of services to return. Omit for all of them.",
+                },
+            },
+            required: [],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "estimate_project",
+        description: "Ballpark budget and range for an app/product, mirroring dribba.com's public calculator. Minimum project budget is €30,000.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                platforms: {
+                    type: "array",
+                    items: {
+                        type: "string",
+                        enum: ["ios", "android", "web", "desktop"],
+                    },
+                    description: "At least one target platform.",
+                },
+                complexity: {
+                    type: "string",
+                    enum: ["mvp", "standard", "complex"],
+                },
+                design: {
+                    type: "string",
+                    enum: ["basic", "custom", "premium"],
+                },
+                timeline: {
+                    type: "string",
+                    enum: ["rush", "normal", "relaxed"],
+                },
+            },
+            required: ["platforms"],
+        },
+    },
+    {
+        name: "list_projects",
+        description: "List Dribba's case studies (slug, title, industry).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                industry: {
+                    type: "string",
+                    description: "Case-insensitive substring match on the industry, e.g. \"fintech\". Omit for all industries.",
+                },
+                limit: {
+                    type: "integer",
+                    minimum: 1,
+                    maximum: 50,
+                    description: "Maximum number of case studies to return.",
+                },
+            },
+            required: [],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "company_facts",
+        description: "Structured facts about Dribba: positioning, offices, team, distinctions, clients.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                fields: {
+                    type: "array",
+                    items: {
+                        type: "string",
+                    },
+                    description: "Subset of fact keys to return (e.g. [\"offices\",\"distinctions\"]). Omit for every fact.",
+                },
+            },
+            required: [],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "submit_contact_request",
+        description: "Submit a real project inquiry to Dribba on behalf of the user. This sends an email and creates a lead — ONLY call it after the user has explicitly confirmed the exact name, email and message to be sent. Dribba replies within 1h. Rate-limited per client.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "Full name of the person making the inquiry.",
+                },
+                email: {
+                    type: "string",
+                    description: "Email address Dribba should reply to.",
+                },
+                message: {
+                    type: "string",
+                    description: "The inquiry, confirmed by the user.",
+                },
+                company: {
+                    type: "string",
+                    description: "Company name (optional).",
+                },
+                budget: {
+                    type: "string",
+                    description: "Approximate budget range, e.g. \"30-60k EUR\" (optional).",
+                },
+            },
+            required: ["name", "email", "message"],
+        },
+    },
+];
+export const TOOL_NAMES = TOOL_DEFS.map((t) => t.name);
+function invalid(message) {
+    return new McpError(ErrorCode.InvalidParams, message);
+}
+function checkValue(tool, key, value, schema) {
+    const type = schema.type;
+    if (type === "string") {
+        if (typeof value !== "string")
+            throw invalid(`${tool}: argument "${key}" must be a string`);
+    }
+    else if (type === "integer") {
+        if (typeof value !== "number" || !Number.isInteger(value)) {
+            throw invalid(`${tool}: argument "${key}" must be an integer`);
+        }
+        if (typeof schema.minimum === "number" && value < schema.minimum) {
+            throw invalid(`${tool}: argument "${key}" must be >= ${schema.minimum}`);
+        }
+        if (typeof schema.maximum === "number" && value > schema.maximum) {
+            throw invalid(`${tool}: argument "${key}" must be <= ${schema.maximum}`);
+        }
+    }
+    else if (type === "array") {
+        if (!Array.isArray(value))
+            throw invalid(`${tool}: argument "${key}" must be an array`);
+        const items = schema.items;
+        if (items) {
+            for (const item of value)
+                checkValue(tool, key, item, items);
+        }
+        return;
+    }
+    if (Array.isArray(schema.enum) && !schema.enum.includes(value)) {
+        throw invalid(`${tool}: argument "${key}" must be one of ${schema.enum.join(", ")}`);
+    }
+}
+/**
+ * Validate tools/call arguments against the captured
+ * literal schema for `name`. Returns the argument object
+ * to forward. Throws McpError(InvalidParams) for an
+ * unknown tool or any malformed argument set.
+ */
+export function validateToolArgs(name, args) {
+    const def = TOOL_DEFS.find((t) => t.name === name);
+    if (!def)
+        throw invalid(`Unknown tool: ${name}`);
+    const value = args ?? {};
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw invalid(`${name}: arguments must be an object`);
+    }
+    const obj = value;
+    const schema = def.inputSchema;
+    const properties = schema.properties ?? {};
+    for (const req of schema.required ?? []) {
+        if (obj[req] === undefined || obj[req] === null) {
+            throw invalid(`${name}: missing required argument "${req}"`);
+        }
+    }
+    if (schema.additionalProperties === false) {
+        for (const key of Object.keys(obj)) {
+            if (!(key in properties))
+                throw invalid(`${name}: unexpected argument "${key}"`);
+        }
+    }
+    for (const [key, val] of Object.entries(obj)) {
+        const propSchema = properties[key];
+        if (propSchema && val !== undefined)
+            checkValue(name, key, val, propSchema);
+    }
+    return obj;
+}
+export function createBallparkServer(client = createClient()) {
+    const server = new Server({ name: "ballpark", version: VERSION }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOL_DEFS }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const validArgs = validateToolArgs(name, args ?? {});
+        const result = await client.callTool(name, validArgs);
+        // Upstream result passes through verbatim.
+        return result;
+    });
+    return server;
+}
+export async function startBallparkServer(client) {
+    const server = createBallparkServer(client);
+    await server.connect(new StdioServerTransport());
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,53 @@
+/**
+ * ballpark types.
+ *
+ * A forwarding client for the published Dribba MCP remote.
+ * tools/list is served locally from literal definitions;
+ * tools/call is forwarded upstream and the upstream result
+ * passes through verbatim.
+ */
+/** A tool's arguments, as decoded JSON. */
+export type ToolArgs = Record<string, unknown>;
+/** A JSON Schema object, as captured in the tools/list literal. */
+export type JsonSchema = Record<string, unknown>;
+/** One tool definition, exactly as served by tools/list. */
+export interface ToolDef {
+    name: string;
+    description: string;
+    inputSchema: JsonSchema;
+}
+/**
+ * The result shape shared by the MCP handler and the CLI.
+ * Extra keys from upstream (for example structuredContent
+ * or _meta) are preserved verbatim, hence the index
+ * signature.
+ */
+export interface ToolResult {
+    content?: unknown;
+    structuredContent?: Record<string, unknown>;
+    isError?: boolean;
+    [key: string]: unknown;
+}
+/** The minimal slice of a fetch Response this client relies on. */
+export interface FetchResponseLike {
+    ok: boolean;
+    status: number;
+    headers: {
+        get(name: string): string | null;
+    };
+    text(): Promise<string>;
+}
+/** Injectable fetch, so tests never touch the live network. */
+export type FetchFn = (url: string, init?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+    signal?: AbortSignal;
+}) => Promise<FetchResponseLike>;
+/** Injectable dependencies for the upstream client. */
+export interface UpstreamDeps {
+    fetchFn?: FetchFn;
+    url?: string;
+    env?: Record<string, string | undefined>;
+    timeoutMs?: number;
+}

package/dist/types.js

@@ -0,0 +1,10 @@
+/**
+ * ballpark types.
+ *
+ * A forwarding client for the published Dribba MCP remote.
+ * tools/list is served locally from literal definitions;
+ * tools/call is forwarded upstream and the upstream result
+ * passes through verbatim.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/upstream.d.ts

@@ -0,0 +1,52 @@
+/**
+ * ballpark core: a forwarding client for the published
+ * Dribba MCP remote at https://dribba.com/mcp.
+ *
+ * The endpoint is pinned by the spec. An override via the
+ * DRIBBA_MCP_URL environment variable is a labelled
+ * reconstruction: no override is published for this
+ * remote-only server.
+ *
+ * Wire protocol (streamable HTTP, JSON-RPC):
+ *   initialize (protocolVersion "2025-03-26", clientInfo
+ *   { name: "ballpark", version: VERSION })
+ *   -> notifications/initialized -> tools/call
+ * The session is established lazily on the first forwarded
+ * call and reused for the client's lifetime. When the
+ * upstream issues an Mcp-Session-Id response header it is
+ * captured and sent on every later request.
+ *
+ * Responses may be plain JSON or SSE (`data:` lines); the
+ * JSON-RPC message whose `id` matches the request is the
+ * answer. An upstream `result` passes through verbatim
+ * (content, structuredContent, isError and any other keys).
+ * Every failure — HTTP error, JSON-RPC error, malformed
+ * response, or a throwing fetch — becomes an isError result
+ * whose text starts with "ballpark error: " (this rebuild's
+ * own error rendering, a labelled reconstruction).
+ *
+ * All upstream access goes through an injectable fetch, so
+ * tests use a fake fetch only and never touch the network.
+ */
+import type { ToolArgs, ToolResult, UpstreamDeps } from "./types.js";
+export declare const VERSION = "0.1.0";
+export declare const DEFAULT_UPSTREAM_URL = "https://dribba.com/mcp";
+/** Parse a response body that is plain JSON or an SSE stream. */
+export declare function parseRpcMessage(body: string, wantId: number): Record<string, unknown> | null;
+export declare class BallparkClient {
+    private readonly fetchFn;
+    private readonly url;
+    private readonly timeoutMs;
+    private sessionId;
+    private sessionPromise;
+    private nextId;
+    constructor(deps?: UpstreamDeps);
+    get upstreamUrl(): string;
+    private post;
+    private ensureSession;
+    /** Forward one tools/call upstream; failures become "ballpark error: ..." results. */
+    callTool(name: string, args: ToolArgs): Promise<ToolResult>;
+}
+export declare function createClient(deps?: UpstreamDeps): BallparkClient;
+/** Convenience one-shot forward used by the CLI. */
+export declare function callTool(name: string, args: ToolArgs, deps?: UpstreamDeps): Promise<ToolResult>;

package/dist/upstream.js

@@ -0,0 +1,167 @@
+export const VERSION = "0.1.0";
+export const DEFAULT_UPSTREAM_URL = "https://dribba.com/mcp";
+const PROTOCOL_VERSION = "2025-03-26";
+const DEFAULT_TIMEOUT_MS = 60000;
+function errorResult(message) {
+    return {
+        content: [{ type: "text", text: `ballpark error: ${message}` }],
+        isError: true,
+    };
+}
+/** Parse a response body that is plain JSON or an SSE stream. */
+export function parseRpcMessage(body, wantId) {
+    const trimmed = body.trim();
+    if (!trimmed)
+        return null;
+    const candidates = [];
+    if (trimmed.startsWith("{")) {
+        try {
+            candidates.push(JSON.parse(trimmed));
+        }
+        catch {
+            // fall through to the SSE scan below
+        }
+    }
+    if (candidates.length === 0) {
+        for (const line of trimmed.split(/\r?\n/)) {
+            const t = line.trim();
+            if (!t.startsWith("data:"))
+                continue;
+            const payload = t.slice("data:".length).trim();
+            if (!payload || payload === "[DONE]")
+                continue;
+            try {
+                candidates.push(JSON.parse(payload));
+            }
+            catch {
+                // ignore non-JSON data lines
+            }
+        }
+    }
+    let fallback = null;
+    for (const c of candidates) {
+        if (c === null || typeof c !== "object" || Array.isArray(c))
+            continue;
+        const msg = c;
+        if (msg.id === wantId)
+            return msg;
+        if (fallback === null && ("result" in msg || "error" in msg))
+            fallback = msg;
+    }
+    return fallback;
+}
+export class BallparkClient {
+    fetchFn;
+    url;
+    timeoutMs;
+    sessionId = null;
+    sessionPromise = null;
+    nextId = 1;
+    constructor(deps = {}) {
+        const env = deps.env ?? process.env;
+        this.fetchFn = deps.fetchFn ?? ((url, init) => fetch(url, init));
+        // DRIBBA_MCP_URL override: labelled reconstruction.
+        this.url = deps.url ?? env.DRIBBA_MCP_URL ?? DEFAULT_UPSTREAM_URL;
+        const envTimeout = env.DRIBBA_TIMEOUT_MS ? Number(env.DRIBBA_TIMEOUT_MS) : NaN;
+        this.timeoutMs =
+            deps.timeoutMs ?? (Number.isFinite(envTimeout) && envTimeout > 0 ? envTimeout : DEFAULT_TIMEOUT_MS);
+    }
+    get upstreamUrl() {
+        return this.url;
+    }
+    async post(payload, wantResponse) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const headers = {
+                "Content-Type": "application/json",
+                Accept: "application/json, text/event-stream",
+            };
+            if (this.sessionId)
+                headers["Mcp-Session-Id"] = this.sessionId;
+            const res = await this.fetchFn(this.url, {
+                method: "POST",
+                headers,
+                body: JSON.stringify(payload),
+                signal: controller.signal,
+            });
+            const issued = res.headers?.get?.("mcp-session-id") ?? res.headers?.get?.("Mcp-Session-Id") ?? null;
+            if (issued)
+                this.sessionId = issued;
+            const text = await res.text();
+            if (!res.ok) {
+                throw new Error(`upstream HTTP ${res.status}`);
+            }
+            if (!wantResponse)
+                return { msg: null, status: res.status, ok: res.ok };
+            const id = payload.id ?? 0;
+            return { msg: parseRpcMessage(text, id), status: res.status, ok: res.ok };
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    ensureSession() {
+        if (!this.sessionPromise) {
+            this.sessionPromise = (async () => {
+                const id = this.nextId++;
+                const { msg } = await this.post({
+                    jsonrpc: "2.0",
+                    id,
+                    method: "initialize",
+                    params: {
+                        protocolVersion: PROTOCOL_VERSION,
+                        capabilities: {},
+                        clientInfo: { name: "ballpark", version: VERSION },
+                    },
+                }, true);
+                if (!msg)
+                    throw new Error("malformed response");
+                if (msg.error) {
+                    const e = msg.error;
+                    throw new Error(typeof e.message === "string" ? e.message : "upstream error");
+                }
+                if (!("result" in msg))
+                    throw new Error("malformed response");
+                await this.post({ jsonrpc: "2.0", method: "notifications/initialized" }, false);
+                return null;
+            })();
+            // A failed handshake must not poison later calls.
+            this.sessionPromise.catch(() => {
+                this.sessionPromise = null;
+            });
+        }
+        return this.sessionPromise;
+    }
+    /** Forward one tools/call upstream; failures become "ballpark error: ..." results. */
+    async callTool(name, args) {
+        try {
+            await this.ensureSession();
+            const id = this.nextId++;
+            const { msg } = await this.post({ jsonrpc: "2.0", id, method: "tools/call", params: { name, arguments: args } }, true);
+            if (!msg)
+                return errorResult("malformed response");
+            if (msg.error) {
+                const e = msg.error;
+                return errorResult(typeof e.message === "string" ? e.message : "upstream error");
+            }
+            if (!("result" in msg) || msg.result === null || typeof msg.result !== "object") {
+                return errorResult("malformed response");
+            }
+            // Upstream result passes through verbatim.
+            return msg.result;
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return errorResult(message);
+        }
+    }
+}
+export function createClient(deps = {}) {
+    return new BallparkClient(deps);
+}
+/** Convenience one-shot forward used by the CLI. */
+export async function callTool(name, args, deps = {}) {
+    return createClient(deps).callTool(name, args);
+}
+//# sourceMappingURL=upstream.js.map

package/dist/upstream.js.map

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

package/package.json

@@ -1,6 +1 @@
-{
-  "name": "@reneturcios/ballpark",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+{"bin":{"ballpark":"dist/cli.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1","zod":"^4"},"description":"Forwarding client for the published Dribba MCP remote: services, case studies, budget estimates, company facts and contact requests, served locally for tools/list and forwarded for tools/call. One bin serves a small CLI and a stdio MCP server.","devDependencies":{"@types/node":"^20","tsx":"^4","typescript":"^5"},"engines":{"node":">=20"},"files":["dist","server.json"],"homepage":"https://github.com/CloudCorpRecords/ballpark#readme","license":"MIT","mcpName":"io.github.CloudCorpRecords/ballpark","name":"@reneturcios/ballpark","private":false,"publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/CloudCorpRecords/ballpark.git"},"scripts":{"build":"tsc","dev":"tsx src/cli.ts","test":"tsx --test test/*.test.ts"},"type":"module","version":"0.1.0"}

package/server.json

@@ -0,0 +1 @@
+{"$schema":"https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json","description":"Forwarding client for Dribba studio data: services, case studies, budget estimates, contact.","name":"io.github.CloudCorpRecords/ballpark","packages":[{"identifier":"@reneturcios/ballpark","packageArguments":[{"type":"positional","value":"mcp"}],"registryBaseUrl":"https://registry.npmjs.org","registryType":"npm","runtimeHint":"npx","transport":{"type":"stdio"},"version":"0.1.0"},{"identifier":"ghcr.io/cloudcorprecords/ballpark:0.1.0","packageArguments":[{"type":"positional","value":"mcp"}],"registryType":"oci","runtimeArguments":[{"name":"--rm","type":"named"},{"name":"-i","type":"named"}],"runtimeHint":"docker","transport":{"type":"stdio"}}],"repository":{"source":"github","url":"https://github.com/CloudCorpRecords/ballpark"},"version":"0.1.0"}