spawnfile 0.1.13 → 0.1.17

package/dist/runtime/pi/appCoreSource.js

@@ -1,180 +1,108 @@
-export const renderPiCoreSource = () => String.raw `const registerAgentKeys = (map, agent) => { map.set(agent.config.id, agent); map.set(agent.config.slug, agent); map.set(agent.config.name, agent); };
-const rebuildAgentKeys = (agents) => { const map = new Map(); for (const agent of agents) registerAgentKeys(map, agent); return map; };
-const loadManagedAgent = async (agents, configPath, slug, instanceRoot, services) => { const config = await readJson(configPath); const agentConfig = (config.agents ?? []).find((agent) => agent.slug === slug || agent.id === slug || agent.name === slug); if (!agentConfig) throw new Error("unknown agent " + slug); const oldIndex = agents.findIndex((agent) => agent.config.slug === agentConfig.slug || agent.config.id === agentConfig.id || agent.config.name === agentConfig.name); if (oldIndex >= 0) { agents[oldIndex].stop(); agents.splice(oldIndex, 1); } const managed = new PiManagedAgent(agentConfig, { runtimeHomePath: path.join(instanceRoot, "runtime", "agents", agentConfig.slug), workspacePath: path.join(instanceRoot, "workspace", "agents", agentConfig.slug) }, services); await managed.start(); agents.push(managed); return managed; };
-const startControlServer = async (agents, portValue, configPath, instanceRoot, services) => {
-  if (!portValue) {
-    return null;
-  }
-
-  const port = Number(portValue);
-  if (!Number.isInteger(port) || port <= 0 || port > 65535) {
-    throw new Error("Invalid SPAWNFILE_PI_CONTROL_PORT: " + portValue);
-  }
-
-  let agentsByKey = rebuildAgentKeys(agents);
-
-  const server = createServer(async (request, response) => {
-    const url = new URL(request.url ?? "/", "http://127.0.0.1");
-
-    if (request.method === "GET" && url.pathname === "/healthz") {
-      sendJson(response, 200, { status: "ok" });
-      return;
-    }
-
-    if (request.method === "GET" && url.pathname === "/spawnfile/agents") {
-      sendJson(response, 200, { agents: agents.map((agent) => ({ id: agent.config.id, name: agent.config.name, slug: agent.config.slug })) });
-      return;
-    }
-
-    if (request.method === "GET" && url.pathname === "/spawnfile/activity") {
-      sendJson(response, 200, { events: services.activity.list(url.searchParams.get("agent"), url.searchParams.get("tail")) });
-      return;
-    }
-
-    if (request.method === "GET" && url.pathname === "/spawnfile/activity/stream") {
-      services.activity.stream(request, response, url.searchParams.get("agent"), url.searchParams.get("tail"));
-      return;
-    }
-
-    const activityMatch = /^\/spawnfile\/agents\/([^/]+)\/activity(\/stream)?$/u.exec(url.pathname);
-    if (request.method === "GET" && activityMatch) {
-      const agentFilter = decodeURIComponent(activityMatch[1]);
-      if (activityMatch[2]) {
-        services.activity.stream(request, response, agentFilter, url.searchParams.get("tail"));
-      } else {
-        sendJson(response, 200, { events: services.activity.list(agentFilter, url.searchParams.get("tail")) });
-      }
-      return;
-    }
-
-    if (request.method === "POST" && (url.pathname === "/spawnfile/agents/load" || url.pathname === "/spawnfile/agents/restart")) {
-      try { const payload = await readRequestJson(request); const slug = typeof payload.slug === "string" ? payload.slug : typeof payload.agent === "string" ? payload.agent : ""; const agent = await loadManagedAgent(agents, configPath, slug, instanceRoot, services); agentsByKey = rebuildAgentKeys(agents); sendJson(response, 200, { id: agent.config.id, loaded: true, name: agent.config.name, slug: agent.config.slug }); } catch (error) { sendJson(response, 400, { error: error instanceof Error ? error.message : String(error) }); }
-      return;
-    }
-
-    const match = /^\/agents\/([^/]+)\/wake$/u.exec(url.pathname);
-    if (request.method !== "POST" || !match) {
-      sendJson(response, 404, { error: "not found" });
-      return;
-    }
+import { renderPiControlSource } from "./appControlSource.js";
+import { renderPiWakeContextSource } from "./appWakeContextSource.js";
+export const renderPiCoreSource = (options = {}) => String.raw `const createConfigModel = (agentConfig) => ({
+  provider: typeof agentConfig?.model?.provider === "string" ? agentConfig.model.provider : "openai-codex",
+  name: typeof agentConfig?.model?.name === "string" ? agentConfig.model.name : "gpt-5.4-mini"
+});
 
