@alisio/core 0.1.0-alpha.12 → 0.1.0-alpha.13

package/dist/application.d.ts

@@ -171,6 +171,8 @@ export declare function createApplication(options?: AppOptions): Promise<{
      * (next instructions load), `websearch.provider` mutates the shared config object the search
      * chain reads per call, `pluginHooks.timeoutMs` lands in the plugin host (next hook call),
      * and `tui.*` is persisted for the host to apply. Nothing in this set requires a restart.
+     * `agents.*` (active agent id and reasoning effort) is persisted for the TUI to consume:
+     * the next `/agents`/`/effort` selection and the next prompt already read the live config.
      * `mcp.allow` is deliberately not routed here: it flows through
      * `rememberGlobalMcpConsent`/`revokeGlobalMcpConsent` instead.
      * Throws under `--read-only`. Returns the written config file.

package/dist/application.js

@@ -743,6 +743,8 @@ export async function createApplication(options = {}) {
              * (next instructions load), `websearch.provider` mutates the shared config object the search
              * chain reads per call, `pluginHooks.timeoutMs` lands in the plugin host (next hook call),
              * and `tui.*` is persisted for the host to apply. Nothing in this set requires a restart.
+             * `agents.*` (active agent id and reasoning effort) is persisted for the TUI to consume:
+             * the next `/agents`/`/effort` selection and the next prompt already read the live config.
              * `mcp.allow` is deliberately not routed here: it flows through
              * `rememberGlobalMcpConsent`/`revokeGlobalMcpConsent` instead.
              * Throws under `--read-only`. Returns the written config file.
@@ -790,6 +792,16 @@ export async function createApplication(options = {}) {
                     case "tui.skillSlashCommands":
                         config.tui = { ...config.tui, skillSlashCommands: value === true };
                         break;
+                    case "agents.active":
+                        config.agents = { ...config.agents, active: String(value) };
+                        break;
+                    case "agents.effort":
+                        // Clearing (undefined) drops the leaf from the live config and the JSON file.
+                        config.agents =
+                            value === undefined
+                                ? { active: config.agents.active }
+                                : { ...config.agents, effort: 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

@@ -177,6 +177,10 @@ export declare const configSchema: z.ZodPipe<z.ZodObject<{
         paddingX: z.ZodDefault<z.ZodNumber>;
         skillSlashCommands: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strict>>;
+    agents: z.ZodDefault<z.ZodObject<{
+        active: z.ZodDefault<z.ZodString>;
+        effort: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
 }, z.core.$strict>, z.ZodTransform<{
     schemaVersion: 1;
     provider: {
@@ -232,6 +236,10 @@ export declare const configSchema: z.ZodPipe<z.ZodObject<{
         paddingX: number;
         skillSlashCommands: boolean;
     };
+    agents: {
+        active: string;
+        effort?: string | undefined;
+    };
     mcp: {
         allow?: boolean | undefined;
         servers: {
@@ -370,6 +378,10 @@ export declare const configSchema: z.ZodPipe<z.ZodObject<{
         paddingX: number;
         skillSlashCommands: boolean;
     };
+    agents: {
+        active: string;
+        effort?: string | undefined;
+    };
 }>>;
 export type Config = z.infer<typeof configSchema>;
 export type ServerConfig = z.infer<typeof serverSchema>;
@@ -452,6 +464,8 @@ declare const SETTABLE_KEYS: {
         serpapi: "serpapi";
         tavily: "tavily";
     }>>;
+    readonly "agents.active": z.ZodDefault<z.ZodString>;
+    readonly "agents.effort": z.ZodOptional<z.ZodString>;
 };
 export type SettableSettingKey = keyof typeof SETTABLE_KEYS;
 export declare function isSettableSettingKey(key: string): key is SettableSettingKey;

package/dist/config.js

@@ -188,6 +188,27 @@ const configObjectSchema = z
     })
         .strict()
         .default(() => ({ paddingX: 1, skillSlashCommands: true })),
+    /**
+     * The ACTIVE agent drives the main session: its system prompt is appended to every prompt and
+     * its optional model selector is offered when the agent is chosen (`/agents`). `build` is the
+     * built-in default (full-power, no added persona); `plan` is the built-in read-only planner.
+     * `effort` holds a reasoning effort level chosen with `/effort` for a model that advertises
+     * `effort.supportedLevels`; it is validated against the ACTIVE model on use, falling back to
+     * the model's default level when unsupported.
+     */
+    agents: z
+        .object({
+        active: z
+            .string()
+            .trim()
+            .min(1)
+            .max(100)
+            .regex(/^[a-zA-Z0-9][a-zA-Z0-9._:-]*$/, "invalid agent name")
+            .default("build"),
+        effort: z.string().trim().min(1).max(50).optional(),
+    })
+        .strict()
+        .default(() => ({ active: "build" })),
 })
     .strict()
     .superRefine((config, context) => {
@@ -434,6 +455,7 @@ const SETTABLE_SECTIONS = {
     pluginHooks: configObjectSchema.shape.pluginHooks.removeDefault(),
     tui: configObjectSchema.shape.tui.removeDefault(),
     websearch: configObjectSchema.shape.websearch.removeDefault(),
+    agents: configObjectSchema.shape.agents.removeDefault(),
 };
 const SETTABLE_KEYS = {
     "compaction.auto": SETTABLE_SECTIONS.compaction.shape.auto,
@@ -450,6 +472,8 @@ const SETTABLE_KEYS = {
     "tui.paddingX": SETTABLE_SECTIONS.tui.shape.paddingX,
     "tui.skillSlashCommands": SETTABLE_SECTIONS.tui.shape.skillSlashCommands,
     "websearch.provider": SETTABLE_SECTIONS.websearch.shape.provider,
+    "agents.active": SETTABLE_SECTIONS.agents.shape.active,
+    "agents.effort": SETTABLE_SECTIONS.agents.shape.effort,
 };
 export function isSettableSettingKey(key) {
     return Object.prototype.hasOwnProperty.call(SETTABLE_KEYS, key);

package/dist/core/compaction.js

@@ -381,6 +381,7 @@ async function completeTextWithMeta(provider, request) {
         signal: request.signal,
         ...(request.model ? { model: request.model } : {}),
         ...(request.sessionId ? { sessionId: request.sessionId } : {}),
+        ...(request.reasoningEffort ? { reasoningEffort: request.reasoningEffort } : {}),
     })) {
         request.signal.throwIfAborted();
         if (event.type === "completed") {

package/dist/core/runner.d.ts

@@ -42,6 +42,11 @@ export interface RunnerOptions {
      * runner; only meaningful for a provider that documents an equivalent server-side tool.
      */
     nativeTools?: Array<Record<string, unknown>>;
+    /**
+     * Default reasoning effort level (a value from the current model's `ModelInfo.effort`), sent on
+     * every run unless overridden per-run. Providers that do not advertise effort levels ignore it.
+     */
+    reasoningEffort?: string;
 }
 /** The settings a running TUI can change live; merged into the runner options on apply. */
 export interface RunnerSettingsPatch {
@@ -80,6 +85,8 @@ export interface RunOptions {
     /** Per-call output token budget for this run; beats the runner-level budget when set. */
     maxOutputTokens?: number;
     timeoutMs?: number;
+    /** Reasoning effort level for this run; beats the runner-level default when set. */
+    reasoningEffort?: string;
 }
 /**
  * Default cumulative token budget for one run: several context windows (each turn re-sends the

package/dist/core/runner.js

@@ -418,6 +418,9 @@ export class AgentRunner {
                     model,
                     sessionId,
                     ...(o.nativeTools?.length ? { nativeTools: o.nativeTools } : {}),
+                    ...((options.reasoningEffort ?? o.reasoningEffort)
+                        ? { reasoningEffort: options.reasoningEffort ?? o.reasoningEffort }
+                        : {}),
                 })) {
                     combined.throwIfAborted();
                     if (e.type === "text_delta")

package/dist/plugins/host.d.ts

@@ -72,6 +72,12 @@ export declare class PluginHost implements RunnerExtensions {
         askQuestions(request: AskQuestionsRequest): Promise<AskQuestionsResult>;
         open(sessionId: string): boolean;
     }): void;
+    /**
+     * Read-only view of one plugin's shared state (written through `api.state.set`). The host layer
+     * uses this to consume plugin-published data (for example the main-capable agent definitions the
+     * built-in subagents plugin publishes) without importing the plugin package.
+     */
+    pluginState(plugin: string, key: string): unknown;
     get sessions(): PluginAPI["sessions"];
     /**
      * Live accessor for core standard tools (e.g. `ask_user_question`), which are not "a plugin"

package/dist/plugins/host.js

@@ -60,6 +60,14 @@ export class PluginHost {
     setInteractiveUI(ui) {
         this.uiImpl = ui;
     }
+    /**
+     * Read-only view of one plugin's shared state (written through `api.state.set`). The host layer
+     * uses this to consume plugin-published data (for example the main-capable agent definitions the
+     * built-in subagents plugin publishes) without importing the plugin package.
+     */
+    pluginState(plugin, key) {
+        return this.state.getState(plugin, key);
+    }
     get sessions() {
         if (!this.sessionsImpl)
             throw new Error("Child sessions are not available yet");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alisio/core",
-  "version": "0.1.0-alpha.12",
+  "version": "0.1.0-alpha.13",
   "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.1.0-alpha.7",
+    "@alisio/sdk": "0.1.0-alpha.8",
     "@mixmark-io/domino": "2.2.0",
     "@modelcontextprotocol/client": "2.1.0",
     "ajv": "8.20.0",