@connormartin/seed-network-agent 0.1.3 → 0.1.5

package/README.md

@@ -62,31 +62,46 @@ npx @connormartin/seed-network-agent@latest
 
 The CLI checks npm for updates at startup at most once per day and prints the exact update command when a newer version is available. Disable this with `SEED_NETWORK_AGENT_NO_UPDATE_CHECK=1`.
 
-## Publish an npm update
+## Update, build, and publish
 
-Updating this repository does not update the published `npx` / global CLI package. To ship CLI changes, publish a new package version to npm:
+From the repository root, make the agent changes, then build the package:
 
 ```bash
-# from the repo root
 pnpm --filter @connormartin/seed-network-agent build
+```
+
+Before publishing, bump the npm package version in `apps/agent/package.json` to a version higher than the current npm `latest`:
 
+```bash
+npm view @connormartin/seed-network-agent version
 cd apps/agent
-npm version patch
-npm publish --access public
+npm version <next-version> --no-git-tag-version
 ```
 
-Use `npm version minor` or `npm version major` instead of `patch` when appropriate. You must be logged into npm with publish access:
+Use semver patch/minor/major as appropriate. For example, if npm `latest` is `0.1.3`, publish `0.1.4` or higher. Then verify the package contents and publish:
 
 ```bash
-npm whoami
-npm login
+npm pack --dry-run
+npm publish --access public
 ```
 
-After publishing, users can update with:
+After publishing, users can update their installed CLI with:
 
 ```bash
 npm install -g @connormartin/seed-network-agent@latest
-# or run without installing
+```
+
+If npm returns `ETARGET` immediately after publishing, the registry metadata and tarball may not have fully propagated yet. Wait a minute, verify the package, then retry with fresh registry metadata:
+
+```bash
+npm view @connormartin/seed-network-agent version versions
+npm install -g @connormartin/seed-network-agent@latest --prefer-online --registry=https://registry.npmjs.org/
+hash -r
+```
+
+Or run the latest version directly:
+
+```bash
 npx @connormartin/seed-network-agent@latest
 ```
 
@@ -123,5 +138,18 @@ The wrapper can connect to the Seed Network web app as an Agent Auth client:
 /seed disconnect
 ```
 
-By default the provider URL is `SEED_NETWORK_AGENT_AUTH_PROVIDER` or `http://localhost:3000`.
+By default, the published npm CLI (`seed`) connects to `https://seed-network-v2.vercel.app/`, while the local source command (`pnpm agent`) connects to `http://localhost:3000` for development. Override either with `SEED_NETWORK_AGENT_AUTH_PROVIDER`.
 Agent Auth identity and grants are stored locally under `~/.seed-network-agent/auth/`.
+
+If `/submit-deal` fails with `fetch failed` during PDF upload, check the upload URL in the error. If it mentions `localhost:3000`, remove stale local Agent Auth state and reconnect to production:
+
+```bash
+/seed disconnect
+/connect
+```
+
+You can also force the provider for one run:
+
+```bash
+SEED_NETWORK_AGENT_AUTH_PROVIDER=https://seed-network-v2.vercel.app/ seed
+```

package/dist/features/agent-auth/register.js

@@ -46,7 +46,7 @@ async function handleSeedCommand(args, ctx) {
                 const grants = connection.capabilityGrants
                     .map((grant) => `${grant.capability}:${grant.status}`)
                     .join(", ");
-                return `${connection.providerName} ${connection.agentId} (${connection.mode}) — ${grants || "no grants"}`;
+                return `${connection.providerName} ${connection.agentId} (${connection.mode}, ${connection.issuer}) — ${grants || "no grants"}`;
             });
             ctx.ui.notify(lines.join("\n"), "info");
             return;

package/dist/features/submit-deal-pdf/pipeline.js

@@ -41,7 +41,7 @@ export async function preparePdfDealSubmission(submission, connection, ui, optio
         ui?.notify?.(`Deal interpretation warnings:\n${interpreted.warnings.join("\n")}`, "warning");
     }
     ui?.notify?.("Uploading PDF deck to Seed Network storage…", "info");
