@crouton-kit/crouter 0.3.24 → 0.3.26

package/dist/index.d.ts

@@ -1 +1,19 @@
-export {};
+export { spawnChild } from './core/runtime/spawn.js';
+export type { SpawnChildOpts, SpawnChildResult } from './core/runtime/spawn.js';
+export { reviveNode } from './core/runtime/revive.js';
+export type { ReviveResult } from './core/runtime/revive.js';
+export { closeNode } from './core/runtime/close.js';
+export type { CloseNodeResult } from './core/runtime/close.js';
+export { appendInbox } from './core/feed/inbox.js';
+export type { InboxEntry, InboxTier, InboxKind } from './core/feed/inbox.js';
+export { getNode, listNodes } from './core/canvas/canvas.js';
+export { nodeDir } from './core/canvas/paths.js';
+export type { NodeMeta, NodeRow, NodeStatus, Lifecycle, Mode, } from './core/canvas/types.js';
+export { asksForNodes, asksAcrossCanvas } from './core/canvas/attention.js';
+export type { AskEntry } from './core/canvas/attention.js';
+export { readTelemetry, readContextTokens } from './core/canvas/telemetry.js';
+export type { Telemetry } from './core/canvas/telemetry.js';
+export { ViewSocketClient, BrokerUnavailableError } from './clients/attach/view-socket.js';
+export { encodeFrame, FrameDecoder, FrameOverflowError, CLIENT_READ_CAPS, BROKER_READ_CAPS, } from './core/runtime/broker-protocol.js';
+export type { FrameDecoderCaps, BrokerSnapshot, ClientRole, WelcomeFrame, ControlChangedFrame, AckFrame, ErrorFrame, ExtensionUIRequestFrame, BrokerToClient, HelloFrame, PromptFrame, SteerFrame, FollowUpFrame, AbortFrame, RequestControlFrame, ReleaseControlFrame, ByeFrame, ShutdownFrame, SetModelFrame, CycleModelFrame, SetThinkingLevelFrame, SetAutoRetryFrame, SetAutoCompactionFrame, CompactFrame, NewSessionFrame, SwitchSessionFrame, ForkFrame, SetSessionNameFrame, GetCommandsFrame, NavigateTreeFrame, ReloadFrame, ExportFrame, ClientToBroker, RpcExtensionUIRequest, RpcExtensionUIResponse, ExtensionUIResponseFrame, } from './core/runtime/broker-protocol.js';
+export type { SessionStats } from '@earendil-works/pi-coding-agent';

package/dist/index.js

@@ -1 +1,26 @@
-export {};
+// @crouton-kit/crouter — the sanctioned library surface (design D1).
+//
+// This barrel is the ONLY supported way to import crouter as a library; the
+// `exports` map gates off deep subpath imports, so consumers (notably
+// @crouton-kit/crouter-web) depend on exactly the symbols re-exported here.
+// Everything below is a stable, server-facing surface: runtime control that
+// keeps the canvas-row ⇄ pi-session lockstep guarantees, read-only canvas/
+// telemetry queries, and the broker socket client + wire protocol. Nothing
+// internal (CLI plumbing, helpers) is exported. This module has no load-time
+// side effects and no circular imports — keep it that way.
+// ── Runtime control ──────────────────────────────────────────────────────
+// Sanctioned launchers/mutators. reviveNode is the ONLY sanctioned launcher of
+// `pi --session`; spawnChild's host is chosen via `hostKind: 'tmux' | 'broker'`.
+export { spawnChild } from './core/runtime/spawn.js';
+export { reviveNode } from './core/runtime/revive.js';
+export { closeNode } from './core/runtime/close.js';
+export { appendInbox } from './core/feed/inbox.js';
+// ── Canvas reads ─────────────────────────────────────────────────────────
+export { getNode, listNodes } from './core/canvas/canvas.js';
+export { nodeDir } from './core/canvas/paths.js';
+export { asksForNodes, asksAcrossCanvas } from './core/canvas/attention.js';
+export { readTelemetry, readContextTokens } from './core/canvas/telemetry.js';
+// ── Broker client ────────────────────────────────────────────────────────
+export { ViewSocketClient, BrokerUnavailableError } from './clients/attach/view-socket.js';
+// ── Broker wire protocol (codec + frame/protocol types) ──────────────────
+export { encodeFrame, FrameDecoder, FrameOverflowError, CLIENT_READ_CAPS, BROKER_READ_CAPS, } from './core/runtime/broker-protocol.js';

