@oddessentials/agent-guild 0.25.0 → 0.27.0

package/README.md

@@ -60,6 +60,14 @@ and come back to the same screens. Drag a session card by its grip, with a
 mouse or a finger, to put the cards in the order you want; this browser
 remembers it, and new sessions join at the end.
 
+**Two terminals at once.** **Split** in the terminal's header, or Ctrl+click
+(⌘-click on a Mac) on a card's **Open**, shows a second session beside the
+first, or above it on a tall, narrow window. Click a terminal to work in it;
+drag the divider, or focus it and use the arrow keys, to resize them. The
+session name in the header switches the focused terminal to another session.
+On a phone one terminal shows at a time, with a button to switch to the
+other. This browser reopens the terminals you had open after a reload.
+
 On a touchscreen, **Copy…** opens a still copy of the terminal text. Touch and
 hold to select, then use **Copy selection** or the browser's Copy menu. **Done**
 returns to the live terminal; the session keeps running while you copy. The
@@ -145,12 +153,27 @@ vX.Y.Z** switches over when you are ready. The version badge opens
 <img src="docs/images/whats-new.webp" alt="The What's new panel listing the release notes of each version">
 
 **Keep notes at hand.** **Notes** in the top bar opens a notepad for prompts,
-commands and to-dos, even while a terminal is open. It saves up to 100,000
-characters as you type and keeps them in this browser, never on the manager;
-every tab of the page shows the same notes.
-
-**Appearance.** The Appearance menu in the top bar picks a skin and light or
-dark mode, without a reload. **Guild** is the default fantasy look;
+commands and to-dos in the side panel, next to your terminals. It saves up to
+100,000 characters as you type and keeps them in this browser, never on the
+manager; every tab of the page shows the same notes.
+
+**GitHub beside your work.** **GitHub** in the top bar opens the side panel.
+Sign in to one or more GitHub accounts, then search the repositories of all
+of them from the box at its top; it starts on the repository the focused
+terminal's folder is a clone of. **Issues** lists, opens, edits and closes
+issues. **Actions** shows the latest workflow runs and whether one is still
+going, refreshing while it is on screen. **Pull requests** lists the open
+ones. **Repositories** lists and creates repositories and clones them over SSH
+with a key Agent Guild keeps for each account. On a wide window the side panel
+makes room for itself; on a smaller one it lies over the cards, and over the
+terminals when they would get too narrow. Drag its edge to resize it. Escape
+or **Close** puts it away.
+
+<img src="docs/images/workspace.webp" alt="Two terminals side by side with the GitHub panel showing the workflow runs of the focused terminal's repository">
+
+**Settings.** The Settings menu in the top bar picks a skin and light or
+dark mode, without a reload. On a narrow window the top bar's buttons gather
+under its menu button. **Guild** is the default fantasy look;
 **Professional** is a plain business look with no characters; **Orbital**
 puts a crew of little robots in deep space; **Grove** is a calm moss garden
 of gentle nature spirits; **Gnomeland** is a lantern-lit village of gnome
@@ -164,6 +187,12 @@ new version is discovered after the initial version check. Session activity
 and assistant responses have no sounds:
 the providers do not yet offer consistently reliable completion signals.
 
+The browser tab icon adds a rotating green ring whenever any session card says
+**Working**, including Shell and task cards. It mirrors the cards' terminal
+activity, not assistant completion. The ring remains visible with reduced
+motion or when the browser pauses animation. During a connection interruption,
+it reflects the last card state until the page reconnects.
+
 Sounds play in one eligible tab per browser and origin after browser playback
 permission (usually a click or keypress). They require Web Locks and writable
 local storage. Opening or reconnecting a page does not replay old alerts,
@@ -186,8 +215,8 @@ There is no added polling while connected and no additional monitoring process.
 | `agent-guild url` | Print the page URL with its access token. |
 | `agent-guild start` | Run the manager in the foreground, for debugging. |
 
-The page's **Restart manager** and **Stop manager** buttons do the same as
-`restart` and `stop`, but ask first while sessions are running. The page also
+**Restart manager** and **Stop manager** in the page's **Manager** menu do the
+same as `restart` and `stop`, but ask first while sessions are running. The page also
 asks before you close it with sessions running. Sessions end when the manager
 stops or the computer restarts.
 
@@ -227,7 +256,9 @@ Any other tool or script can report agents and its model too. See
 
 ## Security and privacy
 
