@velum-labs/cursorkit 0.1.0

package/docs/route-contract-manifest.json

@@ -0,0 +1,288 @@
+{
+  "schemaVersion": 1,
+  "generatedBy": "src/tools/baselineInventory.ts",
+  "sources": ["docs/service-manifest.json", "src/routes.ts", "src/config.ts"],
+  "routes": [
+    {
+      "path": "/aiserver.v1.AiService/AvailableModels",
+      "policy": "intercept",
+      "owner": "bridge-core",
+      "packageName": "aiserver.v1",
+      "service": "AiService",
+      "method": "AvailableModels",
+      "inputType": "AvailableModelsRequest",
+      "outputType": "AvailableModelsResponse",
+      "serverStreaming": false,
+      "protoBacked": true,
+      "supportLevel": "implemented",
+      "expectedMethods": ["POST"],
+      "expectedContentTypes": [
+        "application/proto",
+        "application/connect+proto"
+      ],
+      "fixtureStatus": "synthetic-or-unit-covered",
+      "testStatus": "focused-tests-present",
+      "realClientEvidence": "cli-or-unit-evidence",
+      "reason": "Merge conservative local model entries with upstream models.",
+      "uncertainty": "Model metadata fields beyond local id/display/context remain fixture-gated."
+    },
+    {
+      "path": "/aiserver.v1.AiService/GetUsableModels",
+      "policy": "intercept",
+      "owner": "bridge-core",
+      "packageName": "aiserver.v1",
+      "service": "AiService",
+      "method": "GetUsableModels",
+      "inputType": "AgentV1_GetUsableModelsRequest",
+      "outputType": "AgentV1_GetUsableModelsResponse",
+      "serverStreaming": false,
+      "protoBacked": true,
+      "supportLevel": "implemented",
+      "expectedMethods": ["POST"],
+      "expectedContentTypes": [
+        "application/proto",
+        "application/connect+proto"
+      ],
+      "fixtureStatus": "synthetic-or-unit-covered",
+      "testStatus": "focused-tests-present",
+      "realClientEvidence": "cli-or-unit-evidence",
+      "reason": "Cursor Agent CLI reads this route for its model picker; merge local model entries with upstream usable models.",
+      "uncertainty": "Desktop model picker usage must be confirmed by route inventory before adding desktop-specific assumptions."
+    },
+    {
+      "path": "/aiserver.v1.AiService/GetDefaultModelForCli",
+      "policy": "intercept",
+      "owner": "bridge-core",
+      "packageName": "aiserver.v1",
+      "service": "AiService",
+      "method": "GetDefaultModelForCli",
+      "inputType": "AgentV1_GetDefaultModelForCliRequest",
+      "outputType": "AgentV1_GetDefaultModelForCliResponse",
+      "serverStreaming": false,
+      "protoBacked": true,
+      "supportLevel": "implemented",
+      "expectedMethods": ["POST"],
+      "expectedContentTypes": [
+        "application/proto",
+        "application/connect+proto"
+      ],
+      "fixtureStatus": "synthetic-or-unit-covered",
+      "testStatus": "focused-tests-present",
+      "realClientEvidence": "cli-or-unit-evidence",
+      "reason": "Preserve upstream's CLI default model when present; otherwise provide the first registered local model.",
+      "uncertainty": "Client-specific default selection remains gated by observed CLI/ACP traffic."
+    },
+    {
+      "path": "/aiserver.v1.AiService/GetDefaultModel",
+      "policy": "intercept",
+      "owner": "bridge-core",
+      "packageName": "aiserver.v1",
+      "service": "AiService",
+      "method": "GetDefaultModel",
+      "inputType": "GetDefaultModelRequest",
+      "outputType": "GetDefaultModelResponse",
+      "serverStreaming": false,
+      "protoBacked": true,
+      "supportLevel": "implemented",
+      "expectedMethods": ["POST"],
+      "expectedContentTypes": [
+        "application/proto",
+        "application/connect+proto"
+      ],
+      "fixtureStatus": "synthetic-or-unit-covered",
+      "testStatus": "focused-tests-present",
+      "realClientEvidence": "cli-or-unit-evidence",
+      "reason": "Return the first registered local model as a fallback default for non-CLI callers.",
+      "uncertainty": "Desktop reliance on this route is not yet proven by captured traffic."
+    },
+    {
+      "path": "/aiserver.v1.AiService/NameAgent",
+      "policy": "intercept",
+      "owner": "bridge-core",
+      "packageName": "aiserver.v1",
+      "service": "AiService",
+      "method": "NameAgent",
+      "inputType": "AgentV1_NameAgentRequest",
+      "outputType": "AgentV1_NameAgentResponse",
+      "serverStreaming": false,
+      "protoBacked": true,
+      "supportLevel": "implemented",
+      "expectedMethods": ["POST"],
+      "expectedContentTypes": [
+        "application/proto",
+        "application/connect+proto"
+      ],
+      "fixtureStatus": "synthetic-or-unit-covered",
+      "testStatus": "focused-tests-present",
+      "realClientEvidence": "cli-or-unit-evidence",
+      "reason": "Provide a local fallback name for Cursor Agent sessions.",
+      "uncertainty": "Exact naming behavior can be refined once real client naming fixtures are replayed."
+    },
+    {
+      "path": "/aiserver.v1.ServerConfigService/GetServerConfig",
+      "policy": "intercept",
+      "owner": "bridge-core",
+      "packageName": "aiserver.v1",
+      "service": "ServerConfigService",
+      "method": "GetServerConfig",
+      "inputType": "GetServerConfigRequest",
+      "outputType": "GetServerConfigResponse",
+      "serverStreaming": false,
+      "protoBacked": true,
+      "supportLevel": "implemented",
+      "expectedMethods": ["POST"],
+      "expectedContentTypes": [
+        "application/proto",
+        "application/connect+proto"
+      ],
+      "fixtureStatus": "synthetic-or-unit-covered",
+      "testStatus": "focused-tests-present",
+      "realClientEvidence": "cli-or-unit-evidence",
+      "reason": "Rewrite agent URLs to the bridge origin and force HTTP/2 off for local bridge compatibility.",
+      "uncertainty": "Additional desktop server-config fields stay pass-through until captured fixtures prove they are needed."
+    },
+    {
+      "path": "/auth/full_stripe_profile",
+      "policy": "intercept",
+      "owner": "bridge-core",
+      "protoBacked": false,
+      "supportLevel": "implemented",
+      "expectedMethods": ["GET", "POST"],
+      "expectedContentTypes": ["application/json", "none"],
+      "fixtureStatus": "synthetic-or-unit-covered",
+      "testStatus": "focused-tests-present",
+      "realClientEvidence": "cli-or-unit-evidence",
+      "reason": "Provide a local desktop auth-profile shim for Cursor desktop experiments.",
+      "uncertainty": "HTTP auth profile routes are not proto-backed; exact desktop expectations remain traffic-gated."
+    },
+    {
+      "path": "/auth/stripe_profile",
+      "policy": "intercept",
+      "owner": "bridge-core",
+      "protoBacked": false,
+      "supportLevel": "implemented",
+      "expectedMethods": ["GET", "POST"],
+      "expectedContentTypes": ["application/json", "none"],
+      "fixtureStatus": "synthetic-or-unit-covered",
+      "testStatus": "focused-tests-present",
+      "realClientEvidence": "cli-or-unit-evidence",
+      "reason": "Provide a local desktop auth-profile shim for Cursor desktop experiments.",
+      "uncertainty": "HTTP auth profile routes are not proto-backed; exact desktop expectations remain traffic-gated."
+    },
+    {
+      "path": "/agent.v1.AgentService/Run",
+      "policy": "intercept",
+      "owner": "bridge-core",
+      "packageName": "agent.v1",
+      "service": "AgentService",
+      "method": "Run",
+      "inputType": "AgentClientMessage",
+      "outputType": "AgentServerMessage",
+      "serverStreaming": false,
+      "protoBacked": true,
+      "supportLevel": "conditional",
+      "expectedMethods": ["POST"],
+      "expectedContentTypes": [
+        "application/proto",
+        "application/connect+proto"
+      ],
+      "fixtureStatus": "needs-captured-fixture",
+      "testStatus": "partial-tests-present",
+      "realClientEvidence": "traffic-gated",
+      "reason": "Handle local Agent Run requests when the selected model is registered locally; otherwise preserve upstream behavior.",
+      "uncertainty": "Connect/native streaming shape needs broader fixture replay before this becomes fully fixture-backed."
+    },
+    {
+      "path": "/agent.v1.AgentService/RunSSE",
+      "policy": "intercept",
+      "owner": "bridge-core",
+      "packageName": "agent.v1",
+      "service": "AgentService",
+      "method": "RunSSE",
+      "inputType": "AiserverV1_BidiRequestId",
+      "outputType": "AgentServerMessage",
+      "serverStreaming": true,
+      "protoBacked": true,
+      "supportLevel": "conditional",
+      "expectedMethods": ["POST"],
+      "expectedContentTypes": [
+        "application/proto",
+        "application/connect+proto"
+      ],
+      "fixtureStatus": "needs-captured-fixture",
+      "testStatus": "partial-tests-present",
+      "realClientEvidence": "traffic-gated",
+      "reason": "Serve Cursor Agent local-model runs when paired with a matching BidiAppend payload.",
+      "uncertainty": "Bidi request-id flow and payload framing need captured fixture replay across CLI and ACP."
+    },
+    {
+      "path": "/aiserver.v1.BidiService/BidiAppend",
+      "policy": "intercept",
+      "owner": "bridge-core",
+      "packageName": "aiserver.v1",
+      "service": "BidiService",
+      "method": "BidiAppend",
+      "inputType": "BidiAppendRequest",
+      "outputType": "BidiAppendResponse",
+      "serverStreaming": false,
+      "protoBacked": true,
+      "supportLevel": "conditional",
+      "expectedMethods": ["POST"],
+      "expectedContentTypes": [
+        "application/proto",
+        "application/connect+proto"
+      ],
+      "fixtureStatus": "needs-captured-fixture",
+      "testStatus": "partial-tests-present",
+      "realClientEvidence": "traffic-gated",
+      "reason": "Decode Cursor Agent client messages and register pending local-model runs.",
+      "uncertainty": "Observed payload encodings include surprising nested forms; unsupported forms must pass through."
+    },
+    {
+      "path": "/aiserver.v1.ChatService/StreamUnifiedChatWithTools",
+      "policy": "intercept",
+      "owner": "bridge-core",
+      "packageName": "aiserver.v1",
+      "service": "ChatService",
+      "method": "StreamUnifiedChatWithTools",
+      "inputType": "StreamUnifiedChatRequestWithTools",
+      "outputType": "StreamUnifiedChatResponseWithTools",
+      "serverStreaming": false,
+      "protoBacked": true,
+      "supportLevel": "conditional",
+      "expectedMethods": ["POST"],
+      "expectedContentTypes": [
+        "application/proto",
+        "application/connect+proto"
+      ],
+      "fixtureStatus": "needs-captured-fixture",
+      "testStatus": "partial-tests-present",
+      "realClientEvidence": "traffic-gated",
+      "reason": "Handle requests only when selected model is registered locally; otherwise pass upstream.",
+      "uncertainty": "SSE, Poll, and idempotent chat variants stay pass-through until observed and decoded."
+    },
+    {
+      "path": "/aiserver.v1.AnalyticsService/UploadIssueTrace",
+      "policy": "intercept",
+      "owner": "bridge-core",
+      "packageName": "aiserver.v1",
+      "service": "AnalyticsService",
+      "method": "UploadIssueTrace",
+      "inputType": "UploadIssueTraceRequest",
+      "outputType": "UploadIssueTraceResponse",
+      "serverStreaming": false,
+      "protoBacked": true,
+      "supportLevel": "implemented",
+      "expectedMethods": ["POST"],
+      "expectedContentTypes": [
+        "application/proto",
+        "application/connect+proto"
+      ],
+      "fixtureStatus": "synthetic-or-unit-covered",
+      "testStatus": "focused-tests-present",
+      "realClientEvidence": "cli-or-unit-evidence",
+      "reason": "Acknowledge issue-trace uploads locally to avoid forwarding sensitive diagnostic blobs during local experiments.",
+      "uncertainty": "Full payload redaction and fixture coverage remain part of the reliability/security workstream."
+    }
+  ]
+}

