@agentprojectcontext/apx 1.32.0 → 1.33.0

package/src/host/daemon/api/code.js

@@ -12,9 +12,10 @@
 // stateful: the turn handler rebuilds `previousMessages` from the stored
 // transcript, runs the super-agent on the `code` channel (with plan/build mode
 // + per-mode tool gating), then persists the rich assistant turn.
-import { runSuperAgent } from "../super-agent.js";
+import { runSuperAgent } from "#core/agent/super-agent.js";
 import { appendSuperAgentErrorTrace } from "./shared.js";
-import { createWebConfirmAdapter } from "../../../core/confirmation/adapters/web.js";
+import { createWebConfirmAdapter } from "#core/confirmation/adapters/web.js";
+import { CHANNELS } from "#core/constants/channels.js";
 import {
   listCodeSessions,
   getCodeSession,
@@ -22,9 +23,10 @@ import {
   updateCodeSession,
   removeCodeSession,
   appendTurn,
-} from "../../../core/code-sessions-store.js";
-import { captureBaseline, diffAgainstBaseline, initGitRepo } from "../../../core/git-baseline.js";
-import { loggerFor } from "../../../core/logging.js";
+} from "#core/stores/code-sessions.js";
+import { captureBaseline, diffAgainstBaseline, initGitRepo } from "#core/git-baseline.js";
+import { loggerFor } from "#core/logging.js";
+import { readAgents } from "#core/apc/parser.js";
 
 const log = loggerFor("code");
 
@@ -80,20 +82,51 @@ function modeGuidanceFor(mode) {
     "for choices. Prefer 2–4 mutually-exclusive options when a question has a",
     "natural shortlist (yes/no, which-of-these, …); leave options empty for",
     "open-ended answers (API keys, names, free-form ideas).",
+    "If the previous assistant turn already asked these same questions and the",
+    "current user message is the compiled answers, DO NOT call ask_questions",
+    "again — process the answers and proceed with the task.",
   ].join(" ");
 }
 
 // Build the [{role, content}] history the super-agent expects from the stored
-// rich transcript: flatten each turn's text parts (tool parts are internal).
+// rich transcript: flatten each turn's text parts. Tool parts are normally
+// internal, but ask_questions is special — without surfacing it the model
+// loses track that it ALREADY asked, sees the user's compiled-answer reply
+// as a fresh request, and asks again forever. We render a one-line synthetic
+// summary of each ask_questions call so the next turn's context shows
+// "I asked X, the user replied Y" naturally.
+function summarizeAskQuestionsPart(part) {
+  const raw = part?.args?.questions;
+  if (!Array.isArray(raw) || raw.length === 0) return null;
+  const lines = raw
+    .map((q) => {
+      if (typeof q === "string") return `- ${q}`;
+      if (!q || typeof q !== "object" || typeof q.question !== "string") return null;
+      const opts = Array.isArray(q.options) ? q.options : [];
+      const optStr = opts
+        .map((o) => (typeof o === "string" ? o : (o && typeof o.label === "string" ? o.label : "")))
+        .filter(Boolean)
+        .join(", ");
+      return optStr ? `- ${q.question} (opciones: ${optStr})` : `- ${q.question}`;
+    })
+    .filter(Boolean);
+  if (lines.length === 0) return null;
+  return `[ask_questions]\n${lines.join("\n")}`;
+}
+
 function historyFrom(session) {
-  return (session.messages || []).map((m) => ({
-    role: m.role,
-    content: (m.parts || [])
-      .filter((p) => p && p.kind === "text" && p.text)
-      .map((p) => p.text)
-      .join("\n\n")
-      .trim(),
-  }));
+  return (session.messages || []).map((m) => {
+    const chunks = [];
+    for (const p of m.parts || []) {
+      if (!p) continue;
+      if (p.kind === "text" && p.text) chunks.push(p.text);
+      else if (p.kind === "tool" && p.tool === "ask_questions") {
+        const summary = summarizeAskQuestionsPart(p);
+        if (summary) chunks.push(summary);
+      }
+    }
+    return { role: m.role, content: chunks.join("\n\n").trim() };
+  });
 }
 
 // Accumulate stream events into the rich ChatPart shape so the persisted
