phaibel 4.0.7

package/dist/llm/providers/openai.js

@@ -0,0 +1,62 @@
+import OpenAI from 'openai';
+import { getApiKey } from '../../config.js';
+export class OpenAIProvider {
+    name = 'openai';
+    client = null;
+    modelId;
+    constructor(modelId = 'gpt-4o') {
+        this.modelId = modelId;
+    }
+    async getClient() {
+        if (this.client) {
+            return this.client;
+        }
+        const apiKey = await getApiKey('openai');
+        if (!apiKey) {
+            throw new Error("An API key for OpenAI is needed. Please run 'phaibel config add-provider openai'");
+        }
+        this.client = new OpenAI({ apiKey });
+        return this.client;
+    }
+    async chat(messages, options = {}) {
+        const client = await this.getClient();
+        // Convert messages to OpenAI format
+        const openaiMessages = [];
+        // Add system prompt if provided
+        if (options.systemPrompt) {
+            openaiMessages.push({
+                role: 'system',
+                content: options.systemPrompt,
+            });
+        }
+        // Add other messages
+        for (const msg of messages) {
+            openaiMessages.push({
+                role: msg.role,
+                content: msg.content,
+            });
+        }
+        const response = await client.chat.completions.create({
+            model: this.modelId,
+            max_tokens: options.maxTokens || 4096,
+            messages: openaiMessages,
+        });
+        return response.choices[0]?.message?.content || '';
+    }
+    async embed(texts, options = {}) {
+        const client = await this.getClient();
+        const response = await client.embeddings.create({
+            model: this.modelId,
+            input: texts,
+            ...(options.dimensions ? { dimensions: options.dimensions } : {}),
+        });
+        // Sort by index to maintain input order
+        return response.data
+            .sort((a, b) => a.index - b.index)
+            .map(item => item.embedding);
+    }
+}
+export function createOpenAIProvider(modelId) {
+    return new OpenAIProvider(modelId);
+}
+//# sourceMappingURL=openai.js.map

package/dist/llm/providers/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../../src/llm/providers/openai.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,MAAM,OAAO,cAAc;IACvB,IAAI,GAAG,QAAQ,CAAC;IACR,MAAM,GAAkB,IAAI,CAAC;IAC7B,OAAO,CAAS;IAExB,YAAY,UAAkB,QAAQ;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IAEO,KAAK,CAAC,SAAS;QACnB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,OAAO,IAAI,CAAC,MAAM,CAAC;QACvB,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CACX,kFAAkF,CACrF,CAAC;QACN,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAmB,EAAE,UAAuB,EAAE;QACrD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QAEtC,oCAAoC;QACpC,MAAM,cAAc,GAA6C,EAAE,CAAC;QAEpE,gCAAgC;QAChC,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YACvB,cAAc,CAAC,IAAI,CAAC;gBAChB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,OAAO,CAAC,YAAY;aAChC,CAAC,CAAC;QACP,CAAC;QAED,qBAAqB;QACrB,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YACzB,cAAc,CAAC,IAAI,CAAC;gBAChB,IAAI,EAAE,GAAG,CAAC,IAAuC;gBACjD,OAAO,EAAE,GAAG,CAAC,OAAO;aACvB,CAAC,CAAC;QACP,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;YAClD,KAAK,EAAE,IAAI,CAAC,OAAO;YACnB,UAAU,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;YACrC,QAAQ,EAAE,cAAc;SAC3B,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAe,EAAE,UAAwB,EAAE;QACnD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QAEtC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;YAC5C,KAAK,EAAE,IAAI,CAAC,OAAO;YACnB,KAAK,EAAE,KAAK;YACZ,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpE,CAAC,CAAC;QAEH,wCAAwC;QACxC,OAAO,QAAQ,CAAC,IAAI;aACf,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;aACjC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;CACJ;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACjD,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;AACvC,CAAC"}

package/dist/llm/router.d.ts

