@superblocksteam/vite-plugin-file-sync 1.99.99-next.2 → 2.0.0-SNAPSHOT.2143e2e95d0107ab

package/dist/ai-service/prompts/summarize-api-usage.js

@@ -0,0 +1,30 @@
+export function buildSummarizeApiUsagePrompt({ apiName, apiSourceCode, integrations, pages, usageContexts, }) {
+    const usageList = usageContexts
+        .map((ctx, i) => `### Usage ${i + 1}: ${ctx.filePath}\n\`\`\`tsx\n${ctx.surroundingCode}\n\`\`\``)
+        .join("\n\n");
+    const integrationContext = integrations && integrations.length > 0
+        ? `\nIntegrations used by this API:\n${integrations.map((int) => `- ${int.key} (${int.pluginId}): ID = ${int.id}`).join("\n")}\n`
+        : "";
+    const pageContext = pages && pages.length > 0
+        ? `\nPages in the app:\n${pages.map((p) => `- ${p.name}: scopeId = ${p.scopeId}`).join("\n")}\n`
+        : "";
+    const apiSourceSection = apiSourceCode
+        ? `\nAPI source code for context:\n\`\`\`typescript\n${apiSourceCode}\n\`\`\`\n`
+        : "";
+    return `Your task: Summarize how the API "${apiName}" is used across this application, written for a non-technical person.
+${apiSourceSection}${integrationContext}${pageContext}
+${usageContexts.length === 0 ? `This API is not currently used anywhere in the app.` : `The API is referenced in ${usageContexts.length} place(s):\n\n${usageList}`}
+
+REQUIREMENTS:
+- Write a concise summary (2-5 sentences) explaining WHERE and WHY this API is called in the app
+- Use plain language a non-developer can understand (e.g., "This API is called on the @Homepage[id=abc-123] to load the list of users when the page first opens.")
+- Be confident and assertive. State facts directly. Do NOT hedge with phrases like "it appears", "it seems", "looking at the code", "based on the code". Just say what the API does and where.
+- When referencing pages, use the @PageName[id=<scopeId>] syntax so they render as clickable tags in the UI. For example: "This API is called on the @Dashboard[id=abc-123] page to load data." Match the page name and scopeId from the page list above.
+- Explain the purpose/trigger of each call (e.g., "when the form is submitted", "when the page loads", "when the user clicks refresh")
+- If the API is not used anywhere, say "This API is not currently used anywhere in the app."
+- DO NOT use programming jargon or code snippets in your answer
+- DO NOT mention function names, hooks, or technical implementation details
+- DO NOT use markdown headings or titles — just write the paragraph directly
+- When referencing integrations, use the @Integration[id=<UUID>] syntax so they render as tags in the UI. For example: "This API connects to @Integration[id=abc-123] to fetch order data."`;
+}
+//# sourceMappingURL=summarize-api-usage.js.map

package/dist/ai-service/prompts/summarize-api-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize-api-usage.js","sourceRoot":"","sources":["../../../src/ai-service/prompts/summarize-api-usage.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,4BAA4B,CAAC,EAC3C,OAAO,EACP,aAAa,EACb,YAAY,EACZ,KAAK,EACL,aAAa,GAOd;IACC,MAAM,SAAS,GAAG,aAAa;SAC5B,GAAG,CACF,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CACT,aAAa,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,QAAQ,gBAAgB,GAAG,CAAC,eAAe,UAAU,CACnF;SACA,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,MAAM,kBAAkB,GACtB,YAAY,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC;QACrC,CAAC,CAAC,qCAAqC,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,QAAQ,WAAW,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;QACjI,CAAC,CAAC,EAAE,CAAC;IAET,MAAM,WAAW,GACf,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QACvB,CAAC,CAAC,wBAAwB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;QAChG,CAAC,CAAC,EAAE,CAAC;IAET,MAAM,gBAAgB,GAAG,aAAa;QACpC,CAAC,CAAC,qDAAqD,aAAa,YAAY;QAChF,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO,qCAAqC,OAAO;EACnD,gBAAgB,GAAG,kBAAkB,GAAG,WAAW;EACnD,aAAa,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,qDAAqD,CAAC,CAAC,CAAC,4BAA4B,aAAa,CAAC,MAAM,iBAAiB,SAAS,EAAE;;;;;;;;;;;;4LAYyB,CAAC;AAC7L,CAAC"}

