phaibel 4.0.7

package/dist/entities/spawner.js

@@ -0,0 +1,294 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// SPAWNER — Generic engine for entities that generate child entities
+//
+// Supports two modes:
+//   date-series  — generates one child per occurrence date (like recurrences)
+//   template     — spawns a fixed set of children once
+// ─────────────────────────────────────────────────────────────────────────────
+import { promises as fs } from 'fs';
+import path from 'path';
+import matter from 'gray-matter';
+import { generateEntityId, writeEntity, ensureEntityDir, entityFilename } from './entity.js';
+import { getEntityType } from './entity-type-config.js';
+import { getEntityIndex } from './entity-index.js';
+import { debug } from '../utils/debug.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// DATE UTILITIES
+// ─────────────────────────────────────────────────────────────────────────────
+const DAYS_OF_WEEK = ['sunday', 'monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday'];
+export function formatDate(d) {
+    const y = d.getFullYear();
+    const m = String(d.getMonth() + 1).padStart(2, '0');
+    const day = String(d.getDate()).padStart(2, '0');
+    return `${y}-${m}-${day}`;
+}
+/**
+ * Compute all occurrence dates within [start, end] for daily/weekly/monthly cadences.
+ */
+export function computeOccurrences(cadence, details, start, end) {
+    const dates = [];
+    const cursor = new Date(start);
+    cursor.setHours(0, 0, 0, 0);
+    switch (cadence) {
+        case 'daily': {
+            while (cursor <= end) {
+                dates.push(new Date(cursor));
+                cursor.setDate(cursor.getDate() + 1);
+            }
+            break;
+        }
+        case 'weekly': {
+            const targetDay = DAYS_OF_WEEK.indexOf((details.dayOfWeek ?? 'monday').toLowerCase());
+            while (cursor.getDay() !== targetDay && cursor <= end) {
+                cursor.setDate(cursor.getDate() + 1);
+            }
+            while (cursor <= end) {
+                dates.push(new Date(cursor));
+                cursor.setDate(cursor.getDate() + 7);
+            }
+            break;
+        }
+        case 'monthly': {
+            const targetDom = details.dayOfMonth ?? 1;
+            cursor.setDate(targetDom);
+            if (cursor < start) {
+                cursor.setMonth(cursor.getMonth() + 1);
+                cursor.setDate(targetDom);
+            }
+            while (cursor <= end) {
+                dates.push(new Date(cursor));
+                cursor.setMonth(cursor.getMonth() + 1);
+                cursor.setDate(targetDom);
+            }
+            break;
+        }
+    }
+    return dates;
+}
+/**
+ * Returns true if the date falls inside any blackout window.
+ */
+export function isBlackedOut(date, windows) {
+    const d = formatDate(date);
+    return windows.some(w => d >= w.start && d <= w.end);
+}
+/**
+ * Interpolate a title pattern like "{title} — {YYYY-MM-DD}" for a given date.
+ */
+export function interpolateTitlePattern(pattern, title, date) {
+    return pattern
+        .replace('{title}', title)
+        .replace('{YYYY-MM-DD}', formatDate(date));
+}
+/**
+ * Build child entity fields from a FieldMapping array.
+ * Tokens: {date} → YYYY-MM-DD string, {title} → template title
+ */
+export function applyFieldMapping(mappings, template, date) {
+    const result = {};
+    if (!mappings)
+        return result;
+    const dateStr = date ? formatDate(date) : '';
+    for (const m of mappings) {
+        const targetKey = m.to ?? m.target;
+        if (!targetKey)
+            continue;
+        if (m.from) {
+            // Copy value from template field
+            const val = template.meta[m.from];
+            result[targetKey] = val !== undefined ? val : m.default;
+        }
+        else if (m.value !== undefined) {
+            // Literal value or token substitution
+            const raw = String(m.value);
+            result[targetKey] = raw
+                .replace('{date}', dateStr)
+                .replace('{title}', String(template.meta.title ?? ''))
+                .replace('{YYYY-MM-DD}', dateStr);
+        }
+    }
+    return result;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// DATE-SERIES SPAWNER
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Generate child entities for a date-series spawner (e.g. recurrence).
+ * Creates one child per occurrence date within [startDate, endDate].
+ * Idempotent: skips already-created children based on dedupeFields.
+ */
+export async function spawnDateSeries(template, spawnerConfig, targetTypeConfig, startDate, endDate) {
+    const scheduling = spawnerConfig.scheduling;
+    if (!scheduling)
+        throw new Error('date-series spawner requires scheduling config');
+    const cadence = template.meta[scheduling.cadenceField] ?? 'monthly';
+    const rawDetails = template.meta[scheduling.cadenceDetailsField];
+    const cadenceDetails = (rawDetails && typeof rawDetails === 'object' && !Array.isArray(rawDetails)) ? rawDetails : {};
+    const rawBlackout = template.meta[scheduling.blackoutField];
+    const blackoutWindows = Array.isArray(rawBlackout) ? rawBlackout : [];
+    const occurrences = computeOccurrences(cadence, cadenceDetails, startDate, endDate);
+    const targetDir = await ensureEntityDir(targetTypeConfig.name);
+    // Load existing entities for dedup check
+    const existingFiles = await safeReaddir(targetDir);
+    const existingMetas = await Promise.all(existingFiles.filter(f => f.endsWith('.md')).map(async (f) => {
+        const raw = await fs.readFile(path.join(targetDir, f), 'utf-8');
+        return matter(raw).data;
+    }));
+    const titlePattern = spawnerConfig.titlePattern ?? '{title} — {YYYY-MM-DD}';
+    const dedupeFields = spawnerConfig.dedupeFields ?? [];
+    const templateTitle = String(template.meta.title ?? '');
+    let created = 0;
+    let skipped = 0;
+    for (const date of occurrences) {
+        if (isBlackedOut(date, blackoutWindows)) {
+            skipped++;
+            continue;
+        }
+        const dateStr = formatDate(date);
+        // Idempotency check using dedupeFields
+        if (dedupeFields.length > 0) {
+            const mappedFields = applyFieldMapping(spawnerConfig.fieldMapping, template, date);
+            const alreadyExists = existingMetas.some(m => dedupeFields.every(f => m[f] === mappedFields[f]));
+            if (alreadyExists) {
+                skipped++;
+                continue;
+            }
+        }
+        const childTitle = interpolateTitlePattern(titlePattern, templateTitle, date);
+        const id = generateEntityId(targetTypeConfig.name);
+        const filepath = path.join(targetDir, entityFilename(childTitle, id));
+        // Build child meta
+        const childMeta = {
+            id,
+            title: childTitle,
+            entityType: targetTypeConfig.name,
+            created: new Date().toISOString(),
+            tags: [...(targetTypeConfig.defaultTags ?? []), 'recurring'],
+            ...applyFieldMapping(spawnerConfig.fieldMapping, template, date),
+        };
+        // For event targets: attach times from cadenceDetails if available
+        if (targetTypeConfig.name === 'event' && (cadenceDetails.startTime || cadenceDetails.endTime)) {
+            const startTime = cadenceDetails.startTime ?? '09:00';
+            const endTime = cadenceDetails.endTime ?? '10:00';
+            childMeta.startDate = `${dateStr}T${startTime}:00`;
+            childMeta.endDate = `${dateStr}T${endTime}:00`;
+            if (cadenceDetails.location)
+                childMeta.location = cadenceDetails.location;
+        }
+        await writeEntity(filepath, childMeta, template.content);
+        // Update entity index incrementally
+        const index = getEntityIndex();
+        if (index.isBuilt) {
+            const tags = Array.isArray(childMeta.tags) ? childMeta.tags : [];
+            await index.addOrUpdate(targetTypeConfig.name, id, childTitle, filepath, tags);
+        }
+        debug('spawner', `Created ${targetTypeConfig.name}: ${childTitle}`);
+        created++;
+    }
+    return { created, skipped };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// TEMPLATE SPAWNER (one-shot)
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Spawn a fixed set of child entities from a template entity.
+ * The template entity must have a field (childrenField) containing an array of ChildSpec.
+ * Idempotent: skips children whose title already exists in the target directory.
+ */
+export async function spawnTemplate(template, spawnerConfig, targetTypeConfig) {
+    const childrenField = spawnerConfig.childrenField ?? 'children';
+    const children = template.meta[childrenField];
+    if (!Array.isArray(children) || children.length === 0) {
+        debug('spawner', `Template "${template.meta.title}" has no children to spawn`);
+        return { created: 0, skipped: 0 };
+    }
+    const targetDir = await ensureEntityDir(targetTypeConfig.name);
+    const existingFiles = await safeReaddir(targetDir);
+    const existingTitles = new Set(await Promise.all(existingFiles.filter(f => f.endsWith('.md')).map(async (f) => {
+        const raw = await fs.readFile(path.join(targetDir, f), 'utf-8');
+        return String(matter(raw).data.title ?? '').toLowerCase();
+    })));
+    let created = 0;
+    let skipped = 0;
+    for (const child of children) {
+        if (!child.title)
+            continue;
+        if (existingTitles.has(child.title.toLowerCase())) {
+            skipped++;
+            continue;
+        }
+        const id = generateEntityId(targetTypeConfig.name);
+        const filepath = path.join(targetDir, entityFilename(child.title, id));
+        const childMeta = {
+            id,
+            title: child.title,
+            entityType: targetTypeConfig.name,
+            created: new Date().toISOString(),
+            tags: [...(targetTypeConfig.defaultTags ?? [])],
+            ...(child.fields ?? {}),
+        };
+        // Apply defaults from field definitions
+        for (const fieldDef of targetTypeConfig.fields) {
+            if (childMeta[fieldDef.key] === undefined && fieldDef.default !== undefined) {
+                childMeta[fieldDef.key] = fieldDef.default;
+            }
+        }
+        await writeEntity(filepath, childMeta, child.body ?? '');
+        const index = getEntityIndex();
+        if (index.isBuilt) {
+            const tags = Array.isArray(childMeta.tags) ? childMeta.tags : [];
+            await index.addOrUpdate(targetTypeConfig.name, id, child.title, filepath, tags);
+        }
+        debug('spawner', `Spawned ${targetTypeConfig.name}: ${child.title}`);
+        created++;
+    }
+    return { created, skipped };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// UNIFIED ENTRY POINT
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Spawn children from a template entity.
+ * Resolves the target entity type from the spawner config, then delegates to
+ * the appropriate spawn mode.
+ */
+export async function spawn(template, spawnerConfig, opts = {}) {
+    // Resolve target entity type
+    const targetTypeName = spawnerConfig.targetTypeField
+        ? template.meta[spawnerConfig.targetTypeField]
+        : null;
+    if (!targetTypeName) {
+        throw new Error(`Spawner requires targetTypeField to be set on the template entity`);
+    }
+    const targetTypeConfig = await getEntityType(targetTypeName);
+    if (!targetTypeConfig) {
+        throw new Error(`Unknown target entity type: "${targetTypeName}"`);
+    }
+    if (spawnerConfig.mode === 'date-series') {
+        const today = new Date();
+        today.setHours(0, 0, 0, 0);
+        const start = opts.startDate ?? today;
+        const end = opts.endDate ?? (() => {
+            const d = new Date(today);
+            d.setDate(d.getDate() + 60);
+            return d;
+        })();
+        return spawnDateSeries(template, spawnerConfig, targetTypeConfig, start, end);
+    }
+    if (spawnerConfig.mode === 'template') {
+        return spawnTemplate(template, spawnerConfig, targetTypeConfig);
+    }
+    throw new Error(`Unknown spawner mode: "${spawnerConfig.mode}"`);
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// HELPERS
+// ─────────────────────────────────────────────────────────────────────────────
+async function safeReaddir(dir) {
+    try {
+        return await fs.readdir(dir);
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=spawner.js.map

package/dist/entities/spawner.js.map

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

package/dist/feral/agent/agent-brain.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Result of an AgentBrain thinking step.
+ */
+export interface AgentThought {
+    /** The action/decision the brain recommends */
+    action: string;
+    /** Any parameters for the action */
+    parameters: Record<string, unknown>;
+    /** The brain's reasoning */
+    reasoning: string;
+    /** Whether the brain considers the task complete */
+    done: boolean;
+}
+/**
+ * Interface for AI brain implementations.
+ * The brain interprets prompts and produces structured decisions.
+ */
+export interface AgentBrain {
+    /** Process a prompt and return a structured thought */
+    think(prompt: string): Promise<AgentThought>;
+}
+//# sourceMappingURL=agent-brain.d.ts.map

package/dist/feral/agent/agent-brain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-brain.d.ts","sourceRoot":"","sources":["../../../src/feral/agent/agent-brain.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,IAAI,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACvB,uDAAuD;IACvD,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAChD"}

package/dist/feral/agent/agent-brain.js

@@ -0,0 +1,5 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral Agent — Agent Brain Interface
+// ─────────────────────────────────────────────────────────────────────────────
+export {};
+//# sourceMappingURL=agent-brain.js.map

package/dist/feral/agent/agent-brain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-brain.js","sourceRoot":"","sources":["../../../src/feral/agent/agent-brain.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,sCAAsC;AACtC,gFAAgF"}

package/dist/feral/agent/agent.d.ts

@@ -0,0 +1,27 @@
+import type { Context } from '../context/context.js';
+/**
+ * Result status for agent execution.
+ */
+export declare const AgentResult: {
+    readonly SUCCESS: "success";
+    readonly FAILURE: "failure";
+    readonly MAX_ITERATIONS: "max_iterations";
+};
+export type AgentResultValue = (typeof AgentResult)[keyof typeof AgentResult];
+/**
+ * Outcome of an agent run.
+ */
+export interface AgentOutcome {
+    status: AgentResultValue;
+    message: string;
+    context: Context;
+    iterations: number;
+}
+/**
+ * Interface for agents that execute multi-step tasks using a brain.
+ */
+export interface Agent {
+    /** Execute the agent with the given prompt and initial context */
+    run(prompt: string, context?: Context): Promise<AgentOutcome>;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/feral/agent/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/feral/agent/agent.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,WAAW;;;;CAId,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IAClB,kEAAkE;IAClE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACjE"}

package/dist/feral/agent/agent.js

@@ -0,0 +1,12 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral Agent — Agent Interface
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Result status for agent execution.
+ */
+export const AgentResult = {
+    SUCCESS: 'success',
+    FAILURE: 'failure',
+    MAX_ITERATIONS: 'max_iterations',
+};
+//# sourceMappingURL=agent.js.map

package/dist/feral/agent/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../src/feral/agent/agent.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,gCAAgC;AAChC,gFAAgF;AAIhF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACvB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,cAAc,EAAE,gBAAgB;CAC1B,CAAC"}

package/dist/feral/agent/chatgpt-brain.d.ts

@@ -0,0 +1,14 @@
+import type { AgentBrain, AgentThought } from './agent-brain.js';
+/**
+ * OpenAI SDK-based implementation of AgentBrain.
+ * Uses chat completions with structured output instructions.
+ */
+export declare class ChatGptBrain implements AgentBrain {
+    private apiKey;
+    private model;
+    private baseUrl?;
+    constructor(apiKey: string, model?: string, baseUrl?: string);
+    think(prompt: string): Promise<AgentThought>;
+    private extractJson;
+}
+//# sourceMappingURL=chatgpt-brain.d.ts.map

package/dist/feral/agent/chatgpt-brain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatgpt-brain.d.ts","sourceRoot":"","sources":["../../../src/feral/agent/chatgpt-brain.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEjE;;;GAGG;AACH,qBAAa,YAAa,YAAW,UAAU;IAC3C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAC,CAAS;gBAEb,MAAM,EAAE,MAAM,EAAE,KAAK,SAAW,EAAE,OAAO,CAAC,EAAE,MAAM;IAMxD,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAkDlD,OAAO,CAAC,WAAW;CAOtB"}

package/dist/feral/agent/chatgpt-brain.js

@@ -0,0 +1,73 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral Agent — ChatGPT Brain
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * OpenAI SDK-based implementation of AgentBrain.
+ * Uses chat completions with structured output instructions.
+ */
+export class ChatGptBrain {
+    apiKey;
+    model;
+    baseUrl;
+    constructor(apiKey, model = 'gpt-4o', baseUrl) {
+        this.apiKey = apiKey;
+        this.model = model;
+        this.baseUrl = baseUrl;
+    }
+    async think(prompt) {
+        const { default: OpenAI } = await import('openai');
+        const client = new OpenAI({
+            apiKey: this.apiKey,
+            ...(this.baseUrl ? { baseURL: this.baseUrl } : {}),
+        });
+        const systemPrompt = [
+            'You are an AI agent brain. Given a prompt, decide what action to take.',
+            'You must respond with valid JSON in this format:',
+            '{',
+            '  "action": "name_of_action",',
+            '  "parameters": { ... },',
+            '  "reasoning": "why you chose this action",',
+            '  "done": false',
+            '}',
+            '',
+            'Set "done" to true when the task is complete.',
+            'Respond ONLY with the JSON, no other text.',
+        ].join('\n');
+        const completion = await client.chat.completions.create({
+            model: this.model,
+            messages: [
+                { role: 'system', content: systemPrompt },
+                { role: 'user', content: prompt },
+            ],
+            temperature: 0.3,
+        });
+        const raw = completion.choices[0]?.message?.content ?? '{}';
+        try {
+            const parsed = JSON.parse(this.extractJson(raw));
+            return {
+                action: parsed.action ?? 'unknown',
+                parameters: parsed.parameters ?? {},
+                reasoning: parsed.reasoning ?? '',
+                done: parsed.done ?? false,
+            };
+        }
+        catch {
+            return {
+                action: 'error',
+                parameters: { raw },
+                reasoning: 'Failed to parse brain response as JSON',
+                done: true,
+            };
+        }
+    }
+    extractJson(text) {
+        const fenceMatch = text.match(/```(?:json)?\s*\n?([\s\S]*?)\n?\s*```/);
+        if (fenceMatch)
+            return fenceMatch[1].trim();
+        const objectMatch = text.match(/\{[\s\S]*\}/);
+        if (objectMatch)
+            return objectMatch[0];
+        return text.trim();
+    }
+}
+//# sourceMappingURL=chatgpt-brain.js.map

package/dist/feral/agent/chatgpt-brain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatgpt-brain.js","sourceRoot":"","sources":["../../../src/feral/agent/chatgpt-brain.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,8BAA8B;AAC9B,gFAAgF;AAIhF;;;GAGG;AACH,MAAM,OAAO,YAAY;IACb,MAAM,CAAS;IACf,KAAK,CAAS;IACd,OAAO,CAAU;IAEzB,YAAY,MAAc,EAAE,KAAK,GAAG,QAAQ,EAAE,OAAgB;QAC1D,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAc;QACtB,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC;YACtB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrD,CAAC,CAAC;QAEH,MAAM,YAAY,GAAG;YACjB,wEAAwE;YACxE,kDAAkD;YAClD,GAAG;YACH,+BAA+B;YAC/B,0BAA0B;YAC1B,6CAA6C;YAC7C,iBAAiB;YACjB,GAAG;YACH,EAAE;YACF,+CAA+C;YAC/C,4CAA4C;SAC/C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;YACpD,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE;gBACN,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE;gBACzC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;aACpC;YACD,WAAW,EAAE,GAAG;SACnB,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC;QAE5D,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;YACjD,OAAO;gBACH,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,SAAS;gBAClC,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,EAAE;gBACnC,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE;gBACjC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,KAAK;aAC7B,CAAC;QACN,CAAC;QAAC,MAAM,CAAC;YACL,OAAO;gBACH,MAAM,EAAE,OAAO;gBACf,UAAU,EAAE,EAAE,GAAG,EAAE;gBACnB,SAAS,EAAE,wCAAwC;gBACnD,IAAI,EAAE,IAAI;aACb,CAAC;QACN,CAAC;IACL,CAAC;IAEO,WAAW,CAAC,IAAY;QAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;QACvE,IAAI,UAAU;YAAE,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAC9C,IAAI,WAAW;YAAE,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;CACJ"}

package/dist/feral/agent/index.d.ts

@@ -0,0 +1,10 @@
+export type { ModelPropertySchema, ModelSchema } from './model-schema.js';
+export { ModelSchemaRegistry } from './model-schema.js';
+export type { AgentBrain, AgentThought } from './agent-brain.js';
+export { ChatGptBrain } from './chatgpt-brain.js';
+export { AgentResult } from './agent.js';
+export type { Agent, AgentOutcome, AgentResultValue } from './agent.js';
+export { ProcessAgent } from './process-agent.js';
+export { ProtoFlowAgent } from './protoflow-agent.js';
+export { RenderPrompt } from './render-prompt.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/feral/agent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/feral/agent/index.ts"],"names":[],"mappings":"AAKA,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGxD,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGxE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/feral/agent/index.js

@@ -0,0 +1,13 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral Agent — Public API
+// ─────────────────────────────────────────────────────────────────────────────
+export { ModelSchemaRegistry } from './model-schema.js';
+export { ChatGptBrain } from './chatgpt-brain.js';
+// Agent
+export { AgentResult } from './agent.js';
+// Agents
+export { ProcessAgent } from './process-agent.js';
+export { ProtoFlowAgent } from './protoflow-agent.js';
+// Utilities
+export { RenderPrompt } from './render-prompt.js';
+//# sourceMappingURL=index.js.map

package/dist/feral/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/feral/agent/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAIhF,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAIxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,QAAQ;AACR,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,YAAY;AACZ,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/feral/agent/model-schema.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Describes a single property on a model for GenAI hydration.
+ */
+export interface ModelPropertySchema {
+    readonly name: string;
+    readonly type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    readonly description: string;
+    readonly required: boolean;
+    readonly default?: unknown;
+    readonly items?: ModelPropertySchema;
+}
+/**
+ * Describes a model's schema for GenAI prompt generation and response hydration.
+ * Replaces PHP Reflection + Attributes with an explicit registry.
+ */
+export interface ModelSchema {
+    readonly key: string;
+    readonly name: string;
+    readonly description: string;
+    readonly properties: ModelPropertySchema[];
+}
+/**
+ * Registry for model schemas used by GenAI NodeCodes.
+ * Models are registered at bootstrap time and referenced by key.
+ */
+export declare class ModelSchemaRegistry {
+    private schemas;
+    register(schema: ModelSchema): void;
+    get(key: string): ModelSchema;
+    has(key: string): boolean;
+    getAll(): ModelSchema[];
+    /**
+     * Generate a JSON Schema-like prompt description for a model.
+     */
+    toPromptText(key: string): string;
+}
+//# sourceMappingURL=model-schema.d.ts.map

package/dist/feral/agent/model-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-schema.d.ts","sourceRoot":"","sources":["../../../src/feral/agent/model-schema.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,mBAAmB,CAAC;CACxC;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,mBAAmB,EAAE,CAAC;CAC9C;AAED;;;GAGG;AACH,qBAAa,mBAAmB;IAC5B,OAAO,CAAC,OAAO,CAAuC;IAEtD,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAInC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;IAQ7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,MAAM,IAAI,WAAW,EAAE;IAIvB;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAapC"}

package/dist/feral/agent/model-schema.js

@@ -0,0 +1,43 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral Agent — Model Schema & Registry
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Registry for model schemas used by GenAI NodeCodes.
+ * Models are registered at bootstrap time and referenced by key.
+ */
+export class ModelSchemaRegistry {
+    schemas = new Map();
+    register(schema) {
+        this.schemas.set(schema.key, schema);
+    }
+    get(key) {
+        const schema = this.schemas.get(key);
+        if (!schema) {
+            throw new Error(`Model schema "${key}" not found in registry.`);
+        }
+        return schema;
+    }
+    has(key) {
+        return this.schemas.has(key);
+    }
+    getAll() {
+        return Array.from(this.schemas.values());
+    }
+    /**
+     * Generate a JSON Schema-like prompt description for a model.
+     */
+    toPromptText(key) {
+        const schema = this.get(key);
+        const props = schema.properties.map(p => {
+            const req = p.required ? ' (required)' : ' (optional)';
+            return `  - ${p.name}: ${p.type}${req} — ${p.description}`;
+        });
+        return [
+            `Model: ${schema.name}`,
+            `Description: ${schema.description}`,
+            `Properties:`,
+            ...props,
+        ].join('\n');
+    }
+}
+//# sourceMappingURL=model-schema.js.map

package/dist/feral/agent/model-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-schema.js","sourceRoot":"","sources":["../../../src/feral/agent/model-schema.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,wCAAwC;AACxC,gFAAgF;AAyBhF;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IACpB,OAAO,GAA6B,IAAI,GAAG,EAAE,CAAC;IAEtD,QAAQ,CAAC,MAAmB;QACxB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,GAAG,CAAC,GAAW;QACX,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,iBAAiB,GAAG,0BAA0B,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,GAAG,CAAC,GAAW;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,MAAM;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,GAAW;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YACpC,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC;YACvD,OAAO,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,GAAG,GAAG,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC/D,CAAC,CAAC,CAAC;QACH,OAAO;YACH,UAAU,MAAM,CAAC,IAAI,EAAE;YACvB,gBAAgB,MAAM,CAAC,WAAW,EAAE;YACpC,aAAa;YACb,GAAG,KAAK;SACX,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;CACJ"}