@soederpop/luca 0.1.2 → 0.2.1

package/.github/workflows/release.yaml

@@ -0,0 +1,167 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build-linux:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Pre-build steps
+        run: |
+          bash scripts/stamp-build.sh
+          bun run build:introspection
+          bun run build:scaffolds
+          bun run build:bootstrap
+          bun run build:python-bridge
+
+      - name: Build Linux binaries
+        run: |
+          mkdir -p dist/release
+          bun build ./src/cli/cli.ts --compile --target=bun-linux-x64 --outfile dist/release/luca-linux-x64 --external node-llama-cpp
+          bun build ./src/cli/cli.ts --compile --target=bun-linux-arm64 --outfile dist/release/luca-linux-arm64 --external node-llama-cpp
+
+      - name: Upload Linux artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: linux-binaries
+          path: dist/release/luca-linux-*
+
+  build-windows:
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Pre-build steps
+        shell: bash
+        run: |
+          bash scripts/stamp-build.sh
+          bun run build:introspection
+          bun run build:scaffolds
+          bun run build:bootstrap
+          bun run build:python-bridge
+
+      - name: Build Windows binary
+        shell: bash
+        run: |
+          mkdir -p dist/release
+          bun build ./src/cli/cli.ts --compile --target=bun-windows-x64 --outfile dist/release/luca-windows-x64.exe --external node-llama-cpp
+
+      - name: Upload Windows artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: windows-binaries
+          path: dist/release/luca-windows-x64.exe
+
+  build-macos:
+    runs-on: macos-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Pre-build steps
+        run: |
+          bash scripts/stamp-build.sh
+          bun run build:introspection
+          bun run build:scaffolds
+          bun run build:bootstrap
+          bun run build:python-bridge
+
+      - name: Build macOS binaries
+        run: |
+          mkdir -p dist/release
+          bun build ./src/cli/cli.ts --compile --target=bun-darwin-x64 --outfile dist/release/luca-darwin-x64 --external node-llama-cpp
+          bun build ./src/cli/cli.ts --compile --target=bun-darwin-arm64 --outfile dist/release/luca-darwin-arm64 --external node-llama-cpp
+
+      - name: Import Developer ID Certificate
+        env:
+          CERTIFICATE_P12: ${{ secrets.APPLE_CERTIFICATE_P12 }}
+          CERTIFICATE_PASSWORD: ${{ secrets.APPLE_CERTIFICATE_PASSWORD }}
+        run: |
+          echo "$CERTIFICATE_P12" | base64 --decode > certificate.p12
+          security create-keychain -p "" build.keychain
+          security import certificate.p12 -k build.keychain \
+            -P "$CERTIFICATE_PASSWORD" -T /usr/bin/codesign
+          security list-keychains -s build.keychain
+          security default-keychain -s build.keychain
+          security unlock-keychain -p "" build.keychain
+          security set-key-partition-list -S apple-tool:,apple: \
+            -s -k "" build.keychain
+
+      - name: Sign macOS binaries
+        run: |
+          codesign --sign "Developer ID Application: Demitra Del Fiacco (77WL45HR8M)" \
+            --force --options runtime --timestamp dist/release/luca-darwin-x64
+          codesign --sign "Developer ID Application: Demitra Del Fiacco (77WL45HR8M)" \
+            --force --options runtime --timestamp dist/release/luca-darwin-arm64
+
+      - name: Notarize macOS binaries
+        env:
+          APPLE_ID: ${{ secrets.APPLE_ID }}
+          APPLE_APP_PASSWORD: ${{ secrets.APPLE_APP_PASSWORD }}
+          APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}
+        run: |
+          zip dist/release/luca-darwin-x64.zip dist/release/luca-darwin-x64
+          xcrun notarytool submit dist/release/luca-darwin-x64.zip \
+            --apple-id "$APPLE_ID" \
+            --password "$APPLE_APP_PASSWORD" \
+            --team-id "$APPLE_TEAM_ID" \
+            --wait
+
+          zip dist/release/luca-darwin-arm64.zip dist/release/luca-darwin-arm64
+          xcrun notarytool submit dist/release/luca-darwin-arm64.zip \
+            --apple-id "$APPLE_ID" \
+            --password "$APPLE_APP_PASSWORD" \
+            --team-id "$APPLE_TEAM_ID" \
+            --wait
+
+      - name: Staple notarization
+        run: |
+          xcrun stapler staple dist/release/luca-darwin-x64 || true
+          xcrun stapler staple dist/release/luca-darwin-arm64 || true
+
+      - name: Upload macOS artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: macos-binaries
+          path: dist/release/luca-darwin-*
+          exclude: |
+            dist/release/*.zip
+
+  create-release:
+    needs: [build-linux, build-windows, build-macos]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          merge-multiple: true
+          path: dist/release
+
+      - name: Create draft GitHub release
+        uses: softprops/action-gh-release@v2
+        with:
+          draft: true
+          generate_release_notes: true
+          files: dist/release/*

package/CLAUDE.md

@@ -111,3 +111,5 @@ This means **JSDoc blocks on helpers (features, clients, servers) must be valid
 ## Git Strategy
 
 - We generally roll all on main.  Commit your changes after you're done, only your changes.  Leave a good message, tell me why don't just tell me what.  Don't gimme that coauthored by whoever bullshit.  The streets know we're one.
+
+- Always commit your work

package/README.md

@@ -229,8 +229,11 @@ The CLI works great alongside Claude Code, Codex, and other coding assistants:
 git clone https://github.com/soederpop/luca.git
 cd luca
 bun install
+bun run setup
 ```
 
+`bun run setup` applies `git update-index --skip-worktree` to the build artifact stubs so local changes to generated files (from running `build:introspection`, `build:scaffolds`, etc.) are never accidentally committed.
+
 ### Running in dev
 
 ```sh

package/assistants/codingAssistant/ABOUT.md

@@ -0,0 +1,3 @@
+# Luca Coding Assistant
+
+The Luca Coding assistant understands the Luca framework, and how to learn it.

package/assistants/codingAssistant/CORE.md

@@ -1,25 +1,30 @@
-# Coding Assistant
+---
+skills:
+  - luca-framework
+---
+# Luca Coding Assistant
 
-You are a coding assistant whose purpose is to read and understand codebases as efficiently as possible.
+You are a Luca framework coding assistant. You read, search, understand, and modify Luca project codebases.
 
-You are armed with the following tools:
+- [Luca Github Repo](https://github.com/soederpop/luca)
 
-- **rg** — ripgrep for fast content search across files. Pass any arguments you'd normally pass to `rg`.
-- **ls** — list files and directories. Pass any arguments you'd normally pass to `ls`.
-- **cat** — read file contents. Pass any arguments you'd normally pass to `cat`.
-- **sed** — stream editor for filtering and transforming text. Pass any arguments you'd normally pass to `sed`.
-- **awk** — pattern scanning and text processing. Pass any arguments you'd normally pass to `awk`.
-- **pwd** — print the current working directory.
+## Luca First
 
-Each tool accepts a single string argument: everything that comes after the command name on the command line. For example, to search for "TODO" in TypeScript files, call `rg` with `"TODO" --type ts`.
+This assistant lives in a Luca project. Load `luca-framework` immediately, use `luca describe` to learn framework APIs, and use `luca eval` to verify runtime behavior. Prefer `luca` over guessing from source when the question is about the framework.
 
 ## How to Work
 
-1. Start by orienting yourself — use `pwd` to know where you are, then `ls` to see what's around.
-2. Use `rg` liberally to find relevant code quickly. It's your most powerful tool.
-3. Use `cat` to read files once you've located them.
-4. Use `sed` and `awk` when you need to extract or transform specific parts of output.
-5. Be efficient — don't read entire large files when `rg` can pinpoint what you need.
-6. Synthesize what you find into clear, concise answers.
+1. **Introspect** -- use `luca describe` for framework APIs and `luca eval` for runtime verification before guessing.
+2. **Orient** -- `ls` to see what's around, `rg` to find what you need. Start broad, narrow fast.
+3. **Read** -- `cat -n` to read files with line numbers. `sed -n "10,30p"` for specific ranges. Don't load 500 lines when you need 20.
+4. **Change** -- `editFile` for surgical edits to existing code. `writeFile` only for new files. Never rewrite what you can edit.
+5. **Verify** -- `runCommand` to build, test, type-check after changes. Don't assume your edit worked.
 
-You are read-only. You do not modify files. Your job is to find, read, and explain code.
+## Rules
+
+- Read before you write. Always.
+- Prefer `editFile` over `writeFile` for existing files -- it makes targeted replacements instead of overwriting.
+- Use `rg` liberally. It is faster and more reliable than guessing file paths or grepping your memory.
+- Keep changes minimal. Fix what was asked, don't refactor the neighborhood.
+- Load `luca-framework` at the start and use the Luca CLI before inferring framework behavior from source.
+- Explain what you're about to do, then do it. No essays.

package/assistants/codingAssistant/hooks.ts

@@ -1,9 +1,22 @@
-import type { Assistant } from "@/agi"
+import type { Assistant, AGIContainer } from '@soederpop/luca/agi'
 
-export function started() {
-	assistant.state.set('startedHookRan', true)
+declare global {
+	var assistant: Assistant
+	var container: AGIContainer
 }
 
-export function created(assistant: Assistant) {
+export function started() {
+	// Shell primitives: rg, ls, cat, sed, awk
+	assistant.use(container.feature('codingTools'))
+
+	// Write operations only -- shell tools cover read/search/list
+	const fileTools = container.feature('fileTools')
+	assistant.use(fileTools.toTools({ only: ['editFile', 'writeFile', 'deleteFile'] }))
+	fileTools.setupToolsConsumer(assistant)
+
+	// Process management: runCommand, spawnProcess, listProcesses, etc.
+	assistant.use(container.feature('processManager'))
+
+	// Skill discovery and loading
 	assistant.use(container.feature('skillsLibrary'))
 }

package/assistants/codingAssistant/tools.ts

@@ -1,108 +1,3 @@
 import { z } from 'zod'
-import type { Assistant, AGIContainer } from '@soederpop/luca/agi'
 
-declare global {
-	var assistant: Assistant
-	var container: AGIContainer
-}
-
-const proc = () => container.feature('proc')
-const fs = () => container.feature('fs')
-
-// Patterns that enable command chaining, substitution, or injection at the shell level.
-const SHELL_INJECTION_PATTERNS = [
-	/;/,          // command chaining
-	/&&/,         // logical AND chaining
-	/\|\|/,       // logical OR chaining
-	/\$\(/,       // command substitution $(...)
-	/`/,          // backtick command substitution
-	/\$\{/,       // variable expansion ${...}
-	/\n/,         // newline injection
-]
-
-// Additional patterns for tools that should not use piping or redirection.
-const PIPE_AND_REDIRECT_PATTERNS = [
-	/\|/,         // piping
-	/>\s*/,       // output redirection
-	/<\(/,        // process substitution
-]
-
-/**
- * Validates that args don't contain shell injection metacharacters.
- * `strict` mode also blocks pipes and redirects (for tools like ls, cat).
- * `permissive` mode allows | and > since they're valid in regex patterns (for rg, sed, awk).
- */
-function sanitizeArgs(args: string, command: string, mode: 'strict' | 'permissive' = 'strict'): string {
-	const patterns = mode === 'strict'
-		? [...SHELL_INJECTION_PATTERNS, ...PIPE_AND_REDIRECT_PATTERNS]
-		: SHELL_INJECTION_PATTERNS
-
-	for (const pattern of patterns) {
-		if (pattern.test(args)) {
-			throw new Error(
-				`Refused to execute ${command}: args contain a disallowed shell metacharacter (matched ${pattern}). ` +
-				`Only pass flags, patterns, and file paths — no command chaining or substitution.`
-			)
-		}
-	}
-
-	return args
-}
-
-export const schemas = {
-	rg: z.object({
-		args: z.string().describe('Arguments to pass to ripgrep, e.g. "TODO" --type ts -n'),
-	}).describe('Search file contents using ripgrep (rg). Fast, recursive, respects .gitignore.'),
-
-	ls: z.object({
-		args: z.string().default('.').describe('Arguments to pass to ls, e.g. -la src/'),
-	}).describe('List files and directories.'),
-
-	cat: z.object({
-		args: z.string().describe('Arguments to pass to cat, e.g. src/index.ts'),
-	}).describe('Read file contents.'),
-
-	sed: z.object({
-		args: z.string().describe('Arguments to pass to sed, e.g. -n "10,20p" src/index.ts'),
-	}).describe('Stream editor for filtering and transforming text.'),
-
-	awk: z.object({
-		args: z.string().describe('Arguments to pass to awk, e.g. \'{print $1}\' file.txt'),
-	}).describe('Pattern scanning and text processing.'),
-
-	writeFile: z.object({
-		path: z.string().describe('File path relative to the project root, e.g. src/utils/helper.ts'),
-		content: z.string().describe('The full content to write to the file'),
-	}).describe('Write content to a file. Creates the file if it does not exist, overwrites if it does.'),
-
-	pwd: z.object({}).describe('Print the current working directory.'),
-}
-
-export function rg({ args }: z.infer<typeof schemas.rg>): string {
-	return proc().exec(`rg ${sanitizeArgs(args, 'rg', 'permissive')}`)
-}
-
-export function ls({ args }: z.infer<typeof schemas.ls>): string {
-	return proc().exec(`ls ${sanitizeArgs(args, 'ls')}`)
-}
-
-export function cat({ args }: z.infer<typeof schemas.cat>): string {
-	return proc().exec(`cat ${sanitizeArgs(args, 'cat')}`)
-}
-
-export function sed({ args }: z.infer<typeof schemas.sed>): string {
-	return proc().exec(`sed ${sanitizeArgs(args, 'sed', 'permissive')}`)
-}
-
-export function awk({ args }: z.infer<typeof schemas.awk>): string {
-	return proc().exec(`awk ${sanitizeArgs(args, 'awk', 'permissive')}`)
-}
-
-export async function writeFile({ path, content }: z.infer<typeof schemas.writeFile>): Promise<string> {
-	await fs().writeFileAsync(path, content)
-	return `Wrote ${content.length} bytes to ${path}`
-}
-
-export function pwd(): string {
-	return proc().exec('pwd')
-}
+export const schemas = {}

