@silo-code/sdk 0.20.0 → 0.22.0

package/dist/network-service.d.ts

@@ -1,3 +1,25 @@
+/**
+ * Thrown by {@link NetworkService.fetch} and {@link NetworkService.fetchHeaders}
+ * when a request fails (network error, DNS failure, TLS error, timeout, etc.).
+ *
+ * ```ts
+ * try {
+ *   const res = await ctx.net.fetch("https://api.example.com/data");
+ * } catch (err) {
+ *   if (err instanceof NetworkError) {
+ *     console.error(`Request to ${err.url} failed: ${err.message}`);
+ *   }
+ * }
+ * ```
+ *
+ * @category Core Types
+ * @public
+ */
+export declare class NetworkError extends Error {
+    /** The URL that was requested when the error occurred. */
+    readonly url: string;
+    constructor(url: string, message: string);
+}
 /**
  * Options for {@link NetworkService.fetch} and {@link NetworkService.fetchHeaders}.
  *
@@ -12,8 +34,12 @@ export interface NetworkRequestOptions {
     method?: "GET" | "HEAD" | "POST" | "PUT" | "DELETE" | "PATCH";
     /** Request headers to send. */
     headers?: Record<string, string>;
-    /** Request body (string). Only meaningful for methods that carry a body. */
-    body?: string;
+    /**
+     * Request body. A string is sent as-is; an `ArrayBuffer` / `Uint8Array` is
+     * sent as raw bytes (e.g. uploading a file). Only meaningful for methods that
+     * carry a body.
+     */
+    body?: string | ArrayBuffer | Uint8Array;
     /** Follow HTTP redirects. Defaults to `true`. */
     followRedirects?: boolean;
     /** Request timeout in milliseconds. Omit for the platform default (~30 s). */
@@ -38,6 +64,23 @@ export interface NetworkResponse {
     /** Final URL after redirects. */
     finalUrl: string;
 }
+/**
+ * Response from {@link NetworkService.fetchBytes} — identical to
+ * {@link NetworkResponse} but with the body delivered as raw bytes.
+ *
+ * @category Core Types
+ * @public
+ */
+export interface NetworkBytesResponse {
+    /** HTTP status code. */
+    status: number;
+    /** Response headers, lowercased (multi-value joined with `", "`). */
+    headers: Record<string, string>;
+    /** Response body as raw bytes. */
+    body: ArrayBuffer;
+    /** Final URL after redirects. */
+    finalUrl: string;
+}
 /**
  * Server-side HTTP client exposed as {@link ExtensionContext.net}. Requests
  * run in the Rust backend via `reqwest`, so they bypass the browser's CORS
@@ -60,7 +103,7 @@ export interface NetworkService {
      *
      * @param url - The URL to fetch.
      * @param options - Method, headers, body, redirect and timeout controls.
-     * @throws A string error message if the request fails (network error, DNS
+     * @throws {@link NetworkError} if the request fails (network error, DNS
      *   failure, TLS error, etc.).
      *
      * @example
@@ -69,6 +112,29 @@ export interface NetworkService {
      * ```
      */
     fetch(url: string, options?: NetworkRequestOptions): Promise<NetworkResponse>;
