gipity 1.1.15 → 1.1.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (60) hide show
  1. package/README.md +58 -75
  2. package/dist/adopt-cwd.js +2 -13
  3. package/dist/agents/opencode.js +13 -2
  4. package/dist/api.js +26 -44
  5. package/dist/auth.js +1 -1
  6. package/dist/banner.js +3 -7
  7. package/dist/catalog.js +8 -7
  8. package/dist/commands/add.js +26 -9
  9. package/dist/commands/approval.js +1 -1
  10. package/dist/commands/ask.js +112 -0
  11. package/dist/commands/bug.js +5 -5
  12. package/dist/commands/build.js +10 -35
  13. package/dist/commands/credits.js +3 -3
  14. package/dist/commands/doctor.js +7 -8
  15. package/dist/commands/email.js +6 -56
  16. package/dist/commands/generate.js +4 -4
  17. package/dist/commands/init.js +40 -30
  18. package/dist/commands/key.js +1 -1
  19. package/dist/commands/load.js +2 -12
  20. package/dist/commands/logs.js +2 -2
  21. package/dist/commands/memory.js +5 -17
  22. package/dist/commands/notify.js +1 -1
  23. package/dist/commands/page-eval.js +55 -38
  24. package/dist/commands/page-inspect.js +6 -6
  25. package/dist/commands/page-screenshot.js +51 -54
  26. package/dist/commands/page-test.js +188 -14
  27. package/dist/commands/payments.js +2 -2
  28. package/dist/commands/project.js +66 -15
  29. package/dist/commands/realtime.js +96 -4
  30. package/dist/commands/records.js +4 -6
  31. package/dist/commands/sandbox.js +2 -3
  32. package/dist/commands/skill.js +50 -22
  33. package/dist/commands/status.js +7 -9
  34. package/dist/commands/test.js +2 -2
  35. package/dist/commands/token.js +4 -4
  36. package/dist/commands/workflow.js +45 -8
  37. package/dist/config.js +22 -6
  38. package/dist/flag-aliases.js +75 -18
  39. package/dist/help-skills.js +2 -2
  40. package/dist/hooks/capture-runner.js +5 -3
  41. package/dist/index.js +1618 -1500
  42. package/dist/knowledge.js +24 -21
  43. package/dist/login-flow.js +4 -4
  44. package/dist/net.js +91 -0
  45. package/dist/opencode-setup.js +2 -2
  46. package/dist/page-fixtures.js +3 -3
  47. package/dist/project-setup.js +2 -3
  48. package/dist/prompts.js +1 -1
  49. package/dist/realtime-bench.js +12040 -0
  50. package/dist/relay/agent-token.js +1 -1
  51. package/dist/relay/daemon.js +0 -1
  52. package/dist/relay/setup.js +13 -2
  53. package/dist/setup.js +11 -12
  54. package/dist/sync.js +3 -3
  55. package/dist/utils.js +1 -1
  56. package/package.json +10 -4
  57. package/dist/commands/agent.js +0 -251
  58. package/dist/commands/chat.js +0 -137
  59. package/dist/commands/claude.js +0 -1056
  60. package/dist/commands/plan.js +0 -93
package/README.md CHANGED
@@ -1,14 +1,14 @@
1
1
  # Gipity CLI
2
2
 
3
- The full-stack platform tuned for AI agents.
3
+ The cloud backend for your coding agent.
4
4
 
