kira-glasses-bridge 2.22.0 → 2.23.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kira-glasses-bridge",
-  "version": "2.22.0",
+  "version": "2.23.0",
   "description": "Connects your Mac to Kira, the assistant for Even G2 glasses: Claude Code sessions, files, folders and apps, by voice.",
   "type": "module",
   "bin": {

package/src/claude-config.mjs

@@ -0,0 +1,153 @@
+// Claude Code's own skills on this Mac: one SKILL.md each in ~/.claude/skills/<slug>/ (or under
+// $CLAUDE_CONFIG_DIR), which Claude Code and the bridge's Agent SDK jobs load natively. Kira lists
+// all of them (hers and any other), and writes and removes the ones a person makes in Kira. Every
+// path is confined to that folder: a slug is one plain folder name, and a symlinked folder is never
+// written through.
+import { lstat, mkdir, readdir, readFile, rename, rmdir, stat, unlink, writeFile } from 'node:fs/promises'
+import { homedir } from 'node:os'
+import { join, relative } from 'node:path'
+
+const SLUG = /^[a-z0-9][a-z0-9-]{0,63}$/
+/** A SKILL.md past this isn't one: skipped when listing, refused when writing. */
+const MAX_MD = 256 * 1024
+
+/** Where Claude Code keeps personal skills. */
+function skillsRoot() {
+  return join(process.env.CLAUDE_CONFIG_DIR || join(homedir(), '.claude'), 'skills')
+}
+
+/** The folder for a skill, after checking its slug can't name anything else. */
+function folder(root, slug) {
+  const s = String(slug ?? '')
+  if (!SLUG.test(s)) throw new Error(`“${s}” isn’t a skill folder name (lowercase letters, digits and dashes)`)
+  return join(root, s)
+}
+
+/** As people read it: under the home folder with ~. */
+function display(full) {
+  const rel = relative(homedir(), full)
+  return rel && !rel.startsWith('..') ? `~/${rel}` : full
+}
+
+/** A front-matter value: quoted or plain on its line, or a `|` / `>` block below it. */
+function field(front, key) {
+  const lines = front.split('\n')
+  const at = lines.findIndex(l => l.startsWith(`${key}:`))
+  if (at < 0) return null
+  const raw = lines[at].slice(key.length + 1).trim()
+  if (/^[|>][+-]?$/.test(raw)) {
+    const block = []
+    for (const l of lines.slice(at + 1)) {
+      if (l.trim() && !/^\s/.test(l)) break
+      block.push(l.trim())
+    }
+    return block.join(raw.startsWith('|') ? '\n' : ' ').trim() || null
+  }
+  const quoted = /^(["'])(.*)\1$/.exec(raw)
+  return (quoted ? quoted[2] : raw.replace(/\s+#.*$/, '')).trim() || null
+}
+
+/** The name and description Claude Code shows, from a SKILL.md (the folder's name when it has none). */
+export function skillSummary(md, slug) {
+  const m = /^---\r?\n([\s\S]*?)\r?\n---/.exec(md)
+  const front = m ? m[1].replace(/\r\n/g, '\n') : ''
+  const body = m ? md.slice(m[0].length) : md
+  const firstLine = body.split('\n').map(l => l.trim()).find(Boolean) ?? ''
+  return { name: field(front, 'name') || slug, description: field(front, 'description') || firstLine }
+}
+
+async function isSymlink(p) {
+  return lstat(p).then(
+    s => s.isSymbolicLink(),
+    () => false,
+  )
+}
+
+/** A folder that links elsewhere is changed where it really is, never through the link. */
+async function refuseLinks(root, dir, verb) {
+  if ((await isSymlink(root)) || (await isSymlink(dir))) {
+    throw new Error(`${display(dir)} is a link to somewhere else; ${verb} it there`)
+  }
+}
+
+/** Every skill in the folder: its slug, name, description, where it is, and its SKILL.md. */
+export async function listSkills(root = skillsRoot()) {
+  const entries = await readdir(root, { withFileTypes: true }).catch(e => {
+    if (e.code === 'ENOENT') return []
+    throw e
+  })
+  const skills = []
+  for (const e of entries) {
+    if (!SLUG.test(e.name) || !(e.isDirectory() || e.isSymbolicLink())) continue
+    const file = join(root, e.name, 'SKILL.md')
+    const st = await stat(file).catch(() => null)
+    if (!st?.isFile() || st.size > MAX_MD) continue
+    const md = await readFile(file, 'utf8').catch(() => null)
+    if (md === null) continue
+    skills.push({ slug: e.name, ...skillSummary(md, e.name), path: display(join(root, e.name)), md })
+  }
+  skills.sort((a, b) => a.slug.localeCompare(b.slug))
+  return { root: display(root), skills }
+}
+
+/** One skill's SKILL.md. */
+export async function readSkill({ slug } = {}, root = skillsRoot()) {
+  const dir = folder(root, slug)
+  const md = await readFile(join(dir, 'SKILL.md'), 'utf8').catch(() => null)
+  if (md === null) return { error: `No skill in ${display(dir)}` }
+  return { slug, ...skillSummary(md, slug), path: display(dir), md }
+}
+
+/**
+ * Write a skill's SKILL.md, whole: replacing the one there, or with `create` only a new one (a skill
+ * already in that folder, Kira's or not, is never overwritten by a new one of the same name).
+ */
+export async function writeSkill({ slug, md, create = false } = {}, root = skillsRoot()) {
+  const dir = folder(root, slug)
+  const text = String(md ?? '')
+  if (!/^---\r?\n/.test(text)) throw new Error('A SKILL.md starts with front matter between --- lines')
+  if (Buffer.byteLength(text) > MAX_MD) throw new Error('That SKILL.md is too large')
+  await refuseLinks(root, dir, 'edit')
+  const file = join(dir, 'SKILL.md')
+  if (create && (await stat(file).catch(() => null))) throw new Error(`A skill named ${slug} is already on your Mac`)
+  await mkdir(dir, { recursive: true })
+  const tmp = join(dir, `.SKILL.md.${process.pid}.tmp`)
+  await writeFile(tmp, text, 'utf8')
+  await rename(tmp, file)
+  return { slug, ...skillSummary(text, slug), path: display(dir) }
+}
+
+/**
+ * Remove a skill: its SKILL.md goes (so Claude Code stops loading it), and the folder too when
+ * nothing else is in it. Anything else a skill folder holds (scripts, references) stays.
+ */
+export async function removeSkill({ slug } = {}, root = skillsRoot()) {
+  const dir = folder(root, slug)
+  await refuseLinks(root, dir, 'remove')
+  const gone = await unlink(join(dir, 'SKILL.md')).then(
+    () => true,
+    e => {
+      if (e.code === 'ENOENT') return false
+      throw e
+    },
+  )
+  const left = await readdir(dir).catch(() => [])
+  if (!left.length) await rmdir(dir).catch(() => {})
+  return { slug, removed: gone, path: display(dir), kept: left.length ? left : undefined }
+}
+
+/** The bridge tools (index.mjs). */
+export const skillTools = {
+  async list_skills() {
+    return listSkills()
+  },
+  async read_skill(args) {
+    return readSkill(args)
+  },
+  async write_skill(args) {
+    return writeSkill(args)
+  },
+  async remove_skill(args) {
+    return removeSkill(args)
+  },
+}

package/src/index.mjs

@@ -4,6 +4,7 @@
 import { createRequire } from 'node:module'
 import { AGENTS } from './agents/index.mjs'
 import { claudeTools } from './agents/claude-local.mjs'
+import { skillTools } from './claude-config.mjs'
 import { connect, disconnect, sendIfLive } from './connection.mjs'
 import { fileTools } from './file-tools.mjs'
 import { gitTools } from './git-tools.mjs'
@@ -22,6 +23,7 @@ const tools = {
   ...jobTools,
   ...gitTools,
   ...claudeTools,
+  ...skillTools,
 }
 
 /** What this bridge build implements, told to the API after its hello. */