+    /**
+     * Like {@link NetworkService.fetch}, but resolves the response body as raw
+     * bytes ({@link NetworkBytesResponse}) instead of decoding it as UTF-8 text —
+     * for downloading images, archives, or any binary payload.
+     *
+     * @param url - The URL to fetch.
+     * @param options - Method, headers, body, redirect and timeout controls. The
+     *   body may itself be binary (`ArrayBuffer` / `Uint8Array`).
+     * @throws {@link NetworkError} if the request fails.
+     *
+     * @remarks
+     * The body rides Tauri's binary IPC channel (no base64), but the whole
+     * response is still buffered in memory on both sides — suitable for typical
+     * asset downloads (up to a few tens of MB), not for streaming multi-hundred-MB
+     * files.
+     *
+     * @example
+     * ```ts
+     * const { body } = await ctx.net.fetchBytes("https://example.com/logo.png");
+     * await ctx.files.writeBytes("logo.png", body);
+     * ```
+     */
+    fetchBytes(url: string, options?: NetworkRequestOptions): Promise<NetworkBytesResponse>;
     /**
      * Send a `HEAD` request and return only the response headers — no body is
      * downloaded. More efficient than {@link NetworkService.fetch} when you only
@@ -80,7 +146,7 @@ export interface NetworkService {
      * @param url - The URL to probe.
      * @param options - Redirect and timeout controls (`method` and `body` are
      *   ignored — this is always a HEAD request).
-     * @throws A string error message if the request fails.
+     * @throws {@link NetworkError} if the request fails.
      *
      * @example
      * ```ts

package/dist/network-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"network-service.d.ts","sourceRoot":"","sources":["../src/network-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC9D,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAE9E;;;;;;;;;;;;;;;;;;OAkBG;IACH,YAAY,CACV,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,iBAAiB,GAAG,WAAW,CAAC,GACrE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpC"}
+{"version":3,"file":"network-service.d.ts","sourceRoot":"","sources":["../src/network-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,0DAA0D;IAC1D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CASzC;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC9D,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;IACzC,iDAAiD;IACjD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,kCAAkC;IAClC,IAAI,EAAE,WAAW,CAAC;IAClB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAE9E;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,UAAU,CACR,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAEjC;;;;;;;;;;;;;;;;;;OAkBG;IACH,YAAY,CACV,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,iBAAiB,GAAG,WAAW,CAAC,GACrE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpC"}

package/dist/network-service.js

@@ -1,2 +1,36 @@
-export {};
+/**
+ * Thrown by {@link NetworkService.fetch} and {@link NetworkService.fetchHeaders}
+ * when a request fails (network error, DNS failure, TLS error, timeout, etc.).
+ *
+ * ```ts
+ * try {
+ *   const res = await ctx.net.fetch("https://api.example.com/data");
+ * } catch (err) {
+ *   if (err instanceof NetworkError) {
+ *     console.error(`Request to ${err.url} failed: ${err.message}`);
+ *   }
+ * }
+ * ```
+ *
+ * @category Core Types
+ * @public
+ */
+export class NetworkError extends Error {
+    constructor(url, message) {
+        super(message);
+        /** The URL that was requested when the error occurred. */
+        Object.defineProperty(this, "url", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.name = "NetworkError";
+        this.url = url;
+        // Restore the prototype chain so `instanceof` works across the down-leveled
+        // class output the SDK ships (and across the host↔extension boundary, where
+        // there's a single shared SDK instance).
+        Object.setPrototypeOf(this, NetworkError.prototype);
+    }
+}
 //# sourceMappingURL=network-service.js.map

package/dist/network-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"network-service.js","sourceRoot":"","sources":["../src/network-service.ts"],"names":[],"mappings":""}
+{"version":3,"file":"network-service.js","sourceRoot":"","sources":["../src/network-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IAIrC,YAAY,GAAW,EAAE,OAAe;QACtC,KAAK,CAAC,OAAO,CAAC,CAAC;QAJjB,0DAA0D;QACjD;;;;;WAAY;QAInB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,4EAA4E;QAC5E,4EAA4E;QAC5E,yCAAyC;QACzC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACtD,CAAC;CACF"}

package/dist/path.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Path utilities for extensions — a cross-platform replacement for
+ * `node:path`, which extensions are banned from importing. All output paths
+ * use forward-slash separators (the form {@link FileService} accepts on every
+ * platform). Both `/` and `\` are accepted as input separators.
+ *
+ * @example
+ * ```ts
+ * import { path } from "@silo-code/sdk";
+ *
+ * const dir  = path.dirname(filePath);            // "/home/user/docs"
+ * const full = path.join(dir, "images/fig.png");  // "/home/user/docs/images/fig.png"
+ * const rel  = path.relative(dir, full);           // "images/fig.png"
+ * const ext  = path.extname(full);                 // ".png"
+ * ```
+ *
+ * @category Core Types
+ * @public
+ */
+export declare const path: {
+    /**
+     * Join path segments and normalize the result. Empty segments are ignored;
+     * `\` separators in any segment are treated as `/`.
+     */
+    join(...parts: string[]): string;
+    /**
+     * Return the directory portion of a path — everything up to (not including)
+     * the last `/`. Returns `"."` for a bare filename with no directory component.
+     */
+    dirname(p: string): string;
+    /**
+     * Return the final component of a path. If `ext` is supplied and the
+     * basename ends with that string, it is stripped from the result.
+     */
+    basename(p: string, ext?: string): string;
+    /**
+     * Return the extension of a path — the portion from the last `.` of the
+     * basename, including the dot. Returns `""` for paths with no extension and
+     * for dotfiles with no secondary extension (e.g. `".gitignore"` → `""`).
+     */
+    extname(p: string): string;
+    /**
+     * Compute the relative path from `from` to `to`. Both should be absolute
+     * paths on the same drive. When they are on different Windows drive letters,
+     * `to` (normalized) is returned unchanged — no relative path exists between
+     * drives.
+     */
+    relative(from: string, to: string): string;
+    /**
+     * Return `true` if `p` is an absolute path: starts with `/` (POSIX), has a
+     * drive letter followed by a slash (`C:/`, `C:\`), or is a UNC path
+     * (`\\server\share` / `//server/share`). Note: `C:foo` (drive-relative,
+     * no slash) is NOT absolute.
+     */
+    isAbsolute(p: string): boolean;
+    /**
+     * Normalize a path: convert `\` to `/`, collapse duplicate slashes, and
+     * resolve `.` and `..` segments.
+     */
+    normalize(p: string): string;
+};
+//# sourceMappingURL=path.d.ts.map