@@ -0,0 +1,32 @@
+import type { LLMProvider } from './types.js';
+import type { LLMCapability } from '../schemas/index.js';
+/**
+ * Gets the appropriate LLM provider for a given capability.
+ *
+ * Capabilities:
+ * - reason: Complex thinking, multi-step logic (Claude Opus, GPT-4)
+ * - summarize: Condensing, prioritizing info (Claude Sonnet)
+ * - categorize: Classification, tagging (fast models like Haiku)
+ * - format: Markdown, text cleanup (fast models)
+ * - chat: General conversation (default provider)
+ * - embed: Vector embeddings (OpenAI embeddings)
+ */
+export declare function getModelForCapability(capability: LLMCapability): Promise<LLMProvider>;
+/**
+ * Get embeddings for an array of texts using the configured `embed` capability provider.
+ */
+export declare function getEmbeddings(texts: string[], dimensions?: number): Promise<number[][]>;
+/**
+ * Initialize the system prompt cache. Call once at startup.
+ */
+export declare function initSystemPromptCache(): Promise<void>;
+/**
+ * Refresh the system prompt cache (e.g. after profile save).
+ */
+export declare function refreshSystemPromptCache(): Promise<void>;
+/**
+ * Creates a system prompt with the agent's identity, capabilities, and context.
+ * Personality-aware: pulls personality config and agent name from cached state.
+ */
+export declare function createSystemPrompt(context: string): string;
+//# sourceMappingURL=router.d.ts.map

package/dist/llm/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/llm/router.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIzD;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CAAC,UAAU,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAU3F;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,UAAU,SAAM,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAM1F;AAOD;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAS3D;AAED;;GAEG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAG9D;AAKD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAgC1D"}

package/dist/llm/router.js

@@ -0,0 +1,100 @@
+import { getCapabilityModel } from '../config.js';
+import { getProvider } from './providers/index.js';
+import { getAgentName, getPersonalityId } from '../state/manager.js';
+import { getPersonality } from '../personalities.js';
+/**
+ * Gets the appropriate LLM provider for a given capability.
+ *
+ * Capabilities:
+ * - reason: Complex thinking, multi-step logic (Claude Opus, GPT-4)
+ * - summarize: Condensing, prioritizing info (Claude Sonnet)
+ * - categorize: Classification, tagging (fast models like Haiku)
+ * - format: Markdown, text cleanup (fast models)
+ * - chat: General conversation (default provider)
+ * - embed: Vector embeddings (OpenAI embeddings)
+ */
+export async function getModelForCapability(capability) {
+    const mapping = await getCapabilityModel(capability);
+    if (!mapping) {
+        throw new Error(`No provider configured for capability '${capability}'. Please run 'phaibel config add-provider openai' or 'phaibel config add-provider anthropic'.`);
+    }
+    return getProvider(mapping.provider, mapping.model);
+}
+/**
+ * Get embeddings for an array of texts using the configured `embed` capability provider.
+ */
+export async function getEmbeddings(texts, dimensions = 256) {
+    const provider = await getModelForCapability('embed');
+    if (!provider.embed) {
+        throw new Error('The configured embed provider does not support embeddings.');
+    }
+    return provider.embed(texts, { dimensions });
+}
+// ── Cached values for system prompt ─────────────────────────────────────────
+let _cachedAgentName = 'Agent';
+let _cachedPersonalityBlock = '';
+let _promptCacheLoaded = false;
+/**
+ * Initialize the system prompt cache. Call once at startup.
+ */
+export async function initSystemPromptCache() {
+    if (_promptCacheLoaded)
+        return;
+    try {
+        _cachedAgentName = await getAgentName();
+    }
+    catch { /* keep default */ }
+    try {
+        const personalityId = await getPersonalityId();
+        const personality = getPersonality(personalityId);
+        _cachedPersonalityBlock = personality.systemPromptBlock.replace(/{agentName}/g, _cachedAgentName);
+    }
+    catch { /* keep default */ }
+    _promptCacheLoaded = true;
+}
+/**
+ * Refresh the system prompt cache (e.g. after profile save).
+ */
+export async function refreshSystemPromptCache() {
+    _promptCacheLoaded = false;
+    await initSystemPromptCache();
+}
+// Fire-and-forget on import
+initSystemPromptCache();
+/**
+ * Creates a system prompt with the agent's identity, capabilities, and context.
+ * Personality-aware: pulls personality config and agent name from cached state.
+ */
+export function createSystemPrompt(context) {
+    const agentName = _cachedAgentName;
+    const personalityBlock = _cachedPersonalityBlock || `PERSONALITY:\n${agentName} is a helpful personal assistant.`;
+    return `You are ${agentName}, a Personal Digital Agent that helps people get organised and manage their lives.
+
+WHAT ${agentName.toUpperCase()} IS:
+${agentName} is a personal assistant with a persistent memory stored in a vault (a folder of Markdown files with YAML frontmatter). Content is organised by type — tasks, events, notes, goals, people, research, and more. Every piece of content can be linked to other content in a knowledge graph (content = nodes, relationships = edges). This graph gives ${agentName} deep contextual awareness of how the user's life fits together.
+
+WHAT ${agentName.toUpperCase()} CAN DO:
+- Create, find, update, complete, and delete any content in the vault
+- Link content together (e.g. a task contributes-to a goal, a person relates-to an event)
+- Define new content types on the fly when the user mentions something that isn't tracked yet
+- Call external tools and data providers via MCP skill servers
+- Send and receive messages to other agents via the PAMP protocol
+- Run scheduled tasks via cron
+- Execute multi-step processes using the Feral CCF engine (graph-based workflows)
+
+HOW ${agentName.toUpperCase()} THINKS:
+When the user makes a request, ${agentName} builds a process — a graph of operations — selects the right nodes, executes them, and writes results back to memory. ${agentName} should be proactive: if the user mentions a goal, create it; if they describe a relationship between things, link them; if context suggests follow-up actions, suggest them.
+
+${personalityBlock}
+
+GUIDELINES:
+- Be concise — respect the user's time
+- Be proactive — suggest links, follow-ups, and related content when relevant
+- Be specific — reference actual vault content by name when possible
+- Acknowledge what you did (created, updated, linked) so the user knows what changed
+- When presenting lists, keep them scannable (not walls of text)
+- If something went wrong, say so honestly and suggest what to try instead
+
+${context ? `CONTEXT:\n${context}\n` : ''}Respond helpfully to the user's request while staying in character as ${agentName}.`;
+}
+//# sourceMappingURL=router.js.map

