takomi 2.1.44 → 2.5.1

package/.pi/extensions/takomi-runtime/tool-renderers.ts

@@ -0,0 +1,234 @@
+import { getMarkdownTheme, keyHint } from "@earendil-works/pi-coding-agent";
+import { Container, Markdown, Text } from "@earendil-works/pi-tui";
+
+type Theme = {
+  fg(color: string, text: string): string;
+  bold(text: string): string;
+};
+
+type ToolResult = {
+  content?: string | Array<{ type?: string; text?: string }>;
+  details?: unknown;
+  isError?: boolean;
+};
+
+type ResultOptions = { expanded: boolean; isError?: boolean };
+type CardStatus = "success" | "warning" | "error" | "pending";
+
+type ModeDetails = {
+  mode?: string;
+  source?: string;
+  reason?: string;
+  role?: string;
+  stage?: string;
+  workflow?: string;
+};
+
+type RoutingDetails = {
+  result?: { detectedDefaults?: string[] };
+  preview?: { scope?: string };
+};
+
+type WorkflowDetails = { id?: string; title?: string; purpose?: string };
+
+type BoardError = {
+  code: string;
+  message: string;
+  severity: "warning" | "error";
+};
+
+type BoardDetails = {
+  sessionId?: string;
+  taskId?: string;
+  task?: { id?: string; status?: string };
+  tasks?: unknown[];
+  lifecycle?: unknown;
+  error?: BoardError;
+};
+
+type BoardArgs = {
+  action?: "init_session" | "expand_stage" | "show_workflows" | "show_session" | "update_task" | "replace_master_plan";
+  sessionId?: string;
+  taskId?: string;
+  stage?: string;
+};
+
+// Tool output is model-facing data. Sanitize only at the TUI boundary so
+// ANSI, OSC, and C0 controls cannot alter terminal presentation.
+function sanitizePresentation(value: string): string {
+  return value
+    .replace(/\x1B\][\s\S]*?(?:\x07|\x1B\\)/g, "") // OSC (BEL or ST terminated)
+    .replace(/\x1B\[[0-?]*[ -/]*[@-~]/g, "") // CSI
+    .replace(/[\x00-\x08\x0B-\x1F\x7F-\x9F]/g, "");
+}
+
+function resultText(result: ToolResult): string {
+  const text = typeof result.content === "string"
+    ? result.content
+    : result.content?.filter((part) => part.type === "text").map((part) => part.text ?? "").join("\n") ?? "";
+  return sanitizePresentation(text);
+}
+
+function bounded(value: string | undefined, limit = 36): string {
+  const text = sanitizePresentation(value ?? "").replace(/\s+/g, " ").trim();
+  return text.length > limit ? `${text.slice(0, Math.max(1, limit - 1))}…` : text;
+}
+
+function status(result: ToolResult, options: ResultOptions, details?: { error?: BoardError }): CardStatus {
+  if (details?.error?.severity) return details.error.severity;
+  return result.isError || options.isError ? "error" : "success";
+}
+
+function renderToolCall(name: string, target: string | undefined, theme: Theme): Text {
+  return new Text(
+    `${theme.fg("toolTitle", theme.bold(`${name} `))}${target ? theme.fg("accent", bounded(target)) : ""}`,
+    0,
+    0,
+  );
+}
+
+function renderCompactCard(options: {
+  status: CardStatus;
+  title: string;
+  summary: string;
+  metadata: string;
+}, theme: Theme): Text {
+  const presentation = {
+    success: ["✓", "success"],
+    warning: ["⚠", "warning"],
+    error: ["✗", "error"],
+    pending: ["…", "muted"],
+  } as const;
+  const [icon, color] = presentation[options.status];
+  return new Text([
+    `${theme.fg(color, icon)} ${theme.fg("accent", theme.bold(bounded(options.title)))} ${theme.fg("muted", bounded(options.summary, 72))}`,
+    theme.fg("dim", `${bounded(options.metadata, 64)} · ${keyHint("app.tools.expand", "view details")}`),
+  ].join("\n"), 0, 0);
+}
+
+function renderExpandedCard(options: {
+  status: CardStatus;
+  title: string;
+  summary: string;
+  metadata: string[];
+  markdown: string;
+}, theme: Theme): Container {
+  const presentation = {
+    success: ["✓", "success"],
+    warning: ["⚠", "warning"],
+    error: ["✗", "error"],
+    pending: ["…", "muted"],
+  } as const;
+  const [icon, color] = presentation[options.status];
+  const container = new Container();
+  container.addChild(new Text(
+    `${theme.fg(color, icon)} ${theme.fg("accent", theme.bold(sanitizePresentation(options.title)))} ${theme.fg("muted", sanitizePresentation(options.summary))}`,
+    0,
+    0,
+  ));
+  for (const detail of options.metadata) container.addChild(new Text(theme.fg("dim", sanitizePresentation(detail)), 0, 0));
+  container.addChild(new Text(theme.fg("dim", keyHint("app.tools.expand", "collapse")), 0, 0));
+  container.addChild(new Markdown(sanitizePresentation(options.markdown), 0, 1, getMarkdownTheme()));
+  return container;
+}
+
+export function renderTakomiModeCall(args: { mode?: string } | undefined, theme: Theme): Text {
+  return renderToolCall("takomi_mode", args?.mode ?? "mode", theme);
+}
+
+export function renderTakomiModeResult(result: ToolResult, options: ResultOptions, theme: Theme): Container | Text {
+  const details = result.details as ModeDetails | undefined;
+  const primary = details?.stage ?? details?.role ?? details?.mode ?? "mode";
+  const source = details?.source ?? "model";
+  const metadata = [source, details?.workflow ? `wf:${details.workflow}` : "footer updated"].join(" · ");
+  if (!options.expanded) {
+    return renderCompactCard({ status: status(result, options), title: "Takomi mode", summary: `${source}:${primary}`, metadata }, theme);
+  }
+  return renderExpandedCard({
+    status: status(result, options),
+    title: "Takomi mode",
+    summary: `${source}:${primary}`,
+    metadata: [metadata],
+    markdown: resultText(result),
+  }, theme);
+}
+
+export function renderTakomiRoutingCall(args: { scope?: string } | undefined, theme: Theme): Text {
+  return renderToolCall("takomi_apply_routing_policy", args?.scope ?? "global", theme);
+}
+
+export function renderTakomiRoutingResult(result: ToolResult, options: ResultOptions, theme: Theme): Container | Text {
+  const details = result.details as RoutingDetails | undefined;
+  const scope = details?.preview?.scope ?? "global";
+  const detectedCount = details?.result?.detectedDefaults?.length ?? 0;
+  const summary = status(result, options) === "error" ? "policy was not saved" : `${scope} policy saved`;
+  const metadata = `${detectedCount} routing defaults detected`;
+  if (!options.expanded) return renderCompactCard({ status: status(result, options), title: "Takomi routing", summary, metadata }, theme);
+  return renderExpandedCard({
+    status: status(result, options),
+    title: "Takomi routing",
+    summary,
+    metadata: [`Scope: ${scope}`, metadata],
+    markdown: resultText(result),
+  }, theme);
+}
+
+export function renderTakomiWorkflowCall(args: { workflow?: string } | undefined, theme: Theme): Text {
+  return renderToolCall("takomi_workflow", args?.workflow ?? "library", theme);
+}
+
+export function renderTakomiWorkflowResult(result: ToolResult, options: ResultOptions, theme: Theme): Container | Text {
+  const details = result.details as WorkflowDetails | undefined;
+  const selected = details?.id;
+  const title = selected ? "Takomi workflow" : "Workflow library";
+  const summary = selected ? (details?.title ?? selected) : "embedded lifecycle playbooks";
+  const metadata = selected ? bounded(selected) : "genesis · design · build";
+  if (!options.expanded) return renderCompactCard({ status: status(result, options), title, summary, metadata }, theme);
+  return renderExpandedCard({ status: status(result, options), title, summary, metadata: [metadata], markdown: resultText(result) }, theme);
+}
+
+function boardPresentation(args: BoardArgs, details: BoardDetails | undefined): { title: string; summary: string; metadata: string } {
+  switch (args.action) {
+    case "show_workflows":
+      return { title: "Workflow library", summary: "available lifecycle playbooks", metadata: "genesis · design · build" };
+    case "show_session":
+      return { title: "Takomi session", summary: "session loaded", metadata: `session:${bounded(args.sessionId ?? details?.sessionId, 24)}` };
+    case "update_task":
+      return {
+        title: `Task ${bounded(args.taskId ?? details?.taskId ?? details?.task?.id, 24) || "update"}`,
+        summary: details?.task?.status ? `status: ${details.task.status}` : "task updated",
+        metadata: `session:${bounded(args.sessionId ?? details?.sessionId, 24)}`,
+      };
+    case "expand_stage":
+      return {
+        title: `${args.stage ?? "Lifecycle"} stage`,
+        summary: "stage expanded",
+        metadata: `session:${bounded(args.sessionId ?? details?.sessionId, 24)}`,
+      };
+    default:
+      return {
+        title: "Takomi board",
+        summary: "orchestrator session created",
+        metadata: `session:${bounded(details?.sessionId ?? args.sessionId, 24)}`,
+      };
+  }
+}
+
+export function renderTakomiBoardCall(args: BoardArgs | undefined, theme: Theme): Text {
+  return renderToolCall("takomi_board", args?.action ?? "init_session", theme);
+}
+
+export function renderTakomiBoardResult(result: ToolResult, options: ResultOptions, theme: Theme, args?: BoardArgs): Container | Text {
+  const details = result.details as BoardDetails | undefined;
+  const presentation = boardPresentation(args ?? {}, details);
+  const cardStatus = status(result, options, details);
+  const summary = cardStatus === "success" ? presentation.summary : details?.error?.message ?? "action needs attention";
+  if (!options.expanded) return renderCompactCard({ status: cardStatus, title: presentation.title, summary, metadata: presentation.metadata }, theme);
+  return renderExpandedCard({
+    status: cardStatus,
+    title: presentation.title,
+    summary,
+    metadata: [presentation.metadata],
+    markdown: resultText(result),
+  }, theme);
+}