package/dist/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../src/path.ts"],"names":[],"mappings":"AAiDA;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,IAAI,EAAE;IACjB;;;OAGG;IACH,IAAI,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IACjC;;;OAGG;IACH,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1C;;;;OAIG;IACH,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3C;;;;;OAKG;IACH,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B;;;OAGG;IACH,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CA+E9B,CAAC"}

package/dist/path.js

@@ -0,0 +1,150 @@
+// Pure path utilities for extensions. A cross-platform replacement for
+// `node:path`, which extensions are banned from importing (platform ban).
+// All outputs use forward-slash separators — the form FileService accepts on
+// every platform. Both "/" and "\" are accepted as inputs.
+/** Normalize all separators to forward-slash. */
+function normSep(p) {
+    return p.replace(/\\/g, "/");
+}
+/** Extract a Windows drive-letter prefix ("C:") from a forward-slash path, or null. */
+function parseDrive(p) {
+    const m = /^([A-Za-z]):/.exec(p);
+    return m ? m[1].toUpperCase() + ":" : null;
+}
+/**
+ * Normalize segments of a forward-slash path: collapse duplicate slashes,
+ * resolve "." and ".." segments. Preserves leading "/" (POSIX absolute),
+ * "C:/" (Windows drive-letter), and "//" (UNC paths).
+ */
+function normSegments(s) {
+    const drive = parseDrive(s);
+    const afterDrive = drive ? s.slice(2) : s;
+    const isUnc = afterDrive.startsWith("//");
+    const isAbs = isUnc || afterDrive.startsWith("/");
+    const stack = [];
+    for (const seg of afterDrive.split("/")) {
+        if (seg === "" || seg === ".")
+            continue;
+        if (seg === "..") {
+            if (stack.length > 0 && stack[stack.length - 1] !== "..") {
+                stack.pop();
+            }
+            else if (!isAbs) {
+                stack.push("..");
+            }
+        }
+        else {
+            stack.push(seg);
+        }
+    }
+    let result = stack.join("/");
+    if (isUnc)
+        result = "//" + result;
+    else if (isAbs)
+        result = "/" + result;
+    if (drive)
+        result = drive + result;
+    if (!result)
+        return isAbs ? (drive ? drive + "/" : "/") : ".";
+    return result;
+}
+/**
+ * Path utilities for extensions — a cross-platform replacement for
+ * `node:path`, which extensions are banned from importing. All output paths
+ * use forward-slash separators (the form {@link FileService} accepts on every
+ * platform). Both `/` and `\` are accepted as input separators.
+ *
+ * @example
+ * ```ts
+ * import { path } from "@silo-code/sdk";
+ *
+ * const dir  = path.dirname(filePath);            // "/home/user/docs"
+ * const full = path.join(dir, "images/fig.png");  // "/home/user/docs/images/fig.png"
+ * const rel  = path.relative(dir, full);           // "images/fig.png"
+ * const ext  = path.extname(full);                 // ".png"
+ * ```
+ *
+ * @category Core Types
+ * @public
+ */
+export const path = {
+    normalize(p) {
+        return normSegments(normSep(p));
+    },
+    join(...parts) {
+        const nonEmpty = parts.filter((p) => p.length > 0);
+        if (nonEmpty.length === 0)
+            return ".";
+        // Concatenate without adding "/" when adjacent parts already supply the
+        // boundary, so join("/", "rel") → "/rel" rather than "//rel" (UNC).
+        const raw = nonEmpty.map(normSep).reduce((a, b) => {
+            if (a.endsWith("/") || b.startsWith("/"))
+                return a + b;
+            return a + "/" + b;
+        });
+        return normSegments(raw);
+    },
+    dirname(p) {
+        const n = normSegments(normSep(p));
+        const drive = parseDrive(n);
+        const rest = drive ? n.slice(2) : n;
+        const i = rest.lastIndexOf("/");
+        if (i < 0)
+            return drive ? drive + "." : ".";
+        if (i === 0)
+            return drive ? drive + "/" : "/";
+        return drive ? drive + rest.slice(0, i) : rest.slice(0, i);
+    },
+    basename(p, ext) {
+        const n = normSep(p);
+        const segs = n.split("/");
+        let name = segs[segs.length - 1] ?? "";
+        // Trailing slash: "foo/" → last segment is "" → fall back to prior segment
+        if (name === "" && segs.length > 1)
+            name = segs[segs.length - 2] ?? "";
+        if (ext !== undefined && name.endsWith(ext)) {
+            name = name.slice(0, name.length - ext.length);
+        }
+        return name;
+    },
+    extname(p) {
+        const base = path.basename(normSep(p));
+        const i = base.lastIndexOf(".");
+        // i === 0 means a dotfile like ".gitignore" — no extension
+        if (i <= 0)
+            return "";
+        return base.slice(i);
+    },
+    isAbsolute(p) {
+        const n = normSep(p);
+        if (n.startsWith("//"))
+            return true; // UNC (\\server\share or //server/share)
+        if (/^[A-Za-z]:\//.test(n))
+            return true; // Windows drive with slash (C:/ or C:\)
+        return n.startsWith("/"); // POSIX
+    },
+    relative(from, to) {
+        const nFrom = normSegments(normSep(from));
+        const nTo = normSegments(normSep(to));
+        const driveFrom = parseDrive(nFrom);
+        const driveTo = parseDrive(nTo);
+        // Can't express a relative path across different drives
+        if (driveFrom !== driveTo)
+            return nTo;
+        const segsFrom = (driveFrom ? nFrom.slice(2) : nFrom)
+            .split("/")
+            .filter(Boolean);
+        const segsTo = (driveTo ? nTo.slice(2) : nTo).split("/").filter(Boolean);
+        let common = 0;
+        while (common < segsFrom.length &&
+            common < segsTo.length &&
+            segsFrom[common] === segsTo[common]) {
+            common++;
+        }
+        const ups = segsFrom.length - common;
+        const downs = segsTo.slice(common);
+        const parts = [...Array(ups).fill(".."), ...downs];
+        return parts.join("/") || ".";
+    },
+};
+//# sourceMappingURL=path.js.map

package/dist/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../src/path.ts"],"names":[],"mappings":"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"}

package/dist/process-service.d.ts

@@ -61,6 +61,24 @@ export interface ProcessExecOptions {
      * {@link Permission}. First-party (bundled) extensions are unscoped.
      */
     cwd?: string;
+    /**
+     * Extra environment variables, **merged over** the host's environment (the
+     * command inherits the host env; these keys add to or override it). Use it to
+     * set things like `GIT_PAGER=cat` or a locale without clobbering `PATH`.
+     */
+    env?: Record<string, string>;
+    /**
+     * Kill the process and reject after this many milliseconds. The whole process
+     * group is terminated (not just the direct child), so shell wrappers don't
+     * leak orphans. The rejection is an `Error` whose `name` is `"AbortError"`.
+     */
+    timeoutMs?: number;
+    /**
+     * Abort handle. Aborting kills the process (and its group) and rejects the
+     * `exec` promise with an `Error` whose `name` is `"AbortError"` — the same
+     * shape as a `timeoutMs` expiry, so callers branch on `err.name`.
+     */
+    signal?: AbortSignal;
 }
 /**
  * The captured result of a one-shot subprocess, returned by
@@ -108,10 +126,12 @@ export interface ProcessService {
      * interactive sessions instead.
      *
      * Runs **off the UI thread**, so a slow or network-bound command never
-     * stutters the app. The returned promise rejects only if the process could
-     * not be spawned (e.g. the command was not found); a command that runs but
-     * exits non-zero **resolves** — check {@link ProcessExecResult.code} and
-     * {@link ProcessExecResult.stderr}.
+     * stutters the app. The returned promise rejects if the process could not be
+     * spawned (e.g. the command was not found), or if a
+     * {@link ProcessExecOptions.timeoutMs | timeout} / {@link ProcessExecOptions.signal | abort}
+     * fires (an `Error` with `name === "AbortError"`); a command that runs to
+     * completion but exits non-zero **resolves** — check
+     * {@link ProcessExecResult.code} and {@link ProcessExecResult.stderr}.
      *
      * @param command - Executable to run (resolved via `PATH`), e.g. `"git"`.
      * @param args - Arguments passed verbatim — not shell-interpreted, so no

package/dist/process-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process-service.d.ts","sourceRoot":"","sources":["../src/process-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAK1C;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oDAAoD;IACpD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,4CAA4C;IAC5C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,6EAA6E;IAC7E,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,kDAAkD;IAClD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,2DAA2D;IAC3D,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,UAAU,CAAC;IACrD,4DAA4D;IAC5D,MAAM,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,UAAU,CAAC;CAC1D;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,KAAK,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC1D;;;OAGG;IACH,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GACtC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3B;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC/B"}
+{"version":3,"file":"process-service.d.ts","sourceRoot":"","sources":["../src/process-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAK1C;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oDAAoD;IACpD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,4CAA4C;IAC5C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,6EAA6E;IAC7E,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,kDAAkD;IAClD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,2DAA2D;IAC3D,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,UAAU,CAAC;IACrD,4DAA4D;IAC5D,MAAM,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,UAAU,CAAC;CAC1D;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,KAAK,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC1D;;;OAGG;IACH,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GACtC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC/B"}

package/dist/processes-service.d.ts

@@ -80,7 +80,7 @@ export interface ProcessInfo {
  * // Notify when all agents in the workspace are idle.
  * const sub = ctx.processes.subscribe((procs) => {
  *   const allIdle = procs.every((p) => p.atPrompt);
- *   if (allIdle) ctx.ui.notify({ title: "All agents finished" });
+ *   if (allIdle) ctx.ui.notify("info", "All agents finished");
  * });
  * ctx.subscriptions.push(sub);
  *

package/dist/search-service.d.ts

@@ -38,6 +38,17 @@ export interface SearchOptions {
      * is hit, the search stops early and {@link SearchResponse.truncated} is true.
      */
     maxResults?: number;
+    /**
+     * Cancel the search. When the signal aborts, the promise returned by
+     * {@link SearchService.search} rejects with an `Error` whose `name` is
+     * `"AbortError"` (the `fetch` convention — branch on `err.name`).
+     *
+     * Cancellation is observable immediately, but the native search may still run
+     * to completion in the background — its result is simply discarded. Use this
+     * to abandon a stale query (e.g. superseded by the next keystroke) rather than
+     * to reclaim native CPU the instant you abort.
+     */
+    signal?: AbortSignal;
 }
 /**
  * One matching line within a file, returned in {@link SearchFileResult.matches}.

package/dist/search-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-service.d.ts","sourceRoot":"","sources":["../src/search-service.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,yEAAyE;IACzE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gFAAgF;IAChF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iEAAiE;IACjE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,0FAA0F;IAC1F,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,MAAM,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACjC;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACzE"}
+{"version":3,"file":"search-service.d.ts","sourceRoot":"","sources":["../src/search-service.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,yEAAyE;IACzE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gFAAgF;IAChF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iEAAiE;IACjE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,0FAA0F;IAC1F,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,MAAM,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACjC;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACzE"}

package/dist/system-service.d.ts

@@ -48,13 +48,13 @@ export interface SystemInfo {
  *       ctx.subscriptions.push(
  *         ctx.registerCommand({
  *           id: "my.reveal-in-finder",
- *           title: "Reveal in Finder",
+ *           label: "Reveal in Finder",
  *           run() { ... },
  *         }),
  *       );
  *     }
  *
- *     ctx.ui.notify({ title: `Running Silo ${siloVersion} on ${os}/${arch}` });
+ *     ctx.ui.notify("info", `Running Silo ${siloVersion} on ${os}/${arch}`);
  *   },
  * };
  * ```

package/dist/terminal-service.d.ts

@@ -91,10 +91,47 @@ export interface TerminalService {
      * Open a new terminal in a workspace (defaults to the active one). Returns the
      * created {@link TerminalRecord}; the PTY session spawns lazily when its tab
      * mounts.
+     *
+     * Returns `undefined` only when `input.workspaceId` is not given and there is
+     * no active workspace at the time of the call — in normal use this does not
+     * happen because activating any workspace happens before extensions run.
      */
     create(input?: CreateTerminalInput): TerminalRecord | undefined;
     /** Close and kill every terminal in a workspace (e.g. on workspace delete). */
     closeWorkspace(workspaceId: string): void;
