@agtlantis/core 0.5.0 → 0.6.0

package/dist/prompt/errors.js

@@ -0,0 +1,174 @@
+/**
+ * Prompt module error classes for @agtlantis/core.
+ *
+ * Each error type has a specific code and context for precise error handling.
+ */
+import { AgtlantisError } from '../errors/index.js';
+// =============================================================================
+// Prompt Error Codes
+// =============================================================================
+export var PromptErrorCode;
+(function (PromptErrorCode) {
+    /** Generic prompt error */
+    PromptErrorCode["PROMPT_ERROR"] = "PROMPT_ERROR";
+    /** Prompt not found in repository */
+    PromptErrorCode["NOT_FOUND"] = "PROMPT_NOT_FOUND";
+    /** Invalid prompt file format (e.g., malformed YAML) */
+    PromptErrorCode["INVALID_FORMAT"] = "PROMPT_INVALID_FORMAT";
+    /** Template compilation failed */
+    PromptErrorCode["TEMPLATE_ERROR"] = "PROMPT_TEMPLATE_ERROR";
+    /** File I/O operation failed */
+    PromptErrorCode["IO_ERROR"] = "PROMPT_IO_ERROR";
+})(PromptErrorCode || (PromptErrorCode = {}));
+// =============================================================================
+// Base Prompt Error
+// =============================================================================
+/**
+ * Base error class for prompt operations.
+ * Use specific error subclasses for more precise error handling.
+ *
+ * @example
+ * ```typescript
+ * throw new PromptError('Something went wrong', {
+ *   code: PromptErrorCode.PROMPT_ERROR,
+ *   context: { promptId: 'greeting' }
+ * });
+ * ```
+ */
+export class PromptError extends AgtlantisError {
+    constructor(message, options = {}) {
+        super(message, {
+            code: (options.code ?? PromptErrorCode.PROMPT_ERROR),
+            cause: options.cause,
+            context: options.context,
+        });
+        this.name = 'PromptError';
+    }
+    /**
+     * Creates a PromptError from an unknown error.
+     */
+    static from(error, code = PromptErrorCode.PROMPT_ERROR, context) {
+        if (error instanceof PromptError) {
+            return error;
+        }
+        const cause = error instanceof Error ? error : new Error(String(error));
+        return new PromptError(cause.message, { code, cause, context });
+    }
+}
+// =============================================================================
+// Prompt Not Found Error
+// =============================================================================
+/**
+ * Error thrown when a prompt is not found in the repository.
+ *
+ * @example
+ * ```typescript
+ * throw new PromptNotFoundError('greeting', '1.0.0');
+ * // Error: Prompt 'greeting' version '1.0.0' not found
+ *
+ * throw new PromptNotFoundError('greeting');
+ * // Error: Prompt 'greeting' not found
+ * ```
+ */
+export class PromptNotFoundError extends PromptError {
+    promptId;
+    version;
+    constructor(promptId, version, options = {}) {
+        const message = version
+            ? `Prompt '${promptId}' version '${version}' not found`
+            : `Prompt '${promptId}' not found`;
+        super(message, {
+            code: PromptErrorCode.NOT_FOUND,
+            cause: options.cause,
+            context: { promptId, version, ...options.context },
+        });
+        this.name = 'PromptNotFoundError';
+        this.promptId = promptId;
+        this.version = version;
+    }
+}
+// =============================================================================
+// Prompt Invalid Format Error
+// =============================================================================
+/**
+ * Error thrown when a prompt file has invalid format.
+ * Examples: malformed YAML, missing required fields, invalid schema.
+ *
+ * @example
+ * ```typescript
+ * throw new PromptInvalidFormatError('greeting', 'Missing required field: system');
+ * // Error: Invalid format for prompt 'greeting': Missing required field: system
+ * ```
+ */
+export class PromptInvalidFormatError extends PromptError {
+    promptId;
+    details;
+    constructor(promptId, details, options = {}) {
+        super(`Invalid format for prompt '${promptId}': ${details}`, {
+            code: PromptErrorCode.INVALID_FORMAT,
+            cause: options.cause,
+            context: { promptId, details, ...options.context },
+        });
+        this.name = 'PromptInvalidFormatError';
+        this.promptId = promptId;
+        this.details = details;
+    }
+}
+// =============================================================================
+// Prompt Template Error
+// =============================================================================
+/**
+ * Error thrown when template compilation fails.
+ * Examples: invalid Handlebars syntax, missing helper.
+ *
+ * @example
+ * ```typescript
+ * throw new PromptTemplateError('greeting', 'Unexpected token {{/if}}');
+ * // Error: Template compilation failed for prompt 'greeting': Unexpected token {{/if}}
+ * ```
+ */
+export class PromptTemplateError extends PromptError {
+    promptId;
+    details;
+    constructor(promptId, details, options = {}) {
+        super(`Template compilation failed for prompt '${promptId}': ${details}`, {
+            code: PromptErrorCode.TEMPLATE_ERROR,
+            cause: options.cause,
+            context: { promptId, details, ...options.context },
+        });
+        this.name = 'PromptTemplateError';
+        this.promptId = promptId;
+        this.details = details;
+    }
+}
+// =============================================================================
+// Prompt IO Error
+// =============================================================================
+/**
+ * Error thrown when file I/O operations fail.
+ * Examples: read failure, write failure, directory access denied.
+ *
+ * @example
+ * ```typescript
+ * throw new PromptIOError('read', '/path/to/prompt.yaml', {
+ *   cause: originalError
+ * });
+ * // Error: Failed to read prompt file: /path/to/prompt.yaml
+ * ```
+ */
+export class PromptIOError extends PromptError {
+    operation;
+    path;
+    constructor(operation, path, options = {}) {
+        const opText = operation === 'list' ? 'list prompts in' : `${operation} prompt file`;
+        super(`Failed to ${opText}: ${path}`, {
+            code: PromptErrorCode.IO_ERROR,
+            cause: options.cause,
+            context: { operation, path, ...options.context },
+        });
+        this.name = 'PromptIOError';
+        this.operation = operation;
+        this.path = path;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/prompt/errors.js.map

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

package/dist/prompt/file-prompt-repository.d.ts

@@ -0,0 +1,80 @@
+import type { FileSystem, PromptRepository, PromptTemplateData } from './types.js';
+export interface FilePromptRepositoryOptions {
+    /** Directory path where prompt files are stored */
+    directory: string;
+    /** Optional custom file system implementation (defaults to Node.js fs) */
+    fs?: FileSystem;
+    /** Enable in-memory caching for read operations (defaults to true) */
+    cache?: boolean;
+}
+/**
+ * File-based prompt repository.
+ *
+ * Prompts are stored as YAML files with naming convention: {id}-{version}.yaml
+ *
+ * Can be subclassed to customize parsing/serialization (e.g., JSON instead of YAML).
+ *
+ * @example
+ * ```typescript
+ * const repo = new FilePromptRepository({ directory: './prompts' });
+ *
+ * // Read latest version
+ * const prompt = await repo.read<GreetingInput>('greeting');
+ *
+ * // Subclass to use JSON format
+ * class JsonPromptRepository extends FilePromptRepository {
+ *   protected parseContent(content: string, promptId: string): PromptTemplateData {
+ *     return JSON.parse(content);
+ *   }
+ *   protected serializeContent(content: PromptTemplateData): string {
+ *     return JSON.stringify(content, null, 2);
+ *   }
+ * }
+ * ```
+ */
+export declare class FilePromptRepository implements PromptRepository {
+    protected readonly directory: string;
+    protected readonly fileSystem: FileSystem;
+    protected readonly cacheEnabled: boolean;
+    private readonly contentCache;
+    constructor(options: FilePromptRepositoryOptions);
+    /**
+     * Generates file name from prompt id and version.
+     * Override this along with `parseFileName` to change file naming convention.
+     */
+    protected getFileName(id: string, version: string): string;
+    /**
+     * Parses file name into id and version.
+     * Override this along with `getFileName` to change file naming convention.
+     */
+    protected parseFileName(fileName: string): {
+        id: string;
+        version: string;
+    } | null;
+    /**
+     * Parses raw file content into PromptTemplateData.
+     * Override this to support different file formats (e.g., JSON, TOML).
+     */
+    protected parseContent(content: string, promptId: string): PromptTemplateData;
+    /**
+     * Serializes PromptTemplateData to file content string.
+     * Override this to support different file formats (e.g., JSON, TOML).
+     */
+    protected serializeContent(content: PromptTemplateData): string;
+    private getCacheKey;
+    read(id: string, version?: string): Promise<PromptTemplateData>;
+    write(content: PromptTemplateData): Promise<void>;
+}
+/**
+ * Creates a file-based prompt repository.
+ *
+ * This is a convenience factory function. For subclassing, use `FilePromptRepository` class directly.
+ *
+ * @example
+ * ```typescript
+ * const repo = createFilePromptRepository({ directory: './prompts' });
+ * const prompt = await repo.read<GreetingInput>('greeting');
+ * ```
+ */
+export declare function createFilePromptRepository(options: FilePromptRepositoryOptions): PromptRepository;
+//# sourceMappingURL=file-prompt-repository.d.ts.map

package/dist/prompt/file-prompt-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-prompt-repository.d.ts","sourceRoot":"","sources":["../../src/prompt/file-prompt-repository.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAMnF,MAAM,WAAW,2BAA2B;IACxC,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,EAAE,CAAC,EAAE,UAAU,CAAC;IAChB,sEAAsE;IACtE,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAkJD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,oBAAqB,YAAW,gBAAgB;IACzD,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IACrC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAC1C,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAEzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyC;IAEtE,YAAY,OAAO,EAAE,2BAA2B,EAI/C;IAED;;;OAGG;IACH,SAAS,CAAC,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;IAED;;;OAGG;IACH,SAAS,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAEhF;IAED;;;OAGG;IACH,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAE5E;IAED;;;OAGG;IACH,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAE9D;IAED,OAAO,CAAC,WAAW;IAIb,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA+DpE;IAEK,KAAK,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BtD;CACJ;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,2BAA2B,GAAG,gBAAgB,CAEjG"}

package/dist/prompt/file-prompt-repository.js

@@ -0,0 +1,287 @@
+/**
+ * File-based prompt repository implementation.
+ *
+ * Stores prompts as YAML files with naming convention: {id}-{version}.yaml
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import * as yaml from 'yaml';
+import { PromptIOError, PromptInvalidFormatError, PromptNotFoundError } from './errors.js';
+import { compileTemplate } from './template.js';
+// =============================================================================
+// Error Utilities
+// =============================================================================
+function toErrorCause(error) {
+    return error instanceof Error ? error : undefined;
+}
+function toErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+// =============================================================================
+// Default File System Implementation
+// =============================================================================
+const defaultFileSystem = {
+    readFile: (filePath) => fs.readFile(filePath, 'utf-8'),
+    writeFile: (filePath, content) => fs.writeFile(filePath, content, 'utf-8'),
+    readdir: (dirPath) => fs.readdir(dirPath),
+};
+// =============================================================================
+// Version Utilities
+// =============================================================================
+/**
+ * Parses a semver version string into numeric components.
+ * @param version - Version string (e.g., '1.2.3')
+ * @returns Tuple of [major, minor, patch] or null if invalid
+ */
+function parseVersion(version) {
+    const match = version.match(/^(\d+)\.(\d+)\.(\d+)$/);
+    if (!match)
+        return null;
+    return [parseInt(match[1], 10), parseInt(match[2], 10), parseInt(match[3], 10)];
+}
+/**
+ * Compares two semver versions.
+ * @returns Negative if a < b, positive if a > b, zero if equal
+ */
+function compareVersions(a, b) {
+    const parsedA = parseVersion(a);
+    const parsedB = parseVersion(b);
+    // Invalid versions sort last
+    if (!parsedA && !parsedB)
+        return 0;
+    if (!parsedA)
+        return 1;
+    if (!parsedB)
+        return -1;
+    for (let i = 0; i < 3; i++) {
+        if (parsedA[i] !== parsedB[i]) {
+            return parsedA[i] - parsedB[i];
+        }
+    }
+    return 0;
+}
+// =============================================================================
+// File Name Utilities
+// =============================================================================
+const FILE_EXTENSION = '.yaml';
+/**
+ * Generates file name from prompt id and version.
+ * @example getFileName('greeting', '1.0.0') => 'greeting-1.0.0.yaml'
+ */
+function getFileName(id, version) {
+    return `${id}-${version}${FILE_EXTENSION}`;
+}
+/**
+ * Parses file name into id and version.
+ * @example parseFileName('greeting-1.0.0.yaml') => { id: 'greeting', version: '1.0.0' }
+ */
+function parseFileName(fileName) {
+    if (!fileName.endsWith(FILE_EXTENSION))
+        return null;
+    const baseName = fileName.slice(0, -FILE_EXTENSION.length);
+    const lastDash = baseName.lastIndexOf('-');
+    if (lastDash === -1)
+        return null;
+    const id = baseName.slice(0, lastDash);
+    const version = baseName.slice(lastDash + 1);
+    if (!id || !parseVersion(version))
+        return null;
+    return { id, version };
+}
+// =============================================================================
+// YAML Parsing & Validation
+// =============================================================================
+/**
+ * Parses and validates YAML content as PromptTemplateData.
+ */
+function parsePromptYaml(content, promptId) {
+    let parsed;
+    try {
+        parsed = yaml.parse(content);
+    }
+    catch (error) {
+        throw new PromptInvalidFormatError(promptId, `Invalid YAML: ${toErrorMessage(error)}`, {
+            cause: toErrorCause(error),
+        });
+    }
+    if (!parsed || typeof parsed !== 'object') {
+        throw new PromptInvalidFormatError(promptId, 'Expected YAML object');
+    }
+    const obj = parsed;
+    // Validate required fields
+    const requiredFields = ['id', 'version', 'system', 'userTemplate'];
+    for (const field of requiredFields) {
+        if (typeof obj[field] !== 'string') {
+            throw new PromptInvalidFormatError(promptId, `Missing or invalid required field: ${field} (expected string)`);
+        }
+    }
+    return {
+        id: obj.id,
+        version: obj.version,
+        system: obj.system,
+        userTemplate: obj.userTemplate,
+    };
+}
+/**
+ * Serializes PromptTemplateData to YAML string.
+ */
+function serializePromptYaml(content) {
+    return yaml.stringify(content);
+}
+// =============================================================================
+// Repository Implementation
+// =============================================================================
+/**
+ * File-based prompt repository.
+ *
+ * Prompts are stored as YAML files with naming convention: {id}-{version}.yaml
+ *
+ * Can be subclassed to customize parsing/serialization (e.g., JSON instead of YAML).
+ *
+ * @example
+ * ```typescript
+ * const repo = new FilePromptRepository({ directory: './prompts' });
+ *
+ * // Read latest version
+ * const prompt = await repo.read<GreetingInput>('greeting');
+ *
+ * // Subclass to use JSON format
+ * class JsonPromptRepository extends FilePromptRepository {
+ *   protected parseContent(content: string, promptId: string): PromptTemplateData {
+ *     return JSON.parse(content);
+ *   }
+ *   protected serializeContent(content: PromptTemplateData): string {
+ *     return JSON.stringify(content, null, 2);
+ *   }
+ * }
+ * ```
+ */
+export class FilePromptRepository {
+    directory;
+    fileSystem;
+    cacheEnabled;
+    contentCache = new Map();
+    constructor(options) {
+        this.directory = options.directory;
+        this.fileSystem = options.fs ?? defaultFileSystem;
+        this.cacheEnabled = options.cache ?? true;
+    }
+    /**
+     * Generates file name from prompt id and version.
+     * Override this along with `parseFileName` to change file naming convention.
+     */
+    getFileName(id, version) {
+        return getFileName(id, version);
+    }
+    /**
+     * Parses file name into id and version.
+     * Override this along with `getFileName` to change file naming convention.
+     */
+    parseFileName(fileName) {
+        return parseFileName(fileName);
+    }
+    /**
+     * Parses raw file content into PromptTemplateData.
+     * Override this to support different file formats (e.g., JSON, TOML).
+     */
+    parseContent(content, promptId) {
+        return parsePromptYaml(content, promptId);
+    }
+    /**
+     * Serializes PromptTemplateData to file content string.
+     * Override this to support different file formats (e.g., JSON, TOML).
+     */
+    serializeContent(content) {
+        return serializePromptYaml(content);
+    }
+    getCacheKey(id, version) {
+        return `${id}:${version}`;
+    }
+    async read(id, version) {
+        if (version) {
+            const cacheKey = this.getCacheKey(id, version);
+            if (this.cacheEnabled) {
+                const cached = this.contentCache.get(cacheKey);
+                if (cached) {
+                    return cached;
+                }
+            }
+            const fileName = this.getFileName(id, version);
+            const filePath = path.join(this.directory, fileName);
+            let content;
+            try {
+                content = await this.fileSystem.readFile(filePath);
+            }
+            catch (error) {
+                if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+                    throw new PromptNotFoundError(id, version);
+                }
+                throw new PromptIOError('read', filePath, { cause: toErrorCause(error) });
+            }
+            const promptTemplate = this.parseContent(content, id);
+            if (promptTemplate.id !== id || promptTemplate.version !== version) {
+                throw new PromptInvalidFormatError(id, `File content mismatch: expected id='${id}' version='${version}', got id='${promptTemplate.id}' version='${promptTemplate.version}'`);
+            }
+            if (this.cacheEnabled) {
+                this.contentCache.set(cacheKey, promptTemplate);
+            }
+            return promptTemplate;
+        }
+        let files;
+        try {
+            files = await this.fileSystem.readdir(this.directory);
+        }
+        catch (error) {
+            throw new PromptIOError('list', this.directory, { cause: toErrorCause(error) });
+        }
+        const versions = [];
+        for (const file of files) {
+            const parsed = this.parseFileName(file);
+            if (parsed && parsed.id === id) {
+                versions.push(parsed.version);
+            }
+        }
+        if (versions.length === 0) {
+            throw new PromptNotFoundError(id);
+        }
+        versions.sort((a, b) => compareVersions(b, a));
+        const latestVersion = versions[0];
+        return this.read(id, latestVersion);
+    }
+    async write(content) {
+        // Invalidate cache for this id:version (before any validation)
+        if (this.cacheEnabled) {
+            this.contentCache.delete(this.getCacheKey(content.id, content.version));
+        }
+        const fileName = this.getFileName(content.id, content.version);
+        const filePath = path.join(this.directory, fileName);
+        if (!parseVersion(content.version)) {
+            throw new PromptInvalidFormatError(content.id, `Invalid version format: '${content.version}' (expected semver like '1.0.0')`);
+        }
+        // Validate templates can be compiled (fails fast on syntax errors)
+        compileTemplate(content.system, content.id);
+        compileTemplate(content.userTemplate, content.id);
+        const yamlContent = this.serializeContent(content);
+        try {
+            await this.fileSystem.writeFile(filePath, yamlContent);
+        }
+        catch (error) {
+            throw new PromptIOError('write', filePath, { cause: toErrorCause(error) });
+        }
+    }
+}
+/**
+ * Creates a file-based prompt repository.
+ *
+ * This is a convenience factory function. For subclassing, use `FilePromptRepository` class directly.
+ *
+ * @example
+ * ```typescript
+ * const repo = createFilePromptRepository({ directory: './prompts' });
+ * const prompt = await repo.read<GreetingInput>('greeting');
+ * ```
+ */
+export function createFilePromptRepository(options) {
+    return new FilePromptRepository(options);
+}
+//# sourceMappingURL=file-prompt-repository.js.map

package/dist/prompt/file-prompt-repository.js.map

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

package/dist/prompt/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Prompt module for @agtlantis/core.
+ *
+ * Provides structured prompt management with versioning, templating, and repository abstraction.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   createFilePromptRepository,
+ *   PromptTemplate,
+ *   type PromptRenderer,
+ * } from '@agtlantis/core';
+ *
+ * // Create a file-based repository
+ * const repo = createFilePromptRepository({ directory: './prompts' });
+ *
+ * // Read a prompt and compile to renderer
+ * interface SessionCtx { studentName: string }
+ * interface TurnCtx { answers: string[] }
+ *
+ * const data = await repo.read('greeting');
+ * const renderer = PromptTemplate.from(data).compile<SessionCtx, TurnCtx>();
+ *
+ * // Use the renderer
+ * const systemPrompt = renderer.renderSystemPrompt({ studentName: 'Kim' });
+ * const userPrompt = renderer.renderUserPrompt({ answers: ['A', 'B'] });
+ * ```
+ */
+export type { PromptTemplateData, PromptRenderer, PromptRepository, FileSystem } from './types.js';
+export { PromptTemplate } from './prompt-template.js';
+export { PromptErrorCode, PromptError, PromptNotFoundError, PromptInvalidFormatError, PromptTemplateError, PromptIOError, type PromptErrorOptions, } from './errors.js';
+export { compileTemplate } from './template.js';
+export { FilePromptRepository, createFilePromptRepository, type FilePromptRepositoryOptions, } from './file-prompt-repository.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/prompt/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompt/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGnG,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EACH,eAAe,EACf,WAAW,EACX,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,aAAa,EACb,KAAK,kBAAkB,GAC1B,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,EACH,oBAAoB,EACpB,0BAA0B,EAC1B,KAAK,2BAA2B,GACnC,MAAM,6BAA6B,CAAC"}

package/dist/prompt/index.js

@@ -0,0 +1,37 @@
+/**
+ * Prompt module for @agtlantis/core.
+ *
+ * Provides structured prompt management with versioning, templating, and repository abstraction.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   createFilePromptRepository,
+ *   PromptTemplate,
+ *   type PromptRenderer,
+ * } from '@agtlantis/core';
+ *
+ * // Create a file-based repository
+ * const repo = createFilePromptRepository({ directory: './prompts' });
+ *
+ * // Read a prompt and compile to renderer
+ * interface SessionCtx { studentName: string }
+ * interface TurnCtx { answers: string[] }
+ *
+ * const data = await repo.read('greeting');
+ * const renderer = PromptTemplate.from(data).compile<SessionCtx, TurnCtx>();
+ *
+ * // Use the renderer
+ * const systemPrompt = renderer.renderSystemPrompt({ studentName: 'Kim' });
+ * const userPrompt = renderer.renderUserPrompt({ answers: ['A', 'B'] });
+ * ```
+ */
+// PromptTemplate class
+export { PromptTemplate } from './prompt-template.js';
+// Errors
+export { PromptErrorCode, PromptError, PromptNotFoundError, PromptInvalidFormatError, PromptTemplateError, PromptIOError, } from './errors.js';
+// Template utilities
+export { compileTemplate } from './template.js';
+// Repository implementations
+export { FilePromptRepository, createFilePromptRepository, } from './file-prompt-repository.js';
+//# sourceMappingURL=index.js.map

package/dist/prompt/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompt/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAKH,uBAAuB;AACvB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,SAAS;AACT,OAAO,EACH,eAAe,EACf,WAAW,EACX,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,aAAa,GAEhB,MAAM,aAAa,CAAC;AAErB,qBAAqB;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,6BAA6B;AAC7B,OAAO,EACH,oBAAoB,EACpB,0BAA0B,GAE7B,MAAM,6BAA6B,CAAC"}