@stellar-agent-services/provider-kit 0.0.0-stage → 0.1.0

package/dist/cli/check.js

@@ -0,0 +1,137 @@
+// provider-kit check: a provider's self-check against Provider Standard v1, with no payment and no key.
+//
+//   manifest      the JSON Schema and the rules of §2.4 (what clients and verifiers reject)
+//   facilitator   settles x402 `exact` on the network, with sponsored fees (gateway configs)
+//   payTo         the account exists and has a USDC trustline [P2]
+//   8004          the registration names the manifest, the agent and payTo match [I1]–[I3]
+// Then how agents see the provider (discovery.ts): what search matches, and hints that never fail the check.
+// --fix writes the words search would miss into a gateway config's provider.description. --json prints the result
+// as JSON, for scripts and coding agents. `verifier check` goes further, calling create-job without paying (C3, C6, C7).
+import { readFile, rename, writeFile } from "node:fs/promises";
+import { HORIZON_URL, USDC_ISSUER } from "@stellar-agent-services/protocol";
+import { checkFacilitator } from "../payments/facilitator.js";
+import { inspectRegistration } from "../registration.js";
+import { describedWithServices, howAgentsSeeYou } from "./discovery.js";
+import { nextCommand, UsageError } from "./shared.js";
+import { loadTarget } from "./target.js";
+const MARK = { ok: "✓", fail: "✗", warn: "!" };
+export async function check(flags) {
+    if (flags.fix && flags.config === undefined)
+        throw new UsageError("--fix edits a gateway config: pass --config <file>");
+    const target = await loadTarget(flags);
+    const say = flags.json ? () => { } : (line) => console.log(line);
+    say(`Provider Standard v1 self-check: ${target.source}`);
+    if ("problems" in target) {
+        const lines = target.problems.map((problem) => ({ status: "fail", text: problem }));
+        if (flags.json)
+            console.log(JSON.stringify({ ok: false, source: target.source, checks: lines }, null, 2));
+        else
+            lines.forEach(print);
+        return 1;
+    }
+    const { manifest, manifestUrl } = target;
+    const network = manifest.payment.accepts[0].network;
+    const lines = [
+        { status: "ok", text: `manifest: ${manifest.services.length} service(s) on ${network}, served at ${manifestUrl}` },
+    ];
+    if (manifest.baseUrl.startsWith("http://"))
+        lines.push({ status: "warn", text: "dev mode: clients accept http:// only in development [M6]" });
+    if (target.facilitator !== undefined) {
+        lines.push(await attempt("facilitator", async () => {
+            await checkFacilitator(target.facilitator, network);
+            return `settles x402 exact on ${network} with sponsored fees`;
+        }));
+    }
+    lines.push(await attempt("payTo", () => checkPayTo(manifest)));
+    let registered;
+    if (manifest.provider.agentId === undefined && manifest.baseUrl.startsWith("http://")) {
+        // A provider on this computer isn't registered yet: launch registers it with its public address.
+        lines.push({ status: "warn", text: `8004: not registered yet: ${nextCommand("launch")} registers it, with your public address` });
+    }
+    else {
+        try {
+            const registration = await inspectRegistration(manifest, manifestUrl);
+            registered = registration.file;
+            for (const finding of registration.findings) {
+                lines.push({ status: finding.ok ? "ok" : "fail", text: `8004 [${finding.rule}]: ${finding.message}` });
+            }
+        }
+        catch (error) {
+            lines.push({ status: "fail", text: `8004: the identity registry can't be read: ${error.message}` });
+        }
+    }
+    const agents = howAgentsSeeYou(manifest, registered);
+    const suggested = describedWithServices(manifest);
+    let fixed;
+    if (flags.fix && suggested !== undefined) {
+        await writeDescription(flags.config, suggested);
+        fixed = suggested;
+    }
+    const failed = lines.filter((line) => line.status === "fail").length;
+    if (flags.json) {
+        console.log(JSON.stringify({
+            ok: failed === 0,
+            source: target.source,
+            manifestUrl,
+            checks: lines,
+            howAgentsSeeYou: agents,
+            ...(suggested === undefined ? {} : { suggestedDescription: suggested }),
+            ...(fixed === undefined ? {} : { fixed: { file: flags.config, description: fixed } }),
+        }, null, 2));
+        return failed === 0 ? 0 : 1;
+    }
+    lines.forEach(print);
+    console.log(`\n${agents.join("\n")}\n`);
+    if (fixed !== undefined) {
+        console.log(`✓ Wrote provider.description in ${flags.config}, so search finds your services' words:\n    ${fixed}`);
+        console.log(`  Restart the provider to serve it${registered === undefined ? "" : `, and run ${nextCommand("launch")} to update the registration search reads`}.\n`);
+    }
+    else if (suggested !== undefined) {
+        console.log(flags.config === undefined
+            ? `Put this in provider.description, so search finds your services' words:\n    ${suggested}\n`
+            : `Run check again with --fix to write the missing words into provider.description${nextCommand("check") === "npm run check" ? " (npm run check -- --fix)" : ""}.\n`);
+    }
+    console.log(failed === 0 ? "All checks passed." : `${failed} check(s) failed.`);
+    return failed === 0 ? 0 : 1;
+}
+/** Sets provider.description in a gateway config, keeping the rest of the file as it was. */
+async function writeDescription(path, description) {
+    const text = await readFile(path, "utf8");
+    const config = JSON.parse(text);
+    if (typeof config.provider !== "object" || config.provider === null)
+        throw new Error(`${path} has no "provider" object`);
+    config.provider["description"] = description;
+    const indent = /^[ \t]+(?=")/m.exec(text)?.[0] ?? 2;
+    const temporary = `${path}.${process.pid}.tmp`;
+    await writeFile(temporary, `${JSON.stringify(config, null, indent)}\n`);
+    await rename(temporary, path);
+}
+async function checkPayTo(manifest) {
+    const { network, payTo } = manifest.payment.accepts[0];
+    // A contract holds SAC balances without a trustline.
+    if (payTo.startsWith("C"))
+        return `${payTo} is a contract: no trustline needed`;
+    const response = await fetch(`${HORIZON_URL[network]}/accounts/${payTo}`, { signal: AbortSignal.timeout(15_000) });
+    if (response.status === 404) {
+        throw new Error(`${payTo} does not exist on ${network}: ${network === "stellar:testnet" ? "provider-kit dev makes a throwaway testnet account, and launch sets up your own" : "send it some XLM first"}`);
+    }
+    if (!response.ok)
+        throw new Error(`Horizon answered ${response.status}`);
+    const account = (await response.json());
+    const trusted = account.balances.some((balance) => balance.asset_code === "USDC" && balance.asset_issuer === USDC_ISSUER[network]);
+    if (!trusted)
+        throw new Error(`${payTo} has no USDC trustline, so it can't be paid [P2]: add one with provider-kit trustline`);
+    return `${payTo} exists and has a USDC trustline`;
+}
+async function attempt(label, run) {
+    try {
+        return { status: "ok", text: `${label}: ${await run()}` };
+    }
+    catch (error) {
+        return { status: "fail", text: `${label}: ${error.message}` };
+    }
+}
+function print(line) {
+    console.log(`  ${MARK[line.status]} ${line.text}`);
+}
+//# sourceMappingURL=check.js.map

package/dist/cli/check.js.map

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

package/dist/cli/dev-account.d.ts

@@ -0,0 +1,28 @@
+import { type StellarNetwork } from "@stellar-agent-services/protocol";
+import { Keypair } from "@stellar/stellar-sdk";
+import { type OwnerChain } from "./owner-chain.js";
+/** The .env variable that holds the throwaway account's address, so `launch` knows PAY_TO isn't the developer's own. */
+export declare const DEV_PAY_TO = "DEV_PAY_TO";
+/** What PAY_TO is: unset, a throwaway account made by `provider-kit dev`, or an account the developer holds. */
+export type PayToKind = "unset" | "throwaway" | "yours";
+export declare function payToKind(env: NodeJS.ProcessEnv): PayToKind;
+/** Makes a throwaway testnet account that can receive USDC, and returns its address. The key is gone when this returns. */
+export declare function throwawayPayTo(chain: OwnerChain, keypair?: Keypair): Promise<string>;
+export interface DevPayTo {
+    payTo: string;
+    kind: Exclude<PayToKind, "unset">;
+    /** Whether it was made just now. */
+    made: boolean;
+}
+/**
+ * PAY_TO for a provider in development: the one set, else a throwaway testnet account made now. A new one goes in
+ * `env` and in the env file at `envFile`, when that exists, so the next run uses it again.
+ */
+export declare function devPayTo(options: {
+    env: NodeJS.ProcessEnv;
+    network: StellarNetwork;
+    chain: () => OwnerChain;
+    envFile?: string;
+    log?: (line: string) => void;
+}): Promise<DevPayTo>;
+//# sourceMappingURL=dev-account.d.ts.map

package/dist/cli/dev-account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-account.d.ts","sourceRoot":"","sources":["../../src/cli/dev-account.ts"],"names":[],"mappings":"AASA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAC3F,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEhE,wHAAwH;AACxH,eAAO,MAAM,UAAU,eAAe,CAAC;AAEvC,gHAAgH;AAChH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,CAAC;AAExD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,CAI3D;AAED,2HAA2H;AAC3H,wBAAsB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,OAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAU5G;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAClC,oCAAoC;IACpC,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE;IACtC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,MAAM,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC,QAAQ,CAAC,CAyBpB"}

package/dist/cli/dev-account.js

@@ -0,0 +1,62 @@
+// The payout account during development. `provider-kit dev` (and `try`, when it starts the provider itself) make a
+// throwaway one when PAY_TO is empty, so the first paid call needs no wallet (docs/provider-setup-guide.md §2).
+//
+// A new key, in memory only, gets test XLM from Friendbot and signs one transaction: the USDC trustline [P2]. Then the
+// key is dropped. It is never written to a file or the environment, and the provider never sees it: the provider
+// knows only the public address, as for any payTo (AGENTS.md §4, rule 1). What the account receives is test money
+// that nobody can spend. Testnet only. `provider-kit launch` replaces it with an account in the developer's own wallet,
+// which is how DEV_PAY_TO, the throwaway's public address kept next to PAY_TO in .env, tells the two apart.
+import { stellarAddressKind } from "@stellar-agent-services/protocol";
+import { Keypair } from "@stellar/stellar-sdk";
+import { updateEnvFile } from "./env-file.js";
+import { networkName } from "./owner-chain.js";
+/** The .env variable that holds the throwaway account's address, so `launch` knows PAY_TO isn't the developer's own. */
+export const DEV_PAY_TO = "DEV_PAY_TO";
+export function payToKind(env) {
+    const payTo = env["PAY_TO"];
+    if (payTo === undefined || payTo === "")
+        return "unset";
+    return payTo === env[DEV_PAY_TO] ? "throwaway" : "yours";
+}
+/** Makes a throwaway testnet account that can receive USDC, and returns its address. The key is gone when this returns. */
+export async function throwawayPayTo(chain, keypair = Keypair.random()) {
+    if (chain.network !== "stellar:testnet")
+        throw new Error(`a throwaway payout account is for testnet only, not ${networkName(chain.network)}`);
+    const address = keypair.publicKey();
+    await chain.fund(address);
+    const transaction = await chain.trustline(address);
+    transaction.sign(keypair);
+    const sent = await chain.send(transaction);
+    if (sent.status === "failed")
+        throw new Error(`the throwaway account's USDC trustline failed: ${sent.reason}`);
+    if (sent.status === "unknown")
+        throw new Error(`the throwaway account's USDC trustline may not have gone through: ${sent.reason}`);
+    return address;
+}
+/**
+ * PAY_TO for a provider in development: the one set, else a throwaway testnet account made now. A new one goes in
+ * `env` and in the env file at `envFile`, when that exists, so the next run uses it again.
+ */
+export async function devPayTo(options) {
+    const { env, network } = options;
+    const log = options.log ?? (() => { });
+    const kind = payToKind(env);
+    if (kind !== "unset") {
+        const payTo = env["PAY_TO"];
+        if (stellarAddressKind(payTo) === undefined)
+            throw new Error(`PAY_TO is not a Stellar address: ${payTo}`);
+        return { payTo, kind, made: false };
+    }
+    if (network !== "stellar:testnet") {
+        throw new Error(`PAY_TO is empty. On ${networkName(network)} it must be an account in your own wallet: provider-kit launch sets it up`);
+    }
+    log("  … PAY_TO is empty: making a throwaway testnet account to receive test payments");
+    const payTo = await throwawayPayTo(options.chain());
+    env["PAY_TO"] = payTo;
+    env[DEV_PAY_TO] = payTo;
+    const saved = options.envFile !== undefined &&
+        (await updateEnvFile(options.envFile, { PAY_TO: payTo, [DEV_PAY_TO]: payTo }, { comments: { [DEV_PAY_TO]: "A throwaway testnet account provider-kit dev made, so test payments work before you connect a wallet.\nNobody holds its key, so nobody can spend what it receives. provider-kit launch replaces it with your own." } }));
+    log(`  ✓ PAY_TO=${payTo}, a throwaway testnet account${saved ? ` (saved in ${options.envFile})` : ""}`);
+    return { payTo, kind: "throwaway", made: true };
+}
+//# sourceMappingURL=dev-account.js.map

package/dist/cli/dev-account.js.map

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

package/dist/cli/dev.d.ts

@@ -0,0 +1,27 @@
+import type { StellarNetwork } from "@stellar-agent-services/protocol";
+import { type OwnerChain } from "./owner-chain.js";
+import { type Started } from "./processes.js";
+import { serveGateway } from "./serve.js";
+import { type CliFlags } from "./shared.js";
+import { type Tunnel } from "./tunnel.js";
+/** Where `dev` reaches the outside world. Tests replace it. */
+export interface DevIo {
+    log(line: string): void;
+    chain(network: StellarNetwork): OwnerChain;
+    tunnel(port: number): Promise<Tunnel>;
+    serve: typeof serveGateway;
+    /** Runs the provider's own command, or the --with command, in this terminal. */
+    start(command: string, args: string[], options: {
+        env: NodeJS.ProcessEnv;
+        shell: boolean;
+    }): Started;
+    /** Keeps running until a signal, then runs `stop`: the gateway's way to end. */
+    untilStopped(stop: () => Promise<void>): void;
+    /** Resolves once something takes connections at host:port. Rejects when `exited` resolves first, or after `timeoutMs`. */
+    waitForPort(host: string, port: number, exited: Promise<number>, timeoutMs: number): Promise<void>;
+    env: NodeJS.ProcessEnv;
+}
+export declare function devIo(): DevIo;
+/** provider-kit dev [-- <command> ...]: -1 while a gateway runs, else the command's exit code. */
+export declare function dev(flags: CliFlags, command: string[], io?: DevIo): Promise<number>;
+//# sourceMappingURL=dev.d.ts.map

package/dist/cli/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/cli/dev.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAIvE,OAAO,EAA4C,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC7F,OAAO,EAAiC,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAiB,MAAM,YAAY,CAAC;AACzD,OAAO,EAA2C,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAe,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAEvD,+DAA+D;AAC/D,MAAM,WAAW,KAAK;IACpB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,OAAO,EAAE,cAAc,GAAG,UAAU,CAAC;IAC3C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,KAAK,EAAE,OAAO,YAAY,CAAC;IAC3B,gFAAgF;IAChF,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC;IACrG,gFAAgF;IAChF,YAAY,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9C,0HAA0H;IAC1H,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnG,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;CACxB;AAED,wBAAgB,KAAK,IAAI,KAAK,CAY7B;AA2BD,kGAAkG;AAClG,wBAAsB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,GAAE,KAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BlG"}

package/dist/cli/dev.js

@@ -0,0 +1,226 @@
+// provider-kit dev: runs a provider on this computer, on testnet with nothing to set up first
+// (docs/provider-setup-guide.md §2). On mainnet it runs too, paid to the PAY_TO set: there is no throwaway account there.
+//
+//   provider-kit dev [--config <file>] [--port <n>] [--with '<command>'] [--tunnel]   a gateway, in this process
+//   provider-kit dev [--port <n>] [--tunnel] -- <command> [args...]                   any other provider, by its command
+//
+// 1. Reads .env (or --env-file), as `node --env-file` does: a variable already set wins.
+// 2. PAY_TO: the one set, else a throwaway testnet account made now (dev-account.ts), so test payments work before any
+//    wallet is connected. The provider only ever sees the public address.
+// 3. Runs the provider: the gateway from --config (default ./provider.config.json) in dev mode, or the command after
+//    `--` with PAY_TO in its environment. --with runs the API the gateway calls next to it, such as
+//    `uvicorn app:app`, waits until it takes connections, and stops both when either one stops.
+// 4. --tunnel also serves it at a public HTTPS address (tunnel.ts), to try it from anywhere.
+// `provider-kit try` then pays it once; `provider-kit launch` takes it live.
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { connect } from "node:net";
+import { DEFAULT_PORT } from "../gateway/config.js";
+import { devPayTo } from "./dev-account.js";
+import { ENV_FILE, loadEnvFile } from "./env-file.js";
+import { networkName, rpcOwnerChain, shortAddress } from "./owner-chain.js";
+import { startCommand, startForeground } from "./processes.js";
+import { serveGateway, stopOnSignals } from "./serve.js";
+import { DEFAULT_CONFIG, nextCommand, UsageError } from "./shared.js";
+import { quickTunnel } from "./tunnel.js";
+export function devIo() {
+    const log = (line) => console.log(line);
+    return {
+        log,
+        chain: (network) => rpcOwnerChain(network),
+        tunnel: (port) => quickTunnel(port),
+        serve: serveGateway,
+        start: (command, args, { env, shell }) => (shell ? startCommand(command, { env, show: true }) : startForeground(command, args, { env })),
+        untilStopped: (stop) => stopOnSignals(stop, log),
+        waitForPort,
+        env: process.env,
+    };
+}
+/** How long --with's API may take to start: uv may be installing its packages the first time. */
+const API_START_MS = 180_000;
+async function waitForPort(host, port, exited, timeoutMs) {
+    let stopped;
+    void exited.then((code) => (stopped = code));
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (stopped !== undefined)
+            throw new Error(`it stopped (exit code ${stopped})`);
+        const open = await new Promise((resolve) => {
+            const socket = connect({ host, port });
+            const done = (result) => {
+                socket.destroy();
+                resolve(result);
+            };
+            socket.once("connect", () => done(true));
+            socket.once("error", () => done(false));
+            socket.setTimeout(1000, () => done(false));
+        });
+        if (open)
+            return;
+        await new Promise((resolve) => setTimeout(resolve, 300));
+    }
+    throw new Error(`nothing took connections at ${host}:${port} in ${Math.round(timeoutMs / 1000)} s`);
+}
+/** provider-kit dev [-- <command> ...]: -1 while a gateway runs, else the command's exit code. */
+export async function dev(flags, command, io = devIo()) {
+    if (command.length > 0 && (flags.config !== undefined || flags.with !== undefined)) {
+        throw new UsageError("dev runs a gateway (--config, --with) or your provider's own command (after --), not both");
+    }
+    const envFile = flags["env-file"] ?? ENV_FILE;
+    if (flags["env-file"] !== undefined && !existsSync(envFile))
+        throw new UsageError(`${envFile} doesn't exist`);
+    await loadEnvFile(envFile, io.env);
+    const config = command.length > 0 ? undefined : (flags.config ?? (existsSync(DEFAULT_CONFIG) ? DEFAULT_CONFIG : undefined));
+    if (command.length === 0 && config === undefined) {
+        throw new UsageError(`dev needs a gateway config (--config, or ./${DEFAULT_CONFIG}), or your provider's command after --, such as: provider-kit dev -- node dist/server.js`);
+    }
+    const network = config === undefined ? commandNetwork(io.env) : await configNetwork(config);
+    const port = flags.port === undefined ? (io.env["PORT"] === undefined ? (config === undefined ? DEFAULT_PORT : undefined) : Number(io.env["PORT"])) : Number(flags.port);
+    if (port !== undefined && !(Number.isInteger(port) && port > 0 && port < 65536))
+        throw new UsageError("--port must be a port number");
+    const payTo = await devPayTo({ env: io.env, network, chain: () => io.chain(network), envFile, log: io.log });
+    let tunnel;
+    if (flags.tunnel) {
+        const tunnelPort = port ?? (config === undefined ? DEFAULT_PORT : await configPort(config));
+        io.log(`  … Opening a public HTTPS address for port ${tunnelPort} (cloudflared)`);
+        tunnel = await io.tunnel(tunnelPort);
+        io.log(`  ✓ Public address ${tunnel.url}: it changes every run, so it is for trying things out, not for registering`);
+    }
+    if (config === undefined)
+        return runCommand(command, { io, network, payTo, tunnel, port: port ?? DEFAULT_PORT });
+    return runGateway(config, { io, network, payTo, tunnel, port, with: flags.with });
+}
+/** The gateway, in this process, with the --with command next to it. Keeps running: -1. */
+async function runGateway(config, options) {
+    const { io, tunnel } = options;
+    let companion;
+    if (options.with !== undefined) {
+        io.log(`  … Starting ${options.with}`);
+        companion = io.start(options.with, [], { env: io.env, shell: true });
+        // The gateway serves once the API takes connections, so the first paid call doesn't arrive before it.
+        const api = await upstreamAddress(config, io.env);
+        if (api !== undefined) {
+            try {
+                await io.waitForPort(api.host, api.port, companion.exited, API_START_MS);
+            }
+            catch (error) {
+                await companion.stop();
+                await tunnel?.stop();
+                throw new Error(`${options.with} didn't start: ${error.message}`);
+            }
+            io.log(`  ✓ ${options.with} takes connections at ${api.host}:${api.port}`);
+        }
+    }
+    let served;
+    try {
+        served = await io.serve(config, {
+            dev: tunnel === undefined,
+            env: io.env,
+            ...(options.port === undefined ? {} : { port: options.port }),
+            ...(tunnel === undefined ? {} : { baseUrl: tunnel.url }),
+            log: io.log,
+        });
+    }
+    catch (error) {
+        await companion?.stop();
+        await tunnel?.stop();
+        throw error;
+    }
+    const { server } = served;
+    printNext(io, options.payTo, options.network);
+    let stopped = false;
+    const stop = async () => {
+        if (stopped)
+            return;
+        stopped = true;
+        await companion?.stop();
+        await tunnel?.stop();
+        await server.close();
+    };
+    void companion?.exited.then(async (code) => {
+        // A stop signal reaches this process too: give its handler the first word.
+        await new Promise((resolve) => setTimeout(resolve, 300));
+        if (stopped)
+            return;
+        io.log(`provider-kit: ${options.with} stopped (exit code ${code}), so the gateway stops too`);
+        await stop();
+        process.exit(code === 0 ? 1 : code);
+    });
+    io.untilStopped(stop);
+    return -1;
+}
+/** The provider's own command, with PAY_TO (and the tunnel's PUBLIC_ORIGIN) in its environment. Its exit code. */
+async function runCommand(command, options) {
+    const { io, payTo, tunnel } = options;
+    const env = { ...io.env, PAY_TO: payTo.payTo, PORT: String(options.port), ...(tunnel === undefined ? {} : { PUBLIC_ORIGIN: tunnel.url }) };
+    printNext(io, payTo, options.network);
+    const child = io.start(command[0], command.slice(1), { env, shell: false });
+    // Ctrl+C reaches the command too: it stops, and so does this, with its exit code.
+    const ignore = () => { };
+    const forward = () => void child.stop();
+    process.on("SIGINT", ignore);
+    process.on("SIGTERM", forward);
+    try {
+        return await child.exited;
+    }
+    finally {
+        process.off("SIGINT", ignore);
+        process.off("SIGTERM", forward);
+        await tunnel?.stop();
+    }
+}
+function printNext(io, payTo, network) {
+    if (payTo.kind === "throwaway") {
+        io.log(`  payTo      ${shortAddress(payTo.payTo)} is a throwaway testnet account: test payments land there, and nobody can spend them.`);
+        io.log(`             ${nextCommand("launch")} connects your own wallet and takes the service live.`);
+    }
+    // try pays with test money, which only testnet has.
+    if (network === "stellar:testnet")
+        io.log(`\nNext, from another terminal: ${nextCommand("try")} pays for one call with test money.\n`);
+    else
+        io.log(`\nThis is ${networkName(network)}: clients pay real USDC, to ${shortAddress(payTo.payTo)}. ${nextCommand("check")} checks the service against the standard.\n`);
+}
+/** The network of a gateway config, as written in it. */
+async function configNetwork(path) {
+    let network;
+    try {
+        network = JSON.parse(await readFile(path, "utf8")).network;
+    }
+    catch (error) {
+        throw new Error(`${path} can't be read: ${error.message}`);
+    }
+    if (network !== "stellar:testnet" && network !== "stellar:pubnet")
+        throw new Error(`${path} has no network: stellar:testnet or stellar:pubnet`);
+    return network;
+}
+/** Where a gateway config's first service calls its API, when that is on this computer: what --with starts. */
+async function upstreamAddress(path, env) {
+    const services = JSON.parse(await readFile(path, "utf8")).services;
+    let url = services?.[0]?.upstream?.url;
+    if (typeof url === "string" && url.startsWith("env:"))
+        url = env[url.slice("env:".length)];
+    if (typeof url !== "string")
+        return undefined;
+    try {
+        const { hostname, port, protocol } = new URL(url);
+        if (!["localhost", "127.0.0.1", "[::1]"].includes(hostname))
+            return undefined;
+        return { host: hostname === "[::1]" ? "::1" : hostname, port: Number(port || (protocol === "https:" ? 443 : 80)) };
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The port a gateway config listens on, for the tunnel. */
+async function configPort(path) {
+    const listen = JSON.parse(await readFile(path, "utf8")).listen;
+    return typeof listen?.port === "number" ? listen.port : DEFAULT_PORT;
+}
+/** A provider run by its own command reads STELLAR_NETWORK, as the TypeScript template does. Testnet by default. */
+function commandNetwork(env) {
+    const network = env["STELLAR_NETWORK"] ?? "stellar:testnet";
+    if (network !== "stellar:testnet" && network !== "stellar:pubnet")
+        throw new UsageError(`STELLAR_NETWORK must be stellar:testnet or stellar:pubnet, not "${network}"`);
+    return network;
+}
+//# sourceMappingURL=dev.js.map

package/dist/cli/dev.js.map

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

package/dist/cli/discovery.d.ts

@@ -0,0 +1,20 @@
+import { type ProviderManifest, type ServiceDescriptor } from "@stellar-agent-services/protocol";
+/** The stellar-agent-search release whose matching this follows, and whose CLI shows the live profile. */
+export declare const SEARCH_PACKAGE = "stellar-agent-search@0.2.0";
+/**
+ * The "How agents see you" section of `provider-kit check`. `registered` is the 8004 registration file read from the
+ * registry, when the provider has an agentId and the file could be read: search shows its name and description.
+ */
+export declare function howAgentsSeeYou(manifest: ProviderManifest, registered?: Record<string, unknown>): string[];
+/**
+ * provider.description with the words search would miss written in, for `provider-kit check --fix`: a sentence naming
+ * the services, then any tag words still missing. Undefined when search already finds every word.
+ */
+export declare function describedWithServices(manifest: ProviderManifest): string | undefined;
+/** Words from the services' names, titles and tags that a search for them wouldn't match in `text`. */
+export declare function missingWords(text: string, services: readonly ServiceDescriptor[]): string[];
+/** The words of `text` a search uses: folded, at least two characters, not a number, not a stopword. */
+export declare function searchWords(text: string): string[];
+/** stellar-agent-search's stem: one common suffix off, leaving at least three characters. */
+export declare function stem(word: string): string;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/cli/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/cli/discovery.ts"],"names":[],"mappings":"AAeA,OAAO,EAAyB,KAAK,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAIxH,0GAA0G;AAC1G,eAAO,MAAM,cAAc,+BAA+B,CAAC;AA+B3D;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,gBAAgB,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAmD1G;AAKD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAiBpF;AAED,uGAAuG;AACvG,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,iBAAiB,EAAE,GAAG,MAAM,EAAE,CAS3F;AAED,wGAAwG;AACxG,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAElD;AAED,6FAA6F;AAC7F,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGzC"}