+    /**
+     * Write text to a terminal's PTY as if the user typed it. By default a
+     * carriage return is appended so the line executes; pass `addNewline: false`
+     * to stage text without running it.
+     *
+     * Works even if the terminal tab has never been shown: the PTY spawns lazily
+     * on first mount, and `sendText` force-spawns it on demand (a later mount then
+     * attaches to that same session). No-op for an unknown `terminalId`.
+     *
+     * @param terminalId - The {@link TerminalRecord.id} to write to.
+     * @param text - The text to send.
+     * @param addNewline - Append a carriage return to execute. Defaults to `true`.
+     *
+     * @example
+     * ```ts
+     * const term = ctx.terminals.create({ cwd: workspaceFolder });
+     * if (term) ctx.terminals.sendText(term.id, "npm run build");
+     * ```
+     */
+    sendText(terminalId: string, text: string, addNewline?: boolean): void;
+    /**
+     * Close one terminal tab and kill its PTY session. No-op if the id is unknown.
+     * To reap every terminal in a workspace at once use
+     * {@link TerminalService.closeWorkspace}.
+     */
+    close(terminalId: string): void;
+    /**
+     * Set a terminal's user-facing name ({@link TerminalRecord.customName}),
+     * shown on its tab and persisted across restarts. Passing an empty string
+     * clears the custom name, letting the PTY-derived title take over again.
+     * No-op for an unknown `terminalId`.
+     */
+    rename(terminalId: string, name: string): void;
     /**
      * Switch to the workspace containing this terminal and activate its tab in
      * the center dock. No-ops if the terminal id is unknown.
@@ -152,5 +189,34 @@ export interface TerminalService {
      * ```
      */
     subscribeOsc(terminalId: string, handler: (event: OscEvent) => void): Disposable;