package/assistants/inkbot/ABOUT.md

@@ -0,0 +1,5 @@
+# Luca Inkbot Assistant
+
+The Luca Inkbot Assistant is a demo assistant that goes along with the `luca inkbot` command that is available if you check out the Luca Framework's source code from Github.
+
+Inkbot knows how to build TUIs with Ink, and how to learn and discover all available framework APIs.

package/assistants/inkbot/CORE.md

@@ -0,0 +1,71 @@
+---
+maxTokens: 4096
+local: true
+model: mlx-qwopus3.5-27b-v3-vision 
+skills:
+  - luca-framework
+---
+# Inkbot — Canvas Renderer
+
+You are an expert in the Luca framework running inside a split-pane terminal UI. The left pane is this chat. The right pane is a **canvas** that you control by writing TypeScript code.
+
+## How the Canvas Works
+
+You have a `draw` tool. When you call it, the code you provide runs as a **bun subprocess** and its stdout appears in the canvas panel. If the script exits with an error, you receive the stderr — fix the code and redraw.
+
+A "redraw" is just calling `draw` again with updated code. The canvas always shows the output of the most recent run of the active scene.
+
+### Scenes
+
+The canvas supports multiple named **scenes**. Each scene is a separate script. You can:
+
+- `draw` — create or update a scene and run it immediately (default scene id: `"default"`)
+- `create_scene` — stage a scene without running it
+- `run_scene` — run a specific scene
+- `run_all` — run every scene in order
+- `activate_scene` — switch which scene the canvas displays
+- `get_canvas` — inspect the current output, errors, code, and status
+
+### Writing Scene Code
+
+Scene code runs **inside the container** via `vm.run()` with the full container context injected. You have `container`, every enabled feature, and all standard globals available — no imports needed. Use `console.log()` to produce visible output in the canvas.
+
+Available in scene scope:
+- `container` — the live AGI container instance
+- All enabled features as top-level globals (e.g. `fs`, `proc`, `ui`, `grep`, etc.)
+- `fetch`, `URL`, `URLSearchParams`, `Buffer`, `process`, `setTimeout`, etc.
+
+Use your `luca_describe` tools to learn the APIs. Then write scene code that uses them directly:
+
+```ts
+// Example: list available features
+const available = container.features.available
+console.log("Available features:")
+available.forEach(f => console.log(`  - ${f}`))
+```
+
+```ts
+// Example: read and display a file
+const content = fs.readFile('package.json')
+const pkg = JSON.parse(content)
+console.log(`${pkg.name} v${pkg.version}`)
+console.log(`Dependencies: ${Object.keys(pkg.dependencies || {}).length}`)
+```
+
+Tips:
+- **Simple output**: `console.log("Hello world")` — plain text renders in the canvas.
+- **Formatted tables**: Build strings with padding, box-drawing characters, or ANSI escape codes.
+- **Dynamic data**: Fetch APIs, read files, compute values — full container power.
+- **Async**: Top-level `await` works. Fetch URLs, run queries, whatever you need.
+
+### Error Recovery
+
+If your code has a bug, you will receive the error output. Read the error carefully, fix the issue, and call `draw` again. Do not apologize excessively — just fix it and redraw. The user expects iteration.
+
+## Your Personality
+
+You are creative, concise, and action-oriented. When the user asks you to render something, do it immediately — show, don't tell. Keep chat responses brief; let the canvas speak. When explaining what you drew, be specific about what's visible.
+
+## Your Tools
+
+In addition to the canvas tools above, you have access to Luca framework inspection tools (`luca_describe`, etc.) through the skills library. Use them to look up features, APIs, and helpers when writing scene code.

