abelworkflow 1.2.3 → 1.2.4

package/extensions/gpt-responses-compat.ts

@@ -8,6 +8,20 @@ const RESPONSES_PROVIDERS = new Set(["abelworkflow", "gpt"]);
 const UNSUPPORTED_SPARK_REASONING_EFFORTS = new Set(["none", "minimal"]);
 const TRANSIENT_UPSTREAM_ERROR = /\bupstream(?:[_ -]error|\s+request\s+failed)\b/i;
 const EXPLICIT_ERROR_STATUS = /(?:^\s*|\b(?:upstream(?:[_ -]error|\s+request\s+failed)|code|error(?:[_ -]?code)?|http(?:\/\d+(?:\.\d+)*)?(?:[_ -]?status(?:[_ -]?code)?)?|status(?:[_ -]?code)?)\b\s*["']?\s*[:=(]?\s*)["']?([45]\d{2})["']?(?!\d)/i;
+const SUMMARIZATION_SYSTEM_PROMPT = "You summarize coding conversations into concise continuation checkpoints. Output only the requested structured summary.";
+const SUMMARIZATION_PROMPT = `Create a structured checkpoint using exactly these sections:
+
+## Goal
+## Constraints & Preferences
+## Progress
+### Done
+### In Progress
+### Blocked
+## Key Decisions
+## Next Steps
+## Critical Context
+
+Preserve exact file paths, function names, decisions, errors, and unfinished work. Be concise but include everything needed to continue.`;
 
 function isRecord(value: unknown): value is JsonRecord {
   return !!value && typeof value === "object" && !Array.isArray(value);
@@ -98,9 +112,13 @@ function normalizeInputItem(item: unknown): unknown {
   if (item.type === "reasoning") return undefined;
 
   if (item.type === "message") {
-    const content = normalizeAssistantContent(item.content);
+    const role = item.role === "user" ? "user" : item.role === "assistant" ? "assistant" : undefined;
+    if (!role) return undefined;
+    const content = role === "user"
+      ? normalizeUserContent(item.content)
+      : normalizeAssistantContent(item.content);
     if (Array.isArray(content) && content.length === 0) return undefined;
-    return { role: "assistant", content };
+    return { role, content };
   }
 
   if (item.role === "user") {
@@ -157,32 +175,153 @@ function normalizeReasoning(payload: JsonRecord, modelId: string | undefined): v
   payload.reasoning = { ...payload.reasoning, effort: "low" };
 }
 
+function serializeConversation(messages: unknown[]): string {
+  return messages.map((message) => {
+    if (!isRecord(message)) return "";
+    const content = textFromContent(message.content) ?? "";
+    if (message.role === "user") return content ? `[User]: ${content}` : "";
+    if (message.role === "toolResult") {
+      const text = content.length > 2000 ? `${content.slice(0, 2000)}\n[truncated]` : content;
+      return text ? `[Tool result]: ${text}` : "";
+    }
+    if (message.role === "assistant" && Array.isArray(message.content)) {
+      const parts: string[] = [];
+      const thinking = message.content
+        .filter((part) => isRecord(part) && part.type === "thinking" && typeof part.thinking === "string")
+        .map((part) => part.thinking)
+        .join("\n");
+      if (thinking) parts.push(`[Assistant thinking]: ${thinking}`);
+      if (content) parts.push(`[Assistant]: ${content}`);
+      const calls = message.content
+        .filter((part) => isRecord(part) && part.type === "toolCall")
+        .map((part) => `${part.name}(${JSON.stringify(part.arguments ?? {})})`)
+        .join("; ");
+      if (calls) parts.push(`[Assistant tool calls]: ${calls}`);
+      return parts.join("\n");
+    }
+    if (message.role === "bashExecution") {
+      return `[Bash]: ${String(message.command ?? "")}\n${String(message.output ?? "")}`;
+    }
+    if (typeof message.summary === "string") return `[Previous checkpoint]: ${message.summary}`;
+    return content;
+  }).filter(Boolean).join("\n\n");
+}
+
+function fileDetails(fileOps: unknown): {
+  readFiles: string[];
+  modifiedFiles: string[];
+} {
+  if (!isRecord(fileOps)) return { readFiles: [], modifiedFiles: [] };
+  const modified = new Set<string>([
+    ...(fileOps.edited instanceof Set ? fileOps.edited : []),
+    ...(fileOps.written instanceof Set ? fileOps.written : []),
+  ]);
+  return {
+    readFiles: [...(fileOps.read instanceof Set ? fileOps.read : [])]
+      .filter((path): path is string => typeof path === "string" && !modified.has(path))
+      .sort(),
+    modifiedFiles: [...modified].sort(),
+  };
+}
+
+function formatFileDetails(details: { readFiles: string[]; modifiedFiles: string[] }): string {
+  const sections: string[] = [];
+  if (details.readFiles.length > 0) {
+    sections.push(`<read-files>\n${details.readFiles.join("\n")}\n</read-files>`);
+  }
+  if (details.modifiedFiles.length > 0) {
+    sections.push(`<modified-files>\n${details.modifiedFiles.join("\n")}\n</modified-files>`);
+  }
+  return sections.length > 0 ? `\n\n${sections.join("\n\n")}` : "";
+}
+
+function normalizeResponsesPayload(
+  payload: unknown,
+  model: unknown,
+  systemPrompt: string,
+): JsonRecord | undefined {
+  if (!isRecord(payload) || !isCompatibleResponsesModel(model)) return undefined;
+
+  const input = normalizeInput(payload.input);
+  const first = Array.isArray(payload.input) ? payload.input.find(isRecord) : undefined;
+  const firstIsPrompt = first?.role === "system" || first?.role === "developer";
+  const instructions =
+    textFromContent(payload.instructions) ||
+    (firstIsPrompt ? textFromContent(first.content) : undefined) ||
+    systemPrompt.trim() ||
+    DEFAULT_INSTRUCTIONS;
+  const nextPayload: JsonRecord = { ...payload, instructions, input, store: false };
+
+  delete nextPayload.max_output_tokens;
+  delete nextPayload.prompt_cache_key;
+  delete nextPayload.prompt_cache_retention;
+  delete nextPayload.previous_response_id;
+
+  normalizeReasoning(nextPayload, isRecord(model) && typeof model.id === "string" ? model.id : undefined);
+  return nextPayload;
+}
+
 export default function (pi: ExtensionAPI) {
-  pi.on("before_provider_request", (event, ctx) => {
-    const payload = event.payload as unknown;
-    if (!isRecord(payload)) return;
-    if (!isCompatibleResponsesModel(ctx.model)) return;
-
-    const input = normalizeInput(payload.input);
-    const first = Array.isArray(payload.input) ? payload.input.find(isRecord) : undefined;
-    const firstIsPrompt = first?.role === "system" || first?.role === "developer";
-    const instructions =
-      textFromContent(payload.instructions) ||
-      (firstIsPrompt ? textFromContent(first.content) : undefined) ||
-      ctx.getSystemPrompt().trim() ||
-      DEFAULT_INSTRUCTIONS;
-
-    const nextPayload: JsonRecord = { ...payload, instructions, input, store: false };
-
-    // Unsupported or risky for this Codex passthrough endpoint.
-    delete nextPayload.max_output_tokens;
-    delete nextPayload.prompt_cache_key;
-    delete nextPayload.prompt_cache_retention;
-    delete nextPayload.previous_response_id;
-
-    normalizeReasoning(nextPayload, ctx.model?.id);
-
-    return nextPayload;
+  pi.on("before_provider_request", (event, ctx) =>
+    normalizeResponsesPayload(event.payload, ctx.model, ctx.getSystemPrompt()));
+
+  pi.on("session_before_compact", async (event, ctx) => {
+    const model = ctx.model;
+    if (!isCompatibleResponsesModel(model)) return;
+
+    const { preparation } = event;
+    const conversation = serializeConversation([
+      ...preparation.messagesToSummarize,
+      ...preparation.turnPrefixMessages,
+    ]);
+    const prompt = [
+      `<conversation>\n${conversation}\n</conversation>`,
+      preparation.previousSummary
+        ? `<previous-summary>\n${preparation.previousSummary}\n</previous-summary>\nPreserve and update this previous checkpoint.`
+        : "",
+      preparation.isSplitTurn
+        ? "The conversation ends with the prefix of a split turn; its recent suffix remains in context."
+        : "",
+      SUMMARIZATION_PROMPT,
+      event.customInstructions ? `Additional focus: ${event.customInstructions}` : "",
+    ].filter(Boolean).join("\n\n");
+    const response = await ctx.modelRegistry.complete(
+      model,
+      {
+        systemPrompt: SUMMARIZATION_SYSTEM_PROMPT,
+        messages: [{
+          role: "user",
+          content: [{ type: "text", text: prompt }],
+          timestamp: Date.now(),
+        }],
+      },
+      {
+        signal: event.signal,
+        cacheRetention: "none",
+        ...(ctx.thinkingLevel && ctx.thinkingLevel !== "off"
+          ? { reasoningEffort: ctx.thinkingLevel }
+          : {}),
+        onPayload: (payload: unknown, payloadModel: unknown) =>
+          normalizeResponsesPayload(payload, payloadModel, SUMMARIZATION_SYSTEM_PROMPT),
+      },
+    );
+    if (response.stopReason === "error") {
+      throw new Error(`Summarization failed: ${response.errorMessage ?? "Unknown error"}`);
+    }
+    if (response.stopReason === "aborted") throw new Error("Compaction cancelled");
+
+    const summaryText = textFromContent(response.content);
+    if (!summaryText) throw new Error("Summarization failed: Empty response");
+    const details = fileDetails(preparation.fileOps);
+    return {
+      compaction: {
+        summary: `${summaryText}${formatFileDetails(details)}`,
+        firstKeptEntryId: preparation.firstKeptEntryId,
+        tokensBefore: preparation.tokensBefore,
+        usage: response.usage,
+        details,
+      },
+    };
   });
 
   pi.on("message_end", (event, ctx) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "abelworkflow",
-  "version": "1.2.3",
+  "version": "1.2.4",
   "description": "Install AbelWorkflow into ~/.agents and create Claude, Codex, and Pi links.",
   "type": "module",
   "scripts": {