@agentprojectcontext/apx 1.80.2 → 1.89.1

package/src/interfaces/mcp-server/index.js

@@ -4,12 +4,15 @@
 //
 // Tool surface:
 //   agent_list        — list agents in the current project
+//   agent_create      — create an agent, including its system prompt
+//   agent_set_prompt  — replace an existing agent's system prompt
 //   agent_exec        — quick one-shot LLM call via apx exec
 //   agent_run         — launch a full runtime session
 //   memory_read       — read an agent's memory.md
 //   memory_append     — append a fact to agent memory
 //   messages_tail     — recent messages (all channels or filtered)
 //   session_list      — list sessions for an agent
+//   org_list          — areas + roles an agent can be assigned to
 //   mcp_list          — list project+global MCPs
 //   mcp_call          — call a project MCP tool
 
@@ -19,6 +22,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
 import { findApfRoot } from "#core/apc/parser.js";
+import { AGENT_TYPES, AGENT_TYPE_VALUES, BLOB_KEYS } from "#core/apc/agent-identity.js";
 // Was "../../cli/http.js", which resolves to src/cli/http.js — a path that
 // does not exist, so this binary could not load at all. Use the alias
 // (AGENTS.md rule 7) so the same mistake cannot recur silently.
@@ -71,6 +75,89 @@ server.tool(
   }
 );
 
