gipity 1.0.245 → 1.0.264

package/dist/prompts.js

@@ -13,11 +13,11 @@
  *  - Section headings are `## `, lists are `-` or `1.`.
  */
 export const SCAFFOLD_TYPES = [
-    { key: 'web-simple', for: 'Static page, canvas demo, visualization, physics toy, landing page, dashboard, single-page tool' },
-    { key: 'web-fullstack', for: 'Frontend + backend — needs DB or serverless functions' },
-    { key: '2d-game', for: 'Phaser platformer / arcade / puzzle / endless runner' },
-    { key: '3d-world', for: 'Three.js + Rapier + Colyseus multiplayer world' },
-    { key: 'api', for: 'API only, no frontend' },
+    { key: 'web-simple', for: 'Landing page, dashboard, calculator, canvas demo, visualization, animation, single-page tool' },
+    { key: 'web-fullstack', for: 'Web app with login, database, or API — CRM, invoice tracker, booking system, admin panel' },
+    { key: '2d-game', for: 'Platformer, arcade, puzzle, endless runner, physics toy (Phaser 3)' },
+    { key: '3d-world', for: 'Multiplayer world, 3D sandbox, shooter, exploration, virtual showroom (Three.js + Rapier + Colyseus)' },
+    { key: 'api', for: 'Backend service, webhook, data pipeline, chatbot, cron job — no frontend' },
 ];
 export const SCAFFOLD_TYPE_KEYS = SCAFFOLD_TYPES.map(t => t.key).join('|');
 export const SCAFFOLD_TYPE_PICKER = SCAFFOLD_TYPES
@@ -27,44 +27,60 @@ export const SCAFFOLD_TYPE_PICKER = SCAFFOLD_TYPES
 // Single source of truth for the build-vs-non-build rule.
 // ---------------------------------------------------------------------------
 export const BUILD_VS_NON_BUILD_RULE = [
-    `## Build vs. one-off`,
-    `Build request (deployable — web app, game, API): run \`gipity scaffold --type <type>\` before writing any files. Scaffolding wires up \`gipity.yaml\`, deploy config, and sync; hand-written files miss all of it. Pick the type:`,
+    `## When to scaffold`,
+    `If the user wants a deployable app (web, game, API): run \`gipity scaffold --type <type>\` before writing any files. Scaffolding wires up \`gipity.yaml\`, deploy config, and sync; hand-written files miss all of it.`,
+    `If it's a one-off task (analysis, media, data, research): skip scaffolding — use \`gipity sandbox run\` or work with files directly.`,
+    `If ambiguous: ask one short clarifying question.`,
+    ``,
+    `Scaffold types:`,
     SCAFFOLD_TYPE_PICKER,
     `When unsure, default to \`web-simple\`. After scaffolding, edit the generated files, then \`gipity deploy dev\`.`,
-    ``,
-    `One-off task (PDF analysis, data exploration, media/document work, research, scratch): do not scaffold. Use \`gipity sandbox run\` for compute, or work with files directly.`,
-    ``,
-    `If ambiguous, ask one short clarifying question. Only skip scaffolding on a build request if the user explicitly says "don't scaffold".`,
+    `Only skip scaffolding on a build request if the user explicitly says "don't scaffold".`,
 ].join('\n');
 export const DEFINITION_OF_DONE = [
     `## Definition of done (build tasks)`,
     `1. \`gipity deploy dev\` succeeds and you have a live URL.`,
-    `2. \`gipity browser <url>\` shows no console errors and the golden path works.`,
+    `2. \`gipity page-inspect <url>\` returns no console errors and the page loads (HTTP 200, no blank screen).`,
     `3. For apps with functions: \`gipity test\` passes.`,
     `4. You told the user the live URL.`,
     ``,
     `If any step fails, fix it before claiming done — do not report success on a broken deploy.`,
 ].join('\n');