package/.pi/extensions/takomi-runtime/workflow-catalog.ts

@@ -0,0 +1,54 @@
+import {
+  getWorkflowDefinition,
+  listWorkflowCatalog,
+  type TakomiWorkflowId,
+  type WorkflowCatalogEntry,
+  type WorkflowDefinition,
+} from "../../../src/pi-takomi-core";
+
+type WorkflowCatalogPayload = {
+  content: Array<{ type: "text"; text: string }>;
+  details: { workflows: readonly WorkflowCatalogEntry[] };
+};
+
+type WorkflowPlaybookPayload = {
+  content: Array<{ type: "text"; text: string }>;
+  details: WorkflowDefinition & { workflows: readonly WorkflowCatalogEntry[] };
+};
+
+function formatCatalogEntry(workflow: WorkflowCatalogEntry): string {
+  return `${workflow.id} (${workflow.stage}) — ${workflow.name}: ${workflow.description} [${workflow.availability}]`;
+}
+
+/** Discovery/load adapter for the direct workflow API. */
+export function discoverWorkflowPlaybooks(workflowId?: TakomiWorkflowId): WorkflowPlaybookPayload | WorkflowCatalogPayload {
+  if (workflowId) {
+    const workflow = getWorkflowDefinition(workflowId);
+    return {
+      content: [{ type: "text", text: `${workflow.title}\n\n${workflow.playbook}` }],
+      details: { ...workflow, workflows: listWorkflowCatalog() },
+    };
+  }
+
+  const workflows = listWorkflowCatalog();
+  return {
+    content: [{ type: "text", text: workflows.map(formatCatalogEntry).join("\n") }],
+    details: { workflows },
+  };
+}
+
+/** Lifecycle-board adapter; intentionally catalog-oriented and playbook-free. */
+export function showWorkflowCatalogForBoard(): WorkflowCatalogPayload {
+  const workflows = listWorkflowCatalog();
+  return {
+    content: [{
+      type: "text",
+      text: [
+        "Takomi lifecycle workflow catalog",
+        "",
+        ...workflows.map((workflow) => `- ${formatCatalogEntry(workflow)}`),
+      ].join("\n"),
+    }],
+    details: { workflows },
+  };
+}