package/dist/ai-service/quota-client.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Pre-call AI quota check (extracted from AiService for APPS-4708).
+ *
+ * One HTTP round-trip to the server per prompt, before generation starts.
+ * Fail-open by design: a missing JWT or a flaky quota endpoint must never
+ * block legitimate work, so every failure path returns `allowed: true`.
+ * The check runs inside a `quota.check` LLMObs span so the pre-LLM latency
+ * it adds is attributed in the trace.
+ */
+import { type Logger } from "../util/logger.js";
+import { LLMObsTracer } from "./llmobs/tracer.js";
+export interface AiQuotaResult {
+    allowed: boolean;
+    reason?: string;
+    message?: string;
+}
+interface CheckAiQuotaOptions {
+    superblocksBaseUrl: string;
+    /** Resolved auth token; the no-token case fails open without a request. */
+    jwt: string | undefined;
+    logger: Logger;
+    /** Injectable for tests; defaults to the global fetch. */
+    fetchFn?: typeof fetch;
+    /** Maximum time to wait for the quota endpoint before failing open. */
+    timeoutMs?: number;
+    /** Injectable for tests; defaults to the LLMObs singleton. */
+    tracer?: LLMObsTracer;
+}
+export declare function checkAiQuota(options: CheckAiQuotaOptions): Promise<AiQuotaResult>;
+export {};
+//# sourceMappingURL=quota-client.d.ts.map

package/dist/ai-service/quota-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota-client.d.ts","sourceRoot":"","sources":["../../src/ai-service/quota-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,mBAAmB;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2EAA2E;IAC3E,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAID,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CA4BxB"}

package/dist/ai-service/quota-client.js

