@alisio/sdk 0.1.0-alpha.10 → 0.1.0-alpha.12

package/README.md

@@ -67,6 +67,12 @@ returns an unregister function.
   `/connect` profiles.
 - **providers** — `providers.register(registration)` adds a selectable model provider to `/connect`;
   registrations coexist instead of competing.
+- **categories** — declare `categories` on `Plugin`/`PluginMetadata` from the accepted set:
+  `model-provider`, `methodology-harness`, `memory`, `subagents`, `search`, `tools`, `security`,
+  `analytics`, `mcp`, `storage`, `ui` (see the
+  [plugin categories table](https://gustavogutierrez.github.io/alisio/plugins#plugin-categories)).
+  The TUI groups `/plugins` rows by the first category, falling back to "General"; the host
+  derives `model-provider` automatically when a plugin registers providers.
 - **storage** — `storage.sqlite(path)` opens a private (0600) SQLite file (FTS5 available); the
   host provides the driver, so plugins never depend on a specific runtime.
 - **sessions** — child sessions (`spawn`, `create`, `run`, `get`, `children`, `cancel`, `enqueue`,

package/dist/index.d.ts

@@ -235,6 +235,12 @@ export interface ToolContext {
     session?: string;
     /** Who is asking, e.g. an agent path such as "general › explore" (child sessions only). */
     label?: string;
+    /**
+     * Resolves a tool path under the session's mediated path policy (workspace plus declared extra
+     * directories). Out-of-root paths ask for directory approval when the host allows it; hosts that
+     * do not inject this fall back to the workspace-only `safePath` policy.
+     */
+    resolvePath?: (path: string) => Promise<string>;
 }
 export interface ToolDefinition {
     name: string;
@@ -371,11 +377,22 @@ export interface MascotProvider {
     render(ctx: MascotContext): string | string[];
 }
 /**
- * Catalog grouping a plugin declares or the host derives from its registrations. Accepted
- * values: `"model-provider"` (registers model providers) and `"methodology-harness"` (bundles a
- * development-methodology workflow).
+ * Catalog grouping a plugin declares in its manifest; the host derives `"model-provider"` from
+ * provider registrations. The TUI groups `/plugins` by the first declared category. Accepted
+ * values:
+ * - `"model-provider"` — registers model providers.
+ * - `"methodology-harness"` — bundles a development-methodology workflow.
+ * - `"memory"` — persistent memory, recollection and session summaries.
+ * - `"subagents"` — delegation, child sessions and agent management.
+ * - `"search"` — web or vector search providers.
+ * - `"tools"` — general-purpose tool collections.
+ * - `"security"` — audit, sandbox or permission tooling.
+ * - `"analytics"` — usage/metrics instrumentation (session stats, cost tracking).
+ * - `"mcp"` — MCP-server management or bundling helpers.
+ * - `"storage"` — durable storage backends beyond the default SQLite state.
+ * - `"ui"` — TUI presentation providers (startup screens, mascots, panels).
  */
-export type PluginCategory = "model-provider" | "methodology-harness";
+export type PluginCategory = "model-provider" | "methodology-harness" | "memory" | "subagents" | "search" | "tools" | "security" | "analytics" | "mcp" | "storage" | "ui";
 export interface PluginMetadata {
     id: string;
     version: string;
@@ -383,8 +400,8 @@ export interface PluginMetadata {
     name?: string;
     description?: string;
     /**
-     * Categories declared by the plugin or derived by the host from its registrations
-     * (`"model-provider"`, `"methodology-harness"`).
+     * Categories declared by the plugin or derived by the host from its registrations; any value of
+     * the `PluginCategory` union.
      */
     categories?: PluginCategory[];
 }
@@ -691,7 +708,7 @@ export interface Plugin {
     /** Provider-neutral catalog metadata. Hosts may derive additional categories from registrations. */
     name?: string;
     description?: string;
-    /** Accepted values: `"model-provider"` and `"methodology-harness"` (see `PluginCategory`). */
+    /** Optional catalog categories; any value of the `PluginCategory` union. */
     categories?: PluginCategory[];
     /** Declarative sugar for `api.extensions.register(point, provider)` at priority 0. */
     extensions?: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alisio/sdk",
-  "version": "0.1.0-alpha.10",
+  "version": "0.1.0-alpha.12",
   "description": "Typed plugin SDK for Alisio: the stable contract for tools, commands, context, compaction and session hooks, model completions and storage. Types only plus tiny helpers; zero runtime dependencies.",
   "author": "Gustavo Gutiérrez",
   "license": "MIT",