bridge-agent 0.4.8 → 0.5.0

package/dist/bridge-mcp.cjs

@@ -1299,21 +1299,21 @@ var require_errors = __commonJS({
     function extendErrors({ gen, keyword, schemaValue, data, errsCount, it }) {
       if (errsCount === void 0)
         throw new Error("ajv implementation error");
-      const err3 = gen.name("err");
+      const err4 = gen.name("err");
       gen.forRange("i", errsCount, names_1.default.errors, (i) => {
-        gen.const(err3, (0, codegen_1._)`${names_1.default.vErrors}[${i}]`);
-        gen.if((0, codegen_1._)`${err3}.instancePath === undefined`, () => gen.assign((0, codegen_1._)`${err3}.instancePath`, (0, codegen_1.strConcat)(names_1.default.instancePath, it.errorPath)));
-        gen.assign((0, codegen_1._)`${err3}.schemaPath`, (0, codegen_1.str)`${it.errSchemaPath}/${keyword}`);
+        gen.const(err4, (0, codegen_1._)`${names_1.default.vErrors}[${i}]`);
+        gen.if((0, codegen_1._)`${err4}.instancePath === undefined`, () => gen.assign((0, codegen_1._)`${err4}.instancePath`, (0, codegen_1.strConcat)(names_1.default.instancePath, it.errorPath)));
+        gen.assign((0, codegen_1._)`${err4}.schemaPath`, (0, codegen_1.str)`${it.errSchemaPath}/${keyword}`);
         if (it.opts.verbose) {
-          gen.assign((0, codegen_1._)`${err3}.schema`, schemaValue);
-          gen.assign((0, codegen_1._)`${err3}.data`, data);
+          gen.assign((0, codegen_1._)`${err4}.schema`, schemaValue);
+          gen.assign((0, codegen_1._)`${err4}.data`, data);
         }
       });
     }
     exports2.extendErrors = extendErrors;
     function addError(gen, errObj) {
-      const err3 = gen.const("err", errObj);
-      gen.if((0, codegen_1._)`${names_1.default.vErrors} === null`, () => gen.assign(names_1.default.vErrors, (0, codegen_1._)`[${err3}]`), (0, codegen_1._)`${names_1.default.vErrors}.push(${err3})`);
+      const err4 = gen.const("err", errObj);
+      gen.if((0, codegen_1._)`${names_1.default.vErrors} === null`, () => gen.assign(names_1.default.vErrors, (0, codegen_1._)`[${err4}]`), (0, codegen_1._)`${names_1.default.vErrors}.push(${err4})`);
       gen.code((0, codegen_1._)`${names_1.default.errors}++`);
     }
     function returnErrors(it, errs) {
@@ -7541,8 +7541,8 @@ var ZodType = class {
         } : {
           issues: ctx.common.issues
         };
-      } catch (err3) {
-        if (err3?.message?.toLowerCase()?.includes("encountered")) {
+      } catch (err4) {
+        if (err4?.message?.toLowerCase()?.includes("encountered")) {
           this["~standard"].async = true;
         }
         ctx.common = {
@@ -21243,16 +21243,16 @@ var handleFetchError = (e) => new Response(null, {
   status: e instanceof Error && (e.name === "TimeoutError" || e.constructor.name === "TimeoutError") ? 504 : 500
 });
 var handleResponseError = (e, outgoing) => {
-  const err3 = e instanceof Error ? e : new Error("unknown error", { cause: e });
-  if (err3.code === "ERR_STREAM_PREMATURE_CLOSE") {
+  const err4 = e instanceof Error ? e : new Error("unknown error", { cause: e });
+  if (err4.code === "ERR_STREAM_PREMATURE_CLOSE") {
     console.info("The user aborted a request.");
   } else {
     console.error(e);
     if (!outgoing.headersSent) {
       outgoing.writeHead(500, { "Content-Type": "text/plain" });
     }
-    outgoing.end(`Error: ${err3.message}`);
-    outgoing.destroy(err3);
+    outgoing.end(`Error: ${err4.message}`);
+    outgoing.destroy(err4);
   }
 };
 var flushHeaders = (outgoing) => {
@@ -21309,8 +21309,8 @@ var responseViaResponseObject = async (res, outgoing, options = {}) => {
     if (options.errorHandler) {
       try {
         res = await res;
-      } catch (err3) {
-        const errRes = await options.errorHandler(err3);
+      } catch (err4) {
+        const errRes = await options.errorHandler(err4);
         if (!errRes) {
           return;
         }
@@ -22391,10 +22391,13 @@ async function getAgentIdle(ctx, agentId) {
 }
 async function recordProjectEvent(ctx, params) {
   const { projectId, ...body } = params;
+  const explicitProjectId = projectId?.trim();
+  const isWorkspaceScope = ctx.projectId === "workspace" && !explicitProjectId;
+  const url = isWorkspaceScope ? workspacePath(ctx, "/events") : projectPath(ctx, "/events", explicitProjectId);
   return request(
     ctx,
     "POST",
-    projectPath(ctx, "/events", projectId),
+    url,
     { ...body, agentId: ctx.agentId }
   );
 }
@@ -22414,6 +22417,44 @@ async function getProjectEvents(ctx, opts) {
     projectPath(ctx, `/events${qs ? "?" + qs : ""}`, opts?.projectId)
   );
 }
+async function listPersonas(ctx, opts) {
+  const params = new URLSearchParams();
+  if (opts.projectId) params.set("projectId", opts.projectId);
+  if (opts.scope) params.set("scope", opts.scope);
+  if (opts.includeArchived) params.set("includeArchived", "true");
+  if (opts.excludePersonal) params.set("excludePersonal", "true");
+  if (opts.agentKey) params.set("agentKey", opts.agentKey);
+  if (opts.role) params.set("role", opts.role);
+  if (opts.tag) params.set("tag", opts.tag);
+  if (opts.q) params.set("q", opts.q);
+  if (opts.limit) params.set("pageSize", String(opts.limit));
+  const qs = params.toString();
+  return request(ctx, "GET", workspacePath(ctx, `/personas${qs ? "?" + qs : ""}`));
+}
+async function getPersona(ctx, params) {
+  return request(ctx, "GET", workspacePath(ctx, `/personas/${encodeURIComponent(params.id)}`));
+}
+async function createPersona(ctx, params) {
+  const body = { ...params, scope: params.projectId ? "project" : "workspace" };
+  return request(ctx, "POST", workspacePath(ctx, "/personas"), body);
+}
+async function updatePersona(ctx, params) {
+  const { id, ...body } = params;
+  return request(ctx, "PATCH", workspacePath(ctx, `/personas/${encodeURIComponent(id)}`), body);
+}
+async function archivePersona(ctx, id) {
+  return request(ctx, "POST", workspacePath(ctx, `/personas/${encodeURIComponent(id)}/archive`));
+}
+async function launchPersona(ctx, params) {
+  const { id, projectId, ...rest } = params;
+  const trimmed = projectId?.trim();
+  const pid = trimmed || ctx.projectId;
+  if (pid === "workspace") {
+    throw new Error("launchPersona requires a real projectId \u2014 cannot launch into workspace scope");
+  }
+  const body = pid ? { ...rest, projectId: pid } : rest;
+  return request(ctx, "POST", workspacePath(ctx, `/personas/${encodeURIComponent(id)}/launch`), body);
+}
 
 // ../mcp-server/src/tools/plan.ts
 function registerPlanTools(server, ctx) {
@@ -22542,6 +22583,31 @@ function registerTodoTools(server, ctx) {
   );
 }
 
+// ../shared/dist/types.js
+var ALL_AGENT_KEYS = [
+  "sh",
+  "claude",
+  "codex",
+  "qwen",
+  "kimi",
+  "gemini",
+  "ollama",
+  "aider",
+  "forge",
+  "sim_ios"
+];
+var AGENT_ROLES = [
+  "developer",
+  "reviewer",
+  "planner",
+  "executor",
+  "shell",
+  "runner",
+  "orchestrator"
+];
+var USER_ASSIGNABLE_ROLES = AGENT_ROLES.filter((r) => r !== "orchestrator");
+var EVENT_ROLES = [...AGENT_ROLES, "system"];
+
 // ../mcp-server/src/tools/orchestration.ts
 function ok(data) {
   return { content: [{ type: "text", text: JSON.stringify(data) }] };
@@ -22612,7 +22678,7 @@ function registerOrchestrationTools(server, ctx) {
     {
       agentKey: external_exports.string().describe("Agent type: claude, codex, sh, qwen, gemini, ollama, aider"),
       daemonId: external_exports.string().optional().describe("Target machine ID. Omit to use the workspace default machine."),
-      role: external_exports.string().optional().describe("Panel role: developer, reviewer, planner, executor, shell, runner"),
+      role: external_exports.enum(USER_ASSIGNABLE_ROLES).optional().describe(`Panel role: ${USER_ASSIGNABLE_ROLES.join(", ")}`),
       cmd: external_exports.string().max(512).optional().describe('Command to run after spawn (sh panels only, e.g. "npm run dev"). Sets role to runner automatically.')
     },
     ({ agentKey, daemonId, role, cmd }) => safe(() => spawnAgent(ctx, agentKey, daemonId, role, cmd))
@@ -22666,7 +22732,7 @@ function registerOrchestrationTools(server, ctx) {
   );
   server.tool(
     "bridge_record_event",
-    "Append an event to the project event log. Use to record decisions, discoveries, phase completions, or blockers so future agents and runs have durable context. Events are separate from run history \u2014 they persist across runs and are queryable by role/type/tag. Suggested eventTypes: decision, discovery, blocker, phase_complete, note, warning. Pass projectId to target a specific project (orchestrator must always pass it; per-project workers can omit).",
+    "Append an event to the project event log. Use to record decisions, discoveries, phase completions, or blockers so future agents and runs have durable context. Events are separate from run history \u2014 they persist across runs and are queryable by role/type/tag. Suggested eventTypes: decision, discovery, blocker, phase_complete, note, warning. Pass projectId to target a specific project (orchestrator must always pass it for project events; without projectId the event lands in the workspace log and is not tied to a specific project).",
     {
       eventType: external_exports.string().min(1).max(64).describe("Free-form event type slug (e.g. decision, blocker, phase_complete)"),
       summary: external_exports.string().min(1).max(512).describe("Human-readable event summary (max 512 chars)"),
@@ -22768,6 +22834,12 @@ function registerWorkspaceTools(server, ctx) {
     {},
     () => safe2(() => request(ctx, "GET", workspacePath(ctx, "/projects")))
   );
+  server.tool(
+    "bridge_get_project",
+    "Get the current project details: id, name, description, cwd, machineId. Use this to confirm which project context the caller is operating in.",
+    {},
+    () => safe2(() => getProject(ctx))
+  );
   server.tool(
     "bridge_query_workspace",
     "Natural-language query about orchestration state (runs, todos, failures). No LLM involved \u2014 deterministic answer.",
@@ -22797,6 +22869,114 @@ function registerWorkspaceTools(server, ctx) {
   );
 }
 
+// ../mcp-server/src/tools/personas.ts
+function ok3(data) {
+  return { content: [{ type: "text", text: JSON.stringify(data) }] };
+}
+function err3(message) {
+  return { content: [{ type: "text", text: JSON.stringify({ ok: false, error: message }) }] };
+}
+async function safe3(fn) {
+  try {
+    return ok3(await fn());
+  } catch (e) {
+    const message = e instanceof Error ? e.message : String(e);
+    if (e instanceof Error && (e.name === "TypeError" || e.name === "ReferenceError")) {
+      console.error("[mcp-bridge] unexpected error in persona tool handler", { name: e.name, message, stack: e.stack });
+    }
+    return err3(message);
+  }
+}
+var ListPersonasSchema = external_exports.object({
+  projectId: external_exports.string().min(1).optional().describe("Filter to project scope. Defaults to caller panel's project."),
+  scope: external_exports.enum(["personal", "workspace", "project", "all"]).optional().describe("Scope filter (default: all)"),
+  includeArchived: external_exports.boolean().optional(),
+  excludePersonal: external_exports.boolean().optional().describe("Exclude personal-scoped personas from results (useful for orchestrator workspace-wide queries)"),
+  agentKey: external_exports.enum(ALL_AGENT_KEYS).optional(),
+  role: external_exports.enum(USER_ASSIGNABLE_ROLES).optional(),
+  tag: external_exports.string().optional(),
+  q: external_exports.string().optional().describe("Substring search on name+description"),
+  limit: external_exports.number().int().min(1).max(200).optional()
+});
+var GetPersonaSchema = external_exports.object({
+  id: external_exports.string().min(1).describe("Persona id (UUID)"),
+  projectId: external_exports.string().min(1).optional()
+});
+var CreatePersonaSchema = external_exports.object({
+  name: external_exports.string().min(1).max(80),
+  slug: external_exports.string().min(1).max(63).regex(/^[a-z][a-z0-9_]*$/),
+  description: external_exports.string().max(200).optional(),
+  agentKey: external_exports.enum(ALL_AGENT_KEYS),
+  role: external_exports.enum(USER_ASSIGNABLE_ROLES),
+  systemPrompt: external_exports.string().max(4e3).optional(),
+  defaultCwd: external_exports.string().optional(),
+  defaultDaemonId: external_exports.string().optional(),
+  color: external_exports.string().regex(/^#[0-9a-f]{6}$/i).optional(),
+  icon: external_exports.string().optional(),
+  tags: external_exports.array(external_exports.string()).max(10).optional(),
+  projectId: external_exports.string().min(1).optional().describe("Make this a project-scoped persona. Omit for workspace-scoped.")
+});
+var UpdatePersonaSchema = external_exports.object({
+  id: external_exports.string().min(1),
+  name: external_exports.string().min(1).max(80).optional(),
+  description: external_exports.string().max(200).optional(),
+  systemPrompt: external_exports.string().max(4e3).optional(),
+  defaultCwd: external_exports.string().optional(),
+  defaultDaemonId: external_exports.string().optional(),
+  color: external_exports.string().regex(/^#[0-9a-f]{6}$/i).optional(),
+  icon: external_exports.string().optional(),
+  tags: external_exports.array(external_exports.string()).max(10).optional()
+});
+var ArchivePersonaSchema = external_exports.object({
+  id: external_exports.string().min(1)
+});
+var LaunchPersonaSchema = external_exports.object({
+  id: external_exports.string().min(1).describe("Persona id"),
+  projectId: external_exports.string().min(1).optional().describe("Target project for the spawned panel. Required from orchestrator."),
+  daemonId: external_exports.string().min(1).optional(),
+  cwd: external_exports.string().optional(),
+  cols: external_exports.number().int().optional(),
+  rows: external_exports.number().int().optional()
+});
+function registerPersonaTools(server, ctx) {
+  server.tool(
+    "bridge_list_personas",
+    "Query personas in the workspace. Returns lightweight list \u2014 call bridge_get_persona for full systemPrompt. Pass projectId to filter to a specific project. From the orchestrator (workspace scope) optionally pass projectId; per-project workers default to ctx.projectId. Set excludePersonal:true to filter out personal-scoped personas (useful for orchestrator workspace-wide queries).",
+    ListPersonasSchema.shape,
+    (opts) => safe3(() => listPersonas(ctx, opts))
+  );
+  server.tool(
+    "bridge_get_persona",
+    "Fetch a single persona by id. Returns full systemPrompt and all fields.",
+    GetPersonaSchema.shape,
+    (params) => safe3(() => getPersona(ctx, params))
+  );
+  server.tool(
+    "bridge_create_persona",
+    "Create a new persona. Required from the orchestrator: pass projectId if creating a project-scoped persona; omit for workspace-scoped.",
+    CreatePersonaSchema.shape,
+    (params) => safe3(() => createPersona(ctx, params))
+  );
+  server.tool(
+    "bridge_update_persona",
+    "Update fields of an existing persona. Pass only the fields you want to change.",
+    UpdatePersonaSchema.shape,
+    (params) => safe3(() => updatePersona(ctx, params))
+  );
+  server.tool(
+    "bridge_archive_persona",
+    "Soft-archive a persona. Removes it from the active list but preserves audit trail.",
+    ArchivePersonaSchema.shape,
+    ({ id }) => safe3(() => archivePersona(ctx, id))
+  );
+  server.tool(
+    "bridge_launch_persona",
+    "Spawn a live panel from a persona. Returns the new agentId.",
+    LaunchPersonaSchema.shape,
+    (params) => safe3(() => launchPersona(ctx, params))
+  );
+}
+
 // ../mcp-server/src/index.ts
 var sessions = /* @__PURE__ */ new Map();
 function buildMcpServer(ctx) {
@@ -22806,6 +22986,7 @@ function buildMcpServer(ctx) {
   registerOrchestrationTools(srv, ctx);
   registerMessagingTools(srv, ctx);
   registerWorkspaceTools(srv, ctx);
+  registerPersonaTools(srv, ctx);
   return srv;
 }
 async function parseBody(req) {
@@ -22895,7 +23076,8 @@ function startHttpServer() {
         }
       }
       const agentId = (req.headers["x-panel-id"] ?? "") || void 0;
-      const ctx = { serverUrl: bridgeServerUrl, token, workspaceId, projectId, agentId };
+      const personaId = (req.headers["x-panel-persona-id"] ?? "") || void 0;
+      const ctx = { serverUrl: bridgeServerUrl, token, workspaceId, projectId, agentId, personaId };
       const sid = (0, import_node_crypto.randomUUID)();
       const transport = new StreamableHTTPServerTransport({
         sessionIdGenerator: () => sid,
@@ -22909,8 +23091,8 @@ function startHttpServer() {
       const mcpServer = buildMcpServer(ctx);
       await mcpServer.connect(transport);
       await transport.handleRequest(req, res, body);
-    } catch (err3) {
-      console.error("[bridge-mcp] request error:", err3);
+    } catch (err4) {
+      console.error("[bridge-mcp] request error:", err4);
       if (!res.headersSent) {
         res.writeHead(500, { "Content-Type": "application/json" });
         res.end(JSON.stringify({ error: "Internal server error" }));
@@ -22934,7 +23116,8 @@ async function startStdioServer() {
     token: process.env["BRIDGE_TOKEN"],
     workspaceId: process.env["BRIDGE_WORKSPACE_ID"],
     projectId: process.env["BRIDGE_PROJECT_ID"],
-    agentId: process.env["BRIDGE_PANEL_ID"] || void 0
+    agentId: process.env["BRIDGE_PANEL_ID"] || void 0,
+    personaId: process.env["BRIDGE_PERSONA_ID"] || void 0
   };
   const srv = buildMcpServer(ctx);
   const transport = new StdioServerTransport();
@@ -22944,8 +23127,8 @@ async function startStdioServer() {
 if (process.env["HTTP_MODE"] !== "false") {
   startHttpServer();
 } else {
-  startStdioServer().catch((err3) => {
-    console.error("[bridge-mcp] fatal:", err3);
+  startStdioServer().catch((err4) => {
+    console.error("[bridge-mcp] fatal:", err4);
     process.exit(1);
   });
 }