@@ -0,0 +1,72 @@
+/**
+ * Pre-call AI quota check (extracted from AiService for APPS-4708).
+ *
+ * One HTTP round-trip to the server per prompt, before generation starts.
+ * Fail-open by design: a missing JWT or a flaky quota endpoint must never
+ * block legitimate work, so every failure path returns `allowed: true`.
+ * The check runs inside a `quota.check` LLMObs span so the pre-LLM latency
+ * it adds is attributed in the trace.
+ */
+import { getErrorMeta } from "../util/logger.js";
+import { LLMObsTracer } from "./llmobs/tracer.js";
+const DEFAULT_QUOTA_CHECK_TIMEOUT_MS = 5_000;
+export async function checkAiQuota(options) {
+    const { superblocksBaseUrl, jwt, logger } = options;
+    const fetchFn = options.fetchFn ?? fetch;
+    const tracer = options.tracer ?? LLMObsTracer.instance;
+    if (!jwt) {
+        logger.warn("[ai-service] No JWT available for quota check, skipping");
+        return { allowed: true };
+    }
+    return tracer.trace({ kind: "task", name: "quota.check" }, async (span) => {
+        const startedAt = performance.now();
+        const result = await fetchQuota({
+            superblocksBaseUrl,
+            jwt,
+            logger,
+            fetchFn,
+            timeoutMs: options.timeoutMs ?? DEFAULT_QUOTA_CHECK_TIMEOUT_MS,
+        });
+        tracer.annotate(span, {
+            metadata: {
+                allowed: result.allowed,
+                durationMs: Math.round(performance.now() - startedAt),
+                ...(result.reason !== undefined ? { reason: result.reason } : {}),
+            },
+        });
+        return result;
+    });
+}
+async function fetchQuota({ superblocksBaseUrl, jwt, logger, fetchFn, timeoutMs, }) {
+    try {
+        const url = `${superblocksBaseUrl}/api/v1/ai/quota`;
+        const signal = AbortSignal.timeout(timeoutMs);
+        const response = await fetchFn(url, {
+            method: "GET",
+            signal,
+            headers: {
+                Authorization: `Bearer ${jwt}`,
+                "Content-Type": "application/json",
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`Call to v1/ai/quota failed with status ${response.status}`);
+        }
+        const quota = (await response.json());
+        if (!quota.allowed) {
+            const reason = quota.reason ?? "token_limit_exceeded";
+            const message = reason === "trial_expired"
+                ? "Your AI trial period has ended."
+                : reason === "no_seat_assigned"
+                    ? "You don't have an AI Builder license assigned. Ask your admin to assign a license."
+                    : "Your organization has reached its AI usage limit.";
+            return { allowed: false, reason, message };
+        }
+        return { allowed: true };
+    }
+    catch (error) {
+        logger.warn("[ai-service] Quota check failed, allowing request", getErrorMeta(error));
+        return { allowed: true };
+    }
+}
+//# sourceMappingURL=quota-client.js.map

package/dist/ai-service/quota-client.js.map

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

package/dist/ai-service/recording/block-traversal.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Utilities for recursively walking the block tree in an API definition.
+ *
+ * The block structure supports nesting via loop, tryCatch, conditional,
+ * parallel, and stream containers. These helpers factor out that traversal
+ * so callers only need to provide a per-step visitor callback.
+ */
+/**
+ * Replace steps whose integration ID is not in `availableIntegrationIds`
+ * with a javascript stub.
+ *
+ * @returns The set of integration IDs that were sanitized.
+ */
+export declare function sanitizeBlockIntegrations(blocks: any[], availableIntegrationIds: Set<string>): Set<string>;
+//# sourceMappingURL=block-traversal.d.ts.map

package/dist/ai-service/recording/block-traversal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-traversal.d.ts","sourceRoot":"","sources":["../../../src/ai-service/recording/block-traversal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA8EH;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,GAAG,EAAE,EACb,uBAAuB,EAAE,GAAG,CAAC,MAAM,CAAC,GACnC,GAAG,CAAC,MAAM,CAAC,CAqBb"}

package/dist/ai-service/recording/block-traversal.js

@@ -0,0 +1,104 @@
+/**
+ * Utilities for recursively walking the block tree in an API definition.
+ *
+ * The block structure supports nesting via loop, tryCatch, conditional,
+ * parallel, and stream containers. These helpers factor out that traversal
+ * so callers only need to provide a per-step visitor callback.
+ */
+/** Built-in integration types that do not reference external integrations. */
+const BUILT_IN_INTEGRATION_TYPES = new Set(["javascript", "python"]);
+/**
+ * Recursively walk every step in a block tree, invoking `visitor` for each
+ * object that contains a `step` property (i.e. regular blocks and stream
+ * triggers).
+ *
+ * Handles all nested block containers: loop, tryCatch (try/catch/finally),
+ * conditional (if/elseIf/else), parallel (static paths + dynamic), and
+ * stream (trigger + process).
+ */
+function forEachStep(blocks, visitor) {
+    for (const block of blocks) {
+        // Direct step
+        if (block.step) {
+            visitor(block);
+        }
+        // Loop
+        if (block.loop?.blocks) {
+            forEachStep(block.loop.blocks, visitor);
+        }
+        // TryCatch
+        if (block.tryCatch) {
+            for (const branch of ["try", "catch", "finally"]) {
+                if (block.tryCatch[branch]?.blocks) {
+                    forEachStep(block.tryCatch[branch].blocks, visitor);
+                }
+            }
+        }
+        // Conditional
+        if (block.conditional) {
+            if (block.conditional.if?.blocks) {
+                forEachStep(block.conditional.if.blocks, visitor);
+            }
+            if (Array.isArray(block.conditional.elseIf)) {
+                for (const branch of block.conditional.elseIf) {
+                    if (branch?.blocks) {
+                        forEachStep(branch.blocks, visitor);
+                    }
+                }
+            }
+            if (block.conditional.else?.blocks) {
+                forEachStep(block.conditional.else.blocks, visitor);
+            }
+        }
+        // Parallel (static paths + dynamic blocks)
+        if (block.parallel) {
+            if (block.parallel.static?.paths) {
+                for (const pathBlocks of Object.values(block.parallel.static.paths)) {
+                    if (pathBlocks?.blocks) {
+                        forEachStep(pathBlocks.blocks, visitor);
+                    }
+                }
+            }
+            if (block.parallel.dynamic?.blocks) {
+                forEachStep(block.parallel.dynamic.blocks, visitor);
+            }
+        }
+        // Stream
+        if (block.stream) {
+            if (block.stream.trigger?.step) {
+                visitor(block.stream.trigger);
+            }
+            if (block.stream.process?.blocks) {
+                forEachStep(block.stream.process.blocks, visitor);
+            }
+        }
+    }
+}
+/**
+ * Replace steps whose integration ID is not in `availableIntegrationIds`
+ * with a javascript stub.
+ *
+ * @returns The set of integration IDs that were sanitized.
+ */
+export function sanitizeBlockIntegrations(blocks, availableIntegrationIds) {
+    const sanitizedIds = new Set();
+    forEachStep(blocks, (owner) => {
+        const id = owner.step?.integration;
+        if (!id || BUILT_IN_INTEGRATION_TYPES.has(id))
+            return;
+        if (availableIntegrationIds.has(id))
+            return;
+        // Remove all existing keys from the step
+        for (const key of Object.keys(owner.step)) {
+            delete owner.step[key];
+        }
+        // Replace with a javascript stub
+        owner.step.integration = "javascript";
+        owner.step.javascript = {
+            body: `return null; // This step has been replaced (originally ${id})`,
+        };
+        sanitizedIds.add(id);
+    });
+    return sanitizedIds;
+}
+//# sourceMappingURL=block-traversal.js.map

package/dist/ai-service/recording/block-traversal.js.map

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

package/dist/ai-service/recording/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Recording module for capturing AI interactions.
+ *
+ * This module provides infrastructure for recording socket messages,
+ * tool executions, and LLM calls for later replay.
+ *
+ * @example
+ * ```typescript
+ * import { RecordingManager } from './recording';
+ *
+ * const recorder = new RecordingManager({
+ *   recordingsDir: '/path/to/.superblocks/recordings',
+ *   appRootDirPath: '/path/to/app',
+ * });
+ *
+ * // Start recording with optional initial commit ID
+ * recorder.start(initialCommitId);
+ *
+ * // Entries are written to {recordingsDir}/{sessionId}/recording.jsonl
+ * ```
+ */
+export { RecordingManager } from "./recording-manager.js";
+export { createToolRecordingMiddleware } from "./recorders/tool-recorder.js";
+export { createRecordingFetch } from "./recorders/llm-recorder.js";
+export { SnapshotManager } from "./snapshot-manager.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/ai-service/recording/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai-service/recording/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,OAAO,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/ai-service/recording/index.js

@@ -0,0 +1,29 @@
+/**
+ * Recording module for capturing AI interactions.
+ *
+ * This module provides infrastructure for recording socket messages,
+ * tool executions, and LLM calls for later replay.
+ *
+ * @example
+ * ```typescript
+ * import { RecordingManager } from './recording';
+ *
+ * const recorder = new RecordingManager({
+ *   recordingsDir: '/path/to/.superblocks/recordings',
+ *   appRootDirPath: '/path/to/app',
+ * });
+ *
+ * // Start recording with optional initial commit ID
+ * recorder.start(initialCommitId);
+ *
+ * // Entries are written to {recordingsDir}/{sessionId}/recording.jsonl
+ * ```
+ */
+// Manager
+export { RecordingManager } from "./recording-manager.js";
+// Recorders
+export { createToolRecordingMiddleware } from "./recorders/tool-recorder.js";
+export { createRecordingFetch } from "./recorders/llm-recorder.js";
+// Snapshot management
+export { SnapshotManager } from "./snapshot-manager.js";
+//# sourceMappingURL=index.js.map

package/dist/ai-service/recording/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ai-service/recording/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,UAAU;AACV,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,YAAY;AACZ,OAAO,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,sBAAsB;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/ai-service/recording/recorders/llm-recorder.d.ts

@@ -0,0 +1,35 @@
+/**
+ * LLM call recorder fetch wrapper.
+ *
+ * Creates a fetch wrapper that records LLM calls passing through
+ * the Clark provider. Handles both streaming (doStream) and
+ * non-streaming (doGenerate) requests.
+ */
+import type { FetchFunction } from "@ai-sdk/provider-utils";
+import type { RecordingManager } from "../recording-manager.js";
+/**
+ * Creates a recording fetch wrapper for LLM calls.
+ *
+ * This wrapper intercepts requests to the LLM provider and records
+ * both the request and response data. It handles:
+ * - Non-streaming requests (doGenerate): Clones and parses the JSON response
+ * - Streaming requests (doStream): Buffers SSE chunks to reconstruct the response
+ *
+ * @param recorder - The RecordingManager instance
+ * @param baseFetch - The underlying fetch function to wrap (defaults to global fetch)
+ * @returns A wrapped fetch function that records LLM calls
+ *
+ * @example
+ * ```typescript
+ * const recordingFetch = createRecordingFetch(recorder);
+ *
+ * // Use in provider settings
+ * const settings = {
+ *   clark: {
+ *     fetch: recordingFetch
+ *   }
+ * };
+ * ```
+ */
+export declare function createRecordingFetch(recorder: RecordingManager, baseFetch?: FetchFunction): FetchFunction;
+//# sourceMappingURL=llm-recorder.d.ts.map

package/dist/ai-service/recording/recorders/llm-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-recorder.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/recording/recorders/llm-recorder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AA6BhE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,GAAE,aAAqB,GAC/B,aAAa,CAoDf"}

package/dist/ai-service/recording/recorders/llm-recorder.js

@@ -0,0 +1,221 @@
+/**
+ * LLM call recorder fetch wrapper.
+ *
+ * Creates a fetch wrapper that records LLM calls passing through
+ * the Clark provider. Handles both streaming (doStream) and
+ * non-streaming (doGenerate) requests.
+ */
+/**
+ * Creates a recording fetch wrapper for LLM calls.
+ *
+ * This wrapper intercepts requests to the LLM provider and records
+ * both the request and response data. It handles:
+ * - Non-streaming requests (doGenerate): Clones and parses the JSON response
+ * - Streaming requests (doStream): Buffers SSE chunks to reconstruct the response
+ *
+ * @param recorder - The RecordingManager instance
+ * @param baseFetch - The underlying fetch function to wrap (defaults to global fetch)
+ * @returns A wrapped fetch function that records LLM calls
+ *
+ * @example
+ * ```typescript
+ * const recordingFetch = createRecordingFetch(recorder);
+ *
+ * // Use in provider settings
+ * const settings = {
+ *   clark: {
+ *     fetch: recordingFetch
+ *   }
+ * };
+ * ```
+ */
+export function createRecordingFetch(recorder, baseFetch = fetch) {
+    return async (url, init) => {
+        // If recording is not enabled, just pass through
+        if (!recorder.isEnabled()) {
+            return baseFetch(url, init);
+        }
+        const startTime = Date.now();
+        const urlString = url.toString();
+        // Parse request body
+        let requestBody = {};
+        try {
+            if (init?.body && typeof init.body === "string") {
+                requestBody = JSON.parse(init.body);
+            }
+        }
+        catch {
+            // Failed to parse request body, continue with empty object
+        }
+        // Determine if this is a streaming request
+        const isStreaming = requestBody.stream === true || urlString.includes("/stream");
+        const endpoint = isStreaming ? "stream" : "generate";
+        // Execute the actual fetch
+        const response = await baseFetch(url, init);
+        // Record based on response type
+        if (isStreaming && response.body) {
+            // For streaming responses, wrap the body to capture chunks
+            return createRecordingStreamResponse(response, recorder, requestBody, endpoint, startTime);
+        }
+        else {
+            // For non-streaming responses, clone and parse
+            return recordNonStreamingResponse(response, recorder, requestBody, endpoint, startTime);
+        }
+    };
+}
+/**
+ * Records a non-streaming LLM response.
+ */
+async function recordNonStreamingResponse(response, recorder, requestBody, endpoint, startTime) {
+    try {
+        // Clone response to read body without consuming it
+        const clonedResponse = response.clone();
+        const responseBody = await clonedResponse.json();
+        const recording = {
+            endpoint,
+            request: {
+                model: requestBody.model ?? "unknown",
+                messages: requestBody.messages ?? [],
+                tools: requestBody.tools,
+                system: requestBody.system,
+            },
+            response: {
+                content: responseBody.text ?? responseBody.content ?? "",
+                toolCalls: responseBody.toolCalls ?? [],
+                usage: responseBody.usage
+                    ? {
+                        inputTokens: responseBody.usage.inputTokens,
+                        outputTokens: responseBody.usage.outputTokens,
+                        totalTokens: responseBody.usage.totalTokens,
+                    }
+                    : undefined,
+                finishReason: responseBody.finishReason,
+            },
+            durationMs: Date.now() - startTime,
+        };
+        recorder.recordLLM(recording);
+    }
+    catch {
+        // Failed to parse response, record what we have
+        recorder.recordLLM({
+            endpoint,
+            request: {
+                model: requestBody.model ?? "unknown",
+                messages: requestBody.messages ?? [],
+                tools: requestBody.tools,
+                system: requestBody.system,
+            },
+            response: {
+                content: "[failed to parse response]",
+            },
+            durationMs: Date.now() - startTime,
+        });
+    }
+    return response;
+}
+/**
+ * Creates a response with a recording stream wrapper.
+ *
+ * The stream passes through all chunks while accumulating data
+ * for recording. When the stream completes, the accumulated
+ * response is recorded.
+ */
+function createRecordingStreamResponse(response, recorder, requestBody, endpoint, startTime) {
+    if (!response.body) {
+        return response;
+    }
+    const accumulated = {
+        content: "",
+        toolCalls: [],
+    };
+    const transformedBody = response.body.pipeThrough(new TransformStream({
+        transform(chunk, controller) {
+            // Pass through the chunk
+            controller.enqueue(chunk);
+            // Try to parse and accumulate SSE data
+            try {
+                const text = new TextDecoder().decode(chunk);
+                accumulateSSEData(text, accumulated);
+            }
+            catch {
+                // Failed to parse chunk, continue
+            }
+        },
+        flush() {
+            // Stream completed, record the accumulated response
+            const recording = {
+                endpoint,
+                request: {
+                    model: requestBody.model ?? "unknown",
+                    messages: requestBody.messages ?? [],
+                    tools: requestBody.tools,
+                    system: requestBody.system,
+                },
+                response: {
+                    content: accumulated.content,
+                    toolCalls: accumulated.toolCalls.length > 0
+                        ? accumulated.toolCalls
+                        : undefined,
+                    usage: accumulated.usage,
+                    finishReason: accumulated.finishReason,
+                },
+                durationMs: Date.now() - startTime,
+            };
+            recorder.recordLLM(recording);
+        },
+    }));
+    return new Response(transformedBody, {
+        status: response.status,
+        statusText: response.statusText,
+        headers: response.headers,
+    });
+}
+/**
+ * Accumulates data from SSE chunks.
+ *
+ * Parses SSE data lines and extracts relevant content for recording.
+ */
+function accumulateSSEData(text, accumulated) {
+    // Split by SSE data lines
+    const lines = text.split("\n");
+    for (const line of lines) {
+        if (!line.startsWith("data: "))
+            continue;
+        const data = line.slice(6); // Remove "data: " prefix
+        if (data === "[DONE]")
+            continue;
+        try {
+            const parsed = JSON.parse(data);
+            // Handle different chunk types from the Clark provider
+            switch (parsed.type) {
+                case "text-delta":
+                    accumulated.content += parsed.textDelta ?? parsed.text ?? "";
+                    break;
+                case "tool-call":
+                    accumulated.toolCalls.push({
+                        toolCallId: parsed.toolCallId,
+                        toolName: parsed.toolName,
+                        input: parsed.input,
+                    });
+                    break;
+                case "finish":
+                case "step-finish":
+                    if (parsed.usage) {
+                        accumulated.usage = {
+                            inputTokens: parsed.usage.inputTokens ?? parsed.usage.promptTokens,
+                            outputTokens: parsed.usage.outputTokens ?? parsed.usage.completionTokens,
+                            totalTokens: parsed.usage.totalTokens,
+                        };
+                    }
+                    if (parsed.finishReason) {
+                        accumulated.finishReason = parsed.finishReason;
+                    }
+                    break;
+            }
+        }
+        catch {
+            // Failed to parse SSE data, continue
+        }
+    }
+}
+//# sourceMappingURL=llm-recorder.js.map

package/dist/ai-service/recording/recorders/llm-recorder.js.map

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

package/dist/ai-service/recording/recorders/socket-recorder.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Socket message recorder middleware.
+ *
+ * Creates a middleware that records socket messages passing through
+ * the socket manager. Follows the existing middleware pattern used
+ * for authentication.
+ */
+import type { GenericMiddleware, RequestContextBase } from "@superblocksteam/shared";
+import type { RecordingManager } from "../recording-manager.js";
+/**
+ * Extended context that includes method information.
+ * The TracedSocket infrastructure provides the method name in the context.
+ */
+type RecordingContext = RequestContextBase & {
+    /** The socket method being called */
+    method?: string;
+};
+/**
+ * Creates a socket recording middleware.
+ *
+ * This middleware records all socket messages before passing them to the next
+ * handler. It captures the method name from context, request parameters, and peer ID.
+ *
+ * The actual data cleaning is handled by RecordingManager.recordSocket(),
+ * which uses a switch statement to decide what to record for each method.
+ *
+ * @param recorder - The RecordingManager instance
+ * @returns A GenericMiddleware that records socket messages
+ *
+ * @example
+ * ```typescript
+ * const recordingMiddleware = createSocketRecordingMiddleware(recorder);
+ * // Add to middleware array in socket-manager.ts alongside authMiddleware
+ * ```
+ */
+export declare function createSocketRecordingMiddleware(recorder: RecordingManager): GenericMiddleware<any, RecordingContext>;
+export {};
+//# sourceMappingURL=socket-recorder.d.ts.map