@ggui-ai/mcp-server 0.1.0-rc.3 → 0.2.0-alpha.3

package/dist/schema-compat.d.ts

@@ -1,12 +1,12 @@
 /**
- * Schema compatibility check — verifies that a StackItem's declared
+ * Schema compatibility check — verifies that a Render's declared
  * `actionSpec` / `streamSpec` schemas line up with the input/output
  * schemas of the tools they reference. Wired at two canonical check
- * points: `ggui_push` validation (defensive, fires when the
+ * points: `ggui_render` validation (defensive, fires when the
  * generator eventually emits contract) and blueprint registration
  * (the console blueprint-try endpoint — the real-world site where a
- * StackItem with pre-declared `actionSpec` / `streamSpec` and tool
- * refs lands on a session).
+ * Render with pre-declared `actionSpec` / `streamSpec` and tool
+ * refs lands on the server).
  *
  * **Algorithmic primitive** lives in `@ggui-ai/protocol`:
  *
@@ -16,7 +16,7 @@
  *     `inputSchema` / `outputSchema` to the JsonSchema shape the
  *     subset algorithm consumes.
  *
- * **What this module adds.** A small layer that walks a StackItem's
+ * **What this module adds.** A small layer that walks a Render's
  * `actionSpec` + `streamSpec`, resolves each declared `tool` ref
  * against a toolName → ZodRawShape registry, runs the appropriate
  * subset check, and reports a stable {@link SchemaCompatReport}. The
@@ -120,9 +120,9 @@ export interface ToolSchemaRef {
     readonly outputSchema: ZodRawShape;
 }
 /**
- * Narrow shape of the StackItem subset the checker consumes — the
+ * Narrow shape of the Render subset the checker consumes — the
  * two spec fields PLUS the contract's own tool catalog. Accepts any
- * object carrying them, so both `@ggui-ai/protocol::StackItem` and
+ * object carrying them, so both `@ggui-ai/protocol::Render` and
  * the console endpoint's manifest contract shape work without a cast.
  *
  * `agentCapabilities.tools` is the contract author's declared catalog
@@ -133,7 +133,7 @@ export interface ToolSchemaRef {
  * schema check (we can't validate a remote server's tool schema from
  * here; the agent owns the cross-MCP call).
  */
-export interface StackItemContractShape {
+export interface RenderContractShape {
     readonly actionSpec?: ActionSpec;
     readonly streamSpec?: StreamSpec;
     readonly agentCapabilities?: {
@@ -150,7 +150,7 @@ export declare class SchemaCompatError extends Error {
     constructor(report: SchemaCompatReport, context: string);
 }
 /**
- * Check a StackItem's `actionSpec` / `streamSpec` entries against
+ * Check a Render's `actionSpec` / `streamSpec` entries against
  * the tool registry. See {@link SchemaCompatMode} for policy
  * semantics.
  *
@@ -159,9 +159,9 @@ export declare class SchemaCompatError extends Error {
  * the report is still available on `error.report`.
  *
  * `context` is a short string naming the call site (e.g.
- * `"ggui_push"`, `"console blueprint-try:<blueprintId>"`). Shows
+ * `"ggui_render"`, `"console blueprint-try:<blueprintId>"`). Shows
  * up in thrown error messages so an operator reading logs sees
  * which ingress surfaced the mismatch.
  */
-export declare function checkStackItemSchemaCompat(stackItem: StackItemContractShape, tools: Iterable<ToolSchemaRef>, mode: SchemaCompatMode, context: string): SchemaCompatReport;
+export declare function checkRenderSchemaCompat(render: RenderContractShape, tools: Iterable<ToolSchemaRef>, mode: SchemaCompatMode, context: string): SchemaCompatReport;
 //# sourceMappingURL=schema-compat.d.ts.map

package/dist/schema-compat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema-compat.d.ts","sourceRoot":"","sources":["../src/schema-compat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AACvC,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,UAAU,EAChB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,gBAA2B,CAAC;AAErE;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACnC,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,iBAAiB,CAAC;IACtD;uDACmD;IACnD,QAAQ,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;CACjD;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACnD;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;CACpC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,iBAAiB,CAAC,EAAE;QAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;KACpD,CAAC;CACH;AAED;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;gBACxB,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM;CAKxD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,sBAAsB,EACjC,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC9B,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,MAAM,GACd,kBAAkB,CA0HpB"}
+{"version":3,"file":"schema-compat.d.ts","sourceRoot":"","sources":["../src/schema-compat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AACvC,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,UAAU,EAChB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,gBAA2B,CAAC;AAErE;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACnC,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,iBAAiB,CAAC;IACtD;uDACmD;IACnD,QAAQ,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;CACjD;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACnD;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;CACpC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,iBAAiB,CAAC,EAAE;QAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;KACpD,CAAC;CACH;AAED;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;gBACxB,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM;CAKxD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,mBAAmB,EAC3B,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC9B,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,MAAM,GACd,kBAAkB,CA0HpB"}

package/dist/schema-compat.js

@@ -18,7 +18,7 @@ export class SchemaCompatError extends Error {
     }
 }
 /**
- * Check a StackItem's `actionSpec` / `streamSpec` entries against
+ * Check a Render's `actionSpec` / `streamSpec` entries against
  * the tool registry. See {@link SchemaCompatMode} for policy
  * semantics.
  *
@@ -27,11 +27,11 @@ export class SchemaCompatError extends Error {
  * the report is still available on `error.report`.
  *
  * `context` is a short string naming the call site (e.g.
- * `"ggui_push"`, `"console blueprint-try:<blueprintId>"`). Shows
+ * `"ggui_render"`, `"console blueprint-try:<blueprintId>"`). Shows
  * up in thrown error messages so an operator reading logs sees
  * which ingress surfaced the mismatch.
  */
-export function checkStackItemSchemaCompat(stackItem, tools, mode, context) {
+export function checkRenderSchemaCompat(render, tools, mode, context) {
     if (mode === 'off') {
         return { compatible: true, findings: [] };
     }
@@ -49,7 +49,7 @@ export function checkStackItemSchemaCompat(stackItem, tools, mode, context) {
     // remote tool definition); cross-MCP shape compatibility is the
     // agent's responsibility. Same-server tools still get the full
     // server-driven subset check below.
-    const contractDeclaredTools = new Set(Object.keys(stackItem.agentCapabilities?.tools ?? {}));
+    const contractDeclaredTools = new Set(Object.keys(render.agentCapabilities?.tools ?? {}));
     const findings = [];
     // actionSpec — each action.tool's inputSchema must be a superset
     // of action.schema. A void action (no schema) paired with a tool
@@ -57,7 +57,7 @@ export function checkStackItemSchemaCompat(stackItem, tools, mode, context) {
     // nothing, the tool demands something, so the compat relation is
     // "empty-object ⊆ tool-input" — which fails whenever the tool has
     // required fields.
-    const actionSpec = stackItem.actionSpec ?? {};
+    const actionSpec = render.actionSpec ?? {};
     for (const [actionName, entry] of Object.entries(actionSpec)) {
         if (!entry || typeof entry !== 'object')
             continue;
@@ -104,7 +104,7 @@ export function checkStackItemSchemaCompat(stackItem, tools, mode, context) {
     }
     // streamSpec — each channel.tool's outputSchema must be a superset
     // of channel.schema (inverted direction from actions).
-    const streamSpec = stackItem.streamSpec ?? {};
+    const streamSpec = render.streamSpec ?? {};
     for (const [channelName, entry] of Object.entries(streamSpec)) {
         if (!entry || typeof entry !== 'object')
             continue;