@lucid-agents/pi-xgate 0.1.16 → 0.1.17

package/README.md

@@ -13,7 +13,7 @@ and the reviewed model-capability snapshot; the internal router contracts packag
 is not required. With Node 24.19 or later and Pi 1.5.2:
 
 ```sh
-pi install npm:@lucid-agents/pi-xgate@0.1.16
+pi install npm:@lucid-agents/pi-xgate@0.1.17
 ```
 
 For repository development before a release is available:
@@ -130,6 +130,13 @@ Pi cannot raise the service budget. Authorized ceilings remain consumed after
 successful settlement even when most of a deposit is returned. A new budget is an
 explicit wallet-operator action, never automatic rollover or a fresh journal.
 
+## Example: model calls and a video through one broker
+
+[`examples/video-agent`](examples/video-agent/README.md) runs Pi with this provider on
+Tempo mainnet and adds a tool that buys a Wan 3.0 video through the same wallet broker.
+The broker's `videoDir` setting turns the video routes on; Pi still holds only the broker
+token. It spends real money and needs a funded wallet of your own.
+
 ## Host-injected transport
 
 A host that owns payment, such as TaskMarket, builds the provider around its own

package/dist/config.d.ts

@@ -0,0 +1,7 @@
+import { BrokerClient } from "@lucid-agents/xgate-client/broker";
+/** An owner-only regular file at an absolute path, read whole. */
+export declare function privateText(path: string, max?: number): string;
+/** `XGATE_CONFIG`, else `~/.pi/agent/xgate.json`. */
+export declare function defaultConfigPath(): string;
+/** The broker the provider talks to: `{url, tokenFile}` from the private config file. */
+export declare function brokerFromConfig(configPath?: string): BrokerClient;

package/dist/config.js

@@ -0,0 +1,28 @@
+import { BrokerClient } from "@lucid-agents/xgate-client/broker";
+import { XgateError } from "@lucid-agents/xgate-client/types";
+import { readFileSync, lstatSync } from "node:fs";
+import { isAbsolute, join } from "node:path";
+import { homedir } from "node:os";
+/** An owner-only regular file at an absolute path, read whole. */
+export function privateText(path, max = 8192) {
+    if (!isAbsolute(path))
+        throw new XgateError("absolute_config_path_required");
+    const s = lstatSync(path);
+    if (!s.isFile() ||
+        s.isSymbolicLink() ||
+        (s.mode & 0o077) !== 0 ||
+        s.size > max)
+        throw new XgateError("private_config_required");
+    return readFileSync(path, "utf8").trim();
+}
+/** `XGATE_CONFIG`, else `~/.pi/agent/xgate.json`. */
+export function defaultConfigPath() {
+    return (process.env.XGATE_CONFIG ?? join(homedir(), ".pi", "agent", "xgate.json"));
+}
+/** The broker the provider talks to: `{url, tokenFile}` from the private config file. */
+export function brokerFromConfig(configPath = defaultConfigPath()) {
+    const cfg = JSON.parse(privateText(configPath));
+    if (typeof cfg.url !== "string" || typeof cfg.tokenFile !== "string")
+        throw new XgateError("invalid_config");
+    return new BrokerClient(cfg.url, privateText(cfg.tokenFile, 128));
+}

package/dist/extension.js

@@ -1,26 +1,9 @@
 import { BrokerClient } from "@lucid-agents/xgate-client/broker";
 import { XgateError } from "@lucid-agents/xgate-client/types";
-import { readFileSync, lstatSync, mkdirSync, writeFileSync } from "node:fs";
-import { dirname, isAbsolute, join } from "node:path";
-import { homedir } from "node:os";
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { brokerFromConfig, defaultConfigPath, privateText } from "./config.js";
 import { createXgateProvider } from "./provider.js";
