agent-relay-server 0.43.0 → 0.45.0

package/src/db/migrations.ts

@@ -302,6 +302,23 @@ export function applyMigrations(): void {
   `);
   getDb().run("CREATE INDEX IF NOT EXISTS idx_teams_coordinator ON teams(coordinator_id)");
   getDb().run("CREATE INDEX IF NOT EXISTS idx_teams_status ON teams(status)");
+  getDb().run(`
+    CREATE TABLE IF NOT EXISTS blackboard_entries (
+      id TEXT PRIMARY KEY,
+      team_id TEXT NOT NULL,
+      kind TEXT NOT NULL,
+      title TEXT NOT NULL,
+      body TEXT,
+      status TEXT NOT NULL DEFAULT 'active',
+      supersedes TEXT,
+      tags TEXT,
+      author_id TEXT NOT NULL,
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL
+    )
+  `);
+  getDb().run("CREATE INDEX IF NOT EXISTS idx_blackboard_team ON blackboard_entries(team_id)");
+  getDb().run("CREATE INDEX IF NOT EXISTS idx_blackboard_team_kind ON blackboard_entries(team_id, kind)");
   getDb().run(`
     CREATE TABLE IF NOT EXISTS plans (
       id TEXT PRIMARY KEY, thread_id INTEGER NOT NULL, team_id TEXT, channel TEXT, version INTEGER NOT NULL DEFAULT 1,
@@ -319,11 +336,30 @@ export function applyMigrations(): void {
   getDb().run("CREATE INDEX IF NOT EXISTS idx_plans_team ON plans(team_id)");
   getDb().run(`
     CREATE TABLE IF NOT EXISTS plan_versions (
-      id INTEGER PRIMARY KEY AUTOINCREMENT, plan_id TEXT NOT NULL REFERENCES plans(id) ON DELETE CASCADE,
+      id INTEGER PRIMARY KEY AUTOINCREMENT, plan_id TEXT NOT NULL,
       version INTEGER NOT NULL, title TEXT, objective TEXT, nodes TEXT NOT NULL, edges TEXT NOT NULL,
       changed_by TEXT, changed_at INTEGER NOT NULL
     )
   `);
+  const planVersionFks = getDb().query("PRAGMA foreign_key_list(plan_versions)").all() as any[];
+  if (planVersionFks.some((fk) => fk.table === "plans" && String(fk.on_delete).toUpperCase() === "CASCADE")) {
+    getDb().transaction(() => {
+      getDb().run("ALTER TABLE plan_versions RENAME TO plan_versions_old");
+      getDb().run(`
+        CREATE TABLE plan_versions (
+          id INTEGER PRIMARY KEY AUTOINCREMENT, plan_id TEXT NOT NULL,
+          version INTEGER NOT NULL, title TEXT, objective TEXT, nodes TEXT NOT NULL, edges TEXT NOT NULL,
+          changed_by TEXT, changed_at INTEGER NOT NULL
+        )
+      `);
+      getDb().run(`
+        INSERT INTO plan_versions (id, plan_id, version, title, objective, nodes, edges, changed_by, changed_at)
+        SELECT id, plan_id, version, title, objective, nodes, edges, changed_by, changed_at
+        FROM plan_versions_old
+      `);
+      getDb().run("DROP TABLE plan_versions_old");
+    })();
+  }
   getDb().run("CREATE INDEX IF NOT EXISTS idx_plan_versions_plan ON plan_versions(plan_id, version DESC)");
 
   // Backfill thread_id for pre-migration rows (self-threaded).

package/src/db/schema.ts

@@ -171,6 +171,21 @@ export function initDb(path: string = "agent-relay.db"): Database {
     );
     CREATE INDEX IF NOT EXISTS idx_teams_coordinator ON teams(coordinator_id);
     CREATE INDEX IF NOT EXISTS idx_teams_status ON teams(status);
+    CREATE TABLE IF NOT EXISTS blackboard_entries (
+      id TEXT PRIMARY KEY,
+      team_id TEXT NOT NULL,
+      kind TEXT NOT NULL,
+      title TEXT NOT NULL,
+      body TEXT,
+      status TEXT NOT NULL DEFAULT 'active',
+      supersedes TEXT,
+      tags TEXT,
+      author_id TEXT NOT NULL,
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_blackboard_team ON blackboard_entries(team_id);
+    CREATE INDEX IF NOT EXISTS idx_blackboard_team_kind ON blackboard_entries(team_id, kind);
     CREATE TABLE IF NOT EXISTS plans (
       id TEXT PRIMARY KEY, thread_id INTEGER NOT NULL, team_id TEXT, channel TEXT, version INTEGER NOT NULL DEFAULT 1,
       title TEXT, objective TEXT, nodes TEXT NOT NULL DEFAULT '[]', edges TEXT NOT NULL DEFAULT '[]',
@@ -179,7 +194,7 @@ export function initDb(path: string = "agent-relay.db"): Database {
     CREATE UNIQUE INDEX IF NOT EXISTS idx_plans_thread_channel ON plans(thread_id, coalesce(channel, ''));
     CREATE INDEX IF NOT EXISTS idx_plans_updated ON plans(updated_at);
     CREATE TABLE IF NOT EXISTS plan_versions (
-      id INTEGER PRIMARY KEY AUTOINCREMENT, plan_id TEXT NOT NULL REFERENCES plans(id) ON DELETE CASCADE,
+      id INTEGER PRIMARY KEY AUTOINCREMENT, plan_id TEXT NOT NULL,
       version INTEGER NOT NULL, title TEXT, objective TEXT, nodes TEXT NOT NULL, edges TEXT NOT NULL,
       changed_by TEXT, changed_at INTEGER NOT NULL
     );

package/src/mcp-blackboard-tools.ts

@@ -0,0 +1,131 @@
+import { getAgent, getEntry, getEntryChain, listEntries, retractEntry, searchEntries, ValidationError, writeEntry } from "./db";
+import { McpNotFoundError } from "./mcp-errors";
+import { authContextFromMcp } from "./services/auth-context";
+import { cleanString, cleanStringArray, optionalEnum } from "./validation";
+import type { BlackboardEntryKind } from "./types";
+
+const BLACKBOARD_KINDS = ["decision", "fact", "ruled_out"] as const;
+
+export const BLACKBOARD_TOOLS = [
+  {
+    name: "relay_blackboard_write",
+    description: "Create a team-scoped blackboard entry. The caller's token identity determines the team and author.",
+    requiredScopes: ["blackboard:write"],
+    inputSchema: {
+      type: "object",
+      properties: {
+        kind: { type: "string", enum: BLACKBOARD_KINDS },
+        title: { type: "string" },
+        body: { type: "string" },
+        tags: { type: "array", items: { type: "string" } },
+        supersedes: { type: "string" },
+      },
+      required: ["kind", "title"],
+      additionalProperties: false,
+    },
+  },
+  {
+    name: "relay_blackboard_get",
+    description: "Fetch one blackboard entry and its supersession chain for the caller's team.",
+    requiredScopes: ["blackboard:read"],
+    inputSchema: {
+      type: "object",
+      properties: { id: { type: "string" } },
+      required: ["id"],
+      additionalProperties: false,
+    },
+  },
+  {
+    name: "relay_blackboard_read",
+    description: "Read the caller team's active blackboard working set, optionally filtered by kind.",
+    requiredScopes: ["blackboard:read"],
+    inputSchema: {
+      type: "object",
+      properties: { kind: { type: "string", enum: BLACKBOARD_KINDS } },
+      additionalProperties: false,
+    },
+  },
+  {
+    name: "relay_blackboard_search",
+    description: "Search active blackboard entries for the caller's team by title, body, or tags.",
+    requiredScopes: ["blackboard:read"],
+    inputSchema: {
+      type: "object",
+      properties: {
+        query: { type: "string" },
+        kind: { type: "string", enum: BLACKBOARD_KINDS },
+      },
+      required: ["query"],
+      additionalProperties: false,
+    },
+  },
+  {
+    name: "relay_blackboard_retract",
+    description: "Retract a blackboard entry for the caller's team without deleting its ledger row.",
+    requiredScopes: ["blackboard:write"],
+    inputSchema: {
+      type: "object",
+      properties: { id: { type: "string" } },
+      required: ["id"],
+      additionalProperties: false,
+    },
+  },
+] satisfies Array<{ name: string; description: string; requiredScopes: string[]; inputSchema: Record<string, unknown> }>;
+
+type McpAuthLike = Parameters<typeof authContextFromMcp>[0];
+
+function callerTeam(auth: McpAuthLike): { agentId: string; teamId: string } {
+  const ctx = authContextFromMcp(auth);
+  if (!ctx.callerAgentId) throw new ValidationError("blackboard operations require a single caller agent identity");
+  const agent = getAgent(ctx.callerAgentId);
+  if (!agent?.teamId) throw new ValidationError("caller has no team");
+  return { agentId: ctx.callerAgentId, teamId: agent.teamId };
+}
+
+function cleanKind(value: unknown): BlackboardEntryKind | undefined {
+  return optionalEnum(value, "kind", BLACKBOARD_KINDS) as BlackboardEntryKind | undefined;
+}
+
+function ensureSameTeam(entryId: string, teamId: string): void {
+  const entry = getEntry(entryId);
+  if (!entry) throw new McpNotFoundError("blackboard entry not found");
+  if (entry.teamId !== teamId) throw new McpNotFoundError("blackboard entry not found");
+}
+
+export function relayBlackboardTool(auth: McpAuthLike, name: string, args: Record<string, unknown>): Record<string, unknown> {
+  const { agentId, teamId } = callerTeam(auth);
+  if (name === "relay_blackboard_write") {
+    const supersedes = cleanString(args.supersedes, "supersedes", { max: 120 });
+    const kind = cleanKind(args.kind);
+    if (!kind) throw new ValidationError("kind required");
+    if (supersedes) ensureSameTeam(supersedes, teamId);
+    return writeEntry({
+      teamId,
+      authorId: agentId,
+      kind,
+      title: cleanString(args.title, "title", { required: true, max: 240 })!,
+      body: cleanString(args.body, "body", { max: 16_000 }),
+      tags: cleanStringArray(args.tags, "tags", { itemMax: 80, maxItems: 32 }),
+      supersedes,
+    }) as unknown as Record<string, unknown>;
+  }
+  if (name === "relay_blackboard_get") {
+    const id = cleanString(args.id, "id", { required: true, max: 120 })!;
+    ensureSameTeam(id, teamId);
+    return { entry: getEntry(id), chain: getEntryChain(id) };
+  }
+  if (name === "relay_blackboard_read") {
+    return { entries: listEntries(teamId, { kind: cleanKind(args.kind) }) };
+  }
+  if (name === "relay_blackboard_search") {
+    return { entries: searchEntries(teamId, cleanString(args.query, "query", { required: true, max: 240 })!, { kind: cleanKind(args.kind) }) };
+  }
+  if (name === "relay_blackboard_retract") {
+    const id = cleanString(args.id, "id", { required: true, max: 120 })!;
+    ensureSameTeam(id, teamId);
+    const entry = retractEntry(id);
+    if (!entry) throw new McpNotFoundError("blackboard entry not found");
+    return entry as unknown as Record<string, unknown>;
+  }
+  throw new ValidationError(`unknown tool: ${name}`);
+}

package/src/mcp-plan-tools.ts

@@ -5,6 +5,7 @@ import {
   addPlanEdge,
   addPlanNode,
   createPlan,
+  deletePlanGraph,
   getPlanGraph,
   removePlanEdge,
   removePlanNode,
@@ -82,13 +83,14 @@ export const PLAN_TOOLS = [
   { name: "relay_plan_add_edge", description: "Add a dependency edge to a plan DAG; rejects cycles.", requiredScopes: ["plans:write"], inputSchema: { type: "object", properties: { planId: { type: "string" }, from: { type: "string" }, to: { type: "string" } }, required: ["planId", "from", "to"], additionalProperties: false } },
   { name: "relay_plan_remove_node", description: "Remove a node and its connected edges from a plan DAG.", requiredScopes: ["plans:write"], inputSchema: { type: "object", properties: { planId: { type: "string" }, nodeId: { type: "string" } }, required: ["planId", "nodeId"], additionalProperties: false } },
   { name: "relay_plan_remove_edge", description: "Remove a dependency edge from a plan DAG.", requiredScopes: ["plans:write"], inputSchema: { type: "object", properties: { planId: { type: "string" }, from: { type: "string" }, to: { type: "string" } }, required: ["planId", "from", "to"], additionalProperties: false } },
+  { name: "relay_plan_delete", description: "Delete a persisted plan DAG and archive its latest version.", requiredScopes: ["plans:write"], inputSchema: { type: "object", properties: { planId: { type: "string" } }, required: ["planId"], additionalProperties: false } },
   {
     name: "relay_plan_get",
-    description: "Fetch a plan by planId or by threadId/channel.",
+    description: "Fetch a plan by planId, teamId, or by threadId/channel.",
     requiredScopes: ["plans:read"],
     inputSchema: {
       type: "object",
-      properties: { planId: { type: "string" }, threadId: { oneOf: [{ type: "string" }, { type: "integer", minimum: 1 }] }, channel: { type: "string" } },
+      properties: { planId: { type: "string" }, teamId: { type: "string" }, threadId: { oneOf: [{ type: "string" }, { type: "integer", minimum: 1 }] }, channel: { type: "string" } },
       additionalProperties: false,
     },
   },
@@ -112,8 +114,9 @@ export function relayPlanTool(auth: McpAuthLike, name: string, args: Record<stri
   if (name === "relay_plan_add_edge") return addPlanEdge(stringArg(args.planId, "planId"), { from: args.from, to: args.to }, ctx) as unknown as Record<string, unknown>;
   if (name === "relay_plan_remove_node") return removePlanNode(stringArg(args.planId, "planId"), stringArg(args.nodeId, "nodeId"), ctx) as unknown as Record<string, unknown>;
   if (name === "relay_plan_remove_edge") return removePlanEdge(stringArg(args.planId, "planId"), { from: args.from, to: args.to }, ctx) as unknown as Record<string, unknown>;
+  if (name === "relay_plan_delete") return deletePlanGraph(stringArg(args.planId, "planId"), ctx);
   if (name === "relay_plan_get") {
-    const plan = getPlanGraph({ planId: args.planId, threadId: args.threadId, channel: args.channel });
+    const plan = getPlanGraph({ planId: args.planId, teamId: args.teamId, threadId: args.threadId, channel: args.channel });
     if (!plan) throw new McpNotFoundError("plan not found");
     return plan as unknown as Record<string, unknown>;
   }

package/src/mcp.ts

@@ -48,6 +48,7 @@ import { sendMessageService } from "./services/send-message";
 import { ServiceAuthError } from "./services/errors";
 import { PLAN_TOOLS, relayPlanTool } from "./mcp-plan-tools";
 import { TEAM_TOOLS, relayTeamTool } from "./mcp-team-tools";
+import { BLACKBOARD_TOOLS, relayBlackboardTool } from "./mcp-blackboard-tools";
 import type { ActivityKind, ArtifactKind, ArtifactSensitivity, AttachmentRef, Command, SendMessageInput, Message, SpawnApprovalMode, SpawnProvider, WorkspaceAutoMergePolicy, WorkspaceMergeStrategy, WorkspaceMode, WorkspaceRecord } from "./types";
 import { LAND_STRATEGIES, applyWorkspaceAction, waitForWorkspaceStatus, type WorkspaceAction } from "./workspace-actions";
 import { AUTO_MERGE_POLICIES } from "./workspace-merge";
@@ -460,6 +461,7 @@ const TOOLS: ToolDefinition[] = [
   },
   ...TEAM_TOOLS,
   ...PLAN_TOOLS,
+  ...BLACKBOARD_TOOLS,
 ];
 
 export async function postMcp(req: Request): Promise<Response> {
@@ -573,6 +575,7 @@ async function callTool(auth: McpAuthContext, params: unknown): Promise<Record<s
     else if (name === "relay_workspace_land") result = relayWorkspaceMutation(auth, "merge", args);
     else if (name.startsWith("relay_team_")) result = relayTeamTool(auth, name, args);
     else if (name.startsWith("relay_plan_")) result = relayPlanTool(auth, name, args);
+    else if (name.startsWith("relay_blackboard_")) result = relayBlackboardTool(auth, name, args);
     else throw new ValidationError(`unknown tool: ${name}`);
 
     auditToolCall(auth, name, "ok", result);

package/src/routes/blackboard.ts

@@ -0,0 +1,54 @@
+import { getAgent, getEntry, getEntryChain, listEntries } from "../db";
+import { authContextFromRequest } from "../services/auth-context";
+import { cleanString, optionalEnum } from "../validation";
+import { error, json, type Handler } from "./_shared";
+import type { BlackboardEntryKind } from "../types";
+
+const BLACKBOARD_KINDS = ["decision", "fact", "ruled_out"] as const;
+
+function isAdminContext(ctx: ReturnType<typeof authContextFromRequest>): boolean {
+  return ctx.scopes.includes("*") || ctx.scopes.includes("admin:*");
+}
+
+function routeTeamId(req: Request): string | Response {
+  const ctx = authContextFromRequest(req);
+  if (ctx.component && ctx.callerAgentId) {
+    const callerId = ctx.callerAgentId;
+    const agent = getAgent(callerId);
+    return agent?.teamId ?? error("caller has no team", 403);
+  }
+  if (ctx.component && !isAdminContext(ctx)) return error("caller has no team", 403);
+  const teamId = cleanString(new URL(req.url).searchParams.get("team") ?? undefined, "team", { required: true, max: 120 });
+  return teamId!;
+}
+
+function routeKind(req: Request): BlackboardEntryKind | undefined {
+  return optionalEnum(new URL(req.url).searchParams.get("kind") ?? undefined, "kind", BLACKBOARD_KINDS) as BlackboardEntryKind | undefined;
+}
+
+export const getBlackboardRoute: Handler = (req) => {
+  try {
+    const teamId = routeTeamId(req);
+    if (teamId instanceof Response) return teamId;
+    return json({ entries: listEntries(teamId, { kind: routeKind(req) }) });
+  } catch (err) {
+    return error(err instanceof Error ? err.message : "blackboard route failed");
+  }
+};
+
+export const getBlackboardEntryRoute: Handler = (req, params) => {
+  try {
+    const id = cleanString(params.id, "id", { required: true, max: 120 })!;
+    const entry = getEntry(id);
+    if (!entry) return error("blackboard entry not found", 404);
+    const ctx = authContextFromRequest(req);
+    if (ctx.component && ctx.callerAgentId) {
+      const agent = getAgent(ctx.callerAgentId);
+      if (!agent?.teamId || agent.teamId !== entry.teamId) return error("blackboard entry not found", 404);
+    }
+    if (ctx.component && !ctx.callerAgentId && !isAdminContext(ctx)) return error("blackboard entry not found", 404);
+    return json({ entry, chain: getEntryChain(id) });
+  } catch (err) {
+    return error(err instanceof Error ? err.message : "blackboard route failed");
+  }
+};

package/src/routes/index.ts

@@ -27,6 +27,7 @@ import { getInsightsConfigRoute, getInsightsObservationsRoute, postInsightsObser
 import { getOrchestratorDirectories, getOrchestratorFileRead, getOrchestratorFileStat, getOrchestratorFilesList, getOrchestratorLogs, getOrchestratorProviders, getOrchestratorSessions, getOrchestratorTerminal, getOrchestratorVersion, getOrchestratorWorkspaceProbe, postOrchestratorCreateDirectory, postOrchestratorTerminalInput, postOrchestratorTerminalResize } from "./orchestrator-proxy";
 import { getPairById, getPairs, postAcceptPair, postHangupPair, postPair, postPairMessage, postRejectPair } from "./pairs";
 import { getPlanByIdRoute, getPlansRoute } from "./plans";
+import { getBlackboardEntryRoute, getBlackboardRoute } from "./blackboard";
 import { getRecipeByName, getRecipeInstanceArtifacts, getRecipeInstanceById, getRecipeInstances, getRecipes, postRecipeInstanceArtifacts, postRecipeStart, postRecipeStop } from "./recipes";
 import { getStewardConfigRoute, getWorkspaceConfigRoute, putStewardConfigRoute, putWorkspaceConfigRoute } from "./steward";
 import { getTaskById, getTaskEvents, getTasks, patchTaskStatus, postClaimTask, postRenewTaskClaim } from "./tasks";
@@ -267,6 +268,8 @@ const routes: Route[] = [
   route("POST", "/api/pairs/:id/messages", postPairMessage),
   route("GET", "/api/plans", getPlansRoute),
   route("GET", "/api/plans/:id", getPlanByIdRoute),
+  route("GET", "/api/blackboard", getBlackboardRoute),
+  route("GET", "/api/blackboard/:id", getBlackboardEntryRoute),
 
   route("GET", "/api/spec", getApiSpec),
   route("GET", "/api/docs", getApiDocs),

package/src/routes/plans.ts

@@ -5,10 +5,16 @@ import { error, json, parseQueryInt, type Handler } from "./_shared";
 
 export const getPlansRoute: Handler = (req) => {
   const url = new URL(req.url);
-  const threadId = parseQueryInt(url.searchParams.get("threadId"), { min: 1, max: Number.MAX_SAFE_INTEGER });
-  if (threadId === null) return error("threadId required");
-  if (Number.isNaN(threadId)) return error("threadId must be a positive integer");
   const channel = cleanString(url.searchParams.get("channel") ?? undefined, "channel", { max: 120 });
+  const teamId = cleanString(url.searchParams.get("teamId") ?? undefined, "teamId", { max: 120 });
+  if (teamId) {
+    const plan = getPlanGraph({ teamId, channel });
+    return plan ? json(plan) : error("plan not found", 404);
+  }
+  const rawThreadId = url.searchParams.get("threadId");
+  if (rawThreadId === null) return error("threadId or teamId required");
+  const threadId = parseQueryInt(rawThreadId, { min: 1, max: Number.MAX_SAFE_INTEGER });
+  if (Number.isNaN(threadId)) return error("threadId must be a positive integer");
   const plan = getPlanGraph({ threadId, channel });
   return plan ? json(plan) : error("plan not found", 404);
 };

package/src/security.ts

@@ -205,6 +205,7 @@ export function requiredScopeFor(method: string, pathname: string): string | nul
   if (pathname.startsWith("/api/tasks")) return method === "GET" ? "task:read" : "task:write";
   if (pathname.startsWith("/api/pairs")) return method === "GET" ? "pairs:read" : "pairs:write";
   if (pathname.startsWith("/api/teams")) return method === "GET" ? "teams:read" : "teams:write";
+  if (pathname.startsWith("/api/blackboard")) return method === "GET" ? "blackboard:read" : "blackboard:write";
   // Insights config (the feature toggle) stays admin-only via the default; only the
   // mechanical observation feed is writable by lower-privilege callers.
   if (pathname === "/api/insights/observations") return method === "GET" ? "insights:read" : "insights:write";
@@ -280,6 +281,7 @@ export function requiredComponentScopeFor(method: string, pathname: string): str
   if (pathname.startsWith("/api/orchestrators")) return method === "GET" ? "agent:read" : "command:write";
   if (pathname.startsWith("/api/plans")) return method === "GET" ? "plans:read" : "plans:write";
   if (pathname.startsWith("/api/teams")) return method === "GET" ? "teams:read" : "teams:write";
+  if (pathname.startsWith("/api/blackboard")) return method === "GET" ? "blackboard:read" : "blackboard:write";
   // The Runner posts the #184 context-gathering signal here (source:"server") via its
   // provider token. Without this case the path fell through to the system:admin default
   // below and every observation was 403-dropped — the whole Insights feed stayed empty.

package/src/services/plan-graph.ts

@@ -1,5 +1,5 @@
 import { isRecord } from "agent-relay-sdk";
-import { createPlanRow, getPlan, getPlanByThread, planThreadExists, replacePlan, ValidationError } from "../db";
+import { createPlanRow, deletePlan, getAgent, getPlan, getPlanByTeam, getPlanByThread, planThreadExists, replacePlan, ValidationError } from "../db";
 import { emitRelayEvent } from "../events";
 import { cleanString, optionalEnum } from "../validation";
 import type { AuthContext } from "./auth-context";
@@ -173,7 +173,7 @@ function existingPlan(id: string): Plan {
   return plan;
 }
 
-function emitPlan(type: "plan.created" | "plan.changed", plan: Plan, actor: string): void {
+function emitPlan(type: "plan.created" | "plan.changed" | "plan.deleted", plan: Plan, actor: string): void {
   emitRelayEvent({ type, source: actor, subject: plan.id, data: { plan, actor } });
 }
 
@@ -185,9 +185,11 @@ export function createPlan(input: PlanCreateInput, ctx: AuthContext): Plan {
   const edges = cleanEdges(input.edges);
   validateEdges(nodes, edges);
   const actor = actorId(ctx);
+  const explicitTeamId = cleanString(input.teamId, "teamId", { max: 120 });
+  const teamId = explicitTeamId ?? (input.teamId === undefined || input.teamId === null ? getAgent(actor)?.teamId : undefined);
   const plan = createPlanRow({
     threadId,
-    teamId: cleanString(input.teamId, "teamId", { max: 120 }),
+    teamId,
     channel,
     title: cleanString(input.title, "title", { max: 240 }),
     objective: cleanString(input.objective, "objective", { max: 4000 }),
@@ -264,9 +266,19 @@ export function removePlanEdge(planId: string, edgeInput: unknown, ctx: AuthCont
   return updated;
 }
 
-export function getPlanGraph(input: { planId?: unknown; threadId?: unknown; channel?: unknown }): Plan | null {
+export function deletePlanGraph(planId: string, ctx: AuthContext): { id: string; deleted: true } {
+  const plan = existingPlan(planId);
+  const actor = actorId(ctx);
+  deletePlan(plan.id, actor);
+  emitPlan("plan.deleted", plan, actor);
+  return { id: plan.id, deleted: true };
+}
+
+export function getPlanGraph(input: { planId?: unknown; threadId?: unknown; teamId?: unknown; channel?: unknown }): Plan | null {
   const planId = cleanString(input.planId, "planId", { max: 120 });
   if (planId) return getPlan(planId);
+  const teamId = cleanString(input.teamId, "teamId", { max: 120 });
+  if (teamId) return getPlanByTeam(teamId, cleanString(input.channel, "channel", { max: 120 }));
   const threadId = cleanThreadId(input.threadId);
   return getPlanByThread(threadId, cleanString(input.channel, "channel", { max: 120 }));
 }

package/src/token-db.ts

@@ -57,7 +57,7 @@ const BUILT_IN_PROFILES: Array<Omit<TokenProfile, "createdAt" | "updatedAt">> =
     name: "Provider Agent",
     description: "Coding-agent runtime access for messages, commands, tasks, and scoped memory reads.",
     role: "provider",
-    scope: ["agent:read", "agent:write", "message:read", "message:send", "command:read", "command:write", "task:read", "task:write", "memory:read", "artifact:read", "artifact:write", "mcp:use", "plans:read", "plans:write", "teams:read", "teams:write", "insights:write"],
+    scope: ["agent:read", "agent:write", "message:read", "message:send", "command:read", "command:write", "task:read", "task:write", "memory:read", "artifact:read", "artifact:write", "mcp:use", "plans:read", "plans:write", "teams:read", "teams:write", "blackboard:read", "blackboard:write", "insights:write"],
     ttlSeconds: 24 * 60 * 60,
     builtIn: true,
     createdBy: "system",
@@ -67,7 +67,7 @@ const BUILT_IN_PROFILES: Array<Omit<TokenProfile, "createdAt" | "updatedAt">> =
     name: "Provider Child Agent",
     description: "Delegated child-agent runtime access, constrained to its parent and spawn request.",
     role: "provider",
-    scope: ["agent:read", "agent:write", "message:read", "message:send", "command:read", "command:write", "task:read", "task:write", "memory:read", "artifact:read", "artifact:write", "mcp:use", "teams:read", "insights:write"],
+    scope: ["agent:read", "agent:write", "message:read", "message:send", "command:read", "command:write", "task:read", "task:write", "memory:read", "artifact:read", "artifact:write", "mcp:use", "teams:read", "blackboard:read", "blackboard:write", "insights:write"],
     constraints: { canDelegate: false },
     ttlSeconds: 2 * 60 * 60,
     builtIn: true,
@@ -78,7 +78,7 @@ const BUILT_IN_PROFILES: Array<Omit<TokenProfile, "createdAt" | "updatedAt">> =
     name: "Provider Interactive Agent",
     description: "User-launched provider runtime access constrained to its own agent and cwd for long interactive sessions.",
     role: "provider",
-    scope: ["agent:read", "agent:write", "message:read", "message:send", "command:read", "command:write", "task:read", "task:write", "memory:read", "artifact:read", "artifact:write", "mcp:use", "teams:read", "insights:write"],
+    scope: ["agent:read", "agent:write", "message:read", "message:send", "command:read", "command:write", "task:read", "task:write", "memory:read", "artifact:read", "artifact:write", "mcp:use", "teams:read", "blackboard:read", "blackboard:write", "insights:write"],
     constraints: { terminalAttach: false, logsRead: false, canDelegate: false },
     ttlSeconds: 30 * 24 * 60 * 60,
     builtIn: true,

package/public/assets/channels-CQy-JL7o.js

@@ -1,2 +0,0 @@
-import{Cn as e,Pt as t,Sn as n,jn as r,q as i,xn as a}from"./lucide-react-ChOGD4vc.js";import{a as o,t as s}from"./store-CtKmqMfx.js";import{G as c,H as l,W as u,c as d,s as f}from"./display-ConJ9cJB.js";import{t as p}from"./badge-CFVr4fG9.js";import{t as m}from"./button-BuTu0MHx.js";import{i as h,n as g,r as _,t as v}from"./card-C3ErQ372.js";var y=r();function b({direction:t}){return t===`inbound`?(0,y.jsx)(n,{className:`w-3 h-3`}):t===`outbound`?(0,y.jsx)(a,{className:`w-3 h-3`}):(0,y.jsx)(e,{className:`w-3 h-3`})}function x({channel:e}){let n=o(),r=s(e=>e.openChannelDetail),a=d(e),f=e.status!==`offline`;return(0,y.jsxs)(v,{className:`${f?``:`opacity-60`} hover:border-zinc-600 transition-colors`,children:[(0,y.jsx)(_,{className:`pb-2 pt-4 px-4`,children:(0,y.jsxs)(`div`,{className:`flex items-start gap-2`,children:[(0,y.jsx)(`div`,{className:`p-1.5 rounded-md ${f?`bg-blue-500/10`:`bg-zinc-800`}`,children:(0,y.jsx)(i,{className:`w-4 h-4 ${f?`text-blue-400`:`text-zinc-500`}`})}),(0,y.jsxs)(`div`,{className:`flex-1 min-w-0`,children:[(0,y.jsx)(h,{className:`text-sm font-medium truncate`,children:e.name||e.id}),(0,y.jsxs)(`div`,{className:`text-xs text-muted-foreground mt-0.5`,children:[e.type,` · `,e.transport]})]}),(0,y.jsx)(p,{className:`text-[10px] shrink-0 ${u(a.tone)}`,children:a.label})]})}),(0,y.jsxs)(g,{className:`px-4 pb-4 space-y-2.5`,children:[(0,y.jsxs)(`div`,{className:`flex items-center gap-1.5 text-xs text-muted-foreground`,children:[(0,y.jsx)(b,{direction:e.direction}),(0,y.jsx)(`span`,{className:`capitalize`,children:e.direction}),e.target&&(0,y.jsxs)(y.Fragment,{children:[(0,y.jsx)(`span`,{children:`·`}),(0,y.jsx)(`span`,{className:`truncate text-foreground`,children:e.target})]})]}),e.targetHealth&&e.targetHealth.status!==`ok`&&(0,y.jsx)(`div`,{className:`text-xs px-2 py-1 rounded ${e.targetHealth.status===`error`?`bg-red-500/10 text-red-400`:`bg-yellow-500/10 text-yellow-400`}`,children:e.targetHealth.detail}),c(e.capabilities).length>0&&(0,y.jsx)(`div`,{className:`flex flex-wrap gap-1`,children:c(e.capabilities).map(e=>(0,y.jsx)(p,{variant:`secondary`,className:`text-[9px] px-1 py-0 h-4`,children:e},e))}),e.tags.length>0&&(0,y.jsx)(`div`,{className:`flex flex-wrap gap-1`,children:e.tags.map(e=>(0,y.jsx)(p,{variant:`outline`,className:`text-[9px] px-1 py-0 h-4`,children:e},e))}),(0,y.jsxs)(`div`,{className:`flex items-center justify-between pt-0.5`,children:[(0,y.jsx)(`span`,{className:`text-xs text-muted-foreground`,children:l(n,e.lastSeen)}),(0,y.jsxs)(m,{size:`sm`,variant:`outline`,className:`h-7 text-xs gap-1`,onClick:()=>r(e),children:[(0,y.jsx)(t,{className:`w-3 h-3`}),`Details`]})]})]})]})}function S(){let e=s(e=>e.channels),t=e.filter(f).length,n=e.filter(e=>e.targetHealth?.status===`error`).length,r=e.filter(e=>e.targetHealth?.status===`warning`).length;return(0,y.jsxs)(`div`,{className:`space-y-4`,children:[(0,y.jsxs)(`div`,{className:`flex items-center gap-3`,children:[(0,y.jsxs)(`div`,{children:[(0,y.jsx)(`h2`,{className:`text-base font-semibold`,children:`Channels`}),(0,y.jsx)(`p`,{className:`text-xs text-muted-foreground`,children:`Inbound / outbound message integrations`})]}),(0,y.jsxs)(`div`,{className:`flex items-center gap-2 ml-auto`,children:[t>0&&(0,y.jsxs)(p,{className:`text-xs bg-emerald-500/15 text-emerald-400 border-emerald-500/30`,children:[t,` ready`]}),r>0&&(0,y.jsxs)(p,{className:`text-xs bg-yellow-500/15 text-yellow-400 border-yellow-500/30`,children:[r,` warning`]}),n>0&&(0,y.jsxs)(p,{className:`text-xs bg-red-500/15 text-red-400 border-red-500/30`,children:[n,` error`]})]})]}),e.length===0?(0,y.jsx)(`div`,{className:`text-center py-16 text-muted-foreground text-sm`,children:`No channels registered.`}):(0,y.jsx)(`div`,{className:`grid grid-cols-1 md:grid-cols-2 xl:grid-cols-3 gap-4`,children:e.map(e=>(0,y.jsx)(x,{channel:e},e.id))})]})}export{S as ChannelsView};
-//# sourceMappingURL=channels-CQy-JL7o.js.map