@tomato414941/foundation 0.7.0 → 0.8.0

package/guide.mjs

@@ -113,6 +113,10 @@ export function guide(connectors) {
     '     to register one: they make it at the service (redirect URL <this server>/oauth/<connector id>/callback) and',
     '     type its client ID and secret on the page. result.app_id names it. You never see or handle its secret.',
     '     GET /v1/connectors says which connectors take apps (apps.fields: what registering one asks for).',
+    '   A service with no connector of its own is reached through "oauth2": the owner registers an app for it naming the',
+    '   service and where it authorizes and hands out tokens (and, if it has them, where it says who authorized and',
+    '   where it takes a token back). Ask for that with {"kind":"app","input":{"connector":"oauth2"}} and steps that say',
+    '   where those are for that service. Connections through it yield OAUTH_ACCESS_TOKEN.',
     '   To reconnect, add "connection_id":"<existing id>" inside input. This updates that connection and keeps its id,',
     '   its scopes (add more with scopes) and the app it was made through.',
     '   Without connection_id, authorization creates a separate connection, even for the same service user. List and use',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomato414941/foundation",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Foundation CLI: make a key, and hand what is kept to a command without it passing through the agent.",
   "type": "module",
   "engines": {

package/runtime.mjs

@@ -109,7 +109,7 @@ Commands:
                                        Run a command with saved values in its environment.
   exec --inputs '<json>' -- <command>  The same, with files, structured inputs, or a connected grant by id.
   exec --output '<json>' -- <command>  Also save a file the command writes.
-  guide                                The API guide: what Foundation keeps, and how to ask it for things.
+  guide                                Read the server's API guide (bundled reference when offline).
   version                              Print the version.
 
 Environment:
@@ -126,15 +126,18 @@ async function main() {
   const configured = process.env.FOUNDATION_URL || await savedUrl();
   if (action === '--help' || action === '-h' || action === 'help' || !action) { console.log(HELP); return; }
   if (action === 'guide') {
-    let connectors;
     if (configured) {
       try {
-        const response = await fetch(new URL('/v1/connectors', configured), { redirect: 'error', signal: AbortSignal.timeout(5_000) });
-        const catalog = await response.json();
-        if (response.ok && Array.isArray(catalog.connectors)) connectors = catalog.connectors;
+        const response = await fetch(new URL('/start', serverUrl(configured)), { redirect: 'error', signal: AbortSignal.timeout(5_000) });
+        if (!response.ok || response.headers.get('content-type')?.split(';')[0].trim() !== 'text/plain') throw new Error('Guide unavailable');
+        const instructions = await response.text();
+        if (!instructions.trim()) throw new Error('Empty guide');
+        console.log(instructions.trimEnd());
+        return;
       } catch {}
     }
-    console.log(guide(connectors));
+    console.error(`${configured ? 'Could not read the server guide.' : 'No Foundation server configured.'} Using the bundled reference from CLI ${VERSION}; it may differ from your server.`);
+    console.log(guide());
     return;
   }
   const separatorAt = args.indexOf('--'), command = separatorAt >= 0 ? args.slice(separatorAt + 1) : [];