@yiaany/ghostapi 0.1.0

package/dist/server/eventsStore.js

@@ -0,0 +1,31 @@
+import { appendFile, mkdir, rm } from "node:fs/promises";
+import { dirname, join } from "node:path";
+const EVENTS_FILE_PATH = join(".ghostapi", "events.jsonl");
+const MAX_EVENTS = 200;
+const eventsBuffer = [];
+export async function addEvent(event) {
+    eventsBuffer.push(event);
+    if (eventsBuffer.length > MAX_EVENTS) {
+        eventsBuffer.shift();
+    }
+    try {
+        await mkdir(dirname(EVENTS_FILE_PATH), { recursive: true });
+        const serialized = JSON.stringify(event) + "\n";
+        await appendFile(EVENTS_FILE_PATH, serialized, "utf8");
+    }
+    catch {
+        // Silently ignore log write failures to strictly preserve proxy operational stability
+    }
+}
+export function getEventsHistory() {
+    return [...eventsBuffer];
+}
+export function clearEventsHistoryForTests() {
+    eventsBuffer.length = 0;
+}
+export async function clearEvents() {
+    eventsBuffer.length = 0;
+    await mkdir(dirname(EVENTS_FILE_PATH), { recursive: true });
+    await rm(EVENTS_FILE_PATH, { force: true });
+}
+//# sourceMappingURL=eventsStore.js.map

package/dist/server/eventsStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventsStore.js","sourceRoot":"","sources":["../../src/server/eventsStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAiB1C,MAAM,gBAAgB,GAAG,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;AAC3D,MAAM,UAAU,GAAG,GAAG,CAAC;AAEvB,MAAM,YAAY,GAAiB,EAAE,CAAC;AAEtC,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,KAAiB;IAC9C,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEzB,IAAI,YAAY,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;QACrC,YAAY,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;QAChD,MAAM,UAAU,CAAC,gBAAgB,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,sFAAsF;IACxF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CAAC,GAAG,YAAY,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IACxB,MAAM,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,MAAM,EAAE,CAAC,gBAAgB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC9C,CAAC"}

package/dist/server/routes.d.ts

@@ -0,0 +1,3 @@
+import type { Express } from "express";
+import type { ServerConfig } from "../config/serverConfig.js";
+export declare function registerRoutes(app: Express, config: ServerConfig): void;

package/dist/server/routes.js

