@agent-native/core 0.114.5 → 0.114.7

package/dist/cli/skills.js

@@ -14,9 +14,10 @@ import { buildAppSkillPack, ensureAppSkill, loadAppSkillManifest, normalizeAppSk
 import { resolveClients, runConnect, writeConnectClientPreferences, } from "./connect.js";
 import { CONTEXT_XRAY_SKILL_MD, installLocalContextXray, } from "./context-xray-local.js";
 import { CLIENTS } from "./mcp-config-writers.js";
+import { installScreenMemoryForClient, resolveScreenMemoryStoreDir, } from "./mcp.js";
 import { PR_VISUAL_RECAP_SETUP, writePrVisualRecapWorkflow } from "./recap.js";
 import { setupAgentSymlinks } from "./setup-agents.js";
-import { ASSETS_SKILL_MD, CANVAS_REFERENCE_MD, CONNECTION_REFERENCE_MD, CONTENT_SKILL_MD, DESIGN_EXPLORATION_SKILL_MD, DESIGN_VISUAL_EDIT_SKILL_MD, DOCUMENT_QUALITY_REFERENCE_MD, EXEMPLAR_REFERENCE_MD, HELP, LOCAL_FILES_REFERENCE_MD, VISUAL_PLANS_SKILL_MD, VISUAL_RECAP_SKILL_MD, VISUALIZE_REPO_SKILL_MD, WIREFRAME_REFERENCE_MD, } from "./skills-content/index.js";
+import { ASSETS_SKILL_MD, CANVAS_REFERENCE_MD, CONNECTION_REFERENCE_MD, CONTENT_SKILL_MD, DESIGN_EXPLORATION_SKILL_MD, DESIGN_VISUAL_EDIT_SKILL_MD, DOCUMENT_QUALITY_REFERENCE_MD, EXEMPLAR_REFERENCE_MD, HELP, LOCAL_FILES_REFERENCE_MD, REWIND_SKILL_MD, VISUAL_PLANS_SKILL_MD, VISUAL_RECAP_SKILL_MD, VISUALIZE_REPO_SKILL_MD, WIREFRAME_REFERENCE_MD, } from "./skills-content/index.js";
 import { createCliTelemetry } from "./telemetry.js";
 export { CANVAS_REFERENCE_MD, CONNECTION_REFERENCE_MD, DOCUMENT_QUALITY_REFERENCE_MD, EXEMPLAR_REFERENCE_MD, LOCAL_FILES_REFERENCE_MD, VISUAL_PLANS_SKILL_MD, VISUAL_RECAP_SKILL_MD, VISUALIZE_REPO_SKILL_MD, WIREFRAME_REFERENCE_MD, };
 export const BUILT_IN_APP_SKILLS = {
@@ -111,6 +112,38 @@ export const BUILT_IN_APP_SKILLS = {
         }),
         skillMarkdown: CONTENT_SKILL_MD,
     },
