duet-kit 0.1.0

package/dist/duet.d.ts

@@ -0,0 +1,63 @@
+/**
+ * duet-kit - Main Entry Point
+ *
+ * Single factory that creates everything: store + LLM bridge + schema access.
+ * Follows Zustand conventions - returns a hook with static properties.
+ */
+import { type StoreApi, type UseBoundStore } from 'zustand';
+import { z } from 'zod';
+import type { SchemaFields, FieldDef, InferData, EditResult, LLMBridge } from './types';
+import { DuetSchema } from './schema';
+interface DuetState<T extends SchemaFields> {
+    data: InferData<T>;
+    set: <K extends keyof T>(field: K, value: z.infer<T[K]['schema']>) => boolean;
+    setMany: (updates: Partial<InferData<T>>) => boolean;
+    reset: () => void;
+}
+export interface DuetHook<T extends SchemaFields> extends UseBoundStore<StoreApi<DuetState<T>>> {
+    llm: LLMBridge<T>;
+    schema: DuetSchema<T>;
+}
+export interface DuetOptions {
+    /** Optional localStorage key. Omit for in-memory only. For backend sync, use store.subscribe() */
+    persist?: string;
+    /** Transform the default context string before returning from getContext() */
+    transformContext?: (context: string) => string;
+    /** Transform the default function schema before returning from getFunctionSchema() */
+    transformFunctionSchema?: (schema: object) => object;
+}
+/**
+ * Create a Duet - a Zustand store with LLM bridge and schema access.
+ *
+ * @example
+ * ```typescript
+ * const useTripStore = createDuet('TripBudget', {
+ *   destination: field(z.string(), 'Destination', 'Tokyo'),
+ *   budget: field(z.number().min(0), 'Budget', 5000),
+ * }, { persist: 'trip-data' })
+ *
+ * // React
+ * const { data, set } = useTripStore()
+ *
+ * // LLM (JSON Patch)
+ * useTripStore.llm.applyJSON('[{"op":"replace","path":"/budget","value":10000}]')
+ * ```
+ */
+export declare function createDuet<T extends SchemaFields>(name: string, fields: T, options?: DuetOptions): DuetHook<T>;
+/**
+ * Helper to define a field with Zod schema, label, and default value.
+ */
+export declare function field<T>(schema: z.ZodType<T>, label: string, defaultValue: T): FieldDef<T>;
+/**
+ * Helper to check if edit was successful
+ */
+export declare function isSuccess(result: EditResult): result is {
+    success: true;
+    applied: number;
+};
+/**
+ * Get human-readable message from result
+ */
+export declare function getResultMessage(result: EditResult): string;
+export {};
+//# sourceMappingURL=duet.d.ts.map

package/dist/duet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duet.d.ts","sourceRoot":"","sources":["../src/duet.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAU,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAEpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAe,UAAU,EAAE,SAAS,EAAgB,MAAM,SAAS,CAAC;AACnH,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGtC,UAAU,SAAS,CAAC,CAAC,SAAS,YAAY;IACxC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACnB,GAAG,EAAE,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,KAAK,OAAO,CAAC;IAC9E,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC;IACrD,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAGD,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,YAAY,CAAE,SAAQ,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7F,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,kGAAkG;IAClG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/C,sFAAsF;IACtF,uBAAuB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;CACtD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,YAAY,EAC/C,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,EACT,OAAO,GAAE,WAAgB,GACxB,QAAQ,CAAC,CAAC,CAAC,CAmPb;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,EACrB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EACpB,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,CAAC,GACd,QAAQ,CAAC,CAAC,CAAC,CAEb;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,IAAI;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAE1F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAK3D"}

package/dist/duet.js

