agent-sh 0.14.9 → 0.14.11

package/dist/cli/install.js

@@ -14,7 +14,16 @@ const EXT_DIR = path.join(CONFIG_DIR, "extensions");
 export function listBundled() {
     if (!fs.existsSync(BUNDLED_DIR))
         return [];
-    return fs.readdirSync(BUNDLED_DIR).map((n) => n.replace(/\.(ts|js|mjs)$/, ""));
+    const out = [];
+    for (const d of fs.readdirSync(BUNDLED_DIR, { withFileTypes: true })) {
+        if (d.name.startsWith("."))
+            continue;
+        if (d.isDirectory())
+            out.push(d.name);
+        else if (SCRIPT_EXTS.some((ext) => d.name.endsWith(ext)))
+            out.push(d.name.replace(/\.[^.]+$/, ""));
+    }
+    return out;
 }
 /** Heuristic: a backend named "pi" is typically provided by an extension called "pi-bridge". */
 export function suggestBridgeFor(backend) {

package/dist/shell/events.d.ts

@@ -32,6 +32,9 @@ declare module "../core/event-bus.js" {
             cols: number;
             rows: number;
         };
+        "shell:host-write": {
+            data: string;
+        };
         "shell:buffer-request": Record<string, never>;
         "shell:buffer-snapshot": {
             text: string;

package/dist/shell/shell.js

@@ -110,6 +110,9 @@ export class Shell {
         this.bus.on("shell:pty-resize", ({ cols, rows }) => {
             this.ptyProcess.resize(cols, rows);
         });
+        this.bus.on("shell:host-write", ({ data }) => {
+            this.terminal.write(data);
+        });
         // Compat shims for the bus-event API. shell:stdout-hold maps to hard
         // mute so terminal_keys' stdout-show can't paint through the overlay.
         let holdRefcount = 0;

package/dist/utils/diff-renderer.d.ts

@@ -13,6 +13,10 @@ export interface DiffRenderOptions {
     trueColor?: boolean;
     /** Enable syntax highlighting on diff lines. Default true. */
     syntaxHighlight?: boolean;
+    /** Draw the `│` rule between the line number and the code (default true). Set false
+     *  for a flush gutter: `<n> <sigil><code>`, the row background spans the line, and
+     *  context code is left un-dimmed. */
+    gutterLine?: boolean;
 }
 export declare function detectLanguage(filePath?: string): string | undefined;
 /**

package/dist/utils/diff-renderer.js

@@ -239,25 +239,35 @@ function unifiedLayout(diff, opts) {
         lineTextW: Math.max(1, textWidth - noW - 5),
         textWidth,
         useTrueColor: opts.trueColor !== false,
+        gutterLine: opts.gutterLine !== false,
         lang: opts.syntaxHighlight !== false ? detectLanguage(opts.filePath) : undefined,
         removedPalette: { rowBg: p.errorBg, emphBg: p.errorBgEmph },
         addedPalette: { rowBg: p.successBg, emphBg: p.successBgEmph },
     };
 }
 function renderUnifiedHunk(hunk, layout) {
-    const { noW, lineTextW, textWidth, useTrueColor, lang, removedPalette, addedPalette } = layout;
+    const { noW, lineTextW, textWidth, useTrueColor, gutterLine, lang, removedPalette, addedPalette } = layout;
     const out = [];
     const pairs = findChangePairs(hunk);
     const renderedAsPartOfPair = new Set();
     const bgWidth = Math.max(1, textWidth - noW - 3);
     const gutter = (n) => `${p.dim}${n} │${p.reset} `;
+    const change = (no, sigil, bg, fg, text) => {
+        if (!gutterLine) {
+            return `${bg}${padToWidth(`${no} ${fg}${sigil}${preserveBg(text, bg)}`, textWidth)}${p.reset}`;
+        }
+        if (useTrueColor)
+            return gutter(no) + padToWidth(`${bg}${fg}${sigil} ${preserveBg(text, bg)}`, bgWidth) + p.reset;
+        return `${gutter(no)}${fg}${sigil} ${text}${p.reset}`;
+    };
     for (let i = 0; i < hunk.lines.length; i++) {
         const line = hunk.lines[i];
         const no = String(line.type === "removed" ? (line.oldNo ?? "") : (line.newNo ?? line.oldNo ?? "")).padStart(noW);
         if (line.type === "context") {
             const raw = truncateText(line.text, lineTextW);
             const text = lang ? highlightLine(raw, lang) : raw;
-            out.push(`${gutter(no)}  ${p.dim}${text}${p.reset}`);
+            // The flush gutter dims only the line number; the code stays normal/highlighted.
+            out.push(!gutterLine ? `${p.dim}${no}${p.reset}  ${text}` : `${gutter(no)}  ${p.dim}${text}${p.reset}`);
             continue;
         }
         if (line.type === "removed") {
@@ -276,19 +286,9 @@ function renderUnifiedHunk(hunk, layout) {
                 const raw = truncateText(line.text, lineTextW);
                 removedText = lang ? highlightLine(raw, lang) : raw;
             }
-            if (useTrueColor) {
-                out.push(gutter(no) + padToWidth(`${p.errorBg}${p.error}- ${preserveBg(removedText, p.errorBg)}`, bgWidth) + p.reset);
-            }
-            else {
-                out.push(`${gutter(no)}${p.error}- ${removedText}${p.reset}`);
-            }
+            out.push(change(no, "-", p.errorBg, p.error, removedText));
             if (addedText !== null && addedNo !== null) {
-                if (useTrueColor) {
-                    out.push(gutter(addedNo) + padToWidth(`${p.successBg}${p.success}+ ${preserveBg(addedText, p.successBg)}`, bgWidth) + p.reset);
-                }
-                else {
-                    out.push(`${gutter(addedNo)}${p.success}+ ${addedText}${p.reset}`);
-                }
+                out.push(change(addedNo, "+", p.successBg, p.success, addedText));
             }
             continue;
         }
@@ -297,12 +297,7 @@ function renderUnifiedHunk(hunk, layout) {
                 continue;
             const raw = truncateText(line.text, lineTextW);
             const text = lang ? highlightLine(raw, lang) : raw;
-            if (useTrueColor) {
-                out.push(gutter(no) + padToWidth(`${p.successBg}${p.success}+ ${preserveBg(text, p.successBg)}`, bgWidth) + p.reset);
-            }
-            else {
-                out.push(`${gutter(no)}${p.success}+ ${text}${p.reset}`);
-            }
+            out.push(change(no, "+", p.successBg, p.success, text));
         }
     }
     return out;

package/examples/extensions/ads/SKILL.md

@@ -0,0 +1,170 @@
+---
+name: ads
+description: >-
+  Full ADS query syntax reference and search strategy for the ads_search, ads_paper, ads_citations,
+  and ads_download_pdf tools. Load this before composing ADS queries — the tool descriptions only
+  cover basic field prefixes. Contains: fielded search syntax, date/class filters (entdate, arxiv_class),
+  citation operators, wildcards, positional search, properties, doctypes, daily arXiv listing patterns,
+  and query recipes.
+---
+
+# ADS Query Syntax & Search Strategy
+
+Reference: <https://ui.adsabs.harvard.edu/help/search/>
+
+## Query Basics
+
+- Space = AND, `OR`, `NOT` / `-` (exclude), `()` group, `"phrase"`
+- Precedence: `NOT` > `AND` > `OR` > implicit-AND > `-`
+
+## Fielded Search
+
+### Text Fields
+
+| Field | Syntax |
+|-------|--------|
+| Title+Abstract+Keywords | `abs:"phrase"` |
+| Title only | `title:"phrase"` |
+| Abstract only | `abstract:"phrase"` |
+| Keywords | `keyword:"phrase"` |
+| Full text (body+abs+title+ack+kw) | `full:"phrase"` |
+| Body only | `body:"phrase"` |
+| Acknowledgements | `ack:"phrase"` |
+
+### Author
+
+| Syntax | Meaning |
+|--------|---------|
+| `author:"Last, F"` | Greedy match (initials, variations) |
+| `author:"Last, First M"` | More precise (recommended) |
+| `author:"^Last, F"` | First-author only |
+| `=author:"Last, F"` | Exact match, no synonym expansion |
+
+Precision: `author:"murray, s"` (broadest) → `"murray, stephen"` → `"murray, stephen s"` (tightest)
+
+### Identifiers & Publication
+
+`bibcode:ID`, `doi:DOI`, `arXiv:ID`, `identifier:ID`, `bibstem:ApJ`, `volume:N`, `issue:N`, `page:N`, `year:YYYY` or `year:YYYY-YYYY`, `pubdate:[YYYY-MM TO YYYY-MM]`
+
+### Affiliation
+
+`aff:"phrase"` (raw), `inst:"Harvard U"` (curated, matches variants), `inst:"UCLA/IGPP"` (department), `aff_id:ID`
+
+### Object & Position
+
+`object:Andromeda` (SIMBAD+NED), `object:"(SMC OR LMC) AND M31"` (combined), cone search: `object:"RA Dec:radius"` (decimal deg or sexagesimal, default 2', max 60')
+
+### Classification & Counts
+
+`database:astronomy|physics|general`, `doctype:type`, `arxiv_class:"class"`, `property:flag`, `bibgroup:name`, `citation_count:[10 TO 100]`, `author_count:[10 TO 100]`, `read_count:N`, `facility:/regex/`, `orcid:ID`, `grant:agency`
+
+## Synonyms & Case Sensitivity
+
+- lowercase → matches variations + synonyms (e.g. `title:star` → star, stars, stellar…)
+- UPPERCASE → acronym-only (`title:STAR` → only "STAR")
+- `=field:` prefix → exact match, no synonym expansion
+
+## Wildcards & Proximity
+
+| Syntax | Meaning |
+|--------|---------|
+| `*` / `?` | Multi/single-char wildcard |
+| `NEAR[N]` | ≤N words apart, any order |
+| `"term1 term2"~N` | In-order proximity within N positions |
+| `/regex/` | Lucene regex on indexed tokens |
+
+## Positional Search — `pos(query, positions...)`
+
+Works on: `author`, `aff`, `title`. Examples: `pos(author:"Oort, J", 2)` (2nd author), `pos(author:"Oort", 1,3)` (1st–3rd), `pos(author:"Oort", -1)` (last), `pos(aff:"harvard", 1)` (1st author at Harvard)
+
+## Citation & Reference Operators
+
+`citations(query)` = papers citing query results, `references(query)` = papers cited by query results. Nestable with other terms.
+
+## Second-Order Operators
+
+`similar(query)` (textually similar), `trending(query)` (read by same readers), `useful(query)` (frequently cited by results), `reviews(query)` (citing papers ranked by freq), `topn(N, query, sort)`
+
+Tip: `similar()` excludes originals; use disjoint `entdate` ranges to control overlap.
+
+## Properties
+
+`refereed`, `notrefereed`, `article`, `nonarticle`, `openaccess`, `ads_openaccess`, `pub_openaccess`, `eprint_openaccess`, `author_openaccess`, `data`, `esource`, `inspire`, `toc`
+
+## Document Types
+
+`article`, `eprint`, `inproceedings`, `inbook`, `abstract`, `book`, `bookreview`, `catalog`, `circular`, `erratum`, `mastersthesis`, `newsletter`, `obituary`, `phdthesis`, `pressrelease`, `proceedings`, `proposal`, `software`, `talk`, `techreport`, `misc`
+
+## Bibliographic Groups
+
+Institutional: ARI, CfA, CFHT, Leiden, USNO | Telescope: ALMA, CXC, ESO, Gemini, Herschel, HST, ISO, IUE, JCMT, Keck, Magellan, NOIRLab, NRAO, ROSAT, SDO, SMA, Spitzer, Subaru, Swift, UKIRT, XMM
+
+## Daily arXiv Listings
+
+Use `entdate` (day-resolution) with `doctype:eprint` and `arxiv_class`. Note: `pubdate` is month-resolution only.
+
+```
+# Today's astro-ph.CO (±2 day window)
+arxiv_class:"astro-ph.CO" entdate:[2026-04-07 TO 2026-04-09] doctype:eprint
+
+# All astro-ph classes
+arxiv_class:("astro-ph.CO" OR "astro-ph.GA" OR "astro-ph.HE" OR "astro-ph.IM" OR "astro-ph.EP" OR "astro-ph.SR") entdate:[2026-04-07 TO 2026-04-09] doctype:eprint
+```
+
+Subclasses: `CO` (Cosmology), `EP` (Earth & Planetary), `GA` (Galaxy Astrophysics), `HE` (High Energy), `IM` (Instrumentation), `SR` (Solar & Stellar).
+
+## Search Strategy: Simplicity First
+
+- Start with 2–3 core nouns. If too many results, add constraints (year, author, title:). Don't start with a sentence.
+- ADS is keyword/metadata matching, not semantic search. Overloading queries kills recall.
+- Use `detail='full'` on fewer results rather than compact on many — abstracts often contain the answer.
+
+### Common Pitfalls
+
+**1. Compound multi-concept queries → zero results.**
+Fix: 1–2 core terms + `sort_by` + `year_from:`. Scan abstracts for specifics.
+```
+# Bad: "Population III He II helium 1640 JWST metal-poor galaxy candidate"
+# Good: "Population III JWST"  sort_by:date  year_from:2024
+```
+
+**2. Non-article doctypes polluting results.**
+Fix: `doctype:article` or `property:refereed`.
+
+**3. Iterative reformulation without simplifying.**
+If 2+ zero-result queries on the same topic: strip to 1–2 broadest terms, or use `web_search` first to find titles/authors, then look up in ADS.
+
+**4. Use `web_search` → ADS as a two-step pipeline.**
+For complex/emerging topics, start with `web_search` (plural `queries`, 2–4 varied angles) to identify key papers/arXiv IDs, then verify via `ads_paper` or targeted `ads_search`.
+
+### When Keyword Search Fails, Use Citation Networks
+
+For interdisciplinary connections, find a known paper then walk citations (`ads_citations`) or references. Citation chains beat keyword matching for cross-domain discovery.
+
+## Quick Query Recipes
+
+```
+# Recent refereed articles on a topic
+abs:"dark energy" year:2023-2025 property:refereed doctype:article
+
+# Papers by first author at an institution
+author:"^smith, john" inst:"MIT"
+
+# Highly-cited reviews
+reviews("machine learning astronomy") property:refereed
+
+# Papers citing a specific work, sorted by citations
+citations(bibcode:2023ApJ...950L..12A) sort:citation_count
+
+# Object in specific journal
+object:Andromeda bibstem:ApJ
+
+# Open access with data links
+property:openaccess property:data keyword:"gravitational waves"
+
+# Exclude preprints, keep only journal articles
+abs:"transiting exoplanet" doctype:article -arxiv_class:*
+
+# Cone search
+object:"12h30m49.4s +12d29m40s:5"
+```