@dlgt-io/cli 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DLGT AI, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,54 @@
-# Temporary Holding Version
+<p align="center">
+  <a href="https://dlgt.io"><img src="https://app.dlgt.io/brand/readme-banner@2x.png" alt="Delegate: give your agent superpowers" width="100%"></a>
+</p>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @dlgt-io/cli
+
+[![npm](https://img.shields.io/npm/v/@dlgt-io/cli)](https://www.npmjs.com/package/@dlgt-io/cli)
+[![license](https://img.shields.io/npm/l/@dlgt-io/cli)](https://github.com/Dlgt-io/dlgt/blob/main/LICENSE)
+
+The [Delegate](https://dlgt.io) marketplace in your terminal: find an AI service, hire it with a price cap, get the result. Readable for you, JSON for your coding agents.
+
+```bash
+npm i -g @dlgt-io/cli
+dlgt login
+```
+
+**New to Delegate?** [Sign up](https://app.dlgt.io/signup) first. `dlgt login` then shows where to create an API key (press Enter to open the page), and [app.dlgt.io/wallet](https://app.dlgt.io/wallet) is where you add funds.
+
+![dlgt search, hire and rate in a terminal](https://cdn.jsdelivr.net/gh/Dlgt-io/dlgt@v0.1.0/assets/cli-demo.svg)
+
+## Commands
+
+| Command | What it does |
+|---|---|
+| `dlgt login` | Saves your API key after checking it |
+| `dlgt search <query> [--limit N] [--budget USD]` | Find services. `--budget` ranks cheaper ones higher; it doesn't filter. |
+| `dlgt service <id or key>` | Input fields, offers and price |
+| `dlgt quote <service> --input <json>` | Exact price for this input; nothing is charged |
+| `dlgt hire <service> --input <json> --max-price USD [--wait]` | Order it; refuses when the price is above `--max-price` |
+| `dlgt result <id> [--wait] [--out DIR]` | State and result; `--out` saves the delivered files |
+| `dlgt rate <id> --quality 1-5 --value 1-5 [--note TEXT]` | Rate the work |
+| `dlgt balance` | Your prepaid balance |
+
+`--input @file.json` reads the input from a file. `quote` and `hire` also take `--offer <key>` and `--scope <json>`. `--wait` waits up to 10 minutes (`--timeout S` to change); Ctrl+C stops waiting, and the job keeps running.
+
+## For coding agents
+
+- When the output is piped, as in an agent's tool call, every command prints JSON. `--json` forces it in a terminal.
+- Errors go to stderr as JSON, with exit code 1.
+- `hire` always needs `--max-price`, and no command prompts.
+- To log in without a prompt, set `DELEGATE_API_KEY`, or pipe the key: `echo "$KEY" | dlgt login`.
+
+## Configuration
+
+`dlgt login` saves the key to `~/.config/dlgt/config.json`, readable only by you. `DELEGATE_API_KEY` and `DELEGATE_API_BASE_URL` override it.
+
+## More
+
+- TypeScript SDK: [`@dlgt-io/sdk`](https://www.npmjs.com/package/@dlgt-io/sdk)
+- Python SDK: [`dlgt-io`](https://pypi.org/project/dlgt-io/)
+- MCP server: [dlgt.io/docs](https://dlgt.io/docs)
+- Source and issues: [github.com/Dlgt-io/dlgt](https://github.com/Dlgt-io/dlgt)
+
+MIT license.

package/dist/cli.js

@@ -0,0 +1,448 @@
+#!/usr/bin/env node
+import { spawn } from "node:child_process";
+import { chmodSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, dirname, join } from "node:path";
+import { parseArgs } from "node:util";
+import { Delegate, DelegateError, VERSION } from "@dlgt-io/sdk";
+const CONFIG = join(homedir(), ".config", "dlgt", "config.json");
+const DEFAULT_BASE_URL = "https://app.dlgt.io/api";
+const HELP = `dlgt ${VERSION}: hire AI services on Delegate (https://dlgt.io)
+
+Usage
+  dlgt login                                   Save your API key
+  dlgt search <query> [--limit N] [--budget USD]
+  dlgt service <service>                       Input, offers, price (id or key)
+  dlgt quote <service> --input <json|@file>    Exact price; nothing is charged
+  dlgt hire <service> --input <json|@file> --max-price USD [--wait] [--timeout S]
+  dlgt result <id> [--wait] [--timeout S] [--out DIR]
+  dlgt rate <id> --quality 1-5 --value 1-5 [--note TEXT]
+  dlgt balance
+
+quote and hire also take --offer <key> and --scope <json>. Search's --budget
+ranks cheaper services higher; it doesn't filter. hire --max-price is a hard cap.
+
+Readable output in a terminal; JSON when piped or with --json.
+
+Get started: sign up at https://app.dlgt.io/signup, create an API key at
+https://app.dlgt.io/keys, then run dlgt login (or set DELEGATE_API_KEY).`;
+function args() {
+    return parseArgs({
+        allowPositionals: true,
+        options: {
+            limit: { type: "string" },
+            "max-price": { type: "string" },
+            budget: { type: "string" },
+            input: { type: "string" },
+            offer: { type: "string" },
+            scope: { type: "string" },
+            wait: { type: "boolean" },
+            timeout: { type: "string" },
+            out: { type: "string" },
+            quality: { type: "string" },
+            value: { type: "string" },
+            note: { type: "string" },
+            model: { type: "string" },
+            json: { type: "boolean" },
+            help: { type: "boolean", short: "h" },
+            version: { type: "boolean", short: "v" },
+        },
+    });
+}
+const color = Boolean(process.stdout.isTTY) && !process.env.NO_COLOR;
+const paint = (code) => (text) => (color ? `\x1b[${code}m${text}\x1b[0m` : text);
+const bold = paint(1);
+const dim = paint(2);
+const green = paint(32);
+const yellow = paint(33);
+const red = paint(31);
+async function main() {
+    const { values: v, positionals } = args();
+    const [command, arg] = positionals;
+    // People get readable text; agents and pipes get JSON.
+    const human = Boolean(process.stdout.isTTY) && !v.json;
+    const show = (data, text) => console.log(human ? text(data) : JSON.stringify(data, null, 2));
+    if (v.version)
+        return show({ version: VERSION }, () => `dlgt ${VERSION}`);
+    if (!command || v.help)
+        return console.log(HELP);
+    if (command === "login")
+        return login(human);
+    const { dlgt, site, env } = client();
+    const waitNote = (id) => human && process.stderr.write(dim(`  Waiting for ${id}. Ctrl+C stops waiting; the job keeps running.\n`));
+    switch (command) {
+        case "search": {
+            const found = await dlgt.search(need(arg, "<query>"), { limit: number(v.limit), budgetUsd: number(v.budget) });
+            return show(found, renderSearch);
+        }
+        case "service": {
+            const service = await dlgt.service(need(arg, "<service>"));
+            return show(service, renderService);
+        }
+        case "quote": {
+            const service = need(arg, "<service>");
+            const { raw, ...quote } = await dlgt.quote(service, orderOptions(v));
+            return show(quote, (q) => renderQuote(q, service, v.input));
+        }
+        case "hire": {
+            const maxPriceUsd = number(v["max-price"]);
+            if (maxPriceUsd === undefined) {
+                throw new DelegateError("--max-price is required. See the price first with: dlgt quote", 0, "usage");
+            }
+            const hire = await dlgt.hire(need(arg, "<service>"), { ...orderOptions(v), maxPriceUsd });
+            if (!v.wait || !hire.id)
+                return show(hire, (h) => renderHire(h));
+            if (human)
+                console.log(renderHire(hire, true));
+            waitNote(hire.id);
+            const view = brief(await dlgt.result(hire.id, { timeout: timeout(v) }));
+            return show({ ...hire, ...view }, () => renderResult(view, site));
+        }
+        case "result": {
+            const id = need(arg, "<id>");
+            if (v.wait)
+                waitNote(id);
+            const view = brief(await dlgt.result(id, { timeout: v.wait ? timeout(v) : 0 }));
+            if (v.out && view.result)
+                view.saved = await saveFiles(dlgt, view.result, v.out);
+            return show(view, (r) => renderResult(r, site));
+        }
+        case "rate": {
+            const review = await dlgt.rate(need(arg, "<id>"), {
+                quality: number(need(v.quality, "--quality")),
+                value: number(need(v.value, "--value")),
+                note: v.note,
+                model: v.model ?? "dlgt-cli",
+            });
+            return show(review, renderRate);
+        }
+        case "balance": {
+            const balance = await dlgt.balance();
+            return show({ balance_usd: balance.balance_micros / 1e6, ...balance }, (b) => renderBalance(b, env, site));
+        }
+        default:
+            throw new DelegateError(`Unknown command "${command}". Run dlgt --help`, 0, "usage");
+    }
+}
+// ---- readable output ----
+function renderSearch(found) {
+    const results = found.results ?? [];
+    if (!results.length)
+        return "\n  No services matched. Try describing the task differently.\n";
+    const width = Math.max(24, Math.min(56, (process.stdout.columns ?? 120) - 66));
+    const header = dim(`   #  ${"Service".padEnd(width)}  ${"Price".padEnd(9)}  ${"Rating".padEnd(11)}  Id`);
+    const rows = results.map((r, i) => [
+        `${i + 1}`.padStart(4),
+        clip(r.title ?? "", width).padEnd(width),
+        (r.price_estimate?.price_display ?? "?").padEnd(9),
+        stars(r.quality?.average_rating_hundredths, r.quality?.rating_count).padEnd(11),
+        dim(r.service_id),
+    ].join("  "));
+    return `\n${header}\n${rows.join("\n")}\n\n  ${dim("Details: dlgt service <id>")}\n`;
+}
+function renderService(s) {
+    const lines = [
+        "",
+        `  ${bold(s.title)}`,
+        `  ${[s.service_key, s.price_estimate?.price_display, stars(s.quality_average_rating, s.quality_rating_count)]
+            .filter(Boolean)
+            .join(" · ")}`,
+    ];
+    if (s.description)
+        lines.push("", ...wrap(s.description, 76).map((line) => `  ${line}`));
+    const properties = s.input_schema?.properties ?? {};
+    const required = s.input_schema?.required ?? [];
+    const names = Object.keys(properties);
+    if (names.length) {
+        const nameWidth = Math.max(...names.map((name) => name.length));
+        lines.push("", `  ${bold("Input")}`);
+        for (const name of names) {
+            const p = properties[name];
+            const kind = p.enum ? p.enum.join(" | ") : (p.type ?? "any");
+            const note = required.includes(name) ? "required" : p.default !== undefined ? `default ${JSON.stringify(p.default)}` : "optional";
+            lines.push(`    ${name.padEnd(nameWidth)}  ${clip(`${kind}, ${note}`, 28).padEnd(28)}  ${dim(clip(p.description ?? "", 60))}`);
+        }
+    }
+    const offers = (s.offer_versions ?? []).filter((o) => o.state === "active");
+    if (offers.length > 1) {
+        lines.push("", `  ${bold("Offers")} ${dim("(pick one with --offer)")}`);
+        for (const o of offers)
+            lines.push(`    ${o.definition.offer_key}  ${dim(o.definition.title ?? "")}`);
+    }
+    const example = (required.length ? required : names.slice(0, 1)).map((name) => `"${name}": ...`).join(", ");
+    lines.push("", `  ${dim(`Price for your input: dlgt quote ${s.service_key ?? s.id} --input '{${example}}'`)}`, "");
+    return lines.join("\n");
+}
+function renderQuote(q, service, input = "{}") {
+    const capped = q.funding?.kind === "buyer_cap";
+    const price = usd(q.priceUsd);
+    const terms = capped
+        ? `estimate, billed by usage (cap between ${usd(q.funding.minimum_cap_micros / 1e6)} and ${usd(q.funding.maximum_cap_micros / 1e6)})`
+        : "fixed price";
+    const maxPrice = Math.ceil(q.priceUsd * 100) / 100;
+    return [
+        "",
+        `  ${bold(price)}  ${dim(`${terms} · offer ${q.offerKey}`)}`,
+        `  ${dim(`Valid until ${new Date(q.expiresAt).toLocaleTimeString()}`)}`,
+        "",
+        `  ${dim(`Hire it: dlgt hire ${service} --input '${input}' --max-price ${maxPrice} --wait`)}`,
+        "",
+    ].join("\n");
+}
+function renderHire(h, waiting = false) {
+    if (h.status === "awaiting_approval") {
+        return `\n  ${yellow("!")} Order ${h.orderId} is waiting for approval: its price is above your approval threshold.\n`;
+    }
+    const line = `\n  ${green("✓")} Hired for ${usd(h.priceUsd)} · id ${h.id}`;
+    return waiting ? line : `${line}\n\n  ${dim(`Result: dlgt result ${h.id} --wait`)}\n`;
+}
+function renderResult(r, site) {
+    const page = `${site}/activity/${r.id}`;
+    if (r.state === "running")
+        return `\n  ${yellow("…")} Still running.\n\n  ${dim(`Wait for it: dlgt result ${r.id} --wait`)}\n`;
+    if (r.state === "failed")
+        return `\n  ${red("✗")} Failed: ${r.error}\n\n  ${dim(`Details: ${page}`)}\n`;
+    if (r.state === "needs_input") {
+        const questions = r.questions.map((q) => `    ${q.prompt ?? "(no text)"}${q.choices?.length ? dim(`  [${q.choices.join(" / ")}]`) : ""}`);
+        return `\n  ${yellow("?")} The provider has a question:\n${questions.join("\n")}\n\n  Answer it at ${page}\n`;
+    }
+    const lines = ["", `  ${green("✓")} Delivered`, ""];
+    if (r.result?.content)
+        lines.push(...String(r.result.content).split("\n").map((line) => `  ${line}`), "");
+    const artifacts = r.result?.artifacts;
+    if (artifacts && Object.keys(artifacts).length) {
+        const data = outline(artifacts);
+        lines.push(...data.slice(0, 40).map((line) => `  ${dim(line)}`));
+        if (data.length > 40)
+            lines.push(`  ${dim(`… ${data.length - 40} more lines: dlgt result ${r.id} --json`)}`);
+        lines.push("");
+    }
+    for (const path of r.saved ?? [])
+        lines.push(`  ${green("✓")} Saved ${path}`);
+    lines.push(`  ${dim(`Rate it: dlgt rate ${r.id} --quality 1-5 --value 1-5`)}`, "");
+    return lines.join("\n");
+}
+function renderRate(review) {
+    if (review.status === "nothing_pending")
+        return "\n  Nothing to rate: this job is already rated or isn't finished yet.\n";
+    return `\n  ${green("✓")} Rating saved: quality ${review.quality_rating}/5, value ${review.value_rating}/5. Thanks!\n`;
+}
+function renderBalance(b, env, site) {
+    const note = env === "production" ? "" : dim(` (${env}${b.card_test_mode ? ", test cards" : ""})`);
+    return `\n  Balance: ${bold(`$${b.balance_usd.toFixed(2)}`)}${note}\n\n  ${dim(`Top up: ${site}/wallet`)}\n`;
+}
+/** Money with two decimals, or up to four for sub-cent prices: $0.00, $0.30, $0.0594. */
+function usd(amount) {
+    return `$${amount.toFixed(4).replace(/(\.\d\d\d?)0+$/, "$1")}`;
+}
+/** Indented key: value lines for structured results; empty fields are skipped. */
+function outline(value, indent = "") {
+    if (Array.isArray(value)) {
+        return value.flatMap((item) => {
+            if (item === null || typeof item !== "object")
+                return [`${indent}- ${item}`];
+            const [first = "", ...rest] = outline(item, `${indent}  `);
+            return [`${indent}- ${first.trimStart()}`, ...rest];
+        });
+    }
+    if (value === null || typeof value !== "object")
+        return [`${indent}${value}`];
+    return Object.entries(value).flatMap(([key, item]) => {
+        if (item === null || item === undefined || item === "" || (typeof item === "object" && !Object.keys(item).length))
+            return [];
+        if (typeof item === "object")
+            return [`${indent}${key}:`, ...outline(item, `${indent}  `)];
+        return [`${indent}${key}: ${String(item).replace(/\s*\n\s*/g, " ")}`];
+    });
+}
+function stars(hundredths, count) {
+    return count && hundredths ? `★ ${(hundredths / 100).toFixed(1)} (${count})` : "new";
+}
+function clip(text, width) {
+    return text.length > width ? `${text.slice(0, width - 1)}…` : text;
+}
+function wrap(text, width) {
+    const lines = [];
+    let line = "";
+    for (const word of text.split(/\s+/)) {
+        if (line && line.length + word.length + 1 > width) {
+            lines.push(line);
+            line = word;
+        }
+        else {
+            line = line ? `${line} ${word}` : word;
+        }
+    }
+    return line ? [...lines, line] : lines;
+}
+// ---- auth and config ----
+function client() {
+    const config = readConfig();
+    const apiKey = process.env.DELEGATE_API_KEY || config.api_key;
+    if (!apiKey) {
+        throw new DelegateError("No API key: run dlgt login or set DELEGATE_API_KEY. Create a key at https://app.dlgt.io/keys", 0, "missing_api_key");
+    }
+    const baseUrl = process.env.DELEGATE_API_BASE_URL || config.base_url || DEFAULT_BASE_URL;
+    return { dlgt: new Delegate({ apiKey, baseUrl }), ...where(baseUrl) };
+}
+/** The app's address and a readable environment name for an API base URL. */
+function where(baseUrl) {
+    const site = baseUrl.replace(/\/api\/?$/, "");
+    const host = new URL(site).host;
+    return { site, host, env: host === "app.dlgt.io" ? "production" : host === "dev.dlgt.io" ? "staging" : host };
+}
+function readConfig() {
+    try {
+        return JSON.parse(readFileSync(CONFIG, "utf8"));
+    }
+    catch {
+        return {};
+    }
+}
+async function login(human) {
+    const baseUrl = process.env.DELEGATE_API_BASE_URL || undefined;
+    const { site, host, env } = where(baseUrl ?? DEFAULT_BASE_URL);
+    const keysUrl = `${site}/keys`;
+    if (process.stdin.isTTY && process.stderr.isTTY) {
+        process.stderr.write(`\n  Log in to Delegate (${env})\n\n` +
+            `  1. Create an API key at ${keysUrl}\n` +
+            `  2. Paste it below. Each character shows as •\n\n`);
+    }
+    const apiKey = (await readKey(`  API key (Enter opens ${host}/keys): `, () => {
+        openBrowser(keysUrl);
+        process.stderr.write(`\n  Opened ${keysUrl}. Paste the key here: `);
+    })).trim();
+    if (!apiKey.startsWith("dlg_")) {
+        throw new DelegateError(`That isn't a Delegate API key (they start with dlg_). Create one at ${keysUrl}`, 0, "usage");
+    }
+    let balance;
+    try {
+        balance = await new Delegate({ apiKey, baseUrl }).balance(); // proves the key works before saving it
+    }
+    catch (error) {
+        if (error instanceof DelegateError && error.status === 401) {
+            throw new DelegateError(`${env} rejected that key. Keys only work where they were created: ${keysUrl}`, 401, "invalid_key");
+        }
+        throw error;
+    }
+    mkdirSync(dirname(CONFIG), { recursive: true, mode: 0o700 });
+    writeFileSync(CONFIG, JSON.stringify({ api_key: apiKey, ...(baseUrl ? { base_url: baseUrl } : {}) }, null, 2) + "\n");
+    chmodSync(CONFIG, 0o600);
+    const balanceUsd = balance.balance_micros / 1e6;
+    if (!human)
+        return console.log(JSON.stringify({ logged_in: env, balance_usd: balanceUsd, saved: CONFIG }, null, 2));
+    console.log(`\n  ${green("✓")} Logged in to ${env}. Balance: $${balanceUsd.toFixed(2)}\n` +
+        `  ${green("✓")} Key saved to ${CONFIG.replace(homedir(), "~")}\n\n` +
+        `  ${dim('Next: dlgt search "what you need done"')}\n`);
+}
+/**
+ * Reads the key with a • per character, so a paste visibly lands. Enter on an
+ * empty line calls onEmptyEnter (opens the keys page). Piped input
+ * (echo "$KEY" | dlgt login) is read as-is.
+ */
+function readKey(prompt, onEmptyEnter) {
+    const stdin = process.stdin;
+    if (!stdin.isTTY) {
+        return new Promise((resolve) => {
+            let data = "";
+            stdin.on("data", (chunk) => (data += chunk)).on("end", () => resolve(data));
+        });
+    }
+    process.stderr.write(prompt);
+    return new Promise((resolve) => {
+        let key = "";
+        const finish = () => {
+            stdin.setRawMode(false);
+            stdin.pause();
+            stdin.off("data", onData);
+            process.stderr.write("\n");
+        };
+        const onData = (chunk) => {
+            for (const ch of chunk.replace(/\u001b\[[\d;?]*[~A-Za-z]/g, "")) {
+                if (ch === "\u0003" || ch === "\u0004") {
+                    finish();
+                    process.exit(130);
+                }
+                else if (ch === "\r" || ch === "\n") {
+                    if (key) {
+                        finish();
+                        return resolve(key);
+                    }
+                    onEmptyEnter();
+                }
+                else if (ch === "\u007f" || ch === "\b") {
+                    if (key) {
+                        key = key.slice(0, -1);
+                        process.stderr.write("\b \b");
+                    }
+                }
+                else if (ch >= " ") {
+                    key += ch;
+                    process.stderr.write("•");
+                }
+            }
+        };
+        stdin.setRawMode(true);
+        stdin.setEncoding("utf8");
+        stdin.on("data", onData);
+        stdin.resume();
+    });
+}
+function openBrowser(url) {
+    const [command, args] = process.platform === "darwin"
+        ? ["open", [url]]
+        : process.platform === "win32"
+            ? ["cmd", ["/c", "start", "", url]]
+            : ["xdg-open", [url]];
+    spawn(command, args, { stdio: "ignore", detached: true }).on("error", () => { }).unref();
+}
+// ---- helpers ----
+/** Saves every delegate-file:// the result references into dir. */
+async function saveFiles(dlgt, result, dir) {
+    const uris = [...new Set(JSON.stringify(result).match(/delegate-file:\/\/[\w-]+/g) ?? [])];
+    mkdirSync(dir, { recursive: true });
+    const saved = [];
+    for (const uri of uris) {
+        const file = await dlgt.download(uri);
+        const path = join(dir, basename(file.filename));
+        writeFileSync(path, file.data);
+        saved.push(path);
+    }
+    return saved;
+}
+function brief(view) {
+    const { raw, ...rest } = view;
+    return rest;
+}
+function orderOptions(v) {
+    return { input: jsonArg(v.input), offer: v.offer, scope: jsonArg(v.scope) };
+}
+function jsonArg(value) {
+    if (value === undefined)
+        return undefined;
+    return JSON.parse(value.startsWith("@") ? readFileSync(value.slice(1), "utf8") : value);
+}
+function timeout(v) {
+    return number(v.timeout) ?? 600;
+}
+function need(value, name) {
+    if (!value)
+        throw new DelegateError(`Missing ${name}. Run dlgt --help`, 0, "usage");
+    return value;
+}
+function number(value) {
+    if (value === undefined)
+        return undefined;
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed))
+        throw new DelegateError(`Not a number: ${value}`, 0, "usage");
+    return parsed;
+}
+main().catch((error) => {
+    const detail = error instanceof DelegateError
+        ? { message: error.message, code: error.code, status: error.status || undefined }
+        : { message: String(error?.message ?? error) };
+    // People get a sentence; agents and pipes get JSON.
+    console.error(process.stderr.isTTY ? `\n  ✗ ${detail.message}\n` : JSON.stringify({ error: detail }, null, 2));
+    process.exitCode = 1;
+});

package/package.json

@@ -1,6 +1,35 @@
 {
   "name": "@dlgt-io/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "The dlgt command: hire AI services on Delegate from your terminal.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "dlgt": "dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p ."
+  },
+  "dependencies": {
+    "@dlgt-io/sdk": "0.1.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Dlgt-io/dlgt.git",
+    "directory": "ts/cli"
+  },
+  "homepage": "https://dlgt.io",
+  "keywords": [
+    "delegate",
+    "dlgt",
+    "cli",
+    "ai-agents",
+    "agent-marketplace"
+  ]
+}