package/dist/llm/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/llm/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,UAAyB;IACjE,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAErD,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACX,0CAA0C,UAAU,gGAAgG,CACvJ,CAAC;IACN,CAAC;IAED,OAAO,WAAW,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAe,EAAE,UAAU,GAAG,GAAG;IACjE,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACtD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,+EAA+E;AAC/E,IAAI,gBAAgB,GAAG,OAAO,CAAC;AAC/B,IAAI,uBAAuB,GAAG,EAAE,CAAC;AACjC,IAAI,kBAAkB,GAAG,KAAK,CAAC;AAE/B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACvC,IAAI,kBAAkB;QAAE,OAAO;IAC/B,IAAI,CAAC;QAAC,gBAAgB,GAAG,MAAM,YAAY,EAAE,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;IAC7E,IAAI,CAAC;QACD,MAAM,aAAa,GAAG,MAAM,gBAAgB,EAAE,CAAC;QAC/C,MAAM,WAAW,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;QAClD,uBAAuB,GAAG,WAAW,CAAC,iBAAiB,CAAC,OAAO,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;IACtG,CAAC;IAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;IAC9B,kBAAkB,GAAG,IAAI,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB;IAC1C,kBAAkB,GAAG,KAAK,CAAC;IAC3B,MAAM,qBAAqB,EAAE,CAAC;AAClC,CAAC;AAED,4BAA4B;AAC5B,qBAAqB,EAAE,CAAC;AAExB;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAC9C,MAAM,SAAS,GAAG,gBAAgB,CAAC;IACnC,MAAM,gBAAgB,GAAG,uBAAuB,IAAI,iBAAiB,SAAS,mCAAmC,CAAC;IAElH,OAAO,WAAW,SAAS;;OAExB,SAAS,CAAC,WAAW,EAAE;EAC5B,SAAS,yVAAyV,SAAS;;OAEtW,SAAS,CAAC,WAAW,EAAE;;;;;;;;;MASxB,SAAS,CAAC,WAAW,EAAE;iCACI,SAAS,0HAA0H,SAAS;;EAE3K,gBAAgB;;;;;;;;;;EAUhB,OAAO,CAAC,CAAC,CAAC,aAAa,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,yEAAyE,SAAS,GAAG,CAAC;AAC/H,CAAC"}

package/dist/llm/types.d.ts