5
- [Gipity](https://gipity.ai) is the platform: hosting, databases, file storage, deployment, workflows, code execution, and monitoring. Agent-tuned from idea to deploy. Use standalone, or pair with your coding agent - Claude Code, Codex, or Grok - to give it cloud superpowers. Any model, any infra, always your code.
5
+ [Gipity](https://gipity.ai) is the backend your coding agent gets by installing one CLI and one skill: hosting, databases, serverless functions, file storage, a code sandbox, CPU/GPU jobs, AI models and media services, workflows, and a quick LLM call (`gipity ask`), plus templates and kits that give you a running start.
6
6
 
7
- This CLI connects your coding agent - [Claude Code](https://claude.ai/claude-code), Codex, or Grok - to Gipity's cloud platform: databases, deployment, browser testing, image gen, and 50+ other capabilities your local agent doesn't have. It also syncs files so your local agent and the Gipity web agent share the same project.
7
+ This CLI connects your coding agent ([Claude Code](https://claude.ai/claude-code), Codex, Grok, or opencode) to Gipity: deploy, query the database, call functions, test pages in a real browser, generate images and audio, and keep your local files in sync with your Gipity project.
8
8
 
9
9
  ## Getting Started
10
10
 
11
- **Step 1 - install.** One line installs everything. It sets up Node 18+ (if you don't already have it) and the Gipity CLI, with no sudo required:
11
+ **Step 1 - install.** One line installs everything. It sets up Node 22+ (if you don't already have it) and the Gipity CLI, with no sudo required:
12
12
 
13
13
  ```bash
14
14
  # macOS / Linux / WSL
@@ -18,13 +18,12 @@ curl -fsSL https://gipity.ai/install.sh | bash
18
18
  irm https://gipity.ai/install.ps1 | iex
19
19
  ```
20
20
 
21
- **Step 2 - pick your path.** There are three, and they mix freely:
21
+ **Step 2 - pick your path.** There are two, and they mix freely:
22
22
 
23
23
  | You want to... | Run |
24
24
  |----------------|-----|
25
25
  | Start building right now, from anywhere | `gipity build` |
26
26
  | Use your own workflow in your own directory | `gipity init`, then `claude` / `codex` / `grok` / `opencode` |
27
- | Drive this computer from gipity.ai (phone, browser) | `gipity connect` |
28
27
 
29
28
  ### `gipity build` - start from anywhere
30
29
 
@@ -45,19 +44,9 @@ claude # or codex, grok, or opencode - whatever you use
45
44
 
46
45
  `init` links the directory to a Gipity project, writes CLAUDE.md/AGENTS.md primers so your agent understands Gipity, and installs the Gipity skills + file-sync hooks into the agent CLIs found on your machine (Claude Code, Codex, Grok; Cursor and Gemini get primer files too).
47
46
 
48
- ### `gipity connect` - drive it from the web
49
-
50
- Want to start chats from gipity.ai (including your phone) and have them run the coding agent on this computer? Connect it once:
51
-
52
- ```bash
53
- gipity connect
54
- ```
55
-
56
- It logs you in, pairs the machine, starts the Gipity relay in the background, and installs the login service so it survives reboots - then stops, without launching anything. From then on, open gipity.ai and start a chat to drive your agent here. Manage it with `gipity relay status` / `pause` / `resume` / `revoke`.
57
-
58
47
  ### Prefer npm
59
48
 
60
- If you already have **Node.js 18+** you can install directly:
49
+ If you already have **Node.js 22+** you can install directly:
61
50
 
62
51
  ```bash
63
52
  npm install -g gipity
@@ -135,16 +124,14 @@ This is the good part. When you run `gipity init` (or `gipity build`) in a proje
135
124
 
136
125
  **Auto-push** - Every time your agent writes or edits a file, it gets pushed to Gipity in the background. No extra steps.
137
126
 
138
- **Auto-pull** - Before each turn, your agent pulls any changes that happened remotely (like if your Gipity agent built something via chat). It sees what changed and can pick up where things left off.
127
+ **Auto-pull** - Before each turn, your agent pulls any changes that happened remotely (files written by a sandbox run, a workflow, or another machine). It sees what changed and can pick up where things left off.
139
128
 
140
- That means your local agent and your Gipity agent share the same files, same project, same context. You get the best of both - hands-on coding locally, autonomous agent work on Gipity.
141
-
142
- Sessions are also recorded to your Gipity project so you can watch them live at prompt.gipity.ai. Opt out per project with `gipity init --no-capture`.
129
+ Session recording is off by default. To keep your Claude Code sessions in your Gipity project (the Chats tab in your dashboard), run `gipity init --capture`; turn it off again with `gipity init --no-capture`.
143
130
 
144
131
  ### What gets set up
145
132
 
146
133
  ```
147
- .gipity.json # Project config (which project, which agent)
134
+ .gipity.json # Project config (which project)
148
135
  .gipity/ # Local sync state (gitignored)
149
136
  .claude/settings.json # Hooks for auto-push and auto-pull (per-agent equivalents for Codex/Grok)
150
137
  CLAUDE.md / AGENTS.md # Gipity commands reference for your agent
@@ -155,9 +142,9 @@ CLAUDE.md / AGENTS.md # Gipity commands reference for your agent
155
142
  If you ever need to sync manually:
156
143
 
157
144
  ```bash
158
- gipity sync check # See what's different
159
- gipity sync up # Push local changes
160
- gipity sync down # Pull remote changes
145
+ gipity sync --plan # See what would change, without applying it
146
+ gipity sync # Sync both ways
147
+ gipity push <file> # Push one or more files
161
148
  ```
162
149
 
163
150
  ## Commands
@@ -166,38 +153,37 @@ gipity sync down # Pull remote changes
166
153
  |---------|-------------|
167
154
  | `gipity build` | Log in, pick a project, pick your coding agent, and launch it - all in one |
168
155
  | `gipity init` | Link this directory to a project and set up your coding agent |
169
- | `gipity connect` | Connect this computer to gipity.ai so the web CLI can drive it |
170
- | `gipity relay` | Manage the relay (status, pause, resume, revoke) |
171
- | `gipity login` | Authenticate with email + verification code |
172
- | `gipity status` | Show project, agent, and auth info |
173
- | `gipity sync` | Sync files between local and Gipity |
174
- | `gipity push <file>` | Push a single file |
156
+ | `gipity login` / `gipity logout` | Authenticate with email + verification code / sign out |
157
+ | `gipity status` | Show project and login status |
158
+ | `gipity skill list` / `skill read <name>` | Task docs: read the matching skill before building |
159
+ | `gipity project` | List, create, switch, rename, or delete projects |
160
+ | `gipity add <template\|kit>` | Add a template (web-simple, web-fullstack, api, 2d-game, 3d-world, ...) or a kit (realtime, stripe, i18n, ...) |
175
161
  | `gipity deploy [dev\|prod]` | Deploy your project to the web |
176
- | `gipity chat <message>` | Send a message to your Gipity agent |
162
+ | `gipity page inspect\|eval\|screenshot <url>` | Check a page in a real browser: console errors, failed resources, DOM, screenshots |
163
+ | `gipity test` | Run project tests in sandboxed containers |
177
164
  | `gipity db` | Query, list, create, or drop project databases |
178
- | `gipity memory` | Read/write agent and project memory |
179
- | `gipity sandbox run <code> --lang <js\|py\|bash>` | Execute code in a sandboxed container (language is required) |
180
- | `gipity project` | List, create, switch, or delete projects |
181
- | `gipity agent` | List, create, switch, or configure agents |
165
+ | `gipity fn` | List, call, and delete serverless functions |
166
+ | `gipity logs fn <name>` / `logs app` | Function logs / recent app activity and errors |
167
+ | `gipity secrets` | Manage app secrets (encrypted, never echoed back) |
168
+ | `gipity job` | Run long CPU/GPU jobs |
169
+ | `gipity workflow` | Create, run, and schedule workflows |
182
170
  | `gipity approval` | List, create, answer, or cancel pending approvals |
183
- | `gipity workflow` | Manage and trigger automated workflows |
184
- | `gipity file` | Browse remote files (ls, cat, tree) |
185
- | `gipity add <template>` | Add a template (web-simple, 2d-game, 3d-world, web-fullstack, api) |
186
- | `gipity test` | Run project tests in sandboxed containers |
187
- | `gipity logs fn <name>` | View function execution logs |
188
- | `gipity page inspect <url>` | Inspect a URL: console errors, performance, failed resources |
171
+ | `gipity memory` | Read/write project memory used by workflow llm steps |
172
+ | `gipity ask "<question>"` | Ask a model one question and print the answer |
173
+ | `gipity generate` | Generate images, video, speech, sound effects, or music |
174
+ | `gipity service` | Call an app service (llm, tts, image, transcribe, ...) |
175
+ | `gipity sandbox run` | Execute code in a sandboxed container |
189
176
  | `gipity records` | Query and manage Records API tables |
190
- | `gipity fn` | Manage and call serverless functions |
191
- | `gipity rbac` | Manage RBAC policies |
192
- | `gipity audit` | Query audit logs |
193
- | `gipity credits` | Check your balance and usage |
194
- | `gipity skill` | List and manage agent skills |
195
- | `gipity chat [list\|rename\|archive\|delete]` | Manage chats (or `gipity chat <message>` to send) |
196
- | `gipity gmail [send\|reply\|search\|read]` | Send/read via your own Gmail (different from `gipity email`) |
177
+ | `gipity rbac` / `gipity audit` | Access policies / audit logs |
178
+ | `gipity file` | Browse remote files, versions, and rollbacks |
179
+ | `gipity sync` / `gipity push` | Sync files between local and Gipity |
180
+ | `gipity upload <file>` | Upload a file and print a durable public URL |
197
181
  | `gipity domain` | Manage custom domains for deployed apps |
198
- | `gipity email [send]` | Send emails from the platform (gipity@gipity.ai) |
199
- | `gipity generate` | Generate images, audio, or video via your agent |
200
- | `gipity logout` | Sign out and clear local tokens |
182
+ | `gipity email` | Test and inspect your app's `email()` sends (`email test`, `email log`) |
183
+ | `gipity credits` | Check your plan, balance, and usage |
184
+ | `gipity doctor` | Check install + environment health |
185
+
186
+ Run `gipity --help` for the full list, and `gipity <command> --help` for details.
201
187
 
202
188
  Every command supports `--json` for scripted/programmatic use.
203
189
 
@@ -210,13 +196,16 @@ gipity deploy prod # Deploy to production (app.gipity.ai)
210
196
 
211
197
  Your project gets a live URL at `https://dev.gipity.ai/{account}/{project}/`.
212
198
 
213
- ### chat
199
+ ### ask
214
200
 
215
- Talk to your Gipity agent from the terminal. If the agent creates or modifies files (including generated images, audio, video, and sandbox outputs), they sync back automatically.
201
+ One question, one answer: no chat history, no tools. Handy for summarizing a log or getting a second opinion while you work.
216
202
 
217
203
  ```bash
218
- gipity chat "Build me a landing page"
219
- gipity chat "Add a contact form" --new # Start a fresh conversation
204
+ gipity ask "summarize this" --file notes.md
205
+ cat errors.log | gipity ask "group these by root cause" --file -
206
+ cat prompt.txt | gipity ask # piped stdin is the whole prompt
207
+ gipity ask "what's in this image" --image shot.png --model haiku
208
+ gipity ask "list the causes" --schema '{"type":"array","items":{"type":"string"}}'
220
209
  ```
221
210
 
222
211
  ### db
@@ -232,49 +221,44 @@ gipity db drop old_db --project my-old-app # Drop from another project (no cd n
232
221
 
233
222
  ### memory
234
223
 
235
- Agent memory persists across all conversations. Project memory is scoped to one project.
224
+ Project memory is notes by topic, scoped to one project. Workflow llm steps read and write it with the `memory` tool, so it carries context from one run to the next. You can read and edit it from the CLI.
236
225
 
237
226
  ```bash
238
227
  gipity memory list
239
- gipity memory read preferences
240
- gipity memory write api_keys "stripe: sk_live_..."
241
- gipity memory write design_notes "use dark theme" --project
228
+ gipity memory read design_notes
229
+ gipity memory write design_notes "use dark theme"
230
+ gipity memory delete design_notes
242
231
  ```
243
232
 
233
+ Don't put secrets in memory. Use `gipity secrets set STRIPE_KEY ...` instead: secrets are encrypted at rest and never echoed back.
234
+
244
235
  ### sandbox
245
236
 
246
237
  Run code in a sandboxed Docker container with no network access. JavaScript, Python, and Bash.
247
238
 
248
239
  ```bash
249
- gipity sandbox run "console.log('Hello')" --lang js
250
- gipity sandbox run "import pandas; print(pandas.__version__)" --lang py
251
- gipity sandbox run "echo hello" --lang bash
240
+ gipity sandbox run "console.log('Hello')" --language js
241
+ gipity sandbox run "import pandas; print(pandas.__version__)" --language py
242
+ gipity sandbox run --file scripts/report.py
252
243
  ```
253
244
 
254
245
  ### workflow
255
246
 
256
247
  ```bash
257
248
  gipity workflow # List workflows
258
- gipity workflow run daily_report # Trigger manually
259
- gipity workflow enable daily_report # Turn on cron schedule
249
+ gipity workflow create workflows/daily_report.yaml
250
+ gipity workflow run daily_report # Run now and print each step's output
251
+ gipity workflow enable daily_report # Turn on its schedule
260
252
  gipity workflow runs daily_report # View recent runs
261
253
  ```
262
254
 
263
- ### agent
264
-
265
- ```bash
266
- gipity agent # List agents
267
- gipity agent create "Research Bot" # Create a new agent
268
- gipity agent set model claude-opus # Change the model
269
- gipity agent "Research Bot" # Switch active agent
270
- ```
271
-
272
255
  ### project
273
256
 
274
257
  ```bash
275
258
  gipity project # List projects
276
259
  gipity project create "My App" # Create new project
277
260
  gipity project my-app # Switch active project
261
+ gipity project rename "My Great App" # Rename (display name only)
278
262
  ```
279
263
 
280
264
  ## Project Config
@@ -288,7 +272,6 @@ Created by `gipity init`. Links your local directory to a Gipity project.
288
272
  "projectGuid": "prj-a1b2c3d4",
289
273
  "projectSlug": "my-app",
290
274
  "accountSlug": "steve",
291
- "agentGuid": "agt-x1y2z3w4",
292
275
  "apiBase": "https://a.gipity.ai",
293
276
  "ignore": ["node_modules", ".git", "dist", ".env"]
294
277
  }
package/dist/adopt-cwd.js CHANGED
@@ -193,7 +193,7 @@ export function formatBytes(n) {
193
193
  * validate/prompt as needed).
194
194
  * 2. Try to match an existing server project by slug; adopt if found.
195
195
  * 3. Otherwise POST /projects with relay-device wiring.
196
- * 4. Fetch agent + account, then `finalizeLocalProject` to write config,
196
+ * 4. `finalizeLocalProject` to write config,
197
197
  * sync, and install hooks/skills/gitignore.
198
198
  * Caller is responsible for the size-tier check before calling. */
199
199
  export async function adoptCurrentDir(opts) {
@@ -238,28 +238,17 @@ export async function adoptCurrentDir(opts) {
238
238
  }
239
239
  }
240
240
  }
241
- // Fetch the project's agent (if any). An explicit override wins.
242
- let agentGuid = opts.agentOverride ?? '';
243
- if (!agentGuid) {
244
- try {
245
- const agents = await get(`/projects/${project.short_guid}/agents`);
246
- if (agents.data.length > 0)
247
- agentGuid = agents.data[0].short_guid;
248
- }
249
- catch { /* no agents */ }
250
- }
251
241
  const { applied } = await finalizeLocalProject({
252
242
  dir: opts.cwd,
253
243
  projectGuid: project.short_guid,
254
244
  projectSlug: project.slug,
255
245
  projectName: project.name,
256
246
  accountSlug: opts.accountSlug,
257
- agentGuid,
258
247
  sync: 'strict',
259
248
  interactive: opts.confirmDeletions,
260
249
  tools: opts.tools,
261
250
  });
262
- return { project, isNew, agentGuid, accountSlug: opts.accountSlug, applied };
251
+ return { project, isNew, accountSlug: opts.accountSlug, applied };
263
252
  }
264
253
  /** Re-export so callers can unify on these constants for messaging. */
265
254
  export const ADOPT_THRESHOLDS = {
@@ -46,7 +46,7 @@ export const opencodeAdapter = {
46
46
  providerName: 'Anomaly',
47
47
  binary: 'opencode',
48
48
  buildInteractiveArgs({ resume, model }) {
49
- const args = [];
49
+ const args = ['--dir', process.cwd()];
50
50
  if (model)
51
51
  args.push('--model', toOpencodeModel(model));
52
52
  if (resume)
@@ -54,7 +54,18 @@ export const opencodeAdapter = {
54
54
  return args;
55
55
  },
56
56
  buildHeadlessArgs({ message, resume, model, bypassApprovals, jsonStream }) {
57
- const args = ['run', message];
57
+ // `--dir` is REQUIRED, not a nicety: opencode resolves its own working
58
+ // directory rather than inheriting the spawn cwd, and lands on $HOME when
59
+ // nothing tells it otherwise. On a cloud devbox that meant every file the
60
+ // agent wrote went to /home/relay instead of the project - so nothing
61
+ // synced back to Gipity and the user saw an agent that "didn't write any
62
+ // files" (observed live 2026-08-14: `← Write /home/relay/foo.txt` while
63
+ // the daemon's own sync ran in .../GipityProjects/project-394).
64
+ //
65
+ // process.cwd() is the right value: `gipity build` is spawned by the relay
66
+ // daemon with cwd set to the resolved project dir, and launches the agent
67
+ // from that same cwd.
68
+ const args = ['run', '--dir', process.cwd(), message];
58
69
  if (model)
59
70
  args.push('--model', toOpencodeModel(model));
60
71
  if (resume)
package/dist/api.js CHANGED
@@ -1,7 +1,7 @@
1
1
  import { Readable } from 'stream';
2
2
  import * as tar from 'tar-stream';
3
3
  import { getAuth, refreshTokenIfNeeded, forceRefreshAccessToken } from './auth.js';
4
- import { resolveApiBase, requireConfig, saveConfig } from './config.js';
4
+ import { resolveApiBase } from './config.js';
5
5
  import { clientHeaders } from './client-context.js';
6
6
  export class ApiError extends Error {
7
7
  statusCode;
@@ -150,9 +150,19 @@ async function shouldRetryAfter401(status, retried) {
150
150
  * the emailed login code, and dead-ending there stranded whole runs (cli#137). */
151
151
  function with401Hint(status, message) {
152
152
  return status === 401 && !usingEnvToken()
153
- ? `${message} — run: gipity login (headless/CI: set GIPITY_TOKEN instead — gipity skill read agent-deploy)`
153
+ ? `${message}; run: gipity login (headless/CI: set GIPITY_TOKEN instead; see gipity skill read agent-deploy)`
154
154
  : message;
155
155
  }
156
+ /** Build the ApiError for a non-2xx response from its parsed JSON body (null
157
+ * when the body wasn't JSON). A non-JSON error (an HTML 404 from a retired
158
+ * route, a proxy 502) has no message of its own, and over HTTP/2 statusText is
159
+ * always empty, so name the status and the request instead of printing a
160
+ * blank error. */
161
+ function apiErrorFrom(res, json, label, hint = true) {
162
+ const err = json?.error ?? {};
163
+ const message = err.message || `HTTP ${res.status}${res.statusText ? ` ${res.statusText}` : ''} from ${label}`;
164
+ return new ApiError(res.status, err.code || 'UNKNOWN', hint ? with401Hint(res.status, message) : message, json?.data);
165
+ }
156
166
  async function getHeaders() {
157
167
  return {
158
168
  ...clientHeaders(),
@@ -186,9 +196,8 @@ async function request(method, path, body, retrying = false, timeoutMs = REQUEST
186
196
  return request(method, path, body, true, timeoutMs);
187
197
  }
188
198
  if (!res.ok) {
189
- const json = await res.json().catch(() => ({ error: { code: 'UNKNOWN', message: res.statusText } }));
190
- const err = json.error || { code: 'UNKNOWN', message: res.statusText };
191
- throw new ApiError(res.status, err.code, with401Hint(res.status, err.message), json.data);
199
+ const json = await res.json().catch(() => null);
200
+ throw apiErrorFrom(res, json, `${method} ${path}`);
192
201
  }
193
202
  return res.json();
194
203
  }
@@ -216,9 +225,8 @@ export async function postForTarEntries(path, body, retried = false) {
216
225
  return postForTarEntries(path, body, true);
217
226
  }
218
227
  if (!res.ok) {
219
- const json = await read(r => r.json().catch(() => ({ error: { code: 'UNKNOWN', message: res.statusText } })));
220
- const err = json.error || { code: 'UNKNOWN', message: res.statusText };
221
- throw new ApiError(res.status, err.code, with401Hint(res.status, err.message), json.data);
228
+ const json = await read(r => r.json().catch(() => null));
229
+ throw apiErrorFrom(res, json, `POST ${path}`);
222
230
  }
223
231
  if (!res.body) {
224
232
  await read(async () => null); // clear the body timer before bailing out
@@ -255,29 +263,6 @@ export function patch(path, body) {
255
263
  export function del(path, body) {
256
264
  return request('DELETE', path, body);
257
265
  }
258
- /** Send a message via the conversation API, reusing or creating a conversation. Returns content string. */
259
- export async function sendMessage(message) {
260
- const config = requireConfig();
261
- const useExisting = !!config.conversationGuid;
262
- const endpoint = useExisting
263
- ? `/conversations/${config.conversationGuid}/messages`
264
- : '/conversations';
265
- const body = useExisting
266
- ? { content: message }
267
- : { agentGuid: config.agentGuid, content: message, projectGuid: config.projectGuid };
268
- const res = await post(endpoint, body);
269
- if (res.data.conversationGuid !== config.conversationGuid) {
270
- saveConfig({ ...config, conversationGuid: res.data.conversationGuid });
271
- }
272
- // The server's cost-consent gate stops the agentic loop on big-build
273
- // requests and returns an explicit costWarning with empty content. Surface
274
- // it - before this the CLI printed nothing and the command silently did
275
- // nothing. Replying "y" (next sendMessage) consents and proceeds.
276
- if (res.data.costWarning && !res.data.content) {
277
- return res.data.costWarning.message;
278
- }
279
- return res.data.content;
280
- }
281
266
  /** Download a file as raw bytes (no JSON parsing) */
282
267
  export async function download(path, retried = false) {
283
268
  const url = `${baseUrl()}${path}`;
@@ -290,7 +275,7 @@ export async function download(path, retried = false) {
290
275
  }
291
276
  if (!res.ok) {
292
277
  await read(async () => null);
293
- throw new ApiError(res.status, 'DOWNLOAD_ERROR', with401Hint(res.status, `Download failed: ${res.statusText}`));
278
+ throw new ApiError(res.status, 'DOWNLOAD_ERROR', with401Hint(res.status, `Download failed: HTTP ${res.status}${res.statusText ? ` ${res.statusText}` : ''}`));
294
279
  }
295
280
  return read(async (r) => Buffer.from(await r.arrayBuffer()));
296
281
  }
@@ -310,9 +295,8 @@ export async function downloadWithHeaders(path, retried = false) {
310
295
  return downloadWithHeaders(path, true);
311
296
  }
312
297
  if (!res.ok) {
313
- const json = await read(r => r.json().catch(() => ({ error: { code: 'UNKNOWN', message: res.statusText } })));
314
- const err = json.error || { code: 'UNKNOWN', message: res.statusText };
315
- throw new ApiError(res.status, err.code, with401Hint(res.status, err.message), json.data);
298
+ const json = await read(r => r.json().catch(() => null));
299
+ throw apiErrorFrom(res, json, `GET ${path}`);
316
300
  }
317
301
  return read(async (r) => ({ buffer: Buffer.from(await r.arrayBuffer()), headers: r.headers }));
318
302
  }
@@ -336,9 +320,8 @@ export async function postBinary(path, body, contentType = 'application/zip', re
336
320
  return postBinary(path, body, contentType, true);
337
321
  }
338
322
  if (!res.ok) {
339
- const json = await res.json().catch(() => ({ error: { code: 'UNKNOWN', message: res.statusText } }));
340
- const err = json.error || { code: 'UNKNOWN', message: res.statusText };
341
- throw new ApiError(res.status, err.code, with401Hint(res.status, err.message), json.data);
323
+ const json = await res.json().catch(() => null);
324
+ throw apiErrorFrom(res, json, `POST ${path}`);
342
325
  }
343
326
  return { status: res.status, json: await res.json() };
344
327
  }
@@ -372,7 +355,7 @@ export async function downloadStream(path, retried = false) {
372
355
  return downloadStream(path, true);
373
356
  }
374
357
  if (!res.ok) {
375
- throw new ApiError(res.status, 'DOWNLOAD_ERROR', with401Hint(res.status, `Download failed: ${res.statusText}`));
358
+ throw new ApiError(res.status, 'DOWNLOAD_ERROR', with401Hint(res.status, `Download failed: HTTP ${res.status}${res.statusText ? ` ${res.statusText}` : ''}`));
376
359
  }
377
360
  return Readable.fromWeb(res.body);
378
361
  }
@@ -419,13 +402,13 @@ export async function putToPresignedUrl(url, body, contentLength, contentType) {
419
402
  // A timeout aborts with a TimeoutError/AbortError. Surface it as a 408 so
420
403
  // withRetry() treats it as transient and retries the PUT.
421
404
  if (err instanceof Error && (err.name === 'TimeoutError' || err.name === 'AbortError')) {
422
- throw new ApiError(408, 'S3_UPLOAD_TIMEOUT', `S3 PUT stalled (no completion in ${Math.round(timeoutMs / 1000)}s)`);
405
+ throw new ApiError(408, 'S3_UPLOAD_TIMEOUT', `Storage upload stalled (no completion in ${Math.round(timeoutMs / 1000)}s)`);
423
406
  }
424
407
  throw err;
425
408
  }
426
409
  if (!res.ok) {
427
410
  const text = await res.text().catch(() => res.statusText);
428
- throw new ApiError(res.status, 'S3_UPLOAD', `S3 PUT failed: ${res.status} ${text.slice(0, 200)}`);
411
+ throw new ApiError(res.status, 'S3_UPLOAD', `Storage upload failed: ${res.status} ${text.slice(0, 200)}`);
429
412
  }
430
413
  const etag = (res.headers.get('etag') ?? '').replace(/^"|"$/g, '');
431
414
  return etag;
@@ -450,9 +433,8 @@ export async function publicRequest(method, path, body, extraHeaders) {
450
433
  body: body === undefined ? undefined : JSON.stringify(body),
451
434
  }, REQUEST_TIMEOUT_MS, `${method} ${path}`);
452
435
  if (!res.ok) {
453
- const json = await res.json().catch(() => ({ error: { code: 'UNKNOWN', message: res.statusText } }));
454
- const err = json.error || { code: 'UNKNOWN', message: res.statusText };
455
- throw new ApiError(res.status, err.code, err.message, json.data);
436
+ const json = await res.json().catch(() => null);
437
+ throw apiErrorFrom(res, json, `${method} ${path}`, false);
456
438
  }
457
439
  return res.json();
458
440
  }
package/dist/auth.js CHANGED
@@ -169,7 +169,7 @@ export async function acquireRefreshLock() {
169
169
  * refresh" shortcut and performs the refresh round-trip unconditionally, so a token
170
170
  * the server considers dead actually gets replaced instead of re-sent. */
171
171
  export async function refreshTokenIfNeeded(force = false) {
172
- const auth = readAuthFresh(); // never the cache — a sibling may have rotated
172
+ const auth = readAuthFresh(); // never the cache: a sibling may have rotated
173
173
  if (!auth)
174
174
  return; // not logged in - caller throws the clean error
175
175
  cached = auth;
package/dist/banner.js CHANGED
@@ -19,19 +19,16 @@ function tildify(p) {
19
19
  // ── Static content ─────────────────────────────────────────────────────
20
20
  // ── Feature groups ────────────────────────────────────────────────────
21
21
  const AI_MODELS = [
22
- 'OpenAI', 'Anthropic', 'Gemini', 'ElevenLabs', 'Black Forest Labs',
22
+ 'OpenAI', 'Anthropic', 'Gemini', 'Black Forest Labs',
23
23
  ];
24
24
  const GENERATION = [
25
25
  'Image', 'Video', 'Music', 'Speech / TTS', 'Sound',
26
26
  ];
27
- const AGENT = [
28
- 'Memory', 'Conversations', 'Plans', 'Schedules', 'Soul',
29
- ];
30
27
  const AUTOMATION = [
31
- 'Workflows', 'Triggers', 'Webhooks', 'Approvals',
28
+ 'Workflows', 'Schedules', 'Triggers', 'Webhooks', 'Approvals', 'Memory',
32
29
  ];
33
30
  const INTEGRATIONS = [
34
- '5,000+ Skills', 'Gmail', 'Calendar', 'Twitter', 'Telegram',
31
+ 'GitHub', 'Stripe', 'Web Push', 'Email', 'Custom Domains',
35
32
  ];
36
33
  const DATA = [
37
34
  'Database', 'Records API', 'RBAC', 'Audit Trail', 'Soft Deletes',
@@ -236,7 +233,6 @@ function printFull(opts, outerW) {
236
233
  rightLines.push('');
237
234
  addSection('AI Models', AI_MODELS);
238
235
  addSection('Generation', GENERATION);
239
- addSection('Agent', AGENT);
240
236
  addSection('Automation', AUTOMATION);
241
237
  addSection('Integrations', INTEGRATIONS);
242
238
  addSection('Data', DATA);
package/dist/catalog.js CHANGED
@@ -5,28 +5,28 @@
5
5
  * Source: platform/packages/shared/src/constants.ts (TEMPLATES/KITS cliHint fields)
6
6
  * Run `just build-knowledge` to refresh.
7
7
  */
8
- /** Visible starter templates (complete working demos). */
9
- export const STARTERS = [
8
+ /** Visible apps (registry/apps/): complete working apps to run, then extend. */
9
+ export const APPS = [
10
10
  { key: 'web-vision-cam', hint: 'fullscreen camera app with on-device vision (MediaPipe)' },
11
11
  { key: 'object-spotter', hint: 'camera app that boxes, labels, and counts objects (YOLOX on-device)' },
12
12
  { key: '2d-game', hint: '2D games with Phaser 3 - platformer, arcade, puzzle' },
13
13
  { key: '3d-world', hint: 'playable 3D multiplayer rocket-launcher demo' },
14
14
  { key: 'karaoke-captions', hint: 'audio + lyrics -> word-synced karaoke captions (GPU job)' },
15
- { key: 'outreach-agent', hint: 'AI-run outreach funnel - import contacts, draft + auto-send staged emails' },
16
15
  { key: 'paid-app', hint: 'storefront that charges real money - Stripe checkout, members area, billing' },
17
16
  { key: 'notify-demo', hint: 'web-push demo - enable notifications, send a real ping' },
18
17
  ];
19
- /** Visible blank-wiring templates. */
20
- export const BLANK = [
18
+ /** Visible templates (registry/templates/): blank framework wiring. */
19
+ export const TEMPLATES = [
21
20
  { key: 'web-simple', hint: 'static frontend-only site - pages, dashboards, simple games' },
22
21
  { key: 'web-fullstack', hint: 'backend API + database wiring - frontend, functions, migrations; deploys green empty' },
23
22
  { key: '3d-engine', hint: '3D multiplayer wiring - Three.js + Rapier + Gipity Realtime' },
24
23
  { key: 'api', hint: 'pure API backend, no frontend - functions + tests, deploys green' },
25
24
  ];
26
- /** Hidden templates - installable by exact key, omitted from listings. */
25
+ /** Hidden templates and apps - installable by exact key, omitted from listings. */
27
26
  export const HIDDEN = [
28
27
  { key: 'app-itsm', hint: 'IT service management / helpdesk / ticketing' },
29
- { key: 'monitor', hint: 'account observability dashboard (auto-installed per account)' },
28
+ { key: 'monitor', hint: 'the Gipity account web app (projects, deploys, logs, billing)' },
29
+ { key: 'outreach-agent', hint: 'incomplete: AI-run outreach funnel (needs porting to workflow tools)' },
30
30
  ];
31
31
  /** Kits - building blocks added into an existing app. */
32
32
  export const KITS = [
@@ -40,5 +40,6 @@ export const KITS = [
40
40
  { key: 'stripe', hint: 'charge your users - Stripe checkout, subscriptions, brokered webhooks' },
41
41
  { key: 'notify', hint: 'web push notifications - platform-owned keys, works on iOS home screen' },
42
42
  { key: 'servicenow', hint: 'ServiceNow tables as a data source - OAuth pull/write-back/real-time sync' },
43
+ { key: 'leaderboard', hint: 'leaderboards for any game - scores or times, daily/weekly/season boards, tiebreaks, replays, bans' },
43
44
  ];
44
45
  //# sourceMappingURL=catalog.js.map