@plitzi/sdk-server 0.32.5 → 0.32.6

package/dist/src/modules/mcp/tools/operations/schema/index.d.ts

@@ -1,14 +1,20 @@
 export * from './translator';
-export * from './registry';
 export { elementOps } from './operations';
 export type { ElementInput } from './shared';
-export * from './upsertElement';
-export * from './patchElement';
-export * from './deleteElement';
-export * from './moveElement';
-export * from './upsertPage';
-export * from './deletePage';
-export * from './upsertFolder';
-export * from './deleteFolder';
-export * from './upsertVariable';
-export * from './deleteVariable';
+export * from './elements/upsertElement';
+export * from './elements/patchElement';
+export * from './elements/deleteElement';
+export * from './elements/moveElement';
+export * from './pages/upsertPage';
+export * from './pages/deletePage';
+export * from './folders/upsertFolder';
+export * from './folders/deleteFolder';
+export * from './variables/upsertVariable';
+export * from './variables/deleteVariable';
+export * from './bindings/upsertBinding';
+export * from './bindings/patchBinding';
+export * from './bindings/deleteBinding';
+export * from './interactions/upsertInteractionFlow';
+export * from './interactions/patchInteractionNode';
+export * from './interactions/deleteInteraction';
+export * from './settings/patchSettings';

package/dist/src/modules/mcp/tools/operations/schema/interactions/deleteInteraction.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import { OpResult, Space } from '../../../../helpers';
+import { Env } from '../../../../types';
+export declare const deleteInteractionOp: 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>;
+export type DeleteInteraction = z.infer<typeof deleteInteractionOp>;
+export declare const deleteInteraction: (space: Space, env: Env, op: DeleteInteraction) => OpResult;

package/dist/src/modules/mcp/tools/operations/schema/interactions/patchInteractionNode.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import { OpResult, Space } from '../../../../helpers';
+import { Env } from '../../../../types';
+export declare const patchInteractionNodeOp: 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>;
+export type PatchInteractionNode = z.infer<typeof patchInteractionNodeOp>;
+export declare const patchInteractionNode: (space: Space, env: Env, op: PatchInteractionNode) => OpResult;

package/dist/src/modules/mcp/tools/operations/schema/interactions/upsertInteractionFlow.d.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+import { OpResult, Space } from '../../../../helpers';
+import { Env } from '../../../../types';
+export declare const upsertInteractionFlowOp: 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>;
+export type UpsertInteractionFlow = z.infer<typeof upsertInteractionFlowOp>;
+export declare const upsertInteractionFlow: (space: Space, env: Env, op: UpsertInteractionFlow) => OpResult;

package/dist/src/modules/mcp/tools/operations/schema/operations.d.ts

