@ai-gui/core 0.35.2 → 0.36.0

package/dist/index.cjs

@@ -1311,6 +1311,22 @@ var ActionRuntime = class {
 	listActionTypes() {
 		return this.destroyed ? [] : Object.freeze(this.registry.list().map((action) => action.type));
 	}
+	/**
+	* The parameter schema of one action, and nothing else.
+	*
+	* A model asked to draw a form that calls an action has to know what the
+	* action wants. Told only the name, it invents plausible parameter names —
+	* `when` for a start time — and every dispatch is rejected before it reaches
+	* the host. Prompt builders read this to describe the shape.
+	*
+	* Deliberately narrower than `registry.get`: a schema is a description, while
+	* an ActionDefinition carries `run`, and handing that out is handing out the
+	* side effect itself.
+	*/
+	describeAction(type) {
+		if (this.destroyed) return void 0;
+		return this.registry.get(type)?.schema;
+	}
 	subscribe(listener) {
 		if (this.destroyed) return () => {};
 		this.listeners.add(listener);

package/dist/index.d.cts

@@ -632,6 +632,19 @@ declare class ActionRuntime {
   hasAction(type: string): boolean;
   /** List registered action names without exposing executable definitions. */
   listActionTypes(): readonly string[];
+  /**
+   * The parameter schema of one action, and nothing else.
+   *
+   * A model asked to draw a form that calls an action has to know what the
+   * action wants. Told only the name, it invents plausible parameter names —
+   * `when` for a start time — and every dispatch is rejected before it reaches
+   * the host. Prompt builders read this to describe the shape.
+   *
+   * Deliberately narrower than `registry.get`: a schema is a description, while
+   * an ActionDefinition carries `run`, and handing that out is handing out the
+   * side effect itself.
+   */
+  describeAction(type: string): JSONSchema | undefined;
   subscribe(listener: ActionStateListener): () => void;
   subscribeDebug(listener: DebugEventListener): () => void;
   cancel(key: string): boolean;

package/dist/index.d.ts

@@ -632,6 +632,19 @@ declare class ActionRuntime {
   hasAction(type: string): boolean;
   /** List registered action names without exposing executable definitions. */
   listActionTypes(): readonly string[];
+  /**
+   * The parameter schema of one action, and nothing else.
+   *
+   * A model asked to draw a form that calls an action has to know what the
+   * action wants. Told only the name, it invents plausible parameter names —
+   * `when` for a start time — and every dispatch is rejected before it reaches
+   * the host. Prompt builders read this to describe the shape.
+   *
+   * Deliberately narrower than `registry.get`: a schema is a description, while
+   * an ActionDefinition carries `run`, and handing that out is handing out the
+   * side effect itself.
+   */
+  describeAction(type: string): JSONSchema | undefined;
   subscribe(listener: ActionStateListener): () => void;
   subscribeDebug(listener: DebugEventListener): () => void;
   cancel(key: string): boolean;

package/dist/index.js

@@ -1287,6 +1287,22 @@ var ActionRuntime = class {
 	listActionTypes() {
 		return this.destroyed ? [] : Object.freeze(this.registry.list().map((action) => action.type));
 	}
+	/**
+	* The parameter schema of one action, and nothing else.
+	*
+	* A model asked to draw a form that calls an action has to know what the
+	* action wants. Told only the name, it invents plausible parameter names —
+	* `when` for a start time — and every dispatch is rejected before it reaches
+	* the host. Prompt builders read this to describe the shape.
+	*
+	* Deliberately narrower than `registry.get`: a schema is a description, while
+	* an ActionDefinition carries `run`, and handing that out is handing out the
+	* side effect itself.
+	*/
+	describeAction(type) {
+		if (this.destroyed) return void 0;
+		return this.registry.get(type)?.schema;
+	}
 	subscribe(listener) {
 		if (this.destroyed) return () => {};
 		this.listeners.add(listener);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-gui/core",
-  "version": "0.35.2",
+  "version": "0.36.0",
   "description": "Headless streaming renderer core for LLM-generated UI — markdown/JSON repair, card registry, AST diff, plugin engine, sanitizer.",
   "keywords": [
     "llm",