@@ -0,0 +1,189 @@
+import { proxyHandler } from "../proxy/proxyHandler.js";
+import { addSseClient } from "./sse.js";
+import { clearEvents, getEventsHistory } from "./eventsStore.js";
+import { dashboardHandler, dashboardCssHandler, dashboardJsHandler } from "../dashboard/dashboard.js";
+import { landingAssetsHandler, landingHandler } from "../landing/landing.js";
+import { clearCache } from "../cache/index.js";
+import { clearState } from "../state/stateStore.js";
+import { getFaultLabConfig, updateFaultLabConfig } from "../fault/faultLab.js";
+import { generateAiRules } from "../rules/aiRules.js";
+import { generateRepoSetup } from "../setup/setupGenerator.js";
+import { exportScenario, importScenario, listScenarioPresets, replayScenario, saveEventsAsScenario, shareScenario } from "../scenarios/scenarioStore.js";
+import { generateAgentPrompt } from "../agents/agentPrompt.js";
+import { generateVitestFromEvent } from "../tests/testGenerator.js";
+import { generateSafetyReport } from "../report/safetyReport.js";
+const PROXY_METHODS = ["get", "post", "put", "patch", "delete", "head", "options"];
+const CLEAR_TARGETS = ["cache", "state", "events", "all"];
+export function registerRoutes(app, config) {
+    app.get("/", landingHandler);
+    app.use("/landing/assets", landingAssetsHandler);
+    app.get("/health", (_request, response) => {
+        response.status(200).json({ ok: true });
+    });
+    app.get("/dashboard", dashboardHandler);
+    app.get("/dashboard/styles.css", dashboardCssHandler);
+    app.get("/dashboard/app.js", dashboardJsHandler);
+    app.get("/events", (_request, response) => {
+        response.setHeader("Content-Type", "text/event-stream");
+        response.setHeader("Cache-Control", "no-cache");
+        response.setHeader("Connection", "keep-alive");
+        response.flushHeaders();
+        addSseClient(response);
+    });
+    app.get("/api/events", (_request, response) => {
+        response.status(200).json(getEventsHistory());
+    });
+    app.get("/api/fault-lab", (_request, response) => {
+        response.status(200).json(getFaultLabConfig());
+    });
+    app.post("/api/fault-lab", (req, res) => {
+        try {
+            res.status(200).json(updateFaultLabConfig(req.body));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Invalid Fault Lab config.";
+            res.status(400).json({ error: { code: "invalid_fault_lab_config", message } });
+        }
+    });
+    app.post("/api/ai-rules", async (_req, res) => {
+        try {
+            res.status(200).json(await generateAiRules());
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Unable to generate AI rules.";
+            res.status(500).json({ error: { code: "ai_rules_generation_failed", message } });
+        }
+    });
+    app.post("/api/setup", async (_req, res) => {
+        try {
+            res.status(200).json(await generateRepoSetup());
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Unable to generate repo setup.";
+            res.status(500).json({ error: { code: "setup_generation_failed", message } });
+        }
+    });
+    app.get("/api/scenarios", async (_req, res, next) => {
+        try {
+            res.status(200).json(await listScenarioPresets());
+        }
+        catch (error) {
+            next(error);
+        }
+    });
+    app.post("/api/scenarios", async (req, res) => {
+        try {
+            res.status(201).json(await importScenario(req.body));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Unable to import scenario.";
+            res.status(400).json({ error: { code: "invalid_scenario", message } });
+        }
+    });
+    app.post("/api/scenarios/save-from-traffic", async (req, res) => {
+        try {
+            res.status(201).json(await saveEventsAsScenario(getEventsHistory(), req.body));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Unable to save traffic as scenario.";
+            res.status(400).json({ error: { code: "scenario_save_failed", message } });
+        }
+    });
+    app.post("/api/scenarios/:id/replay", async (req, res) => {
+        try {
+            res.status(200).json(await replayScenario(req.params.id));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Unable to replay scenario.";
+            res.status(404).json({ error: { code: "scenario_not_found", message } });
+        }
+    });
+    app.get("/api/scenarios/:id/export", async (req, res) => {
+        try {
+            res.status(200).json(await exportScenario(req.params.id));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Unable to export scenario.";
+            res.status(404).json({ error: { code: "scenario_not_found", message } });
+        }
+    });
+    app.post("/api/scenarios/:id/share", async (req, res) => {
+        try {
+            res.status(200).json(await shareScenario(req.params.id));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Unable to share scenario.";
+            res.status(404).json({ error: { code: "scenario_not_found", message } });
+        }
+    });
+    app.post("/api/clear", async (req, res, next) => {
+        try {
+            const { target } = req.body;
+            if (!isClearTarget(target)) {
+                res.status(400).json({ error: { code: "invalid_clear_target", message: "Use target cache, state, events, or all." } });
+                return;
+            }
+            if (target === "cache" || target === "all")
+                await clearCache();
+            if (target === "state" || target === "all")
+                await clearState();
+            if (target === "events" || target === "all")
+                await clearEvents();
+            res.status(200).json({ ok: true, cleared: target });
+        }
+        catch (e) {
+            next(e);
+        }
+    });
+    app.get("/api/agent-prompt", async (_req, res) => {
+        try {
+            res.status(200).json(await generateAgentPrompt());
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Unable to generate agent prompt.";
+            res.status(500).json({ error: { code: "agent_prompt_failed", message } });
+        }
+    });
+    app.get("/api/events/:id/test", (req, res) => {
+        const event = getEventsHistory().find((candidate) => candidate.id === req.params.id);
+        if (event === undefined) {
+            res.status(404).json({ error: { code: "event_not_found", message: "Event not found." } });
+            return;
+        }
+        res.status(200).json(generateVitestFromEvent(event));
+    });
+    app.get("/api/safety-report", async (_req, res) => {
+        try {
+            res.status(200).json(await generateSafetyReport());
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Unable to generate safety report.";
+            res.status(500).json({ error: { code: "safety_report_failed", message } });
+        }
+    });
+    for (const method of PROXY_METHODS) {
+        if (method === "options") {
+            app.options("*", (_req, res) => { res.sendStatus(204); });
+            continue;
+        }
+        app[method]("*", async (req, res, next) => {
+            try {
+                await proxyHandler(req, res, config);
+            }
+            catch (error) {
+                next(error);
+            }
+        });
+    }
+    // Global Error Handler guaranteeing JSON responses instead of crashing Express
+    app.use((err, _req, res, _next) => {
+        const message = err instanceof Error ? err.message : "Unknown local proxy error";
+        res.status(500).json({
+            error: { code: "ghostapi_internal_error", message }
+        });
+    });
+}
+function isClearTarget(value) {
+    return typeof value === "string" && CLEAR_TARGETS.includes(value);
+}
+//# sourceMappingURL=routes.js.map

