refactor: inline session runtime from playbooks into server

The playbook session-runtime adapter layer (createPlaybookSessionRuntime,
pickPlaybookAgent, PlaybookAgentIdentityMismatchError, and ~15 input/output
types) lived in @openagentpack/playbooks but had exactly one production
consumer: the server's playbook-session-adapter. This commit:

- Moves the runtime orchestration and agent-pick logic into a new
  apps/server/.../playbook-session-adapter/runtime.ts with all generic
  type parameters instantiated to their concrete server types.
- Replaces the four adapter interfaces with a single concrete
  PlaybookSessionRuntimeDeps type (dependency injection preserved for
  testability, but no cross-package abstraction).
- Migrates tests to apps/server with type-safe fake constructors.
- Removes session-runtime.ts from @openagentpack/playbooks and cleans
  up all re-exports from the package index.
- Eliminates the duplicate ListPlaybookSessionsInput definition in
  sessions.ts (now imported from runtime.ts).

Behavioral changes: none. The PlaybookAgentIdentityMismatchError still
surfaces as HTTP 500 (no route-level catch); a future PR can map it to
4xx if desired.

Change-Id: Ia4276ea3626877163f60529342e7da1ba3a991bd
Co-developed-by: OpenCode <noreply@opencode.ai>

Author: heimanba

apps/server/src/services/sessions/playbook-session-adapter/index.ts

@@ -1,22 +1,15 @@
-import {
-	createPlaybookSessionRuntime,
-	getPlaybookAppId,
-	getSeedPlaybookAgentName,
-	PLAYBOOK_AGENT_NAME_PREFIX,
-	type RemotePlaybookAgent,
-} from "@openagentpack/playbooks";
+import { getPlaybookAppId, getSeedPlaybookAgentName, PLAYBOOK_AGENT_NAME_PREFIX } from "@openagentpack/playbooks";
 import {
 	type CloudAgent,
 	listCloudAgents,
-	type ProviderSessionEvent,
 	readProjectRuntime,
 	resolveSessionProvider,
-	type Session,
 	startSessionRun,
 } from "@openagentpack/sdk";
 import { loadAgentRuntimeInput, withAgentRuntime } from "@/services/runtime-factory";
 import { agentMetadataOf } from "./dto";
 import { ensureAgentApplied } from "./provision";