@@ -0,0 +1,259 @@
+/**
+ * duet-kit - Main Entry Point
+ *
+ * Single factory that creates everything: store + LLM bridge + schema access.
+ * Follows Zustand conventions - returns a hook with static properties.
+ */
+import { create } from 'zustand';
+import { persist } from 'zustand/middleware';
+import { DuetSchema } from './schema';
+/**
+ * Create a Duet - a Zustand store with LLM bridge and schema access.
+ *
+ * @example
+ * ```typescript
+ * const useTripStore = createDuet('TripBudget', {
+ *   destination: field(z.string(), 'Destination', 'Tokyo'),
+ *   budget: field(z.number().min(0), 'Budget', 5000),
+ * }, { persist: 'trip-data' })
+ *
+ * // React
+ * const { data, set } = useTripStore()
+ *
+ * // LLM (JSON Patch)
+ * useTripStore.llm.applyJSON('[{"op":"replace","path":"/budget","value":10000}]')
+ * ```
+ */
+export function createDuet(name, fields, options = {}) {
+    // Create schema
+    const schema = new DuetSchema(name, fields);
+    const initialData = schema.getDefaults();
+    // Store creator function
+    const storeCreator = (set) => ({
+        data: initialData,
+        set: (field, value) => {
+            const result = schema.validate(field, value);
+            if (!result.success) {
+                console.warn(`Validation failed for ${String(field)}:`, result.error.message);
+                return false;
+            }
+            set((state) => ({
+                data: { ...state.data, [field]: result.data },
+            }));
+            return true;
+        },
+        setMany: (updates) => {
+            const validated = {};
+            for (const [key, value] of Object.entries(updates)) {
+                if (key in schema.fields) {
+                    const result = schema.validate(key, value);
+                    if (!result.success) {
+                        console.warn(`Validation failed for ${key}:`, result.error.message);
+                        return false;
+                    }
+                    validated[key] = result.data;
+                }
+            }
+            set((state) => ({
+                data: { ...state.data, ...validated },
+            }));
+            return true;
+        },
+        reset: () => {
+            set(() => ({ data: schema.getDefaults() }));
+        },
+    });
+    // Create the Zustand store
+    const useStore = options.persist
+        ? create()(persist(storeCreator, {
+            name: options.persist,
+            partialize: (state) => ({ data: state.data }),
+        }))
+        : create()(storeCreator);
+    // History log for audit trail
+    const patchHistory = [];
+    let historyId = 0;
+    // Create LLM bridge (JSON Patch format)
+    const llmBridge = {
+        applyPatch(patch, source = 'llm') {
+            const currentData = { ...useStore.getState().data };
+            for (const op of patch) {
+                // Parse JSON Pointer path: /field or /parent/child
+                const pathParts = op.path.replace(/^\//, '').split('/');
+                const rootField = pathParts[0];
+                if (!(rootField in schema.fields)) {
+                    const result = { success: false, error: `Unknown field: ${rootField}` };
+                    patchHistory.push({ id: String(++historyId), timestamp: Date.now(), patch, source, result });
+                    return result;
+                }
+                if (op.op === 'remove') {
+                    if (pathParts.length === 1) {
+                        currentData[rootField] = schema.getDefaults()[rootField];
+                    }
+                    else {
+                        let target = currentData[rootField];
+                        for (let i = 1; i < pathParts.length - 1; i++) {
+                            target = target[pathParts[i]];
+                        }
+                        delete target[pathParts[pathParts.length - 1]];
+                    }
+                    continue;
+                }
+                if (op.op === 'replace' || op.op === 'add') {
+                    if (pathParts.length === 1) {
+                        const result = schema.validate(rootField, op.value);
+                        if (!result.success) {
+                            const editResult = {
+                                success: false,
+                                error: `Invalid value for ${rootField}: ${result.error.errors[0]?.message}`
+                            };
+                            patchHistory.push({ id: String(++historyId), timestamp: Date.now(), patch, source, result: editResult });
+                            return editResult;
+                        }
+                        currentData[rootField] = result.data;
+                    }
+                    else {
+                        const newValue = JSON.parse(JSON.stringify(currentData[rootField]));
+                        let target = newValue;
+                        for (let i = 1; i < pathParts.length - 1; i++) {
+                            if (!(pathParts[i] in target)) {
+                                target[pathParts[i]] = {};
+                            }
+                            target = target[pathParts[i]];
+                        }
+                        target[pathParts[pathParts.length - 1]] = op.value;
+                        const result = schema.validate(rootField, newValue);
+                        if (!result.success) {
+                            const editResult = {
+                                success: false,
+                                error: `Invalid value for ${op.path}: ${result.error.errors[0]?.message}`
+                            };
+                            patchHistory.push({ id: String(++historyId), timestamp: Date.now(), patch, source, result: editResult });
+                            return editResult;
+                        }
+                        currentData[rootField] = result.data;
+                    }
+                }
+            }
+            const committed = useStore.getState().setMany(currentData);
+            if (!committed) {
+                const result = { success: false, error: 'Failed to commit changes to store' };
+                patchHistory.push({ id: String(++historyId), timestamp: Date.now(), patch, source, result });
+                return result;
+            }
+            const result = { success: true, applied: patch.length };
+            patchHistory.push({ id: String(++historyId), timestamp: Date.now(), patch, source, result });
+            return result;
+        },
+        applyJSON(json, source = 'llm') {
+            try {
+                const parsed = JSON.parse(json);
+                if (Array.isArray(parsed)) {
+                    return this.applyPatch(parsed, source);
+                }
+                if (parsed.patch && Array.isArray(parsed.patch)) {
+                    return this.applyPatch(parsed.patch, source);
+                }
+                return { success: false, error: 'Expected JSON Patch array or { patch: [...] } format' };
+            }
+            catch (e) {
+                return { success: false, error: `JSON parse error: ${e.message}` };
+            }
+        },
+        history() {
+            return [...patchHistory];
+        },
+        clearHistory() {
+            patchHistory.length = 0;
+            historyId = 0;
+        },
+        getContext() {
+            const data = useStore.getState().data;
+            let context = schema.getDescription();
+            context += '\nCurrent Values:\n';
+            for (const [id, field] of Object.entries(schema.fields)) {
+                const value = data[id];
+                context += `  ${id}: ${JSON.stringify(value)} (${field.label})\n`;
+            }
+            context += `
+To edit fields, respond with a JSON Patch array (RFC 6902):
+[{ "op": "replace", "path": "/fieldName", "value": newValue }]
+
+Examples:
+- Single edit: [{ "op": "replace", "path": "/budget", "value": 5000 }]
+- Multiple: [{ "op": "replace", "path": "/budget", "value": 5000 }, { "op": "replace", "path": "/days", "value": 14 }]`;
+            return options.transformContext ? options.transformContext(context) : context;
+        },
+        getCompactContext() {
+            const data = useStore.getState().data;
+            const values = Object.entries(data)
+                .map(([k, v]) => `${k}=${JSON.stringify(v)}`)
+                .join(', ');
+            return `${schema.name}: {${values}}\nJSON Patch: [{"op":"replace","path":"/field","value":x}]`;
+        },
+        getFunctionSchema() {
+            const fnSchema = {
+                name: `patch_${schema.name.toLowerCase().replace(/\s+/g, '_')}`,
+                description: `Apply JSON Patch operations to ${schema.name}. Uses RFC 6902 format.`,
+                parameters: {
+                    type: 'object',
+                    properties: {
+                        patch: {
+                            type: 'array',
+                            description: 'JSON Patch operations (RFC 6902)',
+                            items: {
+                                type: 'object',
+                                properties: {
+                                    op: {
+                                        type: 'string',
+                                        enum: ['replace', 'add', 'remove'],
+                                        description: 'Operation type',
+                                    },
+                                    path: {
+                                        type: 'string',
+                                        description: `JSON Pointer to field. Valid paths: ${schema.getFieldIds().map(f => `/${f}`).join(', ')}`,
+                                    },
+                                    value: {
+                                        description: 'New value (required for replace/add)',
+                                    },
+                                },
+                                required: ['op', 'path'],
+                            },
+                        },
+                    },
+                    required: ['patch'],
+                },
+            };
+            return options.transformFunctionSchema ? options.transformFunctionSchema(fnSchema) : fnSchema;
+        },
+        getCurrentValues() {
+            return useStore.getState().data;
+        },
+    };
+    // Attach llm and schema to the hook
+    const hook = useStore;
+    hook.llm = llmBridge;
+    hook.schema = schema;
+    return hook;
+}
+/**
+ * Helper to define a field with Zod schema, label, and default value.
+ */
+export function field(schema, label, defaultValue) {
+    return { schema, label, default: defaultValue };
+}
+/**
+ * Helper to check if edit was successful
+ */
+export function isSuccess(result) {
+    return result.success;
+}
+/**
+ * Get human-readable message from result
+ */
+export function getResultMessage(result) {
+    if (result.success) {
+        return `Successfully applied ${result.applied} operation(s)`;
+    }
+    return result.error;
+}

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * duet-kit - Shared state for humans and LLMs
+ *
+ * A lightweight library for building UIs where both humans and AI
+ * can edit the same validated state through a shared schema.
+ *
+ * Built on Zustand (state) + Zod (validation) + JSON Patch (RFC 6902).
+ *
+ * @packageDocumentation
+ *
+ * @example
+ * ```typescript
+ * import { createDuet, field, z } from 'duet-kit'
+ *
+ * const useTripStore = createDuet('TripBudget', {
+ *   destination: field(z.string(), 'Destination', 'Tokyo'),
+ *   budget: field(z.number().min(0).max(100000), 'Budget', 5000),
+ * }, { persist: 'trip-data' })
+ *
+ * // React
+ * const { data, set } = useTripStore()
+ *
+ * // LLM (JSON Patch format)
+ * useTripStore.llm.applyJSON('[{"op":"replace","path":"/budget","value":10000}]')
+ * ```
+ */
+export { createDuet, field, isSuccess, getResultMessage, type DuetHook, type DuetOptions } from './duet';
+export { attachLLM } from './attach';
+export type { SchemaFields, FieldDef, InferData, JsonPatchOp, EditResult, HistoryEntry, LLMBridge, } from './types';
+export { z } from 'zod';
+export { createSchema, DuetSchema } from './schema';
+export { createStore, type DuetStore, type StoreOptions } from './store';
+export { createLLMBridge } from './llm';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,KAAK,QAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AAGzG,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGrC,YAAY,EACV,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,WAAW,EACX,UAAU,EACV,YAAY,EACZ,SAAS,GACV,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC"}

package/dist/index.js

@@ -0,0 +1,36 @@
+/**
+ * duet-kit - Shared state for humans and LLMs
+ *
+ * A lightweight library for building UIs where both humans and AI
+ * can edit the same validated state through a shared schema.
+ *
+ * Built on Zustand (state) + Zod (validation) + JSON Patch (RFC 6902).
+ *
+ * @packageDocumentation
+ *
+ * @example
+ * ```typescript
+ * import { createDuet, field, z } from 'duet-kit'
+ *
+ * const useTripStore = createDuet('TripBudget', {
+ *   destination: field(z.string(), 'Destination', 'Tokyo'),
+ *   budget: field(z.number().min(0).max(100000), 'Budget', 5000),
+ * }, { persist: 'trip-data' })
+ *
+ * // React
+ * const { data, set } = useTripStore()
+ *
+ * // LLM (JSON Patch format)
+ * useTripStore.llm.applyJSON('[{"op":"replace","path":"/budget","value":10000}]')
+ * ```
+ */
+// Main API
+export { createDuet, field, isSuccess, getResultMessage } from './duet';
+// Drop-in for existing Zustand + Zod codebases
+export { attachLLM } from './attach';
+// Re-export Zod for convenience
+export { z } from 'zod';
+// Advanced: individual building blocks (createDuet combines these)
+export { createSchema, DuetSchema } from './schema';
+export { createStore } from './store';
+export { createLLMBridge } from './llm';

package/dist/llm.d.ts

@@ -0,0 +1,25 @@
+/**
+ * duet-kit - LLM Utilities
+ *
+ * Context generation and JSON Patch application for LLM integration.
+ * Uses RFC 6902 JSON Patch format.
+ */
+import type { SchemaFields, EditResult, LLMBridge } from './types';
+import type { DuetSchema } from './schema';
+import type { DuetStore } from './store';
+/**
+ * Create an LLM bridge for a schema + store
+ */
+export declare function createLLMBridge<T extends SchemaFields>(schema: DuetSchema<T>, store: DuetStore<T>): LLMBridge<T>;
+/**
+ * Helper to check if edit was successful
+ */
+export declare function isSuccess(result: EditResult): result is {
+    success: true;
+    applied: number;
+};
+/**
+ * Get human-readable message from result
+ */
+export declare function getResultMessage(result: EditResult): string;
+//# sourceMappingURL=llm.d.ts.map

package/dist/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../src/llm.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAA0B,UAAU,EAAE,SAAS,EAAgB,MAAM,SAAS,CAAC;AACzG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,YAAY,EACpD,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EACrB,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAClB,SAAS,CAAC,CAAC,CAAC,CAqKd;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,IAAI;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAE1F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAK3D"}

package/dist/llm.js

@@ -0,0 +1,170 @@
+/**
+ * duet-kit - LLM Utilities
+ *
+ * Context generation and JSON Patch application for LLM integration.
+ * Uses RFC 6902 JSON Patch format.
+ */
+/**
+ * Create an LLM bridge for a schema + store
+ */
+export function createLLMBridge(schema, store) {
+    // History log for audit trail
+    const patchHistory = [];
+    let historyId = 0;
+    return {
+        /**
+         * Apply JSON Patch operations (RFC 6902)
+         */
+        applyPatch(patch, source = 'llm') {
+            const updates = {};
+            for (const op of patch) {
+                const fieldName = op.path.replace(/^\//, '').split('/')[0];
+                if (!(fieldName in schema.fields)) {
+                    const result = { success: false, error: `Unknown field: ${fieldName}` };
+                    patchHistory.push({ id: String(++historyId), timestamp: Date.now(), patch, source, result });
+                    return result;
+                }
+                if (op.op === 'remove') {
+                    const defaultValue = schema.getDefaults()[fieldName];
+                    updates[fieldName] = defaultValue;
+                    continue;
+                }
+                if (op.op === 'replace' || op.op === 'add') {
+                    const result = schema.validate(fieldName, op.value);
+                    if (!result.success) {
+                        const editResult = {
+                            success: false,
+                            error: `Invalid value for ${fieldName}: ${result.error.errors[0]?.message}`
+                        };
+                        patchHistory.push({ id: String(++historyId), timestamp: Date.now(), patch, source, result: editResult });
+                        return editResult;
+                    }
+                    updates[fieldName] = result.data;
+                }
+            }
+            store.getState().setMany(updates);
+            const result = { success: true, applied: patch.length };
+            patchHistory.push({ id: String(++historyId), timestamp: Date.now(), patch, source, result });
+            return result;
+        },
+        /**
+         * Apply edits from JSON string (LLM output)
+         */
+        applyJSON(json, source = 'llm') {
+            try {
+                const parsed = JSON.parse(json);
+                if (Array.isArray(parsed)) {
+                    return this.applyPatch(parsed, source);
+                }
+                if (parsed.patch && Array.isArray(parsed.patch)) {
+                    return this.applyPatch(parsed.patch, source);
+                }
+                return { success: false, error: 'Expected JSON Patch array or { patch: [...] } format' };
+            }
+            catch (e) {
+                return { success: false, error: `JSON parse error: ${e.message}` };
+            }
+        },
+        /**
+         * Generate context for LLM prompt
+         */
+        getContext() {
+            const data = store.getState().data;
+            let context = schema.getDescription();
+            context += '\nCurrent Values:\n';
+            for (const [id, field] of Object.entries(schema.fields)) {
+                const value = data[id];
+                context += `  ${id}: ${JSON.stringify(value)} (${field.label})\n`;
+            }
+            context += `
+To edit fields, respond with a JSON Patch array (RFC 6902):
+[{ "op": "replace", "path": "/fieldName", "value": newValue }]
+
+Examples:
+- Single edit: [{ "op": "replace", "path": "/budget", "value": 5000 }]
+- Multiple: [{ "op": "replace", "path": "/budget", "value": 5000 }, { "op": "replace", "path": "/days", "value": 14 }]`;
+            return context;
+        },
+        /**
+         * Compact context for constrained prompts
+         */
+        getCompactContext() {
+            const data = store.getState().data;
+            const values = Object.entries(data)
+                .map(([k, v]) => `${k}=${JSON.stringify(v)}`)
+                .join(', ');
+            return `${schema.name}: {${values}}\nJSON Patch: [{"op":"replace","path":"/field","value":x}]`;
+        },
+        /**
+         * Generate OpenAI/Anthropic function calling schema
+         */
+        getFunctionSchema() {
+            return {
+                name: `patch_${schema.name.toLowerCase().replace(/\s+/g, '_')}`,
+                description: `Apply JSON Patch operations to ${schema.name}. Uses RFC 6902 format.`,
+                parameters: {
+                    type: 'object',
+                    properties: {
+                        patch: {
+                            type: 'array',
+                            description: 'JSON Patch operations (RFC 6902)',
+                            items: {
+                                type: 'object',
+                                properties: {
+                                    op: {
+                                        type: 'string',
+                                        enum: ['replace', 'add', 'remove'],
+                                        description: 'Operation type',
+                                    },
+                                    path: {
+                                        type: 'string',
+                                        description: `JSON Pointer to field. Valid paths: ${schema.getFieldIds().map(f => `/${f}`).join(', ')}`,
+                                    },
+                                    value: {
+                                        description: 'New value (required for replace/add)',
+                                    },
+                                },
+                                required: ['op', 'path'],
+                            },
+                        },
+                    },
+                    required: ['patch'],
+                },
+            };
+        },
+        /**
+         * Get current values
+         */
+        getCurrentValues() {
+            return store.getState().data;
+        },
+        /**
+         * Get patch history for audit trail
+         */
+        history() {
+            return [...patchHistory];
+        },
+        /**
+         * Clear patch history
+         */
+        clearHistory() {
+            patchHistory.length = 0;
+            historyId = 0;
+        },
+    };
+}
+/**
+ * Helper to check if edit was successful
+ */
+export function isSuccess(result) {
+    return result.success;
+}
+/**
+ * Get human-readable message from result
+ */
+export function getResultMessage(result) {
+    if (result.success) {
+        return `Successfully applied ${result.applied} operation(s)`;
+    }
+    return result.error;
+}

package/dist/schema.d.ts

@@ -0,0 +1,27 @@
+/**
+ * duet-kit - Schema
+ *
+ * Thin wrapper around Zod that adds metadata for UI labels and LLM context.
+ */
+import { z } from 'zod';
+import type { SchemaFields, FieldDef, InferData } from './types';
+export declare class DuetSchema<T extends SchemaFields> {
+    readonly name: string;
+    readonly fields: T;
+    constructor(name: string, fields: T);
+    getDefaults(): InferData<T>;
+    validate<K extends keyof T>(field: K, value: unknown): z.SafeParseReturnType<unknown, z.infer<T[K]['schema']>>;
+    validateAll(data: Partial<InferData<T>>): {
+        success: boolean;
+        errors: Record<string, string>;
+    };
+    getField(fieldId: string): FieldDef | undefined;
+    getFieldIds(): string[];
+    getDescription(): string;
+    toJSONSchema(): object;
+    private getZodTypeDescription;
+    private zodToJSONSchema;
+}
+export declare function createSchema<T extends SchemaFields>(name: string, fields: T): DuetSchema<T>;
+export declare function field<T>(schema: z.ZodType<T>, label: string, defaultValue: T): FieldDef<T>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGjE,qBAAa,UAAU,CAAC,CAAC,SAAS,YAAY;aAE1B,IAAI,EAAE,MAAM;aACZ,MAAM,EAAE,CAAC;gBADT,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC;IAI3B,WAAW,IAAI,SAAS,CAAC,CAAC,CAAC;IAS3B,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC,mBAAmB,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAK9G,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE;IAc9F,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAK/C,WAAW,IAAI,MAAM,EAAE;IAKvB,cAAc,IAAI,MAAM;IAYxB,YAAY,IAAI,MAAM;IActB,OAAO,CAAC,qBAAqB;IAS7B,OAAO,CAAC,eAAe;CAwBxB;AAGD,wBAAgB,YAAY,CAAC,CAAC,SAAS,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAE3F;AAGD,wBAAgB,KAAK,CAAC,CAAC,EACrB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EACpB,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,CAAC,GACd,QAAQ,CAAC,CAAC,CAAC,CAEb"}