-function privateText(path, max = 8192) {
-    if (!isAbsolute(path))
-        throw new XgateError("absolute_config_path_required");
-    const s = lstatSync(path);
-    if (!s.isFile() ||
-        s.isSymbolicLink() ||
-        (s.mode & 0o077) !== 0 ||
-        s.size > max)
-        throw new XgateError("private_config_required");
-    return readFileSync(path, "utf8").trim();
-}
-function standalone(configPath) {
-    const cfg = JSON.parse(privateText(configPath));
-    if (typeof cfg.url !== "string" || typeof cfg.tokenFile !== "string")
-        throw new XgateError("invalid_config");
-    return new BrokerClient(cfg.url, privateText(cfg.tokenFile, 128));
-}
 /** Rail-neutral: atomic units of the named asset; decimals are not assumed. */
 export function paymentStatus(p) {
     const left = p.channel
@@ -42,12 +25,12 @@ export function createXgateExtension(options = {}) {
 export default createXgateExtension();
 async function register(pi, options) {
     const injected = options.transport;
-    const configPath = process.env.XGATE_CONFIG ?? join(homedir(), ".pi", "agent", "xgate.json");
+    const configPath = defaultConfigPath();
     let broker;
     let context;
     const load = async () => {
         const next = injected === undefined
-            ? standalone(configPath)
+            ? brokerFromConfig(configPath)
             : typeof injected === "function"
                 ? await injected()
                 : injected;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lucid-agents/pi-xgate",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "type": "module",
   "exports": {
     ".": {
@@ -32,7 +32,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@lucid-agents/xgate-client": "0.1.16"
+    "@lucid-agents/xgate-client": "0.1.17"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "0.85.1 || 1.1.0 || 1.5.2",
@@ -56,10 +56,10 @@
     "registry": "https://registry.npmjs.org"
   },
   "license": "MIT",
-  "gitHead": "7fcdffc4e414569298b44afff9526f0d7ee1d6da",
+  "gitHead": "b50acd791679fab952109febbc2c49aecc20626c",
   "xgateRelease": {
-    "version": "v0.1.16",
-    "sourceSha": "7fcdffc4e414569298b44afff9526f0d7ee1d6da",
-    "candidateId": "rc-7fcdffc4e414-43512117243-1"
+    "version": "v0.1.17",
+    "sourceSha": "b50acd791679fab952109febbc2c49aecc20626c",
+    "candidateId": "rc-b50acd791679-43759708185-1"
   }
 }

package/src/config.ts

@@ -0,0 +1,34 @@
+import { BrokerClient } from "@lucid-agents/xgate-client/broker";
+import { XgateError } from "@lucid-agents/xgate-client/types";
+import { readFileSync, lstatSync } from "node:fs";
+import { isAbsolute, join } from "node:path";
+import { homedir } from "node:os";
+
+/** An owner-only regular file at an absolute path, read whole. */
+export function privateText(path: string, max = 8192): string {
+  if (!isAbsolute(path)) throw new XgateError("absolute_config_path_required");
+  const s = lstatSync(path);
+  if (
+    !s.isFile() ||
+    s.isSymbolicLink() ||
+    (s.mode & 0o077) !== 0 ||
+    s.size > max
+  )
+    throw new XgateError("private_config_required");
+  return readFileSync(path, "utf8").trim();
+}
+/** `XGATE_CONFIG`, else `~/.pi/agent/xgate.json`. */
+export function defaultConfigPath(): string {
+  return (
+    process.env.XGATE_CONFIG ?? join(homedir(), ".pi", "agent", "xgate.json")
+  );
+}
+/** The broker the provider talks to: `{url, tokenFile}` from the private config file. */
+export function brokerFromConfig(
+  configPath: string = defaultConfigPath(),
+): BrokerClient {
+  const cfg = JSON.parse(privateText(configPath));
+  if (typeof cfg.url !== "string" || typeof cfg.tokenFile !== "string")
+    throw new XgateError("invalid_config");
+  return new BrokerClient(cfg.url, privateText(cfg.tokenFile, 128));
+}

package/src/extension.ts

@@ -4,9 +4,9 @@ import type {
 } from "@earendil-works/pi-coding-agent";
 import { BrokerClient } from "@lucid-agents/xgate-client/broker";
 import { XgateError } from "@lucid-agents/xgate-client/types";
-import { readFileSync, lstatSync, mkdirSync, writeFileSync } from "node:fs";
-import { dirname, isAbsolute, join } from "node:path";
-import { homedir } from "node:os";
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { brokerFromConfig, defaultConfigPath, privateText } from "./config.ts";
 import { createXgateProvider, type XgatePurchaseFailure } from "./provider.ts";
 import type { XgatePayment, XgateTransport } from "./transport.ts";
 export interface XgateExtensionOptions {
@@ -17,24 +17,6 @@ export interface XgateExtensionOptions {
    */
   transport?: XgateTransport | (() => XgateTransport | Promise<XgateTransport>);
 }
-function privateText(path: string, max = 8192): string {
-  if (!isAbsolute(path)) throw new XgateError("absolute_config_path_required");
-  const s = lstatSync(path);
-  if (
-    !s.isFile() ||
-    s.isSymbolicLink() ||
-    (s.mode & 0o077) !== 0 ||
-    s.size > max
-  )
-    throw new XgateError("private_config_required");
-  return readFileSync(path, "utf8").trim();
-}
-function standalone(configPath: string): BrokerClient {
-  const cfg = JSON.parse(privateText(configPath));
-  if (typeof cfg.url !== "string" || typeof cfg.tokenFile !== "string")
-    throw new XgateError("invalid_config");
-  return new BrokerClient(cfg.url, privateText(cfg.tokenFile, 128));
-}
 /** Rail-neutral: atomic units of the named asset; decimals are not assumed. */
 export function paymentStatus(p: XgatePayment): string {
   const left = p.channel
@@ -61,14 +43,13 @@ async function register(
   options: XgateExtensionOptions,
 ): Promise<void> {
   const injected = options.transport;
-  const configPath =
-    process.env.XGATE_CONFIG ?? join(homedir(), ".pi", "agent", "xgate.json");
+  const configPath = defaultConfigPath();
   let broker: XgateTransport | undefined;
   let context: ExtensionContext | undefined;
   const load = async () => {
     const next =
       injected === undefined
-        ? standalone(configPath)
+        ? brokerFromConfig(configPath)
         : typeof injected === "function"
           ? await injected()
           : injected;