@rahularya01/pi-cursor 1.1.0 → 1.2.0

package/src/stream/config.ts

@@ -1,69 +0,0 @@
-/**
- * Cursor agent URL resolution (env → CLI config → default).
- */
-import { readFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { join as pathJoin } from "node:path";
-import { assertSafeCursorBaseUrl } from "../utils/security.js";
-
-export const DEFAULT_CURSOR_AGENT_URL = "https://agentn.us.api5.cursor.sh";
-export const DEFAULT_CURSOR_CLIENT_VERSION = "cli-2026.05.01-eea359f";
-
-let cachedCursorAgentUrl: string | undefined;
-
-export function normalizeCursorUrl(value: unknown): string | undefined {
-  if (typeof value !== "string") return undefined;
-  const trimmed = value.trim();
-  if (!trimmed) return undefined;
-  try {
-    const url = new URL(trimmed);
-    if (url.protocol !== "https:" && url.protocol !== "http:") return undefined;
-    url.pathname = url.pathname.replace(/\/+$/, "");
-    url.search = "";
-    url.hash = "";
-    return url.toString().replace(/\/$/, "");
-  } catch {
-    return undefined;
-  }
-}
-
-export function readCursorCliAgentUrl(): string | undefined {
-  const configDir = process.env.CURSOR_CONFIG_DIR?.trim() || pathJoin(homedir(), ".cursor");
-  try {
-    const config = JSON.parse(readFileSync(pathJoin(configDir, "cli-config.json"), "utf8")) as {
-      serverConfigCache?: {
-        agentUrlConfig?: { agentnUrl?: unknown; agentUrl?: unknown };
-      };
-    };
-    return (
-      normalizeCursorUrl(config.serverConfigCache?.agentUrlConfig?.agentnUrl) ??
-      normalizeCursorUrl(config.serverConfigCache?.agentUrlConfig?.agentUrl)
-    );
-  } catch {
-    return undefined;
-  }
-}
-
-export function getCursorClientVersion(): string {
-  return process.env.PI_CURSOR_CLIENT_VERSION?.trim() || DEFAULT_CURSOR_CLIENT_VERSION;
-}
-
-/** Resolve the agent base URL, validating host against the allowlist. */
-export function getCursorAgentUrl(): string {
-  const envUrl =
-    normalizeCursorUrl(process.env.PI_CURSOR_AGENT_URL) ??
-    normalizeCursorUrl(process.env.CURSOR_AGENT_URL);
-  if (envUrl) {
-    cachedCursorAgentUrl = assertSafeCursorBaseUrl(envUrl);
-    return cachedCursorAgentUrl;
-  }
-  if (cachedCursorAgentUrl) return cachedCursorAgentUrl;
-  const resolved = readCursorCliAgentUrl() ?? DEFAULT_CURSOR_AGENT_URL;
-  cachedCursorAgentUrl = assertSafeCursorBaseUrl(resolved);
-  return cachedCursorAgentUrl;
-}
-
-/** Test helper: clear cached URL between cases. */
-export function resetCursorAgentUrlCacheForTests(): void {
-  cachedCursorAgentUrl = undefined;
-}

package/src/stream/context-normalize.ts

@@ -1,104 +0,0 @@
-/**
- * Normalize context-mode / session side-channel user messages into the system
- * prompt so Cursor treats the real user turn as the task.
- */
-
-export type OpenAIRole = "system" | "user" | "assistant" | "tool";
-
-export interface OpenAIContentPart {
-  type: string;
-  text?: string;
-  data?: string;
-  mimeType?: string;
-  image_url?: { url?: string };
-}
-
-export interface OpenAIMessage {
-  role: OpenAIRole;
-  content?: string | OpenAIContentPart[] | null;
-  tool_call_id?: string;
-  name?: string;
-  tool_calls?: unknown[];
-}
-
-const CONTEXT_MODE_SIDE_CHANNEL_PRIORITY =
-  "Provider infrastructure context only. Prioritize the user's actual request above. " +
-  "Do not run compaction recovery, session investigation, or ctx_doctor/ctx_stats rituals " +
-  "unless the user explicitly asked for that.";
-
-export function textContent(content: OpenAIMessage["content"]): string {
-  if (content == null) return "";
-  if (typeof content === "string") return content;
-  return content
-    .filter((p) => p.type === "text" && p.text)
-    .map((p) => p.text as string)
-    .join("\n");
-}
-
-export function contentHasImageParts(content: OpenAIMessage["content"]): boolean {
-  if (!Array.isArray(content)) return false;
-  return content.some(
-    (part) =>
-      part.type === "image_url" ||
-      part.type === "image" ||
-      (typeof part.mimeType === "string" && part.mimeType.startsWith("image/")),
-  );
-}
-
-export function isContextModeSideChannelText(text: string): boolean {
-  const t = text.trim();
-  if (!t) return false;
-  return (
-    /^context-mode active\b/i.test(t) ||
-    t.includes("<session_state") ||
-    t.includes("<session_resume") ||
-    t.includes("<active_memory>") ||
-    t.includes("Hierarchy: ctx_batch_execute") ||
-    /<\/?session_mode\b/i.test(t)
-  );
-}
-
-export function frameContextModeSideChannel(text: string): string {
-  return (
-    `<provider_context source="context-mode">\n${text.trim()}\n</provider_context>\n\n` +
-    CONTEXT_MODE_SIDE_CHANNEL_PRIORITY
-  );
-}
-
-/**
- * Fold pure side-channel user messages into the system prompt and keep the
- * real user turns as the task.
- */
-export function normalizeMessagesForCursor(messages: OpenAIMessage[]): OpenAIMessage[] {
-  const systemParts: string[] = [];
-  const sideParts: string[] = [];
-  const rest: OpenAIMessage[] = [];
-
-  for (const msg of messages) {
-    if (msg.role === "system") {
-      const text = textContent(msg.content);
-      if (text) systemParts.push(text);
-      continue;
-    }
-
-    if (msg.role === "user") {
-      const text = textContent(msg.content);
-      // Keep multimodal user turns intact — only pure text side-channels move.
-      if (isContextModeSideChannelText(text) && !contentHasImageParts(msg.content)) {
-        sideParts.push(text);
-        continue;
-      }
-    }
-
-    rest.push(msg);
-  }
-
-  if (sideParts.length === 0) {
-    if (systemParts.length === 0) return messages;
-    return [{ role: "system", content: systemParts.join("\n") }, ...rest];
-  }
-
-  const framed = frameContextModeSideChannel(sideParts.join("\n\n"));
-  const system = systemParts.length > 0 ? `${systemParts.join("\n")}\n\n${framed}` : framed;
-  return [{ role: "system", content: system }, ...rest];
-}

package/src/stream/index.ts

@@ -1,42 +0,0 @@
-/**
- * Public stream surface for the Cursor provider.
- *
- * The legacy OpenAI-compatible local proxy (`startProxy`) remains inside
- * native-core for internal/debug use but is intentionally not re-exported here.
- */
-export {
-  createCursorNativeStream,
-  getCursorModels,
-  getCursorParameterizedModels,
-  cleanupSessionState,
-  cleanupAllSessionState,
-  type CursorModel,
-  type CursorNativeStreamConfig,
-} from "./native-core.js";
-
-export { getCursorAgentUrl, getCursorClientVersion } from "./config.js";
-export {
-  resolveModelId,
-  resolveRequestedModelId,
-  type CursorNativeModelRouting,
-} from "./model-routing.js";
-export {
-  isContextModeSideChannelText,
-  normalizeMessagesForCursor,
-  frameContextModeSideChannel,
-} from "./context-normalize.js";
-export {
-  planRecovery,
-  fingerprintCompletedTurns,
-  wrapRecoveredToolResults,
-  lostToolContinuationErrorBody,
-  formatLostToolContinuationDiagnostic,
-  type RecoveryDecision,
-  type PlanRecoveryInput,
-  type StoredConversation,
-} from "./recovery.js";
-export {
-  enhanceCursorStreamError,
-  isAuthErrorMessage,
-  isProtocolMismatchMessage,
-} from "./protocol.js";

package/src/stream/model-routing.ts

@@ -1,100 +0,0 @@
-/**
- * Model ID effort suffix routing for Cursor runtime variants.
- */
-
-export interface CursorNativeModelRouting {
-  modelId: string;
-  parameters?: Array<{ id: string; value: string }>;
-  requiresMaxMode?: boolean;
-  requestedMaxMode?: boolean;
-}
-
-export interface ResolvedCursorModelRouting extends CursorNativeModelRouting {
-  maxMode: boolean;
-}
-
-type CursorModelRoutingByEffort = Record<string, CursorNativeModelRouting>;
-
-export interface CursorResolvableModel {
-  id: string;
-  [key: string]: unknown;
-}
-
-/**
- * Insert reasoning effort into model ID, before -fast/-thinking suffix.
- * e.g. model="gpt-5.4" + effort="medium" → "gpt-5.4-medium"
- *      model="gpt-5.4-fast" + effort="high" → "gpt-5.4-high-fast"
- * If no effort provided, returns model as-is.
- */
-export function resolveModelId(model: string, reasoningEffort?: string): string {
-  if (!reasoningEffort) return model;
-
-  let suffix = "";
-  let base = model;
-  if (base.endsWith("-fast")) {
-    suffix = "-fast";
-    base = base.slice(0, -5);
-  } else if (base.endsWith("-thinking")) {
-    suffix = "-thinking";
-    base = base.slice(0, -9);
-  }
-
-  return `${base}-${reasoningEffort}${suffix}`;
-}
-
-function isCursorModelRouting(value: unknown): value is CursorNativeModelRouting {
-  return (
-    !!value &&
-    typeof value === "object" &&
-    typeof (value as { modelId?: unknown }).modelId === "string"
-  );
-}
-
-export function resolveRequestedModelId(
-  model: string,
-  reasoningEffort?: string,
-  cursorModelId?: string,
-): string;
-export function resolveRequestedModelId(
-  model: CursorResolvableModel,
-  reasoningEffort?: string,
-  routingByModelId?: Map<string, CursorModelRoutingByEffort | CursorNativeModelRouting>,
-): ResolvedCursorModelRouting;
-export function resolveRequestedModelId(
-  model: string | CursorResolvableModel,
-  reasoningEffort?: string,
-  cursorModelIdOrRoutingByModelId?:
-    string | Map<string, CursorModelRoutingByEffort | CursorNativeModelRouting>,
-): string | ResolvedCursorModelRouting {
-  if (typeof model === "string") {
-    const trimmedCursorModelId =
-      typeof cursorModelIdOrRoutingByModelId === "string"
-        ? cursorModelIdOrRoutingByModelId.trim()
-        : "";
-    if (trimmedCursorModelId) return trimmedCursorModelId;
-    return resolveModelId(model, reasoningEffort);
-  }
-
-  const routingByModelId =
-    cursorModelIdOrRoutingByModelId instanceof Map ? cursorModelIdOrRoutingByModelId : undefined;
-  const configured = routingByModelId?.get(model.id);
-  let routing: CursorNativeModelRouting | undefined;
-  if (isCursorModelRouting(configured)) {
-    routing = configured;
-  } else if (configured) {
-    routing =
-      configured[reasoningEffort ?? ""] ??
-      configured.none ??
-      configured.medium ??
-      configured.high ??
-      Object.values(configured).find(isCursorModelRouting);
-  }
-
-  return {
-    modelId: routing?.modelId ?? resolveModelId(model.id, reasoningEffort),
-    maxMode: Boolean(routing?.requestedMaxMode ?? routing?.requiresMaxMode),
-    parameters: routing?.parameters,
-    requestedMaxMode: routing?.requestedMaxMode,
-    requiresMaxMode: routing?.requiresMaxMode,
-  };
-}