+// agent_create
+//
+// `prompt` is the agent's instruction set, stored as the body of
+// `.apc/agents/<slug>.md` and injected by buildAgentSystem() as "# Custom
+// instructions". It is required, not optional: an agent created from metadata
+// alone (role + description) has nothing telling it what to do, and that
+// failure is silent — which is exactly how it kept happening.
+server.tool(
+  "agent_create",
+  "Create a project agent. `prompt` is the agent's system prompt (its actual instructions) and is required — `description` is one line of metadata and is NOT a substitute for it.",
+  {
+    slug: z.string().describe("Agent slug (lowercase, a-z0-9_-)"),
+    prompt: z.string().min(1).describe("The agent's system prompt: persona, responsibilities, rules, hard limits. Markdown, multi-line."),
+    type: z.enum(AGENT_TYPE_VALUES).optional().describe(
+      `Typology — ${AGENT_TYPES.map((t) => `${t.value}: ${t.description}`).join(" ")} 'orchestrator' also makes the agent a master (it gets sub-agents).`
+    ),
+    role: z.string().optional().describe("Role slug from the project org chart (see org_list), or free text. Shown as a badge on the agent card."),
+    area: z.string().optional().describe("Area slug from the project org chart (see org_list). Groups the agent in the team view."),
+    description: z.string().optional().describe("One-line summary shown in agent listings"),
+    model: z.string().optional().describe("Model override, e.g. 'zen:big-pickle'. Omit to follow the project default"),
+    language: z.string().optional().describe("Default response language, e.g. 'es' or 'es-AR'"),
+    parent: z.string().optional().describe("Slug of the orchestrator this agent reports to"),
+    icon: z.enum(BLOB_KEYS).optional().describe("Avatar blob preset. Omit and one is picked from the blobs this project isn't using yet."),
+    skills: z.array(z.string()).optional().describe("Skill names to load for this agent"),
+    tools: z.array(z.string()).optional().describe("Tool names. Omit for the safe default set"),
+  },
+  async ({ slug, prompt, type, role, area, description, model, language, parent, icon, skills, tools }) => {
+    const proj = await resolveProject();
+    const created = await http.post(`/api/projects/${proj.id}/agents`, {
+      slug, system: prompt, type, role, area, description, model, language, parent, icon, skills, tools,
+    });
+    const bits = [
+      `Created agent ${created.slug}`,
+      `prompt ${Buffer.byteLength(prompt)} bytes`,
+      `avatar ${created.icon}`,
+    ];
+    if (created.type) bits.push(`type ${created.type}`);
+    if (created.area) bits.push(`area ${created.area}`);
+    if (created.role) bits.push(`role ${created.role}`);
+    return { content: [{ type: "text", text: bits.join(" · ") + "." }] };
+  }
+);
+
+// org_list — the vocabulary agent_create's `area` / `role` draw from.
+server.tool(
+  "org_list",
+  "List the project's org chart: the areas and roles an agent can be assigned to (`.apc/organization.json`). Call this before agent_create if you want to place the agent in the org structure.",
+  {},
+  async () => {
+    const proj = await resolveProject();
+    const org = await http.get(`/api/projects/${proj.id}/organization`);
+    const areas = (org.areas || []).map((a) => `area  ${a.slug}  ${a.name}`);
+    const roles = (org.roles || []).map((r) => `role  ${r.slug}  ${r.name}${r.area ? `  (area: ${r.area})` : ""}`);
+    const rows = [...areas, ...roles];
+    return {
+      content: [{
+        type: "text",
+        text: rows.join("\n") || "(no areas or roles defined — `role` and `area` accept free text too)",
+      }],
+    };
+  }
+);
+
+// agent_set_prompt
+server.tool(
+  "agent_set_prompt",
+  "Replace an existing agent's system prompt (the body of its definition file). Use this to give instructions to an agent that was created without them.",
+  {
+    slug: z.string().describe("Agent slug"),
+    prompt: z.string().min(1).describe("The full replacement system prompt (not a patch)"),
+  },
+  async ({ slug, prompt }) => {
+    const proj = await resolveProject();
+    await http.patch(`/api/projects/${proj.id}/agents/${slug}`, { system: prompt });
+    return {
+      content: [{
+        type: "text",
+        text: `Updated ${slug}: system prompt is now ${Buffer.byteLength(prompt)} bytes.`,
+      }],
+    };
+  }
+);
+
 // agent_exec
 server.tool(
   "agent_exec",

package/src/interfaces/tui/_shims/util-locale.ts

@@ -99,6 +99,4 @@ export const Locale = {
   truncateLeft,
   truncateMiddle,
   pluralize,
-  // legacy alias kept for any callers expecting `format`
-  format: (n: number) => String(n),
 }

package/src/interfaces/tui/app.tsx

@@ -154,9 +154,6 @@ export function tui(input: {
   config: TuiConfig.Resolved
   onSnapshot?: () => Promise<string[]>
   directory?: string
-  fetch?: typeof fetch
-  headers?: RequestInit["headers"]
-  events?: unknown
 }) {
   // promise to prevent immediate exit
   // oxlint-disable-next-line no-async-promise-executor -- intentional: async executor used for sequential setup before resolve
@@ -211,9 +208,6 @@ export function tui(input: {
                           agent={input.agent}
                           model={input.model}
                           directory={input.directory}
-                          fetch={input.fetch}
-                          headers={input.headers}
-                          events={input.events}
                         >
                           <ProjectProvider>
                             <ApxSyncProvider>

package/src/interfaces/tui/attach.ts

@@ -91,7 +91,6 @@ export const AttachCommand = cmd({
           fork: args.fork,
         },
         directory,
-        headers,
       })
     } finally {
       unguard?.()

package/src/interfaces/tui/context/sdk-apx.tsx

@@ -56,11 +56,7 @@ export const { use: useSDK, provider: SDKProvider } = createSimpleContext({
     pid: string
     agent?: string
     model?: string
-    // Legacy compat props (unused but accepted to avoid prop errors)
     directory?: string
-    fetch?: typeof fetch
-    headers?: RequestInit["headers"]
-    events?: unknown
   }) => {
     const abort = new AbortController()
     const emitter = createGlobalEmitter<{ event: ApxEvent }>()

package/src/interfaces/tui/plugin/api.tsx

@@ -17,7 +17,6 @@ import { Slot as HostSlot } from "./slots"
 import type { useToast } from "../ui/toast"
 import { InstallationVersion } from "@opencode-ai/core/installation/version"
 import * as Keymap from "../keymap"
-import { createCommandShim } from "./command-shim"
 
 type RouteEntry = {
   key: symbol
@@ -206,8 +205,6 @@ export function createTuiApi(input: Input): TuiPluginApi {
   }
   return {
     app: appApi(),
-    // Keep deprecated `api.command` working for v1 plugins; remove in v2.
-    command: createCommandShim(input.keymap, input.dialog, input.tuiConfig.keybinds),
     keys: {
       formatSequence(parts) {
         return Keymap.formatKeySequence(parts, input.tuiConfig)

package/src/interfaces/tui/plugin/runtime.ts

@@ -38,7 +38,6 @@ import { INTERNAL_TUI_PLUGINS, type InternalTuiPlugin } from "./internal"
 import { setupSlots, Slot as View } from "./slots"
 import type { HostPluginApi, HostSlots } from "./slots"
 import { ConfigPlugin } from "@/config/plugin"
-import { createCommandShim } from "./command-shim"
 
 ensureRuntimePluginSupport({ additional: keymapRuntimeModules })
 
@@ -576,8 +575,6 @@ function pluginApi(runtime: RuntimeState, plugin: PluginEntry, scope: PluginScop
 
   return {
     app: api.app,
-    // Keep deprecated `api.command` working for v1 plugins; remove in v2.
-    command: createCommandShim(keymap, api.ui.dialog, api.tuiConfig.keybinds),
     keys: api.keys,
     keymap,
     route,

package/src/interfaces/tui/thread.ts

@@ -9,8 +9,6 @@ import { errorMessage } from "@/util/error"
 import { withTimeout } from "@/util/timeout"
 import { withNetworkOptions, resolveNetworkOptionsNoConfig } from "@/cli/network"
 import { Filesystem } from "@/util/filesystem"
-import type { GlobalEvent } from "@opencode-ai/sdk/v2"
-import type { EventSource } from "./context/sdk"
 import { win32DisableProcessedInput, win32InstallCtrlCGuard } from "./win32"
 import { writeHeapSnapshot } from "v8"
 import { TuiConfig } from "./config/tui"
@@ -46,16 +44,6 @@ function createWorkerFetch(client: RpcClient): typeof fetch {
   return fn as typeof fetch
 }
 
-function createEventSource(client: RpcClient): EventSource {
-  return {
-    subscribe: async (handler) => {
-      return client.on<GlobalEvent>("global.event", (e) => {
-        handler(e)
-      })
-    },
-  }
-}
-
 async function target() {
   if (typeof OPENCODE_WORKER_PATH !== "undefined") return OPENCODE_WORKER_PATH
   const dist = new URL("./cli/cmd/tui/worker.js", import.meta.url)
@@ -202,12 +190,10 @@ export const TuiThreadCommand = cmd({
         ? {
             url: (await client.call("server", network)).url,
             fetch: undefined,
-            events: undefined,
           }
         : {
             url: "http://opencode.internal",
             fetch: createWorkerFetch(client),
-            events: createEventSource(client),
           }
 
       try {
@@ -238,8 +224,6 @@ export const TuiThreadCommand = cmd({
           },
           config,
           directory: cwd,
-          fetch: transport.fetch,
-          events: transport.events,
           args: {
             continue: args.continue,
             sessionID: args.session,

package/src/interfaces/web/README.md

@@ -4,8 +4,10 @@ Local-first React app served by the daemon. Operates every part of APX
 (config, channels, projects, agents, routines, sessions, models, MCPs,
 tasks) without leaving the browser.
 
-> Spec: [spec/backlog/08-web-admin-panel.md](../../../spec/backlog/08-web-admin-panel.md) ·
-> No-Radix decision: [spec/decisions/005-no-radix-on-web-panel.md](../../../spec/decisions/005-no-radix-on-web-panel.md).
+> Rules: [`rules/web-ui.md`](../../../rules/web-ui.md) (how-to) ·
+> [`rules/enforcement.md`](../../../rules/enforcement.md) (what is actually gated) ·
+> No-Radix decision: [`rules/decisions/005`](../../../rules/decisions/005-no-radix-on-web-panel.md).
+> The panel's own backlog is local-only under `spec/` and not linked from here.
 
 ## Stack
 
@@ -20,22 +22,28 @@ tasks) without leaving the browser.
 
 ```
 src/
-├── main.tsx                 ← React 19 root + Router
-├── App.tsx                  ← layout shell (sidebar + main)
-├── styles.css               ← Tailwind + theme tokens (dark default)
+├── main.tsx        ← React 19 root + Router
+├── App.tsx         ← layout shell (sidebar + main)
+├── styles.css      ← Tailwind + theme tokens (dark default)
 ├── lib/
-│   ├── api.ts               ← typed daemon client (Bearer auth)
-│   └── cn.ts                ← clsx + tailwind-merge
-├── hooks/
-│   └── useTokenBootstrap.ts ← reads /api/admin/web-token on first paint
+│   ├── api/        ← ONE FILE PER RESOURCE (agents, routines, projects, …)
+│   │                 uniform `export const X = {list,get,add,remove}`
+│   ├── http.ts     ← the single typed client; Bearer auto-fetched
+│   └── …           ← cn, live, notify, pwa, when, …
+├── i18n/           ← en.ts + es.ts — every key in BOTH, always
 ├── components/
-│   ├── ProjectSidebar.tsx   ← rail of avatars (APX + projects)
-│   └── Section.tsx          ← card primitive + small UI atoms
+│   ├── ui/         ← curated Base UI primitives, behind the ui.tsx barrel
+│   └── …
 └── screens/
-    ├── ApxAdminScreen.tsx   ← default landing: global config / status
-    └── ProjectScreen.tsx    ← per-project nav: overview, config, agents, routines, tasks, mcps, threads
+    └── modules/    ← one module per project area
 ```
 
+**`lib/api/` is the rule, not a suggestion.** Nothing in the panel calls
+`fetch` directly — `tests/web-guardrails.test.js` fails the build if it does.
+This README described a single `lib/api.ts` long after it had been split into
+one file per resource; that shape is now a reference implementation in
+[`rules/architecture.md`](../../../rules/architecture.md).
+
 ## Talks to the daemon
 
 The panel only consumes endpoints that already exist in `src/host/daemon/api/`.
@@ -55,7 +63,7 @@ daemon surface, WebSocket included) → `127.0.0.1:7430`. Hot reload, real daemo
 Each project's `.apc/project.json` may include an optional `kind`:
 
 ```json
-{ "name": "iacrmar", "apx_id": "...", "kind": "company" }
+{ "name": "acme", "apx_id": "...", "kind": "company" }
 ```
 
 Recognised values (extensible, the daemon doesn't enforce anything special):