@plitzi/sdk-server 0.32.5 → 0.32.6

package/dist/src/modules/mcp/resources/canonical.d.ts

@@ -1,6 +1,5 @@
 import { Env } from '../types';
 export declare const canonicalUri: (env: Env, uri: string) => string;
-export declare const itemTemplates: (env: Env) => string[];
 /** Teachable message for a URI that read as null. Distinguishes a well-formed URI whose ref does not resolve (the
  *  resource may be stale/deleted) from a URI whose shape matches no template at all (malformed — echo the valid
  *  templates so the agent stops hand-building URIs). See RFC 0004 I2. */

package/dist/src/modules/mcp/resources/index.d.ts

@@ -1,8 +1,7 @@
 export { readResource, resourceVersion } from './router';
 export { registerResources } from './register';
 export { resourceErrorMessage } from './canonical';
-export { buildTypeRegistry } from '../tools/operations/schema/registry';
-export type { TypeInfo, TypePropInfo, TypeRegistry } from '../tools/operations/schema/registry';
+export { buildTypeRegistry, compoundLonghands, cssProperties, expandShorthand, isCssProperty, suggestCssProperty } from '../catalogs';
+export type { TypeInfo, TypePropInfo, TypeRegistry } from '../catalogs';
 export * from '../tools/operations/schema/translator';
-export { cssProperties, expandShorthand, isCssProperty, suggestCssProperty } from '../tools/operations/style/cssCatalog';
 export * from '../tools/operations/style/translator';

package/dist/src/modules/mcp/resources/primer.d.ts

@@ -2,5 +2,6 @@ import { Space } from '../helpers';
 import { Env, ResourceEnvelope } from '../types';
 /** The cold-start bundle: everything the guide says to read before the first write, in one round-trip.
  *  Summaries only — never full page/element trees (those are opened on demand), so it stays cheap even on a
- *  large space. Returns undefined when the URI is not the primer. */
+ *  large space. Carries the condensed `guideQuickstart` (not the full guideText, which the agent reads on demand at
+ *  plitzi://guide) to keep the bundle small. Returns undefined when the URI is not the primer. */
 export declare const readPrimerResource: (space: Space, env: Env, uri: string) => ResourceEnvelope<unknown> | undefined;

package/dist/src/modules/mcp/resources/register.d.ts

@@ -1,6 +1,6 @@
-import { Space } from '../helpers';
+import { McpLog, Space } from '../helpers';
 import { Env } from '../types';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp';
 /** Register every resource on the MCP server: fixed listings plus templated per-item reads. The space is
  *  loaded lazily via getSpace, so listing resources never touches the store — only reading one does. */
-export declare const registerResources: (server: McpServer, getSpace: () => Promise<Space>, env: Env) => void;
+export declare const registerResources: (server: McpServer, getSpace: () => Promise<Space>, env: Env, log: McpLog) => void;

package/dist/src/modules/mcp/server.d.ts

@@ -1,6 +1,6 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp';
 import { PreviewClient, ScreenshotClient } from './types';
-import { SSRAdapters } from '@plitzi/sdk-shared';
+import { SSRAdapters, McpLogger } from '@plitzi/sdk-shared';
 /** The MCP service is stateless: every request resolves its own `spaceId` (from the request JWT) and reads the
  *  space fresh through the adapters — schema and style are two documents, read/written independently. Both the
  *  spaceId and the space itself resolve lazily, so the public surface (handshake, tools-list, resources-list,
@@ -15,5 +15,8 @@ export interface McpServerContext {
     /** The dedicated browser service for plitzi_screenshot. Absent → the tool is not registered (only the HTML
      *  plitzi_preview is offered). */
     screenshot?: ScreenshotClient;
+    /** Structured request-log sink. When set, every tool call and resource read emits an McpLogEvent to it (the
+     *  consumer renders them); otherwise logging falls back to the console when MCP_DEBUG=1. */
+    logger?: McpLogger;
 }
