kira-glasses-bridge 2.12.0 → 2.14.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kira-glasses-bridge",
-  "version": "2.12.0",
+  "version": "2.14.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-designs.mjs

@@ -0,0 +1,180 @@
+// Designs Claude Code made on this Mac: artifacts it published to claude.ai, and the HTML/SVG
+// mockups it wrote (design/ folders, Claude Design projects, scratchpad pages). Read through the
+// Agent SDK like claude-sessions.mjs. A design's HTML comes from the file when it's still on disk,
+// and otherwise from the transcript itself (its Write, then its Edits replayed), since most were
+// written to a scratchpad that macOS has since cleared.
+import { getSessionMessages, getSubagentMessages, listSessions as sdkListSessions, listSubagents } from '@anthropic-ai/claude-agent-sdk'
+import { createHash } from 'node:crypto'
+import { readFile, stat } from 'node:fs/promises'
+import { homedir } from 'node:os'
+import { basename, dirname, extname, relative } from 'node:path'
+
+const MAX_BYTES = 2 * 1024 * 1024
+const DESIGN_DIR = /^(design|designs|mock|mocks|mockups?|prototypes?|wireframes?)$/i
+const DESIGN_NAME = /(mock|design|prototype|wireframe|preview)/i
+const NEVER = /^(node_modules|dist|build|out|\.git|\.next|coverage)$/
+
+const sha = s => createHash('sha256').update(s).digest('hex')
+
+/** Whether a file Claude wrote is a design rather than app source. */
+function isDesignPath(path) {
+  const ext = extname(path).toLowerCase()
+  if (ext !== '.html' && ext !== '.svg') return false
+  const parts = path.split('/')
+  if (parts.some(p => NEVER.test(p))) return false
+  if (path.includes('/scratchpad/') || path.endsWith('.dc.html')) return true
+  return parts.slice(0, -1).some(p => DESIGN_DIR.test(p)) || DESIGN_NAME.test(basename(path))
+}
+
+/** The folder a design sits in, as a short label that groups a set of screens ("kira-cards", "design/assignee-menu"). */
+function collectionOf(path, cwd) {
+  const pad = path.indexOf('/scratchpad/')
+  let dir = pad >= 0 ? dirname(path.slice(pad + '/scratchpad/'.length)) : cwd && path.startsWith(cwd + '/') ? dirname(relative(cwd, path)) : basename(dirname(path))
+  dir = dir.replace(/\/project$/, '')
+  return dir && dir !== '.' ? dir : null
+}
+
+/** The repo a session worked in: Kira task worktrees are ~/.kira/worktrees/<owner>/<repo>/<task>. */
+function repoOf(cwd) {
+  if (!cwd) return null
+  if (cwd === homedir()) return 'Home'
+  const m = /\/\.kira\/worktrees\/[^/]+\/([^/]+)\//.exec(cwd + '/')
+  return m ? m[1] : basename(cwd)
+}
+
+function titleOf(path, html) {
+  const t = /<title[^>]*>([^<]{1,120})<\/title>/i.exec(html ?? '')?.[1]?.trim()
+  if (t) return t.replace(/&amp;/g, '&').replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&quot;/g, '"').replace(/&#39;/g, "'")
+  return basename(path).replace(/(\.dc)?\.(html|svg)$/i, '').replace(/^\d+[-_]/, '').replace(/[-_]+/g, ' ').replace(/\b\w/g, c => c.toUpperCase())
+}
+
+function applyEdit(text, e) {
+  if (text == null || typeof e?.old_string !== 'string' || !text.includes(e.old_string)) return null
+  return e.replace_all ? text.split(e.old_string).join(e.new_string ?? '') : text.replace(e.old_string, () => e.new_string ?? '')
+}
+
+const resultText = c => (typeof c === 'string' ? c : Array.isArray(c) ? c.map(b => b?.text ?? '').join('\n') : '')
+
+/** Every design one session made, with its latest HTML as of the end of the transcript. */
+async function designsOf(s) {
+  const opts = s.cwd ? { dir: s.cwd } : undefined
+  // Subagents write designs too (a design pass is often delegated), so read their transcripts after the session's own.
+  const messages = await getSessionMessages(s.sessionId, opts)
+  for (const agent of await listSubagents(s.sessionId, opts).catch(() => [])) messages.push(...(await getSubagentMessages(s.sessionId, agent, opts).catch(() => [])))
+  const files = new Map() // path -> { content, created, updated }
+  const publishes = new Map() // tool_use id -> Artifact publish input
+  const artifacts = new Map() // url -> { path, description, icon, title, version, created, updated }
+  for (const m of messages) {
+    const at = m.timestamp ?? null
+    const content = m.message?.content
+    if (!Array.isArray(content)) continue
+    for (const b of content) {
+      if (b?.type === 'tool_use') {
+        const i = b.input ?? {}
+        const path = typeof i.file_path === 'string' ? i.file_path : null
+        if (b.name === 'Write' && path) {
+          const f = files.get(path)
+          files.set(path, { content: typeof i.content === 'string' ? i.content : null, created: f?.created ?? at, updated: at })
+        } else if ((b.name === 'Edit' || b.name === 'MultiEdit') && path && files.has(path)) {
+          const f = files.get(path)
+          for (const e of b.name === 'Edit' ? [i] : (i.edits ?? [])) f.content = applyEdit(f.content, e)
+          f.updated = at
+        } else if (b.name === 'Artifact' && (i.action ?? 'publish') === 'publish' && !i.asset) {
+          publishes.set(b.id, i)
+        }
+      } else if (b?.type === 'tool_result' && publishes.has(b.tool_use_id)) {
+        const i = publishes.get(b.tool_use_id)
+        const m2 = /at (https:\/\/claude\.ai\/\S*artifact\/[\w-]+)(?: \(Version (\d+)\))?/.exec(resultText(b.content))
+        if (!m2 || b.is_error) continue
+        const prev = artifacts.get(m2[1])
+        artifacts.set(m2[1], {
+          path: i.file_path ?? prev?.path ?? null,
+          description: i.description ?? prev?.description ?? null,
+          icon: i.icon ?? prev?.icon ?? null,
+          title: i.title ?? prev?.title ?? null,
+          version: Number(m2[2]) || prev?.version || 1,
+          created: prev?.created ?? at,
+          updated: at,
+        })
+      }
+    }
+  }
+
+  const out = []
+  const published = new Map([...artifacts].filter(([, a]) => a.path).map(([url, a]) => [a.path, { url, ...a }]))
+  const base = { session_id: s.sessionId, session_title: s.customTitle || s.summary || s.firstPrompt?.slice(0, 80) || null, cwd: s.cwd ?? null, repo: repoOf(s.cwd) }
+  for (const [path, f] of files) {
+    const art = published.get(path)
+    if (!art && !isDesignPath(path)) continue
+    const onDisk = await stat(path).then(st => st.isFile() && st.size <= MAX_BYTES, () => false)
+    const html = onDisk ? await readFile(path, 'utf8').catch(() => f.content) : f.content
+    if (!html || Buffer.byteLength(html) > MAX_BYTES) continue
+    out.push({
+      ...base,
+      key: sha(`${s.sessionId}:${path}`).slice(0, 32),
+      kind: art ? 'artifact' : path.endsWith('.dc.html') ? 'claude_design' : extname(path).slice(1).toLowerCase(),
+      title: art?.title || titleOf(path, html),
+      description: art?.description ?? null,
+      icon: art?.icon ?? null,
+      path: path.replace(homedir(), '~'),
+      collection: collectionOf(path, s.cwd),
+      artifact_url: art?.url ?? null,
+      artifact_version: art?.version ?? null,
+      on_disk: onDisk,
+      created_at: art?.created ?? f.created,
+      updated_at: art?.updated && art.updated > f.updated ? art.updated : f.updated,
+      content_hash: sha(html),
+      bytes: Buffer.byteLength(html),
+      html,
+    })
+  }
+  // Published without a file Claude wrote in this session (a deck, a doc, or a page from an earlier one).
+  for (const [url, a] of artifacts) {
+    if (a.path && files.has(a.path)) continue
+    const html = a.path ? await readFile(a.path, 'utf8').catch(() => null) : null
+    out.push({
+      ...base,
+      key: sha(url).slice(0, 32),
+      kind: 'artifact',
+      title: a.title || (a.path ? titleOf(a.path, html) : 'Untitled artifact'),
+      description: a.description,
+      icon: a.icon,
+      path: a.path ? a.path.replace(homedir(), '~') : null,
+      collection: a.path ? collectionOf(a.path, s.cwd) : null,
+      artifact_url: url,
+      artifact_version: a.version,
+      on_disk: !!html,
+      created_at: a.created,
+      updated_at: a.updated,
+      content_hash: html ? sha(html) : null,
+      bytes: html ? Buffer.byteLength(html) : 0,
+      html,
+    })
+  }
+  return out
+}
+
+/**
+ * Scan every session changed since `since` (ISO time; all of them when omitted). Returns the
+ * designs without their HTML, plus the HTML of those whose hash isn't in `known` (hashes the API
+ * already holds), so a rescan sends only what changed.
+ */
+export async function scanDesigns({ since, known = [] } = {}) {
+  const after = since ? Date.parse(since) || 0 : 0
+  const have = new Set(known)
+  const sessions = (await sdkListSessions()).filter(s => s.lastModified > after)
+  const designs = []
+  let failed = 0
+  for (const s of sessions) {
+    try {
+      designs.push(...(await designsOf(s)))
+    } catch {
+      failed++
+    }
+  }
+  return {
+    scanned: sessions.length,
+    failed,
+    designs: designs.map(({ html, ...d }) => ({ ...d, html: html && !have.has(d.content_hash) ? html : undefined })),
+  }
+}