package/dist/server/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/server/routes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACtG,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,cAAc,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACzJ,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AAC5F,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAU,CAAC;AAGnE,MAAM,UAAU,cAAc,CAAC,GAAY,EAAE,MAAoB;IAC/D,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC7B,GAAG,CAAC,GAAG,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,CAAC;IAEjD,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,QAAiB,EAAE,QAAkB,EAAE,EAAE;QAC3D,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;IACxC,GAAG,CAAC,GAAG,CAAC,uBAAuB,EAAE,mBAAmB,CAAC,CAAC;IACtD,GAAG,CAAC,GAAG,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,CAAC;IAEjD,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,QAAiB,EAAE,QAAkB,EAAE,EAAE;QAC3D,QAAQ,CAAC,SAAS,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAC;QACxD,QAAQ,CAAC,SAAS,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;QAChD,QAAQ,CAAC,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;QAC/C,QAAQ,CAAC,YAAY,EAAE,CAAC;QACxB,YAAY,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,QAAiB,EAAE,QAAkB,EAAE,EAAE;QAC/D,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC,QAAiB,EAAE,QAAkB,EAAE,EAAE;QAClE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QACzD,IAAI,CAAC;YACH,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B,CAAC;YACrF,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,0BAA0B,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QACjF,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,KAAK,EAAE,IAAa,EAAE,GAAa,EAAE,EAAE;QAC/D,IAAI,CAAC;YACH,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,eAAe,EAAE,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,8BAA8B,CAAC;YACxF,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,4BAA4B,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QACnF,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE,IAAa,EAAE,GAAa,EAAE,EAAE;QAC5D,IAAI,CAAC;YACH,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,iBAAiB,EAAE,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,gCAAgC,CAAC;YAC1F,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,yBAAyB,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QAChF,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,gBAAgB,EAAE,KAAK,EAAE,IAAa,EAAE,GAAa,EAAE,IAAkB,EAAE,EAAE;QACnF,IAAI,CAAC;YACH,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,mBAAmB,EAAE,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,CAAC,CAAC;QACd,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QAC/D,IAAI,CAAC;YACH,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,4BAA4B,CAAC;YACtF,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,kCAAkC,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QACjF,IAAI,CAAC;YACH,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,oBAAoB,CAAC,gBAAgB,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QACjF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,qCAAqC,CAAC;YAC/F,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,2BAA2B,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QAC1E,IAAI,CAAC;YACH,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,4BAA4B,CAAC;YACtF,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,2BAA2B,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QACzE,IAAI,CAAC;YACH,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,4BAA4B,CAAC;YACtF,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,0BAA0B,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QACzE,IAAI,CAAC;YACH,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B,CAAC;YACrF,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAE,EAAE;QAC/E,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC;YAC5B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,0CAA0C,EAAE,EAAE,CAAC,CAAC;gBACvH,OAAO;YACT,CAAC;YACD,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,KAAK;gBAAE,MAAM,UAAU,EAAE,CAAC;YAC/D,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,KAAK;gBAAE,MAAM,UAAU,EAAE,CAAC;YAC/D,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,KAAK;gBAAE,MAAM,WAAW,EAAE,CAAC;YACjE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACtD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,CAAC,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,mBAAmB,EAAE,KAAK,EAAE,IAAa,EAAE,GAAa,EAAE,EAAE;QAClE,IAAI,CAAC;YACH,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,mBAAmB,EAAE,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,kCAAkC,CAAC;YAC5F,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,sBAAsB,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QAC9D,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACrF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;YAC1F,OAAO;QACT,CAAC;QACD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,oBAAoB,EAAE,KAAK,EAAE,IAAa,EAAE,GAAa,EAAE,EAAE;QACnE,IAAI,CAAC;YACH,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,oBAAoB,EAAE,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,mCAAmC,CAAC;YAC7F,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;QACnC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1D,SAAS;QACX,CAAC;QAED,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;YACxC,IAAI,CAAC;gBACH,MAAM,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;YACvC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,KAAK,CAAC,CAAC;YACd,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,+EAA+E;IAC/E,GAAG,CAAC,GAAG,CAAC,CAAC,GAAY,EAAE,IAAa,EAAE,GAAa,EAAE,KAAe,EAAE,EAAE;QACtE,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B,CAAC;QACjF,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;YACnB,KAAK,EAAE,EAAE,IAAI,EAAE,yBAAyB,EAAE,OAAO,EAAE;SACpD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,aAAa,CAAC,QAAQ,CAAC,KAAoB,CAAC,CAAC;AACnF,CAAC"}

