@openagentpack/playground 0.1.0 → 0.2.0-beta-ddef91c-20260720

package/dist/bin/playground.js

@@ -3,7 +3,7 @@
 // src/server.ts
 import "@hono/zod-openapi";
 import { readFileSync } from "fs";
-import { dirname as dirname2, join } from "path";
+import { dirname as dirname3, join as join2 } from "path";
 import { fileURLToPath } from "url";
 import { serve } from "@hono/node-server";
 import { serveStatic } from "@hono/node-server/serve-static";
@@ -1052,109 +1052,6 @@ function localizedDescription(template) {
   return names.zh ?? names.en ?? Object.values(names)[0] ?? template.id;
 }
 
-// ../playbooks/src/session-runtime.ts
-function playbookIdentityMismatchMessage(playbookId) {
-  return `\u73A9\u6CD5\u300C${playbookId}\u300D\u5B58\u5728\u540C\u5E94\u7528\u540C\u540D Agent\uFF0C\u4F46 metadata.${PLAYBOOK_APP_METADATA_KEY}/${PLAYBOOK_METADATA_KEY} \u672A\u5BF9\u4E0A\uFF0C\u7591\u4F3C\u8EAB\u4EFD\u672A\u76D6\u7AE0\uFF1B\u8BF7\u68C0\u67E5\u914D\u7F6E\u800C\u975E\u91CD\u590D\u521B\u5EFA\u3002`;
-}
-var PlaybookAgentIdentityMismatchError = class extends Error {
-  constructor(playbookId) {
-    super(playbookIdentityMismatchMessage(playbookId));
-    this.name = "PlaybookAgentIdentityMismatchError";
-  }
-};
-function pickPlaybookAgent(agents, input) {
-  const matched = agents.filter(
-    (agent2) => (input.includeArchived || !isArchived(agent2)) && agent2.metadata?.[PLAYBOOK_APP_METADATA_KEY] === input.appId && agent2.metadata?.[PLAYBOOK_METADATA_KEY] === input.playbookId
-  );
-  if (matched.length <= 1) {
-    return {
-      agent: matched[0],
-      duplicates: [],
-      identityMismatch: matched.length === 0 && hasSameNameCurrentAppAgent(agents, input)
-    };
-  }
-  const sorted = [...matched].sort((a, b) => epochOf(updatedAtOf(b)) - epochOf(updatedAtOf(a)));
-  const [agent, ...duplicates] = sorted;
-  return { agent, duplicates, identityMismatch: false };
-}
-function createPlaybookSessionRuntime(adapters) {
-  async function findAgent(playbookId) {
-    const [agents, expectedAgentName] = await Promise.all([
-      adapters.agents.listPlaybookAgents({ playbookId, includeArchived: false }),
-      adapters.identity.expectedAgentName?.(playbookId)
-    ]);
-    return pickPlaybookAgent(agents, {
-      playbookId,
-      appId: adapters.identity.appId,
-      expectedAgentName
-    });
-  }
-  return {
-    async list(input) {
-      return adapters.sessions.list(input);
-    },
-    async getDetail(input) {
-      return adapters.sessions.getDetail(input);
-    },
-    async start(input) {
-      const pick = await findAgent(input.playbookId);
-      if (pick.identityMismatch) throw new PlaybookAgentIdentityMismatchError(input.playbookId);
-      if (pick.agent && pick.duplicates.length) {
-        adapters.onDuplicateAgent?.({ playbookId: input.playbookId, winner: pick.agent, duplicates: pick.duplicates });
-      }
-      const agent = await adapters.agents.ensurePlaybookAgent({
-        playbookId: input.playbookId,
-        model: input.model,
-        matched: pick.agent
-      });
-      const started = await adapters.sessions.start({ ...input, remoteAgentId: agent.id });
-      if (started.events) {
-        adapters.events?.attachLiveStream(started.sessionId, started.events, started.completedEvents);
-      } else if (started.completedEvents?.length) {
-        adapters.events?.seedCompleted(started.sessionId, started.completedEvents);
-      }
-      return adapters.sessions.getDetail({
-        sessionId: started.sessionId,
-        playbookId: input.playbookId,
-        remoteAgentId: agent.id
-      });
-    },
-    async send(input) {
-      const sent = await adapters.sessions.send(input);
-      if (sent.events) {
-        adapters.events?.attachLiveStream(sent.sessionId, sent.events, sent.completedEvents);
-      } else if (sent.completedEvents?.length) {
-        adapters.events?.seedCompleted(sent.sessionId, sent.completedEvents);
-      }
-      return adapters.sessions.getDetail({
-        sessionId: sent.sessionId,
-        playbookId: input.playbookId
-      });
-    },
-    async delete(input) {
-      await adapters.sessions.delete(input);
-    }
-  };
-}
-function hasSameNameCurrentAppAgent(agents, input) {
-  if (!input.expectedAgentName) return false;
-  return agents.some(
-    (agent) => !isArchived(agent) && agent.metadata?.[PLAYBOOK_APP_METADATA_KEY] === input.appId && agent.name === input.expectedAgentName
-  );
-}
-function isArchived(agent) {
-  return agent.archivedAt != null || agent.archived_at != null;
-}
-function updatedAtOf(agent) {
-  return agent.updatedAt ?? agent.updated_at;
-}
-function epochOf(value) {
-  if (value == null) return 0;
-  if (typeof value === "number") return value;
-  const parsed = Date.parse(value);
-  return Number.isNaN(parsed) ? 0 : parsed;
-}
-
 // ../playbooks/src/index.ts
 var PLAYBOOK_SOURCES = {
   bailian: bailian_default,
@@ -1314,7 +1211,7 @@ function compileAgentRuntime(playbookId, baseConfig, modelOverride) {
   const config = cloneConfig(baseConfig);
   const resolved = resolveSeedPlaybook(effectiveId, provider);
   const runtimeAgentId = resolved.agent.name;
-  const built = buildAgentDecl(void 0, toAgentBuildInput(resolved, provider, modelOverride));
+  const built = buildAgentDecl(void 0, toAgentBuildInput(resolved, provider, baseConfig, modelOverride));
   config.agents = {
     ...config.agents ?? {},
     [runtimeAgentId]: built.agent
@@ -1373,12 +1270,32 @@ function validateAgent(playbookId, _config) {
 function computeAgentConfigHash(config, agentId) {
   return createHash("sha256").update(stableStringify({ agentId, config })).digest("hex").slice(0, 16);
 }
-function toAgentBuildInput(resolved, provider, modelOverride) {
+function toAgentBuildInput(resolved, provider, baseConfig, modelOverride) {
   const model = resolvePlaybookModel(resolved, provider, modelOverride);
+  const envKeys = Object.keys(baseConfig.environments ?? {});
+  if (envKeys.length !== 1) {
+    throw new Error(
+      `Expected exactly 1 environment in runtime config, got ${envKeys.length}. The agent compile path assumes a single base environment per provider.`
+    );
+  }
+  const environmentName = envKeys[0];
+  const vaultProfile = getVaultProfile(provider);
+  let vaultName;
+  if (vaultProfile) {
+    const vaultKeys = Object.keys(baseConfig.vaults ?? {});
+    if (vaultKeys.length !== 1) {
+      throw new Error(
+        `Expected exactly 1 vault in runtime config for provider '${provider}', got ${vaultKeys.length}. The agent compile path assumes a single base vault per provider.`
+      );
+    }
+    vaultName = vaultKeys[0];
+  }
   return {
     description: resolved.agent.description,
     model,
     instructions: resolved.agent.system,
+    environment: environmentName,
+    vault: vaultName,
     provider,
     builtinTools: resolved.agent.builtinTools,
     skills: resolved.agent.skills.map(
@@ -1458,13 +1375,15 @@ async function buildRuntimeConfig() {
         // Secret value is injected from env here — never stored in playbooks.
         secret_value: requireEnv(cred.secret_name),
         ...cred.networking ? { networking: cred.networking } : {}
-      }))
+      })),
+      metadata: { "agents.vault": "true" }
     }
   } : {};
   const environments = {
     [environment.name]: {
       ...environment.description ? { description: environment.description } : {},
-      config: environment.config
+      config: environment.config,
+      metadata: { "agents.base": "true" }
     }
   };
   const rawConfig = {
@@ -1489,12 +1408,47 @@ function requireEnv(name) {
 }
 
 // ../../apps/server/src/lib/state-scope.ts
-import { resolve } from "path";
+import { copyFileSync, existsSync, mkdirSync, renameSync } from "fs";
+import { homedir } from "os";
+import { dirname, join, resolve } from "path";
 import { LocalFileStateBackend } from "@openagentpack/sdk";
-var DEFAULT_STATE_PATH = "examples/bailian/bailian-cli/agents.state.json";
+var DEFAULT_STATE_PATH = join(homedir(), ".agents", "playground.state.json");
+var LEGACY_STATE_PATH = "examples/bailian/bailian-cli/agents.state.json";
+var migrationChecked = false;
+function ensureMigrated(newPath, cwd) {
+  if (migrationChecked) return;
+  if (existsSync(newPath)) {
+    migrationChecked = true;
+    return;
+  }
+  const legacyPath = resolve(cwd, LEGACY_STATE_PATH);
+  if (!existsSync(legacyPath)) {
+    migrationChecked = true;
+    return;
+  }
+  try {
+    mkdirSync(dirname(newPath), { recursive: true });
+    copyFileSync(legacyPath, newPath);
+    try {
+      renameSync(legacyPath, `${legacyPath}.migrated`);
+    } catch {
+    }
+    migrationChecked = true;
+    console.warn(
+      `[state] Migrated playground state from legacy path:
+         ${legacyPath}
+       \u2192 ${newPath}
+       The legacy file has been renamed to ${legacyPath}.migrated.`
+    );
+  } catch (error) {
+    console.warn(`[state] Failed to migrate legacy state file: ${error instanceof Error ? error.message : error}`);
+  }
+}
 function resolveStatePath(env = process.env, cwd = process.cwd()) {
   const configured = env.AGENTS_STATE_PATH?.trim();
-  return configured ? resolve(cwd, configured) : resolve(cwd, DEFAULT_STATE_PATH);
+  if (configured) return resolve(cwd, configured);
+  ensureMigrated(DEFAULT_STATE_PATH, cwd);
+  return DEFAULT_STATE_PATH;
 }
 function deriveWebUiStateScope() {
   return { projectId: RUNTIME_PROJECT_NAME };
@@ -1633,6 +1587,109 @@ async function importMatchedCloudAgent(input, provider, matched) {
   });
 }
 
+// ../../apps/server/src/services/sessions/playbook-session-adapter/runtime.ts
+function playbookIdentityMismatchMessage(playbookId) {
+  return `\u73A9\u6CD5\u300C${playbookId}\u300D\u5B58\u5728\u540C\u5E94\u7528\u540C\u540D Agent\uFF0C\u4F46 metadata.${PLAYBOOK_APP_METADATA_KEY}/${PLAYBOOK_METADATA_KEY} \u672A\u5BF9\u4E0A\uFF0C\u7591\u4F3C\u8EAB\u4EFD\u672A\u76D6\u7AE0\uFF1B\u8BF7\u68C0\u67E5\u914D\u7F6E\u800C\u975E\u91CD\u590D\u521B\u5EFA\u3002`;
+}
+var PlaybookAgentIdentityMismatchError = class extends Error {
+  constructor(playbookId) {
+    super(playbookIdentityMismatchMessage(playbookId));
+    this.name = "PlaybookAgentIdentityMismatchError";
+  }
+};
+function pickPlaybookAgent(agents, input) {
+  const matched = agents.filter(
+    (agent2) => (input.includeArchived || !isArchived(agent2)) && agent2.metadata?.[PLAYBOOK_APP_METADATA_KEY] === input.appId && agent2.metadata?.[PLAYBOOK_METADATA_KEY] === input.playbookId
+  );
+  if (matched.length <= 1) {
+    return {
+      agent: matched[0],
+      duplicates: [],
+      identityMismatch: matched.length === 0 && hasSameNameCurrentAppAgent(agents, input)
+    };
+  }
+  const sorted = [...matched].sort((a, b) => epochOf(updatedAtOf(b)) - epochOf(updatedAtOf(a)));
+  const [agent, ...duplicates] = sorted;
+  return { agent, duplicates, identityMismatch: false };
+}
+function createPlaybookSessionRuntime(deps) {
+  async function findAgent(playbookId) {
+    const [agents, expectedAgentName] = await Promise.all([
+      deps.agents.listPlaybookAgents({ playbookId, includeArchived: false }),
+      deps.identity.expectedAgentName?.(playbookId)
+    ]);
+    return pickPlaybookAgent(agents, {
+      playbookId,
+      appId: deps.identity.appId,
+      expectedAgentName
+    });
+  }
+  return {
+    async list(input) {
+      return deps.sessions.list(input);
+    },
+    async getDetail(input) {
+      return deps.sessions.getDetail(input);
+    },
+    async start(input) {
+      const pick = await findAgent(input.playbookId);
+      if (pick.identityMismatch) throw new PlaybookAgentIdentityMismatchError(input.playbookId);
+      if (pick.agent && pick.duplicates.length) {
+        deps.onDuplicateAgent?.({ playbookId: input.playbookId, winner: pick.agent, duplicates: pick.duplicates });
+      }
+      const agent = await deps.agents.ensurePlaybookAgent({
+        playbookId: input.playbookId,
+        model: input.model,
+        matched: pick.agent
+      });
+      const started = await deps.sessions.start({ ...input, remoteAgentId: agent.id });
+      if (started.events) {
+        deps.events?.attachLiveStream(started.sessionId, started.events, started.completedEvents);
+      } else if (started.completedEvents?.length) {
+        deps.events?.seedCompleted(started.sessionId, started.completedEvents);
+      }
+      return deps.sessions.getDetail({
+        sessionId: started.sessionId,
+        playbookId: input.playbookId,
+        remoteAgentId: agent.id
+      });
+    },
+    async send(input) {
+      const sent = await deps.sessions.send(input);
+      if (sent.events) {
+        deps.events?.attachLiveStream(sent.sessionId, sent.events, sent.completedEvents);
+      } else if (sent.completedEvents?.length) {
+        deps.events?.seedCompleted(sent.sessionId, sent.completedEvents);
+      }
+      return deps.sessions.getDetail({
+        sessionId: sent.sessionId,
+        playbookId: input.playbookId
+      });
+    },
+    async delete(input) {
+      await deps.sessions.delete(input);
+    }
+  };
+}
+function hasSameNameCurrentAppAgent(agents, input) {
+  if (!input.expectedAgentName) return false;
+  return agents.some(
+    (agent) => !isArchived(agent) && agent.metadata?.[PLAYBOOK_APP_METADATA_KEY] === input.appId && agent.name === input.expectedAgentName
+  );
+}
+function isArchived(agent) {
+  return agent.archivedAt != null || agent.archived_at != null;
+}
+function updatedAtOf(agent) {
+  return agent.updatedAt ?? agent.updated_at;
+}
+function epochOf(value) {
+  if (value == null) return 0;
+  if (typeof value === "number") return value;
+  const parsed = Date.parse(value);
+  return Number.isNaN(parsed) ? 0 : parsed;
+}
+
 // ../../apps/server/src/services/sessions/playbook-session-adapter/sessions.ts
 import {
   deleteSession,
@@ -1838,7 +1895,7 @@ function seedCompletedEvents(sessionId, events) {
 }
 
 // ../../apps/server/src/services/sessions/playbook-session-adapter/index.ts
-function createModeAPlaybookSessionRuntime() {
+function createServerPlaybookSessionRuntime() {
   return createPlaybookSessionRuntime({
     identity: {
       appId: getPlaybookAppId(),
@@ -1898,7 +1955,7 @@ function createModeAPlaybookSessionRuntime() {
     onDuplicateAgent({ playbookId, winner, duplicates }) {
       const all = [winner, ...duplicates];
       console.warn(
-        `\u73A9\u6CD5\u300C${playbookId}\u300D\u5339\u914D\u5230 ${all.length} \u4E2A active playbook Agent(${all.map((agent) => agent.id).join(", ")});\u53D6\u6700\u8FD1\u66F4\u65B0\u7684 ${winner.id}\u3002`
+        `\u73A9\u6CD5\u300C${playbookId}\u300D\u5339\u914D\u5230 ${all.length} \u4E2A active playbook Agent(${all.map((agent) => agent.id).join(", ")})\uFF1B\u53D6\u6700\u8FD1\u66F4\u65B0\u7684 ${winner.id}\u3002`
       );
     }
   });
@@ -1918,7 +1975,7 @@ async function updatePlaybookAgentModel(slug, model) {
     throw new UserError2(run.error ?? `Failed to update agent '${input.agentId}' model (status: ${run.status}).`);
   }
 }
-var playbookSessionRuntime = createModeAPlaybookSessionRuntime();
+var playbookSessionRuntime = createServerPlaybookSessionRuntime();
 async function listSessionsForAgent(input) {
   const requestedAgentId = input.agentId?.trim() || void 0;
   const limit = input.limit ?? 50;
@@ -2089,7 +2146,7 @@ import { areRuntimeCredentialsReady, resolveActiveProvider as resolveActiveProvi
 
 // ../../apps/server/src/lib/agents-config.ts
 import { mkdir, readFile, writeFile } from "fs/promises";
-import { dirname } from "path";
+import { dirname as dirname2 } from "path";
 import {
   AGENTS_CONFIG_PROVIDERS,
   AGENTS_PROVIDER_FIELDS,
@@ -2168,17 +2225,20 @@ async function readProviderConfig() {
   }
   const provider = diskConfig.AGENTS_PROVIDER ?? resolveActiveProvider();
   const merged = { AGENTS_PROVIDER: provider };
-  for (const field of AGENTS_PROVIDER_FIELDS[provider]) {
-    const diskValue = diskConfig[field.key]?.trim();
-    const envValue = process.env[field.key]?.trim();
-    merged[field.key] = diskValue || envValue;
+  for (const candidateProvider of AGENTS_CONFIG_PROVIDERS) {
+    for (const field of AGENTS_PROVIDER_FIELDS[candidateProvider]) {
+      const diskValue = diskConfig[field.key]?.trim();
+      const envValue = process.env[field.key]?.trim();
+      const value = diskValue || envValue;
+      if (value) merged[field.key] = value;
+    }
   }
   return merged;
 }
 async function writeProviderConfig(input) {
   const config = validateProviderConfig(input);
   const path = providerConfigPath();
-  await mkdir(dirname(path), { recursive: true });
+  await mkdir(dirname2(path), { recursive: true });
   const payload = { AGENTS_PROVIDER: config.AGENTS_PROVIDER };
   for (const field of AGENTS_PROVIDER_FIELDS[config.AGENTS_PROVIDER]) {
     payload[field.key] = config[field.key];
@@ -2668,8 +2728,7 @@ var SessionParamsSchema = z7.object({
 var CreateSessionBodySchema = z7.object({
   agentId: z7.string(),
   prompt: z7.string().min(1),
-  // Required: a session must be pinned to a cloud environment (sandbox). Both transports
-  // enforce this so Mode A (REST/OpenAPI) and Mode B (console) reject env-less creates.
+  // Required: a session must be pinned to a cloud environment (sandbox).
   environmentId: z7.string().min(1),
   // Optional: cloud vault ids to bind a user-supplied credential so the sandbox receives it.
   // Top-level binding shape matches the console createSession.
@@ -3347,9 +3406,8 @@ var CloudVaultsResponseSchema = z10.object({
 var CreateVaultBodySchema = z10.object({
   name: z10.string().min(1),
   metadata: z10.record(z10.string(), z10.string()).optional(),
-  // The DASHSCOPE_API_KEY stored as the vault's credential secret value. Optional: Mode B
-  // supplies the user's key; Mode A (local) omits it and the server injects it from its own
-  // DASHSCOPE_API_KEY env. (Mode B never reaches this REST route — it goes via console RPC.)
+  // The DASHSCOPE_API_KEY stored as the vault's credential secret value. Optional:
+  // when omitted the server injects it from its own DASHSCOPE_API_KEY env.
   key: z10.string().min(1).optional()
 });
 var CreateVaultResponseSchema = z10.object({
@@ -3410,8 +3468,8 @@ vaultsRoute.openapi(createVaultRoute, async (c) => {
   const vault = await withAgentRuntime(
     DEFAULT_AGENT_ID,
     (ctx) => createCloudVault(ctx, name, {
-      // display_name carries the base-vault identity (Agents/secrets) — a vault has no
-      // separate `name` field, so findBaseVault nets it by display_name + the stamp.
+      // display_name is used as the vault's human-readable label on the provider.
+      // findBaseVault identifies the managed vault by its metadata stamp (agents.vault).
       display_name: name,
       metadata,
       credentials: structure.credentials.map((cred) => ({
@@ -3511,8 +3569,8 @@ async function resolveListenPort(preferred, maxAttempts = MAX_PORT_ATTEMPTS) {
 
 // src/server.ts
 var DEFAULT_PLAYGROUND_PORT = 4848;
-var webRoot = join(dirname2(fileURLToPath(import.meta.url)), "../../web");
-var indexHtml = injectPlaygroundRuntimeMarker(readFileSync(join(webRoot, "index.html"), "utf8"));
+var webRoot = join2(dirname3(fileURLToPath(import.meta.url)), "../../web");
+var indexHtml = injectPlaygroundRuntimeMarker(readFileSync(join2(webRoot, "index.html"), "utf8"));
 function injectPlaygroundRuntimeMarker(html) {
   if (html.includes('name="agents-runtime"')) return html;
   return html.replace("<head>", '<head>\n    <meta name="agents-runtime" content="playground" />');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openagentpack/playground",
-  "version": "0.1.0",
+  "version": "0.2.0-beta-ddef91c-20260720",
   "description": "OpenAgentPack Playground — one-command local web UI for OpenAgentPack",
   "license": "Apache-2.0",
   "keywords": [
@@ -42,14 +42,13 @@
   "dependencies": {
     "@hono/node-server": "^1.19.0",
     "@hono/zod-openapi": "^1.4.0",
-    "@openagentpack/sdk": "0.1.0",
+    "@openagentpack/sdk": "0.2.0-beta-ddef91c-20260720",
     "hono": "^4.12.28",
     "zod": "^4.4.3"
   },
   "devDependencies": {
     "@types/bun": "^1.3.14",
-    "@openagentpack/playbooks": "0.0.1",
-    "@openagentpack/server": "0.0.3",
+    "@openagentpack/server": "0.0.5",
     "@types/node": "^25.9.3",
     "tsup": "^8.5.1",
     "typescript": "^6.0.3"