-export const CAPABILITIES_BLURB_SHORT = `Gipity gives this session: cloud hosting, Postgres, serverless functions, a sandboxed toolkit ` +
-    `(ffmpeg, ImageMagick, pandas, pandoc, LibreOffice, etc.), headless browsers, file storage, email, ` +
-    `image/TTS/video generation, web search, scheduled workflows, persistent memory, custom domains. ` +
-    `Full reference is in CLAUDE.md. Prefer CLI commands and the sandbox over \`gipity chat\` — they're ` +
-    `faster and don't burn LLM tokens. Naming: honor the user's chosen name; if inventing, blend "Gip" or "Gipity" in.`;
+export const CAPABILITIES_BLURB_SHORT = `Full platform reference is in CLAUDE.md. ` +
+    `Prefer CLI commands and the sandbox over \`gipity chat\` — they're faster and cheaper. ` +
+    `Naming: honor the user's chosen name; if inventing, blend "Gip" or "Gipity" in.`;
+function humanBytes(n) {
+    if (n < 1024)
+        return `${n} B`;
+    if (n < 1024 * 1024)
+        return `${(n / 1024).toFixed(1)} KB`;
+    if (n < 1024 * 1024 * 1024)
+        return `${(n / 1024 / 1024).toFixed(1)} MB`;
+    return `${(n / 1024 / 1024 / 1024).toFixed(2)} GB`;
+}
 function buildHeader(opts) {
     const deployUrl = opts.accountSlug
         ? `https://dev.gipity.ai/${opts.accountSlug}/${opts.projectSlug}/`
         : '(not yet deployed)';
-    const entryLabel = opts.fileCount === 1 ? 'entry' : 'entries';
+    // "Files" line is the agent's at-a-glance signal of project size and
+    // shape. Counts are recursive (from the VFS DB), not just top-level —
+    // prevents the bug where a scaffolded project with everything under
+    // `src/` showed as "1 top-level entry (src/)" and looked nearly empty.
+    const filesLine = opts.fileCount === 0
+        ? `- Files: empty (no files yet)`
+        : `- Files: ${opts.fileCount} file${opts.fileCount === 1 ? '' : 's'}` +
+            ` in ${opts.folderCount} folder${opts.folderCount === 1 ? '' : 's'}` +
+            ` (${humanBytes(opts.totalBytes)}) — ${opts.topLevel}`;
     return [
         `## Gipity project`,
         `- Name: ${opts.projectName} (slug: \`${opts.projectSlug}\`)`,
-        `- GUID: \`${opts.projectGuid}\` — use as \`<PROJECT_GUID>\` in App Services calls`,
+        `- Project GUID: \`${opts.projectGuid}\` (use as \`<PROJECT_GUID>\` in service calls)`,
         `- Directory: ${opts.cwd}`,
         `- Deploy URL: ${deployUrl}`,
-        `- Files: ${opts.fileCount} top-level ${entryLabel}${opts.fileCount > 0 ? ` (${opts.contents})` : ''}`,
+        filesLine,
     ].join('\n');
 }