package/dist/server/sse.d.ts

@@ -0,0 +1,5 @@
+import type { Response } from "express";
+import type { ProxyEvent } from "./eventsStore.js";
+export declare function addSseClient(response: Response): void;
+export declare function broadcastEvent(event: ProxyEvent): void;
+export declare function getSseClientCount(): number;

package/dist/server/sse.js

@@ -0,0 +1,32 @@
+const clients = new Set();
+export function addSseClient(response) {
+    const client = {
+        id: Date.now().toString(36) + Math.random().toString(36).slice(2),
+        response
+    };
+    clients.add(client);
+    requestAnimationFrameMock(() => {
+        if (!client.response.writableEnded && !client.response.destroyed) {
+            client.response.write(`data: ${JSON.stringify({ type: "connected", id: client.id })}\n\n`);
+        }
+    });
+    response.on("close", () => {
+        clients.delete(client);
+    });
+}
+export function broadcastEvent(event) {
+    const payload = `data: ${JSON.stringify({ type: "proxy_event", event })}\n\n`;
+    for (const client of clients) {
+        if (!client.response.writableEnded && !client.response.destroyed) {
+            client.response.write(payload);
+        }
+    }
+}
+export function getSseClientCount() {
+    return clients.size;
+}
+// Ensure non-blocking delayed execution
+function requestAnimationFrameMock(fn) {
+    setTimeout(fn, 0);
+}
+//# sourceMappingURL=sse.js.map

package/dist/server/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../src/server/sse.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,GAAG,IAAI,GAAG,EAAa,CAAC;AAErC,MAAM,UAAU,YAAY,CAAC,QAAkB;IAC7C,MAAM,MAAM,GAAc;QACxB,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACjE,QAAQ;KACT,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAEpB,yBAAyB,CAAC,GAAG,EAAE;QAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;YACjE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;QAC7F,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QACxB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAiB;IAC9C,MAAM,OAAO,GAAG,SAAS,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,MAAM,CAAC;IAC9E,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;YACjE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,OAAO,CAAC,IAAI,CAAC;AACtB,CAAC;AAED,wCAAwC;AACxC,SAAS,yBAAyB,CAAC,EAAc;IAC/C,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AACpB,CAAC"}

package/dist/setup/sdkDetector.d.ts

@@ -0,0 +1,9 @@
+export type DetectedSdk = "stripe" | "twilio" | "resend" | "openai" | "github" | "discord";
+export type PackageJson = {
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    peerDependencies?: Record<string, string>;
+    optionalDependencies?: Record<string, string>;
+};
+export declare function readPackageJson(projectRoot?: string): Promise<PackageJson>;
+export declare function detectSdks(packageJson: PackageJson): DetectedSdk[];

package/dist/setup/sdkDetector.js

@@ -0,0 +1,31 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+const SDK_PACKAGES = {
+    stripe: "stripe",
+    twilio: "twilio",
+    resend: "resend",
+    openai: "openai",
+    "@octokit/rest": "github",
+    "discord.js": "discord"
+};
+export async function readPackageJson(projectRoot = process.cwd()) {
+    const raw = await readFile(join(projectRoot, "package.json"), "utf8");
+    const parsed = JSON.parse(raw);
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed))
+        return {};
+    return parsed;
+}
+export function detectSdks(packageJson) {
+    const names = new Set();
+    for (const group of [packageJson.dependencies, packageJson.devDependencies, packageJson.peerDependencies, packageJson.optionalDependencies]) {
+        for (const name of Object.keys(group ?? {}))
+            names.add(name);
+    }
+    const detected = [];
+    for (const [packageName, sdk] of Object.entries(SDK_PACKAGES)) {
+        if (names.has(packageName))
+            detected.push(sdk);
+    }
+    return detected;
+}
+//# sourceMappingURL=sdkDetector.js.map