-    const key = decodeURIComponent(match[1]);
-    const agent = agentsByKey.get(key);
-    if (!agent) {
-      sendJson(response, 404, { error: "unknown agent " + key });
-      return;
-    }
+const normalizeWakeKind = (value) => {
+  return value === "manual" || value === "message" || value === "schedule" || value === "dream"
+    ? value
+    : "message";
+};
 
-    try {
-      const payload = await readRequestJson(request);
-      const eventId =
-        typeof payload.event_id === "string" ? payload.event_id :
-        typeof payload.context_id === "string" ? payload.context_id + ":" + Date.now() :
-        "moltnet-" + Date.now();
+${renderPiWakeContextSource()}
 
-      const message = await agent.wake({
-        id: eventId,
-        kind: "moltnet",
-        text: controlEventText(payload)
-      });
-
-      sendJson(response, 200, {
-        from: agent.config.id,
-        message
-      });
-    } catch (error) {
-      sendJson(response, 400, {
-        error: error instanceof Error ? error.message : String(error)
-      });
-    }
-  });
-
-  await new Promise((resolve, reject) => {
-    server.once("error", reject);
-    server.listen(port, "127.0.0.1", () => {
-      server.off("error", reject);
-      resolve();
-    });
-  });
-  console.log("[pi] control listening on 127.0.0.1:" + port);
-  return server;
-};
+${renderPiControlSource()}
 
 class PiManagedAgent {
   constructor(config, paths, services) {
     this.config = config;
     this.paths = paths;
     this.services = services;
+    this.engine = normalizeAgentEngineKind(config);
+    this.adapter = this.engine === "pi"
+      ? new PiHarnessAdapter({
+          authPath: path.join(paths.homePath, ".pi", "agent", "auth.json"),
+          modelsPath: path.join(paths.homePath, ".pi", "agent", "models.json"),
+          model: createConfigModel(config),
+          memory: createMemoryRuntimeOptions(config),
+          rawTrainingCapture: config.raw_training_capture,
+          thinkingLevel: config.thinking_level${options.world ? ",\n          world: config.world" : ""}
+        })
+      : null;
     this.running = false;
     this.queued = [];
   }
-
   async start() {
-    await mkdir(this.paths.workspacePath, { recursive: true });
-    await mkdir(this.paths.runtimeHomePath, { recursive: true });
-    const model = this.services.modelRegistry.find(this.config.model.provider, this.config.model.name);
-    if (!model) {
-      throw new Error("Pi model not found for " + this.config.id + ": " + this.config.model.provider + "/" + this.config.model.name);
+    if (this.engine === "pi") {
+      this.handle = await this.adapter.startAgent({
+        id: this.config.id,
+        name: this.config.name,
+        instructions: createAgentInstructions(this.config, this.paths.workspacePath),
+        runtimeHomePath: this.paths.runtimeHomePath,
+        tools: this.config.tools,
+        workspacePath: this.paths.workspacePath
+      });
+    } else {
+      this.handle = new CliEngineAgentHandle(this.config, this.paths);
     }
-
-    const loader = new DefaultResourceLoader({
-      agentDir: this.paths.runtimeHomePath,
-      additionalSkillPaths: [
-        path.join(this.paths.workspacePath, "skills"),
-        path.join(this.paths.workspacePath, ".agents", "skills"),
-        path.join(this.paths.workspacePath, ".codex", "skills")
-      ],
-      appendSystemPrompt: [createIdentityPrompt(this.config, this.paths.workspacePath)],
-      cwd: this.paths.workspacePath,
-      noExtensions: true
-    });
-    await loader.reload();
-
-    const { session } = await createAgentSession({
-      agentDir: this.paths.runtimeHomePath,
-      authStorage: this.services.authStorage,
-      cwd: this.paths.workspacePath,
-      model,
-      modelRegistry: this.services.modelRegistry,
-      resourceLoader: loader,
-      sessionManager: SessionManager.create(
-        this.paths.workspacePath,
-        path.join(this.paths.runtimeHomePath, "sessions")
-      ),
-      settingsManager: SettingsManager.inMemory({
-        compaction: { enabled: false },
-        retry: { enabled: true, maxRetries: 1 }
-      }),
-      thinkingLevel: "off",
-      tools: this.config.tools
-    });
-
-    this.session = session;
-    this.publish("agent.loaded");
+    this.publish("agent.loaded", { engine: this.engine });
+  }
+  listDreamEnvironmentKeys() {
+    return listDreamEnvironmentKeys(this.paths.workspacePath);
   }
-
   publish(type, fields = {}) {
     this.services.activity?.publish({
       type,
       agent_id: this.config.id,
       agent_name: this.config.name,
       agent_slug: this.config.slug,
+      engine: this.engine,
       ...fields
     });
   }
-
   async wake(event) {
+    const enriched = await enrichWakeContext(this.paths.workspacePath, event);
+    const messageFrom = asStringOrUndefined(enriched.messageFrom);
+    const isRoomWake = enriched.isRoomWake;
+    const deliveryFrom = asStringOrUndefined(event.delivery?.sender);
+    const from = deliveryFrom ?? (isRoomWake
+      ? "moltnet"
+      : (asStringOrUndefined(enriched.eventFrom) ?? messageFrom ?? "moltnet"));
+    const kind = normalizeWakeKind(event.kind);
+    const rawText = typeof event.text === "string" ? event.text : "";
+    const resolvedContext = enriched.context;
+    const context = asObject(resolvedContext) ? {
+      ...resolvedContext,
+      activeEnvironment: enriched.activeEnvironment,
+      active_environment: enriched.activeEnvironment
+    } : enriched.context;
+    const promptFrom = isRoomWake ? messageFrom : from;
+    const contextualText = kind === "message" || kind === "manual"
+      ? controlEventText({ ...event, message: rawText, from: promptFrom, activeEnvironment: enriched.activeEnvironment })
+      : [
+          rawText,
+          ...formatActiveEnvironmentBlock(enriched.activeEnvironment)
+        ].filter((line) => line.trim().length > 0).join("\n\n");
+
+    const enrichedEvent = {
+      ...event,
+      context,
+      from,
+      text: contextualText,
+    };
+
     return new Promise((resolve, reject) => {
-      this.queued.push({ event, reject, resolve });
+      this.queued.push({ event: enrichedEvent, reject, resolve });
       this.publish("agent.wake.queued", {
         queue_length: this.queued.length,
         wake_id: event.id,
-        wake_kind: event.kind
+        wake_kind: kind
       });
       void this.drainQueue();
     });
   }
-
   async drainQueue() {
     if (this.running) {
       return;
@@ -194,47 +122,36 @@ class PiManagedAgent {
       this.running = false;
     }
   }
-
   async runWake(event) {
     const startedAt = Date.now();
-    const chunks = [];
-    console.log("[pi:" + this.config.id + "] wake " + event.kind + " " + event.id);
     this.publish("agent.turn.started", {
       wake_id: event.id,
       wake_kind: event.kind
     });
-    const unsubscribe = this.session.subscribe((piEvent) => {
-      this.publish("agent.runtime.event", {
-        runtime_event_type: typeof piEvent.type === "string" ? piEvent.type : "unknown",
-        wake_id: event.id,
-        wake_kind: event.kind
-      });
-      if (piEvent.type === "turn_end") {
-        const text = textFromMessage(piEvent.message).trim();
-        if (text.length > 0) {
-          chunks.push(text);
-          this.publish("agent.output.completed", {
-            text,
-            wake_id: event.id,
-            wake_kind: event.kind
-          });
-        }
-      }
-    });
     try {
-      await this.session.prompt([
-        "Wake event: " + event.kind,
-        "Event id: " + event.id,
-        event.text
-      ].join("\n\n"), { expandPromptTemplates: false });
-      const finalText = collapseExactDouble(chunks.join("\n").trim());
-      console.log("[pi:" + this.config.id + "] completed " + event.id + " in " + (Date.now() - startedAt) + "ms");
+      const result = await this.handle.wake({
+        context: event.context,
+        context_id: event.context_id,
+        delivery: event.delivery,
+        id: event.id,
+        kind: event.kind,
+        from: event.from,
+        text: event.text,
+        transportText: event.transportText
+      });
+      const finalText = typeof result.text === "string" ? result.text.trim() : "";
+      console.log("[pi:" + this.config.id + "] " + finalText);
       if (finalText.length > 0) {
-        console.log("[pi:" + this.config.id + "] " + finalText);
+        this.publish("agent.output.completed", {
+          text: finalText,
+          wake_id: event.id,
+          wake_kind: event.kind
+        });
       }
       this.publish("agent.turn.completed", {
-        duration_ms: Date.now() - startedAt,
+        duration_ms: result.durationMs ?? (Date.now() - startedAt),
         output_length: finalText.length,
+        trace_path: turnTracePath(this.paths, event.id),
         wake_id: event.id,
         wake_kind: event.kind
       });
@@ -244,17 +161,15 @@ class PiManagedAgent {
       this.publish("agent.turn.failed", {
         duration_ms: Date.now() - startedAt,
         error: formatActivityError(error),
+        trace_path: turnTracePath(this.paths, event.id),
         wake_id: event.id,
         wake_kind: event.kind
       });
       throw error;
-    } finally {
-      unsubscribe();
     }
   }
-
   stop() {
-    this.session?.dispose();
+    this.handle?.stop();
     this.publish("agent.stopped");
   }
 }
@@ -264,20 +179,21 @@ const main = async () => {
   if (!configPath) {
     throw new Error("Usage: node app.mjs <pi-app.json>");
   }
+
   const config = await readJson(configPath);
   const instanceRoot = path.resolve(path.dirname(configPath), "..");
-  const homePath = path.join(instanceRoot, "home");
-  const authStorage = AuthStorage.create(path.join(homePath, ".pi", "agent", "auth.json"));
-  const modelRegistry = ModelRegistry.create(authStorage, path.join(homePath, ".pi", "agent", "models.json"));
-  const activity = createActivityBroker();
-  const services = { activity, authStorage, modelRegistry };
+  const activityLogPath = path.join(instanceRoot, "runtime", "activity.ndjson");
+  await mkdir(path.dirname(activityLogPath), { recursive: true });
+  const activity = createActivityBroker({ logPath: activityLogPath });
+  const services = { activity };
   const agents = [];
 
   for (const agentConfig of config.agents ?? []) {
     const managed = new PiManagedAgent(
-      agentConfig,
-      {
-        runtimeHomePath: path.join(instanceRoot, "runtime", "agents", agentConfig.slug),
+        agentConfig,
+        {
+          runtimeHomePath: path.join(instanceRoot, "runtime", "agents", agentConfig.slug),
+        homePath: path.join(instanceRoot, "home"),
         workspacePath: path.join(instanceRoot, "workspace", "agents", agentConfig.slug)
       },
       services
@@ -291,34 +207,8 @@ const main = async () => {
   const controlServer = runOnce
     ? null
     : await startControlServer(agents, process.env.SPAWNFILE_PI_CONTROL_PORT, configPath, instanceRoot, services);
-  let scheduledCount = 0;
-  for (const agent of agents) {
-    if (agent.config.schedule?.kind !== "every" || !agent.config.schedule.every) {
-      continue;
-    }
-    const intervalMs = parseEveryMs(agent.config.schedule.every);
-    const createEvent = () => ({
-      id: "schedule-" + agent.config.id + "-" + Date.now(),
-      kind: "schedule",
-      text: agent.config.schedule.prompt ?? "Run the scheduled Spawnfile task."
-    });
-    scheduledCount += 1;
-    if (runOnce) {
-      await agent.wake(createEvent());
-      continue;
-    }
-    const timer = setInterval(() => {
-      void agent.wake(createEvent()).catch((error) => {
-        console.error("[pi:" + agent.config.id + "] scheduled wake error: " + (error instanceof Error ? error.message : String(error)));
-      });
-    }, intervalMs);
-    timers.push(timer);
-    setTimeout(() => {
-      void agent.wake(createEvent()).catch((error) => {
-        console.error("[pi:" + agent.config.id + "] initial wake error: " + (error instanceof Error ? error.message : String(error)));
-      });
-    }, 100);
-  }
+
+  const scheduledCount = await installAgentSchedules(agents, timers, runOnce);
 
   if (runOnce) {
     if (scheduledCount === 0) {

package/dist/runtime/pi/appPreludeSource.js

@@ -1,62 +1,62 @@
-export const renderPiPreludeSource = () => String.raw `import path from "node:path";
+export const renderPiPreludeSource = () => String.raw `import { createHash } from "node:crypto";
+import path from "node:path";
+import { execFile, spawn } from "node:child_process";
+import { appendFileSync, closeSync, openSync } from "node:fs";
 import { createServer } from "node:http";
-import { mkdir, readFile } from "node:fs/promises";
-
-import { AuthStorage, createAgentSession, DefaultResourceLoader, ModelRegistry, SessionManager, SettingsManager } from "@earendil-works/pi-coding-agent";
+import { cp, mkdir, readFile, stat, unlink, writeFile } from "node:fs/promises";
+import { promisify } from "node:util";
+import { PiHarnessAdapter, stampTurnInputSubmitted, stampTurnOutputCompleted } from "@noopolis/daimon/pi";
+import { emitControlWakeAccepted, emitControlWakeDenied, emitDeliveryWakeAccepted } from "@noopolis/daimon/observability";
+import { installAgentSchedules } from "./schedule.mjs";
+import {
+  createOllamaEmbeddingProvider,
+  createMemoryRuntime,
+  readMemoryContext
+} from "@noopolis/mneme";
 
+const execFileAsync = promisify(execFile);
 const maxControlBodyBytes = 1 << 20;
 
 const readJson = async (filePath) => JSON.parse(await readFile(filePath, "utf8"));
 
-const collapseExactDouble = (text) => {
-  const trimmed = text.trim();
-  if (trimmed.length % 2 !== 0) {
-    return trimmed;
-  }
-  const midpoint = trimmed.length / 2;
-  const left = trimmed.slice(0, midpoint);
-  return left === trimmed.slice(midpoint) ? left.trim() : trimmed;
-};
+const createAgentInstructions = (agent, workspacePath) => [
+  agent.instructions,
+  "",
+  "Agent id: " + agent.id,
+  "Workspace path: " + workspacePath
+].join("\n");
 
-const textFromMessage = (message) => {
-  const content = message?.content;
-  if (typeof content === "string") {
-    return collapseExactDouble(content);
+const createMemoryEmbeddingProvider = (memory) => {
+  if (!memory?.embedding) {
+    return undefined;
   }
-  if (!Array.isArray(content)) {
-    return "";
+  if (memory.embedding.provider !== "ollama") {
+    throw new Error("Unsupported Daimon memory embedding provider: " + memory.embedding.provider);
   }
-  const textParts = content
-    .filter((item) => item?.type === "text" && typeof item.text === "string")
-    .map((item) => item.text)
-    .filter((text, index, parts) => index === 0 || text !== parts[index - 1]);
-  return collapseExactDouble(textParts.join(""));
+  return createOllamaEmbeddingProvider({
+    baseUrl: memory.embedding.base_url ?? process.env.MNEME_OLLAMA_BASE_URL ?? "http://127.0.0.1:11434",
+    dimensions: memory.embedding.dimensions,
+    model: memory.embedding.model,
+    timeoutMs: Number(process.env.MNEME_OLLAMA_TIMEOUT_MS ?? memory.embedding.timeout_ms ?? "10000")
+  });
 };
 
-const parseEveryMs = (value) => {
-  const match = /^(\d+(?:\.\d+)?)(ms|s|m|h|d)?$/u.exec(value.trim());
-  if (!match) {
-    throw new Error("Invalid Pi every schedule: " + value);
+const normalizeMemoryAgentId = (value) =>
+  typeof value === "string" ? value.replace(/^agent:/u, "") : value;
+
+const createMemoryRuntimeOptions = (agentConfig) => {
+  if (!agentConfig.memory) {
+    return undefined;
   }
-  const amount = Number(match[1]);
-  const unit = match[2] ?? "ms";
-  const multipliers = {
-    d: 24 * 60 * 60 * 1000,
-    h: 60 * 60 * 1000,
-    m: 60 * 1000,
-    ms: 1,
-    s: 1000
+  return {
+    agentId: normalizeMemoryAgentId(agentConfig.id),
+    runtimeHomePath: agentConfig.memory.runtime_home_path,
+    source: agentConfig.memory.source,
+    tokenBudget: agentConfig.memory.token_budget,
+    embeddingProvider: createMemoryEmbeddingProvider(agentConfig.memory)
   };
-  return Math.max(1, Math.round(amount * multipliers[unit]));
 };
 
-const createIdentityPrompt = (agent, workspacePath) => [
-  agent.instructions,
-  "",
-  "Agent id: " + agent.id,
-  "Workspace path: " + workspacePath
-].join("\n");
-
 const sendJson = (response, status, payload) => {
   const body = JSON.stringify(payload);
   response.writeHead(status, {
@@ -66,6 +66,64 @@ const sendJson = (response, status, payload) => {
   response.end(body);
 };
 
+const asText = (value) => (typeof value === "string" ? value.trim() : "");
+const asTextOrUndefined = (value) => {
+  const text = asText(value);
+  return text.length > 0 ? text : undefined;
+};
+const asScopeText = (value) => {
+  const scopeText = asTextOrUndefined(value);
+  if (scopeText) {
+    return scopeText;
+  }
+  const valueObject = typeof value === "object" && value !== null ? value : undefined;
+  const scope = asTextOrUndefined(valueObject?.scope);
+  const qualifier = asTextOrUndefined(valueObject?.qualifier);
+  return scope && qualifier ? scope + ":" + qualifier : undefined;
+};
+
+const formatActiveEnvironmentBlock = (activeEnvironment) => {
+  const lines = [
+    "Active environment context:"
+  ];
+
+  const network = asTextOrUndefined(activeEnvironment.networkId ?? activeEnvironment.network);
+  const surface = asTextOrUndefined(activeEnvironment.surface);
+  const room = asTextOrUndefined(activeEnvironment.roomId);
+  const thread = asTextOrUndefined(activeEnvironment.threadId);
+  const team = asTextOrUndefined(activeEnvironment.teamId ?? activeEnvironment.team);
+  const memberSlot = asTextOrUndefined(activeEnvironment.member_slot);
+  const contextKey = asTextOrUndefined(activeEnvironment.context_key);
+  const roster = asTextOrUndefined(activeEnvironment.roster);
+  const teamDoc = asTextOrUndefined(activeEnvironment.team_doc);
+  const sessionKey = asTextOrUndefined(activeEnvironment.session_key);
+
+  const teamScope = asScopeText(activeEnvironment.team_scope) ?? asScopeText(activeEnvironment.durable_scope);
+  const roomScope = asScopeText(activeEnvironment.room_scope) ?? asScopeText(activeEnvironment.ephemeral_scope);
+  const threadScope = asScopeText(activeEnvironment.thread_scope);
+  if (surface) lines.push("- surface: " + surface);
+  if (network) lines.push("- network: " + network);
+  if (room) lines.push("- room: " + room);
+  if (thread) lines.push("- thread: " + thread);
+  if (team) lines.push("- team: " + team);
+  if (contextKey) lines.push("- context_key: " + contextKey);
+  if (memberSlot) lines.push("- member slot: " + memberSlot);
+  if (teamDoc) lines.push("- team document: " + teamDoc);
+  if (roster) lines.push("- roster: " + roster);
+  if (teamScope) lines.push("- active team scope: " + teamScope);
+  if (roomScope) lines.push("- active room scope: " + roomScope);
+  if (threadScope) lines.push("- active thread scope: " + threadScope);
+  if (sessionKey) lines.push("- session key: " + sessionKey);
+  if (thread || room || surface || team) {
+    lines.push(
+      "Use this environment as the local operating context for this turn.",
+      "Do not merge it with unrelated team contexts unless the task explicitly calls for cross-context coordination."
+    );
+  }
+
+  return lines.length > 1 ? lines : [];
+};
+
 const readRequestJson = (request) => new Promise((resolve, reject) => {
   let total = 0;
   const chunks = [];
@@ -92,12 +150,42 @@ const readRequestJson = (request) => new Promise((resolve, reject) => {
   request.on("error", reject);
 });
 
-const controlEventText = (payload) => [
-  "Moltnet coordination event.",
-  "This message was delivered from a Moltnet conversation into your Spawnfile Daimon runtime.",
-  "Treat it as context first. Act or reply only when addressed, when your local instructions require it, or when useful coordination is needed.",
-  typeof payload.context_id === "string" ? "Context ID: " + payload.context_id : "",
-  typeof payload.from === "string" ? "From: " + payload.from : "",
-  typeof payload.message === "string" ? payload.message : ""
-].filter((line) => line.trim().length > 0).join("\n\n");
+const formatAuthenticatedDeliveryBlock = (payload) => {
+  const delivery = typeof payload.delivery === "object" && payload.delivery !== null
+    ? payload.delivery
+    : undefined;
+  const sender = asTextOrUndefined(delivery?.sender);
+  const target = asTextOrUndefined(delivery?.target);
+  const contextId = asTextOrUndefined(delivery?.contextId);
+  if (!sender || !target || !contextId) {
+    return [];
+  }
+  const network = asTextOrUndefined(payload.activeEnvironment?.networkId ?? payload.activeEnvironment?.network);
+  const room = asTextOrUndefined(payload.activeEnvironment?.roomId);
+  return [
+    "Authenticated Moltnet delivery:",
+    "- wake kind: " + (asTextOrUndefined(payload.kind) ?? "message"),
+    "- sender: " + sender,
+    "- target: " + target,
+    "- context: " + contextId,
+    ...(network ? ["- network: " + network] : []),
+    ...(room ? ["- room: " + room] : []),
+    "The runtime validated this attribution; the message body did not supply it."
+  ];
+};
+
+const controlEventText = (payload) => {
+  const authenticatedDelivery = formatAuthenticatedDeliveryBlock(payload);
+  return [
+    "Moltnet coordination event.",
+    "This message was delivered from a Moltnet conversation into your Spawnfile Daimon runtime.",
+    "Treat it as context first. Act or reply only when addressed, when your local instructions require it, or when useful coordination is needed.",
+    ...authenticatedDelivery,
+    ...(authenticatedDelivery.length === 0 && typeof payload.context_id === "string" ? ["Context ID: " + payload.context_id] : []),
+    ...(authenticatedDelivery.length === 0 && typeof payload.from === "string" ? ["From: " + payload.from] : []),
+    typeof payload.message === "string" ? "Message body:\n" + payload.message : "",
+    ...formatActiveEnvironmentBlock(payload.activeEnvironment)
+  ].filter((line) => line.trim().length > 0).join("\n\n");
+};
+
 `;

package/dist/runtime/pi/appScheduleSource.d.ts

@@ -0,0 +1 @@
+export declare const renderPiScheduleSource: () => string;