@silo-code/sdk 0.6.0

package/dist/process-service.d.ts

@@ -0,0 +1,132 @@
+import type { Disposable } from "./types";
+/**
+ * Options for spawning a process session. Today sessions are shell PTYs, so
+ * `cwd` is required (the webview has no ambient working directory).
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface ProcessSpawnOptions {
+    /**
+     * Working directory the session starts in. Must resolve inside the open
+     * workspace unless the extension declared the `process` {@link Permission}
+     * (first-party extensions are unscoped); otherwise throws
+     * {@link PathDeniedError}.
+     */
+    cwd: string;
+    /** Initial column count. */
+    cols?: number;
+    /** Initial row count. */
+    rows?: number;
+}
+/**
+ * A live handle to one persistent process session, returned by
+ * {@link ProcessService.spawn} / {@link ProcessService.attach}. The underlying
+ * session **survives app restarts** — re-`attach` by {@link ProcessSession.id}
+ * to reconnect to a still-running session.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface ProcessSession {
+    /** Stable session id; pass to {@link ProcessService.attach} to reconnect. */
+    readonly id: string;
+    /** Write input to the session (e.g. keystrokes). */
+    write(data: string): void;
+    /** Notify the session its viewport size changed. */
+    resize(cols: number, rows: number): void;
+    /** Terminate the session and release it. */
+    kill(): Promise<void>;
+    /** Fetch the persisted output buffer (to restore a view after re-attach). */
+    getBuffer(): Promise<string>;
+    /** Persist an output buffer for later restore. */
+    saveBuffer(data: string): Promise<void>;
+    /** Subscribe to output data. Dispose to stop listening. */
+    onData(listener: (data: string) => void): Disposable;
+    /** Subscribe to session exit. Dispose to stop listening. */
+    onExit(listener: (exitCode: number) => void): Disposable;
+}
+/**
+ * Options for {@link ProcessService.exec}.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface ProcessExecOptions {
+    /**
+     * Working directory to run the command in. Defaults to the open **workspace
+     * folder** when omitted — the right cwd for CLI tools (git, formatters,
+     * linters) that operate on a repo. A `cwd` outside the workspace throws
+     * {@link PathDeniedError} unless the extension declared the `process`
+     * {@link Permission}. First-party (bundled) extensions are unscoped.
+     */
+    cwd?: string;
+}
+/**
+ * The captured result of a one-shot subprocess, returned by
+ * {@link ProcessService.exec}.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface ProcessExecResult {
+    /** Everything the command wrote to standard output. */
+    stdout: string;
+    /** Everything the command wrote to standard error. */
+    stderr: string;
+    /**
+     * The process exit code (`0` conventionally means success), or `-1` if the
+     * process was terminated by a signal. A non-zero `code` is **not** an error —
+     * `exec` resolves regardless; inspect `code`/`stderr` to decide.
+     */
+    code: number;
+}
+/**
+ * Persistent process / PTY sessions that **survive app restarts** — the core
+ * primitive under the terminal (and future task runners, REPLs) — plus one-shot
+ * {@link ProcessService.exec | exec} for fire-and-forget subprocess execution.
+ * Exposed as {@link ExtensionContext.process}.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface ProcessService {
+    /** Spawn a new session in `opts.cwd`. */
+    spawn(opts: ProcessSpawnOptions): Promise<ProcessSession>;
+    /**
+     * Re-attach to an existing session by id (e.g. after an app restart). Rejects
+     * with a 404-style error if the session no longer exists.
+     */
+    attach(id: string, opts?: {
+        cols?: number;
+        rows?: number;
+    }): Promise<ProcessSession>;
+    /**
+     * Run a one-shot command and resolve with its captured output — for
+     * extensions that wrap a CLI (git, formatters, linters) rather than drive an
+     * interactive shell. Use {@link ProcessService.spawn | spawn} for long-lived
+     * 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}.
+     *
+     * @param command - Executable to run (resolved via `PATH`), e.g. `"git"`.
+     * @param args - Arguments passed verbatim — not shell-interpreted, so no
+     *   quoting/escaping concerns and no shell-injection surface.
+     * @param options - Optional {@link ProcessExecOptions} (e.g. `cwd`).
+     * @example
+     * ```ts
+     * const { stdout, code } = await ctx.process.exec(
+     *   "git",
+     *   ["status", "--porcelain=v2"],
+     *   { cwd: workspaceFolder },
+     * );
+     * if (code === 0) parseStatus(stdout);
+     * ```
+     */
+    exec(command: string, args: string[], options?: ProcessExecOptions): Promise<ProcessExecResult>;
+}
+//# sourceMappingURL=process-service.d.ts.map

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

@@ -0,0 +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"}

package/dist/process-service.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=process-service.js.map

package/dist/process-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-service.js","sourceRoot":"","sources":["../src/process-service.ts"],"names":[],"mappings":""}

package/dist/terminal-service.d.ts