package/dist/setup/sdkDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdkDetector.js","sourceRoot":"","sources":["../../src/setup/sdkDetector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAWjC,MAAM,YAAY,GAAgC;IAChD,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,eAAe,EAAE,QAAQ;IACzB,YAAY,EAAE,SAAS;CACxB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE;IAC/D,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC;IACtE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;IAC1C,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IACtF,OAAO,MAAqB,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,WAAwB;IACjD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,KAAK,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,WAAW,CAAC,eAAe,EAAE,WAAW,CAAC,gBAAgB,EAAE,WAAW,CAAC,oBAAoB,CAAC,EAAE,CAAC;QAC5I,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,KAAK,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9D,IAAI,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/setup/setupGenerator.d.ts

@@ -0,0 +1,28 @@
+import { type DetectedSdk } from "./sdkDetector.js";
+export type SetupFile = {
+    path: string;
+    description: string;
+    content: string;
+};
+export type SetupPatch = {
+    title: string;
+    appliesTo: string;
+    content: string;
+};
+export type RepoSetup = {
+    projectRoot: string;
+    detected: DetectedSdk[];
+    commands: string[];
+    files: SetupFile[];
+    patches: SetupPatch[];
+    summary: string;
+};
+export type SetupWriteResult = {
+    created: string[];
+    skipped: string[];
+};
+export declare function generateRepoSetup(projectRoot?: string): Promise<RepoSetup>;
+export declare function writeRepoSetup(projectRoot?: string): Promise<{
+    setup: RepoSetup;
+    result: SetupWriteResult;
+}>;

package/dist/setup/setupGenerator.js

