@oh-my-pi/pi-ai 12.19.2 → 13.0.0

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-ai",
-	"version": "12.19.2",
+	"version": "13.0.0",
 	"description": "Unified LLM API with automatic model discovery and provider configuration",
 	"homepage": "https://github.com/can1357/oh-my-pi",
 	"author": "Can Boluk",
@@ -44,7 +44,7 @@
 		"@connectrpc/connect-node": "^2.1",
 		"@google/genai": "^1.42",
 		"@mistralai/mistralai": "^1.14",
-		"@oh-my-pi/pi-utils": "12.19.2",
+		"@oh-my-pi/pi-utils": "13.0.0",
 		"@sinclair/typebox": "^0.34",
 		"@smithy/node-http-handler": "^4.4",
 		"ajv": "^8.18",

package/src/providers/amazon-bedrock.ts

@@ -387,6 +387,7 @@ function convertMessages(
 		const m = transformedMessages[i];
 
 		switch (m.role) {
+			case "developer":
 			case "user":
 				if (typeof m.content === "string") {
 					// Skip empty user messages

package/src/providers/anthropic.ts

@@ -967,7 +967,7 @@ export function convertAnthropicMessages(
 	for (let i = 0; i < transformedMessages.length; i++) {
 		const msg = transformedMessages[i];
 
-		if (msg.role === "user") {
+		if (msg.role === "user" || msg.role === "developer") {
 			if (!msg.content) continue;
 
 			if (typeof msg.content === "string") {

package/src/providers/azure-openai-responses.ts

@@ -575,6 +575,43 @@ function convertMessages(
 					content: filteredContent,
 				});
 			}
+		} else if (msg.role === "developer") {
+			const devRole = "user";
+			if (typeof msg.content === "string") {
+				if (!msg.content || msg.content.trim() === "") continue;
+				messages.push({
+					role: devRole,
+					content: sanitizeSurrogates(msg.content),
+				});
+			} else {
+				const content: ResponseInputContent[] = msg.content.map((item): ResponseInputContent => {
+					if (item.type === "text") {
+						return {
+							type: "input_text",
+							text: sanitizeSurrogates(item.text),
+						} satisfies ResponseInputText;
+					}
+					return {
+						type: "input_image",
+						detail: "auto",
+						image_url: `data:${item.mimeType};base64,${item.data}`,
+					} satisfies ResponseInputImage;
+				});
+				let filteredContent = !model.input.includes("image")
+					? content.filter(c => c.type !== "input_image")
+					: content;
+				filteredContent = filteredContent.filter(c => {
+					if (c.type === "input_text") {
+						return c.text.trim().length > 0;
+					}
+					return true;
+				});
+				if (filteredContent.length === 0) continue;
+				messages.push({
+					role: devRole,
+					content: filteredContent,
+				});
+			}
 		} else if (msg.role === "assistant") {
 			const output: ResponseInput = [];
 			const assistantMsg = msg as AssistantMessage;

package/src/providers/cursor.ts

@@ -1834,10 +1834,10 @@ function buildMcpToolDefinitions(tools: Tool[] | undefined): McpToolDefinition[]
 }
 
 /**
- * Extract text content from a user message.
+ * Extract text content from a user or developer message.
  */
 function extractUserMessageText(msg: Message): string {
-	if (msg.role !== "user") return "";
+	if (msg.role !== "user" && msg.role !== "developer") return "";
 	const content = msg.content;
 	if (typeof content === "string") return content.trim();
 	const text = content
@@ -1874,7 +1874,7 @@ function buildConversationTurns(messages: Message[]): Uint8Array[] {
 		const msg = messages[i];
 
 		// Skip non-user messages at the start
-		if (msg.role !== "user") {
+		if (msg.role !== "user" && msg.role !== "developer") {
 			i++;
 			continue;
 		}
@@ -1882,7 +1882,7 @@ function buildConversationTurns(messages: Message[]): Uint8Array[] {
 		// Check if this is the last user message (which goes in the action, not turns)
 		let isLastUserMessage = true;
 		for (let j = i + 1; j < messages.length; j++) {
-			if (messages[j].role === "user") {
+			if (messages[j].role === "user" || messages[j].role === "developer") {
 				isLastUserMessage = false;
 				break;
 			}
@@ -1908,7 +1908,7 @@ function buildConversationTurns(messages: Message[]): Uint8Array[] {
 		const stepBytes: Uint8Array[] = [];
 		i++;
 
-		while (i < messages.length && messages[i].role !== "user") {
+		while (i < messages.length && messages[i].role !== "user" && messages[i].role !== "developer") {
 			const stepMsg = messages[i];
 
 			if (stepMsg.role === "assistant") {
@@ -1982,7 +1982,7 @@ function buildGrpcRequest(
 
 	const lastMessage = context.messages[context.messages.length - 1];
 	const userText =
-		lastMessage?.role === "user"
+		lastMessage?.role === "user" || lastMessage?.role === "developer"
 			? typeof lastMessage.content === "string"
 				? lastMessage.content.trim()
 				: extractText(lastMessage.content)

package/src/providers/google-gemini-cli.ts

@@ -788,7 +788,7 @@ export const streamGoogleGeminiCli: StreamFunction<"google-gemini-cli"> = (
 
 function deriveSessionId(context: Context): string | undefined {
 	for (const message of context.messages) {
-		if (message.role !== "user") {
+		if (message.role !== "user" && message.role !== "developer") {
 			continue;
 		}
 

package/src/providers/google-shared.ts

@@ -83,7 +83,7 @@ export function convertMessages<T extends GoogleApiType>(model: Model<T>, contex
 	const transformedMessages = transformMessages(context.messages, model, normalizeToolCallId);
 
 	for (const msg of transformedMessages) {
-		if (msg.role === "user") {
+		if (msg.role === "user" || msg.role === "developer") {
 			if (typeof msg.content === "string") {
 				// Skip empty user messages
 				if (!msg.content || msg.content.trim() === "") continue;

package/src/providers/openai-codex-responses.ts

@@ -1563,6 +1563,42 @@ function convertMessages(model: Model<"openai-codex-responses">, context: Contex
 					content: filteredContent,
 				});
 			}
+		} else if (msg.role === "developer") {
+			if (typeof msg.content === "string") {
+				if (!msg.content || msg.content.trim() === "") continue;
+				messages.push({
+					role: "developer",
+					content: [{ type: "input_text", text: sanitizeSurrogates(msg.content) }],
+				});
+			} else {
+				const content: ResponseInputContent[] = msg.content.map((item): ResponseInputContent => {
+					if (item.type === "text") {
+						return {
+							type: "input_text",
+							text: sanitizeSurrogates(item.text),
+						} satisfies ResponseInputText;
+					}
+					return {
+						type: "input_image",
+						detail: "auto",
+						image_url: `data:${item.mimeType};base64,${item.data}`,
+					} satisfies ResponseInputImage;
+				});
+				let filteredContent = !model.input.includes("image")
+					? content.filter(c => c.type !== "input_image")
+					: content;
+				filteredContent = filteredContent.filter(c => {
+					if (c.type === "input_text") {
+						return c.text.trim().length > 0;
+					}
+					return true;
+				});
+				if (filteredContent.length === 0) continue;
+				messages.push({
+					role: "developer",
+					content: filteredContent,
+				});
+			}
 		} else if (msg.role === "assistant") {
 			const output: ResponseInput = [];
 

package/src/providers/openai-completions.ts

@@ -583,7 +583,7 @@ function maybeAddOpenRouterAnthropicCacheControl(
 	// on the last user/assistant message (walking backwards until we find text content).
 	for (let i = messages.length - 1; i >= 0; i--) {
 		const msg = messages[i];
-		if (msg.role !== "user" && msg.role !== "assistant") continue;
+		if (msg.role !== "user" && msg.role !== "assistant" && msg.role !== "developer") continue;
 
 		const content = msg.content;
 		if (typeof content === "string") {
@@ -643,19 +643,25 @@ export function convertMessages(
 		const msg = transformedMessages[i];
 		// Some providers (e.g. Mistral/Devstral) don't allow user messages directly after tool results
 		// Insert a synthetic assistant message to bridge the gap
-		if (compat.requiresAssistantAfterToolResult && lastRole === "toolResult" && msg.role === "user") {
+		if (
+			compat.requiresAssistantAfterToolResult &&
+			lastRole === "toolResult" &&
+			(msg.role === "user" || msg.role === "developer")
+		) {
 			params.push({
 				role: "assistant",
 				content: "I have processed the tool results.",
 			});
 		}
 
-		if (msg.role === "user") {
+		const devAsUser = !compat.supportsDeveloperRole;
+		if (msg.role === "user" || msg.role === "developer") {
+			const role = !devAsUser && msg.role === "developer" ? "developer" : "user";
 			if (typeof msg.content === "string") {
 				const text = sanitizeSurrogates(msg.content);
 				if (text.trim().length === 0) continue;
 				params.push({
-					role: "user",
+					role: role,
 					content: text,
 				});
 			} else {
@@ -870,7 +876,12 @@ export function convertMessages(
 			continue;
 		}
 
-		lastRole = msg.role;
+		lastRole =
+			msg.role === "developer"
+				? model.reasoning && compat.supportsDeveloperRole
+					? "developer"
+					: "system"
+				: msg.role;
 	}
 
 	return params;

package/src/providers/openai-responses.ts

@@ -505,7 +505,7 @@ function convertMessages(
 
 	let msgIndex = 0;
 	for (const msg of transformedMessages) {
-		if (msg.role === "user") {
+		if (msg.role === "user" || msg.role === "developer") {
 			if (typeof msg.content === "string") {
 				// Skip empty user messages
 				if (!msg.content || msg.content.trim() === "") continue;

package/src/providers/transform-messages.ts

@@ -1,10 +1,10 @@
-import type { Api, AssistantMessage, Message, Model, ToolCall, ToolResultMessage, UserMessage } from "../types";
+import type { Api, AssistantMessage, DeveloperMessage, Message, Model, ToolCall, ToolResultMessage } from "../types";
 
 const TURN_ABORTED_GUIDANCE =
-	"<turn_aborted>\n" +
+	"<turn-aborted>\n" +
 	"The previous turn was aborted. Any running tools/commands were terminated. " +
 	"If tools were aborted, they may have partially executed; verify current state before retrying.\n" +
-	"</turn_aborted>";
+	"</turn-aborted>";
 
 const enum ToolCallStatus {
 	/** Tool call has received a result (real or synthetic for orphan) */
@@ -21,7 +21,7 @@ const enum ToolCallStatus {
  * For aborted/errored turns, this function:
  * - Preserves tool call structure (unlike converting to text summaries)
  * - Injects synthetic "aborted" tool results
- * - Adds a <turn_aborted> guidance marker for the model
+ * - Adds a <turn-aborted> guidance marker for the model
  */
 export function transformMessages<TApi extends Api>(
 	messages: Message[],
@@ -33,8 +33,8 @@ export function transformMessages<TApi extends Api>(
 
 	// First pass: transform messages (thinking blocks, tool call ID normalization)
 	const transformed = messages.map(msg => {
-		// User messages pass through unchanged
-		if (msg.role === "user") {
+		// User and developer messages pass through unchanged
+		if (msg.role === "user" || msg.role === "developer") {
 			return msg;
 		}
 
@@ -160,13 +160,12 @@ export function transformMessages<TApi extends Api>(
 					} as ToolResultMessage);
 				}
 
-				// Inject turn_aborted guidance marker as synthetic user message
+				// Inject turn_aborted guidance marker as developer message
 				result.push({
-					role: "user",
+					role: "developer",
 					content: TURN_ABORTED_GUIDANCE,
-					synthetic: true,
 					timestamp: assistantMsg.timestamp + 1,
-				} as UserMessage);
+				} as DeveloperMessage);
 
 				continue;
 			}
@@ -182,8 +181,8 @@ export function transformMessages<TApi extends Api>(
 			if (toolCallStatus.get(msg.toolCallId) === ToolCallStatus.Aborted) continue;
 			toolCallStatus.set(msg.toolCallId, ToolCallStatus.Resolved);
 			result.push(msg);
-		} else if (msg.role === "user") {
-			// User message interrupts tool flow - insert synthetic results for orphaned calls
+		} else if (msg.role === "user" || msg.role === "developer") {
+			// User/developer message interrupts tool flow - insert synthetic results for orphaned calls
 			if (pendingToolCalls.length > 0) {
 				for (const tc of pendingToolCalls) {
 					if (!toolCallStatus.has(tc.id)) {

package/src/types.ts

@@ -254,6 +254,12 @@ export interface UserMessage {
 	timestamp: number; // Unix timestamp in milliseconds
 }
 
+export interface DeveloperMessage {
+	role: "developer";
+	content: string | (TextContent | ImageContent)[];
+	timestamp: number; // Unix timestamp in milliseconds
+}
+
 export interface AssistantMessage {
 	role: "assistant";
 	content: (TextContent | ThinkingContent | ToolCall)[];
@@ -281,7 +287,7 @@ export interface ToolResultMessage<TDetails = any, TInput = unknown> {
 	$normative?: TInput;
 }
 
-export type Message = UserMessage | AssistantMessage | ToolResultMessage;
+export type Message = UserMessage | DeveloperMessage | AssistantMessage | ToolResultMessage;
 
 export type CursorExecHandlerResult<T> = { result: T; toolResult?: ToolResultMessage } | T | ToolResultMessage;