package/src/index.mjs

@@ -3,6 +3,7 @@
 // machine on the user's behalf. Env: KIRA_BRIDGE_URL, KIRA_BRIDGE_TOKEN.
 import WebSocket from 'ws'
 import { listProjects, listSessions, readSession } from './claude-sessions.mjs'
+import { scanDesigns } from './claude-designs.mjs'
 import { snapshot, changesSince, display, setupProjectFolder } from './git.mjs'
 import { resolveCwd, folderExists } from './claude-run.mjs'
 import { agentById, AGENTS } from './agents/index.mjs'
@@ -110,6 +111,9 @@ const tools = {
   async list_claude_projects(args) {
     return listProjects(args.max)
   },
+  async scan_claude_designs(args) {
+    return scanDesigns({ since: args.since, known: Array.isArray(args.known) ? args.known : [] })
+  },
   async list_claude_sessions(args) {
     return listSessions(args.max)
   },

package/src/worktrees.mjs

@@ -237,9 +237,17 @@ function mimeOf(name) {
 }
 
 /** Files under an output folder of a worktree (a designer's design/, a researcher's docs/research/), with sizes and types. */
-export async function listOutputs({ path: p, dir }) {
+export async function listOutputs({ path: p, dir, only }) {
   const path = resolveUserPath(String(p ?? ''))
   const base = join(path, String(dir ?? '').replace(/^\/+|\/+$/g, ''))
+  // One named file (a terminal session's task_attach) may sit anywhere in the worktree, the root too.
+  if (typeof only === 'string' && only) {
+    const full = join(base, only)
+    if (only.includes('/') || !(base === path || base.startsWith(path + '/')) || !full.startsWith(path + '/')) return { error: 'bad output file' }
+    const s = await stat(full).catch(() => null)
+    if (!s?.isFile()) return { dir, files: [], bytes: 0 }
+    return { dir, files: [{ rel: only, bytes: s.size, mime: mimeOf(only) }], bytes: s.size }
+  }
   if (!base.startsWith(path + '/')) return { error: 'bad output folder' }
   const { readdir } = await import('node:fs/promises')
   const out = []