+    rewind: {
+        skillName: "rewind",
+        screenMemoryMcp: true,
+        manifest: normalizeAppSkillManifest({
+            schemaVersion: 1,
+            id: "rewind",
+            displayName: "Rewind",
+            description: "Retrieve recent local Clips screen memory, chapters, transcripts, and exact frames through a privacy-preserving agent workflow.",
+            hosted: {
+                url: "https://clips.agent-native.com",
+                mcpUrl: "https://clips.agent-native.com/mcp",
+            },
+            mcp: { serverName: "clips-screen-memory" },
+            auth: { mode: "none" },
+            surfaces: [
+                {
+                    id: "rewind-memory",
+                    path: "/",
+                    description: "Search and inspect the user's local Clips Rewind memory through a bounded local MCP broker.",
+                },
+            ],
+            skills: [
+                {
+                    path: "skills/rewind",
+                    visibility: "exported",
+                    exportAs: "rewind",
+                },
+            ],
+            hostAdapters: ["plain-skill", "claude-skill", "generic-mcp"],
+        }),
+        skillMarkdown: REWIND_SKILL_MD,
+    },
     design: {
         skillName: "design-exploration",
         extraSkills: {
@@ -301,6 +334,10 @@ const BUILT_IN_APP_SKILL_ALIASES = {
     "local-content": "content",
     "content-local-files": "content",
     "agent-native-content": "content",
+    rewind: "rewind",
+    "screen-memory": "rewind",
+    "clips-rewind": "rewind",
+    "agent-native-rewind": "rewind",
     design: "design",
     "ui-design": "design",
     "ux-design": "design",
@@ -342,6 +379,7 @@ const BUILT_IN_APP_SKILL_DISPLAY_ALIASES = {
         "content-local-files",
         "agent-native-content",
     ],
+    rewind: ["screen-memory", "clips-rewind", "agent-native-rewind"],
     design: [
         "design-exploration",
         "visual-edit",
@@ -431,6 +469,9 @@ function isKnownSkill(value) {
 function isLocalOnlyBuiltInSkill(entry) {
     return Boolean(entry && "localOnly" in entry && entry.localOnly);
 }
+function isScreenMemoryMcpBuiltInSkill(entry) {
+    return Boolean(entry && "screenMemoryMcp" in entry && entry.screenMemoryMcp);
+}
 function targetSupportsInstallMode(targetId) {
     return targetId === "visual-plans" || targetId === "content";
 }
@@ -597,6 +638,7 @@ function skillFilesForBuiltIn(appSkillId, options = {}) {
             displayName: entry.manifest.displayName,
             skillName,
             mcpUrl: isLocalOnlyBuiltInSkill(entry) ||
+                isScreenMemoryMcpBuiltInSkill(entry) ||
                 localFilesModeSkipsMcp(appSkillId, options.planMode)
                 ? ""
                 : (options.mcpUrl ?? entry.manifest.hosted.mcpUrl),
@@ -775,11 +817,10 @@ function writeContentLocalFilesManifest(baseDir, options = {}) {
 function builtInSkillsRootForAgent(agent, scope, baseDir) {
     const home = homeDir() ?? baseDir;
     if (scope === "project") {
-        if (agent === "codex")
-            return path.join(baseDir, ".agents", "skills");
-        if (agent === "pi")
-            return path.join(baseDir, ".agents", "skills");
-        return path.join(baseDir, ".claude", "skills");
+        if (agent === "claude-code" || agent === "claude-code-cli") {
+            return path.join(baseDir, ".claude", "skills");
+        }
+        return path.join(baseDir, ".agents", "skills");
     }
     if (agent === "codex") {
         return process.env.CODEX_HOME
@@ -789,6 +830,11 @@ function builtInSkillsRootForAgent(agent, scope, baseDir) {
     if (agent === "pi") {
         return path.join(home, ".agents", "skills");
     }
+    if (agent === "cursor" ||
+        agent === "opencode" ||
+        agent === "github-copilot") {
+        return path.join(home, ".agents", "skills");
+    }
     return path.join(home, ".claude", "skills");
 }
 function builtInCommandsRootForAgent(agent, scope, baseDir) {
@@ -1498,6 +1544,11 @@ const BUILT_IN_SKILL_PROMPT_OPTIONS = [
         label: "content",
         hint: BUILT_IN_APP_SKILLS.content.manifest.description,
     },
+    {
+        value: "rewind",
+        label: "rewind",
+        hint: BUILT_IN_APP_SKILLS.rewind.manifest.description,
+    },
     {
         value: "design-exploration",
         label: "design-exploration",
@@ -2505,7 +2556,11 @@ export async function addAgentNativeSkill(parsed, options = {}) {
         throw new Error(`Unknown skill or manifest path: ${target}. Run "npx @agent-native/core@latest skills list".`);
     }
     const knownBuiltIn = knownTarget ? BUILT_IN_APP_SKILLS[knownTarget] : null;
+    const installsScreenMemoryMcp = isScreenMemoryMcpBuiltInSkill(knownBuiltIn);
     const baseDir = options.baseDir ?? process.cwd();
+    if (installsScreenMemoryMcp && parsed.mcpUrl) {
+        throw new Error("Rewind uses the local Clips Screen Memory MCP and does not accept --mcp-url.");
+    }
     if (isLocalOnlyBuiltInSkill(knownBuiltIn)) {
         if (parsed.planMode) {
             throw new Error("--mode only applies to visual-plan / visual-recap / visualize-repo / content.");
@@ -2596,7 +2651,9 @@ export async function addAgentNativeSkill(parsed, options = {}) {
         throw new Error("MCP setup supports Claude Code, Codex, Claude Cowork, Cursor, OpenCode, or GitHub Copilot / VS Code clients. Use --mode local-files or --no-mcp for Pi.");
     }
     installTarget = preserveMcpUrlAppPathOverride(installTarget, parsed.mcpUrl);
-    const skillsAgents = skillsAgentsForClients(clients);
+    const skillsAgents = installsScreenMemoryMcp
+        ? clients
+        : skillsAgentsForClients(clients);
     if (parsed.dryRun) {
         try {
             const localManifestPath = shouldWriteContentLocalFilesManifest(modeAwareTargetId, planMode)
@@ -2619,9 +2676,11 @@ export async function addAgentNativeSkill(parsed, options = {}) {
                 displayName: installTarget.displayName,
                 skillNames: installTarget.skillNames,
                 skillsAgents,
-                mcpUrl: localFilesModeSkipsMcp(modeAwareTargetId, planMode)
+                mcpUrl: installsScreenMemoryMcp
                     ? ""
-                    : installTarget.loaded.manifest.hosted.mcpUrl,
+                    : localFilesModeSkipsMcp(modeAwareTargetId, planMode)
+                        ? ""
+                        : installTarget.loaded.manifest.hosted.mcpUrl,
                 mcpClients: shouldRegisterMcp ? mcpClients : [],
                 dryRun: true,
                 commands: [
@@ -2716,7 +2775,21 @@ export async function addAgentNativeSkill(parsed, options = {}) {
             scope: parsed.scope,
             dryRun: Boolean(parsed.dryRun),
         });
-        if (shouldRegisterMcp) {
+        if (shouldRegisterMcp && installsScreenMemoryMcp) {
+            const screenMemoryDir = resolveScreenMemoryStoreDir();
+            if (!screenMemoryDir) {
+                throw new Error("No local Clips Screen Memory store was found. Turn Rewind on in Clips, then run the setup again.");
+            }
+            registeredMcpClients = mcpClients.map((client) => {
+                commands.push(`npx @agent-native/core@latest mcp install-screen-memory --client ${client} --scope ${parsed.scope}`);
+                installScreenMemoryForClient(client, screenMemoryDir, baseDir, parsed.scope);
+                return client;
+            });
+            options.telemetry?.track("skills_cli mcp registered", {
+                skills: installTarget.skillNames.join(","),
+            });
+        }
+        else if (shouldRegisterMcp) {
             commands.push(`npx @agent-native/core@latest app-skill ensure --manifest ${installTarget.loaded.file} --client ${parsed.client} --scope ${parsed.scope} --yes`);
             if (!parsed.dryRun) {
                 const ensureResult = await ensureAppSkill(installTarget.loaded, {
@@ -2807,9 +2880,11 @@ export async function addAgentNativeSkill(parsed, options = {}) {
             instructionSource,
             skillNames: installTarget.skillNames,
             skillsAgents,
-            mcpUrl: localFilesModeSkipsMcp(modeAwareTargetId, planMode)
+            mcpUrl: installsScreenMemoryMcp
                 ? ""
-                : installTarget.loaded.manifest.hosted.mcpUrl,
+                : localFilesModeSkipsMcp(modeAwareTargetId, planMode)
+                    ? ""
+                    : installTarget.loaded.manifest.hosted.mcpUrl,
             mcpClients: registeredMcpClients,
             dryRun: parsed.dryRun,
             commands,
@@ -2838,10 +2913,11 @@ function listSkills(options = {}) {
             aliases: BUILT_IN_APP_SKILL_DISPLAY_ALIASES[entry.manifest.id] ?? [],
             name: entry.manifest.displayName,
             description: entry.manifest.description,
-            mcpUrl: isLocalOnlyBuiltInSkill(entry)
+            mcpUrl: isLocalOnlyBuiltInSkill(entry) || isScreenMemoryMcpBuiltInSkill(entry)
                 ? ""
                 : entry.manifest.hosted.mcpUrl,
-            local: isLocalOnlyBuiltInSkill(entry),
+            local: isLocalOnlyBuiltInSkill(entry) ||
+                isScreenMemoryMcpBuiltInSkill(entry),
             source: "agent-native",
         })),
         ...publicSkillEntries(options).map((entry) => ({