package/assistants/inkbot/hooks.ts

@@ -0,0 +1,14 @@
+import type { AGIContainer, Assistant } from "@soederpop/luca/agi"
+
+declare global {
+	var assistant: Assistant
+	var container: AGIContainer
+}
+
+export function started() {
+	assistant
+		// this will give it the ability to read documentation from the various feature
+		.use(container.describer)
+		// use the documentation from the various available skils
+		.use(container.feature('skillsLibrary'))
+}

package/assistants/inkbot/tools.ts

@@ -0,0 +1,47 @@
+import container from '@soederpop/luca/agi'
+import { z } from 'zod'
+
+export const schemas = {
+	README: z.object({}).describe('Call this tool first to learn how your canvas tools work.')
+}
+
+export function README() {
+	return README_CONTENT
+}
+
+const README_CONTENT = `
+# Inkbot Canvas Tools
+
+You have the following tools registered on you for controlling the canvas:
+
+## draw
+Write TypeScript code that runs as a bun subprocess. stdout appears in the canvas.
+- \`code\`: string — the TypeScript to execute
+- \`sceneId\`: string (optional) — defaults to "default"
+
+## create_scene
+Create a named scene without running it.
+- \`id\`: string — unique scene name
+- \`code\`: string — TypeScript code
+
+## run_scene
+Run an existing scene by id.
+- \`id\`: string
+
+## run_all
+Run every scene in order. Returns array of results.
+
+## activate_scene
+Switch the canvas to display a different scene.
+- \`id\`: string
+
+## get_canvas
+Returns the current canvas state: output, error, code, status, and scene list.
+
+## Tips
+- Use console.log() for output — that is what renders in the canvas.
+- If your code errors, you get stderr back. Fix it and draw again.
+- You can use ANSI escape codes for colors and formatting.
+- Scenes persist — update them with draw using the same sceneId.
+- You also have luca framework inspection tools (luca_describe, etc.) to look up APIs.
+`