package/.pi/extensions/takomi-subagents/agents.ts

@@ -5,6 +5,9 @@ import type { TakomiThinkingLevel } from "../../../src/pi-takomi-core";
 
 export type TakomiAgentScope = "user" | "project" | "both";
 
+export const TAKOMI_PUBLIC_AGENT_NAMES = ["architect", "designer", "coder", "worker", "reviewer", "orchestrator"] as const;
+const TAKOMI_PUBLIC_AGENT_SET = new Set<string>(TAKOMI_PUBLIC_AGENT_NAMES);
+
 export type TakomiAgentConfig = {
   name: string;
   description: string;
@@ -12,6 +15,7 @@ export type TakomiAgentConfig = {
   model?: string;
   fallbackModels?: string[];
   thinking?: TakomiThinkingLevel;
+  defaultContext?: "fresh" | "fork";
   systemPrompt: string;
   filePath: string;
   source: "user" | "project";
@@ -52,6 +56,8 @@ function loadAgentsFromDirectory(agentsDir: string, source: "user" | "project"):
     const { frontmatter, body } = parseFrontmatter<Record<string, string>>(content);
     if (!frontmatter.name || !frontmatter.description) continue;
 
+    if (!TAKOMI_PUBLIC_AGENT_SET.has(frontmatter.name)) continue;
+
     agents.push({
       name: frontmatter.name,
       description: frontmatter.description,
@@ -59,6 +65,9 @@ function loadAgentsFromDirectory(agentsDir: string, source: "user" | "project"):
       model: frontmatter.model,
       fallbackModels: splitList(frontmatter.fallbackModels ?? frontmatter.fallback_models),
       thinking: normalizeThinking(frontmatter.thinking),
+      defaultContext: frontmatter.defaultContext === "fork" || frontmatter.defaultContext === "fresh"
+        ? frontmatter.defaultContext
+        : undefined,
       systemPrompt: body,
       filePath,
       source,