agent-tempo 1.6.2 → 1.7.0-beta.0

package/dashboard/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agent-tempo-dashboard",
   "private": true,
-  "version": "1.6.2",
+  "version": "1.7.0-beta.0",
   "type": "module",
   "description": "Web dashboard for agent-tempo. Bundled into the npm package; served by the daemon at /dashboard/*.",
   "scripts": {

package/dist/pi/extension.js

@@ -188,6 +188,34 @@ function createPiExtension(options = {}) {
         };
         (0, render_tools_1.renderToPi)(pi, (0, server_tools_1.buildAllTempoTools)(toolOpts));
         log(`registered tools (player=${currentPlayerId}, conductor=${isConductor}, mode=${mode})`);
+        // ── #698 — FULL server-instruction preamble into the Pi system prompt ──
+        // The Pi equivalent of MCP players' `buildServerInstructions` (#695 S2 seeded
+        // this hook with just the 4 yield-norms; #698 widens it to the WHOLE preamble —
+        // identity, cue/report/recruit guidance, Communication-discipline, and the
+        // conductor/player operational rules). SINGLE-SOURCED off `buildServerInstructions`
+        // so MCP + Pi guidance can't drift; the yield-norms now arrive FOLDED IN (they
+        // live inside that builder since #695 S1), so there is no separate const.
+        // `before_agent_start` exposes the fully-assembled systemPrompt and accepts a
+        // replacement (chained across extensions), so we APPEND — injected into the
+        // model's system prompt every turn, invisibly (NOT a sendMessage, which would
+        // spam the transcript). Applies to ALL Pi players (interactive + headless).
+        //
+        // Opts are built PER FIRE (before_agent_start fires every turn): playerId and
+        // hasRequestedName must reflect CURRENT state, so a `set_name`-renamed player
+        // gets the right identity rather than the boot-time one.
+        const piInstructionOpts = () => ({
+            ensemble: config.ensemble,
+            playerId: toolOpts.getPlayerId(),
+            isConductor,
+            playerType: process.env[config_1.ENV.PLAYER_TYPE] || undefined,
+            // playerTypeDescription omitted (MVP — not threaded into the Pi runtime).
+            hasRequestedName: Boolean(process.env[config_1.ENV.PLAYER_NAME]),
+        });
+        // Cast mirrors the tool_call returning-handler pattern (the shim's `on` is
+        // void-typed; the real ExtensionAPI before_agent_start handler returns a result).
+        pi.on('before_agent_start', (ev) => ({
+            systemPrompt: `${ev.systemPrompt ?? ''}\n\n${(0, server_tools_1.buildServerInstructions)(piInstructionOpts())}`,
+        }));
         // ── #677 PART B — interactive-only `/tempo-reset` command ──
         // Pi's `newSession` (clean-wipe) is ExtensionCommandContext-ONLY (not on the
         // SDK session), so an interactive Pi conductor can ONLY be reset by the operator

package/dist/pi/pi-types.d.ts

@@ -191,6 +191,24 @@ export interface PiToolCallResult {
     block?: boolean;
     reason?: string;
 }
+/**
+ * `before_agent_start` payload (#695). Pi fires this after the user prompt is
+ * assembled but before the agent loop; it carries the fully-built `systemPrompt`.
+ * A handler returns {@link PiBeforeAgentStartResult} to replace it. We read only
+ * `systemPrompt` (to append the yield norms); kept open for forward-compat.
+ */
+export interface PiBeforeAgentStartEvent {
+    /** The fully-assembled system prompt string for this turn. */
+    systemPrompt?: string;
+}
+/**
+ * Result of a `before_agent_start` handler (#695). Returning `systemPrompt`
+ * REPLACES the system prompt for the turn ("If multiple extensions return this,
+ * they are chained" — Pi 0.78). We append the yield norms and return it.
+ */
+export interface PiBeforeAgentStartResult {
+    systemPrompt?: string;
+}
 /**
  * Pi tool result — a Pi-free structural mirror of the real `AgentToolResult`
  * (#653, 1.4.2). The Phase-0 `{ output, isError }` guess was WRONG: Pi's real

package/dist/server-tools.js

@@ -138,6 +138,11 @@ function buildServerInstructions(opts) {
         `Use \`report\` to notify the conductor of task completion, blockers, or questions — always report when you finish a recruited task.` +
         `\n\nCommunication discipline:\n` +
         `- Drafting a response in your turn is not the same as sending one. The conductor and other players cannot read your reasoning — only your \`cue\` and \`report\` tool calls cross the channel boundary. If you reach a decision, ruling, or status update, fire the appropriate tool before moving on. If you find yourself thinking "I already answered that," verify the tool was actually invoked.` +
+        // #695 — yield-don't-poll norms (apply to all MCP players).
+        `\n- Yield after dispatch — after cueing a player and expecting a reply, end your turn. Inbound cues wake you automatically at the next turn boundary; there is nothing to poll.` +
+        `\n- \`listen\` is a one-shot inbox drain, not a wait primitive — it reads whatever is already queued at call time. A \`sleep\`+\`listen\` loop does not work as a wait and is an anti-pattern that burns tokens across the ensemble. If you're waiting for a reply, end your turn.` +
+        `\n- Don't reply to ack/FYI cues — if a player sends a status update or acknowledgment without asking a question or requesting action, do not respond. Responding starts a ping-pong that wastes turns on both sides.` +
+        `\n- Cues queue, they don't interrupt — a cue sent to you while you're processing arrives at your next turn boundary, not mid-turn. A burst from multiple players arrives together; process the batch in one turn.` +
         (isConductor
             ? `\n\nOperational rules:\n` +
                 `- Before assigning parallel work on different branches, provision git worktrees via the \`worktree\` tool so each player has an isolated checkout.\n` +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-tempo",
-  "version": "1.6.2",
+  "version": "1.7.0-beta.0",
   "description": "Many agents, one tempo. Durable coordination for multi-agent work via Temporal.",
   "keywords": [
     "mcp",