-* The manager listens on `127.0.0.1` only.
+* The manager listens on `127.0.0.1` only. **Settings → Remote access** sets
+  up a private Tailscale address without restarting your terminals. See
+  [remote access and other proxies](docs/configuration.md#reverse-proxies).
 * Every API call needs a random per-user token, stored in the data folder
   with owner-only permissions. Anyone who can run programs as your user can
   read it, as with any local developer tool.
@@ -255,7 +286,7 @@ or prompts:
 | GitHub's releases API | What's new | Hourly |
 | herdr.dev and formulae.brew.sh | Multiplexer version checks | At most hourly, or on Refresh or a requested operation; disabled by `AGENT_GUILD_NO_UPDATE_CHECK=1` |
 | herdr.dev, GitHub release downloads, and the selected package manager's repositories | Multiplexer installation and updates | When you request the operation |
-| GitHub (sign-in, API, avatars and SSH) | Signing in to GitHub, listing your repositories, adding your SSH key and cloning | When you use **Clone from GitHub…** |
+| GitHub (sign-in, API, avatars and SSH) | Signing in to GitHub, listing your repositories, issues, workflow runs and pull requests, editing issues, adding your SSH key and cloning | When you use the GitHub panel; while its Actions tab shows, every few seconds during a run and every 30 seconds otherwise |
 
 ## Other front ends
 
@@ -278,6 +309,9 @@ npm test
   coding tool in `tests/fixtures`. CI runs them on Windows, macOS and Linux
   with Node.js 22, 24 and 26, and installs the packed package on x64 and
   arm64.
+* `node tests/browser/proxy.mjs` checks the real UI and terminal through a
+  local HTTPS proxy with an isolated manager and test certificates. Set
+  `CHROME_PATH` to Chrome or Edge if it is not in a standard location.
 * In a checkout, `launchers/AgentGuild.cmd` (Windows) and
   `launchers/AgentGuild.command` (macOS) start Agent Guild with a
   double-click.

package/bin/agent-guild.mjs

@@ -34,6 +34,8 @@ Commands:
 Environment:
   AGENT_GUILD_PORT             Port for the local API (default 47821)
   AGENT_GUILD_HOME             Data directory (default: per-user app data folder)
+  AGENT_GUILD_ALLOWED_HOSTS    Host fallback until Remote access settings are saved
+  AGENT_GUILD_ALLOWED_ORIGINS  Origin fallback until Remote access settings are saved
   AGENT_GUILD_NPM_REGISTRY     npm registry for version checks and installs
   AGENT_GUILD_NO_UPDATE_CHECK  Set to 1 to skip version checks`);
 }

package/node_modules/qrcode-generator/README.md

@@ -0,0 +1,101 @@
+QR Code Generator
+===
+
+## Getting Started
+
+1. Include qrcode.js in your html.
+2. Prepare a place holder.
+3. Generate QR and render it.
+
+```html
+<script type="text/javascript" src="qrcode.js"></script>
+```
+```html
+<div id="placeHolder"></div>
+```
+```javascript
+var typeNumber = 4;
+var errorCorrectionLevel = 'L';
+var qr = qrcode(typeNumber, errorCorrectionLevel);
+qr.addData('Hi!');
+qr.make();
+document.getElementById('placeHolder').innerHTML = qr.createImgTag();
+```
+## API Documentation
+
+### QRCodeFactory
+
+#### qrcode(typeNumber, errorCorrectionLevel) => <code>QRCode</code>
+Create a QRCode Object.
+
+| Param                | Type                | Description                                    |
+| ---------------------| ------------------- | ---------------------------------------------- |
+| typeNumber           | <code>number</code> | Type number (1 ~ 40), or 0 for auto detection. |
+| errorCorrectionLevel | <code>string</code> | Error correction level ('L', 'M', 'Q', 'H')    |
+
+#### qrcode.stringToBytes(s) : <code>number[]</code>
+Encodes a string into an array of number(byte) using any charset.
+This function is used by internal.
+Overwrite this function to encode using a multibyte charset.
+
+| Param  | Type                | Description      |
+| ------ | ------------------- | ---------------- |
+| s      | <code>string</code> | string to encode |
+
+### QRCode
+
+#### addData(data, mode) => <code>void</code>
+Add a data to encode.
+
+| Param  | Type                | Description                                                |
+| ------ | ------------------- | ---------------------------------------------------------- |
+| data   | <code>string</code> | string to encode                                           |
+| mode   | <code>string</code> | Mode ('Numeric', 'Alphanumeric', 'Byte'(default), 'Kanji') |
+
+#### make() => <code>void</code>
+Make a QR Code.
+
+#### getModuleCount() => <code>number</code>
+The number of modules(cells) for each orientation.
+_[Note] call make() before this function._
+
+#### isDark(row, col) => <code>boolean</code>
+The module at row and col is dark or not.
+_[Note] call make() before this function._
+
+| Param | Type                | Description         |
+| ----- | ------------------- | ------------------- |
+| row   | <code>number</code> | 0 ~ moduleCount - 1 |
+| col   | <code>number</code> | 0 ~ moduleCount - 1 |
+
+#### createDataURL(cellSize, margin) => <code>string</code>
+#### createImgTag(cellSize, margin, alt) => <code>string</code>
+#### createSvgTag(cellSize, margin) => <code>string</code>
+#### createTableTag(cellSize, margin) => <code>string</code>
+#### createASCII(cellSize, margin) => <code>string</code>
+Helper functions for HTML.
+ _[Note] call make() before these functions._
+
+| Param    | Type                | Description           |
+| -------- | ------------------- | --------------------- |
+| cellSize | <code>number</code> | default: 2            |
+| margin   | <code>number</code> | default: cellSize * 4 |
+| alt      | <code>string</code> | (optional)            |
+
+#### createSvgTag(opts) => <code>string</code>
+
+| Param         | Type                 | Description           |
+| ------------- | -------------------- | --------------------- |
+| opts          | <code>object</code>  | default: {}           |
+| opts.cellSize | <code>number</code>  | default: 2            |
+| opts.margin   | <code>number</code>  | default: cellSize * 4 |
+| opts.scalable | <code>boolean</code> | default: false        |
+
+#### renderTo2dContext(context, cellSize) => <code>void</code>
+
+--
+
+This implementation is based on JIS X 0510:1999.
+
+The word 'QR Code' is registered trademark of DENSO WAVE INCORPORATED
+<br/>http://www.denso-wave.com/qrcode/faqpatent-e.html

package/node_modules/qrcode-generator/dist/qrcode.d.ts

@@ -0,0 +1,57 @@
+//---------------------------------------------------------------------
+//
+// QR Code Generator for JavaScript - TypeScript Declaration File
+//
+// Copyright (c) 2016 Kazuhiko Arase
+//
+// URL: http://www.d-project.com/
+//
+// Licensed under the MIT license:
+//  http://www.opensource.org/licenses/mit-license.php
+//
+// The word 'QR Code' is registered trademark of
+// DENSO WAVE INCORPORATED
+//  http://www.denso-wave.com/qrcode/faqpatent-e.html
+//
+//---------------------------------------------------------------------
+
+type TypeNumber =
+  | 0 // Automatic type number
+  | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10
+  | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20
+  | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30
+  | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 40
+  ;
+
+type ErrorCorrectionLevel = 'L' | 'M' | 'Q' | 'H';
+
+type Mode = 'Numeric' | 'Alphanumeric' | 'Byte' /* Default */ | 'Kanji';
+
+interface QRCodeFactory {
+  (typeNumber: TypeNumber, errorCorrectionLevel: ErrorCorrectionLevel) : QRCode;
+  stringToBytes(s: string) : number[];
+  stringToBytesFuncs : { [encoding : string] : (s: string) => number[] };
+  createStringToBytes(unicodeData: string, numChars: number) :
+    (s : string) => number[];
+}
+
+interface QRCode {
+  addData(data: string, mode?: Mode) : void;
+  make() : void;
+  getModuleCount() : number;
+  isDark(row: number, col: number) : boolean;
+  createImgTag(cellSize?: number, margin?: number) : string;
+  createSvgTag(cellSize?: number, margin?: number) : string;
+  createSvgTag(opts? : { cellSize?: number, margin?: number,
+      scalable?: boolean }) : string;
+  createDataURL(cellSize?: number, margin?: number) : string;
+  createTableTag(cellSize?: number, margin?: number) : string;
+  createASCII(cellSize?: number, margin?: number) : string;
+  renderTo2dContext(context: CanvasRenderingContext2D, cellSize?: number): void;
+}
+
+declare var qrcode : QRCodeFactory;
+
+declare module 'qrcode-generator' {
+  export = qrcode;
+}