@serviceme/devtools-core 0.1.8 → 0.2.0

package/dist/types-B9gk3dXH.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Skill & Agent v2 — SkillStore Types
+ *
+ * SkillStore scans the local `~/.serviceme/repos/<id>/` tree to produce
+ * a unified list of skills + agents. The store is the single source of
+ * truth for "what's available right now" — the UI reads it; SubmitClient
+ * reads it; install flows read it.
+ *
+ * Three repo layouts are supported in v1 (per spec §12):
+ *   1. **Default** (`medalsoftchina-ms-skills`): `skills/<name>/SKILL.md`
+ *      + `agents/<name>/AGENT.md`.
+ *   2. **Anthropic-style flat** (`anthropics/skills`): each subdir of
+ *      the repo root IS a skill — `<name>/SKILL.md` (no `skills/`
+ *      intermediate).
+ *   3. **awesome-copilot style** (`github/awesome-copilot`): mixed
+ *      prompts/instructions/agents at the root.
+ *
+ * Normalization rule (spec §12): for every directory under the repo
+ * root, peek for a `SKILL.md` or `AGENT.md` file. If present, register
+ * it as a skill or agent respectively. This is more permissive than
+ * guessing from the directory name and works for all three styles.
+ *
+ * The store is local-only and pure — no git, no network. Tests
+ * construct a fixture repo tree and pass the root in directly.
+ */
+/** What's available at this entry: a skill or an agent. */
+type SkillKind = "skill" | "agent";
+/** Top-level summary of a discovered skill/agent entry. */
+interface SkillEntry {
+    /** Repository the entry was found in. */
+    repoId: string;
+    /** Skill or agent name (the directory name under the repo). */
+    name: string;
+    kind: SkillKind;
+    /** Absolute path to the SKILL.md / AGENT.md file. */
+    manifestPath: string;
+    /** Absolute path to the directory containing the entry's files. */
+    dir: string;
+    /** Parsed frontmatter (best-effort; raw key/value map). */
+    frontmatter: Record<string, unknown>;
+    /** ISO timestamp of the manifest file's mtime. */
+    modifiedAt: string;
+}
+/** Full detail of an entry: summary + all the files inside the dir. */
+interface SkillDetail extends SkillEntry {
+    files: SkillFile[];
+}
+/** A single file inside a skill / agent directory. */
+interface SkillFile {
+    /** Path relative to the entry's directory. */
+    path: string;
+    /** UTF-8 content. */
+    content: string;
+}
+/** Sentinel error for store lookups that miss. */
+declare class SkillNotFoundError extends Error {
+    readonly repoId: string;
+    readonly skillName: string;
+    constructor(repoId: string, skillName: string);
+}
+
+export { type SkillEntry as S, type SkillDetail as a, type SkillFile as b, type SkillKind as c, SkillNotFoundError as d };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serviceme/devtools-core",
-  "version": "0.1.8",
+  "version": "0.2.0",
   "description": "Reusable Node.js core capabilities powering the SERVICEME CLI and integrations.",
   "license": "SEE LICENSE IN LICENSE.md",
   "repository": {
@@ -23,6 +23,50 @@
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./skill-store": {
+      "types": "./dist/skill-store.d.ts",
+      "import": "./dist/skill-store.mjs",
+      "require": "./dist/skill-store.js",
+      "default": "./dist/skill-store.js"
+    },
+    "./skill-linker": {
+      "types": "./dist/skill-linker.d.ts",
+      "import": "./dist/skill-linker.mjs",
+      "require": "./dist/skill-linker.js",
+      "default": "./dist/skill-linker.js"
+    },
+    "./submit": {
+      "types": "./dist/submit.d.ts",
+      "import": "./dist/submit.mjs",
+      "require": "./dist/submit.js",
+      "default": "./dist/submit.js"
+    },
+    "./auth": {
+      "types": "./dist/auth.d.ts",
+      "import": "./dist/auth.mjs",
+      "require": "./dist/auth.js",
+      "default": "./dist/auth.js"
+    },
+    "./device": {
+      "types": "./dist/device.d.ts",
+      "import": "./dist/device.mjs",
+      "require": "./dist/device.js",
+      "default": "./dist/device.js"
+    },
+    "./toolbox": {
+      "types": "./dist/toolbox.d.ts",
+      "import": "./dist/toolbox.mjs",
+      "require": "./dist/toolbox.js",
+      "default": "./dist/toolbox.js"
+    }
+  },
   "files": [
     "dist",
     "README.md",
@@ -36,7 +80,8 @@
     "comment-json": "^4.5.1",
     "json5": "^2.2.3",
     "yauzl": "^3.2.0",
-    "@serviceme/devtools-protocol": "0.1.8"
+    "zod": "^3.23.8",
+    "@serviceme/devtools-protocol": "0.2.0"
   },
   "devDependencies": {
     "@types/node": "^24",
@@ -46,11 +91,11 @@
     "typescript": "^5.9.3"
   },
   "scripts": {
-    "watch": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "watch": "tsup --watch",
     "lint": "biome check src test",
-    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "build": "tsup",
     "typecheck": "tsc --noEmit",
-    "test": "pnpm run build && node --test test/**/*.test.js && node --import tsx --test src/**/__tests__/**/*.test.ts",
+    "test": "pnpm run build && node --test test/**/*.test.js && node --import tsx --test --test-force-exit src/**/__tests__/**/*.test.ts",
     "release:check": "pnpm run build && npm pack --dry-run",
     "pack": "npm pack",
     "publish:npm": "pnpm publish --access public --no-git-checks"