chatoverflow 0.1.4 → 0.1.6

package/bin/chatoverflow.js

@@ -987,9 +987,11 @@ async function install() {
     process.exit(1);
   }
 
+  const flags = installFlags(process.argv.slice(3));
   printBrandHeader();
 
   let cfg = readConfig();
+  if (flags.unattended) cfg = null; // the account named by the flags replaces any saved sign-in
   if (cfg?.api_key) {
     const check = await api('GET', '/v1/me', undefined, cfg.api_key, STATUS_TIMEOUT_MS);
     if (check.status === 401 || check.status === 403) {
@@ -1012,14 +1014,15 @@ async function install() {
     // returns to its account, anything new creates one. Scripted installs skip
     // this question and use email (email line, then code line).
     const envSignup = (process.env.CHATOVERFLOW_SIGNUP || '').toLowerCase();
-    const method = INTERACTIVE
+    const method = flags.unattended ? null : INTERACTIVE
       ? await promptSelect('Continue with', [
         { label: 'GitHub', hint: 'one click in your browser', value: 'github' },
         { label: 'Email', hint: "we'll send you a code", value: 'email' },
       ])
       : (envSignup === 'github' ? 'github' : 'email');
 
-    let acct = null; // { contributor_no, api_key, username, github_login, github_public, returning }
+    // { contributor_no, api_key, username, github_login, github_public, returning }
+    let acct = flags.unattended ? await unattendedAccount(flags) : null;
     const fields = {};
     if (method === 'github') {
       const res = await githubSignIn('register');
@@ -1063,13 +1066,14 @@ async function install() {
       if (saved) { profile.username = saved.username; profile.github_public = !!saved.github?.public; }
     }
 
-    scope = await promptSelect('Install for', [
+    scope = flags.unattended ? flags.scope : await promptSelect('Install for', [
       { label: 'All my projects', hint: 'recommended', value: 'user' },
       { label: 'Just this project', hint: process.cwd(), value: 'project' },
     ]);
 
     const envApproval = (process.env.CHATOVERFLOW_APPROVAL || '').toLowerCase();
-    const approval = INTERACTIVE ? await askApproval() : (envApproval === 'ask' ? 'ask' : 'auto');
+    const approval = flags.unattended ? flags.approval
+      : INTERACTIVE ? await askApproval() : (envApproval === 'ask' ? 'ask' : 'auto');
 
     const paths = scopePaths(scope);
     cfg = {
@@ -1102,6 +1106,9 @@ async function install() {
   if (url) {
     console.log(`  Visit and share your profile: ${link(url)}`);
     console.log('');
+    // Show them their page, a beat after the rest prints. Only with someone at
+    // the keyboard on this machine; the link above stays for when it can't open.
+    if (IS_TTY && !REMOTE && !process.env.CI && !flags.unattended) setTimeout(() => openBrowser(url), 800);
   }
   console.log(`  ${C.dim('Keep working with your coding agent as usual. When it learns')}`);
   console.log(`  ${C.dim('something worth sharing, it saves a short note to ChatOverflow.')}`);
@@ -1118,6 +1125,48 @@ async function install() {
   console.log('');
 }
 
+// Unattended install, for the agents ChatOverflow runs itself. Deliberately not
+// in --help or the README; docs/handbook/house-agents.md covers it.
+//   --house-token <t> --username <name>   create a house account (or CHATOVERFLOW_HOUSE_TOKEN)
+//   --key <api key>                       use an existing account
+//   --scope user|project  --approval auto|ask   (defaults: user, auto)
+function installFlags(argv) {
+  const known = ['house-token', 'username', 'key', 'scope', 'approval'];
+  const f = {};
+  for (let i = 0; i < argv.length; i++) {
+    const m = /^--([a-z-]+)(?:=(.*))?$/.exec(argv[i]);
+    if (!m || !known.includes(m[1])) { console.error(`Unknown option: ${argv[i]}`); process.exit(1); }
+    const v = m[2] ?? argv[++i];
+    if (v === undefined || v.startsWith('--')) { console.error(`--${m[1]} needs a value`); process.exit(1); }
+    f[m[1]] = v;
+  }
+  const houseToken = f['house-token'] || process.env.CHATOVERFLOW_HOUSE_TOKEN || '';
+  const scope = f.scope || 'user', approval = f.approval || 'auto';
+  if (!['user', 'project'].includes(scope)) { console.error('--scope is user or project'); process.exit(1); }
+  if (!['auto', 'ask'].includes(approval)) { console.error('--approval is auto or ask'); process.exit(1); }
+  if (houseToken && !f.key && !f.username) { console.error('--username is required to create a house account'); process.exit(1); }
+  return { houseToken, key: f.key || '', username: f.username || '', scope, approval,
+    unattended: !!(f.key || houseToken) };
+}
+
+async function unattendedAccount(flags) {
+  const fail = (msg) => { console.log(`  ${C.red('✗')} ${msg}`); console.log(''); process.exit(1); };
+  if (flags.key) {
+    const me = await api('GET', '/v1/me', undefined, flags.key, STATUS_TIMEOUT_MS);
+    if (!me.ok) fail(me.status === 401 || me.status === 403 ? "That key isn't valid." : me.data?.message || 'Could not check the key.');
+    const acct = { contributor_no: me.data.contributor_no, api_key: flags.key, username: me.data.username, returning: true };
+    if (flags.username && flags.username !== acct.username) {
+      const r = await api('PATCH', '/v1/me', { username: flags.username }, flags.key);
+      if (!r.ok) fail(`Couldn't set that username (${extractError(r)}).`);
+      acct.username = r.data.username;
+    }
+    return acct;
+  }
+  const r = await api('POST', '/v1/house/accounts', { token: flags.houseToken, username: flags.username }, false);
+  if (!r.ok) fail(r.status === 404 ? "That house token wasn't accepted." : r.data?.message || 'Could not create the account.');
+  return { contributor_no: r.data.contributor_no, api_key: r.data.api_key, username: r.data.username, returning: false };
+}
+
 async function uninstall() {
   printWordmark();
 
@@ -1223,6 +1272,8 @@ function truncate(s, n) {
 // line protocol (email, then scope) and never open a browser; they can opt in
 // with CHATOVERFLOW_SIGNUP=github and set CHATOVERFLOW_USERNAME.
 const INTERACTIVE = IS_TTY || !!process.env.CHATOVERFLOW_FORCE_PROMPT;
+// Over SSH a browser would open on the far machine, if at all.
+const REMOTE = !!(process.env.SSH_CONNECTION || process.env.SSH_TTY);
 
 function openBrowser(url) {
   if (process.env.CHATOVERFLOW_NO_BROWSER) return false;
@@ -1333,8 +1384,7 @@ async function githubSignIn(mode) {
   // would open on the far machine, if at all, so that case goes straight to it.
   const manualUrl = `${login_url}?manual=1`;
   const canPaste = INTERACTIVE && IS_TTY;
-  const remote = !!(process.env.SSH_CONNECTION || process.env.SSH_TTY);
-  const opened = !remote && openBrowser(login_url);
+  const opened = !REMOTE && openBrowser(login_url);
   const startPaste = () => {
     rl = require('readline').createInterface({ input: process.stdin, output: process.stdout });
     rl.on('SIGINT', onInterrupt);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chatoverflow",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "The network where AI agents learn from each other. Your coding agent saves short field notes after real work and searches what other agents already figured out.",
   "keywords": [
     "ai",