@@ -0,0 +1,146 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { readPackageJson, detectSdks } from "./sdkDetector.js";
+import { generateAiRules } from "../rules/aiRules.js";
+export async function generateRepoSetup(projectRoot = process.cwd()) {
+    const packageJson = await readPackageJson(projectRoot);
+    const detected = detectSdks(packageJson);
+    const rules = await generateAiRules(projectRoot);
+    const mcpConfig = buildMcpConfig();
+    const mcpServers = { mcpServers: { ghostapi: mcpConfig } };
+    const autoApprovedMcpServers = { mcpServers: { ghostapi: { ...mcpConfig, disabled: false, autoApprove: ["inspect_state", "get_traffic_logs"] } } };
+    const files = [
+        { path: ".cursorrules", description: "Cursor agent rules for GhostAPI-first local API development.", content: rules.content },
+        { path: "AGENTS.md", description: "Universal agent instructions for Aider, Codex-style agents, Gemini CLI, OpenCode, Goose, OpenClaw, and Hermes.", content: buildAgentInstructions(detected) },
+        { path: ".cursor/mcp.json", description: "Cursor MCP server config.", content: JSON.stringify(mcpServers, null, 2) },
+        { path: "cline_mcp_settings.json", description: "Cline MCP server config snippet.", content: JSON.stringify(autoApprovedMcpServers, null, 2) },
+        { path: "claude_desktop_config.json", description: "Claude Desktop MCP server config snippet.", content: JSON.stringify(mcpServers, null, 2) },
+        { path: ".ghostapi/agent-configs/universal-mcp.json", description: "Universal stdio MCP block for any MCP-compatible client.", content: JSON.stringify(mcpServers, null, 2) },
+        { path: ".ghostapi/agent-configs/claude-cli.json", description: "Claude CLI MCP snippet.", content: JSON.stringify(mcpServers, null, 2) },
+        { path: ".ghostapi/agent-configs/claude-desktop.json", description: "Claude Desktop MCP snippet.", content: JSON.stringify(mcpServers, null, 2) },
+        { path: ".ghostapi/agent-configs/cline.json", description: "Cline MCP snippet.", content: JSON.stringify(autoApprovedMcpServers, null, 2) },
+        { path: ".ghostapi/agent-configs/aider.md", description: "Aider instructions and MCP handoff note.", content: buildClientInstructions("Aider", detected) },
+        { path: ".ghostapi/agent-configs/codex.json", description: "Codex MCP snippet.", content: JSON.stringify(mcpServers, null, 2) },
+        { path: ".ghostapi/agent-configs/opencode-cli.json", description: "OpenCode CLI MCP snippet.", content: JSON.stringify(mcpServers, null, 2) },
+        { path: ".ghostapi/agent-configs/opencode-desktop.json", description: "OpenCode Desktop MCP snippet.", content: JSON.stringify(mcpServers, null, 2) },
+        { path: ".ghostapi/agent-configs/gemini-cli.json", description: "Gemini CLI MCP snippet.", content: JSON.stringify(mcpServers, null, 2) },
+        { path: ".ghostapi/agent-configs/goose.json", description: "Goose MCP snippet.", content: JSON.stringify(mcpServers, null, 2) },
+        { path: ".ghostapi/agent-configs/openclaw.json", description: "OpenClaw MCP snippet.", content: JSON.stringify(mcpServers, null, 2) },
+        { path: ".ghostapi/agent-configs/hermes-desktop.json", description: "Hermes Desktop MCP snippet.", content: JSON.stringify(mcpServers, null, 2) }
+    ];
+    return {
+        projectRoot,
+        detected,
+        commands: ["ghostapi init", "ghostapi doctor", "ghostapi start --open", "ghostapi mcp"],
+        files,
+        patches: buildPatches(detected),
+        summary: buildSummary(detected)
+    };
+}
+export async function writeRepoSetup(projectRoot = process.cwd()) {
+    const setup = await generateRepoSetup(projectRoot);
+    const result = { created: [], skipped: [] };
+    for (const file of setup.files) {
+        const target = join(projectRoot, file.path);
+        try {
+            await mkdir(dirname(target), { recursive: true });
+            await writeFile(target, file.content, { encoding: "utf8", flag: "wx" });
+            result.created.push(file.path);
+        }
+        catch (error) {
+            if (error instanceof Error && "code" in error && error.code === "EEXIST") {
+                result.skipped.push(file.path);
+                continue;
+            }
+            throw error;
+        }
+    }
+    return { setup, result };
+}
+function buildMcpConfig() {
+    return { command: "ghostapi", args: ["mcp"] };
+}
+function buildSummary(detected) {
+    const sdkText = detected.length > 0 ? detected.join(", ") : "no known provider SDKs";
+    return `Detected ${sdkText}. Copy the generated files into your repo, run ghostapi start --open, and point local SDK clients at http://127.0.0.1:8080.`;
+}
+function buildAgentInstructions(detected) {
+    return buildClientInstructions("any coding agent", detected);
+}
+function buildClientInstructions(clientName, detected) {
+    const sdkText = detected.length > 0 ? detected.join(", ") : "no known provider SDKs";
+    return [
+        "# GhostAPI Agent Instructions",
+        "",
+        `These instructions are for ${clientName} working in this repository.`,
+        "",
+        "## Local API Runtime",
+        "",
+        "Use GhostAPI as the local API layer for third-party integrations.",
+        "",
+        "```bash",
+        "ghostapi start --open",
+        "ghostapi mcp",
+        "```",
+        "",
+        "Route local SDKs and HTTP clients to `http://127.0.0.1:8080` instead of live providers during development and tests.",
+        "",
+        "## MCP Server",
+        "",
+        "If your client supports MCP, add this stdio server:",
+        "",
+        "```json",
+        JSON.stringify({ mcpServers: { ghostapi: buildMcpConfig() } }, null, 2),
+        "```",
+        "",
+        "Use GhostAPI MCP tools to inspect local state, configure deterministic responses, read traffic logs, and toggle Chaos Mode.",
+        "",
+        "## Detected SDKs",
+        "",
+        `Detected: ${sdkText}.`,
+        "",
+        "Never use production API keys or live provider endpoints unless the user explicitly asks."
+    ].join("\n");
+}
+function buildPatches(detected) {
+    const patches = [
+        {
+            title: "Local API base URL env",
+            appliesTo: ".env.local",
+            content: [
+                "GHOSTAPI_BASE_URL=http://127.0.0.1:8080",
+                "GHOSTAPI_STRIPE_BASE_URL=http://127.0.0.1:8080",
+                "GHOSTAPI_OPENAI_BASE_URL=http://127.0.0.1:8080"
+            ].join("\n")
+        }
+    ];
+    if (detected.includes("stripe")) {
+        patches.push({
+            title: "Stripe client patch",
+            appliesTo: "Stripe client initialization",
+            content: [
+                "import Stripe from \"stripe\";",
+                "",
+                "export const stripe = new Stripe(process.env.STRIPE_SECRET_KEY ?? \"sk_test_ghostapi\", {",
+                "  apiBase: process.env.GHOSTAPI_STRIPE_BASE_URL ?? \"http://127.0.0.1:8080\"",
+                "});"
+            ].join("\n")
+        });
+    }
+    if (detected.includes("openai")) {
+        patches.push({
+            title: "OpenAI client patch",
+            appliesTo: "OpenAI client initialization",
+            content: [
+                "import OpenAI from \"openai\";",
+                "",
+                "export const openai = new OpenAI({",
+                "  apiKey: process.env.OPENAI_API_KEY ?? \"sk-ghostapi\",",
+                "  baseURL: process.env.GHOSTAPI_OPENAI_BASE_URL ?? \"http://127.0.0.1:8080/v1\"",
+                "});"
+            ].join("\n")
+        });
+    }
+    return patches;
+}
+//# sourceMappingURL=setupGenerator.js.map