@@ -0,0 +1,18 @@
+export interface Message {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+}
+export interface ChatOptions {
+    maxTokens?: number;
+    temperature?: number;
+    systemPrompt?: string;
+}
+export interface EmbedOptions {
+    dimensions?: number;
+}
+export interface LLMProvider {
+    name: string;
+    chat(messages: Message[], options?: ChatOptions): Promise<string>;
+    embed?(texts: string[], options?: EmbedOptions): Promise<number[][]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/llm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/llm/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACpB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClE,KAAK,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;CACxE"}

package/dist/llm/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/llm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/llm/types.ts"],"names":[],"mappings":""}

package/dist/markdown/parser.d.ts

@@ -0,0 +1,26 @@
+import { type Frontmatter } from '../schemas/index.js';
+export interface ParsedMarkdown {
+    frontmatter: Frontmatter;
+    content: string;
+}
+/**
+ * Parses a markdown file with YAML frontmatter.
+ */
+export declare function readMarkdown(filePath: string): Promise<ParsedMarkdown>;
+/**
+ * Writes a markdown file with YAML frontmatter.
+ */
+export declare function writeMarkdown(filePath: string, frontmatter: Frontmatter, content: string): Promise<void>;
+/**
+ * Updates the frontmatter of an existing markdown file.
+ */
+export declare function updateFrontmatter(filePath: string, updates: Partial<Frontmatter>): Promise<void>;
+/**
+ * Creates a new markdown file with frontmatter.
+ */
+export declare function createMarkdownFile(filePath: string, title: string, content: string, options?: Partial<Omit<Frontmatter, 'title' | 'created'>>): Promise<void>;
+/**
+ * Appends content to an existing markdown file.
+ */
+export declare function appendToMarkdown(filePath: string, newContent: string): Promise<void>;
+//# sourceMappingURL=parser.d.ts.map

package/dist/markdown/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/markdown/parser.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAE1E,MAAM,WAAW,cAAc;IAC3B,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAW5E;AAED;;GAEG;AACH,wBAAsB,aAAa,CAC/B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAC9B,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACpC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,SAAS,CAAC,CAAM,GAC9D,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAClC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/markdown/parser.js

@@ -0,0 +1,58 @@
+import { promises as fs } from 'fs';
+import matter from 'gray-matter';
+import { FrontmatterSchema } from '../schemas/index.js';
+/**
+ * Parses a markdown file with YAML frontmatter.
+ */
+export async function readMarkdown(filePath) {
+    const fileContent = await fs.readFile(filePath, 'utf-8');
+    const { data, content } = matter(fileContent);
+    // Validate frontmatter with Zod
+    const frontmatter = FrontmatterSchema.parse(data);
+    return {
+        frontmatter,
+        content: content.trim(),
+    };
+}
+/**
+ * Writes a markdown file with YAML frontmatter.
+ */
+export async function writeMarkdown(filePath, frontmatter, content) {
+    const fileContent = matter.stringify(content, frontmatter);
+    await fs.writeFile(filePath, fileContent);
+}
+/**
+ * Updates the frontmatter of an existing markdown file.
+ */
+export async function updateFrontmatter(filePath, updates) {
+    const { frontmatter, content } = await readMarkdown(filePath);
+    const updatedFrontmatter = { ...frontmatter, ...updates };
+    await writeMarkdown(filePath, updatedFrontmatter, content);
+}
+/**
+ * Creates a new markdown file with frontmatter.
+ */
+export async function createMarkdownFile(filePath, title, content, options = {}) {
+    const today = new Date().toISOString().split('T')[0];
+    const frontmatter = {
+        title,
+        created: today,
+        tags: options.tags ?? [],
+        ...options,
+    };
+    await writeMarkdown(filePath, frontmatter, content);
+}
+/**
+ * Appends content to an existing markdown file.
+ */
+export async function appendToMarkdown(filePath, newContent) {
+    const { frontmatter, content } = await readMarkdown(filePath);
+    const updatedContent = content + '\n\n' + newContent;
+    // Update modified date
+    const updatedFrontmatter = {
+        ...frontmatter,
+        modified: new Date().toISOString().split('T')[0],
+    };
+    await writeMarkdown(filePath, updatedFrontmatter, updatedContent);
+}
+//# sourceMappingURL=parser.js.map

package/dist/markdown/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/markdown/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAoB,MAAM,qBAAqB,CAAC;AAO1E;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IAC/C,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IAE9C,gCAAgC;IAChC,MAAM,WAAW,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAElD,OAAO;QACH,WAAW;QACX,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE;KAC1B,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAC/B,QAAgB,EAChB,WAAwB,EACxB,OAAe;IAEf,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC3D,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACnC,QAAgB,EAChB,OAA6B;IAE7B,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC9D,MAAM,kBAAkB,GAAG,EAAE,GAAG,WAAW,EAAE,GAAG,OAAO,EAAE,CAAC;IAC1D,MAAM,aAAa,CAAC,QAAQ,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACpC,QAAgB,EAChB,KAAa,EACb,OAAe,EACf,UAA2D,EAAE;IAE7D,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,MAAM,WAAW,GAAgB;QAC7B,KAAK;QACL,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;QACxB,GAAG,OAAO;KACb,CAAC;IAEF,MAAM,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAClC,QAAgB,EAChB,UAAkB;IAElB,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC9D,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC;IAErD,uBAAuB;IACvB,MAAM,kBAAkB,GAAG;QACvB,GAAG,WAAW;QACd,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;KACnD,CAAC;IAEF,MAAM,aAAa,CAAC,QAAQ,EAAE,kBAAkB,EAAE,cAAc,CAAC,CAAC;AACtE,CAAC"}

package/dist/pamp/client.d.ts

@@ -0,0 +1,39 @@
+import type { PampIdentity, PampAgreement, PampEnvelopeHeader, PampMessage } from './types.js';
+export declare class PampClient {
+    private identity;
+    constructor(identity: PampIdentity);
+    private headers;
+    private url;
+    private request;
+    /**
+     * Register a new mailbox at a Post Office.
+     * This is a static method — no identity needed yet.
+     */
+    static register(postOffice: string, displayName: string, preferredId?: string): Promise<PampIdentity>;
+    getMailboxInfo(mailboxId: string): Promise<{
+        mailbox_id: string;
+        display_name: string;
+        public_key: string;
+    }>;
+    rotateApiKey(): Promise<string>;
+    requestAgreement(toAddress: string, type?: 'bilateral' | 'unilateral'): Promise<PampAgreement>;
+    listPendingAgreements(): Promise<PampAgreement[]>;
+    acceptAgreement(agreementId: string): Promise<PampAgreement>;
+    declineAgreement(agreementId: string): Promise<void>;
+    revokeAgreement(agreementId: string): Promise<void>;
+    getAgreement(agreementId: string): Promise<PampAgreement>;
+    sendMessage(toAddress: string, body: string, contentType?: string, replyToId?: string): Promise<PampMessage>;
+    listMessages(options?: {
+        unread?: boolean;
+    }): Promise<PampEnvelopeHeader[]>;
+    fetchMessage(messageId: string): Promise<string>;
+    fetchAndDecryptMessage(messageId: string): Promise<PampMessage>;
+    markRead(messageId: string): Promise<void>;
+    listThreads(): Promise<Array<{
+        thread_id: string;
+        message_count: number;
+        latest_message_id: string;
+        latest_created_at: string;
+    }>>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/pamp/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/pamp/client.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACR,YAAY,EACZ,aAAa,EACb,kBAAkB,EAElB,WAAW,EAGd,MAAM,YAAY,CAAC;AAmBpB,qBAAa,UAAU;IACP,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,YAAY;IAE1C,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,GAAG;YAIG,OAAO;IAqBrB;;;OAGG;WACU,QAAQ,CACjB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,YAAY,CAAC;IAsClB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAC7C,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;KACtB,CAAC;IAII,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAY/B,gBAAgB,CAClB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,WAAW,GAAG,YAA0B,GAC/C,OAAO,CAAC,aAAa,CAAC;IA0DnB,qBAAqB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IA8BjD,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA6D5D,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA2CzD,WAAW,CACb,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,WAAW,SAAe,EAC1B,SAAS,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,WAAW,CAAC;IAgEjB,YAAY,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAK3E,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIhD,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA0C/D,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,WAAW,IAAI,OAAO,CAAC,KAAK,CAAC;QAC/B,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,iBAAiB,EAAE,MAAM,CAAC;KAC7B,CAAC,CAAC;CAGN"}