+import { createPlaybookSessionRuntime, type RemotePlaybookAgent } from "./runtime";
 import {
 	attachLiveStream,
 	deletePlaybookSession,
@@ -29,7 +22,7 @@ import {
 export type { PlaybookSessionDetail } from "./sessions";
 
 export function createServerPlaybookSessionRuntime() {
-	return createPlaybookSessionRuntime<PlaybookSessionDetail, ProviderSessionEvent, Session, RemotePlaybookAgent>({
+	return createPlaybookSessionRuntime({
 		identity: {
 			appId: getPlaybookAppId(),
 			expectedAgentName: getSeedPlaybookAgentName,
@@ -87,12 +80,10 @@ export function createServerPlaybookSessionRuntime() {
 		onDuplicateAgent({ playbookId, winner, duplicates }) {
 			const all = [winner, ...duplicates];
 			console.warn(
-				`玩法「${playbookId}」匹配到 ${all.length} 个 active playbook Agent(${all
+				`\u73A9\u6CD5\u300C${playbookId}\u300D\u5339\u914D\u5230 ${all.length} \u4E2A active playbook Agent(${all
 					.map((agent) => agent.id)
-					.join(", ")});取最近更新的 ${winner.id}。`,
+					.join(", ")})\uFF1B\u53D6\u6700\u8FD1\u66F4\u65B0\u7684 ${winner.id}\u3002`,
 			);
 		},
 	});
 }
-
-type PlaybookSessionDetail = import("./sessions").PlaybookSessionDetail;

apps/server/src/services/sessions/playbook-session-adapter/provision.ts

@@ -1,4 +1,3 @@
-import type { RemotePlaybookAgent } from "@openagentpack/playbooks";
 import type { CloudAgent } from "@openagentpack/sdk";
 import {
 	importResource,
@@ -9,6 +8,7 @@ import {
 	writeProjectRuntime,
 } from "@openagentpack/sdk";
 import { loadAgentRuntimeInput } from "@/services/runtime-factory";
+import type { RemotePlaybookAgent } from "./runtime";
 
 /**
  * Ensure a compiled catalog agent is provisioned to its provider (has a remote_id in state).

…/playbooks/tests/session-runtime.test.ts …playbook-session-adapter/runtime.test.tspackages/playbooks/tests/session-runtime.test.ts renamed to apps/server/src/services/sessions/playbook-session-adapter/runtime.test.ts packages/playbooks/tests/session-runtime.test.ts renamed to apps/server/src/services/sessions/playbook-session-adapter/runtime.test.ts

@@ -1,19 +1,20 @@
 import { describe, expect, test } from "bun:test";
+import { PLAYBOOK_APP_METADATA_KEY, PLAYBOOK_METADATA_KEY } from "@openagentpack/playbooks";
+import type { ProviderSessionEvent, Session } from "@openagentpack/sdk";
 import {
 	createPlaybookSessionRuntime,
-	PLAYBOOK_APP_METADATA_KEY,
-	PLAYBOOK_METADATA_KEY,
 	PlaybookAgentIdentityMismatchError,
 	pickPlaybookAgent,
 	type RemotePlaybookAgent,
-} from "../src/index.ts";
+} from "./runtime";
+import type { PlaybookSessionDetail } from "./sessions";
 
 const APP_ID = "agents-webui";
 
 function agent(overrides: Partial<RemotePlaybookAgent> = {}): RemotePlaybookAgent {
 	return {
 		id: "agent_1",
-		name: "Agents/设计师助手",
+		name: "Agents/\u8BBE\u8BA1\u5E08\u52A9\u624B",
 		metadata: {
 			[PLAYBOOK_APP_METADATA_KEY]: APP_ID,
 			[PLAYBOOK_METADATA_KEY]: "designer",
@@ -23,6 +24,22 @@ function agent(overrides: Partial<RemotePlaybookAgent> = {}): RemotePlaybookAgen
 	};
 }
 
+function fakeEvent(raw_type = "created"): ProviderSessionEvent {
+	return { type: "status", raw_type, raw: {} };
+}
+
+function fakeSession(id: string, agentId?: string): Session {
+	return {
+		session_id: id,
+		status: "running",
+		agent: agentId ? { agent_id: agentId } : undefined,
+	};
+}
+
+function fakeDetail(sessionId: string, agentId?: string): PlaybookSessionDetail {
+	return { session: fakeSession(sessionId, agentId), events: [] };
+}
+
 describe("pickPlaybookAgent", () => {
 	test("picks the current-app playbook stamp by newest update time", () => {
 		const older = agent({ id: "agent_old", updatedAt: "2026-06-20T00:00:00.000Z" });
@@ -43,7 +60,7 @@ describe("pickPlaybookAgent", () => {
 					metadata: { [PLAYBOOK_APP_METADATA_KEY]: APP_ID },
 				}),
 			],
-			{ playbookId: "designer", appId: APP_ID, expectedAgentName: "Agents/设计师助手" },
+			{ playbookId: "designer", appId: APP_ID, expectedAgentName: "Agents/\u8BBE\u8BA1\u5E08\u52A9\u624B" },
 		);
 
 		expect(pick.agent).toBeUndefined();
@@ -64,10 +81,10 @@ describe("createPlaybookSessionRuntime", () => {
 	test("start ensures the selected agent, starts the provider session, attaches events, then returns detail", async () => {
 		const calls: string[] = [];
 		const liveEvents = (async function* () {
-			yield { type: "created" };
+			yield fakeEvent();
 		})();
 		const runtime = createPlaybookSessionRuntime({
-			identity: { appId: APP_ID, expectedAgentName: () => "Agents/设计师助手" },
+			identity: { appId: APP_ID, expectedAgentName: () => "Agents/\u8BBE\u8BA1\u5E08\u52A9\u624B" },
 			agents: {
 				async listPlaybookAgents() {
 					calls.push("agents.list");
@@ -94,7 +111,7 @@ describe("createPlaybookSessionRuntime", () => {
 				},
 				async getDetail(input) {
 					calls.push(`sessions.detail:${input.sessionId}:${input.remoteAgentId}`);
-					return { sessionId: input.sessionId, agentId: input.remoteAgentId };
+					return fakeDetail(input.sessionId, input.remoteAgentId);
 				},
 			},
 			events: {
@@ -114,7 +131,8 @@ describe("createPlaybookSessionRuntime", () => {
 			model: "glm-5.1",
 		});
 
-		expect(detail).toEqual({ sessionId: "sess_1", agentId: "agent_existing" });
+		expect(detail.session.session_id).toBe("sess_1");
+		expect(detail.session.agent?.agent_id).toBe("agent_existing");
 		expect(calls).toEqual([
 			"agents.list",
 			"agents.ensure:agent_existing:glm-5.1",
@@ -126,7 +144,7 @@ describe("createPlaybookSessionRuntime", () => {
 
 	test("start throws before ensuring when identity is blocked", async () => {
 		const runtime = createPlaybookSessionRuntime({
-			identity: { appId: APP_ID, expectedAgentName: () => "Agents/设计师助手" },
+			identity: { appId: APP_ID, expectedAgentName: () => "Agents/\u8BBE\u8BA1\u5E08\u52A9\u624B" },
 			agents: {
 				async listPlaybookAgents() {
 					return [agent({ metadata: { [PLAYBOOK_APP_METADATA_KEY]: APP_ID } })];
@@ -162,7 +180,7 @@ describe("createPlaybookSessionRuntime", () => {
 	test("send appends a message, attaches events, then returns detail", async () => {
 		const calls: string[] = [];
 		const liveEvents = (async function* () {
-			yield { type: "message" };
+			yield fakeEvent("message");
 		})();
 		const runtime = createPlaybookSessionRuntime({
 			identity: { appId: APP_ID },
@@ -190,7 +208,7 @@ describe("createPlaybookSessionRuntime", () => {
 				},
 				async getDetail(input) {
 					calls.push(`sessions.detail:${input.sessionId}:${input.playbookId}`);
-					return { sessionId: input.sessionId, playbookId: input.playbookId };
+					return fakeDetail(input.sessionId);
 				},
 			},
 			events: {
@@ -205,7 +223,7 @@ describe("createPlaybookSessionRuntime", () => {
 
 		const detail = await runtime.send({ playbookId: "designer", sessionId: "sess_1", message: "continue" });
 
-		expect(detail).toEqual({ sessionId: "sess_1", playbookId: "designer" });
+		expect(detail.session.session_id).toBe("sess_1");
 		expect(calls).toEqual([
 			"sessions.send:sess_1:designer:continue",
 			"events.attach:sess_1",
@@ -228,7 +246,7 @@ describe("createPlaybookSessionRuntime", () => {
 			sessions: {
 				async list(input) {
 					calls.push(`sessions.list:${input.playbookId}:${input.remoteAgentId}:${input.limit}:${input.pageToken}`);
-					return { sessions: [{ id: "sess_1" }], nextPageToken: "next" };
+					return { sessions: [fakeSession("sess_1")], nextPageToken: "next" };
 				},
 				async start() {
 					throw new Error("should not start");
@@ -252,7 +270,8 @@ describe("createPlaybookSessionRuntime", () => {
 			pageToken: "page_1",
 		});
 
-		expect(listed).toEqual({ sessions: [{ id: "sess_1" }], nextPageToken: "next" });
+		expect(listed.sessions[0]?.session_id).toBe("sess_1");
+		expect(listed.nextPageToken).toBe("next");
 		expect(calls).toEqual(["sessions.list:designer:agent_1:10:page_1"]);
 	});
 
@@ -283,14 +302,14 @@ describe("createPlaybookSessionRuntime", () => {
 				},
 				async getDetail(input) {
 					calls.push(`sessions.detail:${input.sessionId}:${input.playbookId}`);
-					return { sessionId: input.sessionId, playbookId: input.playbookId };
+					return fakeDetail(input.sessionId);
 				},
 			},
 		});
 
 		const detail = await runtime.getDetail({ playbookId: "designer", sessionId: "sess_1" });
 
-		expect(detail).toEqual({ sessionId: "sess_1", playbookId: "designer" });
+		expect(detail.session.session_id).toBe("sess_1");
 		expect(calls).toEqual(["sessions.detail:sess_1:designer"]);
 	});