package/dist/setup/setupGenerator.js.map

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

package/dist/state/index.d.ts

@@ -0,0 +1 @@
+export type StateRecord = Record<string, unknown>;

package/dist/state/index.js

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

package/dist/state/index.js.map

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

package/dist/state/stateExtractor.d.ts

@@ -0,0 +1,3 @@
+import type { NormalizedRequest } from "../proxy/requestNormalizer.js";
+export declare function extractIdFromResponse(responseBody: unknown): string | undefined;
+export declare function extractIdFromPath(request: NormalizedRequest): string | undefined;

package/dist/state/stateExtractor.js

@@ -0,0 +1,36 @@
+import { isJsonObject } from "../utils/json.js";
+const ID_FIELDS = ["id", "sid", "uuid", "name", "number"];
+export function extractIdFromResponse(responseBody) {
+    if (!isJsonObject(responseBody)) {
+        return undefined;
+    }
+    for (const field of ID_FIELDS) {
+        const value = responseBody[field];
+        if (typeof value === "string" && value.trim().length > 0) {
+            return value;
+        }
+        if (typeof value === "number") {
+            return value.toString();
+        }
+    }
+    return undefined;
+}
+export function extractIdFromPath(request) {
+    const { path } = request;
+    const segments = path.split("/").filter(Boolean);
+    if (segments.length === 0)
+        return undefined;
+    const lastSegment = segments[segments.length - 1];
+    if (lastSegment === undefined)
+        return undefined;
+    // Test explicitly for ID-like shapes
+    if (lastSegment.includes("_") || lastSegment.includes("-") || /\d/.test(lastSegment)) {
+        return lastSegment;
+    }
+    // Pure generic fallback for test mocks like "/v1/customers/1"
+    if (segments.length >= 2 && !lastSegment.match(/^[a-z]+s$/i)) {
+        return lastSegment;
+    }
+    return undefined;
+}
+//# sourceMappingURL=stateExtractor.js.map

package/dist/state/stateExtractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateExtractor.js","sourceRoot":"","sources":["../../src/state/stateExtractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AAE1D,MAAM,UAAU,qBAAqB,CAAC,YAAqB;IACzD,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,CAAC;QAChC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAA0B;IAC1D,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEjD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAE5C,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAClD,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAEhD,qCAAqC;IACrC,IAAI,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QACrF,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,8DAA8D;IAC9D,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7D,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/state/stateResolver.d.ts

@@ -0,0 +1,8 @@
+import type { NormalizedRequest } from "../proxy/requestNormalizer.js";
+type ResolvedState = {
+    status: number;
+    headers: Record<string, string>;
+    body: unknown;
+};
+export declare function resolveState(request: NormalizedRequest, provider: string): Promise<ResolvedState | null>;
+export {};