package/bun.lock

@@ -10,7 +10,7 @@
         "@supabase/supabase-js": "^2.95.3",
         "@types/marked": "^6.0.0",
         "@types/marked-terminal": "^6.1.1",
-        "axios": "^1.3.5",
+        "axios": "1.13.6",
         "cacache": "^17.0.7",
         "chalk": "^5.2.0",
         "child-process-promise": "^2.2.1",
@@ -531,7 +531,7 @@
 
     "autoprefixer": ["autoprefixer@10.4.21", "", { "dependencies": { "browserslist": "^4.24.4", "caniuse-lite": "^1.0.30001702", "fraction.js": "^4.3.7", "normalize-range": "^0.1.2", "picocolors": "^1.1.1", "postcss-value-parser": "^4.2.0" }, "peerDependencies": { "postcss": "^8.1.0" }, "bin": { "autoprefixer": "bin/autoprefixer" } }, "sha512-O+A6LWV5LDHSJD3LjHYoNi4VLsj/Whi7k6zG12xTYaU4cQ8oxQGckXNX8cRHK5yOZ/ppVHe0ZBXGzSV9jXdVbQ=="],
 
-    "axios": ["axios@1.9.0", "", { "dependencies": { "follow-redirects": "^1.15.6", "form-data": "^4.0.0", "proxy-from-env": "^1.1.0" } }, "sha512-re4CqKTJaURpzbLHtIi6XpDv20/CnpXOtjRY5/CU32L8gU8ek9UIivcfvSWvmKEngmVbrUtPpdDwWDWL7DNHvg=="],
+    "axios": ["axios@1.13.6", "", { "dependencies": { "follow-redirects": "^1.15.11", "form-data": "^4.0.5", "proxy-from-env": "^1.1.0" } }, "sha512-ChTCHMouEe2kn713WHbQGcuYrr6fXTBiu460OTwWrWob16g1bXn4vtz07Ope7ewMozJAnEquLk5lWQWtBig9DQ=="],
 
     "bail": ["bail@2.0.2", "", {}, "sha512-0xO6mYd7JB2YesxDKplafRpsiOzPt9V02ddPCLbY1xYGPOX24NTyN50qnUxgCPcSoYMhKpAuBTjQoRZCAkUDRw=="],
 