-export declare const createMcpServer: ({ adapters, getSpaceId, preview, screenshot }: McpServerContext) => McpServer;
+export declare const createMcpServer: ({ adapters, getSpaceId, preview, screenshot, logger }: McpServerContext) => McpServer;

package/dist/src/modules/mcp/tools/apply/index.d.ts

@@ -19,6 +19,7 @@ export declare const applyShape: {
         type: z.ZodLiteral<"patchElement">;
         pageRef: z.ZodString;
         ref: z.ZodString;
+        idRef: z.ZodOptional<z.ZodString>;
         label: z.ZodOptional<z.ZodString>;
         subType: z.ZodOptional<z.ZodString>;
         props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -26,6 +27,10 @@ export declare const applyShape: {
             base: z.ZodOptional<z.ZodArray<z.ZodString>>;
             slots: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
         }, z.core.$strip>>;
+        initialState: z.ZodOptional<z.ZodObject<{
+            styleVariant: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>>;
+            visibility: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"deleteElement">;
         pageRef: z.ZodString;
@@ -47,6 +52,7 @@ export declare const applyShape: {
         slug: z.ZodOptional<z.ZodString>;
         folder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         default: z.ZodOptional<z.ZodBoolean>;
+        enabled: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"deletePage">;
         ref: z.ZodString;
@@ -72,6 +78,124 @@ export declare const applyShape: {
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"deleteVariable">;
         name: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"upsertBinding">;
+        pageRef: z.ZodString;
+        ref: z.ZodString;
+        category: z.ZodEnum<{
+            attributes: "attributes";
+            style: "style";
+            initialState: "initialState";
+        }>;
+        binding: z.ZodObject<{
+            to: z.ZodString;
+            source: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+            transformers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                action: z.ZodString;
+                params: z.ZodRecord<z.ZodString, z.ZodString>;
+                enabled: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>>;
+            when: z.ZodOptional<z.ZodType<import('@plitzi/plitzi-ui/components/QueryBuilder').RuleGroup, unknown, z.core.$ZodTypeInternals<import('@plitzi/plitzi-ui/components/QueryBuilder').RuleGroup, unknown>>>;
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"patchBinding">;
+        pageRef: z.ZodString;
+        ref: z.ZodString;
+        category: z.ZodEnum<{
+            attributes: "attributes";
+            style: "style";
+            initialState: "initialState";
+        }>;
+        to: z.ZodString;
+        id: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodString>;
+        transformers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            action: z.ZodString;
+            params: z.ZodRecord<z.ZodString, z.ZodString>;
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        when: z.ZodOptional<z.ZodType<import('@plitzi/plitzi-ui/components/QueryBuilder').RuleGroup, unknown, z.core.$ZodTypeInternals<import('@plitzi/plitzi-ui/components/QueryBuilder').RuleGroup, unknown>>>;
+        enabled: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"deleteBinding">;
+        pageRef: z.ZodString;
+        ref: z.ZodString;
+        category: z.ZodEnum<{
+            attributes: "attributes";
+            style: "style";
+            initialState: "initialState";
+        }>;
+        to: z.ZodString;
+        id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"upsertInteractionFlow">;
+        pageRef: z.ZodString;
+        ref: z.ZodString;
+        flowId: z.ZodOptional<z.ZodString>;
+        nodes: z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            title: z.ZodString;
+            nodeType: z.ZodEnum<{
+                trigger: "trigger";
+                globalCallback: "globalCallback";
+                callback: "callback";
+                utility: "utility";
+            }>;
+            action: z.ZodString;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            when: z.ZodOptional<z.ZodType<import('@plitzi/plitzi-ui/components/QueryBuilder').RuleGroup, unknown, z.core.$ZodTypeInternals<import('@plitzi/plitzi-ui/components/QueryBuilder').RuleGroup, unknown>>>;
+            elementId: z.ZodOptional<z.ZodString>;
+            preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"patchInteractionNode">;
+        pageRef: z.ZodString;
+        ref: z.ZodString;
+        nodeId: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        action: z.ZodOptional<z.ZodString>;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        when: z.ZodOptional<z.ZodType<import('@plitzi/plitzi-ui/components/QueryBuilder').RuleGroup, unknown, z.core.$ZodTypeInternals<import('@plitzi/plitzi-ui/components/QueryBuilder').RuleGroup, unknown>>>;
+        elementId: z.ZodOptional<z.ZodString>;
+        preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"deleteInteraction">;
+        pageRef: z.ZodString;
+        ref: z.ZodString;
+        flowId: z.ZodOptional<z.ZodString>;
+        nodeId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"patchSettings">;
+        customCss: z.ZodOptional<z.ZodString>;
+        keepState: z.ZodOptional<z.ZodBoolean>;
+        stateStorage: z.ZodOptional<z.ZodEnum<{
+            localStorage: "localStorage";
+            sessionStorage: "sessionStorage";
+        }>>;
+        userProvider: z.ZodOptional<z.ZodEnum<{
+            "": "";
+            custom: "custom";
+            basic: "basic";
+            auth0: "auth0";
+        }>>;
+        auth0Domain: z.ZodOptional<z.ZodString>;
+        auth0ClientId: z.ZodOptional<z.ZodString>;
+        tokenStorage: z.ZodOptional<z.ZodEnum<{
+            "": "";
+            localStorage: "localStorage";
+            sessionStorage: "sessionStorage";
+        }>>;
+        loginUrl: z.ZodOptional<z.ZodString>;
+        userUrl: z.ZodOptional<z.ZodString>;
+        refreshUrl: z.ZodOptional<z.ZodString>;
+        logoutUrl: z.ZodOptional<z.ZodString>;
+        detailsPath: z.ZodOptional<z.ZodString>;
+        tokenPath: z.ZodOptional<z.ZodString>;
+        expirationTimePath: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
         desktop: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
         tablet: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
@@ -202,13 +326,78 @@ export declare const applyShape: {
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"deleteGlobalStyle">;
         componentType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        desktop: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+        tablet: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+        mobile: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+        states: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            desktop: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+            tablet: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+            mobile: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+        }, z.core.$strip>>>;
+        variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            desktop: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+            tablet: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+            mobile: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+        }, z.core.$strip>>>;
+        slots: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            desktop: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+            tablet: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+            mobile: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+            states: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                desktop: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+                tablet: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+                mobile: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+            }, z.core.$strip>>>;
+            variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                desktop: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+                tablet: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+                mobile: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>>;
+        type: z.ZodLiteral<"upsertIdStyle">;
+        targetId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        desktop: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>>;
+        tablet: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>>;
+        mobile: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>>;
+        states: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            desktop: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>>;
+            tablet: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>>;
+            mobile: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>>;
+        }, z.core.$strip>>>;
+        variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            desktop: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>>;
+            tablet: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>>;
+            mobile: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>>;
+        }, z.core.$strip>>>;
+        slots: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            desktop: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>>;
+            tablet: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>>;
+            mobile: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>>;
+            states: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                desktop: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>>;
+                tablet: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>>;
+                mobile: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>>;
+            }, z.core.$strip>>>;
+            variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                desktop: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>>;
+                tablet: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>>;
+                mobile: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>>;
+        type: z.ZodLiteral<"patchIdStyle">;
+        targetId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"deleteIdStyle">;
+        targetId: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"upsertStyleVariable">;
         category: z.ZodEnum<{
             color: "color";
+            custom: "custom";
             spacing: "spacing";
             shadow: "shadow";
-            custom: "custom";
         }>;
         name: z.ZodString;
         value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
@@ -220,9 +409,9 @@ export declare const applyShape: {
         type: z.ZodLiteral<"deleteStyleVariable">;
         category: z.ZodEnum<{
             color: "color";
+            custom: "custom";
             spacing: "spacing";
             shadow: "shadow";
-            custom: "custom";
         }>;
         name: z.ZodString;
     }, z.core.$strip>], "type">>;