package/docs/route-policy.json

@@ -0,0 +1,133 @@
+[
+  {
+    "path": "/aiserver.v1.AiService/AvailableModels",
+    "package": "aiserver.v1",
+    "service": "AiService",
+    "method": "AvailableModels",
+    "policy": "intercept",
+    "supportLevel": "implemented",
+    "reason": "Merge conservative local model entries with upstream models.",
+    "uncertainty": "Model metadata fields beyond local id/display/context remain fixture-gated."
+  },
+  {
+    "path": "/aiserver.v1.AiService/GetUsableModels",
+    "package": "aiserver.v1",
+    "service": "AiService",
+    "method": "GetUsableModels",
+    "policy": "intercept",
+    "supportLevel": "implemented",
+    "reason": "Cursor Agent CLI reads this route for its model picker; merge local model entries with upstream usable models.",
+    "uncertainty": "Desktop model picker usage must be confirmed by route inventory before adding desktop-specific assumptions."
+  },
+  {
+    "path": "/aiserver.v1.AiService/GetDefaultModelForCli",
+    "package": "aiserver.v1",
+    "service": "AiService",
+    "method": "GetDefaultModelForCli",
+    "policy": "intercept",
+    "supportLevel": "implemented",
+    "reason": "Preserve upstream's CLI default model when present; otherwise provide the first registered local model.",
+    "uncertainty": "Client-specific default selection remains gated by observed CLI/ACP traffic."
+  },
+  {
+    "path": "/aiserver.v1.AiService/GetDefaultModel",
+    "package": "aiserver.v1",
+    "service": "AiService",
+    "method": "GetDefaultModel",
+    "policy": "intercept",
+    "supportLevel": "implemented",
+    "reason": "Return the first registered local model as a fallback default for non-CLI callers.",
+    "uncertainty": "Desktop reliance on this route is not yet proven by captured traffic."
+  },
+  {
+    "path": "/aiserver.v1.AiService/NameAgent",
+    "package": "aiserver.v1",
+    "service": "AiService",
+    "method": "NameAgent",
+    "policy": "intercept",
+    "supportLevel": "implemented",
+    "reason": "Provide a local fallback name for Cursor Agent sessions.",
+    "uncertainty": "Exact naming behavior can be refined once real client naming fixtures are replayed."
+  },
+  {
+    "path": "/aiserver.v1.ServerConfigService/GetServerConfig",
+    "package": "aiserver.v1",
+    "service": "ServerConfigService",
+    "method": "GetServerConfig",
+    "policy": "intercept",
+    "supportLevel": "implemented",
+    "reason": "Rewrite agent URLs to the bridge origin and force HTTP/2 off for local bridge compatibility.",
+    "uncertainty": "Additional desktop server-config fields stay pass-through until captured fixtures prove they are needed."
+  },
+  {
+    "path": "/auth/full_stripe_profile",
+    "policy": "intercept",
+    "supportLevel": "implemented",
+    "reason": "Provide a local desktop auth-profile shim for Cursor desktop experiments.",
+    "uncertainty": "HTTP auth profile routes are not proto-backed; exact desktop expectations remain traffic-gated."
+  },
+  {
+    "path": "/auth/stripe_profile",
+    "policy": "intercept",
+    "supportLevel": "implemented",
+    "reason": "Provide a local desktop auth-profile shim for Cursor desktop experiments.",
+    "uncertainty": "HTTP auth profile routes are not proto-backed; exact desktop expectations remain traffic-gated."
+  },
+  {
+    "path": "/agent.v1.AgentService/Run",
+    "package": "agent.v1",
+    "service": "AgentService",
+    "method": "Run",
+    "policy": "intercept",
+    "supportLevel": "conditional",
+    "reason": "Handle local Agent Run requests when the selected model is registered locally; otherwise preserve upstream behavior.",
+    "uncertainty": "Connect/native streaming shape needs broader fixture replay before this becomes fully fixture-backed."
+  },
+  {
+    "path": "/agent.v1.AgentService/RunSSE",
+    "package": "agent.v1",
+    "service": "AgentService",
+    "method": "RunSSE",
+    "policy": "intercept",
+    "supportLevel": "conditional",
+    "reason": "Serve Cursor Agent local-model runs when paired with a matching BidiAppend payload.",
+    "uncertainty": "Bidi request-id flow and payload framing need captured fixture replay across CLI and ACP."
+  },
+  {
+    "path": "/aiserver.v1.BidiService/BidiAppend",
+    "package": "aiserver.v1",
+    "service": "BidiService",
+    "method": "BidiAppend",
+    "policy": "intercept",
+    "supportLevel": "conditional",
+    "reason": "Decode Cursor Agent client messages and register pending local-model runs.",
+    "uncertainty": "Observed payload encodings include surprising nested forms; unsupported forms must pass through."
+  },
+  {
+    "path": "/aiserver.v1.ChatService/StreamUnifiedChatWithTools",
+    "package": "aiserver.v1",
+    "service": "ChatService",
+    "method": "StreamUnifiedChatWithTools",
+    "policy": "intercept",
+    "supportLevel": "conditional",
+    "reason": "Handle requests only when selected model is registered locally; otherwise pass upstream.",
+    "uncertainty": "SSE, Poll, and idempotent chat variants stay pass-through until observed and decoded."
+  },
+  {
+    "path": "/aiserver.v1.AnalyticsService/UploadIssueTrace",
+    "package": "aiserver.v1",
+    "service": "AnalyticsService",
+    "method": "UploadIssueTrace",
+    "policy": "intercept",
+    "supportLevel": "implemented",
+    "reason": "Acknowledge issue-trace uploads locally to avoid forwarding sensitive diagnostic blobs during local experiments.",
+    "uncertainty": "Full payload redaction and fixture coverage remain part of the reliability/security workstream."
+  },
+  {
+    "path": "*",
+    "policy": "pass-through",
+    "supportLevel": "observe-first",
+    "reason": "Default byte-preserving proxy policy for unknown or unverified routes.",
+    "uncertainty": "Desktop-specific and proto-visible routes must be observed and decoded before interception."
+  }
+]