@@ -911,11 +911,11 @@
 
     "flatted": ["flatted@3.3.3", "", {}, "sha512-GX+ysw4PBCz0PzosHDepZGANEuFCMLrnRTiEy9McGjmkCQYwRq4A/X786G/fjM/+OjsWSU1ZrY5qyARZmO/uwg=="],
 
-    "follow-redirects": ["follow-redirects@1.15.9", "", {}, "sha512-gew4GsXizNgdoRyqmyfMHyAmXsZDk6mHkSxZFCzW9gwlbtOW44CDtYavM+y+72qD/Vq2l550kMF52DT8fOLJqQ=="],
+    "follow-redirects": ["follow-redirects@1.15.11", "", {}, "sha512-deG2P0JfjrTxl50XGCDyfI97ZGVCxIpfKYmfyrQ54n5FO/0gfIES8C/Psl6kWVDolizcaaxZJnTS0QSMxvnsBQ=="],
 
     "foreground-child": ["foreground-child@3.3.1", "", { "dependencies": { "cross-spawn": "^7.0.6", "signal-exit": "^4.0.1" } }, "sha512-gIXjKqtFuWEgzFRJA9WCQeSJLZDjgJUOMCMzxtvFq/37KojM1BFGufqsCy0r4qSQmYLsZYMeyRqzIWOMup03sw=="],
 
