@velum-labs/cursorkit 0.1.0

package/dist/src/gen/internapi/v1/internapi_pb.d.ts

@@ -0,0 +1,121 @@
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file internapi/v1/internapi.proto.
+ */
+export declare const file_internapi_v1_internapi: GenFile;
+/**
+ * internapi.v1.ImageBlobData
+ *
+ * @generated from message internapi.v1.ImageBlobData
+ */
+export type ImageBlobData = Message<"internapi.v1.ImageBlobData"> & {
+    /**
+     * @generated from field: string mime_type = 1;
+     */
+    mimeType: string;
+};
+/**
+ * Describes the message internapi.v1.ImageBlobData.
+ * Use `create(ImageBlobDataSchema)` to create a new message.
+ */
+export declare const ImageBlobDataSchema: GenMessage<ImageBlobData>;
+/**
+ * internapi.v1.BlobData
+ *
+ * @generated from message internapi.v1.BlobData
+ */
+export type BlobData = Message<"internapi.v1.BlobData"> & {
+    /**
+     * @generated from field: internapi.v1.BlobType blob_type = 1;
+     */
+    blobType: BlobType;
+    /**
+     * @generated from field: bytes blob_id = 2;
+     */
+    blobId: Uint8Array;
+    /**
+     * @generated from field: int32 index = 3;
+     */
+    index: number;
+    /**
+     * @generated from field: internapi.v1.ImageBlobData image_data = 4;
+     */
+    imageData?: ImageBlobData | undefined;
+};
+/**
+ * Describes the message internapi.v1.BlobData.
+ * Use `create(BlobDataSchema)` to create a new message.
+ */
+export declare const BlobDataSchema: GenMessage<BlobData>;
+/**
+ * internapi.v1.BlobDataPerMessage
+ *
+ * @generated from message internapi.v1.BlobDataPerMessage
+ */
+export type BlobDataPerMessage = Message<"internapi.v1.BlobDataPerMessage"> & {
+    /**
+     * @generated from field: repeated internapi.v1.BlobData blob_data = 1;
+     */
+    blobData: BlobData[];
+};
+/**
+ * Describes the message internapi.v1.BlobDataPerMessage.
+ * Use `create(BlobDataPerMessageSchema)` to create a new message.
+ */
+export declare const BlobDataPerMessageSchema: GenMessage<BlobDataPerMessage>;
+/**
+ * internapi.v1.BlobType
+ *
+ * @generated from enum internapi.v1.BlobType
+ */
+export declare enum BlobType {
+    /**
+     * @generated from enum value: BLOB_TYPE_BLOB_TYPE_UNSPECIFIED = 0;
+     */
+    BLOB_TYPE_UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: BLOB_TYPE_BLOB_TYPE_IMAGE = 1;
+     */
+    BLOB_TYPE_IMAGE = 1,
+    /**
+     * @generated from enum value: BLOB_TYPE_BLOB_TYPE_INVOCATION_CONTEXT = 2;
+     */
+    BLOB_TYPE_INVOCATION_CONTEXT = 2,
+    /**
+     * @generated from enum value: BLOB_TYPE_BLOB_TYPE_EXTRA_CONTEXT = 3;
+     */
+    BLOB_TYPE_EXTRA_CONTEXT = 3,
+    /**
+     * @generated from enum value: BLOB_TYPE_BLOB_TYPE_GIT_PR_DIFF_SELECTION = 4;
+     */
+    BLOB_TYPE_GIT_PR_DIFF_SELECTION = 4,
+    /**
+     * @generated from enum value: BLOB_TYPE_BLOB_TYPE_SELECTED_PULL_REQUEST = 5;
+     */
+    BLOB_TYPE_SELECTED_PULL_REQUEST = 5,
+    /**
+     * @generated from enum value: BLOB_TYPE_BLOB_TYPE_TEXT = 6;
+     */
+    BLOB_TYPE_TEXT = 6,
+    /**
+     * @generated from enum value: BLOB_TYPE_BLOB_TYPE_RICH_TEXT = 7;
+     */
+    BLOB_TYPE_RICH_TEXT = 7,
+    /**
+     * @generated from enum value: BLOB_TYPE_BLOB_TYPE_EXTERNAL_LINK_PDF = 8;
+     */
+    BLOB_TYPE_EXTERNAL_LINK_PDF = 8,
+    /**
+     * @generated from enum value: BLOB_TYPE_BLOB_TYPE_DOCUMENT = 9;
+     */
+    BLOB_TYPE_DOCUMENT = 9,
+    /**
+     * @generated from enum value: BLOB_TYPE_BLOB_TYPE_VIDEO = 10;
+     */
+    BLOB_TYPE_VIDEO = 10
+}
+/**
+ * Describes the enum internapi.v1.BlobType.
+ */
+export declare const BlobTypeSchema: GenEnum<BlobType>;

