paseo-room 0.1.0 → 0.2.0

package/dist/plugin-assets/index.server.ts

@@ -0,0 +1,50 @@
+/**
+ * Room contract carrier for Claude seats, as a Paseo v0.8 server plugin.
+ *
+ * Paseo launches Claude through the Claude Agent SDK, so no provider-owned argv can carry an
+ * additive system prompt (see docs/design.md §6). `AgentSessionConfig.systemPrompt` is the one
+ * strong additive channel, and it exists only at creation time — which is exactly what the
+ * `agent.create` before-hook can change. Paseo's Claude provider maps that value to the SDK's
+ * `{ type: "preset", preset: "claude_code", append }`, so the vendor prompt is kept and the
+ * room contract is appended to it.
+ *
+ * Deliberately dependency-free: the daemon compiles this directory as-is, so it imports no SDK
+ * and no package. The types below describe only the fields this hook reads or writes.
+ */
+import { composeSystemPrompt, hasExactContract } from './server/carrier.js';
+import { CONTRACT, GENERATION } from './server/contract.js';
+
+export interface RoomAgentCreateRequest {
+  readonly config: {
+    readonly provider: string;
+    readonly systemPrompt?: string;
+    readonly internal?: boolean;
+  };
+}
+
+interface RoomServerContext {
+  before(
+    name: 'agent.create',
+    handler: (input: { readonly request: RoomAgentCreateRequest }) => RoomAgentCreateRequest | undefined,
+  ): () => void;
+}
+
+export function transformAgentCreate(
+  request: RoomAgentCreateRequest,
+  contracts: Readonly<Record<string, string>> = CONTRACT,
+  generation = GENERATION,
+): RoomAgentCreateRequest | undefined {
+  // Internal agents are Paseo's own ephemeral system tasks: they are not room seats.
+  if (request.config.internal === true) return undefined;
+  // Exact room provider ids only. An operator's own Claude provider is never touched.
+  const contract = Object.entries(contracts).find(([id]) => id === request.config.provider)?.[1];
+  if (contract === undefined) return undefined;
+  if (hasExactContract(request.config.systemPrompt, contract, generation)) return undefined;
+  const systemPrompt = composeSystemPrompt(request.config.systemPrompt, contract, generation);
+  return { ...request, config: { ...request.config, systemPrompt } };
+}
+
+export default function contribute(server: RoomServerContext): () => void {
+  const dispose = server.before('agent.create', ({ request }) => transformAgentCreate(request));
+  return () => { dispose(); };
+}

package/dist/plugin-assets/package.json

@@ -0,0 +1,5 @@
+{
+  "name": "paseo-room-claude-carrier",
+  "private": true,
+  "type": "module"
+}

package/dist/plugin-assets/paseo-plugin.json

@@ -0,0 +1,5 @@
+{
+  "id": "paseo-room-claude-carrier",
+  "description": "Adds paseo-room role contracts to Claude's creation-time system prompt.",
+  "requirements": { "paseo": ">=0.8.0 <0.9.0" }
+}

package/dist/plugin-assets/server/carrier.ts

@@ -0,0 +1,41 @@
+/**
+ * Composition rule for the room's Claude creation-time contract carrier.
+ *
+ * Kept free of every import — including the plugin SDK — so the daemon's plugin compiler
+ * needs no installed dependency inside the room plugin directory, and so this repository can
+ * unit-test the rule directly.
+ */
+
+/** Opens the room-owned block, so an already-carried prompt is recognisable without parsing. */
+export const CONTRACT_MARKER_PREFIX = '<!-- paseo-room-contract:';
+
+export function contractMarker(generation: string): string {
+  return `${CONTRACT_MARKER_PREFIX}${generation} -->`;
+}
+
+/** True only when the prompt ends with the complete current room-owned block. */
+export function hasExactContract(
+  existing: string | undefined,
+  contract: string,
+  generation: string,
+): boolean {
+  return existing?.endsWith(`${contractMarker(generation)}\n${contract}`) === true;
+}
+
+/**
+ * Appends the role contract to whatever prompt the caller already asked for, rather than
+ * replacing it. The room block is always last and always marked, so a prompt that already
+ * carries one is rewritten in place instead of gaining a second copy.
+ */
+export function composeSystemPrompt(
+  existing: string | undefined,
+  contract: string,
+  generation: string,
+): string {
+  const raw = existing ?? '';
+  const marker = CONTRACT_MARKER_PREFIX;
+  const index = raw.indexOf(marker);
+  const base = (index === -1 ? raw : raw.slice(0, index)).trimEnd();
+  const block = `${contractMarker(generation)}\n${contract}`;
+  return base ? `${base}\n\n${block}` : block;
+}

package/dist/plugin-assets/server/contract.ts

@@ -0,0 +1,3 @@
+/** Replaced by paseo-room setup with the selected Claude seats' rendered contracts. */
+export const GENERATION = 'unconfigured';
+export const CONTRACT: Readonly<Record<string, string>> = {};

package/dist/plugin-assets/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "noEmit": true
+  },
+  "include": ["index.server.ts", "server/**/*.ts"]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paseo-room",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "One CLI that configures Codex, Claude Code, and Pi role homes in $HOME and registers them with your local Paseo daemon.",
   "keywords": [
     "paseo",
@@ -34,7 +34,7 @@
     "lint": "eslint . --max-warnings 0",
     "test": "vitest run",
     "test:package": "vitest run --config vitest.package.config.ts",
-    "build": "tsup && node --input-type=module -e \"import { cpSync, rmSync } from 'node:fs'; rmSync('dist/prompts', { recursive: true, force: true }); cpSync('src/room/prompts', 'dist/prompts', { recursive: true });\"",
+    "build": "tsup && node --input-type=module -e \"import { cpSync, rmSync } from 'node:fs'; for (const [source, target] of [['src/room/prompts', 'dist/prompts'], ['src/plugin-assets', 'dist/plugin-assets']]) { rmSync(target, { recursive: true, force: true }); cpSync(source, target, { recursive: true }); }\"",
     "prepack": "npm run build",
     "verify": "npm run typecheck && npm run lint && npm test && npm run build && npm run test:package"
   },