@hasna/skills 0.1.63 → 0.1.64

package/bin/mcp.js

@@ -6727,6 +6727,9 @@ function normalizeConfigValue(key, value) {
     return value.trim() ? value : undefined;
   return;
 }
+function isOwnerLayoutMigrated(appDir) {
+  return existsSync(join(appDir, SKILLS_CACHE_DIRNAME, LAYOUT_MIGRATION_RECORD));
+}
 function getDataDir() {
   const override = process.env[DATA_DIR_ENV];
   if (override) {
@@ -6750,6 +6753,33 @@ function getDataDir() {
   }
   return newDir;
 }
+function getDataDirReadOnly() {
+  const override = process.env[DATA_DIR_ENV];
+  if (override)
+    return override;
+  return join(process.env["HOME"] || process.env["USERPROFILE"] || homedir(), ".hasna", "skills");
+}
+function getConfigPathReadOnly(scope) {
+  if (scope === "global")
+    return join(getDataDirReadOnly(), "config.json");
+  return join(process.cwd(), "skills.config.json");
+}
+function loadConfigReadOnly() {
+  const canonicalConfigPath = getConfigPathReadOnly("global");
+  let globalConfig2;
+  if (existsSync(canonicalConfigPath)) {
+    globalConfig2 = readConfigFile(canonicalConfigPath);
+  } else if (process.env[DATA_DIR_ENV] !== undefined) {
+    globalConfig2 = {};
+  } else {
+    globalConfig2 = readConfigFile(legacyConfigFilePath());
+  }
+  const projectConfig = readConfigFile(getConfigPathReadOnly("project"));
+  return { ...globalConfig2, ...projectConfig };
+}
+function legacyConfigFilePath() {
+  return join(process.env["HOME"] || process.env["USERPROFILE"] || homedir(), ".skillsrc");
+}
 function getConfigPath(scope) {
   if (scope === "global") {
     return join(getDataDir(), "config.json");
@@ -6781,7 +6811,7 @@ function loadConfig() {
   const projectConfig = readConfigFile(getConfigPath("project"));
   return { ...globalConfig2, ...projectConfig };
 }
-var ENUM_KEYS, STRING_KEYS, DATA_DIR_ENV = "HASNA_SKILLS_DIR", INSTALLED_SKILLS_DIRNAME = "installed";
+var ENUM_KEYS, STRING_KEYS, DATA_DIR_ENV = "HASNA_SKILLS_DIR", INSTALLED_SKILLS_DIRNAME = "installed", SKILLS_CACHE_DIRNAME = "skills", LAYOUT_MIGRATION_RECORD = ".layout-migration.json";
 var init_config = __esm(() => {
   init_retired_settings();
   ENUM_KEYS = {
@@ -6866,19 +6896,33 @@ var exports_auth_store = {};
 __export(exports_auth_store, {
   saveAuthConfig: () => saveAuthConfig,
   normalizeSkillsApiOrigin: () => normalizeSkillsApiOrigin,
+  getAuthFilePathReadOnly: () => getAuthFilePathReadOnly,
+  getAuthFilePath: () => getAuthFilePath,
+  getAuthConfigReadOnly: () => getAuthConfigReadOnly,
   getAuthConfig: () => getAuthConfig,
   getApiUrl: () => getApiUrl,
+  getApiKeyReadOnly: () => getApiKeyReadOnly,
   getApiKey: () => getApiKey,
   clearAuthConfig: () => clearAuthConfig
 });
 import { existsSync as existsSync11, mkdirSync as mkdirSync6, readFileSync as readFileSync10, writeFileSync as writeFileSync6, unlinkSync } from "fs";
-import { join as join11 } from "path";
+import { dirname as dirname5, join as join11 } from "path";
 import { homedir as homedir3 } from "os";
+function getAuthFilePath() {
+  return join11(getDataDir(), "auth.json");
+}
+function getAuthFilePathReadOnly() {
+  return join11(getDataDirReadOnly(), "auth.json");
+}
+function legacyAuthFilePath() {
+  return join11(process.env["HOME"] || process.env["USERPROFILE"] || homedir3(), ".skills", "auth.json");
+}
 function getAuthConfig() {
   if (cachedConfig !== undefined)
     return cachedConfig;
   try {
-    const raw = readFileSync10(existsSync11(AUTH_FILE) ? AUTH_FILE : LEGACY_AUTH_FILE, "utf-8");
+    const file = existsSync11(getAuthFilePath()) ? getAuthFilePath() : legacyAuthFilePath();
+    const raw = readFileSync10(file, "utf-8");
     const config2 = JSON.parse(raw);
     if (!config2.apiKey) {
       cachedConfig = null;
@@ -6892,19 +6936,20 @@ function getAuthConfig() {
   }
 }
 function saveAuthConfig(config2) {
-  mkdirSync6(AUTH_DIR, { recursive: true, mode: 448 });
-  writeFileSync6(AUTH_FILE, JSON.stringify(config2, null, 2) + `
+  const file = getAuthFilePath();
+  mkdirSync6(dirname5(file), { recursive: true, mode: 448 });
+  writeFileSync6(file, JSON.stringify(config2, null, 2) + `
 `, { mode: 384 });
   cachedConfig = config2;
 }
 function clearAuthConfig() {
   try {
-    unlinkSync(AUTH_FILE);
+    unlinkSync(getAuthFilePath());
   } catch {}
   try {
-    unlinkSync(LEGACY_AUTH_FILE);
+    unlinkSync(legacyAuthFilePath());
   } catch {}
-  cachedConfig = null;
+  cachedConfig = undefined;
 }
 function getApiKey() {
   if (process.env.SKILLS_API_KEY)
@@ -6913,6 +6958,25 @@ function getApiKey() {
     return process.env.SKILL_API_KEY;
   return getAuthConfig()?.apiKey || null;
 }
+function getAuthConfigReadOnly() {
+  try {
+    const file = existsSync11(getAuthFilePathReadOnly()) ? getAuthFilePathReadOnly() : legacyAuthFilePath();
+    const raw = readFileSync10(file, "utf-8");
+    const config2 = JSON.parse(raw);
+    if (!config2.apiKey)
+      return null;
+    return config2;
+  } catch {
+    return null;
+  }
+}
+function getApiKeyReadOnly() {
+  if (process.env.SKILLS_API_KEY)
+    return process.env.SKILLS_API_KEY;
+  if (process.env.SKILL_API_KEY)
+    return process.env.SKILL_API_KEY;
+  return getAuthConfigReadOnly()?.apiKey || null;
+}
 function normalizeSkillsApiOrigin(apiUrl) {
   const url = new URL(apiUrl);
   const pathname = url.pathname.replace(/\/+$/, "");
@@ -6928,12 +6992,10 @@ function normalizeSkillsApiOrigin(apiUrl) {
 function getApiUrl(action) {
   return normalizeSkillsApiOrigin(requireApiUrl(action));
 }
-var AUTH_DIR, AUTH_FILE, LEGACY_AUTH_FILE, cachedConfig;
+var cachedConfig;
 var init_auth_store = __esm(() => {
   init_api_url();
-  AUTH_DIR = join11(homedir3(), ".hasna", "skills");
-  AUTH_FILE = join11(AUTH_DIR, "auth.json");
-  LEGACY_AUTH_FILE = join11(homedir3(), ".skills", "auth.json");
+  init_config();
 });
 
 // src/lib/blog-article.ts
@@ -7069,8 +7131,11 @@ var init_blog_article = __esm(() => {
 // src/lib/remote-client.ts
 var exports_remote_client = {};
 __export(exports_remote_client, {
+  createRemoteSkillsClientReadOnly: () => createRemoteSkillsClientReadOnly,
   createRemoteSkillsClient: () => createRemoteSkillsClient,
-  RemoteSkillsClient: () => RemoteSkillsClient
+  RemoteSkillsClient: () => RemoteSkillsClient,
+  RemoteRouteUnsupportedError: () => RemoteRouteUnsupportedError,
+  RemoteRequestError: () => RemoteRequestError
 });
 
 class RemoteSkillsClient {
@@ -7090,6 +7155,20 @@ class RemoteSkillsClient {
       }
     });
   }
+  async requestNewRoute(path, options, opts = {}) {
+    const response = await this.request(path, options);
+    const routePath = path.split("?")[0];
+    if (response.status === 404 || response.status === 405) {
+      if (response.status === 404 && opts.domainNotFoundCodes?.length && await responseBodyCarriesCode(response, opts.domainNotFoundCodes)) {
+        return response;
+      }
+      throw new RemoteRouteUnsupportedError(routePath, response.status, this.apiUrl);
+    }
+    if (!response.ok) {
+      throw new RemoteRequestError(routePath, response.status, response.statusText);
+    }
+    return response;
+  }
   async listSkills() {
     const res = await this.request("/api/v1/skills");
     return res.json();
@@ -7106,6 +7185,14 @@ class RemoteSkillsClient {
       return null;
     return res.json();
   }
+  async getSkillStatus(slug) {
+    const res = await this.request(`/api/v1/skills/${encodeURIComponent(slug)}`, { method: "GET" });
+    let body = null;
+    try {
+      body = await res.json();
+    } catch {}
+    return { status: res.status, body };
+  }
   async submitRun(slug, input, args) {
     const res = await this.request(`/api/v1/runs/${slug}`, {
       method: "POST",
@@ -7139,15 +7226,18 @@ class RemoteSkillsClient {
       method: "GET"
     });
   }
-  async publishSkill(manifest, bundle) {
+  async publishSkill(manifest, bundle, ifMatch) {
     const form = new FormData;
     form.set("manifest", JSON.stringify(manifest));
     if (bundle) {
       form.set("bundle", new Blob([bundle], { type: "application/gzip" }), `${String(manifest.slug ?? "skill")}.tar.gz`);
     }
+    const headers = { Authorization: `Bearer ${this.apiKey}` };
+    if (ifMatch)
+      headers["If-Match"] = ifMatch;
     return fetch(`${this.apiUrl}/api/v1/skills`, {
       method: "POST",
-      headers: { Authorization: `Bearer ${this.apiKey}` },
+      headers,
       body: form
     });
   }
@@ -7163,6 +7253,135 @@ class RemoteSkillsClient {
       return null;
     return response;
   }
+  async listPins() {
+    const response = await this.requestNewRoute("/api/v1/pins");
+    return normalizePinList(await response.json());
+  }
+  async pin(slug, metadata) {
+    const path = `/api/v1/pins/${encodeURIComponent(slug)}`;
+    const response = await this.requestNewRoute(path, {
+      method: "PUT",
+      body: JSON.stringify({ ...metadata ? { metadata } : {} })
+    });
+    return normalizePin(await response.json());
+  }
+  async unpin(slug) {
+    const path = `/api/v1/pins/${encodeURIComponent(slug)}`;
+    const response = await this.requestNewRoute(path, { method: "DELETE" }, { domainNotFoundCodes: ["PIN_NOT_FOUND"] });
+    return response.status !== 404;
+  }
+  async listTags() {
+    const response = await this.requestNewRoute("/api/v1/tags");
+    const payload = await response.json();
+    if (!Array.isArray(payload)) {
+      throw new Error("Remote tags payload did not match the expected contract (expected an array of tag names)");
+    }
+    for (const tag of payload) {
+      if (typeof tag !== "string" || tag.trim().length === 0) {
+        throw new Error("Remote tags payload did not match the expected contract (every element must be a non-empty tag name)");
+      }
+    }
+    return payload;
+  }
+  async skillsByTag(tag) {
+    const path = `/api/v1/tags/${encodeURIComponent(tag)}/skills`;
+    const response = await this.requestNewRoute(path);
+    return normalizeSkillSummaryList(await response.json());
+  }
+  async listUpdatedSince(since, options = {}) {
+    const params = new URLSearchParams({ since });
+    if (options.cursor)
+      params.set("cursor", options.cursor);
+    if (options.limit !== undefined)
+      params.set("limit", String(options.limit));
+    const response = await this.requestNewRoute(`/api/v1/skills/updated?${params.toString()}`);
+    return normalizeUpdatedSincePage(await response.json());
+  }
+}
+function requireOptionalString(record3, field) {
+  if (record3[field] === undefined)
+    return;
+  if (typeof record3[field] !== "string") {
+    throw new Error(`Remote payload did not match the expected contract (${field} must be a string when present)`);
+  }
+  return record3[field];
+}
+function normalizePin(entry) {
+  if (!entry || typeof entry !== "object") {
+    throw new Error("Remote pin payload did not match the expected contract (expected an object)");
+  }
+  const record3 = entry;
+  const slug = typeof record3.slug === "string" && record3.slug.trim() ? record3.slug.trim() : undefined;
+  if (!slug) {
+    throw new Error("Remote pin payload did not match the expected contract (missing slug)");
+  }
+  let metadata;
+  if (record3.metadata !== undefined) {
+    if (!record3.metadata || typeof record3.metadata !== "object" || Array.isArray(record3.metadata)) {
+      throw new Error("Remote pin payload did not match the expected contract (metadata must be a JSON object when present)");
+    }
+    metadata = record3.metadata;
+  }
+  const pinnedAt = requireOptionalString(record3, "pinnedAt");
+  return {
+    slug,
+    ...pinnedAt !== undefined ? { pinnedAt } : {},
+    ...metadata ? { metadata } : {}
+  };
+}
+function normalizePinList(payload) {
+  if (!Array.isArray(payload)) {
+    throw new Error("Remote pins payload did not match the expected contract (expected an array of pins)");
+  }
+  return payload.map(normalizePin);
+}
+function normalizeSkillSummary(entry) {
+  if (!entry || typeof entry !== "object") {
+    throw new Error("Remote skill payload did not match the expected contract (expected an object)");
+  }
+  const record3 = entry;
+  const slug = typeof record3.slug === "string" && record3.slug.trim() ? record3.slug.trim() : undefined;
+  if (!slug) {
+    throw new Error("Remote skill payload did not match the expected contract (missing slug)");
+  }
+  return {
+    slug,
+    ...requireOptionalString(record3, "name") !== undefined ? { name: requireOptionalString(record3, "name") } : {},
+    ...requireOptionalString(record3, "version") !== undefined ? { version: requireOptionalString(record3, "version") } : {},
+    ...requireOptionalString(record3, "updatedAt") !== undefined ? { updatedAt: requireOptionalString(record3, "updatedAt") } : {}
+  };
+}
+function normalizeSkillSummaryList(payload) {
+  if (!Array.isArray(payload)) {
+    throw new Error("Remote skills payload did not match the expected contract (expected an array of skills)");
+  }
+  return payload.map(normalizeSkillSummary);
+}
+async function responseBodyCarriesCode(response, codes) {
+  try {
+    const payload = await response.clone().json();
+    if (!payload || typeof payload !== "object")
+      return false;
+    const code = payload.code;
+    return typeof code === "string" && codes.includes(code);
+  } catch {
+    return false;
+  }
+}
+function normalizeUpdatedSincePage(payload) {
+  if (!payload || typeof payload !== "object") {
+    throw new Error("Updated-since payload did not match the expected contract (expected an object)");
+  }
+  const record3 = payload;
+  if (!Array.isArray(record3.skills)) {
+    throw new Error("Updated-since payload did not match the expected contract (missing skills array)");
+  }
+  const skills = record3.skills.map(normalizeSkillSummary);
+  const nextCursor = record3.nextCursor === undefined || record3.nextCursor === null ? null : record3.nextCursor;
+  if (nextCursor !== null && typeof nextCursor !== "string") {
+    throw new Error("Updated-since payload did not match the expected contract (nextCursor must be a string or absent)");
+  }
+  return { skills, nextCursor };
 }
 function createRemoteSkillsClient() {
   const apiKey = getApiKey();
@@ -7170,8 +7389,42 @@ function createRemoteSkillsClient() {
     return null;
   return new RemoteSkillsClient(apiKey);
 }
+function createRemoteSkillsClientReadOnly() {
+  const apiKey = getApiKeyReadOnly();
+  if (!apiKey)
+    return null;
+  const apiUrl = resolveApiUrl(loadConfigReadOnly(), process.env);
+  if (!apiUrl)
+    throw new MissingApiUrlError("the cloud group's sync verb (--dry-run)");
+  return new RemoteSkillsClient(apiKey, apiUrl);
+}
+var RemoteRouteUnsupportedError, RemoteRequestError;
 var init_remote_client = __esm(() => {
   init_auth_store();
+  init_api_url();
+  init_config();
+  RemoteRouteUnsupportedError = class RemoteRouteUnsupportedError extends Error {
+    path;
+    status;
+    instance;
+    constructor(path, status, instance) {
+      super(`The configured Skills instance does not support ${path} (HTTP ${status}). ` + `The instance at ${instance} predates this client feature \u2014 upgrade the server, or ` + `use a client version that matches it.`);
+      this.path = path;
+      this.status = status;
+      this.instance = instance;
+      this.name = "RemoteRouteUnsupportedError";
+    }
+  };
+  RemoteRequestError = class RemoteRequestError extends Error {
+    path;
+    status;
+    constructor(path, status, statusText) {
+      super(`Remote request to ${path} failed: HTTP ${status}${statusText ? ` ${statusText}` : ""}`);
+      this.path = path;
+      this.status = status;
+      this.name = "RemoteRequestError";
+    }
+  };
 });
 
 // ../../node_modules/.bun/content-type@1.0.5/node_modules/content-type/index.js
@@ -12690,7 +12943,7 @@ class StdioServerTransport {
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.1.63",
+  version: "0.1.64",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {
@@ -12764,6 +13017,7 @@ var package_default = {
   license: "Apache-2.0",
   devDependencies: {
     "@types/bun": "latest",
+    "@types/node": "25.2.3",
     "@types/react": "^18.2.0",
     "bun-types": "1.3.14",
     "react-devtools-core": "^7.0.1",
@@ -12772,7 +13026,7 @@ var package_default = {
   dependencies: {
     "@aws-sdk/client-ecs": "^3.1079.0",
     "@aws-sdk/client-s3": "^3.1079.0",
-    "@hasna/events": "0.1.7",
+    "@hasna/events": "0.1.16",
     "@modelcontextprotocol/sdk": "^1.26.0",
     chalk: "^5.3.0",
     commander: "^12.1.0",
@@ -20800,7 +21054,7 @@ var DEVELOPMENT_TOOLS_SKILLS = [
   {
     name: "monitor",
     displayName: "Monitor",
-    description: "Operate the open-monitor MCP for machine health, processes, cron jobs, and cleanup workflows",
+    description: "Operate the monitor MCP for machine health, processes, cron jobs, and cleanup workflows",
     category: "Development Tools",
     tags: ["monitoring", "mcp", "processes", "operations"]
   },
@@ -20846,6 +21100,14 @@ var DEVELOPMENT_TOOLS_SKILLS = [
     description: "Validate configuration files for syntax and schema compliance",
     category: "Development Tools",
     tags: ["config", "validation", "schema", "linting"]
+  },
+  {
+    name: "session-inject-monitor",
+    displayName: "Session Inject Monitor",
+    description: "Set up a declarative monitor that injects a prompt into a live coding-agent session when a watched source (conversations, email, todos, knowledge, command output) has new content",
+    category: "Development Tools",
+    tags: ["monitor", "session", "injection", "automation", "wake"],
+    kind: "instruction"
   }
 ];
 
@@ -21233,7 +21495,7 @@ var DESIGN_BRANDING_SKILLS = [
     displayName: "Site Analyze",
     description: "Analyze any website's design system \u2014 detects shadcn/ui, Tailwind, extracts colors, typography, and components via Playwright + Claude Vision.",
     category: "Design & Branding",
-    tags: ["design", "shadcn", "tailwind", "colors", "typography", "playwright", "analysis", "open-styles"]
+    tags: ["design", "shadcn", "tailwind", "colors", "typography", "playwright", "analysis", "styles"]
   }
 ];
 
@@ -22566,6 +22828,9 @@ function getPortableSkillsRoot(options = {}) {
   if (options.rootDir)
     return options.rootDir;
   const appDir = options.homeDir ? join5(options.homeDir, ".hasna", "skills") : getDataDir();
+  const cache = join5(appDir, SKILLS_CACHE_DIRNAME);
+  if (isOwnerLayoutMigrated(appDir) && safeIsDirectory(cache))
+    return cache;
   const installed = join5(appDir, INSTALLED_SKILLS_DIRNAME);
   migrateLegacySkillLayout(appDir, installed);
   return installed;
@@ -23192,6 +23457,7 @@ import { fileURLToPath } from "url";
 
 // src/lib/home-migration.ts
 init_config();
+init_config();
 
 // src/lib/utils.ts
 function normalizeSkillName(name) {
@@ -25928,14 +26194,14 @@ function compactRunToolPayload(payload, detailHint) {
 // src/lib/feedback.ts
 init_config();
 import { existsSync as existsSync13, mkdirSync as mkdirSync7 } from "fs";
-import { dirname as dirname5, join as join13 } from "path";
+import { dirname as dirname6, join as join13 } from "path";
 import { Database } from "bun:sqlite";
 function getFeedbackDbPath() {
   return join13(getDataDir(), "skills.db");
 }
 function getFeedbackDb() {
   const dbPath = getFeedbackDbPath();
-  const dir = dirname5(dbPath);
+  const dir = dirname6(dbPath);
   if (!existsSync13(dir))
     mkdirSync7(dir, { recursive: true });
   const db = new Database(dbPath);
@@ -26382,7 +26648,7 @@ import {
   statSync as statSync8,
   writeFileSync as writeFileSync8
 } from "fs";
-import { dirname as dirname6, join as join15, normalize as normalize3, relative as relative3, sep as sep2 } from "path";
+import { dirname as dirname7, join as join15, normalize as normalize3, relative as relative3, sep as sep2 } from "path";
 init_retired_settings();
 var SKILLS_STORAGE_TABLES = [
   "skills_sync_records",
@@ -26450,7 +26716,7 @@ function getSkillsNativeStorageStatus(options = {}) {
   const s3BucketEnv = readStorageEnv(env, "s3Bucket");
   const targetDir = options.targetDir ?? process.cwd();
   return {
-    package: "open-skills",
+    package: "skills",
     tables: [...SKILLS_STORAGE_TABLES],
     env: {
       databaseUrl: SKILLS_NATIVE_STORAGE_ENV.databaseUrl,
@@ -26603,7 +26869,7 @@ function registerStorageTools(server) {
     const snapshot = exportSkillsLocalSnapshot(targetDir, { includeFileContents: false });
     const s3Plan = config2.s3Bucket ? planSkillsS3SnapshotUpload(snapshot, { prefix: config2.s3Prefix }) : [];
     return mcpJson({
-      package: "open-skills",
+      package: "skills",
       noNetwork: true,
       databaseConfigured: Boolean(config2.databaseUrl),
       s3Configured: Boolean(config2.s3Bucket),