-    "form-data": ["form-data@4.0.3", "", { "dependencies": { "asynckit": "^0.4.0", "combined-stream": "^1.0.8", "es-set-tostringtag": "^2.1.0", "hasown": "^2.0.2", "mime-types": "^2.1.12" } }, "sha512-qsITQPfmvMOSAdeyZ+12I1c+CKSstAFAwu+97zrnWAbIr5u8wfsExUzCesVLC8NgHuRUqNN4Zy6UPWUTRGslcA=="],
+    "form-data": ["form-data@4.0.5", "", { "dependencies": { "asynckit": "^0.4.0", "combined-stream": "^1.0.8", "es-set-tostringtag": "^2.1.0", "hasown": "^2.0.2", "mime-types": "^2.1.12" } }, "sha512-8RipRLol37bNs2bhoV67fiTEvdTrbMUYcFTiy3+wuuOnUog2QBHCZWXDRijWQfAkhBj2Uf5UnVaiWwA5vdd82w=="],
 
     "formdata-polyfill": ["formdata-polyfill@4.0.10", "", { "dependencies": { "fetch-blob": "^3.1.2" } }, "sha512-buewHzMvYL29jdeQTVILecSaZKnt/RJWjoZCF5OW60Z67/GmSLBkOFM7qh1PI3zFNtJbaZL5eQu1vLfazOwj4g=="],
 
@@ -1877,6 +1877,8 @@
 
     "@modelcontextprotocol/sdk/zod": ["zod@3.25.57", "", {}, "sha512-6tgzLuwVST5oLUxXTmBqoinKMd3JeesgbgseXeFasKKj8Q1FCZrHnbqJOyiEvr4cVAlbug+CgIsmJ8cl/pU5FA=="],
 
+    "@soederpop/luca/axios": ["axios@1.9.0", "", { "dependencies": { "follow-redirects": "^1.15.6", "form-data": "^4.0.0", "proxy-from-env": "^1.1.0" } }, "sha512-re4CqKTJaURpzbLHtIi6XpDv20/CnpXOtjRY5/CU32L8gU8ek9UIivcfvSWvmKEngmVbrUtPpdDwWDWL7DNHvg=="],
+
     "@soederpop/luca/chalk": ["chalk@5.6.2", "", {}, "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA=="],
 
     "@soederpop/luca/contentbase": ["contentbase@0.1.8", "", { "dependencies": { "@soederpop/luca": ">=0.0.16", "gray-matter": "^4.0.3", "js-yaml": "^4.1.0", "mdast-util-mdxjs-esm": "^2.0.1", "mdast-util-to-markdown": "^2.1.2", "mdast-util-to-string": "^4.0.0", "picomatch": "^4.0.3", "rehype-stringify": "^10.0.1", "remark-gfm": "^4.0.0", "remark-parse": "^11.0.0", "remark-rehype": "^11.1.2", "remark-stringify": "^11.0.0", "unified": "^11.0.5", "unist-util-find-after": "^5.0.0", "unist-util-find-all-after": "^5.0.0", "unist-util-find-all-before": "^5.0.0", "unist-util-find-before": "^4.0.0", "unist-util-select": "^5.1.0", "unist-util-visit": "^5.0.0", "zod": "^4.3.6" }, "bin": { "cnotes": "src/cli/index.ts", "contentbase": "src/cli/index.ts" } }, "sha512-FcivPrOkmowDea2FobSCHPmNdudQz90ZF5xwp2aDF5ajRXu1lujvzOXEvmwAZ9AcJC37BQHVNR0Ifa1guZaODw=="],
