@agentprojectcontext/apx 1.58.0 → 1.59.0

package/src/interfaces/web/src/lib/api/skills.ts

@@ -1,16 +1,44 @@
 import { http } from "../http";
 
+export type SkillSource = "builtin" | "global" | "project" | string;
+
 export type SkillEntry = {
   slug: string;
-  source: "bundled" | "user" | "project" | string;
+  source: SkillSource;
   description: string;
+  /** Effective enabled state for the requested scope. */
+  enabled?: boolean;
+  /** Built-in APX skill — always active, never disableable. */
+  private?: boolean;
+  /** Whether THIS scope holds an explicit override (vs. inherited). */
+  overridden?: boolean;
 };
 
 export type SkillsList = {
   count: number;
+  /** Echoed scope key: "default" (super-agent) or a project path. */
+  scope?: string;
   skills: SkillEntry[];
 };
 
+export interface SkillDetail {
+  slug: string;
+  source: SkillSource;
+  description: string;
+  frontmatter: Record<string, string>;
+  body: string;
+  file: string;
+  enabled: boolean;
+  private: boolean;
+  overridden: boolean;
+}
+
+export interface CreateResult {
+  ok: boolean;
+  slug: string;
+  source: string;
+}
+
 export interface InspectorConfig {
   enabled: boolean;
   load_threshold: number;
@@ -62,16 +90,59 @@ export interface InspectResult {
 
 export const Skills = {
   /**
-   * List installed skills (bundled + user + optional project-scoped). The
-   * description is already condensed for one-line rendering.
+   * List installed skills (built-in + user + optional project-scoped), each
+   * annotated with `enabled`/`private` for the requested scope. Pass a project
+   * path to both scan that project's skills AND resolve enabled-state against
+   * it; omit it for the super-agent ("default") scope.
    */
-  list: (projectPath?: string) =>
-    http.get<SkillsList>(
-      projectPath
-        ? `/skills?project_path=${encodeURIComponent(projectPath)}`
-        : "/skills",
+  list: (projectPath?: string) => {
+    const qs = new URLSearchParams();
+    if (projectPath) {
+      qs.set("project_path", projectPath);
+      qs.set("scope", projectPath);
+    }
+    const q = qs.toString();
+    return http.get<SkillsList>(q ? `/skills?${q}` : "/skills");
+  },
+
+  /** Full body + frontmatter of a skill, for the viewer. */
+  detail: (slug: string, projectPath?: string) => {
+    const qs = projectPath ? `?project_path=${encodeURIComponent(projectPath)}` : "";
+    return http.get<SkillDetail>(`/skills/${encodeURIComponent(slug)}/detail${qs}`);
+  },
+
+  /**
+   * Enable/disable a skill for a scope. `enabled: null` clears the override so
+   * the skill inherits the super-agent default again. `scope` is "default" or a
+   * project path.
+   */
+  setEnabled: (body: { slug: string; enabled: boolean | null; scope?: string }) =>
+    http.put<{ ok: boolean; slug: string; scope: string; enabled: boolean | null }>(
+      "/skills/enabled",
+      body,
     ),
 
+  /**
+   * Create a user skill from the online editor. With `project_path` it lands in
+   * that project's .apc/skills/; otherwise in ~/.apx/skills/.
+   */
+  create: (body: { slug: string; description?: string; body?: string; project_path?: string }) =>
+    http.post<CreateResult>("/skills", body),
+
+  /** Import a skill from an uploaded .zip (base64-encoded). */
+  importZip: (body: { data: string; project_path?: string }) =>
+    http.post<CreateResult>("/skills/import/zip", body),
+
+  /** Import a skill by cloning a git repo. */
+  importRepo: (body: { url: string; project_path?: string }) =>
+    http.post<CreateResult>("/skills/import/repo", body),
+
+  /** Delete a user skill (global or project-scoped). */
+  remove: (slug: string, projectPath?: string) => {
+    const qs = projectPath ? `?project_path=${encodeURIComponent(projectPath)}` : "";
+    return http.del<{ ok: boolean; slug: string }>(`/skills/${encodeURIComponent(slug)}${qs}`);
+  },
+
   /** Skill Inspector config + index status. */
   inspector: () => http.get<InspectorState>("/skills/inspector"),
 

package/src/interfaces/web/src/screens/ProjectScreen.tsx

@@ -4,7 +4,7 @@ import {
   Bot, Heart, Zap, Puzzle, FolderKanban, Settings,
   MessagesSquare, Send, KeyRound,
   LayoutDashboard, Boxes, Cpu, ScrollText, History, Brain, FileCode2,
-  Building2, FileText, FolderTree,
+  Building2, FileText, FolderTree, Sparkles,
 } from "lucide-react";
 import { useNavCollapse, type TabSection } from "../components/common/TabNav";
 import { TabLayout } from "../components/common/TabLayout";
@@ -34,11 +34,12 @@ import { AgentDetailScreen } from "./project/AgentDetailScreen";
 import { StructureTab } from "./project/StructureTab";
 import { DocsTab } from "./project/DocsTab";
 import { FilesTab } from "./project/FilesTab";
+import { SkillsTab } from "./project/SkillsTab";
 
 type NavKey =
   | "" | "chat" | "config" | "telegram"
   | "agents" | "routines" | "tasks" | "mcps" | "vars" | "logs" | "memories" | "artifacts"
-  | "structure" | "docs" | "files";
+  | "structure" | "docs" | "files" | "skills";
 
 export function ProjectScreen() {
   const navigate = useNavigate();
@@ -75,6 +76,7 @@ export function ProjectScreen() {
           items: [
             { key: "agents",   label: t("project.nav.agents"),   icon: Bot },
             { key: "memories", label: t("project.nav.memories"), icon: Brain },
+            { key: "skills",   label: t("skills_page.title"),    icon: Sparkles },
             { key: "routines",  label: t("project.nav.routines"),  icon: Heart },
             { key: "mcps",      label: t("project.nav.mcps"),      icon: Puzzle },
             { key: "vars",      label: t("project.nav.vars"),      icon: KeyRound },
@@ -97,6 +99,7 @@ export function ProjectScreen() {
           { key: "agents",   label: t("project.nav.agents"),    icon: Bot },
           ...(isCompany ? [{ key: "structure", label: t("project.nav.structure"), icon: Building2 }] : []),
           { key: "memories", label: t("project.nav.memories"),  icon: Brain },
+          { key: "skills",   label: t("skills_page.title"),     icon: Sparkles },
         ],
       },
       {
@@ -175,6 +178,7 @@ export function ProjectScreen() {
         <Route path="docs"         element={<DocsTab pid={pid} />} />
         <Route path="files"        element={<FilesTab pid={pid} />} />
         <Route path="memories"     element={<MemoriesTab pid={pid} />} />
+        <Route path="skills"       element={<SkillsTab pid={pid} />} />
         <Route path="routines"     element={<RoutinesTab pid={pid} />} />
         <Route path="tasks"        element={isBase ? <GlobalTasksTab /> : <TasksTab pid={pid} />} />
         <Route path="mcps"         element={<McpsTab pid={pid} />} />

package/src/interfaces/web/src/screens/SettingsScreen.tsx

@@ -8,7 +8,7 @@ import { TabLayout } from "../components/common/TabLayout";
 import { IdentityPanel } from "../components/settings/IdentityPanel";
 import { SuperAgentPanel } from "../components/settings/SuperAgentPanel";
 import { MemoryPanel } from "../components/settings/MemoryPanel";
-import { SkillsInspectorPanel } from "../components/settings/SkillsInspectorPanel";
+import { SkillsSettings } from "../components/settings/SkillsSettings";
 import { ModelsTab } from "./base/ModelsTab";
 import { TelegramSettingsTabs } from "../components/settings/TelegramSettingsTabs";
 import { DevicesPanel } from "../components/settings/DevicesPanel";
@@ -37,7 +37,7 @@ const SECTIONS: TabSection[] = [
       { key: "super_agent", label: t("settings.tabs.super_agent"), icon: Bot },
       { key: "engines",     label: t("settings.tabs.engines"),     icon: Cpu },
       { key: "memory",      label: "Memory (RAG)",                 icon: Database },
-      { key: "skills",      label: "Skills (RAG)",                 icon: Sparkles },
+      { key: "skills",      label: t("skills_page.title"),         icon: Sparkles },
     ],
   },
   {
@@ -75,7 +75,7 @@ const PANELS: Record<TabKey, () => ReactElement> = {
   super_agent: () => <SuperAgentPanel />,
   engines:     () => <ModelsTab />,
   memory:      () => <MemoryPanel />,
-  skills:      () => <SkillsInspectorPanel />,
+  skills:      () => <SkillsSettings />,
   telegram:    () => <TelegramSettingsTabs />,
   devices:     () => <DevicesPanel />,
   voice:       () => <VoiceScreen />,

package/src/interfaces/web/src/screens/project/SkillsTab.tsx

@@ -0,0 +1,13 @@
+import { useProject } from "../../hooks/useProjects";
+import { Loading } from "../../components/ui";
+import { SkillsManager } from "../../components/settings/SkillsManager";
+
+// Per-project skills view: the Claude-Desktop-style manager locked to THIS
+// project's scope so you can enable/disable and add skills while working in it.
+// The base project (pid "0" = super-agent admin) manages the "default" scope.
+export function SkillsTab({ pid }: { pid: string }) {
+  const { project } = useProject(pid);
+  const scope = pid === "0" ? "default" : project?.path;
+  if (!scope) return <Loading />;
+  return <SkillsManager scope={scope} />;
+}