package/dist/pi-extensions/canvas-context-intro.js

@@ -15,11 +15,11 @@
 //
 // The block carries: the path to the node's own context dir and the framing for
 // what belongs there (a shared document store for the other nodes). EVERY node
-// also gets a `## References` block rendered from the document substrate —
+// also gets a `<references>` block rendered from the document substrate —
 // eligible `reference` docs at their system-prompt visibility rung, plus the
 // node's own node-local substrate docs — so the bearings name what to read on
-// demand. (Skills and preferences surface as their own `## Skills` /
-// `## Preferences` sections of the system prompt, not in this block.) An
+// demand. (Skills and preferences surface as their own `<skills>` /
+// `<preferences>` blocks of the system prompt, not in this block.) An
 // orchestrator additionally gets the across-refresh-cycles framing (the one
 // thing a terminal worker's bearings drop). The prose lives in
 // core/runtime/bearings.ts (shared with the promotion guidance dump).

package/dist/pi-extensions/canvas-doc-substrate.js

@@ -9,8 +9,9 @@
 // It owns the substrate's two new pi hooks:
 //
 //   1. before_agent_start — the BOOT system-prompt half. Splices the rendered
-//      `## Skills` + `## Preferences` sections into `event.systemPrompt`, right
-//      after pi's native "Available tools" list (before the `\n\nGuidelines:`
+//      `<skills>` + `<preferences>` + `<memory-guidance>` blocks into
+//      `event.systemPrompt`, right after pi's native "Available tools" list
+//      (before the `\n\nGuidelines:`
 //      anchor), so the substrate's skills/preferences sit in the tool-selection
 //      frame the agent reads while choosing a capability — mirroring the
 //      personal crouter-help.ts anchor logic. Falls back to appending when the
@@ -33,7 +34,7 @@
 // with no dep on the pi packages. Mirrors canvas-context-intro.ts.
 import { homedir } from 'node:os';
 import { join, resolve } from 'node:path';
-import { renderOnReadDocs, renderPreferencesSection, renderSkillsSection, } from '../core/substrate/index.js';
+import { renderMemoryGuidance, renderOnReadDocs, renderPreferencesSection, renderSkillsSection, } from '../core/substrate/index.js';
 import { clearSessionCache } from '../core/substrate/session-cache.js';
 // ---------------------------------------------------------------------------
 // Extension
@@ -64,10 +65,17 @@ export function registerCanvasDocSubstrate(pi) {
         injectedDocs.clear();
         clearSessionCache();
     });
-    // 1. BOOT system-prompt half — splice `## Skills` + `## Preferences`.
+    // 1. BOOT system-prompt half — splice `<skills>` + `<preferences>` +
+    //    `<memory-guidance>`. The guidance block is always present for a canvas
+    //    node (the memory system always exists), so the splice is never empty even
+    //    when both trees are.
     pi.on('before_agent_start', (event) => {
         try {
-            const sections = [renderSkillsSection(nodeId), renderPreferencesSection(nodeId)].filter((s) => s !== '');
+            const sections = [
+                renderSkillsSection(nodeId),
+                renderPreferencesSection(nodeId),
+                renderMemoryGuidance(),
+            ].filter((s) => s !== '');
             if (sections.length === 0)
                 return; // nothing eligible — leave the prompt untouched
             const block = sections.join('\n\n');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crouton-kit/crouter",
-  "version": "0.3.24",
+  "version": "0.3.26",
   "description": "crtr — fast access to skills, plugins, and marketplaces",
   "type": "module",
   "main": "dist/index.js",