@agentprojectcontext/apx 1.32.0 → 1.32.2

package/src/host/daemon/apc-runtime-context.js

@@ -1,124 +0,0 @@
-// Helpers that wrap external runtimes (Claude Code, Codex, OpenCode, Aider,
-// Cursor Agent, Gemini CLI, Qwen Code)
-// with APC awareness:
-//
-//   1. Create an APX runtime session BEFORE the runtime starts.
-//   2. Inject an "APC Runtime Context" block into the system prompt so the
-//      runtime knows the session id, the cwd of the project, and the apx
-//      commands it can use to update memory / append session notes.
-//   3. After the runtime returns, capture the external transcript path
-//      (Claude Code gives one; most other runtimes don't yet) and write it
-//      into the APX session frontmatter.
-//   4. Close the session with a synthesised result (truncated stdout).
-//
-// Used by both POST /projects/:pid/agents/:slug/runtime (CLI) and the
-// super-agent's call_runtime tool.
-
-import fs from "node:fs";
-import path from "node:path";
-import { generateSessionId } from "../../core/session-store.js";
-
-const nowIso = () => new Date().toISOString().replace(/\.\d{3}Z$/, "Z");
-
-const APC_RUNTIME_HINT = `
-# APC Runtime Context
-
-You are running inside an APC (Agent Project Context) project. APC gives you portable project context. APX gives you local runtime session state.
-
-- **Project**: {{name}}  ({{path}})
-- **Agent**: {{agent}}
-- **APC session id**: {{session_id}}
-  (stored in APX local runtime storage, outside .apc/)
-
-## Commands you can use during this run
-
-- \`apx memory {{agent}} --append "<note>"\`        save a long-term fact for this agent
-- \`apx session update {{session_id}} --status "..."\`   update the session status
-- \`apx session update {{session_id}} --task-ref TASK-...\`  link to an external task
-
-## When you finish
-
-Close the session with a one-line result so a future operator (or apx session resume) can summarize:
-
-  apx session close {{session_id}} --result "<one-line summary of what you did>"
-
-If you cannot run apx (sandboxed shell), just print the result on the last line of your output prefixed with "APC_RESULT:" and APX will capture it automatically.
-`.trim();
-
-export function buildApfHint({ projectName, projectPath, agentSlug, sessionId }) {
-  return APC_RUNTIME_HINT
-    .replace(/\{\{name\}\}/g, projectName)
-    .replace(/\{\{path\}\}/g, projectPath)
-    .replace(/\{\{agent\}\}/g, agentSlug)
-    .replace(/\{\{session_id\}\}/g, sessionId);
-}
-
-// Create the APX runtime session file on disk. Returns { id, filename, path }.
-export function createRuntimeSession({ projectRoot, storageRoot = projectRoot, agentSlug, runtime, taskRef = "", title }) {
-  const dir = path.join(storageRoot, "agents", agentSlug, "sessions");
-  fs.mkdirSync(dir, { recursive: true });
-  const id = generateSessionId(storageRoot, agentSlug);
-  const file = path.join(dir, `${id}.md`);
-  const started = nowIso();
-  const sessionTitle = title || `Runtime: ${runtime}`;
-  const body =
-    `---\n` +
-    `id: ${id}\n` +
-    `agent: ${agentSlug}\n` +
-    `title: ${sessionTitle}\n` +
-    `task_ref: ${taskRef}\n` +
-    `status: 🔄 In progress\n` +
-    `started: ${started}\n` +
-    `completed: \n` +
-    `result: \n` +
-    `runtime: ${runtime}\n` +
-    `external_session_path: \n` +
-    `---\n\n` +
-    `# ${sessionTitle}\n\n`;
-  fs.writeFileSync(file, body);
-  return { id, filename: `${id}.md`, path: file };
-}
-
-// Update session frontmatter with the external transcript path captured from
-// the runtime adapter. Closes the session with a result string.
-export function closeRuntimeSession({ filePath, externalSessionPath, exitCode, result }) {
-  let text = fs.readFileSync(filePath, "utf8");
-  text = setField(text, "completed", nowIso());
-  if (externalSessionPath) {
-    text = setField(text, "external_session_path", externalSessionPath);
-  }
-  if (typeof exitCode === "number") {
-    text = setField(text, "result", `${exitCode === 0 ? "✅" : "⚠️"} exit ${exitCode}: ${(result || "").slice(0, 200)}`);
-  } else if (result) {
-    text = setField(text, "result", result.slice(0, 300));
-  }
-  text = setField(text, "status", exitCode === 0 ? "✅ Completed" : "⚠️ Closed with error");
-  fs.writeFileSync(filePath, text);
-}
-
-function setField(text, field, value) {
-  if (!text.startsWith("---\n")) return text;
-  const end = text.indexOf("\n---", 4);
-  if (end === -1) return text;
-  const fmText = text.slice(4, end);
-  const lines = fmText.split("\n");
-  let found = false;
-  const out = lines.map((line) => {
-    if (line.startsWith(`${field}:`)) {
-      found = true;
-      return `${field}: ${value}`;
-    }
-    return line;
-  });
-  if (!found) out.push(`${field}: ${value}`);
-  return `---\n${out.join("\n")}\n---${text.slice(end + 4)}`;
-}
-
-// Look at the runtime's stdout for a self-reported "APC_RESULT: ..." line
-// (the convention printed in the hint above). Returns the captured string or
-// null. This is the fallback for runtimes that can't shell out.
-export function extractApfResult(stdout) {
-  if (!stdout || typeof stdout !== "string") return null;
-  const m = stdout.match(/^APC_RESULT:\s*(.+?)\s*$/m);
-  return m ? m[1].trim() : null;
-}