@@ -180,7 +213,7 @@ export function register(app, { projects, project, config, registries, plugins }
   app.post("/projects/:pid/code/sessions", (req, res) => {
     const p = findProject(req, res);
     if (!p) return;
-    const { title, model, mode } = req.body || {};
+    const { title, model, mode, agentSlug } = req.body || {};
     let git = captureBaseline(p.path);
     // No baseline because the project isn't a git repo yet. For real projects
     // (not the default apx home, id 0) init one so the "changes" diff works —
@@ -198,6 +231,7 @@ export function register(app, { projects, project, config, registries, plugins }
       title,
       model,
       mode,
+      agentSlug: agentSlug || null,
       git,
     });
     res.status(201).json(session);
@@ -259,6 +293,15 @@ export function register(app, { projects, project, config, registries, plugins }
     const mode = session.mode === "plan" ? "plan" : "build";
     const previousMessages = historyFrom(session);
 
+    // If a project agent is selected, inject its system prompt as a suffix so
+    // the super-agent's tool loop runs with the agent's personality/context.
+    let agentSystemSuffix = "";
+    if (session.agentSlug) {
+      const agents = readAgents(p.path);
+      const agent = agents.find((a) => a.slug === session.agentSlug);
+      if (agent?.body) agentSystemSuffix = `\n\n## Agente seleccionado: ${session.agentSlug}\n${agent.body}`;
+    }
+
     // Persist the user turn immediately so a crash mid-stream still records it.
     appendTurn(p.storagePath, session.id, {
       role: "user",
@@ -285,15 +328,17 @@ export function register(app, { projects, project, config, registries, plugins }
         plugins,
         registries,
         prompt,
-        channel: "code",
+        channel: CHANNELS.WEB_CODE,
         channelMeta: {
           projectId: String(p.id),
           projectName: p.name,
           projectPath: p.path,
           mode,
           modeGuidance: modeGuidanceFor(mode),
+          agentSlug: session.agentSlug || null,
         },
         previousMessages,
+        systemSuffix: agentSystemSuffix,
         overrideModel: session.model || undefined,
         allowedTools: mode === "plan" ? PLAN_TOOLS : "*",
         // Coding tasks are multi-step: give the loop a high safety ceiling so it
@@ -349,7 +394,7 @@ export function register(app, { projects, project, config, registries, plugins }
       });
       appendSuperAgentErrorTrace(req, e, {
         prompt,
-        channel: "code",
+        channel: CHANNELS.WEB_CODE,
         previousMessages,
         model: session.model,
         stream: true,

package/src/host/daemon/api/confirm.js

@@ -8,7 +8,7 @@
 // Promise in the agent loop, unblocking it to continue with confirmed: true
 // or to return a cancelled error.
 
-import { getConfirmationStore } from "../../../core/confirmation/pending-store.js";
+import { getConfirmationStore } from "#core/confirmation/pending-store.js";
 
 export function register(app) {
   app.post("/super-agent/confirm/:correlationId", async (req, res) => {

package/src/host/daemon/api/connections.js

@@ -1,7 +1,7 @@
 // GET /projects/:pid/agents/:slug/connections
 // Builds a per-peer summary of an agent's a2a traffic from the messages store.
-import { readAgents } from "../../../core/parser.js";
-import { readProjectMessages } from "../../../core/messages-store.js";
+import { readAgents } from "#core/apc/parser.js";
+import { readProjectMessages } from "#core/stores/messages.js";
 
 export function register(app, { project }) {
   app.get("/projects/:pid/agents/:slug/connections", (req, res) => {

package/src/host/daemon/api/conversations.js

@@ -6,8 +6,8 @@
 //   POST /projects/:pid/send                                   (agent-to-agent)
 import fs from "node:fs";
 import path from "node:path";
-import { readAgents } from "../../../core/parser.js";
-import { callEngine } from "../../../core/engines/index.js";
+import { readAgents } from "#core/apc/parser.js";
+import { callEngine } from "#core/engines/index.js";
 import { listConversations, readConversation } from "../conversations.js";
 import { compactConversation } from "../compact.js";
 import { nowIso } from "./shared.js";

package/src/host/daemon/api/deck.js

@@ -226,7 +226,7 @@ export function register(app, ctx) {
     // the override we're about to set; we mutate ONLY the override and
     // leave everything else intact.
     try {
-      const { readConfig, writeConfig } = await import("../../../core/config.js");
+      const { readConfig, writeConfig } = await import("#core/config/index.js");
       const fresh = readConfig();
       fresh.deck = fresh.deck && typeof fresh.deck === "object" ? fresh.deck : {};
       fresh.deck.widget_overrides =

package/src/host/daemon/api/desktop.js

@@ -15,7 +15,7 @@ import {
   autostartIsOn,
   autostartInstall,
   autostartUninstall,
-} from "../../../core/desktop/autostart.js";
+} from "#core/desktop/autostart.js";
 
 export function register(app, { plugins }) {
   app.get("/desktop/status", (_req, res) => {

package/src/host/daemon/api/embeddings.js

@@ -8,15 +8,15 @@
 //   POST /embeddings/reindex    → { ok, cleared, indexed }  (rebuild the vector
 //                                   store under the current embedder — needed
 //                                   after switching provider/model)
-import { readConfig } from "../../../core/config.js";
+import { readConfig } from "#core/config/index.js";
 import {
   listAvailableEmbedEngines,
   embeddingsConfig,
   resolveMode,
   resolveChainOrder,
-} from "../../../core/memory/embed-engines/index.js";
-import { embedOne } from "../../../core/memory/embeddings.js";
-import { reindexMemory } from "../../../core/memory/index.js";
+} from "#core/memory/embed-engines/index.js";
+import { embedOne } from "#core/memory/embeddings.js";
+import { reindexMemory } from "#core/memory/index.js";
 
 export function register(app) {
   app.get("/embeddings/providers", async (_req, res) => {

package/src/host/daemon/api/engines.js

@@ -1,8 +1,8 @@
 // GET  /engines            — list engine adapter ids known to core/engines.
 // POST /engines/models      — live model catalog from a provider.
 // GET  /engines/models      — legacy (Ollama only, no auth).
-import { ENGINE_IDS } from "../../../core/engines/index.js";
-import { fetchJsonWithTimeout } from "../../../core/engines/_health.js";
+import { ENGINE_IDS } from "#core/engines/index.js";
+import { fetchJsonWithTimeout } from "#core/engines/_health.js";
 
 const DEFAULT_BASE = {
   openai:     "https://api.openai.com/v1",

package/src/host/daemon/api/exec.js

@@ -4,9 +4,10 @@
 //
 //   POST /projects/:pid/agents/:slug/exec     one-shot, no history
 //   POST /projects/:pid/agents/:slug/chat     append to (or start) a conversation
-import { callEngine } from "../../../core/engines/index.js";
-import { readAgents } from "../../../core/parser.js";
-import { buildAgentSystem } from "../../../core/agent-system.js";
+import { callEngine } from "#core/engines/index.js";
+import { readAgents } from "#core/apc/parser.js";
+import { buildAgentSystem } from "#core/agent/build-agent-system.js";
+import { resolveActiveModel } from "#core/agent/model-router.js";
 import {
   startConversation,
   appendTurn,
@@ -14,6 +15,20 @@ import {
   setStatus,
 } from "../conversations.js";
 
+// Pick a model for a direct agent chat: explicit override → agent's own model →
+// super-agent default (resolved via the same router the super-agent uses, so
+// it walks the fallback chain when the primary is empty/unhealthy).
+async function pickAgentModel({ modelOverride, agent, config }) {
+  if (modelOverride) return modelOverride;
+  if (agent.fields?.Model) return agent.fields.Model;
+  try {
+    const routing = await resolveActiveModel(config);
+    return routing?.modelId || null;
+  } catch {
+    return null;
+  }
+}
+
 export function register(app, { projects, project, config }) {
   app.post("/projects/:pid/agents/:slug/exec", async (req, res) => {
     const p = project(req, res);
@@ -28,7 +43,7 @@ export function register(app, { projects, project, config }) {
     const agents = readAgents(p.path);
     const agent = agents.find((a) => a.slug === req.params.slug);
     if (!agent) return res.status(404).json({ error: "agent not found" });
-    const modelId = modelOverride || agent.fields.Model;
+    const modelId = await pickAgentModel({ modelOverride, agent, config });
     if (!modelId)
       return res
         .status(400)
@@ -106,7 +121,7 @@ export function register(app, { projects, project, config }) {
     const agents = readAgents(p.path);
     const agent = agents.find((a) => a.slug === req.params.slug);
     if (!agent) return res.status(404).json({ error: "agent not found" });
-    const modelId = modelOverride || agent.fields.Model;
+    const modelId = await pickAgentModel({ modelOverride, agent, config });
     if (!modelId)
       return res
         .status(400)

package/src/host/daemon/api/identity.js

@@ -1,6 +1,6 @@
 // GET   /identity            full identity.json
 // PATCH /identity            { agent_name?, owner_name?, personality?, owner_context?, language?, timezone? }
-import { readIdentity, writeIdentity } from "../../../core/identity.js";
+import { readIdentity, writeIdentity } from "#core/identity/index.js";
 
 const ALLOWED_KEYS = new Set([
   "agent_name",

package/src/host/daemon/api/mcps.js

@@ -18,7 +18,7 @@ import {
   runtimeMcpsPath,
   globalMcpsPath,
   SOURCES,
-} from "../../../core/mcp/sources.js";
+} from "#core/mcp/sources.js";
 
 // scope alias used by API/CLI -> internal source id used in entry metadata
 const SCOPE_TO_SOURCE = {

package/src/host/daemon/api/messages.js

@@ -9,7 +9,7 @@ import {
   readGlobalMessages,
   readProjectMessages,
   searchProjectMessages,
-} from "../../../core/messages-store.js";
+} from "#core/stores/messages.js";
 
 export function register(app, { project }) {
   app.get("/projects/:pid/messages", (req, res) => {

package/src/host/daemon/api/runtimes.js

@@ -7,18 +7,19 @@
 //   GET  /projects/:pid/sessions/:id/resume?summarize=true
 import fs from "node:fs";
 import path from "node:path";
-import { readAgents } from "../../../core/parser.js";
-import { readSessionFrontmatter } from "../../../core/session-store.js";
-import { buildAgentSystem } from "../../../core/agent-system.js";
+import { readAgents } from "#core/apc/parser.js";
+import { readSessionFrontmatter } from "#core/stores/sessions.js";
+import { buildAgentSystem } from "#core/agent/build-agent-system.js";
+import { CHANNELS } from "#core/constants/channels.js";
 import { getRuntime, RUNTIME_IDS } from "../runtimes/index.js";
 import { detectAll } from "../env-detect.js";
+import { buildRuntimeBridgeHint as buildApfHint } from "#core/agent/runtime-bridge.js";
 import {
-  buildApfHint,
   createRuntimeSession,
   closeRuntimeSession,
-  extractApfResult,
-} from "../apc-runtime-context.js";
-import { runSuperAgent, isSuperAgentEnabled } from "../super-agent.js";
+  extractRuntimeResult as extractApfResult,
+} from "#core/stores/runtime-sessions.js";
+import { runSuperAgent, isSuperAgentEnabled } from "#core/agent/super-agent.js";
 
 export function register(app, { projects, registries, plugins, project, config }) {
   app.get("/runtimes", (_req, res) =>
@@ -205,7 +206,7 @@ export function register(app, { projects, registries, plugins, project, config }
           plugins,
           registries,
           prompt,
-          channel: "api",
+          channel: CHANNELS.API,
           contextNote: `Resume request for session ${id}.`,
         });
         out.summary = sa.text;

package/src/host/daemon/api/sessions-search.js

@@ -4,7 +4,7 @@
 //                                  then delegates to compactConversation.
 import fs from "node:fs";
 import path from "node:path";
-import { readAgents } from "../../../core/parser.js";
+import { readAgents } from "#core/apc/parser.js";
 import { compactConversation } from "../compact.js";
 
 export function register(app, { projects, config }) {

package/src/host/daemon/api/sessions.js

@@ -4,8 +4,8 @@
 //   GET  /projects/:pid/sessions/:sid              by filename (cross-agent lookup)
 import fs from "node:fs";
 import path from "node:path";
-import { parseSessionFrontmatter, readAgents } from "../../../core/parser.js";
-import { collectAllSessions } from "../../../interfaces/cli/commands/sessions.js";
+import { parseSessionFrontmatter, readAgents } from "#core/apc/parser.js";
+import { collectAllSessions } from "#interfaces/cli/commands/sessions.js";
 import { nowIso } from "./shared.js";
 
 export function register(app, { projects, project }) {

package/src/host/daemon/api/shared.js

@@ -5,9 +5,10 @@
 import fs from "node:fs";
 import path from "node:path";
 import { randomUUID } from "node:crypto";
-import { appendErrorTrace, previewText } from "../../../core/logging.js";
-import { readAgents } from "../../../core/parser.js";
-import { agentMemoryPath } from "../../../core/agent-memory.js";
+import { appendErrorTrace, previewText } from "#core/logging.js";
+import { readAgents } from "#core/apc/parser.js";
+import { agentMemoryPath } from "#core/agent/memory.js";
+import { CHANNELS } from "#core/constants/channels.js";
 
 export const nowIso = () =>
   new Date().toISOString().replace(/\.\d{3}Z$/, "Z");
@@ -141,7 +142,7 @@ export function resolveSuperAgentContext(req, project) {
     };
   }
   return {
-    channel: "api",
+    channel: CHANNELS.API,
     channelMeta: {
       projectId: String(project.id),
       projectName: project.name,

package/src/host/daemon/api/skills.js

@@ -0,0 +1,30 @@
+// Lightweight `/skills` listing for UI surfaces (web composer picker,
+// future palettes). Same data backing `list_skills` tool, but here without
+// auth-binding to a project — anyone with a valid daemon token can ask
+// "which skills are around right now?".
+//
+// Returns the catalog already condensed (slug + first-sentence description)
+// so the picker doesn't have to repeat the cleanup work.
+import { listSkills } from "#core/agent/skills/loader.js";
+import { condenseSkillDescription } from "#core/agent/skills/catalog.js";
+
+export function register(app /*, ctx */) {
+  app.get("/skills", (req, res) => {
+    const projectPath = typeof req.query?.project_path === "string"
+      ? req.query.project_path
+      : undefined;
+    try {
+      const skills = listSkills({ projectPath });
+      res.json({
+        count: skills.length,
+        skills: skills.map(({ slug, source, description }) => ({
+          slug,
+          source,
+          description: condenseSkillDescription(description),
+        })),
+      });
+    } catch (e) {
+      res.status(500).json({ error: e.message });
+    }
+  });
+}

package/src/host/daemon/api/super-agent.js

@@ -5,14 +5,17 @@
 //
 //   POST /projects/:pid/super-agent/chat/stream    NDJSON event stream
 //   POST /projects/:pid/super-agent/chat            blocking JSON response
-import { runSuperAgent } from "../super-agent.js";
+import { runSuperAgent } from "#core/agent/super-agent.js";
 import {
   resolveSuperAgentContext,
   appendSuperAgentErrorTrace,
 } from "./shared.js";
-import { loggerFor } from "../../../core/logging.js";
-import { appendGlobalMessage } from "../../../core/messages-store.js";
-import { createWebConfirmAdapter } from "../../../core/confirmation/adapters/web.js";
+import { loggerFor } from "#core/logging.js";
+import { appendGlobalMessage } from "#core/stores/messages.js";
+import { createWebConfirmAdapter } from "#core/confirmation/adapters/web.js";
+import { tryResolveSkillCommand } from "#core/agent/skills/trigger.js";
+import { suggestSkillForPrompt } from "#core/agent/skills/rag.js";
+import { CHANNELS } from "#core/constants/channels.js";
 
 const log = loggerFor("super-agent");
 
@@ -20,7 +23,7 @@ const log = loggerFor("super-agent");
 // RAG index, search_messages, and the "active threads" awareness block. Only
 // the human surfaces (web big chat + sidebar) — not generic "api"/automation
 // callers. Best-effort: a logging failure never breaks the reply.
-const WEB_LOGGED_CHANNELS = new Set(["web", "web_sidebar"]);
+const WEB_LOGGED_CHANNELS = new Set([CHANNELS.WEB, CHANNELS.WEB_SIDEBAR]);
 function logWebTurn(channel, { prompt, replyText }) {
   if (!WEB_LOGGED_CHANNELS.has(channel)) return;
   try {
@@ -66,11 +69,24 @@ export function register(app, { projects, registries, plugins, project, config }
     // Optional coding-surface knobs: the terminal Code TUI (apx code, Build
     // mode) sends these so it runs to completion exactly like the web Code
     // module. Plain chat callers omit them and keep the lightweight defaults.
-    const { prompt, previousMessages, model, maxIters, maxTokens, completionContract } =
+    const { prompt: rawPrompt, previousMessages, model, maxIters, maxTokens, completionContract } =
       req.body || {};
-    if (!prompt) return res.status(400).json({ error: "prompt required" });
+    if (!rawPrompt) return res.status(400).json({ error: "prompt required" });
     const ctx = resolveSuperAgentContext(req, p);
 
+    // `/slug ...` shortcut: load the matching skill body into contextNote and
+    // strip the prefix from the user prompt. Falls through unchanged when the
+    // slug is unknown.
+    const slashed = tryResolveSkillCommand(rawPrompt, { projectPath: p.path });
+    const prompt = slashed.handled ? slashed.prompt : rawPrompt;
+    if (slashed.handled) {
+      ctx.contextNote = [ctx.contextNote, slashed.contextNote].filter(Boolean).join("\n\n");
+    } else {
+      // Semantic skill nudge — only when there was no explicit /slug.
+      const hint = await suggestSkillForPrompt(prompt, { projectPath: p.path });
+      if (hint) ctx.contextNote = [ctx.contextNote, hint].filter(Boolean).join("\n\n");
+    }
+
     res.setHeader("content-type", "application/x-ndjson; charset=utf-8");
     res.setHeader("cache-control", "no-cache, no-transform");
     res.setHeader("x-accel-buffering", "no");
@@ -151,7 +167,7 @@ export function register(app, { projects, registries, plugins, project, config }
         registries,
         prompt,
         contextNote,
-        channel: "api",
+        channel: CHANNELS.API,
         overrideModel: model,
         maxTokens:
           max_tokens && Number.isFinite(Number(max_tokens))
@@ -174,7 +190,8 @@ export function register(app, { projects, registries, plugins, project, config }
   app.post("/projects/:pid/super-agent/chat", async (req, res) => {
     const p = project(req, res);
     if (!p) return;
-    const { prompt, previousMessages, model } = req.body || {};
+    const { prompt, previousMessages, model, maxIters, maxTokens, completionContract } =
+      req.body || {};
     if (!prompt) return res.status(400).json({ error: "prompt required" });
     const ctx = resolveSuperAgentContext(req, p);
     try {
@@ -189,6 +206,9 @@ export function register(app, { projects, registries, plugins, project, config }
         contextNote: ctx.contextNote,
         previousMessages: previousMessages || [],
         overrideModel: model,
+        ...(Number.isFinite(Number(maxIters)) ? { maxIters: Number(maxIters) } : {}),
+        ...(Number.isFinite(Number(maxTokens)) ? { maxTokens: Number(maxTokens) } : {}),
+        ...(completionContract ? { completionContract: true } : {}),
         onEvent: wrapOnEventForLog(null, {
           trace_id: req.apxTraceId,
           channel: ctx.channel,

package/src/host/daemon/api/tasks.js

@@ -1,4 +1,4 @@
-// Per-project tasks (TODOs). Backed by core/tasks-store.js (JSONL event log).
+// Per-project tasks (TODOs). Backed by core/stores/tasks.js (JSONL event log).
 //   GET    /projects/:pid/tasks                  ?state=open|done|dropped|all&tag=X&agent=Y&due_before=ISO&limit=N
 //   POST   /projects/:pid/tasks                  { title, body?, tags?, due?, agent?, source?, meta? }
 //   GET    /projects/:pid/tasks/:id              (id or prefix)
@@ -15,7 +15,7 @@ import {
   dropTask,
   reopenTask,
   countTasks,
-} from "../../../core/tasks-store.js";
+} from "#core/stores/tasks.js";
 
 export function register(app, { project, projects }) {
   // Global tasks across every project.

package/src/host/daemon/api/telegram.js

@@ -37,7 +37,7 @@ import {
   listRoles,
   setRole,
   removeRole,
-} from "../../../core/config.js";
+} from "#core/config/index.js";
 
 function redactChannel(channel) {
   if (!channel?.bot_token) return channel;

package/src/host/daemon/api/tools.js

@@ -4,12 +4,12 @@
 //   search / glob / grep                    → filesystem-bounded
 //   registry                                → /:name wildcard, MOUNT LAST so it
 //                                             doesn't shadow the specific paths
-import { buildBrowserRouter } from "../../../core/tools/browser.js";
-import { buildFetchRouter } from "../../../core/tools/fetch.js";
-import { buildSearchRouter } from "../../../core/tools/search.js";
-import { buildRegistryRouter } from "../../../core/tools/registry.js";
-import { buildGlobRouter } from "../../../core/tools/glob.js";
-import { buildGrepRouter } from "../../../core/tools/grep.js";
+import { buildBrowserRouter } from "#core/tools/browser.js";
+import { buildFetchRouter } from "#core/tools/fetch.js";
+import { buildSearchRouter } from "#core/tools/search.js";
+import { buildRegistryRouter } from "#core/tools/registry.js";
+import { buildGlobRouter } from "#core/tools/glob.js";
+import { buildGrepRouter } from "#core/tools/grep.js";
 
 export function register(app, { express, projects, registries }) {
   app.use("/tools/fetch", buildFetchRouter(express));

package/src/host/daemon/api/tts.js

@@ -8,8 +8,8 @@
 //
 // Audio files land under ~/.apx/tmp/tts/<uuid>.<ext>. The caller (CLI,
 // Telegram plugin, overlay) is responsible for picking them up.
-import { synthesize, listProviders } from "../../../core/voice/tts.js";
-import { readConfig } from "../../../core/config.js";
+import { synthesize, listProviders } from "#core/voice/tts.js";
+import { readConfig } from "#core/config/index.js";
 
 export function register(app) {
   app.post("/tts/say", async (req, res) => {

package/src/host/daemon/api/voice.js

@@ -1,3 +1,5 @@
+// eslint-disable-next-line -- import below
+import { CHANNELS } from "#core/constants/channels.js";
 // Daemon HTTP routes for the unified "voice" channel.
 //
 //   POST /voice/turn  { audio?: <base64 or path>, format?, text?, agent?,
@@ -19,12 +21,12 @@ import fs from "node:fs";
 import path from "node:path";
 import os from "node:os";
 import { randomUUID } from "node:crypto";
-import { readConfig } from "../../../core/config.js";
-import { synthesize } from "../../../core/voice/tts.js";
+import { readConfig } from "#core/config/index.js";
+import { synthesize } from "#core/voice/tts.js";
 import { transcribe } from "../transcription.js";
-import { runSuperAgent, isSuperAgentEnabled } from "../super-agent.js";
-import { appendGlobalMessage } from "../../../core/messages-store.js";
-import { appendErrorTrace, previewText } from "../../../core/logging.js";
+import { runSuperAgent, isSuperAgentEnabled } from "#core/agent/super-agent.js";
+import { appendGlobalMessage } from "#core/stores/messages.js";
+import { appendErrorTrace, previewText } from "#core/logging.js";
 
 // ── Channel-aware pre-processor ────────────────────────────────────
 //
@@ -84,14 +86,14 @@ function buildChannelContext(channel, { projectId, language = "es" } = {}) {
   const dynamicNote = `${langDirective}${projectHint}`;
   switch (channel) {
     case "voice":
-      return { ...base, contextNote: dynamicNote, systemSuffix: SUGGESTIONS_INSTRUCTION, wantsSuggestions: true, channel: "deck", channelMeta: { voice: true } };
+      return { ...base, contextNote: dynamicNote, systemSuffix: SUGGESTIONS_INSTRUCTION, wantsSuggestions: true, channel: CHANNELS.DECK, channelMeta: { voice: true } };
     case "deck":
-      return { ...base, contextNote: dynamicNote, systemSuffix: SUGGESTIONS_INSTRUCTION, wantsSuggestions: true, channel: "deck", channelMeta: {} };
+      return { ...base, contextNote: dynamicNote, systemSuffix: SUGGESTIONS_INSTRUCTION, wantsSuggestions: true, channel: CHANNELS.DECK, channelMeta: {} };
     case "desktop":
-      return { ...base, contextNote: dynamicNote, systemSuffix: SUGGESTIONS_INSTRUCTION, wantsSuggestions: true, channel: "desktop", channelMeta: { voice: true } };
+      return { ...base, contextNote: dynamicNote, systemSuffix: SUGGESTIONS_INSTRUCTION, wantsSuggestions: true, channel: CHANNELS.DESKTOP, channelMeta: { voice: true } };
     case "telegram":
       // Format rules live in channels/telegram.md; keep only the dynamic note.
-      return { ...base, contextNote: dynamicNote, channel: "telegram", channelMeta: {} };
+      return { ...base, contextNote: dynamicNote, channel: CHANNELS.TELEGRAM, channelMeta: {} };
     default:
       return { ...base, contextNote: dynamicNote, channel: channel || "api", channelMeta: {} };
   }
@@ -232,7 +234,7 @@ async function tryVoiceTaskIntent({ projects, userText, hintProjectId }) {
     };
   }
   try {
-    const { createTask } = await import("../../../core/tasks-store.js");
+    const { createTask } = await import("#core/stores/tasks.js");
     const task = createTask(project.storagePath, {
       title,
       source: "voice",
@@ -511,8 +513,8 @@ export function register(app, { projects, plugins, registries }) {
 }
 
 // Note for plugin authors:
-//   Desktop (src/host/daemon/plugins/desktop.js) and Telegram
-//   (src/host/daemon/plugins/telegram.js) currently implement their own
+//   Desktop (src/host/daemon/plugins/desktop/index.js) and Telegram
+//   (src/host/daemon/plugins/telegram/index.js) currently implement their own
 //   STT → agent → render pipelines. To get spoken replies via APX they can
 //   POST to /voice/turn (or call `synthesize()` directly) instead of
 //   re-implementing TTS. This module intentionally does NOT migrate them —