@@ -0,0 +1,38 @@
+import type { TerminalKind, TerminalRecord } from "./domain-types";
+export type { TerminalKind, TerminalRecord } from "./domain-types";
+/**
+ * Input for {@link TerminalService.create}.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface CreateTerminalInput {
+    /** Terminal kind — `"shell"` (default), `"claude"`, or `"pi"`. */
+    kind?: TerminalKind;
+    /** Working directory; falls back to the workspace folder when absent. */
+    cwd?: string;
+    /** Target workspace; defaults to the active workspace. */
+    workspaceId?: string;
+}
+/**
+ * Consumer API for the terminal domain, exposed as
+ * {@link ExtensionContext.terminals}. The terminal is a core feature — a
+ * built-in DockKind like the editor — so this mirrors {@link EditorService}:
+ * `create` opens a terminal tab in a workspace, and `closeWorkspace` reaps a
+ * workspace's terminals (used when a workspace is deleted). The tab itself is
+ * rendered by the core dock from the workspace's terminal records.
+ *
+ * @category Consumer Services
+ * @public
+ */
+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.
+     */
+    create(input?: CreateTerminalInput): TerminalRecord | undefined;
+    /** Close and kill every terminal in a workspace (e.g. on workspace delete). */
+    closeWorkspace(workspaceId: string): void;
+}
+//# sourceMappingURL=terminal-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-service.d.ts","sourceRoot":"","sources":["../src/terminal-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGnE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEnE;;;;;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;CAC3C"}

package/dist/terminal-service.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=terminal-service.js.map

package/dist/terminal-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-service.js","sourceRoot":"","sources":["../src/terminal-service.ts"],"names":[],"mappings":""}

package/dist/theme-service.d.ts

@@ -0,0 +1,87 @@
+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.
+ *
+ * @category Registration
+ * @public
+ */
+export interface ThemePreset {
+    /** Unique id (also the persisted `activeThemeId` when selected). */
+    id: string;
+    /** Display name shown in the theme picker. */
+    name: string;
+    /** Dark or light — drives the Monaco/xterm base and the `data-theme` attribute. */
+    base: ThemeBase;
+    /** The CSS `color-scheme` for native controls. */
+    colorScheme: "dark" | "light";
+    /** CSS variable overrides applied on top of the base palette in `theme.css`. */
+    vars: Partial<ThemeVars>;
+}
+/**
+ * A theme id resolved to its base + effective variables — what the theme picker
+ * renders swatches from, returned by {@link ThemeService.resolve}.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface ResolvedTheme {
+    base: ThemeBase;
+    colorScheme: "dark" | "light";
+    vars: Partial<ThemeVars>;
+}
+/**
+ * An immutable, frozen view of theme state, returned by
+ * {@link ThemeService.getState} and delivered to subscribers — read access
+ * without a Valtio dependency. `presets` is part of the state (not a static
+ * read) because presets are dynamic: extensions register and unregister them at
+ * runtime.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface ThemeState {
+    /** The active theme's id (a preset id or a custom theme id). */
+    activeId: string;
+    /** Core Dark/Light followed by every registered preset, in registration order. */
+    presets: readonly ThemePreset[];
+    /** The user's custom themes, loaded from disk. */
+    customThemes: readonly CustomTheme[];
+}
+/**
+ * Consumer API for the theme domain, exposed as {@link ExtensionContext.theme}.
+ * 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}.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface ThemeService {
+    /** Current frozen view of theme state. */
+    getState(): ThemeState;
+    /** Subscribe to theme-state changes (active theme, custom themes, or presets). */
+    subscribe(listener: (s: ThemeState) => void): Disposable;
+    /** Set the active theme by id (a built-in preset, registered preset, or custom). */
+    setActive(id: string): void;
+    /** Resolve a theme id to its base + effective vars (for previews/swatches). */
+    resolve(id: string): ResolvedTheme;
+    /** Persist a custom theme to disk and refresh the in-memory list. */
+    saveCustom(theme: CustomTheme): Promise<void>;
+    /** Delete a custom theme from disk and refresh the in-memory list. */
+    deleteCustom(id: string): Promise<void>;
+    /** Reload custom themes from disk into the store. */
+    reloadCustom(): Promise<void>;
+    /** Strip the id from a custom theme for sharing/serialization. */
+    exportTheme(theme: CustomTheme): ThemeExport;
+    /** Validate/parse imported JSON into a custom theme (assigns a fresh id). */
+    importTheme(data: unknown): CustomTheme;
+}
+//# sourceMappingURL=theme-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"theme-service.d.ts","sourceRoot":"","sources":["../src/theme-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,WAAW,EACX,WAAW,EACZ,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,SAAS,EACT,SAAS,EACT,WAAW,EACX,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAExB;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAC;IACX,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,IAAI,EAAE,SAAS,CAAC;IAChB,kDAAkD;IAClD,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,gFAAgF;IAChF,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACzB,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IAChC,kDAAkD;IAClD,YAAY,EAAE,SAAS,WAAW,EAAE,CAAC;CACtC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,QAAQ,IAAI,UAAU,CAAC;IACvB,kFAAkF;IAClF,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,GAAG,UAAU,CAAC;IACzD,oFAAoF;IACpF,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,+EAA+E;IAC/E,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,CAAC;IACnC,qEAAqE;IACrE,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,sEAAsE;IACtE,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,qDAAqD;IACrD,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,kEAAkE;IAClE,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAAC;IAC7C,6EAA6E;IAC7E,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,CAAC;CACzC"}

package/dist/theme-service.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=theme-service.js.map

package/dist/theme-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-service.js","sourceRoot":"","sources":["../src/theme-service.ts"],"names":[],"mappings":""}