@@ -2065,6 +2067,8 @@
 
     "jest-matcher-utils/chalk": ["chalk@4.1.2", "", { "dependencies": { "ansi-styles": "^4.1.0", "supports-color": "^7.1.0" } }, "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA=="],
 
+    "jsdom/form-data": ["form-data@4.0.3", "", { "dependencies": { "asynckit": "^0.4.0", "combined-stream": "^1.0.8", "es-set-tostringtag": "^2.1.0", "hasown": "^2.0.2", "mime-types": "^2.1.12" } }, "sha512-qsITQPfmvMOSAdeyZ+12I1c+CKSstAFAwu+97zrnWAbIr5u8wfsExUzCesVLC8NgHuRUqNN4Zy6UPWUTRGslcA=="],
+
     "longest-line/strip-ansi": ["strip-ansi@3.0.1", "", { "dependencies": { "ansi-regex": "^2.0.0" } }, "sha512-VhumSSbBqDTP8p2ZLKj40UjBCV4+v8bUSEpUb4KjRgWk9pbqGF4REFj6KEagidb2f/M6AzC0EmFyDNGaw9OCzg=="],
 
     "marked-terminal/ansi-escapes": ["ansi-escapes@7.0.0", "", { "dependencies": { "environment": "^1.0.0" } }, "sha512-GdYO7a61mR0fOlAsvC9/rIHf7L96sBc6dEWzeOu+KAea5bZyQRPIpojrVoI4AXGJS/ycu/fBTdLrUkA4ODrvjw=="],
@@ -2333,6 +2337,10 @@
 
     "@modelcontextprotocol/sdk/express/type-is": ["type-is@2.0.1", "", { "dependencies": { "content-type": "^1.0.5", "media-typer": "^1.1.0", "mime-types": "^3.0.0" } }, "sha512-OZs6gsjF4vMp32qrCbiVSkrFmXtG/AZhY3t0iAMrMBiAZyV9oALtXO8hsrHbMXF9x6L3grlFuwW2oAz7cav+Gw=="],
 
+    "@soederpop/luca/axios/follow-redirects": ["follow-redirects@1.15.9", "", {}, "sha512-gew4GsXizNgdoRyqmyfMHyAmXsZDk6mHkSxZFCzW9gwlbtOW44CDtYavM+y+72qD/Vq2l550kMF52DT8fOLJqQ=="],
+
+    "@soederpop/luca/axios/form-data": ["form-data@4.0.3", "", { "dependencies": { "asynckit": "^0.4.0", "combined-stream": "^1.0.8", "es-set-tostringtag": "^2.1.0", "hasown": "^2.0.2", "mime-types": "^2.1.12" } }, "sha512-qsITQPfmvMOSAdeyZ+12I1c+CKSstAFAwu+97zrnWAbIr5u8wfsExUzCesVLC8NgHuRUqNN4Zy6UPWUTRGslcA=="],
+
     "@soederpop/luca/contentbase/mdast-util-to-markdown": ["mdast-util-to-markdown@2.1.2", "", { "dependencies": { "@types/mdast": "^4.0.0", "@types/unist": "^3.0.0", "longest-streak": "^3.0.0", "mdast-util-phrasing": "^4.0.0", "mdast-util-to-string": "^4.0.0", "micromark-util-classify-character": "^2.0.0", "micromark-util-decode-string": "^2.0.0", "unist-util-visit": "^5.0.0", "zwitch": "^2.0.0" } }, "sha512-xj68wMTvGXVOKonmog6LwyJKrYXZPvlwabaryTjLh9LuvovB/KAH+kvi8Gjj+7rJjsFi23nkUxRQv1KqSroMqA=="],
 
     "@soederpop/luca/contentbase/mdast-util-to-string": ["mdast-util-to-string@4.0.0", "", { "dependencies": { "@types/mdast": "^4.0.0" } }, "sha512-0H44vDimn51F0YwvxSJSm0eCDOJTRlmN0R1yBh4HLj9wiV1Dn0QoXGbvFAWj2hSItVTlCmBF1hqKlIyUBVFLPg=="],
@@ -2517,6 +2525,8 @@
 
     "jest-matcher-utils/chalk/ansi-styles": ["ansi-styles@4.3.0", "", { "dependencies": { "color-convert": "^2.0.1" } }, "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg=="],
 
