@pi-unipi/unipi 3.0.0-alpha.2 → 3.0.0-alpha.21

package/packages/core/command-echo.ts

@@ -0,0 +1,63 @@
+/**
+ * withCommandEcho — wrap an ExtensionAPI so every registered slash command
+ * leaves a `❭ /cmd args` line in the chat transcript, like Devin's /btw.
+ *
+ * pi clears the editor and runs the handler inside the input path
+ * (agent-session `_tryExecuteExtensionCommand`), so there is no pi hook that
+ * sees a command before it runs — wrapping `registerCommand` is the only
+ * interception point.
+ *
+ * The echo is a `unipi-command-echo` custom entry: UI-only, never sent to
+ * the model, rendered live on `entry_appended` and after resume. Echo
+ * failures never block the command itself.
+ */
+
+import type { ExtensionAPI, ExtensionCommandContext, RegisteredCommand } from "@earendil-works/pi-coding-agent";
+import { Text } from "@earendil-works/pi-tui";
+
+export const COMMAND_ECHO_TYPE = "unipi-command-echo";
+
+export function withCommandEcho(pi: ExtensionAPI): ExtensionAPI {
+  try {
+    pi.registerEntryRenderer<{ text?: string }>(
+      COMMAND_ECHO_TYPE,
+      (entry, _options, theme) => {
+        const text = entry.data?.text;
+        if (!text) return undefined;
+        const t = theme as unknown as { fg?: (c: string, t: string) => string };
+        const marker = t.fg?.("accent", "❭ ") ?? "❭ ";
+        return new Text(`${marker}${t.fg?.("text", text) ?? text}`, 1, 0);
+      },
+    );
+  } catch {
+    // Renderer registration is best-effort; echoes still persist.
+  }
+
+  return new Proxy(pi, {
+    get(target, prop, receiver) {
+      if (prop === "registerCommand") {
+        return (name: string, options: Omit<RegisteredCommand, "name" | "sourceInfo">) => {
+          const wrapped = {
+            ...options,
+            handler: (args: string, ctx: ExtensionCommandContext) => {
+              const trimmed = (args ?? "").trim();
+              try {
+                target.appendEntry(COMMAND_ECHO_TYPE, {
+                  text: `/${name}${trimmed ? ` ${trimmed}` : ""}`,
+                });
+              } catch {
+                // Echo must never block the command.
+              }
+              return options.handler(args, ctx);
+            },
+          };
+          // Reflect.apply keeps the command audit's literal source scan from
+          // flagging this proxy call as an unresolvable name.
+          return Reflect.apply(target.registerCommand, target, [name, wrapped]);
+        };
+      }
+      const value = Reflect.get(target, prop, receiver);
+      return typeof value === "function" ? value.bind(target) : value;
+    },
+  });
+}

package/packages/core/compaction-context.ts

@@ -0,0 +1,41 @@
+/**
+ * Active-work providers for compaction.
+ *
+ * Modules that drive autonomous work (long-horizon goals/ralph, kanboard
+ * tasks) register a provider returning a short, authoritative description of
+ * what is in flight. The compactor puts these at the top of every summary so
+ * a loop keeps its task, rules and progress across compaction instead of the
+ * summarizer guessing them from transcript text.
+ */
+
+export interface CompactionContextBlock {
+  readonly id: string;
+  readonly text: string;
+}
+
+/** Returns the active-work text, or null/empty when nothing is in flight. */
+export type CompactionContextProvider = () => string | null | undefined;
+
+const providers = new Map<string, CompactionContextProvider>();
+
+/** Register (or replace) a provider; returns an unregister function. */
+export function registerCompactionContext(id: string, provider: CompactionContextProvider): () => void {
+  providers.set(id, provider);
+  return () => {
+    if (providers.get(id) === provider) providers.delete(id);
+  };
+}
+
+/** Collect every non-empty provider block; a throwing provider is skipped. */
+export function collectCompactionContext(): CompactionContextBlock[] {
+  const blocks: CompactionContextBlock[] = [];
+  for (const [id, provider] of providers) {
+    try {
+      const text = provider()?.trim();
+      if (text) blocks.push({ id, text });
+    } catch {
+      // A broken provider must never block compaction.
+    }
+  }
+  return blocks;
+}

package/packages/core/constants.ts

