@itaila/archetype 0.3.30

package/dist/core/crud-prompt.js

@@ -0,0 +1,268 @@
+import { allowedOperations } from './entity-helpers.js';
+// ─── Zod traversal helpers (shared pattern with zod-to-gemini.ts) ───────────
+function resolveTypeName(def) {
+    if (typeof def.typeName === 'string')
+        return def.typeName;
+    if (typeof def.type === 'string') {
+        const map = {
+            string: 'ZodString', number: 'ZodNumber', boolean: 'ZodBoolean',
+            array: 'ZodArray', object: 'ZodObject', optional: 'ZodOptional',
+            nullable: 'ZodNullable', enum: 'ZodEnum', literal: 'ZodLiteral',
+        };
+        return map[def.type] ?? '';
+    }
+    return '';
+}
+function resolveShape(def) {
+    const s = def.shape;
+    if (typeof s === 'function')
+        return s();
+    if (s && typeof s === 'object')
+        return s;
+    return null;
+}
+function resolveArrayItem(def) {
+    if (def.type && typeof def.type === 'object' && '_def' in def.type)
+        return def.type;
+    if (def.element && typeof def.element === 'object' && '_def' in def.element)
+        return def.element;
+    return null;
+}
+function resolveInnerType(def) {
+    const inner = def.innerType;
+    if (inner && typeof inner === 'object' && '_def' in inner)
+        return inner;
+    return null;
+}
+function isOptionalLike(zodType) {
+    const def = zodType._def;
+    if (!def)
+        return false;
+    const typeName = resolveTypeName(def);
+    return typeName === 'ZodOptional' || typeName === 'ZodNullable';
+}
+function buildExampleValue(zodType) {
+    const def = zodType._def;
+    if (!def)
+        return '<value>';
+    const typeName = resolveTypeName(def);
+    switch (typeName) {
+        case 'ZodString':
+            return '<string>';
+        case 'ZodNumber':
+            return 1;
+        case 'ZodBoolean':
+            return true;
+        case 'ZodLiteral':
+            return def.value;
+        case 'ZodEnum': {
+            const values = def.values ?? def.entries;
+            const arr = Array.isArray(values) ? values : Object.keys(values);
+            return arr[0] ?? '<value>';
+        }
+        case 'ZodOptional':
+        case 'ZodNullable': {
+            const inner = resolveInnerType(def);
+            return inner ? buildExampleValue(inner) : '<value>';
+        }
+        case 'ZodArray': {
+            const item = resolveArrayItem(def);
+            return item ? [buildExampleValue(item)] : ['<value>'];
+        }
+        case 'ZodObject': {
+            const shape = resolveShape(def);
+            if (!shape)
+                return {};
+            const example = {};
+            for (const [key, value] of Object.entries(shape)) {
+                example[key] = buildExampleValue(value);
+            }
+            return example;
+        }
+        default:
+            return '<value>';
+    }
+}
+function buildRequiredExampleValue(zodType) {
+    const def = zodType._def;
+    if (!def)
+        return '<value>';
+    const typeName = resolveTypeName(def);
+    switch (typeName) {
+        case 'ZodObject': {
+            const shape = resolveShape(def);
+            if (!shape)
+                return {};
+            const example = {};
+            for (const [key, value] of Object.entries(shape)) {
+                if (isOptionalLike(value))
+                    continue;
+                example[key] = buildRequiredExampleValue(value);
+            }
+            return example;
+        }
+        case 'ZodOptional':
+        case 'ZodNullable': {
+            const inner = resolveInnerType(def);
+            return inner ? buildRequiredExampleValue(inner) : '<value>';
+        }
+        default:
+            return buildExampleValue(zodType);
+    }
+}
+function buildExampleCrudResponseItem(entities) {
+    const first = Object.entries(entities)[0];
+    if (!first) {
+        return '{ "name": "crud", "params": { "operation": "create", "entity": "<name>", "id": "_temp1", "params": "{ ... }" } }';
+    }
+    const [entityName, config] = first;
+    const params = JSON.stringify(buildRequiredExampleValue(config.schema));
+    return JSON.stringify({
+        name: 'crud',
+        params: {
+            operation: 'create',
+            entity: entityName,
+            id: `_${entityName}1`,
+            params,
+        },
+    });
+}
+// ─── zodToDescription: comprehensive Zod → human-readable text ──────────────
+/**
+ * Convert any Zod schema to a compact human-readable description.
+ * Handles the full Zod type system: primitives, enums, arrays, objects,
+ * optionals, nullables, literals, and .describe() annotations.
+ *
+ * Same traversal pattern as zodToGeminiSchema but outputs text for prompts.
+ */
+export function zodToDescription(zodType) {
+    const def = zodType._def;
+    if (!def)
+        return 'unknown';
+    const typeName = resolveTypeName(def);
+    const description = def.description
+        ?? zodType.description;
+    let result;
+    switch (typeName) {
+        case 'ZodString':
+            result = 'string';
+            break;
+        case 'ZodNumber':
+            result = 'number';
+            break;
+        case 'ZodBoolean':
+            result = 'boolean';
+            break;
+        case 'ZodEnum': {
+            const values = def.values ?? def.entries;
+            const arr = Array.isArray(values) ? values : Object.keys(values);
+            result = arr.map(value => JSON.stringify(value)).join(' | ');
+            break;
+        }
+        case 'ZodLiteral':
+            result = JSON.stringify(def.value);
+            break;
+        case 'ZodArray': {
+            const item = resolveArrayItem(def);
+            if (item) {
+                const itemDesc = zodToDescription(item);
+                const wrapped = itemDesc.includes(' | ') && !itemDesc.startsWith('{')
+                    ? `(${itemDesc})`
+                    : itemDesc;
+                result = `${wrapped}[]`;
+            }
+            else {
+                result = 'array';
+            }
+            break;
+        }
+        case 'ZodObject': {
+            const shape = resolveShape(def);
+            if (!shape) {
+                result = 'object';
+                break;
+            }
+            const fields = Object.entries(shape).map(([key, val]) => {
+                const fieldDef = val._def;
+                const fieldTypeName = resolveTypeName(fieldDef);
+                const isOptional = fieldTypeName === 'ZodOptional';
+                const fieldDesc = zodToDescription(val);
+                const fieldDescription = fieldDef.description
+                    ?? val.description;
+                const descSuffix = fieldDescription ? ` (${fieldDescription})` : '';
+                const optionalSuffix = isOptional && !fieldDesc.endsWith('?') ? '?' : '';
+                return `${key}: ${fieldDesc}${optionalSuffix}${descSuffix}`;
+            });
+            result = `{ ${fields.join(', ')} }`;
+            break;
+        }
+        case 'ZodOptional': {
+            const inner = resolveInnerType(def);
+            if (!inner)
+                return 'string?';
+            const innerDesc = zodToDescription(inner);
+            // Don't double-append ? if already present
+            return innerDesc.endsWith('?') ? innerDesc : `${innerDesc}?`;
+        }
+        case 'ZodNullable': {
+            const inner = resolveInnerType(def);
+            if (!inner)
+                return 'string | null';
+            return `${zodToDescription(inner)} | null`;
+        }
+        default:
+            result = 'string';
+            break;
+    }
+    return result;
+}
+// ─── Entity block builder ───────────────────────────────────────────────────
+/**
+ * Render the entities block for the system prompt.
+ * Includes entity definitions and CRUD format instructions.
+ */
+export function buildEntitiesBlock(entities, promptMode = 'conversation', contractStyle = 'full') {
+    const names = Object.keys(entities);
+    if (names.length === 0)
+        return '';
+    const intro = promptMode === 'operational'
+        ? '--- ENTITIES (available for create, update, and delete when the live turn calls for it) ---'
+        : '--- ENTITIES (available for create, update, and delete when the conversation calls for it) ---';
+    const lines = [intro];
+    for (const [name, config] of Object.entries(entities)) {
+        const schemaDesc = zodToDescription(config.schema);
+        // Strip outer braces for inline display: { field: type, ... } → field: type, ...
+        const fields = schemaDesc.startsWith('{') && schemaDesc.endsWith('}')
+            ? schemaDesc.slice(2, -2)
+            : schemaDesc;
+        lines.push(`- ${name}`);
+        lines.push(`    fields: { ${fields} }`);
+        const ops = allowedOperations(config);
+        if (ops.length < 3) {
+            lines.push(`    operations: ${ops.join(', ')} only`);
+        }
+        if (config.description) {
+            lines.push(`    what it is: ${config.description}`);
+        }
+    }
+    lines.push('');
+    lines.push(contractStyle === 'lean' ? '--- CRUD ---' : '--- ENTITY CRUD RESPONSE CONTRACT ---');
+    lines.push('crud action item: { "name": "crud", "params": { "operation": "create"|"update"|"delete", "entity": "<name>", "id": "<id>", "params": "{ ... }" } }');
+    if (contractStyle === 'full') {
+        lines.push('do not use a top-level "crudActions" key — entity mutations belong inside the main "actions" array');
+    }
+    lines.push(`example response item: ${buildExampleCrudResponseItem(entities)}`);
+    if (contractStyle === 'lean') {
+        lines.push('create: required fields only; temp ids start with _');
+        lines.push('update: real id + changed fields only');
+        lines.push('delete: operation, entity, id only');
+    }
+    else {
+        lines.push('create: include all required fields in params and add optional fields only when the situation genuinely calls for them; generate a temp id starting with _');
+        lines.push('update: use a real id from context and include only changed fields');
+        lines.push('delete: include operation, entity, and id only');
+        lines.push('cross-reference: create parent temp id first, then reuse it in child params');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=crud-prompt.js.map

package/dist/core/crud-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crud-prompt.js","sourceRoot":"","sources":["../../src/core/crud-prompt.ts"],"names":[],"mappings":"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"}

package/dist/core/crud-schema.d.ts

@@ -0,0 +1,12 @@
+import type { EntityConfig } from '../types.js';
+/**
+ * Build the crudActions schema fragment for the Gemini response schema.
+ *
+ * The crudActions array uses a SINGLE generic schema shape (not per-entity anyOf),
+ * which is the whole point: eliminating the schema explosion that comes from
+ * N entities x 3 operations.
+ *
+ * Validation against per-entity Zod schemas happens after parsing in crud.ts.
+ */
+export declare function buildCrudActionsSchema(entities: Record<string, EntityConfig>): Record<string, unknown>;
+//# sourceMappingURL=crud-schema.d.ts.map

package/dist/core/crud-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crud-schema.d.ts","sourceRoot":"","sources":["../../src/core/crud-schema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GACrC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+BzB"}

package/dist/core/crud-schema.js

@@ -0,0 +1,42 @@
+import { SchemaType } from '@google/generative-ai';
+/**
+ * Build the crudActions schema fragment for the Gemini response schema.
+ *
+ * The crudActions array uses a SINGLE generic schema shape (not per-entity anyOf),
+ * which is the whole point: eliminating the schema explosion that comes from
+ * N entities x 3 operations.
+ *
+ * Validation against per-entity Zod schemas happens after parsing in crud.ts.
+ */
+export function buildCrudActionsSchema(entities) {
+    const entityNames = Object.keys(entities);
+    return {
+        type: SchemaType.ARRAY,
+        description: 'Entity CRUD mutations. Use this array for create/update/delete on declared entities.',
+        items: {
+            type: SchemaType.OBJECT,
+            properties: {
+                operation: {
+                    type: SchemaType.STRING,
+                    enum: ['create', 'update', 'delete'],
+                    description: 'The CRUD operation to perform.',
+                },
+                entity: {
+                    type: SchemaType.STRING,
+                    enum: entityNames,
+                    description: 'Which entity to operate on.',
+                },
+                id: {
+                    type: SchemaType.STRING,
+                    description: 'Entity ID (required for update and delete).',
+                },
+                params: {
+                    type: SchemaType.STRING,
+                    description: `JSON object with entity fields. For create: include all required fields. For update: include only the fields to change. For delete: omit or leave empty. Field names and types are defined in the ENTITIES section of the prompt.`,
+                },
+            },
+            required: ['operation', 'entity'],
+        },
+    };
+}
+//# sourceMappingURL=crud-schema.js.map

package/dist/core/crud-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crud-schema.js","sourceRoot":"","sources":["../../src/core/crud-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAGlD;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAAsC;IAEtC,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAEzC,OAAO;QACL,IAAI,EAAE,UAAU,CAAC,KAAK;QACtB,WAAW,EAAE,sFAAsF;QACnG,KAAK,EAAE;YACL,IAAI,EAAE,UAAU,CAAC,MAAM;YACvB,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,UAAU,CAAC,MAAM;oBACvB,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;oBACpC,WAAW,EAAE,gCAAgC;iBAC9C;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,UAAU,CAAC,MAAM;oBACvB,IAAI,EAAE,WAAW;oBACjB,WAAW,EAAE,6BAA6B;iBAC3C;gBACD,EAAE,EAAE;oBACF,IAAI,EAAE,UAAU,CAAC,MAAM;oBACvB,WAAW,EAAE,6CAA6C;iBAC3D;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,UAAU,CAAC,MAAM;oBACvB,WAAW,EAAE,mOAAmO;iBACjP;aACF;YACD,QAAQ,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC;SAClC;KACF,CAAA;AACH,CAAC"}

package/dist/core/effective-config.d.ts

@@ -0,0 +1,13 @@
+import type { PersonaConfig, EntityConfig } from '../types.js';
+/**
+ * Resolve the effective actions for a persona.
+ * Memory actions are no longer merged here — they flow through the entity CRUD system.
+ */
+export declare function resolveActions(config: PersonaConfig): Record<string, import('../types.js').ActionDefinition> | undefined;
+/**
+ * Resolve the effective entities for a persona, including internal memory entities
+ * when memory.enabled or craftMemory.enabled are set.
+ */
+export declare function resolveEntities(config: PersonaConfig): Record<string, EntityConfig> | undefined;
+export declare function resolveEffectiveConfig(config: PersonaConfig): PersonaConfig;
+//# sourceMappingURL=effective-config.d.ts.map

package/dist/core/effective-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effective-config.d.ts","sourceRoot":"","sources":["../../src/core/effective-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG9D;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,aAAa,EAAE,gBAAgB,CAAC,GAAG,SAAS,CAGxH;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,SAAS,CAS/F;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAQ3E"}

package/dist/core/effective-config.js

@@ -0,0 +1,33 @@
+import { buildMemoryEntityConfig, buildCraftMemoryEntityConfig } from './memory-actions.js';
+/**
+ * Resolve the effective actions for a persona.
+ * Memory actions are no longer merged here — they flow through the entity CRUD system.
+ */
+export function resolveActions(config) {
+    const actions = config.actions ? { ...config.actions } : {};
+    return Object.keys(actions).length > 0 ? actions : undefined;
+}
+/**
+ * Resolve the effective entities for a persona, including internal memory entities
+ * when memory.enabled or craftMemory.enabled are set.
+ */
+export function resolveEntities(config) {
+    const entities = { ...(config.entities ?? {}) };
+    if (config.memory?.enabled) {
+        entities.memory = buildMemoryEntityConfig(config.memory.categories);
+    }
+    if (config.craftMemory?.enabled) {
+        entities.craftMemory = buildCraftMemoryEntityConfig(config.craftMemory.categories);
+    }
+    return Object.keys(entities).length > 0 ? entities : undefined;
+}
+export function resolveEffectiveConfig(config) {
+    const actions = resolveActions(config);
+    const entities = resolveEntities(config);
+    return {
+        ...config,
+        ...(actions !== config.actions ? { actions } : {}),
+        ...(entities !== config.entities ? { entities } : {}),
+    };
+}
+//# sourceMappingURL=effective-config.js.map

package/dist/core/effective-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effective-config.js","sourceRoot":"","sources":["../../src/core/effective-config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAA;AAE3F;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAqB;IAClD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAC3D,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;AAC9D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAqB;IACnD,MAAM,QAAQ,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAA;IAC/C,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QAC3B,QAAQ,CAAC,MAAM,GAAG,uBAAuB,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;IACrE,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC;QAChC,QAAQ,CAAC,WAAW,GAAG,4BAA4B,CAAC,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,CAAA;IACpF,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAA;AAChE,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAqB;IAC1D,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAA;IACtC,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;IACxC,OAAO;QACL,GAAG,MAAM;QACT,GAAG,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClD,GAAG,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,CAAA;AACH,CAAC"}

package/dist/core/entities.d.ts

@@ -0,0 +1,82 @@
+import { z } from 'zod';
+import type { ActionDefinition, ActionConfidence, ContextInputDefinition, ContextFormat } from '../types.js';
+export interface EntityOperationConfig {
+    confidence: ActionConfidence;
+    /** Override the auto-generated action description */
+    description?: string;
+}
+export type CrudOperationName = 'create' | 'update' | 'delete';
+export type CrudConfigInput = ActionConfidence | Partial<Record<CrudOperationName, ActionConfidence>>;
+export interface EntityDefinitionInput {
+    /** Entity name in singular form (e.g., 'thread', 'meal', 'document') */
+    name: string;
+    /** Zod schema for entity fields */
+    schema: z.ZodObject<z.ZodRawShape>;
+    /** Human-readable entity name (e.g. "Thread", "Forcing Function"). Defaults to capitalize(name). */
+    label?: string;
+    /** Which field in params to use as display title (e.g. "title", "what", "cueText") */
+    displayField?: string;
+    /** How to display entities in the prompt */
+    contextFormat?: ContextFormat;
+    /** Character budget for the context block */
+    contextBudget?: number;
+    /** Context priority level */
+    contextPriority?: 'normal' | 'critical';
+    /** Which CRUD operations the AI can perform */
+    operations: {
+        create?: EntityOperationConfig;
+        update?: EntityOperationConfig;
+        delete?: EntityOperationConfig;
+    };
+}
+export interface EntityDefinitionResult {
+    /** Generated ActionDefinitions for the entity's CRUD operations */
+    actions: Record<string, ActionDefinition>;
+    /** Generated ContextInputDefinition for prompt injection */
+    contextInput: ContextInputDefinition;
+    /** Human-readable entity name (resolved: input.label ?? capitalize(name)) */
+    label: string;
+    /** Which field in params to use as display title */
+    displayField?: string;
+}
+/**
+ * Convenience helper for common CRUD entities.
+ * Note: most apps now use `entities` on PersonaConfig directly. This utility
+ * is still available for advanced integrations that need manual wiring.
+ *
+ * Examples:
+ * ```ts
+ * operations: crud('medium')
+ * operations: crud({ create: 'low', update: 'medium', delete: 'high' })
+ * operations: crud(
+ *   { create: 'low', update: 'medium', delete: 'medium' },
+ *   { update: 'Prefer updating existing tasks over duplicates.' },
+ * )
+ * ```
+ */
+export declare function crud(config?: CrudConfigInput, descriptions?: Partial<Record<CrudOperationName, string>>): EntityDefinitionInput['operations'];
+/**
+ * Define a domain entity and get auto-generated action definitions + context input.
+ *
+ * Note: most apps now declare entities via `entities` on PersonaConfig, which
+ * handles prompt generation and response schema automatically. This function
+ * is available for advanced integrations that need manual action wiring.
+ *
+ * Eliminates CRUD boilerplate: instead of manually writing Zod schemas for
+ * createThread, updateThread, deleteThread actions + a context input definition,
+ * declare the entity once and get everything generated.
+ *
+ * Example:
+ * ```typescript
+ * const threadEntity = defineEntity({
+ *   name: 'thread',
+ *   schema: z.object({ title: z.string(), status: z.string(), owner: z.string() }),
+ *   contextFormat: 'list',
+ *   operations: {
+ *     update: { confidence: 'high' },   // CEO must approve
+ *   },
+ * })
+ * ```
+ */
+export declare function defineEntity(input: EntityDefinitionInput): EntityDefinitionResult;
+//# sourceMappingURL=entities.d.ts.map

package/dist/core/entities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../src/core/entities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAI5G,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,gBAAgB,CAAA;IAC5B,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAE9D,MAAM,MAAM,eAAe,GACvB,gBAAgB,GAChB,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC,CAAA;AAExD,MAAM,WAAW,qBAAqB;IACpC,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAA;IACZ,mCAAmC;IACnC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAA;IAClC,oGAAoG;IACpG,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,6CAA6C;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,6BAA6B;IAC7B,eAAe,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAA;IACvC,+CAA+C;IAC/C,UAAU,EAAE;QACV,MAAM,CAAC,EAAE,qBAAqB,CAAA;QAC9B,MAAM,CAAC,EAAE,qBAAqB,CAAA;QAC9B,MAAM,CAAC,EAAE,qBAAqB,CAAA;KAC/B,CAAA;CACF;AAED,MAAM,WAAW,sBAAsB;IACrC,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;IACzC,4DAA4D;IAC5D,YAAY,EAAE,sBAAsB,CAAA;IACpC,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAA;IACb,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,IAAI,CAClB,MAAM,GAAE,eAA0B,EAClC,YAAY,GAAE,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAM,GAC5D,qBAAqB,CAAC,YAAY,CAAC,CAiBrC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,qBAAqB,GAAG,sBAAsB,CA+DjF"}

package/dist/core/entities.js

@@ -0,0 +1,116 @@
+import { z } from 'zod';
+/**
+ * Convenience helper for common CRUD entities.
+ * Note: most apps now use `entities` on PersonaConfig directly. This utility
+ * is still available for advanced integrations that need manual wiring.
+ *
+ * Examples:
+ * ```ts
+ * operations: crud('medium')
+ * operations: crud({ create: 'low', update: 'medium', delete: 'high' })
+ * operations: crud(
+ *   { create: 'low', update: 'medium', delete: 'medium' },
+ *   { update: 'Prefer updating existing tasks over duplicates.' },
+ * )
+ * ```
+ */
+export function crud(config = 'medium', descriptions = {}) {
+    const confidences = typeof config === 'string'
+        ? { create: config, update: config, delete: config }
+        : config;
+    const operations = {};
+    for (const op of ['create', 'update', 'delete']) {
+        const confidence = confidences[op];
+        if (!confidence)
+            continue;
+        operations[op] = {
+            confidence,
+            ...(descriptions[op] ? { description: descriptions[op] } : {}),
+        };
+    }
+    return operations;
+}
+/**
+ * Define a domain entity and get auto-generated action definitions + context input.
+ *
+ * Note: most apps now declare entities via `entities` on PersonaConfig, which
+ * handles prompt generation and response schema automatically. This function
+ * is available for advanced integrations that need manual action wiring.
+ *
+ * Eliminates CRUD boilerplate: instead of manually writing Zod schemas for
+ * createThread, updateThread, deleteThread actions + a context input definition,
+ * declare the entity once and get everything generated.
+ *
+ * Example:
+ * ```typescript
+ * const threadEntity = defineEntity({
+ *   name: 'thread',
+ *   schema: z.object({ title: z.string(), status: z.string(), owner: z.string() }),
+ *   contextFormat: 'list',
+ *   operations: {
+ *     update: { confidence: 'high' },   // CEO must approve
+ *   },
+ * })
+ * ```
+ */
+export function defineEntity(input) {
+    const { name, schema, operations } = input;
+    const Name = capitalize(name);
+    const actions = {};
+    // Determine if update/delete exist (they need IDs)
+    const hasUpdate = !!operations.update;
+    const hasDelete = !!operations.delete;
+    const needsIds = hasUpdate || hasDelete;
+    // Create action
+    if (operations.create) {
+        const actionName = `create${Name}`;
+        actions[actionName] = {
+            description: operations.create.description
+                ?? `Create a new ${name}. Use when a new ${name} needs to be tracked.`,
+            schema: schema,
+            confidence: operations.create.confidence,
+        };
+    }
+    // Update action — takes id + partial fields
+    if (operations.update) {
+        const actionName = `update${Name}`;
+        actions[actionName] = {
+            description: operations.update.description
+                ?? `Update an existing ${name} by ID. Reference the (id:xxx) from the ${name.toUpperCase()}S context.`,
+            schema: z.object({
+                id: z.string().describe(`The ${name} ID to update`),
+                updates: schema.partial().describe(`Fields to update on the ${name}`),
+            }),
+            confidence: operations.update.confidence,
+        };
+    }
+    // Delete action
+    if (operations.delete) {
+        const actionName = `delete${Name}`;
+        actions[actionName] = {
+            description: operations.delete.description
+                ?? `Delete a ${name} by ID. Reference the (id:xxx) from the ${name.toUpperCase()}S context.`,
+            schema: z.object({
+                id: z.string().describe(`The ${name} ID to delete`),
+            }),
+            confidence: operations.delete.confidence,
+        };
+    }
+    // Context input definition
+    const contextInput = {
+        label: `${name.toUpperCase()}S`,
+        format: input.contextFormat ?? 'list',
+        ...(input.contextBudget ? { budget: input.contextBudget } : {}),
+        ...(input.contextPriority ? { priority: input.contextPriority } : {}),
+        // Entities with update/delete need IDs in the context
+        ...(needsIds ? { includeIds: true } : {}),
+    };
+    // Resolve entity metadata
+    const label = input.label ?? Name;
+    const displayField = input.displayField;
+    return { actions, contextInput, label, displayField };
+}
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+//# sourceMappingURL=entities.js.map

package/dist/core/entities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.js","sourceRoot":"","sources":["../../src/core/entities.ts"],"names":[],"mappings":"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"}