@piagent/platform 1.6.0 → 1.7.1

package/packages/piagent-core/runtime/registration/workflow-commands.ts

@@ -1,94 +1,52 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import {
+  WORKFLOW_OPTIONS,
+  type WorkflowId,
+  resolveWorkflowId,
+  workflowCommandNames,
+  workflowHelpLines,
+  workflowOption
+} from "../workflows/webui-workflow.ts";
+import { buildOnboardingWorkflowPrompt, buildWorkflowFollowUp } from "../workflows/workflow-follow-up.ts";
+
+import type { TaskContract } from "../../extensions/guard-types.js";
+import { activeSessionTask } from "../../extensions/task-state.js";
+import { isUncertainSendContinuation, terminalUncertainSendReceipt } from "../session/uncertain-send-continuation.ts";
 
 type ExtensionContext = any;
 
 export function registerWorkflowCommands(pi: ExtensionAPI, deps: Record<string, any>): any {
   const {
-    FRESH_COMMAND_ACTIONS, FRESH_COMMAND_HELP, ONBOARDING_COMMAND_ACTIONS, WORKFLOW_COMMAND_EXCLUSIONS, buildContextIndexStatus,
+    ONBOARDING_COMMAND_ACTIONS, WORKFLOW_COMMAND_EXCLUSIONS, buildContextIndexStatus,
     buildUsageSnapshot, commandArgs, emitProfileStatus, emitProfileTechStatus, emitRuntimeMessage,
     fs, loadProfileFromContext, prefixCompletions, projectContextFilePath, projectProfilePath,
     registerRuntimeCommand, resolveMemorySettings, runProfileTechWizard, selectRuntimeAction, sendWorkflowFollowUp,
     freshRequestParts, shortTaskLabel, techStackPath
   } = deps;
-  type WorkflowCommandName = "task" | "scout" | "be-to-fe" | "discuss" | "plan" | "review" | "platform-improve" | "commit" | "pr" | "onboard";
-
-  const WORKFLOW_ALIASES: Record<string, WorkflowCommandName> = {
-    task: "task",
-    implement: "task",
-    scout: "scout",
-    audit: "scout",
-    "be-to-fe": "be-to-fe",
-    befe: "be-to-fe",
-    discuss: "discuss",
-    clarify: "discuss",
-    plan: "plan",
-    review: "review",
-    "platform-improve": "platform-improve",
-    platform: "platform-improve",
-    commit: "commit",
-    pr: "pr",
-    onboard: "onboard",
-    "onboard-project": "onboard"
-  };
-
   function workflowChoices(): Array<{ value: string; label: string; description: string; recommended?: boolean }> {
     return [
-      { value: "task", label: "Task", description: "Implement a bounded task", recommended: true },
-      { value: "scout", label: "Scout", description: "Read-only audit/research" },
-      { value: "be-to-fe", label: "BE to FE", description: "Backend read-only, frontend implementation" },
-      { value: "discuss", label: "Discuss", description: "Clarify before planning/editing" },
-      { value: "plan", label: "Plan", description: "Create an implementation plan" },
-      { value: "review", label: "Review", description: "Review diff/source read-only" },
-      { value: "commit", label: "Commit", description: "Guarded local commit workflow" },
-      { value: "pr", label: "PR", description: "Guarded pull request preparation" },
-      { value: "onboard", label: "Onboard", description: "First-read project onboarding scout" },
-      { value: "platform-improve", label: "Platform", description: "Improve Pi Agent Platform itself" },
+      ...WORKFLOW_OPTIONS.map((option) => ({
+        value: option.id,
+        label: option.label,
+        description: option.description,
+        ...(option.id === "task" ? { recommended: true } : {})
+      })),
       { value: "help", label: "Help", description: "Show typed workflow forms" }
     ];
   }
 
-  function buildOnboardingWorkflowPrompt(focus: string): string {
-    return [
-      "Run the Pi Agent Platform first-read onboarding workflow for this repository.",
-      "",
-      `Optional focus: ${focus.trim() || "whole repository"}`,
-      "",
-      "Preconditions:",
-      "- The operator has logged in and selected the intended model/thinking level.",
-      "- Stay read-only except writing Piagent onboarding state through piagent tools.",
-      "",
-      "Mandatory flow:",
-      "1. Call piagent_context with detail=full.",
-      "2. If the project is unprofiled, call piagent_profile_options, do a lightweight root scout, recommend a profile, and use piagent_profile_apply only after the operator choice is clear.",
-      "3. Prefer /profile setup or piagent_profile_tech_options + piagent_profile_tech_apply for tech stack selection.",
-      "4. Re-call piagent_context after profile/tech changes.",
-      "5. Call piagent_memory_status and treat memory as advisory.",
-      "6. Read AGENTS.md, README/package/build config, required context, docs/architecture files, source map, and verify command definitions. Do not ingest the whole repo.",
-      "7. Identify project purpose, stack/runtime, ownership boundaries, high-risk areas, protected paths, verify commands, MCP/tool capabilities, selected tech stack, memory policy, and conventions.",
-      "8. Write a concise .pi/project-context.md snapshot and record it with piagent_project_onboarding_record so .pi/context-index.json is generated.",
-      "9. Call piagent_context_index_status and report pending/stale warnings.",
-      "",
-      "Final output: profile, tech stack, context files read, verification matrix, high-risk areas, context-index status, memory status, and any missing operator decisions."
-    ].join("\n");
-  }
-
   function emitWorkflowHelp(ctx: ExtensionContext): void {
-    emitRuntimeMessage(ctx, "piagent-workflow-help", [
-      "namespace: /workflow",
-      "daily: /workflow task <request>",
-      "readOnly: /workflow scout <area/spec/risk>",
-      "beToFe: /workflow be-to-fe <BE spec/change + FE outcome>",
-      "clarify: /workflow discuss <rough idea>",
-      "plan: /workflow plan <goal>",
-      "review: /workflow review <target or diff>",
-      "git: /workflow commit [message] | /workflow pr [title]",
-      "onboard: /workflow onboard [focus]",
-      "aliases still work: /task, /scout, /be-to-fe, /commit, /pr"
-    ].join("\n"), { workflows: workflowChoices().map((choice) => choice.value) });
+    emitRuntimeMessage(ctx, "piagent-workflow-help", workflowHelpLines().join("\n"), {
+      workflows: WORKFLOW_OPTIONS.map((option) => option.id)
+    });
   }
 
   async function runWorkflowNamespace(raw: string, ctx: ExtensionContext): Promise<void> {
     const { action, rest } = commandArgs(raw);
+    if (action === "help") {
+      emitWorkflowHelp(ctx);
+      return;
+    }
     if (!action) {
       const chosen = await selectRuntimeAction(ctx, "Piagent workflow", workflowChoices(), "task");
       if (!chosen || chosen === "help") {
@@ -107,8 +65,8 @@ export function registerWorkflowCommands(pi: ExtensionAPI, deps: Record<string,
       ].join("\n"), { workflow: chosen });
       return;
     }
-    const workflow = WORKFLOW_ALIASES[action];
-    if (!workflow || workflow === undefined) {
+    const workflow = resolveWorkflowId(action);
+    if (!workflow) {
       emitRuntimeMessage(ctx, "piagent-workflow-error", `unknown workflow: ${action}\nRun /workflow help`, { action }, { message: `Unknown workflow: ${action}`, level: "warning" });
       return;
     }
@@ -117,7 +75,7 @@ export function registerWorkflowCommands(pi: ExtensionAPI, deps: Record<string,
       ctx.ui.notify("Workflow launched: onboard", "info");
       return;
     }
-    if (!rest.trim()) {
+    if (!rest.trim() && workflowOption(workflow)?.requestRequired !== false) {
       emitRuntimeMessage(ctx, "piagent-workflow-needs-request", [
         `workflow: ${workflow}`,
         `run: /workflow ${workflow} <request>`,
@@ -125,7 +83,13 @@ export function registerWorkflowCommands(pi: ExtensionAPI, deps: Record<string,
       ].join("\n"), { workflow });
       return;
     }
-    sendWorkflowFollowUp(`/${workflow} ${rest}`);
+    // Namespace commands run before the input hook. Recover a current durable
+    // receipt here so their deferred extension prompt cannot open a model turn.
+    if (isUncertainSendContinuation(rest) && ctx.isIdle()) {
+      const receipt = terminalUncertainSendReceipt(ctx.cwd, activeSessionTask(ctx.cwd, ctx.sessionManager.getSessionId()) as TaskContract | undefined);
+      if (receipt) { emitRuntimeMessage(ctx, receipt.customType, receipt.content, receipt.details); return; }
+    }
+    sendWorkflowFollowUp(buildWorkflowFollowUp(workflow, rest));
     ctx.ui.notify(`Workflow launched: ${workflow}`, "info");
   }
 
@@ -150,20 +114,16 @@ export function registerWorkflowCommands(pi: ExtensionAPI, deps: Record<string,
     const sections: Record<string, string[]> = {
       overview: [
         "Piagent command surface:",
-        "runtime: /workflow | /piagent-inspector | /usage | /context | /permission | /commands | /profile | /memory | /onboard | /fresh",
+        "runtime: /workflow | /piagent-inspector | /usage | /context | /permission | /fast | /commands | /profile | /memory | /onboard | /fresh",
         "native: /model | /name | /session | /resume | /compact | /mcp",
-        "workflow: /workflow task|scout|be-to-fe|review|commit|pr <request>",
+        `workflow: /workflow ${WORKFLOW_OPTIONS.map((option) => option.id).join("|")} <request>`,
         "mcp: /mcp is Pi native; governed MCP checks stay at /piagent-mcp to avoid collision",
         "legacy: /piagent-* commands still work where they existed",
         "principle: runtime commands run immediately; workflows intentionally launch an agent turn"
       ],
       workflow: [
         "Workflow entrypoint:",
-        "/workflow",
-        "/workflow task <request>",
-        "/workflow scout <read-only request>",
-        "/workflow be-to-fe <BE spec/change + FE outcome>",
-        "/workflow onboard [focus]"
+        ...workflowHelpLines()
       ],
       usage: [
         "Usage/session:",
@@ -171,7 +131,7 @@ export function registerWorkflowCommands(pi: ExtensionAPI, deps: Record<string,
         "/piagent-inspector",
         "/usage history",
         "Pi native: /name <task name>",
-        "/fresh task|scout|be-to-fe <request>",
+        `/fresh ${WORKFLOW_OPTIONS.map((option) => option.id).join("|")} <request>`,
         "native: /session | /resume"
       ],
       context: [
@@ -193,8 +153,16 @@ export function registerWorkflowCommands(pi: ExtensionAPI, deps: Record<string,
         "Model:",
         "/model or Ctrl+L opens Pi native selector",
         "/model-options shows local Piagent model guidance",
+        "/fast status|on|off controls the OpenAI Codex Fast service tier without changing model/thinking",
         "Ctrl+P cycles model scope; Shift+Tab cycles thinking"
       ],
+      fast: [
+        "Fast service tier:",
+        "/fast status",
+        "/fast on",
+        "/fast off",
+        "Fast is a zero-model-turn session setting; model/thinking stay unchanged and provider quota or pricing may differ"
+      ],
       memory: [
         "Memory:",
         "/memory",
@@ -240,6 +208,7 @@ export function registerWorkflowCommands(pi: ExtensionAPI, deps: Record<string,
       { value: "context", label: "Context", description: "Index/search/preflight/compact" },
       { value: "permission", label: "Permission", description: "Read/write/full access controls" },
       { value: "model", label: "Model", description: "Native model selector and thinking" },
+      { value: "fast", label: "Fast mode", description: "Status and OpenAI Codex Fast service tier control" },
       { value: "mcp", label: "MCP", description: "Governed MCP commands" },
       { value: "subagents", label: "Subagents", description: "Health, fleet, cost" },
       { value: "terminal", label: "Terminal", description: "piagent-* helpers" }
@@ -339,7 +308,7 @@ export function registerWorkflowCommands(pi: ExtensionAPI, deps: Record<string,
   registerRuntimeCommand(pi, "workflow", {
     description: "One menu for Piagent task, scout, review, git, and onboarding workflows",
     getArgumentCompletions: (prefix: string) => prefixCompletions(
-      Object.keys(WORKFLOW_ALIASES).filter((name) => !WORKFLOW_COMMAND_EXCLUSIONS.includes(name)),
+      workflowCommandNames().filter((name) => !WORKFLOW_COMMAND_EXCLUSIONS.includes(name)),
       prefix
     ),
     handler: async (args, ctx) => {
@@ -376,16 +345,16 @@ export function registerWorkflowCommands(pi: ExtensionAPI, deps: Record<string,
     handler: async (args, ctx) => runOnboardingCommand(String(args ?? ""), ctx)
   });
 
-  async function startFreshWorkflow(workflow: "task" | "scout" | "be-to-fe", args: string, ctx: any) {
+  async function startFreshWorkflow(workflow: WorkflowId, args: string, ctx: any) {
     const parsed = freshRequestParts(String(args ?? ""));
     const request = parsed.request;
-    if (!request) {
+    if (!request && workflowOption(workflow)?.requestRequired !== false) {
       ctx.ui.notify(`Usage: /fresh ${workflow} <request>`, "warning");
       return;
     }
 
-    const label = parsed.sessionTitle ?? shortTaskLabel(request);
-    const command = `/${workflow} ${request}`;
+    const label = parsed.sessionTitle ?? shortTaskLabel(request || workflow);
+    const command = [`/${workflow}`, request].filter(Boolean).join(" ");
     const result = await ctx.newSession({
       withSession: async (nextCtx) => {
         pi.setSessionName(`pi:${label}`);
@@ -398,18 +367,20 @@ export function registerWorkflowCommands(pi: ExtensionAPI, deps: Record<string,
   }
 
   registerRuntimeCommand(pi, "fresh", {
-    description: "Open a fresh governed session for task, scout, or BE-to-FE work",
-    getArgumentCompletions: (prefix: string) => prefixCompletions(FRESH_COMMAND_ACTIONS, prefix),
+    description: "Open a fresh governed session for any Piagent workflow",
+    getArgumentCompletions: (prefix: string) => prefixCompletions([...workflowCommandNames({ aliases: false }), "help"], prefix),
     handler: async (args, ctx) => {
       const { action, rest } = commandArgs(String(args ?? ""));
       if (!action || action === "help") {
-        emitRuntimeMessage(ctx, "piagent-fresh-help", FRESH_COMMAND_HELP.join("\n"));
+        emitRuntimeMessage(ctx, "piagent-fresh-help", [
+          "namespace: /fresh",
+          ...WORKFLOW_OPTIONS.map((option) => `/fresh ${option.id} ${option.argumentHint}`)
+        ].join("\n"));
         return;
       }
-      const workflow = action === "be-to-fe" ? "be-to-fe" : action === "scout" ? "scout" : "task";
-      const request = action === "task" || action === "scout" || action === "be-to-fe"
-        ? rest
-        : [action, rest].filter(Boolean).join(" ");
+      const resolved = resolveWorkflowId(action);
+      const workflow = resolved ?? "task";
+      const request = resolved ? rest : [action, rest].filter(Boolean).join(" ");
       await startFreshWorkflow(workflow, request, ctx);
     }
   });

package/packages/piagent-core/runtime/runtime-limits.ts

@@ -6,10 +6,24 @@ export const CONTEXT_COMPACT_PERCENT = 70;
 export const CONTEXT_FRESH_PERCENT = 82;
 export const LONG_INPUT_CHARS = 8000;
 export const MAX_INLINE_COLLAPSED_TASK_CHARS = 2200;
-export const RUNTIME_INTAKE_MESSAGE_MAX_CHARS = 6_000;
-export const SEMANTIC_COMPACTION_MAX_CHARS = 8_000;
+export const RUNTIME_INTAKE_COMPACT_CHARS = 3_500;
+export const RUNTIME_INTAKE_MESSAGE_MAX_CHARS = 3_500;
+export const SEMANTIC_COMPACTION_MAX_CHARS = 12_000;
 export const CONTEXT_PACK_MAX_TOKENS = 900;
 
+// The host's default compaction reserve is primarily an overflow guard. Piagent's
+// governor acts earlier because repeatedly replaying a valid 200k+ context can
+// burn substantially more tokens than the task itself. These are working-set
+// limits, not capability limits: high-value task truth is carried forward while
+// stale tool transcripts remain in the durable session history.
+export const CONTEXT_PROVIDER_PROMPT_CEILING_TOKENS = 240_000;
+export const CONTEXT_GOVERNOR_PRESSURE_TOKENS = 160_000;
+export const CONTEXT_GOVERNOR_TARGET_MESSAGE_TOKENS = 72_000;
+export const CONTEXT_GOVERNOR_RECENT_MESSAGE_TOKENS = 40_000;
+export const CONTEXT_GOVERNOR_SEMANTIC_BOUNDARY_TOKENS = 48_000;
+export const CONTEXT_GOVERNOR_TOOL_ROUND_LIMIT = 24;
+export const CONTEXT_GOVERNOR_LEDGER_MAX_CHARS = 12_000;
+
 export const TOOL_RESULT_COMPACT_CHAR_THRESHOLD = 12_000;
 export const TOOL_RESULT_COMPACT_LINE_THRESHOLD = 180;
 export const TOOL_RESULT_PREVIEW_HEAD_LINES = 24;