@@ -37,8 +37,8 @@ export const MODULES = {
   FOOTER: "@pi-unipi/footer",
   UPDATER: "@pi-unipi/updater",
   INPUT_SHORTCUTS: "@pi-unipi/input-shortcuts",
-  IMAGE: "@pi-unipi/image",
   WATCHDOG: "@pi-unipi/watchdog",
+  SKILL_REGISTRY: "@pi-unipi/skill-registry",
 } as const;
 
 /** Workflow command names — plan mode + permission modes */
@@ -104,30 +104,10 @@ export const RALPH_STATUS_ICONS = {
 /** Utility command names */
 export const UTILITY_COMMANDS = {
   CONTINUE: "continue",
-  RELOAD: "reload",
-  STATUS: "status",
+  RETRY: "retry",
   CLEANUP: "cleanup",
-  ENV: "env",
   DOCTOR: "doctor",
-  PREFIX_CACHE: "prefix-cache",
-} as const;
-
-/** Utility tool names */
-export const UTILITY_TOOLS = {
-  CONTINUE: "continue_task",
-  BATCH: "ctx_batch",
-  ENV: "ctx_env",
-  SET_SESSION_NAME: "set_session_name",
-} as const;
-
-/** Badge config path */
-export const BADGE_CONFIG_FILE = ".unipi/config/badge.json" as const;
-
-/** Utility directory paths */
-export const UTILITY_DIRS = {
-  CACHE: "~/.unipi/cache",
-  ANALYTICS: "~/.unipi/analytics",
-  TEMP: "/tmp/unipi",
+  ANSWER: "answer",
 } as const;
 
 /** Ask-user tool names */
@@ -138,6 +118,7 @@ export const ASK_USER_TOOLS = {
 /** Image tool names */
 export const IMAGE_TOOLS = {
   GENERATE: "image_generate",
+  EDIT: "image_edit",
   RECOGNIZE: "image_recognize",
 } as const;
 
@@ -180,21 +161,15 @@ export const COMPACTOR_INSTRUCTION = "__compactor__" as const;
 
 /** Compactor tool names */
 export const COMPACTOR_TOOLS = {
-  COMPACT: "compact",
-  VCC_RECALL: "vcc_recall",
-  CTX_EXECUTE: "ctx_execute",
-  CTX_EXECUTE_FILE: "ctx_execute_file",
-  CTX_BATCH_EXECUTE: "ctx_batch_execute",
-  CTX_STATS: "ctx_stats",
-  CTX_DOCTOR: "ctx_doctor",
+  SESSION_RECALL: "session_recall",
+  CONTEXT_BUDGET: "context_budget",
 } as const;
 
 /** Compactor command names */
 export const COMPACTOR_COMMANDS = {
-  LOSSLESS_COMPACT: "lossless-compact",
-  COMPACT: "compact",
+  COMPACT_VCC: "compact-vcc",
+  COMPACT_BY_LLM: "compact-by-llm",
   SESSION_RECALL: "session-recall",
-  COMPACT_RECALL: "compact-recall",
   COMPACT_STATS: "compact-stats",
   COMPACT_DOCTOR: "compact-doctor",
   COMPACT_HELP: "compact-help",
@@ -245,11 +220,6 @@ export const NOTIFY_DIRS = {
 /** BTW command names */
 export const BTW_COMMANDS = {
   BTW: "btw",
-  TANGENT: "btw-tangent",
-  NEW: "btw-new",
-  CLEAR: "btw-clear",
-  INJECT: "btw-inject",
-  SUMMARIZE: "btw-summarize",
 } as const;
 
 /** Updater command names */

package/packages/core/events.ts

@@ -35,8 +35,6 @@ export const UNIPI_EVENTS = {
   LONG_HORIZON_TODO_UPDATED: "unipi:long-horizon:todo:updated",
 
 
-  /** Info screen group registered */
-  INFO_GROUP_REGISTERED: "unipi:info:group:registered",
   /** Info screen data updated */
   INFO_DATA_UPDATED: "unipi:info:data:updated",
 
@@ -64,19 +62,10 @@ export const UNIPI_EVENTS = {
   COMPACTOR_COMPACTED: "unipi:compactor:compacted",
   /** @deprecated Footer reads live Pi session data; retained for compatibility. */
   COMPACTOR_STATS_UPDATED: "unipi:compactor:stats:updated",
-  /** Utility module cleanup completed */
-  UTILITY_CLEANUP_DONE: "unipi:utility:cleanup:done",
-  /** Utility diagnostics started */
-  UTILITY_DIAGNOSTICS_START: "unipi:utility:diagnostics:start",
-  /** Utility diagnostics completed */
-  UTILITY_DIAGNOSTICS_DONE: "unipi:utility:diagnostics:done",
 
   /** Notification sent */
   NOTIFICATION_SENT: "unipi:notify:sent",
 
-  /** Badge generation requested (from kanboard or other module) */
-  BADGE_GENERATE_REQUEST: "unipi:badge:generate:request",
-
   /** Agent asked user a question (ask_user tool invoked) */
   ASK_USER_PROMPT: "unipi:ask-user:prompt",
 
@@ -178,15 +167,6 @@ export interface UnipiMemoryConsolidatedEvent {
   projectName: string;
 }
 
-/** Payload for INFO_GROUP_REGISTERED */
-export interface UnipiInfoGroupEvent {
-  /** Group id */
-  groupId: string;
-  /** Group display name */
-  groupName: string;
-  /** Module that registered the group */
-  module: string;
-}
 
 /** Payload for INFO_DATA_UPDATED */
 export interface UnipiInfoDataEvent {
@@ -252,38 +232,9 @@ export interface UnipiCompactorStatsEvent {
   searchQueries: number;
 }
 
-/** Payload for UTILITY_CLEANUP_START / UTILITY_CLEANUP_DONE */
-export interface UnipiUtilityCleanupEvent {
-  /** Whether this is a dry run */
-  dryRun: boolean;
-  /** Categories being cleaned */
-  categories: string[];
-  /** Results (present on DONE) */
-  results?: Array<{
-    category: string;
-    removed: number;
-    bytesFreed: number;
-  }>;
-}
 
-/** Payload for UTILITY_DIAGNOSTICS_START / UTILITY_DIAGNOSTICS_DONE */
-export interface UnipiUtilityDiagnosticsEvent {
-  /** Overall health status */
-  overall: "healthy" | "warning" | "error" | "unknown";
-  /** Number of checks run */
-  checkCount: number;
-  /** Report (present on DONE) */
-  report?: unknown;
-}
 
 
-/** Payload for BADGE_GENERATE_REQUEST */
-export interface UnipiBadgeGenerateRequestEvent {
-  /** Source of the request (e.g., "kanboard", "input-hook") */
-  source: string;
-  /** First user message for context (optional) */
-  conversationSummary?: string;
-}
 
 /** Payload for ASK_USER_PROMPT */
 export interface UnipiAskUserPromptEvent {
@@ -361,17 +312,13 @@ export type UnipiEventPayload =
   | UnipiMemoryStoredEvent
   | UnipiMemoryDeletedEvent
   | UnipiMemoryConsolidatedEvent
-  | UnipiInfoGroupEvent
   | UnipiInfoDataEvent
   | UnipiMcpServerEvent
   | UnipiMcpToolsEvent
   | UnipiMcpCatalogSyncedEvent
   | UnipiCompactionEvent
   | UnipiCompactorStatsEvent
-  | UnipiUtilityCleanupEvent
-  | UnipiUtilityDiagnosticsEvent
   | UnipiNotificationSentEvent
-  | UnipiBadgeGenerateRequestEvent
   | UnipiAskUserPromptEvent
   | UnipiUpdateCheckEvent
   | UnipiUpdateAvailableEvent

package/packages/core/fusion-status.ts

@@ -10,6 +10,10 @@
 export interface SharedFusionStatus {
   /** Display name of the lead (the session model). */
   leadName: string;
+  /** Lead model key provider/id (for child-model resolution). */
+  leadKey?: string;
+  /** Sidekick model key provider/id (for child-model resolution). */
+  sidekickKey?: string;
   /** Lead thinking level, e.g. "medium". */
   leadEffort: string;
   /** Display name of the sidekick. */

package/packages/core/global.d.ts

@@ -15,6 +15,16 @@ declare global {
   // eslint-disable-next-line no-var
   var __unipi_kanboard_registry: unknown;
 
+  /** Kanboard's API for other extensions — set by @pi-unipi/kanboard on load. */
+  // eslint-disable-next-line no-var
+  var __unipi_kanboard_api:
+    | {
+        captureToBacklog(opts: { cwd: string; text: string }): Promise<
+          { ok: true; id: string; attachments: number } | { ok: false; reason: string }
+        >;
+      }
+    | undefined;
+
   // eslint-disable-next-line no-var
   var __unipi_mcp_stats: import("./global-types.js").McpStatsLike | undefined;
 }