@sjawhar/pi-legion-envoy 5.20.0 → 5.22.0

package/dist/envoy.js

@@ -34517,6 +34517,31 @@ function asObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
 }
 
+// ../envoy-client/src/dispatch-first.ts
+import { readFileSync as readFileSync3 } from "fs";
+import { join as join2 } from "path";
+var DISPATCH_FIRST_MARKER = "<dispatch-first-skill>";
+function dispatchFirstSkillFile(skillsDirectory) {
+  return join2(skillsDirectory, "dispatch-first", "SKILL.md");
+}
+function readDispatchFirstContext(skillFile) {
+  let skill;
+  try {
+    skill = readFileSync3(skillFile, "utf8");
+  } catch (error48) {
+    throw new Error(`the dispatch-first skill ${skillFile} could not be read: ${messageFor(error48)}`);
+  }
+  const body = skill.replace(/^---\n[\s\S]*?\n---\n/, "").trim();
+  return [
+    DISPATCH_FIRST_MARKER,
+    "This session has Dispatch, so the dispatch-first skill is loaded for it. Follow it.",
+    "",
+    body,
+    "</dispatch-first-skill>"
+  ].join(`
+`);
+}
+
 // ../envoy-client/src/dispatch-subscribe.ts
 function dispatchFollowNotice(details) {
   if (typeof details !== "object" || details === null)
@@ -35196,6 +35221,29 @@ class AgentStreamPublisher {
   }
 }
 
+// src/dispatch-first.ts
+function withDispatchFirst(messages, context) {
+  let index = 0;
+  for (const message of messages) {
+    const summary = typeof message === "object" && message !== null && "role" in message && message.role === "compactionSummary";
+    if (!summary)
+      break;
+    index += 1;
+  }
+  const present = messages[index];
+  if (typeof present === "object" && present !== null && "role" in present && present.role === "user" && "content" in present && Array.isArray(present.content)) {
+    const [first] = present.content;
+    if (typeof first === "object" && first !== null && "text" in first && typeof first.text === "string" && first.text.startsWith(DISPATCH_FIRST_MARKER)) {
+      return;
+    }
+  }
+  return [
+    ...messages.slice(0, index),
+    { role: "user", content: [{ type: "text", text: context }], timestamp: 0 },
+    ...messages.slice(index)
+  ];
+}
+
 // src/envoy-session.ts
 import path2 from "path";
 var ENVOY_SESSIONS = Symbol.for("legion.pi-envoy.envoy-session");
@@ -35532,6 +35580,7 @@ function resolveSkillsDirectory() {
   return found;
 }
 var SKILLS_DIRECTORY = resolveSkillsDirectory();
+var DISPATCH_FIRST_CONTEXT = readDispatchFirstContext(dispatchFirstSkillFile(SKILLS_DIRECTORY));
 function envoyExtension(pi) {
   logger.debug("extension instance loaded", { extension: import.meta.url });
   const defaults = envoyDefaultsFromEnvironment(process.env);
@@ -36282,6 +36331,10 @@ function envoyExtension(pi) {
         }
       });
     }
+    pi.on("context", async (event) => {
+      const messages = withDispatchFirst(event.messages, DISPATCH_FIRST_CONTEXT);
+      return messages === undefined ? undefined : { messages };
+    });
   }
   registerEnvoyWhoamiCommand(pi, replyAddress);
   pi.on("before_agent_start", async (event, context) => {

package/dist/legion.js

@@ -33495,7 +33495,7 @@ import { logger } from "@oh-my-pi/pi-utils";
 // package.json
 var package_default = {
   name: "@sjawhar/pi-legion-envoy",
-  version: "5.20.0",
+  version: "5.22.0",
   type: "module",
   omp: {
     extensions: [

package/dist/skills/AGENTS.md

@@ -8,6 +8,7 @@ event intake, process lifecycle, credentials, and role delivery.
 | --- | --- | --- |
 | `ce-simplify-code/` | the implementer, once per pull request | the behaviour-preserving simplify pass before the reviewer's final pass (Legion's copy of the MIT-licensed Compound Engineering skill; `LICENSE` beside it) |
 | `dispatch/` | every role, and any session writing to Dispatch | specs, asks, comments, artifacts, and messages on native Dispatch |
+| `dispatch-first/` | every session with Dispatch configured, injected by each host plugin on every request (Oh My Pi), on every `SessionStart` (startup, resume, clear, compact, fork) and `SubagentStart` (Claude Code), or as an instruction file (OpenCode) | searching Dispatch before acting, extending the existing issue, citing decisions, closing duplicates; kept under 60 lines and 6,000 characters |
 | `envoy/` | every role | subscriptions, agent-to-agent messages, and topic formats |
 | `legion-architect/` | root and sub-architects | tree ownership, decomposition, waves, gates, integration, sign-off |
 | `legion-controller/` | the controller root process | wake routing, keeping the admission slots full from `todo`, the daily report, escalation |
@@ -19,6 +20,7 @@ event intake, process lifecycle, credentials, and role delivery.
 
 The owning skill above is where each contract is defined; a role prompt that needs a contract from its own seat points there or restates only its own step. This file lists and does not restate.
 A Legion prompt (a skill here, a role prompt, or an agent definition in `packages/pi-envoy/agents/`) names a task agent only as `task(agent="<name>")` and a skill it tells the model to load only as `skill://<name>`. Those are the two forms the Go daemon's boot gate and `legion probe-image` resolve through Oh My Pi, refusing by name one it cannot find; a dispatch or a load written any other way goes unchecked. An agent or skill Legion's prompts name is shipped here or in `packages/pi-envoy/agents/`, unless Oh My Pi bundles it.
+A skill file an agent loads stays under 51,200 bytes, Oh My Pi's spill threshold (a longer one arrives with its middle cut out), and a skill's detail lives in `references/` files linked as `skill://<name>/references/<file>.md`, never by relative path, which a read by path cuts at 300 lines. `packages/pi-envoy/src/skills-guard.test.ts` fails on a file at the threshold, on any `SKILL.md` body of 500 lines or more, on a skill whose frontmatter `name` is not its directory's name, on a `dispatch-first` over its budget, on a `skill://<name>/<path>` link that names a missing file or a missing `#heading`, and on a `legion-worker` reference nothing links.
 The text a worker boots with (its role prompt) lives in `packages/pi-envoy/roles/` and is
 composed per role in `packages/daemon/src/daemon/processes.ts`; `packages/pi-envoy/roles/roles.test.ts`
 holds the structural rules for those parts.