@alisio/sdk 0.1.0-alpha.7 → 0.1.0-alpha.9

package/dist/index.d.ts

@@ -10,10 +10,52 @@ export interface ToolCall {
     name: string;
     arguments: string;
 }
+/** A node of a `{ kind: "tree" }` UI block. */
+export interface TreeNode {
+    label: string;
+    children?: TreeNode[];
+    /** Optional annotation rendered after the label, e.g. a count or a status word. */
+    meta?: string;
+}
+/**
+ * Alisio-owned structured rendering of a tool result, produced by core adapters (for example
+ * the MCP connector) when a tool returns structured data. It never carries MCP protocol types:
+ * plugins wanting a structured block build one of these shapes directly. The runner always
+ * keeps a plain-text projection alongside a `ui` part, so providers, compaction and headless
+ * output only ever see text; the block is a display hint for TUI rendering.
+ */
+export type UiBlock = {
+    kind: "table";
+    columns: string[];
+    rows: Array<Array<string>>;
+    caption?: string;
+} | {
+    kind: "key-value";
+    entries: Array<[string, string]>;
+    caption?: string;
+} | {
+    kind: "tree";
+    nodes: Array<TreeNode>;
+} | {
+    kind: "code";
+    lang?: string;
+    code: string;
+    caption?: string;
+} | {
+    kind: "markdown";
+    text: string;
+};
 export interface ToolResult {
     content: Array<{
         type: "text";
         text: string;
+    } | {
+        type: "image";
+        mimeType: string;
+        data: string;
+    } | {
+        type: "ui";
+        block: UiBlock;
     }>;
     isError?: boolean;
 }
@@ -137,6 +179,12 @@ export interface ModelProvider {
          * that does not support one may ignore this or let the provider reject it.
          */
         nativeTools?: Array<Record<string, unknown>>;
+        /**
+         * Provider-declared reasoning effort level (a value from `ModelInfo.effort.supportedLevels`).
+         * Providers that advertise effort levels map it to their request field (for example DeepSeek
+         * `reasoning_effort`); providers without a concept ignore it.
+         */
+        reasoningEffort?: string;
     }): AsyncIterable<ProviderEvent>;
     /** Optional model catalog. Implementations must not expose credentials. */
     listModels?(signal: AbortSignal): Promise<ModelInfo[]>;
@@ -276,6 +324,8 @@ export interface CompletionRequest {
     model?: string;
     /** Session whose provider binding should be used when model is omitted. */
     sessionId?: string;
+    /** Reasoning effort level when the target model advertises `ModelInfo.effort`. */
+    reasoningEffort?: string;
     signal?: AbortSignal;
 }
 export type SqlValue = string | number | bigint | null | Uint8Array;
@@ -643,3 +693,10 @@ export interface Plugin {
 }
 export declare function definePlugin<T extends Plugin>(plugin: T): T;
 export declare const textResult: (text: string, isError?: boolean) => ToolResult;
+/**
+ * Text-only view of a tool result: the content filtered to its text parts, order preserved.
+ * This is what the runner hands to providers, what compaction summarizes and what headless
+ * output shows; `ui`/`image` parts stay only in the persisted transcript for TUI replay, so
+ * raw bytes or structured blocks never reach the model prompt.
+ */
+export declare function textProjection(result: ToolResult): ToolResult;

package/dist/index.js

@@ -5,3 +5,14 @@ export const textResult = (text, isError = false) => ({
     content: [{ type: "text", text }],
     ...(isError ? { isError: true } : {}),
 });
+/**
+ * Text-only view of a tool result: the content filtered to its text parts, order preserved.
+ * This is what the runner hands to providers, what compaction summarizes and what headless
+ * output shows; `ui`/`image` parts stay only in the persisted transcript for TUI replay, so
+ * raw bytes or structured blocks never reach the model prompt.
+ */
+export function textProjection(result) {
+    if (result.content.every((part) => part.type === "text"))
+        return result;
+    return { ...result, content: result.content.filter((part) => part.type === "text") };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alisio/sdk",
-  "version": "0.1.0-alpha.7",
+  "version": "0.1.0-alpha.9",
   "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",