rivet-design 0.12.4 → 0.13.0

package/dist/mcp/agent-variants/tools.d.ts

@@ -1,187 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { type VariantQaResult, type VisualEditorAttachment, type WorkItemStatus } from './contracts';
-import { VariantHistoryService } from '../../services/VariantHistoryService';
-import { slugifyPrompt } from './generatedDestination';
-export { slugifyPrompt };
-import type { AgentVariantsOrchestrator } from './WorktreeOrchestrator';
-import type { IntegrationsClient } from '../../services/IntegrationsClient';
-import { BrowserAgentClient } from '../../services/BrowserAgentClient';
-import type { MCPVariantsTelemetryMetadata } from '../../services/MCPVariantsTelemetry';
-/**
- * Coerce `output` to a structured value when an agent (incorrectly) sends a
- * stringified JSON. The MCP schema accepts `z.unknown()` so the call doesn't
- * fail validation, but downstream consumers (e.g. `output.html` in
- * WorktreeOrchestrator) expect an object and silently no-op on strings —
- * leaving the variant stuck at "not ready" until session expiry.
- */
-export declare const normalizeAgentOutput: (output: unknown) => unknown;
-/**
- * Reject caller-supplied fresh destinations at the generic variants boundary.
- * Fresh projects must go through `start_variants(mode='zero_to_one')`, where
- * the server derives the destination path before delegating to the
- * orchestrator.
- */
-export interface ToolDeps {
-    orchestrator: AgentVariantsOrchestrator;
-    leaseOwner: () => string;
-    /**
-     * Zero-to-one only: ensure the Rivet visual editor is up on the future
-     * destination path so the iframe is ready when variants render. Wired
-     * from server.ts. When
-     * absent (e.g. unit tests), start_variants(mode='zero_to_one') skips
-     * the auto-open and the caller can open the editor themselves.
-     */
-    ensureVisualEditorOpen?: (input: {
-        /** The materialize target — where the generated subproject's files live
-         *  (`<workspaceRoot>/.rivet/<slug>/`). */
-        projectPath: string;
-        /** The user's working dir that owns all Rivet artifacts. The session
-         *  bridge tracks this so `bridge.getProjectPath()` resolves to a stable
-         *  workspace across multiple zero-to-one sessions. */
-        workspaceRoot: string;
-        /** 'vite' for scaffolded apps; 'static' for an empty / HTML-only
-         *  workspace opened in static mode (no dev server). */
-        framework: 'vite' | 'static';
-    }) => Promise<VisualEditorAttachment>;
-    /**
-     * Existing-project only: ensure the Rivet visual editor is open with the
-     * selected project mounted as the default preview upstream. Wired from
-     * server.ts so `Original` can clear variant targeting back to the base app.
-     */
-    ensureExistingVisualEditorOpen?: (input: {
-        projectPath: string;
-        workspaceRoot: string;
-        framework: 'vite' | 'static';
-    }) => Promise<VisualEditorAttachment>;
-    /** Test seam — defaults to process.cwd. */
-    cwd?: () => string;
-    /** Resolve the currently-open editor projectPath, if any. Used by
-     *  `start_variants(mode='zero_to_one')` so new projects default to the
-     *  workspace the user is already working in. Wired from server.ts. */
-    getProjectPath?: () => string | null;
-    telemetry?: VariantsToolTelemetry;
-    /** Read-only access to the on-disk variant history under
-     *  `<projectPath>/.rivet/variants/`. Defaults to a fresh
-     *  `VariantHistoryService` since the service is stateless. */
-    variantHistory?: VariantHistoryService;
-    /** Test seam — defaults to os.homedir. Used to authorize asset-source
-     *  roots for source-grounded zero-to-one sessions. */
-    homedir?: () => string;
-    /** Optional authenticated integration client for source-context enrichment. */
-    integrationsClient?: Pick<IntegrationsClient, 'fetchPinterest' | 'fetchArena'>;
-    /**
-     * Surfaces the "Connect design references" dialog in the Rivet editor when a
-     * source needs a provider account.
-     */
-    openIntegrationConnectUrl?: (input: {
-        provider: 'pinterest' | 'arena';
-    }) => Promise<void> | void;
-    /**
-     * Browser-agent client for `capture_design_evidence`. Calls the proxy to
-     * render reference URLs server-side (provider keys never reach the CLI).
-     * Defaults to a fresh `BrowserAgentClient`; injectable for tests.
-     */
-    browserAgentClient?: Pick<BrowserAgentClient, 'captureDesignEvidence'>;
-    /** Returns whether the variant commit/send path is enabled for this session. */
-    isVariantSendEnabled?: () => Promise<boolean>;
-    /**
-     * Live depth of the server's variant-request/refine FIFO (the bridge's
-     * `pendingVariantRequestCount()`). Surfaced on agent-facing responses as
-     * `pendingVariantRequests` so a watch loop that stopped can detect stranded
-     * batches still queued and resume draining. Optional so unit tests that omit
-     * it simply skip the field; wired from server.ts to read the live bridge.
-     */
-    pendingVariantRequestCount?: () => number;
-    /**
-     * Resolves the project path that owns a UI-originated variant request.
-     * Returns null when the request id is not known to the visual editor bridge.
-     */
-    resolveVariantRequestProjectPath?: (requestId: string) => string | null;
-    /**
-     * Associates a UI-originated variant request batch with the work items that
-     * will handle it. Wired by the MCP server to keep the bridge lease alive until
-     * those items finish.
-     */
-    claimVariantRequestLease?: (args: {
-        requestId?: string;
-        sessionId: string;
-        workItemIds: string[];
-    }) => void;
-    /** Marks a leased UI variant-request work item as handled. */
-    completeVariantRequestWork?: (args: {
-        sessionId: string;
-        workItemId: string;
-        status: WorkItemStatus;
-        requeuedForRegeneration?: boolean;
-        aborted?: boolean;
-    }) => void;
-    /**
-     * Records the user's first successful variants kickoff so the first-run
-     * "proactive directions" onboarding nudge stops firing. Wired from server.ts
-     * to `ConfigManager.markFirstVariantsRun()`; idempotent and omitted in tests.
-     */
-    markFirstVariantsRun?: () => void;
-}
-/**
- * Telemetry surface used by the variants tools. All methods optional so unit
- * tests can omit them; the real telemetry service structurally satisfies this.
- */
-export interface VariantsToolTelemetry {
-    track(event: string, properties: Record<string, unknown>): void;
-    trackAgentVariantsRequestStarted?: (data: MCPVariantsTelemetryMetadata) => void;
-    trackAgentVariantsRequestAccepted?: (data: MCPVariantsTelemetryMetadata) => void;
-    trackAgentVariantsRequestRejected?: (data: MCPVariantsTelemetryMetadata) => void;
-    trackAgentVariantsCommitFailed?: (data: MCPVariantsTelemetryMetadata) => void;
-    trackAgentVariantsSourceContextQuality?: (data: {
-        sessionId: string;
-        sourceUrlCount: number;
-        artifactCount: number;
-        hasScreenshotReferences: boolean;
-        preserveBrand: boolean;
-    }) => void;
-    /**
-     * Outcome metadata only — counts of links, successes, low-signal pages,
-     * fetch failures, blocked targets, the merge strategy, and cache outcome
-     * counts. Full URLs, fetched HTML, file paths, and extracted text MUST NOT
-     * be forwarded.
-     */
-    trackAgentVariantsInspirationExtraction?: (data: {
-        sessionId: string;
-        inspirationLinkCount: number;
-        referenceLinkCount: number;
-        successfulExtractions: number;
-        lowSignalCount: number;
-        fetchFailureCount: number;
-        blockedTargetCount: number;
-        mergeStrategy: 'merge' | 'separate' | 'none';
-        cacheHitCount: number;
-        cacheMissCount: number;
-        cacheStaleCount: number;
-        cacheVersionMismatchCount: number;
-        cacheLowConfidenceCount: number;
-        cacheRegenerationCount: number;
-        cacheForcedRefresh: boolean;
-        cacheReuseAgeBucket?: 'lt_1h' | '1h_24h' | '1d_7d' | '7d_30d' | 'gt_30d';
-        cacheReuseConfidenceBucket?: 'low' | 'medium' | 'high';
-    }) => void;
-}
-export declare function registerAgentVariantsTools(mcp: McpServer, deps: ToolDeps): void;
-/**
- * User-facing prompt template for QA failures. Lists each failed variant
- * with its summary + first asset/console issue, then asks the user
- * whether to retry, continue with healthy variants, or cancel. Kept as
- * data (not a log line) so the calling agent can present the choice
- * directly to the human.
- */
-export declare function buildQaFailurePrompt(failures: Array<{
-    label: string;
-    qa: VariantQaResult;
-}>, healthyCount: number): string;
-/**
- * Compose the agent-facing instruction for a variant the QA gate re-queued
- * for its single regeneration. Names the variant, surfaces the QA notes, and
- * spells out the exact next call so the agent re-leases and regenerates
- * instead of treating `waiting_for_results` as "nothing to do".
- */
-export declare function buildRegeneratePrompt(label: string | undefined, qa?: VariantQaResult): string;
-//# sourceMappingURL=tools.d.ts.map

package/dist/mcp/agent-variants/tools.d.ts.map

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