package/src/host/daemon/super-agent-tools/helpers.js

@@ -1,124 +0,0 @@
-import path from "node:path";
-import { agentSkills, buildAgentSystem as buildCoreAgentSystem } from "../../../core/agent-system.js";
-import { buildConfirmDescription } from "../../../core/confirmation/index.js";
-
-export function projectMeta(projects, entry) {
-  const meta = projects.list().find((p) => p.id === entry.id);
-  return {
-    id: entry.id,
-    name: meta?.name || path.basename(entry.path),
-    path: entry.path,
-  };
-}
-
-export function resolveProject(projects, target, { allowMulti = false } = {}) {
-  if (target === undefined || target === null || target === "") {
-    if (allowMulti) return null;
-    const defaultProject = projects.get(0);
-    if (defaultProject) return defaultProject;
-    const all = projects.list();
-    if (all.length === 1) return projects.get(all[0].id);
-    throw new Error(`multiple projects registered (${all.length}); specify project=<id|name|path>`);
-  }
-
-  const tgt = String(target);
-  if (tgt.toLowerCase() === "default") {
-    const defaultProject = projects.get(0);
-    if (!defaultProject) throw new Error("default project not available");
-    return defaultProject;
-  }
-
-  if (typeof target === "number" || /^\d+$/.test(tgt)) {
-    const entry = projects.get(parseInt(tgt, 10));
-    if (!entry) throw new Error(`project id ${target} not found`);
-    return entry;
-  }
-
-  const all = projects.list();
-  const byPath = all.find((p) => p.path === path.resolve(tgt));
-  if (byPath) return projects.get(byPath.id);
-
-  const byName = all.find((p) => p.name === tgt);
-  if (byName) return projects.get(byName.id);
-
-  const tgtLow = tgt.toLowerCase();
-  const fuzzy = all.filter(
-    (p) => p.name.toLowerCase().includes(tgtLow) || p.path.toLowerCase().includes(tgtLow)
-  );
-  if (fuzzy.length === 1) return projects.get(fuzzy[0].id);
-  if (fuzzy.length > 1) {
-    throw new Error(`project "${tgt}" is ambiguous; matches: ${fuzzy.map((p) => p.name).join(", ")}`);
-  }
-  throw new Error(`project "${tgt}" not found`);
-}
-
-export function safePathJoin(root, sub = ".") {
-  const target = path.resolve(root, sub || ".");
-  const rootResolved = path.resolve(root);
-  if (target !== rootResolved && !target.startsWith(rootResolved + path.sep)) {
-    throw new Error(`path "${sub}" escapes the project root`);
-  }
-  return target;
-}
-
-export function skillsFromFields(fields = {}) {
-  return agentSkills({ fields });
-}
-
-export function agentRow(agent) {
-  return {
-    slug: agent.slug,
-    role: agent.fields.Role || null,
-    model: agent.fields.Model || null,
-    language: agent.fields.Language || null,
-    description: agent.fields.Description || null,
-    skills: skillsFromFields(agent.fields),
-  };
-}
-
-export function buildAgentSystem(project, agent, opts = {}) {
-  return buildCoreAgentSystem(project, agent, opts);
-}
-
-export function createPermissionGuard(globalConfig = {}, {
-  implicitConfirmation = false,
-  requestConfirmation = null,
-} = {}) {
-  const permissionMode = globalConfig.super_agent?.permission_mode || "automatico";
-  const allowedTools = new Set(globalConfig.super_agent?.allowed_tools || []);
-
-  // async so tools can `await requirePermission(...)` and the confirmation
-  // dialog resolves transparently before execution continues.
-  return async function requirePermission(tool, { dangerous = false, confirmed = false, args } = {}) {
-    const ok = confirmed || implicitConfirmation;
-    if (permissionMode === "total") return;
-
-    const blocked =
-      (permissionMode === "permiso" && !allowedTools.has(tool) && !ok) ||
-      (permissionMode === "automatico" && dangerous && !ok);
-
-    if (!blocked) return;
-
-    const description = buildConfirmDescription(tool, args || {});
-
-    if (!requestConfirmation) {
-      // No confirmation channel wired for this invocation context (e.g. routine,
-      // autonomous agent). Surface a clear message so the model can explain it.
-      throw new Error(`Action requires user confirmation: ${description}`);
-    }
-
-    const userConfirmed = await requestConfirmation(tool, args || {}, description);
-
-    if (!userConfirmed) {
-      throw new Error(`User did not confirm: ${description}`);
-    }
-    // Confirmed — fall through, tool executes normally.
-  };
-}
-
-export function confirmedProperty(description) {
-  return {
-    type: "boolean",
-    description: description || "true only after explicit user confirmation for this exact action",
-  };
-}

package/src/host/daemon/tool-call-parser.js

@@ -1,2 +0,0 @@
-// Compat shim — parser moved to core/agent/tool-call-parser.js
-export * from "../../core/agent/tool-call-parser.js";