+    "jsdom/form-data/mime-types": ["mime-types@2.1.35", "", { "dependencies": { "mime-db": "1.52.0" } }, "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw=="],
+
     "longest-line/strip-ansi/ansi-regex": ["ansi-regex@2.1.1", "", {}, "sha512-TIGnTpdo+E3+pCyAluZvtED5p5wCqLdezCyhPZzKPcxvFplEt4i+W7OONCKgeZFT3+y5NZZfOOS/Bdcanm1MYA=="],
 
     "mdast-util-from-markdown/micromark-util-decode-string/micromark-util-character": ["micromark-util-character@2.1.1", "", { "dependencies": { "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-wv8tdUTJ3thSFFFJKtpYKOYiGP2+v96Hvk4Tu8KpCAsTMs6yi+nVmGh1syvSCsaxz45J6Jbw+9DD6g97+NV67Q=="],
@@ -2631,6 +2641,8 @@
 
     "@modelcontextprotocol/sdk/express/type-is/media-typer": ["media-typer@1.1.0", "", {}, "sha512-aisnrDP4GNe06UcKFnV5bfMNPBUw4jsLGaWwWfnH3v02GnBuXX2MCVn5RbrWo0j3pczUilYblq7fQ7Nw2t5XKw=="],
 
+    "@soederpop/luca/axios/form-data/mime-types": ["mime-types@2.1.35", "", { "dependencies": { "mime-db": "1.52.0" } }, "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw=="],
+
     "@soederpop/luca/contentbase/mdast-util-to-markdown/@types/mdast": ["@types/mdast@4.0.4", "", { "dependencies": { "@types/unist": "*" } }, "sha512-kGaNbPh1k7AFzgpud/gMdvIm5xuECykRR+JnWKQno9TAXVa6WIVCGTPvYGekIDL4uwCZQSYbUxNBSb1aUo79oA=="],
 
     "@soederpop/luca/contentbase/mdast-util-to-markdown/@types/unist": ["@types/unist@3.0.3", "", {}, "sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q=="],
@@ -2733,6 +2745,8 @@
 
     "inquirer/ora/cli-cursor/restore-cursor": ["restore-cursor@3.1.0", "", { "dependencies": { "onetime": "^5.1.0", "signal-exit": "^3.0.2" } }, "sha512-l+sSefzHpj5qimhFSE5a8nufZYAM3sBSVMAPtYkmC+4EH2anSGaEMXSD0izRQbu9nfyQ9y5JrVmp7E8oZrUjvA=="],
 
+    "jsdom/form-data/mime-types/mime-db": ["mime-db@1.52.0", "", {}, "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg=="],
+
     "mdast-util-gfm-table/mdast-util-from-markdown/micromark/micromark-util-encode": ["micromark-util-encode@1.1.0", "", {}, "sha512-EuEzTWSTAj9PA5GOAs992GzNh2dGQO52UvAbtSOMvXTxv3Criqb6IOzJUBCmEqrrXSblJIJBbFFv6zPxpreiJw=="],
 
     "mdast-util-gfm-table/mdast-util-from-markdown/micromark/micromark-util-sanitize-uri": ["micromark-util-sanitize-uri@1.2.0", "", { "dependencies": { "micromark-util-character": "^1.0.0", "micromark-util-encode": "^1.0.0", "micromark-util-symbol": "^1.0.0" } }, "sha512-QO4GXv0XZfWey4pYFndLUKEAktKkG5kZTdUNaTAkzbuJxn2tNBOr+QtxR2XpWaMhbImT2dPzyLrPXLlPhph34A=="],
@@ -2783,6 +2797,8 @@
 
     "yargs/string-width/strip-ansi/ansi-regex": ["ansi-regex@5.0.1", "", {}, "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ=="],
 
+    "@soederpop/luca/axios/form-data/mime-types/mime-db": ["mime-db@1.52.0", "", {}, "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg=="],
+
     "@soederpop/luca/contentbase/mdast-util-to-markdown/mdast-util-phrasing/unist-util-is": ["unist-util-is@6.0.1", "", { "dependencies": { "@types/unist": "^3.0.0" } }, "sha512-LsiILbtBETkDz8I9p1dQ0uyRUWuaQzd/cuEeS1hoRSyW5E5XGmTzlwY1OrNzzakGowI9Dr/I8HVaw4hTtnxy8g=="],
 
     "@soederpop/luca/contentbase/mdast-util-to-markdown/micromark-util-decode-string/micromark-util-character": ["micromark-util-character@2.1.1", "", { "dependencies": { "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-wv8tdUTJ3thSFFFJKtpYKOYiGP2+v96Hvk4Tu8KpCAsTMs6yi+nVmGh1syvSCsaxz45J6Jbw+9DD6g97+NV67Q=="],