@@ -14,6 +14,7 @@ export declare const elementOps: {
         type: import('zod').ZodLiteral<"patchElement">;
         pageRef: import('zod').ZodString;
         ref: import('zod').ZodString;
+        idRef: import('zod').ZodOptional<import('zod').ZodString>;
         label: import('zod').ZodOptional<import('zod').ZodString>;
         subType: import('zod').ZodOptional<import('zod').ZodString>;
         props: import('zod').ZodOptional<import('zod').ZodRecord<import('zod').ZodString, import('zod').ZodUnknown>>;
@@ -21,6 +22,10 @@ export declare const elementOps: {
             base: import('zod').ZodOptional<import('zod').ZodArray<import('zod').ZodString>>;
             slots: import('zod').ZodOptional<import('zod').ZodRecord<import('zod').ZodString, import('zod').ZodArray<import('zod').ZodString>>>;
         }, import('zod/v4/core').$strip>>;
+        initialState: import('zod').ZodOptional<import('zod').ZodObject<{
+            styleVariant: import('zod').ZodOptional<import('zod').ZodRecord<import('zod').ZodString, import('zod').ZodRecord<import('zod').ZodString, import('zod').ZodUnion<readonly [import('zod').ZodString, import('zod').ZodArray<import('zod').ZodString>]>>>>;
+            visibility: import('zod').ZodOptional<import('zod').ZodBoolean>;
+        }, import('zod/v4/core').$strip>>;
     }, import('zod/v4/core').$strip>;
     deleteElement: import('zod').ZodObject<{
         type: import('zod').ZodLiteral<"deleteElement">;
@@ -45,6 +50,7 @@ export declare const elementOps: {
         slug: import('zod').ZodOptional<import('zod').ZodString>;
         folder: import('zod').ZodOptional<import('zod').ZodNullable<import('zod').ZodString>>;
         default: import('zod').ZodOptional<import('zod').ZodBoolean>;
+        enabled: import('zod').ZodOptional<import('zod').ZodBoolean>;
     }, import('zod/v4/core').$strip>;
     deletePage: import('zod').ZodObject<{
         type: import('zod').ZodLiteral<"deletePage">;
@@ -76,4 +82,129 @@ export declare const elementOps: {
         type: import('zod').ZodLiteral<"deleteVariable">;
         name: import('zod').ZodString;
     }, import('zod/v4/core').$strip>;
+    upsertBinding: import('zod').ZodObject<{
+        type: import('zod').ZodLiteral<"upsertBinding">;
+        pageRef: import('zod').ZodString;
+        ref: import('zod').ZodString;
+        category: import('zod').ZodEnum<{
+            attributes: "attributes";
+            style: "style";
+            initialState: "initialState";
+        }>;
+        binding: import('zod').ZodObject<{
+            to: import('zod').ZodString;
+            source: import('zod').ZodString;
+            id: import('zod').ZodOptional<import('zod').ZodString>;
+            transformers: import('zod').ZodOptional<import('zod').ZodArray<import('zod').ZodObject<{
+                action: import('zod').ZodString;
+                params: import('zod').ZodRecord<import('zod').ZodString, import('zod').ZodString>;
+                enabled: import('zod').ZodOptional<import('zod').ZodBoolean>;
+            }, import('zod/v4/core').$strip>>>;
+            when: import('zod').ZodOptional<import('zod').ZodType<import('@plitzi/plitzi-ui/components/QueryBuilder').RuleGroup, unknown, import('zod/v4/core').$ZodTypeInternals<import('@plitzi/plitzi-ui/components/QueryBuilder').RuleGroup, unknown>>>;
+            enabled: import('zod').ZodOptional<import('zod').ZodBoolean>;
+        }, import('zod/v4/core').$strip>;
+    }, import('zod/v4/core').$strip>;
+    patchBinding: import('zod').ZodObject<{
+        type: import('zod').ZodLiteral<"patchBinding">;
+        pageRef: import('zod').ZodString;
+        ref: import('zod').ZodString;
+        category: import('zod').ZodEnum<{
+            attributes: "attributes";
+            style: "style";
+            initialState: "initialState";
+        }>;
+        to: import('zod').ZodString;
+        id: import('zod').ZodOptional<import('zod').ZodString>;
+        source: import('zod').ZodOptional<import('zod').ZodString>;
+        transformers: import('zod').ZodOptional<import('zod').ZodArray<import('zod').ZodObject<{
+            action: import('zod').ZodString;
+            params: import('zod').ZodRecord<import('zod').ZodString, import('zod').ZodString>;
+            enabled: import('zod').ZodOptional<import('zod').ZodBoolean>;
+        }, import('zod/v4/core').$strip>>>;
+        when: import('zod').ZodOptional<import('zod').ZodType<import('@plitzi/plitzi-ui/components/QueryBuilder').RuleGroup, unknown, import('zod/v4/core').$ZodTypeInternals<import('@plitzi/plitzi-ui/components/QueryBuilder').RuleGroup, unknown>>>;
+        enabled: import('zod').ZodOptional<import('zod').ZodBoolean>;
+    }, import('zod/v4/core').$strip>;
+    deleteBinding: import('zod').ZodObject<{
+        type: import('zod').ZodLiteral<"deleteBinding">;
+        pageRef: import('zod').ZodString;
+        ref: import('zod').ZodString;
+        category: import('zod').ZodEnum<{
+            attributes: "attributes";
+            style: "style";
+            initialState: "initialState";
+        }>;
+        to: import('zod').ZodString;
+        id: import('zod').ZodOptional<import('zod').ZodString>;
+    }, import('zod/v4/core').$strip>;
+    upsertInteractionFlow: import('zod').ZodObject<{
+        type: import('zod').ZodLiteral<"upsertInteractionFlow">;
+        pageRef: import('zod').ZodString;
+        ref: import('zod').ZodString;
+        flowId: import('zod').ZodOptional<import('zod').ZodString>;
+        nodes: import('zod').ZodArray<import('zod').ZodObject<{
+            id: import('zod').ZodOptional<import('zod').ZodString>;
+            title: import('zod').ZodString;
+            nodeType: import('zod').ZodEnum<{
+                trigger: "trigger";
+                globalCallback: "globalCallback";
+                callback: "callback";
+                utility: "utility";
+            }>;
+            action: import('zod').ZodString;
+            params: import('zod').ZodOptional<import('zod').ZodRecord<import('zod').ZodString, import('zod').ZodUnknown>>;
+            enabled: import('zod').ZodOptional<import('zod').ZodBoolean>;
+            when: import('zod').ZodOptional<import('zod').ZodType<import('@plitzi/plitzi-ui/components/QueryBuilder').RuleGroup, unknown, import('zod/v4/core').$ZodTypeInternals<import('@plitzi/plitzi-ui/components/QueryBuilder').RuleGroup, unknown>>>;
+            elementId: import('zod').ZodOptional<import('zod').ZodString>;
+            preview: import('zod').ZodOptional<import('zod').ZodRecord<import('zod').ZodString, import('zod').ZodUnknown>>;
+        }, import('zod/v4/core').$strip>>;
+    }, import('zod/v4/core').$strip>;
+    patchInteractionNode: import('zod').ZodObject<{
+        type: import('zod').ZodLiteral<"patchInteractionNode">;
+        pageRef: import('zod').ZodString;
+        ref: import('zod').ZodString;
+        nodeId: import('zod').ZodString;
+        title: import('zod').ZodOptional<import('zod').ZodString>;
+        action: import('zod').ZodOptional<import('zod').ZodString>;
+        params: import('zod').ZodOptional<import('zod').ZodRecord<import('zod').ZodString, import('zod').ZodUnknown>>;
+        enabled: import('zod').ZodOptional<import('zod').ZodBoolean>;
+        when: import('zod').ZodOptional<import('zod').ZodType<import('@plitzi/plitzi-ui/components/QueryBuilder').RuleGroup, unknown, import('zod/v4/core').$ZodTypeInternals<import('@plitzi/plitzi-ui/components/QueryBuilder').RuleGroup, unknown>>>;
+        elementId: import('zod').ZodOptional<import('zod').ZodString>;
+        preview: import('zod').ZodOptional<import('zod').ZodRecord<import('zod').ZodString, import('zod').ZodUnknown>>;
+    }, import('zod/v4/core').$strip>;
+    deleteInteraction: import('zod').ZodObject<{
+        type: import('zod').ZodLiteral<"deleteInteraction">;
+        pageRef: import('zod').ZodString;
+        ref: import('zod').ZodString;
+        flowId: import('zod').ZodOptional<import('zod').ZodString>;
+        nodeId: import('zod').ZodOptional<import('zod').ZodString>;
+    }, import('zod/v4/core').$strip>;
+    patchSettings: import('zod').ZodObject<{
+        type: import('zod').ZodLiteral<"patchSettings">;
+        customCss: import('zod').ZodOptional<import('zod').ZodString>;
+        keepState: import('zod').ZodOptional<import('zod').ZodBoolean>;
+        stateStorage: import('zod').ZodOptional<import('zod').ZodEnum<{
+            localStorage: "localStorage";
+            sessionStorage: "sessionStorage";
+        }>>;
+        userProvider: import('zod').ZodOptional<import('zod').ZodEnum<{
+            "": "";
+            custom: "custom";
+            basic: "basic";
+            auth0: "auth0";
+        }>>;
+        auth0Domain: import('zod').ZodOptional<import('zod').ZodString>;
+        auth0ClientId: import('zod').ZodOptional<import('zod').ZodString>;
+        tokenStorage: import('zod').ZodOptional<import('zod').ZodEnum<{
+            "": "";
+            localStorage: "localStorage";
+            sessionStorage: "sessionStorage";
+        }>>;
+        loginUrl: import('zod').ZodOptional<import('zod').ZodString>;
+        userUrl: import('zod').ZodOptional<import('zod').ZodString>;
+        refreshUrl: import('zod').ZodOptional<import('zod').ZodString>;
+        logoutUrl: import('zod').ZodOptional<import('zod').ZodString>;
+        detailsPath: import('zod').ZodOptional<import('zod').ZodString>;
+        tokenPath: import('zod').ZodOptional<import('zod').ZodString>;
+        expirationTimePath: import('zod').ZodOptional<import('zod').ZodString>;
+    }, import('zod/v4/core').$strip>;
 };

package/dist/src/modules/mcp/tools/operations/schema/{deletePage.d.ts → pages/deletePage.d.ts}

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { Space, OpResult } from '../../../helpers';
-import { Env } from '../../../types';
+import { Space, OpResult } from '../../../../helpers';
+import { Env } from '../../../../types';
 export declare const deletePageOp: z.ZodObject<{
     type: z.ZodLiteral<"deletePage">;
     ref: z.ZodString;

package/dist/src/modules/mcp/tools/operations/schema/{upsertPage.d.ts → pages/upsertPage.d.ts}

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { Space, OpResult } from '../../../helpers';
-import { Env } from '../../../types';
+import { Space, OpResult } from '../../../../helpers';
+import { Env } from '../../../../types';
 export declare const upsertPageOp: z.ZodObject<{
     type: z.ZodLiteral<"upsertPage">;
     ref: z.ZodString;
@@ -8,6 +8,7 @@ export declare const upsertPageOp: z.ZodObject<{
     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>;
 export type UpsertPage = z.infer<typeof upsertPageOp>;
 export declare const upsertPage: (space: Space, env: Env, op: UpsertPage) => OpResult;

package/dist/src/modules/mcp/tools/operations/schema/settings/patchSettings.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+import { Space, OpResult } from '../../../../helpers';
+import { Env } from '../../../../types';
+export declare const patchSettingsOp: 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>;
+export type PatchSettings = z.infer<typeof patchSettingsOp>;
+export declare const patchSettings: (space: Space, env: Env, op: PatchSettings) => OpResult;

package/dist/src/modules/mcp/tools/operations/schema/shared.d.ts

@@ -1,4 +1,10 @@
 import { z } from 'zod';
+import { RuleGroup } from '@plitzi/plitzi-ui/QueryBuilder';
+export declare const ruleGroup: z.ZodType<RuleGroup>;
+export interface InitialStateInput {
+    styleVariant?: Record<string, Record<string, string | string[]>>;
+    visibility?: boolean;
+}
 export interface ElementInput {
     ref: string;
     type: string;
@@ -9,12 +15,18 @@ export interface ElementInput {
         base?: string[];
         slots?: Record<string, string[]>;
     };
+    initialState?: InitialStateInput;
     children?: ElementInput[];
 }
 export declare const styleRefs: z.ZodObject<{
     base: z.ZodOptional<z.ZodArray<z.ZodString>>;
     slots: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
 }, z.core.$strip>;
+export declare const styleVariantInput: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>;
+export declare const initialStateInput: 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>;
 export declare const elementInput: z.ZodType<ElementInput>;
 export declare const position: z.ZodEnum<{
     inside: "inside";
@@ -22,3 +34,44 @@ export declare const position: z.ZodEnum<{
     after: "after";
 }>;
 export declare const scalar: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+export declare const bindingCategory: z.ZodEnum<{
+    attributes: "attributes";
+    style: "style";
+    initialState: "initialState";
+}>;
+export declare const bindingInput: 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<RuleGroup, unknown, z.core.$ZodTypeInternals<RuleGroup, unknown>>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type BindingInput = z.infer<typeof bindingInput>;
+export declare const interactionNodeType: z.ZodEnum<{
+    trigger: "trigger";
+    globalCallback: "globalCallback";
+    callback: "callback";
+    utility: "utility";
+}>;
+export declare const interactionNode: 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<RuleGroup, unknown, z.core.$ZodTypeInternals<RuleGroup, unknown>>>;
+    elementId: z.ZodOptional<z.ZodString>;
+    preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type InteractionNodeInput = z.infer<typeof interactionNode>;

package/dist/src/modules/mcp/tools/operations/schema/translator.d.ts

@@ -1,9 +1,12 @@
-import { AIElementDetail, AIFolder, AIPageSkeleton, AIPageStyles, AIPageSummary, AISchemaVariable } from '../../../types';
+import { ElementVersion } from '../../../helpers';
+import { AIElementDetail, AIFolder, AIPageSkeleton, AIPageStyles, AIPageSummary, AISchemaVariable, AISettings } from '../../../types';
 import { Element, Schema, Style } from '@plitzi/sdk-shared';
 export declare const pageSummariesToAI: (schema: Schema) => AIPageSummary[];
 export declare const foldersToAI: (schema: Schema) => AIFolder[];
 export declare const folderRefToAI: (schema: Schema, ref: string) => AIFolder | undefined;
-export declare const pageSkeletonToAI: (schema: Schema, pageEl: Element) => AIPageSkeleton;
+export declare const elementView: (schema: Schema, el: Element, style: Style) => ElementVersion;
+export declare const pageSkeletonToAI: (schema: Schema, pageEl: Element, style?: Style) => AIPageSkeleton;
 export declare const pageStylesToAI: (schema: Schema, style: Style, pageEl: Element) => AIPageStyles;
 export declare const elementDetailToAI: (schema: Schema, el: Element, style?: Style) => AIElementDetail;
 export declare const schemaVariablesToAI: (schema: Schema, includeSubValues?: boolean) => Record<string, AISchemaVariable>;
+export declare const settingsToAI: (schema: Schema) => AISettings;

package/dist/src/modules/mcp/tools/operations/schema/{deleteVariable.d.ts → variables/deleteVariable.d.ts}

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { Space, OpResult } from '../../../helpers';
-import { Env } from '../../../types';
+import { Space, OpResult } from '../../../../helpers';
+import { Env } from '../../../../types';
 export declare const deleteVariableOp: z.ZodObject<{
     type: z.ZodLiteral<"deleteVariable">;
     name: z.ZodString;

package/dist/src/modules/mcp/tools/operations/schema/{upsertVariable.d.ts → variables/upsertVariable.d.ts}

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { Space, OpResult } from '../../../helpers';
-import { Env } from '../../../types';
+import { Space, OpResult } from '../../../../helpers';
+import { Env } from '../../../../types';
 export declare const upsertVariableOp: z.ZodObject<{
     type: z.ZodLiteral<"upsertVariable">;
     name: z.ZodString;

package/dist/src/modules/mcp/tools/operations/schema/write.d.ts

@@ -1,12 +1,42 @@
-import { ElementInput } from './shared';
-import { Space } from '../../../helpers';
+import { ElementInput, InitialStateInput } from './shared';
+import { OpResult, Space } from '../../../helpers';
 import { Env } from '../../../types';
 import { Element } from '@plitzi/sdk-shared';
-export declare const pageUri: (env: Env, ref: string) => string;
-export declare const pagesUri: (env: Env) => string;
-export declare const foldersUri: (env: Env) => string;
-export declare const folderUri: (env: Env, ref: string) => string;
-export declare const schemaVarsUri: (env: Env) => string;
-export declare const removeFromParent: (space: Space, childId: string) => void;
+export declare const ID_REF_HINT: string;
+/** Every ref in an element input tree (the element plus its nested children) — each becomes a new element's idRef. */
+export declare const collectInputRefs: (input: ElementInput) => string[];
+/** Validate a ref that is about to become an element's idRef: the charset, then whether anything already answers
+ *  to it. The charset rule is sdk-schema's `isValidIdRef` — never a regex restated here, so the MCP cannot drift
+ *  from what the builder and the schema validator enforce.
+ *
+ *  Uniqueness is checked with the ref lookups rather than `FlatMap.idRefConflict`, and deliberately so: these are
+ *  a superset of it. FlatMap asks whether another element holds this idRef; the MCP must also refuse a ref that
+ *  shadows a raw id or a page slug, because its handlers resolve refs through those too — calling both would just
+ *  run the same rule twice. Null when the ref is usable.
+ *
+ *  Enforced here, at every point a ref BECOMES an idRef — addressing an existing element by its raw id is not
+ *  charset-checked, which is why the validator cannot simply tighten its own REF_RE for every ref it sees. */
+export declare const guardNewRef: (space: Space, ref: string, field: string) => OpResult | null;
+export { folderUri, foldersUri, pageUri, pagesUri, schemaVarsUri, settingsUri } from '../../../helpers';
+export declare const removeFromParent: (space: Space, child: Element) => void;
 export declare const placeChild: (parent: Element, childId: string, index?: number) => void;
+export declare const writeInitialState: (el: Element, input: InitialStateInput, merge: boolean) => void;
 export declare const createElement: (space: Space, page: Element, input: ElementInput, parent: Element, index: number | undefined) => void;
+/** The idRef an element is wired by, minting one when it has none. Interactions are keyed by idRef, so an element
+ *  that is about to host or be targeted by a flow must have one — rather than make the agent assign it with a
+ *  separate patchElement, the MCP gives it a free `<type>-<n>` ref (unique across the space) and proceeds. An
+ *  element that already has an idRef keeps it. Mutates the element in place and returns the ref. */
+export declare const ensureIdRef: (space: Space, el: Element) => string;
+/** The key an interaction node must store to reach a target element. Every ref field also accepts a raw id, so a
+ *  target given as an id is resolved to the element's idRef — the key the runtime registers callbacks under. A
+ *  target that has no idRef is given one (see `ensureIdRef`), since it must be reachable to be wired to. A target
+ *  that resolves to no element is left as written — it is already a ref, or a key only a plugin knows. */
+export declare const resolveTargetRef: (space: Space, elementId: string) => string;
+/** Resolve a non-page element within a page for the element-scoped ops (bindings, interactions). Returns the
+ *  element, or a teachable OpResult when the page or element ref does not resolve — so each op reports the same
+ *  errors as patchElement without repeating them. */
+export declare const resolveElement: (space: Space, env: Env, pageRef: string, ref: string) => {
+    el: Element;
+} | {
+    error: OpResult;
+};

package/dist/src/modules/mcp/tools/operations/style/{deleteDefinition.d.ts → definitions/deleteDefinition.d.ts}

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { Space, OpResult } from '../../../helpers';
-import { Env } from '../../../types';
+import { Space, OpResult } from '../../../../helpers';
+import { Env } from '../../../../types';
 export declare const deleteDefinitionOp: z.ZodObject<{
     type: z.ZodLiteral<"deleteDefinition">;
     ref: z.ZodString;

package/dist/src/modules/mcp/tools/operations/style/{patchDefinition.d.ts → definitions/patchDefinition.d.ts}

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { Space, OpResult } from '../../../helpers';
-import { Env } from '../../../types';
+import { Space, OpResult } from '../../../../helpers';
+import { Env } from '../../../../types';
 export declare const patchDefinitionOp: 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]>>>;

package/dist/src/modules/mcp/tools/operations/style/{upsertDefinition.d.ts → definitions/upsertDefinition.d.ts}

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { Space, OpResult } from '../../../helpers';
-import { Env } from '../../../types';
+import { Space, OpResult } from '../../../../helpers';
+import { Env } from '../../../../types';
 export declare const upsertDefinitionOp: 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]>>>;

package/dist/src/modules/mcp/tools/operations/style/{deleteGlobalStyle.d.ts → globalStyles/deleteGlobalStyle.d.ts}

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { Space, OpResult } from '../../../helpers';
-import { Env } from '../../../types';
+import { Space, OpResult } from '../../../../helpers';
+import { Env } from '../../../../types';
 export declare const deleteGlobalStyleOp: z.ZodObject<{
     type: z.ZodLiteral<"deleteGlobalStyle">;
     componentType: z.ZodString;

package/dist/src/modules/mcp/tools/operations/style/{patchGlobalStyle.d.ts → globalStyles/patchGlobalStyle.d.ts}

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { Space, OpResult } from '../../../helpers';
-import { Env } from '../../../types';
+import { Space, OpResult } from '../../../../helpers';
+import { Env } from '../../../../types';
 export declare const patchGlobalStyleOp: 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]>>>;

package/dist/src/modules/mcp/tools/operations/style/{upsertGlobalStyle.d.ts → globalStyles/upsertGlobalStyle.d.ts}

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { Space, OpResult } from '../../../helpers';
-import { Env } from '../../../types';
+import { Space, OpResult } from '../../../../helpers';
+import { Env } from '../../../../types';
 export declare const upsertGlobalStyleOp: 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]>>>;

package/dist/src/modules/mcp/tools/operations/style/idStyles/deleteIdStyle.d.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import { Space, OpResult } from '../../../../helpers';
+import { Env } from '../../../../types';
+export declare const deleteIdStyleOp: z.ZodObject<{
+    type: z.ZodLiteral<"deleteIdStyle">;
+    targetId: z.ZodString;
+}, z.core.$strip>;
+export type DeleteIdStyle = z.infer<typeof deleteIdStyleOp>;
+export declare const deleteIdStyle: (space: Space, env: Env, op: DeleteIdStyle) => OpResult;

package/dist/src/modules/mcp/tools/operations/style/idStyles/patchIdStyle.d.ts

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import { Space, OpResult } from '../../../../helpers';
+import { Env } from '../../../../types';
+export declare const patchIdStyleOp: 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>;
+export type PatchIdStyle = z.infer<typeof patchIdStyleOp>;
+export declare const patchIdStyle: (space: Space, env: Env, op: PatchIdStyle) => OpResult;