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

package/dist/cli/init.js

@@ -0,0 +1,170 @@
+// provider-kit init: writes a starter gateway config. It never overwrites a file.
+//
+//   provider-kit init [--upstream <url>]                  one service to edit, which forwards to --upstream
+//   provider-kit init --openapi <file | url> [--upstream <base url>]
+//                                                         a service per POST endpoint of an OpenAPI document,
+//                                                         such as FastAPI's /openapi.json (gateway/openapi.ts),
+//                                                         then loaded as `provider-kit serve` loads it
+// --json prints what it wrote and skipped as JSON, for scripts and coding agents.
+import { existsSync } from "node:fs";
+import { writeFile } from "node:fs/promises";
+import { Keypair } from "@stellar/stellar-sdk";
+import { loadGatewayConfig } from "../gateway/config.js";
+import { DESCRIPTION_TO_WRITE, FIRST_GUESS, gatewayFromOpenApi, PROVIDER_DESCRIPTION_TO_WRITE, readOpenApi } from "../gateway/openapi.js";
+import { createProvider } from "../provider.js";
+import { quote } from "./shared.js";
+const DEFAULT_OUT = "provider.config.json";
+/** Skipped operations listed, before "and N more". */
+const SKIPPED_SHOWN = 15;
+export async function init(flags) {
+    const out = flags.out ?? DEFAULT_OUT;
+    if (flags.openapi !== undefined)
+        return initFromOpenApi(flags.openapi, out, flags.upstream, flags.json === true);
+    const service = {
+        name: "my-service",
+        title: "My service",
+        description: DESCRIPTION_TO_WRITE,
+        price: FIRST_GUESS.price,
+        charge: FIRST_GUESS.charge,
+        expectedDurationSeconds: FIRST_GUESS.expectedDurationSeconds,
+        inputSchema: {
+            type: "object",
+            required: ["text"],
+            properties: { text: { type: "string", minLength: 1, maxLength: 10000 } },
+            additionalProperties: false,
+        },
+        outputSchema: { type: "object" },
+        capacity: { ...FIRST_GUESS.capacity },
+        upstream: { url: flags.upstream ?? "http://127.0.0.1:5000/run" },
+    };
+    await write(out, gatewayConfig({ name: "My provider", description: PROVIDER_DESCRIPTION_TO_WRITE }, [service]));
+    if (flags.json) {
+        console.log(JSON.stringify({ ok: true, out, services: [{ name: service.name, url: service.upstream.url, headers: [] }], skipped: [], warnings: [], credentials: [] }, null, 2));
+        return 0;
+    }
+    console.log(`Wrote ${out}. Next:
+  1. Edit the service: name, description, price, schemas and upstream URL.
+  2. provider-kit dev --config ${out}   runs it here. With PAY_TO empty, a throwaway testnet account is paid.
+  3. provider-kit try my-service '{"text":"Hello"}' --config ${out}   one paid testnet call, from another terminal
+  4. provider-kit launch --config ${out} --url https://your.domain   registers it from your wallet, to go live
+  Where it runs in production, set baseUrl to your public HTTPS URL and remove "dev".`);
+    return 0;
+}
+/** init --openapi: a service per POST endpoint the gateway can call, and every other operation with the reason. */
+async function initFromOpenApi(source, out, upstream, json) {
+    // With --json, standard output holds only the JSON at the end.
+    const say = json ? () => { } : (line) => console.log(line);
+    // Checked first, so nothing is read for a file that won't be written.
+    if (existsSync(out))
+        throw new Error(`${out} already exists; nothing was written`);
+    const { document, url } = await readOpenApi(source);
+    const gateway = await gatewayFromOpenApi(document, { ...(url === undefined ? {} : { url }), ...(upstream === undefined ? {} : { upstream }) });
+    const { api, services } = gateway;
+    say(`Read ${api.title}${api.version === undefined ? "" : ` ${api.version}`} (OpenAPI ${api.openapi}) from ${source}`);
+    if (services.length === 0) {
+        printSkipped(gateway.skipped, say);
+        throw new Error("none of its operations can be a service: the gateway POSTs a JSON object to the API and takes a JSON object back. Nothing was written.");
+    }
+    await write(out, gatewayConfig({ name: gateway.provider.name, description: gateway.provider.description ?? PROVIDER_DESCRIPTION_TO_WRITE }, services));
+    say(`\nWrote ${out} with ${count(services.length, "service")}:`);
+    const width = Math.max(...services.map((service) => service.name.length));
+    for (const service of services) {
+        const headers = Object.keys(service.upstream.headers ?? {});
+        say(`  ${service.name.padEnd(width)}  POST ${service.upstream.url}${headers.length === 0 ? "" : `  with ${headers.join(", ")}`}`);
+    }
+    if (gateway.skipped.length > 0)
+        printSkipped(gateway.skipped, say);
+    for (const warning of gateway.warnings)
+        say(`\n! ${warning}`);
+    const problem = await loadAsServeWould(out, ["PAY_TO", ...gateway.credentials.map((credential) => credential.name)]);
+    if (problem === undefined)
+        say("\n✓ The config passes Provider Standard v1, checked as provider-kit serve checks it.");
+    else
+        say(`\n✗ The config doesn't load yet:\n  ${problem.split("\n").join("\n  ")}`);
+    const steps = [
+        `Review ${out}: each service's price (${FIRST_GUESS.price} USDC for now), charge and description, which agents choose by.` +
+            (gateway.undescribed.length === 0 ? "" : `\n     Write one for ${gateway.undescribed.join(", ")}: the document gives only a summary, or nothing.`),
+        ...gateway.credentials.map((credential) => `export ${credential.name}=...   ${credential.holds}`),
+        `provider-kit dev --config ${quote(out)}   runs it here. With PAY_TO empty, a throwaway testnet account is paid.`,
+        `${tryCommand(services, out)}   one paid testnet call, from another terminal`,
+        `provider-kit launch --config ${quote(out)} --url https://your.domain   registers it from your wallet, to go live`,
+    ];
+    say(`\nNext:\n${steps.map((step, index) => `  ${index + 1}. ${step}`).join("\n")}`);
+    if (json) {
+        const report = {
+            ok: problem === undefined,
+            out,
+            api: { title: api.title, ...(api.version === undefined ? {} : { version: api.version }), openapi: api.openapi },
+            services: services.map((service) => ({ name: service.name, url: service.upstream.url, headers: Object.keys(service.upstream.headers ?? {}), described: !gateway.undescribed.includes(service.name) })),
+            skipped: gateway.skipped,
+            warnings: gateway.warnings,
+            credentials: gateway.credentials.map(({ name, holds }) => ({ name, holds })),
+            ...(problem === undefined ? {} : { problem }),
+        };
+        console.log(JSON.stringify(report, null, 2));
+    }
+    return problem === undefined ? 0 : 1;
+}
+/** A gateway config for development on testnet, as both kinds of init write it. */
+function gatewayConfig(provider, services) {
+    return {
+        $schema: "./node_modules/@stellar-agent-services/provider-kit/schemas/gateway-config.schema.json",
+        baseUrl: "http://localhost:8787",
+        dev: true,
+        network: "stellar:testnet",
+        payTo: "env:PAY_TO",
+        facilitator: "https://x402.org/facilitator",
+        provider: { ...provider, dataUse: { storesInputs: false, trainsOnInputs: false } },
+        store: "./jobs.sqlite",
+        services: services,
+    };
+}
+async function write(out, config) {
+    try {
+        await writeFile(out, `${JSON.stringify(config, null, 2)}\n`, { flag: "wx" });
+    }
+    catch (error) {
+        if (error.code === "EEXIST")
+            throw new Error(`${out} already exists; nothing was written`);
+        throw error;
+    }
+}
+/**
+ * Loads the written config as `provider-kit serve` does: the gateway config's schema, every service, the manifest
+ * against the standard. Variables it reads that aren't set here get stand-ins: only the file is checked. The
+ * problems, or undefined.
+ */
+async function loadAsServeWould(path, variables) {
+    const env = { ...process.env };
+    for (const name of variables) {
+        if (env[name] === undefined || env[name] === "")
+            env[name] = name === "PAY_TO" ? Keypair.random().publicKey() : "stand-in";
+    }
+    try {
+        const { config } = await loadGatewayConfig(path, { env, openStore: false });
+        await createProvider(config).close();
+        return undefined;
+    }
+    catch (error) {
+        return error.message;
+    }
+}
+function printSkipped(skipped, say) {
+    say(`\nSkipped ${count(skipped.length, "operation")}:`);
+    const shown = skipped.slice(0, SKIPPED_SHOWN);
+    const methods = Math.max(...shown.map((operation) => operation.method.length));
+    const paths = Math.min(40, Math.max(...shown.map((operation) => operation.path.length)));
+    for (const { method, path, reason } of shown)
+        say(`  ${method.padEnd(methods)}  ${path.padEnd(paths)}  ${reason}`);
+    if (skipped.length > shown.length)
+        say(`  … and ${skipped.length - shown.length} more`);
+}
+/** How to try the first service: with its example input when it has one. */
+function tryCommand(services, out) {
+    const service = services.find((candidate) => candidate.examples !== undefined) ?? services[0];
+    return `provider-kit try ${service.name}${service.examples === undefined ? " '<input JSON>'" : ""}${out === DEFAULT_OUT ? "" : ` --config ${quote(out)}`}`;
+}
+function count(n, noun) {
+    return `${n} ${noun}${n === 1 ? "" : "s"}`;
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/init.js.map

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

package/dist/cli/launch.d.ts

@@ -0,0 +1,21 @@
+import { type FlyRunner } from "./fly.js";
+import { type Started } from "./processes.js";
+import { type CliFlags, type OwnerIo } from "./shared.js";
+/** Where `launch` reaches the outside world. Tests replace it. */
+export interface LaunchIo extends OwnerIo {
+    log(line: string): void;
+    /** Whether someone is there to answer a question. */
+    interactive: boolean;
+    /** Asks yes or no. Enter means yes. */
+    confirm(question: string): Promise<boolean>;
+    fetch: typeof fetch;
+    /** Starts the provider's own command in the background, with `env` added. */
+    start(command: string, env: NodeJS.ProcessEnv): Started;
+    freePort(): Promise<number>;
+    fly: FlyRunner;
+    sleep(ms: number): Promise<void>;
+    env: NodeJS.ProcessEnv;
+}
+export declare function launchIo(flags: CliFlags): LaunchIo;
+export declare function launch(flags: CliFlags, io?: LaunchIo): Promise<number>;
+//# sourceMappingURL=launch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../src/cli/launch.ts"],"names":[],"mappings":"AAqCA,OAAO,EAAmE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAG3G,OAAO,EAAuD,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEnG,OAAO,EAA2D,KAAK,QAAQ,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAenH,kEAAkE;AAClE,MAAM,WAAW,QAAS,SAAQ,OAAO;IACvC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,qDAAqD;IACrD,WAAW,EAAE,OAAO,CAAC;IACrB,uCAAuC;IACvC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,6EAA6E;IAC7E,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC;IACxD,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5B,GAAG,EAAE,SAAS,CAAC;IACf,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;CACxB;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,CAwBlD;AAcD,wBAAsB,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,GAAE,QAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CA4O7F"}