-    const deck = await uploadDealDeck(validated, connection);
+    const deck = await uploadDealDeck(validated, connection, ui);
     const sanitizedAnswers = omitAnswer(submission.answers, "deck_file_path");
     const explicitName = answerValue(submission.answers.name);
     return {

package/dist/features/submit-deal-pdf/upload-client.js

@@ -1,5 +1,5 @@
-import { createSeedAgentAuthClient, DEFAULT_PROVIDER_URL, SEED_SUBMIT_DEAL_CAPABILITY } from "../../seed-agent-auth.js";
-export async function uploadDealDeck(validated, connection) {
+import { createSeedAgentAuthClient, DEFAULT_PROVIDER_URL, isLocalhostUrl, SEED_SUBMIT_DEAL_CAPABILITY, } from "../../seed-agent-auth.js";
+export async function uploadDealDeck(validated, connection, ui) {
     const client = createSeedAgentAuthClient();
     try {
         const { token } = await client.signJwt({
@@ -10,17 +10,25 @@ export async function uploadDealDeck(validated, connection) {
         form.set("file", new Blob([validated.buffer], { type: "application/pdf" }), validated.fileName || "deck.pdf");
         form.set("sha256", validated.sha256);
         form.set("size", String(validated.size));
-        const response = await fetch(agentUploadUrl(connection), {
-            method: "POST",
-            headers: {
-                Authorization: `Bearer ${token}`,
-            },
-            body: form,
-        });
+        const uploadUrl = agentUploadUrl(connection);
+        ui?.notify?.(`Uploading PDF deck to ${urlOrigin(uploadUrl) ?? uploadUrl}…`, "info");
+        let response;
+        try {
+            response = await fetch(uploadUrl, {
+                method: "POST",
+                headers: {
+                    Authorization: `Bearer ${token}`,
+                },
+                body: form,
+            });
+        }
+        catch (error) {
+            throw new Error(`PDF deck upload could not reach ${uploadUrl} (Agent Auth issuer: ${connection.issuer}). ${formatFetchError(error)}${uploadHint(uploadUrl)}`, { cause: error });
+        }
         const data = await response.json().catch(() => null);
         if (!response.ok) {
             const message = isRecord(data) && typeof data.error === "string" ? data.error : `HTTP ${response.status}`;
-            throw new Error(`PDF deck upload failed: ${message}`);
+            throw new Error(`PDF deck upload failed at ${uploadUrl}: ${message}`);
         }
         if (!isRecord(data) || data.ok !== true || !isRecord(data.deck)) {
             throw new Error("PDF deck upload returned an invalid response.");
@@ -52,6 +60,36 @@ function agentUploadUrl(connection) {
         return new URL("/api/agent/deal-deck-upload", DEFAULT_PROVIDER_URL).toString();
     }
 }
+function uploadHint(uploadUrl) {
+    if (isLocalhostUrl(uploadUrl)) {
+        return " This looks like a stale localhost Agent Auth connection. Run /seed disconnect, then /connect, then retry /submit-deal.";
+    }
+    return " Check your network connection or set SEED_NETWORK_AGENT_DECK_UPLOAD_URL to override the upload endpoint.";
+}
+function formatFetchError(error) {
+    if (!(error instanceof Error))
+        return `Fetch error: ${String(error)}.`;
+    const cause = error.cause;
+    if (cause && typeof cause === "object") {
+        const code = "code" in cause && typeof cause.code === "string" ? cause.code : undefined;
+        const message = "message" in cause && typeof cause.message === "string" ? cause.message : undefined;
+        if (code && message)
+            return `Fetch error: ${error.message} (${code}: ${message}).`;
+        if (code)
+            return `Fetch error: ${error.message} (${code}).`;
+        if (message)
+            return `Fetch error: ${error.message} (${message}).`;
+    }
+    return `Fetch error: ${error.message}.`;
+}
+function urlOrigin(value) {
+    try {
+        return new URL(value).origin;
+    }
+    catch {
+        return null;
+    }
+}
 function stringProperty(record, field) {
     const value = record[field];
     if (typeof value !== "string" || value.length === 0)

package/dist/pi.js

@@ -34,6 +34,7 @@ export async function runPi(userArgs = []) {
         env: {
             ...process.env,
             SEED_NETWORK_AGENT_ROOT: agentRoot,
+            SEED_NETWORK_AGENT_RUNTIME: process.env.SEED_NETWORK_AGENT_RUNTIME ?? agentRuntime(),
         },
     });
     await new Promise((resolve, reject) => {
@@ -54,6 +55,9 @@ function resolveExtensionPath() {
         return compiledExtensionPath;
     return path.join(__dirname, "extension", "index.ts");
 }
+function agentRuntime() {
+    return path.basename(__dirname) === "src" ? "source" : "package";
+}
 function shouldCheckForUpdates(userArgs) {
     const skipFlags = new Set(["--help", "-h", "--version", "-v", "--offline"]);
     return !userArgs.some((arg) => skipFlags.has(arg));

package/dist/seed-agent-auth.js

@@ -3,8 +3,13 @@ import os from "node:os";
 import { AgentAuthClient } from "@auth/agent";
 import { SeedAgentAuthStorage } from "./agent-auth-storage.js";
 export const SEED_SUBMIT_DEAL_CAPABILITY = "submit_deal";
-export const DEFAULT_PROVIDER_URL = process.env.SEED_NETWORK_AGENT_AUTH_PROVIDER ?? "http://localhost:3000";
+export const LOCAL_PROVIDER_URL = "http://localhost:3000";
+export const PROD_PROVIDER_URL = "https://seed-network-v2.vercel.app/";
+export const DEFAULT_PROVIDER_URL = process.env.SEED_NETWORK_AGENT_AUTH_PROVIDER ?? defaultProviderUrl();
 const DEFAULT_SEED_CAPABILITIES = [SEED_SUBMIT_DEAL_CAPABILITY];
+function defaultProviderUrl() {
+    return process.env.SEED_NETWORK_AGENT_RUNTIME === "source" ? LOCAL_PROVIDER_URL : PROD_PROVIDER_URL;
+}
 export function createSeedAgentAuthClient(ui) {
     return new AgentAuthClient({
         storage: new SeedAgentAuthStorage(),
@@ -45,8 +50,8 @@ export async function listSeedAgentConnections() {
 }
 export async function getPreferredConnection() {
     const connections = await listSeedAgentConnections();
-    return connections.find((connection) => hasActiveCapability(connection, SEED_SUBMIT_DEAL_CAPABILITY))
-        ?? connections[0];
+    return preferCurrentProvider(connections.filter((connection) => hasActiveCapability(connection, SEED_SUBMIT_DEAL_CAPABILITY)))
+        ?? preferCurrentProvider(connections);
 }
 export async function ensureActiveSeedCapability(client, capability, ui, approval) {
     const storage = new SeedAgentAuthStorage();
@@ -138,11 +143,41 @@ async function waitForActiveCapability(client, agentId, capability, timeoutMs =
 }
 async function getConnectionWithCapability(capability) {
     const connections = await listSeedAgentConnections();
-    return connections.find((connection) => hasActiveCapability(connection, capability));
+    return preferCurrentProvider(connections.filter((connection) => hasActiveCapability(connection, capability)));
 }
 function hasActiveCapability(connection, capability) {
     return connection.capabilityGrants.some((grant) => grant.capability === capability && grant.status === "active");
 }
+function preferCurrentProvider(connections) {
+    const usableConnections = connections.filter((connection) => !isStaleLocalhostConnection(connection));
+    return usableConnections.find(isCurrentProviderConnection) ?? usableConnections[0];
+}
+function isCurrentProviderConnection(connection) {
+    return urlOrigin(connection.issuer) === urlOrigin(DEFAULT_PROVIDER_URL);
+}
+export function isStaleLocalhostConnection(connection) {
+    return isLocalhostUrl(connection.issuer) && !isLocalhostUrl(DEFAULT_PROVIDER_URL);
+}
+export function isLocalhostUrl(value) {
+    const hostname = urlHostname(value);
+    return hostname === "localhost" || hostname === "127.0.0.1" || hostname === "::1";
+}
+function urlOrigin(value) {
+    try {
+        return new URL(value).origin;
+    }
+    catch {
+        return null;
+    }
+}
+function urlHostname(value) {
+    try {
+        return new URL(value).hostname;
+    }
+    catch {
+        return null;
+    }
+}
 function isAgentAuthErrorCode(error, ...codes) {
     return typeof error === "object"
         && error !== null
@@ -156,10 +191,17 @@ async function sleep(ms) {
 export async function disconnectSeedAgents(ui) {
     const connections = await listSeedAgentConnections();
     const client = createSeedAgentAuthClient(ui);
+    const storage = new SeedAgentAuthStorage();
     let disconnected = 0;
     try {
         for (const connection of connections) {
-            await client.disconnectAgent(connection.agentId);
+            try {
+                await client.disconnectAgent(connection.agentId);
+            }
+            catch (error) {
+                ui?.notify?.(`Could not revoke Seed Network Agent ${connection.agentId} at ${connection.issuer}; removing the local saved connection anyway. ${formatError(error)}`, "warning");
+            }
+            await storage.deleteAgentConnection(connection.agentId);
             disconnected += 1;
         }
     }
@@ -168,6 +210,22 @@ export async function disconnectSeedAgents(ui) {
     }
     return disconnected;
 }
+function formatError(error) {
+    if (!(error instanceof Error))
+        return String(error);
+    const cause = error.cause;
+    if (cause && typeof cause === "object") {
+        const code = "code" in cause && typeof cause.code === "string" ? cause.code : undefined;
+        const message = "message" in cause && typeof cause.message === "string" ? cause.message : undefined;
+        if (code && message)
+            return `${error.message} (${code}: ${message})`;
+        if (code)
+            return `${error.message} (${code})`;
+        if (message)
+            return `${error.message} (${message})`;
+    }
+    return error.message;
+}
 function formatApprovalMessage(approval) {
     const lines = ["Seed Network Agent requires browser approval."];
     if (approval.user_code)

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@connormartin/seed-network-agent",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "private": false,
   "type": "module",
   "bin": {
-    "seed": "./dist/cli.js",
-    "seed-agent": "./dist/cli.js",
-    "seed-network-agent": "./dist/cli.js"
+    "seed": "dist/cli.js",
+    "seed-agent": "dist/cli.js",
+    "seed-network-agent": "dist/cli.js"
   },
   "files": [
     "dist",