@alisio/core 0.4.5 → 0.5.1

package/dist/application.js

@@ -1306,6 +1306,10 @@ export async function createApplication(options = {}) {
                         config.tasks = { ...config.tasks, [leaf]: Number(value) };
                         break;
                     }
+                    case "web.iconTheme":
+                        // Read live by the icon-theme routes on the next request; `"none"` clears the theme.
+                        config.web = { ...config.web, iconTheme: String(value) };
+                        break;
                     case "websearch.provider":
                         // Mutated in place (same object identity) so the tool chain's per-call
                         // `websearchCtx.config` sees the new provider on the very next search call.

package/dist/config.d.ts

@@ -255,6 +255,9 @@ export declare const configSchema: z.ZodPipe<z.ZodObject<{
         active: z.ZodDefault<z.ZodString>;
         effort: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
+    web: z.ZodDefault<z.ZodObject<{
+        iconTheme: z.ZodDefault<z.ZodString>;
+    }, z.core.$strict>>;
 }, z.core.$strict>, z.ZodTransform<{
     schemaVersion: 1;
     provider: {
@@ -376,6 +379,9 @@ export declare const configSchema: z.ZodPipe<z.ZodObject<{
         active: string;
         effort?: string | undefined;
     };
+    web: {
+        iconTheme: string;
+    };
     mcp: {
         allow?: boolean | undefined;
         servers: {
@@ -580,6 +586,9 @@ export declare const configSchema: z.ZodPipe<z.ZodObject<{
         active: string;
         effort?: string | undefined;
     };
+    web: {
+        iconTheme: string;
+    };
 }>>;
 export type Config = z.infer<typeof configSchema>;
 export type ServerConfig = z.infer<typeof serverSchema>;
@@ -695,6 +704,7 @@ declare const SETTABLE_KEYS: {
     readonly "goal.blockedRepeats": z.ZodDefault<z.ZodNumber>;
     readonly "plan.diagrams": z.ZodDefault<z.ZodBoolean>;
     readonly "plan.maxDiagrams": z.ZodDefault<z.ZodNumber>;
+    readonly "web.iconTheme": z.ZodDefault<z.ZodString>;
 };
 export type SettableSettingKey = keyof typeof SETTABLE_KEYS;
 export declare function isSettableSettingKey(key: string): key is SettableSettingKey;

package/dist/config.js

@@ -85,6 +85,8 @@ export const OCI_IMAGE_PATTERN = /^[a-zA-Z0-9][^\s@]*@sha256:[a-f0-9]{64}$/;
 const GLOBAL_ONLY_ANALYSIS = ["runtime", "oci", "retention"];
 /** Decision Intelligence keys only the user (global) layer decides: the provider and telemetry. */
 const GLOBAL_ONLY_DECISIONS = ["provider", "telemetry"];
+/** Web UI keys only the user (global) layer decides: the server picks which theme it serves. */
+const GLOBAL_ONLY_WEB = ["iconTheme"];
 /** JSON values a plugin may receive as options (`pluginOverrides[id].options`). */
 const jsonValueSchema = z.lazy(() => z.union([
     z.string(),
@@ -503,6 +505,17 @@ const configObjectSchema = z
     })
         .strict()
         .default(() => ({ active: "build" })),
+    /**
+     * Web UI preferences. `iconTheme` names the active `icon-theme` extension point provider
+     * (`"none"` keeps the built-in inline icons). GLOBAL ONLY: the server decides which theme its
+     * files serve, so a repository cannot pick one.
+     */
+    web: z
+        .object({
+        iconTheme: z.string().trim().min(1).max(100).default("none"),
+    })
+        .strict()
+        .default(() => ({ iconTheme: "none" })),
 })
     .strict()
     .superRefine((config, context) => {
@@ -618,6 +631,9 @@ export async function loadConfigWithProvenance(workspace, options = {}) {
         const decisionsRaw = object.decisions && typeof object.decisions === "object" && !Array.isArray(object.decisions)
             ? object.decisions
             : {};
+        const webRaw = object.web && typeof object.web === "object" && !Array.isArray(object.web)
+            ? object.web
+            : {};
         const overridesRaw = object.pluginOverrides &&
             typeof object.pluginOverrides === "object" &&
             !Array.isArray(object.pluginOverrides)
@@ -626,6 +642,7 @@ export async function loadConfigWithProvenance(workspace, options = {}) {
         const ignored = [
             ...GLOBAL_ONLY_ANALYSIS.filter((key) => key in analysisRaw).map((key) => `analysis.${key}`),
             ...GLOBAL_ONLY_DECISIONS.filter((key) => key in decisionsRaw).map((key) => `decisions.${key}`),
+            ...GLOBAL_ONLY_WEB.filter((key) => key in webRaw).map((key) => `web.${key}`),
             ...Object.entries(overridesRaw)
                 .filter(([, entry]) => !!entry && typeof entry === "object" && !Array.isArray(entry) && "options" in entry)
                 .map(([id]) => `pluginOverrides.${id}.options`),
@@ -738,6 +755,11 @@ export async function loadConfigWithProvenance(workspace, options = {}) {
                 };
                 continue;
             }
+            if (key === "web") {
+                // `iconTheme` is global-only (the server decides which theme its files serve).
+                overlaid.web = { ...selected.config.web, iconTheme: global.config.web.iconTheme };
+                continue;
+            }
             overlaid[key] = selected.config[key];
         }
         if (selected.keys.has("mcp") || selected.keys.has("mcpServers"))
@@ -889,6 +911,7 @@ const SETTABLE_SECTIONS = {
     tasks: configObjectSchema.shape.tasks.removeDefault(),
     goal: configObjectSchema.shape.goal.removeDefault(),
     plan: configObjectSchema.shape.plan.removeDefault(),
+    web: configObjectSchema.shape.web.removeDefault(),
 };
 const ANALYSIS_LIMITS = SETTABLE_SECTIONS.analysis.shape.limits.removeDefault();
 const ANALYSIS_RETENTION = SETTABLE_SECTIONS.analysis.shape.retention.removeDefault();
@@ -938,6 +961,7 @@ const SETTABLE_KEYS = {
     "goal.blockedRepeats": SETTABLE_SECTIONS.goal.shape.blockedRepeats,
     "plan.diagrams": SETTABLE_SECTIONS.plan.shape.diagrams,
     "plan.maxDiagrams": SETTABLE_SECTIONS.plan.shape.maxDiagrams,
+    "web.iconTheme": SETTABLE_SECTIONS.web.shape.iconTheme,
 };
 export function isSettableSettingKey(key) {
     return Object.prototype.hasOwnProperty.call(SETTABLE_KEYS, key);

package/dist/extensions/registry.d.ts

@@ -1,8 +1,3 @@
-/**
- * Generic, typed extension registry. Resolution is deterministic and independent of plugin
- * load order: highest priority, then plugin id (lexicographic), then registration order
- * within the plugin. Fallbacks (built-in defaults) only win when nothing else is registered.
- */
 import type { ExtensionPoints } from "@alisio/sdk";
 export interface ExtensionConflict {
     point: string;
@@ -23,6 +18,14 @@ export declare class ExtensionRegistry {
         provider: ExtensionPoints[K];
         plugin: string;
     } | undefined;
+    /**
+     * Every provider of a point in resolution order (the same ranking `resolve` uses): highest
+     * priority first, plugin id and registration order as tie-breaks, fallbacks last.
+     */
+    list<K extends keyof ExtensionPoints>(point: K): Array<{
+        provider: ExtensionPoints[K];
+        plugin: string;
+    }>;
     /** Equal-priority, non-fallback competitors for each point's winning slot. */
     conflicts(point?: keyof ExtensionPoints): ExtensionConflict[];
 }

package/dist/extensions/registry.js

@@ -1,3 +1,9 @@
+/**
+ * Generic, typed extension registry. Resolution is deterministic and independent of plugin
+ * load order: highest priority, then plugin id (lexicographic), then registration order
+ * within the plugin. Fallbacks (built-in defaults) only win when nothing else is registered.
+ */
+import { isAbsolute } from "node:path";
 const key = (e) => `${e.plugin}/${e.provider.id}`;
 function compare(a, b) {
     if (a.fallback !== b.fallback)
@@ -17,6 +23,14 @@ export class ExtensionRegistry {
         // a throwing or malformed provider already falls back there (see `startup/index.ts`).
         if (!provider || typeof provider.id !== "string")
             throw new Error(`Invalid ${point} provider: it needs an id`);
+        if (point === "icon-theme") {
+            // The server reads these absolute paths: an empty id or a relative path can never resolve.
+            const theme = provider;
+            if (!theme.id.trim())
+                throw new Error("Invalid icon-theme provider: it needs a non-empty id");
+            if (!isAbsolute(theme.manifestPath) || !isAbsolute(theme.iconsDir))
+                throw new Error("Invalid icon-theme provider: manifestPath and iconsDir must be absolute paths");
+        }
         const priority = options.priority ?? 0;
         if (!Number.isFinite(priority))
             throw new Error("Extension priority must be a finite number");
@@ -40,6 +54,16 @@ export class ExtensionRegistry {
         const top = this.ranked(point)[0];
         return top ? { provider: top.provider, plugin: top.plugin } : undefined;
     }
+    /**
+     * Every provider of a point in resolution order (the same ranking `resolve` uses): highest
+     * priority first, plugin id and registration order as tie-breaks, fallbacks last.
+     */
+    list(point) {
+        return this.ranked(point).map((entry) => ({
+            provider: entry.provider,
+            plugin: entry.plugin,
+        }));
+    }
     /** Equal-priority, non-fallback competitors for each point's winning slot. */
     conflicts(point) {
         const points = point ? [point] : [...new Set(this.entries.map((e) => e.point))];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alisio/core",
-  "version": "0.4.5",
+  "version": "0.5.1",
   "description": "Embeddable provider-agnostic Alisio agent core: tool loop, context compaction, local tools, MCP, plugin host and SQLite session store. Runs on Node >=22.16 and Bun.",
   "author": "Gustavo Gutiérrez",
   "license": "MIT",
@@ -41,7 +41,7 @@
     "node": ">=22.16"
   },
   "dependencies": {
-    "@alisio/sdk": "0.4.5",
+    "@alisio/sdk": "0.5.1",
     "@mixmark-io/domino": "2.2.0",
     "@modelcontextprotocol/client": "2.1.0",
     "ajv": "8.20.0",