@hanzo/build 0.2.80 → 0.2.82

package/lib/api/members.js

@@ -13,7 +13,8 @@
  * An invitation is a code IAM redeems when someone signs up with it; IAM sends
  * no email of its own.
  */
-import { call, query, seg } from './call.js';
+import { phrase } from '@hanzo/i18n';
+import { call, query, seg, Sentence } from './call.js';
 const str = (v) => (typeof v === 'string' ? v : '');
 const num = (v) => (typeof v === 'number' && Number.isFinite(v) ? v : 0);
 const obj = (v) => (v && typeof v === 'object' ? v : {});
@@ -34,7 +35,7 @@ export function member(raw) {
 export async function roster(t, org) {
     const raw = obj(await call(t, 'GET', `/v1/iam/memberships${query({ org })}`));
     if (raw.status === 'error')
-        throw new Error(str(raw.msg) || 'IAM refused the roster');
+        throw new Error(str(raw.msg) || phrase('IAM refused the roster'));
     const rank = (r) => ROLES.indexOf(r);
     return arr(raw.data)
         .map(obj)
@@ -71,7 +72,7 @@ function hex(bytes) {
 export async function invite(t, org, email) {
     const address = email.trim().toLowerCase();
     if (!EMAIL.test(address))
-        throw new Error(`${email.trim() || 'That'} is not an email address`);
+        throw email.trim() ? new Sentence(phrase('{email} is not an email address'), { email: email.trim() }) : new Error(phrase('That is not an email address'));
     const local = address.slice(0, address.indexOf('@')).replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 24);
     return invitation(await call(t, 'POST', '/v1/iam/invitations', {
         owner: org,

package/lib/api/memory.d.ts

@@ -1,14 +1,3 @@
-/**
- * What Hanzo remembers about the signed-in person, in the org they act in.
- *
- *   GET  /v1/ai/memory/list?limit=  {status, data: [memory]}, newest first
- *   POST /v1/ai/memory/remember     {content} → {status, data: memory}
- *   POST /v1/ai/memory/delete       {id: "<owner>/<name>"}
- *
- * The platform keys every memory on the validated caller and org, never on the
- * request, so these read and change the caller's own and nobody else's. A
- * refusal arrives in the envelope, usually under a 200.
- */
 import { type Target } from './call.ts';
 export interface Memory {
     /** `<owner>/<name>`, what a delete names. */

package/lib/api/memory.js

@@ -9,6 +9,7 @@
  * request, so these read and change the caller's own and nobody else's. A
  * refusal arrives in the envelope, usually under a 200.
  */
+import { phrase } from '@hanzo/i18n';
 import { call, query, unwrap } from './call.js';
 const str = (v) => (typeof v === 'string' ? v : '');
 export function memoryOf(raw) {
@@ -26,7 +27,7 @@ export async function memories(t, limit = 100) {
 export async function remember(t, content) {
     const said = content.trim();
     if (!said)
-        throw new Error('Say what Hanzo should remember');
+        throw new Error(phrase('Say what Hanzo should remember'));
     return memoryOf(unwrap(await call(t, 'POST', '/v1/ai/memory/remember', { content: said })));
 }
 export async function forget(t, id) {

package/lib/api/places.d.ts

@@ -1,12 +1,3 @@
-/**
- * Where a run can run: the platform's sandbox, or one of the org's machines.
- *
- *   GET /v1/agent/targets → {targets: [...]}, newest first (machines.ts)
- *
- * The sandbox is not a row the platform lists — it is what a run gets when it
- * names no target — so it is the first place here and carries no id. A machine
- * can take a run only while it is online.
- */
 import type { Target } from './call.ts';
 export interface Place {
     /** `tgt_…`, or '' for the sandbox. */
@@ -19,6 +10,7 @@ export interface Place {
     /** "10 vCPU / 122G / 1× GB10", when the machine reported one. */
     capacity: string;
 }
+/** The sandbox, named in English and marked (`phrase`): a screen draws its label through `t`. */
 export declare const SANDBOX: Place;
 export declare function places(t: Target): Promise<Place[]>;
 /** Whether a run sent here now would be taken. */

package/lib/api/places.js

@@ -1,5 +1,16 @@
+/**
+ * Where a run can run: the platform's sandbox, or one of the org's machines.
+ *
+ *   GET /v1/agent/targets → {targets: [...]}, newest first (machines.ts)
+ *
+ * The sandbox is not a row the platform lists — it is what a run gets when it
+ * names no target — so it is the first place here and carries no id. A machine
+ * can take a run only while it is online.
+ */
+import { phrase } from '@hanzo/i18n';
 import { machines, state } from './machines.js';
-export const SANDBOX = { id: '', label: 'Hanzo sandbox', kind: 'sandbox', status: 'online', capacity: '' };
+/** The sandbox, named in English and marked (`phrase`): a screen draws its label through `t`. */
+export const SANDBOX = { id: '', label: phrase('Hanzo sandbox'), kind: 'sandbox', status: 'online', capacity: '' };
 export async function places(t) {
     const list = await machines(t);
     return [SANDBOX, ...list.map((m) => ({ id: m.id, label: m.label, kind: m.kind, status: state(m), capacity: m.capacity }))];

package/lib/api/plugins.d.ts

@@ -1,18 +1,3 @@
-/**
- * Plugins: TypeScript connectors an org builds, and what this deployment mounts.
- *
- *   GET    /v1/tool/plugins/authored        {plugins: [plugin]}, newest first, each with its source
- *   POST   /v1/tool/plugins/build           {name, provider?, source | spec} → 201 {bytes, generated, plugin}
- *   DELETE /v1/tool/plugins/authored/{id}   {deleted}
- *   GET    /v1/tool/plugins                 {plugins: [{name, enabled, prefixes}]}
- *
- * Building is the gate: the platform bundles the source and compiles it in the
- * runtime that will run it, and keeps it only if both succeed — a failure is a
- * 422 whose reason is the bundler's. A spec (an OpenAPI document or prose) has a
- * model write the source, which comes back to be read. A plugin never carries a
- * credential: it names the connectors provider whose credential it reads when it
- * runs. The mounted list is the deployment's own subsystems, read-only.
- */
 import { type Target } from './call.ts';
 export interface Plugin {
     /** What a delete addresses. */
@@ -49,7 +34,7 @@ export interface Build {
     source: string;
     spec: string;
 }
-/** Why a plugin cannot be built as it stands, or '' when it can. */
+/** Why a plugin cannot be built as it stands, or '' when it can. English, marked (`phrase`): a screen says it through `t`. */
 export declare function refuse(b: Build): string;
 export declare function build(t: Target, b: Build): Promise<Built>;
 export declare function remove(t: Target, id: string): Promise<void>;

package/lib/api/plugins.js

@@ -13,6 +13,7 @@
  * credential: it names the connectors provider whose credential it reads when it
  * runs. The mounted list is the deployment's own subsystems, read-only.
  */
+import { phrase } from '@hanzo/i18n';
 import { call, seg } from './call.js';
 /** A plugin's name: one lowercase path segment, the id it runs by. */
 export const NAME = /^[a-z0-9][a-z0-9_-]{0,63}$/;
@@ -35,12 +36,12 @@ export async function mounted(t) {
     })
         .filter((m) => m.name);
 }
-/** Why a plugin cannot be built as it stands, or '' when it can. */
+/** Why a plugin cannot be built as it stands, or '' when it can. English, marked (`phrase`): a screen says it through `t`. */
 export function refuse(b) {
     if (!NAME.test(b.name))
-        return 'A name is one lowercase word: letters, digits, _ or -';
+        return phrase('A name is one lowercase word: letters, digits, _ or -');
     if (!b.source.trim() === !b.spec.trim())
-        return 'Give the TypeScript or the API it calls, one of the two';
+        return phrase('Give the TypeScript or the API it calls, one of the two');
     return '';
 }
 export async function build(t, b) {

package/lib/api/profile.d.ts

@@ -1,13 +1,3 @@
-/**
- * The signed-in person's own profile on Hanzo IAM: the name they are shown by
- * and their photo.
- *
- *   PUT  /v1/iam/account  {displayName} → {status, data: {owner, name, displayName, avatar, …}}
- *   POST /v1/account/avatar  multipart `file` → {avatar}   the photo, also written to IAM
- *
- * Both act on the caller alone: neither request names a person. The email is a
- * sign-in identifier and changes only through IAM's verification, never here.
- */
 import { type Target } from './call.ts';
 export interface Profile {
     displayName: string;

package/lib/api/profile.js

@@ -8,6 +8,7 @@
  * Both act on the caller alone: neither request names a person. The email is a
  * sign-in identifier and changes only through IAM's verification, never here.
  */
+import { phrase } from '@hanzo/i18n';
 import { call, headers, reason, Refusal, unwrap } from './call.js';
 const str = (v) => (typeof v === 'string' ? v : '');
 const obj = (v) => (v && typeof v === 'object' ? v : {});
@@ -15,7 +16,7 @@ const obj = (v) => (v && typeof v === 'object' ? v : {});
 export async function rename(t, name) {
     const displayName = name.trim();
     if (!displayName)
-        throw new Error('A name cannot be empty');
+        throw new Error(phrase('A name cannot be empty'));
     const p = obj(unwrap(await call(t, 'PUT', '/v1/iam/account', { displayName })));
     return { displayName: str(p.displayName), avatar: str(p.avatar) };
 }
@@ -25,9 +26,9 @@ const LIMIT = 8 << 20;
 /** Store a new photo and answer its address. */
 export async function photo(t, file) {
     if (!file.size)
-        throw new Error('That file is empty');
+        throw new Error(phrase('That file is empty'));
     if (file.size > LIMIT)
-        throw new Error('A photo is at most 8 MB');
+        throw new Error(phrase('A photo is at most 8 MB'));
     const form = new FormData();
     form.append('file', file);
     const res = await fetch(`${t.api}/v1/account/avatar`, { method: 'POST', headers: headers(t), body: form, cache: 'no-store' });
@@ -35,6 +36,6 @@ export async function photo(t, file) {
         throw new Refusal(res.status, (await reason(res)) || `POST /v1/account/avatar answered ${res.status}`);
     const url = str(obj(await res.json()).avatar);
     if (!url.startsWith('https://'))
-        throw new Refusal(502, 'The photo was stored without an address this page can show');
+        throw new Refusal(502, phrase('The photo was stored without an address this page can show'));
     return url;
 }

package/lib/api/projects.d.ts

@@ -1,17 +1,3 @@
-/**
- * The org's projects: what it has built, and where each one is served.
- *
- *   GET    /v1/projects                     → Project[]
- *   PATCH  /v1/projects/{slug}              rename it, or make it public or private
- *   DELETE /v1/projects/{slug}              delete it and take its site down
- *   GET    /v1/projects/{slug}/deployments  → Deployment[], newest first
- *
- * `slug` is the one key every surface shares — the address under /dev, the
- * site's name, the `project` a run is tagged with. A project belongs to the org,
- * not to a person: the record names no author, so any member lists, changes and
- * deletes it. Private is paid, and an unfunded org is refused rather than left
- * public without being told.
- */
 import { type Target } from './call.ts';
 export interface Project {
     slug: string;

package/lib/api/projects.js

@@ -1,10 +1,10 @@
 /**
  * The org's projects: what it has built, and where each one is served.
  *
- *   GET    /v1/projects                     → Project[]
- *   PATCH  /v1/projects/{slug}              rename it, or make it public or private
- *   DELETE /v1/projects/{slug}              delete it and take its site down
- *   GET    /v1/projects/{slug}/deployments  → Deployment[], newest first
+ *   GET    /v1/project                     → Project[]
+ *   PATCH  /v1/project/{slug}              rename it, or make it public or private
+ *   DELETE /v1/project/{slug}              delete it and take its site down
+ *   GET    /v1/project/{slug}/deployments  → Deployment[], newest first
  *
  * `slug` is the one key every surface shares — the address under /dev, the
  * site's name, the `project` a run is tagged with. A project belongs to the org,
@@ -12,6 +12,7 @@
  * deletes it. Private is paid, and an unfunded org is refused rather than left
  * public without being told.
  */
+import { phrase } from '@hanzo/i18n';
 import { call, seg } from './call.js';
 const str = (v) => (typeof v === 'string' ? v : '');
 const num = (v) => (typeof v === 'number' && Number.isFinite(v) ? v : 0);
@@ -51,7 +52,7 @@ export function project(raw) {
     };
 }
 export async function projects(t) {
-    const raw = await call(t, 'GET', '/v1/projects');
+    const raw = await call(t, 'GET', '/v1/project');
     const rows = Array.isArray(raw) ? raw : Array.isArray(raw?.data) ? raw.data : [];
     return rows
         .map(project)
@@ -64,16 +65,16 @@ export async function change(t, slug, what) {
     if (what.name !== undefined) {
         const n = what.name.trim();
         if (!n)
-            throw new Error('A project needs a name');
+            throw new Error(phrase('A project needs a name'));
         body.name = n;
     }
     if (what.visibility !== undefined)
         body.visibility = what.visibility;
-    return project(await call(t, 'PATCH', `/v1/projects/${seg(slug)}`, body));
+    return project(await call(t, 'PATCH', `/v1/project/${seg(slug)}`, body));
 }
 /** Delete a project. Its site stops answering and its slug is free again. */
 export async function remove(t, slug) {
-    await call(t, 'DELETE', `/v1/projects/${seg(slug)}`);
+    await call(t, 'DELETE', `/v1/project/${seg(slug)}`);
 }
 export function deployment(raw) {
     const d = (raw && typeof raw === 'object' ? raw : {});
@@ -89,7 +90,7 @@ export function deployment(raw) {
 }
 /** A project's deployments, newest first: the first says how its latest build went. */
 export async function deployments(t, slug) {
-    const raw = await call(t, 'GET', `/v1/projects/${seg(slug)}/deployments`);
+    const raw = await call(t, 'GET', `/v1/project/${seg(slug)}/deployments`);
     return (Array.isArray(raw) ? raw : [])
         .map(deployment)
         .filter((d) => d.id)
@@ -126,7 +127,7 @@ export async function templates(t) {
  * once, and answers `building` until it is `live` or its build failed.
  */
 export async function fork(t, slug) {
-    return project(await call(t, 'POST', '/v1/projects/fork', { slug }));
+    return project(await call(t, 'POST', '/v1/project/fork', { slug }));
 }
 /** `owner/name` from a clone URL — its last two path segments, without `.git`. */
 export function address(clone) {

package/lib/api/provider.d.ts

@@ -1,16 +1,3 @@
-/**
- * The organization's connectors: a Slack workspace, the GitHub accounts the
- * platform's GitHub App is installed on, and the social accounts automations
- * post to.
- *
- *   GET  /v1/provider/{id}              one connector and this org's connection to it
- *   POST /v1/provider/{id}/connect      {return} → {authorizeUrl}: the provider's own consent page (org admin)
- *   POST /v1/provider/{id}/disconnect   forget the org's connection (org admin)
- *   GET  /v1/provider/slack/channels    the connected workspace's channels, a page at a time
- *
- * Connecting leaves this page once, for the provider's consent screen, and only
- * for that provider's own host.
- */
 import { type Target } from './call.ts';
 export interface Connector {
     id: string;
@@ -30,7 +17,8 @@ export declare function read(t: Target, id: string): Promise<Connector>;
  * The social accounts an organization connects. An automation posts text to
  * the ones that take it; Instagram and TikTok take only images and video, and
  * say so. `needs` is what connecting waits on while Hanzo's app with the
- * platform is not set up.
+ * platform is not set up. Its sentences are English and marked (`phrase`):
+ * a screen draws them through `t`.
  */
 export declare const SOCIAL: readonly {
     id: string;

package/lib/api/provider.js

@@ -11,7 +11,8 @@
  * Connecting leaves this page once, for the provider's consent screen, and only
  * for that provider's own host.
  */
-import { call, query, seg } from './call.js';
+import { phrase } from '@hanzo/i18n';
+import { call, query, seg, Sentence } from './call.js';
 const str = (v) => (typeof v === 'string' ? v : '');
 const obj = (v) => (v && typeof v === 'object' ? v : {});
 const arr = (v) => (Array.isArray(v) ? v : []);
@@ -45,25 +46,26 @@ const CONSENT = {
  * The social accounts an organization connects. An automation posts text to
  * the ones that take it; Instagram and TikTok take only images and video, and
  * say so. `needs` is what connecting waits on while Hanzo's app with the
- * platform is not set up.
+ * platform is not set up. Its sentences are English and marked (`phrase`):
+ * a screen draws them through `t`.
  */
 export const SOCIAL = [
-    { id: 'x', name: 'X', posts: true, needs: 'X posting needs Hanzo’s X developer app with paid API access; it is not set up yet.' },
-    { id: 'linkedin', name: 'LinkedIn', posts: true, needs: 'LinkedIn posting needs Hanzo’s LinkedIn app with Share on LinkedIn; it is not set up yet.' },
-    { id: 'facebook', name: 'Facebook', posts: true, needs: 'Facebook Page posting needs Hanzo’s Meta app, approved by Meta App Review to publish to Pages; it is not set up yet.' },
+    { id: 'x', name: 'X', posts: true, needs: phrase('X posting needs Hanzo’s X developer app with paid API access; it is not set up yet.') },
+    { id: 'linkedin', name: 'LinkedIn', posts: true, needs: phrase('LinkedIn posting needs Hanzo’s LinkedIn app with Share on LinkedIn; it is not set up yet.') },
+    { id: 'facebook', name: 'Facebook', posts: true, needs: phrase('Facebook Page posting needs Hanzo’s Meta app, approved by Meta App Review to publish to Pages; it is not set up yet.') },
     {
         id: 'instagram',
         name: 'Instagram',
         posts: false,
-        needs: 'Instagram posting needs Hanzo’s Meta app, approved by Meta App Review; it is not set up yet.',
-        takes: 'Instagram takes photos and reels, not text, so automations do not post to it.',
+        needs: phrase('Instagram posting needs Hanzo’s Meta app, approved by Meta App Review; it is not set up yet.'),
+        takes: phrase('Instagram takes photos and reels, not text, so automations do not post to it.'),
     },
     {
         id: 'tiktok',
         name: 'TikTok',
         posts: false,
-        needs: 'TikTok posting needs TikTok’s audit of Hanzo’s app; it is not set up yet.',
-        takes: 'TikTok takes videos and photos, not text, so automations do not post to it.',
+        needs: phrase('TikTok posting needs TikTok’s audit of Hanzo’s app; it is not set up yet.'),
+        takes: phrase('TikTok takes videos and photos, not text, so automations do not post to it.'),
     },
 ];
 /** The provider's consent page for this org; its return lands on `back` when that is a Hanzo app page. */
@@ -71,7 +73,7 @@ export async function authorize(t, id, back) {
     const url = str(obj(await call(t, 'POST', `/v1/provider/${seg(id)}/connect`, back ? { return: back } : {})).authorizeUrl);
     const host = CONSENT[id];
     if (!host || !host.test(url))
-        throw new Error(`The platform did not name a ${id} address to connect at`);
+        throw new Sentence(phrase('The platform did not name a {provider} address to connect at'), { provider: id });
     return url;
 }
 export async function disconnect(t, id) {

package/lib/api/sandbox.d.ts

@@ -1,20 +1,3 @@
-/**
- * A run's sandbox. It outlives the run: kept after the run ends, parked (its pod
- * stopped, its disk and working tree kept) while nobody watches, and retired a
- * day after it parks; a free plan's sandbox is not parked, and ends within the
- * hour. Resume gives a parked one a pod again under the same id and tree.
- *
- *   GET  /v1/sandbox/{id}                              its status and when its lease ends
- *   POST /v1/sandbox/{id}/pause                        park it: stop the pod, keep the disk
- *   POST /v1/sandbox/{id}/resume                       a pod again, same id and /work
- *   POST /v1/sandbox/{id}/{screen|terminal}/ticket     one ticket, spent when the page's socket opens (30 s)
- *   GET  /v1/sandbox/{id}/ports                        what listens in it, each with its preview host
- *   POST /v1/sandbox/{id}/preview {port}               an address that opens that port in a browser
- *   POST /v1/sandbox/read {id, path}                   a directory's names, or a file's bytes
- *
- * A door or a preview asked of a sandbox that stopped as it was asked is 409: it
- * is resumed, and asked again once.
- */
 import { type Target } from './call.ts';
 export type Door = 'screen' | 'terminal';
 /** Where a sandbox is in its life. */

package/lib/api/sandbox.js

@@ -15,6 +15,7 @@
  * A door or a preview asked of a sandbox that stopped as it was asked is 409: it
  * is resumed, and asked again once.
  */
+import { phrase } from '@hanzo/i18n';
 import { call, Refusal, seg } from './call.js';
 const STATES = ['pending', 'running', 'parked', 'error'];
 function box(raw, id) {
@@ -54,7 +55,7 @@ async function up(t, id) {
         b = await sandbox(t, id);
     }
     if (b.state !== 'running')
-        throw new Refusal(503, b.error || 'The sandbox did not start again. Try again.');
+        throw new Refusal(503, b.error || phrase('The sandbox did not start again. Try again.'));
 }
 /** Asks what needs a running sandbox; a parked one is resumed first. */
 async function running(t, id, ask) {
@@ -75,7 +76,7 @@ export async function door(t, id, which, session = '') {
     const r = await running(t, id, () => call(t, 'POST', `/v1/sandbox/${seg(id)}/${which}/ticket`));
     const path = typeof r?.url === 'string' ? r.url : '';
     if (!path.startsWith('/v1/'))
-        throw new Refusal(502, 'The sandbox answered with no address to open');
+        throw new Refusal(502, phrase('The sandbox answered with no address to open'));
     const arg = which === 'terminal' && NAME.test(session) ? `&arg=${session}` : '';
     return `${t.api}${path}${arg}`;
 }
@@ -104,10 +105,10 @@ export async function preview(t, id, port) {
         url = new URL(typeof r?.url === 'string' ? r.url : '');
     }
     catch {
-        throw new Refusal(502, 'The sandbox answered with no address to open');
+        throw new Refusal(502, phrase('The sandbox answered with no address to open'));
     }
     if (url.protocol !== 'https:')
-        throw new Refusal(502, 'The sandbox answered with no address to open');
+        throw new Refusal(502, phrase('The sandbox answered with no address to open'));
     return url.href;
 }
 /** What a file shows at most. */

package/lib/api/sessions.d.ts

@@ -1,20 +1,3 @@
-/**
- * Runs, as the platform records them: one session per run.
- *
- *   GET   /v1/agent/sessions?kind=&project=&status=&limit=&after=   newest first, {sessions, next}
- *   GET   /v1/agent/sessions/{id}                            + the 50 most recent events
- *   PATCH /v1/agent/sessions/{id}         {title}|{published} rename it; open its story to the public build route
- *   POST  /v1/agent/sessions/{id}/message {message}           steer a running run
- *   POST  /v1/agent/sessions/{id}/pause                       pause it; a sandbox run keeps its work on its branch
- *   POST  /v1/agent/sessions/{id}/resume                      ask a paused run to go on
- *   POST  /v1/agent/sessions/{id}/stop    {message}           end it, work kept
- *   GET  /v1/agent/sessions/stream?root={id}                 SSE: `session` and `event` frames,
- *                                                            each wrapped: {"session":{…}}, {"event":{…}}
- *
- * The stream is best-effort by the platform's own statement: a subscriber that
- * falls 256 frames behind is dropped. So `watch` reconnects, and every
- * reconnect is reported, which is the caller's cue to re-read the detail.
- */
 import { type Target } from './call.ts';
 export type Status = 'running' | 'paused' | 'done' | 'error' | 'stopped' | string;
 export interface Session {

package/lib/api/sessions.js

@@ -15,6 +15,7 @@
  * falls 256 frames behind is dropped. So `watch` reconnects, and every
  * reconnect is reported, which is the caller's cue to re-read the detail.
  */
+import { phrase } from '@hanzo/i18n';
 import { call, headers, query, Refusal, seg } from './call.js';
 import { read } from './sse.js';
 const str = (v) => (typeof v === 'string' ? v : '');
@@ -93,7 +94,7 @@ export async function get(t, id) {
 export async function message(t, id, text) {
     const m = text.trim();
     if (!m)
-        throw new Refusal(400, 'Say something to the run');
+        throw new Refusal(400, phrase('Say something to the run'));
     await call(t, 'POST', `/v1/agent/sessions/${seg(id)}/message`, { message: m });
 }
 export async function stop(t, id, why = 'Stopped from the builder') {
@@ -109,9 +110,9 @@ export async function resume(t, id) {
 export async function rename(t, id, title) {
     const name = title.trim();
     if (!name)
-        throw new Refusal(400, 'Give the run a name');
+        throw new Refusal(400, phrase('Give the run a name'));
     if (name.length > 512)
-        throw new Refusal(400, 'A run’s name is at most 512 characters');
+        throw new Refusal(400, phrase('A run’s name is at most 512 characters'));
     return session(await call(t, 'PATCH', `/v1/agent/sessions/${seg(id)}`, { title: name }));
 }
 /**
@@ -139,7 +140,7 @@ export async function watch(t, root, on, signal) {
                 signal,
             });
             if (res.status === 401 || res.status === 403)
-                throw new Refusal(res.status, 'This account cannot follow this run');
+                throw new Refusal(res.status, phrase('This account cannot follow this run'));
             if (!res.ok || !res.body)
                 throw new Error(`stream answered ${res.status}`);
             on.open?.(opened++);

package/lib/api/skills.d.ts

@@ -1,17 +1,3 @@
-/**
- * Skills: what an agent knows how to do, as a SKILL.md it reads.
- *
- *   GET    /v1/tool/skills?activated=true   {tools: [Tool]}  the org's skills that are on, brand and own
- *   GET    /v1/tool/skills/authored         {skills: [skill]} the org's own, with their SKILL.md
- *   POST   /v1/tool/skills                  {name, description, content} → 201 {skill}; the same name revises it
- *   DELETE /v1/tool/skills/{id}             {deleted}
- *   GET    /.well-known/agent-skills/index.json         the brand's catalogue, public
- *   GET    /.well-known/agent-skills/{name}/SKILL.md     one of its documents, public
- *
- * A skill is on when its tool name, `skill_<name>`, is activated (tools.ts):
- * that is how a catalogue skill is added to an org and how an org's own skill is
- * switched off. The brand's skill wins a name an org's own skill also takes.
- */
 import { type Target } from './call.ts';
 import { type Tool } from './tools.ts';
 /** An org's own skill. */
@@ -56,7 +42,7 @@ export declare function catalogue(raw: unknown): Catalogue;
 /** The org's skills that are on, brand and own. */
 export declare function active(t: Target): Promise<Tool[]>;
 export declare function authored(t: Target): Promise<Skill[]>;
-/** Why a skill cannot be written as it stands, or '' when it can. */
+/** Why a skill cannot be written as it stands, or '' when it can. English, marked (`phrase`): a screen says it through `t`. */
 export declare function refuse(s: {
     name: string;
     content: string;

package/lib/api/skills.js

@@ -12,6 +12,7 @@
  * that is how a catalogue skill is added to an org and how an org's own skill is
  * switched off. The brand's skill wins a name an org's own skill also takes.
  */
+import { phrase } from '@hanzo/i18n';
 import { call, reason, Refusal, seg } from './call.js';
 import { toolsOf } from './tools.js';
 /** A skill's name: one lowercase path segment, as the handler takes it. */
@@ -63,14 +64,14 @@ export async function active(t) {
 export async function authored(t) {
     return rows(obj(await call(t, 'GET', '/v1/tool/skills/authored')).skills).map(skill).filter((s) => s.name);
 }
-/** Why a skill cannot be written as it stands, or '' when it can. */
+/** Why a skill cannot be written as it stands, or '' when it can. English, marked (`phrase`): a screen says it through `t`. */
 export function refuse(s) {
     if (!NAME.test(s.name))
-        return 'A name is one lowercase word: letters, digits, _ or -';
+        return phrase('A name is one lowercase word: letters, digits, _ or -');
     if (!s.content.trim())
-        return 'A skill needs its SKILL.md';
+        return phrase('A skill needs its SKILL.md');
     if (new TextEncoder().encode(s.content).length > MAX)
-        return 'A SKILL.md is at most 256 KB';
+        return phrase('A SKILL.md is at most 256 KB');
     return '';
 }
 export async function write(t, s) {

package/lib/api/studio.d.ts

@@ -1,17 +1,3 @@
-/**
- * Hanzo Studio: a creation is a run of a template, its files kept in the Library.
- *
- *   GET  /v1/studio/templates           {data: [template]}  the public catalog, then the org's own
- *   POST /v1/studio/runs                {template, input, title?, parent?} → 201 run, queued
- *   GET  /v1/studio/runs/{id}           the run: status, text, outputs
- *   POST /v1/studio/runs/{id}/cancel    stop it; what it reserved is released
- *
- * A run is priced and its estimate reserved against the org's wallet before it
- * is queued (402 when the wallet cannot cover it). `parent` makes the run the
- * next version of that one. Its outputs are Library items: their `url` is
- * signed and expires, their `origin` is the app path that opens the run in
- * Studio and does not.
- */
 import { type Target } from './call.ts';
 import { type Item } from './library.ts';
 export interface Run {

package/lib/api/studio.js

@@ -12,7 +12,8 @@
  * signed and expires, their `origin` is the app path that opens the run in
  * Studio and does not.
  */
-import { call, Refusal, seg } from './call.js';
+import { phrase } from '@hanzo/i18n';
+import { call, Refusal, seg, Sentence } from './call.js';
 import { item } from './library.js';
 export function brandOf(raw) {
     const o = obj(raw);
@@ -65,10 +66,10 @@ const pause = (ms, signal) => new Promise((done, fail) => {
  */
 export async function make(t, s, signal) {
     let r = run(await call(t, 'POST', '/v1/studio/runs', s, { signal }).catch((e) => {
-        throw e instanceof Refusal && e.status === 402 ? new Error('Your balance does not cover it. Add credit in Settings › Billing.') : e;
+        throw e instanceof Refusal && e.status === 402 ? new Error(phrase('Your balance does not cover it. Add credit in Settings › Billing.')) : e;
     }));
     if (!r.id)
-        throw new Error('Studio started the run and named no id');
+        throw new Error(phrase('Studio started the run and named no id'));
     const id = r.id;
     const stop = () => void call(t, 'POST', `/v1/studio/runs/${seg(id)}/cancel`, {}).catch(() => undefined);
     signal?.addEventListener('abort', stop, { once: true });
@@ -76,7 +77,7 @@ export async function make(t, s, signal) {
         const until = Date.now() + LONGEST;
         while (!ended(r)) {
             if (Date.now() > until)
-                throw new Error('Studio is still making it. It will be in your Library when it is done.');
+                throw new Error(phrase('Studio is still making it. It will be in your Library when it is done.'));
             await pause(EVERY, signal);
             r = run(await call(t, 'GET', `/v1/studio/runs/${seg(id)}`, undefined, { signal }));
         }
@@ -85,6 +86,6 @@ export async function make(t, s, signal) {
         signal?.removeEventListener('abort', stop);
     }
     if (r.status !== 'succeeded')
-        throw new Error(r.error || `Studio could not make it (${r.status})`);
+        throw r.error ? new Error(r.error) : new Sentence(phrase('Studio could not make it ({status})'), { status: r.status });
     return r;
 }