package/dist/src/gen/internapi/v1/internapi_pb.js

@@ -0,0 +1,79 @@
+// @generated by protoc-gen-es v2.12.0 with parameter "target=ts"
+// @generated from file internapi/v1/internapi.proto (package internapi.v1, syntax proto3)
+/* eslint-disable */
+import { enumDesc, fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv2";
+/**
+ * Describes the file internapi/v1/internapi.proto.
+ */
+export const file_internapi_v1_internapi = /*@__PURE__*/ fileDesc("ChxpbnRlcm5hcGkvdjEvaW50ZXJuYXBpLnByb3RvEgxpbnRlcm5hcGkudjEiIgoNSW1hZ2VCbG9iRGF0YRIRCgltaW1lX3R5cGUYASABKAkihgEKCEJsb2JEYXRhEikKCWJsb2JfdHlwZRgBIAEoDjIWLmludGVybmFwaS52MS5CbG9iVHlwZRIPCgdibG9iX2lkGAIgASgMEg0KBWluZGV4GAMgASgFEi8KCmltYWdlX2RhdGEYBCABKAsyGy5pbnRlcm5hcGkudjEuSW1hZ2VCbG9iRGF0YSI/ChJCbG9iRGF0YVBlck1lc3NhZ2USKQoJYmxvYl9kYXRhGAEgAygLMhYuaW50ZXJuYXBpLnYxLkJsb2JEYXRhKqwDCghCbG9iVHlwZRIjCh9CTE9CX1RZUEVfQkxPQl9UWVBFX1VOU1BFQ0lGSUVEEAASHQoZQkxPQl9UWVBFX0JMT0JfVFlQRV9JTUFHRRABEioKJkJMT0JfVFlQRV9CTE9CX1RZUEVfSU5WT0NBVElPTl9DT05URVhUEAISJQohQkxPQl9UWVBFX0JMT0JfVFlQRV9FWFRSQV9DT05URVhUEAMSLQopQkxPQl9UWVBFX0JMT0JfVFlQRV9HSVRfUFJfRElGRl9TRUxFQ1RJT04QBBItCilCTE9CX1RZUEVfQkxPQl9UWVBFX1NFTEVDVEVEX1BVTExfUkVRVUVTVBAFEhwKGEJMT0JfVFlQRV9CTE9CX1RZUEVfVEVYVBAGEiEKHUJMT0JfVFlQRV9CTE9CX1RZUEVfUklDSF9URVhUEAcSKQolQkxPQl9UWVBFX0JMT0JfVFlQRV9FWFRFUk5BTF9MSU5LX1BERhAIEiAKHEJMT0JfVFlQRV9CTE9CX1RZUEVfRE9DVU1FTlQQCRIdChlCTE9CX1RZUEVfQkxPQl9UWVBFX1ZJREVPEApCJVojY3Vyc29yL2dlbi9pbnRlcm5hcGkvdjE7aW50ZXJuYXBpdjFiBnByb3RvMw");
+/**
+ * Describes the message internapi.v1.ImageBlobData.
+ * Use `create(ImageBlobDataSchema)` to create a new message.
+ */
+export const ImageBlobDataSchema = /*@__PURE__*/ messageDesc(file_internapi_v1_internapi, 0);
+/**
+ * Describes the message internapi.v1.BlobData.
+ * Use `create(BlobDataSchema)` to create a new message.
+ */
+export const BlobDataSchema = /*@__PURE__*/ messageDesc(file_internapi_v1_internapi, 1);
+/**
+ * Describes the message internapi.v1.BlobDataPerMessage.
+ * Use `create(BlobDataPerMessageSchema)` to create a new message.
+ */
+export const BlobDataPerMessageSchema = /*@__PURE__*/ messageDesc(file_internapi_v1_internapi, 2);
+/**
+ * internapi.v1.BlobType
+ *
+ * @generated from enum internapi.v1.BlobType
+ */
+export var BlobType;
+(function (BlobType) {
+    /**
+     * @generated from enum value: BLOB_TYPE_BLOB_TYPE_UNSPECIFIED = 0;
+     */
+    BlobType[BlobType["BLOB_TYPE_UNSPECIFIED"] = 0] = "BLOB_TYPE_UNSPECIFIED";
+    /**
+     * @generated from enum value: BLOB_TYPE_BLOB_TYPE_IMAGE = 1;
+     */
+    BlobType[BlobType["BLOB_TYPE_IMAGE"] = 1] = "BLOB_TYPE_IMAGE";
+    /**
+     * @generated from enum value: BLOB_TYPE_BLOB_TYPE_INVOCATION_CONTEXT = 2;
+     */
+    BlobType[BlobType["BLOB_TYPE_INVOCATION_CONTEXT"] = 2] = "BLOB_TYPE_INVOCATION_CONTEXT";
+    /**
+     * @generated from enum value: BLOB_TYPE_BLOB_TYPE_EXTRA_CONTEXT = 3;
+     */
+    BlobType[BlobType["BLOB_TYPE_EXTRA_CONTEXT"] = 3] = "BLOB_TYPE_EXTRA_CONTEXT";
+    /**
+     * @generated from enum value: BLOB_TYPE_BLOB_TYPE_GIT_PR_DIFF_SELECTION = 4;
+     */
+    BlobType[BlobType["BLOB_TYPE_GIT_PR_DIFF_SELECTION"] = 4] = "BLOB_TYPE_GIT_PR_DIFF_SELECTION";
+    /**
+     * @generated from enum value: BLOB_TYPE_BLOB_TYPE_SELECTED_PULL_REQUEST = 5;
+     */
+    BlobType[BlobType["BLOB_TYPE_SELECTED_PULL_REQUEST"] = 5] = "BLOB_TYPE_SELECTED_PULL_REQUEST";
+    /**
+     * @generated from enum value: BLOB_TYPE_BLOB_TYPE_TEXT = 6;
+     */
+    BlobType[BlobType["BLOB_TYPE_TEXT"] = 6] = "BLOB_TYPE_TEXT";
+    /**
+     * @generated from enum value: BLOB_TYPE_BLOB_TYPE_RICH_TEXT = 7;
+     */
+    BlobType[BlobType["BLOB_TYPE_RICH_TEXT"] = 7] = "BLOB_TYPE_RICH_TEXT";
+    /**
+     * @generated from enum value: BLOB_TYPE_BLOB_TYPE_EXTERNAL_LINK_PDF = 8;
+     */
+    BlobType[BlobType["BLOB_TYPE_EXTERNAL_LINK_PDF"] = 8] = "BLOB_TYPE_EXTERNAL_LINK_PDF";
+    /**
+     * @generated from enum value: BLOB_TYPE_BLOB_TYPE_DOCUMENT = 9;
+     */
+    BlobType[BlobType["BLOB_TYPE_DOCUMENT"] = 9] = "BLOB_TYPE_DOCUMENT";
+    /**
+     * @generated from enum value: BLOB_TYPE_BLOB_TYPE_VIDEO = 10;
+     */
+    BlobType[BlobType["BLOB_TYPE_VIDEO"] = 10] = "BLOB_TYPE_VIDEO";
+})(BlobType || (BlobType = {}));
+/**
+ * Describes the enum internapi.v1.BlobType.
+ */
+export const BlobTypeSchema = /*@__PURE__*/ enumDesc(file_internapi_v1_internapi, 0);

package/dist/src/logger.d.ts

@@ -0,0 +1,8 @@
+import type { LogLevel } from "./config.js";
+export interface Logger {
+    debug(message: string, metadata?: Record<string, unknown>): void;
+    info(message: string, metadata?: Record<string, unknown>): void;
+    warn(message: string, metadata?: Record<string, unknown>): void;
+    error(message: string, metadata?: Record<string, unknown>): void;
+}
+export declare function createLogger(level: LogLevel): Logger;

package/dist/src/logger.js

@@ -0,0 +1,37 @@
+import { redactForLogging, redactValue } from "./redaction.js";
+const LEVELS = {
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40,
+};
+export function createLogger(level) {
+    const threshold = LEVELS[level];
+    function write(entryLevel, message, metadata = {}) {
+        if (LEVELS[entryLevel] < threshold) {
+            return;
+        }
+        const entry = {
+            ts: new Date().toISOString(),
+            level: entryLevel,
+            message,
+            ...metadata,
+        };
+        const output = redactValue(JSON.stringify(redactForLogging(entry)));
+        if (entryLevel === "error") {
+            console.error(output);
+        }
+        else if (entryLevel === "warn") {
+            console.warn(output);
+        }
+        else {
+            console.log(output);
+        }
+    }
+    return {
+        debug: (message, metadata) => write("debug", message, metadata),
+        info: (message, metadata) => write("info", message, metadata),
+        warn: (message, metadata) => write("warn", message, metadata),
+        error: (message, metadata) => write("error", message, metadata),
+    };
+}

package/dist/src/modelFusion/cursorHarness.d.ts

@@ -0,0 +1,146 @@
+import type { ArtifactRef, CursorRunRequestV1, CursorRunResultV1, HarnessRunRequestV1, HarnessRunResultV1, JsonValue, ModelFusionCapabilityStatus, ModelFusionStatus } from "../fixtures/modelFusion.js";
+export type CursorCapabilityPolicy = "record-and-degrade" | "fail-closed";
+export type CursorHarnessModel = {
+    id: string;
+    model: string;
+    endpointId?: string;
+};
+export type CursorAdapterMode = "fixture" | "real";
+export type CursorEvidenceTier = "smoke" | "real";
+export type CursorRouteInventorySummary = {
+    observedRoutes: number;
+    passThroughRoutes: number;
+    interceptedRoutes: number;
+    degradedRoutes?: number;
+    observedPaths?: string[];
+    failedRouteCount?: number;
+    diagnosis?: string[];
+};
+export type CursorCandidateEvidence = {
+    transcript?: string;
+    diff?: string;
+    log?: string;
+    outputSummary?: string;
+    rawPayload?: string;
+    observedModel?: string;
+    modelResolutionStatus?: CursorModelResolutionStatus;
+    modelResolutionReason?: string;
+    routeInventory?: CursorRouteInventorySummary;
+    routeInventoryArtifact?: ArtifactRef;
+    artifacts?: CursorArtifactEvidence[];
+    toolEvidence?: Record<string, JsonValue>[];
+};
+export type CursorArtifactEvidence = {
+    artifactId?: string;
+    kind: ArtifactRef["kind"];
+    uri?: string;
+    content?: string;
+    hash?: string;
+    redactionStatus?: ArtifactRef["redaction_status"];
+};
+export type CursorHarnessBaseOptions = {
+    capabilityPolicy?: CursorCapabilityPolicy;
+    artifactBaseUri?: string;
+    producer?: string;
+    producerVersion?: string;
+    producerGitSha?: string;
+    now?: () => Date;
+};
+export type CursorFixtureHarnessOptions = CursorHarnessBaseOptions & {
+    adapterMode?: "fixture";
+};
+export type CursorRealHarnessOptions = CursorHarnessBaseOptions & {
+    adapterMode: "real";
+    cursorRunClient: CursorRunClient;
+    capabilities?: Record<string, ModelFusionCapabilityStatus>;
+};
+export type CursorHarnessOptions = CursorFixtureHarnessOptions | CursorRealHarnessOptions;
+export type RunCursorCandidateInput = {
+    request: HarnessRunRequestV1;
+    candidateId: string;
+    model: CursorHarnessModel;
+    workspacePath?: string;
+    worktreePath?: string;
+    timeoutMs?: number;
+    requestedModel?: string;
+    requiredCapabilities?: string[];
+    evidence?: CursorCandidateEvidence;
+    metadata?: Record<string, JsonValue>;
+};
+export type CursorCapabilityIssue = {
+    capability: string;
+    status: ModelFusionCapabilityStatus;
+    requestedStatus?: ModelFusionCapabilityStatus;
+    reason: string;
+};
+export type CursorModelResolutionStatus = "matched" | "unknown" | "blocked_override";
+export type CursorModelEvidence = {
+    requestedModel: string;
+    observedModel: string;
+    modelId: string;
+    endpointId: string;
+    status: CursorModelResolutionStatus;
+    reason: string;
+};
+export type RunCursorCandidateOutput = {
+    cursorRequest: CursorRunRequestV1;
+    cursorResult: CursorRunResultV1;
+    harnessResult: HarnessRunResultV1;
+    missingCapabilities: CursorCapabilityIssue[];
+    metadata: Record<string, JsonValue>;
+};
+export type CursorRunClientRequest = {
+    cursorRequest: CursorRunRequestV1;
+    candidateId: string;
+    model: CursorHarnessModel;
+    workspacePath: string;
+    timeoutMs?: number;
+    capabilities: Record<string, ModelFusionCapabilityStatus>;
+};
+export type CursorRunClientResult = {
+    status?: ModelFusionStatus;
+    outputSummary?: string;
+    transcript?: string;
+    rawPayload?: string;
+    observedModel?: string;
+    modelId?: string;
+    endpointId?: string;
+    routeInventory?: CursorRouteInventorySummary;
+    routeInventoryArtifact?: ArtifactRef;
+    artifacts?: CursorArtifactEvidence[];
+    capabilities?: Record<string, ModelFusionCapabilityStatus>;
+    toolEvidence?: Record<string, JsonValue>[];
+};
+export type CursorRunClient = {
+    capabilities?: () => Record<string, ModelFusionCapabilityStatus>;
+    run(input: CursorRunClientRequest): Promise<CursorRunClientResult>;
+};
+export type CursorBridgeRunClientOptions = {
+    bridgeBaseUrl: string;
+    authToken?: string;
+    headers?: Record<string, string>;
+    fetch?: typeof fetch;
+};
+export type CursorFixtureHarness = {
+    id: "cursor";
+    adapterMode: "fixture";
+    capabilities(): Record<string, ModelFusionCapabilityStatus>;
+    runCursorCandidate(input: RunCursorCandidateInput): RunCursorCandidateOutput;
+};
+export type CursorRealHarness = {
+    id: "cursor";
+    adapterMode: "real";
+    capabilities(): Record<string, ModelFusionCapabilityStatus>;
+    runCursorCandidate(input: RunCursorCandidateInput): Promise<RunCursorCandidateOutput>;
+};
+export type CursorHarness = CursorFixtureHarness | CursorRealHarness;
+export declare class CursorCapabilityError extends Error {
+    readonly issues: CursorCapabilityIssue[];
+    constructor(issues: CursorCapabilityIssue[]);
+}
+export declare function cursorHarness(options: CursorRealHarnessOptions): CursorRealHarness;
+export declare function cursorHarness(options?: CursorFixtureHarnessOptions): CursorFixtureHarness;
+export declare function runCursorCandidate(input: RunCursorCandidateInput, options?: CursorFixtureHarnessOptions): RunCursorCandidateOutput;
+export declare function runRealCursorCandidate(input: RunCursorCandidateInput, options: CursorRealHarnessOptions): Promise<RunCursorCandidateOutput>;
+export declare function cursorCapabilities(): Record<string, ModelFusionCapabilityStatus>;
+export declare function createCursorBridgeRunClient(options: CursorBridgeRunClientOptions): CursorRunClient;