kira-glasses-bridge 2.4.0 → 2.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kira-glasses-bridge",
-  "version": "2.4.0",
+  "version": "2.5.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/index.mjs

@@ -9,7 +9,7 @@ import { agentById, AGENTS } from './agents/index.mjs'
 import { normalizeAnswer } from './agents/protocol.mjs'
 import { openApp, installedApps } from './apps.mjs'
 import { listFiles, readUserFile, createFolder, writeUserFile, trashPath, resolveUserPath } from './files.mjs'
-import { prepareWorktree, worktreeStatus, pushWorktree, removeWorktree, repoOfFolder } from './worktrees.mjs'
+import { prepareWorktree, worktreeStatus, pushWorktree, removeWorktree, repoOfFolder, stageFiles } from './worktrees.mjs'
 
 import { createRequire } from 'node:module'
 const { version: BRIDGE_VERSION } = createRequire(import.meta.url)('../package.json')
@@ -151,6 +151,10 @@ end tell`
   remove_worktree(args) {
     return removeWorktree(args)
   },
+  /** A task's reference files, downloaded into the worktree's .kira/files for the agent. */
+  stage_files(args) {
+    return stageFiles(args)
+  },
   /** Which GitHub repo a folder's origin points at (project link enrichment). */
   async repo_of_folder(args) {
     return { repo: await repoOfFolder(args.path) }

package/src/worktrees.mjs

@@ -5,7 +5,10 @@
 import { execFile } from 'node:child_process'
 import { homedir } from 'node:os'
 import { isAbsolute, join, resolve } from 'node:path'
-import { mkdir, stat } from 'node:fs/promises'
+import { mkdir, stat, readFile, writeFile, appendFile, rm } from 'node:fs/promises'
+import { pipeline } from 'node:stream/promises'
+import { createWriteStream } from 'node:fs'
+import { Readable } from 'node:stream'
 import { display } from './git.mjs'
 import { resolveUserPath } from './files.mjs'
 
@@ -162,3 +165,49 @@ export async function removeWorktree({ path: p, delete_branch: deleteBranch }) {
   if (deleteBranch && main && branch && branch !== 'HEAD') branchDeleted = (await git(main, ['branch', '-D', branch])).ok
   return { removed: true, branch, branch_deleted: branchDeleted }
 }
+
+const STAGE_DIR = '.kira/files'
+const STAGE_MAX_BYTES = 200 * 1024 * 1024
+
+/**
+ * Put a task's reference files into the worktree under .kira/files (excluded
+ * from git through .git/info/exclude, never committed), so the agent can open
+ * them like anything else on disk. Downloads from short-lived signed URLs.
+ */
+export async function stageFiles({ path: p, files }) {
+  const path = resolveUserPath(String(p ?? ''))
+  if (!(await exists(join(path, '.git')))) return { error: 'no worktree at that path', path: display(path) }
+  const dir = join(path, STAGE_DIR)
+  await rm(dir, { recursive: true, force: true })
+  await mkdir(dir, { recursive: true })
+  // A worktree's .git is a file pointing at the real gitdir; git tells us where its exclude file lives.
+  const excl = await git(path, ['rev-parse', '--git-path', 'info/exclude'])
+  if (excl.ok) {
+    const file = isAbsolute(excl.out) ? excl.out : join(path, excl.out)
+    await mkdir(join(file, '..'), { recursive: true })
+    const current = await readFile(file, 'utf8').catch(() => '')
+    if (!current.split('\n').includes('/.kira/')) await appendFile(file, `${current && !current.endsWith('\n') ? '\n' : ''}/.kira/\n`)
+  }
+  const staged = []
+  let total = 0
+  const seen = new Set()
+  for (const f of files ?? []) {
+    let name = String(f.name ?? 'file').replace(/[\/\\]/g, '_')
+    if (seen.has(name)) name = `${name.replace(/(\.[^.]+)?$/, '')}-${seen.size}${/\.[^.]+$/.exec(name)?.[0] ?? ''}`
+    seen.add(name)
+    try {
+      const res = await fetch(String(f.url))
+      if (!res.ok || !res.body) throw new Error(`download failed (${res.status})`)
+      const len = Number(res.headers.get('content-length') ?? 0)
+      if (total + len > STAGE_MAX_BYTES) throw new Error('over the staging size limit')
+      const dest = join(dir, name)
+      await pipeline(Readable.fromWeb(res.body), createWriteStream(dest))
+      const size = (await stat(dest)).size
+      total += size
+      staged.push({ name, path: `${STAGE_DIR}/${name}`, bytes: size, description: f.description || undefined })
+    } catch (err) {
+      staged.push({ name, error: err.message })
+    }
+  }
+  return { dir: `${STAGE_DIR}/`, staged, bytes: total }
+}