+    /**
+     * The record id of the terminal tab that is currently active in the active
+     * workspace's center dock, or `null` when an editor tab (or nothing) is
+     * active. "Active" is the dock's single active panel — the tab the user is
+     * looking at and typing into — so a terminal merely visible in a non-active
+     * split does not count.
+     */
+    getActive(): string | null;
+    /**
+     * Subscribe to active-terminal changes. The listener receives the terminal
+     * record id whenever a terminal tab becomes the active center-dock panel,
+     * and `null` when activation moves elsewhere (an editor tab, or no panel —
+     * including transiently during a workspace switch, before the incoming
+     * workspace's active tab is published).
+     *
+     * Fires on tab activation, group activation, and workspace switches.
+     * Returns a {@link Disposable} that cancels the subscription.
+     *
+     * @example
+     * ```ts
+     * // Clear a "needs attention" marker once the user views the terminal.
+     * ctx.subscriptions.push(
+     *   ctx.terminals.subscribeActive((terminalId) => {
+     *     if (terminalId) attention.delete(terminalId);
+     *   }),
+     * );
+     * ```
+     */
+    subscribeActive(listener: (terminalId: string | null) => void): Disposable;
 }
 //# sourceMappingURL=terminal-service.d.ts.map

package/dist/terminal-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"terminal-service.d.ts","sourceRoot":"","sources":["../src/terminal-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEnE;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,QAAQ;IACvB,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;CACjB;AAGD,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEnE;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC;IACtB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,KAAK,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC;CACtD;AAED;;;;;;GAMG;AACH,MAAM,WAAW,6BAA6B;IAC5C,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAC;IACX;;;;OAIG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAAC;CAC3D;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,EAAE,mBAAmB,GAAG,cAAc,GAAG,SAAS,CAAC;IAChE,+EAA+E;IAC/E,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1C;;;OAGG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC;;;;;OAKG;IACH,qBAAqB,CAAC,QAAQ,EAAE,6BAA6B,GAAG,UAAU,CAAC;IAE3E;;;OAGG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAAC;IAEnE;;;;OAIG;IACH,wBAAwB,IAAI,IAAI,CAAC;IAEjC;;;OAGG;IACH,uBAAuB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,UAAU,CAAC;IAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,YAAY,CACV,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GACjC,UAAU,CAAC;CACf"}
+{"version":3,"file":"terminal-service.d.ts","sourceRoot":"","sources":["../src/terminal-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEnE;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,QAAQ;IACvB,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;CACjB;AAGD,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEnE;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC;IACtB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,KAAK,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC;CACtD;AAED;;;;;;GAMG;AACH,MAAM,WAAW,6BAA6B;IAC5C,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAC;IACX;;;;OAIG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAAC;CAC3D;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;OAQG;IACH,MAAM,CAAC,KAAK,CAAC,EAAE,mBAAmB,GAAG,cAAc,GAAG,SAAS,CAAC;IAChE,+EAA+E;IAC/E,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1C;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAEvE;;;;OAIG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC;;;;;OAKG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/C;;;OAGG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC;;;;;OAKG;IACH,qBAAqB,CAAC,QAAQ,EAAE,6BAA6B,GAAG,UAAU,CAAC;IAE3E;;;OAGG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAAC;IAEnE;;;;OAIG;IACH,wBAAwB,IAAI,IAAI,CAAC;IAEjC;;;OAGG;IACH,uBAAuB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,UAAU,CAAC;IAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,YAAY,CACV,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GACjC,UAAU,CAAC;IAEd;;;;;;OAMG;IACH,SAAS,IAAI,MAAM,GAAG,IAAI,CAAC;IAE3B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,eAAe,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,UAAU,CAAC;CAC5E"}

package/dist/theme-service.d.ts

@@ -2,11 +2,11 @@ import type { Disposable } from "./types";
 import type { ThemeBase, ThemeVars, CustomTheme, ThemeExport } from "./domain-types";
 export type { ThemeBase, ThemeVars, CustomTheme, ThemeExport, } from "./domain-types";
 /**
- * A selectable theme contributed via
- * {@link ExtensionContext.registerThemePreset}. Built-in presets (Tokyo Night,
- * Solarized Light, Gruvbox Dark, …) are registered by the `theme-presets`
- * extension; core ships only Dark and Light. A preset's {@link ThemePreset.vars}
- * are injected as CSS custom properties when it is the active theme.
+ * A selectable theme contributed via {@link ThemeService.registerPreset}.
+ * Built-in presets (Tokyo Night, Solarized Light, Gruvbox Dark, …) are
+ * registered by the `theme-presets` extension; core ships only Dark and Light.
+ * A preset's {@link ThemePreset.vars} are injected as CSS custom properties
+ * when it is the active theme.
  *
  * @category Registration
  * @public
@@ -58,8 +58,7 @@ export interface ThemeState {
  * Read via {@link ThemeService.getState | getState} /
  * {@link ThemeService.subscribe | subscribe} (e.g. with `useSyncExternalStore`);
  * drive via {@link ThemeService.setActive | setActive} and the custom-theme
- * methods. Contributing a *new* preset is a separate concern —
- * {@link ExtensionContext.registerThemePreset}.
+ * methods. Contribute a new preset via {@link ThemeService.registerPreset}.
  *
  * @category Consumer Services
  * @public
@@ -83,5 +82,22 @@ export interface ThemeService {
     exportTheme(theme: CustomTheme): ThemeExport;
     /** Validate/parse imported JSON into a custom theme (assigns a fresh id). */
     importTheme(data: unknown): CustomTheme;
+    /**
+     * Register a {@link ThemePreset} (a selectable theme in the picker). The
+     * preset appears immediately and is removed when the returned
+     * {@link Disposable} is disposed (typically when the extension deactivates).
+     *
+     * @example
+     * ```ts
+     * ctx.theme.registerPreset({
+     *   id: "my-theme",
+     *   name: "My Theme",
+     *   base: "dark",
+     *   colorScheme: "dark",
+     *   vars: { "--silo-color-bg": "#1a1a2e" },
+     * });
+     * ```
+     */
+    registerPreset(preset: ThemePreset): Disposable;
 }
 //# sourceMappingURL=theme-service.d.ts.map