-const EMPTY_STATE_NOTE = `Directory is empty. Apply the build-vs-one-off rule above before writing any files.`;
+const EMPTY_STATE_NOTE = `Directory is empty. Apply the scaffolding rule above before writing any files.`;
 const EXISTING_STATE_NOTE = [
     `Project already has files. Before making changes:`,
     `- Read \`README.md\` / \`gipity.yaml\` if present to understand what's here.`,
@@ -72,7 +88,13 @@ const EXISTING_STATE_NOTE = [
     `- Edit in place. Don't re-scaffold over an existing app.`,
     `- Exception: if the existing files are user content (media, data, notes) and the user wants to build an app around them, scaffolding is allowed — \`gipity scaffold\` will refuse automatically if any file paths would collide.`,
 ].join('\n');
-/** Compact project-context preamble — header + capabilities + build rule + state note + definition of done. */
+/** Compact project-context preamble — header + capabilities + state note + definition of done.
+ *  The BUILD_VS_NON_BUILD_RULE (scaffold picker, scaffold types, default
+ *  recommendations) only fires for empty projects. An existing project
+ *  that already has a scaffold doesn't need to be told to pick a scaffold
+ *  type — that guidance conflicts with EXISTING_STATE_NOTE's "edit in
+ *  place, don't re-scaffold" and led to agents re-scaffolding over live
+ *  projects. */
 export function buildProjectContextBlock(opts) {
     const isEmpty = opts.fileCount === 0;
     return [
@@ -81,12 +103,12 @@ export function buildProjectContextBlock(opts) {
         `## Session`,
         `You're pairing with the user on this project. ${CAPABILITIES_BLURB_SHORT}`,
         ``,
-        BUILD_VS_NON_BUILD_RULE,
+        isEmpty ? BUILD_VS_NON_BUILD_RULE : EXISTING_STATE_NOTE,
         ``,
-        isEmpty ? EMPTY_STATE_NOTE : EXISTING_STATE_NOTE,
+        isEmpty ? EMPTY_STATE_NOTE : '',
         ``,
         DEFINITION_OF_DONE,
-    ].join('\n');
+    ].join('\n').replace(/\n{3,}/g, '\n\n');
 }
 /** Project-context block + a brief greeting instruction. */
 export function buildExistingProjectPrompt(opts) {
@@ -100,7 +122,7 @@ export function buildExistingProjectPrompt(opts) {
 export function buildNewProjectPrompt(opts) {
     const base = buildProjectContextBlock(opts);
     if (opts.buildIdea) {
-        return `${base}\n\nThe user's first message: "${opts.buildIdea}"\n\nGet started. Apply the build-vs-one-off rule. Report back when you hit the definition of done.`;
+        return `${base}\n\nThe user's first message: "${opts.buildIdea}"\n\nGet started. Apply the scaffolding rule. Report back when you hit the definition of done.`;
     }
     return `${base}\n\nThe user started a blank project with no specific request. Briefly introduce yourself, highlight a few key capabilities, and ask what they want to build.`;
 }
@@ -109,20 +131,20 @@ export function buildNewProjectPrompt(opts) {
 // ---------------------------------------------------------------------------
 /** Compact capability reminder — safe to include on every resumed-session message.
  *  Hedges against Claude compacting away the original context block mid-session. */
-export const PLATFORM_REMINDER = `This project runs on the Gipity hosting platform. The \`gipity\` CLI exposes 90+ tools — common ones: ` +
-    `\`gipity deploy dev\`, \`gipity browser <url>\`, \`gipity sandbox run\`, \`gipity test\`, \`gipity fn call\`. ` +
-    `Run \`gipity skills list\` for the full skill catalog; full platform reference is in \`CLAUDE.md\`.`;
-/** Resume wrap: header + capability reminder + short framing. */
+export const PLATFORM_REMINDER = `This project runs on the Gipity platform. All CLI commands and service APIs are documented in CLAUDE.md.`;
+/** Resume wrap: compact header + capability reminder + short framing.
+ *  Takes identity only — resume doesn't need the full file stats
+ *  (Claude already has the context from the initial start dispatch). */
 export function buildResumeWrap(opts, userMsg) {
+    const deployUrl = opts.accountSlug
+        ? `https://dev.gipity.ai/${opts.accountSlug}/${opts.projectSlug}/`
+        : '(not yet deployed)';
     return [
-        buildHeader(opts),
-        ``,
+        `Project: ${opts.projectName} (\`${opts.projectGuid}\`) — ${deployUrl}`,
         PLATFORM_REMINDER,
-        `Resumed session — apply the build-vs-one-off rule for new features; files auto-sync on save.`,
+        `Resumed session — scaffold before building (see CLAUDE.md); skip for one-off tasks.`,
         ``,
         `User message: ${userMsg}`,
-        ``,
-        `Answer directly. Do not greet or reintroduce yourself.`,
     ].join('\n');
 }
 /** Fresh wrap: full project context + the user's message. */
@@ -143,208 +165,48 @@ export const SKILLS_CONTENT = `# Gipity Integration
 
 Gipity is a platform for cloud agents — AI agents that run on a server with persistent memory, storage, a database, a sandboxed runtime, and direct internet access. Gip is the cloud agent on Gipity.
 
-This Claude Code session is connected to a Gipity project. You have four ways to use the platform — try them in this order before falling back to \`gipity chat\`:
-
-1. CLI commands (fast, no agent overhead). The \`gipity\` CLI exposes ~30 commands covering scaffold/deploy/db/fn/logs/browser/sync/memory/skills/etc. Use these whenever possible.
-2. Cloud sandbox via \`gipity sandbox run\` (fast, no agent overhead, no deploy needed). The sandbox is a Docker container with a huge pre-installed toolkit — use it for any one-off media, data, or build task instead of delegating to Gip:
-   - Media: \`ffmpeg\` (transcode, trim, concat, extract audio, generate thumbnails, splice video), \`ImageMagick\` (resize, convert, composite, OCR-friendly preprocess), \`sox\` (audio mix/normalize/effects), \`exiftool\`, \`mediainfo\`, \`optipng\`, \`gifsicle\`, \`webp\`, \`potrace\` (raster→SVG)
-   - Documents: \`pandoc\` (any-to-any docs), \`LibreOffice\` headless (DOCX/XLSX/PPTX↔PDF), \`wkhtmltopdf\`, \`poppler-utils\` (PDF text/image extract), \`ghostscript\`, \`qpdf\`, \`python-docx\`, \`python-pptx\`, \`openpyxl\`, \`reportlab\`, \`cairosvg\`
-   - Data / analysis: Python with \`pandas\`, \`numpy\`, \`scipy\`, \`sympy\`, \`matplotlib\`, \`seaborn\`, \`pillow\`, \`bs4\`, \`requests\`, \`pyyaml\`, \`jinja2\`, \`tabulate\`, plus \`csvkit\`, \`miller\`, \`datamash\`, \`jq\`, \`xmlstarlet\`, \`sqlite3\`
-   - Misc: \`Graphviz\`, \`gnuplot\`, \`qrcode\`, \`p7zip\`, \`GCC/G++\`, \`Rust\` (rustc/cargo), \`mingw-w64\` (Windows cross-compile)
-   - Languages: Node 20, Python 3, Bash. Workspace files are auto-injected; output files auto-extract back to the project. Sticky session per user (state persists across calls). No network from inside the sandbox — fetch what you need before sending it in.
+This Claude Code session is connected to a Gipity project. Prefer the cheapest option that works — CLI and sandbox are instant and free, app services are runtime HTTP calls, \`gipity chat\` burns LLM tokens:
 
-   Examples:
-   \`\`\`bash
-   gipity sandbox run --lang bash "ffmpeg -i input.mp4 -vf scale=640:-1 -c:a copy out.mp4"
-   gipity sandbox run --lang bash "convert input.png -resize 200x200 thumb.jpg"   # ImageMagick
-   gipity sandbox run --lang py   "import pandas as pd; print(pd.read_csv('sales.csv').groupby('region').total.sum())"
-   gipity sandbox run --lang bash "libreoffice --headless --convert-to pdf report.docx"
-   gipity sandbox run --lang bash "pandoc article.md -o article.pdf"
-   \`\`\`
-3. Call app services directly from your app (no agent overhead, runtime endpoints). LLM, TTS, image, sound, music, transcription, video, file upload, and realtime multiplayer are HTTP endpoints under \`https://a.gipity.ai/api/<PROJECT_GUID>/services/*\` — see the app services section below. These are for the deployed app to call at runtime; for one-off generation during development, prefer \`gipity generate <image|video|...>\` or \`gipity chat\`.
-4. Delegate to Gip (\`gipity chat "<task>"\`) — only when the work genuinely needs agent reasoning or a tool that isn't in the CLI, the sandbox, or the app services. Required for: Twitter/X search, Gmail, calendar operations, push notifications, video understanding, audio source isolation, cross-model second opinions, multi-step orchestration. Don't use \`gipity chat\` to run ffmpeg, ImageMagick, pandas, LibreOffice, pandoc, or anything else listed in the sandbox toolkit above — \`gipity sandbox run\` is faster and doesn't burn tokens.
+1. CLI commands (fast, no agent overhead). The \`gipity\` CLI covers scaffold, deploy, db, fn, logs, browser, sync, memory, skills, and more. Run \`gipity --help\` for the full list. All commands support \`--json\`.
+2. Cloud sandbox via \`gipity sandbox run\` — Docker container with pre-installed tools for media (ffmpeg, ImageMagick, sox), documents (pandoc, LibreOffice), and data (pandas, matplotlib, sqlite3). Run \`gipity skills read sandbox-tools\` for the full toolkit. No network from inside the sandbox — fetch what you need before sending it in.
+3. App services — runtime HTTP endpoints your deployed app calls directly at \`https://a.gipity.ai/api/<PROJECT_GUID>/services/*\`. Available: LLM, TTS, image, sound, music, transcribe, video, file upload, realtime. Load the matching skill (\`app-llm\`, \`app-tts\`, etc.) before writing service code — they have the schemas, auth pattern, and common-mistake guards. For one-off generation during development, prefer \`gipity generate <image|video|...>\` or \`gipity chat\`.
+4. Delegate to Gip (\`gipity chat "<task>"\`) — only when the work genuinely needs agent reasoning or a tool not in the CLI, sandbox, or app services. Required for: Twitter/X search, Gmail, calendar, push notifications, video understanding, audio source isolation, cross-model second opinions, multi-step orchestration. Don't use \`gipity chat\` for anything the sandbox can do — it's slower and burns tokens.
 
 You are the developer. Write files in this directory — they auto-sync to Gipity via hooks. Don't run \`npm install\`, \`npm start\`, \`node\`, or \`python\` locally; there is no local runtime. Code runs in the Gipity sandbox.
 
-## Build vs. one-off
-
-The full build-vs-one-off rule and definition of done are injected at the top of every session context. In short: if the user asks you to build something deployable (web app, game, API), run \`gipity scaffold --type <type>\` first (default \`web-simple\`); if it's a one-off task (analysis, PDFs, data work), use \`gipity sandbox run\` — do not scaffold.
-
-## Remote control
-
-This session can be driven from the Gipity web CLI on any browser (desktop or phone). The first \`gipity claude\` run on this machine pairs the device and starts the relay daemon automatically. Once paired, typing \`/claude\` (or \`/cc\`) in the web CLI enters dispatch mode; each message queues a new \`gipity claude -p "…"\` session here and streams the captured conversation back to their browser. If the user asks how to use Gipity from their phone or another browser, point them at \`gipity relay --help\`.
-
-## Workflow
-
-1. Write and edit files normally (auto-pushed to Gipity on every save)
-2. \`gipity deploy dev\` → live URL instantly
-3. \`gipity deploy prod\` when ready
-
-## CLI commands
-
-| Command | Purpose |
-|---------|---------|
-| \`gipity scaffold [title]\` | Create app structure. \`--type\` is required. Canonical types: \`${SCAFFOLD_TYPE_KEYS}\`. Run \`gipity scaffold --help\` for the full list. |
-| \`gipity deploy [dev\\|prod]\` | Deploy and get live URL |
-| \`gipity sync [up\\|down\\|check]\` | Manual file sync |
-| \`gipity db create <name>\` | Create a project database |
-| \`gipity db drop <name> [--project <slug>]\` | Drop a database (--project for cross-project) |
-| \`gipity db query "SQL"\` | Run SQL on project database |
-| \`gipity db list [--all]\` | List databases (--all for account-wide) |
-| \`gipity fn list\\|call <name> [body]\\|logs <name>\` | Manage serverless functions |
-| \`gipity memory list\\|read\\|write\` | Persistent key-value memory |
-| \`gipity browser <url>\` | Inspect URL: console errors, timing, resources |
-| \`gipity logs fn <name>\` | View function execution logs |
-| \`gipity sandbox <lang> "code"\` | Execute code in cloud sandbox |
-| \`gipity location [ip\\|lat lng]\` | IP geo / reverse-geocode / caller location |
-| \`gipity chat <message>\` | Send a task to the Gipity agent |
-| \`gipity skills list\` | List all available skill docs |
-| \`gipity skills read <name>\` | Read detailed docs on a topic |
-| \`gipity status\` | Check project and auth status (project GUID, slug, auth state) |
-
-All commands support \`--json\` for structured output. Use \`--help\` on any command for details (auto-fetches relevant skill docs from the server).
+## When to scaffold
 
-## Platform capabilities
+The full scaffolding rule and definition of done are injected at the top of every session context. In short: if the user asks you to build something deployable (web app, game, API), run \`gipity scaffold --type <type>\` first (default \`web-simple\`); if it's a one-off task (analysis, PDFs, data work), use \`gipity sandbox run\` — do not scaffold.
 
-- App hosting — deploy to dev/prod URLs on Gipity CDN
-- Databases — per-project PostgreSQL databases with SQL access
-- Serverless functions — JavaScript functions callable via REST
-- Multiplayer — Colyseus WebSocket rooms (relay and state-synced)
-- Image generation — OpenAI (gpt-image-1, DALL-E 3) and BFL/Flux
-- Speech / TTS — ElevenLabs and OpenAI voices
-- Audio/video processing — FFmpeg, sox, transcription, source isolation
-- Web search — Brave API
-- Browser automation — open URLs, screenshot, click, fill forms, console
-- Workflows — cron or webhook-triggered multi-step AI pipelines
-- Email — SendGrid transactional email
-- Cloud sandbox — Python, Node.js, Bash with 50+ pre-installed tools
-- Cross-model queries — ask GPT-5, Claude, etc. for second opinions
+## CLI quick reference
 
-## App services (HTTP endpoints your deployed app can call)
+Key commands: \`gipity scaffold --type <type>\`, \`gipity deploy dev\`, \`gipity sandbox run\`, \`gipity page-inspect <url>\`, \`gipity db query "SQL"\`, \`gipity fn call <name>\`, \`gipity skills read <name>\`.
+Run \`gipity --help\` for the full list. Use \`--help\` on any command for details.
 
-Every project automatically exposes platform services at \`https://a.gipity.ai/api/<PROJECT_GUID>/services/*\`. Your frontend or function calls these directly — don't write a server-side wrapper function for them, and don't fall back to browser APIs (e.g. \`window.speechSynthesis\`). Billing defaults to your credits (\`owner_pays\`); no setup needed.
+## Files and sync
 
-Your \`<PROJECT_GUID>\` is printed in the session context header on every launch, and also via \`gipity status --json\`.
+Write files locally — hooks auto-push to Gipity on every save. Remote-generated files (images, audio from \`gipity chat\`) auto-pull. Use \`gipity sync\` if things get out of sync. Deletes are safe — use \`rollback\` with a datetime to undo, or \`file_version_restore\` for individual files.
 
-| Service | Endpoint | Purpose |
-|---------|----------|---------|
-| LLM | \`POST /services/llm\` | OpenAI-style chat completions (Anthropic + OpenAI models, streaming) |
-| TTS | \`POST /services/tts\` | Text-to-speech → MP3 URL (ElevenLabs/OpenAI/Gemini) |
-| Image | \`POST /services/image\` | Image generation (OpenAI/BFL/Gemini) |
-| Sound effects | \`POST /services/sound\` | ElevenLabs SFX from text |
-| Music | \`POST /services/music\` | ElevenLabs music from prompt |
-| Transcribe (STT) | \`POST /services/transcribe\` | Multipart audio → text |
-| Video | \`POST /services/video\` | Veo 3.1 video with audio |
-| Files | \`POST /uploads/init\` + \`/uploads/complete\` | Presigned S3 uploads up to 30 GB |
-| Realtime | \`wss://rt.gipity.ai\` | Colyseus rooms (relay or state) |
+## Skills (detailed documentation)
 
-### Universal auth — mint an app token
+Run \`gipity skills list\` to see all available skill docs. Run \`gipity skills read <name>\` to read one. Load the relevant skill before starting a task — they contain the correct API patterns, code examples, and common mistakes.
 
-\`\`\`js
-const r = await fetch('https://a.gipity.ai/api/token', {  // must be absolute URL, POST
-  method: 'POST',
-  headers: { 'Content-Type': 'application/json' },
-  body: JSON.stringify({ app: '<PROJECT_GUID>' })
-});
-const { data: { token } } = await r.json();              // token is at .data.token
-\`\`\`
-Send on every service call as \`X-App-Token: <token>\`. For \`auth: user\` functions or \`user_pays\` services also pass \`credentials: 'include'\` so the \`.gipity.ai\` session cookie travels.
-
-Common mistakes the agent should avoid:
-- Relative URL \`/api/token\` (hits app host, 404) — always absolute \`https://a.gipity.ai/api/token\`
-- Reading \`json.token\` instead of \`json.data.token\`
-- Treating the project GUID as the bearer token
-- Writing a server-side TTS \`speak\` function or a \`useBrowserTts\` fallback — just call \`/services/tts\` from the browser and \`new Audio(url).play()\`
-- Calling \`client.getAvailableRooms()\` for realtime — that method doesn't exist; use \`GET https://rt.gipity.ai/rooms?room=<name>&token=<t>\`
-
-### Quick examples
-
-LLM:
-\`\`\`js
-const r = await fetch(\`https://a.gipity.ai/api/\${APP}/services/llm\`, {
-  method: 'POST',
-  headers: { 'Content-Type': 'application/json', 'X-App-Token': token },
-  body: JSON.stringify({ messages: [{ role: 'user', content: 'Hi' }], model: 'gpt-5-mini' })
-});
-const { choices } = await r.json();
-// choices[0].message.content
-\`\`\`
-
-TTS:
-\`\`\`js
-const r = await fetch(\`https://a.gipity.ai/api/\${APP}/services/tts\`, {
-  method: 'POST',
-  headers: { 'Content-Type': 'application/json', 'X-App-Token': token },
-  body: JSON.stringify({ text: 'Hello world', provider: 'elevenlabs' })
-});
-const { url } = await r.json();
-new Audio(url).play();
-\`\`\`
-
-Transcribe:
-\`\`\`js
-const fd = new FormData();
-fd.append('audio', file);                    // mp3/wav/m4a, up to 100MB
-fd.append('diarize', 'true');                // optional
-const r = await fetch(\`https://a.gipity.ai/api/\${APP}/services/transcribe\`, {
-  method: 'POST',
-  headers: { 'X-App-Token': token },         // do not set Content-Type for FormData
-  body: fd
-});
-const { text } = await r.json();
-\`\`\`
-
-File upload (helper script handles progress + multipart for 5GB+ files):
-\`\`\`html
-<script src="https://media.gipity.ai/scripts/gipity-upload.js"></script>
-<script>
-  const result = await Gipity.upload(file, { appGuid: '<PROJECT_GUID>', appToken: token });
-  // result.url, result.guid
-</script>
-\`\`\`
-
-For full request/response schemas, parameters, error codes, and edge cases (streaming, image input, multi-speaker TTS, Veo aspect ratios, multipart uploads, popup auth flow, Colyseus room safety patterns), load the matching skill before writing code.
-
-## Detailed documentation
-
-Run \`gipity skills list\` to see all available skill docs. Run \`gipity skills read <name>\` to read one.
-
-App services skills (load before calling \`/services/*\` endpoints — they contain the canonical request/response schemas, examples, and common-mistake guards):
-
-- \`app-llm\` — \`/services/llm\` (chat completions, streaming, image input, model list)
-- \`app-tts\` — \`/services/tts\` (voices, multi-speaker Gemini, languages)
-- \`app-image\` — \`/services/image\` (providers, sizes, aspect ratios)
-- \`app-audio\` — \`/services/sound\`, \`/services/music\`, \`/services/transcribe\`
-- \`app-video\` — \`/services/video\` (Veo models, aspect, resolution)
-- \`app-files\` — \`/uploads/init\`+\`/uploads/complete\`, \`gipity-upload.js\` helper, variants, file listing
-- \`app-auth\` — sign in with Gipity, popup vs redirect, \`auth/status\`, error codes
-- \`app-realtime\` — Colyseus rooms (relay vs state), \`MapSchema\` init guard, room discovery
+App services skills (load before calling \`/services/*\` endpoints):
+- \`app-llm\` — chat completions, streaming, image input
+- \`app-tts\` — voices, multi-speaker, languages
+- \`app-image\` — providers, sizes, aspect ratios
+- \`app-audio\` — sound effects, music, transcription
+- \`app-video\` — Veo models, aspect, resolution
+- \`app-files\` — uploads, variants, file listing
+- \`app-auth\` — sign in with Gipity, popup vs redirect
+- \`app-realtime\` — Colyseus rooms, relay vs state
 
 Other key skills:
-
 - \`web-app-basics\` — coding guidelines, file structure, HTML/CSS/JS patterns
-- \`app-development\` — functions, database & API (write functions → deploy → test → call via REST)
+- \`app-development\` — functions, database and API
 - \`3d-world\` — 3D multiplayer game template (Three.js + Rapier + Colyseus)
 - \`2d-game\` — 2D game template (Phaser 3)
 - \`sandbox-tools\` — cloud sandbox capabilities and pre-installed tools
-- \`tts-guide\` — agent-side speech tools (\`speech_generate\`, \`voice_set\`, sound/music) — different from the \`app-tts\` HTTP service
-
-Load the relevant skill before starting a task — they contain the correct API patterns, code examples, and common mistakes.
-
-## File operations
-
-All file creation and editing should happen locally — hooks auto-push changes to Gipity. Don't use \`gipity chat\` to create or edit files. Use \`gipity sync\` if files get out of sync. Files generated remotely by \`gipity chat\` (images, audio, etc.) also sync down automatically and can be referenced in your code like any local file.
-
-## Authentication
-
-1. \`gipity login --email user@example.com\` → sends a 6-digit code
-2. \`gipity login --email user@example.com --code 123456\`
-
-## Sync behavior
-
-- Auto-push — files push to Gipity after every Write/Edit (hook)
-- Auto-pull — remote changes pull before each prompt (hook)
-- Tool-generated files sync too — images, audio, and other files created by \`gipity chat\` or remote agent tools auto-pull like any other
-- Deletes are safe — use \`rollback\` with a datetime to undo, or \`file_version_restore\` for individual files
+- \`tts-guide\` — agent-side speech tools (different from the \`app-tts\` HTTP service)
 `;
 //# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"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"}

package/dist/relay/daemon.d.ts

@@ -15,9 +15,33 @@ export interface DaemonOptions {
     verbose?: boolean;
 }
 export declare function run(opts?: DaemonOptions): Promise<number>;
-/** Spawn `gipity claude …` in `cwd`. Inherits stdio so the child's
- *  stream-json flows to our stdout (which launchd/systemd captures).
- *  `GIPITY_CONVERSATION_GUID` is passed to the child so every capture
- *  hook tags events with the right conv. Injectable via
- *  GIPITY_RELAY_CLAUDE_CMD env for tests. */
-export declare function spawnGipityClaude(args: string[], cwd: string, convGuid: string): Promise<number>;
+interface ClaimedDispatch {
+    short_guid: string;
+    kind: 'start' | 'resume';
+    remote_session_id: string | null;
+    message: string;
+    project_guid: string;
+    project_slug: string;
+    account_slug: string;
+    /** Server-assigned conv guid. We pass it as GIPITY_CONVERSATION_GUID
+     *  to the spawned `gipity claude` so every capture hook tags events
+     *  with it — no placeholder adoption needed. */
+    conversation_guid: string;
+    agent_guid: string | null;
+}
+export declare function getRunningDispatchGuids(): string[];
+export declare function getRunningConvGuids(): string[];
+/** SIGTERM any running child whose conv_guid matches, then wait for each
+ *  to fully unwind (exit event fires, handleDispatch acks + posts
+ *  cancelled marker). Used at the top of handleDispatch so a new message
+ *  for a busy conv cleanly replaces the in-flight one. No-op if no child
+ *  matches. */
+export declare function killRunningForConv(convGuid: string): Promise<void>;
+export declare function spawnGipityClaude(args: string[], cwd: string, d: ClaimedDispatch): Promise<{
+    exitCode: number;
+    killed: boolean;
+}>;
+/** SIGTERM a specific running dispatch. Returns true if one was killed,
+ *  false if no such child was running on this daemon. */
+export declare function killDispatch(shortGuid: string): boolean;
+export {};